From c627348c25774600e83248182336bdc857feda0a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 23 Nov 2020 18:20:52 -0500
Subject: [PATCH 001/856] let players specify game path by running the
 installer from within it

---
 docs/release-notes.md                         |   4 +
 .../Framework/InstallerContext.cs             | 103 +++++++++++++++
 src/SMAPI.Installer/InteractiveInstaller.cs   | 124 ++++++------------
 .../Framework/GameScanning/GameScanner.cs     |  48 ++++---
 4 files changed, 183 insertions(+), 96 deletions(-)
 create mode 100644 src/SMAPI.Installer/Framework/InstallerContext.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1115f482..8043212e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * When the installer is run from within a game folder, it now installs SMAPI to that folder. That simplifies installation if you have multiple copies of the game or it can't otherwise auto-detect the game path.
+
 ## 3.7.6
 Released 21 November 2020 for Stardew Valley 1.4.1 or later.
 
diff --git a/src/SMAPI.Installer/Framework/InstallerContext.cs b/src/SMAPI.Installer/Framework/InstallerContext.cs
new file mode 100644
index 00000000..7531eaee
--- /dev/null
+++ b/src/SMAPI.Installer/Framework/InstallerContext.cs
@@ -0,0 +1,103 @@
+using System;
+using System.IO;
+using Microsoft.Win32;
+using StardewModdingAPI.Toolkit;
+using StardewModdingAPI.Toolkit.Framework.GameScanning;
+using StardewModdingAPI.Toolkit.Utilities;
+
+namespace StardewModdingAPI.Installer.Framework
+{
+    /// <summary>The installer context.</summary>
+    internal class InstallerContext
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The <see cref="Environment.OSVersion"/> value that represents Windows 7.</summary>
+        private readonly Version Windows7Version = new Version(6, 1);
+
+        /// <summary>The underlying toolkit game scanner.</summary>
+        private readonly GameScanner GameScanner = new GameScanner();
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The current OS.</summary>
+        public Platform Platform { get; }
+
+        /// <summary>The human-readable OS name and version.</summary>
+        public string PlatformName { get; }
+
+        /// <summary>The name of the Stardew Valley executable.</summary>
+        public string ExecutableName { get; }
+
+        /// <summary>Whether the installer is running on Windows.</summary>
+        public bool IsWindows => this.Platform == Platform.Windows;
+
+        /// <summary>Whether the installer is running on a Unix OS (including Linux or MacOS).</summary>
+        public bool IsUnix => !this.IsWindows;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public InstallerContext()
+        {
+            this.Platform = EnvironmentUtility.DetectPlatform();
+            this.PlatformName = EnvironmentUtility.GetFriendlyPlatformName(this.Platform);
+            this.ExecutableName = EnvironmentUtility.GetExecutableName(this.Platform);
+        }
+
+        /// <summary>Get the installer's version number.</summary>
+        public ISemanticVersion GetInstallerVersion()
+        {
+            var raw = this.GetType().Assembly.GetName().Version;
+            return new SemanticVersion(raw);
+        }
+
+        /// <summary>Get whether the current system has .NET Framework 4.5 or later installed. This only applies on Windows.</summary>
+        /// <exception cref="NotSupportedException">The current platform is not Windows.</exception>
+        public bool HasNetFramework45()
+        {
+            switch (this.Platform)
+            {
+                case Platform.Windows:
+                    using (RegistryKey versionKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(@"SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full"))
+                        return versionKey?.GetValue("Release") != null; // .NET Framework 4.5+
+
+                default:
+                    throw new NotSupportedException("The installed .NET Framework version can only be checked on Windows.");
+            }
+        }
+
+        /// <summary>Get whether the current system has XNA Framework installed. This only applies on Windows.</summary>
+        /// <exception cref="NotSupportedException">The current platform is not Windows.</exception>
+        public bool HasXna()
+        {
+            switch (this.Platform)
+            {
+                case Platform.Windows:
+                    using (RegistryKey key = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(@"SOFTWARE\Microsoft\XNA\Framework"))
+                        return key != null; // XNA Framework 4.0+
+
+                default:
+                    throw new NotSupportedException("The installed XNA Framework version can only be checked on Windows.");
+            }
+        }
+
+        /// <summary>Whether the current OS supports newer versions of .NET Framework.</summary>
+        public bool CanInstallLatestNetFramework()
+        {
+            return Environment.OSVersion.Version >= this.Windows7Version; // Windows 7+
+        }
+
+        /// <summary>Get whether a folder seems to contain the game files.</summary>
+        /// <param name="dir">The folder to check.</param>
+        public bool LooksLikeGameFolder(DirectoryInfo dir)
+        {
+            return this.GameScanner.LooksLikeGameFolder(dir);
+        }
+    }
+}
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index d0ef0b8d..035ec382 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -3,7 +3,7 @@ using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
 using System.Linq;
-using Microsoft.Win32;
+using System.Reflection;
 using StardewModdingApi.Installer.Enums;
 using StardewModdingAPI.Installer.Framework;
 using StardewModdingAPI.Internal.ConsoleWriting;
@@ -25,12 +25,8 @@ namespace StardewModdingApi.Installer
         /// <summary>The absolute path to the directory containing the files to copy into the game folder.</summary>
         private readonly string BundlePath;
 
-        /// <summary>The <see cref="Environment.OSVersion"/> value that represents Windows 7.</summary>
-        private readonly Version Windows7Version = new Version(6, 1);
-
         /// <summary>The mod IDs which the installer should allow as bundled mods.</summary>
-        private readonly string[] BundledModIDs = new[]
-        {
+        private readonly string[] BundledModIDs = {
             "SMAPI.SaveBackup",
             "SMAPI.ConsoleCommands"
         };
@@ -129,22 +125,22 @@ namespace StardewModdingApi.Installer
             ** Get basic info & set window title
             ****/
             ModToolkit toolkit = new ModToolkit();
-            Platform platform = EnvironmentUtility.DetectPlatform();
-            Console.Title = $"SMAPI {this.GetDisplayVersion(this.GetType().Assembly.GetName().Version)} installer on {platform} {EnvironmentUtility.GetFriendlyPlatformName(platform)}";
+            var context = new InstallerContext();
+            Console.Title = $"SMAPI {context.GetInstallerVersion()} installer on {context.Platform} {context.PlatformName}";
             Console.WriteLine();
 
             /****
             ** Check if correct installer
             ****/
 #if SMAPI_FOR_WINDOWS
-            if (platform == Platform.Linux || platform == Platform.Mac)
+            if (context.IsUnix)
             {
-                this.PrintError($"This is the installer for Windows. Run the 'install on {platform}.{(platform == Platform.Linux ? "sh" : "command")}' file instead.");
+                this.PrintError($"This is the installer for Windows. Run the 'install on {context.Platform}.{(context.Platform == Platform.Mac ? "command" : "sh")}' file instead.");
                 Console.ReadLine();
                 return;
             }
 #else
-            if (platform == Platform.Windows)
+            if (context.IsWindows)
             {
                 this.PrintError($"This is the installer for Linux/Mac. Run the 'install on Windows.exe' file instead.");
                 Console.ReadLine();
@@ -155,20 +151,20 @@ namespace StardewModdingApi.Installer
             /****
             ** Check Windows dependencies
             ****/
-            if (platform == Platform.Windows)
+            if (context.IsWindows)
             {
                 // .NET Framework 4.5+
-                if (!this.HasNetFramework45(platform))
+                if (!context.HasNetFramework45())
                 {
-                    this.PrintError(Environment.OSVersion.Version >= this.Windows7Version
-                            ? "Please install the latest version of .NET Framework before installing SMAPI." // Windows 7+
-                            : "Please install .NET Framework 4.5 before installing SMAPI." // Windows Vista or earlier
+                    this.PrintError(context.CanInstallLatestNetFramework()
+                            ? "Please install the latest version of .NET Framework before installing SMAPI."
+                            : "Please install .NET Framework 4.5 before installing SMAPI."
                     );
                     this.PrintError("See the download page at https://www.microsoft.com/net/download/framework for details.");
                     Console.ReadLine();
                     return;
                 }
-                if (!this.HasXna(platform))
+                if (!context.HasXna())
                 {
                     this.PrintError("You don't seem to have XNA Framework installed. Please run the game at least once before installing SMAPI, so it can perform its first-time setup.");
                     Console.ReadLine();
@@ -202,7 +198,7 @@ namespace StardewModdingApi.Installer
             ** Step 2: choose a theme (can't auto-detect on Linux/Mac)
             *********/
             MonitorColorScheme scheme = MonitorColorScheme.AutoDetect;
-            if (platform == Platform.Linux || platform == Platform.Mac)
+            if (context.IsUnix)
             {
                 /****
                 ** print header
@@ -215,8 +211,8 @@ namespace StardewModdingApi.Installer
                 ** show theme selector
                 ****/
                 // get theme writers
-                var lightBackgroundWriter = new ColorfulConsoleWriter(platform, ColorfulConsoleWriter.GetDefaultColorSchemeConfig(MonitorColorScheme.LightBackground));
-                var darkBackgroundWriter = new ColorfulConsoleWriter(platform, ColorfulConsoleWriter.GetDefaultColorSchemeConfig(MonitorColorScheme.DarkBackground));
+                var lightBackgroundWriter = new ColorfulConsoleWriter(context.Platform, ColorfulConsoleWriter.GetDefaultColorSchemeConfig(MonitorColorScheme.LightBackground));
+                var darkBackgroundWriter = new ColorfulConsoleWriter(context.Platform, ColorfulConsoleWriter.GetDefaultColorSchemeConfig(MonitorColorScheme.DarkBackground));
 
                 // print question
                 this.PrintPlain("Which text looks more readable?");
@@ -264,7 +260,7 @@ namespace StardewModdingApi.Installer
                 ****/
                 // get game path
                 this.PrintInfo("Where is your game folder?");
-                DirectoryInfo installDir = this.InteractivelyGetInstallPath(platform, toolkit, gamePathArg);
+                DirectoryInfo installDir = this.InteractivelyGetInstallPath(toolkit, context, gamePathArg);
                 if (installDir == null)
                 {
                     this.PrintError("Failed finding your game path.");
@@ -274,7 +270,7 @@ namespace StardewModdingApi.Installer
 
                 // get folders
                 DirectoryInfo bundleDir = new DirectoryInfo(this.BundlePath);
-                paths = new InstallerPaths(bundleDir, installDir, EnvironmentUtility.GetExecutableName(platform));
+                paths = new InstallerPaths(bundleDir, installDir, context.ExecutableName);
             }
             Console.Clear();
 
@@ -359,7 +355,7 @@ namespace StardewModdingApi.Installer
                 ** Always uninstall old files
                 ****/
                 // restore game launcher
-                if (platform.IsMono() && File.Exists(paths.UnixBackupLauncherPath))
+                if (context.IsUnix && File.Exists(paths.UnixBackupLauncherPath))
                 {
                     this.PrintDebug("Removing SMAPI launcher...");
                     this.InteractivelyDelete(paths.UnixLauncherPath);
@@ -406,7 +402,7 @@ namespace StardewModdingApi.Installer
                     }
 
                     // replace mod launcher (if possible)
-                    if (platform.IsMono())
+                    if (context.IsUnix)
                     {
                         this.PrintDebug("Safely replacing game launcher...");
 
@@ -504,7 +500,7 @@ namespace StardewModdingApi.Installer
             /*********
             ** Step 7: final instructions
             *********/
-            if (platform == Platform.Windows)
+            if (context.IsWindows)
             {
                 if (action == ScriptAction.Install)
                 {
@@ -531,16 +527,6 @@ namespace StardewModdingApi.Installer
         /*********
         ** Private methods
         *********/
-        /// <summary>Get the display text for an assembly version.</summary>
-        /// <param name="version">The assembly version.</param>
-        private string GetDisplayVersion(Version version)
-        {
-            string str = $"{version.Major}.{version.Minor}";
-            if (version.Build != 0)
-                str += $".{version.Build}";
-            return str;
-        }
-
         /// <summary>Get the display text for a color scheme.</summary>
         /// <param name="scheme">The color scheme.</param>
         private string GetDisplayText(MonitorColorScheme scheme)
@@ -582,38 +568,6 @@ namespace StardewModdingApi.Installer
         /// <param name="text">The text to print.</param>
         private void PrintSuccess(string text) => this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Success);
 
-        /// <summary>Get whether the current system has .NET Framework 4.5 or later installed. This only applies on Windows.</summary>
-        /// <param name="platform">The current platform.</param>
-        /// <exception cref="NotSupportedException">The current platform is not Windows.</exception>
-        private bool HasNetFramework45(Platform platform)
-        {
-            switch (platform)
-            {
-                case Platform.Windows:
-                    using (RegistryKey versionKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(@"SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full"))
-                        return versionKey?.GetValue("Release") != null; // .NET Framework 4.5+
-
-                default:
-                    throw new NotSupportedException("The installed .NET Framework version can only be checked on Windows.");
-            }
-        }
-
-        /// <summary>Get whether the current system has XNA Framework installed. This only applies on Windows.</summary>
-        /// <param name="platform">The current platform.</param>
-        /// <exception cref="NotSupportedException">The current platform is not Windows.</exception>
-        private bool HasXna(Platform platform)
-        {
-            switch (platform)
-            {
-                case Platform.Windows:
-                    using (RegistryKey key = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(@"SOFTWARE\Microsoft\XNA\Framework"))
-                        return key != null; // XNA Framework 4.0+
-
-                default:
-                    throw new NotSupportedException("The installed XNA Framework version can only be checked on Windows.");
-            }
-        }
-
         /// <summary>Interactively delete a file or folder path, and block until deletion completes.</summary>
         /// <param name="path">The file or folder path.</param>
         private void InteractivelyDelete(string path)
@@ -687,15 +641,12 @@ namespace StardewModdingApi.Installer
         }
 
         /// <summary>Interactively locate the game install path to update.</summary>
-        /// <param name="platform">The current platform.</param>
         /// <param name="toolkit">The mod toolkit.</param>
+        /// <param name="context">The installer context.</param>
         /// <param name="specifiedPath">The path specified as a command-line argument (if any), which should override automatic path detection.</param>
-        private DirectoryInfo InteractivelyGetInstallPath(Platform platform, ModToolkit toolkit, string specifiedPath)
+        private DirectoryInfo InteractivelyGetInstallPath(ModToolkit toolkit, InstallerContext context, string specifiedPath)
         {
-            // get executable name
-            string executableFilename = EnvironmentUtility.GetExecutableName(platform);
-
-            // validate specified path
+            // use specified path
             if (specifiedPath != null)
             {
                 var dir = new DirectoryInfo(specifiedPath);
@@ -704,7 +655,7 @@ namespace StardewModdingApi.Installer
                     this.PrintError($"You specified --game-path \"{specifiedPath}\", but that folder doesn't exist.");
                     return null;
                 }
-                if (!dir.EnumerateFiles(executableFilename).Any())
+                if (!context.LooksLikeGameFolder(dir))
                 {
                     this.PrintError($"You specified --game-path \"{specifiedPath}\", but that folder doesn't contain the Stardew Valley executable.");
                     return null;
@@ -712,7 +663,19 @@ namespace StardewModdingApi.Installer
                 return dir;
             }
 
-            // get installed paths
+            // use game folder which contains the installer, if any
+            {
+                DirectoryInfo curPath = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory;
+                while (curPath?.Parent != null) // must be in a folder (not at the root)
+                {
+                    if (context.LooksLikeGameFolder(curPath))
+                        return curPath;
+
+                    curPath = curPath.Parent;
+                }
+            }
+
+            // use an installed path
             DirectoryInfo[] defaultPaths = toolkit.GetGameFolders().ToArray();
             if (defaultPaths.Any())
             {
@@ -738,7 +701,7 @@ namespace StardewModdingApi.Installer
             while (true)
             {
                 // get path from user
-                this.PrintInfo($"Type the file path to the game directory (the one containing '{executableFilename}'), then press enter.");
+                this.PrintInfo($"Type the file path to the game directory (the one containing '{context.ExecutableName}'), then press enter.");
                 string path = Console.ReadLine()?.Trim();
                 if (string.IsNullOrWhiteSpace(path))
                 {
@@ -747,10 +710,9 @@ namespace StardewModdingApi.Installer
                 }
 
                 // normalize path
-                if (platform == Platform.Windows)
-                    path = path.Replace("\"", ""); // in Windows, quotes are used to escape spaces and aren't part of the file path
-                if (platform == Platform.Linux || platform == Platform.Mac)
-                    path = path.Replace("\\ ", " "); // in Linux/Mac, spaces in paths may be escaped if copied from the command line
+                path = context.IsWindows
+                    ? path.Replace("\"", "") // in Windows, quotes are used to escape spaces and aren't part of the file path
+                    : path.Replace("\\ ", " "); // in Linux/Mac, spaces in paths may be escaped if copied from the command line
                 if (path.StartsWith("~/"))
                 {
                     string home = Environment.GetEnvironmentVariable("HOME") ?? Environment.GetEnvironmentVariable("USERPROFILE");
@@ -768,7 +730,7 @@ namespace StardewModdingApi.Installer
                     this.PrintInfo("   That directory doesn't seem to exist.");
                     continue;
                 }
-                if (!directory.EnumerateFiles(executableFilename).Any())
+                if (!context.LooksLikeGameFolder(directory))
                 {
                     this.PrintInfo("   That directory doesn't contain a Stardew Valley executable.");
                     continue;
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 825988a5..d4c82180 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -14,21 +14,34 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
     /// <summary>Finds installed game folders.</summary>
     public class GameScanner
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The current OS.</summary>
+        private readonly Platform Platform;
+
+        /// <summary>The name of the Stardew Valley executable.</summary>
+        private readonly string ExecutableName;
+
+
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        public GameScanner()
+        {
+            this.Platform = EnvironmentUtility.DetectPlatform();
+            this.ExecutableName = EnvironmentUtility.GetExecutableName(this.Platform);
+        }
+
         /// <summary>Find all valid Stardew Valley install folders.</summary>
         /// <remarks>This checks default game locations, and on Windows checks the Windows registry for GOG/Steam install data. A folder is considered 'valid' if it contains the Stardew Valley executable for the current OS.</remarks>
         public IEnumerable<DirectoryInfo> Scan()
         {
-            // get OS info
-            Platform platform = EnvironmentUtility.DetectPlatform();
-            string executableFilename = EnvironmentUtility.GetExecutableName(platform);
-
             // get install paths
             IEnumerable<string> paths = this
-                .GetCustomInstallPaths(platform)
-                .Concat(this.GetDefaultInstallPaths(platform))
+                .GetCustomInstallPaths()
+                .Concat(this.GetDefaultInstallPaths())
                 .Select(PathUtilities.NormalizePath)
                 .Distinct(StringComparer.OrdinalIgnoreCase);
 
@@ -36,21 +49,27 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
             foreach (string path in paths)
             {
                 DirectoryInfo folder = new DirectoryInfo(path);
-                if (folder.Exists && folder.EnumerateFiles(executableFilename).Any())
+                if (this.LooksLikeGameFolder(folder))
                     yield return folder;
             }
         }
 
+        /// <summary>Get whether a folder seems to contain the game.</summary>
+        /// <param name="dir">The folder to check.</param>
+        public bool LooksLikeGameFolder(DirectoryInfo dir)
+        {
+            return dir.Exists && dir.EnumerateFiles(this.ExecutableName).Any();
+        }
+
 
         /*********
         ** Private methods
         *********/
         /// <summary>The default file paths where Stardew Valley can be installed.</summary>
-        /// <param name="platform">The target platform.</param>
-        /// <remarks>Derived from the crossplatform mod config: https://github.com/Pathoschild/Stardew.ModBuildConfig. </remarks>
-        private IEnumerable<string> GetDefaultInstallPaths(Platform platform)
+        /// <remarks>Derived from the <a href="https://github.com/Pathoschild/Stardew.ModBuildConfig">crossplatform mod config</a>.</remarks>
+        private IEnumerable<string> GetDefaultInstallPaths()
         {
-            switch (platform)
+            switch (this.Platform)
             {
                 case Platform.Linux:
                 case Platform.Mac:
@@ -102,16 +121,15 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                     break;
 
                 default:
-                    throw new InvalidOperationException($"Unknown platform '{platform}'.");
+                    throw new InvalidOperationException($"Unknown platform '{this.Platform}'.");
             }
         }
 
         /// <summary>Get the custom install path from the <c>stardewvalley.targets</c> file in the home directory, if any.</summary>
-        /// <param name="platform">The target platform.</param>
-        private IEnumerable<string> GetCustomInstallPaths(Platform platform)
+        private IEnumerable<string> GetCustomInstallPaths()
         {
             // get home path
-            string homePath = Environment.GetEnvironmentVariable(platform == Platform.Windows ? "USERPROFILE" : "HOME");
+            string homePath = Environment.GetEnvironmentVariable(this.Platform == Platform.Windows ? "USERPROFILE" : "HOME");
             if (string.IsNullOrWhiteSpace(homePath))
                 yield break;
 

From 1e2000126d32f883b820538ba6873a5d5e5f0d19 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 5 Dec 2020 12:49:06 -0500
Subject: [PATCH 002/856] update schema for Content Patcher 1.19

---
 .../wwwroot/schemas/content-patcher.json      | 37 +++++++++++++------
 1 file changed, 25 insertions(+), 12 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index e52cd757..92149f4d 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -11,9 +11,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features and avoid obsolete behavior.",
             "type": "string",
-            "const": "1.18.0",
+            "const": "1.19.0",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.18.0'."
+                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.19.0'."
             }
         },
         "ConfigSchema": {
@@ -147,13 +147,16 @@
                     },
                     "Update": {
                         "title": "Update",
-                        "description": "When the patch should update if it changed. The possible values are 'OnDayStart' and 'OnLocationChange' (defaults to OnDayStart).",
+                        "description": "When the patch should update if it changed. The possible values are 'OnDayStart', 'OnLocationChange', or 'OnTimeChange' (defaults to OnDayStart).",
                         "type": "string",
-                        "enum": [ "OnDayStart", "OnLocationChange" ]
+                        "pattern": "^ *((OnDayStart|OnLocationChange|OnTimeChange), *)*(OnDayStart|OnLocationChange|OnTimeChange) *$",
+                        "@errorMessages": {
+                            "pattern": "Invalid value; must be 'OnDayStart', 'OnLocationChange', 'OnTimeChange', or a comma-delimited combination of those values."
+                        }
                     },
                     "FromFile": {
                         "title": "Source file",
-                        "description": "The relative file path in your content pack folder to load instead (like 'assets/dinosaur.png'). This can be a .json (data), .png (image), .tbin or .tmx (map), or .xnb file. This field supports tokens and capitalization doesn't matter.",
+                        "description": "The relative file path in your content pack folder to load instead (like 'assets/dinosaur.png'), or multiple comma-delimited values. This can be a .json (data), .png (image), .tbin or .tmx (map), or .xnb file. This field supports tokens and capitalization doesn't matter.",
                         "type": "string",
                         "allOf": [
                             {
@@ -180,13 +183,6 @@
                         "description": "The part of the target image to replace. Defaults to the FromArea size starting from the top-left corner.",
                         "$ref": "#/definitions/Rectangle"
                     },
-                    "PatchMode": {
-                        "title": "Patch mode",
-                        "description": "How to apply FromArea to ToArea. Defaults to Replace.",
-                        "type": "string",
-                        "enum": [ "Replace", "Overlay" ],
-                        "default": "Replace"
-                    },
                     "Fields": {
                         "title": "Fields",
                         "description": "The individual fields you want to change for existing entries. This field supports tokens in field keys and values. The key for each field is the field index (starting at zero) for a slash-delimited string, or the field name for an object.",
@@ -359,6 +355,15 @@
                             }
                         },
                         "then": {
+                            "properties": {
+                                "PatchMode": {
+                                    "title": "Patch mode",
+                                    "description": "How to apply FromArea to ToArea. Defaults to Replace.",
+                                    "type": "string",
+                                    "enum": [ "Replace", "Overlay" ],
+                                    "default": "Replace"
+                                }
+                            },
                             "required": [ "FromFile", "Target" ],
                             "propertyNames": {
                                 "enum": [
@@ -417,6 +422,13 @@
                                 },
                                 "ToArea": {
                                     "description": "The part of the target map to replace."
+                                },
+                                "PatchMode": {
+                                    "title": "Patch mode",
+                                    "description": "How to apply FromArea to ToArea. Defaults to ReplaceByLayer.",
+                                    "type": "string",
+                                    "enum": [ "Overlay", "Replace", "ReplaceByLayer" ],
+                                    "default": "ReplaceByLayer"
                                 }
                             },
                             "propertyNames": {
@@ -432,6 +444,7 @@
                                     "FromArea",
                                     "MapProperties",
                                     "MapTiles",
+                                    "PatchMode",
                                     "TextOperations",
                                     "ToArea"
                                 ]

From 1c70736c00e6e70f46f539cb26b5fd253f4eff3b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 8 Dec 2020 08:23:16 -0500
Subject: [PATCH 003/856] clarify not-a-mod error when SMAPI installer is in
 mods folder

---
 docs/release-notes.md                                 |  1 +
 src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs | 10 ++++++++++
 2 files changed, 11 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8043212e..0bbbeb58 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * When the installer is run from within a game folder, it now installs SMAPI to that folder. That simplifies installation if you have multiple copies of the game or it can't otherwise auto-detect the game path.
+  * Clarified not-a-mod error when the SMAPI installer is in the `Mods` folder.
 
 ## 3.7.6
 Released 21 November 2020 for Stardew Valley 1.4.1 or later.
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 6d6b6417..5eacee9e 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -112,10 +112,20 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             if (manifestFile == null)
             {
                 FileInfo[] files = this.RecursivelyGetRelevantFiles(searchFolder).ToArray();
+
+                // empty folder
                 if (!files.Any())
                     return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.EmptyFolder, "it's an empty folder.");
+
+                // XNB mod
                 if (files.All(this.IsPotentialXnbFile))
                     return new ModFolder(root, searchFolder, ModType.Xnb, null, ModParseError.XnbMod, "it's not a SMAPI mod (see https://smapi.io/xnb for info).");
+
+                // SMAPI installer
+                if (files.Any(p => p.Name == "install on Linux.sh" || p.Name == "install on Mac.command" || p.Name == "install on Windows.bat"))
+                    return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.ManifestMissing, "the SMAPI installer isn't a mod (you can delete this folder after running the installer file).");
+
+                // not a mod?
                 return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.ManifestMissing, "it contains files, but none of them are manifest.json.");
             }
 

From 50a146d1c9a228391c4201685a5e0df9daa529e9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:34:58 -0500
Subject: [PATCH 004/856] update game version

---
 docs/release-notes.md  | 4 ++++
 src/SMAPI/Constants.cs | 4 ++--
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1115f482..00445832 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Updated for Stardew Valley 1.5.
+
 ## 3.7.6
 Released 21 November 2020 for Stardew Valley 1.4.1 or later.
 
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 88f79811..5ff324b0 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,10 +54,10 @@ namespace StardewModdingAPI
         public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.7.6");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.4.1");
+        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.0");
 
         /// <summary>The maximum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MaximumGameVersion { get; } = new GameVersion("1.4.5");
+        public static ISemanticVersion MaximumGameVersion { get; } = null;
 
         /// <summary>The target game platform.</summary>
         public static GamePlatform TargetPlatform { get; } = EarlyConstants.Platform;

From 2e8c7e06c5c46834b570b667cb7497fe4cc408ac Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:34:59 -0500
Subject: [PATCH 005/856] update for split-screen mode

This includes splitting GameRunner (the main game instance) from Game1 (now a per-screen game state), adding a PerScreen<T> utility to simplify per-screen values, adding separate per-screen input handling and events, adding new Context fields for split-screen, and logging the screen ID in split-screen mode to distinguish log entries.
---
 docs/release-notes.md                         |   6 +-
 .../Framework/LogParsing/LogMessageBuilder.cs |   8 +-
 .../Framework/LogParsing/LogParser.cs         |   4 +-
 .../Framework/LogParsing/Models/LogMessage.cs |   3 +
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  11 +-
 src/SMAPI/Constants.cs                        |   3 +
 src/SMAPI/Context.cs                          |  79 +++-
 src/SMAPI/Framework/Logging/LogManager.cs     |   5 +-
 src/SMAPI/Framework/ModHelpers/DataHelper.cs  |   8 +-
 src/SMAPI/Framework/ModHelpers/InputHelper.cs |  21 +-
 src/SMAPI/Framework/ModHelpers/ModHelper.cs   |   6 +-
 src/SMAPI/Framework/Monitor.cs                |  11 +-
 src/SMAPI/Framework/SCore.cs                  | 402 ++++++++++--------
 src/SMAPI/Framework/SGame.cs                  | 121 ++++--
 src/SMAPI/Framework/SGameRunner.cs            | 156 +++++++
 src/SMAPI/Utilities/PerScreen.cs              |  79 ++++
 16 files changed, 646 insertions(+), 277 deletions(-)
 create mode 100644 src/SMAPI/Framework/SGameRunner.cs
 create mode 100644 src/SMAPI/Utilities/PerScreen.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 00445832..176961d4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,11 @@
 
 ## Upcoming release
 * For players:
-  * Updated for Stardew Valley 1.5.
+  * Updated for Stardew Valley 1.5, including split-screen support.
+
+* For modders:
+  * Added `PerScreen<T>` utility and new `Context` fields to simplify split-screen support in mods.
+  * Added screen ID to log when playing in split-screen mode.
 
 ## 3.7.6
 Released 21 November 2020 for Stardew Valley 1.4.1 or later.
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs b/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
index 42e283a9..992876ef 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
@@ -16,6 +16,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         /// <summary>The log level for the next log message.</summary>
         public LogLevel Level { get; set; }
 
+        /// <summary>The screen ID in split-screen mode.</summary>
+        public int ScreenId { get; set; }
+
         /// <summary>The mod name for the next log message.</summary>
         public string Mod { get; set; }
 
@@ -36,10 +39,11 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         /// <summary>Start accumulating values for a new log message.</summary>
         /// <param name="time">The local time when the log was posted.</param>
         /// <param name="level">The log level.</param>
+        /// <param name="screenId">The screen ID in split-screen mode.</param>
         /// <param name="mod">The mod name.</param>
         /// <param name="text">The initial log text.</param>
         /// <exception cref="InvalidOperationException">A log message is already started; call <see cref="Clear"/> before starting a new message.</exception>
-        public void Start(string time, LogLevel level, string mod, string text)
+        public void Start(string time, LogLevel level, int screenId, string mod, string text)
         {
             if (this.Started)
                 throw new InvalidOperationException("Can't start new message, previous log message isn't done yet.");
@@ -48,6 +52,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
 
             this.Time = time;
             this.Level = level;
+            this.ScreenId = screenId;
             this.Mod = mod;
             this.Text.Append(text);
         }
@@ -74,6 +79,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
             {
                 Time = this.Time,
                 Level = this.Level,
+                ScreenId = this.ScreenId,
                 Mod = this.Mod,
                 Text = this.Text.ToString()
             };
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 227dcd89..f69d4b6f 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         ** Fields
         *********/
         /// <summary>A regex pattern matching the start of a SMAPI message.</summary>
-        private readonly Regex MessageHeaderPattern = new Regex(@"^\[(?<time>\d\d[:\.]\d\d[:\.]\d\d) (?<level>[a-z]+) +(?<modName>[^\]]+)\] ", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex MessageHeaderPattern = new Regex(@"^\[(?<time>\d\d[:\.]\d\d[:\.]\d\d) (?<level>[a-z]+)(?: +screen_(?<screen>\d+))? +(?<modName>[^\]]+)\] ", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching SMAPI's initial platform info message.</summary>
         private readonly Regex InfoLinePattern = new Regex(@"^SMAPI (?<apiVersion>.+) with Stardew Valley (?<gameVersion>.+) on (?<os>.+)", RegexOptions.Compiled | RegexOptions.IgnoreCase);
@@ -304,9 +304,11 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                         builder.Clear();
                     }
 
+                    var screenGroup = header.Groups["screen"];
                     builder.Start(
                         time: header.Groups["time"].Value,
                         level: Enum.Parse<LogLevel>(header.Groups["level"].Value, ignoreCase: true),
+                        screenId: screenGroup.Success ? int.Parse(screenGroup.Value) : 0, // main player is always screen ID 0
                         mod: header.Groups["modName"].Value,
                         text: line.Substring(header.Length)
                     );
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
index f7c99d02..1e08be78 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
@@ -12,6 +12,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         /// <summary>The log level.</summary>
         public LogLevel Level { get; set; }
 
+        /// <summary>The screen ID in split-screen mode.</summary>
+        public int ScreenId { get; set; }
+
         /// <summary>The mod name.</summary>
         public string Mod { get; set; }
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index d4ff4f10..fd472673 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -13,6 +13,8 @@
         .ToDictionary(level => level.ToString().ToLower(), level => level != LogLevel.Trace);
 
     string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true);
+
+    ISet<int> screenIds = new HashSet<int>(Model.ParsedLog?.Messages?.Select(p => p.ScreenId) ?? new int[0]);
 }
 
 @section Head {
@@ -35,7 +37,8 @@
                 showMods: @this.ForJson(Model.ParsedLog?.Mods?.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, slug => true)),
                 showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, section => false)),
                 showLevels: @this.ForJson(defaultFilters),
-                enableFilters: @this.ForJson(!Model.ShowRaw)
+                enableFilters: @this.ForJson(!Model.ShowRaw),
+                screenIds: @this.ForJson(screenIds)
             }, '@this.Url.PlainAction("Index", "LogParser", values: null)');
         });
     </script>
@@ -305,6 +308,10 @@ else if (Model.ParsedLog?.IsValid == true)
                         @if (message.IsStartOfSection) { <text> v-on:click="toggleSection('@message.Section')" </text> }
                         v-show="filtersAllow('@Model.GetSlug(message.Mod)', '@levelStr') @sectionFilter">
                         <td v-pre>@message.Time</td>
+                        @if (screenIds.Count > 1)
+                        {
+                            <td v-pre>screen_@message.ScreenId</td>
+                        }
                         <td v-pre>@message.Level.ToString().ToUpper()</td>
                         <td v-pre data-title="@message.Mod">@message.Mod</td>
                         <td>
@@ -325,7 +332,7 @@ else if (Model.ParsedLog?.IsValid == true)
                     if (message.Repeated > 0)
                     {
                         <tr class="@levelStr mod mod-repeat" v-show="filtersAllow('@Model.GetSlug(message.Mod)', '@levelStr') @sectionFilter">
-                            <td colspan="3"></td>
+                            <td colspan="4"></td>
                             <td v-pre><i>repeats [@message.Repeated] times.</i></td>
                         </tr>
                     }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 5ff324b0..d0f34cee 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -39,6 +39,9 @@ namespace StardewModdingAPI
 
         /// <summary>The game's assembly name.</summary>
         internal static string GameAssemblyName => EarlyConstants.Platform == GamePlatform.Windows ? "Stardew Valley" : "StardewValley";
+
+        /// <summary>The <see cref="Context.ScreenId"/> value which should appear in the SMAPI log, if any.</summary>
+        internal static int? LogScreenId { get; set; }
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>
diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index a7238b32..b1b33cd6 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -1,5 +1,7 @@
+using System.Collections.Generic;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Events;
+using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.Menus;
 
@@ -8,17 +10,50 @@ namespace StardewModdingAPI
     /// <summary>Provides information about the current game state.</summary>
     public static class Context
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Whether the player has loaded a save and the world has finished initializing.</summary>
+        private static readonly PerScreen<bool> IsWorldReadyForScreen = new PerScreen<bool>();
+
+        /// <summary>The current stage in the game's loading process.</summary>
+        private static readonly PerScreen<LoadStage> LoadStageForScreen = new PerScreen<LoadStage>();
+
+        /// <summary>Whether a player save has been loaded.</summary>
+        internal static bool IsSaveLoaded => Game1.hasLoadedGame && !(Game1.activeClickableMenu is TitleMenu);
+
+        /// <summary>Whether the game is currently writing to the save file.</summary>
+        internal static bool IsSaving => Game1.activeClickableMenu is SaveGameMenu || Game1.activeClickableMenu is ShippingMenu; // saving is performed by SaveGameMenu, but it's wrapped by ShippingMenu on days when the player shipping something
+
+        /// <summary>The active split-screen instance IDs.</summary>
+        internal static readonly ISet<int> ActiveScreenIds = new HashSet<int>();
+
+        /// <summary>The last screen ID that was removed from the game, used to synchronize <see cref="PerScreen{T}"/>.</summary>
+        internal static int LastRemovedScreenId = -1;
+
+        /// <summary>The current stage in the game's loading process.</summary>
+        internal static LoadStage LoadStage
+        {
+            get => Context.LoadStageForScreen.Value;
+            set => Context.LoadStageForScreen.Value = value;
+        }
+
+
         /*********
         ** Accessors
         *********/
         /****
-        ** Public
+        ** Game/player state
         ****/
         /// <summary>Whether the game has performed core initialization. This becomes true right before the first update tick.</summary>
         public static bool IsGameLaunched { get; internal set; }
 
         /// <summary>Whether the player has loaded a save and the world has finished initializing.</summary>
-        public static bool IsWorldReady { get; internal set; }
+        public static bool IsWorldReady
+        {
+            get => Context.IsWorldReadyForScreen.Value;
+            set => Context.IsWorldReadyForScreen.Value = value;
+        }
 
         /// <summary>Whether <see cref="IsWorldReady"/> is true and the player is free to act in the world (no menu is displayed, no cutscene is in progress, etc).</summary>
         public static bool IsPlayerFree => Context.IsWorldReady && Game1.currentLocation != null && Game1.activeClickableMenu == null && !Game1.dialogueUp && (!Game1.eventUp || Game1.isFestival());
@@ -29,22 +64,36 @@ namespace StardewModdingAPI
         /// <summary>Whether the game is currently running the draw loop. This isn't relevant to most mods, since you should use <see cref="IDisplayEvents"/> events to draw to the screen.</summary>
         public static bool IsInDrawLoop { get; internal set; }
 
-        /// <summary>Whether <see cref="IsWorldReady"/> and the player loaded the save in multiplayer mode (regardless of whether any other players are connected).</summary>
-        public static bool IsMultiplayer => Context.IsWorldReady && Game1.multiplayerMode != Game1.singlePlayer;
-
-        /// <summary>Whether <see cref="IsWorldReady"/> and the current player is the main player. This is always true in single-player, and true when hosting in multiplayer.</summary>
-        public static bool IsMainPlayer => Context.IsWorldReady && Game1.IsMasterGame;
-
         /****
-        ** Internal
+        ** Multiplayer
         ****/
-        /// <summary>Whether a player save has been loaded.</summary>
-        internal static bool IsSaveLoaded => Game1.hasLoadedGame && !(Game1.activeClickableMenu is TitleMenu);
+        /// <summary>The unique ID of the current screen in split-screen mode. A screen is always assigned a new ID when it's opened (so a player who quits and rejoins has a new screen ID).</summary>
+        public static int ScreenId => Game1.game1?.instanceId ?? 0;
 
-        /// <summary>Whether the game is currently writing to the save file.</summary>
-        internal static bool IsSaving => Game1.activeClickableMenu is SaveGameMenu || Game1.activeClickableMenu is ShippingMenu; // saving is performed by SaveGameMenu, but it's wrapped by ShippingMenu on days when the player shipping something
+        /// <summary>Whether the game is running in multiplayer or split-screen mode (regardless of whether any other players are connected). See <see cref="IsSplitScreen"/> and <see cref="HasRemotePlayers"/> for more specific checks.</summary>
+        public static bool IsMultiplayer => Context.IsSplitScreen || (Context.IsWorldReady && Game1.multiplayerMode != Game1.singlePlayer);
 
-        /// <summary>The current stage in the game's loading process.</summary>
-        internal static LoadStage LoadStage { get; set; }
+        /// <summary>Whether this player is running on the main player's computer. This is true for both the main player and split-screen players.</summary>
+        public static bool IsOnHostComputer => Context.IsMainPlayer || Context.IsSplitScreen;
+
+        /// <summary>Whether the current player is playing in a split-screen. This is only applicable when <see cref="IsOnHostComputer"/> is true, since split-screen players on another computer are just regular remote players.</summary>
+        public static bool IsSplitScreen => LocalMultiplayer.IsLocalMultiplayer();
+
+        /// <summary>Whether there are players connected over the network.</summary>
+        public static bool HasRemotePlayers => Context.IsMultiplayer && !Game1.hasLocalClientsOnly;
+
+        /// <summary>Whether the current player is the main player. This is always true in single-player, and true when hosting in multiplayer.</summary>
+        public static bool IsMainPlayer => Game1.IsMasterGame && !(TitleMenu.subMenu is FarmhandMenu);
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get whether a screen ID is still active.</summary>
+        /// <param name="id">The screen ID.</param>
+        public static bool HasScreenId(int id)
+        {
+            return Context.ActiveScreenIds.Contains(id);
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 1e484709..a2c0125e 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -84,10 +84,11 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="writeToConsole">Whether to output log messages to the console.</param>
         /// <param name="isVerbose">Whether verbose logging is enabled. This enables more detailed diagnostic messages than are normally needed.</param>
         /// <param name="isDeveloperMode">Whether to enable full console output for developers.</param>
-        public LogManager(string logPath, ColorSchemeConfig colorConfig, bool writeToConsole, bool isVerbose, bool isDeveloperMode)
+        /// <param name="getScreenIdForLog">Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</param>
+        public LogManager(string logPath, ColorSchemeConfig colorConfig, bool writeToConsole, bool isVerbose, bool isDeveloperMode, Func<int?> getScreenIdForLog)
         {
             // init construction logic
-            this.GetMonitorImpl = name => new Monitor(name, this.IgnoreChar, this.LogFile, colorConfig, isVerbose)
+            this.GetMonitorImpl = name => new Monitor(name, this.IgnoreChar, this.LogFile, colorConfig, isVerbose, getScreenIdForLog)
             {
                 WriteToConsole = writeToConsole,
                 ShowTraceInConsole = isDeveloperMode,
diff --git a/src/SMAPI/Framework/ModHelpers/DataHelper.cs b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
index 41612387..0fe3209f 100644
--- a/src/SMAPI/Framework/ModHelpers/DataHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
@@ -69,8 +69,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             if (Context.LoadStage == LoadStage.None)
                 throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.ReadSaveData)} when a save file isn't loaded.");
-            if (!Game1.IsMasterGame)
-                throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.ReadSaveData)} because this isn't the main player. (Save files are stored on the main player's computer.)");
+            if (!Context.IsOnHostComputer)
+                throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.ReadSaveData)} when connected to a remote host. (Save files are stored on the main player's computer.)");
 
 
             string internalKey = this.GetSaveFileKey(key);
@@ -87,8 +87,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             if (Context.LoadStage == LoadStage.None)
                 throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.WriteSaveData)} when a save file isn't loaded.");
-            if (!Game1.IsMasterGame)
-                throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.WriteSaveData)} because this isn't the main player. (Save files are stored on the main player's computer.)");
+            if (!Context.IsOnHostComputer)
+                throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.WriteSaveData)} when connected to a remote host. (Save files are stored on the main player's computer.)");
 
             string internalKey = this.GetSaveFileKey(key);
             string data = model != null
diff --git a/src/SMAPI/Framework/ModHelpers/InputHelper.cs b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
index 09ce3c65..e1317544 100644
--- a/src/SMAPI/Framework/ModHelpers/InputHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
@@ -1,3 +1,4 @@
+using System;
 using StardewModdingAPI.Framework.Input;
 
 namespace StardewModdingAPI.Framework.ModHelpers
@@ -8,8 +9,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /*********
         ** Accessors
         *********/
-        /// <summary>Manages the game's input state.</summary>
-        private readonly SInputState InputState;
+        /// <summary>Manages the game's input state for the current player instance. That may not be the main player in split-screen mode.</summary>
+        private readonly Func<SInputState> CurrentInputState;
 
 
         /*********
@@ -17,41 +18,41 @@ namespace StardewModdingAPI.Framework.ModHelpers
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="modID">The unique ID of the relevant mod.</param>
-        /// <param name="inputState">Manages the game's input state.</param>
-        public InputHelper(string modID, SInputState inputState)
+        /// <param name="currentInputState">Manages the game's input state for the current player instance. That may not be the main player in split-screen mode.</param>
+        public InputHelper(string modID, Func<SInputState> currentInputState)
             : base(modID)
         {
-            this.InputState = inputState;
+            this.CurrentInputState = currentInputState;
         }
 
         /// <inheritdoc />
         public ICursorPosition GetCursorPosition()
         {
-            return this.InputState.CursorPosition;
+            return this.CurrentInputState().CursorPosition;
         }
 
         /// <inheritdoc />
         public bool IsDown(SButton button)
         {
-            return this.InputState.IsDown(button);
+            return this.CurrentInputState().IsDown(button);
         }
 
         /// <inheritdoc />
         public bool IsSuppressed(SButton button)
         {
-            return this.InputState.IsSuppressed(button);
+            return this.CurrentInputState().IsSuppressed(button);
         }
 
         /// <inheritdoc />
         public void Suppress(SButton button)
         {
-            this.InputState.OverrideButton(button, setDown: false);
+            this.CurrentInputState().OverrideButton(button, setDown: false);
         }
 
         /// <inheritdoc />
         public SButtonState GetState(SButton button)
         {
-            return this.InputState.GetState(button);
+            return this.CurrentInputState().GetState(button);
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index d9fc8621..058bff83 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -51,7 +51,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Construct an instance.</summary>
         /// <param name="modID">The mod's unique ID.</param>
         /// <param name="modDirectory">The full path to the mod's folder.</param>
-        /// <param name="inputState">Manages the game's input state.</param>
+        /// <param name="currentInputState">Manages the game's input state for the current player instance. That may not be the main player in split-screen mode.</param>
         /// <param name="events">Manages access to events raised by SMAPI.</param>
         /// <param name="contentHelper">An API for loading content assets.</param>
         /// <param name="contentPackHelper">An API for managing content packs.</param>
@@ -63,7 +63,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="translationHelper">An API for reading translations stored in the mod's <c>i18n</c> folder.</param>
         /// <exception cref="ArgumentNullException">An argument is null or empty.</exception>
         /// <exception cref="InvalidOperationException">The <paramref name="modDirectory"/> path does not exist on disk.</exception>
-        public ModHelper(string modID, string modDirectory, SInputState inputState, IModEvents events, IContentHelper contentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper)
+        public ModHelper(string modID, string modDirectory, Func<SInputState> currentInputState, IModEvents events, IContentHelper contentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper)
             : base(modID)
         {
             // validate directory
@@ -77,7 +77,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.Content = contentHelper ?? throw new ArgumentNullException(nameof(contentHelper));
             this.ContentPacks = contentPackHelper ?? throw new ArgumentNullException(nameof(contentPackHelper));
             this.Data = dataHelper ?? throw new ArgumentNullException(nameof(dataHelper));
-            this.Input = new InputHelper(modID, inputState);
+            this.Input = new InputHelper(modID, currentInputState);
             this.ModRegistry = modRegistry ?? throw new ArgumentNullException(nameof(modRegistry));
             this.ConsoleCommands = commandHelper ?? throw new ArgumentNullException(nameof(commandHelper));
             this.Reflection = reflectionHelper ?? throw new ArgumentNullException(nameof(reflectionHelper));
diff --git a/src/SMAPI/Framework/Monitor.cs b/src/SMAPI/Framework/Monitor.cs
index 533420a5..04e67d68 100644
--- a/src/SMAPI/Framework/Monitor.cs
+++ b/src/SMAPI/Framework/Monitor.cs
@@ -30,6 +30,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>A cache of messages that should only be logged once.</summary>
         private readonly HashSet<string> LogOnceCache = new HashSet<string>();
 
+        /// <summary>Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</summary>
+        private readonly Func<int?> GetScreenIdForLog;
+
 
         /*********
         ** Accessors
@@ -56,7 +59,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="logFile">The log file to which to write messages.</param>
         /// <param name="colorConfig">The colors to use for text written to the SMAPI console.</param>
         /// <param name="isVerbose">Whether verbose logging is enabled. This enables more detailed diagnostic messages than are normally needed.</param>
-        public Monitor(string source, char ignoreChar, LogFileManager logFile, ColorSchemeConfig colorConfig, bool isVerbose)
+        /// <param name="getScreenIdForLog">Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</param>
+        public Monitor(string source, char ignoreChar, LogFileManager logFile, ColorSchemeConfig colorConfig, bool isVerbose, Func<int?> getScreenIdForLog)
         {
             // validate
             if (string.IsNullOrWhiteSpace(source))
@@ -68,6 +72,7 @@ namespace StardewModdingAPI.Framework
             this.ConsoleWriter = new ColorfulConsoleWriter(Constants.Platform, colorConfig);
             this.IgnoreChar = ignoreChar;
             this.IsVerbose = isVerbose;
+            this.GetScreenIdForLog = getScreenIdForLog;
         }
 
         /// <inheritdoc />
@@ -143,7 +148,9 @@ namespace StardewModdingAPI.Framework
         private string GenerateMessagePrefix(string source, ConsoleLogLevel level)
         {
             string levelStr = level.ToString().ToUpper().PadRight(Monitor.MaxLevelLength);
-            return $"[{DateTime.Now:HH:mm:ss} {levelStr} {source}]";
+            int? playerIndex = this.GetScreenIdForLog();
+
+            return $"[{DateTime.Now:HH:mm:ss} {levelStr}{(playerIndex != null ? $" screen_{playerIndex}" : "")} {source}]";
         }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 1b4c32bb..a7f8fbed 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -85,17 +85,14 @@ namespace StardewModdingAPI.Framework
         private readonly CommandManager CommandManager = new CommandManager();
 
         /// <summary>The underlying game instance.</summary>
-        private SGame Game;
-
-        /// <summary>Manages input visible to the game.</summary>
-        private SInputState Input => SGame.Input;
-
-        /// <summary>The game's core multiplayer utility.</summary>
-        private SMultiplayer Multiplayer => SGame.Multiplayer;
+        private SGameRunner Game;
 
         /// <summary>SMAPI's content manager.</summary>
         private ContentCoordinator ContentCore;
 
+        /// <summary>The game's core multiplayer utility for the main player.</summary>
+        private SMultiplayer Multiplayer;
+
         /// <summary>Tracks the installed mods.</summary>
         /// <remarks>This is initialized after the game starts.</remarks>
         private readonly ModRegistry ModRegistry = new ModRegistry();
@@ -103,11 +100,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>Manages SMAPI events for mods.</summary>
         private readonly EventManager EventManager;
 
-        /// <summary>Monitors the entire game state for changes.</summary>
-        private WatcherCore Watchers;
-
-        /// <summary>A snapshot of the current <see cref="Watchers"/> state.</summary>
-        private readonly WatcherSnapshot WatcherSnapshot = new WatcherSnapshot();
 
         /****
         ** State
@@ -127,25 +119,15 @@ namespace StardewModdingAPI.Framework
         /// <summary>Whether post-game-startup initialization has been performed.</summary>
         private bool IsInitialized;
 
+        /// <summary>Whether the player just returned to the title screen.</summary>
+        public bool JustReturnedToTitle { get; set; }
+
         /// <summary>The maximum number of consecutive attempts SMAPI should make to recover from an update error.</summary>
         private readonly Countdown UpdateCrashTimer = new Countdown(60); // 60 ticks = roughly one second
 
-        /// <summary>The number of ticks until SMAPI should notify mods that the game has loaded.</summary>
-        /// <remarks>Skipping a few frames ensures the game finishes initializing the world before mods try to change it.</remarks>
-        private readonly Countdown AfterLoadTimer = new Countdown(5);
-
         /// <summary>Whether custom content was removed from the save data to avoid a crash.</summary>
         private bool IsSaveContentRemoved;
 
-        /// <summary>Whether the game is saving and SMAPI has already raised <see cref="IGameLoopEvents.Saving"/>.</summary>
-        private bool IsBetweenSaveEvents;
-
-        /// <summary>Whether the game is creating the save file and SMAPI has already raised <see cref="IGameLoopEvents.SaveCreating"/>.</summary>
-        private bool IsBetweenCreateEvents;
-
-        /// <summary>Whether the player just returned to the title screen.</summary>
-        private bool JustReturnedToTitle;
-
         /// <summary>Asset interceptors added or removed since the last tick.</summary>
         private readonly List<AssetInterceptorChange> ReloadAssetInterceptorsQueue = new List<AssetInterceptorChange>();
 
@@ -191,7 +173,7 @@ namespace StardewModdingAPI.Framework
             if (File.Exists(Constants.ApiUserConfigPath))
                 JsonConvert.PopulateObject(File.ReadAllText(Constants.ApiUserConfigPath), this.Settings);
 
-            this.LogManager = new LogManager(logPath: logPath, colorConfig: this.Settings.ConsoleColors, writeToConsole: writeToConsole, isVerbose: this.Settings.VerboseLogging, isDeveloperMode: this.Settings.DeveloperMode);
+            this.LogManager = new LogManager(logPath: logPath, colorConfig: this.Settings.ConsoleColors, writeToConsole: writeToConsole, isVerbose: this.Settings.VerboseLogging, isDeveloperMode: this.Settings.DeveloperMode, getScreenIdForLog: this.GetScreenIdForLog);
 
             SCore.PerformanceMonitor = new PerformanceMonitor(this.Monitor);
             this.EventManager = new EventManager(this.ModRegistry, SCore.PerformanceMonitor);
@@ -250,22 +232,22 @@ namespace StardewModdingAPI.Framework
                 LocalizedContentManager.OnLanguageChange += locale => this.OnLocaleChanged();
 
                 // override game
-                var multiplayer = new SMultiplayer(this.Monitor, this.EventManager, this.Toolkit.JsonHelper, this.ModRegistry, this.Reflection, this.OnModMessageReceived, this.Settings.LogNetworkTraffic);
-                var modHooks = new SModHooks(this.OnNewDayAfterFade);
+                this.Multiplayer = new SMultiplayer(this.Monitor, this.EventManager, this.Toolkit.JsonHelper, this.ModRegistry, this.Reflection, this.OnModMessageReceived, this.Settings.LogNetworkTraffic);
                 SGame.CreateContentManagerImpl = this.CreateContentManager; // must be static since the game accesses it before the SGame constructor is called
-                this.Game = new SGame(
+                this.Game = new SGameRunner(
                     monitor: this.Monitor,
                     reflection: this.Reflection,
                     eventManager: this.EventManager,
-                    modHooks: modHooks,
-                    multiplayer: multiplayer,
+                    modHooks: new SModHooks(this.OnNewDayAfterFade),
+                    multiplayer: this.Multiplayer,
                     exitGameImmediately: this.ExitGameImmediately,
 
                     onGameContentLoaded: this.OnGameContentLoaded,
                     onGameUpdating: this.OnGameUpdating,
+                    onPlayerInstanceUpdating: this.OnPlayerInstanceUpdating,
                     onGameExiting: this.OnGameExiting
                 );
-                StardewValley.Program.gamePtr = this.Game;
+                StardewValley.GameRunner.instance = this.Game;
 
                 // apply game patches
                 new GamePatcher(this.Monitor).Apply(
@@ -422,12 +404,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>Raised after the game finishes initializing.</summary>
         private void OnGameInitialized()
         {
-            // set initial state
-            this.Input.TrueUpdate();
-
-            // init watchers
-            this.Watchers = new WatcherCore(this.Input, this.Game.GetObservableLocations());
-
             // validate XNB integrity
             if (!this.ValidateContentIntegrity())
                 this.Monitor.Log("SMAPI found problems in your game's content files which are likely to cause errors or crashes. Consider uninstalling XNB mods or reinstalling the game.", LogLevel.Error);
@@ -460,8 +436,6 @@ namespace StardewModdingAPI.Framework
         /// <param name="runGameUpdate">Invoke the game's update logic.</param>
         private void OnGameUpdating(GameTime gameTime, Action runGameUpdate)
         {
-            var events = this.EventManager;
-
             try
             {
                 /*********
@@ -471,15 +445,6 @@ namespace StardewModdingAPI.Framework
                 SCore.DeprecationManager.PrintQueued();
                 SCore.PerformanceMonitor.PrintQueuedAlerts();
 
-                // reapply overrides
-                if (this.JustReturnedToTitle)
-                {
-                    if (!(Game1.mapDisplayDevice is SDisplayDevice))
-                        Game1.mapDisplayDevice = this.GetMapDisplayDevice();
-
-                    this.JustReturnedToTitle = false;
-                }
-
                 /*********
                 ** First-tick initialization
                 *********/
@@ -489,16 +454,6 @@ namespace StardewModdingAPI.Framework
                     this.OnGameInitialized();
                 }
 
-                /*********
-                ** Update input
-                *********/
-                // This should *always* run, even when suppressing mod events, since the game uses
-                // this too. For example, doing this after mod event suppression would prevent the
-                // user from doing anything on the overnight shipping screen.
-                SInputState inputState = this.Input;
-                if (this.Game.IsActive)
-                    inputState.TrueUpdate();
-
                 /*********
                 ** Special cases
                 *********/
@@ -509,98 +464,6 @@ namespace StardewModdingAPI.Framework
                     return;
                 }
 
-                // Run async tasks synchronously to avoid issues due to mod events triggering
-                // concurrently with game code.
-                bool saveParsed = false;
-                if (Game1.currentLoader != null)
-                {
-                    this.Monitor.Log("Game loader synchronizing...");
-                    while (Game1.currentLoader?.MoveNext() == true)
-                    {
-                        // raise load stage changed
-                        switch (Game1.currentLoader.Current)
-                        {
-                            case 20 when (!saveParsed && SaveGame.loaded != null):
-                                saveParsed = true;
-                                this.OnLoadStageChanged(LoadStage.SaveParsed);
-                                break;
-
-                            case 36:
-                                this.OnLoadStageChanged(LoadStage.SaveLoadedBasicInfo);
-                                break;
-
-                            case 50:
-                                this.OnLoadStageChanged(LoadStage.SaveLoadedLocations);
-                                break;
-
-                            default:
-                                if (Game1.gameMode == Game1.playingGameMode)
-                                    this.OnLoadStageChanged(LoadStage.Preloaded);
-                                break;
-                        }
-                    }
-
-                    Game1.currentLoader = null;
-                    this.Monitor.Log("Game loader done.");
-                }
-
-                if (SGame.NewDayTask?.Status == TaskStatus.Created)
-                {
-                    this.Monitor.Log("New day task synchronizing...");
-                    SGame.NewDayTask.RunSynchronously();
-                    this.Monitor.Log("New day task done.");
-                }
-
-                // While a background task is in progress, the game may make changes to the game
-                // state while mods are running their code. This is risky, because data changes can
-                // conflict (e.g. collection changed during enumeration errors) and data may change
-                // unexpectedly from one mod instruction to the next.
-                //
-                // Therefore we can just run Game1.Update here without raising any SMAPI events. There's
-                // a small chance that the task will finish after we defer but before the game checks,
-                // which means technically events should be raised, but the effects of missing one
-                // update tick are negligible and not worth the complications of bypassing Game1.Update.
-                if (SGame.NewDayTask != null || Game1.gameMode == Game1.loadingMode)
-                {
-                    events.UnvalidatedUpdateTicking.RaiseEmpty();
-                    SCore.TicksElapsed++;
-                    runGameUpdate();
-                    events.UnvalidatedUpdateTicked.RaiseEmpty();
-                    return;
-                }
-
-                // Raise minimal events while saving.
-                // While the game is writing to the save file in the background, mods can unexpectedly
-                // fail since they don't have exclusive access to resources (e.g. collection changed
-                // during enumeration errors). To avoid problems, events are not invoked while a save
-                // is in progress. It's safe to raise SaveEvents.BeforeSave as soon as the menu is
-                // opened (since the save hasn't started yet), but all other events should be suppressed.
-                if (Context.IsSaving)
-                {
-                    // raise before-create
-                    if (!Context.IsWorldReady && !this.IsBetweenCreateEvents)
-                    {
-                        this.IsBetweenCreateEvents = true;
-                        this.Monitor.Log("Context: before save creation.");
-                        events.SaveCreating.RaiseEmpty();
-                    }
-
-                    // raise before-save
-                    if (Context.IsWorldReady && !this.IsBetweenSaveEvents)
-                    {
-                        this.IsBetweenSaveEvents = true;
-                        this.Monitor.Log("Context: before save.");
-                        events.Saving.RaiseEmpty();
-                    }
-
-                    // suppress non-save events
-                    events.UnvalidatedUpdateTicking.RaiseEmpty();
-                    SCore.TicksElapsed++;
-                    runGameUpdate();
-                    events.UnvalidatedUpdateTicked.RaiseEmpty();
-                    return;
-                }
-
                 /*********
                 ** Reload assets when interceptors are added/removed
                 *********/
@@ -671,32 +534,7 @@ namespace StardewModdingAPI.Framework
                 }
 
                 /*********
-                ** Update context
-                *********/
-                bool wasWorldReady = Context.IsWorldReady;
-                if ((Context.IsWorldReady && !Context.IsSaveLoaded) || Game1.exitToTitle)
-                {
-                    Context.IsWorldReady = false;
-                    this.AfterLoadTimer.Reset();
-                }
-                else if (Context.IsSaveLoaded && this.AfterLoadTimer.Current > 0 && Game1.currentLocation != null)
-                {
-                    if (Game1.dayOfMonth != 0) // wait until new-game intro finishes (world not fully initialized yet)
-                        this.AfterLoadTimer.Decrement();
-                    Context.IsWorldReady = this.AfterLoadTimer.Current == 0;
-                }
-
-                /*********
-                ** Update watchers
-                **   (Watchers need to be updated, checked, and reset in one go so we can detect any changes mods make in event handlers.)
-                *********/
-                this.Watchers.Update();
-                this.WatcherSnapshot.Update(this.Watchers);
-                this.Watchers.Reset();
-                WatcherSnapshot state = this.WatcherSnapshot;
-
-                /*********
-                ** Display in-game warnings
+                ** Show in-game warnings (for main player only)
                 *********/
                 // save content removed
                 if (this.IsSaveContentRemoved && Context.IsWorldReady)
@@ -705,6 +543,178 @@ namespace StardewModdingAPI.Framework
                     Game1.addHUDMessage(new HUDMessage(this.Translator.Get("warn.invalid-content-removed"), HUDMessage.error_type));
                 }
 
+                /*********
+                ** Run game update
+                *********/
+                runGameUpdate();
+
+                /*********
+                ** Reset crash timer
+                *********/
+                this.UpdateCrashTimer.Reset();
+            }
+            catch (Exception ex)
+            {
+                // log error
+                this.Monitor.Log($"An error occured in the overridden update loop: {ex.GetLogSummary()}", LogLevel.Error);
+
+                // exit if irrecoverable
+                if (!this.UpdateCrashTimer.Decrement())
+                    this.ExitGameImmediately("The game crashed when updating, and SMAPI was unable to recover the game.");
+            }
+            finally
+            {
+                SCore.TicksElapsed++;
+            }
+        }
+
+        /// <summary>Raised when the game instance for a local player is updating (once per <see cref="OnGameUpdating"/> per player).</summary>
+        /// <param name="instance">The game instance being updated.</param>
+        /// <param name="gameTime">A snapshot of the game timing state.</param>
+        /// <param name="runUpdate">Invoke the game's update logic.</param>
+        private void OnPlayerInstanceUpdating(SGame instance, GameTime gameTime, Action runUpdate)
+        {
+            var events = this.EventManager;
+
+            try
+            {
+                // reapply overrides
+                if (this.JustReturnedToTitle)
+                {
+                    if (!(Game1.mapDisplayDevice is SDisplayDevice))
+                        Game1.mapDisplayDevice = this.GetMapDisplayDevice();
+
+                    this.JustReturnedToTitle = false;
+                }
+
+                /*********
+                ** Update input
+                *********/
+                // This should *always* run, even when suppressing mod events, since the game uses
+                // this too. For example, doing this after mod event suppression would prevent the
+                // user from doing anything on the overnight shipping screen.
+                SInputState inputState = instance.Input;
+                if (this.Game.IsActive)
+                    inputState.TrueUpdate();
+
+                /*********
+                ** Special cases
+                *********/
+                // Run async tasks synchronously to avoid issues due to mod events triggering
+                // concurrently with game code.
+                bool saveParsed = false;
+                if (Game1.currentLoader != null)
+                {
+                    this.Monitor.Log("Game loader synchronizing...");
+                    while (Game1.currentLoader?.MoveNext() == true)
+                    {
+                        // raise load stage changed
+                        switch (Game1.currentLoader.Current)
+                        {
+                            case 20 when (!saveParsed && SaveGame.loaded != null):
+                                saveParsed = true;
+                                this.OnLoadStageChanged(LoadStage.SaveParsed);
+                                break;
+
+                            case 36:
+                                this.OnLoadStageChanged(LoadStage.SaveLoadedBasicInfo);
+                                break;
+
+                            case 50:
+                                this.OnLoadStageChanged(LoadStage.SaveLoadedLocations);
+                                break;
+
+                            default:
+                                if (Game1.gameMode == Game1.playingGameMode)
+                                    this.OnLoadStageChanged(LoadStage.Preloaded);
+                                break;
+                        }
+                    }
+
+                    Game1.currentLoader = null;
+                    this.Monitor.Log("Game loader done.");
+                }
+
+                if (instance.NewDayTask?.Status == TaskStatus.Created)
+                {
+                    this.Monitor.Log("New day task synchronizing...");
+                    instance.NewDayTask.RunSynchronously();
+                    this.Monitor.Log("New day task done.");
+                }
+
+                // While a background task is in progress, the game may make changes to the game
+                // state while mods are running their code. This is risky, because data changes can
+                // conflict (e.g. collection changed during enumeration errors) and data may change
+                // unexpectedly from one mod instruction to the next.
+                //
+                // Therefore we can just run Game1.Update here without raising any SMAPI events. There's
+                // a small chance that the task will finish after we defer but before the game checks,
+                // which means technically events should be raised, but the effects of missing one
+                // update tick are negligible and not worth the complications of bypassing Game1.Update.
+                if (instance.NewDayTask != null || Game1.gameMode == Game1.loadingMode)
+                {
+                    events.UnvalidatedUpdateTicking.RaiseEmpty();
+                    runUpdate();
+                    events.UnvalidatedUpdateTicked.RaiseEmpty();
+                    return;
+                }
+
+                // Raise minimal events while saving.
+                // While the game is writing to the save file in the background, mods can unexpectedly
+                // fail since they don't have exclusive access to resources (e.g. collection changed
+                // during enumeration errors). To avoid problems, events are not invoked while a save
+                // is in progress. It's safe to raise SaveEvents.BeforeSave as soon as the menu is
+                // opened (since the save hasn't started yet), but all other events should be suppressed.
+                if (Context.IsSaving)
+                {
+                    // raise before-create
+                    if (!Context.IsWorldReady && !instance.IsBetweenCreateEvents)
+                    {
+                        instance.IsBetweenCreateEvents = true;
+                        this.Monitor.Log("Context: before save creation.");
+                        events.SaveCreating.RaiseEmpty();
+                    }
+
+                    // raise before-save
+                    if (Context.IsWorldReady && !instance.IsBetweenSaveEvents)
+                    {
+                        instance.IsBetweenSaveEvents = true;
+                        this.Monitor.Log("Context: before save.");
+                        events.Saving.RaiseEmpty();
+                    }
+
+                    // suppress non-save events
+                    events.UnvalidatedUpdateTicking.RaiseEmpty();
+                    runUpdate();
+                    events.UnvalidatedUpdateTicked.RaiseEmpty();
+                    return;
+                }
+
+                /*********
+                ** Update context
+                *********/
+                bool wasWorldReady = Context.IsWorldReady;
+                if ((Context.IsWorldReady && !Context.IsSaveLoaded) || Game1.exitToTitle)
+                {
+                    Context.IsWorldReady = false;
+                    instance.AfterLoadTimer.Reset();
+                }
+                else if (Context.IsSaveLoaded && instance.AfterLoadTimer.Current > 0 && Game1.currentLocation != null)
+                {
+                    if (Game1.dayOfMonth != 0) // wait until new-game intro finishes (world not fully initialized yet)
+                        instance.AfterLoadTimer.Decrement();
+                    Context.IsWorldReady = instance.AfterLoadTimer.Current == 0;
+                }
+
+                /*********
+                ** Update watchers
+                **   (Watchers need to be updated, checked, and reset in one go so we can detect any changes mods make in event handlers.)
+                *********/
+                instance.Watchers.Update();
+                instance.WatcherSnapshot.Update(instance.Watchers);
+                instance.Watchers.Reset();
+                WatcherSnapshot state = instance.WatcherSnapshot;
+
                 /*********
                 ** Pre-update events
                 *********/
@@ -712,19 +722,19 @@ namespace StardewModdingAPI.Framework
                     /*********
                     ** Save created/loaded events
                     *********/
-                    if (this.IsBetweenCreateEvents)
+                    if (instance.IsBetweenCreateEvents)
                     {
                         // raise after-create
-                        this.IsBetweenCreateEvents = false;
+                        instance.IsBetweenCreateEvents = false;
                         this.Monitor.Log($"Context: after save creation, starting {Game1.currentSeason} {Game1.dayOfMonth} Y{Game1.year}.");
                         this.OnLoadStageChanged(LoadStage.CreatedSaveFile);
                         events.SaveCreated.RaiseEmpty();
                     }
 
-                    if (this.IsBetweenSaveEvents)
+                    if (instance.IsBetweenSaveEvents)
                     {
                         // raise after-save
-                        this.IsBetweenSaveEvents = false;
+                        instance.IsBetweenSaveEvents = false;
                         this.Monitor.Log($"Context: after save, starting {Game1.currentSeason} {Game1.dayOfMonth} Y{Game1.year}.");
                         events.Saved.RaiseEmpty();
                         events.DayStarted.RaiseEmpty();
@@ -785,7 +795,7 @@ namespace StardewModdingAPI.Framework
                         bool isChatInput = Game1.IsChatting || (Context.IsMultiplayer && Context.IsWorldReady && Game1.activeClickableMenu == null && Game1.currentMinigame == null && inputState.IsAnyDown(Game1.options.chatButton));
                         if (!isChatInput)
                         {
-                            ICursorPosition cursor = this.Input.CursorPosition;
+                            ICursorPosition cursor = instance.Input.CursorPosition;
 
                             // raise cursor moved event
                             if (state.Cursor.IsChanged)
@@ -950,9 +960,8 @@ namespace StardewModdingAPI.Framework
                     /*********
                     ** Game update
                     *********/
-                    // game launched
-                    bool isFirstTick = SCore.TicksElapsed == 0;
-                    if (isFirstTick)
+                    // game launched (not raised for secondary players in split-screen mode)
+                    if (instance.IsFirstTick && !Context.IsGameLaunched)
                     {
                         Context.IsGameLaunched = true;
                         events.GameLaunched.Raise(new GameLaunchedEventArgs());
@@ -974,9 +983,8 @@ namespace StardewModdingAPI.Framework
                         events.OneSecondUpdateTicking.RaiseEmpty();
                     try
                     {
-                        this.Input.ApplyOverrides(); // if mods added any new overrides since the update, process them now
-                        SCore.TicksElapsed++;
-                        runGameUpdate();
+                        instance.Input.ApplyOverrides(); // if mods added any new overrides since the update, process them now
+                        runUpdate();
                     }
                     catch (Exception ex)
                     {
@@ -1113,6 +1121,13 @@ namespace StardewModdingAPI.Framework
             return this.ContentCore.CreateGameContentManager("(generated)");
         }
 
+        /// <summary>Get the current game instance. This may not be the main player if playing in split-screen.</summary>
+        private SGame GetCurrentGameInstance()
+        {
+            return Game1.game1 as SGame
+                ?? throw new InvalidOperationException("The current game instance wasn't created by SMAPI.");
+        }
+
         /// <summary>Look for common issues with the game's XNB content, and log warnings if anything looks broken or outdated.</summary>
         /// <returns>Returns whether all integrity checks passed.</returns>
         private bool ValidateContentIntegrity()
@@ -1601,7 +1616,7 @@ namespace StardewModdingAPI.Framework
                         IModRegistry modRegistryHelper = new ModRegistryHelper(manifest.UniqueID, this.ModRegistry, proxyFactory, monitor);
                         IMultiplayerHelper multiplayerHelper = new MultiplayerHelper(manifest.UniqueID, this.Multiplayer);
 
-                        modHelper = new ModHelper(manifest.UniqueID, mod.DirectoryPath, this.Input, events, contentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
+                        modHelper = new ModHelper(manifest.UniqueID, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events, contentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
                     }
 
                     // init mod
@@ -1813,5 +1828,14 @@ namespace StardewModdingAPI.Framework
             this.Monitor.LogFatal(message);
             this.CancellationToken.Cancel();
         }
+
+        /// <summary>Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</summary>
+        private int? GetScreenIdForLog()
+        {
+            if (Context.ScreenId != 0 || (Context.IsWorldReady && Context.IsSplitScreen))
+                return Context.ScreenId;
+
+            return null;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 1c769c3f..aeb48f5c 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -5,9 +5,11 @@ using System.Text;
 using System.Threading.Tasks;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Events;
 using StardewModdingAPI.Framework.Input;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Framework.StateTracking.Snapshots;
 using StardewModdingAPI.Framework.Utilities;
 using StardewValley;
 using StardewValley.BellsAndWhistles;
@@ -41,30 +43,47 @@ namespace StardewModdingAPI.Framework
         /// <summary>Immediately exit the game without saving. This should only be invoked when an irrecoverable fatal error happens that risks save corruption or game-breaking bugs.</summary>
         private readonly Action<string> ExitGameImmediately;
 
-        /// <summary>Raised after the game finishes loading its initial content.</summary>
-        private readonly Action OnGameContentLoaded;
+        /// <summary>The initial override for <see cref="Input"/>. This value is null after initialization.</summary>
+        private SInputState InitialInput;
 
-        /// <summary>Raised when the game is updating its state (roughly 60 times per second).</summary>
-        private readonly Action<GameTime, Action> OnGameUpdating;
+        /// <summary>The initial override for <see cref="Multiplayer"/>. This value is null after initialization.</summary>
+        private SMultiplayer InitialMultiplayer;
 
-        /// <summary>Raised before the game exits.</summary>
-        private readonly Action OnGameExiting;
+        /// <summary>Raised when the instance is updating its state (roughly 60 times per second).</summary>
+        private readonly Action<SGame, GameTime, Action> OnUpdating;
 
 
         /*********
         ** Accessors
         *********/
         /// <summary>Manages input visible to the game.</summary>
-        public static SInputState Input => (SInputState)Game1.input;
-
-        /// <summary>The game's core multiplayer utility.</summary>
-        public static SMultiplayer Multiplayer => (SMultiplayer)Game1.multiplayer;
+        public SInputState Input => (SInputState)Game1.input;
 
         /// <summary>The game background task which initializes a new day.</summary>
-        public static Task NewDayTask => Game1._newDayTask;
+        public Task NewDayTask => Game1._newDayTask;
+
+        /// <summary>Monitors the entire game state for changes.</summary>
+        public WatcherCore Watchers { get; private set; }
+
+        /// <summary>A snapshot of the current <see cref="Watchers"/> state.</summary>
+        public WatcherSnapshot WatcherSnapshot { get; } = new WatcherSnapshot();
+
+        /// <summary>Whether the current update tick is the first one for this instance.</summary>
+        public bool IsFirstTick = true;
+
+        /// <summary>The number of ticks until SMAPI should notify mods that the game has loaded.</summary>
+        /// <remarks>Skipping a few frames ensures the game finishes initializing the world before mods try to change it.</remarks>
+        public Countdown AfterLoadTimer { get; } = new Countdown(5);
+
+        /// <summary>Whether the game is saving and SMAPI has already raised <see cref="IGameLoopEvents.Saving"/>.</summary>
+        public bool IsBetweenSaveEvents { get; set; }
+
+        /// <summary>Whether the game is creating the save file and SMAPI has already raised <see cref="IGameLoopEvents.SaveCreating"/>.</summary>
+        public bool IsBetweenCreateEvents { get; set; }
 
         /// <summary>Construct a content manager to read game content files.</summary>
         /// <remarks>This must be static because the game accesses it before the <see cref="SGame"/> constructor is called.</remarks>
+        [NonInstancedStatic]
         public static Func<IServiceProvider, string, LocalizedContentManager> CreateContentManagerImpl;
 
 
@@ -72,63 +91,40 @@ namespace StardewModdingAPI.Framework
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="playerIndex">The player index.</param>
+        /// <param name="instanceIndex">The instance index.</param>
         /// <param name="monitor">Encapsulates monitoring and logging for SMAPI.</param>
         /// <param name="reflection">Simplifies access to private game code.</param>
         /// <param name="eventManager">Manages SMAPI events for mods.</param>
+        /// <param name="input">Manages the game's input state.</param>
         /// <param name="modHooks">Handles mod hooks provided by the game.</param>
         /// <param name="multiplayer">The core multiplayer logic.</param>
         /// <param name="exitGameImmediately">Immediately exit the game without saving. This should only be invoked when an irrecoverable fatal error happens that risks save corruption or game-breaking bugs.</param>
-        /// <param name="onGameContentLoaded">Raised after the game finishes loading its initial content.</param>
-        /// <param name="onGameUpdating">Raised when the game is updating its state (roughly 60 times per second).</param>
-        /// <param name="onGameExiting">Raised before the game exits.</param>
-        public SGame(Monitor monitor, Reflector reflection, EventManager eventManager, SModHooks modHooks, SMultiplayer multiplayer, Action<string> exitGameImmediately, Action onGameContentLoaded, Action<GameTime, Action> onGameUpdating, Action onGameExiting)
+        /// <param name="onUpdating">Raised when the instance is updating its state (roughly 60 times per second).</param>
+        public SGame(PlayerIndex playerIndex, int instanceIndex, Monitor monitor, Reflector reflection, EventManager eventManager, SInputState input, SModHooks modHooks, SMultiplayer multiplayer, Action<string> exitGameImmediately, Action<SGame, GameTime, Action> onUpdating)
+            : base(playerIndex, instanceIndex)
         {
             // init XNA
             Game1.graphics.GraphicsProfile = GraphicsProfile.HiDef;
 
             // hook into game
-            Game1.input = new SInputState();
-            Game1.multiplayer = multiplayer;
+            Game1.input = this.InitialInput = input;
+            Game1.multiplayer = this.InitialMultiplayer = multiplayer;
             Game1.hooks = modHooks;
-            Game1.locations = new ObservableCollection<GameLocation>();
+            this._locations = new ObservableCollection<GameLocation>();
 
             // init SMAPI
             this.Monitor = monitor;
             this.Events = eventManager;
             this.Reflection = reflection;
             this.ExitGameImmediately = exitGameImmediately;
-            this.OnGameContentLoaded = onGameContentLoaded;
-            this.OnGameUpdating = onGameUpdating;
-            this.OnGameExiting = onGameExiting;
-        }
-
-        /// <summary>Get the observable location list.</summary>
-        public ObservableCollection<GameLocation> GetObservableLocations()
-        {
-            return (ObservableCollection<GameLocation>)Game1.locations;
+            this.OnUpdating = onUpdating;
         }
 
 
         /*********
         ** Protected methods
         *********/
-        /// <summary>Load content when the game is launched.</summary>
-        protected override void LoadContent()
-        {
-            base.LoadContent();
-
-            this.OnGameContentLoaded();
-        }
-
-        /// <summary>Perform cleanup logic when the game exits.</summary>
-        /// <param name="sender">The event sender.</param>
-        /// <param name="args">The event args.</param>
-        /// <remarks>This overrides the logic in <see cref="Game1.exitEvent"/> to let SMAPI clean up before exit.</remarks>
-        protected override void OnExiting(object sender, EventArgs args)
-        {
-            this.OnGameExiting();
-        }
-
         /// <summary>Construct a content manager to read game content files.</summary>
         /// <param name="serviceProvider">The service provider to use to locate services.</param>
         /// <param name="rootDirectory">The root directory to search for content.</param>
@@ -140,11 +136,42 @@ namespace StardewModdingAPI.Framework
             return SGame.CreateContentManagerImpl(serviceProvider, rootDirectory);
         }
 
-        /// <summary>The method called when the game is updating its state (roughly 60 times per second).</summary>
+        /// <summary>Initialize the instance when the game starts.</summary>
+        protected override void Initialize()
+        {
+            base.Initialize();
+
+            // The game resets public static fields after the class is constructed (see
+            // GameRunner.SetInstanceDefaults), so SMAPI needs to re-override them here.
+            Game1.input = this.InitialInput;
+            Game1.multiplayer = this.InitialMultiplayer;
+
+            // The Initial* fields should no longer be used after this point, since mods may
+            // further override them after initialization.
+            this.InitialInput = null;
+            this.InitialMultiplayer = null;
+        }
+
+        /// <summary>The method called when the instance is updating its state (roughly 60 times per second).</summary>
         /// <param name="gameTime">A snapshot of the game timing state.</param>
         protected override void Update(GameTime gameTime)
         {
-            this.OnGameUpdating(gameTime, () => base.Update(gameTime));
+            // set initial state
+            if (this.IsFirstTick)
+            {
+                this.Input.TrueUpdate();
+                this.Watchers = new WatcherCore(this.Input, (ObservableCollection<GameLocation>)this._locations);
+            }
+
+            // update
+            try
+            {
+                this.OnUpdating(this, gameTime, () => base.Update(gameTime));
+            }
+            finally
+            {
+                this.IsFirstTick = false;
+            }
         }
 
         /// <summary>The method called to draw everything to the screen.</summary>
@@ -171,7 +198,7 @@ namespace StardewModdingAPI.Framework
                     return;
                 }
 
-                // recover sprite batch
+                // recover draw state
                 try
                 {
                     if (Game1.spriteBatch.IsOpen(this.Reflection))
diff --git a/src/SMAPI/Framework/SGameRunner.cs b/src/SMAPI/Framework/SGameRunner.cs
new file mode 100644
index 00000000..ae06f513
--- /dev/null
+++ b/src/SMAPI/Framework/SGameRunner.cs
@@ -0,0 +1,156 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.Xna.Framework;
+using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework.Events;
+using StardewModdingAPI.Framework.Input;
+using StardewModdingAPI.Framework.Reflection;
+using StardewValley;
+
+namespace StardewModdingAPI.Framework
+{
+    /// <summary>SMAPI's extension of the game's core <see cref="GameRunner"/>, used to inject SMAPI components.</summary>
+    internal class SGameRunner : GameRunner
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Encapsulates monitoring and logging for SMAPI.</summary>
+        private readonly Monitor Monitor;
+
+        /// <summary>Manages SMAPI events for mods.</summary>
+        private readonly EventManager Events;
+
+        /// <summary>Simplifies access to private game code.</summary>
+        private readonly Reflector Reflection;
+
+        /// <summary>Immediately exit the game without saving. This should only be invoked when an irrecoverable fatal error happens that risks save corruption or game-breaking bugs.</summary>
+        private readonly Action<string> ExitGameImmediately;
+
+        /// <summary>The core SMAPI mod hooks.</summary>
+        private readonly SModHooks ModHooks;
+
+        /// <summary>The core multiplayer logic.</summary>
+        private readonly SMultiplayer Multiplayer;
+
+        /// <summary>Raised after the game finishes loading its initial content.</summary>
+        private readonly Action OnGameContentLoaded;
+
+        /// <summary>Raised when XNA is updating (roughly 60 times per second).</summary>
+        private readonly Action<GameTime, Action> OnGameUpdating;
+
+        /// <summary>Raised when the game instance for a local split-screen player is updating (once per <see cref="OnGameUpdating"/> per player).</summary>
+        private readonly Action<SGame, GameTime, Action> OnPlayerInstanceUpdating;
+
+        /// <summary>Raised before the game exits.</summary>
+        private readonly Action OnGameExiting;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="monitor">Encapsulates monitoring and logging for SMAPI.</param>
+        /// <param name="reflection">Simplifies access to private game code.</param>
+        /// <param name="eventManager">Manages SMAPI events for mods.</param>
+        /// <param name="modHooks">Handles mod hooks provided by the game.</param>
+        /// <param name="multiplayer">The core multiplayer logic.</param>
+        /// <param name="exitGameImmediately">Immediately exit the game without saving. This should only be invoked when an irrecoverable fatal error happens that risks save corruption or game-breaking bugs.</param>
+        /// <param name="onGameContentLoaded">Raised after the game finishes loading its initial content.</param>
+        /// <param name="onGameUpdating">Raised when XNA is updating its state (roughly 60 times per second).</param>
+        /// <param name="onPlayerInstanceUpdating">Raised when the game instance for a local split-screen player is updating (once per <see cref="OnGameUpdating"/> per player).</param>
+        /// <param name="onGameExiting">Raised before the game exits.</param>
+        public SGameRunner(Monitor monitor, Reflector reflection, EventManager eventManager, SModHooks modHooks, SMultiplayer multiplayer, Action<string> exitGameImmediately, Action onGameContentLoaded, Action<GameTime, Action> onGameUpdating, Action<SGame, GameTime, Action> onPlayerInstanceUpdating, Action onGameExiting)
+        {
+            // init XNA
+            Game1.graphics.GraphicsProfile = GraphicsProfile.HiDef;
+
+            // hook into game
+            this.ModHooks = modHooks;
+
+            // init SMAPI
+            this.Monitor = monitor;
+            this.Events = eventManager;
+            this.Reflection = reflection;
+            this.Multiplayer = multiplayer;
+            this.ExitGameImmediately = exitGameImmediately;
+            this.OnGameContentLoaded = onGameContentLoaded;
+            this.OnGameUpdating = onGameUpdating;
+            this.OnPlayerInstanceUpdating = onPlayerInstanceUpdating;
+            this.OnGameExiting = onGameExiting;
+        }
+
+        /// <summary>Create a game instance for a local player.</summary>
+        /// <param name="playerIndex">The player index.</param>
+        /// <param name="instanceIndex">The instance index.</param>
+        public override Game1 CreateGameInstance(PlayerIndex playerIndex = PlayerIndex.One, int instanceIndex = 0)
+        {
+            SInputState inputState = new SInputState();
+            return new SGame(playerIndex, instanceIndex, this.Monitor, this.Reflection, this.Events, inputState, this.ModHooks, this.Multiplayer, this.ExitGameImmediately, this.OnPlayerInstanceUpdating);
+        }
+
+        /// <inheritdoc />
+        public override void AddGameInstance(PlayerIndex playerIndex)
+        {
+            base.AddGameInstance(playerIndex);
+
+            EarlyConstants.LogScreenId = Context.ScreenId;
+            this.UpdateForSplitScreenChanges();
+        }
+
+        /// <inheritdoc />
+        public override void RemoveGameInstance(Game1 instance)
+        {
+            base.RemoveGameInstance(instance);
+
+            if (this.gameInstances.Count <= 1)
+                EarlyConstants.LogScreenId = null;
+            this.UpdateForSplitScreenChanges();
+        }
+
+
+        /*********
+        ** Protected methods
+        *********/
+        /// <summary>Load content when the game is launched.</summary>
+        protected override void LoadContent()
+        {
+            base.LoadContent();
+
+            this.OnGameContentLoaded();
+        }
+
+        /// <summary>Perform cleanup logic when the game exits.</summary>
+        /// <param name="sender">The event sender.</param>
+        /// <param name="args">The event args.</param>
+        /// <remarks>This overrides the logic in <see cref="Game1.exitEvent"/> to let SMAPI clean up before exit.</remarks>
+        protected override void OnExiting(object sender, EventArgs args)
+        {
+            this.OnGameExiting();
+        }
+
+        /// <summary>The method called when the game is updating its state (roughly 60 times per second).</summary>
+        /// <param name="gameTime">A snapshot of the game timing state.</param>
+        protected override void Update(GameTime gameTime)
+        {
+            this.OnGameUpdating(gameTime, () => base.Update(gameTime));
+        }
+
+        private void UpdateForSplitScreenChanges()
+        {
+            HashSet<int> oldScreenIds = new HashSet<int>(Context.ActiveScreenIds);
+
+            // track active screens
+            Context.ActiveScreenIds.Clear();
+            foreach (var screen in this.gameInstances)
+                Context.ActiveScreenIds.Add(screen.instanceId);
+
+            // remember last removed screen
+            foreach (int id in oldScreenIds)
+            {
+                if (!Context.ActiveScreenIds.Contains(id))
+                    Context.LastRemovedScreenId = id;
+            }
+        }
+    }
+}
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
new file mode 100644
index 00000000..55dae0d8
--- /dev/null
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -0,0 +1,79 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace StardewModdingAPI.Utilities
+{
+    /// <summary>Manages a separate value for each player in split-screen mode. This can safely be used in non-split-screen mode too, it'll just have a single state in that case.</summary>
+    /// <typeparam name="T">The state class.</typeparam>
+    public class PerScreen<T>
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Create the initial value for a player.</summary>
+        private readonly Func<T> CreateNewState;
+
+        /// <summary>The tracked values for each player.</summary>
+        private readonly IDictionary<int, T> States = new Dictionary<int, T>();
+
+        /// <summary>The last <see cref="Context.LastRemovedScreenId"/> value for which this instance was updated.</summary>
+        private int LastRemovedScreenId;
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The value for the current player.</summary>
+        /// <remarks>The value is initialized the first time it's requested for that player, unless it's set manually first.</remarks>
+        public T Value
+        {
+            get
+            {
+                this.RemoveDeadPlayers();
+                return this.States.TryGetValue(Context.ScreenId, out T state)
+                    ? state
+                    : this.States[Context.ScreenId] = this.CreateNewState();
+            }
+            set
+            {
+                this.RemoveDeadPlayers();
+                this.States[Context.ScreenId] = value;
+            }
+        }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public PerScreen()
+            : this(null) { }
+
+        /// <summary>Construct an instance.</summary>
+        /// <param name="createNewState">Create the initial state for a player screen.</param>
+        public PerScreen(Func<T> createNewState)
+        {
+            this.CreateNewState = createNewState ?? (() => default);
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Remove players who are no longer have a split-screen index.</summary>
+        /// <returns>Returns whether any players were removed.</returns>
+        private void RemoveDeadPlayers()
+        {
+            if (this.LastRemovedScreenId == Context.LastRemovedScreenId)
+                return;
+
+            this.LastRemovedScreenId = Context.LastRemovedScreenId;
+            foreach (int id in this.States.Keys.ToArray())
+            {
+                if (!Context.HasScreenId(id))
+                    this.States.Remove(id);
+            }
+        }
+    }
+}

From 85cb824c3b96905d4e991946db61802a24e350c9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:34:59 -0500
Subject: [PATCH 006/856] update for draw changes

That includes child menus, UI draw mode, and UI scaling.
---
 src/SMAPI/Framework/Input/SInputState.cs  |  17 +-
 src/SMAPI/Framework/InternalExtensions.cs |  18 ++
 src/SMAPI/Framework/SGame.cs              | 310 +++++++++++++---------
 3 files changed, 212 insertions(+), 133 deletions(-)

diff --git a/src/SMAPI/Framework/Input/SInputState.cs b/src/SMAPI/Framework/Input/SInputState.cs
index f618608a..23670202 100644
--- a/src/SMAPI/Framework/Input/SInputState.cs
+++ b/src/SMAPI/Framework/Input/SInputState.cs
@@ -65,13 +65,16 @@ namespace StardewModdingAPI.Framework.Input
             // update SMAPI extended data
             try
             {
-                float zoomMultiplier = (1f / Game1.options.zoomLevel);
+                float scale = Game1.options.uiScale;
 
                 // get real values
                 var controller = new GamePadStateBuilder(base.GetGamePadState());
                 var keyboard = new KeyboardStateBuilder(base.GetKeyboardState());
                 var mouse = new MouseStateBuilder(base.GetMouseState());
-                Vector2 cursorAbsolutePos = new Vector2((mouse.X * zoomMultiplier) + Game1.viewport.X, (mouse.Y * zoomMultiplier) + Game1.viewport.Y);
+                Vector2 cursorAbsolutePos = new Vector2(
+                    x: (mouse.X / scale) + Game1.uiViewport.X,
+                    y: (mouse.Y / scale) + Game1.uiViewport.Y
+                );
                 Vector2? playerTilePos = Context.IsPlayerFree ? Game1.player.getTileLocation() : (Vector2?)null;
                 HashSet<SButton> reallyDown = new HashSet<SButton>(this.GetPressedButtons(keyboard, mouse, controller));
 
@@ -106,7 +109,7 @@ namespace StardewModdingAPI.Framework.Input
                 if (cursorAbsolutePos != this.CursorPositionImpl?.AbsolutePixels || playerTilePos != this.LastPlayerTile)
                 {
                     this.LastPlayerTile = playerTilePos;
-                    this.CursorPositionImpl = this.GetCursorPosition(this.MouseState, cursorAbsolutePos, zoomMultiplier);
+                    this.CursorPositionImpl = this.GetCursorPosition(this.MouseState, cursorAbsolutePos, scale);
                 }
             }
             catch (InvalidOperationException)
@@ -199,11 +202,11 @@ namespace StardewModdingAPI.Framework.Input
         /// <summary>Get the current cursor position.</summary>
         /// <param name="mouseState">The current mouse state.</param>
         /// <param name="absolutePixels">The absolute pixel position relative to the map, adjusted for pixel zoom.</param>
-        /// <param name="zoomMultiplier">The multiplier applied to pixel coordinates to adjust them for pixel zoom.</param>
-        private CursorPosition GetCursorPosition(MouseState mouseState, Vector2 absolutePixels, float zoomMultiplier)
+        /// <param name="scale">The UI scale applied to pixel coordinates.</param>
+        private CursorPosition GetCursorPosition(MouseState mouseState, Vector2 absolutePixels, float scale)
         {
-            Vector2 screenPixels = new Vector2(mouseState.X * zoomMultiplier, mouseState.Y * zoomMultiplier);
-            Vector2 tile = new Vector2((int)((Game1.viewport.X + screenPixels.X) / Game1.tileSize), (int)((Game1.viewport.Y + screenPixels.Y) / Game1.tileSize));
+            Vector2 screenPixels = new Vector2(mouseState.X / scale, mouseState.Y / scale);
+            Vector2 tile = new Vector2((int)((Game1.uiViewport.X + screenPixels.X) / Game1.tileSize), (int)((Game1.uiViewport.Y + screenPixels.Y) / Game1.tileSize));
             Vector2 grabTile = (Game1.mouseCursorTransparency > 0 && Utility.tileWithinRadiusOfPlayer((int)tile.X, (int)tile.Y, 1, Game1.player)) // derived from Game1.pressActionButton
                 ? tile
                 : Game1.player.GetGrabTile();
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index b6704f26..ba1879da 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -1,11 +1,13 @@
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using System.Reflection;
 using System.Threading;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Events;
 using StardewModdingAPI.Framework.Reflection;
 using StardewValley;
+using StardewValley.Menus;
 
 namespace StardewModdingAPI.Framework
 {
@@ -153,6 +155,22 @@ namespace StardewModdingAPI.Framework
             }
         }
 
+        /****
+        ** IActiveClickableMenu
+        ****/
+        /// <summary>Get a string representation of the menu chain to the given menu (including the specified menu), in parent to child order.</summary>
+        /// <param name="menu">The menu whose chain to get.</param>
+        public static string GetMenuChainLabel(this IClickableMenu menu)
+        {
+            static IEnumerable<IClickableMenu> GetAncestors(IClickableMenu menu)
+            {
+                for (; menu != null; menu = menu.GetParentMenu())
+                    yield return menu;
+            }
+
+            return string.Join(" > ", GetAncestors(menu).Reverse().Select(p => p.GetType().FullName));
+        }
+
         /****
         ** Sprite batch
         ****/
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index aeb48f5c..f69c5f08 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -206,10 +206,14 @@ namespace StardewModdingAPI.Framework
                         this.Monitor.Log("Recovering sprite batch from error...");
                         Game1.spriteBatch.End();
                     }
+
+                    Game1.uiMode = false;
+                    Game1.uiModeCount = 0;
+                    Game1.nonUIRenderTarget = null;
                 }
                 catch (Exception innerEx)
                 {
-                    this.Monitor.Log($"Could not recover sprite batch state: {innerEx.GetLogSummary()}", LogLevel.Error);
+                    this.Monitor.Log($"Could not recover game draw state: {innerEx.GetLogSummary()}", LogLevel.Error);
                 }
             }
             Context.IsInDrawLoop = false;
@@ -224,9 +228,11 @@ namespace StardewModdingAPI.Framework
         [SuppressMessage("ReSharper", "LocalVariableHidesMember", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "PossibleLossOfFraction", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantArgumentDefaultValue", Justification = "copied from game code as-is")]
+        [SuppressMessage("ReSharper", "RedundantBaseQualifier", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantCast", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantExplicitNullableCreation", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantTypeArgumentsOfMethod", Justification = "copied from game code as-is")]
+        [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "copied from game code as-is")]
         [SuppressMessage("SMAPI.CommonErrors", "AvoidNetField", Justification = "copied from game code as-is")]
         [SuppressMessage("SMAPI.CommonErrors", "AvoidImplicitNetFieldCast", Justification = "copied from game code as-is")]
         private void DrawImpl(GameTime gameTime, RenderTarget2D target_screen)
@@ -234,7 +240,7 @@ namespace StardewModdingAPI.Framework
             var events = this.Events;
 
             Game1.showingHealthBar = false;
-            if (Game1._newDayTask != null)
+            if (Game1._newDayTask != null || this.isLocalMultiplayerNewDayActive)
             {
                 base.GraphicsDevice.Clear(Game1.bgColor);
                 return;
@@ -246,6 +252,7 @@ namespace StardewModdingAPI.Framework
             if (this.IsSaving)
             {
                 base.GraphicsDevice.Clear(Game1.bgColor);
+                Game1.PushUIMode();
                 IClickableMenu menu = Game1.activeClickableMenu;
                 if (menu != null)
                 {
@@ -271,53 +278,49 @@ namespace StardewModdingAPI.Framework
                     Game1.overlayMenu.draw(Game1.spriteBatch);
                     Game1.spriteBatch.End();
                 }
-                this.renderScreenBuffer(target_screen);
+                Game1.PopUIMode();
                 return;
             }
             base.GraphicsDevice.Clear(Game1.bgColor);
             if (Game1.activeClickableMenu != null && Game1.options.showMenuBackground && Game1.activeClickableMenu.showWithoutTransparencyIfOptionIsSet() && !this.takingMapScreenshot)
             {
+                Game1.PushUIMode();
                 Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
 
                 events.Rendering.RaiseEmpty();
+                IClickableMenu curMenu = null;
                 try
                 {
                     Game1.activeClickableMenu.drawBackground(Game1.spriteBatch);
                     events.RenderingActiveMenu.RaiseEmpty();
-                    Game1.activeClickableMenu.draw(Game1.spriteBatch);
+                    for (curMenu = Game1.activeClickableMenu; curMenu != null; curMenu = curMenu.GetChildMenu())
+                    {
+                        curMenu.draw(Game1.spriteBatch);
+                    }
                     events.RenderedActiveMenu.RaiseEmpty();
                 }
                 catch (Exception ex)
                 {
-                    this.Monitor.Log($"The {Game1.activeClickableMenu.GetType().FullName} menu crashed while drawing itself. SMAPI will force it to exit to avoid crashing the game.\n{ex.GetLogSummary()}", LogLevel.Error);
+                    this.Monitor.Log($"The {curMenu.GetMenuChainLabel()} menu crashed while drawing itself. SMAPI will force it to exit to avoid crashing the game.\n{ex.GetLogSummary()}", LogLevel.Error);
                     Game1.activeClickableMenu.exitThisMenu();
                 }
                 events.Rendered.RaiseEmpty();
+                if (Game1.specialCurrencyDisplay != null)
+                {
+                    Game1.specialCurrencyDisplay.Draw(Game1.spriteBatch);
+                }
                 Game1.spriteBatch.End();
                 this.drawOverlays(Game1.spriteBatch);
-                if (target_screen != null)
-                {
-                    base.GraphicsDevice.SetRenderTarget(null);
-                    base.GraphicsDevice.Clear(Game1.bgColor);
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.LinearClamp, DepthStencilState.Default, RasterizerState.CullNone);
-                    Game1.spriteBatch.Draw(target_screen, Vector2.Zero, target_screen.Bounds, Color.White, 0f, Vector2.Zero, Game1.options.zoomLevel, SpriteEffects.None, 1f);
-                    Game1.spriteBatch.End();
-                }
-                if (Game1.overlayMenu != null)
-                {
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
-                    Game1.overlayMenu.draw(Game1.spriteBatch);
-                    Game1.spriteBatch.End();
-                }
+                Game1.PopUIMode();
                 return;
             }
             if (Game1.gameMode == 11)
             {
                 Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                 events.Rendering.RaiseEmpty();
-                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3685"), new Vector2(16f, 16f), Color.HotPink);
-                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3686"), new Vector2(16f, 32f), new Color(0, 255, 0));
-                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.parseText(Game1.errorMessage, Game1.dialogueFont, Game1.graphics.GraphicsDevice.Viewport.Width), new Vector2(16f, 48f), Color.White);
+                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3685"), new Vector2(16f, 16f), Microsoft.Xna.Framework.Color.HotPink);
+                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3686"), new Vector2(16f, 32f), new Microsoft.Xna.Framework.Color(0, 255, 0));
+                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.parseText(Game1.errorMessage, Game1.dialogueFont, Game1.graphics.GraphicsDevice.Viewport.Width), new Vector2(16f, 48f), Microsoft.Xna.Framework.Color.White);
                 events.Rendered.RaiseEmpty();
                 Game1.spriteBatch.End();
                 return;
@@ -334,64 +337,57 @@ namespace StardewModdingAPI.Framework
                 Game1.currentMinigame.draw(Game1.spriteBatch);
                 if (Game1.globalFade && !Game1.menuUp && (!Game1.nameSelectUp || Game1.messagePause))
                 {
+                    Game1.PushUIMode();
                     Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.Black * ((Game1.gameMode == 0) ? (1f - Game1.fadeToBlackAlpha) : Game1.fadeToBlackAlpha));
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.Black * ((Game1.gameMode == 0) ? (1f - Game1.fadeToBlackAlpha) : Game1.fadeToBlackAlpha));
                     Game1.spriteBatch.End();
+                    Game1.PopUIMode();
                 }
+                Game1.PushUIMode();
                 this.drawOverlays(Game1.spriteBatch);
-                if (target_screen != null)
+                Game1.PopUIMode();
+                if (events.Rendered.HasListeners())
                 {
-                    base.GraphicsDevice.SetRenderTarget(null);
-                    base.GraphicsDevice.Clear(Game1.bgColor);
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.LinearClamp, DepthStencilState.Default, RasterizerState.CullNone);
-                    Game1.spriteBatch.Draw(target_screen, Vector2.Zero, target_screen.Bounds, Color.White, 0f, Vector2.Zero, Game1.options.zoomLevel, SpriteEffects.None, 1f);
+                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                     events.Rendered.RaiseEmpty();
                     Game1.spriteBatch.End();
                 }
-                else
-                {
-                    if (events.Rendered.HasListeners())
-                    {
-                        Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
-                        events.Rendered.RaiseEmpty();
-                        Game1.spriteBatch.End();
-                    }
-                }
+
+                base.GraphicsDevice.SetRenderTarget(target_screen);
                 return;
             }
             if (Game1.showingEndOfNightStuff)
             {
+                Game1.PushUIMode();
                 Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                 events.Rendering.RaiseEmpty();
                 if (Game1.activeClickableMenu != null)
                 {
+                    IClickableMenu curMenu = null;
                     try
                     {
                         events.RenderingActiveMenu.RaiseEmpty();
-                        Game1.activeClickableMenu.draw(Game1.spriteBatch);
+                        for (curMenu = Game1.activeClickableMenu; curMenu != null; curMenu = curMenu.GetChildMenu())
+                        {
+                            curMenu.draw(Game1.spriteBatch);
+                        }
                         events.RenderedActiveMenu.RaiseEmpty();
                     }
                     catch (Exception ex)
                     {
-                        this.Monitor.Log($"The {Game1.activeClickableMenu.GetType().FullName} menu crashed while drawing itself during end-of-night-stuff. SMAPI will force it to exit to avoid crashing the game.\n{ex.GetLogSummary()}", LogLevel.Error);
+                        this.Monitor.Log($"The {curMenu.GetMenuChainLabel()} menu crashed while drawing itself. SMAPI will force it to exit to avoid crashing the game.\n{ex.GetLogSummary()}", LogLevel.Error);
                         Game1.activeClickableMenu.exitThisMenu();
                     }
                 }
-                events.Rendered.RaiseEmpty();
                 Game1.spriteBatch.End();
                 this.drawOverlays(Game1.spriteBatch);
-                if (target_screen != null)
-                {
-                    base.GraphicsDevice.SetRenderTarget(null);
-                    base.GraphicsDevice.Clear(Game1.bgColor);
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.LinearClamp, DepthStencilState.Default, RasterizerState.CullNone);
-                    Game1.spriteBatch.Draw(target_screen, Vector2.Zero, target_screen.Bounds, Color.White, 0f, Vector2.Zero, Game1.options.zoomLevel, SpriteEffects.None, 1f);
-                    Game1.spriteBatch.End();
-                }
+                Game1.PopUIMode();
                 return;
             }
             if (Game1.gameMode == 6 || (Game1.gameMode == 3 && Game1.currentLocation == null))
             {
+                Game1.PushUIMode();
+                base.GraphicsDevice.Clear(Game1.bgColor);
                 Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                 events.Rendering.RaiseEmpty();
                 string addOn = "";
@@ -410,23 +406,10 @@ namespace StardewModdingAPI.Framework
                 events.Rendered.RaiseEmpty();
                 Game1.spriteBatch.End();
                 this.drawOverlays(Game1.spriteBatch);
-                if (target_screen != null)
-                {
-                    base.GraphicsDevice.SetRenderTarget(null);
-                    base.GraphicsDevice.Clear(Game1.bgColor);
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.LinearClamp, DepthStencilState.Default, RasterizerState.CullNone);
-                    Game1.spriteBatch.Draw(target_screen, Vector2.Zero, target_screen.Bounds, Color.White, 0f, Vector2.Zero, Game1.options.zoomLevel, SpriteEffects.None, 1f);
-                    Game1.spriteBatch.End();
-                }
-                if (Game1.overlayMenu != null)
-                {
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
-                    Game1.overlayMenu.draw(Game1.spriteBatch);
-                    Game1.spriteBatch.End();
-                }
-                //base.Draw(gameTime);
+                Game1.PopUIMode();
                 return;
             }
+
             byte batchOpens = 0; // used for rendering event
             if (Game1.gameMode == 0)
             {
@@ -436,18 +419,43 @@ namespace StardewModdingAPI.Framework
             }
             else
             {
+                if (Game1.gameMode == 3 && Game1.dayOfMonth == 0 && Game1.newDay)
+                {
+                    //base.Draw(gameTime);
+                    return;
+                }
                 if (Game1.drawLighting)
                 {
                     base.GraphicsDevice.SetRenderTarget(Game1.lightmap);
-                    base.GraphicsDevice.Clear(Color.White * 0f);
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.NonPremultiplied, SamplerState.PointClamp, null, null);
+                    base.GraphicsDevice.Clear(Microsoft.Xna.Framework.Color.White * 0f);
+                    Matrix lighting_matrix = Matrix.Identity;
+                    if (this.useUnscaledLighting)
+                    {
+                        lighting_matrix = Matrix.CreateScale(Game1.options.zoomLevel);
+                    }
+                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.NonPremultiplied, SamplerState.PointClamp, null, null, null, lighting_matrix);
                     if (++batchOpens == 1)
                         events.Rendering.RaiseEmpty();
-                    Color lighting = (Game1.currentLocation.Name.StartsWith("UndergroundMine") && Game1.currentLocation is MineShaft) ? (Game1.currentLocation as MineShaft).getLightingColor(gameTime) : ((Game1.ambientLight.Equals(Color.White) || (Game1.isRaining && (bool)Game1.currentLocation.isOutdoors)) ? Game1.outdoorLight : Game1.ambientLight);
+                    Microsoft.Xna.Framework.Color lighting = (Game1.currentLocation.Name.StartsWith("UndergroundMine") && Game1.currentLocation is MineShaft) ? (Game1.currentLocation as MineShaft).getLightingColor(gameTime) : ((Game1.ambientLight.Equals(Microsoft.Xna.Framework.Color.White) || (Game1.IsRainingHere() && (bool)Game1.currentLocation.isOutdoors)) ? Game1.outdoorLight : Game1.ambientLight);
+                    float light_multiplier = 1f;
+                    if (Game1.player.hasBuff(26))
+                    {
+                        if (lighting == Microsoft.Xna.Framework.Color.White)
+                        {
+                            lighting = new Microsoft.Xna.Framework.Color(0.75f, 0.75f, 0.75f);
+                        }
+                        else
+                        {
+                            lighting.R = (byte)Utility.Lerp((int)lighting.R, 255f, 0.5f);
+                            lighting.G = (byte)Utility.Lerp((int)lighting.G, 255f, 0.5f);
+                            lighting.B = (byte)Utility.Lerp((int)lighting.B, 255f, 0.5f);
+                        }
+                        light_multiplier = 0.33f;
+                    }
                     Game1.spriteBatch.Draw(Game1.staminaRect, Game1.lightmap.Bounds, lighting);
                     foreach (LightSource lightSource in Game1.currentLightSources)
                     {
-                        if ((Game1.isRaining || Game1.isDarkOut()) && lightSource.lightContext.Value == LightSource.LightContext.WindowLight)
+                        if ((Game1.IsRainingHere() || Game1.isDarkOut()) && lightSource.lightContext.Value == LightSource.LightContext.WindowLight)
                         {
                             continue;
                         }
@@ -461,7 +469,7 @@ namespace StardewModdingAPI.Framework
                         }
                         if (Utility.isOnScreen(lightSource.position, (int)((float)lightSource.radius * 64f * 4f)))
                         {
-                            Game1.spriteBatch.Draw(lightSource.lightTexture, Game1.GlobalToLocal(Game1.viewport, lightSource.position) / (Game1.options.lightingQuality / 2), lightSource.lightTexture.Bounds, lightSource.color, 0f, new Vector2(lightSource.lightTexture.Bounds.Center.X, lightSource.lightTexture.Bounds.Center.Y), (float)lightSource.radius / (float)(Game1.options.lightingQuality / 2), SpriteEffects.None, 0.9f);
+                            Game1.spriteBatch.Draw(lightSource.lightTexture, Game1.GlobalToLocal(Game1.viewport, lightSource.position) / (Game1.options.lightingQuality / 2), lightSource.lightTexture.Bounds, lightSource.color.Value * light_multiplier, 0f, new Vector2(lightSource.lightTexture.Bounds.Width / 2, lightSource.lightTexture.Bounds.Height / 2), (float)lightSource.radius / (float)(Game1.options.lightingQuality / 2), SpriteEffects.None, 0.9f);
                         }
                     }
                     Game1.spriteBatch.End();
@@ -480,9 +488,15 @@ namespace StardewModdingAPI.Framework
                 {
                     Game1.background.draw(Game1.spriteBatch);
                 }
+                Game1.currentLocation.drawBackground(Game1.spriteBatch);
                 Game1.mapDisplayDevice.BeginScene(Game1.spriteBatch);
                 Game1.currentLocation.Map.GetLayer("Back").Draw(Game1.mapDisplayDevice, Game1.viewport, Location.Origin, wrapAround: false, 4);
                 Game1.currentLocation.drawWater(Game1.spriteBatch);
+                Game1.spriteBatch.End();
+                Game1.spriteBatch.Begin(SpriteSortMode.FrontToBack, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.currentLocation.drawFloorDecorations(Game1.spriteBatch);
+                Game1.spriteBatch.End();
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                 this._farmerShadows.Clear();
                 if (Game1.currentLocation.currentEvent != null && !Game1.currentLocation.currentEvent.isFestival && Game1.currentLocation.currentEvent.farmerActors.Count > 0)
                 {
@@ -510,27 +524,27 @@ namespace StardewModdingAPI.Framework
                     {
                         foreach (NPC k in Game1.currentLocation.characters)
                         {
-                            if (!k.swimming && !k.HideShadow && !k.IsInvisible && !Game1.currentLocation.shouldShadowBeDrawnAboveBuildingsLayer(k.getTileLocation()))
+                            if (!k.swimming && !k.HideShadow && !k.IsInvisible && !this.checkCharacterTilesForShadowDrawFlag(k))
                             {
-                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, k.Position + new Vector2((float)(k.Sprite.SpriteWidth * 4) / 2f, k.GetBoundingBox().Height + ((!k.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), (4f + (float)k.yJumpOffset / 40f) * (float)k.scale, SpriteEffects.None, Math.Max(0f, (float)k.getStandingY() / 10000f) - 1E-06f);
+                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, k.GetShadowOffset() + k.Position + new Vector2((float)(k.GetSpriteWidthForPositioning() * 4) / 2f, k.GetBoundingBox().Height + ((!k.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)k.yJumpOffset / 40f) * (float)k.scale), SpriteEffects.None, Math.Max(0f, (float)k.getStandingY() / 10000f) - 1E-06f);
                             }
                         }
                     }
                     else
                     {
-                        foreach (NPC l in Game1.CurrentEvent.actors)
+                        foreach (NPC m in Game1.CurrentEvent.actors)
                         {
-                            if (!l.swimming && !l.HideShadow && !Game1.currentLocation.shouldShadowBeDrawnAboveBuildingsLayer(l.getTileLocation()))
+                            if ((Game1.CurrentEvent == null || !Game1.CurrentEvent.ShouldHideCharacter(m)) && !m.swimming && !m.HideShadow && !this.checkCharacterTilesForShadowDrawFlag(m))
                             {
-                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, l.Position + new Vector2((float)(l.Sprite.SpriteWidth * 4) / 2f, l.GetBoundingBox().Height + ((!l.IsMonster) ? ((l.Sprite.SpriteHeight <= 16) ? (-4) : 12) : 0))), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), (4f + (float)l.yJumpOffset / 40f) * (float)l.scale, SpriteEffects.None, Math.Max(0f, (float)l.getStandingY() / 10000f) - 1E-06f);
+                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, m.GetShadowOffset() + m.Position + new Vector2((float)(m.GetSpriteWidthForPositioning() * 4) / 2f, m.GetBoundingBox().Height + ((!m.IsMonster) ? ((m.Sprite.SpriteHeight <= 16) ? (-4) : 12) : 0))), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, 4f + (float)m.yJumpOffset / 40f) * (float)m.scale, SpriteEffects.None, Math.Max(0f, (float)m.getStandingY() / 10000f) - 1E-06f);
                             }
                         }
                     }
                     foreach (Farmer f3 in this._farmerShadows)
                     {
-                        if (!Game1.multiplayer.isDisconnecting(f3.UniqueMultiplayerID) && !f3.swimming && !f3.isRidingHorse() && (Game1.currentLocation == null || !Game1.currentLocation.shouldShadowBeDrawnAboveBuildingsLayer(f3.getTileLocation())))
+                        if (!Game1.multiplayer.isDisconnecting(f3.UniqueMultiplayerID) && !f3.swimming && !f3.isRidingHorse() && !f3.IsSitting() && (Game1.currentLocation == null || !this.checkCharacterTilesForShadowDrawFlag(f3)))
                         {
-                            Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(f3.Position + new Vector2(32f, 24f)), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), 4f - (((f3.running || f3.UsingTool) && f3.FarmerSprite.currentAnimationIndex > 1) ? ((float)Math.Abs(FarmerRenderer.featureYOffsetPerFrame[f3.FarmerSprite.CurrentFrame]) * 0.5f) : 0f), SpriteEffects.None, 0f);
+                            Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(f3.GetShadowOffset() + f3.Position + new Vector2(32f, 24f)), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), 4f - (((f3.running || f3.UsingTool) && f3.FarmerSprite.currentAnimationIndex > 1) ? ((float)Math.Abs(FarmerRenderer.featureYOffsetPerFrame[f3.FarmerSprite.CurrentFrame]) * 0.5f) : 0f), SpriteEffects.None, 0f);
                         }
                     }
                 }
@@ -545,9 +559,9 @@ namespace StardewModdingAPI.Framework
                     {
                         foreach (NPC n in Game1.currentLocation.characters)
                         {
-                            if (!n.swimming && !n.HideShadow && !n.isInvisible && Game1.currentLocation.shouldShadowBeDrawnAboveBuildingsLayer(n.getTileLocation()))
+                            if (!n.swimming && !n.HideShadow && !n.isInvisible && this.checkCharacterTilesForShadowDrawFlag(n))
                             {
-                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, n.Position + new Vector2((float)(n.Sprite.SpriteWidth * 4) / 2f, n.GetBoundingBox().Height + ((!n.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), (4f + (float)n.yJumpOffset / 40f) * (float)n.scale, SpriteEffects.None, Math.Max(0f, (float)n.getStandingY() / 10000f) - 1E-06f);
+                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, n.GetShadowOffset() + n.Position + new Vector2((float)(n.GetSpriteWidthForPositioning() * 4) / 2f, n.GetBoundingBox().Height + ((!n.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)n.yJumpOffset / 40f) * (float)n.scale), SpriteEffects.None, Math.Max(0f, (float)n.getStandingY() / 10000f) - 1E-06f);
                             }
                         }
                     }
@@ -555,18 +569,18 @@ namespace StardewModdingAPI.Framework
                     {
                         foreach (NPC n2 in Game1.CurrentEvent.actors)
                         {
-                            if (!n2.swimming && !n2.HideShadow && Game1.currentLocation.shouldShadowBeDrawnAboveBuildingsLayer(n2.getTileLocation()))
+                            if ((Game1.CurrentEvent == null || !Game1.CurrentEvent.ShouldHideCharacter(n2)) && !n2.swimming && !n2.HideShadow && this.checkCharacterTilesForShadowDrawFlag(n2))
                             {
-                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, n2.Position + new Vector2((float)(n2.Sprite.SpriteWidth * 4) / 2f, n2.GetBoundingBox().Height + ((!n2.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), (4f + (float)n2.yJumpOffset / 40f) * (float)n2.scale, SpriteEffects.None, Math.Max(0f, (float)n2.getStandingY() / 10000f) - 1E-06f);
+                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, n2.GetShadowOffset() + n2.Position + new Vector2((float)(n2.GetSpriteWidthForPositioning() * 4) / 2f, n2.GetBoundingBox().Height + ((!n2.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)n2.yJumpOffset / 40f) * (float)n2.scale), SpriteEffects.None, Math.Max(0f, (float)n2.getStandingY() / 10000f) - 1E-06f);
                             }
                         }
                     }
                     foreach (Farmer f4 in this._farmerShadows)
                     {
                         float draw_layer = Math.Max(0.0001f, f4.getDrawLayer() + 0.00011f) - 0.0001f;
-                        if (!f4.swimming && !f4.isRidingHorse() && Game1.currentLocation != null && Game1.currentLocation.shouldShadowBeDrawnAboveBuildingsLayer(f4.getTileLocation()))
+                        if (!f4.swimming && !f4.isRidingHorse() && !f4.IsSitting() && Game1.currentLocation != null && this.checkCharacterTilesForShadowDrawFlag(f4))
                         {
-                            Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(f4.Position + new Vector2(32f, 24f)), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), 4f - (((f4.running || f4.UsingTool) && f4.FarmerSprite.currentAnimationIndex > 1) ? ((float)Math.Abs(FarmerRenderer.featureYOffsetPerFrame[f4.FarmerSprite.CurrentFrame]) * 0.5f) : 0f), SpriteEffects.None, draw_layer);
+                            Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(f4.GetShadowOffset() + f4.Position + new Vector2(32f, 24f)), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), 4f - (((f4.running || f4.UsingTool) && f4.FarmerSprite.currentAnimationIndex > 1) ? ((float)Math.Abs(FarmerRenderer.featureYOffsetPerFrame[f4.FarmerSprite.CurrentFrame]) * 0.5f) : 0f), SpriteEffects.None, draw_layer);
                         }
                     }
                 }
@@ -576,7 +590,7 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.player.currentUpgrade != null && Game1.player.currentUpgrade.daysLeftTillUpgradeDone <= 3 && Game1.currentLocation.Name.Equals("Farm"))
                 {
-                    Game1.spriteBatch.Draw(Game1.player.currentUpgrade.workerTexture, Game1.GlobalToLocal(Game1.viewport, Game1.player.currentUpgrade.positionOfCarpenter), Game1.player.currentUpgrade.getSourceRectangle(), Color.White, 0f, Vector2.Zero, 1f, SpriteEffects.None, (Game1.player.currentUpgrade.positionOfCarpenter.Y + 48f) / 10000f);
+                    Game1.spriteBatch.Draw(Game1.player.currentUpgrade.workerTexture, Game1.GlobalToLocal(Game1.viewport, Game1.player.currentUpgrade.positionOfCarpenter), Game1.player.currentUpgrade.getSourceRectangle(), Microsoft.Xna.Framework.Color.White, 0f, Vector2.Zero, 1f, SpriteEffects.None, (Game1.player.currentUpgrade.positionOfCarpenter.Y + 48f) / 10000f);
                 }
                 Game1.currentLocation.draw(Game1.spriteBatch);
                 foreach (Vector2 tile_position in Game1.crabPotOverlayTiles.Keys)
@@ -603,14 +617,14 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.tvStation >= 0)
                 {
-                    Game1.spriteBatch.Draw(Game1.tvStationTexture, Game1.GlobalToLocal(Game1.viewport, new Vector2(400f, 160f)), new Microsoft.Xna.Framework.Rectangle(Game1.tvStation * 24, 0, 24, 15), Color.White, 0f, Vector2.Zero, 4f, SpriteEffects.None, 1E-08f);
+                    Game1.spriteBatch.Draw(Game1.tvStationTexture, Game1.GlobalToLocal(Game1.viewport, new Vector2(400f, 160f)), new Microsoft.Xna.Framework.Rectangle(Game1.tvStation * 24, 0, 24, 15), Microsoft.Xna.Framework.Color.White, 0f, Vector2.Zero, 4f, SpriteEffects.None, 1E-08f);
                 }
                 if (Game1.panMode)
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle((int)Math.Floor((double)(Game1.getOldMouseX() + Game1.viewport.X) / 64.0) * 64 - Game1.viewport.X, (int)Math.Floor((double)(Game1.getOldMouseY() + Game1.viewport.Y) / 64.0) * 64 - Game1.viewport.Y, 64, 64), Color.Lime * 0.75f);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle((int)Math.Floor((double)(Game1.getOldMouseX() + Game1.viewport.X) / 64.0) * 64 - Game1.viewport.X, (int)Math.Floor((double)(Game1.getOldMouseY() + Game1.viewport.Y) / 64.0) * 64 - Game1.viewport.Y, 64, 64), Microsoft.Xna.Framework.Color.Lime * 0.75f);
                     foreach (Warp w in Game1.currentLocation.warps)
                     {
-                        Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(w.X * 64 - Game1.viewport.X, w.Y * 64 - Game1.viewport.Y, 64, 64), Color.Red * 0.75f);
+                        Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(w.X * 64 - Game1.viewport.X, w.Y * 64 - Game1.viewport.Y, 64, 64), Microsoft.Xna.Framework.Color.Red * 0.75f);
                     }
                 }
                 Game1.mapDisplayDevice.BeginScene(Game1.spriteBatch);
@@ -619,18 +633,6 @@ namespace StardewModdingAPI.Framework
                 Game1.currentLocation.drawAboveFrontLayer(Game1.spriteBatch);
                 Game1.spriteBatch.End();
                 Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
-                if (Game1.displayFarmer && Game1.player.ActiveObject != null && (bool)Game1.player.ActiveObject.bigCraftable && this.checkBigCraftableBoundariesForFrontLayer() && Game1.currentLocation.Map.GetLayer("Front").PickTile(new Location(Game1.player.getStandingX(), Game1.player.getStandingY()), Game1.viewport.Size) == null)
-                {
-                    Game1.drawPlayerHeldObject(Game1.player);
-                }
-                else if (Game1.displayFarmer && Game1.player.ActiveObject != null && ((Game1.currentLocation.Map.GetLayer("Front").PickTile(new Location((int)Game1.player.Position.X, (int)Game1.player.Position.Y - 38), Game1.viewport.Size) != null && !Game1.currentLocation.Map.GetLayer("Front").PickTile(new Location((int)Game1.player.Position.X, (int)Game1.player.Position.Y - 38), Game1.viewport.Size).TileIndexProperties.ContainsKey("FrontAlways")) || (Game1.currentLocation.Map.GetLayer("Front").PickTile(new Location(Game1.player.GetBoundingBox().Right, (int)Game1.player.Position.Y - 38), Game1.viewport.Size) != null && !Game1.currentLocation.Map.GetLayer("Front").PickTile(new Location(Game1.player.GetBoundingBox().Right, (int)Game1.player.Position.Y - 38), Game1.viewport.Size).TileIndexProperties.ContainsKey("FrontAlways"))))
-                {
-                    Game1.drawPlayerHeldObject(Game1.player);
-                }
-                if ((Game1.player.UsingTool || Game1.pickingTool) && Game1.player.CurrentTool != null && (!Game1.player.CurrentTool.Name.Equals("Seeds") || Game1.pickingTool) && Game1.currentLocation.Map.GetLayer("Front").PickTile(new Location(Game1.player.getStandingX(), (int)Game1.player.Position.Y - 38), Game1.viewport.Size) != null && Game1.currentLocation.Map.GetLayer("Front").PickTile(new Location(Game1.player.getStandingX(), Game1.player.getStandingY()), Game1.viewport.Size) == null)
-                {
-                    Game1.drawTool(Game1.player);
-                }
                 if (Game1.currentLocation.Map.GetLayer("AlwaysFront") != null)
                 {
                     Game1.mapDisplayDevice.BeginScene(Game1.spriteBatch);
@@ -639,7 +641,7 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.toolHold > 400f && Game1.player.CurrentTool.UpgradeLevel >= 1 && Game1.player.canReleaseTool)
                 {
-                    Color barColor = Color.White;
+                    Microsoft.Xna.Framework.Color barColor = Microsoft.Xna.Framework.Color.White;
                     switch ((int)(Game1.toolHold / 600f) + 2)
                     {
                         case 1:
@@ -655,17 +657,20 @@ namespace StardewModdingAPI.Framework
                             barColor = Tool.iridiumColor;
                             break;
                     }
-                    Game1.spriteBatch.Draw(Game1.littleEffect, new Microsoft.Xna.Framework.Rectangle((int)Game1.player.getLocalPosition(Game1.viewport).X - 2, (int)Game1.player.getLocalPosition(Game1.viewport).Y - ((!Game1.player.CurrentTool.Name.Equals("Watering Can")) ? 64 : 0) - 2, (int)(Game1.toolHold % 600f * 0.08f) + 4, 12), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.littleEffect, new Microsoft.Xna.Framework.Rectangle((int)Game1.player.getLocalPosition(Game1.viewport).X - 2, (int)Game1.player.getLocalPosition(Game1.viewport).Y - ((!Game1.player.CurrentTool.Name.Equals("Watering Can")) ? 64 : 0) - 2, (int)(Game1.toolHold % 600f * 0.08f) + 4, 12), Microsoft.Xna.Framework.Color.Black);
                     Game1.spriteBatch.Draw(Game1.littleEffect, new Microsoft.Xna.Framework.Rectangle((int)Game1.player.getLocalPosition(Game1.viewport).X, (int)Game1.player.getLocalPosition(Game1.viewport).Y - ((!Game1.player.CurrentTool.Name.Equals("Watering Can")) ? 64 : 0), (int)(Game1.toolHold % 600f * 0.08f), 8), barColor);
                 }
-                this.drawWeather(gameTime, target_screen);
+                if (!Game1.IsFakedBlackScreen())
+                {
+                    this.drawWeather(gameTime, target_screen);
+                }
                 if (Game1.farmEvent != null)
                 {
                     Game1.farmEvent.draw(Game1.spriteBatch);
                 }
                 if (Game1.currentLocation.LightLevel > 0f && Game1.timeOfDay < 2000)
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.Black * Game1.currentLocation.LightLevel);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.Black * Game1.currentLocation.LightLevel);
                 }
                 if (Game1.screenGlow)
                 {
@@ -680,32 +685,44 @@ namespace StardewModdingAPI.Framework
                 Game1.spriteBatch.Begin(SpriteSortMode.FrontToBack, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                 if (Game1.eventUp && Game1.currentLocation.currentEvent != null)
                 {
-                    foreach (NPC m in Game1.currentLocation.currentEvent.actors)
+                    foreach (NPC l in Game1.currentLocation.currentEvent.actors)
                     {
-                        if (m.isEmoting)
+                        if (l.isEmoting)
                         {
-                            Vector2 emotePosition = m.getLocalPosition(Game1.viewport);
+                            Vector2 emotePosition = l.getLocalPosition(Game1.viewport);
+                            if (l.NeedsBirdieEmoteHack())
+                            {
+                                emotePosition.X += 64f;
+                            }
                             emotePosition.Y -= 140f;
-                            if (m.Age == 2)
+                            if (l.Age == 2)
                             {
                                 emotePosition.Y += 32f;
                             }
-                            else if (m.Gender == 1)
+                            else if (l.Gender == 1)
                             {
                                 emotePosition.Y += 10f;
                             }
-                            Game1.spriteBatch.Draw(Game1.emoteSpriteSheet, emotePosition, new Microsoft.Xna.Framework.Rectangle(m.CurrentEmoteIndex * 16 % Game1.emoteSpriteSheet.Width, m.CurrentEmoteIndex * 16 / Game1.emoteSpriteSheet.Width * 16, 16, 16), Color.White, 0f, Vector2.Zero, 4f, SpriteEffects.None, (float)m.getStandingY() / 10000f);
+                            Game1.spriteBatch.Draw(Game1.emoteSpriteSheet, emotePosition, new Microsoft.Xna.Framework.Rectangle(l.CurrentEmoteIndex * 16 % Game1.emoteSpriteSheet.Width, l.CurrentEmoteIndex * 16 / Game1.emoteSpriteSheet.Width * 16, 16, 16), Microsoft.Xna.Framework.Color.White, 0f, Vector2.Zero, 4f, SpriteEffects.None, (float)l.getStandingY() / 10000f);
                         }
                     }
                 }
                 Game1.spriteBatch.End();
-                if (Game1.drawLighting)
+                if (Game1.drawLighting && !Game1.IsFakedBlackScreen())
                 {
                     Game1.spriteBatch.Begin(SpriteSortMode.Deferred, this.lightingBlend, SamplerState.LinearClamp, null, null);
-                    Game1.spriteBatch.Draw(Game1.lightmap, Vector2.Zero, Game1.lightmap.Bounds, Color.White, 0f, Vector2.Zero, Game1.options.lightingQuality / 2, SpriteEffects.None, 1f);
-                    if (Game1.isRaining && (bool)Game1.currentLocation.isOutdoors && !(Game1.currentLocation is Desert))
+                    Viewport vp = base.GraphicsDevice.Viewport;
+                    vp.Bounds = (target_screen?.Bounds ?? base.GraphicsDevice.PresentationParameters.Bounds);
+                    base.GraphicsDevice.Viewport = vp;
+                    float render_zoom = Game1.options.lightingQuality / 2;
+                    if (this.useUnscaledLighting)
                     {
-                        Game1.spriteBatch.Draw(Game1.staminaRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.OrangeRed * 0.45f);
+                        render_zoom /= Game1.options.zoomLevel;
+                    }
+                    Game1.spriteBatch.Draw(Game1.lightmap, Vector2.Zero, Game1.lightmap.Bounds, Microsoft.Xna.Framework.Color.White, 0f, Vector2.Zero, render_zoom, SpriteEffects.None, 1f);
+                    if (Game1.IsRainingHere() && (bool)Game1.currentLocation.isOutdoors && !(Game1.currentLocation is Desert))
+                    {
+                        Game1.spriteBatch.Draw(Game1.staminaRect, vp.Bounds, Microsoft.Xna.Framework.Color.OrangeRed * 0.45f);
                     }
                     Game1.spriteBatch.End();
                 }
@@ -717,11 +734,11 @@ namespace StardewModdingAPI.Framework
                     float startingY = -Game1.viewport.Y % 64;
                     for (int x = startingX; x < Game1.graphics.GraphicsDevice.Viewport.Width; x += 64)
                     {
-                        Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(x, (int)startingY, 1, Game1.graphics.GraphicsDevice.Viewport.Height), Color.Red * 0.5f);
+                        Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(x, (int)startingY, 1, Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Red * 0.5f);
                     }
                     for (float y = startingY; y < (float)Game1.graphics.GraphicsDevice.Viewport.Height; y += 64f)
                     {
-                        Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(startingX, (int)y, Game1.graphics.GraphicsDevice.Viewport.Width, 1), Color.Red * 0.5f);
+                        Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(startingX, (int)y, Game1.graphics.GraphicsDevice.Viewport.Width, 1), Microsoft.Xna.Framework.Color.Red * 0.5f);
                     }
                 }
                 if (Game1.currentBillboard != 0 && !this.takingMapScreenshot)
@@ -730,9 +747,14 @@ namespace StardewModdingAPI.Framework
                 }
                 if (!Game1.eventUp && Game1.farmEvent == null && Game1.currentBillboard == 0 && Game1.gameMode == 3 && !this.takingMapScreenshot && Game1.isOutdoorMapSmallerThanViewport())
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, -Math.Min(Game1.viewport.X, 4096), Game1.graphics.GraphicsDevice.Viewport.Height), Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64, 0, Math.Min(4096, Game1.graphics.GraphicsDevice.Viewport.Width - (-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64)), Game1.graphics.GraphicsDevice.Viewport.Height), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, -Math.Min(Game1.viewport.X, 4096), Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64, 0, Math.Min(4096, Game1.graphics.GraphicsDevice.Viewport.Width - (-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64)), Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, Game1.graphics.GraphicsDevice.Viewport.Width, -Math.Min(Game1.viewport.Y, 4096)), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, -Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64, Game1.graphics.GraphicsDevice.Viewport.Width, Math.Min(4096, Game1.graphics.GraphicsDevice.Viewport.Height - (-Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64))), Microsoft.Xna.Framework.Color.Black);
                 }
+                Game1.spriteBatch.End();
+                Game1.PushUIMode();
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                 if ((Game1.displayHUD || Game1.eventUp) && Game1.currentBillboard == 0 && Game1.gameMode == 3 && !Game1.freezeControls && !Game1.panMode && !Game1.HostPaused && !this.takingMapScreenshot)
                 {
                     events.RenderingHud.RaiseEmpty();
@@ -750,37 +772,52 @@ namespace StardewModdingAPI.Framework
                         Game1.hudMessages[j].draw(Game1.spriteBatch, j);
                     }
                 }
+                Game1.spriteBatch.End();
+                Game1.PopUIMode();
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
             }
             if (Game1.farmEvent != null)
             {
                 Game1.farmEvent.draw(Game1.spriteBatch);
+                Game1.spriteBatch.End();
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
             }
+            Game1.PushUIMode();
             if (Game1.dialogueUp && !Game1.nameSelectUp && !Game1.messagePause && (Game1.activeClickableMenu == null || !(Game1.activeClickableMenu is DialogueBox)) && !this.takingMapScreenshot)
             {
                 this.drawDialogueBox();
             }
             if (Game1.progressBar && !this.takingMapScreenshot)
             {
-                Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle((Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Width - Game1.dialogueWidth) / 2, Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Bottom - 128, Game1.dialogueWidth, 32), Color.LightGray);
-                Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle((Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Width - Game1.dialogueWidth) / 2, Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Bottom - 128, (int)(Game1.pauseAccumulator / Game1.pauseTime * (float)Game1.dialogueWidth), 32), Color.DimGray);
+                Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle((Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Width - Game1.dialogueWidth) / 2, Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Bottom - 128, Game1.dialogueWidth, 32), Microsoft.Xna.Framework.Color.LightGray);
+                Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle((Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Width - Game1.dialogueWidth) / 2, Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Bottom - 128, (int)(Game1.pauseAccumulator / Game1.pauseTime * (float)Game1.dialogueWidth), 32), Microsoft.Xna.Framework.Color.DimGray);
             }
+            Game1.spriteBatch.End();
+            Game1.PopUIMode();
+            Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
             if (Game1.eventUp && Game1.currentLocation != null && Game1.currentLocation.currentEvent != null)
             {
                 Game1.currentLocation.currentEvent.drawAfterMap(Game1.spriteBatch);
             }
-            if (Game1.isRaining && Game1.currentLocation != null && (bool)Game1.currentLocation.isOutdoors && !(Game1.currentLocation is Desert))
+            if (!Game1.IsFakedBlackScreen() && Game1.IsRainingHere() && Game1.currentLocation != null && (bool)Game1.currentLocation.isOutdoors && !(Game1.currentLocation is Desert))
             {
-                Game1.spriteBatch.Draw(Game1.staminaRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.Blue * 0.2f);
+                Game1.spriteBatch.Draw(Game1.staminaRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.Blue * 0.2f);
             }
             if ((Game1.fadeToBlack || Game1.globalFade) && !Game1.menuUp && (!Game1.nameSelectUp || Game1.messagePause) && !this.takingMapScreenshot)
             {
-                Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.Black * ((Game1.gameMode == 0) ? (1f - Game1.fadeToBlackAlpha) : Game1.fadeToBlackAlpha));
+                Game1.spriteBatch.End();
+                Game1.PushUIMode();
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.Black * ((Game1.gameMode == 0) ? (1f - Game1.fadeToBlackAlpha) : Game1.fadeToBlackAlpha));
+                Game1.spriteBatch.End();
+                Game1.PopUIMode();
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
             }
             else if (Game1.flashAlpha > 0f && !this.takingMapScreenshot)
             {
                 if (Game1.options.screenFlash)
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.White * Math.Min(1f, Game1.flashAlpha));
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.White * Math.Min(1f, Game1.flashAlpha));
                 }
                 Game1.flashAlpha -= 0.1f;
             }
@@ -794,6 +831,16 @@ namespace StardewModdingAPI.Framework
                 {
                     screenOverlayTempSprite.draw(Game1.spriteBatch, localPosition: true);
                 }
+                Game1.spriteBatch.End();
+                Game1.PushUIMode();
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                foreach (TemporaryAnimatedSprite uiOverlayTempSprite in Game1.uiOverlayTempSprites)
+                {
+                    uiOverlayTempSprite.draw(Game1.spriteBatch, localPosition: true);
+                }
+                Game1.spriteBatch.End();
+                Game1.PopUIMode();
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
             }
             if (Game1.debugMode)
             {
@@ -825,23 +872,30 @@ namespace StardewModdingAPI.Framework
                 sb.Append(Game1.getMouseY() + Game1.viewport.Y);
                 sb.Append("  debugOutput: ");
                 sb.Append(Game1.debugOutput);
-                Game1.spriteBatch.DrawString(Game1.smallFont, sb, new Vector2(base.GraphicsDevice.Viewport.GetTitleSafeArea().X, base.GraphicsDevice.Viewport.GetTitleSafeArea().Y + Game1.smallFont.LineSpacing * 8), Color.Red, 0f, Vector2.Zero, 1f, SpriteEffects.None, 0.9999999f);
+                Game1.spriteBatch.DrawString(Game1.smallFont, sb, new Vector2(base.GraphicsDevice.Viewport.GetTitleSafeArea().X, base.GraphicsDevice.Viewport.GetTitleSafeArea().Y + Game1.smallFont.LineSpacing * 8), Microsoft.Xna.Framework.Color.Red, 0f, Vector2.Zero, 1f, SpriteEffects.None, 0.9999999f);
             }
+            Game1.spriteBatch.End();
+            Game1.PushUIMode();
+            Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
             if (Game1.showKeyHelp && !this.takingMapScreenshot)
             {
-                Game1.spriteBatch.DrawString(Game1.smallFont, Game1.keyHelpString, new Vector2(64f, (float)(Game1.viewport.Height - 64 - (Game1.dialogueUp ? (192 + (Game1.isQuestion ? (Game1.questionChoices.Count * 64) : 0)) : 0)) - Game1.smallFont.MeasureString(Game1.keyHelpString).Y), Color.LightGray, 0f, Vector2.Zero, 1f, SpriteEffects.None, 0.9999999f);
+                Game1.spriteBatch.DrawString(Game1.smallFont, Game1.keyHelpString, new Vector2(64f, (float)(Game1.viewport.Height - 64 - (Game1.dialogueUp ? (192 + (Game1.isQuestion ? (Game1.questionChoices.Count * 64) : 0)) : 0)) - Game1.smallFont.MeasureString(Game1.keyHelpString).Y), Microsoft.Xna.Framework.Color.LightGray, 0f, Vector2.Zero, 1f, SpriteEffects.None, 0.9999999f);
             }
             if (Game1.activeClickableMenu != null && !this.takingMapScreenshot)
             {
+                IClickableMenu curMenu = null;
                 try
                 {
                     events.RenderingActiveMenu.RaiseEmpty();
-                    Game1.activeClickableMenu.draw(Game1.spriteBatch);
+                    for (curMenu = Game1.activeClickableMenu; curMenu != null; curMenu = curMenu.GetChildMenu())
+                    {
+                        curMenu.draw(Game1.spriteBatch);
+                    }
                     events.RenderedActiveMenu.RaiseEmpty();
                 }
                 catch (Exception ex)
                 {
-                    this.Monitor.Log($"The {Game1.activeClickableMenu.GetType().FullName} menu crashed while drawing itself. SMAPI will force it to exit to avoid crashing the game.\n{ex.GetLogSummary()}", LogLevel.Error);
+                    this.Monitor.Log($"The {curMenu.GetMenuChainLabel()} menu crashed while drawing itself. SMAPI will force it to exit to avoid crashing the game.\n{ex.GetLogSummary()}", LogLevel.Error);
                     Game1.activeClickableMenu.exitThisMenu();
                 }
             }
@@ -849,6 +903,10 @@ namespace StardewModdingAPI.Framework
             {
                 Game1.farmEvent.drawAboveEverything(Game1.spriteBatch);
             }
+            if (Game1.specialCurrencyDisplay != null)
+            {
+                Game1.specialCurrencyDisplay.Draw(Game1.spriteBatch);
+            }
             if (Game1.emoteMenu != null && !this.takingMapScreenshot)
             {
                 Game1.emoteMenu.draw(Game1.spriteBatch);
@@ -861,7 +919,7 @@ namespace StardewModdingAPI.Framework
             events.Rendered.RaiseEmpty();
             Game1.spriteBatch.End();
             this.drawOverlays(Game1.spriteBatch);
-            this.renderScreenBuffer(target_screen);
+            Game1.PopUIMode();
         }
     }
 }

From ffe74869ca626883f3f65116fd19af2d4951156e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:34:59 -0500
Subject: [PATCH 007/856] update patches and asset propagation

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 104 ++++++++++++++++------
 src/SMAPI/Patches/DialogueErrorPatch.cs   |   4 +-
 src/SMAPI/Patches/ScheduleErrorPatch.cs   |   2 +-
 3 files changed, 78 insertions(+), 32 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 307bb11b..b82dedfd 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -138,12 +138,20 @@ namespace StardewModdingAPI.Metadata
                 {
                     if (!string.IsNullOrWhiteSpace(location.mapPath.Value) && this.NormalizeAssetNameIgnoringEmpty(location.mapPath.Value) == key)
                     {
-                        // reset town caches
-                        if (location is Town town)
+                        // reset patch caches
+                        switch (location)
                         {
-                            this.Reflection.GetField<bool>(town, "ccRefurbished").SetValue(false);
-                            this.Reflection.GetField<bool>(town, "isShowingDestroyedJoja").SetValue(false);
-                            this.Reflection.GetField<bool>(town, "isShowingUpgradedPamHouse").SetValue(false);
+                            case Town _:
+                                this.Reflection.GetField<bool>(location, "ccRefurbished").SetValue(false);
+                                this.Reflection.GetField<bool>(location, "isShowingDestroyedJoja").SetValue(false);
+                                this.Reflection.GetField<bool>(location, "isShowingUpgradedPamHouse").SetValue(false);
+                                break;
+
+                            case Beach _:
+                            case BeachNightMarket _:
+                            case Forest _:
+                                this.Reflection.GetField<bool>(location, "hasShownCCUpgrade").SetValue(false);
+                                break;
                         }
 
                         // general updates
@@ -271,6 +279,9 @@ namespace StardewModdingAPI.Metadata
                 case "data\\farmanimals": // FarmAnimal constructor
                     return this.ReloadFarmAnimalData();
 
+                case "data\\hairdata": // Farmer.GetHairStyleMetadataFile
+                    return this.ReloadHairData();
+
                 case "data\\moviesreactions": // MovieTheater.GetMovieReactions
                     this.Reflection
                         .GetField<List<MovieCharacterReaction>>(typeof(MovieTheater), "_genericReactions")
@@ -388,13 +399,19 @@ namespace StardewModdingAPI.Metadata
                     Game1.shadowTexture = content.Load<Texture2D>(key);
                     return true;
 
+                case "loosesprites\\suspensionbridge": // SuspensionBridge constructor
+                    return this.ReloadSuspensionBridges(content, key);
+
                 /****
                 ** Content\TileSheets
                 ****/
-                case "tilesheets\\critters": // Critter constructor
-                    this.ReloadCritterTextures(content, key);
+                case "tilesheets\\chairtiles": // Game1.LoadContent
+                    MapSeat.mapChairTexture = content.Load<Texture2D>(key);
                     return true;
 
+                case "tilesheets\\critters": // Critter constructor
+                    return this.ReloadCritterTextures(content, key) > 0;
+
                 case "tilesheets\\crops": // Game1.LoadContent
                     Game1.cropSpriteSheet = content.Load<Texture2D>(key);
                     return true;
@@ -411,6 +428,10 @@ namespace StardewModdingAPI.Metadata
                     Furniture.furnitureTexture = content.Load<Texture2D>(key);
                     return true;
 
+                case "tilesheets\\furniturefront": // Game1.LoadContent
+                    Furniture.furnitureFrontTexture = content.Load<Texture2D>(key);
+                    return true;
+
                 case "tilesheets\\projectiles": // Game1.LoadContent
                     Projectile.projectileSheet = content.Load<Texture2D>(key);
                     return true;
@@ -612,7 +633,7 @@ namespace StardewModdingAPI.Metadata
             // update sprites
             Texture2D texture = content.Load<Texture2D>(key);
             foreach (TAnimal animal in animals)
-                this.SetSpriteTexture(animal.Sprite, texture);
+                animal.Sprite.spriteTexture = texture;
             return true;
         }
 
@@ -642,7 +663,7 @@ namespace StardewModdingAPI.Metadata
 
                 // reload asset
                 if (expectedKey == key)
-                    this.SetSpriteTexture(animal.Sprite, texture.Value);
+                    animal.Sprite.spriteTexture = texture.Value;
             }
             return texture.IsValueCreated;
         }
@@ -682,9 +703,8 @@ namespace StardewModdingAPI.Metadata
             Critter[] critters =
                 (
                     from location in this.GetLocations()
-                    let locCritters = this.Reflection.GetField<List<Critter>>(location, "critters").GetValue()
-                    where locCritters != null
-                    from Critter critter in locCritters
+                    where location.critters != null
+                    from Critter critter in location.critters
                     where this.NormalizeAssetNameIgnoringEmpty(critter.sprite?.Texture?.Name) == key
                     select critter
                 )
@@ -695,7 +715,7 @@ namespace StardewModdingAPI.Metadata
             // update sprites
             Texture2D texture = content.Load<Texture2D>(key);
             foreach (var entry in critters)
-                this.SetSpriteTexture(entry.sprite, texture);
+                entry.sprite.spriteTexture = texture;
 
             return critters.Length;
         }
@@ -752,10 +772,7 @@ namespace StardewModdingAPI.Metadata
                 (
                     from location in this.GetLocations()
                     from grass in location.terrainFeatures.Values.OfType<Grass>()
-                    let textureName = this.NormalizeAssetNameIgnoringEmpty(
-                        this.Reflection.GetMethod(grass, "textureName").Invoke<string>()
-                    )
-                    where textureName == key
+                    where this.NormalizeAssetNameIgnoringEmpty(grass.textureName()) == key
                     select grass
                 )
                 .ToArray();
@@ -764,13 +781,28 @@ namespace StardewModdingAPI.Metadata
             {
                 Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
                 foreach (Grass grass in grasses)
-                    this.Reflection.GetField<Lazy<Texture2D>>(grass, "texture").SetValue(texture);
+                    grass.texture = texture;
                 return true;
             }
 
             return false;
         }
 
+        /// <summary>Reload hair style metadata.</summary>
+        /// <returns>Returns whether any assets were reloaded.</returns>
+        /// <remarks>Derived from the <see cref="Farmer.GetHairStyleMetadataFile"/> and <see cref="Farmer.GetHairStyleMetadata"/>.</remarks>
+        private bool ReloadHairData()
+        {
+            if (Farmer.hairStyleMetadataFile == null)
+                return false;
+
+            Farmer.hairStyleMetadataFile = null;
+            Farmer.allHairStyleIndices = null;
+            Farmer.hairStyleMetadata.Clear();
+
+            return true;
+        }
+
         /// <summary>Reload the disposition data for matching NPCs.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="key">The asset key to reload.</param>
@@ -813,7 +845,7 @@ namespace StardewModdingAPI.Metadata
             // update sprite
             foreach (var target in characters)
             {
-                this.SetSpriteTexture(target.Npc.Sprite, content.Load<Texture2D>(target.Key));
+                target.Npc.Sprite.spriteTexture = content.Load<Texture2D>(target.Key);
                 propagated[target.Key] = true;
             }
         }
@@ -877,6 +909,29 @@ namespace StardewModdingAPI.Metadata
             return players.Any();
         }
 
+        /// <summary>Reload suspension bridge textures.</summary>
+        /// <param name="content">The content manager through which to reload the asset.</param>
+        /// <param name="key">The asset key to reload.</param>
+        /// <returns>Returns whether any textures were reloaded.</returns>
+        private bool ReloadSuspensionBridges(LocalizedContentManager content, string key)
+        {
+            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
+
+            foreach (GameLocation location in this.GetLocations(buildingInteriors: false))
+            {
+                // get suspension bridges field
+                var field = this.Reflection.GetField<IEnumerable<SuspensionBridge>>(location, nameof(IslandNorth.suspensionBridges), required: false);
+                if (field == null || !typeof(IEnumerable<SuspensionBridge>).IsAssignableFrom(field.FieldInfo.FieldType))
+                    continue;
+
+                // update textures
+                foreach (SuspensionBridge bridge in field.GetValue())
+                    this.Reflection.GetField<Texture2D>(bridge, "_texture").SetValue(texture.Value);
+            }
+
+            return texture.IsValueCreated;
+        }
+
         /// <summary>Reload tree textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="key">The asset key to reload.</param>
@@ -958,7 +1013,8 @@ namespace StardewModdingAPI.Metadata
                     int lastScheduleTime = villager.Schedule.Keys.Where(p => p <= Game1.timeOfDay).OrderByDescending(p => p).FirstOrDefault();
                     if (lastScheduleTime != 0)
                     {
-                        villager.scheduleTimeToTry = NPC.NO_TRY; // use time that's passed in to checkSchedule
+                        villager.queuedSchedulePaths.Clear();
+                        villager.lastAttemptedSchedule = 0;
                         villager.checkSchedule(lastScheduleTime);
                     }
                 }
@@ -969,14 +1025,6 @@ namespace StardewModdingAPI.Metadata
         /****
         ** Helpers
         ****/
-        /// <summary>Reload the texture for an animated sprite.</summary>
-        /// <param name="sprite">The animated sprite to update.</param>
-        /// <param name="texture">The texture to set.</param>
-        private void SetSpriteTexture(AnimatedSprite sprite, Texture2D texture)
-        {
-            this.Reflection.GetField<Texture2D>(sprite, "spriteTexture").SetValue(texture);
-        }
-
         /// <summary>Get all NPCs in the game (excluding farm animals).</summary>
         private IEnumerable<NPC> GetCharacters()
         {
diff --git a/src/SMAPI/Patches/DialogueErrorPatch.cs b/src/SMAPI/Patches/DialogueErrorPatch.cs
index 42494390..215df561 100644
--- a/src/SMAPI/Patches/DialogueErrorPatch.cs
+++ b/src/SMAPI/Patches/DialogueErrorPatch.cs
@@ -135,11 +135,9 @@ namespace StardewModdingAPI.Patches
             IReflectedMethod translateArraysOfStrings = DialogueErrorPatch.Reflection.GetMethod(typeof(Dialogue), "TranslateArraysOfStrings");
             IReflectedMethod parseDialogueString = DialogueErrorPatch.Reflection.GetMethod(__instance, "parseDialogueString");
             IReflectedMethod checkForSpecialDialogueAttributes = DialogueErrorPatch.Reflection.GetMethod(__instance, "checkForSpecialDialogueAttributes");
-            IReflectedField<List<string>> dialogues = DialogueErrorPatch.Reflection.GetField<List<string>>(__instance, "dialogues");
 
             // replicate base constructor
-            if (dialogues.GetValue() == null)
-                dialogues.SetValue(new List<string>());
+            __instance.dialogues ??= new List<string>();
 
             // duplicate code with try..catch
             try
diff --git a/src/SMAPI/Patches/ScheduleErrorPatch.cs b/src/SMAPI/Patches/ScheduleErrorPatch.cs
index 17db07a6..1d58a292 100644
--- a/src/SMAPI/Patches/ScheduleErrorPatch.cs
+++ b/src/SMAPI/Patches/ScheduleErrorPatch.cs
@@ -51,7 +51,7 @@ namespace StardewModdingAPI.Patches
 #endif
         {
             harmony.Patch(
-                original: AccessTools.Method(typeof(NPC), "parseMasterSchedule"),
+                original: AccessTools.Method(typeof(NPC), nameof(NPC.parseMasterSchedule)),
 #if HARMONY_2
                 finalizer: new HarmonyMethod(this.GetType(), nameof(ScheduleErrorPatch.Finalize_NPC_parseMasterSchedule))
 #else

From ff167e68382a26577e2ce759ec8376b584584c83 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:35:00 -0500
Subject: [PATCH 008/856] update for map tilesheet changes

---
 .../ContentManagers/ModContentManager.cs      | 130 +++++++-----------
 1 file changed, 48 insertions(+), 82 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 12d672cf..127705ea 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -12,7 +12,6 @@ using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
 using xTile;
 using xTile.Format;
-using xTile.ObjectModel;
 using xTile.Tiles;
 
 namespace StardewModdingAPI.Framework.ContentManagers
@@ -127,8 +126,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
                             asset = this.RawLoad<T>(assetName, useCache: false);
                             if (asset is Map map)
                             {
-                                this.NormalizeTilesheetPaths(map);
-                                this.FixCustomTilesheetPaths(map, relativeMapPath: assetName);
+                                map.assetPath = assetName;
+                                this.FixTilesheetPaths(map, relativeMapPath: assetName);
                             }
                         }
                         break;
@@ -168,8 +167,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
                             // fetch & cache
                             FormatManager formatManager = FormatManager.Instance;
                             Map map = formatManager.LoadMap(file.FullName);
-                            this.NormalizeTilesheetPaths(map);
-                            this.FixCustomTilesheetPaths(map, relativeMapPath: assetName);
+                            map.assetPath = assetName;
+                            this.FixTilesheetPaths(map, relativeMapPath: assetName);
                             asset = (T)(object)map;
                         }
                         break;
@@ -257,44 +256,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return texture;
         }
 
-        /// <summary>Normalize map tilesheet paths for the current platform.</summary>
-        /// <param name="map">The map whose tilesheets to fix.</param>
-        private void NormalizeTilesheetPaths(Map map)
-        {
-            foreach (TileSheet tilesheet in map.TileSheets)
-                tilesheet.ImageSource = this.NormalizePathSeparators(tilesheet.ImageSource);
-        }
-
         /// <summary>Fix custom map tilesheet paths so they can be found by the content manager.</summary>
         /// <param name="map">The map whose tilesheets to fix.</param>
         /// <param name="relativeMapPath">The relative map path within the mod folder.</param>
         /// <exception cref="ContentLoadException">A map tilesheet couldn't be resolved.</exception>
-        /// <remarks>
-        /// The game's logic for tilesheets in <see cref="Game1.setGraphicsForSeason"/> is a bit specialized. It boils
-        /// down to this:
-        ///  * If the location is indoors or the desert, or the image source contains 'path' or 'object', it's loaded
-        ///    as-is relative to the <c>Content</c> folder.
-        ///  * Else it's loaded from <c>Content\Maps</c> with a seasonal prefix.
-        ///
-        /// That logic doesn't work well in our case, mainly because we have no location metadata at this point.
-        /// Instead we use a more heuristic approach: check relative to the map file first, then relative to
-        /// <c>Content\Maps</c>, then <c>Content</c>. If the image source filename contains a seasonal prefix, try for a
-        /// seasonal variation and then an exact match.
-        ///
-        /// While that doesn't exactly match the game logic, it's close enough that it's unlikely to make a difference.
-        /// </remarks>
-        private void FixCustomTilesheetPaths(Map map, string relativeMapPath)
+        private void FixTilesheetPaths(Map map, string relativeMapPath)
         {
             // get map info
-            if (!map.TileSheets.Any())
-                return;
             relativeMapPath = this.AssertAndNormalizeAssetName(relativeMapPath); // Mono's Path.GetDirectoryName doesn't handle Windows dir separators
             string relativeMapFolder = Path.GetDirectoryName(relativeMapPath) ?? ""; // folder path containing the map, relative to the mod folder
-            bool isOutdoors = map.Properties.TryGetValue("Outdoors", out PropertyValue outdoorsProperty) && outdoorsProperty != null;
 
             // fix tilesheets
             foreach (TileSheet tilesheet in map.TileSheets)
             {
+                tilesheet.ImageSource = this.NormalizePathSeparators(tilesheet.ImageSource);
+
                 string imageSource = tilesheet.ImageSource;
                 string errorPrefix = $"{this.ModName} loaded map '{relativeMapPath}' with invalid tilesheet path '{imageSource}'.";
 
@@ -305,7 +281,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // load best match
                 try
                 {
-                    if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, isOutdoors, out string assetName, out string error))
+                    if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out string assetName, out string error))
                         throw new SContentLoadException($"{errorPrefix} {error}");
 
                     tilesheet.ImageSource = assetName;
@@ -319,37 +295,23 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Get the actual asset name for a tilesheet.</summary>
         /// <param name="modRelativeMapFolder">The folder path containing the map, relative to the mod folder.</param>
-        /// <param name="originalPath">The tilesheet path to load.</param>
-        /// <param name="willSeasonalize">Whether the game will apply seasonal logic to the tilesheet.</param>
+        /// <param name="relativePath">The tilesheet path to load.</param>
         /// <param name="assetName">The found asset name.</param>
         /// <param name="error">A message indicating why the file couldn't be loaded.</param>
         /// <returns>Returns whether the asset name was found.</returns>
-        /// <remarks>See remarks on <see cref="FixCustomTilesheetPaths"/>.</remarks>
-        private bool TryGetTilesheetAssetName(string modRelativeMapFolder, string originalPath, bool willSeasonalize, out string assetName, out string error)
+        /// <remarks>See remarks on <see cref="FixTilesheetPaths"/>.</remarks>
+        private bool TryGetTilesheetAssetName(string modRelativeMapFolder, string relativePath, out string assetName, out string error)
         {
             assetName = null;
             error = null;
 
             // nothing to do
-            if (string.IsNullOrWhiteSpace(originalPath))
+            if (string.IsNullOrWhiteSpace(relativePath))
             {
-                assetName = originalPath;
+                assetName = relativePath;
                 return true;
             }
 
-            // parse path
-            string filename = Path.GetFileName(originalPath);
-            bool isSeasonal = filename.StartsWith("spring_", StringComparison.CurrentCultureIgnoreCase)
-                || filename.StartsWith("summer_", StringComparison.CurrentCultureIgnoreCase)
-                || filename.StartsWith("fall_", StringComparison.CurrentCultureIgnoreCase)
-                || filename.StartsWith("winter_", StringComparison.CurrentCultureIgnoreCase);
-            string relativePath = originalPath;
-            if (willSeasonalize && isSeasonal)
-            {
-                string dirPath = Path.GetDirectoryName(originalPath);
-                relativePath = Path.Combine(dirPath, $"{Game1.currentSeason}_{filename.Substring(filename.IndexOf("_", StringComparison.CurrentCultureIgnoreCase) + 1)}");
-            }
-
             // get relative to map file
             {
                 string localKey = Path.Combine(modRelativeMapFolder, relativePath);
@@ -361,38 +323,24 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // get from game assets
-            // Map tilesheet keys shouldn't include the "Maps/" prefix (the game will add it automatically) or ".png" extension.
+            string contentKey = this.GetContentKeyForTilesheetImageSource(relativePath);
+            try
             {
-                string contentKey = relativePath;
-                foreach (char separator in PathUtilities.PossiblePathSeparators)
-                {
-                    if (contentKey.StartsWith($"Maps{separator}"))
-                    {
-                        contentKey = contentKey.Substring(5);
-                        break;
-                    }
-                }
-                if (contentKey.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
-                    contentKey = contentKey.Substring(0, contentKey.Length - 4);
-
-                try
-                {
-                    this.GameContentManager.Load<Texture2D>(Path.Combine("Maps", contentKey), this.Language, useCache: true); // no need to bypass cache here, since we're not storing the asset
-                    assetName = contentKey;
-                    return true;
-                }
-                catch
-                {
-                    // ignore file-not-found errors
-                    // TODO: while it's useful to suppress an asset-not-found error here to avoid
-                    // confusion, this is a pretty naive approach. Even if the file doesn't exist,
-                    // the file may have been loaded through an IAssetLoader which failed. So even
-                    // if the content file doesn't exist, that doesn't mean the error here is a
-                    // content-not-found error. Unfortunately XNA doesn't provide a good way to
-                    // detect the error type.
-                    if (this.GetContentFolderFileExists(contentKey))
-                        throw;
-                }
+                this.GameContentManager.Load<Texture2D>(contentKey, this.Language, useCache: true); // no need to bypass cache here, since we're not storing the asset
+                assetName = contentKey;
+                return true;
+            }
+            catch
+            {
+                // ignore file-not-found errors
+                // TODO: while it's useful to suppress an asset-not-found error here to avoid
+                // confusion, this is a pretty naive approach. Even if the file doesn't exist,
+                // the file may have been loaded through an IAssetLoader which failed. So even
+                // if the content file doesn't exist, that doesn't mean the error here is a
+                // content-not-found error. Unfortunately XNA doesn't provide a good way to
+                // detect the error type.
+                if (this.GetContentFolderFileExists(contentKey))
+                    throw;
             }
 
             // not found
@@ -412,5 +360,23 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // get file
             return new FileInfo(path).Exists;
         }
+
+        /// <summary>Get the asset key for a tilesheet in the game's <c>Maps</c> content folder.</summary>
+        /// <param name="relativePath">The tilesheet image source.</param>
+        private string GetContentKeyForTilesheetImageSource(string relativePath)
+        {
+            string key = relativePath;
+            string topFolder = PathUtilities.GetSegments(key, limit: 2)[0];
+
+            // convert image source relative to map file into asset key
+            if (!topFolder.Equals("Maps", StringComparison.OrdinalIgnoreCase))
+                key = Path.Combine("Maps", key);
+
+            // remove file extension from unpacked file
+            if (key.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
+                key = key.Substring(0, key.Length - 4);
+
+            return key;
+        }
     }
 }

From 7268cae65c19b7d4378ff5b4453afe0f42b2e241 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:35:00 -0500
Subject: [PATCH 009/856] update for localized asset changes

---
 .../ContentManagers/GameContentManager.cs     | 74 ++++++++-----------
 1 file changed, 30 insertions(+), 44 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index f20580e1..83a63986 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -29,8 +29,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Interceptors which edit matching assets after they're loaded.</summary>
         private IList<ModLinked<IAssetEditor>> Editors => this.Coordinator.Editors;
 
-        /// <summary>A lookup which indicates whether the asset is localizable (i.e. the filename contains the locale), if previously loaded.</summary>
-        private readonly IDictionary<string, bool> IsLocalizableLookup;
+        /// <summary>Maps asset names to their localized form, like <c>LooseSprites\Billboard => LooseSprites\Billboard.fr-FR</c> (localized) or <c>Maps\AnimalShop => Maps\AnimalShop</c> (not localized).</summary>
+        private IDictionary<string, string> LocalizedAssetNames => LocalizedContentManager.localizedAssetNames;
 
         /// <summary>Whether the next load is the first for any game content manager.</summary>
         private static bool IsFirstLoad = true;
@@ -55,7 +55,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         public GameContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: false)
         {
-            this.IsLocalizableLookup = reflection.GetField<IDictionary<string, bool>>(this, "_localizedAsset").GetValue();
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
         }
 
@@ -124,7 +123,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // find assets for which a translatable version was loaded
             HashSet<string> removeAssetNames = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
-            foreach (string key in this.IsLocalizableLookup.Where(p => p.Value).Select(p => p.Key))
+            foreach (string key in this.LocalizedAssetNames.Where(p => p.Key != p.Value).Select(p => p.Key))
                 removeAssetNames.Add(this.TryParseExplicitLanguageAssetKey(key, out string assetName, out _) ? assetName : key);
 
             // invalidate translatable assets
@@ -154,21 +153,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="normalizedAssetName">The normalized asset name.</param>
         protected override bool IsNormalizedKeyLoaded(string normalizedAssetName)
         {
-            // default English
-            if (this.Language == LocalizedContentManager.LanguageCode.en || this.Coordinator.IsManagedAssetKey(normalizedAssetName))
-                return this.Cache.ContainsKey(normalizedAssetName);
+            string cachedKey = null;
+            bool localized =
+                this.Language != LocalizedContentManager.LanguageCode.en
+                && !this.Coordinator.IsManagedAssetKey(normalizedAssetName)
+                && this.LocalizedAssetNames.TryGetValue(normalizedAssetName, out cachedKey);
 
-            // translated
-            string keyWithLocale = $"{normalizedAssetName}.{this.GetLocale(this.GetCurrentLanguage())}";
-            if (this.IsLocalizableLookup.TryGetValue(keyWithLocale, out bool localizable))
-            {
-                return localizable
-                    ? this.Cache.ContainsKey(keyWithLocale)
-                    : this.Cache.ContainsKey(normalizedAssetName);
-            }
-
-            // not loaded yet
-            return false;
+            return localized
+                ? this.Cache.ContainsKey(cachedKey)
+                : this.Cache.ContainsKey(normalizedAssetName);
         }
 
         /// <summary>Add tracking data to an asset and add it to the cache.</summary>
@@ -197,22 +190,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
             //      doesn't change the instance stored in the cache, e.g. using `asset.ReplaceWith`.
             if (useCache)
             {
-                string keyWithLocale = $"{assetName}.{this.GetLocale(language)}";
+                string translatedKey = $"{assetName}.{this.GetLocale(language)}";
                 base.TrackAsset(assetName, value, language, useCache: true);
-                if (this.Cache.ContainsKey(keyWithLocale))
-                    base.TrackAsset(keyWithLocale, value, language, useCache: true);
+                if (this.Cache.ContainsKey(translatedKey))
+                    base.TrackAsset(translatedKey, value, language, useCache: true);
 
                 // track whether the injected asset is translatable for is-loaded lookups
-                if (this.Cache.ContainsKey(keyWithLocale))
-                {
-                    this.IsLocalizableLookup[assetName] = true;
-                    this.IsLocalizableLookup[keyWithLocale] = true;
-                }
+                if (this.Cache.ContainsKey(translatedKey))
+                    this.LocalizedAssetNames[assetName] = translatedKey;
                 else if (this.Cache.ContainsKey(assetName))
-                {
-                    this.IsLocalizableLookup[assetName] = false;
-                    this.IsLocalizableLookup[keyWithLocale] = false;
-                }
+                    this.LocalizedAssetNames[assetName] = assetName;
                 else
                     this.Monitor.Log($"Asset '{assetName}' could not be found in the cache immediately after injection.", LogLevel.Error);
             }
@@ -226,24 +213,23 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <remarks>Derived from <see cref="LocalizedContentManager.Load{T}(string, LocalizedContentManager.LanguageCode)"/>.</remarks>
         private T RawLoad<T>(string assetName, LanguageCode language, bool useCache)
         {
-            // try translated asset
+            // use cached key
+            if (this.LocalizedAssetNames.TryGetValue(assetName, out string cachedKey))
+                return base.RawLoad<T>(cachedKey, useCache);
+
+            // try translated key
             if (language != LocalizedContentManager.LanguageCode.en)
             {
                 string translatedKey = $"{assetName}.{this.GetLocale(language)}";
-                if (!this.IsLocalizableLookup.TryGetValue(translatedKey, out bool isTranslatable) || isTranslatable)
+                try
                 {
-                    try
-                    {
-                        T obj = base.RawLoad<T>(translatedKey, useCache);
-                        this.IsLocalizableLookup[assetName] = true;
-                        this.IsLocalizableLookup[translatedKey] = true;
-                        return obj;
-                    }
-                    catch (ContentLoadException)
-                    {
-                        this.IsLocalizableLookup[assetName] = false;
-                        this.IsLocalizableLookup[translatedKey] = false;
-                    }
+                    T obj = base.RawLoad<T>(translatedKey, useCache);
+                    this.LocalizedAssetNames[assetName] = translatedKey;
+                    return obj;
+                }
+                catch (ContentLoadException)
+                {
+                    this.LocalizedAssetNames[assetName] = assetName;
                 }
             }
 

From 8d298991825bbb1c676ba592dd6f7fe0ecbb1e0b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:35:01 -0500
Subject: [PATCH 010/856] update for new save naming logic

---
 src/SMAPI/Constants.cs | 18 +++++-------------
 1 file changed, 5 insertions(+), 13 deletions(-)

diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index d0f34cee..5aa08887 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -275,21 +275,13 @@ namespace StardewModdingAPI
                 return null;
 
             // get basic info
-            string playerName;
-            ulong saveID;
-            if (Context.LoadStage == LoadStage.SaveParsed)
-            {
-                playerName = SaveGame.loaded.player.Name;
-                saveID = SaveGame.loaded.uniqueIDForThisGame;
-            }
-            else
-            {
-                playerName = Game1.player.Name;
-                saveID = Game1.uniqueIDForThisGame;
-            }
+            string saveName = Game1.GetSaveGameName(set_value: false);
+            ulong saveID = Context.LoadStage == LoadStage.SaveParsed
+                ? SaveGame.loaded.uniqueIDForThisGame
+                : Game1.uniqueIDForThisGame;
 
             // build folder name
-            return $"{new string(playerName.Where(char.IsLetterOrDigit).ToArray())}_{saveID}";
+            return $"{new string(saveName.Where(char.IsLetterOrDigit).ToArray())}_{saveID}";
         }
 
         /// <summary>Get the path to the current save folder, if any.</summary>

From 1870336f4c175b067690fdd6c390ae74bed984b7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:35:01 -0500
Subject: [PATCH 011/856] update for item changes

---
 src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index d1dd758b..34149209 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -107,12 +107,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
 
                 // furniture
                 foreach (int id in this.TryLoad<int, string>("Data\\Furniture").Keys)
-                {
-                    if (id == 1466 || id == 1468 || id == 1680)
-                        yield return this.TryCreate(ItemType.Furniture, id, p => new TV(p.ID, Vector2.Zero));
-                    else
-                        yield return this.TryCreate(ItemType.Furniture, id, p => new Furniture(p.ID, Vector2.Zero));
-                }
+                    yield return this.TryCreate(ItemType.Furniture, id, p => Furniture.GetFurnitureInstance(p.ID));
 
                 // craftables
                 foreach (int id in Game1.bigCraftablesInformation.Keys)

From fb244dc936b8929dc032ad326f8cad0c9fc80d92 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:35:01 -0500
Subject: [PATCH 012/856] update for location furniture changes

---
 docs/release-notes.md                         |  3 +++
 .../Framework/Commands/World/ClearCommand.cs  | 22 +++++++++++--------
 2 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 176961d4..2c3720e8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -15,6 +15,9 @@
   * Added `PerScreen<T>` utility and new `Context` fields to simplify split-screen support in mods.
   * Added screen ID to log when playing in split-screen mode.
 
+* For the Console Commands mod:
+  * Added `furniture` option to `world_clear`.
+
 ## 3.7.6
 Released 21 November 2020 for Stardew Valley 1.4.1 or later.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index 1190a4ab..29052be3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -16,7 +16,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         ** Fields
         *********/
         /// <summary>The valid types that can be cleared.</summary>
-        private readonly string[] ValidTypes = { "crops", "debris", "fruit-trees", "grass", "trees", "everything" };
+        private readonly string[] ValidTypes = { "crops", "debris", "fruit-trees", "furniture", "grass", "trees", "everything" };
 
         /// <summary>The resource clump IDs to consider debris.</summary>
         private readonly int[] DebrisClumps = { ResourceClump.stumpIndex, ResourceClump.hollowLogIndex, ResourceClump.meteoriteIndex, ResourceClump.boulderIndex };
@@ -32,7 +32,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                 description: "Clears in-game entities in a given location.\n\n"
                     + "Usage: world_clear <location> <object type>\n"
                     + "- location: the location name for which to clear objects (like Farm), or 'current' for the current location.\n"
-                    + " - object type: the type of object clear. You can specify 'crops', 'debris' (stones/twigs/weeds and dead crops), 'grass', and 'trees' / 'fruit-trees'. You can also specify 'everything', which includes things not removed by the other types (like furniture or resource clumps)."
+                    + " - object type: the type of object clear. You can specify 'crops', 'debris' (stones/twigs/weeds and dead crops), 'furniture', 'grass', and 'trees' / 'fruit-trees'. You can also specify 'everything', which includes things not removed by the other types (like resource clumps)."
             )
         { }
 
@@ -113,6 +113,13 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                         break;
                     }
 
+                case "furniture":
+                    {
+                        int removed = this.RemoveFurniture(location, furniture => true);
+                        monitor.Log($"Done! Removed {removed} entities from {location.Name}.", LogLevel.Info);
+                        break;
+                    }
+
                 case "grass":
                     {
                         int removed = this.RemoveTerrainFeatures(location, feature => feature is Grass);
@@ -244,15 +251,12 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         {
             int removed = 0;
 
-            if (location is DecoratableLocation decoratableLocation)
+            foreach (Furniture furniture in location.furniture.ToArray())
             {
-                foreach (Furniture furniture in decoratableLocation.furniture.ToArray())
+                if (shouldRemove(furniture))
                 {
-                    if (shouldRemove(furniture))
-                    {
-                        decoratableLocation.furniture.Remove(furniture);
-                        removed++;
-                    }
+                    location.furniture.Remove(furniture);
+                    removed++;
                 }
             }
 

From 1e8a07e333fb38242bb7a9dd2ada588c6c4b8dce Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:35:02 -0500
Subject: [PATCH 013/856] update for debug log changes

---
 src/SMAPI/Framework/Logging/LogManager.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index a2c0125e..ee013a85 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -32,10 +32,10 @@ namespace StardewModdingAPI.Framework.Logging
         private readonly Regex[] SuppressConsolePatterns =
         {
             new Regex(@"^TextBox\.Selected is now '(?:True|False)'\.$", RegexOptions.Compiled | RegexOptions.CultureInvariant),
-            new Regex(@"^(?:FRUIT )?TREE: IsClient:(?:True|False) randomOutput: \d+$", RegexOptions.Compiled | RegexOptions.CultureInvariant),
             new Regex(@"^loadPreferences\(\); begin", RegexOptions.Compiled | RegexOptions.CultureInvariant),
             new Regex(@"^savePreferences\(\); async=", RegexOptions.Compiled | RegexOptions.CultureInvariant),
-            new Regex(@"^DebugOutput:\s+(?:added CLOUD|added cricket|dismount tile|Ping|playerPos)", RegexOptions.Compiled | RegexOptions.CultureInvariant)
+            new Regex(@"^DebugOutput:\s+(?:added cricket|dismount tile|Ping|playerPos)", RegexOptions.Compiled | RegexOptions.CultureInvariant),
+            new Regex(@"^Ignoring keys: ", RegexOptions.Compiled | RegexOptions.CultureInvariant)
         };
 
         /// <summary>Regex patterns which match console messages to show a more friendly error for.</summary>

From 93f00b115e1d8bbd5745c0d1b4416f91550f2d2b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:35:02 -0500
Subject: [PATCH 014/856] add mod rewriters for SDV 1.5

---
 src/SMAPI/Metadata/InstructionMetadata.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 09a199f9..2c1e14ce 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -6,6 +6,7 @@ using StardewModdingAPI.Framework.ModLoading.Finders;
 using StardewModdingAPI.Framework.ModLoading.RewriteFacades;
 using StardewModdingAPI.Framework.ModLoading.Rewriters;
 using StardewValley;
+using StardewValley.Locations;
 
 namespace StardewModdingAPI.Metadata
 {
@@ -35,6 +36,11 @@ namespace StardewModdingAPI.Metadata
             if (platformChanged)
                 yield return new MethodParentRewriter(typeof(SpriteBatch), typeof(SpriteBatchFacade));
 
+            // rewrite for Stardew Valley 1.5
+            yield return new FieldReplaceRewriter(typeof(DecoratableLocation), "furniture", typeof(GameLocation), nameof(GameLocation.furniture));
+            yield return new FieldReplaceRewriter(typeof(Farm), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
+            yield return new FieldReplaceRewriter(typeof(MineShaft), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
+
             // heuristic rewrites
             yield return new HeuristicFieldRewriter(this.ValidateReferencesToAssemblies);
             yield return new HeuristicMethodRewriter(this.ValidateReferencesToAssemblies);

From 5e2f6f565d6ef5330ea2e8c6a5e796f937289255 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Dec 2020 22:35:02 -0500
Subject: [PATCH 015/856] update mod compatibility list

---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 88 ++++++++++++++---------
 1 file changed, 53 insertions(+), 35 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 179ef42a..2a81e12a 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -54,15 +54,15 @@
             "Default | UpdateKey": "Nexus:2270"
         },
 
-        //"Content Patcher": {
-        //  "ID": "Pathoschild.ContentPatcher",
-        //  "Default | UpdateKey": "Nexus:1915"
-        //},
+        "Content Patcher": {
+            "ID": "Pathoschild.ContentPatcher",
+            "Default | UpdateKey": "Nexus:1915"
+        },
 
-        //"Custom Farming Redux": {
-        //  "ID": "Platonymous.CustomFarming",
-        //  "Default | UpdateKey": "Nexus:991"
-        //},
+        "Custom Farming Redux": {
+            "ID": "Platonymous.CustomFarming",
+            "Default | UpdateKey": "Nexus:991"
+        },
 
         "Custom Shirts": {
             "ID": "Platonymous.CustomShirts",
@@ -150,6 +150,51 @@
             "~ | StatusReasonPhrase": "debug mode was removed in SMAPI 1.0."
         },
 
+        "Split Screen": {
+            "ID": "Ilyaki.SplitScreen",
+            "~ | Status": "Obsolete",
+            "~ | StatusReasonPhrase": "split-screen mode was added in Stardew Valley 1.5"
+        },
+
+        /*********
+        ** Broke in SDV 1.5
+        *********/
+        "Audio Devices": {
+            "ID": "maxvollmer.audiodevices",
+            "~2.0.0 | Status": "AssumeBroken" // causes crash to desktop when starting the game
+        },
+
+        "Custom Localization": {
+            "ID": "ZaneYork.CustomLocalization",
+            "FormerIDs": "SMAPI.CustomLocalization", // changed in 1.0.1
+            "~1.1 | Status": "AssumeBroken" // reflection error for _localizedAssets field
+        },
+
+        "Mod Settings Tab": {
+            "ID": "GilarF.ModSettingsTab",
+            "~0.2.1 | Status": "AssumeBroken" // fails extending title menu
+        },
+
+        "More Grass": {
+            "ID": "EpicBellyFlop45.MoreGrass",
+            "~1.0.8 | Status": "AssumeBroken" // crashes save load 
+        },
+
+        "Movement Speed": {
+            "ID": "bcmpinc.MovementSpeed",
+            "~3.0.0 | Status": "AssumeBroken" // transpiler errors
+        },
+
+        "Tree Spread": {
+            "ID": "bcmpinc.TreeSpread",
+            "~3.0.0 | Status": "AssumeBroken" // transpiler errors 
+        },
+
+        "TreeTransplant": {
+            "ID": "TreeTransplant",
+            "~1.0.9 | Status": "AssumeBroken" // causes AccessViolationException which prevents game launch
+        },
+
         /*********
         ** Broke in SDV 1.4
         *********/
@@ -221,12 +266,6 @@
             "~2.3.1-unofficial.7-pathoschild | Status": "AssumeBroken"
         },
 
-        "Content Patcher": {
-            "ID": "Pathoschild.ContentPatcher",
-            "Default | UpdateKey": "Nexus:1915",
-            "~1.6.4 | Status": "AssumeBroken"
-        },
-
         "Current Location (Vrakyas)": {
             "ID": "Vrakyas.CurrentLocation",
             "~1.5.4 | Status": "AssumeBroken"
@@ -237,12 +276,6 @@
             "~1.8 | Status": "AssumeBroken"
         },
 
-        "Custom Farming Redux": {
-            "ID": "Platonymous.CustomFarming",
-            "Default | UpdateKey": "Nexus:991",
-            "~2.10.10 | Status": "AssumeBroken" // possibly due to PyTK
-        },
-
         "Decrafting Mod": {
             "ID": "MSCFC.DecraftingMod",
             "~1.0 | Status": "AssumeBroken" // NRE in ModEntry
@@ -408,11 +441,6 @@
             "~1.0.1 | Status": "AssumeBroken" // broke in SDV 1.3
         },
 
-        "Movement Speed": {
-            "ID": "bcmpinc.MovementSpeed",
-            "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
-        },
-
         "No Added Flying Mine Monsters": {
             "ID": "Drynwynn.NoAddedFlyingMineMonsters",
             "~1.1 | Status": "AssumeBroken" // runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+
@@ -429,11 +457,6 @@
             "1.3-beta | Status": "AssumeBroken" // doesn't work in multiplayer, no longer maintained
         },
 
-        "Split Screen": {
-            "ID": "Ilyaki.SplitScreen",
-            "~3.0.1 | Status": "AssumeBroken" // broke in SMAPI 2.6-beta.16 due to reflection into SMAPI internals
-        },
-
         "Stardew Hack": {
             "ID": "bcmpinc.StardewHack",
             "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
@@ -455,11 +478,6 @@
             "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
         },
 
-        "Tree Spread": {
-            "ID": "bcmpinc.TreeSpread",
-            "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
-        },
-
         /*********
         ** Broke circa SDV 1.2
         *********/

From 872a1d5627f20faece618644db1ae4749e124741 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 21 Dec 2020 12:24:43 -0500
Subject: [PATCH 016/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 11 ++++++++---
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 5 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index d8b29488..ee4f918f 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.7.6</Version>
+    <Version>3.8.0</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index b02b58d1..d550857c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,11 +7,13 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.8
+Released 21 December 2020 for Stardew Valley 1.5 or later.
+
 * For players:
   * Updated for Stardew Valley 1.5, including split-screen support.
-  * When the installer is run from within a game folder, it now installs SMAPI to that folder. That simplifies installation if you have multiple copies of the game or it can't otherwise auto-detect the game path.
-  * Clarified not-a-mod error when the SMAPI installer is in the `Mods` folder.
+  * You can now run the installer from a subfolder of your game folder to auto-detect it. That simplifies installation if you have multiple copies of the game or it can't otherwise auto-detect the game path.
+  * Clarified error when the SMAPI installer is in the `Mods` folder.
 
 * For modders:
   * Added `PerScreen<T>` utility and new `Context` fields to simplify split-screen support in mods.
@@ -20,6 +22,9 @@
 * For the Console Commands mod:
   * Added `furniture` option to `world_clear`.
 
+* For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.19.
+
 ## 3.7.6
 Released 21 November 2020 for Stardew Valley 1.4.1 or later.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index ddc55a73..a1a137a1 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.7.6",
+    "Version": "3.8.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.7.6"
+    "MinimumApiVersion": "3.8.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 0fe98909..96822f4a 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.7.6",
+    "Version": "3.8.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.7.6"
+    "MinimumApiVersion": "3.8.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 5aa08887..98d0277b 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.7.6");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.0");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.0");

From bbf2c3b020192d91f8d24cd687c5c6272ac26e82 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 21 Dec 2020 15:14:18 -0500
Subject: [PATCH 017/856] link to 3.8 release highlights

---
 docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d550857c..428888d8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,7 +8,7 @@
 -->
 
 ## 3.8
-Released 21 December 2020 for Stardew Valley 1.5 or later.
+Released 21 December 2020 for Stardew Valley 1.5 or later. See [release highlights](https://www.patreon.com/posts/45294737).
 
 * For players:
   * Updated for Stardew Valley 1.5, including split-screen support.

From 63111621c9375ac2e9a68eefa73ffe1d817000dd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 23 Dec 2020 19:11:41 -0500
Subject: [PATCH 018/856] fix world events not raised for volcano levels

---
 docs/release-notes.md                             |  4 ++++
 .../StateTracking/WorldLocationsTracker.cs        | 15 ++++++++++++++-
 src/SMAPI/Framework/WatcherCore.cs                |  2 +-
 3 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 428888d8..e54d6c71 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For modders:
+  * Fixed world events not raised for volcano levels.
+
 ## 3.8
 Released 21 December 2020 for Stardew Valley 1.5 or later. See [release highlights](https://www.patreon.com/posts/45294737).
 
diff --git a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
index 303a4f3a..e968d79c 100644
--- a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
@@ -21,6 +21,9 @@ namespace StardewModdingAPI.Framework.StateTracking
         /// <summary>Tracks changes to the list of active mine locations.</summary>
         private readonly ICollectionWatcher<MineShaft> MineLocationListWatcher;
 
+        /// <summary>Tracks changes to the list of active volcano locations.</summary>
+        private readonly ICollectionWatcher<GameLocation> VolcanoLocationListWatcher;
+
         /// <summary>A lookup of the tracked locations.</summary>
         private IDictionary<GameLocation, LocationTracker> LocationDict { get; } = new Dictionary<GameLocation, LocationTracker>(new ObjectReferenceComparer<GameLocation>());
 
@@ -53,10 +56,12 @@ namespace StardewModdingAPI.Framework.StateTracking
         /// <summary>Construct an instance.</summary>
         /// <param name="locations">The game's list of locations.</param>
         /// <param name="activeMineLocations">The game's list of active mine locations.</param>
-        public WorldLocationsTracker(ObservableCollection<GameLocation> locations, IList<MineShaft> activeMineLocations)
+        /// <param name="activeVolcanoLocations">The game's list of active volcano locations.</param>
+        public WorldLocationsTracker(ObservableCollection<GameLocation> locations, IList<MineShaft> activeMineLocations, IList<VolcanoDungeon> activeVolcanoLocations)
         {
             this.LocationListWatcher = WatcherFactory.ForObservableCollection(locations);
             this.MineLocationListWatcher = WatcherFactory.ForReferenceList(activeMineLocations);
+            this.VolcanoLocationListWatcher = WatcherFactory.ForReferenceList(activeVolcanoLocations);
         }
 
         /// <summary>Update the current value if needed.</summary>
@@ -65,6 +70,7 @@ namespace StardewModdingAPI.Framework.StateTracking
             // update watchers
             this.LocationListWatcher.Update();
             this.MineLocationListWatcher.Update();
+            this.VolcanoLocationListWatcher.Update();
             foreach (LocationTracker watcher in this.Locations)
                 watcher.Update();
 
@@ -79,6 +85,11 @@ namespace StardewModdingAPI.Framework.StateTracking
                 this.Remove(this.MineLocationListWatcher.Removed);
                 this.Add(this.MineLocationListWatcher.Added);
             }
+            if (this.VolcanoLocationListWatcher.IsChanged)
+            {
+                this.Remove(this.VolcanoLocationListWatcher.Removed);
+                this.Add(this.VolcanoLocationListWatcher.Added);
+            }
 
             // detect building changed
             foreach (LocationTracker watcher in this.Locations.Where(p => p.BuildingsWatcher.IsChanged).ToArray())
@@ -107,6 +118,7 @@ namespace StardewModdingAPI.Framework.StateTracking
             this.Added.Clear();
             this.LocationListWatcher.Reset();
             this.MineLocationListWatcher.Reset();
+            this.VolcanoLocationListWatcher.Reset();
         }
 
         /// <summary>Set the current value as the baseline.</summary>
@@ -243,6 +255,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         {
             yield return this.LocationListWatcher;
             yield return this.MineLocationListWatcher;
+            yield return this.VolcanoLocationListWatcher;
             foreach (LocationTracker watcher in this.Locations)
                 yield return watcher;
         }
diff --git a/src/SMAPI/Framework/WatcherCore.cs b/src/SMAPI/Framework/WatcherCore.cs
index 393f6a37..62a0c3b8 100644
--- a/src/SMAPI/Framework/WatcherCore.cs
+++ b/src/SMAPI/Framework/WatcherCore.cs
@@ -66,7 +66,7 @@ namespace StardewModdingAPI.Framework
             this.WindowSizeWatcher = WatcherFactory.ForEquatable(() => new Point(Game1.viewport.Width, Game1.viewport.Height));
             this.TimeWatcher = WatcherFactory.ForEquatable(() => Game1.timeOfDay);
             this.ActiveMenuWatcher = WatcherFactory.ForReference(() => Game1.activeClickableMenu);
-            this.LocationsWatcher = new WorldLocationsTracker(gameLocations, MineShaft.activeMines);
+            this.LocationsWatcher = new WorldLocationsTracker(gameLocations, MineShaft.activeMines, VolcanoDungeon.activeLevels);
             this.LocaleWatcher = WatcherFactory.ForGenericEquality(() => LocalizedContentManager.CurrentLanguageCode);
             this.Watchers.AddRange(new IWatcher[]
             {

From 9215f89825734f447b8637851569de9ffa08b661 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 23 Dec 2020 21:38:19 -0500
Subject: [PATCH 019/856] fix edge cases in SMAPI log parsing (#743)

---
 docs/release-notes.md                           |  3 +++
 src/SMAPI.Web/Framework/LogParsing/LogParser.cs | 11 ++++-------
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e54d6c71..e464154f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,9 @@
 * For modders:
   * Fixed world events not raised for volcano levels.
 
+For the web UI:
+  * Fixed edge cases in SMAPI log parsing.
+
 ## 3.8
 Released 21 December 2020 for Stardew Valley 1.5 or later. See [release highlights](https://www.patreon.com/posts/45294737).
 
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index f69d4b6f..84013ccc 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -42,7 +42,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         private readonly Regex ModUpdateListStartPattern = new Regex(@"^You can update \d+ mods?:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching an entry in SMAPI's mod update list.</summary>
-        private readonly Regex ModUpdateListEntryPattern = new Regex(@"^   (?<name>.+?) (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ModUpdateListEntryPattern = new Regex(@"^   (?<name>.+) (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching SMAPI's update line.</summary>
         private readonly Regex SmapiUpdatePattern = new Regex(@"^You can update SMAPI to (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
@@ -109,12 +109,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                     if (message.Mod == "SMAPI")
                     {
                         // update flags
-                        if (inModList && !this.ModListEntryPattern.IsMatch(message.Text))
-                            inModList = false;
-                        if (inContentPackList && !this.ContentPackListEntryPattern.IsMatch(message.Text))
-                            inContentPackList = false;
-                        if (inModUpdateList && !this.ModUpdateListEntryPattern.IsMatch(message.Text))
-                            inModUpdateList = false;
+                        inModList = inModList && message.Level == LogLevel.Info && this.ModListEntryPattern.IsMatch(message.Text);
+                        inContentPackList = inContentPackList && message.Level == LogLevel.Info && this.ContentPackListEntryPattern.IsMatch(message.Text);
+                        inModUpdateList = inModUpdateList && message.Level == LogLevel.Alert && this.ModUpdateListEntryPattern.IsMatch(message.Text);
 
                         // mod list
                         if (!inModList && message.Level == LogLevel.Info && this.ModListStartPattern.IsMatch(message.Text))

From 2406380495cc5176d3cbd2309e6f17080389f9af Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Dec 2020 01:28:00 -0500
Subject: [PATCH 020/856] fix SMAPI using a cached translation when the game
 asks for an untranslated asset

This mainly affects community center bundles in Stardew Valley 1.5,
---
 docs/release-notes.md                                    | 5 ++++-
 src/SMAPI/Framework/ContentCoordinator.cs                | 2 +-
 .../Framework/ContentManagers/BaseContentManager.cs      | 8 +++++---
 .../Framework/ContentManagers/GameContentManager.cs      | 9 +++++----
 src/SMAPI/Framework/ContentManagers/IContentManager.cs   | 3 ++-
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 3 ++-
 6 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e464154f..2df7467a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,8 +8,11 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Fixed community center bundle corruption for non-English players.
+
 * For modders:
-  * Fixed world events not raised for volcano levels.
+  * World events are now raised for the volcano levels.
 
 For the web UI:
   * Fixed edge cases in SMAPI log parsing.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 93371415..f9027972 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -278,7 +278,7 @@ namespace StardewModdingAPI.Framework
             return this.ContentManagerLock.InReadLock(() =>
             {
                 List<object> values = new List<object>();
-                foreach (IContentManager content in this.ContentManagers.Where(p => !p.IsNamespaced && p.IsLoaded(assetName)))
+                foreach (IContentManager content in this.ContentManagers.Where(p => !p.IsNamespaced && p.IsLoaded(assetName, p.Language)))
                 {
                     object value = content.Load<object>(assetName, this.Language, useCache: true);
                     values.Add(value);
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 6bc3a505..92264f8c 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -169,10 +169,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Get whether the content manager has already loaded and cached the given asset.</summary>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        public bool IsLoaded(string assetName)
+        /// <param name="language">The language.</param>
+        public bool IsLoaded(string assetName, LanguageCode language)
         {
             assetName = this.Cache.NormalizeKey(assetName);
-            return this.IsNormalizedKeyLoaded(assetName);
+            return this.IsNormalizedKeyLoaded(assetName, language);
         }
 
         /// <summary>Get the cached asset keys.</summary>
@@ -315,7 +316,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Get whether an asset has already been loaded.</summary>
         /// <param name="normalizedAssetName">The normalized asset name.</param>
-        protected abstract bool IsNormalizedKeyLoaded(string normalizedAssetName);
+        /// <param name="language">The language to check.</param>
+        protected abstract bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language);
 
         /// <summary>Get the locale codes (like <c>ja-JP</c>) used in asset keys.</summary>
         private IDictionary<LanguageCode, string> GetKeyLocales()
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 83a63986..ad8f2ef1 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -78,7 +78,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return this.Load<T>(newAssetName, newLanguage, useCache);
 
             // get from cache
-            if (useCache && this.IsLoaded(assetName))
+            if (useCache && this.IsLoaded(assetName, language))
                 return this.RawLoad<T>(assetName, language, useCache: true);
 
             // get managed asset
@@ -151,11 +151,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
         *********/
         /// <summary>Get whether an asset has already been loaded.</summary>
         /// <param name="normalizedAssetName">The normalized asset name.</param>
-        protected override bool IsNormalizedKeyLoaded(string normalizedAssetName)
+        /// <param name="language">The language to check.</param>
+        protected override bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language)
         {
             string cachedKey = null;
             bool localized =
-                this.Language != LocalizedContentManager.LanguageCode.en
+                language != LocalizedContentManager.LanguageCode.en
                 && !this.Coordinator.IsManagedAssetKey(normalizedAssetName)
                 && this.LocalizedAssetNames.TryGetValue(normalizedAssetName, out cachedKey);
 
@@ -214,7 +215,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T RawLoad<T>(string assetName, LanguageCode language, bool useCache)
         {
             // use cached key
-            if (this.LocalizedAssetNames.TryGetValue(assetName, out string cachedKey))
+            if (language == this.Language && this.LocalizedAssetNames.TryGetValue(assetName, out string cachedKey))
                 return base.RawLoad<T>(cachedKey, useCache);
 
             // try translated key
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index 8da9a777..0e7edd8f 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -58,7 +58,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Get whether the content manager has already loaded and cached the given asset.</summary>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        bool IsLoaded(string assetName);
+        /// <param name="language">The language.</param>
+        bool IsLoaded(string assetName, LocalizedContentManager.LanguageCode language);
 
         /// <summary>Get the cached asset keys.</summary>
         IEnumerable<string> GetAssetKeys();
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 127705ea..753ec188 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -211,7 +211,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         *********/
         /// <summary>Get whether an asset has already been loaded.</summary>
         /// <param name="normalizedAssetName">The normalized asset name.</param>
-        protected override bool IsNormalizedKeyLoaded(string normalizedAssetName)
+        /// <param name="language">The language to check.</param>
+        protected override bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language)
         {
             return this.Cache.ContainsKey(normalizedAssetName);
         }

From 5a8a684e22b2eec0b318c68adbc6780479d8efd4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Dec 2020 01:30:27 -0500
Subject: [PATCH 021/856] add apply_save_fix command

---
 docs/release-notes.md                         |  1 +
 .../Commands/Other/ApplySaveFixCommand.cs     | 77 +++++++++++++++++++
 2 files changed, 78 insertions(+)
 create mode 100644 src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2df7467a..be51695e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
 
 * For modders:
   * World events are now raised for the volcano levels.
+  * Added `apply_save_fix` command to reapply a save migration in exceptional cases. This should be used with extreme care. Type `help apply_save_fix` for details.
 
 For the web UI:
   * Fixed edge cases in SMAPI log parsing.
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
new file mode 100644
index 00000000..8f59342e
--- /dev/null
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
@@ -0,0 +1,77 @@
+using System;
+using System.Collections.Generic;
+using StardewValley;
+
+namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
+{
+    /// <summary>A command which runs one of the game's save migrations.</summary>
+    internal class ApplySaveFixCommand : TrainerCommand
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public ApplySaveFixCommand()
+            : base("apply_save_fix", "Apply one of the game's save migrations to the currently loaded save. WARNING: This may corrupt or make permanent changes to your save. DO NOT USE THIS unless you're absolutely sure.\n\nUsage: apply_save_fix list\nList all valid save IDs.\n\nUsage: apply_save_fix <fix ID>\nApply the named save fix.") { }
+
+        /// <summary>Handle the command.</summary>
+        /// <param name="monitor">Writes messages to the console and log file.</param>
+        /// <param name="command">The command name.</param>
+        /// <param name="args">The command arguments.</param>
+        public override void Handle(IMonitor monitor, string command, ArgumentParser args)
+        {
+            // get fix ID
+            if (!args.TryGet(0, "fix_id", out string rawFixId, required: false))
+            {
+                monitor.Log("Invalid usage. Type 'help apply_save_fix' for details.", LogLevel.Error);
+                return;
+            }
+            rawFixId = rawFixId.Trim();
+
+
+            // list mode
+            if (rawFixId == "list")
+            {
+                monitor.Log("Valid save fix IDs:\n  - " + string.Join("\n  - ", this.GetSaveIds()), LogLevel.Info);
+                return;
+            }
+
+            // validate fix ID
+            if (!Enum.TryParse(rawFixId, ignoreCase: true, out SaveGame.SaveFixes fixId))
+            {
+                monitor.Log($"Invalid save ID '{rawFixId}'. Type 'help apply_save_fix' for details.", LogLevel.Error);
+                return;
+            }
+
+            // apply
+            monitor.Log("THIS MAY CAUSE PERMANENT CHANGES TO YOUR SAVE FILE. If you're not sure, exit your game without saving to avoid issues.", LogLevel.Warn);
+            monitor.Log($"Trying to apply save fix ID: '{fixId}'.", LogLevel.Warn);
+            try
+            {
+                Game1.applySaveFix(fixId);
+                monitor.Log("Save fix applied.", LogLevel.Info);
+            }
+            catch (Exception ex)
+            {
+                monitor.Log("Applying save fix failed. The save may be in an invalid state; you should exit your game now without saving to avoid issues.", LogLevel.Error);
+                monitor.Log($"Technical details: {ex}", LogLevel.Debug);
+            }
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get the valid save fix IDs.</summary>
+        private IEnumerable<string> GetSaveIds()
+        {
+            foreach (SaveGame.SaveFixes id in Enum.GetValues(typeof(SaveGame.SaveFixes)))
+            {
+                if (id == SaveGame.SaveFixes.MAX)
+                    continue;
+
+                yield return id.ToString();
+            }
+        }
+    }
+}

From 49c192fc4772417428d490dabf93b790f82c94c9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Dec 2020 02:08:53 -0500
Subject: [PATCH 022/856] detect & fix broken community center bundles

---
 docs/release-notes.md        |  2 +-
 src/SMAPI/Framework/SCore.cs | 41 ++++++++++++++++++++++++++++++++++++
 2 files changed, 42 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index be51695e..fe614303 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,7 @@
 
 ## Upcoming release
 * For players:
-  * Fixed community center bundle corruption for non-English players.
+  * Fixed community center bundles broken for non-English saves created in SMAPI 3.8.0. Affected saves will be fixed automatically next time you load them.
 
 * For modders:
   * World events are now raised for the volcano levels.
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index a7f8fbed..6b8098cd 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -765,6 +765,9 @@ namespace StardewModdingAPI.Framework
 
                         this.Monitor.Log(context);
 
+                        // apply save fixes
+                        this.ApplySaveFixes();
+
                         // raise events
                         this.OnLoadStageChanged(LoadStage.Ready);
                         events.SaveLoaded.RaiseEmpty();
@@ -1054,6 +1057,44 @@ namespace StardewModdingAPI.Framework
                 this.EventManager.ReturnedToTitle.RaiseEmpty();
         }
 
+        /// <summary>Apply fixes to the save after it's loaded.</summary>
+        private void ApplySaveFixes()
+        {
+            // get last SMAPI version used with this save
+            const string migrationKey = "Pathoschild.SMAPI/last-version";
+            if (!Game1.CustomData.TryGetValue(migrationKey, out string rawVersion) || !SemanticVersion.TryParse(rawVersion, out ISemanticVersion lastVersionRun))
+                lastVersionRun = new SemanticVersion(3, 8, 0);
+
+            // fix bundle corruption in SMAPI 3.8.0
+            // For non-English players who created a new save in SMAPI 3.8.0, bundle data was
+            // incorrectly translated which caused the code to crash whenever the game tried to
+            // read it.
+            if (lastVersionRun.IsOlderThan(new SemanticVersion(3, 8, 1)))
+            {
+                bool? hasInvalidBundleData = Game1.netWorldState?.Value
+                    ?.BundleData
+                    ?.Values
+                    ?.Any(raw => raw != null && raw.Split('/').Length > 5);
+
+                if (hasInvalidBundleData == true)
+                {
+                    try
+                    {
+                        Game1.applySaveFix(SaveGame.SaveFixes.FixBotchedBundleData);
+                        this.Monitor.Log("Found corrupted community center data due to a previous version of SMAPI, and fixed it automatically.", LogLevel.Info);
+                    }
+                    catch (Exception ex)
+                    {
+                        this.Monitor.Log("Found corrupted community center data due to a previous version of SMAPI, but was unable to fix it automatically.", LogLevel.Error);
+                        this.Monitor.Log($"Technical details: {ex}");
+                    }
+                }
+            }
+
+            // update last run
+            Game1.CustomData[migrationKey] = Constants.ApiVersion.ToString();
+        }
+
         /// <summary>Raised after custom content is removed from the save data to avoid a crash.</summary>
         internal void OnSaveContentRemoved()
         {

From 8895021696fd2129af6de775e275f3bd83edf034 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Dec 2020 10:41:39 -0500
Subject: [PATCH 023/856] rewrite migration to avoid repeating game checks

---
 src/SMAPI/Framework/SCore.cs | 34 +++++++++++++++-------------------
 1 file changed, 15 insertions(+), 19 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 6b8098cd..e05213f0 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1061,33 +1061,29 @@ namespace StardewModdingAPI.Framework
         private void ApplySaveFixes()
         {
             // get last SMAPI version used with this save
-            const string migrationKey = "Pathoschild.SMAPI/last-version";
-            if (!Game1.CustomData.TryGetValue(migrationKey, out string rawVersion) || !SemanticVersion.TryParse(rawVersion, out ISemanticVersion lastVersionRun))
-                lastVersionRun = new SemanticVersion(3, 8, 0);
+            const string migrationKey = "Pathoschild.SMAPI/api-version";
+            if (!Game1.CustomData.TryGetValue(migrationKey, out string rawVersion) || !SemanticVersion.TryParse(rawVersion, out ISemanticVersion lastVersion))
+                lastVersion = new SemanticVersion(3, 8, 0);
 
             // fix bundle corruption in SMAPI 3.8.0
             // For non-English players who created a new save in SMAPI 3.8.0, bundle data was
             // incorrectly translated which caused the code to crash whenever the game tried to
             // read it.
-            if (lastVersionRun.IsOlderThan(new SemanticVersion(3, 8, 1)))
+            if (lastVersion.IsOlderThan(new SemanticVersion(3, 8, 1)) && Game1.netWorldState?.Value?.BundleData != null)
             {
-                bool? hasInvalidBundleData = Game1.netWorldState?.Value
-                    ?.BundleData
-                    ?.Values
-                    ?.Any(raw => raw != null && raw.Split('/').Length > 5);
+                var oldData = new Dictionary<string, string>(Game1.netWorldState.Value.BundleData);
 
-                if (hasInvalidBundleData == true)
+                try
                 {
-                    try
-                    {
-                        Game1.applySaveFix(SaveGame.SaveFixes.FixBotchedBundleData);
-                        this.Monitor.Log("Found corrupted community center data due to a previous version of SMAPI, and fixed it automatically.", LogLevel.Info);
-                    }
-                    catch (Exception ex)
-                    {
-                        this.Monitor.Log("Found corrupted community center data due to a previous version of SMAPI, but was unable to fix it automatically.", LogLevel.Error);
-                        this.Monitor.Log($"Technical details: {ex}");
-                    }
+                    Game1.applySaveFix(SaveGame.SaveFixes.FixBotchedBundleData);
+                    bool changed = Game1.netWorldState.Value.BundleData.Any(p => oldData.TryGetValue(p.Key, out string oldValue) && oldValue != p.Value);
+                    if (changed)
+                        this.Monitor.Log("Found broken community center bundles and fixed them automatically.", LogLevel.Info);
+                }
+                catch (Exception ex)
+                {
+                    this.Monitor.Log("Failed to verify community center data.", LogLevel.Error); // should never happen
+                    this.Monitor.Log($"Technical details: {ex}");
                 }
             }
 

From 5cc069476e1cb63c8fef2dd245a540b6b5130e68 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Dec 2020 11:20:47 -0500
Subject: [PATCH 024/856] deprecate ConsoleCommands.Trigger method

---
 docs/release-notes.md                         |  1 +
 src/SMAPI/Framework/DeprecationManager.cs     | 31 +++++++------------
 .../Framework/ModHelpers/CommandHelper.cs     |  8 +++++
 3 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index fe614303..0cc45116 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -14,6 +14,7 @@
 * For modders:
   * World events are now raised for the volcano levels.
   * Added `apply_save_fix` command to reapply a save migration in exceptional cases. This should be used with extreme care. Type `help apply_save_fix` for details.
+  * **Deprecation notice:** the `Helper.ConsoleCommands.Trigger` method is now deprecated and should no longer be used. See [integration APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations) for better mod integration options. It will eventually be removed in SMAPI 4.0.
 
 For the web UI:
   * Fixed edge cases in SMAPI log parsing.
diff --git a/src/SMAPI/Framework/DeprecationManager.cs b/src/SMAPI/Framework/DeprecationManager.cs
index 94a2da85..c22b5718 100644
--- a/src/SMAPI/Framework/DeprecationManager.cs
+++ b/src/SMAPI/Framework/DeprecationManager.cs
@@ -35,19 +35,17 @@ namespace StardewModdingAPI.Framework
             this.ModRegistry = modRegistry;
         }
 
-        /// <summary>Log a deprecation warning for the old-style events.</summary>
-        public void WarnForOldEvents()
+        /// <summary>Get the source name for a mod from its unique ID.</summary>
+        public string GetSourceNameFromStack()
         {
-            this.Warn("legacy events", "2.9", DeprecationLevel.PendingRemoval);
+            return this.ModRegistry.GetFromStack()?.DisplayName;
         }
 
-        /// <summary>Log a deprecation warning.</summary>
-        /// <param name="nounPhrase">A noun phrase describing what is deprecated.</param>
-        /// <param name="version">The SMAPI version which deprecated it.</param>
-        /// <param name="severity">How deprecated the code is.</param>
-        public void Warn(string nounPhrase, string version, DeprecationLevel severity)
+        /// <summary>Get the source name for a mod from its unique ID.</summary>
+        /// <param name="modId">The mod's unique ID.</param>
+        public string GetSourceName(string modId)
         {
-            this.Warn(this.ModRegistry.GetFromStack()?.DisplayName, nounPhrase, version, severity);
+            return this.ModRegistry.Get(modId)?.DisplayName;
         }
 
         /// <summary>Log a deprecation warning.</summary>
@@ -58,7 +56,7 @@ namespace StardewModdingAPI.Framework
         public void Warn(string source, string nounPhrase, string version, DeprecationLevel severity)
         {
             // ignore if already warned
-            if (!this.MarkWarned(source ?? "<unknown>", nounPhrase, version))
+            if (!this.MarkWarned(source ?? this.GetSourceNameFromStack() ?? "<unknown>", nounPhrase, version))
                 return;
 
             // queue warning
@@ -111,21 +109,16 @@ namespace StardewModdingAPI.Framework
             this.QueuedWarnings.Clear();
         }
 
-        /// <summary>Mark a deprecation warning as already logged.</summary>
-        /// <param name="nounPhrase">A noun phrase describing what is deprecated (e.g. "the Extensions.AsInt32 method").</param>
-        /// <param name="version">The SMAPI version which deprecated it.</param>
-        /// <returns>Returns whether the deprecation was successfully marked as warned. Returns <c>false</c> if it was already marked.</returns>
-        public bool MarkWarned(string nounPhrase, string version)
-        {
-            return this.MarkWarned(this.ModRegistry.GetFromStack()?.DisplayName, nounPhrase, version);
-        }
 
+        /*********
+        ** Private methods
+        *********/
         /// <summary>Mark a deprecation warning as already logged.</summary>
         /// <param name="source">The friendly name of the assembly which used the deprecated code.</param>
         /// <param name="nounPhrase">A noun phrase describing what is deprecated (e.g. "the Extensions.AsInt32 method").</param>
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <returns>Returns whether the deprecation was successfully marked as warned. Returns <c>false</c> if it was already marked.</returns>
-        public bool MarkWarned(string source, string nounPhrase, string version)
+        private bool MarkWarned(string source, string nounPhrase, string version)
         {
             if (string.IsNullOrWhiteSpace(source))
                 throw new InvalidOperationException("The deprecation source cannot be empty.");
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index 600f867f..69382009 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -36,8 +36,16 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
+        [Obsolete]
         public bool Trigger(string name, string[] arguments)
         {
+            SCore.DeprecationManager.Warn(
+                source: SCore.DeprecationManager.GetSourceName(this.ModID),
+                nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.ConsoleCommands)}.{nameof(ICommandHelper.Trigger)}",
+                version: "3.8.1",
+                severity: DeprecationLevel.Notice
+            );
+
             return this.CommandManager.Trigger(name, arguments);
         }
     }

From 5ac46b7ab22ad5d6ce558a6b6d6d020971c178bd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Dec 2020 11:22:09 -0500
Subject: [PATCH 025/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 10 ++++++----
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  4 ++--
 5 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index ee4f918f..6c79d290 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.8.0</Version>
+    <Version>3.8.1</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0cc45116..90557c54 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,13 +7,15 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.8.1
+Released 26 December 2020 for Stardew Valley 1.5.1 or later.
+
 * For players:
-  * Fixed community center bundles broken for non-English saves created in SMAPI 3.8.0. Affected saves will be fixed automatically next time you load them.
+  * Fixed broken community center bundles for non-English saves created in Stardew Valley 1.5. Affected saves will be fixed automatically on load.
 
 * For modders:
-  * World events are now raised for the volcano levels.
-  * Added `apply_save_fix` command to reapply a save migration in exceptional cases. This should be used with extreme care. Type `help apply_save_fix` for details.
+  * World events are now raised for volcano dungeon levels.
+  * Added `apply_save_fix` command to reapply a save migration in exceptional cases. This should be used very carefully. Type `help apply_save_fix` for details.
   * **Deprecation notice:** the `Helper.ConsoleCommands.Trigger` method is now deprecated and should no longer be used. See [integration APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations) for better mod integration options. It will eventually be removed in SMAPI 4.0.
 
 For the web UI:
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index a1a137a1..61c610d0 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.8.0",
+    "Version": "3.8.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.8.0"
+    "MinimumApiVersion": "3.8.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 96822f4a..7cf63e66 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.8.0",
+    "Version": "3.8.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.8.0"
+    "MinimumApiVersion": "3.8.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 98d0277b..9d5501a3 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,10 +54,10 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.0");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.1");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.0");
+        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.1");
 
         /// <summary>The maximum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MaximumGameVersion { get; } = null;

From 06c7e4e2b92849858002835ed41c7e9cce60fde4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 29 Dec 2020 23:58:54 -0500
Subject: [PATCH 026/856] show details in TRACE logs when a mod is blocked by
 compatibility list

---
 docs/release-notes.md                         |  4 +++
 .../Framework/ModData/ModDataField.cs         |  1 +
 .../Framework/ModData/ModDataFieldKey.cs      |  5 ++-
 .../Framework/ModData/ModDataRecord.cs        |  5 +++
 .../ModData/ModDataRecordVersionedFields.cs   |  3 ++
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json     |  3 ++
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 36 +++++++++++++++++--
 src/SMAPI/Framework/SCore.cs                  |  2 +-
 8 files changed, 55 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 90557c54..ac4a89c6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For modders:
+  * When a mod is blocked by SMAPI's internal compatibility list, the `TRACE` messages while loading it now indicates that and specifies the reason.
+
 ## 3.8.1
 Released 26 December 2020 for Stardew Valley 1.5.1 or later.
 
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
index b3954693..44422f01 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
@@ -71,6 +71,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
                 // non-manifest fields
                 case ModDataFieldKey.AlternativeUrl:
                 case ModDataFieldKey.StatusReasonPhrase:
+                case ModDataFieldKey.StatusReasonDetails:
                 case ModDataFieldKey.Status:
                     return false;
 
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs
index 09dd0cc5..068291aa 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs
@@ -13,6 +13,9 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         Status,
 
         /// <summary>A reason phrase for the <see cref="Status"/>, or <c>null</c> to use the default reason.</summary>
-        StatusReasonPhrase
+        StatusReasonPhrase,
+
+        /// <summary>Technical details shown in TRACE logs for the <see cref="Status"/>, or <c>null</c> to omit it.</summary>
+        StatusReasonDetails
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
index 3201c421..f28f6afe 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
@@ -107,6 +107,11 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
                     case ModDataFieldKey.StatusReasonPhrase:
                         parsed.StatusReasonPhrase = field.Value;
                         break;
+
+                    // status technical reason
+                    case ModDataFieldKey.StatusReasonDetails:
+                        parsed.StatusReasonDetails = field.Value;
+                        break;
                 }
             }
 
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
index 598da66a..f0282eb4 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
@@ -24,6 +24,9 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <summary>A reason phrase for the <see cref="Status"/>, or <c>null</c> to use the default reason.</summary>
         public string StatusReasonPhrase { get; set; }
 
+        /// <summary>Technical details shown in TRACE logs for the <see cref="Status"/>, or <c>null</c> to omit it.</summary>
+        public string StatusReasonDetails { get; set; }
+
         /// <summary>The upper version for which the <see cref="Status"/> applies (if any).</summary>
         public ISemanticVersion StatusUpperVersion { get; set; }
     }
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 2a81e12a..b570a322 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -42,6 +42,9 @@
      *   - StatusReasonPhrase: a message to show to the player explaining why the mod can't be loaded
      *     (if applicable). If blank, will default to a generic not-compatible message.
      *
+     *   - StatusReasonDetails: a technical reason shown in TRACE logs, indicating why the status
+     *     was overridden. If not provided, it defaults to the StatusReasonPhrase or 'no reason given'.
+     *
      *   - AlternativeUrl: a URL where the player can find an unofficial update or alternative if the
      *     mod is no longer compatible.
      */
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 08df7b76..af7d90f6 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -72,7 +72,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 switch (mod.DataRecord?.Status)
                 {
                     case ModStatus.Obsolete:
-                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.Obsolete, $"it's obsolete: {mod.DataRecord.StatusReasonPhrase}");
+                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.Obsolete, $"it's obsolete: {mod.DataRecord.StatusReasonPhrase}", this.GetTechnicalReasonForStatusOverride(mod));
                         continue;
 
                     case ModStatus.AssumeBroken:
@@ -102,7 +102,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                                 error += $"version newer than {mod.DataRecord.StatusUpperVersion}";
                             error += " at " + string.Join(" or ", updateUrls);
 
-                            mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.Incompatible, error);
+                            mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.Incompatible, error, this.GetTechnicalReasonForStatusOverride(mod));
                         }
                         continue;
                 }
@@ -409,6 +409,38 @@ namespace StardewModdingAPI.Framework.ModLoading
                 yield return new ModDependency(manifest.ContentPackFor.UniqueID, manifest.ContentPackFor.MinimumVersion, FindMod(manifest.ContentPackFor.UniqueID), isRequired: true);
         }
 
+        /// <summary>Get a technical message indicating why a mod's compatibility status was overridden, if applicable.</summary>
+        /// <param name="mod">The mod metadata.</param>
+        private string GetTechnicalReasonForStatusOverride(IModMetadata mod)
+        {
+            // get compatibility list record
+            var data = mod.DataRecord;
+            if (data == null)
+                return null;
+
+            // get status label
+            string statusLabel = data.Status switch
+            {
+                ModStatus.AssumeBroken => "'assume broken'",
+                ModStatus.AssumeCompatible => "'assume compatible'",
+                ModStatus.Obsolete => "obsolete",
+                _ => data.Status.ToString()
+            };
+
+            // get reason
+            string[] reasons = new[] { mod.DataRecord.StatusReasonPhrase, mod.DataRecord.StatusReasonDetails }
+                .Where(p => !string.IsNullOrWhiteSpace(p))
+                .ToArray();
+
+            // build message
+            return
+                $"marked {statusLabel} in SMAPI's internal compatibility list for "
+                + (mod.DataRecord.StatusUpperVersion != null ? $"versions up to {mod.DataRecord.StatusUpperVersion}" : "all versions")
+                + ": "
+                + (reasons.Any() ? string.Join(": ", reasons) : "no reason given")
+                + ".";
+        }
+
 
         /*********
         ** Private models
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index e05213f0..27540442 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1532,7 +1532,7 @@ namespace StardewModdingAPI.Framework
             // validate status
             if (mod.Status == ModMetadataStatus.Failed)
             {
-                this.Monitor.Log($"      Failed: {mod.Error}");
+                this.Monitor.Log($"      Failed: {mod.ErrorDetails ?? mod.Error}");
                 failReason = mod.FailReason;
                 errorReasonPhrase = mod.Error;
                 return false;

From 847826198ff0cc836f566c14725d98b44aa67fdd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 30 Dec 2020 00:25:32 -0500
Subject: [PATCH 027/856] add status reason details to past mods, clean out
 some old blacklist entries

---
 docs/release-notes.md                     |   3 +
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 183 ++++++++--------------
 2 files changed, 66 insertions(+), 120 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ac4a89c6..c68b3d62 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Updated compatibility list.
+
 * For modders:
   * When a mod is blocked by SMAPI's internal compatibility list, the `TRACE` messages while loading it now indicates that and specifies the reason.
 
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index b570a322..06762a3f 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -79,8 +79,7 @@
 
         "JSON Assets": {
             "ID": "spacechase0.JsonAssets",
-            "Default | UpdateKey": "Nexus:1720",
-            "1.3.1 | Status": "AssumeBroken" // causes runtime crashes
+            "Default | UpdateKey": "Nexus:1720"
         },
 
         "Mail Framework": {
@@ -90,8 +89,7 @@
 
         "MTN": {
             "ID": "SgtPickles.MTN",
-            "Default | UpdateKey": "Nexus:2256",
-            "~1.2.6 | Status": "AssumeBroken" // replaces Game1.multiplayer, which breaks SMAPI's multiplayer API.
+            "Default | UpdateKey": "Nexus:2256"
         },
 
         "PyTK": {
@@ -164,38 +162,45 @@
         *********/
         "Audio Devices": {
             "ID": "maxvollmer.audiodevices",
-            "~2.0.0 | Status": "AssumeBroken" // causes crash to desktop when starting the game
+            "~2.0.0 | Status": "AssumeBroken",
+            "~2.0.0 | StatusReasonDetails": "causes crash to desktop when starting the game"
         },
 
         "Custom Localization": {
             "ID": "ZaneYork.CustomLocalization",
             "FormerIDs": "SMAPI.CustomLocalization", // changed in 1.0.1
-            "~1.1 | Status": "AssumeBroken" // reflection error for _localizedAssets field
+            "~1.1 | Status": "AssumeBroken",
+            "~1.1 | StatusReasonDetails": "reflection error due to renamed _localizedAssets field"
         },
 
         "Mod Settings Tab": {
             "ID": "GilarF.ModSettingsTab",
-            "~0.2.1 | Status": "AssumeBroken" // fails extending title menu
+            "~0.2.1 | Status": "AssumeBroken",
+            "~0.2.1 | StatusReasonDetails": "fails extending title menu"
         },
 
         "More Grass": {
             "ID": "EpicBellyFlop45.MoreGrass",
-            "~1.0.8 | Status": "AssumeBroken" // crashes save load 
+            "~1.0.8 | Status": "AssumeBroken",
+            "~1.0.8 | StatusReasonDetails": "crashes on save load"
         },
 
         "Movement Speed": {
             "ID": "bcmpinc.MovementSpeed",
-            "~3.0.0 | Status": "AssumeBroken" // transpiler errors
+            "~3.0.0 | Status": "AssumeBroken",
+            "~3.0.0 | StatusReasonDetails": "broken due to transpiler errors"
         },
 
         "Tree Spread": {
             "ID": "bcmpinc.TreeSpread",
-            "~3.0.0 | Status": "AssumeBroken" // transpiler errors 
+            "~3.0.0 | Status": "AssumeBroken",
+            "~3.0.0 | StatusReasonDetails": "broken due to transpiler errors"
         },
 
         "TreeTransplant": {
             "ID": "TreeTransplant",
-            "~1.0.9 | Status": "AssumeBroken" // causes AccessViolationException which prevents game launch
+            "~1.0.9 | Status": "AssumeBroken",
+            "~3.0.0 | StatusReasonDetails": "breaks game launch due to AccessViolationException"
         },
 
         /*********
@@ -203,17 +208,14 @@
         *********/
         "Auto Quality Patch": {
             "ID": "SilentOak.AutoQualityPatch",
-            "~2.1.3-unofficial.7-mizzion | Status": "AssumeBroken" // runtime errors
+            "~2.1.3-unofficial.7-mizzion | Status": "AssumeBroken",
+            "~2.1.3-unofficial.7-mizzion | StatusReasonDetails": "broken due to runtime errors"
         },
 
         "Fix Dice": {
             "ID": "ashley.fixdice",
-            "~1.1.2 | Status": "AssumeBroken" // crashes game on startup
-        },
-
-        "Grass Growth": {
-            "ID": "bcmpinc.GrassGrowth",
-            "~1.0 | Status": "AssumeBroken"
+            "~1.1.2 | Status": "AssumeBroken",
+            "~1.1.2 | StatusReasonDetails": "crashes game on startup"
         },
 
         "Invite Code Mod": {
@@ -241,11 +243,6 @@
             "~2.15 | Status": "AssumeBroken"
         },
 
-        "Yet Another Harvest With Scythe Mod": {
-            "ID": "bcmpinc.HarvestWithScythe",
-            "~1.1 | Status": "AssumeBroken"
-        },
-
         /*********
         ** Broke in SMAPI 3.0 (runtime errors due to lifecycle changes)
         *********/
@@ -254,16 +251,6 @@
             "~1.0.0 | Status": "AssumeBroken"
         },
 
-        "Arcade 2048": {
-            "ID": "Platonymous.2048",
-            "~1.0.6 | Status": "AssumeBroken" // possibly due to PyTK
-        },
-
-        "Arcade Snake": {
-            "ID": "Platonymous.Snake",
-            "~1.1.0 | Status": "AssumeBroken" // possibly due to PyTK
-        },
-
         "Better Sprinklers": {
             "ID": "Speeder.BetterSprinklers",
             "~2.3.1-unofficial.7-pathoschild | Status": "AssumeBroken"
@@ -281,12 +268,8 @@
 
         "Decrafting Mod": {
             "ID": "MSCFC.DecraftingMod",
-            "~1.0 | Status": "AssumeBroken" // NRE in ModEntry
-        },
-
-        "JoJaBan - Arcade Sokoban": {
-            "ID": "Platonymous.JoJaBan",
-            "~0.4.3 | Status": "AssumeBroken" // possibly due to PyTK
+            "~1.0 | Status": "AssumeBroken",
+            "~1.0 | StatusReasonDetails": "fails due to NullReferenceException in ModEntry"
         },
 
         "Level Extender": {
@@ -304,11 +287,6 @@
             "~1.5 | Status": "AssumeBroken"
         },
 
-        "Seed Bag": {
-            "ID": "Platonymous.SeedBag",
-            "~1.2.7 | Status": "AssumeBroken" // possibly due to PyTK
-        },
-
         "Stardew Valley ESP": {
             "ID": "reimu.sdv-helper",
             "~1.1 | Status": "AssumeBroken"
@@ -316,12 +294,14 @@
 
         "Underdark Krobus": {
             "ID": "melnoelle.underdarkkrobus",
-            "~1.0.0 | Status": "AssumeBroken" // NRE in ModEntry
+            "~1.0 | Status": "AssumeBroken",
+            "~1.0 | StatusReasonDetails": "fails due to NullReferenceException in ModEntry"
         },
 
         "Underdark Sewer": {
             "ID": "melnoelle.underdarksewer",
-            "~1.1.0 | Status": "AssumeBroken" // NRE in ModEntry
+            "~1.1.0 | Status": "AssumeBroken",
+            "~1.1.0 | StatusReasonDetails": "fails due to NullReferenceException in ModEntry"
         },
 
         /*********
@@ -330,60 +310,70 @@
         "2cute FarmCave": {
             "ID": "taintedwheat.2CuteFarmCave",
             "Default | UpdateKey": "Nexus:843",
-            "~2.0 | Status": "AssumeBroken" // references deleted Content/Mine.xnb
+            "~2.0    | Status": "AssumeBroken",
+            "~2.0    | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
         "Ace's Expanded Caves - Default Cave": {
             "ID": "Acerbicon.AECdefault",
             "Default | UpdateKey": "Nexus:2131",
-            "~1.2.2  | Status": "AssumeBroken" // references deleted Content/Mine.xnb
+            "~1.2.2  | Status": "AssumeBroken",
+            "~1.2.2  | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
         "Ace's Expanded Caves - Desert Cave": {
             "ID": "Acerbicon.AECdesert",
             "Default | UpdateKey": "Nexus:2131",
-            "~1.2.2  | Status": "AssumeBroken" // references deleted Content/Mine.xnb
+            "~1.2.2  | Status": "AssumeBroken",
+            "~1.2.2  | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
         "Ace's Expanded Caves - Ice Cave": {
             "ID": "Acerbicon.AECice",
             "Default | UpdateKey": "Nexus:2131",
-            "~1.2.2  | Status": "AssumeBroken" // references deleted Content/Mine.xnb
+            "~1.2.2  | Status": "AssumeBroken",
+            "~1.2.2  | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
         "Ace's Expanded Caves - Lava Cave": {
             "ID": "Acerbicon.AEClava",
             "Default | UpdateKey": "Nexus:2131",
-            "~1.2.2  | Status": "AssumeBroken" // references deleted Content/Mine.xnb
+            "~1.2.2  | Status": "AssumeBroken",
+            "~1.2.2  | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
         "Ace's Expanded Caves - Slime Cave": {
             "ID": "Acerbicon.AECslime",
             "Default | UpdateKey": "Nexus:2131",
-            "~1.2.2  | Status": "AssumeBroken" // references deleted Content/Mine.xnb
+            "~1.2.2  | Status": "AssumeBroken",
+            "~1.2.2  | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
         "Green Pastures Farm": {
             "ID": "bugbuddy.GreenPasturesFarm",
             "Default | UpdateKey": "Nexus:2326",
-            "~1.0    | Status": "AssumeBroken" // references deleted Content/weapons.xnb
+            "~1.0    | Status": "AssumeBroken",
+            "~1.0    | StatusReasonDetails": "references the deleted Content/weapons asset"
         },
 
         "Immersive Farm 2": {
             "ID": "zander.immersivefarm2",
-            "~2.0.1 | Status": "AssumeBroken" // references deleted Content/Mine.xnb
+            "~2.0.1 | Status": "AssumeBroken",
+            "~2.0.1 | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
         "Karmylla's Immersive Map Edits": {
             "ID": "Karmylla.ImmersiveMapEdits",
             "Default | UpdateKey": "Nexus:1149",
-            "~2.4    | Status": "AssumeBroken" // references deleted Content/weapons.xnb
+            "~2.4    | Status": "AssumeBroken",
+            "~2.4    | StatusReasonDetails": "references the deleted Content/weapons asset"
         },
 
         "Secret Gardens Greenhouse": {
             "ID": "jessebot.secretgardens",
             "Default | UpdateKey": "Nexus:3067",
-            "~2.0.1 | Status": "AssumeBroken" // references deleted Content/Mine.xnb
+            "~2.0.1  | Status": "AssumeBroken",
+            "~2.0.1  | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
         /*********
@@ -391,102 +381,55 @@
         *********/
         "Canon-Friendly Dialogue Expansion": {
             "ID": "gizzymo.canonfriendlyexpansion",
-            "~1.1.1 | Status": "AssumeBroken" // causes a save crash on certain dates
+            "~1.1.1 | Status": "AssumeBroken",
+            "~1.1.1 | StatusReasonDetails": "causes a save crash on certain dates"
         },
 
         "Everytime Submarine": {
             "ID": "MustafaDemirel.EverytimeSubmarine",
-            "~1.0.0 | Status": "AssumeBroken" // breaks player saves if their beach bridge is fixed
-        },
-
-        "Always Scroll Map": {
-            "ID": "bcmpinc.AlwaysScrollMap",
-            "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
-        },
-
-        "Arcade Pong": {
-            "ID": "Platonymous.ArcadePong",
-            "~1.0.2 | Status": "AssumeBroken" // broke in SMAPI 2.6-beta.16 due to reflection into SMAPI internals
+            "~1.0.0 | Status": "AssumeBroken",
+            "~1.1.1 | StatusReasonDetails": "breaks player saves if their beach bridge is fixed"
         },
 
         "BJS Night Sounds": {
             "ID": "BunnyJumps.BJSNightSounds",
-            "~1.0.0 | Status": "AssumeBroken" // runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+
-        },
-
-        "Craft Counter": {
-            "ID": "bcmpinc.CraftCounter",
-            "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
+            "~1.0.0 | Status": "AssumeBroken",
+            "~1.0.0 | StatusReasonDetails": "runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+"
         },
 
         "Fishing Adjust": {
             "ID": "shuaiz.FishingAdjustMod",
-            "~2.0.1 | Status": "AssumeBroken" // Method not found: 'Void Harmony.HarmonyInstance.Patch(System.Reflection.MethodBase, Harmony.HarmonyMethod, Harmony.HarmonyMethod, Harmony.HarmonyMethod)'
+            "~2.0.1 | Status": "AssumeBroken",
+            "~2.0.1 | StatusReasonDetails":  "fails with 'method not found' error for 'Void Harmony.HarmonyInstance.Patch(System.Reflection.MethodBase, Harmony.HarmonyMethod, Harmony.HarmonyMethod, Harmony.HarmonyMethod)'"
         },
 
         "Fishing Automaton": {
             "ID": "Drynwynn.FishingAutomaton",
-            "~1.1 | Status": "AssumeBroken" // runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+
-        },
-
-        "Fix Animal Tools": {
-            "ID": "bcmpinc.FixAnimalTools",
-            "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
-        },
-
-        "Fix Scythe Exp": {
-            "ID": "bcmpinc.FixScytheExp",
-            "~0.3 | Status": "AssumeBroken" // broke in 1.3: Exception from HarmonyInstance "bcmpinc.FixScytheExp" [...] Bad label content in ILGenerator.
+            "~1.1 | Status": "AssumeBroken",
+            "~1.1 | StatusReasonDetails":  "runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+"
         },
 
         "More Silo Storage": {
             "ID": "OrneryWalrus.MoreSiloStorage",
-            "~1.0.1 | Status": "AssumeBroken" // broke in SDV 1.3
+            "~1.0.1 | Status": "AssumeBroken"
         },
 
         "No Added Flying Mine Monsters": {
             "ID": "Drynwynn.NoAddedFlyingMineMonsters",
-            "~1.1 | Status": "AssumeBroken" // runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+
+            "~1.1 | Status": "AssumeBroken",
+            "~1.1 | StatusReasonDetails": "runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+"
         },
 
         "Server Bookmarker": {
             "ID": "Ilyaki.ServerBookmarker",
-            "~1.0.0 | Status": "AssumeBroken" // broke in Stardew Valley 1.3.29 (runtime errors)
-        },
-
-        "Skull Cave Saver": {
-            "ID": "cantorsdust.SkullCaveSaver",
-            "FormerIDs": "8ac06349-26f7-4394-806c-95d48fd35774 | community.SkullCaveSaver", // changed in 1.1 and 1.2.2
-            "1.3-beta | Status": "AssumeBroken" // doesn't work in multiplayer, no longer maintained
-        },
-
-        "Stardew Hack": {
-            "ID": "bcmpinc.StardewHack",
-            "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
+            "~1.0.0 | Status": "AssumeBroken",
+            "~1.0.0 | StatusReasonDetails": "runtime errors in Stardew Valley 1.3.29"
         },
 
         "Stephan's Lots of Crops": {
             "ID": "stephansstardewcrops",
-            "~1.1    | Status": "AssumeBroken" // broke in SDV 1.3 (overwrites vanilla items)
-        },
-
-        "Summit Reborn": {
-            "ID": "KoihimeNakamura.summitreborn",
-            "FormerIDs": "emissaryofinfinity.summitreborn", // changed in 1.0.2
-            "~1.0.2 | Status": "AssumeBroken" // broke in SDV 1.3 (runtime errors)
-        },
-
-        "Tilled Soil Decay": {
-            "ID": "bcmpinc.TilledSoilDecay",
-            "~0.6 | Status": "AssumeBroken" // breaks newer versions of bcmpinc mods (per bcmpinc's request)
-        },
-
-        /*********
-        ** Broke circa SDV 1.2
-        *********/
-        "Move Faster": {
-            "ID": "shuaiz.MoveFasterMod",
-            "~1.0.1   | Status": "AssumeBroken" // doesn't do anything as of SDV 1.2.33 (bad Harmony patch?)
+            "~1.1 | Status": "AssumeBroken",
+            "~1.1 | StatusReasonDetails": "causes errors due to overwritten Stardew Valley 1.3 items"
         }
     }
 }

From fd37253dc3aa12be5b11b8d377eae3ced88bc30c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 30 Dec 2020 00:26:39 -0500
Subject: [PATCH 028/856] update compatibility list

---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 06762a3f..43b8d2ac 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -158,7 +158,16 @@
         },
 
         /*********
-        ** Broke in SDV 1.5
+        ** Broke in SDV 1.5 (Content Patcher packs)
+        *********/
+        "mi.Mermaids": {
+            "ID": "mi.Mermaids",
+            "~1.0.0 | Status": "AssumeBroken",
+            "~1.0.0 | StatusReasonDetails": "causes errors due to removed Stardew Valley 1.5 content"
+        },
+
+        /*********
+        ** Broke in SDV 1.5 (SMAPI mods)
         *********/
         "Audio Devices": {
             "ID": "maxvollmer.audiodevices",

From f95292953f95ec71071fce7a6438a5403dc85816 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 30 Dec 2020 19:38:48 -0500
Subject: [PATCH 029/856] fix repeated mods in 'skipped mods' section of
 console

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Framework/Logging/LogManager.cs | 18 ++++++++++++++----
 2 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c68b3d62..dbc8e905 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Updated compatibility list.
+  * Fixed 'skipped mods' section repeating mods in some cases.
 
 * For modders:
   * When a mod is blocked by SMAPI's internal compatibility list, the `TRACE` messages while loading it now indicates that and specifies the reason.
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index ee013a85..4a8019af 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -425,9 +425,11 @@ namespace StardewModdingAPI.Framework.Logging
                         this.Monitor.Log($"        ({mod.ErrorDetails})");
                 }
 
-                // find skipped dependencies
-                IModMetadata[] skippedDependencies;
+                // group mods
+                List<IModMetadata> skippedDependencies = new List<IModMetadata>();
+                List<IModMetadata> otherSkippedMods = new List<IModMetadata>();
                 {
+                    // track broken dependencies
                     HashSet<string> skippedDependencyIds = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
                     HashSet<string> skippedModIds = new HashSet<string>(from mod in skippedMods where mod.HasID() select mod.Manifest.UniqueID, StringComparer.OrdinalIgnoreCase);
                     foreach (IModMetadata mod in skippedMods)
@@ -435,7 +437,15 @@ namespace StardewModdingAPI.Framework.Logging
                         foreach (string requiredId in skippedModIds.Intersect(mod.GetRequiredModIds()))
                             skippedDependencyIds.Add(requiredId);
                     }
-                    skippedDependencies = skippedMods.Where(p => p.HasID() && skippedDependencyIds.Contains(p.Manifest.UniqueID)).ToArray();
+
+                    // collect mod groups
+                    foreach (IModMetadata mod in skippedMods)
+                    {
+                        if (mod.HasID() && skippedDependencyIds.Contains(mod.Manifest.UniqueID))
+                            skippedDependencies.Add(mod);
+                        else
+                            otherSkippedMods.Add(mod);
+                    }
                 }
 
                 // log skipped mods
@@ -451,7 +461,7 @@ namespace StardewModdingAPI.Framework.Logging
                     this.Monitor.Newline();
                 }
 
-                foreach (IModMetadata mod in skippedMods.OrderBy(p => p.DisplayName))
+                foreach (IModMetadata mod in otherSkippedMods.OrderBy(p => p.DisplayName))
                     LogSkippedMod(mod);
                 this.Monitor.Newline();
             }

From 0fdb09f5f9ef463dbf867c3a46ce680706305f0e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 1 Jan 2021 11:51:57 -0500
Subject: [PATCH 030/856] fix network messages not using same JSON serializer
 settings (#745)

---
 docs/release-notes.md                           |  1 +
 src/SMAPI.Toolkit/Serialization/JsonHelper.cs   |  6 ++++++
 src/SMAPI/Events/ModMessageReceivedEventArgs.cs | 10 ++++++++--
 src/SMAPI/Framework/SCore.cs                    |  2 +-
 4 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index dbc8e905..dcd638a3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -14,6 +14,7 @@
 
 * For modders:
   * When a mod is blocked by SMAPI's internal compatibility list, the `TRACE` messages while loading it now indicates that and specifies the reason.
+  * Message data from the `ModMessageReceived` event now uses the same serializer settings as the rest of SMAPI. This mainly adds support for sending crossplatform `Color`, `Point`, `Vector2`, `Rectangle`, and `SemanticVersion` fields through network messages.
 
 ## 3.8.1
 Released 26 December 2020 for Stardew Valley 1.5.1 or later.
diff --git a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
index 031afbb0..00db9903 100644
--- a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
+++ b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
@@ -132,5 +132,11 @@ namespace StardewModdingAPI.Toolkit.Serialization
         {
             return JsonConvert.SerializeObject(model, formatting, this.JsonSettings);
         }
+
+        /// <summary>Get a low-level JSON serializer matching the <see cref="JsonSettings"/>.</summary>
+        public JsonSerializer GetSerializer()
+        {
+            return JsonSerializer.CreateDefault(this.JsonSettings);
+        }
     }
 }
diff --git a/src/SMAPI/Events/ModMessageReceivedEventArgs.cs b/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
index d4370028..d75a7540 100644
--- a/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
+++ b/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
@@ -1,5 +1,6 @@
 using System;
 using StardewModdingAPI.Framework.Networking;
+using StardewModdingAPI.Toolkit.Serialization;
 
 namespace StardewModdingAPI.Events
 {
@@ -12,6 +13,9 @@ namespace StardewModdingAPI.Events
         /// <summary>The underlying message model.</summary>
         private readonly ModMessageModel Message;
 
+        /// <summary>The JSON helper used to deserialize models.</summary>
+        private readonly JsonHelper JsonHelper;
+
 
         /*********
         ** Accessors
@@ -31,16 +35,18 @@ namespace StardewModdingAPI.Events
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="message">The received message.</param>
-        internal ModMessageReceivedEventArgs(ModMessageModel message)
+        /// <param name="jsonHelper">The JSON helper used to deserialize models.</param>
+        internal ModMessageReceivedEventArgs(ModMessageModel message, JsonHelper jsonHelper)
         {
             this.Message = message;
+            this.JsonHelper = jsonHelper;
         }
 
         /// <summary>Read the message data into the given model type.</summary>
         /// <typeparam name="TModel">The message model type.</typeparam>
         public TModel ReadAs<TModel>()
         {
-            return this.Message.Data.ToObject<TModel>();
+            return this.Message.Data.ToObject<TModel>(this.JsonHelper.GetSerializer());
         }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 27540442..5dc33828 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1128,7 +1128,7 @@ namespace StardewModdingAPI.Framework
                 modIDs.Remove(message.FromModID); // don't send a broadcast back to the sender
 
             // raise events
-            this.EventManager.ModMessageReceived.Raise(new ModMessageReceivedEventArgs(message), mod => mod != null && modIDs.Contains(mod.Manifest.UniqueID));
+            this.EventManager.ModMessageReceived.Raise(new ModMessageReceivedEventArgs(message, this.Toolkit.JsonHelper), mod => mod != null && modIDs.Contains(mod.Manifest.UniqueID));
         }
 
         /// <summary>Constructor a content manager to read game content files.</summary>

From 251ee2121a870bd8210830a8bdb943f64c00e030 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Jan 2021 12:33:19 -0500
Subject: [PATCH 031/856] fix players in split-screen mode sharing peer state
 (#747)

---
 docs/release-notes.md               |  1 +
 src/SMAPI/Framework/SMultiplayer.cs | 15 +++++++++++++--
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index dcd638a3..a12a5482 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Updated compatibility list.
+  * Fixed errors when multiple players join in split-screen mode.
   * Fixed 'skipped mods' section repeating mods in some cases.
 
 * For modders:
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index f3b5e9b9..2f89fce9 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -10,6 +10,7 @@ using StardewModdingAPI.Framework.Events;
 using StardewModdingAPI.Framework.Networking;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Serialization;
+using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.Network;
 using StardewValley.SDKs;
@@ -54,15 +55,25 @@ namespace StardewModdingAPI.Framework
         /// <summary>Whether to log network traffic.</summary>
         private readonly bool LogNetworkTraffic;
 
+        /// <summary>The backing field for <see cref="Peers"/>.</summary>
+        private readonly PerScreen<IDictionary<long, MultiplayerPeer>> PeersImpl = new(() => new Dictionary<long, MultiplayerPeer>());
+
+        /// <summary>The backing field for <see cref="HostPeer"/>.</summary>
+        private readonly PerScreen<MultiplayerPeer> HostPeerImpl = new();
+
 
         /*********
         ** Accessors
         *********/
         /// <summary>The metadata for each connected peer.</summary>
-        public IDictionary<long, MultiplayerPeer> Peers { get; } = new Dictionary<long, MultiplayerPeer>();
+        public IDictionary<long, MultiplayerPeer> Peers => this.PeersImpl.Value;
 
         /// <summary>The metadata for the host player, if the current player is a farmhand.</summary>
-        public MultiplayerPeer HostPeer;
+        public MultiplayerPeer HostPeer
+        {
+            get => this.HostPeerImpl.Value;
+            private set => this.HostPeerImpl.Value = value;
+        }
 
 
         /*********

From 456480ef918fc4d864b425fb7a8779618a91475a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Jan 2021 15:02:58 -0500
Subject: [PATCH 032/856] fix cursor position incorrectly handling UI mode
 (#741)

---
 docs/release-notes.md                    |  1 +
 src/SMAPI/Framework/CursorPosition.cs    | 21 +++++++++++++++++++--
 src/SMAPI/Framework/Input/SInputState.cs | 18 ++++++++----------
 src/SMAPI/ICursorPosition.cs             | 18 ++++++++++++++++--
 4 files changed, 44 insertions(+), 14 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a12a5482..c4aa413e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,6 +16,7 @@
 * For modders:
   * When a mod is blocked by SMAPI's internal compatibility list, the `TRACE` messages while loading it now indicates that and specifies the reason.
   * Message data from the `ModMessageReceived` event now uses the same serializer settings as the rest of SMAPI. This mainly adds support for sending crossplatform `Color`, `Point`, `Vector2`, `Rectangle`, and `SemanticVersion` fields through network messages.
+  * Fixed how the input API handles UI scaling. This mainly affects `ICursorPosition` values returned by the API; see [the wiki docs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Input#ICursorPosition) for how to account for UI scaling.
 
 ## 3.8.1
 Released 26 December 2020 for Stardew Valley 1.5.1 or later.
diff --git a/src/SMAPI/Framework/CursorPosition.cs b/src/SMAPI/Framework/CursorPosition.cs
index 80d89994..107481e7 100644
--- a/src/SMAPI/Framework/CursorPosition.cs
+++ b/src/SMAPI/Framework/CursorPosition.cs
@@ -1,4 +1,5 @@
 using Microsoft.Xna.Framework;
+using StardewValley;
 
 namespace StardewModdingAPI.Framework
 {
@@ -25,8 +26,8 @@ namespace StardewModdingAPI.Framework
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="absolutePixels">The pixel position relative to the top-left corner of the in-game map, adjusted for pixel zoom.</param>
-        /// <param name="screenPixels">The pixel position relative to the top-left corner of the visible screen, adjusted for pixel zoom.</param>
+        /// <param name="absolutePixels">The pixel position relative to the top-left corner of the in-game map, adjusted for zoom but not UI scaling.</param>
+        /// <param name="screenPixels">The pixel position relative to the top-left corner of the visible screen, adjusted for zoom but not UI scaling.</param>
         /// <param name="tile">The tile position relative to the top-left corner of the map.</param>
         /// <param name="grabTile">The tile position that the game considers under the cursor for purposes of clicking actions.</param>
         public CursorPosition(Vector2 absolutePixels, Vector2 screenPixels, Vector2 tile, Vector2 grabTile)
@@ -42,5 +43,21 @@ namespace StardewModdingAPI.Framework
         {
             return other != null && this.AbsolutePixels == other.AbsolutePixels;
         }
+
+        /// <inheritdoc />
+        public Vector2 GetScaledAbsolutePixels()
+        {
+            return Game1.uiMode
+                ? Utility.ModifyCoordinatesForUIScale(this.AbsolutePixels)
+                : this.AbsolutePixels;
+        }
+
+        /// <inheritdoc />
+        public Vector2 GetScaledScreenPixels()
+        {
+            return Game1.uiMode
+                ? Utility.ModifyCoordinatesForUIScale(this.ScreenPixels)
+                : this.ScreenPixels;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Input/SInputState.cs b/src/SMAPI/Framework/Input/SInputState.cs
index 23670202..a8d1f371 100644
--- a/src/SMAPI/Framework/Input/SInputState.cs
+++ b/src/SMAPI/Framework/Input/SInputState.cs
@@ -63,18 +63,16 @@ namespace StardewModdingAPI.Framework.Input
             base.Update();
 
             // update SMAPI extended data
+            // note: Stardew Valley is *not* in UI mode when this code runs
             try
             {
-                float scale = Game1.options.uiScale;
+                float zoomMultiplier = (1f / Game1.options.zoomLevel);
 
                 // get real values
                 var controller = new GamePadStateBuilder(base.GetGamePadState());
                 var keyboard = new KeyboardStateBuilder(base.GetKeyboardState());
                 var mouse = new MouseStateBuilder(base.GetMouseState());
-                Vector2 cursorAbsolutePos = new Vector2(
-                    x: (mouse.X / scale) + Game1.uiViewport.X,
-                    y: (mouse.Y / scale) + Game1.uiViewport.Y
-                );
+                Vector2 cursorAbsolutePos = new Vector2((mouse.X * zoomMultiplier) + Game1.viewport.X, (mouse.Y * zoomMultiplier) + Game1.viewport.Y);
                 Vector2? playerTilePos = Context.IsPlayerFree ? Game1.player.getTileLocation() : (Vector2?)null;
                 HashSet<SButton> reallyDown = new HashSet<SButton>(this.GetPressedButtons(keyboard, mouse, controller));
 
@@ -109,7 +107,7 @@ namespace StardewModdingAPI.Framework.Input
                 if (cursorAbsolutePos != this.CursorPositionImpl?.AbsolutePixels || playerTilePos != this.LastPlayerTile)
                 {
                     this.LastPlayerTile = playerTilePos;
-                    this.CursorPositionImpl = this.GetCursorPosition(this.MouseState, cursorAbsolutePos, scale);
+                    this.CursorPositionImpl = this.GetCursorPosition(this.MouseState, cursorAbsolutePos, zoomMultiplier);
                 }
             }
             catch (InvalidOperationException)
@@ -202,11 +200,11 @@ namespace StardewModdingAPI.Framework.Input
         /// <summary>Get the current cursor position.</summary>
         /// <param name="mouseState">The current mouse state.</param>
         /// <param name="absolutePixels">The absolute pixel position relative to the map, adjusted for pixel zoom.</param>
-        /// <param name="scale">The UI scale applied to pixel coordinates.</param>
-        private CursorPosition GetCursorPosition(MouseState mouseState, Vector2 absolutePixels, float scale)
+        /// <param name="zoomMultiplier">The multiplier applied to pixel coordinates to adjust them for pixel zoom.</param>
+        private CursorPosition GetCursorPosition(MouseState mouseState, Vector2 absolutePixels, float zoomMultiplier)
         {
-            Vector2 screenPixels = new Vector2(mouseState.X / scale, mouseState.Y / scale);
-            Vector2 tile = new Vector2((int)((Game1.uiViewport.X + screenPixels.X) / Game1.tileSize), (int)((Game1.uiViewport.Y + screenPixels.Y) / Game1.tileSize));
+            Vector2 screenPixels = new Vector2(mouseState.X * zoomMultiplier, mouseState.Y * zoomMultiplier);
+            Vector2 tile = new Vector2((int)((Game1.viewport.X + screenPixels.X) / Game1.tileSize), (int)((Game1.viewport.Y + screenPixels.Y) / Game1.tileSize));
             Vector2 grabTile = (Game1.mouseCursorTransparency > 0 && Utility.tileWithinRadiusOfPlayer((int)tile.X, (int)tile.Y, 1, Game1.player)) // derived from Game1.pressActionButton
                 ? tile
                 : Game1.player.GetGrabTile();
diff --git a/src/SMAPI/ICursorPosition.cs b/src/SMAPI/ICursorPosition.cs
index 21c57db0..99c1b84d 100644
--- a/src/SMAPI/ICursorPosition.cs
+++ b/src/SMAPI/ICursorPosition.cs
@@ -1,15 +1,19 @@
 using System;
 using Microsoft.Xna.Framework;
+using StardewValley;
 
 namespace StardewModdingAPI
 {
     /// <summary>Represents a cursor position in the different coordinate systems.</summary>
     public interface ICursorPosition : IEquatable<ICursorPosition>
     {
-        /// <summary>The pixel position relative to the top-left corner of the in-game map.</summary>
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The pixel position relative to the top-left corner of the in-game map, adjusted for zoom but not UI scaling. See also <see cref="GetScaledAbsolutePixels"/>.</summary>
         Vector2 AbsolutePixels { get; }
 
-        /// <summary>The pixel position relative to the top-left corner of the visible screen.</summary>
+        /// <summary>The pixel position relative to the top-left corner of the visible screen, adjusted for zoom but not UI scaling. See also <see cref="GetScaledScreenPixels"/>.</summary>
         Vector2 ScreenPixels { get; }
 
         /// <summary>The tile position under the cursor relative to the top-left corner of the map.</summary>
@@ -17,5 +21,15 @@ namespace StardewModdingAPI
 
         /// <summary>The tile position that the game considers under the cursor for purposes of clicking actions. This may be different than <see cref="Tile"/> if that's too far from the player.</summary>
         Vector2 GrabTile { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get the <see cref="AbsolutePixels"/>, adjusted for UI scaling if needed. This is only different if <see cref="Game1.uiMode"/> is true.</summary>
+        Vector2 GetScaledAbsolutePixels();
+
+        /// <summary>Get the <see cref="ScreenPixels"/>, adjusted for UI scaling if needed. This is only different if <see cref="Game1.uiMode"/> is true.</summary>
+        Vector2 GetScaledScreenPixels();
     }
 }

From 76e08fc58b75be3dbcd852bfe53dfed40987871d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Jan 2021 15:49:25 -0500
Subject: [PATCH 033/856] detect flatpak Steam install paths (#739)

---
 build/find-game-folder.targets | 1 +
 docs/release-notes.md          | 1 +
 2 files changed, 2 insertions(+)

diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index f304d841..a4200662 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -11,6 +11,7 @@
         <GamePath Condition="!Exists('$(GamePath)')">$(HOME)/GOG Games/Stardew Valley/game</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">$(HOME)/.steam/steam/steamapps/common/Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">$(HOME)/.local/share/Steam/steamapps/common/Stardew Valley</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">$(HOME)/.var/app/com.valvesoftware.Steam/data/Steam/steamapps/common/Stardew Valley</GamePath>
 
         <!-- Mac (may be 'Unix' or 'OSX') -->
         <GamePath Condition="!Exists('$(GamePath)')">/Applications/Stardew Valley.app/Contents/MacOS</GamePath>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index c4aa413e..ecad1635 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Updated compatibility list.
+  * On Linux, the SMAPI installer now auto-detects flatpak Steam paths.
   * Fixed errors when multiple players join in split-screen mode.
   * Fixed 'skipped mods' section repeating mods in some cases.
 

From 68bcf28e6cd92dd843c2e461ccca74c0b432f1e6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Jan 2021 18:22:30 -0500
Subject: [PATCH 034/856] update error text linking to renamed wiki section

---
 docs/release-notes.md                     | 1 +
 src/SMAPI/Framework/Logging/LogManager.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ecad1635..9fbfcbb3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
   * On Linux, the SMAPI installer now auto-detects flatpak Steam paths.
   * Fixed errors when multiple players join in split-screen mode.
   * Fixed 'skipped mods' section repeating mods in some cases.
+  * Fixed out-of-date error text.
 
 * For modders:
   * When a mod is blocked by SMAPI's internal compatibility list, the `TRACE` messages while loading it now indicates that and specifies the reason.
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 4a8019af..e504218b 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -46,7 +46,7 @@ namespace StardewModdingAPI.Framework.Logging
                 search: new Regex(@"^System\.InvalidOperationException: Steamworks is not initialized\.[\s\S]+$", RegexOptions.Compiled | RegexOptions.CultureInvariant),
                 replacement:
 #if SMAPI_FOR_WINDOWS
-                    "Oops! Steam achievements won't work because Steam isn't loaded. You can launch the game through Steam to fix that (see 'Part 2: Configure Steam' in the install guide for more info: https://smapi.io/install).",
+                    "Oops! Steam achievements won't work because Steam isn't loaded. See 'Launch SMAPI through Steam or GOG Galaxy' in the install guide for more info: https://smapi.io/install.",
 #else
                     "Oops! Steam achievements won't work because Steam isn't loaded. You can launch the game through Steam to fix that.",
 #endif

From 397f338394c31e2a9bad2e90383f1ff621ae5d91 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Jan 2021 22:24:45 -0500
Subject: [PATCH 035/856] detect and block map replacements that would crash
 the game due to tilesheet changes

---
 docs/release-notes.md                         |  2 +
 src/SMAPI/Framework/ContentCoordinator.cs     | 23 +++++
 .../ContentManagers/GameContentManager.cs     | 84 +++++++++++++++++--
 src/SMAPI/Framework/DeprecationManager.cs     |  5 ++
 4 files changed, 106 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9fbfcbb3..e671f373 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Updated compatibility list.
+  * SMAPI now blocks farm map replacements that would crash the game in Stardew Valley 1.5.
   * On Linux, the SMAPI installer now auto-detects flatpak Steam paths.
   * Fixed errors when multiple players join in split-screen mode.
   * Fixed 'skipped mods' section repeating mods in some cases.
@@ -18,6 +19,7 @@
 * For modders:
   * When a mod is blocked by SMAPI's internal compatibility list, the `TRACE` messages while loading it now indicates that and specifies the reason.
   * Message data from the `ModMessageReceived` event now uses the same serializer settings as the rest of SMAPI. This mainly adds support for sending crossplatform `Color`, `Point`, `Vector2`, `Rectangle`, and `SemanticVersion` fields through network messages.
+  * Added warning when a map replacement changes the tilesheet order/IDs, which may cause crashes.
   * Fixed how the input API handles UI scaling. This mainly affects `ICursorPosition` values returned by the API; see [the wiki docs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Input#ICursorPosition) for how to account for UI scaling.
 
 ## 3.8.1
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index f9027972..3d5bb29d 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -54,6 +54,9 @@ namespace StardewModdingAPI.Framework
         /// <remarks>The game may adds content managers in asynchronous threads (e.g. when populating the load screen).</remarks>
         private readonly ReaderWriterLockSlim ContentManagerLock = new ReaderWriterLockSlim();
 
+        /// <summary>An unmodified content manager which doesn't intercept assets, used to compare asset data.</summary>
+        private readonly LocalizedContentManager VanillaContentManager;
+
 
         /*********
         ** Accessors
@@ -95,6 +98,7 @@ namespace StardewModdingAPI.Framework
             this.ContentManagers.Add(
                 this.MainContentManager = new GameContentManager("Game1.content", serviceProvider, rootDirectory, currentCulture, this, monitor, reflection, this.OnDisposing, onLoadingFirstAsset)
             );
+            this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
             this.CoreAssets = new CoreAssetPropagator(this.MainContentManager.AssertAndNormalizeAssetName, reflection);
         }
 
@@ -150,6 +154,8 @@ namespace StardewModdingAPI.Framework
             {
                 foreach (IContentManager contentManager in this.ContentManagers)
                     contentManager.OnLocaleChanged();
+
+                this.VanillaContentManager.Unload();
             });
         }
 
@@ -287,6 +293,23 @@ namespace StardewModdingAPI.Framework
             });
         }
 
+        /// <summary>Get a vanilla asset without interception.</summary>
+        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
+        public bool TryLoadVanillaAsset<T>(string assetName, out T asset)
+        {
+            try
+            {
+                asset = this.VanillaContentManager.Load<T>(assetName);
+                return true;
+            }
+            catch
+            {
+                asset = default;
+                return false;
+            }
+        }
+
         /// <summary>Dispose held resources.</summary>
         public void Dispose()
         {
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index ad8f2ef1..424d6ff3 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -11,6 +11,7 @@ using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Utilities;
 using StardewValley;
 using xTile;
+using xTile.Tiles;
 
 namespace StardewModdingAPI.Framework.ContentManagers
 {
@@ -308,15 +309,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return null;
             }
 
-            // validate asset
-            if (data == null)
-            {
-                mod.LogAsMod($"Mod incorrectly set asset '{info.AssetName}' to a null value; ignoring override.", LogLevel.Error);
-                return null;
-            }
-
             // return matched asset
-            return new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName);
+            return this.TryValidateLoadedAsset(info, data, mod)
+                ? new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName)
+                : null;
         }
 
         /// <summary>Apply any <see cref="Editors"/> to a loaded asset.</summary>
@@ -386,5 +382,77 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // return result
             return asset;
         }
+
+        /// <summary>Validate that an asset loaded by a mod is valid and won't cause issues.</summary>
+        /// <typeparam name="T">The asset type.</typeparam>
+        /// <param name="info">The basic asset metadata.</param>
+        /// <param name="data">The loaded asset data.</param>
+        /// <param name="mod">The mod which loaded the asset.</param>
+        private bool TryValidateLoadedAsset<T>(IAssetInfo info, T data, IModMetadata mod)
+        {
+            // can't load a null asset
+            if (data == null)
+            {
+                mod.LogAsMod($"SMAPI blocked asset replacement for '{info.AssetName}': mod incorrectly set asset to a null value.", LogLevel.Error);
+                return false;
+            }
+
+            // when replacing a map, the vanilla tilesheets must have the same order and IDs
+            if (data is Map loadedMap && this.Coordinator.TryLoadVanillaAsset(info.AssetName, out Map vanillaMap))
+            {
+                for (int i = 0; i < vanillaMap.TileSheets.Count; i++)
+                {
+                    // check for match
+                    TileSheet vanillaSheet = vanillaMap.TileSheets[i];
+                    bool found = this.TryFindTilesheet(loadedMap, vanillaSheet.Id, out int loadedIndex, out TileSheet loadedSheet);
+                    if (found && loadedIndex == i)
+                        continue;
+
+                    // handle mismatch
+                    {
+                        // only show warning if not farm map
+                        // This is temporary: mods shouldn't do this for any vanilla map, but these are the ones we know will crash. Showing a warning for others instead gives modders time to update their mods, while still simplifying troubleshooting.
+                        bool isFarmMap = info.AssetNameEquals("Maps/Farm") || info.AssetNameEquals("Maps/Farm_Combat") || info.AssetNameEquals("Maps/Farm_Fishing") || info.AssetNameEquals("Maps/Farm_Foraging") || info.AssetNameEquals("Maps/Farm_FourCorners") || info.AssetNameEquals("Maps/Farm_Island") || info.AssetNameEquals("Maps/Farm_Mining");
+
+
+                        string reason = found
+                            ? $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\n\nTechnical details for mod author:\nExpected order [{string.Join(", ", vanillaMap.TileSheets.Select(p => $"'{p.ImageSource}' (id: {p.Id})"))}], but found tilesheet '{vanillaSheet.Id}' at index {loadedIndex} instead of {i}. Make sure custom tilesheet IDs are prefixed with 'z_' to avoid reordering tilesheets."
+                            : $"mod has no tilesheet with ID '{vanillaSheet.Id}'. Map replacements must keep the original tilesheets to avoid errors or crashes.";
+
+                        SCore.DeprecationManager.PlaceholderWarn("3.8.2", DeprecationLevel.PendingRemoval);
+                        if (isFarmMap)
+                        {
+                            mod.LogAsMod($"SMAPI blocked asset replacement for '{info.AssetName}': {reason}", LogLevel.Error);
+                            return false;
+                        }
+                        mod.LogAsMod($"SMAPI detected a potential issue with asset replacement for '{info.AssetName}' map: {reason}", LogLevel.Warn);
+                    }
+                }
+            }
+
+            return true;
+        }
+
+        /// <summary>Find a map tilesheet by ID.</summary>
+        /// <param name="map">The map whose tilesheets to search.</param>
+        /// <param name="id">The tilesheet ID to match.</param>
+        /// <param name="index">The matched tilesheet index, if any.</param>
+        /// <param name="tilesheet">The matched tilesheet, if any.</param>
+        private bool TryFindTilesheet(Map map, string id, out int index, out TileSheet tilesheet)
+        {
+            for (int i = 0; i < map.TileSheets.Count; i++)
+            {
+                if (map.TileSheets[i].Id == id)
+                {
+                    index = i;
+                    tilesheet = map.TileSheets[i];
+                    return true;
+                }
+            }
+
+            index = -1;
+            tilesheet = null;
+            return false;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/DeprecationManager.cs b/src/SMAPI/Framework/DeprecationManager.cs
index c22b5718..fc1b434b 100644
--- a/src/SMAPI/Framework/DeprecationManager.cs
+++ b/src/SMAPI/Framework/DeprecationManager.cs
@@ -63,6 +63,11 @@ namespace StardewModdingAPI.Framework
             this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, Environment.StackTrace));
         }
 
+        /// <summary>A placeholder method used to track deprecated code for which a separate warning will be shown.</summary>
+        /// <param name="version">The SMAPI version which deprecated it.</param>
+        /// <param name="severity">How deprecated the code is.</param>
+        public void PlaceholderWarn(string version, DeprecationLevel severity) { }
+
         /// <summary>Print any queued messages.</summary>
         public void PrintQueued()
         {

From 8b9fc0dce79a23d37238ad773a45d97c1a4f1f92 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Jan 2021 22:25:10 -0500
Subject: [PATCH 036/856] update compatibility list

---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 43b8d2ac..e75a6bc0 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -175,6 +175,18 @@
             "~2.0.0 | StatusReasonDetails": "causes crash to desktop when starting the game"
         },
 
+        "ChestEx": {
+            "ID": "berkayylmao.ChestEx",
+            "~1.3.4 | Status": "AssumeBroken",
+            "~1.3.4 | StatusReasonDetails": "has no effect due to changes in Stardew Valley 1.5, causes crashes in other mods like Chests Anywhere"
+        },
+
+        "Custom Furniture": {
+            "ID": "Platonymous.CustomFurniture",
+            "~0.11.2 | Status": "AssumeBroken",
+            "~0.11.2 | StatusReasonDetails": "causes errors and custom furniture no longer work in Stardew Valley 1.5"
+        },
+        
         "Custom Localization": {
             "ID": "ZaneYork.CustomLocalization",
             "FormerIDs": "SMAPI.CustomLocalization", // changed in 1.0.1
@@ -182,6 +194,12 @@
             "~1.1 | StatusReasonDetails": "reflection error due to renamed _localizedAssets field"
         },
 
+        "Geode Info Menu": {
+            "ID": "cat.geodeinfomenu",
+            "~1.5.2 | Status": "AssumeBroken",
+            "~1.5.2 | StatusReasonDetails": "shows no info, freezes game if you try to search"
+        },
+
         "Mod Settings Tab": {
             "ID": "GilarF.ModSettingsTab",
             "~0.2.1 | Status": "AssumeBroken",

From 2b3f0506a16622b25a702aae250e10005287c4f4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 3 Jan 2021 14:31:10 -0500
Subject: [PATCH 037/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 14 ++++++++------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 5 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 6c79d290..4332313b 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.8.1</Version>
+    <Version>3.8.2</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index e671f373..82709d3c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,19 +7,21 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.8.2
+Released 03 January 2021 for Stardew Valley 1.5.1 or later.
+
 * For players:
-  * Updated compatibility list.
   * SMAPI now blocks farm map replacements that would crash the game in Stardew Valley 1.5.
-  * On Linux, the SMAPI installer now auto-detects flatpak Steam paths.
+  * On Linux, the SMAPI installer now auto-detects Flatpak Steam paths.
+  * Updated compatibility list.
   * Fixed errors when multiple players join in split-screen mode.
   * Fixed 'skipped mods' section repeating mods in some cases.
   * Fixed out-of-date error text.
 
 * For modders:
-  * When a mod is blocked by SMAPI's internal compatibility list, the `TRACE` messages while loading it now indicates that and specifies the reason.
-  * Message data from the `ModMessageReceived` event now uses the same serializer settings as the rest of SMAPI. This mainly adds support for sending crossplatform `Color`, `Point`, `Vector2`, `Rectangle`, and `SemanticVersion` fields through network messages.
-  * Added warning when a map replacement changes the tilesheet order/IDs, which may cause crashes.
+  * Added warning when a map replacement changes the order/IDs of the original tilesheets, which may cause errors and crashes. Doing so for a farm map is blocked outright since that causes a consistent crash in Stardew Valley 1.5.
+  * Message data from the `ModMessageReceived` event now uses the same serializer settings as the rest of SMAPI. That mainly adds support for sending crossplatform `Color`, `Point`, `Vector2`, `Rectangle`, and `SemanticVersion` fields through network messages.
+  * When a mod is blocked by SMAPI's compatibility override list, the `TRACE` messages while loading it now say so and indicate why.
   * Fixed how the input API handles UI scaling. This mainly affects `ICursorPosition` values returned by the API; see [the wiki docs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Input#ICursorPosition) for how to account for UI scaling.
 
 ## 3.8.1
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 61c610d0..13e85c70 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.8.1",
+    "Version": "3.8.2",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.8.1"
+    "MinimumApiVersion": "3.8.2"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 7cf63e66..475ec165 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.8.1",
+    "Version": "3.8.2",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.8.1"
+    "MinimumApiVersion": "3.8.2"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 9d5501a3..ef996c0f 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.1");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.2");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.1");

From c5be446701d4e24a03d8464e9b080ce74d158223 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Jan 2021 00:29:39 -0500
Subject: [PATCH 038/856] rework vanilla tilesheet checking to avoid keeping a
 copy of the vanilla maps in memory

---
 docs/release-notes.md                         |  4 ++
 .../Framework/Content/TilesheetReference.cs   | 33 ++++++++++++++
 src/SMAPI/Framework/ContentCoordinator.cs     | 43 ++++++++++++++-----
 .../ContentManagers/GameContentManager.cs     | 32 +++++---------
 4 files changed, 80 insertions(+), 32 deletions(-)
 create mode 100644 src/SMAPI/Framework/Content/TilesheetReference.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 82709d3c..9e2caba0 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Slightly reduced memory usage.
+
 ## 3.8.2
 Released 03 January 2021 for Stardew Valley 1.5.1 or later.
 
diff --git a/src/SMAPI/Framework/Content/TilesheetReference.cs b/src/SMAPI/Framework/Content/TilesheetReference.cs
new file mode 100644
index 00000000..2ea38430
--- /dev/null
+++ b/src/SMAPI/Framework/Content/TilesheetReference.cs
@@ -0,0 +1,33 @@
+namespace StardewModdingAPI.Framework.Content
+{
+    /// <summary>Basic metadata about a vanilla tilesheet.</summary>
+    internal class TilesheetReference
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The tilesheet's index in the list.</summary>
+        public readonly int Index;
+
+        /// <summary>The tilesheet's unique ID in the map.</summary>
+        public readonly string Id;
+
+        /// <summary>The asset path for the tilesheet texture.</summary>
+        public readonly string ImageSource;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="index">The tilesheet's index in the list.</param>
+        /// <param name="id">The tilesheet's unique ID in the map.</param>
+        /// <param name="imageSource">The asset path for the tilesheet texture.</param>
+        public TilesheetReference(int index, string id, string imageSource)
+        {
+            this.Index = index;
+            this.Id = id;
+            this.ImageSource = imageSource;
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 3d5bb29d..27fb3dbb 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -54,6 +54,9 @@ namespace StardewModdingAPI.Framework
         /// <remarks>The game may adds content managers in asynchronous threads (e.g. when populating the load screen).</remarks>
         private readonly ReaderWriterLockSlim ContentManagerLock = new ReaderWriterLockSlim();
 
+        /// <summary>A cache of ordered tilesheet IDs used by vanilla maps.</summary>
+        private readonly IDictionary<string, TilesheetReference[]> VanillaTilesheets = new Dictionary<string, TilesheetReference[]>(StringComparer.OrdinalIgnoreCase);
+
         /// <summary>An unmodified content manager which doesn't intercept assets, used to compare asset data.</summary>
         private readonly LocalizedContentManager VanillaContentManager;
 
@@ -293,21 +296,21 @@ namespace StardewModdingAPI.Framework
             });
         }
 
-        /// <summary>Get a vanilla asset without interception.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <summary>Get the tilesheet ID order used by the unmodified version of a map asset.</summary>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        public bool TryLoadVanillaAsset<T>(string assetName, out T asset)
+        public TilesheetReference[] GetVanillaTilesheetIds(string assetName)
         {
-            try
+            if (!this.VanillaTilesheets.TryGetValue(assetName, out TilesheetReference[] tilesheets))
             {
-                asset = this.VanillaContentManager.Load<T>(assetName);
-                return true;
-            }
-            catch
-            {
-                asset = default;
-                return false;
+                tilesheets = this.TryLoadVanillaAsset(assetName, out Map map)
+                    ? map.TileSheets.Select((sheet, index) => new TilesheetReference(index, sheet.Id, sheet.ImageSource)).ToArray()
+                    : null;
+
+                this.VanillaTilesheets[assetName] = tilesheets;
+                this.VanillaContentManager.Unload();
             }
+
+            return tilesheets ?? new TilesheetReference[0];
         }
 
         /// <summary>Dispose held resources.</summary>
@@ -341,5 +344,23 @@ namespace StardewModdingAPI.Framework
                 this.ContentManagers.Remove(contentManager)
             );
         }
+
+        /// <summary>Get a vanilla asset without interception.</summary>
+        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
+        /// <param name="asset">The loaded asset data.</param>
+        private bool TryLoadVanillaAsset<T>(string assetName, out T asset)
+        {
+            try
+            {
+                asset = this.VanillaContentManager.Load<T>(assetName);
+                return true;
+            }
+            catch
+            {
+                asset = default;
+                return false;
+            }
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 424d6ff3..540475f1 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -11,7 +11,6 @@ using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Utilities;
 using StardewValley;
 using xTile;
-using xTile.Tiles;
 
 namespace StardewModdingAPI.Framework.ContentManagers
 {
@@ -398,14 +397,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // when replacing a map, the vanilla tilesheets must have the same order and IDs
-            if (data is Map loadedMap && this.Coordinator.TryLoadVanillaAsset(info.AssetName, out Map vanillaMap))
+            if (data is Map loadedMap)
             {
-                for (int i = 0; i < vanillaMap.TileSheets.Count; i++)
+                TilesheetReference[] vanillaTilesheetRefs = this.Coordinator.GetVanillaTilesheetIds(info.AssetName);
+                foreach (TilesheetReference vanillaSheet in vanillaTilesheetRefs)
                 {
-                    // check for match
-                    TileSheet vanillaSheet = vanillaMap.TileSheets[i];
-                    bool found = this.TryFindTilesheet(loadedMap, vanillaSheet.Id, out int loadedIndex, out TileSheet loadedSheet);
-                    if (found && loadedIndex == i)
+                    // skip if match
+                    if (loadedMap.TileSheets.Count > vanillaSheet.Index && loadedMap.TileSheets[vanillaSheet.Index].Id == vanillaSheet.Id)
                         continue;
 
                     // handle mismatch
@@ -414,9 +412,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         // This is temporary: mods shouldn't do this for any vanilla map, but these are the ones we know will crash. Showing a warning for others instead gives modders time to update their mods, while still simplifying troubleshooting.
                         bool isFarmMap = info.AssetNameEquals("Maps/Farm") || info.AssetNameEquals("Maps/Farm_Combat") || info.AssetNameEquals("Maps/Farm_Fishing") || info.AssetNameEquals("Maps/Farm_Foraging") || info.AssetNameEquals("Maps/Farm_FourCorners") || info.AssetNameEquals("Maps/Farm_Island") || info.AssetNameEquals("Maps/Farm_Mining");
 
-
-                        string reason = found
-                            ? $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\n\nTechnical details for mod author:\nExpected order [{string.Join(", ", vanillaMap.TileSheets.Select(p => $"'{p.ImageSource}' (id: {p.Id})"))}], but found tilesheet '{vanillaSheet.Id}' at index {loadedIndex} instead of {i}. Make sure custom tilesheet IDs are prefixed with 'z_' to avoid reordering tilesheets."
+                        int loadedIndex = this.TryFindTilesheet(loadedMap, vanillaSheet.Id);
+                        string reason = loadedIndex != -1
+                            ? $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\n\nTechnical details for mod author:\nExpected order [{string.Join(", ", vanillaTilesheetRefs.Select(p => $"'{p.ImageSource}' (id: {p.Id})"))}], but found tilesheet '{vanillaSheet.Id}' at index {loadedIndex} instead of {vanillaSheet.Index}. Make sure custom tilesheet IDs are prefixed with 'z_' to avoid reordering tilesheets."
                             : $"mod has no tilesheet with ID '{vanillaSheet.Id}'. Map replacements must keep the original tilesheets to avoid errors or crashes.";
 
                         SCore.DeprecationManager.PlaceholderWarn("3.8.2", DeprecationLevel.PendingRemoval);
@@ -436,23 +434,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Find a map tilesheet by ID.</summary>
         /// <param name="map">The map whose tilesheets to search.</param>
         /// <param name="id">The tilesheet ID to match.</param>
-        /// <param name="index">The matched tilesheet index, if any.</param>
-        /// <param name="tilesheet">The matched tilesheet, if any.</param>
-        private bool TryFindTilesheet(Map map, string id, out int index, out TileSheet tilesheet)
+        private int TryFindTilesheet(Map map, string id)
         {
             for (int i = 0; i < map.TileSheets.Count; i++)
             {
                 if (map.TileSheets[i].Id == id)
-                {
-                    index = i;
-                    tilesheet = map.TileSheets[i];
-                    return true;
-                }
+                    return i;
             }
 
-            index = -1;
-            tilesheet = null;
-            return false;
+            return -1;
         }
     }
 }

From a179466e6b2800846bd425e2fe61de80d52d77bd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Jan 2021 00:44:24 -0500
Subject: [PATCH 039/856] remove experimental performance counters

Unfortunately this impacted SMAPI's memory usage and the data was often misinterpreted by players.
---
 docs/release-notes.md                         |   5 +-
 .../Framework/Commands/ArgumentParser.cs      |  50 --
 .../Other/PerformanceCounterCommand.cs        | 647 ------------------
 .../Framework/Commands/TrainerCommand.cs      |   5 +-
 src/SMAPI/Constants.cs                        |   3 -
 src/SMAPI/Framework/Events/EventManager.cs    |   6 +-
 src/SMAPI/Framework/Events/ManagedEvent.cs    |  44 +-
 .../PerformanceMonitoring/AlertContext.cs     |  34 -
 .../PerformanceMonitoring/AlertEntry.cs       |  38 -
 .../PerformanceMonitoring/PeakEntry.cs        |  35 -
 .../PerformanceCounter.cs                     | 124 ----
 .../PerformanceCounterCollection.cs           | 205 ------
 .../PerformanceCounterEntry.cs                |  30 -
 .../PerformanceMonitor.cs                     | 184 -----
 src/SMAPI/Framework/SCore.cs                  |  10 +-
 src/SMAPI/Properties/AssemblyInfo.cs          |   1 -
 16 files changed, 21 insertions(+), 1400 deletions(-)
 delete mode 100644 src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/PerformanceCounterCommand.cs
 delete mode 100644 src/SMAPI/Framework/PerformanceMonitoring/AlertContext.cs
 delete mode 100644 src/SMAPI/Framework/PerformanceMonitoring/AlertEntry.cs
 delete mode 100644 src/SMAPI/Framework/PerformanceMonitoring/PeakEntry.cs
 delete mode 100644 src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounter.cs
 delete mode 100644 src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounterCollection.cs
 delete mode 100644 src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounterEntry.cs
 delete mode 100644 src/SMAPI/Framework/PerformanceMonitoring/PerformanceMonitor.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9e2caba0..4c548924 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,10 @@
 
 ## Upcoming release
 * For players:
-  * Slightly reduced memory usage.
+  * Reduced memory usage.
+
+* For the Console Commands mod:
+  * Removed experimental `performance` command. Unfortunately this impacted SMAPI's memory usage and the data was often misinterpreted. This may be replaced with more automatic performance alerts in a future version.
 
 ## 3.8.2
 Released 03 January 2021 for Stardew Valley 1.5.1 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
index e84445d7..7e157c38 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections;
 using System.Collections.Generic;
-using System.Globalization;
 using System.Linq;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
@@ -107,38 +106,6 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
             return true;
         }
 
-        /// <summary>Try to read a decimal argument.</summary>
-        /// <param name="index">The argument index.</param>
-        /// <param name="name">The argument name for error messages.</param>
-        /// <param name="value">The parsed value.</param>
-        /// <param name="required">Whether to show an error if the argument is missing.</param>
-        /// <param name="min">The minimum value allowed.</param>
-        /// <param name="max">The maximum value allowed.</param>
-        public bool TryGetDecimal(int index, string name, out decimal value, bool required = true, decimal? min = null, decimal? max = null)
-        {
-            value = 0;
-
-            // get argument
-            if (!this.TryGet(index, name, out string raw, required))
-                return false;
-
-            // parse
-            if (!decimal.TryParse(raw, NumberStyles.Number, CultureInfo.InvariantCulture, out value))
-            {
-                this.LogDecimalFormatError(index, name, min, max);
-                return false;
-            }
-
-            // validate
-            if ((min.HasValue && value < min) || (max.HasValue && value > max))
-            {
-                this.LogDecimalFormatError(index, name, min, max);
-                return false;
-            }
-
-            return true;
-        }
-
         /// <summary>Returns an enumerator that iterates through the collection.</summary>
         /// <returns>An enumerator that can be used to iterate through the collection.</returns>
         public IEnumerator<string> GetEnumerator()
@@ -180,22 +147,5 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
             else
                 this.LogError($"Argument {index} ({name}) must be an integer.");
         }
-
-        /// <summary>Print an error for an invalid decimal argument.</summary>
-        /// <param name="index">The argument index.</param>
-        /// <param name="name">The argument name for error messages.</param>
-        /// <param name="min">The minimum value allowed.</param>
-        /// <param name="max">The maximum value allowed.</param>
-        private void LogDecimalFormatError(int index, string name, decimal? min, decimal? max)
-        {
-            if (min.HasValue && max.HasValue)
-                this.LogError($"Argument {index} ({name}) must be a decimal between {min} and {max}.");
-            else if (min.HasValue)
-                this.LogError($"Argument {index} ({name}) must be a decimal and at least {min}.");
-            else if (max.HasValue)
-                this.LogError($"Argument {index} ({name}) must be a decimal and at most {max}.");
-            else
-                this.LogError($"Argument {index} ({name}) must be a decimal.");
-        }
     }
 }
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/PerformanceCounterCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/PerformanceCounterCommand.cs
deleted file mode 100644
index 63851c9d..00000000
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/PerformanceCounterCommand.cs
+++ /dev/null
@@ -1,647 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using StardewModdingAPI.Framework;
-using StardewModdingAPI.Framework.PerformanceMonitoring;
-
-namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
-{
-    /// <summary>A set of commands which displays or configures performance monitoring.</summary>
-    internal class PerformanceCounterCommand : TrainerCommand
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The name of the command.</summary>
-        private const string CommandName = "performance";
-
-        /// <summary>The available commands.</summary>
-        private enum SubCommand
-        {
-            Summary,
-            Detail,
-            Reset,
-            Trigger,
-            Enable,
-            Disable,
-            Help
-        }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        public PerformanceCounterCommand()
-            : base(CommandName, PerformanceCounterCommand.GetDescription()) { }
-
-        /// <summary>Handle the command.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        /// <param name="command">The command name.</param>
-        /// <param name="args">The command arguments.</param>
-        public override void Handle(IMonitor monitor, string command, ArgumentParser args)
-        {
-            // parse args
-            SubCommand subcommand = SubCommand.Summary;
-            {
-                if (args.TryGet(0, "command", out string subcommandStr, false) && !Enum.TryParse(subcommandStr, ignoreCase: true, out subcommand))
-                {
-                    this.LogUsageError(monitor, $"Unknown command {subcommandStr}");
-                    return;
-                }
-            }
-
-            // handle
-            switch (subcommand)
-            {
-                case SubCommand.Summary:
-                    this.HandleSummarySubCommand(monitor, args);
-                    break;
-
-                case SubCommand.Detail:
-                    this.HandleDetailSubCommand(monitor, args);
-                    break;
-
-                case SubCommand.Reset:
-                    this.HandleResetSubCommand(monitor, args);
-                    break;
-
-                case SubCommand.Trigger:
-                    this.HandleTriggerSubCommand(monitor, args);
-                    break;
-
-                case SubCommand.Enable:
-                    SCore.PerformanceMonitor.EnableTracking = true;
-                    monitor.Log("Performance counter tracking is now enabled", LogLevel.Info);
-                    break;
-
-                case SubCommand.Disable:
-                    SCore.PerformanceMonitor.EnableTracking = false;
-                    monitor.Log("Performance counter tracking is now disabled", LogLevel.Info);
-                    break;
-
-                case SubCommand.Help:
-                    this.OutputHelp(monitor, args.TryGet(1, "command", out _) ? subcommand : null as SubCommand?);
-                    break;
-
-                default:
-                    this.LogUsageError(monitor, $"Unknown command {subcommand}");
-                    break;
-            }
-        }
-
-
-        /*********
-        ** Private methods
-        *********/
-        /// <summary>Handles the summary sub command.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        /// <param name="args">The command arguments.</param>
-        private void HandleSummarySubCommand(IMonitor monitor, ArgumentParser args)
-        {
-            if (!this.AssertEnabled(monitor))
-                return;
-
-            IEnumerable<PerformanceCounterCollection> data = SCore.PerformanceMonitor.GetCollections();
-
-            double? threshold = null;
-            if (args.TryGetDecimal(1, "threshold", out decimal t, required: false))
-                threshold = (double?)t;
-
-            TimeSpan interval = TimeSpan.FromSeconds(60);
-
-            StringBuilder report = new StringBuilder();
-            report.AppendLine($"Summary over the last {interval.TotalSeconds} seconds:");
-            report.AppendLine(this.GetTableString(
-                data: data,
-                header: new[] { "Collection", "Avg Calls/s", "Avg Exec Time (Game)", "Avg Exec Time (Mods)", "Avg Exec Time (Game+Mods)", "Peak Exec Time" },
-                getRow: item => new[]
-                {
-                    item.Name,
-                    item.GetAverageCallsPerSecond().ToString(),
-                    this.FormatMilliseconds(item.GetGameAverageExecutionTime(interval), threshold),
-                    this.FormatMilliseconds(item.GetModsAverageExecutionTime(interval), threshold),
-                    this.FormatMilliseconds(item.GetAverageExecutionTime(interval), threshold),
-                    this.FormatMilliseconds(item.GetPeakExecutionTime(interval), threshold)
-                },
-                true
-            ));
-
-            monitor.Log(report.ToString(), LogLevel.Info);
-        }
-
-        /// <summary>Handles the detail sub command.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        /// <param name="args">The command arguments.</param>
-        private void HandleDetailSubCommand(IMonitor monitor, ArgumentParser args)
-        {
-            if (!this.AssertEnabled(monitor))
-                return;
-
-            // parse args
-            double thresholdMilliseconds = 0;
-            if (args.TryGetDecimal(1, "threshold", out decimal t, required: false))
-                thresholdMilliseconds = (double)t;
-
-            // get collections
-            var collections = SCore.PerformanceMonitor.GetCollections();
-
-            // render
-            TimeSpan averageInterval = TimeSpan.FromSeconds(60);
-            StringBuilder report = new StringBuilder($"Showing details for performance counters of {thresholdMilliseconds}+ milliseconds:\n\n");
-            bool anyShown = false;
-            foreach (PerformanceCounterCollection collection in collections)
-            {
-                KeyValuePair<string, PerformanceCounter>[] data = collection.PerformanceCounters
-                    .Where(p => p.Value.GetAverage(averageInterval) >= thresholdMilliseconds)
-                    .ToArray();
-
-                if (data.Any())
-                {
-                    anyShown = true;
-                    report.AppendLine($"{collection.Name}:");
-                    report.AppendLine(this.GetTableString(
-                        data: data,
-                        header: new[] { "Mod", $"Avg Exec Time (last {(int)averageInterval.TotalSeconds}s)", "Last Exec Time", "Peak Exec Time", $"Peak Exec Time (last {(int)averageInterval.TotalSeconds}s)" },
-                        getRow: item => new[]
-                        {
-                            item.Key,
-                            this.FormatMilliseconds(item.Value.GetAverage(averageInterval), thresholdMilliseconds),
-                            this.FormatMilliseconds(item.Value.GetLastEntry()?.ElapsedMilliseconds),
-                            this.FormatMilliseconds(item.Value.GetPeak()?.ElapsedMilliseconds),
-                            this.FormatMilliseconds(item.Value.GetPeak(averageInterval)?.ElapsedMilliseconds)
-                        },
-                        true
-                    ));
-                }
-            }
-
-            if (!anyShown)
-                report.AppendLine("No performance counters found.");
-
-            monitor.Log(report.ToString(), LogLevel.Info);
-        }
-
-        /// <summary>Handles the trigger sub command.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        /// <param name="args">The command arguments.</param>
-        private void HandleTriggerSubCommand(IMonitor monitor, ArgumentParser args)
-        {
-            if (!this.AssertEnabled(monitor))
-                return;
-
-            if (args.TryGet(1, "mode", out string mode, false))
-            {
-                switch (mode)
-                {
-                    case "list":
-                        this.OutputAlertTriggers(monitor);
-                        break;
-
-                    case "collection":
-                        if (args.TryGet(2, "name", out string collectionName))
-                        {
-                            if (args.TryGetDecimal(3, "threshold", out decimal threshold))
-                            {
-                                if (!args.TryGet(4, "source", out string source, required: false))
-                                    source = null;
-                                this.ConfigureAlertTrigger(monitor, collectionName, source, threshold);
-                            }
-                        }
-                        break;
-
-                    case "pause":
-                        SCore.PerformanceMonitor.PauseAlerts = true;
-                        monitor.Log("Alerts are now paused.", LogLevel.Info);
-                        break;
-
-                    case "resume":
-                        SCore.PerformanceMonitor.PauseAlerts = false;
-                        monitor.Log("Alerts are now resumed.", LogLevel.Info);
-                        break;
-
-                    case "dump":
-                        this.OutputAlertTriggers(monitor, true);
-                        break;
-
-                    case "clear":
-                        this.ClearAlertTriggers(monitor);
-                        break;
-
-                    default:
-                        this.LogUsageError(monitor, $"Unknown mode {mode}. See '{CommandName} help trigger' for usage.");
-                        break;
-                }
-            }
-            else
-                this.OutputAlertTriggers(monitor);
-        }
-
-        /// <summary>Sets up an an alert trigger.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        /// <param name="collectionName">The name of the collection.</param>
-        /// <param name="sourceName">The name of the source, or null for all sources.</param>
-        /// <param name="threshold">The trigger threshold, or 0 to remove.</param>
-        private void ConfigureAlertTrigger(IMonitor monitor, string collectionName, string sourceName, decimal threshold)
-        {
-            foreach (PerformanceCounterCollection collection in SCore.PerformanceMonitor.GetCollections())
-            {
-                if (collection.Name.ToLowerInvariant().Equals(collectionName.ToLowerInvariant()))
-                {
-                    if (sourceName == null)
-                    {
-                        if (threshold != 0)
-                        {
-                            collection.EnableAlerts = true;
-                            collection.AlertThresholdMilliseconds = (double)threshold;
-                            monitor.Log($"Set up alert triggering for '{collectionName}' with '{this.FormatMilliseconds((double?)threshold)}'", LogLevel.Info);
-                        }
-                        else
-                        {
-                            collection.EnableAlerts = false;
-                            monitor.Log($"Cleared alert triggering for '{collection}'.");
-                        }
-
-                        return;
-                    }
-                    else
-                    {
-                        foreach (var performanceCounter in collection.PerformanceCounters)
-                        {
-                            if (performanceCounter.Value.Source.ToLowerInvariant().Equals(sourceName.ToLowerInvariant()))
-                            {
-                                if (threshold != 0)
-                                {
-                                    performanceCounter.Value.EnableAlerts = true;
-                                    performanceCounter.Value.AlertThresholdMilliseconds = (double)threshold;
-                                    monitor.Log($"Set up alert triggering for '{sourceName}' in collection '{collectionName}' with '{this.FormatMilliseconds((double?)threshold)}", LogLevel.Info);
-                                }
-                                else
-                                    performanceCounter.Value.EnableAlerts = false;
-                                return;
-                            }
-                        }
-
-                        monitor.Log($"Could not find the source '{sourceName}' in collection '{collectionName}'", LogLevel.Warn);
-                        return;
-                    }
-                }
-            }
-
-            monitor.Log($"Could not find the collection '{collectionName}'", LogLevel.Warn);
-        }
-
-
-        /// <summary>Clears alert triggering for all collections.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        private void ClearAlertTriggers(IMonitor monitor)
-        {
-            int clearedTriggers = 0;
-            foreach (PerformanceCounterCollection collection in SCore.PerformanceMonitor.GetCollections())
-            {
-                if (collection.EnableAlerts)
-                {
-                    collection.EnableAlerts = false;
-                    clearedTriggers++;
-                }
-
-                foreach (var performanceCounter in collection.PerformanceCounters)
-                {
-                    if (performanceCounter.Value.EnableAlerts)
-                    {
-                        performanceCounter.Value.EnableAlerts = false;
-                        clearedTriggers++;
-                    }
-                }
-
-            }
-
-            monitor.Log($"Cleared {clearedTriggers} alert triggers.", LogLevel.Info);
-        }
-
-        /// <summary>Lists all configured alert triggers.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        /// <param name="asDump">True to dump the triggers as commands.</param>
-        private void OutputAlertTriggers(IMonitor monitor, bool asDump = false)
-        {
-            StringBuilder report = new StringBuilder();
-            report.AppendLine("Configured triggers:");
-            report.AppendLine();
-            var collectionTriggers = new List<CollectionTrigger>();
-            var sourceTriggers = new List<SourceTrigger>();
-
-            foreach (PerformanceCounterCollection collection in SCore.PerformanceMonitor.GetCollections())
-            {
-                if (collection.EnableAlerts)
-                    collectionTriggers.Add(new CollectionTrigger(collection.Name, collection.AlertThresholdMilliseconds));
-
-                sourceTriggers.AddRange(
-                    from counter in collection.PerformanceCounters
-                    where counter.Value.EnableAlerts
-                    select new SourceTrigger(collection.Name, counter.Value.Source, counter.Value.AlertThresholdMilliseconds)
-                );
-            }
-
-            if (collectionTriggers.Count > 0)
-            {
-                report.AppendLine("Collection Triggers:");
-                report.AppendLine();
-
-                if (asDump)
-                {
-                    foreach (var item in collectionTriggers)
-                        report.AppendLine($"{CommandName} trigger {item.CollectionName} {item.Threshold}");
-                }
-                else
-                {
-                    report.AppendLine(this.GetTableString(
-                        data: collectionTriggers,
-                        header: new[] { "Collection", "Threshold" },
-                        getRow: item => new[] { item.CollectionName, this.FormatMilliseconds(item.Threshold) },
-                        true
-                    ));
-                }
-
-                report.AppendLine();
-            }
-            else
-                report.AppendLine("No collection triggers.");
-
-            if (sourceTriggers.Count > 0)
-            {
-                report.AppendLine("Source Triggers:");
-                report.AppendLine();
-
-                if (asDump)
-                {
-                    foreach (SourceTrigger item in sourceTriggers)
-                        report.AppendLine($"{CommandName} trigger {item.CollectionName} {item.Threshold} {item.SourceName}");
-                }
-                else
-                {
-                    report.AppendLine(this.GetTableString(
-                        data: sourceTriggers,
-                        header: new[] { "Collection", "Source", "Threshold" },
-                        getRow: item => new[] { item.CollectionName, item.SourceName, this.FormatMilliseconds(item.Threshold) },
-                        true
-                    ));
-                }
-
-                report.AppendLine();
-            }
-            else
-                report.AppendLine("No source triggers.");
-
-            monitor.Log(report.ToString(), LogLevel.Info);
-        }
-
-        /// <summary>Handles the reset sub command.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        /// <param name="args">The command arguments.</param>
-        private void HandleResetSubCommand(IMonitor monitor, ArgumentParser args)
-        {
-            if (!this.AssertEnabled(monitor))
-                return;
-
-            if (args.TryGet(1, "type", out string type, false, new[] { "category", "source" }))
-            {
-                args.TryGet(2, "name", out string name);
-
-                switch (type)
-                {
-                    case "category":
-                        SCore.PerformanceMonitor.ResetCollection(name);
-                        monitor.Log($"All performance counters for category {name} are now cleared.", LogLevel.Info);
-                        break;
-                    case "source":
-                        SCore.PerformanceMonitor.ResetSource(name);
-                        monitor.Log($"All performance counters for source {name} are now cleared.", LogLevel.Info);
-                        break;
-                }
-            }
-            else
-            {
-                SCore.PerformanceMonitor.Reset();
-                monitor.Log("All performance counters are now cleared.", LogLevel.Info);
-            }
-        }
-
-        /// <summary>Formats the given milliseconds value into a string format. Optionally
-        /// allows a threshold to return "-" if the value is less than the threshold.</summary>
-        /// <param name="milliseconds">The milliseconds to format. Returns "-" if null</param>
-        /// <param name="thresholdMilliseconds">The threshold. Any value below this is returned as "-".</param>
-        /// <returns>The formatted milliseconds.</returns>
-        private string FormatMilliseconds(double? milliseconds, double? thresholdMilliseconds = null)
-        {
-            thresholdMilliseconds ??= 1;
-            return milliseconds != null && milliseconds >= thresholdMilliseconds
-                   ? ((double)milliseconds).ToString("F2")
-                   : "-";
-        }
-
-        /// <summary>Shows detailed help for a specific sub command.</summary>
-        /// <param name="monitor">The output monitor.</param>
-        /// <param name="subcommand">The subcommand.</param>
-        private void OutputHelp(IMonitor monitor, SubCommand? subcommand)
-        {
-            StringBuilder report = new StringBuilder();
-            report.AppendLine();
-
-            switch (subcommand)
-            {
-                case SubCommand.Detail:
-                    report.AppendLine($"       {CommandName} detail <threshold>");
-                    report.AppendLine();
-                    report.AppendLine("Displays details for a specific collection.");
-                    report.AppendLine();
-                    report.AppendLine("Arguments:");
-                    report.AppendLine("  <threshold>   Optional. The threshold in milliseconds. Any average execution time below that");
-                    report.AppendLine("                threshold is not reported.");
-                    report.AppendLine();
-                    report.AppendLine("Examples:");
-                    report.AppendLine($"{CommandName} detail 5     Show counters exceeding an average of 5ms");
-                    break;
-
-                case SubCommand.Summary:
-                    report.AppendLine($"Usage: {CommandName} summary <threshold>");
-                    report.AppendLine();
-                    report.AppendLine("Displays the performance counter summary.");
-                    report.AppendLine();
-                    report.AppendLine("Arguments:");
-                    report.AppendLine("  <threshold> Optional. Hides the actual execution time if it's below this threshold");
-                    report.AppendLine();
-                    report.AppendLine("Examples:");
-                    report.AppendLine($"{CommandName} summary       Show all events");
-                    report.AppendLine($"{CommandName} summary 5     Shows events exceeding an average of 5ms");
-                    break;
-
-                case SubCommand.Trigger:
-                    report.AppendLine($"Usage: {CommandName} trigger <mode>");
-                    report.AppendLine($"Usage: {CommandName} trigger collection <collectionName> <threshold>");
-                    report.AppendLine($"Usage: {CommandName} trigger collection <collectionName> <threshold> <sourceName>");
-                    report.AppendLine();
-                    report.AppendLine("Manages alert triggers.");
-                    report.AppendLine();
-                    report.AppendLine("Arguments:");
-                    report.AppendLine("  <mode>           Optional. Specifies if a specific source or a specific collection should be triggered.");
-                    report.AppendLine("                   - list        Lists current triggers");
-                    report.AppendLine("                   - collection  Sets up a trigger for a collection");
-                    report.AppendLine("                   - clear       Clears all trigger entries");
-                    report.AppendLine("                   - pause       Pauses triggering of alerts");
-                    report.AppendLine("                   - resume      Resumes triggering of alerts");
-                    report.AppendLine("                   - dump        Dumps all triggers as commands for copy and paste");
-                    report.AppendLine("                   Defaults to 'list' if not specified.");
-                    report.AppendLine();
-                    report.AppendLine("  <collectionName> Required if the mode 'collection' is specified.");
-                    report.AppendLine("                   Specifies the name of the collection to be triggered. Must be an exact match.");
-                    report.AppendLine();
-                    report.AppendLine("  <sourceName>     Optional. Specifies the name of a specific source. Must be an exact match.");
-                    report.AppendLine();
-                    report.AppendLine("  <threshold>      Required if the mode 'collection' is specified.");
-                    report.AppendLine("                   Specifies the threshold in milliseconds (fractions allowed).");
-                    report.AppendLine("                   Specify '0' to remove the threshold.");
-                    report.AppendLine();
-                    report.AppendLine("Examples:");
-                    report.AppendLine();
-                    report.AppendLine($"{CommandName} trigger collection Display.Rendering 10");
-                    report.AppendLine("  Sets up an alert trigger which writes on the console if the execution time of all performance counters in");
-                    report.AppendLine("  the 'Display.Rendering' collection exceed 10 milliseconds.");
-                    report.AppendLine();
-                    report.AppendLine($"{CommandName} trigger collection Display.Rendering 5 Pathoschild.ChestsAnywhere");
-                    report.AppendLine("  Sets up an alert trigger to write on the console if the execution time of Pathoschild.ChestsAnywhere in");
-                    report.AppendLine("  the 'Display.Rendering' collection exceed 5 milliseconds.");
-                    report.AppendLine();
-                    report.AppendLine($"{CommandName} trigger collection Display.Rendering 0");
-                    report.AppendLine("  Removes the threshold previously defined from the collection. Note that source-specific thresholds are left intact.");
-                    report.AppendLine();
-                    report.AppendLine($"{CommandName} trigger clear");
-                    report.AppendLine("  Clears all previously setup alert triggers.");
-                    break;
-
-                case SubCommand.Reset:
-                    report.AppendLine($"Usage: {CommandName} reset <type> <name>");
-                    report.AppendLine();
-                    report.AppendLine("Resets performance counters.");
-                    report.AppendLine();
-                    report.AppendLine("Arguments:");
-                    report.AppendLine("  <type>  Optional. Specifies if a collection or source should be reset.");
-                    report.AppendLine("          If omitted, all performance counters are reset.");
-                    report.AppendLine();
-                    report.AppendLine("          - source     Clears performance counters for a specific source");
-                    report.AppendLine("          - collection Clears performance counters for a specific collection");
-                    report.AppendLine();
-                    report.AppendLine("  <name>  Required if a <type> is given. Specifies the name of either the collection");
-                    report.AppendLine("          or the source. The name must be an exact match.");
-                    report.AppendLine();
-                    report.AppendLine("Examples:");
-                    report.AppendLine($"{CommandName} reset                                    Resets all performance counters");
-                    report.AppendLine($"{CommandName} reset source Pathoschild.ChestsAnywhere  Resets all performance for the source named Pathoschild.ChestsAnywhere");
-                    report.AppendLine($"{CommandName} reset collection Display.Rendering       Resets all performance for the collection named Display.Rendering");
-                    break;
-            }
-
-            report.AppendLine();
-            monitor.Log(report.ToString(), LogLevel.Info);
-        }
-
-        /// <summary>Get the command description.</summary>
-        private static string GetDescription()
-        {
-            StringBuilder report = new StringBuilder();
-
-            report.AppendLine("Displays or configures performance monitoring to diagnose issues. Performance monitoring is disabled by default.");
-            report.AppendLine();
-            report.AppendLine("For example, the counter collection named 'Display.Rendered' contains one performance");
-            report.AppendLine("counter when the game executes the 'Display.Rendered' event, and another counter for each mod which handles it.");
-            report.AppendLine();
-            report.AppendLine($"Usage: {CommandName} <command> <action>");
-            report.AppendLine();
-            report.AppendLine("Commands:");
-            report.AppendLine();
-            report.AppendLine("  summary    Show a summary of collections.");
-            report.AppendLine("  detail     Show a summary for a given collection.");
-            report.AppendLine("  reset      Reset all performance counters.");
-            report.AppendLine("  trigger    Configure alert triggers.");
-            report.AppendLine("  enable     Enable performance counter recording.");
-            report.AppendLine("  disable    Disable performance counter recording.");
-            report.AppendLine("  help       Show verbose help for the available commands.");
-            report.AppendLine();
-            report.AppendLine($"To get help for a specific command, use '{CommandName} help <command>', for example:");
-            report.AppendLine($"{CommandName} help summary");
-            report.AppendLine();
-            report.AppendLine("Defaults to summary if no command is given.");
-            report.AppendLine();
-
-            return report.ToString();
-        }
-
-        /// <summary>Log a warning if performance monitoring isn't enabled.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        /// <returns>Returns whether performance monitoring is enabled.</returns>
-        private bool AssertEnabled(IMonitor monitor)
-        {
-            if (!SCore.PerformanceMonitor.EnableTracking)
-            {
-                monitor.Log($"Performance monitoring is currently disabled; enter '{CommandName} enable' to enable it.", LogLevel.Warn);
-                return false;
-            }
-
-            return true;
-        }
-
-
-        /*********
-        ** Private models
-        *********/
-        /// <summary>An alert trigger for a collection.</summary>
-        private class CollectionTrigger
-        {
-            /*********
-            ** Accessors
-            *********/
-            /// <summary>The collection name.</summary>
-            public string CollectionName { get; }
-
-            /// <summary>The trigger threshold.</summary>
-            public double Threshold { get; }
-
-
-            /*********
-            ** Public methods
-            *********/
-            /// <summary>Construct an instance.</summary>
-            /// <param name="collectionName">The collection name.</param>
-            /// <param name="threshold">The trigger threshold.</param>
-            public CollectionTrigger(string collectionName, double threshold)
-            {
-                this.CollectionName = collectionName;
-                this.Threshold = threshold;
-            }
-        }
-
-        /// <summary>An alert triggered for a source.</summary>
-        private class SourceTrigger : CollectionTrigger
-        {
-            /*********
-            ** Accessors
-            *********/
-            /// <summary>The source name.</summary>
-            public string SourceName { get; }
-
-
-            /*********
-            ** Public methods
-            *********/
-            /// <summary>Construct an instance.</summary>
-            /// <param name="collectionName">The collection name.</param>
-            /// <param name="sourceName">The source name.</param>
-            /// <param name="threshold">The trigger threshold.</param>
-            public SourceTrigger(string collectionName, string sourceName, double threshold)
-                : base(collectionName, threshold)
-            {
-                this.SourceName = sourceName;
-            }
-        }
-    }
-}
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/TrainerCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/TrainerCommand.cs
index 77a26c6a..98daa906 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/TrainerCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/TrainerCommand.cs
@@ -78,8 +78,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
         /// <param name="data">The data to display.</param>
         /// <param name="header">The table header.</param>
         /// <param name="getRow">Returns a set of fields for a data value.</param>
-        /// <param name="rightAlign">Whether to right-align the data.</param>
-        protected string GetTableString<T>(IEnumerable<T> data, string[] header, Func<T, string[]> getRow, bool rightAlign = false)
+        protected string GetTableString<T>(IEnumerable<T> data, string[] header, Func<T, string[]> getRow)
         {
             // get table data
             int[] widths = header.Select(p => p.Length).ToArray();
@@ -108,7 +107,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
             return string.Join(
                 Environment.NewLine,
                 lines.Select(line => string.Join(" | ",
-                    line.Select((field, i) => rightAlign ? field.PadRight(widths[i], ' ') : field.PadLeft(widths[i], ' '))
+                    line.Select((field, i) => field.PadLeft(widths[i], ' '))
                 ))
             );
         }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index ef996c0f..9816013c 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -97,9 +97,6 @@ namespace StardewModdingAPI
         /// <summary>The URL of the SMAPI home page.</summary>
         internal const string HomePageUrl = "https://smapi.io";
 
-        /// <summary>The default performance counter name for unknown event handlers.</summary>
-        internal const string GamePerformanceCounterName = "<StardewValley>";
-
         /// <summary>The absolute path to the folder containing SMAPI's internal files.</summary>
         internal static readonly string InternalFilesPath = EarlyConstants.InternalFilesPath;
 
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index 9092669f..665dbfe3 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -2,7 +2,6 @@ using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
 using StardewModdingAPI.Events;
-using StardewModdingAPI.Framework.PerformanceMonitoring;
 
 namespace StardewModdingAPI.Framework.Events
 {
@@ -178,13 +177,12 @@ namespace StardewModdingAPI.Framework.Events
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="modRegistry">The mod registry with which to identify mods.</param>
-        /// <param name="performanceMonitor">Tracks performance metrics.</param>
-        public EventManager(ModRegistry modRegistry, PerformanceMonitor performanceMonitor)
+        public EventManager(ModRegistry modRegistry)
         {
             // create shortcut initializers
             ManagedEvent<TEventArgs> ManageEventOf<TEventArgs>(string typeName, string eventName, bool isPerformanceCritical = false)
             {
-                return new ManagedEvent<TEventArgs>($"{typeName}.{eventName}", modRegistry, performanceMonitor, isPerformanceCritical);
+                return new ManagedEvent<TEventArgs>($"{typeName}.{eventName}", modRegistry, isPerformanceCritical);
             }
 
             // init events (new)
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index f2dfb2ab..2204966c 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -3,7 +3,6 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
 using StardewModdingAPI.Events;
-using StardewModdingAPI.Framework.PerformanceMonitoring;
 
 namespace StardewModdingAPI.Framework.Events
 {
@@ -17,9 +16,6 @@ namespace StardewModdingAPI.Framework.Events
         /// <summary>The mod registry with which to identify mods.</summary>
         protected readonly ModRegistry ModRegistry;
 
-        /// <summary>Tracks performance metrics.</summary>
-        private readonly PerformanceMonitor PerformanceMonitor;
-
         /// <summary>The underlying event handlers.</summary>
         private readonly List<ManagedEventHandler<TEventArgs>> Handlers = new List<ManagedEventHandler<TEventArgs>>();
 
@@ -49,13 +45,11 @@ namespace StardewModdingAPI.Framework.Events
         /// <summary>Construct an instance.</summary>
         /// <param name="eventName">A human-readable name for the event.</param>
         /// <param name="modRegistry">The mod registry with which to identify mods.</param>
-        /// <param name="performanceMonitor">Tracks performance metrics.</param>
         /// <param name="isPerformanceCritical">Whether the event is typically called at least once per second.</param>
-        public ManagedEvent(string eventName, ModRegistry modRegistry, PerformanceMonitor performanceMonitor, bool isPerformanceCritical = false)
+        public ManagedEvent(string eventName, ModRegistry modRegistry, bool isPerformanceCritical = false)
         {
             this.EventName = eventName;
             this.ModRegistry = modRegistry;
-            this.PerformanceMonitor = performanceMonitor;
             this.IsPerformanceCritical = isPerformanceCritical;
         }
 
@@ -126,40 +120,26 @@ namespace StardewModdingAPI.Framework.Events
             }
 
             // raise event
-            this.PerformanceMonitor.Track(this.EventName, () =>
+            foreach (ManagedEventHandler<TEventArgs> handler in handlers)
             {
-                foreach (ManagedEventHandler<TEventArgs> handler in handlers)
-                {
-                    if (match != null && !match(handler.SourceMod))
-                        continue;
+                if (match != null && !match(handler.SourceMod))
+                    continue;
 
-                    try
-                    {
-                        this.PerformanceMonitor.Track(this.EventName, this.GetModNameForPerformanceCounters(handler), () => handler.Handler.Invoke(null, args));
-                    }
-                    catch (Exception ex)
-                    {
-                        this.LogError(handler, ex);
-                    }
+                try
+                {
+                    handler.Handler.Invoke(null, args);
                 }
-            });
+                catch (Exception ex)
+                {
+                    this.LogError(handler, ex);
+                }
+            }
         }
 
 
         /*********
         ** Private methods
         *********/
-        /// <summary>Get the mod name for a given event handler to display in performance monitoring reports.</summary>
-        /// <param name="handler">The event handler.</param>
-        private string GetModNameForPerformanceCounters(ManagedEventHandler<TEventArgs> handler)
-        {
-            IModMetadata mod = handler.SourceMod;
-
-            return mod.HasManifest()
-                ? mod.Manifest.UniqueID
-                : mod.DisplayName;
-        }
-
         /// <summary>Log an exception from an event handler.</summary>
         /// <param name="handler">The event handler instance.</param>
         /// <param name="ex">The exception that was raised.</param>
diff --git a/src/SMAPI/Framework/PerformanceMonitoring/AlertContext.cs b/src/SMAPI/Framework/PerformanceMonitoring/AlertContext.cs
deleted file mode 100644
index af630055..00000000
--- a/src/SMAPI/Framework/PerformanceMonitoring/AlertContext.cs
+++ /dev/null
@@ -1,34 +0,0 @@
-namespace StardewModdingAPI.Framework.PerformanceMonitoring
-{
-    /// <summary>The context for an alert.</summary>
-    internal readonly struct AlertContext
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The source which triggered the alert.</summary>
-        public string Source { get; }
-
-        /// <summary>The elapsed milliseconds.</summary>
-        public double Elapsed { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="source">The source which triggered the alert.</param>
-        /// <param name="elapsed">The elapsed milliseconds.</param>
-        public AlertContext(string source, double elapsed)
-        {
-            this.Source = source;
-            this.Elapsed = elapsed;
-        }
-
-        /// <summary>Get a human-readable text form of this instance.</summary>
-        public override string ToString()
-        {
-            return $"{this.Source}: {this.Elapsed:F2}ms";
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/PerformanceMonitoring/AlertEntry.cs b/src/SMAPI/Framework/PerformanceMonitoring/AlertEntry.cs
deleted file mode 100644
index d5a0b343..00000000
--- a/src/SMAPI/Framework/PerformanceMonitoring/AlertEntry.cs
+++ /dev/null
@@ -1,38 +0,0 @@
-namespace StardewModdingAPI.Framework.PerformanceMonitoring
-{
-    /// <summary>A single alert entry.</summary>
-    internal readonly struct AlertEntry
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The collection in which the alert occurred.</summary>
-        public PerformanceCounterCollection Collection { get; }
-
-        /// <summary>The actual execution time in milliseconds.</summary>
-        public double ExecutionTimeMilliseconds { get; }
-
-        /// <summary>The configured alert threshold in milliseconds.</summary>
-        public double ThresholdMilliseconds { get; }
-
-        /// <summary>The sources involved in exceeding the threshold.</summary>
-        public AlertContext[] Context { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="collection">The collection in which the alert occurred.</param>
-        /// <param name="executionTimeMilliseconds">The actual execution time in milliseconds.</param>
-        /// <param name="thresholdMilliseconds">The configured alert threshold in milliseconds.</param>
-        /// <param name="context">The sources involved in exceeding the threshold.</param>
-        public AlertEntry(PerformanceCounterCollection collection, double executionTimeMilliseconds, double thresholdMilliseconds, AlertContext[] context)
-        {
-            this.Collection = collection;
-            this.ExecutionTimeMilliseconds = executionTimeMilliseconds;
-            this.ThresholdMilliseconds = thresholdMilliseconds;
-            this.Context = context;
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/PerformanceMonitoring/PeakEntry.cs b/src/SMAPI/Framework/PerformanceMonitoring/PeakEntry.cs
deleted file mode 100644
index 1746e358..00000000
--- a/src/SMAPI/Framework/PerformanceMonitoring/PeakEntry.cs
+++ /dev/null
@@ -1,35 +0,0 @@
-using System;
-
-namespace StardewModdingAPI.Framework.PerformanceMonitoring
-{
-    /// <summary>A peak invocation time.</summary>
-    internal readonly struct PeakEntry
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The actual execution time in milliseconds.</summary>
-        public double ExecutionTimeMilliseconds { get; }
-
-        /// <summary>When the entry occurred.</summary>
-        public DateTime EventTime { get; }
-
-        /// <summary>The sources involved in exceeding the threshold.</summary>
-        public AlertContext[] Context { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="executionTimeMilliseconds">The actual execution time in milliseconds.</param>
-        /// <param name="eventTime">When the entry occurred.</param>
-        /// <param name="context">The sources involved in exceeding the threshold.</param>
-        public PeakEntry(double executionTimeMilliseconds, DateTime eventTime, AlertContext[] context)
-        {
-            this.ExecutionTimeMilliseconds = executionTimeMilliseconds;
-            this.EventTime = eventTime;
-            this.Context = context;
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounter.cs b/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounter.cs
deleted file mode 100644
index 42825999..00000000
--- a/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounter.cs
+++ /dev/null
@@ -1,124 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-
-namespace StardewModdingAPI.Framework.PerformanceMonitoring
-{
-    /// <summary>Tracks metadata about a particular code event.</summary>
-    internal class PerformanceCounter
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The size of the ring buffer.</summary>
-        private readonly int MaxEntries = 16384;
-
-        /// <summary>The collection to which this performance counter belongs.</summary>
-        private readonly PerformanceCounterCollection ParentCollection;
-
-        /// <summary>The performance counter entries.</summary>
-        private readonly Stack<PerformanceCounterEntry> Entries;
-
-        /// <summary>The entry with the highest execution time.</summary>
-        private PerformanceCounterEntry? PeakPerformanceCounterEntry;
-
-
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The name of the source.</summary>
-        public string Source { get; }
-
-        /// <summary>The alert threshold in milliseconds</summary>
-        public double AlertThresholdMilliseconds { get; set; }
-
-        /// <summary>If alerting is enabled or not</summary>
-        public bool EnableAlerts { get; set; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="parentCollection">The collection to which this performance counter belongs.</param>
-        /// <param name="source">The name of the source.</param>
-        public PerformanceCounter(PerformanceCounterCollection parentCollection, string source)
-        {
-            this.ParentCollection = parentCollection;
-            this.Source = source;
-            this.Entries = new Stack<PerformanceCounterEntry>(this.MaxEntries);
-        }
-
-        /// <summary>Add a performance counter entry to the list, update monitoring, and raise alerts if needed.</summary>
-        /// <param name="entry">The entry to add.</param>
-        public void Add(PerformanceCounterEntry entry)
-        {
-            // add entry
-            if (this.Entries.Count > this.MaxEntries)
-                this.Entries.Pop();
-            this.Entries.Push(entry);
-
-            // update metrics
-            if (this.PeakPerformanceCounterEntry == null || entry.ElapsedMilliseconds > this.PeakPerformanceCounterEntry.Value.ElapsedMilliseconds)
-                this.PeakPerformanceCounterEntry = entry;
-
-            // raise alert
-            if (this.EnableAlerts && entry.ElapsedMilliseconds > this.AlertThresholdMilliseconds)
-                this.ParentCollection.AddAlert(entry.ElapsedMilliseconds, this.AlertThresholdMilliseconds, new AlertContext(this.Source, entry.ElapsedMilliseconds));
-        }
-
-        /// <summary>Clear all performance counter entries and monitoring.</summary>
-        public void Reset()
-        {
-            this.Entries.Clear();
-            this.PeakPerformanceCounterEntry = null;
-        }
-
-        /// <summary>Get the peak entry.</summary>
-        public PerformanceCounterEntry? GetPeak()
-        {
-            return this.PeakPerformanceCounterEntry;
-        }
-
-        /// <summary>Get the entry with the highest execution time.</summary>
-        /// <param name="range">The time range to search.</param>
-        /// <param name="endTime">The end time for the <paramref name="range"/>, or null for the current time.</param>
-        public PerformanceCounterEntry? GetPeak(TimeSpan range, DateTime? endTime = null)
-        {
-            endTime ??= DateTime.UtcNow;
-            DateTime startTime = endTime.Value.Subtract(range);
-
-            return this.Entries
-                .Where(entry => entry.EventTime >= startTime && entry.EventTime <= endTime)
-                .OrderByDescending(x => x.ElapsedMilliseconds)
-                .FirstOrDefault();
-        }
-
-        /// <summary>Get the last entry added to the list.</summary>
-        public PerformanceCounterEntry? GetLastEntry()
-        {
-            if (this.Entries.Count == 0)
-                return null;
-
-            return this.Entries.Peek();
-        }
-
-        /// <summary>Get the average over a given time span.</summary>
-        /// <param name="range">The time range to search.</param>
-        /// <param name="endTime">The end time for the <paramref name="range"/>, or null for the current time.</param>
-        public double GetAverage(TimeSpan range, DateTime? endTime = null)
-        {
-            endTime ??= DateTime.UtcNow;
-            DateTime startTime = endTime.Value.Subtract(range);
-
-            double[] entries = this.Entries
-                .Where(entry => entry.EventTime >= startTime && entry.EventTime <= endTime)
-                .Select(p => p.ElapsedMilliseconds)
-                .ToArray();
-
-            return entries.Length > 0
-                ? entries.Average()
-                : 0;
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounterCollection.cs b/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounterCollection.cs
deleted file mode 100644
index 29a06794..00000000
--- a/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounterCollection.cs
+++ /dev/null
@@ -1,205 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.Linq;
-
-namespace StardewModdingAPI.Framework.PerformanceMonitoring
-{
-    internal class PerformanceCounterCollection
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The number of peak invocations to keep.</summary>
-        private readonly int MaxEntries = 16384;
-
-        /// <summary>The sources involved in exceeding alert thresholds.</summary>
-        private readonly List<AlertContext> TriggeredPerformanceCounters = new List<AlertContext>();
-
-        /// <summary>The stopwatch used to track the invocation time.</summary>
-        private readonly Stopwatch InvocationStopwatch = new Stopwatch();
-
-        /// <summary>The performance counter manager.</summary>
-        private readonly PerformanceMonitor PerformanceMonitor;
-
-        /// <summary>The time to calculate average calls per second.</summary>
-        private DateTime CallsPerSecondStart = DateTime.UtcNow;
-
-        /// <summary>The number of invocations.</summary>
-        private long CallCount;
-
-        /// <summary>The peak invocations.</summary>
-        private readonly Stack<PeakEntry> PeakInvocations;
-
-
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The associated performance counters.</summary>
-        public IDictionary<string, PerformanceCounter> PerformanceCounters { get; } = new Dictionary<string, PerformanceCounter>();
-
-        /// <summary>The name of this collection.</summary>
-        public string Name { get; }
-
-        /// <summary>Whether the source is typically invoked at least once per second.</summary>
-        public bool IsPerformanceCritical { get; }
-
-        /// <summary>The alert threshold in milliseconds.</summary>
-        public double AlertThresholdMilliseconds { get; set; }
-
-        /// <summary>Whether alerts are enabled.</summary>
-        public bool EnableAlerts { get; set; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="performanceMonitor">The performance counter manager.</param>
-        /// <param name="name">The name of this collection.</param>
-        /// <param name="isPerformanceCritical">Whether the source is typically invoked at least once per second.</param>
-        public PerformanceCounterCollection(PerformanceMonitor performanceMonitor, string name, bool isPerformanceCritical = false)
-        {
-            this.PeakInvocations = new Stack<PeakEntry>(this.MaxEntries);
-            this.Name = name;
-            this.PerformanceMonitor = performanceMonitor;
-            this.IsPerformanceCritical = isPerformanceCritical;
-        }
-
-        /// <summary>Track a single invocation for a named source.</summary>
-        /// <param name="source">The name of the source.</param>
-        /// <param name="entry">The entry.</param>
-        public void Track(string source, PerformanceCounterEntry entry)
-        {
-            // add entry
-            if (!this.PerformanceCounters.ContainsKey(source))
-                this.PerformanceCounters.Add(source, new PerformanceCounter(this, source));
-            this.PerformanceCounters[source].Add(entry);
-
-            // raise alert
-            if (this.EnableAlerts)
-                this.TriggeredPerformanceCounters.Add(new AlertContext(source, entry.ElapsedMilliseconds));
-        }
-
-        /// <summary>Get the average execution time for all non-game internal sources in milliseconds.</summary>
-        /// <param name="interval">The interval for which to get the average, relative to now</param>
-        public double GetModsAverageExecutionTime(TimeSpan interval)
-        {
-            return this.PerformanceCounters
-                .Where(entry => entry.Key != Constants.GamePerformanceCounterName)
-                .Sum(entry => entry.Value.GetAverage(interval));
-        }
-
-        /// <summary>Get the overall average execution time in milliseconds.</summary>
-        /// <param name="interval">The interval for which to get the average, relative to now</param>
-        public double GetAverageExecutionTime(TimeSpan interval)
-        {
-            return this.PerformanceCounters
-                .Sum(entry => entry.Value.GetAverage(interval));
-        }
-
-        /// <summary>Get the average execution time for game-internal sources in milliseconds.</summary>
-        public double GetGameAverageExecutionTime(TimeSpan interval)
-        {
-            return this.PerformanceCounters.TryGetValue(Constants.GamePerformanceCounterName, out PerformanceCounter gameExecTime)
-                ? gameExecTime.GetAverage(interval)
-                : 0;
-        }
-
-        /// <summary>Get the peak execution time in milliseconds.</summary>
-        /// <param name="range">The time range to search.</param>
-        /// <param name="endTime">The end time for the <paramref name="range"/>, or null for the current time.</param>
-        public double GetPeakExecutionTime(TimeSpan range, DateTime? endTime = null)
-        {
-            if (this.PeakInvocations.Count == 0)
-                return 0;
-
-            endTime ??= DateTime.UtcNow;
-            DateTime startTime = endTime.Value.Subtract(range);
-
-            return this.PeakInvocations
-                .Where(entry => entry.EventTime >= startTime && entry.EventTime <= endTime)
-                .OrderByDescending(x => x.ExecutionTimeMilliseconds)
-                .Select(p => p.ExecutionTimeMilliseconds)
-                .FirstOrDefault();
-        }
-
-        /// <summary>Start tracking the invocation of this collection.</summary>
-        public void BeginTrackInvocation()
-        {
-            this.TriggeredPerformanceCounters.Clear();
-            this.InvocationStopwatch.Reset();
-            this.InvocationStopwatch.Start();
-
-            this.CallCount++;
-        }
-
-        /// <summary>End tracking the invocation of this collection, and raise an alert if needed.</summary>
-        public void EndTrackInvocation()
-        {
-            this.InvocationStopwatch.Stop();
-
-            // add invocation
-            if (this.PeakInvocations.Count >= this.MaxEntries)
-                this.PeakInvocations.Pop();
-            this.PeakInvocations.Push(new PeakEntry(this.InvocationStopwatch.Elapsed.TotalMilliseconds, DateTime.UtcNow, this.TriggeredPerformanceCounters.ToArray()));
-
-            // raise alert
-            if (this.EnableAlerts && this.InvocationStopwatch.Elapsed.TotalMilliseconds >= this.AlertThresholdMilliseconds)
-                this.AddAlert(this.InvocationStopwatch.Elapsed.TotalMilliseconds, this.AlertThresholdMilliseconds, this.TriggeredPerformanceCounters.ToArray());
-        }
-
-        /// <summary>Add an alert.</summary>
-        /// <param name="executionTimeMilliseconds">The execution time in milliseconds.</param>
-        /// <param name="thresholdMilliseconds">The configured threshold.</param>
-        /// <param name="alerts">The sources involved in exceeding the threshold.</param>
-        public void AddAlert(double executionTimeMilliseconds, double thresholdMilliseconds, AlertContext[] alerts)
-        {
-            this.PerformanceMonitor.AddAlert(
-                new AlertEntry(this, executionTimeMilliseconds, thresholdMilliseconds, alerts)
-            );
-        }
-
-        /// <summary>Add an alert.</summary>
-        /// <param name="executionTimeMilliseconds">The execution time in milliseconds.</param>
-        /// <param name="thresholdMilliseconds">The configured threshold.</param>
-        /// <param name="alert">The source involved in exceeding the threshold.</param>
-        public void AddAlert(double executionTimeMilliseconds, double thresholdMilliseconds, AlertContext alert)
-        {
-            this.AddAlert(executionTimeMilliseconds, thresholdMilliseconds, new[] { alert });
-        }
-
-        /// <summary>Reset the calls per second counter.</summary>
-        public void ResetCallsPerSecond()
-        {
-            this.CallCount = 0;
-            this.CallsPerSecondStart = DateTime.UtcNow;
-        }
-
-        /// <summary>Reset all performance counters in this collection.</summary>
-        public void Reset()
-        {
-            this.PeakInvocations.Clear();
-            foreach (var counter in this.PerformanceCounters)
-                counter.Value.Reset();
-        }
-
-        /// <summary>Reset the performance counter for a specific source.</summary>
-        /// <param name="source">The source name.</param>
-        public void ResetSource(string source)
-        {
-            foreach (var i in this.PerformanceCounters)
-                if (i.Value.Source.Equals(source, StringComparison.OrdinalIgnoreCase))
-                    i.Value.Reset();
-        }
-
-        /// <summary>Get the average calls per second.</summary>
-        public long GetAverageCallsPerSecond()
-        {
-            long runtimeInSeconds = (long)DateTime.UtcNow.Subtract(this.CallsPerSecondStart).TotalSeconds;
-            return runtimeInSeconds > 0
-                ? this.CallCount / runtimeInSeconds
-                : 0;
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounterEntry.cs b/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounterEntry.cs
deleted file mode 100644
index 18cca628..00000000
--- a/src/SMAPI/Framework/PerformanceMonitoring/PerformanceCounterEntry.cs
+++ /dev/null
@@ -1,30 +0,0 @@
-using System;
-
-namespace StardewModdingAPI.Framework.PerformanceMonitoring
-{
-    /// <summary>A single performance counter entry.</summary>
-    internal readonly struct PerformanceCounterEntry
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>When the entry occurred.</summary>
-        public DateTime EventTime { get; }
-
-        /// <summary>The elapsed milliseconds.</summary>
-        public double ElapsedMilliseconds { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="eventTime">When the entry occurred.</param>
-        /// <param name="elapsedMilliseconds">The elapsed milliseconds.</param>
-        public PerformanceCounterEntry(DateTime eventTime, double elapsedMilliseconds)
-        {
-            this.EventTime = eventTime;
-            this.ElapsedMilliseconds = elapsedMilliseconds;
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/PerformanceMonitoring/PerformanceMonitor.cs b/src/SMAPI/Framework/PerformanceMonitoring/PerformanceMonitor.cs
deleted file mode 100644
index 3f2608aa..00000000
--- a/src/SMAPI/Framework/PerformanceMonitoring/PerformanceMonitor.cs
+++ /dev/null
@@ -1,184 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.Linq;
-using System.Text;
-using StardewModdingAPI.Framework.Events;
-
-namespace StardewModdingAPI.Framework.PerformanceMonitoring
-{
-    /// <summary>Tracks performance metrics.</summary>
-    internal class PerformanceMonitor
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The recorded alerts.</summary>
-        private readonly IList<AlertEntry> Alerts = new List<AlertEntry>();
-
-        /// <summary>The monitor for output logging.</summary>
-        private readonly IMonitor Monitor;
-
-        /// <summary>The invocation stopwatch.</summary>
-        private readonly Stopwatch InvocationStopwatch = new Stopwatch();
-
-        /// <summary>The underlying performance counter collections.</summary>
-        private readonly IDictionary<string, PerformanceCounterCollection> Collections = new Dictionary<string, PerformanceCounterCollection>(StringComparer.OrdinalIgnoreCase);
-
-
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>Whether alerts are paused.</summary>
-        public bool PauseAlerts { get; set; }
-
-        /// <summary>Whether performance counter tracking is enabled.</summary>
-        public bool EnableTracking { get; set; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="monitor">The monitor for output logging.</param>
-        public PerformanceMonitor(IMonitor monitor)
-        {
-            this.Monitor = monitor;
-        }
-
-        /// <summary>Reset all performance counters in all collections.</summary>
-        public void Reset()
-        {
-            foreach (PerformanceCounterCollection collection in this.Collections.Values)
-                collection.Reset();
-        }
-
-        /// <summary>Track the invocation time for a collection.</summary>
-        /// <param name="collectionName">The name of the collection.</param>
-        /// <param name="action">The action to execute and track.</param>
-        public void Track(string collectionName, Action action)
-        {
-            if (!this.EnableTracking)
-            {
-                action();
-                return;
-            }
-
-            PerformanceCounterCollection collection = this.GetOrCreateCollectionByName(collectionName);
-            collection.BeginTrackInvocation();
-            try
-            {
-                action();
-            }
-            finally
-            {
-                collection.EndTrackInvocation();
-            }
-        }
-
-        /// <summary>Track a single performance counter invocation in a specific collection.</summary>
-        /// <param name="collectionName">The name of the collection.</param>
-        /// <param name="sourceName">The name of the source.</param>
-        /// <param name="action">The action to execute and track.</param>
-        public void Track(string collectionName, string sourceName, Action action)
-        {
-            if (!this.EnableTracking)
-            {
-                action();
-                return;
-            }
-
-            PerformanceCounterCollection collection = this.GetOrCreateCollectionByName(collectionName);
-            DateTime eventTime = DateTime.UtcNow;
-            this.InvocationStopwatch.Reset();
-            this.InvocationStopwatch.Start();
-
-            try
-            {
-                action();
-            }
-            finally
-            {
-                this.InvocationStopwatch.Stop();
-                collection.Track(sourceName, new PerformanceCounterEntry(eventTime, this.InvocationStopwatch.Elapsed.TotalMilliseconds));
-            }
-        }
-
-        /// <summary>Reset the performance counters for a specific collection.</summary>
-        /// <param name="name">The collection name.</param>
-        public void ResetCollection(string name)
-        {
-            if (this.Collections.TryGetValue(name, out PerformanceCounterCollection collection))
-            {
-                collection.ResetCallsPerSecond();
-                collection.Reset();
-            }
-        }
-
-        /// <summary>Reset performance counters for a specific source.</summary>
-        /// <param name="name">The name of the source.</param>
-        public void ResetSource(string name)
-        {
-            foreach (PerformanceCounterCollection performanceCounterCollection in this.Collections.Values)
-                performanceCounterCollection.ResetSource(name);
-        }
-
-        /// <summary>Print any queued alerts.</summary>
-        public void PrintQueuedAlerts()
-        {
-            if (this.Alerts.Count == 0)
-                return;
-
-            StringBuilder report = new StringBuilder();
-
-            foreach (AlertEntry alert in this.Alerts)
-            {
-                report.AppendLine($"{alert.Collection.Name} took {alert.ExecutionTimeMilliseconds:F2}ms (exceeded threshold of {alert.ThresholdMilliseconds:F2}ms)");
-
-                foreach (AlertContext context in alert.Context.OrderByDescending(p => p.Elapsed))
-                    report.AppendLine(context.ToString());
-            }
-
-            this.Alerts.Clear();
-            this.Monitor.Log(report.ToString(), LogLevel.Error);
-        }
-
-        /// <summary>Add an alert to the queue.</summary>
-        /// <param name="entry">The alert to add.</param>
-        public void AddAlert(AlertEntry entry)
-        {
-            if (!this.PauseAlerts)
-                this.Alerts.Add(entry);
-        }
-
-        /// <summary>Initialize the default performance counter collections.</summary>
-        /// <param name="eventManager">The event manager.</param>
-        public void InitializePerformanceCounterCollections(EventManager eventManager)
-        {
-            foreach (IManagedEvent @event in eventManager.GetAllEvents())
-                this.Collections[@event.EventName] = new PerformanceCounterCollection(this, @event.EventName, @event.IsPerformanceCritical);
-        }
-
-        /// <summary>Get the underlying performance counters.</summary>
-        public IEnumerable<PerformanceCounterCollection> GetCollections()
-        {
-            return this.Collections.Values;
-        }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Get a collection by name and creates it if it doesn't exist.</summary>
-        /// <param name="name">The name of the collection.</param>
-        private PerformanceCounterCollection GetOrCreateCollectionByName(string name)
-        {
-            if (!this.Collections.TryGetValue(name, out PerformanceCounterCollection collection))
-            {
-                collection = new PerformanceCounterCollection(this, name);
-                this.Collections[name] = collection;
-            }
-            return collection;
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 5dc33828..f9113194 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -28,7 +28,6 @@ using StardewModdingAPI.Framework.ModHelpers;
 using StardewModdingAPI.Framework.ModLoading;
 using StardewModdingAPI.Framework.Networking;
 using StardewModdingAPI.Framework.Patching;
-using StardewModdingAPI.Framework.PerformanceMonitoring;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Rendering;
 using StardewModdingAPI.Framework.Serialization;
@@ -143,10 +142,6 @@ namespace StardewModdingAPI.Framework
         /// <remarks>This is initialized after the game starts. This is accessed directly because it's not part of the normal class model.</remarks>
         internal static DeprecationManager DeprecationManager { get; private set; }
 
-        /// <summary>Manages performance counters.</summary>
-        /// <remarks>This is initialized after the game starts. This is non-private for use by Console Commands.</remarks>
-        internal static PerformanceMonitor PerformanceMonitor { get; private set; }
-
         /// <summary>The number of update ticks which have already executed. This is similar to <see cref="Game1.ticks"/>, but incremented more consistently for every tick.</summary>
         internal static uint TicksElapsed { get; private set; }
 
@@ -175,9 +170,7 @@ namespace StardewModdingAPI.Framework
 
             this.LogManager = new LogManager(logPath: logPath, colorConfig: this.Settings.ConsoleColors, writeToConsole: writeToConsole, isVerbose: this.Settings.VerboseLogging, isDeveloperMode: this.Settings.DeveloperMode, getScreenIdForLog: this.GetScreenIdForLog);
 
-            SCore.PerformanceMonitor = new PerformanceMonitor(this.Monitor);
-            this.EventManager = new EventManager(this.ModRegistry, SCore.PerformanceMonitor);
-            SCore.PerformanceMonitor.InitializePerformanceCounterCollections(this.EventManager);
+            this.EventManager = new EventManager(this.ModRegistry);
 
             SCore.DeprecationManager = new DeprecationManager(this.Monitor, this.ModRegistry);
 
@@ -443,7 +436,6 @@ namespace StardewModdingAPI.Framework
                 *********/
                 // print warnings/alerts
                 SCore.DeprecationManager.PrintQueued();
-                SCore.PerformanceMonitor.PrintQueuedAlerts();
 
                 /*********
                 ** First-tick initialization
diff --git a/src/SMAPI/Properties/AssemblyInfo.cs b/src/SMAPI/Properties/AssemblyInfo.cs
index f8f7f4ea..ee8a1674 100644
--- a/src/SMAPI/Properties/AssemblyInfo.cs
+++ b/src/SMAPI/Properties/AssemblyInfo.cs
@@ -1,5 +1,4 @@
 using System.Runtime.CompilerServices;
 
 [assembly: InternalsVisibleTo("SMAPI.Tests")]
-[assembly: InternalsVisibleTo("ConsoleCommands")] // for performance monitoring commands
 [assembly: InternalsVisibleTo("DynamicProxyGenAssembly2")] // Moq for unit testing

From d5b00bec84fca94ebd94bea509af060928585cc8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Jan 2021 02:14:44 -0500
Subject: [PATCH 040/856] simplify tilesheet order warning

---
 docs/release-notes.md                                     | 3 +++
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs | 6 +++---
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4c548924..d4702dd5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,9 @@
 * For players:
   * Reduced memory usage.
 
+* For modders:
+  * Simplified tilesheet order warning added in 3.8.2.
+
 * For the Console Commands mod:
   * Removed experimental `performance` command. Unfortunately this impacted SMAPI's memory usage and the data was often misinterpreted. This may be replaced with more automatic performance alerts in a future version.
 
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 540475f1..3db3856f 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -414,16 +414,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
                         int loadedIndex = this.TryFindTilesheet(loadedMap, vanillaSheet.Id);
                         string reason = loadedIndex != -1
-                            ? $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\n\nTechnical details for mod author:\nExpected order [{string.Join(", ", vanillaTilesheetRefs.Select(p => $"'{p.ImageSource}' (id: {p.Id})"))}], but found tilesheet '{vanillaSheet.Id}' at index {loadedIndex} instead of {vanillaSheet.Index}. Make sure custom tilesheet IDs are prefixed with 'z_' to avoid reordering tilesheets."
+                            ? $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewcommunitywiki.com/Modding:Maps#Tilesheet_order for help."
                             : $"mod has no tilesheet with ID '{vanillaSheet.Id}'. Map replacements must keep the original tilesheets to avoid errors or crashes.";
 
                         SCore.DeprecationManager.PlaceholderWarn("3.8.2", DeprecationLevel.PendingRemoval);
                         if (isFarmMap)
                         {
-                            mod.LogAsMod($"SMAPI blocked asset replacement for '{info.AssetName}': {reason}", LogLevel.Error);
+                            mod.LogAsMod($"SMAPI blocked '{info.AssetName}' map load: {reason}", LogLevel.Error);
                             return false;
                         }
-                        mod.LogAsMod($"SMAPI detected a potential issue with asset replacement for '{info.AssetName}' map: {reason}", LogLevel.Warn);
+                        mod.LogAsMod($"SMAPI found an issue with '{info.AssetName}' map load: {reason}", LogLevel.Warn);
                     }
                 }
             }

From 51de495ae4c1b9da13cce24dc15ac844b24f657e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Jan 2021 23:43:48 -0500
Subject: [PATCH 041/856] add a way to send console commands to a specific
 screen

---
 docs/release-notes.md                 |  1 +
 src/SMAPI/Framework/CommandManager.cs | 67 ++++++++++++++++++++++++++-
 src/SMAPI/Framework/SCore.cs          | 67 ++++++++++++++++++---------
 src/SMAPI/Utilities/PerScreen.cs      | 33 ++++++++-----
 4 files changed, 132 insertions(+), 36 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d4702dd5..afb88f5b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Reduced memory usage.
+  * You can now enter console commands for a specific screen in split-screen mode by adding `screen=ID` to the command.
 
 * For modders:
   * Simplified tilesheet order warning added in 3.8.2.
diff --git a/src/SMAPI/Framework/CommandManager.cs b/src/SMAPI/Framework/CommandManager.cs
index 4a99fd4d..ff540ad8 100644
--- a/src/SMAPI/Framework/CommandManager.cs
+++ b/src/SMAPI/Framework/CommandManager.cs
@@ -15,10 +15,20 @@ namespace StardewModdingAPI.Framework
         /// <summary>The commands registered with SMAPI.</summary>
         private readonly IDictionary<string, Command> Commands = new Dictionary<string, Command>(StringComparer.OrdinalIgnoreCase);
 
+        /// <summary>Writes messages to the console.</summary>
+        private readonly IMonitor Monitor;
+
 
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="monitor">Writes messages to the console.</param>
+        public CommandManager(IMonitor monitor)
+        {
+            this.Monitor = monitor;
+        }
+
         /// <summary>Add a console command.</summary>
         /// <param name="mod">The mod adding the command (or <c>null</c> for a SMAPI command).</param>
         /// <param name="name">The command name, which the user must type to trigger it.</param>
@@ -81,8 +91,9 @@ namespace StardewModdingAPI.Framework
         /// <param name="name">The parsed command name.</param>
         /// <param name="args">The parsed command arguments.</param>
         /// <param name="command">The command which can handle the input.</param>
+        /// <param name="screenId">The screen ID on which to run the command.</param>
         /// <returns>Returns true if the input was successfully parsed and matched to a command; else false.</returns>
-        public bool TryParse(string input, out string name, out string[] args, out Command command)
+        public bool TryParse(string input, out string name, out string[] args, out Command command, out int screenId)
         {
             // ignore if blank
             if (string.IsNullOrWhiteSpace(input))
@@ -90,6 +101,7 @@ namespace StardewModdingAPI.Framework
                 name = null;
                 args = null;
                 command = null;
+                screenId = 0;
                 return false;
             }
 
@@ -98,6 +110,27 @@ namespace StardewModdingAPI.Framework
             name = this.GetNormalizedName(args[0]);
             args = args.Skip(1).ToArray();
 
+            // get screen ID argument
+            screenId = 0;
+            for (int i = 0; i < args.Length; i++)
+            {
+                // consume arg & set screen ID
+                if (this.TryParseScreenId(args[i], out int rawScreenId, out string error))
+                {
+                    args = args.Take(i).Concat(args.Skip(i + 1)).ToArray();
+                    screenId = rawScreenId;
+                    continue;
+                }
+
+                // invalid screen arg
+                if (error != null)
+                {
+                    this.Monitor.Log(error, LogLevel.Error);
+                    command = null;
+                    return false;
+                }
+            }
+
             // get command
             return this.Commands.TryGetValue(name, out command);
         }
@@ -152,6 +185,38 @@ namespace StardewModdingAPI.Framework
             return args.Where(item => !string.IsNullOrWhiteSpace(item)).ToArray();
         }
 
+        /// <summary>Try to parse a 'screen=X' command argument, which specifies the screen that should receive the command.</summary>
+        /// <param name="arg">The raw argument to parse.</param>
+        /// <param name="screen">The parsed screen ID, if any.</param>
+        /// <param name="error">The error which indicates an invalid screen ID, if applicable.</param>
+        /// <returns>Returns whether the screen ID was parsed successfully.</returns>
+        private bool TryParseScreenId(string arg, out int screen, out string error)
+        {
+            screen = -1;
+            error = null;
+
+            // skip non-screen arg
+            if (!arg.StartsWith("screen="))
+                return false;
+
+            // get screen ID
+            string rawScreen = arg.Substring("screen=".Length);
+            if (!int.TryParse(rawScreen, out screen))
+            {
+                error = $"invalid screen ID format: {rawScreen}";
+                return false;
+            }
+
+            // validate ID
+            if (!Context.HasScreenId(screen))
+            {
+                error = $"there's no active screen with ID {screen}. Active screen IDs: {string.Join(", ", Context.ActiveScreenIds)}.";
+                return false;
+            }
+
+            return true;
+        }
+
         /// <summary>Get a normalized command name.</summary>
         /// <param name="name">The command name.</param>
         private string GetNormalizedName(string name)
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index f9113194..3a51b418 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -81,7 +81,7 @@ namespace StardewModdingAPI.Framework
         ** Higher-level components
         ****/
         /// <summary>Manages console commands.</summary>
-        private readonly CommandManager CommandManager = new CommandManager();
+        private readonly CommandManager CommandManager;
 
         /// <summary>The underlying game instance.</summary>
         private SGameRunner Game;
@@ -130,9 +130,12 @@ namespace StardewModdingAPI.Framework
         /// <summary>Asset interceptors added or removed since the last tick.</summary>
         private readonly List<AssetInterceptorChange> ReloadAssetInterceptorsQueue = new List<AssetInterceptorChange>();
 
-        /// <summary>A list of queued commands to execute.</summary>
+        /// <summary>A list of queued commands to parse and execute.</summary>
         /// <remarks>This property must be thread-safe, since it's accessed from a separate console input thread.</remarks>
-        public ConcurrentQueue<string> CommandQueue { get; } = new ConcurrentQueue<string>();
+        private readonly ConcurrentQueue<string> RawCommandQueue = new ConcurrentQueue<string>();
+
+        /// <summary>A list of commands to execute on each screen.</summary>
+        private readonly PerScreen<List<Tuple<Command, string, string[]>>> ScreenCommandQueue = new(() => new());
 
 
         /*********
@@ -169,11 +172,9 @@ namespace StardewModdingAPI.Framework
                 JsonConvert.PopulateObject(File.ReadAllText(Constants.ApiUserConfigPath), this.Settings);
 
             this.LogManager = new LogManager(logPath: logPath, colorConfig: this.Settings.ConsoleColors, writeToConsole: writeToConsole, isVerbose: this.Settings.VerboseLogging, isDeveloperMode: this.Settings.DeveloperMode, getScreenIdForLog: this.GetScreenIdForLog);
-
+            this.CommandManager = new CommandManager(this.Monitor);
             this.EventManager = new EventManager(this.ModRegistry);
-
             SCore.DeprecationManager = new DeprecationManager(this.Monitor, this.ModRegistry);
-
             SDate.Translations = this.Translator;
 
             // log SMAPI/OS info
@@ -406,7 +407,7 @@ namespace StardewModdingAPI.Framework
                 () => this.LogManager.RunConsoleInputLoop(
                     commandManager: this.CommandManager,
                     reloadTranslations: this.ReloadTranslations,
-                    handleInput: input => this.CommandQueue.Enqueue(input),
+                    handleInput: input => this.RawCommandQueue.Enqueue(input),
                     continueWhile: () => this.IsGameRunning && !this.CancellationToken.IsCancellationRequested
                 )
             ).Start();
@@ -489,17 +490,18 @@ namespace StardewModdingAPI.Framework
                 }
 
                 /*********
-                ** Execute commands
+                ** Parse commands
                 *********/
-                while (this.CommandQueue.TryDequeue(out string rawInput))
+                while (this.RawCommandQueue.TryDequeue(out string rawInput))
                 {
                     // parse command
                     string name;
                     string[] args;
                     Command command;
+                    int screenId;
                     try
                     {
-                        if (!this.CommandManager.TryParse(rawInput, out name, out args, out command))
+                        if (!this.CommandManager.TryParse(rawInput, out name, out args, out command, out screenId))
                         {
                             this.Monitor.Log("Unknown command; type 'help' for a list of available commands.", LogLevel.Error);
                             continue;
@@ -511,18 +513,8 @@ namespace StardewModdingAPI.Framework
                         continue;
                     }
 
-                    // execute command
-                    try
-                    {
-                        command.Callback.Invoke(name, args);
-                    }
-                    catch (Exception ex)
-                    {
-                        if (command.Mod != null)
-                            command.Mod.LogAsMod($"Mod failed handling that command:\n{ex.GetLogSummary()}", LogLevel.Error);
-                        else
-                            this.Monitor.Log($"Failed handling that command:\n{ex.GetLogSummary()}", LogLevel.Error);
-                    }
+                    // queue command for screen
+                    this.ScreenCommandQueue.GetValueForScreen(screenId).Add(Tuple.Create(command, name, args));
                 }
 
                 /*********
@@ -570,7 +562,9 @@ namespace StardewModdingAPI.Framework
 
             try
             {
-                // reapply overrides
+                /*********
+                ** Reapply overrides
+                *********/
                 if (this.JustReturnedToTitle)
                 {
                     if (!(Game1.mapDisplayDevice is SDisplayDevice))
@@ -579,6 +573,33 @@ namespace StardewModdingAPI.Framework
                     this.JustReturnedToTitle = false;
                 }
 
+                /*********
+                ** Execute commands
+                *********/
+                {
+                    var commandQueue = this.ScreenCommandQueue.Value;
+                    foreach (var entry in commandQueue)
+                    {
+                        Command command = entry.Item1;
+                        string name = entry.Item2;
+                        string[] args = entry.Item3;
+
+                        try
+                        {
+                            command.Callback.Invoke(name, args);
+                        }
+                        catch (Exception ex)
+                        {
+                            if (command.Mod != null)
+                                command.Mod.LogAsMod($"Mod failed handling that command:\n{ex.GetLogSummary()}", LogLevel.Error);
+                            else
+                                this.Monitor.Log($"Failed handling that command:\n{ex.GetLogSummary()}", LogLevel.Error);
+                        }
+                    }
+                    commandQueue.Clear();
+                }
+
+
                 /*********
                 ** Update input
                 *********/
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 55dae0d8..89d08e87 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -28,18 +28,8 @@ namespace StardewModdingAPI.Utilities
         /// <remarks>The value is initialized the first time it's requested for that player, unless it's set manually first.</remarks>
         public T Value
         {
-            get
-            {
-                this.RemoveDeadPlayers();
-                return this.States.TryGetValue(Context.ScreenId, out T state)
-                    ? state
-                    : this.States[Context.ScreenId] = this.CreateNewState();
-            }
-            set
-            {
-                this.RemoveDeadPlayers();
-                this.States[Context.ScreenId] = value;
-            }
+            get => this.GetValueForScreen(Context.ScreenId);
+            set => this.SetValueForScreen(Context.ScreenId, value);
         }
 
 
@@ -57,6 +47,25 @@ namespace StardewModdingAPI.Utilities
             this.CreateNewState = createNewState ?? (() => default);
         }
 
+        /// <summary>Get the value for a given screen ID, creating it if needed.</summary>
+        /// <param name="screenId">The screen ID to check.</param>
+        internal T GetValueForScreen(int screenId)
+        {
+            this.RemoveDeadPlayers();
+            return this.States.TryGetValue(screenId, out T state)
+                ? state
+                : this.States[screenId] = this.CreateNewState();
+        }
+
+        /// <summary>Set the value for a given screen ID, creating it if needed.</summary>
+        /// <param name="screenId">The screen ID whose value set.</param>
+        /// <param name="value">The value to set.</param>
+        internal void SetValueForScreen(int screenId, T value)
+        {
+            this.RemoveDeadPlayers();
+            this.States[screenId] = value;
+        }
+
 
         /*********
         ** Private methods

From c6b40fb5911b54ace96167fe5fc1bce4fe3695bc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Jan 2021 00:05:27 -0500
Subject: [PATCH 042/856] add more helpful `help` command output

---
 docs/release-notes.md                       |  1 +
 src/SMAPI.Web/Startup.cs                    |  1 +
 src/SMAPI/Framework/Commands/HelpCommand.cs | 18 +++++++++++++++---
 3 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index afb88f5b..ace1f61b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,7 @@
 * For players:
   * Reduced memory usage.
   * You can now enter console commands for a specific screen in split-screen mode by adding `screen=ID` to the command.
+  * Typing `help` in the SMAPI console is now more friendly and helpful.
 
 * For modders:
   * Simplified tilesheet order warning added in 3.8.2.
diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index 586b0c3c..bd1f8c9b 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -210,6 +210,7 @@ namespace StardewModdingAPI.Web
                     [@"^/community\.?$"] = "https://stardewvalleywiki.com/Modding:Community",
                     [@"^/compat\.?$"] = "https://smapi.io/mods",
                     [@"^/docs\.?$"] = "https://stardewvalleywiki.com/Modding:Index",
+                    [@"^/help\.?$"] = "https://stardewvalleywiki.com/Modding:Help",
                     [@"^/install\.?$"] = "https://stardewvalleywiki.com/Modding:Player_Guide/Getting_Started#Install_SMAPI",
                     [@"^/troubleshoot(.*)$"] = "https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting$1",
                     [@"^/xnb\.?$"] = "https://stardewvalleywiki.com/Modding:Using_XNB_mods"
diff --git a/src/SMAPI/Framework/Commands/HelpCommand.cs b/src/SMAPI/Framework/Commands/HelpCommand.cs
index b8730a00..baf3116e 100644
--- a/src/SMAPI/Framework/Commands/HelpCommand.cs
+++ b/src/SMAPI/Framework/Commands/HelpCommand.cs
@@ -41,13 +41,26 @@ namespace StardewModdingAPI.Framework.Commands
             {
                 Command result = this.CommandManager.Get(args[0]);
                 if (result == null)
-                    monitor.Log("There's no command with that name.", LogLevel.Error);
+                    monitor.Log("There's no command with that name. Type 'help' by itself for more info.", LogLevel.Error);
                 else
                     monitor.Log($"{result.Name}: {result.Documentation}{(result.Mod != null ? $"\n(Added by {result.Mod.DisplayName}.)" : "")}", LogLevel.Info);
             }
             else
             {
-                string message = "The following commands are registered:\n";
+                string message =
+                    "\n\n"
+                    + "Need help with a SMAPI or mod issue?\n"
+                    + "------------------------------------\n"
+                    + "See https://smapi.io/help for the best places to ask.\n\n\n"
+                    + "How commands work\n"
+                    + "-----------------\n"
+                    + "Just enter a command directly to run it, just like you did for this help command. Commands may take optional arguments\n"
+                    + "which change what they do; for example, type 'help help' to see help about the help command. When playing in split-screen\n"
+                    + "mode, you can add screen=X to send the command to a specific screen instance.\n\n\n"
+                    + "Valid commands\n"
+                    + "--------------\n"
+                    + "The following commands are registered. For more info about a command, type 'help command_name'.\n\n";
+
                 IGrouping<string, string>[] groups = (from command in this.CommandManager.GetAll() orderby command.Mod?.DisplayName, command.Name group command.Name by command.Mod?.DisplayName).ToArray();
                 foreach (var group in groups)
                 {
@@ -55,7 +68,6 @@ namespace StardewModdingAPI.Framework.Commands
                     string[] commandNames = group.ToArray();
                     message += $"{modName}:\n  {string.Join("\n  ", commandNames)}\n\n";
                 }
-                message += "For more information about a command, type 'help command_name'.";
 
                 monitor.Log(message, LogLevel.Info);
             }

From d100681be7ef1eafd8ec5e98984c41d7473ad3d0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jan 2021 20:48:15 -0500
Subject: [PATCH 043/856] update for draw changes in SDV 1.5.2

---
 docs/release-notes.md        | 5 +++--
 src/SMAPI/Framework/SGame.cs | 9 ++++-----
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ace1f61b..25d08095 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,12 +9,13 @@
 
 ## Upcoming release
 * For players:
+  * Updated for Stardew Valley 1.5.2.
   * Reduced memory usage.
   * You can now enter console commands for a specific screen in split-screen mode by adding `screen=ID` to the command.
-  * Typing `help` in the SMAPI console is now more friendly and helpful.
+  * Typing `help` in the SMAPI console is now more helpful.
 
 * For modders:
-  * Simplified tilesheet order warning added in 3.8.2.
+  * Simplified tilesheet order warning added in SMAPI 3.8.2.
 
 * For the Console Commands mod:
   * Removed experimental `performance` command. Unfortunately this impacted SMAPI's memory usage and the data was often misinterpreted. This may be replaced with more automatic performance alerts in a future version.
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index f69c5f08..2ede40ae 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -247,7 +247,7 @@ namespace StardewModdingAPI.Framework
             }
             if (target_screen != null)
             {
-                base.GraphicsDevice.SetRenderTarget(target_screen);
+                Game1.SetRenderTarget(target_screen);
             }
             if (this.IsSaving)
             {
@@ -352,8 +352,7 @@ namespace StardewModdingAPI.Framework
                     events.Rendered.RaiseEmpty();
                     Game1.spriteBatch.End();
                 }
-
-                base.GraphicsDevice.SetRenderTarget(target_screen);
+                Game1.SetRenderTarget(target_screen);
                 return;
             }
             if (Game1.showingEndOfNightStuff)
@@ -426,7 +425,7 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.drawLighting)
                 {
-                    base.GraphicsDevice.SetRenderTarget(Game1.lightmap);
+                    Game1.SetRenderTarget(Game1.lightmap);
                     base.GraphicsDevice.Clear(Microsoft.Xna.Framework.Color.White * 0f);
                     Matrix lighting_matrix = Matrix.Identity;
                     if (this.useUnscaledLighting)
@@ -473,7 +472,7 @@ namespace StardewModdingAPI.Framework
                         }
                     }
                     Game1.spriteBatch.End();
-                    base.GraphicsDevice.SetRenderTarget(target_screen);
+                    Game1.SetRenderTarget(target_screen);
                 }
                 if (Game1.bloomDay && Game1.bloom != null)
                 {

From df25368300e1254bc6eb2a1c7aa371bfeb289dff Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jan 2021 21:01:17 -0500
Subject: [PATCH 044/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 6 ++++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 4 ++--
 5 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 4332313b..c7af8630 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.8.2</Version>
+    <Version>3.8.3</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 25d08095..6a6b07a2 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,7 +7,9 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.8.3
+Released 08 January 2021 for Stardew Valley 1.5.2 or later.
+
 * For players:
   * Updated for Stardew Valley 1.5.2.
   * Reduced memory usage.
@@ -18,7 +20,7 @@
   * Simplified tilesheet order warning added in SMAPI 3.8.2.
 
 * For the Console Commands mod:
-  * Removed experimental `performance` command. Unfortunately this impacted SMAPI's memory usage and the data was often misinterpreted. This may be replaced with more automatic performance alerts in a future version.
+  * Removed experimental `performance` command. Unfortunately this impacted SMAPI's memory usage and performance, and the data was often misinterpreted. This may be replaced with more automatic performance alerts in a future version.
 
 ## 3.8.2
 Released 03 January 2021 for Stardew Valley 1.5.1 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 13e85c70..1a021485 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.8.2",
+    "Version": "3.8.3",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.8.2"
+    "MinimumApiVersion": "3.8.3"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 475ec165..17ca5991 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.8.2",
+    "Version": "3.8.3",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.8.2"
+    "MinimumApiVersion": "3.8.3"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 9816013c..2c0b85b7 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,10 +54,10 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.2");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.3");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.1");
+        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.2");
 
         /// <summary>The maximum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MaximumGameVersion { get; } = null;

From aab4ddf05ed825d043330c5d65f7d3503b8b02fb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 10 Jan 2021 13:12:34 -0500
Subject: [PATCH 045/856] fix title screen music not stopping after save is
 loaded

---
 docs/release-notes.md        | 4 ++++
 src/SMAPI/Framework/SCore.cs | 1 +
 2 files changed, 5 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6a6b07a2..f4f65653 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Fixed issue where title screen music didn't stop after loading a save.
+
 ## 3.8.3
 Released 08 January 2021 for Stardew Valley 1.5.2 or later.
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 3a51b418..f9a36593 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -619,6 +619,7 @@ namespace StardewModdingAPI.Framework
                 if (Game1.currentLoader != null)
                 {
                     this.Monitor.Log("Game loader synchronizing...");
+                    this.Reflection.GetMethod(Game1.game1, "UpdateTitleScreen").Invoke(Game1.currentGameTime); // run game logic to change music on load, etc
                     while (Game1.currentLoader?.MoveNext() == true)
                     {
                         // raise load stage changed

From d47d850753ec19d82993c5e2af8a17ca729c43a7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 12 Jan 2021 20:00:40 -0500
Subject: [PATCH 046/856] tuck location map reload into method (#751)

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 66 ++++++++++++-----------
 1 file changed, 36 insertions(+), 30 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index b82dedfd..bd1cc50e 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -138,36 +138,7 @@ namespace StardewModdingAPI.Metadata
                 {
                     if (!string.IsNullOrWhiteSpace(location.mapPath.Value) && this.NormalizeAssetNameIgnoringEmpty(location.mapPath.Value) == key)
                     {
-                        // reset patch caches
-                        switch (location)
-                        {
-                            case Town _:
-                                this.Reflection.GetField<bool>(location, "ccRefurbished").SetValue(false);
-                                this.Reflection.GetField<bool>(location, "isShowingDestroyedJoja").SetValue(false);
-                                this.Reflection.GetField<bool>(location, "isShowingUpgradedPamHouse").SetValue(false);
-                                break;
-
-                            case Beach _:
-                            case BeachNightMarket _:
-                            case Forest _:
-                                this.Reflection.GetField<bool>(location, "hasShownCCUpgrade").SetValue(false);
-                                break;
-                        }
-
-                        // general updates
-                        location.reloadMap();
-                        location.updateSeasonalTileSheets();
-                        location.updateWarps();
-
-                        // update interior doors
-                        location.interiorDoors.Clear();
-                        foreach (var entry in new InteriorDoorDictionary(location))
-                            location.interiorDoors.Add(entry);
-
-                        // update doors
-                        location.doors.Clear();
-                        location.updateDoors();
-
+                        this.ReloadMap(location);
                         anyChanged = true;
                     }
                 }
@@ -803,6 +774,41 @@ namespace StardewModdingAPI.Metadata
             return true;
         }
 
+        /// <summary>Reload the map for a location.</summary>
+        /// <param name="location">The location whose map to reload.</param>
+        private void ReloadMap(GameLocation location)
+        {
+            // reset patch caches
+            switch (location)
+            {
+                case Town _:
+                    this.Reflection.GetField<bool>(location, "ccRefurbished").SetValue(false);
+                    this.Reflection.GetField<bool>(location, "isShowingDestroyedJoja").SetValue(false);
+                    this.Reflection.GetField<bool>(location, "isShowingUpgradedPamHouse").SetValue(false);
+                    break;
+
+                case Beach _:
+                case BeachNightMarket _:
+                case Forest _:
+                    this.Reflection.GetField<bool>(location, "hasShownCCUpgrade").SetValue(false);
+                    break;
+            }
+
+            // general updates
+            location.reloadMap();
+            location.updateSeasonalTileSheets();
+            location.updateWarps();
+
+            // update interior doors
+            location.interiorDoors.Clear();
+            foreach (var entry in new InteriorDoorDictionary(location))
+                location.interiorDoors.Add(entry);
+
+            // update doors
+            location.doors.Clear();
+            location.updateDoors();
+        }
+
         /// <summary>Reload the disposition data for matching NPCs.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="key">The asset key to reload.</param>

From d31370b1d702511fd2d08c66a1f58aac5d454edd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Jan 2021 20:59:39 -0500
Subject: [PATCH 047/856] group mods in solution

---
 src/SMAPI.sln | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index bc74e6b9..b7a84fe4 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -48,6 +48,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "technical", "technical", "{
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Internal", "Internal", "{82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Mods", "Mods", "{AE9A4D46-E910-4293-8BC4-673F85FFF6A5}"
+EndProject
 Project("{D954291E-2A0B-460D-934E-DC6B0785DB48}") = "SMAPI.Internal", "SMAPI.Internal\SMAPI.Internal.shproj", "{85208F8D-6FD1-4531-BE05-7142490F59FE}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.ModBuildConfig.Analyzer.Tests", "SMAPI.ModBuildConfig.Analyzer.Tests\SMAPI.ModBuildConfig.Analyzer.Tests.csproj", "{680B2641-81EA-467C-86A5-0E81CDC57ED0}"
@@ -148,6 +150,8 @@ Global
 		{85208F8D-6FD1-4531-BE05-7142490F59FE} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
 		{680B2641-81EA-467C-86A5-0E81CDC57ED0} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
 		{AA95884B-7097-476E-92C8-D0500DE9D6D1} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
+		{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
+		{CD53AD6F-97F4-4872-A212-50C2A0FD3601} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {70143042-A862-47A8-A677-7C819DDC90DC}

From de789fb3e8f344a09032c23f56e800717ea801a0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 14 Jan 2021 00:04:31 -0500
Subject: [PATCH 048/856] fix semantic version comparison returning wrong value
 in rare cases

---
 docs/release-notes.md                |  2 +
 src/SMAPI.Toolkit/SemanticVersion.cs | 80 +++++++++++++++++-----------
 2 files changed, 51 insertions(+), 31 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f4f65653..0d8fc0ac 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,8 @@
 * For players:
   * Fixed issue where title screen music didn't stop after loading a save.
 
+* For modders:
+  * Fixed `SemanticVersion` comparisons returning wrong value in rare cases.
 ## 3.8.3
 Released 08 January 2021 for Stardew Valley 1.5.2 or later.
 
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index 0f341665..d58dce0c 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -230,38 +230,49 @@ namespace StardewModdingAPI.Toolkit
             const int curNewer = 1;
             const int curOlder = -1;
 
-            // compare stable versions
-            if (this.MajorVersion != otherMajor)
-                return this.MajorVersion.CompareTo(otherMajor);
-            if (this.MinorVersion != otherMinor)
-                return this.MinorVersion.CompareTo(otherMinor);
-            if (this.PatchVersion != otherPatch)
-                return this.PatchVersion.CompareTo(otherPatch);
-            if (this.PlatformRelease != otherPlatformRelease)
-                return this.PlatformRelease.CompareTo(otherPlatformRelease);
-            if (this.PrereleaseTag == otherTag)
-                return same;
-
-            // stable supersedes prerelease
-            bool curIsStable = string.IsNullOrWhiteSpace(this.PrereleaseTag);
-            bool otherIsStable = string.IsNullOrWhiteSpace(otherTag);
-            if (curIsStable)
-                return curNewer;
-            if (otherIsStable)
-                return curOlder;
-
-            // compare two prerelease tag values
-            string[] curParts = this.PrereleaseTag.Split('.', '-');
-            string[] otherParts = otherTag.Split('.', '-');
-            for (int i = 0; i < curParts.Length; i++)
+            int CompareToRaw()
             {
-                // longer prerelease tag supersedes if otherwise equal
-                if (otherParts.Length <= i)
-                    return curNewer;
+                // compare stable versions
+                if (this.MajorVersion != otherMajor)
+                    return this.MajorVersion.CompareTo(otherMajor);
+                if (this.MinorVersion != otherMinor)
+                    return this.MinorVersion.CompareTo(otherMinor);
+                if (this.PatchVersion != otherPatch)
+                    return this.PatchVersion.CompareTo(otherPatch);
+                if (this.PlatformRelease != otherPlatformRelease)
+                    return this.PlatformRelease.CompareTo(otherPlatformRelease);
+                if (this.PrereleaseTag == otherTag)
+                    return same;
 
-                // compare if different
-                if (curParts[i] != otherParts[i])
+                // stable supersedes prerelease
+                bool curIsStable = string.IsNullOrWhiteSpace(this.PrereleaseTag);
+                bool otherIsStable = string.IsNullOrWhiteSpace(otherTag);
+                if (curIsStable)
+                    return curNewer;
+                if (otherIsStable)
+                    return curOlder;
+
+                // compare two prerelease tag values
+                string[] curParts = this.PrereleaseTag.Split('.', '-');
+                string[] otherParts = otherTag.Split('.', '-');
+                int length = Math.Max(curParts.Length, otherParts.Length);
+                for (int i = 0; i < length; i++)
                 {
+                    // longer prerelease tag supersedes if otherwise equal
+                    if (curParts.Length <= i)
+                        return curOlder;
+                    if (otherParts.Length <= i)
+                        return curNewer;
+
+                    // skip if same value, unless we've reached the end
+                    if (curParts[i] == otherParts[i])
+                    {
+                        if (i == length - 1)
+                            return same;
+
+                        continue;
+                    }
+
                     // unofficial is always lower-precedence
                     if (otherParts[i].Equals("unofficial", StringComparison.OrdinalIgnoreCase))
                         return curNewer;
@@ -277,10 +288,17 @@ namespace StardewModdingAPI.Toolkit
                     // else compare lexically
                     return string.Compare(curParts[i], otherParts[i], StringComparison.OrdinalIgnoreCase);
                 }
+
+                // fallback (this should never happen)
+                return string.Compare(this.ToString(), new SemanticVersion(otherMajor, otherMinor, otherPatch, otherPlatformRelease, otherTag).ToString(), StringComparison.OrdinalIgnoreCase);
             }
 
-            // fallback (this should never happen)
-            return string.Compare(this.ToString(), new SemanticVersion(otherMajor, otherMinor, otherPatch, otherPlatformRelease, otherTag).ToString(), StringComparison.OrdinalIgnoreCase);
+            return CompareToRaw() switch
+            {
+                (< 0) => curOlder,
+                (> 0) => curNewer,
+                _ => same
+            };
         }
 
         /// <summary>Assert that the current version is valid.</summary>

From 5db9b049a6156afd580511ed097f0cc705ae41d9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:30:59 -0500
Subject: [PATCH 049/856] update for draw code changes in SDV 1.5.3

---
 docs/release-notes.md        |  2 ++
 src/SMAPI/Constants.cs       |  2 +-
 src/SMAPI/Framework/SGame.cs | 12 ++++++++----
 3 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0d8fc0ac..e30bf08b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,10 +9,12 @@
 
 ## Upcoming release
 * For players:
+  * Updated for Stardew Valley 1.5.3.
   * Fixed issue where title screen music didn't stop after loading a save.
 
 * For modders:
   * Fixed `SemanticVersion` comparisons returning wrong value in rare cases.
+
 ## 3.8.3
 Released 08 January 2021 for Stardew Valley 1.5.2 or later.
 
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 2c0b85b7..36f8f4b5 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -57,7 +57,7 @@ namespace StardewModdingAPI
         public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.3");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.2");
+        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.3");
 
         /// <summary>The maximum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MaximumGameVersion { get; } = null;
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 2ede40ae..42a712ee 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -740,16 +740,20 @@ namespace StardewModdingAPI.Framework
                         Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(startingX, (int)y, Game1.graphics.GraphicsDevice.Viewport.Width, 1), Microsoft.Xna.Framework.Color.Red * 0.5f);
                     }
                 }
+                if (Game1.ShouldShowOnscreenUsernames() && Game1.currentLocation != null)
+                {
+                    Game1.currentLocation.DrawFarmerUsernames(Game1.spriteBatch);
+                }
                 if (Game1.currentBillboard != 0 && !this.takingMapScreenshot)
                 {
                     this.drawBillboard();
                 }
                 if (!Game1.eventUp && Game1.farmEvent == null && Game1.currentBillboard == 0 && Game1.gameMode == 3 && !this.takingMapScreenshot && Game1.isOutdoorMapSmallerThanViewport())
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, -Math.Min(Game1.viewport.X, 4096), Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64, 0, Math.Min(4096, Game1.graphics.GraphicsDevice.Viewport.Width - (-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64)), Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, Game1.graphics.GraphicsDevice.Viewport.Width, -Math.Min(Game1.viewport.Y, 4096)), Microsoft.Xna.Framework.Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, -Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64, Game1.graphics.GraphicsDevice.Viewport.Width, Math.Min(4096, Game1.graphics.GraphicsDevice.Viewport.Height - (-Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64))), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, -Math.Min(Game1.viewport.X, GameRunner.MaxTextureSize), Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64, 0, Math.Min(GameRunner.MaxTextureSize, Game1.graphics.GraphicsDevice.Viewport.Width - (-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64)), Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, Game1.graphics.GraphicsDevice.Viewport.Width, -Math.Min(Game1.viewport.Y, GameRunner.MaxTextureSize)), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, -Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64, Game1.graphics.GraphicsDevice.Viewport.Width, Math.Min(GameRunner.MaxTextureSize, Game1.graphics.GraphicsDevice.Viewport.Height - (-Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64))), Microsoft.Xna.Framework.Color.Black);
                 }
                 Game1.spriteBatch.End();
                 Game1.PushUIMode();

From 415047bf8e44057d6aeeffc6191d00817f6b0d1b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:33:52 -0500
Subject: [PATCH 050/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 5 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index c7af8630..3d39be23 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.8.3</Version>
+    <Version>3.8.4</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index e30bf08b..a2ac8b35 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,7 +7,9 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.8.4
+Released 15 January 2021 for Stardew Valley 1.5.3 or later.
+
 * For players:
   * Updated for Stardew Valley 1.5.3.
   * Fixed issue where title screen music didn't stop after loading a save.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 1a021485..a7daf62b 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.8.3",
+    "Version": "3.8.4",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.8.3"
+    "MinimumApiVersion": "3.8.4"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 17ca5991..0fd202da 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.8.3",
+    "Version": "3.8.4",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.8.3"
+    "MinimumApiVersion": "3.8.4"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 36f8f4b5..b72471ca 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.3");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.4");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.3");

From 8a475b35790506a18aa94a68530b40e8326017ca Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:29 -0500
Subject: [PATCH 051/856] move error-handling Harmony patches into a new Error
 Handler bundled mod

---
 build/common.targets                          | 10 ++-
 build/prepare-install-package.targets         |  6 ++
 docs/release-notes.md                         |  4 +
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       | 73 +++++++++++++++++++
 .../Patches/DialogueErrorPatch.cs             |  9 +--
 .../Patches/EventErrorPatch.cs                |  4 +-
 .../Patches/LoadErrorPatch.cs                 |  2 +-
 .../Patches/ObjectErrorPatch.cs               |  4 +-
 .../Patches/ScheduleErrorPatch.cs             |  4 +-
 .../SMAPI.Mods.ErrorHandler.csproj            | 46 ++++++++++++
 src/SMAPI.Mods.ErrorHandler/i18n/de.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/default.json |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/es.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/fr.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/hu.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/it.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/ja.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/ko.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/pt.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/ru.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/tr.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/i18n/zh.json      |  4 +
 src/SMAPI.Mods.ErrorHandler/manifest.json     |  9 +++
 src/SMAPI.sln                                 |  8 ++
 src/SMAPI/Framework/SCore.cs                  | 31 ++------
 src/SMAPI/Properties/AssemblyInfo.cs          |  1 +
 src/SMAPI/SMAPI.config.json                   |  1 +
 src/SMAPI/i18n/de.json                        |  4 -
 src/SMAPI/i18n/default.json                   |  3 -
 src/SMAPI/i18n/es.json                        |  3 -
 src/SMAPI/i18n/fr.json                        |  3 -
 src/SMAPI/i18n/hu.json                        |  3 -
 src/SMAPI/i18n/it.json                        |  3 -
 src/SMAPI/i18n/ja.json                        |  3 -
 src/SMAPI/i18n/ko.json                        |  3 -
 src/SMAPI/i18n/pt.json                        |  3 -
 src/SMAPI/i18n/ru.json                        |  3 -
 src/SMAPI/i18n/tr.json                        |  3 -
 src/SMAPI/i18n/zh.json                        |  3 -
 39 files changed, 223 insertions(+), 74 deletions(-)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/ModEntry.cs
 rename src/{SMAPI => SMAPI.Mods.ErrorHandler}/Patches/DialogueErrorPatch.cs (96%)
 rename src/{SMAPI => SMAPI.Mods.ErrorHandler}/Patches/EventErrorPatch.cs (96%)
 rename src/{SMAPI => SMAPI.Mods.ErrorHandler}/Patches/LoadErrorPatch.cs (99%)
 rename src/{SMAPI => SMAPI.Mods.ErrorHandler}/Patches/ObjectErrorPatch.cs (97%)
 rename src/{SMAPI => SMAPI.Mods.ErrorHandler}/Patches/ScheduleErrorPatch.cs (97%)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/de.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/default.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/es.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/fr.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/hu.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/it.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/ja.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/ko.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/pt.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/ru.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/tr.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/zh.json
 create mode 100644 src/SMAPI.Mods.ErrorHandler/manifest.json

diff --git a/build/common.targets b/build/common.targets
index 3d39be23..c9afb27a 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -37,16 +37,24 @@
     <Copy SourceFiles="$(TargetDir)\TMXTile.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\smapi-internal\i18n" />
   </Target>
-  <Target Name="CopyDefaultMods" Condition="'$(MSBuildProjectName)' == 'SMAPI.Mods.ConsoleCommands' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.SaveBackup'">
+
+  <Target Name="CopyDefaultMods" Condition="'$(MSBuildProjectName)' == 'SMAPI.Mods.ConsoleCommands' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.ErrorHandler' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.SaveBackup'">
+    <ItemGroup>
+      <TranslationFiles Include="$(TargetDir)\i18n\*.json" />
+    </ItemGroup>
+
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" Condition="Exists('$(TargetDir)\$(TargetName).pdb')" />
     <Copy SourceFiles="$(TargetDir)\manifest.json" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" />
+    <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)\i18n" />
   </Target>
+
   <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit' AND $(TargetFramework) == 'net4.5'" AfterTargets="PostBuildEvent">
       <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
       <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
       <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
+
   <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces' AND $(TargetFramework) == 'net4.5'" AfterTargets="PostBuildEvent">
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index 7b9d63f9..205040db 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -16,6 +16,7 @@
       <SmapiBin>$(BuildRootPath)\SMAPI\bin\$(Configuration)</SmapiBin>
       <ToolkitBin>$(BuildRootPath)\SMAPI.Toolkit\bin\$(Configuration)\net4.5</ToolkitBin>
       <ConsoleCommandsBin>$(BuildRootPath)\SMAPI.Mods.ConsoleCommands\bin\$(Configuration)</ConsoleCommandsBin>
+      <ErrorHandlerBin>$(BuildRootPath)\SMAPI.Mods.ErrorHandler\bin\$(Configuration)</ErrorHandlerBin>
       <SaveBackupBin>$(BuildRootPath)\SMAPI.Mods.SaveBackup\bin\$(Configuration)</SaveBackupBin>
 
       <PackagePath>$(OutRootPath)\SMAPI installer</PackagePath>
@@ -23,6 +24,7 @@
     </PropertyGroup>
     <ItemGroup>
       <TranslationFiles Include="$(SmapiBin)\i18n\*.json" />
+      <ErrorHandlerTranslationFiles Include="$(ErrorHandlerBin)\i18n\*.json" />
     </ItemGroup>
 
     <!-- reset package directory -->
@@ -64,6 +66,10 @@
     <Copy SourceFiles="$(ConsoleCommandsBin)\ConsoleCommands.dll" DestinationFolder="$(PackagePath)\bundle\Mods\ConsoleCommands" />
     <Copy SourceFiles="$(ConsoleCommandsBin)\ConsoleCommands.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\ConsoleCommands" />
     <Copy SourceFiles="$(ConsoleCommandsBin)\manifest.json" DestinationFolder="$(PackagePath)\bundle\Mods\ConsoleCommands" />
+    <Copy SourceFiles="$(ErrorHandlerBin)\ErrorHandler.dll" DestinationFolder="$(PackagePath)\bundle\Mods\ErrorHandler" />
+    <Copy SourceFiles="$(ErrorHandlerBin)\ErrorHandler.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\ErrorHandler" />
+    <Copy SourceFiles="$(ErrorHandlerBin)\manifest.json" DestinationFolder="$(PackagePath)\bundle\Mods\ErrorHandler" />
+    <Copy SourceFiles="@(ErrorHandlerTranslationFiles)" DestinationFolder="$(PackagePath)\bundle\Mods\ErrorHandler\i18n" />
     <Copy SourceFiles="$(SaveBackupBin)\SaveBackup.dll" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
     <Copy SourceFiles="$(SaveBackupBin)\SaveBackup.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
     <Copy SourceFiles="$(SaveBackupBin)\manifest.json" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
diff --git a/docs/release-notes.md b/docs/release-notes.md
index a2ac8b35..7347560e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For the Error Handler mod:
+  * Added in SMAPI 3.9. This has vanilla error-handling that was previously added by SMAPI directly. That simplifies the core SMAPI logic, and lets players or modders disable it if needed.
+
 ## 3.8.4
 Released 15 January 2021 for Stardew Valley 1.5.3 or later.
 
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
new file mode 100644
index 00000000..fa9338f4
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -0,0 +1,73 @@
+using System.Reflection;
+using StardewModdingAPI.Events;
+using StardewModdingAPI.Framework;
+using StardewModdingAPI.Framework.Logging;
+using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Mods.ErrorHandler.Patches;
+using StardewValley;
+
+namespace StardewModdingAPI.Mods.ErrorHandler
+{
+    /// <summary>The main entry point for the mod.</summary>
+    public class ModEntry : Mod
+    {
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Whether custom content was removed from the save data to avoid a crash.</summary>
+        private bool IsSaveContentRemoved;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>The mod entry point, called after the mod is first loaded.</summary>
+        /// <param name="helper">Provides simplified APIs for writing mods.</param>
+        public override void Entry(IModHelper helper)
+        {
+            // get SMAPI core types
+            SCore core = SCore.Instance;
+            LogManager logManager = core.GetType().GetField("LogManager", BindingFlags.Instance | BindingFlags.NonPublic)?.GetValue(core) as LogManager;
+            if (logManager == null)
+            {
+                this.Monitor.Log($"Can't access SMAPI's internal log manager. Error-handling patches won't be applied.", LogLevel.Error);
+                return;
+            }
+
+            // apply patches
+            new GamePatcher(this.Monitor).Apply(
+                new EventErrorPatch(logManager.MonitorForGame),
+                new DialogueErrorPatch(logManager.MonitorForGame, this.Helper.Reflection),
+                new ObjectErrorPatch(),
+                new LoadErrorPatch(this.Monitor, this.OnSaveContentRemoved),
+                new ScheduleErrorPatch(logManager.MonitorForGame)
+            );
+
+            // hook events
+            this.Helper.Events.GameLoop.SaveLoaded += this.OnSaveLoaded;
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Raised after custom content is removed from the save data to avoid a crash.</summary>
+        internal void OnSaveContentRemoved()
+        {
+            this.IsSaveContentRemoved = true;
+        }
+
+        /// <summary>The method invoked when a save is loaded.</summary>
+        /// <param name="sender">The event sender.</param>
+        /// <param name="e">The event arguments.</param>
+        public void OnSaveLoaded(object sender, SaveLoadedEventArgs e)
+        {
+            // show in-game warning for removed save content
+            if (this.IsSaveContentRemoved)
+            {
+                this.IsSaveContentRemoved = false;
+                Game1.addHUDMessage(new HUDMessage(this.Helper.Translation.Get("warn.invalid-content-removed"), HUDMessage.error_type));
+            }
+        }
+    }
+}
diff --git a/src/SMAPI/Patches/DialogueErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
similarity index 96%
rename from src/SMAPI/Patches/DialogueErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
index 215df561..ba0ca582 100644
--- a/src/SMAPI/Patches/DialogueErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
@@ -2,7 +2,6 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using StardewModdingAPI.Framework.Patching;
-using StardewModdingAPI.Framework.Reflection;
 using StardewValley;
 #if HARMONY_2
 using HarmonyLib;
@@ -12,7 +11,7 @@ using System.Reflection;
 using Harmony;
 #endif
 
-namespace StardewModdingAPI.Patches
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
     /// <summary>A Harmony patch for the <see cref="Dialogue"/> constructor which intercepts invalid dialogue lines and logs an error instead of crashing.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
@@ -27,7 +26,7 @@ namespace StardewModdingAPI.Patches
         private static IMonitor MonitorForGame;
 
         /// <summary>Simplifies access to private code.</summary>
-        private static Reflector Reflection;
+        private static IReflectionHelper Reflection;
 
 
         /*********
@@ -43,7 +42,7 @@ namespace StardewModdingAPI.Patches
         /// <summary>Construct an instance.</summary>
         /// <param name="monitorForGame">Writes messages to the console and log file on behalf of the game.</param>
         /// <param name="reflector">Simplifies access to private code.</param>
-        public DialogueErrorPatch(IMonitor monitorForGame, Reflector reflector)
+        public DialogueErrorPatch(IMonitor monitorForGame, IReflectionHelper reflector)
         {
             DialogueErrorPatch.MonitorForGame = monitorForGame;
             DialogueErrorPatch.Reflection = reflector;
@@ -167,7 +166,7 @@ namespace StardewModdingAPI.Patches
         /// <returns>Returns whether to execute the original method.</returns>
         private static bool Before_NPC_CurrentDialogue(NPC __instance, ref Stack<Dialogue> __result, MethodInfo __originalMethod)
         {
-            const string key = nameof(Before_NPC_CurrentDialogue);
+            const string key = nameof(DialogueErrorPatch.Before_NPC_CurrentDialogue);
             if (!PatchHelper.StartIntercept(key))
                 return true;
 
diff --git a/src/SMAPI/Patches/EventErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/EventErrorPatch.cs
similarity index 96%
rename from src/SMAPI/Patches/EventErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/EventErrorPatch.cs
index 46651387..fabc6cad 100644
--- a/src/SMAPI/Patches/EventErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/EventErrorPatch.cs
@@ -9,7 +9,7 @@ using Harmony;
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
 
-namespace StardewModdingAPI.Patches
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
     /// <summary>A Harmony patch for <see cref="GameLocation.checkEventPrecondition"/> which intercepts invalid preconditions and logs an error instead of crashing.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
@@ -89,7 +89,7 @@ namespace StardewModdingAPI.Patches
         /// <returns>Returns whether to execute the original method.</returns>
         private static bool Before_GameLocation_CheckEventPrecondition(GameLocation __instance, ref int __result, string precondition, MethodInfo __originalMethod)
         {
-            const string key = nameof(Before_GameLocation_CheckEventPrecondition);
+            const string key = nameof(EventErrorPatch.Before_GameLocation_CheckEventPrecondition);
             if (!PatchHelper.StartIntercept(key))
                 return true;
 
diff --git a/src/SMAPI/Patches/LoadErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
similarity index 99%
rename from src/SMAPI/Patches/LoadErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
index f5ee5d71..2227ea07 100644
--- a/src/SMAPI/Patches/LoadErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
@@ -13,7 +13,7 @@ using StardewValley;
 using StardewValley.Buildings;
 using StardewValley.Locations;
 
-namespace StardewModdingAPI.Patches
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
     /// <summary>A Harmony patch for <see cref="SaveGame"/> which prevents some errors due to broken save data.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
diff --git a/src/SMAPI/Patches/ObjectErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
similarity index 97%
rename from src/SMAPI/Patches/ObjectErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
index 64b8e6b6..70f054cd 100644
--- a/src/SMAPI/Patches/ObjectErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
@@ -12,7 +12,7 @@ using System.Reflection;
 using Harmony;
 #endif
 
-namespace StardewModdingAPI.Patches
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
     /// <summary>A Harmony patch for <see cref="SObject.getDescription"/> which intercepts crashes due to the item no longer existing.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
@@ -103,7 +103,7 @@ namespace StardewModdingAPI.Patches
         /// <returns>Returns whether to execute the original method.</returns>
         private static bool Before_Object_loadDisplayName(SObject __instance, ref string __result, MethodInfo __originalMethod)
         {
-            const string key = nameof(Before_Object_loadDisplayName);
+            const string key = nameof(ObjectErrorPatch.Before_Object_loadDisplayName);
             if (!PatchHelper.StartIntercept(key))
                 return true;
 
diff --git a/src/SMAPI/Patches/ScheduleErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
similarity index 97%
rename from src/SMAPI/Patches/ScheduleErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
index 1d58a292..abbd1a8f 100644
--- a/src/SMAPI/Patches/ScheduleErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
@@ -11,7 +11,7 @@ using System.Reflection;
 using Harmony;
 #endif
 
-namespace StardewModdingAPI.Patches
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
     /// <summary>A Harmony patch for <see cref="NPC.parseMasterSchedule"/> which intercepts crashes due to invalid schedule data.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
@@ -90,7 +90,7 @@ namespace StardewModdingAPI.Patches
         /// <returns>Returns whether to execute the original method.</returns>
         private static bool Before_NPC_parseMasterSchedule(string rawData, NPC __instance, ref Dictionary<int, SchedulePathDescription> __result, MethodInfo __originalMethod)
         {
-            const string key = nameof(Before_NPC_parseMasterSchedule);
+            const string key = nameof(ScheduleErrorPatch.Before_NPC_parseMasterSchedule);
             if (!PatchHelper.StartIntercept(key))
                 return true;
 
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
new file mode 100644
index 00000000..5c0cf952
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -0,0 +1,46 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <AssemblyName>ErrorHandler</AssemblyName>
+    <RootNamespace>StardewModdingAPI.Mods.ErrorHandler</RootNamespace>
+    <TargetFramework>net45</TargetFramework>
+    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
+    <PlatformTarget>x86</PlatformTarget>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\SMAPI\SMAPI.csproj" Private="False" />
+    <Reference Include="..\..\build\0Harmony.dll" Private="False" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+  </ItemGroup>
+
+  <Choose>
+    <!-- Windows -->
+    <When Condition="$(OS) == 'Windows_NT'">
+      <ItemGroup>
+        <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
+        <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
+        <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
+        <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
+        <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
+      </ItemGroup>
+    </When>
+
+    <!-- Linux/Mac -->
+    <Otherwise>
+      <ItemGroup>
+        <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
+      </ItemGroup>
+    </Otherwise>
+  </Choose>
+
+  <ItemGroup>
+    <None Update="i18n\*.json" CopyToOutputDirectory="PreserveNewest" />
+    <None Update="manifest.json" CopyToOutputDirectory="PreserveNewest" />
+  </ItemGroup>
+
+  <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
+  <Import Project="..\..\build\common.targets" />
+</Project>
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/de.json b/src/SMAPI.Mods.ErrorHandler/i18n/de.json
new file mode 100644
index 00000000..1de6301c
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/de.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Ungültiger Inhalt wurde entfernt, um einen Absturz zu verhindern (siehe SMAPI Konsole für weitere Informationen)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/default.json b/src/SMAPI.Mods.ErrorHandler/i18n/default.json
new file mode 100644
index 00000000..b74dcea0
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/default.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Invalid content was removed to prevent a crash (see the SMAPI console for info)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/es.json b/src/SMAPI.Mods.ErrorHandler/i18n/es.json
new file mode 100644
index 00000000..8ba10b70
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/es.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Se ha quitado contenido inválido para evitar un cierre forzoso (revisa la consola de SMAPI para más información)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/fr.json b/src/SMAPI.Mods.ErrorHandler/i18n/fr.json
new file mode 100644
index 00000000..76978526
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/fr.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Le contenu non valide a été supprimé afin d'éviter un plantage (voir la console de SMAPI pour plus d'informations)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/hu.json b/src/SMAPI.Mods.ErrorHandler/i18n/hu.json
new file mode 100644
index 00000000..92aca7d0
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/hu.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Érvénytelen elemek kerültek eltávolításra, hogy a játék ne omoljon össze (további információk a SMAPI konzolon)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/it.json b/src/SMAPI.Mods.ErrorHandler/i18n/it.json
new file mode 100644
index 00000000..5182972e
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/it.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Contenuto non valido rimosso per prevenire un crash (Guarda la console di SMAPI per maggiori informazioni)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/ja.json b/src/SMAPI.Mods.ErrorHandler/i18n/ja.json
new file mode 100644
index 00000000..559c7fbe
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/ja.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "クラッシュを防ぐために無効なコンテンツを取り除きました （詳細はSMAPIコンソールを参照）"
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/ko.json b/src/SMAPI.Mods.ErrorHandler/i18n/ko.json
new file mode 100644
index 00000000..48f05c26
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/ko.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "충돌을 방지하기 위해 잘못된 컨텐츠가 제거되었습니다 (자세한 내용은 SMAPI 콘솔 참조)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/pt.json b/src/SMAPI.Mods.ErrorHandler/i18n/pt.json
new file mode 100644
index 00000000..8ea8cec9
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/pt.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Conteúdo inválido foi removido para prevenir uma falha (veja o console do SMAPI para mais informações)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/ru.json b/src/SMAPI.Mods.ErrorHandler/i18n/ru.json
new file mode 100644
index 00000000..e9c3b313
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/ru.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Недопустимое содержимое было удалено, чтобы предотвратить сбой (см. информацию в консоли SMAPI)"
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/tr.json b/src/SMAPI.Mods.ErrorHandler/i18n/tr.json
new file mode 100644
index 00000000..a05ab152
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/tr.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Yanlış paketlenmiş bir içerik, oyunun çökmemesi için yüklenmedi (SMAPI konsol penceresinde detaylı bilgi mevcut)."
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/zh.json b/src/SMAPI.Mods.ErrorHandler/i18n/zh.json
new file mode 100644
index 00000000..e959aa40
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/zh.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "非法内容已移除以防游戏闪退（查看SMAPI控制台获得更多信息）"
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
new file mode 100644
index 00000000..f83e2f96
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -0,0 +1,9 @@
+{
+    "Name": "Error Handler",
+    "Author": "SMAPI",
+    "Version": "3.8.3",
+    "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
+    "UniqueID": "SMAPI.ErrorHandler",
+    "EntryDll": "ErrorHandler.dll",
+    "MinimumApiVersion": "3.8.3"
+}
diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index b7a84fe4..904ae7f4 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -71,6 +71,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.ModBuildConfig.Analyz
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Mods.ConsoleCommands", "SMAPI.Mods.ConsoleCommands\SMAPI.Mods.ConsoleCommands.csproj", "{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Mods.ErrorHandler", "SMAPI.Mods.ErrorHandler\SMAPI.Mods.ErrorHandler.csproj", "{491E775B-EAD0-44D4-B6CA-F1FC3E316D33}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Mods.SaveBackup", "SMAPI.Mods.SaveBackup\SMAPI.Mods.SaveBackup.csproj", "{CD53AD6F-97F4-4872-A212-50C2A0FD3601}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Toolkit", "SMAPI.Toolkit\SMAPI.Toolkit.csproj", "{08184F74-60AD-4EEE-A78C-F4A35ADE6246}"
@@ -83,6 +85,7 @@ Global
 	GlobalSection(SharedMSBuildProjectFiles) = preSolution
 		SMAPI.Internal\SMAPI.Internal.projitems*{0634ea4c-3b8f-42db-aea6-ca9e4ef6e92f}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{0a9bb24f-15ff-4c26-b1a2-81f7ae316518}*SharedItemsImports = 5
+		SMAPI.Internal\SMAPI.Internal.projitems*{491e775b-ead0-44d4-b6ca-f1fc3e316d33}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{80efd92f-728f-41e0-8a5b-9f6f49a91899}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{85208f8d-6fd1-4531-be05-7142490f59fe}*SharedItemsImports = 13
 		SMAPI.Internal\SMAPI.Internal.projitems*{cd53ad6f-97f4-4872-a212-50c2a0fd3601}*SharedItemsImports = 5
@@ -121,6 +124,10 @@ Global
 		{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F}.Release|Any CPU.Build.0 = Release|Any CPU
+		{491E775B-EAD0-44D4-B6CA-F1FC3E316D33}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{491E775B-EAD0-44D4-B6CA-F1FC3E316D33}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{491E775B-EAD0-44D4-B6CA-F1FC3E316D33}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{491E775B-EAD0-44D4-B6CA-F1FC3E316D33}.Release|Any CPU.Build.0 = Release|Any CPU
 		{CD53AD6F-97F4-4872-A212-50C2A0FD3601}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{CD53AD6F-97F4-4872-A212-50C2A0FD3601}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{CD53AD6F-97F4-4872-A212-50C2A0FD3601}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -151,6 +158,7 @@ Global
 		{680B2641-81EA-467C-86A5-0E81CDC57ED0} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
 		{AA95884B-7097-476E-92C8-D0500DE9D6D1} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
 		{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
+		{491E775B-EAD0-44D4-B6CA-F1FC3E316D33} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
 		{CD53AD6F-97F4-4872-A212-50C2A0FD3601} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index f9a36593..00c2de75 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -124,9 +124,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>The maximum number of consecutive attempts SMAPI should make to recover from an update error.</summary>
         private readonly Countdown UpdateCrashTimer = new Countdown(60); // 60 ticks = roughly one second
 
-        /// <summary>Whether custom content was removed from the save data to avoid a crash.</summary>
-        private bool IsSaveContentRemoved;
-
         /// <summary>Asset interceptors added or removed since the last tick.</summary>
         private readonly List<AssetInterceptorChange> ReloadAssetInterceptorsQueue = new List<AssetInterceptorChange>();
 
@@ -145,6 +142,10 @@ namespace StardewModdingAPI.Framework
         /// <remarks>This is initialized after the game starts. This is accessed directly because it's not part of the normal class model.</remarks>
         internal static DeprecationManager DeprecationManager { get; private set; }
 
+        /// <summary>The singleton instance.</summary>
+        /// <remarks>This is only intended for use by external code like the Error Handler mod.</remarks>
+        internal static SCore Instance { get; private set; }
+
         /// <summary>The number of update ticks which have already executed. This is similar to <see cref="Game1.ticks"/>, but incremented more consistently for every tick.</summary>
         internal static uint TicksElapsed { get; private set; }
 
@@ -157,6 +158,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="writeToConsole">Whether to output log messages to the console.</param>
         public SCore(string modsPath, bool writeToConsole)
         {
+            SCore.Instance = this;
+
             // init paths
             this.VerifyPath(modsPath);
             this.VerifyPath(Constants.LogDir);
@@ -245,12 +248,7 @@ namespace StardewModdingAPI.Framework
 
                 // apply game patches
                 new GamePatcher(this.Monitor).Apply(
-                    new EventErrorPatch(this.LogManager.MonitorForGame),
-                    new DialogueErrorPatch(this.LogManager.MonitorForGame, this.Reflection),
-                    new ObjectErrorPatch(),
-                    new LoadContextPatch(this.Reflection, this.OnLoadStageChanged),
-                    new LoadErrorPatch(this.Monitor, this.OnSaveContentRemoved),
-                    new ScheduleErrorPatch(this.LogManager.MonitorForGame)
+                    new LoadContextPatch(this.Reflection, this.OnLoadStageChanged)
                 );
 
                 // add exit handler
@@ -517,15 +515,6 @@ namespace StardewModdingAPI.Framework
                     this.ScreenCommandQueue.GetValueForScreen(screenId).Add(Tuple.Create(command, name, args));
                 }
 
-                /*********
-                ** Show in-game warnings (for main player only)
-                *********/
-                // save content removed
-                if (this.IsSaveContentRemoved && Context.IsWorldReady)
-                {
-                    this.IsSaveContentRemoved = false;
-                    Game1.addHUDMessage(new HUDMessage(this.Translator.Get("warn.invalid-content-removed"), HUDMessage.error_type));
-                }
 
                 /*********
                 ** Run game update
@@ -1105,12 +1094,6 @@ namespace StardewModdingAPI.Framework
             Game1.CustomData[migrationKey] = Constants.ApiVersion.ToString();
         }
 
-        /// <summary>Raised after custom content is removed from the save data to avoid a crash.</summary>
-        internal void OnSaveContentRemoved()
-        {
-            this.IsSaveContentRemoved = true;
-        }
-
         /// <summary>A callback invoked before <see cref="Game1.newDayAfterFade"/> runs.</summary>
         protected void OnNewDayAfterFade()
         {
diff --git a/src/SMAPI/Properties/AssemblyInfo.cs b/src/SMAPI/Properties/AssemblyInfo.cs
index ee8a1674..ae758e9b 100644
--- a/src/SMAPI/Properties/AssemblyInfo.cs
+++ b/src/SMAPI/Properties/AssemblyInfo.cs
@@ -1,4 +1,5 @@
 using System.Runtime.CompilerServices;
 
 [assembly: InternalsVisibleTo("SMAPI.Tests")]
+[assembly: InternalsVisibleTo("ErrorHandler")]
 [assembly: InternalsVisibleTo("DynamicProxyGenAssembly2")] // Moq for unit testing
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 6ba64fe7..f44c422f 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -113,6 +113,7 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "SuppressUpdateChecks": [
         "SMAPI.ConsoleCommands",
+        "SMAPI.ErrorHandler",
         "SMAPI.SaveBackup"
     ]
 }
diff --git a/src/SMAPI/i18n/de.json b/src/SMAPI/i18n/de.json
index a8cbd83b..595c3eff 100644
--- a/src/SMAPI/i18n/de.json
+++ b/src/SMAPI/i18n/de.json
@@ -1,10 +1,6 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Ungültiger Inhalt wurde entfernt, um einen Absturz zu verhindern (siehe SMAPI Konsole für weitere Informationen).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{season}} {{day}}",
     "generic.date-with-year": "{{season}} {{day}} im Jahr {{year}}"
-
 }
diff --git a/src/SMAPI/i18n/default.json b/src/SMAPI/i18n/default.json
index 7a3d3ed5..7e1f9c4d 100644
--- a/src/SMAPI/i18n/default.json
+++ b/src/SMAPI/i18n/default.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Invalid content was removed to prevent a crash (see the SMAPI console for info).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{season}} {{day}}",
diff --git a/src/SMAPI/i18n/es.json b/src/SMAPI/i18n/es.json
index c9843991..76228d7d 100644
--- a/src/SMAPI/i18n/es.json
+++ b/src/SMAPI/i18n/es.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Se ha quitado contenido inválido para evitar un cierre forzoso (revisa la consola de SMAPI para más información).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{seasonLowercase}} {{day}}",
diff --git a/src/SMAPI/i18n/fr.json b/src/SMAPI/i18n/fr.json
index 5969aa20..e32ee712 100644
--- a/src/SMAPI/i18n/fr.json
+++ b/src/SMAPI/i18n/fr.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Le contenu non valide a été supprimé afin d'éviter un plantage (voir la console de SMAPI pour plus d'informations).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{day}} {{seasonLowercase}}",
diff --git a/src/SMAPI/i18n/hu.json b/src/SMAPI/i18n/hu.json
index 785012f4..2e3b7264 100644
--- a/src/SMAPI/i18n/hu.json
+++ b/src/SMAPI/i18n/hu.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Érvénytelen elemek kerültek eltávolításra, hogy a játék ne omoljon össze (további információk a SMAPI konzolon).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{season}} {{day}}",
diff --git a/src/SMAPI/i18n/it.json b/src/SMAPI/i18n/it.json
index 3b3351c3..7ada11f0 100644
--- a/src/SMAPI/i18n/it.json
+++ b/src/SMAPI/i18n/it.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Contenuto non valido rimosso per prevenire un crash (Guarda la console di SMAPI per maggiori informazioni).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{day}} {{season}}",
diff --git a/src/SMAPI/i18n/ja.json b/src/SMAPI/i18n/ja.json
index 1f814bfa..c95ac1b1 100644
--- a/src/SMAPI/i18n/ja.json
+++ b/src/SMAPI/i18n/ja.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "クラッシュを防ぐために無効なコンテンツを取り除きました （詳細はSMAPIコンソールを参照）",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{season}} {{day}}日",
diff --git a/src/SMAPI/i18n/ko.json b/src/SMAPI/i18n/ko.json
index d5bbffa4..8d267e5e 100644
--- a/src/SMAPI/i18n/ko.json
+++ b/src/SMAPI/i18n/ko.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "충돌을 방지하기 위해 잘못된 컨텐츠가 제거되었습니다 (자세한 내용은 SMAPI 콘솔 참조).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{season}} {{day}}",
diff --git a/src/SMAPI/i18n/pt.json b/src/SMAPI/i18n/pt.json
index e8460922..7a08b08f 100644
--- a/src/SMAPI/i18n/pt.json
+++ b/src/SMAPI/i18n/pt.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Conteúdo inválido foi removido para prevenir uma falha (veja o console do SMAPI para mais informações).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{season}} {{day}}",
diff --git a/src/SMAPI/i18n/ru.json b/src/SMAPI/i18n/ru.json
index 002fdbf8..b8ff55c4 100644
--- a/src/SMAPI/i18n/ru.json
+++ b/src/SMAPI/i18n/ru.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Недопустимое содержимое было удалено, чтобы предотвратить сбой (см. информацию в консоли SMAPI)",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{season}}, {{day}}-е число",
diff --git a/src/SMAPI/i18n/tr.json b/src/SMAPI/i18n/tr.json
index 2a6e83a1..e97a48ba 100644
--- a/src/SMAPI/i18n/tr.json
+++ b/src/SMAPI/i18n/tr.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "Yanlış paketlenmiş bir içerik, oyunun çökmemesi için yüklenmedi (SMAPI konsol penceresinde detaylı bilgi mevcut).",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{day}} {{season}}",
diff --git a/src/SMAPI/i18n/zh.json b/src/SMAPI/i18n/zh.json
index cdbe3b74..36d459de 100644
--- a/src/SMAPI/i18n/zh.json
+++ b/src/SMAPI/i18n/zh.json
@@ -1,7 +1,4 @@
 {
-    // error messages
-    "warn.invalid-content-removed": "非法内容已移除以防游戏闪退（查看SMAPI控制台获得更多信息）",
-
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{season}}{{day}}日",

From f945349ed40b770c1f7788f659d4ef3980abe3ff Mon Sep 17 00:00:00 2001
From: David Camp <Bpendragon@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:29 -0500
Subject: [PATCH 052/856] (feat) Disable Mod rewrites if requested

---
 src/SMAPI/Framework/Logging/LogManager.cs     |  5 +++-
 .../Framework/ModLoading/AssemblyLoader.cs    |  9 +++++--
 src/SMAPI/Framework/Models/SConfig.cs         |  6 ++++-
 src/SMAPI/Framework/SCore.cs                  |  4 +--
 src/SMAPI/Metadata/InstructionMetadata.cs     | 25 +++++++++++--------
 src/SMAPI/SMAPI.config.json                   |  6 +++++
 6 files changed, 38 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index e504218b..cc573427 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -286,12 +286,15 @@ namespace StardewModdingAPI.Framework.Logging
         /// <summary>Log details for settings that don't match the default.</summary>
         /// <param name="isDeveloperMode">Whether to enable full console output for developers.</param>
         /// <param name="checkForUpdates">Whether to check for newer versions of SMAPI and mods on startup.</param>
-        public void LogSettingsHeader(bool isDeveloperMode, bool checkForUpdates)
+        /// ///<param name="rewriteMods">Whether to rewrite mods, might need to be false to hook up to the Visual Studio Debugger.</param>
+        public void LogSettingsHeader(bool isDeveloperMode, bool checkForUpdates, bool rewriteMods)
         {
             if (isDeveloperMode)
                 this.Monitor.Log($"You have SMAPI for developers, so the console will be much more verbose. You can disable developer mode by installing the non-developer version of SMAPI, or by editing {Constants.ApiConfigPath}.", LogLevel.Info);
             if (!checkForUpdates)
                 this.Monitor.Log($"You configured SMAPI to not check for updates. Running an old version of SMAPI is not recommended. You can enable update checks by reinstalling SMAPI or editing {Constants.ApiConfigPath}.", LogLevel.Warn);
+            if (!rewriteMods)
+                this.Monitor.Log($"You configured SMAPI to not rewrite potentially broken mods. This is not reccomended except in certain circumstances such as attaching to the Visual Studio debugger. You can enable mod rewrites by reinstalling SMAPI or editing {Constants.ApiConfigPath}.", LogLevel.Warn);
             if (!this.Monitor.WriteToConsole)
                 this.Monitor.Log("Writing to the terminal is disabled because the --no-terminal argument was received. This usually means launching the terminal failed.", LogLevel.Warn);
             this.Monitor.VerboseLog("Verbose logging enabled.");
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 9fb5384e..d6a32621 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -37,6 +37,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>The objects to dispose as part of this instance.</summary>
         private readonly HashSet<IDisposable> Disposables = new HashSet<IDisposable>();
 
+        /// <summary>Whether mods should be re-writen for compatibility.</summary>
+        private readonly bool RewriteMods;
+
 
         /*********
         ** Public methods
@@ -45,10 +48,12 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="targetPlatform">The current game platform.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
         /// <param name="paranoidMode">Whether to detect paranoid mode issues.</param>
-        public AssemblyLoader(Platform targetPlatform, IMonitor monitor, bool paranoidMode)
+        /// <param name="rewriteMods">Whether to rewrite potentially broken mods or not.</param>
+        public AssemblyLoader(Platform targetPlatform, IMonitor monitor, bool paranoidMode, bool rewriteMods)
         {
             this.Monitor = monitor;
             this.ParanoidMode = paranoidMode;
+            this.RewriteMods = rewriteMods;
             this.AssemblyMap = this.TrackForDisposal(Constants.GetAssemblyMap(targetPlatform));
 
             // init resolver
@@ -308,7 +313,7 @@ namespace StardewModdingAPI.Framework.ModLoading
             }
 
             // find or rewrite code
-            IInstructionHandler[] handlers = new InstructionMetadata().GetHandlers(this.ParanoidMode, platformChanged).ToArray();
+            IInstructionHandler[] handlers = new InstructionMetadata().GetHandlers(this.ParanoidMode, platformChanged, this.RewriteMods).ToArray();
             RecursiveRewriter rewriter = new RecursiveRewriter(
                 module: module,
                 rewriteType: (type, replaceWith) =>
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 3a3f6960..a5b27c17 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -20,7 +20,8 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(GitHubProjectName)] = "Pathoschild/SMAPI",
             [nameof(WebApiBaseUrl)] = "https://smapi.io/api/",
             [nameof(VerboseLogging)] = false,
-            [nameof(LogNetworkTraffic)] = false
+            [nameof(LogNetworkTraffic)] = false,
+            [nameof(RewriteMods)] = true
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
@@ -64,6 +65,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
         public string[] SuppressUpdateChecks { get; set; }
 
+        /// <summary>Whether to rewrite mods for compatibility. Should only be set to false to facilitate joining to the Visual Studio Debugger.</summary>
+        public bool RewriteMods { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
+
 
         /********
         ** Public methods
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 00c2de75..06c88851 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -276,7 +276,7 @@ namespace StardewModdingAPI.Framework
 
             // log basic info
             this.LogManager.HandleMarkerFiles();
-            this.LogManager.LogSettingsHeader(this.Settings.DeveloperMode, this.Settings.CheckForUpdates);
+            this.LogManager.LogSettingsHeader(this.Settings.DeveloperMode, this.Settings.CheckForUpdates, this.Settings.RewriteMods);
 
             // set window titles
             this.SetWindowTitles(
@@ -1389,7 +1389,7 @@ namespace StardewModdingAPI.Framework
 
             // load mods
             IList<IModMetadata> skippedMods = new List<IModMetadata>();
-            using (AssemblyLoader modAssemblyLoader = new AssemblyLoader(Constants.Platform, this.Monitor, this.Settings.ParanoidWarnings))
+            using (AssemblyLoader modAssemblyLoader = new AssemblyLoader(Constants.Platform, this.Monitor, this.Settings.ParanoidWarnings, this.Settings.RewriteMods))
             {
                 // init
                 HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 2c1e14ce..1816e7f9 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -27,29 +27,32 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Get rewriters which detect or fix incompatible CIL instructions in mod assemblies.</summary>
         /// <param name="paranoidMode">Whether to detect paranoid mode issues.</param>
         /// <param name="platformChanged">Whether the assembly was rewritten for crossplatform compatibility.</param>
-        public IEnumerable<IInstructionHandler> GetHandlers(bool paranoidMode, bool platformChanged)
+        /// <param name="rewriteMods">Whether to return Rewriters</param>
+        public IEnumerable<IInstructionHandler> GetHandlers(bool paranoidMode, bool platformChanged, bool rewriteMods)
         {
             /****
             ** rewrite CIL to fix incompatible code
             ****/
             // rewrite for crossplatform compatibility
-            if (platformChanged)
-                yield return new MethodParentRewriter(typeof(SpriteBatch), typeof(SpriteBatchFacade));
+            if (rewriteMods)
+            {
+                if (platformChanged)
+                    yield return new MethodParentRewriter(typeof(SpriteBatch), typeof(SpriteBatchFacade));
 
-            // rewrite for Stardew Valley 1.5
-            yield return new FieldReplaceRewriter(typeof(DecoratableLocation), "furniture", typeof(GameLocation), nameof(GameLocation.furniture));
-            yield return new FieldReplaceRewriter(typeof(Farm), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
-            yield return new FieldReplaceRewriter(typeof(MineShaft), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
+                // rewrite for Stardew Valley 1.5
+                yield return new FieldReplaceRewriter(typeof(DecoratableLocation), "furniture", typeof(GameLocation), nameof(GameLocation.furniture));
+                yield return new FieldReplaceRewriter(typeof(Farm), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
+                yield return new FieldReplaceRewriter(typeof(MineShaft), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
 
-            // heuristic rewrites
-            yield return new HeuristicFieldRewriter(this.ValidateReferencesToAssemblies);
-            yield return new HeuristicMethodRewriter(this.ValidateReferencesToAssemblies);
+                // heuristic rewrites
+                yield return new HeuristicFieldRewriter(this.ValidateReferencesToAssemblies);
+                yield return new HeuristicMethodRewriter(this.ValidateReferencesToAssemblies);
 
 #if HARMONY_2
             // rewrite for SMAPI 3.6 (Harmony 1.x => 2.0 update)
             yield return new Harmony1AssemblyRewriter();
 #endif
-
+            }
             /****
             ** detect mod issues
             ****/
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index f44c422f..7b9f76d4 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -68,6 +68,12 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "LogNetworkTraffic": false,
 
+    /**
+    * Whether SMAPI should rewrite mods for compatibility.
+    * Note: This is best left to true unless you are attempting to hook into the Visual Studio Debugger
+    */
+    "RewriteMods": true,
+
     /**
      * The colors to use for text written to the SMAPI console.
      *

From 666f7ad8f9ad431c3f007d84228207e13d2ddbbc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:29 -0500
Subject: [PATCH 053/856] tweak recent changes, update release notes

---
 docs/release-notes.md                            |  3 +++
 src/SMAPI/Framework/Logging/LogManager.cs        | 10 +++++-----
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs |  4 ++--
 src/SMAPI/Framework/Models/SConfig.cs            |  9 +++++----
 src/SMAPI/Metadata/InstructionMetadata.cs        |  7 ++++---
 src/SMAPI/SMAPI.config.json                      | 12 ++++++------
 6 files changed, 25 insertions(+), 20 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7347560e..fabe7572 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For modders:
+  * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This may prevent older mods from loading, but bypasses a Visual Studio crash when debugging.
+
 * For the Error Handler mod:
   * Added in SMAPI 3.9. This has vanilla error-handling that was previously added by SMAPI directly. That simplifies the core SMAPI logic, and lets players or modders disable it if needed.
 
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index cc573427..ff00cff7 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -208,7 +208,7 @@ namespace StardewModdingAPI.Framework.Logging
             // show update alert
             if (File.Exists(Constants.UpdateMarker))
             {
-                string[] rawUpdateFound = File.ReadAllText(Constants.UpdateMarker).Split(new [] { '|' }, 2);
+                string[] rawUpdateFound = File.ReadAllText(Constants.UpdateMarker).Split(new[] { '|' }, 2);
                 if (SemanticVersion.TryParse(rawUpdateFound[0], out ISemanticVersion updateFound))
                 {
                     if (Constants.ApiVersion.IsPrerelease() && updateFound.IsNewerThan(Constants.ApiVersion))
@@ -286,15 +286,15 @@ namespace StardewModdingAPI.Framework.Logging
         /// <summary>Log details for settings that don't match the default.</summary>
         /// <param name="isDeveloperMode">Whether to enable full console output for developers.</param>
         /// <param name="checkForUpdates">Whether to check for newer versions of SMAPI and mods on startup.</param>
-        /// ///<param name="rewriteMods">Whether to rewrite mods, might need to be false to hook up to the Visual Studio Debugger.</param>
+        /// <param name="rewriteMods">Whether to rewrite mods for compatibility.</param>
         public void LogSettingsHeader(bool isDeveloperMode, bool checkForUpdates, bool rewriteMods)
         {
             if (isDeveloperMode)
-                this.Monitor.Log($"You have SMAPI for developers, so the console will be much more verbose. You can disable developer mode by installing the non-developer version of SMAPI, or by editing {Constants.ApiConfigPath}.", LogLevel.Info);
+                this.Monitor.Log("You have SMAPI for developers, so the console will be much more verbose. You can disable developer mode by installing the non-developer version of SMAPI.", LogLevel.Info);
             if (!checkForUpdates)
-                this.Monitor.Log($"You configured SMAPI to not check for updates. Running an old version of SMAPI is not recommended. You can enable update checks by reinstalling SMAPI or editing {Constants.ApiConfigPath}.", LogLevel.Warn);
+                this.Monitor.Log("You configured SMAPI to not check for updates. Running an old version of SMAPI is not recommended. You can enable update checks by reinstalling SMAPI.", LogLevel.Warn);
             if (!rewriteMods)
-                this.Monitor.Log($"You configured SMAPI to not rewrite potentially broken mods. This is not reccomended except in certain circumstances such as attaching to the Visual Studio debugger. You can enable mod rewrites by reinstalling SMAPI or editing {Constants.ApiConfigPath}.", LogLevel.Warn);
+                this.Monitor.Log("You configured SMAPI to not rewrite broken mods. Many older mods may fail to load. You can undo this by reinstalling SMAPI.", LogLevel.Warn);
             if (!this.Monitor.WriteToConsole)
                 this.Monitor.Log("Writing to the terminal is disabled because the --no-terminal argument was received. This usually means launching the terminal failed.", LogLevel.Warn);
             this.Monitor.VerboseLog("Verbose logging enabled.");
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index d6a32621..4fae0f44 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -37,7 +37,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>The objects to dispose as part of this instance.</summary>
         private readonly HashSet<IDisposable> Disposables = new HashSet<IDisposable>();
 
-        /// <summary>Whether mods should be re-writen for compatibility.</summary>
+        /// <summary>Whether to rewrite mods for compatibility.</summary>
         private readonly bool RewriteMods;
 
 
@@ -48,7 +48,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="targetPlatform">The current game platform.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
         /// <param name="paranoidMode">Whether to detect paranoid mode issues.</param>
-        /// <param name="rewriteMods">Whether to rewrite potentially broken mods or not.</param>
+        /// <param name="rewriteMods">Whether to rewrite mods for compatibility.</param>
         public AssemblyLoader(Platform targetPlatform, IMonitor monitor, bool paranoidMode, bool rewriteMods)
         {
             this.Monitor = monitor;
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index a5b27c17..dea08717 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -28,6 +28,7 @@ namespace StardewModdingAPI.Framework.Models
         private static readonly HashSet<string> DefaultSuppressUpdateChecks = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
         {
             "SMAPI.ConsoleCommands",
+            "SMAPI.ErrorHandler",
             "SMAPI.SaveBackup"
         };
 
@@ -56,6 +57,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether SMAPI should log more information about the game context.</summary>
         public bool VerboseLogging { get; set; }
 
+        /// <summary>Whether SMAPI should rewrite mods for compatibility.</summary>
+        public bool RewriteMods { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
+
         /// <summary>Whether SMAPI should log network traffic. Best combined with <see cref="VerboseLogging"/>, which includes network metadata.</summary>
         public bool LogNetworkTraffic { get; set; }
 
@@ -65,14 +69,11 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
         public string[] SuppressUpdateChecks { get; set; }
 
-        /// <summary>Whether to rewrite mods for compatibility. Should only be set to false to facilitate joining to the Visual Studio Debugger.</summary>
-        public bool RewriteMods { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
-
 
         /********
         ** Public methods
         ********/
-        /// <summary>Get the settings which have been customised by the player.</summary>
+        /// <summary>Get the settings which have been customized by the player.</summary>
         public IDictionary<string, object> GetCustomSettings()
         {
             IDictionary<string, object> custom = new Dictionary<string, object>();
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 1816e7f9..d1699636 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -27,7 +27,7 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Get rewriters which detect or fix incompatible CIL instructions in mod assemblies.</summary>
         /// <param name="paranoidMode">Whether to detect paranoid mode issues.</param>
         /// <param name="platformChanged">Whether the assembly was rewritten for crossplatform compatibility.</param>
-        /// <param name="rewriteMods">Whether to return Rewriters</param>
+        /// <param name="rewriteMods">Whether to get handlers which rewrite mods for compatibility.</param>
         public IEnumerable<IInstructionHandler> GetHandlers(bool paranoidMode, bool platformChanged, bool rewriteMods)
         {
             /****
@@ -49,10 +49,11 @@ namespace StardewModdingAPI.Metadata
                 yield return new HeuristicMethodRewriter(this.ValidateReferencesToAssemblies);
 
 #if HARMONY_2
-            // rewrite for SMAPI 3.6 (Harmony 1.x => 2.0 update)
-            yield return new Harmony1AssemblyRewriter();
+                // rewrite for SMAPI 3.x (Harmony 1.x => 2.0 update)
+                yield return new Harmony1AssemblyRewriter();
 #endif
             }
+
             /****
             ** detect mod issues
             ****/
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 7b9f76d4..7a710f14 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -33,6 +33,12 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "DeveloperMode": true,
 
+    /**
+     * Whether SMAPI should rewrite mods for compatibility. This may prevent older mods from
+     * loading, but bypasses a Visual Studio crash when debugging.
+     */
+    "RewriteMods": true,
+
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially
      * sensitive .NET APIs like file or shell access. Note that many mods do this legitimately as
@@ -68,12 +74,6 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "LogNetworkTraffic": false,
 
-    /**
-    * Whether SMAPI should rewrite mods for compatibility.
-    * Note: This is best left to true unless you are attempting to hook into the Visual Studio Debugger
-    */
-    "RewriteMods": true,
-
     /**
      * The colors to use for text written to the SMAPI console.
      *

From 70edec65678fc07200cd817b99f812389d1e97b0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:30 -0500
Subject: [PATCH 054/856] add detailed message for game error when parsing an
 item text description

---
 docs/release-notes.md                         |  1 +
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  3 +-
 .../Patches/UtilityErrorPatches.cs            | 96 +++++++++++++++++++
 3 files changed, 99 insertions(+), 1 deletion(-)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index fabe7572..5409d9ff 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
 
 * For the Error Handler mod:
   * Added in SMAPI 3.9. This has vanilla error-handling that was previously added by SMAPI directly. That simplifies the core SMAPI logic, and lets players or modders disable it if needed.
+  * Added a detailed message for the _Input string was not in a correct format_ error when the game fails to parse an item text description.
 
 ## 3.8.4
 Released 15 January 2021 for Stardew Valley 1.5.3 or later.
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index fa9338f4..2f6f1939 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -40,7 +40,8 @@ namespace StardewModdingAPI.Mods.ErrorHandler
                 new DialogueErrorPatch(logManager.MonitorForGame, this.Helper.Reflection),
                 new ObjectErrorPatch(),
                 new LoadErrorPatch(this.Monitor, this.OnSaveContentRemoved),
-                new ScheduleErrorPatch(logManager.MonitorForGame)
+                new ScheduleErrorPatch(logManager.MonitorForGame),
+                new UtilityErrorPatches()
             );
 
             // hook events
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
new file mode 100644
index 00000000..481c881e
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
@@ -0,0 +1,96 @@
+#if HARMONY_2
+using System;
+using HarmonyLib;
+#else
+using Harmony;
+#endif
+using System;
+using System.Diagnostics.CodeAnalysis;
+using System.Reflection;
+using StardewModdingAPI.Framework.Patching;
+using StardewValley;
+
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
+{
+    /// <summary>A Harmony patch for <see cref="Utility"/> methods to log more detailed errors.</summary>
+    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    internal class UtilityErrorPatches : IHarmonyPatch
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <inheritdoc />
+        public string Name => nameof(UtilityErrorPatches);
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <inheritdoc />
+#if HARMONY_2
+        public void Apply(Harmony harmony)
+        {
+            harmony.Patch(
+                original: AccessTools.Method(typeof(Utility), nameof(Utility.getItemFromStandardTextDescription)),
+                finalizer: new HarmonyMethod(this.GetType(), nameof(UtilityErrorPatches.Finalize_Utility_GetItemFromStandardTextDescription))
+            );
+        }
+#else
+        public void Apply(HarmonyInstance harmony)
+        {
+            harmony.Patch(
+                original: AccessTools.Method(typeof(Utility), nameof(Utility.getItemFromStandardTextDescription)),
+                prefix: new HarmonyMethod(this.GetType(), nameof(UtilityErrorPatches.Before_Utility_GetItemFromStandardTextDescription))
+            );
+        }
+#endif
+
+
+        /*********
+        ** Private methods
+        *********/
+#if HARMONY_2
+        /// <summary>The method to call instead of <see cref="Utility.getItemFromStandardTextDescription"/>.</summary>
+        /// <param name="description">The item text description to parse.</param>
+        /// <param name="delimiter">The delimiter by which to split the text description.</param>
+        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
+        /// <returns>Returns the exception to throw, if any.</returns>
+        private static Exception Finalize_Utility_GetItemFromStandardTextDescription(string description, char delimiter, ref Exception __exception)
+        {
+            return __exception != null
+                ? new FormatException($"Failed to parse item text description \"{description}\" with delimiter \"{delimiter}\".", __exception)
+                : null;
+        }
+#else
+        /// <summary>The method to call instead of <see cref="Utility.getItemFromStandardTextDescription"/>.</summary>
+        /// <param name="__result">The return value of the original method.</param>
+        /// <param name="description">The item text description to parse.</param>
+        /// <param name="who">The player for which the item is being parsed.</param>
+        /// <param name="delimiter">The delimiter by which to split the text description.</param>
+        /// <param name="__originalMethod">The method being wrapped.</param>
+        /// <returns>Returns whether to execute the original method.</returns>
+        private static bool Before_Utility_GetItemFromStandardTextDescription(ref Item __result, string description, Farmer who, char delimiter, MethodInfo __originalMethod)
+        {
+            const string key = nameof(UtilityErrorPatches.Before_Utility_GetItemFromStandardTextDescription);
+            if (!PatchHelper.StartIntercept(key))
+                return true;
+
+            try
+            {
+                __result = (Item)__originalMethod.Invoke(null, new object[] { description, who, delimiter });
+                return false;
+            }
+            catch (TargetInvocationException ex)
+            {
+                throw new FormatException($"Failed to parse item text description \"{description}\" with delimiter \"{delimiter}\".", ex.InnerException);
+            }
+            finally
+            {
+                PatchHelper.StopIntercept(key);
+            }
+        }
+#endif
+    }
+}

From 95ad954fa4b761dd32eefa072622cb1168c4d028 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:30 -0500
Subject: [PATCH 055/856] allow get/setting PerScreen<T> values by screen ID

---
 docs/release-notes.md            |  1 +
 src/SMAPI/Utilities/PerScreen.cs | 23 +++++++++++------------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5409d9ff..be34e653 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For modders:
+  * Expanded `PerScreen<T>` API: you can now get/set the value for any screen.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This may prevent older mods from loading, but bypasses a Visual Studio crash when debugging.
 
 * For the Error Handler mod:
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 89d08e87..1498488b 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -49,20 +49,20 @@ namespace StardewModdingAPI.Utilities
 
         /// <summary>Get the value for a given screen ID, creating it if needed.</summary>
         /// <param name="screenId">The screen ID to check.</param>
-        internal T GetValueForScreen(int screenId)
+        public T GetValueForScreen(int screenId)
         {
-            this.RemoveDeadPlayers();
+            this.RemoveDeadScreens();
             return this.States.TryGetValue(screenId, out T state)
                 ? state
                 : this.States[screenId] = this.CreateNewState();
         }
 
-        /// <summary>Set the value for a given screen ID, creating it if needed.</summary>
+        /// <summary>Set the value for a given screen ID.</summary>
         /// <param name="screenId">The screen ID whose value set.</param>
         /// <param name="value">The value to set.</param>
-        internal void SetValueForScreen(int screenId, T value)
+        public void SetValueForScreen(int screenId, T value)
         {
-            this.RemoveDeadPlayers();
+            this.RemoveDeadScreens();
             this.States[screenId] = value;
         }
 
@@ -70,18 +70,17 @@ namespace StardewModdingAPI.Utilities
         /*********
         ** Private methods
         *********/
-        /// <summary>Remove players who are no longer have a split-screen index.</summary>
-        /// <returns>Returns whether any players were removed.</returns>
-        private void RemoveDeadPlayers()
+        /// <summary>Remove screens which are no longer active.</summary>
+        private void RemoveDeadScreens()
         {
             if (this.LastRemovedScreenId == Context.LastRemovedScreenId)
                 return;
-
             this.LastRemovedScreenId = Context.LastRemovedScreenId;
-            foreach (int id in this.States.Keys.ToArray())
+
+            foreach (var pair in this.States.ToArray())
             {
-                if (!Context.HasScreenId(id))
-                    this.States.Remove(id);
+                if (!Context.HasScreenId(pair.Key))
+                    this.States.Remove(pair.Key);
             }
         }
     }

From a9b99c12069bfabca81a74c83eda7f1325c2522a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:31 -0500
Subject: [PATCH 056/856] allow resetting a PerScreen<T> field

---
 docs/release-notes.md            |  2 +-
 src/SMAPI/Utilities/PerScreen.cs | 25 +++++++++++++++++++------
 2 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index be34e653..deac0bc8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,7 @@
 
 ## Upcoming release
 * For modders:
-  * Expanded `PerScreen<T>` API: you can now get/set the value for any screen.
+  * Expanded `PerScreen<T>` API: you can now get/set the value for any screen, or clear all values.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This may prevent older mods from loading, but bypasses a Visual Studio crash when debugging.
 
 * For the Error Handler mod:
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 1498488b..60406d6b 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -11,10 +11,10 @@ namespace StardewModdingAPI.Utilities
         /*********
         ** Fields
         *********/
-        /// <summary>Create the initial value for a player.</summary>
+        /// <summary>Create the initial value for a screen.</summary>
         private readonly Func<T> CreateNewState;
 
-        /// <summary>The tracked values for each player.</summary>
+        /// <summary>The tracked values for each screen.</summary>
         private readonly IDictionary<int, T> States = new Dictionary<int, T>();
 
         /// <summary>The last <see cref="Context.LastRemovedScreenId"/> value for which this instance was updated.</summary>
@@ -24,8 +24,8 @@ namespace StardewModdingAPI.Utilities
         /*********
         ** Accessors
         *********/
-        /// <summary>The value for the current player.</summary>
-        /// <remarks>The value is initialized the first time it's requested for that player, unless it's set manually first.</remarks>
+        /// <summary>The value for the current screen.</summary>
+        /// <remarks>The value is initialized the first time it's requested for that screen, unless it's set manually first.</remarks>
         public T Value
         {
             get => this.GetValueForScreen(Context.ScreenId);
@@ -41,7 +41,7 @@ namespace StardewModdingAPI.Utilities
             : this(null) { }
 
         /// <summary>Construct an instance.</summary>
-        /// <param name="createNewState">Create the initial state for a player screen.</param>
+        /// <param name="createNewState">Create the initial state for a screen.</param>
         public PerScreen(Func<T> createNewState)
         {
             this.CreateNewState = createNewState ?? (() => default);
@@ -66,6 +66,12 @@ namespace StardewModdingAPI.Utilities
             this.States[screenId] = value;
         }
 
+        /// <summary>Remove all active values.</summary>
+        public void ResetAllScreens()
+        {
+            this.RemoveScreens(p => true);
+        }
+
 
         /*********
         ** Private methods
@@ -77,9 +83,16 @@ namespace StardewModdingAPI.Utilities
                 return;
             this.LastRemovedScreenId = Context.LastRemovedScreenId;
 
+            this.RemoveScreens(id => !Context.HasScreenId(id));
+        }
+
+        /// <summary>Remove screens matching a condition.</summary>
+        /// <param name="shouldRemove">Returns whether a screen ID should be removed.</param>
+        private void RemoveScreens(Func<int, bool> shouldRemove)
+        {
             foreach (var pair in this.States.ToArray())
             {
-                if (!Context.HasScreenId(pair.Key))
+                if (shouldRemove(pair.Key))
                     this.States.Remove(pair.Key);
             }
         }

From 812251e7ae532d7a2f10d46ff366bf19e67e88d0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:31 -0500
Subject: [PATCH 057/856] allow getting all active values from a PerScreen<T>
 field

---
 docs/release-notes.md            | 2 +-
 src/SMAPI/Utilities/PerScreen.cs | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index deac0bc8..c36d80ed 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,7 @@
 
 ## Upcoming release
 * For modders:
-  * Expanded `PerScreen<T>` API: you can now get/set the value for any screen, or clear all values.
+  * Expanded `PerScreen<T>` API: you can now get/set the value for any screen, get all active values, or clear all values.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This may prevent older mods from loading, but bypasses a Visual Studio crash when debugging.
 
 * For the Error Handler mod:
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 60406d6b..20b8fbce 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -47,6 +47,13 @@ namespace StardewModdingAPI.Utilities
             this.CreateNewState = createNewState ?? (() => default);
         }
 
+        /// <summary>Get all active values by screen ID. This doesn't initialize the value for a screen ID if it's not created yet.</summary>
+        public IEnumerable<KeyValuePair<int, T>> GetActiveValues()
+        {
+            this.RemoveDeadScreens();
+            return this.States.ToArray();
+        }
+
         /// <summary>Get the value for a given screen ID, creating it if needed.</summary>
         /// <param name="screenId">The screen ID to check.</param>
         public T GetValueForScreen(int screenId)

From 56ca0f5e81b22eafeaec2c51085a82bda1188121 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:32 -0500
Subject: [PATCH 058/856] add split-screen info to multiplayer peer

---
 docs/release-notes.md                         |  1 +
 .../Framework/Networking/MultiplayerPeer.cs   | 10 +++-
 src/SMAPI/Framework/SGame.cs                  |  4 ++
 src/SMAPI/Framework/SGameRunner.cs            | 22 ++++++++-
 src/SMAPI/Framework/SMultiplayer.cs           | 48 +++++++++++++++++--
 src/SMAPI/IMultiplayerPeer.cs                 |  7 +++
 6 files changed, 84 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c36d80ed..49ee219a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For modders:
   * Expanded `PerScreen<T>` API: you can now get/set the value for any screen, get all active values, or clear all values.
+  * Expanded player info received from multiplayer API/events with new `IsSplitScreen` and `ScreenID` fields.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This may prevent older mods from loading, but bypasses a Visual Studio crash when debugging.
 
 * For the Error Handler mod:
diff --git a/src/SMAPI/Framework/Networking/MultiplayerPeer.cs b/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
index 5eda71f6..3923700f 100644
--- a/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
+++ b/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
@@ -24,9 +24,15 @@ namespace StardewModdingAPI.Framework.Networking
         /// <inheritdoc />
         public bool IsHost { get; }
 
+        /// <inheritdoc />
+        public bool IsSplitScreen => this.ScreenID != null;
+
         /// <inheritdoc />
         public bool HasSmapi => this.ApiVersion != null;
 
+        /// <inheritdoc />
+        public int? ScreenID { get; }
+
         /// <inheritdoc />
         public GamePlatform? Platform { get; }
 
@@ -45,12 +51,14 @@ namespace StardewModdingAPI.Framework.Networking
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="playerID">The player's unique ID.</param>
+        /// <param name="screenID">The player's screen ID, if applicable.</param>
         /// <param name="model">The metadata to copy.</param>
         /// <param name="sendMessage">A method which sends a message to the peer.</param>
         /// <param name="isHost">Whether this is a connection to the host player.</param>
-        public MultiplayerPeer(long playerID, RemoteContextModel model, Action<OutgoingMessage> sendMessage, bool isHost)
+        public MultiplayerPeer(long playerID, int? screenID, RemoteContextModel model, Action<OutgoingMessage> sendMessage, bool isHost)
         {
             this.PlayerID = playerID;
+            this.ScreenID = screenID;
             this.IsHost = isHost;
             if (model != null)
             {
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 42a712ee..634680a0 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -81,6 +81,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>Whether the game is creating the save file and SMAPI has already raised <see cref="IGameLoopEvents.SaveCreating"/>.</summary>
         public bool IsBetweenCreateEvents { get; set; }
 
+        /// <summary>The cached <see cref="Farmer.UniqueMultiplayerID"/> value for this instance's player.</summary>
+        public long? PlayerId { get; private set; }
+
         /// <summary>Construct a content manager to read game content files.</summary>
         /// <remarks>This must be static because the game accesses it before the <see cref="SGame"/> constructor is called.</remarks>
         [NonInstancedStatic]
@@ -167,6 +170,7 @@ namespace StardewModdingAPI.Framework
             try
             {
                 this.OnUpdating(this, gameTime, () => base.Update(gameTime));
+                this.PlayerId = Game1.player?.UniqueMultiplayerID;
             }
             finally
             {
diff --git a/src/SMAPI/Framework/SGameRunner.cs b/src/SMAPI/Framework/SGameRunner.cs
index ae06f513..45e7369c 100644
--- a/src/SMAPI/Framework/SGameRunner.cs
+++ b/src/SMAPI/Framework/SGameRunner.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Events;
@@ -46,6 +47,13 @@ namespace StardewModdingAPI.Framework
         private readonly Action OnGameExiting;
 
 
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>The singleton instance.</summary>
+        public static SGameRunner Instance => (SGameRunner)GameRunner.instance;
+
+
         /*********
         ** Public methods
         *********/
@@ -99,15 +107,24 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <inheritdoc />
-        public override void RemoveGameInstance(Game1 instance)
+        public override void RemoveGameInstance(Game1 gameInstance)
         {
-            base.RemoveGameInstance(instance);
+            base.RemoveGameInstance(gameInstance);
 
             if (this.gameInstances.Count <= 1)
                 EarlyConstants.LogScreenId = null;
             this.UpdateForSplitScreenChanges();
         }
 
+        /// <summary>Get the screen ID for a given player ID, if the player is local.</summary>
+        /// <param name="playerId">The player ID to check.</param>
+        public int? GetScreenId(long playerId)
+        {
+            return this.gameInstances
+                .FirstOrDefault(p => ((SGame)p).PlayerId == playerId)
+                ?.instanceId;
+        }
+
 
         /*********
         ** Protected methods
@@ -136,6 +153,7 @@ namespace StardewModdingAPI.Framework
             this.OnGameUpdating(gameTime, () => base.Update(gameTime));
         }
 
+        /// <summary>Update metadata when a split screen is added or removed.</summary>
         private void UpdateForSplitScreenChanges()
         {
             HashSet<int> oldScreenIds = new HashSet<int>(Context.ActiveScreenIds);
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index 2f89fce9..b2257286 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -196,7 +196,13 @@ namespace StardewModdingAPI.Framework
                         this.Monitor.Log($"Received context for farmhand {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.", LogLevel.Trace);
 
                         // store peer
-                        MultiplayerPeer newPeer = new MultiplayerPeer(message.FarmerID, model, sendMessage, isHost: false);
+                        MultiplayerPeer newPeer = new MultiplayerPeer(
+                            playerID: message.FarmerID,
+                            screenID: this.GetScreenId(message.FarmerID),
+                            model: model,
+                            sendMessage: sendMessage,
+                            isHost: false
+                        );
                         if (this.Peers.ContainsKey(message.FarmerID))
                         {
                             this.Monitor.Log($"Received mod context from farmhand {message.FarmerID}, but the game didn't see them disconnect. This may indicate issues with the network connection.", LogLevel.Info);
@@ -238,7 +244,13 @@ namespace StardewModdingAPI.Framework
                     if (!this.Peers.ContainsKey(message.FarmerID))
                     {
                         this.Monitor.Log($"Received connection for vanilla player {message.FarmerID}.", LogLevel.Trace);
-                        MultiplayerPeer peer = new MultiplayerPeer(message.FarmerID, null, sendMessage, isHost: false);
+                        MultiplayerPeer peer = new MultiplayerPeer(
+                            playerID: message.FarmerID,
+                            screenID: this.GetScreenId(message.FarmerID),
+                            model: null,
+                            sendMessage: sendMessage,
+                            isHost: false
+                        );
                         this.AddPeer(peer, canBeHost: false);
                     }
 
@@ -280,7 +292,13 @@ namespace StardewModdingAPI.Framework
                         this.Monitor.Log($"Received context for {(model?.IsHost == true ? "host" : "farmhand")} {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.", LogLevel.Trace);
 
                         // store peer
-                        MultiplayerPeer peer = new MultiplayerPeer(message.FarmerID, model, sendMessage, isHost: model?.IsHost ?? this.HostPeer == null);
+                        MultiplayerPeer peer = new MultiplayerPeer(
+                            playerID: message.FarmerID,
+                            screenID: this.GetScreenId(message.FarmerID),
+                            model: model,
+                            sendMessage: sendMessage,
+                            isHost: model?.IsHost ?? this.HostPeer == null
+                        );
                         if (peer.IsHost && this.HostPeer != null)
                         {
                             this.Monitor.Log($"Rejected mod context from host player {peer.PlayerID}: already received host data from {(peer.PlayerID == this.HostPeer.PlayerID ? "that player" : $"player {peer.PlayerID}")}.", LogLevel.Error);
@@ -297,7 +315,14 @@ namespace StardewModdingAPI.Framework
                         if (!this.Peers.ContainsKey(message.FarmerID) && this.HostPeer == null)
                         {
                             this.Monitor.Log($"Received connection for vanilla host {message.FarmerID}.", LogLevel.Trace);
-                            this.AddPeer(new MultiplayerPeer(message.FarmerID, null, sendMessage, isHost: true), canBeHost: false);
+                            var peer = new MultiplayerPeer(
+                                playerID: message.FarmerID,
+                                screenID: this.GetScreenId(message.FarmerID),
+                                model: null,
+                                sendMessage: sendMessage,
+                                isHost: true
+                            );
+                            this.AddPeer(peer, canBeHost: false);
                         }
                         resume();
                         break;
@@ -309,7 +334,13 @@ namespace StardewModdingAPI.Framework
                         // store peer
                         if (!this.Peers.TryGetValue(message.FarmerID, out MultiplayerPeer peer))
                         {
-                            peer = new MultiplayerPeer(message.FarmerID, null, sendMessage, isHost: this.HostPeer == null);
+                            peer = new MultiplayerPeer(
+                                playerID: message.FarmerID,
+                                screenID: this.GetScreenId(message.FarmerID),
+                                model: null,
+                                sendMessage: sendMessage,
+                                isHost: this.HostPeer == null
+                            );
                             this.Monitor.Log($"Received connection for vanilla {(peer.IsHost ? "host" : "farmhand")} {message.FarmerID}.", LogLevel.Trace);
                             this.AddPeer(peer, canBeHost: true);
                         }
@@ -505,6 +536,13 @@ namespace StardewModdingAPI.Framework
             }
         }
 
+        /// <summary>Get the screen ID for a given player ID, if the player is local.</summary>
+        /// <param name="playerId">The player ID to check.</param>
+        private int? GetScreenId(long playerId)
+        {
+            return SGameRunner.Instance.GetScreenId(playerId);
+        }
+
         /// <summary>Get all connected player IDs, including the current player.</summary>
         private IEnumerable<long> GetKnownPlayerIDs()
         {
diff --git a/src/SMAPI/IMultiplayerPeer.cs b/src/SMAPI/IMultiplayerPeer.cs
index 0d4d3261..47084174 100644
--- a/src/SMAPI/IMultiplayerPeer.cs
+++ b/src/SMAPI/IMultiplayerPeer.cs
@@ -14,9 +14,16 @@ namespace StardewModdingAPI
         /// <summary>Whether this is a connection to the host player.</summary>
         bool IsHost { get; }
 
+        /// <summary>Whether this a local player on the same computer in split-screen mote.</summary>
+        bool IsSplitScreen { get; }
+
         /// <summary>Whether the player has SMAPI installed.</summary>
         bool HasSmapi { get; }
 
+        /// <summary>The player's screen ID, if applicable.</summary>
+        /// <remarks>See <see cref="Context.ScreenId"/> for details. This is only visible to players in split-screen mode. A remote player won't see this value, even if the other players are in split-screen mode.</remarks>
+        int? ScreenID { get; }
+
         /// <summary>The player's OS platform, if <see cref="HasSmapi"/> is true.</summary>
         GamePlatform? Platform { get; }
 

From 1b52adb4fb6bcbe95f562e51ce914534ca1e64e8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 18:48:32 -0500
Subject: [PATCH 059/856] fix build order for new ErrorHandler project

---
 src/SMAPI.sln | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index 904ae7f4..58228ce9 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -61,6 +61,7 @@ EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Installer", "SMAPI.Installer\SMAPI.Installer.csproj", "{0A9BB24F-15FF-4C26-B1A2-81F7AE316518}"
 	ProjectSection(ProjectDependencies) = postProject
 		{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F} = {0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F}
+		{491E775B-EAD0-44D4-B6CA-F1FC3E316D33} = {491E775B-EAD0-44D4-B6CA-F1FC3E316D33}
 		{CD53AD6F-97F4-4872-A212-50C2A0FD3601} = {CD53AD6F-97F4-4872-A212-50C2A0FD3601}
 		{E6DA2198-7686-4F1D-B312-4A4DC70884C0} = {E6DA2198-7686-4F1D-B312-4A4DC70884C0}
 	EndProjectSection

From a5ba931770cf70b071c00f19dbccb594fb245e06 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 15 Jan 2021 21:18:15 -0500
Subject: [PATCH 060/856] improve JSON validator schema for manifest update
 keys

---
 docs/release-notes.md                       | 3 +++
 src/SMAPI.Web/wwwroot/schemas/manifest.json | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 49ee219a..06a133e8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -17,6 +17,9 @@
   * Added in SMAPI 3.9. This has vanilla error-handling that was previously added by SMAPI directly. That simplifies the core SMAPI logic, and lets players or modders disable it if needed.
   * Added a detailed message for the _Input string was not in a correct format_ error when the game fails to parse an item text description.
 
+* For the web UI:
+  * Fixed JSON validator for manifest files marking some update keys as invalid incorrectly.
+
 ## 3.8.4
 Released 15 January 2021 for Stardew Valley 1.5.3 or later.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/manifest.json b/src/SMAPI.Web/wwwroot/schemas/manifest.json
index 685b515b..0b265201 100644
--- a/src/SMAPI.Web/wwwroot/schemas/manifest.json
+++ b/src/SMAPI.Web/wwwroot/schemas/manifest.json
@@ -99,7 +99,7 @@
             "type": "array",
             "items": {
                 "type": "string",
-                "pattern": "^(Chucklefish:\\d+|Nexus:\\d+|GitHub:[A-Za-z0-9_]+/[A-Za-z0-9_]+|ModDrop:\\d+)$",
+                "pattern": "^(?i)(Chucklefish:\\d+|Nexus:\\d+|GitHub:[A-Za-z0-9_\\-]+/[A-Za-z0-9_\\-]+|ModDrop:\\d+)$",
                 "@errorMessages": {
                     "pattern": "Invalid update key; see https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Manifest#Update_checks for more info."
                 }

From b58d432a22bc39c3135779664293c7beff7b3bd4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Jan 2021 12:21:33 -0500
Subject: [PATCH 061/856] subclass chatbox to log game errors

---
 docs/release-notes.md           |  1 +
 src/SMAPI/Framework/SChatBox.cs | 49 +++++++++++++++++++++++++++++++++
 src/SMAPI/Framework/SCore.cs    |  7 +++++
 3 files changed, 57 insertions(+)
 create mode 100644 src/SMAPI/Framework/SChatBox.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 06a133e8..8fa1c330 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,7 @@
 * For modders:
   * Expanded `PerScreen<T>` API: you can now get/set the value for any screen, get all active values, or clear all values.
   * Expanded player info received from multiplayer API/events with new `IsSplitScreen` and `ScreenID` fields.
+  * Game errors shown in the chatbox are now logged.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This may prevent older mods from loading, but bypasses a Visual Studio crash when debugging.
 
 * For the Error Handler mod:
diff --git a/src/SMAPI/Framework/SChatBox.cs b/src/SMAPI/Framework/SChatBox.cs
new file mode 100644
index 00000000..e000d1cd
--- /dev/null
+++ b/src/SMAPI/Framework/SChatBox.cs
@@ -0,0 +1,49 @@
+using StardewValley;
+using StardewValley.Menus;
+
+namespace StardewModdingAPI.Framework
+{
+    /// <summary>SMAPI's implementation of the chatbox which intercepts errors for logging.</summary>
+    internal class SChatBox : ChatBox
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Encapsulates monitoring and logging.</summary>
+        private readonly IMonitor Monitor;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="monitor">Encapsulates monitoring and logging.</param>
+        public SChatBox(IMonitor monitor)
+        {
+            this.Monitor = monitor;
+        }
+
+        /// <inheritdoc />
+        protected override void runCommand(string command)
+        {
+            this.Monitor.Log($"> chat command: {command}");
+            base.runCommand(command);
+        }
+
+        /// <inheritdoc />
+        public override void receiveChatMessage(long sourceFarmer, int chatKind, LocalizedContentManager.LanguageCode language, string message)
+        {
+            if (chatKind == ChatBox.errorMessage)
+            {
+                // log error
+                this.Monitor.Log(message, LogLevel.Error);
+
+                // add event details if applicable
+                if (Game1.CurrentEvent != null && message.StartsWith("Event script error:"))
+                    this.Monitor.Log($"In event #{Game1.CurrentEvent.id} for location {Game1.currentLocation?.NameOrUniqueName}", LogLevel.Error);
+            }
+
+            base.receiveChatMessage(sourceFarmer, chatKind, language, message);
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 06c88851..1b39065f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1054,6 +1054,13 @@ namespace StardewModdingAPI.Framework
                 this.OnReturnedToTitle();
             }
 
+            // override chatbox
+            if (newStage == LoadStage.Loaded)
+            {
+                Game1.onScreenMenus.Remove(Game1.chatBox);
+                Game1.onScreenMenus.Add(Game1.chatBox = new SChatBox(this.LogManager.MonitorForGame));
+            }
+
             // raise events
             this.EventManager.LoadStageChanged.Raise(new LoadStageChangedEventArgs(oldStage, newStage));
             if (newStage == LoadStage.None)

From 516b2fc010ba9a794297ae74b4c5de321ffd0a70 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Jan 2021 14:57:41 -0500
Subject: [PATCH 062/856] don't send multiplayer broadcasts to players without
 SMAPI

---
 docs/release-notes.md               |  1 +
 src/SMAPI/Framework/SMultiplayer.cs | 34 ++++++++++-------------------
 2 files changed, 13 insertions(+), 22 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8fa1c330..d448c726 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
   * Expanded player info received from multiplayer API/events with new `IsSplitScreen` and `ScreenID` fields.
   * Game errors shown in the chatbox are now logged.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This may prevent older mods from loading, but bypasses a Visual Studio crash when debugging.
+  * Network messages through the multiplayer API are no longer sent to players who don't have SMAPI installed. This reduces unneeded network traffic (since they can't read it anyway) and avoids an error in some cases.
 
 * For the Error Handler mod:
   * Added in SMAPI 3.9. This has vanilla error-handling that was previously added by SMAPI directly. That simplifies the core SMAPI logic, and lets players or modders disable it if needed.
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index b2257286..8e18cc09 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -392,34 +392,24 @@ namespace StardewModdingAPI.Framework
             if (string.IsNullOrWhiteSpace(fromModID))
                 throw new ArgumentNullException(nameof(fromModID));
 
-            // get target players
-            long curPlayerId = Game1.player.UniqueMultiplayerID;
-            bool sendToSelf = false;
-            List<MultiplayerPeer> sendToPeers = new List<MultiplayerPeer>();
-            if (toPlayerIDs == null)
+            // get valid peers
+            var sendToPeers = this.Peers.Values.Where(p => p.HasSmapi).ToList();
+            bool sendToSelf = true;
+
+            // filter by player ID
+            if (toPlayerIDs != null)
             {
-                sendToSelf = true;
-                sendToPeers.AddRange(this.Peers.Values);
-            }
-            else
-            {
-                foreach (long id in toPlayerIDs.Distinct())
-                {
-                    if (id == curPlayerId)
-                        sendToSelf = true;
-                    else if (this.Peers.TryGetValue(id, out MultiplayerPeer peer) && peer.HasSmapi)
-                        sendToPeers.Add(peer);
-                }
+                var ids = new HashSet<long>(toPlayerIDs);
+                sendToPeers.RemoveAll(peer => !ids.Contains(peer.PlayerID));
+                sendToSelf = ids.Contains(Game1.player.UniqueMultiplayerID);
             }
 
             // filter by mod ID
             if (toModIDs != null)
             {
-                HashSet<string> sendToMods = new HashSet<string>(toModIDs, StringComparer.OrdinalIgnoreCase);
-                if (sendToSelf && toModIDs.All(id => this.ModRegistry.Get(id) == null))
-                    sendToSelf = false;
-
-                sendToPeers.RemoveAll(peer => peer.Mods.All(mod => !sendToMods.Contains(mod.ID)));
+                var ids = new HashSet<string>(toModIDs, StringComparer.OrdinalIgnoreCase);
+                sendToPeers.RemoveAll(peer => peer.Mods.All(mod => !ids.Contains(mod.ID)));
+                sendToSelf = sendToSelf && toModIDs.Any(id => this.ModRegistry.Get(id) != null);
             }
 
             // validate recipients

From cfe2c3975f8be62581195fbfffc41528f22b2ee3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Jan 2021 15:06:04 -0500
Subject: [PATCH 063/856] prefer GOG/Steam registry paths when scanning for
 game folder

---
 build/find-game-folder.targets                | 15 +++++++------
 docs/release-notes.md                         |  3 +++
 .../Framework/GameScanning/GameScanner.cs     | 22 +++++++++----------
 3 files changed, 22 insertions(+), 18 deletions(-)

diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index a4200662..02abb54b 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -20,6 +20,14 @@
     </When>
     <When Condition="$(OS) == 'Windows_NT'">
       <PropertyGroup>
+        <!-- registry paths -->
+        <GamePath Condition="!Exists('$(GamePath)')">$([MSBuild]::GetRegistryValueFromView('HKEY_LOCAL_MACHINE\SOFTWARE\GOG.com\Games\1453375253', 'PATH', null, RegistryView.Registry32))</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">$([MSBuild]::GetRegistryValueFromView('HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Steam App 413150', 'InstallLocation', null, RegistryView.Registry64, RegistryView.Registry32))</GamePath>
+
+        <!-- derive from Steam library path -->
+        <_SteamLibraryPath>$([MSBuild]::GetRegistryValueFromView('HKEY_CURRENT_USER\SOFTWARE\Valve\Steam', 'SteamPath', null, RegistryView.Registry32))</_SteamLibraryPath>
+        <GamePath Condition="!Exists('$(GamePath)') AND '$(_SteamLibraryPath)' != ''">$(_SteamLibraryPath)\steamapps\common\Stardew Valley</GamePath>
+
         <!-- default paths -->
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\GalaxyClient\Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\GOG Galaxy\Games\Stardew Valley</GamePath>
@@ -29,13 +37,6 @@
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley</GamePath>
 
-        <!-- registry paths -->
-        <GamePath Condition="!Exists('$(GamePath)')">$([MSBuild]::GetRegistryValueFromView('HKEY_LOCAL_MACHINE\SOFTWARE\GOG.com\Games\1453375253', 'PATH', null, RegistryView.Registry32))</GamePath>
-        <GamePath Condition="!Exists('$(GamePath)')">$([MSBuild]::GetRegistryValueFromView('HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Steam App 413150', 'InstallLocation', null, RegistryView.Registry64, RegistryView.Registry32))</GamePath>
-
-        <!-- derive from Steam library path -->
-        <_SteamLibraryPath>$([MSBuild]::GetRegistryValueFromView('HKEY_CURRENT_USER\SOFTWARE\Valve\Steam', 'SteamPath', null, RegistryView.Registry32))</_SteamLibraryPath>
-        <GamePath Condition="!Exists('$(GamePath)') AND '$(_SteamLibraryPath)' != ''">$(_SteamLibraryPath)\steamapps\common\Stardew Valley</GamePath>
       </PropertyGroup>
     </When>
   </Choose>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index d448c726..663ab667 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Improved game path detection. The installer now prefers the path installed through Steam or GOG Galaxy.
+
 * For modders:
   * Expanded `PerScreen<T>` API: you can now get/set the value for any screen, get all active values, or clear all values.
   * Expanded player info received from multiplayer API/events with new `IsSplitScreen` and `ScreenID` fields.
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index d4c82180..055e3b6d 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -90,14 +90,6 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
 
                 case Platform.Windows:
                     {
-                        // Windows
-                        foreach (string programFiles in new[] { @"C:\Program Files", @"C:\Program Files (x86)" })
-                        {
-                            yield return $@"{programFiles}\GalaxyClient\Games\Stardew Valley";
-                            yield return $@"{programFiles}\GOG Galaxy\Games\Stardew Valley";
-                            yield return $@"{programFiles}\Steam\steamapps\common\Stardew Valley";
-                        }
-
                         // Windows registry
 #if SMAPI_FOR_WINDOWS
                         IDictionary<string, string> registryKeys = new Dictionary<string, string>
@@ -113,10 +105,18 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                         }
 
                         // via Steam library path
-                        string steampath = this.GetCurrentUserRegistryValue(@"Software\Valve\Steam", "SteamPath");
-                        if (steampath != null)
-                            yield return Path.Combine(steampath.Replace('/', '\\'), @"steamapps\common\Stardew Valley");
+                        string steamPath = this.GetCurrentUserRegistryValue(@"Software\Valve\Steam", "SteamPath");
+                        if (steamPath != null)
+                            yield return Path.Combine(steamPath.Replace('/', '\\'), @"steamapps\common\Stardew Valley");
 #endif
+
+                        // Windows
+                        foreach (string programFiles in new[] { @"C:\Program Files", @"C:\Program Files (x86)" })
+                        {
+                            yield return $@"{programFiles}\GalaxyClient\Games\Stardew Valley";
+                            yield return $@"{programFiles}\GOG Galaxy\Games\Stardew Valley";
+                            yield return $@"{programFiles}\Steam\steamapps\common\Stardew Valley";
+                        }
                     }
                     break;
 

From bc71f994ece3943f02f91cdefbbe126cbef5a541 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Jan 2021 15:11:45 -0500
Subject: [PATCH 064/856] improve game path detection

---
 build/find-game-folder.targets                          | 3 ++-
 docs/release-notes.md                                   | 2 +-
 src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs | 3 ++-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index 02abb54b..0a766ad4 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -31,12 +31,13 @@
         <!-- default paths -->
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\GalaxyClient\Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\GOG Galaxy\Games\Stardew Valley</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\GOG Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\Steam\steamapps\common\Stardew Valley</GamePath>
 
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\GalaxyClient\Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\GOG Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley</GamePath>
-
       </PropertyGroup>
     </When>
   </Choose>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 663ab667..bb379898 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,7 @@
 
 ## Upcoming release
 * For players:
-  * Improved game path detection. The installer now prefers the path installed through Steam or GOG Galaxy.
+  * Improved game path detection in the installer. The installer now prefers the path registered by Steam or GOG Galaxy, and can also now detect the default install path for manual GOG installs.
 
 * For modders:
   * Expanded `PerScreen<T>` API: you can now get/set the value for any screen, get all active values, or clear all values.
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 055e3b6d..785daba3 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -110,11 +110,12 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                             yield return Path.Combine(steamPath.Replace('/', '\\'), @"steamapps\common\Stardew Valley");
 #endif
 
-                        // Windows
+                        // default paths
                         foreach (string programFiles in new[] { @"C:\Program Files", @"C:\Program Files (x86)" })
                         {
                             yield return $@"{programFiles}\GalaxyClient\Games\Stardew Valley";
                             yield return $@"{programFiles}\GOG Galaxy\Games\Stardew Valley";
+                            yield return $@"{programFiles}\GOG Games\Stardew Valley";
                             yield return $@"{programFiles}\Steam\steamapps\common\Stardew Valley";
                         }
                     }

From 47df90f67cab0f1903f0214fed4795c8bd181fe0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 18 Jan 2021 18:19:46 -0500
Subject: [PATCH 065/856] merge sections in asset propagator

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 92 +++++++++++------------
 1 file changed, 46 insertions(+), 46 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index bd1cc50e..72130e05 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -373,52 +373,6 @@ namespace StardewModdingAPI.Metadata
                 case "loosesprites\\suspensionbridge": // SuspensionBridge constructor
                     return this.ReloadSuspensionBridges(content, key);
 
-                /****
-                ** Content\TileSheets
-                ****/
-                case "tilesheets\\chairtiles": // Game1.LoadContent
-                    MapSeat.mapChairTexture = content.Load<Texture2D>(key);
-                    return true;
-
-                case "tilesheets\\critters": // Critter constructor
-                    return this.ReloadCritterTextures(content, key) > 0;
-
-                case "tilesheets\\crops": // Game1.LoadContent
-                    Game1.cropSpriteSheet = content.Load<Texture2D>(key);
-                    return true;
-
-                case "tilesheets\\debris": // Game1.LoadContent
-                    Game1.debrisSpriteSheet = content.Load<Texture2D>(key);
-                    return true;
-
-                case "tilesheets\\emotes": // Game1.LoadContent
-                    Game1.emoteSpriteSheet = content.Load<Texture2D>(key);
-                    return true;
-
-                case "tilesheets\\furniture": // Game1.LoadContent
-                    Furniture.furnitureTexture = content.Load<Texture2D>(key);
-                    return true;
-
-                case "tilesheets\\furniturefront": // Game1.LoadContent
-                    Furniture.furnitureFrontTexture = content.Load<Texture2D>(key);
-                    return true;
-
-                case "tilesheets\\projectiles": // Game1.LoadContent
-                    Projectile.projectileSheet = content.Load<Texture2D>(key);
-                    return true;
-
-                case "tilesheets\\rain": // Game1.LoadContent
-                    Game1.rainTexture = content.Load<Texture2D>(key);
-                    return true;
-
-                case "tilesheets\\tools": // Game1.ResetToolSpriteSheet
-                    Game1.ResetToolSpriteSheet();
-                    return true;
-
-                case "tilesheets\\weapons": // Game1.LoadContent
-                    Tool.weaponsTexture = content.Load<Texture2D>(key);
-                    return true;
-
                 /****
                 ** Content\Maps
                 ****/
@@ -469,14 +423,57 @@ namespace StardewModdingAPI.Metadata
                     Bush.texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
                     return true;
 
+                case "tilesheets\\chairtiles": // Game1.LoadContent
+                    MapSeat.mapChairTexture = content.Load<Texture2D>(key);
+                    return true;
+
                 case "tilesheets\\craftables": // Game1.LoadContent
                     Game1.bigCraftableSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
+                case "tilesheets\\critters": // Critter constructor
+                    return this.ReloadCritterTextures(content, key) > 0;
+
+                case "tilesheets\\crops": // Game1.LoadContent
+                    Game1.cropSpriteSheet = content.Load<Texture2D>(key);
+                    return true;
+
+                case "tilesheets\\debris": // Game1.LoadContent
+                    Game1.debrisSpriteSheet = content.Load<Texture2D>(key);
+                    return true;
+
+                case "tilesheets\\emotes": // Game1.LoadContent
+                    Game1.emoteSpriteSheet = content.Load<Texture2D>(key);
+                    return true;
+
                 case "tilesheets\\fruittrees": // FruitTree
                     FruitTree.texture = content.Load<Texture2D>(key);
                     return true;
 
+                case "tilesheets\\furniture": // Game1.LoadContent
+                    Furniture.furnitureTexture = content.Load<Texture2D>(key);
+                    return true;
+
+                case "tilesheets\\furniturefront": // Game1.LoadContent
+                    Furniture.furnitureFrontTexture = content.Load<Texture2D>(key);
+                    return true;
+
+                case "tilesheets\\projectiles": // Game1.LoadContent
+                    Projectile.projectileSheet = content.Load<Texture2D>(key);
+                    return true;
+
+                case "tilesheets\\rain": // Game1.LoadContent
+                    Game1.rainTexture = content.Load<Texture2D>(key);
+                    return true;
+
+                case "tilesheets\\tools": // Game1.ResetToolSpriteSheet
+                    Game1.ResetToolSpriteSheet();
+                    return true;
+
+                case "tilesheets\\weapons": // Game1.LoadContent
+                    Tool.weaponsTexture = content.Load<Texture2D>(key);
+                    return true;
+
                 /****
                 ** Content\TerrainFeatures
                 ****/
@@ -528,6 +525,9 @@ namespace StardewModdingAPI.Metadata
                     return this.ReloadTreeTextures(content, key, Tree.pineTree);
             }
 
+            /****
+            ** Dynamic assets
+            ****/
             // dynamic textures
             if (this.KeyStartsWith(key, "animals\\cat"))
                 return this.ReloadPetOrHorseSprites<Cat>(content, key);

From 9fb6d67417ee3f2db0754b135786e052ae308683 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 18 Jan 2021 18:52:31 -0500
Subject: [PATCH 066/856] add asset propagation for Strings\StringsFromCSFiles

---
 docs/release-notes.md                     | 11 +++++----
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 27 +++++++++++++++++++++++
 2 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index bb379898..9a63de7c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,11 +12,14 @@
   * Improved game path detection in the installer. The installer now prefers the path registered by Steam or GOG Galaxy, and can also now detect the default install path for manual GOG installs.
 
 * For modders:
-  * Expanded `PerScreen<T>` API: you can now get/set the value for any screen, get all active values, or clear all values.
-  * Expanded player info received from multiplayer API/events with new `IsSplitScreen` and `ScreenID` fields.
+  * Improved multiplayer APIs:
+    * `PerScreen<T>` now lets you get/set the value for any screen, get all active values, or clear all values.
+    * Peer data for the multiplayer API/events now includes `IsSplitScreen` and `ScreenID` fields.
+    * Network messages through the multiplayer API are no longer sent to players who don't have SMAPI installed. This reduces unneeded network traffic (since they can't read it anyway) and avoids an error in some cases.
+  * Improved asset propagation:
+    * Added propagation for some `Strings\StringsFromCSFiles` keys (mainly short day names).
+  * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This prevents older mods from loading but bypasses a Visual Studio debugger crash.
   * Game errors shown in the chatbox are now logged.
-  * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This may prevent older mods from loading, but bypasses a Visual Studio crash when debugging.
-  * Network messages through the multiplayer API are no longer sent to players who don't have SMAPI installed. This reduces unneeded network traffic (since they can't read it anyway) and avoids an error in some cases.
 
 * For the Error Handler mod:
   * Added in SMAPI 3.9. This has vanilla error-handling that was previously added by SMAPI directly. That simplifies the core SMAPI logic, and lets players or modders disable it if needed.
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 72130e05..24b578ad 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -408,6 +408,12 @@ namespace StardewModdingAPI.Metadata
                 case "minigames\\titlebuttons": // TitleMenu
                     return this.ReloadTitleButtons(content, key);
 
+                /****
+                ** Content\Strings
+                ****/
+                case "strings\\stringsfromcsfiles":
+                    return this.ReloadStringsFromCsFiles(content);
+
                 /****
                 ** Content\TileSheets
                 ****/
@@ -1028,6 +1034,27 @@ namespace StardewModdingAPI.Metadata
             return true;
         }
 
+        /// <summary>Reload cached translations from the <c>Strings\StringsFromCSFiles</c> asset.</summary>
+        /// <param name="content">The content manager through which to reload the asset.</param>
+        /// <returns>Returns whether any data was reloaded.</returns>
+        /// <remarks>Derived from the <see cref="Game1.TranslateFields"/>.</remarks>
+        private bool ReloadStringsFromCsFiles(LocalizedContentManager content)
+        {
+            Game1.samBandName = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.2156");
+            Game1.elliottBookName = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.2157");
+
+            string[] dayNames = this.Reflection.GetField<string[]>(typeof(Game1), "_shortDayDisplayName").GetValue();
+            dayNames[0] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3042");
+            dayNames[1] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3043");
+            dayNames[2] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3044");
+            dayNames[3] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3045");
+            dayNames[4] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3046");
+            dayNames[5] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3047");
+            dayNames[6] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3048");
+
+            return true;
+        }
+
         /****
         ** Helpers
         ****/

From 00e545715d89f32ab999a3b1f6ae70edec158591 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 18 Jan 2021 23:19:34 -0500
Subject: [PATCH 067/856] reset map overrides when reloading a map (#751)

---
 docs/release-notes.md                     | 1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 1 +
 2 files changed, 2 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9a63de7c..bc50b197 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,6 +18,7 @@
     * Network messages through the multiplayer API are no longer sent to players who don't have SMAPI installed. This reduces unneeded network traffic (since they can't read it anyway) and avoids an error in some cases.
   * Improved asset propagation:
     * Added propagation for some `Strings\StringsFromCSFiles` keys (mainly short day names).
+    * Fixed some town patches not reapplied when the map is reloaded in Stardew Valley 1.5.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This prevents older mods from loading but bypasses a Visual Studio debugger crash.
   * Game errors shown in the chatbox are now logged.
 
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 24b578ad..29c4dc1d 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -785,6 +785,7 @@ namespace StardewModdingAPI.Metadata
         private void ReloadMap(GameLocation location)
         {
             // reset patch caches
+            this.Reflection.GetField<HashSet<string>>(location, "_appliedMapOverrides").GetValue().Clear();
             switch (location)
             {
                 case Town _:

From 5676d94fe655c42e50c27b5eae72b9c96cfc2476 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Jan 2021 01:05:15 -0500
Subject: [PATCH 068/856] reset some missed map cache fields (#751)

---
 docs/release-notes.md                     | 3 ++-
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 5 +++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index bc50b197..8e31b79c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,7 +18,8 @@
     * Network messages through the multiplayer API are no longer sent to players who don't have SMAPI installed. This reduces unneeded network traffic (since they can't read it anyway) and avoids an error in some cases.
   * Improved asset propagation:
     * Added propagation for some `Strings\StringsFromCSFiles` keys (mainly short day names).
-    * Fixed some town patches not reapplied when the map is reloaded in Stardew Valley 1.5.
+    * Fixed some of the game's map changes not reapplied after reloading a map in Stardew Valley 1.5.
+    * Fixed quarry bridge not fixed if the mountain map was reloaded.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This prevents older mods from loading but bypasses a Visual Studio debugger crash.
   * Game errors shown in the chatbox are now logged.
 
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 29c4dc1d..859a1b7a 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -791,6 +791,7 @@ namespace StardewModdingAPI.Metadata
                 case Town _:
                     this.Reflection.GetField<bool>(location, "ccRefurbished").SetValue(false);
                     this.Reflection.GetField<bool>(location, "isShowingDestroyedJoja").SetValue(false);
+                    this.Reflection.GetField<bool>(location, "isShowingSpecialOrdersBoard").SetValue(false);
                     this.Reflection.GetField<bool>(location, "isShowingUpgradedPamHouse").SetValue(false);
                     break;
 
@@ -799,6 +800,10 @@ namespace StardewModdingAPI.Metadata
                 case Forest _:
                     this.Reflection.GetField<bool>(location, "hasShownCCUpgrade").SetValue(false);
                     break;
+
+                case Mountain _:
+                    this.Reflection.GetField<bool>(location, "bridgeRestored").SetValue(false);
+                    break;
             }
 
             // general updates

From ff16a6567b6137b1aafed3470406d5f5884a5bdc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Jan 2021 21:20:25 -0500
Subject: [PATCH 069/856] add multi-key binding API (#744)

---
 docs/release-notes.md                         |   3 +-
 .../Converters/SemanticVersionConverter.cs    |   4 +-
 src/SMAPI.sln.DotSettings                     |   2 +
 src/SMAPI/Framework/SCore.cs                  |   1 +
 src/SMAPI/Framework/SGame.cs                  |  13 ++
 .../Serialization/KeybindConverter.cs         |  89 ++++++++++
 src/SMAPI/Utilities/Keybind.cs                | 131 +++++++++++++++
 src/SMAPI/Utilities/KeybindList.cs            | 152 ++++++++++++++++++
 8 files changed, 392 insertions(+), 3 deletions(-)
 create mode 100644 src/SMAPI/Framework/Serialization/KeybindConverter.cs
 create mode 100644 src/SMAPI/Utilities/Keybind.cs
 create mode 100644 src/SMAPI/Utilities/KeybindList.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8e31b79c..edf4481d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,6 +12,7 @@
   * Improved game path detection in the installer. The installer now prefers the path registered by Steam or GOG Galaxy, and can also now detect the default install path for manual GOG installs.
 
 * For modders:
+  * Added [API for multi-key bindings](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
   * Improved multiplayer APIs:
     * `PerScreen<T>` now lets you get/set the value for any screen, get all active values, or clear all values.
     * Peer data for the multiplayer API/events now includes `IsSplitScreen` and `ScreenID` fields.
@@ -22,9 +23,9 @@
     * Fixed quarry bridge not fixed if the mountain map was reloaded.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This prevents older mods from loading but bypasses a Visual Studio debugger crash.
   * Game errors shown in the chatbox are now logged.
+  * Moved vanilla error-handling into a new Error Handler mod. This simplifies the core SMAPI logic, and lets users disable it if needed.
 
 * For the Error Handler mod:
-  * Added in SMAPI 3.9. This has vanilla error-handling that was previously added by SMAPI directly. That simplifies the core SMAPI logic, and lets players or modders disable it if needed.
   * Added a detailed message for the _Input string was not in a correct format_ error when the game fails to parse an item text description.
 
 * For the web UI:
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
index 3604956b..cf69104d 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
@@ -18,10 +18,10 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         ** Accessors
         *********/
         /// <summary>Get whether this converter can read JSON.</summary>
-        public override bool CanRead => true;
+        public override bool CanRead { get; } = true;
 
         /// <summary>Get whether this converter can write JSON.</summary>
-        public override bool CanWrite => true;
+        public override bool CanWrite { get; } = true;
 
 
         /*********
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index 76e863cc..29d4ade5 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -39,6 +39,8 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hangfire/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=initializers/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Junimo/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Keybind/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=keybinds/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=modder/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=modders/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Mongo/@EntryIndexedValue">True</s:Boolean>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 1b39065f..0c55164c 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -208,6 +208,7 @@ namespace StardewModdingAPI.Framework
             {
                 JsonConverter[] converters = {
                     new ColorConverter(),
+                    new KeybindConverter(),
                     new PointConverter(),
                     new Vector2Converter(),
                     new RectangleConverter()
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 634680a0..af7fa387 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -11,6 +11,7 @@ using StardewModdingAPI.Framework.Input;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.StateTracking.Snapshots;
 using StardewModdingAPI.Framework.Utilities;
+using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.BellsAndWhistles;
 using StardewValley.Locations;
@@ -124,6 +125,18 @@ namespace StardewModdingAPI.Framework
             this.OnUpdating = onUpdating;
         }
 
+        /// <summary>Get the current input state for a button.</summary>
+        /// <param name="button">The button to check.</param>
+        /// <remarks>This is intended for use by <see cref="Keybind"/> and shouldn't be used directly in most cases.</remarks>
+        internal static SButtonState GetInputState(SButton button)
+        {
+            SInputState input = Game1.input as SInputState;
+            if (input == null)
+                throw new InvalidOperationException("SMAPI's input state is not in a ready state yet.");
+
+            return input.GetState(button);
+        }
+
 
         /*********
         ** Protected methods
diff --git a/src/SMAPI/Framework/Serialization/KeybindConverter.cs b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
new file mode 100644
index 00000000..1bc146f8
--- /dev/null
+++ b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
@@ -0,0 +1,89 @@
+using System;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+using StardewModdingAPI.Toolkit.Serialization;
+using StardewModdingAPI.Utilities;
+
+namespace StardewModdingAPI.Framework.Serialization
+{
+    /// <summary>Handles deserialization of <see cref="Keybind"/> and <see cref="KeybindList"/> models.</summary>
+    internal class KeybindConverter : JsonConverter
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <inheritdoc />
+        public override bool CanRead { get; } = true;
+
+        /// <inheritdoc />
+        public override bool CanWrite { get; } = true;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get whether this instance can convert the specified object type.</summary>
+        /// <param name="objectType">The object type.</param>
+        public override bool CanConvert(Type objectType)
+        {
+            return
+                typeof(Keybind).IsAssignableFrom(objectType)
+                || typeof(KeybindList).IsAssignableFrom(objectType);
+        }
+
+        /// <summary>Reads the JSON representation of the object.</summary>
+        /// <param name="reader">The JSON reader.</param>
+        /// <param name="objectType">The object type.</param>
+        /// <param name="existingValue">The object being read.</param>
+        /// <param name="serializer">The calling serializer.</param>
+        public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
+        {
+            string path = reader.Path;
+
+            // validate JSON type
+            if (reader.TokenType != JsonToken.String)
+                throw new SParseException($"Can't parse {nameof(KeybindList)} from {reader.TokenType} node (path: {reader.Path}).");
+
+            // parse raw value
+            string str = JToken.Load(reader).Value<string>();
+            if (objectType == typeof(Keybind))
+            {
+                return Keybind.TryParse(str, out Keybind parsed, out string[] errors)
+                    ? parsed
+                    : throw new SParseException($"Can't parse {nameof(Keybind)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
+            }
+
+            if (objectType == typeof(KeybindList))
+            {
+                return KeybindList.TryParse(str, out KeybindList parsed, out string[] errors)
+                    ? parsed
+                    : throw new SParseException($"Can't parse {nameof(KeybindList)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
+            }
+
+            throw new SParseException($"Can't parse unexpected type {objectType} from {reader.TokenType} node (path: {reader.Path}).");
+        }
+
+        /// <summary>Writes the JSON representation of the object.</summary>
+        /// <param name="writer">The JSON writer.</param>
+        /// <param name="value">The value.</param>
+        /// <param name="serializer">The calling serializer.</param>
+        public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
+        {
+            writer.WriteValue(value?.ToString());
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Read a JSON string.</summary>
+        /// <param name="str">The JSON string value.</param>
+        /// <param name="path">The path to the current JSON node.</param>
+        protected KeybindList ReadString(string str, string path)
+        {
+            return KeybindList.TryParse(str, out KeybindList parsed, out string[] errors)
+                ? parsed
+                : throw new SParseException($"Can't parse {nameof(KeybindList)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
+        }
+    }
+}
diff --git a/src/SMAPI/Utilities/Keybind.cs b/src/SMAPI/Utilities/Keybind.cs
new file mode 100644
index 00000000..9d6cd6ee
--- /dev/null
+++ b/src/SMAPI/Utilities/Keybind.cs
@@ -0,0 +1,131 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using StardewModdingAPI.Framework;
+
+namespace StardewModdingAPI.Utilities
+{
+    /// <summary>A single multi-key binding which can be triggered by the player.</summary>
+    /// <remarks>NOTE: this is part of <see cref="KeybindList"/>, and usually shouldn't be used directly.</remarks>
+    public class Keybind
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The buttons that must be down to activate the keybind.</summary>
+        public SButton[] Buttons { get; }
+
+        /// <summary>Whether any keys are bound.</summary>
+        public bool IsBound { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="buttons">The buttons that must be down to activate the keybind.</param>
+        public Keybind(params SButton[] buttons)
+        {
+            this.Buttons = buttons;
+            this.IsBound = buttons.Any(p => p != SButton.None);
+        }
+
+        /// <summary>Parse a keybind string, if it's valid.</summary>
+        /// <param name="input">The keybind string. See remarks on <see cref="ToString"/> for format details.</param>
+        /// <param name="parsed">The parsed keybind, if valid.</param>
+        /// <param name="errors">The parse errors, if any.</param>
+        public static bool TryParse(string input, out Keybind parsed, out string[] errors)
+        {
+            // empty input
+            if (string.IsNullOrWhiteSpace(input))
+            {
+                parsed = new Keybind(SButton.None);
+                errors = new string[0];
+                return true;
+            }
+
+            // parse buttons
+            string[] rawButtons = input.Split('+');
+            SButton[] buttons = new SButton[rawButtons.Length];
+            List<string> rawErrors = new List<string>();
+            for (int i = 0; i < buttons.Length; i++)
+            {
+                string rawButton = rawButtons[i].Trim();
+                if (string.IsNullOrWhiteSpace(rawButton))
+                    rawErrors.Add("Invalid empty button value");
+                else if (!Enum.TryParse(rawButton, ignoreCase: true, out SButton button))
+                {
+                    string error = $"Invalid button value '{rawButton}'";
+
+                    switch (rawButton.ToLower())
+                    {
+                        case "shift":
+                            error += $" (did you mean {SButton.LeftShift}?)";
+                            break;
+
+                        case "ctrl":
+                        case "control":
+                            error += $" (did you mean {SButton.LeftControl}?)";
+                            break;
+
+                        case "alt":
+                            error += $" (did you mean {SButton.LeftAlt}?)";
+                            break;
+                    }
+
+                    rawErrors.Add(error);
+                }
+                else
+                    buttons[i] = button;
+            }
+
+            // build result
+            if (rawErrors.Any())
+            {
+                parsed = null;
+                errors = rawErrors.ToArray();
+                return false;
+            }
+            else
+            {
+                parsed = new Keybind(buttons);
+                errors = new string[0];
+                return true;
+            }
+        }
+
+        /// <summary>Get the keybind state relative to the previous tick.</summary>
+        public SButtonState GetState()
+        {
+            SButtonState[] states = this.Buttons.Select(SGame.GetInputState).Distinct().ToArray();
+
+            // single state
+            if (states.Length == 1)
+                return states[0];
+
+            // if any key has no state, the whole set wasn't enabled last tick
+            if (states.Contains(SButtonState.None))
+                return SButtonState.None;
+
+            // mix of held + pressed => pressed
+            if (states.All(p => p == SButtonState.Pressed || p == SButtonState.Held))
+                return SButtonState.Pressed;
+
+            // mix of held + released => released
+            if (states.All(p => p == SButtonState.Held || p == SButtonState.Released))
+                return SButtonState.Released;
+
+            // not down last tick or now
+            return SButtonState.None;
+        }
+
+        /// <summary>Get a string representation of the keybind.</summary>
+        /// <remarks>A keybind is serialized to a string like <c>LeftControl + S</c>, where each key is separated with <c>+</c>. The key order is commutative, so <c>LeftControl + S</c> and <c>S + LeftControl</c> are identical.</remarks>
+        public override string ToString()
+        {
+            return this.Buttons.Length > 0
+                ? string.Join(" + ", this.Buttons)
+                : SButton.None.ToString();
+        }
+    }
+}
diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
new file mode 100644
index 00000000..f6933af3
--- /dev/null
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -0,0 +1,152 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using StardewModdingAPI.Toolkit.Serialization;
+
+namespace StardewModdingAPI.Utilities
+{
+    /// <summary>A set of multi-key bindings which can be triggered by the player.</summary>
+    public class KeybindList
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The individual keybinds.</summary>
+        public Keybind[] Keybinds { get; }
+
+        /// <summary>Whether any keys are bound.</summary>
+        public bool IsBound { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="keybinds">The underlying keybinds.</param>
+        /// <remarks>See <see cref="Parse"/> or <see cref="TryParse"/> to parse it from a string representation. You can also use this type directly in your config or JSON data models, and it'll be parsed by SMAPI.</remarks>
+        public KeybindList(params Keybind[] keybinds)
+        {
+            this.Keybinds = keybinds.Where(p => p.IsBound).ToArray();
+            this.IsBound = this.Keybinds.Any();
+        }
+
+        /// <summary>Parse a keybind list from a string, and throw an exception if it's not valid.</summary>
+        /// <param name="input">The keybind string. See remarks on <see cref="ToString"/> for format details.</param>
+        /// <exception cref="FormatException">The <paramref name="input"/> format is invalid.</exception>
+        public static KeybindList Parse(string input)
+        {
+            return KeybindList.TryParse(input, out KeybindList parsed, out string[] errors)
+                ? parsed
+                : throw new SParseException($"Can't parse {nameof(Keybind)} from invalid value '{input}'.\n{string.Join("\n", errors)}");
+        }
+
+        /// <summary>Try to parse a keybind list from a string.</summary>
+        /// <param name="input">The keybind string. See remarks on <see cref="ToString"/> for format details.</param>
+        /// <param name="parsed">The parsed keybind list, if valid.</param>
+        /// <param name="errors">The errors that occurred while parsing the input, if any.</param>
+        public static bool TryParse(string input, out KeybindList parsed, out string[] errors)
+        {
+            // empty input
+            if (string.IsNullOrWhiteSpace(input))
+            {
+                parsed = new KeybindList();
+                errors = new string[0];
+                return true;
+            }
+
+            // parse buttons
+            var rawErrors = new List<string>();
+            var keybinds = new List<Keybind>();
+            foreach (string rawSet in input.Split(','))
+            {
+                if (string.IsNullOrWhiteSpace(rawSet))
+                    continue;
+
+                if (!Keybind.TryParse(rawSet, out Keybind keybind, out string[] curErrors))
+                    rawErrors.AddRange(curErrors);
+                else
+                    keybinds.Add(keybind);
+            }
+
+            // build result
+            if (rawErrors.Any())
+            {
+                parsed = null;
+                errors = rawErrors.ToArray();
+                return false;
+            }
+            else
+            {
+                parsed = new KeybindList(keybinds.ToArray());
+                errors = new string[0];
+                return true;
+            }
+        }
+
+        /// <summary>Get the overall keybind list state relative to the previous tick.</summary>
+        /// <remarks>States are transitive across keybind. For example, if one keybind is 'released' and another is 'pressed', the state of the keybind list is 'held'.</remarks>
+        public SButtonState GetState()
+        {
+            bool wasPressed = false;
+            bool isPressed = false;
+
+            foreach (Keybind keybind in this.Keybinds)
+            {
+                switch (keybind.GetState())
+                {
+                    case SButtonState.Pressed:
+                        isPressed = true;
+                        break;
+
+                    case SButtonState.Held:
+                        wasPressed = true;
+                        isPressed = true;
+                        break;
+
+                    case SButtonState.Released:
+                        wasPressed = true;
+                        break;
+                }
+            }
+
+            if (wasPressed == isPressed)
+            {
+                return wasPressed
+                    ? SButtonState.Held
+                    : SButtonState.None;
+            }
+
+            return wasPressed
+                ? SButtonState.Released
+                : SButtonState.Pressed;
+        }
+
+        /// <summary>Get whether any of the button sets are pressed.</summary>
+        public bool IsDown()
+        {
+            SButtonState state = this.GetState();
+            return state == SButtonState.Pressed || state == SButtonState.Held;
+        }
+
+        /// <summary>Get whether the input binding was just pressed this tick.</summary>
+        public bool JustPressed()
+        {
+            return this.GetState() == SButtonState.Pressed;
+        }
+
+        /// <summary>Get the keybind which is currently down, if any. If there are multiple keybinds down, the first one is returned.</summary>
+        public Keybind GetKeybindCurrentlyDown()
+        {
+            return this.Keybinds.FirstOrDefault(p => p.GetState().IsDown());
+        }
+
+        /// <summary>Get a string representation of the input binding.</summary>
+        /// <remarks>A keybind list is serialized to a string like <c>LeftControl + S, LeftAlt + S</c>, where each multi-key binding is separated with <c>,</c> and the keys within each keybind are separated with <c>+</c>. The key order is commutative, so <c>LeftControl + S</c> and <c>S + LeftControl</c> are identical.</remarks>
+        public override string ToString()
+        {
+            return this.Keybinds.Length > 0
+                ? string.Join(", ", this.Keybinds.Select(p => p.ToString()))
+                : SButton.None.ToString();
+        }
+    }
+}

From 7e280a066db92c74e957e2a694c922d4c3eae017 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Jan 2021 21:47:05 -0500
Subject: [PATCH 070/856] add Input.ButtonsChanged event (#744)

---
 docs/release-notes.md                        |  1 +
 src/SMAPI/Events/ButtonsChangedEventArgs.cs  | 67 ++++++++++++++++++++
 src/SMAPI/Events/IInputEvents.cs             |  3 +
 src/SMAPI/Framework/Events/EventManager.cs   |  4 ++
 src/SMAPI/Framework/Events/ModInputEvents.cs |  7 ++
 src/SMAPI/Framework/SCore.cs                 | 31 +++++----
 6 files changed, 100 insertions(+), 13 deletions(-)
 create mode 100644 src/SMAPI/Events/ButtonsChangedEventArgs.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index edf4481d..5e0e05b6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
 
 * For modders:
   * Added [API for multi-key bindings](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
+  * Added a new [`Input.ButtonsChanged` event](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Events#Input.ButtonsChanged).
   * Improved multiplayer APIs:
     * `PerScreen<T>` now lets you get/set the value for any screen, get all active values, or clear all values.
     * Peer data for the multiplayer API/events now includes `IsSplitScreen` and `ScreenID` fields.
diff --git a/src/SMAPI/Events/ButtonsChangedEventArgs.cs b/src/SMAPI/Events/ButtonsChangedEventArgs.cs
new file mode 100644
index 00000000..dda41692
--- /dev/null
+++ b/src/SMAPI/Events/ButtonsChangedEventArgs.cs
@@ -0,0 +1,67 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using StardewModdingAPI.Framework.Input;
+
+namespace StardewModdingAPI.Events
+{
+    /// <summary>Event arguments when any buttons were pressed or released.</summary>
+    public class ButtonsChangedEventArgs : EventArgs
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The buttons that were pressed, held, or released since the previous tick.</summary>
+        private readonly Lazy<Dictionary<SButtonState, SButton[]>> ButtonsByState;
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The current cursor position.</summary>
+        public ICursorPosition Cursor { get; }
+
+        /// <summary>The buttons which were pressed since the previous tick.</summary>
+        public IEnumerable<SButton> Pressed => this.ButtonsByState.Value[SButtonState.Pressed];
+
+        /// <summary>The buttons which were held since the previous tick.</summary>
+        public IEnumerable<SButton> Held => this.ButtonsByState.Value[SButtonState.Held];
+
+        /// <summary>The buttons which were released since the previous tick.</summary>
+        public IEnumerable<SButton> Released => this.ButtonsByState.Value[SButtonState.Released];
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="cursor">The cursor position.</param>
+        /// <param name="inputState">The game's current input state.</param>
+        internal ButtonsChangedEventArgs(ICursorPosition cursor, SInputState inputState)
+        {
+            this.Cursor = cursor;
+            this.ButtonsByState = new Lazy<Dictionary<SButtonState, SButton[]>>(() => this.GetButtonsByState(inputState));
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get the buttons that were pressed, held, or released since the previous tick.</summary>
+        /// <param name="inputState">The game's current input state.</param>
+        private Dictionary<SButtonState, SButton[]> GetButtonsByState(SInputState inputState)
+        {
+            Dictionary<SButtonState, SButton[]> lookup = inputState.ButtonStates
+                .GroupBy(p => p.Value)
+                .ToDictionary(p => p.Key, p => p.Select(p => p.Key).ToArray());
+
+            foreach (var state in new[] { SButtonState.Pressed, SButtonState.Held, SButtonState.Released })
+            {
+                if (!lookup.ContainsKey(state))
+                    lookup[state] = new SButton[0];
+            }
+
+            return lookup;
+        }
+    }
+}
diff --git a/src/SMAPI/Events/IInputEvents.cs b/src/SMAPI/Events/IInputEvents.cs
index 5c40a438..081c40c0 100644
--- a/src/SMAPI/Events/IInputEvents.cs
+++ b/src/SMAPI/Events/IInputEvents.cs
@@ -5,6 +5,9 @@ namespace StardewModdingAPI.Events
     /// <summary>Events raised when the player provides input using a controller, keyboard, or mouse.</summary>
     public interface IInputEvents
     {
+        /// <summary>Raised after the player presses or releases any buttons on the keyboard, controller, or mouse.</summary>
+        event EventHandler<ButtonsChangedEventArgs> ButtonsChanged;
+
         /// <summary>Raised after the player presses a button on the keyboard, controller, or mouse.</summary>
         event EventHandler<ButtonPressedEventArgs> ButtonPressed;
 
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index 665dbfe3..f4abfffe 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -93,6 +93,9 @@ namespace StardewModdingAPI.Framework.Events
         /****
         ** Input
         ****/
+        /// <summary>Raised after the player presses or releases any buttons on the keyboard, controller, or mouse.</summary>
+        public readonly ManagedEvent<ButtonsChangedEventArgs> ButtonsChanged;
+
         /// <summary>Raised after the player presses a button on the keyboard, controller, or mouse.</summary>
         public readonly ManagedEvent<ButtonPressedEventArgs> ButtonPressed;
 
@@ -212,6 +215,7 @@ namespace StardewModdingAPI.Framework.Events
             this.TimeChanged = ManageEventOf<TimeChangedEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.TimeChanged));
             this.ReturnedToTitle = ManageEventOf<ReturnedToTitleEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.ReturnedToTitle));
 
+            this.ButtonsChanged = ManageEventOf<ButtonsChangedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.ButtonsChanged));
             this.ButtonPressed = ManageEventOf<ButtonPressedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.ButtonPressed));
             this.ButtonReleased = ManageEventOf<ButtonReleasedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.ButtonReleased));
             this.CursorMoved = ManageEventOf<CursorMovedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.CursorMoved), isPerformanceCritical: true);
diff --git a/src/SMAPI/Framework/Events/ModInputEvents.cs b/src/SMAPI/Framework/Events/ModInputEvents.cs
index ab26ab3e..6f423e5d 100644
--- a/src/SMAPI/Framework/Events/ModInputEvents.cs
+++ b/src/SMAPI/Framework/Events/ModInputEvents.cs
@@ -9,6 +9,13 @@ namespace StardewModdingAPI.Framework.Events
         /*********
         ** Accessors
         *********/
+        /// <summary>Raised after the player presses or releases any buttons on the keyboard, controller, or mouse.</summary>
+        public event EventHandler<ButtonsChangedEventArgs> ButtonsChanged
+        {
+            add => this.EventManager.ButtonsChanged.Add(value, this.Mod);
+            remove => this.EventManager.ButtonsChanged.Remove(value);
+        }
+
         /// <summary>Raised after the player presses a button on the keyboard, controller, or mouse.</summary>
         public event EventHandler<ButtonPressedEventArgs> ButtonPressed
         {
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 0c55164c..1ac361cd 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -817,24 +817,29 @@ namespace StardewModdingAPI.Framework
                             }
 
                             // raise input button events
-                            foreach (var pair in inputState.ButtonStates)
+                            if (inputState.ButtonStates.Count > 0)
                             {
-                                SButton button = pair.Key;
-                                SButtonState status = pair.Value;
+                                events.ButtonsChanged.Raise(new ButtonsChangedEventArgs(cursor, inputState));
 
-                                if (status == SButtonState.Pressed)
+                                foreach (var pair in inputState.ButtonStates)
                                 {
-                                    if (this.Monitor.IsVerbose)
-                                        this.Monitor.Log($"Events: button {button} pressed.");
+                                    SButton button = pair.Key;
+                                    SButtonState status = pair.Value;
 
-                                    events.ButtonPressed.Raise(new ButtonPressedEventArgs(button, cursor, inputState));
-                                }
-                                else if (status == SButtonState.Released)
-                                {
-                                    if (this.Monitor.IsVerbose)
-                                        this.Monitor.Log($"Events: button {button} released.");
+                                    if (status == SButtonState.Pressed)
+                                    {
+                                        if (this.Monitor.IsVerbose)
+                                            this.Monitor.Log($"Events: button {button} pressed.");
 
-                                    events.ButtonReleased.Raise(new ButtonReleasedEventArgs(button, cursor, inputState));
+                                        events.ButtonPressed.Raise(new ButtonPressedEventArgs(button, cursor, inputState));
+                                    }
+                                    else if (status == SButtonState.Released)
+                                    {
+                                        if (this.Monitor.IsVerbose)
+                                            this.Monitor.Log($"Events: button {button} released.");
+
+                                        events.ButtonReleased.Raise(new ButtonReleasedEventArgs(button, cursor, inputState));
+                                    }
                                 }
                             }
                         }

From 7e90b1c60aa12d8c552a56738711500cab783be0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Jan 2021 21:47:31 -0500
Subject: [PATCH 071/856] add shortcut method to create a keybind list for a
 single default keybind (#744)

---
 src/SMAPI/Utilities/KeybindList.cs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
index f6933af3..4ae66ab7 100644
--- a/src/SMAPI/Utilities/KeybindList.cs
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -83,6 +83,15 @@ namespace StardewModdingAPI.Utilities
             }
         }
 
+        /// <summary>Get a keybind list for a single keybind.</summary>
+        /// <param name="buttons">The buttons that must be down to activate the keybind.</param>
+        public static KeybindList ForSingle(params SButton[] buttons)
+        {
+            return new KeybindList(
+                new Keybind(buttons)
+            );
+        }
+
         /// <summary>Get the overall keybind list state relative to the previous tick.</summary>
         /// <remarks>States are transitive across keybind. For example, if one keybind is 'released' and another is 'pressed', the state of the keybind list is 'held'.</remarks>
         public SButtonState GetState()

From f251f0d06c2942b53dfd69bb79bf12b16a227503 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Jan 2021 23:14:03 -0500
Subject: [PATCH 072/856] make buttonState.IsDown() extension public (#744)

---
 docs/release-notes.md     | 1 +
 src/SMAPI/SButtonState.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5e0e05b6..5f67641b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -14,6 +14,7 @@
 * For modders:
   * Added [API for multi-key bindings](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
   * Added a new [`Input.ButtonsChanged` event](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Events#Input.ButtonsChanged).
+  * Added a `buttonState.IsDown()` extension.
   * Improved multiplayer APIs:
     * `PerScreen<T>` now lets you get/set the value for any screen, get all active values, or clear all values.
     * Peer data for the multiplayer API/events now includes `IsSplitScreen` and `ScreenID` fields.
diff --git a/src/SMAPI/SButtonState.cs b/src/SMAPI/SButtonState.cs
index 2b78da27..5f3e8d3c 100644
--- a/src/SMAPI/SButtonState.cs
+++ b/src/SMAPI/SButtonState.cs
@@ -17,7 +17,7 @@ namespace StardewModdingAPI
     }
 
     /// <summary>Extension methods for <see cref="SButtonState"/>.</summary>
-    internal static class InputStatusExtensions
+    public static class InputStatusExtensions
     {
         /// <summary>Whether the button was pressed or held.</summary>
         /// <param name="state">The button state.</param>

From e40483aab1f6dbcb89f3a1fd1639fc732fe987fc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Jan 2021 23:50:46 -0500
Subject: [PATCH 073/856] add method to suppress active keybindings (#744)

---
 docs/release-notes.md                         |  8 +++++---
 src/SMAPI/Framework/ModHelpers/InputHelper.cs | 14 ++++++++++++++
 src/SMAPI/IInputHelper.cs                     |  6 ++++++
 3 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5f67641b..83de68e4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,9 +12,11 @@
   * Improved game path detection in the installer. The installer now prefers the path registered by Steam or GOG Galaxy, and can also now detect the default install path for manual GOG installs.
 
 * For modders:
-  * Added [API for multi-key bindings](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
-  * Added a new [`Input.ButtonsChanged` event](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Events#Input.ButtonsChanged).
-  * Added a `buttonState.IsDown()` extension.
+  * Added new input APIs:
+    * Added [API for multi-key bindings](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
+    * Added a new [`Input.ButtonsChanged` event](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Events#Input.ButtonsChanged).
+    * Added a `buttonState.IsDown()` extension.
+    * Added a `helper.Input.SuppressActiveKeybindings` method which suppresses the active buttons in a keybind list.
   * Improved multiplayer APIs:
     * `PerScreen<T>` now lets you get/set the value for any screen, get all active values, or clear all values.
     * Peer data for the multiplayer API/events now includes `IsSplitScreen` and `ScreenID` fields.
diff --git a/src/SMAPI/Framework/ModHelpers/InputHelper.cs b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
index e1317544..88caf4c3 100644
--- a/src/SMAPI/Framework/ModHelpers/InputHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
@@ -1,5 +1,6 @@
 using System;
 using StardewModdingAPI.Framework.Input;
+using StardewModdingAPI.Utilities;
 
 namespace StardewModdingAPI.Framework.ModHelpers
 {
@@ -49,6 +50,19 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.CurrentInputState().OverrideButton(button, setDown: false);
         }
 
+        /// <inheritdoc />
+        public void SuppressActiveKeybinds(KeybindList keybindList)
+        {
+            foreach (Keybind keybind in keybindList.Keybinds)
+            {
+                if (!keybind.GetState().IsDown())
+                    continue;
+
+                foreach (SButton button in keybind.Buttons)
+                    this.Suppress(button);
+            }
+        }
+
         /// <inheritdoc />
         public SButtonState GetState(SButton button)
         {
diff --git a/src/SMAPI/IInputHelper.cs b/src/SMAPI/IInputHelper.cs
index e9768c24..2b907b0d 100644
--- a/src/SMAPI/IInputHelper.cs
+++ b/src/SMAPI/IInputHelper.cs
@@ -1,3 +1,5 @@
+using StardewModdingAPI.Utilities;
+
 namespace StardewModdingAPI
 {
     /// <summary>Provides an API for checking and changing input state.</summary>
@@ -18,6 +20,10 @@ namespace StardewModdingAPI
         /// <param name="button">The button to suppress.</param>
         void Suppress(SButton button);
 
+        /// <summary>Suppress the keybinds which are currently down.</summary>
+        /// <param name="keybindList">The keybind list whose active keybinds to suppress.</param>
+        void SuppressActiveKeybinds(KeybindList keybindList);
+
         /// <summary>Get the state of a button.</summary>
         /// <param name="button">The button to check.</param>
         SButtonState GetState(SButton button);

From 587d60495e01b1bdacc31acc7e15a87d7f441839 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 20 Jan 2021 01:02:49 -0500
Subject: [PATCH 074/856] add unit tests for KeybindList (#744)

---
 src/SMAPI.Tests/Utilities/KeybindListTests.cs | 152 ++++++++++++++++++
 src/SMAPI/Utilities/Keybind.cs                |  10 +-
 src/SMAPI/Utilities/KeybindList.cs            |   2 +-
 3 files changed, 162 insertions(+), 2 deletions(-)
 create mode 100644 src/SMAPI.Tests/Utilities/KeybindListTests.cs

diff --git a/src/SMAPI.Tests/Utilities/KeybindListTests.cs b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
new file mode 100644
index 00000000..0bd6ec17
--- /dev/null
+++ b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
@@ -0,0 +1,152 @@
+using System;
+using System.Collections.Generic;
+using NUnit.Framework;
+using StardewModdingAPI;
+using StardewModdingAPI.Utilities;
+
+namespace SMAPI.Tests.Utilities
+{
+    /// <summary>Unit tests for <see cref="KeybindList"/>.</summary>
+    [TestFixture]
+    internal class KeybindListTests
+    {
+        /*********
+        ** Unit tests
+        *********/
+        /****
+        ** TryParse
+        ****/
+        /// <summary>Assert the parsed fields when constructed from a simple single-key string.</summary>
+        [TestCaseSource(nameof(KeybindListTests.GetAllButtons))]
+        public void TryParse_SimpleValue(SButton button)
+        {
+            // act
+            bool success = KeybindList.TryParse($"{button}", out KeybindList parsed, out string[] errors);
+
+            // assert
+            Assert.IsTrue(success, "Parsing unexpectedly failed.");
+            Assert.IsNotNull(parsed, "The parsed result should not be null.");
+            Assert.AreEqual(parsed.ToString(), $"{button}");
+            Assert.IsNotNull(errors, message: "The errors should never be null.");
+            Assert.IsEmpty(errors, message: "The input bindings incorrectly reported errors.");
+        }
+
+        /// <summary>Assert the parsed fields when constructed from multi-key values.</summary>
+        [TestCase("", ExpectedResult = "None")]
+        [TestCase("    ", ExpectedResult = "None")]
+        [TestCase(null, ExpectedResult = "None")]
+        [TestCase("A + B", ExpectedResult = "A + B")]
+        [TestCase("A+B", ExpectedResult = "A + B")]
+        [TestCase("      A+     B    ", ExpectedResult = "A + B")]
+        [TestCase("a +b", ExpectedResult = "A + B")]
+        [TestCase("a +b, LEFTcontrol + leftALT + LeftSHifT + delete", ExpectedResult = "A + B, LeftControl + LeftAlt + LeftShift + Delete")]
+
+        [TestCase(",", ExpectedResult = "None")]
+        [TestCase("A,", ExpectedResult = "A")]
+        [TestCase(",A", ExpectedResult = "A")]
+        public string TryParse_MultiValues(string input)
+        {
+            // act
+            bool success = KeybindList.TryParse(input, out KeybindList parsed, out string[] errors);
+
+            // assert
+            Assert.IsTrue(success, "Parsing unexpectedly failed.");
+            Assert.IsNotNull(parsed, "The parsed result should not be null.");
+            Assert.IsNotNull(errors, message: "The errors should never be null.");
+            Assert.IsEmpty(errors, message: "The input bindings incorrectly reported errors.");
+            return parsed.ToString();
+        }
+
+        /// <summary>Assert invalid values are rejected.</summary>
+        [TestCase("+", "Invalid empty button value")]
+        [TestCase("A+", "Invalid empty button value")]
+        [TestCase("+C", "Invalid empty button value")]
+        [TestCase("A + B +, C", "Invalid empty button value")]
+        [TestCase("A, TotallyInvalid", "Invalid button value 'TotallyInvalid'")]
+        [TestCase("A + TotallyInvalid", "Invalid button value 'TotallyInvalid'")]
+        public void TryParse_InvalidValues(string input, string expectedError)
+        {
+            // act
+            bool success = KeybindList.TryParse(input, out KeybindList parsed, out string[] errors);
+
+            // assert
+            Assert.IsFalse(success, "Parsing unexpectedly succeeded.");
+            Assert.IsNull(parsed, "The parsed result should be null.");
+            Assert.IsNotNull(errors, message: "The errors should never be null.");
+            Assert.AreEqual(expectedError, string.Join("; ", errors), "The errors don't match the expected ones.");
+        }
+
+
+        /****
+        ** GetState
+        ****/
+        /// <summary>Assert that <see cref="KeybindList.GetState"/> returns the expected result for a given input state.</summary>
+        // single value
+        [TestCase("A", "A:Held", ExpectedResult = SButtonState.Held)]
+        [TestCase("A", "A:Pressed", ExpectedResult = SButtonState.Pressed)]
+        [TestCase("A", "A:Released", ExpectedResult = SButtonState.Released)]
+        [TestCase("A", "A:None", ExpectedResult = SButtonState.None)]
+
+        // multiple values
+        [TestCase("A + B + C, D", "A:Released, B:None, C:None, D:Pressed", ExpectedResult = SButtonState.Pressed)] // right pressed => pressed
+        [TestCase("A + B + C, D", "A:Pressed, B:Held, C:Pressed, D:None", ExpectedResult = SButtonState.Pressed)] // left pressed => pressed
+        [TestCase("A + B + C, D", "A:Pressed, B:Pressed, C:Released, D:None", ExpectedResult = SButtonState.None)] // one key released but other keys weren't down last tick => none
+        [TestCase("A + B + C, D", "A:Held, B:Held, C:Released, D:None", ExpectedResult = SButtonState.Released)] // all three keys were down last tick and now one is released => released
+
+        // transitive
+        [TestCase("A, B", "A: Released, B: Pressed", ExpectedResult = SButtonState.Held)]
+        public SButtonState GetState(string input, string stateMap)
+        {
+            // act
+            bool success = KeybindList.TryParse(input, out KeybindList parsed, out string[] errors);
+            if (success && parsed?.Keybinds != null)
+            {
+                foreach (var keybind in parsed.Keybinds)
+#pragma warning disable 618 // method is marked obsolete because it should only be used in unit tests
+                    keybind.GetButtonState = key => this.GetStateFromMap(key, stateMap);
+#pragma warning restore 618
+            }
+
+            // assert
+            Assert.IsTrue(success, "Parsing unexpected failed");
+            Assert.IsNotNull(parsed, "The parsed result should not be null.");
+            Assert.IsNotNull(errors, message: "The errors should never be null.");
+            Assert.IsEmpty(errors, message: "The input bindings incorrectly reported errors.");
+            return parsed.GetState();
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get all defined buttons.</summary>
+        private static IEnumerable<SButton> GetAllButtons()
+        {
+            foreach (SButton button in Enum.GetValues(typeof(SButton)))
+                yield return button;
+        }
+
+        /// <summary>Get the button state defined by a mapping string.</summary>
+        /// <param name="button">The button to check.</param>
+        /// <param name="stateMap">The state map.</param>
+        private SButtonState GetStateFromMap(SButton button, string stateMap)
+        {
+            foreach (string rawPair in stateMap.Split(','))
+            {
+                // parse values
+                string[] parts = rawPair.Split(new[] { ':' }, 2);
+                if (!Enum.TryParse(parts[0], ignoreCase: true, out SButton curButton))
+                    Assert.Fail($"The state map is invalid: unknown button value '{parts[0].Trim()}'");
+                if (!Enum.TryParse(parts[1], ignoreCase: true, out SButtonState state))
+                    Assert.Fail($"The state map is invalid: unknown state value '{parts[1].Trim()}'");
+
+                // get state
+                if (curButton == button)
+                    return state;
+            }
+
+            Assert.Fail($"The state map doesn't define button value '{button}'.");
+            return SButtonState.None;
+        }
+    }
+}
diff --git a/src/SMAPI/Utilities/Keybind.cs b/src/SMAPI/Utilities/Keybind.cs
index 9d6cd6ee..dd8d2861 100644
--- a/src/SMAPI/Utilities/Keybind.cs
+++ b/src/SMAPI/Utilities/Keybind.cs
@@ -9,6 +9,14 @@ namespace StardewModdingAPI.Utilities
     /// <remarks>NOTE: this is part of <see cref="KeybindList"/>, and usually shouldn't be used directly.</remarks>
     public class Keybind
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Get the current input state for a button.</summary>
+        [Obsolete("This property should only be used for unit tests.")]
+        internal Func<SButton, SButtonState> GetButtonState { get; set; } = SGame.GetInputState;
+
+
         /*********
         ** Accessors
         *********/
@@ -97,7 +105,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get the keybind state relative to the previous tick.</summary>
         public SButtonState GetState()
         {
-            SButtonState[] states = this.Buttons.Select(SGame.GetInputState).Distinct().ToArray();
+            SButtonState[] states = this.Buttons.Select(this.GetButtonState).Distinct().ToArray();
 
             // single state
             if (states.Length == 1)
diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
index 4ae66ab7..1845285a 100644
--- a/src/SMAPI/Utilities/KeybindList.cs
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -72,7 +72,7 @@ namespace StardewModdingAPI.Utilities
             if (rawErrors.Any())
             {
                 parsed = null;
-                errors = rawErrors.ToArray();
+                errors = rawErrors.Distinct().ToArray();
                 return false;
             }
             else

From 48f6857892ee4e075422f27a7aa5b78bea6b04e0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 20 Jan 2021 01:22:29 -0500
Subject: [PATCH 075/856] fix null handling in keybind list parsing (#744)

---
 .../Serialization/KeybindConverter.cs         | 57 ++++++++-----------
 1 file changed, 25 insertions(+), 32 deletions(-)

diff --git a/src/SMAPI/Framework/Serialization/KeybindConverter.cs b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
index 1bc146f8..7c5db3ad 100644
--- a/src/SMAPI/Framework/Serialization/KeybindConverter.cs
+++ b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
@@ -40,27 +40,34 @@ namespace StardewModdingAPI.Framework.Serialization
         {
             string path = reader.Path;
 
-            // validate JSON type
-            if (reader.TokenType != JsonToken.String)
-                throw new SParseException($"Can't parse {nameof(KeybindList)} from {reader.TokenType} node (path: {reader.Path}).");
-
-            // parse raw value
-            string str = JToken.Load(reader).Value<string>();
-            if (objectType == typeof(Keybind))
+            switch (reader.TokenType)
             {
-                return Keybind.TryParse(str, out Keybind parsed, out string[] errors)
-                    ? parsed
-                    : throw new SParseException($"Can't parse {nameof(Keybind)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
-            }
+                case JsonToken.Null:
+                    return objectType == typeof(Keybind)
+                        ? new Keybind()
+                        : new KeybindList();
 
-            if (objectType == typeof(KeybindList))
-            {
-                return KeybindList.TryParse(str, out KeybindList parsed, out string[] errors)
-                    ? parsed
-                    : throw new SParseException($"Can't parse {nameof(KeybindList)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
-            }
+                case JsonToken.String:
+                    {
+                        string str = JToken.Load(reader).Value<string>();
 
-            throw new SParseException($"Can't parse unexpected type {objectType} from {reader.TokenType} node (path: {reader.Path}).");
+                        if (objectType == typeof(Keybind))
+                        {
+                            return Keybind.TryParse(str, out Keybind parsed, out string[] errors)
+                                ? parsed
+                                : throw new SParseException($"Can't parse {nameof(Keybind)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
+                        }
+                        else
+                        {
+                            return KeybindList.TryParse(str, out KeybindList parsed, out string[] errors)
+                                ? parsed
+                                : throw new SParseException($"Can't parse {nameof(KeybindList)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
+                        }
+                    }
+
+                default:
+                    throw new SParseException($"Can't parse {objectType} from unexpected {reader.TokenType} node (path: {reader.Path}).");
+            }
         }
 
         /// <summary>Writes the JSON representation of the object.</summary>
@@ -71,19 +78,5 @@ namespace StardewModdingAPI.Framework.Serialization
         {
             writer.WriteValue(value?.ToString());
         }
-
-
-        /*********
-        ** Private methods
-        *********/
-        /// <summary>Read a JSON string.</summary>
-        /// <param name="str">The JSON string value.</param>
-        /// <param name="path">The path to the current JSON node.</param>
-        protected KeybindList ReadString(string str, string path)
-        {
-            return KeybindList.TryParse(str, out KeybindList parsed, out string[] errors)
-                ? parsed
-                : throw new SParseException($"Can't parse {nameof(KeybindList)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
-        }
     }
 }

From 4d95030ee9338bf68a9b50ec4482280d3b441c20 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 20 Jan 2021 09:31:18 -0500
Subject: [PATCH 076/856] correct links

---
 docs/release-notes.md                                     | 4 ++--
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 83de68e4..5688982e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,8 +13,8 @@
 
 * For modders:
   * Added new input APIs:
-    * Added [API for multi-key bindings](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
-    * Added a new [`Input.ButtonsChanged` event](https://stardewcommunitywiki.com/Modding:Modder_Guide/APIs/Events#Input.ButtonsChanged).
+    * Added [API for multi-key bindings](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
+    * Added a new [`Input.ButtonsChanged` event](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Input.ButtonsChanged).
     * Added a `buttonState.IsDown()` extension.
     * Added a `helper.Input.SuppressActiveKeybindings` method which suppresses the active buttons in a keybind list.
   * Improved multiplayer APIs:
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 3db3856f..665c019b 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -414,7 +414,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
                         int loadedIndex = this.TryFindTilesheet(loadedMap, vanillaSheet.Id);
                         string reason = loadedIndex != -1
-                            ? $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewcommunitywiki.com/Modding:Maps#Tilesheet_order for help."
+                            ? $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewvalleywiki.com/Modding:Maps#Tilesheet_order for help."
                             : $"mod has no tilesheet with ID '{vanillaSheet.Id}'. Map replacements must keep the original tilesheets to avoid errors or crashes.";
 
                         SCore.DeprecationManager.PlaceholderWarn("3.8.2", DeprecationLevel.PendingRemoval);

From 49666ac5bcfc0ffb2b8e2b8f2a274f90b67232d2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 20 Jan 2021 22:13:12 -0500
Subject: [PATCH 077/856] fix SDV 1.5 compatibility with content packs that
 still load XNB maps

---
 docs/release-notes.md                             |  1 +
 .../ContentManagers/ModContentManager.cs          | 15 ++++++++++-----
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5688982e..279e43d2 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Improved game path detection in the installer. The installer now prefers the path registered by Steam or GOG Galaxy, and can also now detect the default install path for manual GOG installs.
+  * Fixed compatibility for very old content packs which still load maps from `.xnb` files. These were broken by map loading changes in Stardew Valley 1.5, but SMAPI now corrects them automatically.
 
 * For modders:
   * Added new input APIs:
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 753ec188..1456d3c1 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -127,7 +127,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                             if (asset is Map map)
                             {
                                 map.assetPath = assetName;
-                                this.FixTilesheetPaths(map, relativeMapPath: assetName);
+                                this.FixTilesheetPaths(map, relativeMapPath: assetName, fixEagerPathPrefixes: true);
                             }
                         }
                         break;
@@ -168,7 +168,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                             FormatManager formatManager = FormatManager.Instance;
                             Map map = formatManager.LoadMap(file.FullName);
                             map.assetPath = assetName;
-                            this.FixTilesheetPaths(map, relativeMapPath: assetName);
+                            this.FixTilesheetPaths(map, relativeMapPath: assetName, fixEagerPathPrefixes: false);
                             asset = (T)(object)map;
                         }
                         break;
@@ -260,8 +260,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Fix custom map tilesheet paths so they can be found by the content manager.</summary>
         /// <param name="map">The map whose tilesheets to fix.</param>
         /// <param name="relativeMapPath">The relative map path within the mod folder.</param>
+        /// <param name="fixEagerPathPrefixes">Whether to undo the game's eager tilesheet path prefixing for maps loaded from an <c>.xnb</c> file, which incorrectly prefixes tilesheet paths with the map's local asset key folder.</param>
         /// <exception cref="ContentLoadException">A map tilesheet couldn't be resolved.</exception>
-        private void FixTilesheetPaths(Map map, string relativeMapPath)
+        private void FixTilesheetPaths(Map map, string relativeMapPath, bool fixEagerPathPrefixes)
         {
             // get map info
             relativeMapPath = this.AssertAndNormalizeAssetName(relativeMapPath); // Mono's Path.GetDirectoryName doesn't handle Windows dir separators
@@ -270,12 +271,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // fix tilesheets
             foreach (TileSheet tilesheet in map.TileSheets)
             {
+                // get image source
                 tilesheet.ImageSource = this.NormalizePathSeparators(tilesheet.ImageSource);
-
                 string imageSource = tilesheet.ImageSource;
-                string errorPrefix = $"{this.ModName} loaded map '{relativeMapPath}' with invalid tilesheet path '{imageSource}'.";
+
+                // reverse incorrect eager tilesheet path prefixing
+                if (fixEagerPathPrefixes && relativeMapFolder.Length > 0 && imageSource.StartsWith(relativeMapFolder))
+                    imageSource = imageSource.Substring(relativeMapFolder.Length + 1);
 
                 // validate tilesheet path
+                string errorPrefix = $"{this.ModName} loaded map '{relativeMapPath}' with invalid tilesheet path '{imageSource}'.";
                 if (Path.IsPathRooted(imageSource) || PathUtilities.GetSegments(imageSource).Contains(".."))
                     throw new SContentLoadException($"{errorPrefix} Tilesheet paths must be a relative path without directory climbing (../).");
 

From 342fc80394ac2d1bd67fb1b745b8ddec927fac49 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 20 Jan 2021 23:22:24 -0500
Subject: [PATCH 078/856] rewrite C# 9 code not supported in Linux build tools
 yet

---
 src/SMAPI.Toolkit/SemanticVersion.cs                 | 12 ++++++------
 src/SMAPI/Framework/SCore.cs                         |  2 +-
 src/SMAPI/Framework/SMultiplayer.cs                  |  4 ++--
 .../Framework/Serialization/KeybindConverter.cs      |  2 +-
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index d58dce0c..2f3e282b 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -293,12 +293,12 @@ namespace StardewModdingAPI.Toolkit
                 return string.Compare(this.ToString(), new SemanticVersion(otherMajor, otherMinor, otherPatch, otherPlatformRelease, otherTag).ToString(), StringComparison.OrdinalIgnoreCase);
             }
 
-            return CompareToRaw() switch
-            {
-                (< 0) => curOlder,
-                (> 0) => curNewer,
-                _ => same
-            };
+            int result = CompareToRaw();
+            if (result < 0)
+                return curOlder;
+            if (result > 0)
+                return curNewer;
+            return same;
         }
 
         /// <summary>Assert that the current version is valid.</summary>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 1ac361cd..cd094ff4 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -132,7 +132,7 @@ namespace StardewModdingAPI.Framework
         private readonly ConcurrentQueue<string> RawCommandQueue = new ConcurrentQueue<string>();
 
         /// <summary>A list of commands to execute on each screen.</summary>
-        private readonly PerScreen<List<Tuple<Command, string, string[]>>> ScreenCommandQueue = new(() => new());
+        private readonly PerScreen<List<Tuple<Command, string, string[]>>> ScreenCommandQueue = new PerScreen<List<Tuple<Command, string, string[]>>>(() => new List<Tuple<Command, string, string[]>>());
 
 
         /*********
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index 8e18cc09..5956b63f 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -56,10 +56,10 @@ namespace StardewModdingAPI.Framework
         private readonly bool LogNetworkTraffic;
 
         /// <summary>The backing field for <see cref="Peers"/>.</summary>
-        private readonly PerScreen<IDictionary<long, MultiplayerPeer>> PeersImpl = new(() => new Dictionary<long, MultiplayerPeer>());
+        private readonly PerScreen<IDictionary<long, MultiplayerPeer>> PeersImpl = new PerScreen<IDictionary<long, MultiplayerPeer>>(() => new Dictionary<long, MultiplayerPeer>());
 
         /// <summary>The backing field for <see cref="HostPeer"/>.</summary>
-        private readonly PerScreen<MultiplayerPeer> HostPeerImpl = new();
+        private readonly PerScreen<MultiplayerPeer> HostPeerImpl = new PerScreen<MultiplayerPeer>();
 
 
         /*********
diff --git a/src/SMAPI/Framework/Serialization/KeybindConverter.cs b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
index 7c5db3ad..93a274a8 100644
--- a/src/SMAPI/Framework/Serialization/KeybindConverter.cs
+++ b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
@@ -44,7 +44,7 @@ namespace StardewModdingAPI.Framework.Serialization
             {
                 case JsonToken.Null:
                     return objectType == typeof(Keybind)
-                        ? new Keybind()
+                        ? (object)new Keybind()
                         : new KeybindList();
 
                 case JsonToken.String:

From ebc8cd4c7f068cb687c8786623b8b617e5295e82 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 20 Jan 2021 23:28:48 -0500
Subject: [PATCH 079/856] add ErrorHandler to bundled mod list

---
 src/SMAPI.Installer/InteractiveInstaller.cs | 3 ++-
 src/SMAPI.Mods.ErrorHandler/manifest.json   | 4 ++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 035ec382..ff74a659 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -28,7 +28,8 @@ namespace StardewModdingApi.Installer
         /// <summary>The mod IDs which the installer should allow as bundled mods.</summary>
         private readonly string[] BundledModIDs = {
             "SMAPI.SaveBackup",
-            "SMAPI.ConsoleCommands"
+            "SMAPI.ConsoleCommands",
+            "SMAPI.ErrorHandler"
         };
 
         /// <summary>Get the absolute file or folder paths to remove when uninstalling SMAPI.</summary>
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index f83e2f96..3394da53 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.8.3",
+    "Version": "3.8.4",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.8.3"
+    "MinimumApiVersion": "3.8.4"
 }

From 7fc7a45102f856e84de36fdc5acc0bcb4d99afbb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 21 Jan 2021 19:01:57 -0500
Subject: [PATCH 080/856] fix some broken mods incorrectly listed as XNB mods

---
 docs/release-notes.md                         |  5 ++-
 .../Framework/ModScanning/ModScanner.cs       | 37 +++++++++++++------
 2 files changed, 29 insertions(+), 13 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 279e43d2..7e3e48e5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,8 +9,11 @@
 
 ## Upcoming release
 * For players:
-  * Improved game path detection in the installer. The installer now prefers the path registered by Steam or GOG Galaxy, and can also now detect the default install path for manual GOG installs.
+  * Improved game detection in the installer:
+    * The installer now prefers paths registered by Steam or GOG Galaxy.
+    * The installer now detects default manual GOG installs.
   * Fixed compatibility for very old content packs which still load maps from `.xnb` files. These were broken by map loading changes in Stardew Valley 1.5, but SMAPI now corrects them automatically.
+  * Fixed some broken mods incorrectly listed as XNB mods under 'skipped mods'.
 
 * For modders:
   * Added new input APIs:
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 5eacee9e..b2f09431 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -58,16 +58,18 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             ".lnk"
         };
 
-        /// <summary>The extensions for files which an XNB mod may contain. If a mod doesn't have a <c>manifest.json</c> and contains *only* these file extensions, it should be considered an XNB mod.</summary>
-        private readonly HashSet<string> PotentialXnbModExtensions = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
+        /// <summary>The extensions for packed content files.</summary>
+        private readonly HashSet<string> StrictXnbModExtensions = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
         {
-            // XNB files
             ".xgs",
             ".xnb",
             ".xsb",
-            ".xwb",
+            ".xwb"
+        };
 
-            // unpacking artifacts
+        /// <summary>The extensions for files which an XNB mod may contain, in addition to <see cref="StrictXnbModExtensions"/>.</summary>
+        private readonly HashSet<string> PotentialXnbModExtensions = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
+        {
             ".json",
             ".yaml"
         };
@@ -118,7 +120,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
                     return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.EmptyFolder, "it's an empty folder.");
 
                 // XNB mod
-                if (files.All(this.IsPotentialXnbFile))
+                if (this.IsXnbMod(files))
                     return new ModFolder(root, searchFolder, ModType.Xnb, null, ModParseError.XnbMod, "it's not a SMAPI mod (see https://smapi.io/xnb for info).");
 
                 // SMAPI installer
@@ -302,14 +304,25 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             return !this.IgnoreFilesystemNames.Any(p => p.IsMatch(entry.Name));
         }
 
-        /// <summary>Get whether a file is potentially part of an XNB mod.</summary>
-        /// <param name="entry">The file.</param>
-        private bool IsPotentialXnbFile(FileInfo entry)
+        /// <summary>Get whether a set of files looks like an XNB mod.</summary>
+        /// <param name="files">The files in the mod.</param>
+        private bool IsXnbMod(IEnumerable<FileInfo> files)
         {
-            if (!this.IsRelevant(entry))
-                return true;
+            bool hasXnbFile = false;
 
-            return this.PotentialXnbModExtensions.Contains(entry.Extension); // use EndsWith to handle cases like image..png
+            foreach (FileInfo file in files.Where(this.IsRelevant))
+            {
+                if (this.StrictXnbModExtensions.Contains(file.Extension))
+                {
+                    hasXnbFile = true;
+                    continue;
+                }
+
+                if (!this.PotentialXnbModExtensions.Contains(file.Extension))
+                    return false;
+            }
+
+            return hasXnbFile;
         }
 
         /// <summary>Strip newlines from a string.</summary>

From 546012da8c6ab5e29f34926cda47756d6d18c326 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 21 Jan 2021 19:04:34 -0500
Subject: [PATCH 081/856] add clearer error for empty Vortex folders to reduce
 confusion

---
 docs/release-notes.md                         |  1 +
 .../Framework/ModScanning/ModParseError.cs    |  3 ++
 .../Framework/ModScanning/ModScanner.cs       | 49 ++++++++++++++++---
 3 files changed, 45 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7e3e48e5..58bc2826 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,6 +12,7 @@
   * Improved game detection in the installer:
     * The installer now prefers paths registered by Steam or GOG Galaxy.
     * The installer now detects default manual GOG installs.
+  * Added clearer error when Vortex creates an empty mod folder.
   * Fixed compatibility for very old content packs which still load maps from `.xnb` files. These were broken by map loading changes in Stardew Valley 1.5, but SMAPI now corrects them automatically.
   * Fixed some broken mods incorrectly listed as XNB mods under 'skipped mods'.
 
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModParseError.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModParseError.cs
index b10510ff..f1e782b6 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModParseError.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModParseError.cs
@@ -9,6 +9,9 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         /// <summary>The folder is empty or contains only ignored files.</summary>
         EmptyFolder,
 
+        /// <summary>The folder is an empty folder managed by Vortex.</summary>
+        EmptyVortexFolder,
+
         /// <summary>The folder is ignored by convention.</summary>
         IgnoredFolder,
 
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index b2f09431..86a97016 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -74,6 +74,12 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             ".yaml"
         };
 
+        /// <summary>The name of the marker file added by Vortex to indicate it's managing the folder.</summary>
+        private readonly string VortexMarkerFileName = "__folder_managed_by_vortex";
+
+        /// <summary>The name for a mod's configuration JSON file.</summary>
+        private readonly string ConfigFileName = "config.json";
+
 
         /*********
         ** Public methods
@@ -113,18 +119,24 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             // set appropriate invalid-mod error
             if (manifestFile == null)
             {
-                FileInfo[] files = this.RecursivelyGetRelevantFiles(searchFolder).ToArray();
+                FileInfo[] files = this.RecursivelyGetFiles(searchFolder).ToArray();
+                FileInfo[] relevantFiles = files.Where(this.IsRelevant).ToArray();
+
+                // empty Vortex folder
+                // (this filters relevant files internally so it can check for the normally-ignored Vortex marker file)
+                if (this.IsEmptyVortexFolder(files))
+                    return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.EmptyVortexFolder, "it's an empty Vortex folder (is the mod disabled in Vortex?).");
 
                 // empty folder
-                if (!files.Any())
+                if (!relevantFiles.Any())
                     return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.EmptyFolder, "it's an empty folder.");
 
                 // XNB mod
-                if (this.IsXnbMod(files))
+                if (this.IsXnbMod(relevantFiles))
                     return new ModFolder(root, searchFolder, ModType.Xnb, null, ModParseError.XnbMod, "it's not a SMAPI mod (see https://smapi.io/xnb for info).");
 
                 // SMAPI installer
-                if (files.Any(p => p.Name == "install on Linux.sh" || p.Name == "install on Mac.command" || p.Name == "install on Windows.bat"))
+                if (relevantFiles.Any(p => p.Name == "install on Linux.sh" || p.Name == "install on Mac.command" || p.Name == "install on Windows.bat"))
                     return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.ManifestMissing, "the SMAPI installer isn't a mod (you can delete this folder after running the installer file).");
 
                 // not a mod?
@@ -272,13 +284,13 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             return subfolders.Any() && !files.Any();
         }
 
-        /// <summary>Recursively get all relevant files in a folder based on the result of <see cref="IsRelevant"/>.</summary>
+        /// <summary>Recursively get all files in a folder.</summary>
         /// <param name="folder">The root folder to search.</param>
-        private IEnumerable<FileInfo> RecursivelyGetRelevantFiles(DirectoryInfo folder)
+        private IEnumerable<FileInfo> RecursivelyGetFiles(DirectoryInfo folder)
         {
             foreach (FileSystemInfo entry in folder.GetFileSystemInfos())
             {
-                if (!this.IsRelevant(entry))
+                if (entry is DirectoryInfo && !this.IsRelevant(entry))
                     continue;
 
                 if (entry is FileInfo file)
@@ -286,7 +298,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 
                 if (entry is DirectoryInfo subfolder)
                 {
-                    foreach (FileInfo subfolderFile in this.RecursivelyGetRelevantFiles(subfolder))
+                    foreach (FileInfo subfolderFile in this.RecursivelyGetFiles(subfolder))
                         yield return subfolderFile;
                 }
             }
@@ -325,6 +337,27 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             return hasXnbFile;
         }
 
+        /// <summary>Get whether a set of files looks like an XNB mod.</summary>
+        /// <param name="files">The files in the mod.</param>
+        private bool IsEmptyVortexFolder(IEnumerable<FileInfo> files)
+        {
+            bool hasVortexMarker = false;
+
+            foreach (FileInfo file in files)
+            {
+                if (file.Name == this.VortexMarkerFileName)
+                {
+                    hasVortexMarker = true;
+                    continue;
+                }
+
+                if (this.IsRelevant(file) && file.Name != this.ConfigFileName)
+                    return false;
+            }
+
+            return hasVortexMarker;
+        }
+
         /// <summary>Strip newlines from a string.</summary>
         /// <param name="input">The input to strip.</param>
         private string StripNewlines(string input)

From 8fd2a6fd3a3de037055ccd8ec350c92ba2cdda9d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 22 Jan 2021 20:17:01 -0500
Subject: [PATCH 082/856] update for new map override logic in SDV 1.5.4

Special thanks to the Stardew Valley developers for making the requested changes!
---
 docs/release-notes.md                     |  4 +++-
 src/SMAPI/Constants.cs                    |  2 +-
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 26 ++---------------------
 3 files changed, 6 insertions(+), 26 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 58bc2826..0d5fdea4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,10 +9,12 @@
 
 ## Upcoming release
 * For players:
+  * Updated for Stardew Valley 1.5.4.
   * Improved game detection in the installer:
     * The installer now prefers paths registered by Steam or GOG Galaxy.
     * The installer now detects default manual GOG installs.
   * Added clearer error when Vortex creates an empty mod folder.
+  * Fixed various cases where the game's map changes wouldn't be reapplied correctly after mods changed the map.
   * Fixed compatibility for very old content packs which still load maps from `.xnb` files. These were broken by map loading changes in Stardew Valley 1.5, but SMAPI now corrects them automatically.
   * Fixed some broken mods incorrectly listed as XNB mods under 'skipped mods'.
 
@@ -28,7 +30,7 @@
     * Network messages through the multiplayer API are no longer sent to players who don't have SMAPI installed. This reduces unneeded network traffic (since they can't read it anyway) and avoids an error in some cases.
   * Improved asset propagation:
     * Added propagation for some `Strings\StringsFromCSFiles` keys (mainly short day names).
-    * Fixed some of the game's map changes not reapplied after reloading a map in Stardew Valley 1.5.
+    * Updated map propagation for the changes in Stardew Valley 1.5.4.
     * Fixed quarry bridge not fixed if the mountain map was reloaded.
   * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This prevents older mods from loading but bypasses a Visual Studio debugger crash.
   * Game errors shown in the chatbox are now logged.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index b72471ca..36745ea7 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -57,7 +57,7 @@ namespace StardewModdingAPI
         public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.4");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.3");
+        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");
 
         /// <summary>The maximum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MaximumGameVersion { get; } = null;
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 859a1b7a..4b911a83 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -784,32 +784,10 @@ namespace StardewModdingAPI.Metadata
         /// <param name="location">The location whose map to reload.</param>
         private void ReloadMap(GameLocation location)
         {
-            // reset patch caches
-            this.Reflection.GetField<HashSet<string>>(location, "_appliedMapOverrides").GetValue().Clear();
-            switch (location)
-            {
-                case Town _:
-                    this.Reflection.GetField<bool>(location, "ccRefurbished").SetValue(false);
-                    this.Reflection.GetField<bool>(location, "isShowingDestroyedJoja").SetValue(false);
-                    this.Reflection.GetField<bool>(location, "isShowingSpecialOrdersBoard").SetValue(false);
-                    this.Reflection.GetField<bool>(location, "isShowingUpgradedPamHouse").SetValue(false);
-                    break;
-
-                case Beach _:
-                case BeachNightMarket _:
-                case Forest _:
-                    this.Reflection.GetField<bool>(location, "hasShownCCUpgrade").SetValue(false);
-                    break;
-
-                case Mountain _:
-                    this.Reflection.GetField<bool>(location, "bridgeRestored").SetValue(false);
-                    break;
-            }
-
-            // general updates
+            // reload map
             location.reloadMap();
-            location.updateSeasonalTileSheets();
             location.updateWarps();
+            location.MakeMapModifications(force: true);
 
             // update interior doors
             location.interiorDoors.Clear();

From cea8e557efef1be5466cbb7102b4e163c34394c2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 22 Jan 2021 20:24:13 -0500
Subject: [PATCH 083/856] remove inf options for player_sethealth/money/stamina

---
 docs/release-notes.md                         |  3 ++
 .../Commands/Player/SetHealthCommand.cs       | 36 ++++---------------
 .../Commands/Player/SetMoneyCommand.cs        | 36 ++++---------------
 .../Commands/Player/SetStaminaCommand.cs      | 36 ++++---------------
 4 files changed, 21 insertions(+), 90 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0d5fdea4..1d4323af 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -36,6 +36,9 @@
   * Game errors shown in the chatbox are now logged.
   * Moved vanilla error-handling into a new Error Handler mod. This simplifies the core SMAPI logic, and lets users disable it if needed.
 
+* For the Console Commands mod:
+  * Removed the `inf` option for `player_sethealth`, `player_setmoney`, and `player_setstamina`. You can use more intuitive mods like [CJB Cheats Menu](https://www.nexusmods.com/stardewvalley/mods/4) if you used those options.
+
 * For the Error Handler mod:
   * Added a detailed message for the _Input string was not in a correct format_ error when the game fails to parse an item text description.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
index 59bda5dd..41a5b2af 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
@@ -6,19 +6,12 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
     /// <summary>A command which edits the player's current health.</summary>
     internal class SetHealthCommand : TrainerCommand
     {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>Whether to keep the player's health at its maximum.</summary>
-        private bool InfiniteHealth;
-
-
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
         public SetHealthCommand()
-            : base("player_sethealth", "Sets the player's health.\n\nUsage: player_sethealth [value]\n- value: an integer amount, or 'inf' for infinite health.", mayNeedUpdate: true) { }
+            : base("player_sethealth", "Sets the player's health.\n\nUsage: player_sethealth [value]\n- value: an integer amount.") { }
 
         /// <summary>Handle the command.</summary>
         /// <param name="monitor">Writes messages to the console and log file.</param>
@@ -29,36 +22,19 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
             // no-argument mode
             if (!args.Any())
             {
-                monitor.Log($"You currently have {(this.InfiniteHealth ? "infinite" : Game1.player.health.ToString())} health. Specify a value to change it.", LogLevel.Info);
+                monitor.Log($"You currently have {Game1.player.health} health. Specify a value to change it.", LogLevel.Info);
                 return;
             }
 
             // handle
             string amountStr = args[0];
-            if (amountStr == "inf")
+            if (int.TryParse(amountStr, out int amount))
             {
-                this.InfiniteHealth = true;
-                monitor.Log("OK, you now have infinite health.", LogLevel.Info);
+                Game1.player.health = amount;
+                monitor.Log($"OK, you now have {Game1.player.health} health.", LogLevel.Info);
             }
             else
-            {
-                this.InfiniteHealth = false;
-                if (int.TryParse(amountStr, out int amount))
-                {
-                    Game1.player.health = amount;
-                    monitor.Log($"OK, you now have {Game1.player.health} health.", LogLevel.Info);
-                }
-                else
-                    this.LogArgumentNotInt(monitor);
-            }
-        }
-
-        /// <summary>Perform any logic needed on update tick.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        public override void OnUpdated(IMonitor monitor)
-        {
-            if (this.InfiniteHealth && Context.IsWorldReady)
-                Game1.player.health = Game1.player.maxHealth;
+                this.LogArgumentNotInt(monitor);
         }
     }
 }
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
index 6e3d68b6..e015f01a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
@@ -6,19 +6,12 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
     /// <summary>A command which edits the player's current money.</summary>
     internal class SetMoneyCommand : TrainerCommand
     {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>Whether to keep the player's money at a set value.</summary>
-        private bool InfiniteMoney;
-
-
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
         public SetMoneyCommand()
-            : base("player_setmoney", "Sets the player's money.\n\nUsage: player_setmoney <value>\n- value: an integer amount, or 'inf' for infinite money.", mayNeedUpdate: true) { }
+            : base("player_setmoney", "Sets the player's money.\n\nUsage: player_setmoney <value>\n- value: an integer amount.") { }
 
         /// <summary>Handle the command.</summary>
         /// <param name="monitor">Writes messages to the console and log file.</param>
@@ -29,36 +22,19 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
             // validate
             if (!args.Any())
             {
-                monitor.Log($"You currently have {(this.InfiniteMoney ? "infinite" : Game1.player.Money.ToString())} gold. Specify a value to change it.", LogLevel.Info);
+                monitor.Log($"You currently have {Game1.player.Money} gold. Specify a value to change it.", LogLevel.Info);
                 return;
             }
 
             // handle
             string amountStr = args[0];
-            if (amountStr == "inf")
+            if (int.TryParse(amountStr, out int amount))
             {
-                this.InfiniteMoney = true;
-                monitor.Log("OK, you now have infinite money.", LogLevel.Info);
+                Game1.player.Money = amount;
+                monitor.Log($"OK, you now have {Game1.player.Money} gold.", LogLevel.Info);
             }
             else
-            {
-                this.InfiniteMoney = false;
-                if (int.TryParse(amountStr, out int amount))
-                {
-                    Game1.player.Money = amount;
-                    monitor.Log($"OK, you now have {Game1.player.Money} gold.", LogLevel.Info);
-                }
-                else
-                    this.LogArgumentNotInt(monitor);
-            }
-        }
-
-        /// <summary>Perform any logic needed on update tick.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        public override void OnUpdated(IMonitor monitor)
-        {
-            if (this.InfiniteMoney && Context.IsWorldReady)
-                Game1.player.Money = 999999;
+                this.LogArgumentNotInt(monitor);
         }
     }
 }
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
index 60a1dcb1..a8adafce 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
@@ -6,19 +6,12 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
     /// <summary>A command which edits the player's current stamina.</summary>
     internal class SetStaminaCommand : TrainerCommand
     {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>Whether to keep the player's stamina at its maximum.</summary>
-        private bool InfiniteStamina;
-
-
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
         public SetStaminaCommand()
-            : base("player_setstamina", "Sets the player's stamina.\n\nUsage: player_setstamina [value]\n- value: an integer amount, or 'inf' for infinite stamina.", mayNeedUpdate: true) { }
+            : base("player_setstamina", "Sets the player's stamina.\n\nUsage: player_setstamina [value]\n- value: an integer amount.") { }
 
         /// <summary>Handle the command.</summary>
         /// <param name="monitor">Writes messages to the console and log file.</param>
@@ -29,36 +22,19 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
             // validate
             if (!args.Any())
             {
-                monitor.Log($"You currently have {(this.InfiniteStamina ? "infinite" : Game1.player.Stamina.ToString())} stamina. Specify a value to change it.", LogLevel.Info);
+                monitor.Log($"You currently have {Game1.player.Stamina} stamina. Specify a value to change it.", LogLevel.Info);
                 return;
             }
 
             // handle
             string amountStr = args[0];
-            if (amountStr == "inf")
+            if (int.TryParse(amountStr, out int amount))
             {
-                this.InfiniteStamina = true;
-                monitor.Log("OK, you now have infinite stamina.", LogLevel.Info);
+                Game1.player.Stamina = amount;
+                monitor.Log($"OK, you now have {Game1.player.Stamina} stamina.", LogLevel.Info);
             }
             else
-            {
-                this.InfiniteStamina = false;
-                if (int.TryParse(amountStr, out int amount))
-                {
-                    Game1.player.Stamina = amount;
-                    monitor.Log($"OK, you now have {Game1.player.Stamina} stamina.", LogLevel.Info);
-                }
-                else
-                    this.LogArgumentNotInt(monitor);
-            }
-        }
-
-        /// <summary>Perform any logic needed on update tick.</summary>
-        /// <param name="monitor">Writes messages to the console and log file.</param>
-        public override void OnUpdated(IMonitor monitor)
-        {
-            if (this.InfiniteStamina && Context.IsWorldReady)
-                Game1.player.stamina = Game1.player.MaxStamina;
+                this.LogArgumentNotInt(monitor);
         }
     }
 }

From 4b5dd0f2c9ed530e97a783aedb3de73425d24516 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 22 Jan 2021 20:29:08 -0500
Subject: [PATCH 084/856] rename TrainerCommand to ConsoleCommand to match the
 rest of the code

---
 .../{TrainerCommand.cs => ConsoleCommand.cs}  |  6 +++---
 ...{ITrainerCommand.cs => IConsoleCommand.cs} |  2 +-
 .../Commands/Other/ApplySaveFixCommand.cs     |  2 +-
 .../Framework/Commands/Other/DebugCommand.cs  |  2 +-
 .../Commands/Other/ShowDataFilesCommand.cs    |  2 +-
 .../Commands/Other/ShowGameFilesCommand.cs    |  2 +-
 .../Commands/Other/TestInputCommand.cs        |  2 +-
 .../Framework/Commands/Player/AddCommand.cs   |  2 +-
 .../Commands/Player/ListItemTypesCommand.cs   |  2 +-
 .../Commands/Player/ListItemsCommand.cs       |  2 +-
 .../Commands/Player/SetColorCommand.cs        |  2 +-
 .../Commands/Player/SetHealthCommand.cs       |  2 +-
 .../Commands/Player/SetImmunityCommand.cs     |  2 +-
 .../Commands/Player/SetMaxHealthCommand.cs    |  2 +-
 .../Commands/Player/SetMaxStaminaCommand.cs   |  2 +-
 .../Commands/Player/SetMoneyCommand.cs        |  2 +-
 .../Commands/Player/SetNameCommand.cs         |  2 +-
 .../Commands/Player/SetStaminaCommand.cs      |  2 +-
 .../Commands/Player/SetStyleCommand.cs        |  2 +-
 .../Framework/Commands/World/ClearCommand.cs  |  2 +-
 .../Commands/World/DownMineLevelCommand.cs    |  2 +-
 .../Commands/World/FreezeTimeCommand.cs       |  2 +-
 .../Framework/Commands/World/SetDayCommand.cs |  2 +-
 .../Commands/World/SetMineLevelCommand.cs     |  2 +-
 .../Commands/World/SetSeasonCommand.cs        |  2 +-
 .../Commands/World/SetTimeCommand.cs          |  2 +-
 .../Commands/World/SetYearCommand.cs          |  2 +-
 src/SMAPI.Mods.ConsoleCommands/ModEntry.cs    | 20 +++++++++----------
 28 files changed, 39 insertions(+), 39 deletions(-)
 rename src/SMAPI.Mods.ConsoleCommands/Framework/Commands/{TrainerCommand.cs => ConsoleCommand.cs} (96%)
 rename src/SMAPI.Mods.ConsoleCommands/Framework/Commands/{ITrainerCommand.cs => IConsoleCommand.cs} (97%)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/TrainerCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
similarity index 96%
rename from src/SMAPI.Mods.ConsoleCommands/Framework/Commands/TrainerCommand.cs
rename to src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
index 98daa906..01cab92e 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/TrainerCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
@@ -4,8 +4,8 @@ using System.Linq;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
 {
-    /// <summary>The base implementation for a trainer command.</summary>
-    internal abstract class TrainerCommand : ITrainerCommand
+    /// <summary>The base implementation for a console command.</summary>
+    internal abstract class ConsoleCommand : IConsoleCommand
     {
         /*********
         ** Accessors
@@ -50,7 +50,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
         /// <param name="description">The command description.</param>
         /// <param name="mayNeedInput">Whether the command may need to perform logic when the player presses a button.</param>
         /// <param name="mayNeedUpdate">Whether the command may need to perform logic when the game updates.</param>
-        protected TrainerCommand(string name, string description, bool mayNeedInput = false, bool mayNeedUpdate = false)
+        protected ConsoleCommand(string name, string description, bool mayNeedInput = false, bool mayNeedUpdate = false)
         {
             this.Name = name;
             this.Description = description;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ITrainerCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
similarity index 97%
rename from src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ITrainerCommand.cs
rename to src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
index d4d36e5d..9c82bbd3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ITrainerCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
@@ -1,7 +1,7 @@
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
 {
     /// <summary>A console command to register.</summary>
-    internal interface ITrainerCommand
+    internal interface IConsoleCommand
     {
         /*********
         ** Accessors
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
index 8f59342e..957b0e75 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
@@ -5,7 +5,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which runs one of the game's save migrations.</summary>
-    internal class ApplySaveFixCommand : TrainerCommand
+    internal class ApplySaveFixCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
index e4010111..1955c14e 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
@@ -3,7 +3,7 @@
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which sends a debug command to the game.</summary>
-    internal class DebugCommand : TrainerCommand
+    internal class DebugCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
index 54d27185..27f6ce53 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
@@ -3,7 +3,7 @@
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which shows the data files.</summary>
-    internal class ShowDataFilesCommand : TrainerCommand
+    internal class ShowDataFilesCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
index 0257892f..71093184 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
@@ -3,7 +3,7 @@
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which shows the game files.</summary>
-    internal class ShowGameFilesCommand : TrainerCommand
+    internal class ShowGameFilesCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
index 11aa10c3..46583dc3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
@@ -3,7 +3,7 @@ using System;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which logs the keys being pressed for 30 seconds once enabled.</summary>
-    internal class TestInputCommand : TrainerCommand
+    internal class TestInputCommand : ConsoleCommand
     {
         /*********
         ** Fields
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
index 6cb2b624..0e8f7517 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
@@ -7,7 +7,7 @@ using Object = StardewValley.Object;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which adds an item to the player inventory.</summary>
-    internal class AddCommand : TrainerCommand
+    internal class AddCommand : ConsoleCommand
     {
         /*********
         ** Fields
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
index a835455e..1f12e5f9 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
@@ -4,7 +4,7 @@ using StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which list item types.</summary>
-    internal class ListItemTypesCommand : TrainerCommand
+    internal class ListItemTypesCommand : ConsoleCommand
     {
         /*********
         ** Fields
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
index 4232ce16..67569298 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
@@ -6,7 +6,7 @@ using StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which list items available to spawn.</summary>
-    internal class ListItemsCommand : TrainerCommand
+    internal class ListItemsCommand : ConsoleCommand
     {
         /*********
         ** Fields
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
index f0815ef6..7b7cbf83 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the color of a player feature.</summary>
-    internal class SetColorCommand : TrainerCommand
+    internal class SetColorCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
index 41a5b2af..f27b336f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's current health.</summary>
-    internal class SetHealthCommand : TrainerCommand
+    internal class SetHealthCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
index 9c66c4fe..df90adf2 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's current immunity.</summary>
-    internal class SetImmunityCommand : TrainerCommand
+    internal class SetImmunityCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
index f4ae0694..a5f7f444 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's maximum health.</summary>
-    internal class SetMaxHealthCommand : TrainerCommand
+    internal class SetMaxHealthCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
index 5bce5ea3..e3c2f011 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's maximum stamina.</summary>
-    internal class SetMaxStaminaCommand : TrainerCommand
+    internal class SetMaxStaminaCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
index e015f01a..787ce920 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's current money.</summary>
-    internal class SetMoneyCommand : TrainerCommand
+    internal class SetMoneyCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
index e8cb0584..4911ad1c 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
@@ -3,7 +3,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's name.</summary>
-    internal class SetNameCommand : TrainerCommand
+    internal class SetNameCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
index a8adafce..c78378ef 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's current stamina.</summary>
-    internal class SetStaminaCommand : TrainerCommand
+    internal class SetStaminaCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
index 31f4107d..98f6c330 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
@@ -3,7 +3,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits a player style.</summary>
-    internal class SetStyleCommand : TrainerCommand
+    internal class SetStyleCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index 29052be3..4b0e45a0 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -10,7 +10,7 @@ using SObject = StardewValley.Object;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which clears in-game objects.</summary>
-    internal class ClearCommand : TrainerCommand
+    internal class ClearCommand : ConsoleCommand
     {
         /*********
         ** Fields
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
index 2cec0fd3..0aa9c9c3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
@@ -4,7 +4,7 @@ using StardewValley.Locations;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which moves the player to the next mine level.</summary>
-    internal class DownMineLevelCommand : TrainerCommand
+    internal class DownMineLevelCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
index 736a93a0..16faa2fe 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which freezes the current time.</summary>
-    internal class FreezeTimeCommand : TrainerCommand
+    internal class FreezeTimeCommand : ConsoleCommand
     {
         /*********
         ** Fields
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
index 23c266ea..4028b3dc 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
@@ -5,7 +5,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which sets the current day.</summary>
-    internal class SetDayCommand : TrainerCommand
+    internal class SetDayCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
index b4f6d5b3..40f4b19f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
@@ -4,7 +4,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which moves the player to the given mine level.</summary>
-    internal class SetMineLevelCommand : TrainerCommand
+    internal class SetMineLevelCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
index 676369fe..a4cb35bb 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
@@ -5,7 +5,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which sets the current season.</summary>
-    internal class SetSeasonCommand : TrainerCommand
+    internal class SetSeasonCommand : ConsoleCommand
     {
         /*********
         ** Fields
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
index 9eae6741..6782e38a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
@@ -5,7 +5,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which sets the current time.</summary>
-    internal class SetTimeCommand : TrainerCommand
+    internal class SetTimeCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
index 648830c1..95401962 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
@@ -5,7 +5,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which sets the current year.</summary>
-    internal class SetYearCommand : TrainerCommand
+    internal class SetYearCommand : ConsoleCommand
     {
         /*********
         ** Public methods
diff --git a/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs b/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
index 5c4f3bba..91437fd3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
@@ -13,13 +13,13 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         ** Fields
         *********/
         /// <summary>The commands to handle.</summary>
-        private ITrainerCommand[] Commands;
+        private IConsoleCommand[] Commands;
 
         /// <summary>The commands which may need to handle update ticks.</summary>
-        private ITrainerCommand[] UpdateHandlers;
+        private IConsoleCommand[] UpdateHandlers;
 
         /// <summary>The commands which may need to handle input.</summary>
-        private ITrainerCommand[] InputHandlers;
+        private IConsoleCommand[] InputHandlers;
 
 
         /*********
@@ -31,7 +31,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         {
             // register commands
             this.Commands = this.ScanForCommands().ToArray();
-            foreach (ITrainerCommand command in this.Commands)
+            foreach (IConsoleCommand command in this.Commands)
                 helper.ConsoleCommands.Add(command.Name, command.Description, (name, args) => this.HandleCommand(command, name, args));
 
             // cache commands
@@ -52,7 +52,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         /// <param name="e">The event arguments.</param>
         private void OnButtonPressed(object sender, ButtonPressedEventArgs e)
         {
-            foreach (ITrainerCommand command in this.InputHandlers)
+            foreach (IConsoleCommand command in this.InputHandlers)
                 command.OnButtonPressed(this.Monitor, e.Button);
         }
 
@@ -61,7 +61,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         /// <param name="e">The event arguments.</param>
         private void OnUpdateTicked(object sender, EventArgs e)
         {
-            foreach (ITrainerCommand command in this.UpdateHandlers)
+            foreach (IConsoleCommand command in this.UpdateHandlers)
                 command.OnUpdated(this.Monitor);
         }
 
@@ -69,19 +69,19 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         /// <param name="command">The command to invoke.</param>
         /// <param name="commandName">The command name specified by the user.</param>
         /// <param name="args">The command arguments.</param>
-        private void HandleCommand(ITrainerCommand command, string commandName, string[] args)
+        private void HandleCommand(IConsoleCommand command, string commandName, string[] args)
         {
             ArgumentParser argParser = new ArgumentParser(commandName, args, this.Monitor);
             command.Handle(this.Monitor, commandName, argParser);
         }
 
         /// <summary>Find all commands in the assembly.</summary>
-        private IEnumerable<ITrainerCommand> ScanForCommands()
+        private IEnumerable<IConsoleCommand> ScanForCommands()
         {
             return (
                 from type in this.GetType().Assembly.GetTypes()
-                where !type.IsAbstract && typeof(ITrainerCommand).IsAssignableFrom(type)
-                select (ITrainerCommand)Activator.CreateInstance(type)
+                where !type.IsAbstract && typeof(IConsoleCommand).IsAssignableFrom(type)
+                select (IConsoleCommand)Activator.CreateInstance(type)
             );
         }
     }

From 733750fdc4f5d16069d95880144619c0e31e8a89 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 22 Jan 2021 21:04:48 -0500
Subject: [PATCH 085/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 24 +++++++++++---------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index c9afb27a..30c059a3 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.8.4</Version>
+    <Version>3.9.0</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1d4323af..0f83e044 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,43 +7,45 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.9
+Released 22 January 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
   * Updated for Stardew Valley 1.5.4.
   * Improved game detection in the installer:
     * The installer now prefers paths registered by Steam or GOG Galaxy.
     * The installer now detects default manual GOG installs.
-  * Added clearer error when Vortex creates an empty mod folder.
-  * Fixed various cases where the game's map changes wouldn't be reapplied correctly after mods changed the map.
+  * Added clearer error text for empty mod folders created by Vortex.
+  * Fixed the game's map changes not always reapplied correctly after mods change certain maps, which caused issues like the community center resetting to its non-repaired texture.
   * Fixed compatibility for very old content packs which still load maps from `.xnb` files. These were broken by map loading changes in Stardew Valley 1.5, but SMAPI now corrects them automatically.
   * Fixed some broken mods incorrectly listed as XNB mods under 'skipped mods'.
 
 * For modders:
   * Added new input APIs:
-    * Added [API for multi-key bindings](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
+    * Added an [API for multi-key bindings](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
     * Added a new [`Input.ButtonsChanged` event](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Input.ButtonsChanged).
     * Added a `buttonState.IsDown()` extension.
-    * Added a `helper.Input.SuppressActiveKeybindings` method which suppresses the active buttons in a keybind list.
+    * Added a `helper.Input.SuppressActiveKeybinds` method to suppress the active buttons in a keybind list.
   * Improved multiplayer APIs:
     * `PerScreen<T>` now lets you get/set the value for any screen, get all active values, or clear all values.
-    * Peer data for the multiplayer API/events now includes `IsSplitScreen` and `ScreenID` fields.
-    * Network messages through the multiplayer API are no longer sent to players who don't have SMAPI installed. This reduces unneeded network traffic (since they can't read it anyway) and avoids an error in some cases.
+    * Peer data from the multiplayer API/events now includes `IsSplitScreen` and `ScreenID` fields.
+    * Fixed network messages through the multiplayer API being sent to players who don't have SMAPI installed in some cases.
   * Improved asset propagation:
-    * Added propagation for some `Strings\StringsFromCSFiles` keys (mainly short day names).
     * Updated map propagation for the changes in Stardew Valley 1.5.4.
+    * Added propagation for some `Strings\StringsFromCSFiles` keys (mainly short day names).
     * Fixed quarry bridge not fixed if the mountain map was reloaded.
-  * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This prevents older mods from loading but bypasses a Visual Studio debugger crash.
+  * Added an option to disable rewriting mods for compatibility (thanks to Bpendragon!). This prevents older mods from loading, but bypasses a Visual Studio crash when debugging.
   * Game errors shown in the chatbox are now logged.
   * Moved vanilla error-handling into a new Error Handler mod. This simplifies the core SMAPI logic, and lets users disable it if needed.
 
 * For the Console Commands mod:
-  * Removed the `inf` option for `player_sethealth`, `player_setmoney`, and `player_setstamina`. You can use more intuitive mods like [CJB Cheats Menu](https://www.nexusmods.com/stardewvalley/mods/4) if you used those options.
+  * Removed the `inf` option for `player_sethealth`, `player_setmoney`, and `player_setstamina`. You can use mods like [CJB Cheats Menu](https://www.nexusmods.com/stardewvalley/mods/4) instead for that.
 
 * For the Error Handler mod:
   * Added a detailed message for the _Input string was not in a correct format_ error when the game fails to parse an item text description.
 
 * For the web UI:
-  * Fixed JSON validator for manifest files marking some update keys as invalid incorrectly.
+  * Fixed JSON validator incorrectly marking some manifest update keys as invalid.
 
 ## 3.8.4
 Released 15 January 2021 for Stardew Valley 1.5.3 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index a7daf62b..f2340638 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.8.4",
+    "Version": "3.9.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.8.4"
+    "MinimumApiVersion": "3.9.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 3394da53..bc0a7294 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.8.4",
+    "Version": "3.9.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.8.4"
+    "MinimumApiVersion": "3.9.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 0fd202da..79727fad 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.8.4",
+    "Version": "3.9.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.8.4"
+    "MinimumApiVersion": "3.9.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 36745ea7..2adafbbf 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.8.4");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.0");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");

From 6cd6eb43a123cef2aab811e23aea97dadc95e5ee Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 22 Jan 2021 23:08:26 -0500
Subject: [PATCH 086/856] link to 3.9 release highlights

---
 docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0f83e044..d6c8d368 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,7 +8,7 @@
 -->
 
 ## 3.9
-Released 22 January 2021 for Stardew Valley 1.5.4 or later.
+Released 22 January 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/46553874).
 
 * For players:
   * Updated for Stardew Valley 1.5.4.

From 66017a39d9091520bad81253be21daa8c7fd2c36 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 23 Jan 2021 11:59:36 -0500
Subject: [PATCH 087/856] disable 'patched game code' warning for ErrorHandler

It doesn't really make sense for SMAPI to show a warning about itself.
---
 docs/release-notes.md                     |  4 ++++
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 19 ++++++++++++++++---
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d6c8d368..6407ff2d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For the Error Handler mod:
+  * Disabled 'patched game code' warning.
+
 ## 3.9
 Released 22 January 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/46553874).
 
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index e75a6bc0..150aec65 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -3,6 +3,7 @@
      * Metadata about some SMAPI mods used in compatibility, update, and dependency checks. This
      * field shouldn't be edited by players in most cases.
      *
+     *
      * Standard fields
      * ===============
      * The predefined fields are documented below (only 'ID' is required). Each entry's key is the
@@ -14,6 +15,10 @@
      *     other fields if no ID was specified. This doesn't include the latest ID, if any. Multiple
      *     variants can be separated with '|'.
      *
+     *   - SuppressWarnings: the mod warnings to suppress, even if they'd normally be shown. This
+     *     should match the ModWarning enum.
+     *
+     *
      * Versioned metadata
      * ==================
      * Each record can also specify extra metadata using the field keys below.
@@ -49,6 +54,14 @@
      *     mod is no longer compatible.
      */
     "ModData": {
+        /*********
+        ** Mods bundles with SMAPI
+        *********/
+        "Error Handler": {
+            "ID": "SMAPI.ErrorHandler",
+            "SuppressWarnings": "PatchesGame"
+        },
+
         /*********
         ** Common dependencies for friendly errors
         *********/
@@ -186,7 +199,7 @@
             "~0.11.2 | Status": "AssumeBroken",
             "~0.11.2 | StatusReasonDetails": "causes errors and custom furniture no longer work in Stardew Valley 1.5"
         },
-        
+
         "Custom Localization": {
             "ID": "ZaneYork.CustomLocalization",
             "FormerIDs": "SMAPI.CustomLocalization", // changed in 1.0.1
@@ -427,13 +440,13 @@
         "Fishing Adjust": {
             "ID": "shuaiz.FishingAdjustMod",
             "~2.0.1 | Status": "AssumeBroken",
-            "~2.0.1 | StatusReasonDetails":  "fails with 'method not found' error for 'Void Harmony.HarmonyInstance.Patch(System.Reflection.MethodBase, Harmony.HarmonyMethod, Harmony.HarmonyMethod, Harmony.HarmonyMethod)'"
+            "~2.0.1 | StatusReasonDetails": "fails with 'method not found' error for 'Void Harmony.HarmonyInstance.Patch(System.Reflection.MethodBase, Harmony.HarmonyMethod, Harmony.HarmonyMethod, Harmony.HarmonyMethod)'"
         },
 
         "Fishing Automaton": {
             "ID": "Drynwynn.FishingAutomaton",
             "~1.1 | Status": "AssumeBroken",
-            "~1.1 | StatusReasonDetails":  "runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+"
+            "~1.1 | StatusReasonDetails": "runtime errors with Harmony 1.2.0.1 in SMAPI 2.8+"
         },
 
         "More Silo Storage": {

From 4c0272c0aaec58fbd457e87650f66a067efc2fee Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 23 Jan 2021 12:01:46 -0500
Subject: [PATCH 088/856] remove unused AlternativeUrl field in metadata model

---
 src/SMAPI.Tests/Core/ModResolverTests.cs                     | 3 +--
 src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs          | 1 -
 src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs       | 3 ---
 src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs         | 5 -----
 .../Framework/ModData/ModDataRecordVersionedFields.cs        | 3 ---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json                    | 3 ---
 src/SMAPI/Framework/ModLoading/ModResolver.cs                | 2 --
 7 files changed, 1 insertion(+), 19 deletions(-)

diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index 78056ef7..28262111 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -146,8 +146,7 @@ namespace SMAPI.Tests.Core
             Mock<IModMetadata> mock = this.GetMetadata("Mod A", new string[0], allowStatusChange: true);
             this.SetupMetadataForValidation(mock, new ModDataRecordVersionedFields
             {
-                Status = ModStatus.AssumeBroken,
-                AlternativeUrl = "https://example.org"
+                Status = ModStatus.AssumeBroken
             });
 
             // act
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
index 44422f01..6658d219 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
@@ -69,7 +69,6 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
                     return manifest.UpdateKeys != null && manifest.UpdateKeys.Any(p => !string.IsNullOrWhiteSpace(p));
 
                 // non-manifest fields
-                case ModDataFieldKey.AlternativeUrl:
                 case ModDataFieldKey.StatusReasonPhrase:
                 case ModDataFieldKey.StatusReasonDetails:
                 case ModDataFieldKey.Status:
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs
index 068291aa..2b59096d 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataFieldKey.cs
@@ -6,9 +6,6 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <summary>A manifest update key.</summary>
         UpdateKey,
 
-        /// <summary>An alternative URL the player can check for an updated version.</summary>
-        AlternativeUrl,
-
         /// <summary>The mod's predefined compatibility status.</summary>
         Status,
 
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
index f28f6afe..5dd32acf 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
@@ -92,11 +92,6 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
                         parsed.UpdateKey = field.Value;
                         break;
 
-                    // alternative URL
-                    case ModDataFieldKey.AlternativeUrl:
-                        parsed.AlternativeUrl = field.Value;
-                        break;
-
                     // status
                     case ModDataFieldKey.Status:
                         parsed.Status = (ModStatus)Enum.Parse(typeof(ModStatus), field.Value, ignoreCase: true);
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
index f0282eb4..5aaabd51 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
@@ -15,9 +15,6 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <summary>The update key to apply.</summary>
         public string UpdateKey { get; set; }
 
-        /// <summary>The alternative URL the player can check for an updated version.</summary>
-        public string AlternativeUrl { get; set; }
-
         /// <summary>The predefined compatibility status.</summary>
         public ModStatus Status { get; set; } = ModStatus.None;
 
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 150aec65..8cc60a73 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -49,9 +49,6 @@
      *
      *   - StatusReasonDetails: a technical reason shown in TRACE logs, indicating why the status
      *     was overridden. If not provided, it defaults to the StatusReasonPhrase or 'no reason given'.
-     *
-     *   - AlternativeUrl: a URL where the player can find an unofficial update or alternative if the
-     *     mod is no longer compatible.
      */
     "ModData": {
         /*********
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index af7d90f6..c70820e4 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -88,8 +88,6 @@ namespace StardewModdingAPI.Framework.ModLoading
                                 if (url != null)
                                     updateUrls.Add(url);
                             }
-                            if (mod.DataRecord.AlternativeUrl != null)
-                                updateUrls.Add(mod.DataRecord.AlternativeUrl);
 
                             // default update URL
                             updateUrls.Add("https://smapi.io/mods");

From 5129c361c94bd2f4e2e9ef8d39235dc6159a849d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 24 Jan 2021 00:32:26 -0500
Subject: [PATCH 089/856] fix interior door errors when reloading maps

---
 docs/release-notes.md                     | 5 +++--
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 1 +
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6407ff2d..1e7558ff 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,8 +8,9 @@
 -->
 
 ## Upcoming release
-* For the Error Handler mod:
-  * Disabled 'patched game code' warning.
+* For players:
+  * Fixed _tile contains an invalid TileSheet reference_ errors when mods change certain maps.
+  * Fixed _patched game code_ issue shown for the bundled ErrorHandler mod.
 
 ## 3.9
 Released 22 January 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/46553874).
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 4b911a83..f486321e 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -785,6 +785,7 @@ namespace StardewModdingAPI.Metadata
         private void ReloadMap(GameLocation location)
         {
             // reload map
+            location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist
             location.reloadMap();
             location.updateWarps();
             location.MakeMapModifications(force: true);

From 0058267c36dbc11326a7a1839540809421ea82da Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 24 Jan 2021 01:05:40 -0500
Subject: [PATCH 090/856] minor cleanup

---
 src/SMAPI/Framework/ContentCoordinator.cs | 24 +++++++++++++++++++++--
 src/SMAPI/Metadata/CoreAssetPropagator.cs |  7 ++++---
 2 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 27fb3dbb..77dd6c72 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -99,7 +99,17 @@ namespace StardewModdingAPI.Framework
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
             this.FullRootDirectory = Path.Combine(Constants.ExecutionPath, rootDirectory);
             this.ContentManagers.Add(
-                this.MainContentManager = new GameContentManager("Game1.content", serviceProvider, rootDirectory, currentCulture, this, monitor, reflection, this.OnDisposing, onLoadingFirstAsset)
+                this.MainContentManager = new GameContentManager(
+                    name: "Game1.content",
+                    serviceProvider: serviceProvider,
+                    rootDirectory: rootDirectory,
+                    currentCulture: currentCulture,
+                    coordinator: this,
+                    monitor: monitor,
+                    reflection: reflection,
+                    onDisposing: this.OnDisposing,
+                    onLoadingFirstAsset: onLoadingFirstAsset
+                )
             );
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
             this.CoreAssets = new CoreAssetPropagator(this.MainContentManager.AssertAndNormalizeAssetName, reflection);
@@ -111,7 +121,17 @@ namespace StardewModdingAPI.Framework
         {
             return this.ContentManagerLock.InWriteLock(() =>
             {
-                GameContentManager manager = new GameContentManager(name, this.MainContentManager.ServiceProvider, this.MainContentManager.RootDirectory, this.MainContentManager.CurrentCulture, this, this.Monitor, this.Reflection, this.OnDisposing, this.OnLoadingFirstAsset);
+                GameContentManager manager = new GameContentManager(
+                    name: name,
+                    serviceProvider: this.MainContentManager.ServiceProvider,
+                    rootDirectory: this.MainContentManager.RootDirectory,
+                    currentCulture: this.MainContentManager.CurrentCulture,
+                    coordinator: this,
+                    monitor: this.Monitor,
+                    reflection: this.Reflection,
+                    onDisposing: this.OnDisposing,
+                    onLoadingFirstAsset: this.OnLoadingFirstAsset
+                );
                 this.ContentManagers.Add(manager);
                 return manager;
             });
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index f486321e..063804e0 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using Microsoft.Xna.Framework.Graphics;
@@ -79,7 +80,7 @@ namespace StardewModdingAPI.Metadata
             });
 
             // reload assets
-            IDictionary<string, bool> propagated = assets.ToDictionary(p => p.Key, p => false, StringComparer.OrdinalIgnoreCase);
+            IDictionary<string, bool> propagated = assets.ToDictionary(p => p.Key, _ => false, StringComparer.OrdinalIgnoreCase);
             foreach (var bucket in buckets)
             {
                 switch (bucket.Key)
@@ -110,6 +111,7 @@ namespace StardewModdingAPI.Metadata
         /// <param name="key">The asset key to reload.</param>
         /// <param name="type">The asset type to reload.</param>
         /// <returns>Returns whether an asset was loaded. The return value may be true or false, or a non-null value for true.</returns>
+        [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These deliberately match the asset names.")]
         private bool PropagateOther(LocalizedContentManager content, string key, Type type)
         {
             key = this.AssertAndNormalizeAssetName(key);
@@ -492,8 +494,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures\\grass": // from Grass
-                    this.ReloadGrassTextures(content, key);
-                    return true;
+                    return this.ReloadGrassTextures(content, key);
 
                 case "terrainfeatures\\hoedirt": // from HoeDirt
                     HoeDirt.lightTexture = content.Load<Texture2D>(key);

From 082028016993606e8deec84027c781d77e062caa Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 25 Jan 2021 21:52:51 -0500
Subject: [PATCH 091/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 8 +++++---
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 30c059a3..a38f15a6 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.9.0</Version>
+    <Version>3.9.1</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1e7558ff..dabdada1 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,10 +7,12 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.9.1
+Released 25 January 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
-  * Fixed _tile contains an invalid TileSheet reference_ errors when mods change certain maps.
-  * Fixed _patched game code_ issue shown for the bundled ErrorHandler mod.
+  * Fixed _tile contains an invalid TileSheet reference_ crash after mods change certain maps.
+  * Fixed _patched game code_ issue shown for the bundled Error Handler mod.
 
 ## 3.9
 Released 22 January 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/46553874).
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index f2340638..10611e08 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.9.0",
+    "Version": "3.9.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.9.0"
+    "MinimumApiVersion": "3.9.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index bc0a7294..bb9942d1 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.9.0",
+    "Version": "3.9.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.9.0"
+    "MinimumApiVersion": "3.9.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 79727fad..95ee5144 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.9.0",
+    "Version": "3.9.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.9.0"
+    "MinimumApiVersion": "3.9.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 2adafbbf..57c40bbf 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.0");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.1");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");

From 822cc71619cd173a67de241843cf1679cfc1904d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 28 Jan 2021 19:51:30 -0500
Subject: [PATCH 092/856] fix error running 'install on Windows.bat' for one
 user

---
 docs/release-notes.md                          | 4 ++++
 src/SMAPI.Installer/assets/windows-install.bat | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index dabdada1..bb5998f8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Fixed error running `install on Windows.bat` in very rare cases.
+
 ## 3.9.1
 Released 25 January 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index d02dd4c6..2cc54e80 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -4,5 +4,5 @@ if not errorlevel 1 (
    echo Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first.
    pause
 ) else (
-   start /WAIT /B internal/windows-install.exe
+   start /WAIT /B ./internal/windows-install.exe
 )

From b2a6933efb0719b48034eff8c29b5f12beb00248 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 28 Jan 2021 21:21:18 -0500
Subject: [PATCH 093/856] fix mod type defaulted incorrectly in SMAPI toolkit

---
 docs/release-notes.md                             |  3 +++
 .../Framework/ModScanning/ModScanner.cs           | 15 ++++++++++-----
 2 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index bb5998f8..2e99277f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,9 @@
 * For players:
   * Fixed error running `install on Windows.bat` in very rare cases.
 
+* For modders:
+  * Fixed SMAPI toolkit defaulting the mod type to SMAPI if its `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
+
 ## 3.9.1
 Released 25 January 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 86a97016..fd206d9d 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -177,12 +177,17 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             }
 
             // get mod type
-            ModType type = ModType.Invalid;
-            if (manifest != null)
+            ModType type;
             {
-                type = !string.IsNullOrWhiteSpace(manifest.ContentPackFor?.UniqueID)
-                    ? ModType.ContentPack
-                    : ModType.Smapi;
+                bool isContentPack = !string.IsNullOrWhiteSpace(manifest?.ContentPackFor?.UniqueID);
+                bool isSmapi = !string.IsNullOrWhiteSpace(manifest?.EntryDll);
+
+                if (isContentPack == isSmapi)
+                    type = ModType.Invalid;
+                else if (isContentPack)
+                    type = ModType.ContentPack;
+                else
+                    type = ModType.Smapi;
             }
 
             // build result

From 7e8f4518764a86e7d3589ae75235b1d3d4462f8b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 31 Jan 2021 15:37:00 -0500
Subject: [PATCH 094/856] add experimental 'aggressive memory optimization'
 flag (#757)

---
 docs/release-notes.md                         |  1 +
 src/SMAPI/Framework/ContentCoordinator.cs     | 18 +++++++++----
 .../ContentManagers/BaseContentManager.cs     | 26 +++++++++++++-----
 .../ContentManagers/GameContentManager.cs     |  5 ++--
 .../ContentManagers/ModContentManager.cs      |  5 ++--
 src/SMAPI/Framework/Logging/LogManager.cs     | 26 +++++++++++-------
 src/SMAPI/Framework/Models/SConfig.cs         |  6 ++++-
 src/SMAPI/Framework/SCore.cs                  |  4 +--
 src/SMAPI/Metadata/CoreAssetPropagator.cs     | 27 ++++++++++++++++---
 src/SMAPI/SMAPI.config.json                   |  6 +++++
 10 files changed, 92 insertions(+), 32 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2e99277f..e54fd24b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For players:
+  * Added _aggressive memory optimization_ option. This is experimental and disabled by default; you can enable it in `smapi-internal/config.json` if you experience `OutOfMemoryException` crashes.
   * Fixed error running `install on Windows.bat` in very rare cases.
 
 * For modders:
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 77dd6c72..81265fa2 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -26,6 +26,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>An asset key prefix for assets from SMAPI mod folders.</summary>
         private readonly string ManagedPrefix = "SMAPI";
 
+        /// <summary>Whether to enable more aggressive memory optimizations.</summary>
+        private readonly bool AggressiveMemoryOptimizations;
+
         /// <summary>Encapsulates monitoring and logging.</summary>
         private readonly IMonitor Monitor;
 
@@ -91,8 +94,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset)
+        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations)
         {
+            this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.Reflection = reflection;
             this.JsonHelper = jsonHelper;
@@ -108,11 +113,12 @@ namespace StardewModdingAPI.Framework
                     monitor: monitor,
                     reflection: reflection,
                     onDisposing: this.OnDisposing,
-                    onLoadingFirstAsset: onLoadingFirstAsset
+                    onLoadingFirstAsset: onLoadingFirstAsset,
+                    aggressiveMemoryOptimizations: aggressiveMemoryOptimizations
                 )
             );
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
-            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager.AssertAndNormalizeAssetName, reflection);
+            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager.AssertAndNormalizeAssetName, reflection, aggressiveMemoryOptimizations);
         }
 
         /// <summary>Get a new content manager which handles reading files from the game content folder with support for interception.</summary>
@@ -130,7 +136,8 @@ namespace StardewModdingAPI.Framework
                     monitor: this.Monitor,
                     reflection: this.Reflection,
                     onDisposing: this.OnDisposing,
-                    onLoadingFirstAsset: this.OnLoadingFirstAsset
+                    onLoadingFirstAsset: this.OnLoadingFirstAsset,
+                    aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
@@ -157,7 +164,8 @@ namespace StardewModdingAPI.Framework
                     monitor: this.Monitor,
                     reflection: this.Reflection,
                     jsonHelper: this.JsonHelper,
-                    onDisposing: this.OnDisposing
+                    onDisposing: this.OnDisposing,
+                    aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 92264f8c..709c624e 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -11,6 +11,7 @@ using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewValley;
+using xTile;
 
 namespace StardewModdingAPI.Framework.ContentManagers
 {
@@ -29,6 +30,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Encapsulates monitoring and logging.</summary>
         protected readonly IMonitor Monitor;
 
+        /// <summary>Whether to enable more aggressive memory optimizations.</summary>
+        protected readonly bool AggressiveMemoryOptimizations;
+
         /// <summary>Whether the content coordinator has been disposed.</summary>
         private bool IsDisposed;
 
@@ -75,7 +79,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="isNamespaced">Whether this content manager handles managed asset keys (e.g. to load assets from a mod folder).</param>
-        protected BaseContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, bool isNamespaced)
+        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        protected BaseContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, bool isNamespaced, bool aggressiveMemoryOptimizations)
             : base(serviceProvider, rootDirectory, currentCulture)
         {
             // init
@@ -85,6 +90,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.OnDisposing = onDisposing;
             this.IsNamespaced = isNamespaced;
+            this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
 
             // get asset data
             this.LanguageCodes = this.GetKeyLocales().ToDictionary(p => p.Value, p => p.Key, StringComparer.OrdinalIgnoreCase);
@@ -198,14 +204,22 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 this.ParseCacheKey(key, out string assetName, out _);
 
-                if (removeAssets.ContainsKey(assetName))
-                    return true;
-                if (predicate(assetName, asset.GetType()))
+                // check if asset should be removed
+                bool remove = removeAssets.ContainsKey(assetName);
+                if (!remove && predicate(assetName, asset.GetType()))
                 {
                     removeAssets[assetName] = asset;
-                    return true;
+                    remove = true;
                 }
-                return false;
+
+                // dispose if safe
+                if (remove && this.AggressiveMemoryOptimizations)
+                {
+                    if (asset is Map map)
+                        map.DisposeTileSheets(Game1.mapDisplayDevice);
+                }
+
+                return remove;
             }, dispose);
 
             return removeAssets;
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 665c019b..f8ee575f 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -52,8 +52,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
-        public GameContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset)
-            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: false)
+        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        public GameContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations)
+            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: false, aggressiveMemoryOptimizations: aggressiveMemoryOptimizations)
         {
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
         }
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 1456d3c1..284c1f37 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -50,8 +50,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing)
-            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
+        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, bool aggressiveMemoryOptimizations)
+            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true, aggressiveMemoryOptimizations: aggressiveMemoryOptimizations)
         {
             this.GameContentManager = gameContentManager;
             this.JsonHelper = jsonHelper;
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index ff00cff7..5f191873 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using System.Text.RegularExpressions;
 using System.Threading;
 using StardewModdingAPI.Framework.Commands;
+using StardewModdingAPI.Framework.Models;
 using StardewModdingAPI.Framework.ModLoading;
 using StardewModdingAPI.Internal.ConsoleWriting;
 using StardewModdingAPI.Toolkit.Framework.ModData;
@@ -284,19 +285,24 @@ namespace StardewModdingAPI.Framework.Logging
         }
 
         /// <summary>Log details for settings that don't match the default.</summary>
-        /// <param name="isDeveloperMode">Whether to enable full console output for developers.</param>
-        /// <param name="checkForUpdates">Whether to check for newer versions of SMAPI and mods on startup.</param>
-        /// <param name="rewriteMods">Whether to rewrite mods for compatibility.</param>
-        public void LogSettingsHeader(bool isDeveloperMode, bool checkForUpdates, bool rewriteMods)
+        /// <param name="settings">The settings to log.</param>
+        public void LogSettingsHeader(SConfig settings)
         {
-            if (isDeveloperMode)
-                this.Monitor.Log("You have SMAPI for developers, so the console will be much more verbose. You can disable developer mode by installing the non-developer version of SMAPI.", LogLevel.Info);
-            if (!checkForUpdates)
-                this.Monitor.Log("You configured SMAPI to not check for updates. Running an old version of SMAPI is not recommended. You can enable update checks by reinstalling SMAPI.", LogLevel.Warn);
-            if (!rewriteMods)
-                this.Monitor.Log("You configured SMAPI to not rewrite broken mods. Many older mods may fail to load. You can undo this by reinstalling SMAPI.", LogLevel.Warn);
+            // developer mode
+            if (settings.DeveloperMode)
+                this.Monitor.Log("You enabled developer mode, so the console will be much more verbose. You can disable it by installing the non-developer version of SMAPI.", LogLevel.Info);
+
+            // warnings
+            if (!settings.CheckForUpdates)
+                this.Monitor.Log("You disabled update checks, so you won't be notified of new SMAPI or mod updates. Running an old version of SMAPI is not recommended. You can undo this by reinstalling SMAPI.", LogLevel.Warn);
+            if (settings.AggressiveMemoryOptimizations)
+                this.Monitor.Log("You enabled aggressive memory optimizations. This is an experimental option which may cause errors or crashes. You can undo this by reinstalling SMAPI.", LogLevel.Warn);
+            if (!settings.RewriteMods)
+                this.Monitor.Log("You disabled rewriting broken mods, so many older mods may fail to load. You can undo this by reinstalling SMAPI.", LogLevel.Info);
             if (!this.Monitor.WriteToConsole)
                 this.Monitor.Log("Writing to the terminal is disabled because the --no-terminal argument was received. This usually means launching the terminal failed.", LogLevel.Warn);
+
+            // verbose logging
             this.Monitor.VerboseLog("Verbose logging enabled.");
         }
 
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index dea08717..382ae41f 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -21,7 +21,8 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(WebApiBaseUrl)] = "https://smapi.io/api/",
             [nameof(VerboseLogging)] = false,
             [nameof(LogNetworkTraffic)] = false,
-            [nameof(RewriteMods)] = true
+            [nameof(RewriteMods)] = true,
+            [nameof(AggressiveMemoryOptimizations)] = false
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
@@ -60,6 +61,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether SMAPI should rewrite mods for compatibility.</summary>
         public bool RewriteMods { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
 
+        /// <summary>Whether to enable more aggressive memory optimizations.</summary>
+        public bool AggressiveMemoryOptimizations { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.AggressiveMemoryOptimizations)];
+
         /// <summary>Whether SMAPI should log network traffic. Best combined with <see cref="VerboseLogging"/>, which includes network metadata.</summary>
         public bool LogNetworkTraffic { get; set; }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index cd094ff4..0ae69f0f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -277,7 +277,7 @@ namespace StardewModdingAPI.Framework
 
             // log basic info
             this.LogManager.HandleMarkerFiles();
-            this.LogManager.LogSettingsHeader(this.Settings.DeveloperMode, this.Settings.CheckForUpdates, this.Settings.RewriteMods);
+            this.LogManager.LogSettingsHeader(this.Settings);
 
             // set window titles
             this.SetWindowTitles(
@@ -1149,7 +1149,7 @@ namespace StardewModdingAPI.Framework
             // Game1._temporaryContent initializing from SGame constructor
             if (this.ContentCore == null)
             {
-                this.ContentCore = new ContentCoordinator(serviceProvider, rootDirectory, Thread.CurrentThread.CurrentUICulture, this.Monitor, this.Reflection, this.Toolkit.JsonHelper, this.InitializeBeforeFirstAssetLoaded);
+                this.ContentCore = new ContentCoordinator(serviceProvider, rootDirectory, Thread.CurrentThread.CurrentUICulture, this.Monitor, this.Reflection, this.Toolkit.JsonHelper, this.InitializeBeforeFirstAssetLoaded, this.Settings.AggressiveMemoryOptimizations);
                 if (this.ContentCore.Language != this.Translator.LocaleEnum)
                     this.Translator.SetLocale(this.ContentCore.GetLocale(), this.ContentCore.Language);
 
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 063804e0..829aa451 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -29,6 +29,9 @@ namespace StardewModdingAPI.Metadata
         /*********
         ** Fields
         *********/
+        /// <summary>Whether to enable more aggressive memory optimizations.</summary>
+        private readonly bool AggressiveMemoryOptimizations;
+
         /// <summary>Normalizes an asset key to match the cache key and assert that it's valid.</summary>
         private readonly Func<string, string> AssertAndNormalizeAssetName;
 
@@ -55,10 +58,12 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Initialize the core asset data.</summary>
         /// <param name="assertAndNormalizeAssetName">Normalizes an asset key to match the cache key and assert that it's valid.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public CoreAssetPropagator(Func<string, string> assertAndNormalizeAssetName, Reflector reflection)
+        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        public CoreAssetPropagator(Func<string, string> assertAndNormalizeAssetName, Reflector reflection, bool aggressiveMemoryOptimizations)
         {
             this.AssertAndNormalizeAssetName = assertAndNormalizeAssetName;
             this.Reflection = reflection;
+            this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
         }
 
         /// <summary>Reload one of the game's core assets (if applicable).</summary>
@@ -582,7 +587,7 @@ namespace StardewModdingAPI.Metadata
                 titleMenu.aboutButton.texture = texture;
                 titleMenu.languageButton.texture = texture;
                 foreach (ClickableTextureComponent button in titleMenu.buttons)
-                    button.texture = titleMenu.titleButtonsTexture;
+                    button.texture = texture;
                 foreach (TemporaryAnimatedSprite bird in titleMenu.birds)
                     bird.texture = texture;
 
@@ -785,6 +790,9 @@ namespace StardewModdingAPI.Metadata
         /// <param name="location">The location whose map to reload.</param>
         private void ReloadMap(GameLocation location)
         {
+            if (this.AggressiveMemoryOptimizations)
+                location.map.DisposeTileSheets(Game1.mapDisplayDevice);
+
             // reload map
             location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist
             location.reloadMap();
@@ -843,7 +851,7 @@ namespace StardewModdingAPI.Metadata
             // update sprite
             foreach (var target in characters)
             {
-                target.Npc.Sprite.spriteTexture = content.Load<Texture2D>(target.Key);
+                target.Npc.Sprite.spriteTexture = this.DisposeIfNeeded(target.Npc.Sprite.spriteTexture, content.Load<Texture2D>(target.Key));
                 propagated[target.Key] = true;
             }
         }
@@ -881,7 +889,7 @@ namespace StardewModdingAPI.Metadata
             // update portrait
             foreach (var target in characters)
             {
-                target.Npc.Portrait = content.Load<Texture2D>(target.Key);
+                target.Npc.Portrait = this.DisposeIfNeeded(target.Npc.Portrait, content.Load<Texture2D>(target.Key));
                 propagated[target.Key] = true;
             }
         }
@@ -1146,5 +1154,16 @@ namespace StardewModdingAPI.Metadata
         {
             return this.GetSegments(path).Length;
         }
+
+        /// <summary>Dispose a texture if <see cref="AggressiveMemoryOptimizations"/> are enabled and it's different from the new instance.</summary>
+        /// <param name="oldTexture">The previous texture to dispose.</param>
+        /// <param name="newTexture">The new texture being loaded.</param>
+        private Texture2D DisposeIfNeeded(Texture2D oldTexture, Texture2D newTexture)
+        {
+            if (this.AggressiveMemoryOptimizations && oldTexture != null && !oldTexture.IsDisposed && !object.ReferenceEquals(oldTexture, newTexture))
+                oldTexture.Dispose();
+
+            return newTexture;
+        }
     }
 }
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 7a710f14..6a485cbd 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -39,6 +39,12 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "RewriteMods": true,
 
+    /**
+     * Whether to enable more aggressive memory optimizations.
+     * THIS IS EXPERIMENTAL AND MAY CAUSE ERRORS OR CRASHES.
+     */
+    "AggressiveMemoryOptimizations": true,
+
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially
      * sensitive .NET APIs like file or shell access. Note that many mods do this legitimately as

From 423f2352af9d0e9815daf4ba3ba33134f587ce47 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 31 Jan 2021 22:08:03 -0500
Subject: [PATCH 095/856] rework aggressive memory optimization to minimize mod
 impact (#757)

---
 src/SMAPI/Framework/ContentCoordinator.cs     | 17 ++++-
 .../GameContentManagerForAssetPropagation.cs  | 47 ++++++++++++++
 src/SMAPI/Metadata/CoreAssetPropagator.cs     | 63 ++++++++++++-------
 3 files changed, 103 insertions(+), 24 deletions(-)
 create mode 100644 src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 81265fa2..6a7385c3 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -117,8 +117,21 @@ namespace StardewModdingAPI.Framework
                     aggressiveMemoryOptimizations: aggressiveMemoryOptimizations
                 )
             );
+            var contentManagerForAssetPropagation = new GameContentManagerForAssetPropagation(
+                name: nameof(GameContentManagerForAssetPropagation),
+                serviceProvider: serviceProvider,
+                rootDirectory: rootDirectory,
+                currentCulture: currentCulture,
+                coordinator: this,
+                monitor: monitor,
+                reflection: reflection,
+                onDisposing: this.OnDisposing,
+                onLoadingFirstAsset: onLoadingFirstAsset,
+                aggressiveMemoryOptimizations: aggressiveMemoryOptimizations
+            );
+            this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
-            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager.AssertAndNormalizeAssetName, reflection, aggressiveMemoryOptimizations);
+            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, reflection, aggressiveMemoryOptimizations);
         }
 
         /// <summary>Get a new content manager which handles reading files from the game content folder with support for interception.</summary>
@@ -298,7 +311,7 @@ namespace StardewModdingAPI.Framework
             // reload core game assets
             if (removedAssets.Any())
             {
-                IDictionary<string, bool> propagated = this.CoreAssets.Propagate(this.MainContentManager, removedAssets.ToDictionary(p => p.Key, p => p.Value)); // use an intercepted content manager
+                IDictionary<string, bool> propagated = this.CoreAssets.Propagate(removedAssets.ToDictionary(p => p.Key, p => p.Value)); // use an intercepted content manager
                 this.Monitor.Log($"Invalidated {removedAssets.Count} asset names ({string.Join(", ", removedAssets.Keys.OrderBy(p => p, StringComparer.OrdinalIgnoreCase))}); propagated {propagated.Count(p => p.Value)} core assets.", LogLevel.Trace);
             }
             else
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
new file mode 100644
index 00000000..cbbebf02
--- /dev/null
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
@@ -0,0 +1,47 @@
+using System;
+using System.Globalization;
+using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework.Reflection;
+using StardewValley;
+
+namespace StardewModdingAPI.Framework.ContentManagers
+{
+    /// <summary>An extension of <see cref="GameContentManager"/> specifically optimized for asset propagation.</summary>
+    /// <remarks>This avoids sharing an asset cache with <see cref="Game1.content"/> or mods, so that assets can be safely disposed when the vanilla game no longer references them.</remarks>
+    internal class GameContentManagerForAssetPropagation : GameContentManager
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>A unique value used in <see cref="Texture2D"/> to identify assets loaded through this instance.</summary>
+        private readonly string Tag = $"Pathoschild.SMAPI/LoadedBy:{nameof(GameContentManagerForAssetPropagation)}";
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <inheritdoc />
+        public GameContentManagerForAssetPropagation(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations)
+            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, onLoadingFirstAsset, aggressiveMemoryOptimizations) { }
+
+        /// <inheritdoc />
+        public override T Load<T>(string assetName, LanguageCode language, bool useCache)
+        {
+            T data = base.Load<T>(assetName, language, useCache);
+
+            if (data is Texture2D texture)
+                texture.Tag = this.Tag;
+
+            return data;
+        }
+
+        /// <summary>Get whether a texture was loaded by this content manager.</summary>
+        /// <param name="texture">The texture to check.</param>
+        public bool IsReponsibleFor(Texture2D texture)
+        {
+            return
+                texture?.Tag is string tag
+                && tag.Contains(this.Tag);
+        }
+    }
+}
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 829aa451..426fc3f6 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -5,6 +5,7 @@ using System.IO;
 using System.Linq;
 using Microsoft.Xna.Framework.Graphics;
 using Netcode;
+using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
@@ -29,6 +30,12 @@ namespace StardewModdingAPI.Metadata
         /*********
         ** Fields
         *********/
+        /// <summary>The main content manager through which to reload assets.</summary>
+        private readonly LocalizedContentManager MainContentManager;
+
+        /// <summary>An internal content manager used only for asset propagation. See remarks on <see cref="GameContentManagerForAssetPropagation"/>.</summary>
+        private readonly GameContentManagerForAssetPropagation DisposableContentManager;
+
         /// <summary>Whether to enable more aggressive memory optimizations.</summary>
         private readonly bool AggressiveMemoryOptimizations;
 
@@ -56,21 +63,24 @@ namespace StardewModdingAPI.Metadata
         ** Public methods
         *********/
         /// <summary>Initialize the core asset data.</summary>
-        /// <param name="assertAndNormalizeAssetName">Normalizes an asset key to match the cache key and assert that it's valid.</param>
+        /// <param name="mainContent">The main content manager through which to reload assets.</param>
+        /// <param name="disposableContent">An internal content manager used only for asset propagation.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        public CoreAssetPropagator(Func<string, string> assertAndNormalizeAssetName, Reflector reflection, bool aggressiveMemoryOptimizations)
+        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, Reflector reflection, bool aggressiveMemoryOptimizations)
         {
-            this.AssertAndNormalizeAssetName = assertAndNormalizeAssetName;
+            this.MainContentManager = mainContent;
+            this.DisposableContentManager = disposableContent;
             this.Reflection = reflection;
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
+
+            this.AssertAndNormalizeAssetName = disposableContent.AssertAndNormalizeAssetName;
         }
 
         /// <summary>Reload one of the game's core assets (if applicable).</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="assets">The asset keys and types to reload.</param>
         /// <returns>Returns a lookup of asset names to whether they've been propagated.</returns>
-        public IDictionary<string, bool> Propagate(LocalizedContentManager content, IDictionary<string, Type> assets)
+        public IDictionary<string, bool> Propagate(IDictionary<string, Type> assets)
         {
             // group into optimized lists
             var buckets = assets.GroupBy(p =>
@@ -91,16 +101,16 @@ namespace StardewModdingAPI.Metadata
                 switch (bucket.Key)
                 {
                     case AssetBucket.Sprite:
-                        this.ReloadNpcSprites(content, bucket.Select(p => p.Key), propagated);
+                        this.ReloadNpcSprites(bucket.Select(p => p.Key), propagated);
                         break;
 
                     case AssetBucket.Portrait:
-                        this.ReloadNpcPortraits(content, bucket.Select(p => p.Key), propagated);
+                        this.ReloadNpcPortraits(bucket.Select(p => p.Key), propagated);
                         break;
 
                     default:
                         foreach (var entry in bucket)
-                            propagated[entry.Key] = this.PropagateOther(content, entry.Key, entry.Value);
+                            propagated[entry.Key] = this.PropagateOther(entry.Key, entry.Value);
                         break;
                 }
             }
@@ -112,13 +122,13 @@ namespace StardewModdingAPI.Metadata
         ** Private methods
         *********/
         /// <summary>Reload one of the game's core assets (if applicable).</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="key">The asset key to reload.</param>
         /// <param name="type">The asset type to reload.</param>
         /// <returns>Returns whether an asset was loaded. The return value may be true or false, or a non-null value for true.</returns>
         [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These deliberately match the asset names.")]
-        private bool PropagateOther(LocalizedContentManager content, string key, Type type)
+        private bool PropagateOther(string key, Type type)
         {
+            var content = this.MainContentManager;
             key = this.AssertAndNormalizeAssetName(key);
 
             /****
@@ -830,10 +840,9 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Reload the sprites for matching NPCs.</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="keys">The asset keys to reload.</param>
         /// <param name="propagated">The asset keys which have been propagated.</param>
-        private void ReloadNpcSprites(LocalizedContentManager content, IEnumerable<string> keys, IDictionary<string, bool> propagated)
+        private void ReloadNpcSprites(IEnumerable<string> keys, IDictionary<string, bool> propagated)
         {
             // get NPCs
             HashSet<string> lookup = new HashSet<string>(keys, StringComparer.OrdinalIgnoreCase);
@@ -851,16 +860,15 @@ namespace StardewModdingAPI.Metadata
             // update sprite
             foreach (var target in characters)
             {
-                target.Npc.Sprite.spriteTexture = this.DisposeIfNeeded(target.Npc.Sprite.spriteTexture, content.Load<Texture2D>(target.Key));
+                target.Npc.Sprite.spriteTexture = this.LoadAndDisposeIfNeeded(target.Npc.Sprite.spriteTexture, target.Key);
                 propagated[target.Key] = true;
             }
         }
 
         /// <summary>Reload the portraits for matching NPCs.</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="keys">The asset key to reload.</param>
         /// <param name="propagated">The asset keys which have been propagated.</param>
-        private void ReloadNpcPortraits(LocalizedContentManager content, IEnumerable<string> keys, IDictionary<string, bool> propagated)
+        private void ReloadNpcPortraits(IEnumerable<string> keys, IDictionary<string, bool> propagated)
         {
             // get NPCs
             HashSet<string> lookup = new HashSet<string>(keys, StringComparer.OrdinalIgnoreCase);
@@ -889,7 +897,7 @@ namespace StardewModdingAPI.Metadata
             // update portrait
             foreach (var target in characters)
             {
-                target.Npc.Portrait = this.DisposeIfNeeded(target.Npc.Portrait, content.Load<Texture2D>(target.Key));
+                target.Npc.Portrait = this.LoadAndDisposeIfNeeded(target.Npc.Portrait, target.Key);
                 propagated[target.Key] = true;
             }
         }
@@ -1155,15 +1163,26 @@ namespace StardewModdingAPI.Metadata
             return this.GetSegments(path).Length;
         }
 
-        /// <summary>Dispose a texture if <see cref="AggressiveMemoryOptimizations"/> are enabled and it's different from the new instance.</summary>
+        /// <summary>Load a texture, and dispose the old one if <see cref="AggressiveMemoryOptimizations"/> is enabled and it's different from the new instance.</summary>
         /// <param name="oldTexture">The previous texture to dispose.</param>
-        /// <param name="newTexture">The new texture being loaded.</param>
-        private Texture2D DisposeIfNeeded(Texture2D oldTexture, Texture2D newTexture)
+        /// <param name="key">The asset key to load.</param>
+        private Texture2D LoadAndDisposeIfNeeded(Texture2D oldTexture, string key)
         {
-            if (this.AggressiveMemoryOptimizations && oldTexture != null && !oldTexture.IsDisposed && !object.ReferenceEquals(oldTexture, newTexture))
-                oldTexture.Dispose();
+            // if aggressive memory optimizations are enabled, load the asset from the disposable
+            // content manager and dispose the old instance if needed.
+            if (this.AggressiveMemoryOptimizations)
+            {
+                GameContentManagerForAssetPropagation content = this.DisposableContentManager;
 
-            return newTexture;
+                Texture2D newTexture = content.Load<Texture2D>(key);
+                if (oldTexture?.IsDisposed == false && !object.ReferenceEquals(oldTexture, newTexture) && content.IsReponsibleFor(oldTexture))
+                    oldTexture.Dispose();
+
+                return newTexture;
+            }
+
+            // else just (re)load it from the main content manager
+            return this.MainContentManager.Load<Texture2D>(key);
         }
     }
 }

From e81e07594ca4863f9feb94c882b59ba7cc00a0ae Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 31 Jan 2021 22:12:36 -0500
Subject: [PATCH 096/856] extend aggressive memory optimization to a few more
 common textures (#757)

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 426fc3f6..e2a28c62 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -178,14 +178,19 @@ namespace StardewModdingAPI.Metadata
                 ** Buildings
                 ****/
                 case "buildings\\houses": // Farm
-                    reflection.GetField<Texture2D>(typeof(Farm), nameof(Farm.houseTextures)).SetValue(content.Load<Texture2D>(key));
-                    return true;
+                    {
+                        var field = reflection.GetField<Texture2D>(typeof(Farm), nameof(Farm.houseTextures));
+                        field.SetValue(
+                            this.LoadAndDisposeIfNeeded(field.GetValue(), key)
+                        );
+                        return true;
+                    }
 
                 /****
                 ** Content\Characters\Farmer
                 ****/
                 case "characters\\farmer\\accessories": // Game1.LoadContent
-                    FarmerRenderer.accessoriesTexture = content.Load<Texture2D>(key);
+                    FarmerRenderer.accessoriesTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.accessoriesTexture, key);
                     return true;
 
                 case "characters\\farmer\\farmer_base": // Farmer
@@ -195,19 +200,19 @@ namespace StardewModdingAPI.Metadata
                     return this.ReloadPlayerSprites(key);
 
                 case "characters\\farmer\\hairstyles": // Game1.LoadContent
-                    FarmerRenderer.hairStylesTexture = content.Load<Texture2D>(key);
+                    FarmerRenderer.hairStylesTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.hairStylesTexture, key);
                     return true;
 
                 case "characters\\farmer\\hats": // Game1.LoadContent
-                    FarmerRenderer.hatsTexture = content.Load<Texture2D>(key);
+                    FarmerRenderer.hatsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.hatsTexture, key);
                     return true;
 
                 case "characters\\farmer\\pants": // Game1.LoadContent
-                    FarmerRenderer.pantsTexture = content.Load<Texture2D>(key);
+                    FarmerRenderer.pantsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.pantsTexture, key);
                     return true;
 
                 case "characters\\farmer\\shirts": // Game1.LoadContent
-                    FarmerRenderer.shirtsTexture = content.Load<Texture2D>(key);
+                    FarmerRenderer.shirtsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.shirtsTexture, key);
                     return true;
 
                 /****

From 54e7b5b846dfd542af3c8a904a57fc5ccc44ecb5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 3 Feb 2021 20:24:25 -0500
Subject: [PATCH 097/856] enable aggressive memory optimizations by default
 (#757)

The new approach should be safe, and no errors were reported so far by alpha testers.
---
 docs/release-notes.md                     | 4 ++--
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs   | 2 +-
 src/SMAPI/Framework/Logging/LogManager.cs | 2 --
 src/SMAPI/Framework/Models/SConfig.cs     | 2 +-
 src/SMAPI/SMAPI.config.json               | 2 +-
 5 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e54fd24b..9cea9fa9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,11 +9,11 @@
 
 ## Upcoming release
 * For players:
-  * Added _aggressive memory optimization_ option. This is experimental and disabled by default; you can enable it in `smapi-internal/config.json` if you experience `OutOfMemoryException` crashes.
+  * Added more aggressive memory optimization which should eliminate many cases of `OutOfMemoryException` crashes.
   * Fixed error running `install on Windows.bat` in very rare cases.
 
 * For modders:
-  * Fixed SMAPI toolkit defaulting the mod type to SMAPI if its `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
+  * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
 
 ## 3.9.1
 Released 25 January 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index 2f6f1939..f543814e 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -30,7 +30,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
             LogManager logManager = core.GetType().GetField("LogManager", BindingFlags.Instance | BindingFlags.NonPublic)?.GetValue(core) as LogManager;
             if (logManager == null)
             {
-                this.Monitor.Log($"Can't access SMAPI's internal log manager. Error-handling patches won't be applied.", LogLevel.Error);
+                this.Monitor.Log("Can't access SMAPI's internal log manager. Error-handling patches won't be applied.", LogLevel.Error);
                 return;
             }
 
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 5f191873..2c7be399 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -295,8 +295,6 @@ namespace StardewModdingAPI.Framework.Logging
             // warnings
             if (!settings.CheckForUpdates)
                 this.Monitor.Log("You disabled update checks, so you won't be notified of new SMAPI or mod updates. Running an old version of SMAPI is not recommended. You can undo this by reinstalling SMAPI.", LogLevel.Warn);
-            if (settings.AggressiveMemoryOptimizations)
-                this.Monitor.Log("You enabled aggressive memory optimizations. This is an experimental option which may cause errors or crashes. You can undo this by reinstalling SMAPI.", LogLevel.Warn);
             if (!settings.RewriteMods)
                 this.Monitor.Log("You disabled rewriting broken mods, so many older mods may fail to load. You can undo this by reinstalling SMAPI.", LogLevel.Info);
             if (!this.Monitor.WriteToConsole)
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 382ae41f..4a80e34c 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(VerboseLogging)] = false,
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
-            [nameof(AggressiveMemoryOptimizations)] = false
+            [nameof(AggressiveMemoryOptimizations)] = true
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 6a485cbd..a9e6f389 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -41,7 +41,7 @@ copy all the settings, or you may cause bugs due to overridden changes in future
 
     /**
      * Whether to enable more aggressive memory optimizations.
-     * THIS IS EXPERIMENTAL AND MAY CAUSE ERRORS OR CRASHES.
+     * You can try disabling this if you get ObjectDisposedException errors.
      */
     "AggressiveMemoryOptimizations": true,
 

From efec87065780426db15c51a7e68315ff488a89c0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 6 Feb 2021 13:03:37 -0500
Subject: [PATCH 098/856] fix edge case in non-English asset cache after
 returning to title screen

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Framework/ContentCoordinator.cs | 26 +++++++++++++++++++++++
 src/SMAPI/Framework/SCore.cs              |  1 +
 3 files changed, 28 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9cea9fa9..9f4ea50a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -14,6 +14,7 @@
 
 * For modders:
   * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
+  * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.
 
 ## 3.9.1
 Released 25 January 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 6a7385c3..b7c15526 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -203,6 +203,32 @@ namespace StardewModdingAPI.Framework
             });
         }
 
+        /// <summary>Clean up when the player is returning to the title screen.</summary>
+        /// <remarks>This is called after the player returns to the title screen, but before <see cref="Game1.CleanupReturningToTitle"/> runs.</remarks>
+        public void OnReturningToTitleScreen()
+        {
+            // The game clears LocalizedContentManager.localizedAssetNames after returning to the title screen. That
+            // causes an inconsistency in the SMAPI asset cache, which leads to an edge case where assets already
+            // provided by mods via IAssetLoader when playing in non-English are ignored.
+            //
+            // For example, let's say a mod provides the 'Data\mail' asset through IAssetLoader when playing in
+            // Portuguese. Here's the normal load process after it's loaded:
+            //   1. The game requests Data\mail.
+            //   2. SMAPI sees that it's already cached, and calls LoadRaw to bypass asset interception.
+            //   3. LoadRaw sees that there's a localized key mapping, and gets the mapped key.
+            //   4. In this case "Data\mail" is mapped to "Data\mail" since it was loaded by a mod, so it loads that
+            //      asset.
+            //
+            // When the game clears localizedAssetNames, that process goes wrong in step 4:
+            //  3. LoadRaw sees that there's no localized key mapping *and* the locale is non-English, so it attempts
+            //     to load from the localized key format.
+            //  4. In this case that's 'Data\mail.pt-BR', so it successfully loads that asset.
+            //  5. Since we've bypassed asset interception at this point, it's loaded directly from the base content
+            //     manager without mod changes.
+
+            this.InvalidateCache(asset => true);
+        }
+
         /// <summary>Get whether this asset is mapped to a mod folder.</summary>
         /// <param name="key">The asset key.</param>
         public bool IsManagedAssetKey(string key)
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 0ae69f0f..2d783eb2 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1118,6 +1118,7 @@ namespace StardewModdingAPI.Framework
         {
             // perform cleanup
             this.Multiplayer.CleanupOnMultiplayerExit();
+            this.ContentCore.OnReturningToTitleScreen();
             this.JustReturnedToTitle = true;
         }
 

From 5ea871fee59e4a7ed7280d1678a76ed8019337b4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 6 Feb 2021 19:46:34 -0500
Subject: [PATCH 099/856] update schema for Content Patcher 1.20

---
 docs/release-notes.md                              | 3 +++
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 4 ++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9f4ea50a..cb54ee98 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,6 +16,9 @@
   * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
   * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.
 
+* For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.20.
+
 ## 3.9.1
 Released 25 January 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index 92149f4d..21514979 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -11,9 +11,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features and avoid obsolete behavior.",
             "type": "string",
-            "const": "1.19.0",
+            "const": "1.20.0",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.19.0'."
+                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.20.0'."
             }
         },
         "ConfigSchema": {

From 97d3501e20c9b97dc85cfca32ccea4f55c9d61ff Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 6 Feb 2021 20:47:04 -0500
Subject: [PATCH 100/856] improve ErrorHandler's error handling if it can't
 access log manager

---
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs | 27 +++++++++++++++----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index f543814e..e4bcc5bc 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -26,21 +26,15 @@ namespace StardewModdingAPI.Mods.ErrorHandler
         public override void Entry(IModHelper helper)
         {
             // get SMAPI core types
-            SCore core = SCore.Instance;
-            LogManager logManager = core.GetType().GetField("LogManager", BindingFlags.Instance | BindingFlags.NonPublic)?.GetValue(core) as LogManager;
-            if (logManager == null)
-            {
-                this.Monitor.Log("Can't access SMAPI's internal log manager. Error-handling patches won't be applied.", LogLevel.Error);
-                return;
-            }
+            IMonitor monitorForGame = this.GetMonitorForGame();
 
             // apply patches
             new GamePatcher(this.Monitor).Apply(
-                new EventErrorPatch(logManager.MonitorForGame),
-                new DialogueErrorPatch(logManager.MonitorForGame, this.Helper.Reflection),
+                new EventErrorPatch(monitorForGame),
+                new DialogueErrorPatch(monitorForGame, this.Helper.Reflection),
                 new ObjectErrorPatch(),
                 new LoadErrorPatch(this.Monitor, this.OnSaveContentRemoved),
-                new ScheduleErrorPatch(logManager.MonitorForGame),
+                new ScheduleErrorPatch(monitorForGame),
                 new UtilityErrorPatches()
             );
 
@@ -61,7 +55,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
         /// <summary>The method invoked when a save is loaded.</summary>
         /// <param name="sender">The event sender.</param>
         /// <param name="e">The event arguments.</param>
-        public void OnSaveLoaded(object sender, SaveLoadedEventArgs e)
+        private void OnSaveLoaded(object sender, SaveLoadedEventArgs e)
         {
             // show in-game warning for removed save content
             if (this.IsSaveContentRemoved)
@@ -70,5 +64,16 @@ namespace StardewModdingAPI.Mods.ErrorHandler
                 Game1.addHUDMessage(new HUDMessage(this.Helper.Translation.Get("warn.invalid-content-removed"), HUDMessage.error_type));
             }
         }
+
+        /// <summary>Get the monitor with which to log game errors.</summary>
+        private IMonitor GetMonitorForGame()
+        {
+            SCore core = SCore.Instance;
+            LogManager logManager = core.GetType().GetField("LogManager", BindingFlags.Instance | BindingFlags.NonPublic)?.GetValue(core) as LogManager;
+            if (logManager == null)
+                this.Monitor.Log("Can't access SMAPI's internal log manager. Some game errors may be reported as being from Error Handler.", LogLevel.Error);
+
+            return logManager?.MonitorForGame ?? this.Monitor;
+        }
     }
 }

From 67c52af72d6d0c4fddd3a07b159cb44b5c277599 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 6 Feb 2021 21:12:01 -0500
Subject: [PATCH 101/856] add early detection of disposed assets in error
 handler mod

---
 docs/release-notes.md                         |  3 +
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  1 +
 .../Patches/SpriteBatchValidationPatches.cs   | 63 +++++++++++++++++++
 3 files changed, 67 insertions(+)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index cb54ee98..9d95dacb 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,6 +16,9 @@
   * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
   * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.
 
+* For the ErrorHandler mod:
+  * Added early detection of disposed textures so the crash stack trace shows the actual code which used them.
+
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.20.
 
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index e4bcc5bc..87f531fe 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -35,6 +35,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
                 new ObjectErrorPatch(),
                 new LoadErrorPatch(this.Monitor, this.OnSaveContentRemoved),
                 new ScheduleErrorPatch(monitorForGame),
+                new SpriteBatchValidationPatches(),
                 new UtilityErrorPatches()
             );
 
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
new file mode 100644
index 00000000..0211cfb1
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
@@ -0,0 +1,63 @@
+#if HARMONY_2
+using HarmonyLib;
+#else
+using Harmony;
+#endif
+using System;
+using System.Diagnostics.CodeAnalysis;
+using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework.Patching;
+
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
+{
+    /// <summary>Harmony patch for <see cref="SpriteBatch"/> to validate textures earlier.</summary>
+    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    internal class SpriteBatchValidationPatches : IHarmonyPatch
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <inheritdoc />
+        public string Name => nameof(SpriteBatchValidationPatches);
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <inheritdoc />
+#if HARMONY_2
+        public void Apply(Harmony harmony)
+#else
+        public void Apply(HarmonyInstance harmony)
+#endif
+        {
+            harmony.Patch(
+#if SMAPI_FOR_WINDOWS
+                original: AccessTools.Method(typeof(SpriteBatch), "InternalDraw"),
+#else
+                original: AccessTools.Method(typeof(SpriteBatch), "CheckValid", new[] { typeof(Texture2D) }),
+#endif
+                postfix: new HarmonyMethod(this.GetType(), nameof(SpriteBatchValidationPatches.After_SpriteBatch_CheckValid))
+            );
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+#if SMAPI_FOR_WINDOWS
+        /// <summary>The method to call instead of <see cref="SpriteBatch.InternalDraw"/>.</summary>
+        /// <param name="texture">The texture to validate.</param>
+#else
+        /// <summary>The method to call instead of <see cref="SpriteBatch.CheckValid"/>.</summary>
+        /// <param name="texture">The texture to validate.</param>
+#endif
+        private static void After_SpriteBatch_CheckValid(Texture2D texture)
+        {
+            if (texture?.IsDisposed == true)
+                throw new ObjectDisposedException("Cannot draw this texture because it's disposed.");
+        }
+    }
+}

From 5173ddf53571703c3895cd5f2d45891489d96ff9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Feb 2021 18:07:38 -0500
Subject: [PATCH 102/856] fix compat list error if mod has no name field due to
 wiki rendering issues

---
 docs/release-notes.md                       | 1 +
 src/SMAPI.Web/Controllers/ModsController.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9d95dacb..7e2829d3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -21,6 +21,7 @@
 
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.20.
+  * Fixed mod compatibility list error if a mod has no name.
 
 ## 3.9.1
 Released 25 January 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Web/Controllers/ModsController.cs b/src/SMAPI.Web/Controllers/ModsController.cs
index 24e36709..c62ed605 100644
--- a/src/SMAPI.Web/Controllers/ModsController.cs
+++ b/src/SMAPI.Web/Controllers/ModsController.cs
@@ -62,7 +62,7 @@ namespace StardewModdingAPI.Web.Controllers
                 mods: this.Cache
                     .GetWikiMods()
                     .Select(mod => new ModModel(mod.Data))
-                    .OrderBy(p => Regex.Replace(p.Name.ToLower(), "[^a-z0-9]", "")), // ignore case, spaces, and special characters when sorting
+                    .OrderBy(p => Regex.Replace((p.Name ?? "").ToLower(), "[^a-z0-9]", "")), // ignore case, spaces, and special characters when sorting
                 lastUpdated: metadata.LastUpdated,
                 isStale: this.Cache.IsStale(metadata.LastUpdated, this.StaleMinutes)
             );

From fa3305e1d8cb079fcfbccd87d2368627b4138ee4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Feb 2021 19:32:48 -0500
Subject: [PATCH 103/856] add error details when an event command fails

---
 docs/release-notes.md                         |  1 +
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  3 +-
 .../Patches/EventPatches.cs                   | 67 +++++++++++++++++++
 ...ntErrorPatch.cs => GameLocationPatches.cs} | 14 ++--
 4 files changed, 77 insertions(+), 8 deletions(-)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
 rename src/SMAPI.Mods.ErrorHandler/Patches/{EventErrorPatch.cs => GameLocationPatches.cs} (88%)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7e2829d3..e5cac9e0 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,6 +18,7 @@
 
 * For the ErrorHandler mod:
   * Added early detection of disposed textures so the crash stack trace shows the actual code which used them.
+  * Added error details when an event command fails.
 
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.20.
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index 87f531fe..d9426d75 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -30,8 +30,9 @@ namespace StardewModdingAPI.Mods.ErrorHandler
 
             // apply patches
             new GamePatcher(this.Monitor).Apply(
-                new EventErrorPatch(monitorForGame),
                 new DialogueErrorPatch(monitorForGame, this.Helper.Reflection),
+                new EventPatches(monitorForGame),
+                new GameLocationPatches(monitorForGame),
                 new ObjectErrorPatch(),
                 new LoadErrorPatch(this.Monitor, this.OnSaveContentRemoved),
                 new ScheduleErrorPatch(monitorForGame),
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
new file mode 100644
index 00000000..a15c1d32
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
@@ -0,0 +1,67 @@
+using System;
+using System.Diagnostics.CodeAnalysis;
+#if HARMONY_2
+using HarmonyLib;
+#else
+using Harmony;
+#endif
+using StardewModdingAPI.Framework.Patching;
+using StardewValley;
+
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
+{
+    /// <summary>Harmony patches for <see cref="Event"/> which intercept errors to log more details.</summary>
+    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    internal class EventPatches : IHarmonyPatch
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Writes messages to the console and log file on behalf of the game.</summary>
+        private static IMonitor MonitorForGame;
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <inheritdoc />
+        public string Name => nameof(EventPatches);
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="monitorForGame">Writes messages to the console and log file on behalf of the game.</param>
+        public EventPatches(IMonitor monitorForGame)
+        {
+            EventPatches.MonitorForGame = monitorForGame;
+        }
+
+        /// <inheritdoc />
+#if HARMONY_2
+        public void Apply(Harmony harmony)
+#else
+        public void Apply(HarmonyInstance harmony)
+#endif
+        {
+            harmony.Patch(
+                original: AccessTools.Method(typeof(Event), nameof(Event.LogErrorAndHalt)),
+                postfix: new HarmonyMethod(this.GetType(), nameof(EventPatches.After_Event_LogErrorAndHalt))
+            );
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>The method to call after <see cref="Event.LogErrorAndHalt"/>.</summary>
+        /// <param name="e">The exception being logged.</param>
+        private static void After_Event_LogErrorAndHalt(Exception e)
+        {
+            EventPatches.MonitorForGame.Log(e.ToString(), LogLevel.Error);
+        }
+    }
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/EventErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
similarity index 88%
rename from src/SMAPI.Mods.ErrorHandler/Patches/EventErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
index fabc6cad..c10f2de7 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/EventErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
@@ -15,7 +15,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class EventErrorPatch : IHarmonyPatch
+    internal class GameLocationPatches : IHarmonyPatch
     {
         /*********
         ** Fields
@@ -28,7 +28,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Accessors
         *********/
         /// <inheritdoc />
-        public string Name => nameof(EventErrorPatch);
+        public string Name => nameof(GameLocationPatches);
 
 
         /*********
@@ -36,9 +36,9 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="monitorForGame">Writes messages to the console and log file on behalf of the game.</param>
-        public EventErrorPatch(IMonitor monitorForGame)
+        public GameLocationPatches(IMonitor monitorForGame)
         {
-            EventErrorPatch.MonitorForGame = monitorForGame;
+            GameLocationPatches.MonitorForGame = monitorForGame;
         }
 
         /// <inheritdoc />
@@ -55,7 +55,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(GameLocation), "checkEventPrecondition"),
-                prefix: new HarmonyMethod(this.GetType(), nameof(EventErrorPatch.Before_GameLocation_CheckEventPrecondition))
+                prefix: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Before_GameLocation_CheckEventPrecondition))
             );
         }
 #endif
@@ -89,7 +89,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <returns>Returns whether to execute the original method.</returns>
         private static bool Before_GameLocation_CheckEventPrecondition(GameLocation __instance, ref int __result, string precondition, MethodInfo __originalMethod)
         {
-            const string key = nameof(EventErrorPatch.Before_GameLocation_CheckEventPrecondition);
+            const string key = nameof(GameLocationPatches.Before_GameLocation_CheckEventPrecondition);
             if (!PatchHelper.StartIntercept(key))
                 return true;
 
@@ -101,7 +101,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             catch (TargetInvocationException ex)
             {
                 __result = -1;
-                EventErrorPatch.MonitorForGame.Log($"Failed parsing event precondition ({precondition}):\n{ex.InnerException}", LogLevel.Error);
+                GameLocationPatches.MonitorForGame.Log($"Failed parsing event precondition ({precondition}):\n{ex.InnerException}", LogLevel.Error);
                 return false;
             }
             finally

From b1876dec7ac6132b03b06277ef4d3bd8900b8805 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 13 Feb 2021 16:54:57 -0500
Subject: [PATCH 104/856] fix asset propagation for map seats

---
 docs/release-notes.md                     |  3 ++-
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 25 +++++++++++++++++++++--
 2 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e5cac9e0..82913873 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,8 +13,9 @@
   * Fixed error running `install on Windows.bat` in very rare cases.
 
 * For modders:
-  * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
+  * Fixed asset propagation for `TileSheets/ChairTiles` not changing existing map seats.
   * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.
+  * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
 
 * For the ErrorHandler mod:
   * Added early detection of disposed textures so the crash stack trace shows the actual code which used them.
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index e2a28c62..5fb1b10d 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -452,8 +452,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "tilesheets\\chairtiles": // Game1.LoadContent
-                    MapSeat.mapChairTexture = content.Load<Texture2D>(key);
-                    return true;
+                    return this.ReloadChairTiles(content, key);
 
                 case "tilesheets\\craftables": // Game1.LoadContent
                     Game1.bigCraftableSpriteSheet = content.Load<Texture2D>(key);
@@ -691,6 +690,28 @@ namespace StardewModdingAPI.Metadata
             return false;
         }
 
+        /// <summary>Reload map seat textures.</summary>
+        /// <param name="content">The content manager through which to reload the asset.</param>
+        /// <param name="key">The asset key to reload.</param>
+        /// <returns>Returns whether any textures were reloaded.</returns>
+        private bool ReloadChairTiles(LocalizedContentManager content, string key)
+        {
+            MapSeat.mapChairTexture = content.Load<Texture2D>(key);
+
+            foreach (var location in this.GetLocations())
+            {
+                foreach (MapSeat seat in location.mapSeats.Where(p => p != null))
+                {
+                    string curKey = this.NormalizeAssetNameIgnoringEmpty(seat._loadedTextureFile);
+
+                    if (curKey == null || key.Equals(curKey, StringComparison.OrdinalIgnoreCase))
+                        seat.overlayTexture = MapSeat.mapChairTexture;
+                }
+            }
+
+            return true;
+        }
+
         /// <summary>Reload critter textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="key">The asset key to reload.</param>

From 50d7e95920e1963af583f398055c6e8ad5df1033 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 19 Feb 2021 22:54:01 -0500
Subject: [PATCH 105/856] fix errors parsing the mod compatibility list on the
 new wiki

---
 docs/release-notes.md                                  | 1 +
 src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 82913873..041071e0 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -22,6 +22,7 @@
   * Added error details when an event command fails.
 
 * For the web UI:
+  * Updated for the new wiki.
   * Updated the JSON validator/schema for Content Patcher 1.20.
   * Fixed mod compatibility list error if a mod has no name.
 
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index 89a22eaf..da312471 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -50,13 +50,13 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             doc.LoadHtml(html);
 
             // fetch game versions
-            string stableVersion = doc.DocumentNode.SelectSingleNode("div[@class='game-stable-version']")?.InnerText;
-            string betaVersion = doc.DocumentNode.SelectSingleNode("div[@class='game-beta-version']")?.InnerText;
+            string stableVersion = doc.DocumentNode.SelectSingleNode("//div[@class='game-stable-version']")?.InnerText;
+            string betaVersion = doc.DocumentNode.SelectSingleNode("//div[@class='game-beta-version']")?.InnerText;
             if (betaVersion == stableVersion)
                 betaVersion = null;
 
             // find mod entries
-            HtmlNodeCollection modNodes = doc.DocumentNode.SelectNodes("table[@id='mod-list']//tr[@class='mod']");
+            HtmlNodeCollection modNodes = doc.DocumentNode.SelectNodes("//table[@id='mod-list']//tr[@class='mod']");
             if (modNodes == null)
                 throw new InvalidOperationException("Can't parse wiki compatibility list, no mods found.");
 

From 79aee3fba7a43025d84527f883ce6715d7140302 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Feb 2021 13:45:10 -0500
Subject: [PATCH 106/856] reduce performance impact of new cache fix

---
 src/SMAPI/Framework/ContentCoordinator.cs     | 27 +++++--------------
 .../ContentManagers/BaseContentManager.cs     |  3 +++
 .../ContentManagers/GameContentManager.cs     | 25 +++++++++++++++++
 .../ContentManagers/IContentManager.cs        | 10 ++++---
 4 files changed, 41 insertions(+), 24 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index b7c15526..32195fff 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI.Framework
         private bool IsDisposed;
 
         /// <summary>A lock used to prevent asynchronous changes to the content manager list.</summary>
-        /// <remarks>The game may adds content managers in asynchronous threads (e.g. when populating the load screen).</remarks>
+        /// <remarks>The game may add content managers in asynchronous threads (e.g. when populating the load screen).</remarks>
         private readonly ReaderWriterLockSlim ContentManagerLock = new ReaderWriterLockSlim();
 
         /// <summary>A cache of ordered tilesheet IDs used by vanilla maps.</summary>
@@ -207,26 +207,11 @@ namespace StardewModdingAPI.Framework
         /// <remarks>This is called after the player returns to the title screen, but before <see cref="Game1.CleanupReturningToTitle"/> runs.</remarks>
         public void OnReturningToTitleScreen()
         {
-            // The game clears LocalizedContentManager.localizedAssetNames after returning to the title screen. That
-            // causes an inconsistency in the SMAPI asset cache, which leads to an edge case where assets already
-            // provided by mods via IAssetLoader when playing in non-English are ignored.
-            //
-            // For example, let's say a mod provides the 'Data\mail' asset through IAssetLoader when playing in
-            // Portuguese. Here's the normal load process after it's loaded:
-            //   1. The game requests Data\mail.
-            //   2. SMAPI sees that it's already cached, and calls LoadRaw to bypass asset interception.
-            //   3. LoadRaw sees that there's a localized key mapping, and gets the mapped key.
-            //   4. In this case "Data\mail" is mapped to "Data\mail" since it was loaded by a mod, so it loads that
-            //      asset.
-            //
-            // When the game clears localizedAssetNames, that process goes wrong in step 4:
-            //  3. LoadRaw sees that there's no localized key mapping *and* the locale is non-English, so it attempts
-            //     to load from the localized key format.
-            //  4. In this case that's 'Data\mail.pt-BR', so it successfully loads that asset.
-            //  5. Since we've bypassed asset interception at this point, it's loaded directly from the base content
-            //     manager without mod changes.
-
-            this.InvalidateCache(asset => true);
+            this.ContentManagerLock.InReadLock(() =>
+            {
+                foreach (IContentManager contentManager in this.ContentManagers)
+                    contentManager.OnReturningToTitleScreen();
+            });
         }
 
         /// <summary>Get whether this asset is mapped to a mod folder.</summary>
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 709c624e..b6b3a7a0 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -133,6 +133,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Perform any cleanup needed when the locale changes.</summary>
         public virtual void OnLocaleChanged() { }
 
+        /// <inheritdoc />
+        public virtual void OnReturningToTitleScreen() { }
+
         /// <summary>Normalize path separators in a file path. For asset keys, see <see cref="AssertAndNormalizeAssetName"/> instead.</summary>
         /// <param name="path">The file path to normalize.</param>
         [Pure]
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index f8ee575f..e3d1e569 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -140,6 +140,31 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 this.Monitor.Log($"Invalidated {invalidated.Length} asset names: {string.Join(", ", invalidated)} for locale change.", LogLevel.Trace);
         }
 
+        /// <inheritdoc />
+        public override void OnReturningToTitleScreen()
+        {
+            // The game clears LocalizedContentManager.localizedAssetNames after returning to the title screen. That
+            // causes an inconsistency in the SMAPI asset cache, which leads to an edge case where assets already
+            // provided by mods via IAssetLoader when playing in non-English are ignored.
+            //
+            // For example, let's say a mod provides the 'Data\mail' asset through IAssetLoader when playing in
+            // Portuguese. Here's the normal load process after it's loaded:
+            //   1. The game requests Data\mail.
+            //   2. SMAPI sees that it's already cached, and calls LoadRaw to bypass asset interception.
+            //   3. LoadRaw sees that there's a localized key mapping, and gets the mapped key.
+            //   4. In this case "Data\mail" is mapped to "Data\mail" since it was loaded by a mod, so it loads that
+            //      asset.
+            //
+            // When the game clears localizedAssetNames, that process goes wrong in step 4:
+            //  3. LoadRaw sees that there's no localized key mapping *and* the locale is non-English, so it attempts
+            //     to load from the localized key format.
+            //  4. In this case that's 'Data\mail.pt-BR', so it successfully loads that asset.
+            //  5. Since we've bypassed asset interception at this point, it's loaded directly from the base content
+            //     manager without mod changes.
+            if (LocalizedContentManager.CurrentLanguageCode != LocalizedContentManager.LanguageCode.en)
+                this.InvalidateCache((_, _) => true);
+        }
+
         /// <summary>Create a new content manager for temporary use.</summary>
         public override LocalizedContentManager CreateTemporary()
         {
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index 0e7edd8f..1e222472 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -36,9 +36,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
         T Load<T>(string assetName, LocalizedContentManager.LanguageCode language, bool useCache);
 
-        /// <summary>Perform any cleanup needed when the locale changes.</summary>
-        void OnLocaleChanged();
-
         /// <summary>Normalize path separators in a file path. For asset keys, see <see cref="AssertAndNormalizeAssetName"/> instead.</summary>
         /// <param name="path">The file path to normalize.</param>
         [Pure]
@@ -69,5 +66,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
         /// <returns>Returns the invalidated asset names and instances.</returns>
         IDictionary<string, object> InvalidateCache(Func<string, Type, bool> predicate, bool dispose = false);
+
+        /// <summary>Perform any cleanup needed when the locale changes.</summary>
+        void OnLocaleChanged();
+
+        /// <summary>Clean up when the player is returning to the title screen.</summary>
+        /// <remarks>This is called after the player returns to the title screen, but before <see cref="Game1.CleanupReturningToTitle"/> runs.</remarks>
+        void OnReturningToTitleScreen();
     }
 }

From ad80f8b078176519d49732b28a03465e6d8a6501 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Feb 2021 13:50:08 -0500
Subject: [PATCH 107/856] use inheritdoc, minor cleanup

---
 .../ContentManagers/BaseContentManager.cs     | 56 ++++++-------------
 .../ContentManagers/GameContentManager.cs     | 27 +++------
 .../GameContentManagerForAssetPropagation.cs  |  2 +-
 .../ContentManagers/ModContentManager.cs      | 21 ++-----
 src/SMAPI/Metadata/CoreAssetPropagator.cs     |  2 +-
 5 files changed, 32 insertions(+), 76 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index b6b3a7a0..1a64dab8 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -5,7 +5,6 @@ using System.Diagnostics.Contracts;
 using System.Globalization;
 using System.IO;
 using System.Linq;
-using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
@@ -53,16 +52,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Accessors
         *********/
-        /// <summary>A name for the mod manager. Not guaranteed to be unique.</summary>
+        /// <inheritdoc />
         public string Name { get; }
 
-        /// <summary>The current language as a constant.</summary>
+        /// <inheritdoc />
         public LanguageCode Language => this.GetCurrentLanguage();
 
-        /// <summary>The absolute path to the <see cref="ContentManager.RootDirectory"/>.</summary>
+        /// <inheritdoc />
         public string FullRootDirectory => Path.Combine(Constants.ExecutionPath, this.RootDirectory);
 
-        /// <summary>Whether this content manager can be targeted by managed asset keys (e.g. to load assets from a mod folder).</summary>
+        /// <inheritdoc />
         public bool IsNamespaced { get; }
 
 
@@ -97,56 +96,42 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.BaseDisposableReferences = reflection.GetField<List<IDisposable>>(this, "disposableAssets").GetValue();
         }
 
-        /// <summary>Load an asset that has been processed by the content pipeline.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
+        /// <inheritdoc />
         public override T Load<T>(string assetName)
         {
             return this.Load<T>(assetName, this.Language, useCache: true);
         }
 
-        /// <summary>Load an asset that has been processed by the content pipeline.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        /// <param name="language">The language code for which to load content.</param>
+        /// <inheritdoc />
         public override T Load<T>(string assetName, LanguageCode language)
         {
             return this.Load<T>(assetName, language, useCache: true);
         }
 
-        /// <summary>Load an asset that has been processed by the content pipeline.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        /// <param name="language">The language code for which to load content.</param>
-        /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
+        /// <inheritdoc />
         public abstract T Load<T>(string assetName, LocalizedContentManager.LanguageCode language, bool useCache);
 
-        /// <summary>Load the base asset without localization.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
+        /// <inheritdoc />
         [Obsolete("This method is implemented for the base game and should not be used directly. To load an asset from the underlying content manager directly, use " + nameof(BaseContentManager.RawLoad) + " instead.")]
         public override T LoadBase<T>(string assetName)
         {
             return this.Load<T>(assetName, LanguageCode.en, useCache: true);
         }
 
-        /// <summary>Perform any cleanup needed when the locale changes.</summary>
+        /// <inheritdoc />
         public virtual void OnLocaleChanged() { }
 
         /// <inheritdoc />
         public virtual void OnReturningToTitleScreen() { }
 
-        /// <summary>Normalize path separators in a file path. For asset keys, see <see cref="AssertAndNormalizeAssetName"/> instead.</summary>
-        /// <param name="path">The file path to normalize.</param>
+        /// <inheritdoc />
         [Pure]
         public string NormalizePathSeparators(string path)
         {
             return this.Cache.NormalizePathSeparators(path);
         }
 
-        /// <summary>Assert that the given key has a valid format and return a normalized form consistent with the underlying cache.</summary>
-        /// <param name="assetName">The asset key to check.</param>
-        /// <exception cref="SContentLoadException">The asset key is empty or contains invalid characters.</exception>
+        /// <inheritdoc />
         [SuppressMessage("ReSharper", "ParameterOnlyUsedForPreconditionCheck.Local", Justification = "Parameter is only used for assertion checks by design.")]
         public string AssertAndNormalizeAssetName(string assetName)
         {
@@ -163,29 +148,26 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /****
         ** Content loading
         ****/
-        /// <summary>Get the current content locale.</summary>
+        /// <inheritdoc />
         public string GetLocale()
         {
             return this.GetLocale(this.GetCurrentLanguage());
         }
 
-        /// <summary>The locale for a language.</summary>
-        /// <param name="language">The language.</param>
+        /// <inheritdoc />
         public string GetLocale(LanguageCode language)
         {
             return this.LanguageCodeString(language);
         }
 
-        /// <summary>Get whether the content manager has already loaded and cached the given asset.</summary>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        /// <param name="language">The language.</param>
+        /// <inheritdoc />
         public bool IsLoaded(string assetName, LanguageCode language)
         {
             assetName = this.Cache.NormalizeKey(assetName);
             return this.IsNormalizedKeyLoaded(assetName, language);
         }
 
-        /// <summary>Get the cached asset keys.</summary>
+        /// <inheritdoc />
         public IEnumerable<string> GetAssetKeys()
         {
             return this.Cache.Keys
@@ -196,10 +178,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /****
         ** Cache invalidation
         ****/
-        /// <summary>Purge matched assets from the cache.</summary>
-        /// <param name="predicate">Matches the asset keys to invalidate.</param>
-        /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
-        /// <returns>Returns the invalidated asset names and instances.</returns>
+        /// <inheritdoc />
         public IDictionary<string, object> InvalidateCache(Func<string, Type, bool> predicate, bool dispose = false)
         {
             IDictionary<string, object> removeAssets = new Dictionary<string, object>(StringComparer.OrdinalIgnoreCase);
@@ -228,8 +207,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return removeAssets;
         }
 
-        /// <summary>Dispose held resources.</summary>
-        /// <param name="isDisposing">Whether the content manager is being disposed (rather than finalized).</param>
+        /// <inheritdoc />
         protected override void Dispose(bool isDisposing)
         {
             // ignore if disposed
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index e3d1e569..8e78faba 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -59,11 +59,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
         }
 
-        /// <summary>Load an asset that has been processed by the content pipeline.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        /// <param name="language">The language code for which to load content.</param>
-        /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
+        /// <inheritdoc />
         public override T Load<T>(string assetName, LocalizedContentManager.LanguageCode language, bool useCache)
         {
             // raise first-load callback
@@ -95,7 +91,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             if (this.AssetsBeingLoaded.Contains(assetName))
             {
                 this.Monitor.Log($"Broke loop while loading asset '{assetName}'.", LogLevel.Warn);
-                this.Monitor.Log($"Bypassing mod loaders for this asset. Stack trace:\n{Environment.StackTrace}", LogLevel.Trace);
+                this.Monitor.Log($"Bypassing mod loaders for this asset. Stack trace:\n{Environment.StackTrace}");
                 data = this.RawLoad<T>(assetName, language, useCache);
             }
             else
@@ -117,7 +113,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return data;
         }
 
-        /// <summary>Perform any cleanup needed when the locale changes.</summary>
+        /// <inheritdoc />
         public override void OnLocaleChanged()
         {
             base.OnLocaleChanged();
@@ -137,7 +133,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 .OrderBy(p => p, StringComparer.OrdinalIgnoreCase)
                 .ToArray();
             if (invalidated.Any())
-                this.Monitor.Log($"Invalidated {invalidated.Length} asset names: {string.Join(", ", invalidated)} for locale change.", LogLevel.Trace);
+                this.Monitor.Log($"Invalidated {invalidated.Length} asset names: {string.Join(", ", invalidated)} for locale change.");
         }
 
         /// <inheritdoc />
@@ -165,7 +161,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 this.InvalidateCache((_, _) => true);
         }
 
-        /// <summary>Create a new content manager for temporary use.</summary>
+        /// <inheritdoc />
         public override LocalizedContentManager CreateTemporary()
         {
             return this.Coordinator.CreateGameContentManager("(temporary)");
@@ -175,9 +171,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
-        /// <summary>Get whether an asset has already been loaded.</summary>
-        /// <param name="normalizedAssetName">The normalized asset name.</param>
-        /// <param name="language">The language to check.</param>
+        /// <inheritdoc />
         protected override bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language)
         {
             string cachedKey = null;
@@ -191,12 +185,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 : this.Cache.ContainsKey(normalizedAssetName);
         }
 
-        /// <summary>Add tracking data to an asset and add it to the cache.</summary>
-        /// <typeparam name="T">The type of asset to inject.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        /// <param name="value">The asset value.</param>
-        /// <param name="language">The language code for which to inject the asset.</param>
-        /// <param name="useCache">Whether to save the asset to the asset cache.</param>
+        /// <inheritdoc />
         protected override void TrackAsset<T>(string assetName, T value, LanguageCode language, bool useCache)
         {
             // handle explicit language in asset name
@@ -384,7 +373,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 try
                 {
                     editor.Edit<T>(asset);
-                    this.Monitor.Log($"{mod.DisplayName} edited {info.AssetName}.", LogLevel.Trace);
+                    this.Monitor.Log($"{mod.DisplayName} edited {info.AssetName}.");
                 }
                 catch (Exception ex)
                 {
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
index cbbebf02..61683ce6 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
@@ -37,7 +37,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Get whether a texture was loaded by this content manager.</summary>
         /// <param name="texture">The texture to check.</param>
-        public bool IsReponsibleFor(Texture2D texture)
+        public bool IsResponsibleFor(Texture2D texture)
         {
             return
                 texture?.Tag is string tag
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 284c1f37..9af14cb5 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -59,28 +59,19 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.ModName = modName;
         }
 
-        /// <summary>Load an asset that has been processed by the content pipeline.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
+        /// <inheritdoc />
         public override T Load<T>(string assetName)
         {
             return this.Load<T>(assetName, this.DefaultLanguage, useCache: false);
         }
 
-        /// <summary>Load an asset that has been processed by the content pipeline.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        /// <param name="language">The language code for which to load content.</param>
+        /// <inheritdoc />
         public override T Load<T>(string assetName, LanguageCode language)
         {
             return this.Load<T>(assetName, language, useCache: false);
         }
 
-        /// <summary>Load an asset that has been processed by the content pipeline.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        /// <param name="language">The language code for which to load content.</param>
-        /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
+        /// <inheritdoc />
         public override T Load<T>(string assetName, LanguageCode language, bool useCache)
         {
             assetName = this.AssertAndNormalizeAssetName(assetName);
@@ -190,7 +181,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return asset;
         }
 
-        /// <summary>Create a new content manager for temporary use.</summary>
+        /// <inheritdoc />
         public override LocalizedContentManager CreateTemporary()
         {
             throw new NotSupportedException("Can't create a temporary mod content manager.");
@@ -210,9 +201,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
-        /// <summary>Get whether an asset has already been loaded.</summary>
-        /// <param name="normalizedAssetName">The normalized asset name.</param>
-        /// <param name="language">The language to check.</param>
+        /// <inheritdoc />
         protected override bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language)
         {
             return this.Cache.ContainsKey(normalizedAssetName);
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 5fb1b10d..8b591bc1 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1201,7 +1201,7 @@ namespace StardewModdingAPI.Metadata
                 GameContentManagerForAssetPropagation content = this.DisposableContentManager;
 
                 Texture2D newTexture = content.Load<Texture2D>(key);
-                if (oldTexture?.IsDisposed == false && !object.ReferenceEquals(oldTexture, newTexture) && content.IsReponsibleFor(oldTexture))
+                if (oldTexture?.IsDisposed == false && !object.ReferenceEquals(oldTexture, newTexture) && content.IsResponsibleFor(oldTexture))
                     oldTexture.Dispose();
 
                 return newTexture;

From 8205b4bd3501360780ddbc51bea2cccfdaac7517 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Feb 2021 13:54:29 -0500
Subject: [PATCH 108/856] use 'mod authors' instead of 'modders' in release
 notes for clarity

---
 docs/release-notes-archived.md | 48 ++++++++++++++++----------------
 docs/release-notes.md          | 50 +++++++++++++++++-----------------
 2 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/docs/release-notes-archived.md b/docs/release-notes-archived.md
index 9f8de3cb..b5dd538b 100644
--- a/docs/release-notes-archived.md
+++ b/docs/release-notes-archived.md
@@ -19,7 +19,7 @@ Released 13 September 2019 for Stardew Valley 1.3.36.
   * Added log parser instructions for Android.
   * Fixed log parser failing in some cases due to time format localization.
 
-* For modders:
+* For mod authors:
   * `this.Monitor.Log` now defaults to the `Trace` log level instead of `Debug`. The change will only take effect when you recompile the mod.
   * Fixed 'location list changed' verbose log not correctly listing changes.
   * Fixed mods able to directly load (and in some cases edit) a different mod's local assets using internal asset key forwarding.
@@ -42,7 +42,7 @@ Released 17 March 2019 for Stardew Valley 1.3.36.
   * Updated mod compatibility list.
   * Fixed `world_clear` console command removing chests edited to have a debris name.
 
-* For modders:
+* For mod authors:
   * Added support for suppressing false-positive warnings in rare cases.
 
 * For the web UI:
@@ -55,7 +55,7 @@ Released 01 March 2019 for Stardew Valley 1.3.36.
 * For players:
   * Updated for Stardew Valley 1.3.36.
 
-* For modders:
+* For mod authors:
   * Bumped all deprecation levels to _pending removal_.
 
 * For the web UI:
@@ -80,7 +80,7 @@ Released 09 January 2019 for Stardew Valley 1.3.32–33.
   * Added beta status filter to compatibility list.
   * Fixed broken ModDrop links in the compatibility list.
 
-* For modders:
+* For mod authors:
   * Asset changes are now propagated into the parsed save being loaded if applicable.
   * Added locale to context trace logs.
   * Fixed error loading custom map tilesheets in some cases.
@@ -106,7 +106,7 @@ Released 29 December 2018 for Stardew Valley 1.3.32–33.
   * Minor performance improvements.
   * Tweaked installer to reduce antivirus false positives.
 
-* For modders:
+* For mod authors:
   * Added [events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events): `GameLoop.OneSecondUpdateTicking`, `GameLoop.OneSecondUpdateTicked`, and `Specialized.LoadStageChanged`.
   * Added `e.IsCurrentLocation` event arg to `World` events.
   * You can now use `helper.Data.Read/WriteSaveData` as soon as the save is loaded (instead of once the world is initialized).
@@ -133,7 +133,7 @@ Released 16 December 2018 for Stardew Valley 1.3.32.
   * Fixed game launch errors logged as `SMAPI` instead of `game`.
   * Fixed Windows installer adding unneeded Unix launcher to game folder.
 
-* For modders:
+* For mod authors:
   * Moved content pack methods into a new [content pack API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Content_Packs).
   * Fixed invalid NPC data propagated when a mod changes NPC dispositions.
   * Fixed `Display.RenderedWorld` event broken in SMAPI 2.9.1.
@@ -162,7 +162,7 @@ Released 07 December 2018 for Stardew Valley 1.3.32.
   * Fixed empty "mods with warnings" list in some cases due to hidden warnings.
   * Fixed Console Commands' handling of tool upgrade levels for item commands.
 
-* For modders:
+* For mod authors:
   * Added ModDrop update keys (see [docs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Manifest#Update_checks)).
   * Added `IsLocalPlayer` to new player events.
   * Added `helper.CreateTemporaryContentPack` to replace the deprecated `CreateTransitionalContentPack`.
@@ -225,7 +225,7 @@ Released 19 November 2018 for Stardew Valley 1.3.32.
   * Tweaked log parser UI (thanks to danvolchek!).
   * Fixed log parser instructions for Mac.
 
-* For modders:
+* For mod authors:
   * Added [data API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Data) to store mod data in the save file or app data.
   * Added [multiplayer API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Multiplayer) and [events](https://stardewvalleywiki.com/Modding:Modder_Guide/Apis/Events#Multiplayer_2) to send/receive messages and get connected player info.
   * Added [verbose logging](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Logging#Verbose_logging) feature.
@@ -275,7 +275,7 @@ Released 14 August 2018 for Stardew Valley 1.3.28.
   * Fixed some SMAPI logs not deleted when starting a new session.
   * Updated compatibility list.
 
-* For modders:
+* For mod authors:
   * Added support for `.json` data files in the content API (including Content Patcher).
   * Added propagation for asset changes through the content API for...
     * child sprites;
@@ -336,7 +336,7 @@ Released 01 August 2018 for Stardew Valley 1.3.27.
   * Fixed log parser mangling crossplatform paths in some cases.
   * Fixed `smapi.io/install` not linking to a useful page.
 
-* For modders:
+* For mod authors:
   * Added [input API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Input) for reading and suppressing keyboard, controller, and mouse input.
   * Added code analysis in the NuGet package to flag common issues as warnings.
   * Replaced `LocationEvents` to support multiplayer:
@@ -418,7 +418,7 @@ Released 26 March 2018 for Stardew Valley 1.2.30–1.2.33.
 * For the [log parser](https://smapi.io/log):
   * Fixed error when log text contains certain tokens.
 
-* For modders:
+* For mod authors:
   * Updated to Json.NET 11.0.2.
 
 * For SMAPI developers:
@@ -448,7 +448,7 @@ Released 13 March 2018 for Stardew Valley ~~1.2.30~~–1.2.33.
 ## 2.5.2
 Released 25 February 2018 for Stardew Valley 1.2.30–1.2.33.
 
-* For modders:
+* For mod authors:
   * Fixed issue where replacing an asset through `asset.AsImage()` or `asset.AsDictionary()` didn't take effect.
 
 * For the [log parser](https://smapi.io/log):
@@ -472,7 +472,7 @@ Released 24 February 2018 for Stardew Valley 1.2.30–1.2.33.
   * Fixed uninstall script not reporting when done on Linux/Mac.
   * Updated compatibility list and enabled update checks for more mods.
 
-* For modders:
+* For mod authors:
   * Added support for content packs and new APIs to read them.
   * Added support for `ISemanticVersion` in JSON models.
   * Added `SpecializedEvents.UnvalidatedUpdateTick` event for specialized use cases.
@@ -506,7 +506,7 @@ Released 24 January 2018 for Stardew Valley 1.2.30–1.2.33.
 * For the [log parser](https://smapi.io/log):
   * Fixed error parsing logs with zero installed mods.
 
-* For modders:
+* For mod authors:
   * Added `SaveEvents.BeforeCreate` and `AfterCreate` events.
   * Added `SButton` `IsActionButton()` and `IsUseToolButton()` extensions.
   * Improved JSON parse errors to provide more useful info for troubleshooting.
@@ -527,7 +527,7 @@ Released 26 December 2017 for Stardew Valley 1.2.30–1.2.33.
   * Improved cryptic libgdiplus errors on Mac when Mono isn't installed.
   * Fixed mod UIs hidden when menu backgrounds are enabled.
 
-* For modders:
+* For mod authors:
   * **Added mod-provided APIs** to allow simple integrations between mods, even without direct assembly references.
   * Added `GameEvents.FirstUpdateTick` event (called once after all mods are initialized).
   * Added `IsSuppressed` to input events so mods can optionally avoid handling keys another mod has already handled.
@@ -557,7 +557,7 @@ Released 02 December 2017 for Stardew Valley 1.2.30–1.2.33.
   * Fixed error when uploading very large logs.
   * Slightly improved the UI.
 
-* For modders:
+* For mod authors:
   * Added `helper.Content.NormalizeAssetName` method.
   * Added `SDate.DaysSinceStart` property.
   * Fixed input events' `e.SuppressButton(button)` method ignoring specified button.
@@ -575,7 +575,7 @@ Released 01 November 2017 for Stardew Valley 1.2.30–1.2.33.
   * Fixed compatibility check for players with Stardew Valley 1.08.
   * Fixed `player_setlevel` command not setting XP too.
 
-* For modders:
+* For mod authors:
   * The reflection API now works with public code to simplify mod integrations.
   * The content API now lets you invalidated multiple assets at once.
   * The `InputEvents` have been improved:
@@ -600,7 +600,7 @@ Released 14 October 2017 for Stardew Valley 1.2.30–1.2.33.
 * **Mod update checks**  
   SMAPI now checks if your mods have updates available, and will alert you in the console with a convenient link to the
   mod page. This works with mods from the Chucklefish mod site, GitHub, or Nexus Mods. SMAPI 2.0 launches with
-  update-check support for over 250 existing mods, and more will be added as modders enable the feature.
+  update-check support for over 250 existing mods, and more will be added as mod authors enable the feature.
 
 * **Mod stability warnings**  
   SMAPI now detects when a mod contains code which can destabilise your game or corrupt your save, and shows a warning
@@ -610,7 +610,7 @@ Released 14 October 2017 for Stardew Valley 1.2.30–1.2.33.
    The console is now simpler and easier to read, some commands have been streamlined, and the colors now adjust to fit
    your terminal background color.
 
-* **New features for modders**  
+* **New features for mod authors**  
   SMAPI 2.0 adds several features to enable new kinds of mods (see
   [API documentation](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs)).
 
@@ -688,7 +688,7 @@ For players:
 * Fixed errors when loading some custom maps on Linux/Mac or using XNB Loader.
 * Fixed errors in rare cases when a mod calculates an in-game date.
 
-For modders:
+For mod authors:
 * Added UTC timestamp to log file.
 
 For SMAPI developers:
@@ -726,7 +726,7 @@ For players:
 * Fixed controller mod input broken in 1.15.
 * Fixed TrainerMod packaging unneeded files.
 
-For modders:
+For mod authors:
 * Fixed mod registry lookups by unique ID not being case-insensitive.
 
 ## 1.15
@@ -744,7 +744,7 @@ For players:
 * Fixed invalid `ObjectInformation.xnb` causing a flood of warnings; SMAPI now shows one error instead.
 * Updated mod compatibility list.
 
-For modders:
+For mod authors:
 * Added `SDate` utility for in-game date calculations (see [API reference](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Utilities#Dates)).
 * Added support for minimum dependency versions in `manifest.json` (see [API reference](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Manifest)).
 * Added more useful logging when loading mods.
@@ -777,7 +777,7 @@ For players:
 * Bumped minimum game version to 1.2.30.
 * Updated mod compatibility list.
 
-For modders:
+For mod authors:
 * You can now add dependencies to `manifest.json` (see [API reference](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Manifest)).
 * You can now translate your mod (see [API reference](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Translation)).
 * You can now load unpacked `.tbin` files from your mod folder through the content API.  
@@ -788,7 +788,7 @@ For modders:
 * Fixed `smapi-crash.txt` being copied from the default log even if a different path is specified with `--log-path`.
 * Fixed the content API not matching XNB filenames with two dots (like `a.b.xnb`) if you don't specify the `.xnb` extension.
 * Fixed `debug` command output not printed to console.
-* Deprecated `TimeEvents.DayOfMonthChanged`, `SeasonOfYearChanged`, and `YearOfGameChanged`. These don't do what most modders think they do and aren't very reliable, since they depend on the SMAPI/game lifecycle which can change. You should use `TimeEvents.AfterDayStarted` or `SaveEvents.BeforeSave` instead.
+* Deprecated `TimeEvents.DayOfMonthChanged`, `SeasonOfYearChanged`, and `YearOfGameChanged`. These don't do what most mod authors think they do and aren't very reliable, since they depend on the SMAPI/game lifecycle which can change. You should use `TimeEvents.AfterDayStarted` or `SaveEvents.BeforeSave` instead.
 
 ## 1.13.1
 Released 19 May 2017 for Stardew Valley 1.2.26–1.2.29.
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 041071e0..1ac7cf0a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,7 +3,7 @@
 # Release notes
 <!--
 ## Future release
-* For modders:
+* For mod authors:
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
@@ -12,7 +12,7 @@
   * Added more aggressive memory optimization which should eliminate many cases of `OutOfMemoryException` crashes.
   * Fixed error running `install on Windows.bat` in very rare cases.
 
-* For modders:
+* For mod authors:
   * Fixed asset propagation for `TileSheets/ChairTiles` not changing existing map seats.
   * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.
   * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
@@ -46,7 +46,7 @@ Released 22 January 2021 for Stardew Valley 1.5.4 or later. See [release highlig
   * Fixed compatibility for very old content packs which still load maps from `.xnb` files. These were broken by map loading changes in Stardew Valley 1.5, but SMAPI now corrects them automatically.
   * Fixed some broken mods incorrectly listed as XNB mods under 'skipped mods'.
 
-* For modders:
+* For mod authors:
   * Added new input APIs:
     * Added an [API for multi-key bindings](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Input#KeybindList).
     * Added a new [`Input.ButtonsChanged` event](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Input.ButtonsChanged).
@@ -80,7 +80,7 @@ Released 15 January 2021 for Stardew Valley 1.5.3 or later.
   * Updated for Stardew Valley 1.5.3.
   * Fixed issue where title screen music didn't stop after loading a save.
 
-* For modders:
+* For mod authors:
   * Fixed `SemanticVersion` comparisons returning wrong value in rare cases.
 
 ## 3.8.3
@@ -92,7 +92,7 @@ Released 08 January 2021 for Stardew Valley 1.5.2 or later.
   * You can now enter console commands for a specific screen in split-screen mode by adding `screen=ID` to the command.
   * Typing `help` in the SMAPI console is now more helpful.
 
-* For modders:
+* For mod authors:
   * Simplified tilesheet order warning added in SMAPI 3.8.2.
 
 * For the Console Commands mod:
@@ -109,7 +109,7 @@ Released 03 January 2021 for Stardew Valley 1.5.1 or later.
   * Fixed 'skipped mods' section repeating mods in some cases.
   * Fixed out-of-date error text.
 
-* For modders:
+* For mod authors:
   * Added warning when a map replacement changes the order/IDs of the original tilesheets, which may cause errors and crashes. Doing so for a farm map is blocked outright since that causes a consistent crash in Stardew Valley 1.5.
   * Message data from the `ModMessageReceived` event now uses the same serializer settings as the rest of SMAPI. That mainly adds support for sending crossplatform `Color`, `Point`, `Vector2`, `Rectangle`, and `SemanticVersion` fields through network messages.
   * When a mod is blocked by SMAPI's compatibility override list, the `TRACE` messages while loading it now say so and indicate why.
@@ -121,7 +121,7 @@ Released 26 December 2020 for Stardew Valley 1.5.1 or later.
 * For players:
   * Fixed broken community center bundles for non-English saves created in Stardew Valley 1.5. Affected saves will be fixed automatically on load.
 
-* For modders:
+* For mod authors:
   * World events are now raised for volcano dungeon levels.
   * Added `apply_save_fix` command to reapply a save migration in exceptional cases. This should be used very carefully. Type `help apply_save_fix` for details.
   * **Deprecation notice:** the `Helper.ConsoleCommands.Trigger` method is now deprecated and should no longer be used. See [integration APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations) for better mod integration options. It will eventually be removed in SMAPI 4.0.
@@ -137,7 +137,7 @@ Released 21 December 2020 for Stardew Valley 1.5 or later. See [release highligh
   * You can now run the installer from a subfolder of your game folder to auto-detect it. That simplifies installation if you have multiple copies of the game or it can't otherwise auto-detect the game path.
   * Clarified error when the SMAPI installer is in the `Mods` folder.
 
-* For modders:
+* For mod authors:
   * Added `PerScreen<T>` utility and new `Context` fields to simplify split-screen support in mods.
   * Added screen ID to log when playing in split-screen mode.
 
@@ -154,7 +154,7 @@ Released 21 November 2020 for Stardew Valley 1.4.1 or later.
   * Fixed error when heuristically rewriting an outdated mod in rare cases.
   * Fixed rare 'collection was modified' error when using `harmony summary` console command.
 
-* For modders:
+* For mod authors:
   * Updated TMXTile to 1.5.8 to fix exported `.tmx` files losing tile index properties.
 
 * For the Console Commands mod:
@@ -164,7 +164,7 @@ Released 21 November 2020 for Stardew Valley 1.4.1 or later.
 ## 3.7.5
 Released 16 October 2020 for Stardew Valley 1.4.1 or later.
 
-* For modders:
+* For mod authors:
   * Fixed changes to the town map asset not reapplying the game's community center, JojaMart, and Pam house changes.
 
 ## 3.7.4
@@ -174,7 +174,7 @@ Released 03 October 2020 for Stardew Valley 1.4.1 or later.
   * Improved performance on some older computers (thanks to millerscout!).
   * Fixed update alerts for Chucklefish forum mods broken by a recent site change.
 
-* For modders:
+* For mod authors:
   * Updated dependencies (including Mono.Cecil 0.11.2 → 0.11.3 and Platonymous.TMXTile 1.3.8 → 1.5.6).
   * Fixed asset propagation for `Data\MoviesReactions`.
   * Fixed error in content pack path handling when you pass a null path.
@@ -193,7 +193,7 @@ Released 16 September 2020 for Stardew Valley 1.4.1 or later.
   * Fixed map rendering crash due to conflict between SMAPI and PyTK.
   * Fixed error in heuristically-rewritten mods in rare cases (thanks to collaboration with ZaneYork!).
 
-* For modders:
+* For mod authors:
   * File paths accessed through `IContentPack` are now case-insensitive (even on Linux).
 
 * For the web UI:
@@ -205,7 +205,7 @@ Released 08 September 2020 for Stardew Valley 1.4.1 or later.
 * For players:
   * Fixed mod recipe changes not always applied in 3.7.
 
-* For modders:
+* For mod authors:
   * Renamed `PathUtilities.NormalizePathSeparators` to `NormalizePath`, and added normalization for more cases.
 
 ## 3.7.1
@@ -230,7 +230,7 @@ Released 07 September 2020 for Stardew Valley 1.4.1 or later. See [release highl
   * Removed the experimental `RewriteInParallel` option added in SMAPI 3.6 (it was already disabled by default). Unfortunately this caused intermittent and unpredictable errors when enabled.
   * Internal changes to prepare for upcoming game updates.
 
-* For modders:
+* For mod authors:
   * Added `PathUtilities` to simplify working with file/asset names.
   * You can now read/write `SDate` values to JSON (e.g. for `config.json`, network mod messages, etc).
   * Fixed asset propagation not updating title menu buttons immediately on Linux/Mac.
@@ -260,7 +260,7 @@ Released 02 August 2020 for Stardew Valley 1.4.1 or later.
   * Fixed spawned Floor TV not functional as a TV (thanks to Platonymous!).
   * Fixed spawned sturgeon roe having incorrect color.
 
-* For modders:
+* For mod authors:
   * Updated internal dependencies.
   * SMAPI now ignores more file types when scanning for mod folders (`.doc`, `.docx`, `.rar`, and `.zip`).
   * Added current GPU to trace logs to simplify troubleshooting.
@@ -293,7 +293,7 @@ Released 20 June 2020 for Stardew Valley 1.4.1 or later. See [release highlights
   * Updated ModDrop URLs.
   * Internal changes to improve performance and reliability.
 
-* For modders:
+* For mod authors:
   * Added [event priorities](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Custom_priority) (thanks to spacechase0!).
   * Added [update subkeys](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Update_checks#Update_subkeys).
   * Added [a custom build of Harmony](https://github.com/Pathoschild/Harmony#readme) to provide more useful stack traces in error logs.
@@ -328,7 +328,7 @@ Released 27 April 2020 for Stardew Valley 1.4.1 or later. See [release highlight
   * Updated the JSON validator/schema for Content Patcher 1.13.
   * Fixed rare intermittent "CGI application encountered an error" errors.
 
-* For modders:
+* For mod authors:
   * Added map patching to the content API (via `asset.AsMap()`).
   * Added support for using patch helpers with arbitrary data (via `helper.Content.GetPatchHelper`).
   * Added `SDate` fields/methods: `SeasonIndex`, `FromDaysSinceStart`, `FromWorldDate`, `ToWorldDate`, and `ToLocaleString` (thanks to kdau!).
@@ -342,7 +342,7 @@ Released 27 April 2020 for Stardew Valley 1.4.1 or later. See [release highlight
 ## 3.4.1
 Released 24 March 2020 for Stardew Valley 1.4.1 or later.
 
-* For modders:
+* For mod authors:
   * Asset changes now propagate to NPCs in an event (e.g. wedding sprites).
   * Fixed mouse input suppression not working in SMAPI 3.4.
 
@@ -355,7 +355,7 @@ Released 22 March 2020 for Stardew Valley 1.4.1 or later. See [release highlight
   * Removed invalid-location check now handled by the game.
   * Updated translations. Thanks to Annosz (added Hungarian)!
 
-* For modders:
+* For mod authors:
   * Added support for flipped and rotated map tiles (thanks to collaboration with Platonymous!).
   * Added support for `.tmx` maps using zlib compression (thanks to Platonymous!).
   * Added `this.Monitor.LogOnce` method.
@@ -399,7 +399,7 @@ Released 22 February 2020 for Stardew Valley 1.4.1 or later. See [release highli
   * Updated the JSON validator and Content Patcher schema for `.tmx` support.
   * The mod compatibility page now has a sticky table header.
 
-* For modders:
+* For mod authors:
   * Added support for [message sending](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Message_sending) to mods on the current computer (in addition to remote computers).
   * Added `ExtendImage` method to content API when editing files to resize textures.
   * Added `helper.Input.GetState` to get the low-level state of a button.
@@ -434,7 +434,7 @@ Released 01 February 2020 for Stardew Valley 1.4.1 or later. See [release highli
   * Fixed extra files under `Saves` (e.g. manual backups) not being ignored.
   * Fixed Android issue where game files were backed up.
 
-* For modders:
+* For mod authors:
   * Added support for `.tmx` map files. (Thanks to [Platonymous for the underlying library](https://github.com/Platonymous/TMXTile)!)
   * Added special handling for `Vector2` values in `.json` files, so they work consistently crossplatform.
   * Reworked the order that asset editors/loaders are called between multiple mods to support some framework mods like Content Patcher and Json Assets. Note that the order is undefined and should not be depended on.
@@ -483,7 +483,7 @@ Released 05 January 2019 for Stardew Valley 1.4.1 or later. See [release highlig
   * Fixed log parser not correctly handling content packs with no author (thanks to danvolchek!).
   * Fixed main sidebar link pointing to wiki instead of home page.
 
-* For modders:
+* For mod authors:
   * Added `World.ChestInventoryChanged` event (thanks to collaboration with wartech0!).
   * Added asset propagation for...
     * grass textures;
@@ -512,7 +512,7 @@ Released 02 December 2019 for Stardew Valley 1.4 or later.
   * If a log can't be uploaded to Pastebin (e.g. due to rate limits), it's now uploaded to Amazon S3 instead. Logs uploaded to S3 expire after one month.
   * Fixed JSON validator not letting you drag & drop a file.
 
-* For modders:
+* For mod authors:
   * `SemanticVersion` now supports [semver 2.0](https://semver.org/) build metadata.
 
 ## 3.0
@@ -542,7 +542,7 @@ For players:
 
 * **Fixed many bugs and edge cases.**
 
-For modders:
+For mod authors:
 * **New event system.**  
   SMAPI 3.0 removes the deprecated static events in favor of the new `helper.Events` API. The event
   engine is rewritten to make events more efficient, add events that weren't possible before, make
@@ -626,7 +626,7 @@ For modders:
   * Added instructions for Android.
   * The page now detects your OS and preselects the right instructions (thanks to danvolchek!).
 
-### For modders
+### For mod authors
 * Breaking changes:
   * Mods are now loaded much earlier in the game launch. This lets mods intercept any content asset, but the game is not fully initialized when `Entry` is called; use the `GameLaunched` event if you need to run code when the game is initialized.
   * Removed all deprecated APIs.

From 033b3856413f51e26e74498ea9fe3de291d4e93a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Feb 2021 17:33:37 -0500
Subject: [PATCH 109/856] add detailed error message when Stardew Valley.exe
 can't be loaded

---
 docs/release-notes.md |  7 +++++--
 src/SMAPI/Program.cs  | 31 ++++++++++++++++++++++++++++---
 2 files changed, 33 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1ac7cf0a..1843b0e6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,13 +9,13 @@
 
 ## Upcoming release
 * For players:
-  * Added more aggressive memory optimization which should eliminate many cases of `OutOfMemoryException` crashes.
+  * Added more aggressive memory optimization which should reduce `OutOfMemoryException` errors with some mods.
+  * Added more detailed error when `Stardew Valley.exe` exists but can't be loaded.
   * Fixed error running `install on Windows.bat` in very rare cases.
 
 * For mod authors:
   * Fixed asset propagation for `TileSheets/ChairTiles` not changing existing map seats.
   * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.
-  * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
 
 * For the ErrorHandler mod:
   * Added early detection of disposed textures so the crash stack trace shows the actual code which used them.
@@ -26,6 +26,9 @@
   * Updated the JSON validator/schema for Content Patcher 1.20.
   * Fixed mod compatibility list error if a mod has no name.
 
+* For SMAPI developers:
+  * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
+
 ## 3.9.1
 Released 25 January 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 23ee8453..986d2780 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -73,8 +73,22 @@ namespace StardewModdingAPI
         /// <remarks>This must be checked *before* any references to <see cref="Constants"/>, and this method should not reference <see cref="Constants"/> itself to avoid errors in Mono or when the game isn't present.</remarks>
         private static void AssertGamePresent()
         {
-            if (Type.GetType($"StardewValley.Game1, {EarlyConstants.GameAssemblyName}", throwOnError: false) == null)
-                Program.PrintErrorAndExit("Oops! SMAPI can't find the game. Make sure you're running StardewModdingAPI.exe in your game folder. See the readme.txt file for details.");
+            try
+            {
+                _ = Type.GetType($"StardewValley.Game1, {EarlyConstants.GameAssemblyName}", throwOnError: true);
+            }
+            catch (Exception ex)
+            {
+                // file doesn't exist
+                if (!File.Exists(Path.Combine(EarlyConstants.ExecutionPath, $"{EarlyConstants.GameAssemblyName}.exe")))
+                    Program.PrintErrorAndExit("Oops! SMAPI can't find the game. Make sure you're running StardewModdingAPI.exe in your game folder.");
+
+                // can't load file
+                Program.PrintErrorAndExit(
+                    message: "Oops! SMAPI couldn't load the game executable. The technical details below may have more info.",
+                    technicalMessage: $"Technical details: {ex}"
+                );
+            }
         }
 
         /// <summary>Assert that the game version is within <see cref="Constants.MinimumGameVersion"/> and <see cref="Constants.MaximumGameVersion"/>.</summary>
@@ -130,11 +144,22 @@ namespace StardewModdingAPI
 
         /// <summary>Write an error directly to the console and exit.</summary>
         /// <param name="message">The error message to display.</param>
-        private static void PrintErrorAndExit(string message)
+        /// <param name="technicalMessage">An additional message to log with technical details.</param>
+        private static void PrintErrorAndExit(string message, string technicalMessage = null)
         {
             Console.ForegroundColor = ConsoleColor.Red;
             Console.WriteLine(message);
             Console.ResetColor();
+
+            if (technicalMessage != null)
+            {
+                Console.WriteLine();
+                Console.ForegroundColor = ConsoleColor.Gray;
+                Console.WriteLine(technicalMessage);
+                Console.ResetColor();
+                Console.WriteLine();
+            }
+            
             Program.PressAnyKeyToExit(showMessage: true);
         }
 

From 27accf55a5e008819015a599a484c8e670cc546f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Feb 2021 18:29:14 -0500
Subject: [PATCH 110/856] update ambient light when setting game time

---
 docs/release-notes.md                         |  7 +++----
 .../Commands/World/SetTimeCommand.cs          | 20 ++++++++++++-------
 2 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1843b0e6..09c941d6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,15 +12,14 @@
   * Added more aggressive memory optimization which should reduce `OutOfMemoryException` errors with some mods.
   * Added more detailed error when `Stardew Valley.exe` exists but can't be loaded.
   * Fixed error running `install on Windows.bat` in very rare cases.
+  * Fixed outdoor ambient lighting not updated when you reverse time using the `world_settime` command _(in Console Commands)_.
 
 * For mod authors:
+  * Added early detection of disposed textures so the crash stack trace shows the actual code which used them _(in Error Handler)_.
+  * Added error details when an event command fails _(in Error Handler)_.
   * Fixed asset propagation for `TileSheets/ChairTiles` not changing existing map seats.
   * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.
 
-* For the ErrorHandler mod:
-  * Added early detection of disposed textures so the crash stack trace shows the actual code which used them.
-  * Added error details when an event command fails.
-
 * For the web UI:
   * Updated for the new wiki.
   * Updated the JSON validator/schema for Content Patcher 1.20.
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
index 6782e38a..2d4b4565 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
@@ -1,5 +1,5 @@
-using System;
 using System.Linq;
+using Microsoft.Xna.Framework;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
@@ -45,12 +45,8 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         /// <param name="time">The time of day.</param>
         private void SafelySetTime(int time)
         {
-            // define conversion between game time and TimeSpan
-            TimeSpan ToTimeSpan(int value) => new TimeSpan(0, value / 100, value % 100, 0);
-            int FromTimeSpan(TimeSpan span) => (span.Hours * 100) + span.Minutes;
-
             // transition to new time
-            int intervals = (int)((ToTimeSpan(time) - ToTimeSpan(Game1.timeOfDay)).TotalMinutes / 10);
+            int intervals = Utility.CalculateMinutesBetweenTimes(Game1.timeOfDay, time) / 10;
             if (intervals > 0)
             {
                 for (int i = 0; i < intervals; i++)
@@ -60,10 +56,20 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
             {
                 for (int i = 0; i > intervals; i--)
                 {
-                    Game1.timeOfDay = FromTimeSpan(ToTimeSpan(Game1.timeOfDay).Subtract(TimeSpan.FromMinutes(20))); // offset 20 minutes so game updates to next interval
+                    Game1.timeOfDay = Utility.ModifyTime(Game1.timeOfDay, -20); // offset 20 mins so game updates to next interval
                     Game1.performTenMinuteClockUpdate();
                 }
             }
+
+            // reset ambient light
+            // White is the default non-raining color. If it's raining or dark out, UpdateGameClock
+            // below will update it automatically.
+            Game1.outdoorLight = Color.White;
+            Game1.ambientLight = Color.White;
+
+            // run clock update (to correct lighting, etc)
+            Game1.gameTimeInterval = 0;
+            Game1.UpdateGameClock(Game1.currentGameTime);
         }
     }
 }

From 9c4c10d2d22cbf67ccadbd35fdf1ffced0541cc2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Feb 2021 21:58:37 -0500
Subject: [PATCH 111/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 14 ++++++++------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index a38f15a6..29acbb56 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.9.1</Version>
+    <Version>3.9.2</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 09c941d6..fb67d8dc 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,21 +7,23 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.9.2
+Released 21 February 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
-  * Added more aggressive memory optimization which should reduce `OutOfMemoryException` errors with some mods.
-  * Added more detailed error when `Stardew Valley.exe` exists but can't be loaded.
+  * Added more aggressive memory optimization to reduce `OutOfMemoryException` errors with some mods.
+  * Improved error when `Stardew Valley.exe` exists but can't be loaded.
   * Fixed error running `install on Windows.bat` in very rare cases.
-  * Fixed outdoor ambient lighting not updated when you reverse time using the `world_settime` command _(in Console Commands)_.
+  * Fixed `world_settime` command not always updating outdoor ambient lighting _(in Console Commands)_.
 
 * For mod authors:
-  * Added early detection of disposed textures so the crash stack trace shows the actual code which used them _(in Error Handler)_.
+  * Added early detection of disposed textures so the error details are more relevant _(in Error Handler)_.
   * Added error details when an event command fails _(in Error Handler)_.
   * Fixed asset propagation for `TileSheets/ChairTiles` not changing existing map seats.
   * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.
 
 * For the web UI:
-  * Updated for the new wiki.
+  * Updated compatibility list for the new wiki.
   * Updated the JSON validator/schema for Content Patcher 1.20.
   * Fixed mod compatibility list error if a mod has no name.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 10611e08..aa3d6ceb 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.9.1",
+    "Version": "3.9.2",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.9.1"
+    "MinimumApiVersion": "3.9.2"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index bb9942d1..b6df0f49 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.9.1",
+    "Version": "3.9.2",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.9.1"
+    "MinimumApiVersion": "3.9.2"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 95ee5144..4d2003e2 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.9.1",
+    "Version": "3.9.2",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.9.1"
+    "MinimumApiVersion": "3.9.2"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 57c40bbf..54fb54ab 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.1");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.2");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");

From 944c03737e7f7d7788f4321224a4e59a4f04717d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 28 Feb 2021 12:01:11 -0500
Subject: [PATCH 112/856] add load stages immediately after game adds initial
 locations

---
 docs/release-notes.md                 |  4 ++
 src/SMAPI/Enums/LoadStage.cs          |  6 +++
 src/SMAPI/Patches/LoadContextPatch.cs | 53 ++++++++++++++++++++++++---
 3 files changed, 58 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index fb67d8dc..e7401910 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For mod authors:
+  * Added two stages to the `LoadStageChanged` event: `CreatedInitialLocations` and `SaveAddedLocations`, raised immediately after the game adds its vanilla locations but before they're initialized.
+
 ## 3.9.2
 Released 21 February 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Enums/LoadStage.cs b/src/SMAPI/Enums/LoadStage.cs
index 5c2b0412..aa95d201 100644
--- a/src/SMAPI/Enums/LoadStage.cs
+++ b/src/SMAPI/Enums/LoadStage.cs
@@ -9,6 +9,9 @@ namespace StardewModdingAPI.Enums
         /// <summary>The game is creating a new save slot, and has initialized the basic save info.</summary>
         CreatedBasicInfo,
 
+        /// <summary>The game is creating a new save slot, and has added the location instances but hasn't fully initialized them yet.</summary>
+        CreatedInitialLocations,
+
         /// <summary>The game is creating a new save slot, and has initialized the in-game locations.</summary>
         CreatedLocations,
 
@@ -21,6 +24,9 @@ namespace StardewModdingAPI.Enums
         /// <summary>The game is loading a save slot, and has applied the basic save info (including player data). Not applicable when connecting to a multiplayer host. Note that some basic info (like daily luck) is not initialized at this point. This is equivalent to <see cref="StardewValley.SaveGame.getLoadEnumerator"/> value 36.</summary>
         SaveLoadedBasicInfo,
 
+        /// <summary>The game is loading a save slot and has added the location instances, but hasn't applied the data yet. Not applicable when connecting to a multiplayer host.</summary>
+        SaveAddedLocations,
+
         /// <summary>The game is loading a save slot, and has applied the in-game location data. Not applicable when connecting to a multiplayer host. This is equivalent to <see cref="StardewValley.SaveGame.getLoadEnumerator"/> value 50.</summary>
         SaveLoadedLocations,
 
diff --git a/src/SMAPI/Patches/LoadContextPatch.cs b/src/SMAPI/Patches/LoadContextPatch.cs
index ceda061b..9fddcc50 100644
--- a/src/SMAPI/Patches/LoadContextPatch.cs
+++ b/src/SMAPI/Patches/LoadContextPatch.cs
@@ -29,6 +29,9 @@ namespace StardewModdingAPI.Patches
         /// <summary>A callback to invoke when the load stage changes.</summary>
         private static Action<LoadStage> OnStageChanged;
 
+        /// <summary>Whether the game is running running the code in <see cref="Game1.loadForNewGame"/>.</summary>
+        private static bool IsInLoadForNewGame;
+
 
         /*********
         ** Accessors
@@ -62,9 +65,16 @@ namespace StardewModdingAPI.Patches
                 prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_TitleMenu_CreatedNewCharacter))
             );
 
-            // detect CreatedLocations
+            // detect CreatedInitialLocations and SaveAddedLocations
+            harmony.Patch(
+                original: AccessTools.Method(typeof(Game1), nameof(Game1.AddModNPCs)),
+                prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_Game1_AddModNPCs))
+            );
+
+            // detect CreatedLocations, and track IsInLoadForNewGame
             harmony.Patch(
                 original: AccessTools.Method(typeof(Game1), nameof(Game1.loadForNewGame)),
+                prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_Game1_LoadForNewGame)),
                 postfix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.After_Game1_LoadForNewGame))
             );
         }
@@ -82,16 +92,49 @@ namespace StardewModdingAPI.Patches
             return true;
         }
 
+        /// <summary>Called before <see cref="Game1.AddModNPCs"/>.</summary>
+        /// <returns>Returns whether to execute the original method.</returns>
+        /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
+        private static bool Before_Game1_AddModNPCs()
+        {
+            // When this method is called from Game1.loadForNewGame, it happens right after adding the vanilla
+            // locations but before initializing them.
+            if (LoadContextPatch.IsInLoadForNewGame)
+            {
+                LoadContextPatch.OnStageChanged(LoadContextPatch.IsCreating()
+                    ? LoadStage.CreatedInitialLocations
+                    : LoadStage.SaveAddedLocations
+                );
+            }
+
+            return true;
+        }
+
+        /// <summary>Called before <see cref="Game1.loadForNewGame"/>.</summary>
+        /// <returns>Returns whether to execute the original method.</returns>
+        /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
+        private static bool Before_Game1_LoadForNewGame()
+        {
+            LoadContextPatch.IsInLoadForNewGame = true;
+            return true;
+        }
+
         /// <summary>Called after <see cref="Game1.loadForNewGame"/>.</summary>
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
         private static void After_Game1_LoadForNewGame()
         {
-            bool creating =
+            LoadContextPatch.IsInLoadForNewGame = false;
+
+            if (LoadContextPatch.IsCreating())
+                LoadContextPatch.OnStageChanged(LoadStage.CreatedLocations);
+        }
+
+        /// <summary>Get whether the save file is currently being created.</summary>
+        private static bool IsCreating()
+        {
+            return
                 (Game1.currentMinigame is Intro) // creating save with intro
                 || (Game1.activeClickableMenu is TitleMenu menu && LoadContextPatch.Reflection.GetField<bool>(menu, "transitioningCharacterCreationMenu").GetValue()); // creating save, skipped intro
-
-            if (creating)
-                LoadContextPatch.OnStageChanged(LoadStage.CreatedLocations);
         }
     }
 }

From 403616b07c6da6479ce77fd45b41f622e9972915 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 28 Feb 2021 12:39:37 -0500
Subject: [PATCH 113/856] fix mods with suppressed warnings counted for showing
 the log section

---
 docs/release-notes.md                         |  3 +++
 src/SMAPI/Framework/IModMetadata.cs           |  6 +++---
 src/SMAPI/Framework/Logging/LogManager.cs     | 10 +++++-----
 src/SMAPI/Framework/ModLoading/ModMetadata.cs | 19 ++++++++++++-------
 4 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e7401910..d3b0698f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Fixed console showing _found 1 mod with warnings_ with no mods listed.
+
 * For mod authors:
   * Added two stages to the `LoadStageChanged` event: `CreatedInitialLocations` and `SaveAddedLocations`, raised immediately after the game adds its vanilla locations but before they're initialized.
 
diff --git a/src/SMAPI/Framework/IModMetadata.cs b/src/SMAPI/Framework/IModMetadata.cs
index 70cf0036..5d2f352d 100644
--- a/src/SMAPI/Framework/IModMetadata.cs
+++ b/src/SMAPI/Framework/IModMetadata.cs
@@ -34,7 +34,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>The reason the mod failed to load, if applicable.</summary>
         ModFailReason? FailReason { get; }
 
-        /// <summary>Indicates non-error issues with the mod.</summary>
+        /// <summary>The non-error issues with the mod, ignoring those suppressed via <see cref="DataRecord"/>.</summary>
         ModWarning Warnings { get; }
 
         /// <summary>The reason the metadata is invalid, if any.</summary>
@@ -124,9 +124,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>Whether the mod has at least one valid update key set.</summary>
         bool HasValidUpdateKeys();
 
-        /// <summary>Get whether the mod has any of the given warnings which haven't been suppressed in the <see cref="DataRecord"/>.</summary>
+        /// <summary>Get whether the mod has any of the given warnings, ignoring those suppressed via <see cref="DataRecord"/>.</summary>
         /// <param name="warnings">The warnings to check.</param>
-        bool HasUnsuppressedWarnings(params ModWarning[] warnings);
+        bool HasWarnings(params ModWarning[] warnings);
 
         /// <summary>Get a relative path which includes the root folder name.</summary>
         string GetRelativePathWithRoot();
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 2c7be399..f3656886 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -505,7 +505,7 @@ namespace StardewModdingAPI.Framework.Logging
                 {
                     this.LogModWarningGroup(
                         modsWithWarnings,
-                        match: mod => mod.HasUnsuppressedWarnings(ModWarning.AccessesConsole, ModWarning.AccessesFilesystem, ModWarning.AccessesShell),
+                        match: mod => mod.HasWarnings(ModWarning.AccessesConsole, ModWarning.AccessesFilesystem, ModWarning.AccessesShell),
                         level: LogLevel.Debug,
                         heading: "Direct system access",
                         blurb: new[]
@@ -517,11 +517,11 @@ namespace StardewModdingAPI.Framework.Logging
                         modLabel: mod =>
                         {
                             List<string> labels = new List<string>();
-                            if (mod.HasUnsuppressedWarnings(ModWarning.AccessesConsole))
+                            if (mod.HasWarnings(ModWarning.AccessesConsole))
                                 labels.Add("console");
-                            if (mod.HasUnsuppressedWarnings(ModWarning.AccessesFilesystem))
+                            if (mod.HasWarnings(ModWarning.AccessesFilesystem))
                                 labels.Add("files");
-                            if (mod.HasUnsuppressedWarnings(ModWarning.AccessesShell))
+                            if (mod.HasWarnings(ModWarning.AccessesShell))
                                 labels.Add("shells/processes");
 
                             return $"{mod.DisplayName} ({string.Join(", ", labels)})";
@@ -582,7 +582,7 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="blurb">A detailed explanation of the warning, split into lines.</param>
         private void LogModWarningGroup(IModMetadata[] mods, ModWarning warning, LogLevel level, string heading, params string[] blurb)
         {
-            this.LogModWarningGroup(mods, mod => mod.HasUnsuppressedWarnings(warning), level, heading, blurb);
+            this.LogModWarningGroup(mods, mod => mod.HasWarnings(warning), level, heading, blurb);
         }
 
 
diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index 18d2b112..b4de3d6c 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -13,6 +13,13 @@ namespace StardewModdingAPI.Framework.ModLoading
     /// <summary>Metadata for a mod.</summary>
     internal class ModMetadata : IModMetadata
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The non-error issues with the mod, including warnings suppressed by the data record.</summary>
+        private ModWarning ActualWarnings = ModWarning.None;
+
+
         /*********
         ** Accessors
         *********/
@@ -41,7 +48,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         public ModFailReason? FailReason { get; private set; }
 
         /// <inheritdoc />
-        public ModWarning Warnings { get; private set; }
+        public ModWarning Warnings => this.ActualWarnings & ~(this.DataRecord?.DataRecord.SuppressWarnings ?? ModWarning.None);
 
         /// <inheritdoc />
         public string Error { get; private set; }
@@ -116,7 +123,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <inheritdoc />
         public IModMetadata SetWarning(ModWarning warning)
         {
-            this.Warnings |= warning;
+            this.ActualWarnings |= warning;
             return this;
         }
 
@@ -218,12 +225,10 @@ namespace StardewModdingAPI.Framework.ModLoading
         }
 
         /// <inheritdoc />
-        public bool HasUnsuppressedWarnings(params ModWarning[] warnings)
+        public bool HasWarnings(params ModWarning[] warnings)
         {
-            return warnings.Any(warning =>
-                this.Warnings.HasFlag(warning)
-                && (this.DataRecord?.DataRecord == null || !this.DataRecord.DataRecord.SuppressWarnings.HasFlag(warning))
-            );
+            ModWarning curWarnings = this.Warnings;
+            return warnings.Any(warning => curWarnings.HasFlag(warning));
         }
 
         /// <inheritdoc />

From b2d47e29ffe58142efd0a5084f33fefffd87a460 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 28 Feb 2021 14:17:41 -0500
Subject: [PATCH 114/856] add ReturningToTitle stage

---
 docs/release-notes.md                 |  2 +-
 src/SMAPI/Enums/LoadStage.cs          |  5 ++++-
 src/SMAPI/Patches/LoadContextPatch.cs | 15 +++++++++++++++
 3 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d3b0698f..833e2130 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,7 +12,7 @@
   * Fixed console showing _found 1 mod with warnings_ with no mods listed.
 
 * For mod authors:
-  * Added two stages to the `LoadStageChanged` event: `CreatedInitialLocations` and `SaveAddedLocations`, raised immediately after the game adds its vanilla locations but before they're initialized.
+  * Added three stages to the `LoadStageChanged` event: `CreatedInitialLocations`/`SaveAddedLocations` (raised immediately after the game adds locations but before they're initialized), and `ReturningToTitle` (raised before exiting to the title screen).
 
 ## 3.9.2
 Released 21 February 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Enums/LoadStage.cs b/src/SMAPI/Enums/LoadStage.cs
index aa95d201..250c88e9 100644
--- a/src/SMAPI/Enums/LoadStage.cs
+++ b/src/SMAPI/Enums/LoadStage.cs
@@ -37,6 +37,9 @@ namespace StardewModdingAPI.Enums
         Loaded,
 
         /// <summary>The save is fully loaded, the world has been initialized, and <see cref="Context.IsWorldReady"/> is now true.</summary>
-        Ready
+        Ready,
+
+        /// <summary>The game is exiting the loaded save and returning to the title screen. This happens before it returns to title; see <see cref="None"/> after it returns.</summary>
+        ReturningToTitle
     }
 }
diff --git a/src/SMAPI/Patches/LoadContextPatch.cs b/src/SMAPI/Patches/LoadContextPatch.cs
index 9fddcc50..28bc23b6 100644
--- a/src/SMAPI/Patches/LoadContextPatch.cs
+++ b/src/SMAPI/Patches/LoadContextPatch.cs
@@ -77,6 +77,12 @@ namespace StardewModdingAPI.Patches
                 prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_Game1_LoadForNewGame)),
                 postfix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.After_Game1_LoadForNewGame))
             );
+
+            // detect ReturningToTitle
+            harmony.Patch(
+                original: AccessTools.Method(typeof(Game1), nameof(Game1.CleanupReturningToTitle)),
+                prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_Game1_CleanupReturningToTitle))
+            );
         }
 
 
@@ -110,6 +116,15 @@ namespace StardewModdingAPI.Patches
             return true;
         }
 
+        /// <summary>Called before <see cref="Game1.CleanupReturningToTitle"/>.</summary>
+        /// <returns>Returns whether to execute the original method.</returns>
+        /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
+        private static bool Before_Game1_CleanupReturningToTitle()
+        {
+            LoadContextPatch.OnStageChanged(LoadStage.ReturningToTitle);
+            return true;
+        }
+
         /// <summary>Called before <see cref="Game1.loadForNewGame"/>.</summary>
         /// <returns>Returns whether to execute the original method.</returns>
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>

From 5ce096c89a15e74102c2741672a4a75afed47ddb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 28 Feb 2021 14:22:30 -0500
Subject: [PATCH 115/856] fix edge case for non-English farmhands where content
 coordinator handled return to title too late

---
 docs/release-notes.md        |  1 +
 src/SMAPI/Framework/SCore.cs | 30 ++++++++++++++++++------------
 2 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 833e2130..6f69479e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
 
 * For mod authors:
   * Added three stages to the `LoadStageChanged` event: `CreatedInitialLocations`/`SaveAddedLocations` (raised immediately after the game adds locations but before they're initialized), and `ReturningToTitle` (raised before exiting to the title screen).
+  * Fixed edge case when playing as a farmhand in non-English where translatable assets loaded via `IAssetLoader` weren't reapplied immediately when the server disconnects.
 
 ## 3.9.2
 Released 21 February 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 2d783eb2..5df4b61b 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1054,17 +1054,24 @@ namespace StardewModdingAPI.Framework
             LoadStage oldStage = Context.LoadStage;
             Context.LoadStage = newStage;
             this.Monitor.VerboseLog($"Context: load stage changed to {newStage}");
-            if (newStage == LoadStage.None)
-            {
-                this.Monitor.Log("Context: returned to title");
-                this.OnReturnedToTitle();
-            }
 
-            // override chatbox
-            if (newStage == LoadStage.Loaded)
+            // handle stages
+            switch (newStage)
             {
-                Game1.onScreenMenus.Remove(Game1.chatBox);
-                Game1.onScreenMenus.Add(Game1.chatBox = new SChatBox(this.LogManager.MonitorForGame));
+                case LoadStage.ReturningToTitle:
+                    this.Monitor.Log("Context: returning to title");
+                    this.OnReturningToTitle();
+                    break;
+
+                case LoadStage.None:
+                    this.JustReturnedToTitle = true;
+                    break;
+
+                case LoadStage.Loaded:
+                    // override chatbox
+                    Game1.onScreenMenus.Remove(Game1.chatBox);
+                    Game1.onScreenMenus.Add(Game1.chatBox = new SChatBox(this.LogManager.MonitorForGame));
+                    break;
             }
 
             // raise events
@@ -1113,13 +1120,12 @@ namespace StardewModdingAPI.Framework
             this.EventManager.DayEnding.RaiseEmpty();
         }
 
-        /// <summary>Raised after the player returns to the title screen.</summary>
-        private void OnReturnedToTitle()
+        /// <summary>Raised immediately before the player returns to the title screen.</summary>
+        private void OnReturningToTitle()
         {
             // perform cleanup
             this.Multiplayer.CleanupOnMultiplayerExit();
             this.ContentCore.OnReturningToTitleScreen();
-            this.JustReturnedToTitle = true;
         }
 
         /// <summary>Raised before the game exits.</summary>

From 699a07ecf718ee60a1225ff910a73aa4898ef908 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 28 Feb 2021 20:12:39 -0500
Subject: [PATCH 116/856] fix broken references to LoadStage enum in previously
 compiled mods

---
 src/SMAPI/Enums/LoadStage.cs | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/src/SMAPI/Enums/LoadStage.cs b/src/SMAPI/Enums/LoadStage.cs
index 250c88e9..bf103576 100644
--- a/src/SMAPI/Enums/LoadStage.cs
+++ b/src/SMAPI/Enums/LoadStage.cs
@@ -4,42 +4,42 @@ namespace StardewModdingAPI.Enums
     public enum LoadStage
     {
         /// <summary>A save is not loaded or loading.</summary>
-        None,
+        None = 0,
 
         /// <summary>The game is creating a new save slot, and has initialized the basic save info.</summary>
-        CreatedBasicInfo,
+        CreatedBasicInfo = 1,
 
         /// <summary>The game is creating a new save slot, and has added the location instances but hasn't fully initialized them yet.</summary>
-        CreatedInitialLocations,
+        CreatedInitialLocations = 10,
 
         /// <summary>The game is creating a new save slot, and has initialized the in-game locations.</summary>
-        CreatedLocations,
+        CreatedLocations = 2,
 
         /// <summary>The game is creating a new save slot, and has created the physical save files.</summary>
-        CreatedSaveFile,
+        CreatedSaveFile = 3,
 
         /// <summary>The game is loading a save slot, and has read the raw save data into <see cref="StardewValley.SaveGame.loaded"/>. Not applicable when connecting to a multiplayer host. This is equivalent to <see cref="StardewValley.SaveGame.getLoadEnumerator"/> value 20.</summary>
-        SaveParsed,
+        SaveParsed = 4,
 
         /// <summary>The game is loading a save slot, and has applied the basic save info (including player data). Not applicable when connecting to a multiplayer host. Note that some basic info (like daily luck) is not initialized at this point. This is equivalent to <see cref="StardewValley.SaveGame.getLoadEnumerator"/> value 36.</summary>
-        SaveLoadedBasicInfo,
+        SaveLoadedBasicInfo = 5,
 
         /// <summary>The game is loading a save slot and has added the location instances, but hasn't applied the data yet. Not applicable when connecting to a multiplayer host.</summary>
-        SaveAddedLocations,
+        SaveAddedLocations = 11,
 
         /// <summary>The game is loading a save slot, and has applied the in-game location data. Not applicable when connecting to a multiplayer host. This is equivalent to <see cref="StardewValley.SaveGame.getLoadEnumerator"/> value 50.</summary>
-        SaveLoadedLocations,
+        SaveLoadedLocations = 6,
 
         /// <summary>The final metadata has been loaded from the save file. This happens before the game applies problem fixes, checks for achievements, starts music, etc. Not applicable when connecting to a multiplayer host.</summary>
-        Preloaded,
+        Preloaded = 7,
 
         /// <summary>The save is fully loaded, but the world may not be fully initialized yet.</summary>
-        Loaded,
+        Loaded = 8,
 
         /// <summary>The save is fully loaded, the world has been initialized, and <see cref="Context.IsWorldReady"/> is now true.</summary>
-        Ready,
+        Ready = 9,
 
         /// <summary>The game is exiting the loaded save and returning to the title screen. This happens before it returns to title; see <see cref="None"/> after it returns.</summary>
-        ReturningToTitle
+        ReturningToTitle = 12
     }
 }

From 5a2258f4194986df3dea7dca9b17cdc96b3e63d5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 4 Mar 2021 21:59:49 -0500
Subject: [PATCH 117/856] fix RewriteMods option ignored when rewriting mod for
 OS

---
 docs/release-notes.md                         |  1 +
 .../Framework/ModLoading/AssemblyLoader.cs    | 57 ++++++++++---------
 2 files changed, 31 insertions(+), 27 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6f69479e..7a4a0409 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
 
 * For mod authors:
   * Added three stages to the `LoadStageChanged` event: `CreatedInitialLocations`/`SaveAddedLocations` (raised immediately after the game adds locations but before they're initialized), and `ReturningToTitle` (raised before exiting to the title screen).
+  * Fixed `RewriteMods` option in `smapi-internal/config.json` ignored when rewriting mod for OS compatibility.
   * Fixed edge case when playing as a farmhand in non-English where translatable assets loaded via `IAssetLoader` weren't reapplied immediately when the server disconnects.
 
 ## 3.9.2
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 4fae0f44..69535aa5 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -276,37 +276,40 @@ namespace StardewModdingAPI.Framework.ModLoading
 
             // swap assembly references if needed (e.g. XNA => MonoGame)
             bool platformChanged = false;
-            for (int i = 0; i < module.AssemblyReferences.Count; i++)
+            if (this.RewriteMods)
             {
-                // remove old assembly reference
-                if (this.AssemblyMap.RemoveNames.Any(name => module.AssemblyReferences[i].Name == name))
+                for (int i = 0; i < module.AssemblyReferences.Count; i++)
                 {
-                    this.Monitor.LogOnce(loggedMessages, $"{logPrefix}Rewriting {filename} for OS...");
-                    platformChanged = true;
-                    module.AssemblyReferences.RemoveAt(i);
-                    i--;
-                }
-            }
-            if (platformChanged)
-            {
-                // add target assembly references
-                foreach (AssemblyNameReference target in this.AssemblyMap.TargetReferences.Values)
-                    module.AssemblyReferences.Add(target);
-
-                // rewrite type scopes to use target assemblies
-                IEnumerable<TypeReference> typeReferences = module.GetTypeReferences().OrderBy(p => p.FullName);
-                foreach (TypeReference type in typeReferences)
-                    this.ChangeTypeScope(type);
-
-                // rewrite types using custom attributes
-                foreach (TypeDefinition type in module.GetTypes())
-                {
-                    foreach (var attr in type.CustomAttributes)
+                    // remove old assembly reference
+                    if (this.AssemblyMap.RemoveNames.Any(name => module.AssemblyReferences[i].Name == name))
                     {
-                        foreach (var conField in attr.ConstructorArguments)
+                        this.Monitor.LogOnce(loggedMessages, $"{logPrefix}Rewriting {filename} for OS...");
+                        platformChanged = true;
+                        module.AssemblyReferences.RemoveAt(i);
+                        i--;
+                    }
+                }
+                if (platformChanged)
+                {
+                    // add target assembly references
+                    foreach (AssemblyNameReference target in this.AssemblyMap.TargetReferences.Values)
+                        module.AssemblyReferences.Add(target);
+
+                    // rewrite type scopes to use target assemblies
+                    IEnumerable<TypeReference> typeReferences = module.GetTypeReferences().OrderBy(p => p.FullName);
+                    foreach (TypeReference type in typeReferences)
+                        this.ChangeTypeScope(type);
+
+                    // rewrite types using custom attributes
+                    foreach (TypeDefinition type in module.GetTypes())
+                    {
+                        foreach (var attr in type.CustomAttributes)
                         {
-                            if (conField.Value is TypeReference typeRef)
-                                this.ChangeTypeScope(typeRef);
+                            foreach (var conField in attr.ConstructorArguments)
+                            {
+                                if (conField.Value is TypeReference typeRef)
+                                    this.ChangeTypeScope(typeRef);
+                            }
                         }
                     }
                 }

From 36cb8e8fcb8afd2965ffe26e7755eb11838264d7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 7 Mar 2021 17:42:55 -0500
Subject: [PATCH 118/856] keep window open when installer crashes

---
 docs/release-notes.md          |  1 +
 src/SMAPI.Installer/Program.cs | 25 ++++++++++++++++++++++++-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7a4a0409..ebe44f09 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Fixed console showing _found 1 mod with warnings_ with no mods listed.
+  * If the installer crashes, the window now stays open if possible so you can read the error and ask for help.
 
 * For mod authors:
   * Added three stages to the `LoadStageChanged` event: `CreatedInitialLocations`/`SaveAddedLocations` (raised immediately after the game adds locations but before they're initialized), and `ReturningToTitle` (raised before exiting to the title screen).
diff --git a/src/SMAPI.Installer/Program.cs b/src/SMAPI.Installer/Program.cs
index 6c479621..d9c31dd6 100644
--- a/src/SMAPI.Installer/Program.cs
+++ b/src/SMAPI.Installer/Program.cs
@@ -3,6 +3,7 @@ using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.IO.Compression;
 using System.Reflection;
+using System.Threading;
 
 namespace StardewModdingApi.Installer
 {
@@ -49,7 +50,15 @@ namespace StardewModdingApi.Installer
 
             // launch installer
             var installer = new InteractiveInstaller(bundleDir.FullName);
-            installer.Run(args);
+
+            try
+            {
+                installer.Run(args);
+            }
+            catch (Exception ex)
+            {
+                Program.PrintErrorAndExit($"The installer failed with an unexpected exception.\nIf you need help fixing this error, see https://smapi.io/help\n\n{ex}");
+            }
         }
 
         /*********
@@ -76,5 +85,19 @@ namespace StardewModdingApi.Installer
                 return null;
             }
         }
+
+        /// <summary>Write an error directly to the console and exit.</summary>
+        /// <param name="message">The error message to display.</param>
+        private static void PrintErrorAndExit(string message)
+        {
+            Console.ForegroundColor = ConsoleColor.Red;
+            Console.WriteLine(message);
+            Console.ResetColor();
+
+            Console.WriteLine("Game has ended. Press any key to exit.");
+            Thread.Sleep(100);
+            Console.ReadKey();
+            Environment.Exit(0);
+        }
     }
 }

From 0ed46c09104b823a5784690fa50e7022efc12c8f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 7 Mar 2021 18:04:48 -0500
Subject: [PATCH 119/856] add descriptive error for PathTooLongException which
 crashes SMAPI or the installer

---
 docs/release-notes.md                        |  3 ++-
 src/SMAPI.Installer/InteractiveInstaller.cs  | 12 ++++++++++
 src/SMAPI.Toolkit/Properties/AssemblyInfo.cs |  1 +
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs | 25 ++++++++++++++++++++
 src/SMAPI/Framework/Logging/LogManager.cs    | 13 +++++++++-
 5 files changed, 52 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ebe44f09..39e33305 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,8 +9,9 @@
 
 ## Upcoming release
 * For players:
-  * Fixed console showing _found 1 mod with warnings_ with no mods listed.
   * If the installer crashes, the window now stays open if possible so you can read the error and ask for help.
+  * Added descriptive error if possible when a `PathTooLongException` crashes SMAPI or the installer.
+  * Fixed console showing _found 1 mod with warnings_ with no mods listed.
 
 * For mod authors:
   * Added three stages to the `LoadStageChanged` event: `CreatedInitialLocations`/`SaveAddedLocations` (raised immediately after the game adds locations but before they're initialized), and `ReturningToTitle` (raised before exiting to the title screen).
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index ff74a659..3d673719 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -279,6 +279,7 @@ namespace StardewModdingApi.Installer
             /*********
             ** Step 4: validate assumptions
             *********/
+            // executable exists
             if (!File.Exists(paths.ExecutablePath))
             {
                 this.PrintError("The detected game install path doesn't contain a Stardew Valley executable.");
@@ -286,6 +287,17 @@ namespace StardewModdingApi.Installer
                 return;
             }
 
+            // game folder doesn't contain paths beyond the max limit
+            {
+                string[] tooLongPaths = PathUtilities.GetTooLongPaths(Path.Combine(paths.GamePath, "Mods")).ToArray();
+                if (tooLongPaths.Any())
+                {
+                    this.PrintError($"SMAPI can't install to the detected game folder, because some of its files exceed the maximum {context.Platform} path length.\nIf you need help fixing this error, see https://smapi.io/help\n\nAffected paths:\n   {string.Join("\n   ", tooLongPaths)}");
+                    Console.ReadLine();
+                    return;
+                }
+            }
+
 
             /*********
             ** Step 5: ask what to do
diff --git a/src/SMAPI.Toolkit/Properties/AssemblyInfo.cs b/src/SMAPI.Toolkit/Properties/AssemblyInfo.cs
index 233e680b..eede4562 100644
--- a/src/SMAPI.Toolkit/Properties/AssemblyInfo.cs
+++ b/src/SMAPI.Toolkit/Properties/AssemblyInfo.cs
@@ -1,4 +1,5 @@
 using System.Runtime.CompilerServices;
 
 [assembly: InternalsVisibleTo("StardewModdingAPI")]
+[assembly: InternalsVisibleTo("SMAPI.Installer")]
 [assembly: InternalsVisibleTo("SMAPI.Web")]
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index c9fb6213..a394edba 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.Diagnostics.Contracts;
 using System.IO;
 using System.Linq;
@@ -133,5 +134,29 @@ namespace StardewModdingAPI.Toolkit.Utilities
         {
             return !Regex.IsMatch(str, "[^a-z0-9_.-]", RegexOptions.IgnoreCase);
         }
+
+        /// <summary>Get the paths which exceed the OS length limit.</summary>
+        /// <param name="rootPath">The root path to search.</param>
+        internal static IEnumerable<string> GetTooLongPaths(string rootPath)
+        {
+            return Directory
+                .EnumerateFileSystemEntries(rootPath, "*.*", SearchOption.AllDirectories)
+                .Where(PathUtilities.IsPathTooLong);
+        }
+
+        /// <summary>Get whether a file or directory path exceeds the OS path length limit.</summary>
+        /// <param name="path">The path to test.</param>
+        internal static bool IsPathTooLong(string path)
+        {
+            try
+            {
+                _ = Path.GetFullPath(path);
+                return false;
+            }
+            catch (PathTooLongException)
+            {
+                return true;
+            }
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index f3656886..0dd45355 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -252,11 +252,22 @@ namespace StardewModdingAPI.Framework.Logging
                     break;
 
                 // missing content folder exception
-                case FileNotFoundException ex when ex.Message == "Could not find file 'C:\\Program Files (x86)\\Steam\\SteamApps\\common\\Stardew Valley\\Content\\XACT\\FarmerSounds.xgs'.": // path in error is hardcoded regardless of install path
+                case FileNotFoundException ex when ex.Message == "Couldn't find file 'C:\\Program Files (x86)\\Steam\\SteamApps\\common\\Stardew Valley\\Content\\XACT\\FarmerSounds.xgs'.": // path in error is hardcoded regardless of install path
                     this.Monitor.Log("The game can't find its Content\\XACT\\FarmerSounds.xgs file. You can usually fix this by resetting your content files (see https://smapi.io/troubleshoot#reset-content ), or by uninstalling and reinstalling the game.", LogLevel.Error);
                     this.Monitor.Log($"Technical details: {ex.GetLogSummary()}");
                     break;
 
+                // path too long exception
+                case PathTooLongException:
+                    {
+                        string[] affectedPaths = PathUtilities.GetTooLongPaths(Constants.ModsPath).ToArray();
+                        string message = affectedPaths.Any()
+                            ? $"SMAPI can't launch because some of your mod files exceed the maximum path length on {Constants.Platform}.\nIf you need help fixing this error, see https://smapi.io/help\n\nAffected paths:\n   {string.Join("\n   ", affectedPaths)}"
+                            : $"The game failed to launch: {exception.GetLogSummary()}";
+                        this.MonitorForGame.Log(message, LogLevel.Error);
+                    }
+                    break;
+
                 // generic exception
                 default:
                     this.MonitorForGame.Log($"The game failed to launch: {exception.GetLogSummary()}", LogLevel.Error);

From 7914734375df7b4c94e9119611a0eb85cc2caac9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 7 Mar 2021 19:48:47 -0500
Subject: [PATCH 120/856] get patcher names automatically if needed

---
 src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs  | 7 -------
 src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs        | 7 -------
 src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs | 7 -------
 src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs      | 7 -------
 src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs    | 7 -------
 src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs  | 7 -------
 .../Patches/SpriteBatchValidationPatches.cs                | 7 -------
 src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs | 7 -------
 src/SMAPI/Framework/Patching/GamePatcher.cs                | 2 +-
 src/SMAPI/Framework/Patching/IHarmonyPatch.cs              | 6 +++---
 src/SMAPI/Patches/LoadContextPatch.cs                      | 7 -------
 11 files changed, 4 insertions(+), 67 deletions(-)

diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
index ba0ca582..cce13064 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
@@ -29,13 +29,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static IReflectionHelper Reflection;
 
 
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(DialogueErrorPatch);
-
-
         /*********
         ** Public methods
         *********/
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
index a15c1d32..72863d17 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
@@ -23,13 +23,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static IMonitor MonitorForGame;
 
 
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(EventPatches);
-
-
         /*********
         ** Public methods
         *********/
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
index c10f2de7..1edf2d6a 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
@@ -24,13 +24,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static IMonitor MonitorForGame;
 
 
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(GameLocationPatches);
-
-
         /*********
         ** Public methods
         *********/
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
index 2227ea07..52d5f5a1 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
@@ -31,13 +31,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static Action OnContentRemoved;
 
 
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(LoadErrorPatch);
-
-
         /*********
         ** Public methods
         *********/
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
index 70f054cd..9f8a98cd 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
@@ -20,13 +20,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     internal class ObjectErrorPatch : IHarmonyPatch
     {
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(ObjectErrorPatch);
-
-
         /*********
         ** Public methods
         *********/
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
index abbd1a8f..d2a5e988 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
@@ -26,13 +26,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static IMonitor MonitorForGame;
 
 
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(ScheduleErrorPatch);
-
-
         /*********
         ** Public methods
         *********/
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
index 0211cfb1..95e4f5ef 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
@@ -16,13 +16,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     internal class SpriteBatchValidationPatches : IHarmonyPatch
     {
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(SpriteBatchValidationPatches);
-
-
         /*********
         ** Public methods
         *********/
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
index 481c881e..1ddd407c 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
@@ -18,13 +18,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     internal class UtilityErrorPatches : IHarmonyPatch
     {
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(UtilityErrorPatches);
-
-
         /*********
         ** Public methods
         *********/
diff --git a/src/SMAPI/Framework/Patching/GamePatcher.cs b/src/SMAPI/Framework/Patching/GamePatcher.cs
index 82d7b9c8..ddecda08 100644
--- a/src/SMAPI/Framework/Patching/GamePatcher.cs
+++ b/src/SMAPI/Framework/Patching/GamePatcher.cs
@@ -44,7 +44,7 @@ namespace StardewModdingAPI.Framework.Patching
                 }
                 catch (Exception ex)
                 {
-                    this.Monitor.Log($"Couldn't apply runtime patch '{patch.Name}' to the game. Some SMAPI features may not work correctly. See log file for details.", LogLevel.Error);
+                    this.Monitor.Log($"Couldn't apply runtime patch '{patch.GetType().Name}' to the game. Some SMAPI features may not work correctly. See log file for details.", LogLevel.Error);
                     this.Monitor.Log(ex.GetLogSummary(), LogLevel.Trace);
                 }
             }
diff --git a/src/SMAPI/Framework/Patching/IHarmonyPatch.cs b/src/SMAPI/Framework/Patching/IHarmonyPatch.cs
index 922243fa..38d30ab2 100644
--- a/src/SMAPI/Framework/Patching/IHarmonyPatch.cs
+++ b/src/SMAPI/Framework/Patching/IHarmonyPatch.cs
@@ -9,9 +9,9 @@ namespace StardewModdingAPI.Framework.Patching
     /// <summary>A Harmony patch to apply.</summary>
     internal interface IHarmonyPatch
     {
-        /// <summary>A unique name for this patch.</summary>
-        string Name { get; }
-
+        /*********
+        ** Methods
+        *********/
         /// <summary>Apply the Harmony patch.</summary>
         /// <param name="harmony">The Harmony instance.</param>
 #if HARMONY_2
diff --git a/src/SMAPI/Patches/LoadContextPatch.cs b/src/SMAPI/Patches/LoadContextPatch.cs
index 28bc23b6..c43d7071 100644
--- a/src/SMAPI/Patches/LoadContextPatch.cs
+++ b/src/SMAPI/Patches/LoadContextPatch.cs
@@ -33,13 +33,6 @@ namespace StardewModdingAPI.Patches
         private static bool IsInLoadForNewGame;
 
 
-        /*********
-        ** Accessors
-        *********/
-        /// <inheritdoc />
-        public string Name => nameof(LoadContextPatch);
-
-
         /*********
         ** Public methods
         *********/

From a571f459f59a6ecfdd53e3158ba8d29157598920 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 7 Mar 2021 20:02:25 -0500
Subject: [PATCH 121/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 12 +++++++-----
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 src/SMAPI/Enums/LoadStage.cs                 |  4 ++--
 7 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 29acbb56..50c839e1 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.9.2</Version>
+    <Version>3.9.3</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 39e33305..36351f34 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,15 +7,17 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.9.3
+Released 07 March 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
-  * If the installer crashes, the window now stays open if possible so you can read the error and ask for help.
   * Added descriptive error if possible when a `PathTooLongException` crashes SMAPI or the installer.
-  * Fixed console showing _found 1 mod with warnings_ with no mods listed.
+  * The installer window now tries to stay open if it crashed, so you can read the error and ask for help.
+  * Fixed console showing _found 1 mod with warnings_ with no mods listed in some cases.
 
 * For mod authors:
-  * Added three stages to the `LoadStageChanged` event: `CreatedInitialLocations`/`SaveAddedLocations` (raised immediately after the game adds locations but before they're initialized), and `ReturningToTitle` (raised before exiting to the title screen).
-  * Fixed `RewriteMods` option in `smapi-internal/config.json` ignored when rewriting mod for OS compatibility.
+  * Added three stages to the specialised [`LoadStageChanged` event](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Specialised): `CreatedInitialLocations`, `SaveAddedLocations`, and `ReturningToTitle`.
+  * Fixed `RewriteMods` option ignored when rewriting for OS compatibility.
   * Fixed edge case when playing as a farmhand in non-English where translatable assets loaded via `IAssetLoader` weren't reapplied immediately when the server disconnects.
 
 ## 3.9.2
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index aa3d6ceb..58692de1 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.9.2",
+    "Version": "3.9.3",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.9.2"
+    "MinimumApiVersion": "3.9.3"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index b6df0f49..962b27f8 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.9.2",
+    "Version": "3.9.3",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.9.2"
+    "MinimumApiVersion": "3.9.3"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 4d2003e2..d51bc5d9 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.9.2",
+    "Version": "3.9.3",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.9.2"
+    "MinimumApiVersion": "3.9.3"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 54fb54ab..a81a6bc9 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.2");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.3");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");
diff --git a/src/SMAPI/Enums/LoadStage.cs b/src/SMAPI/Enums/LoadStage.cs
index bf103576..302c263b 100644
--- a/src/SMAPI/Enums/LoadStage.cs
+++ b/src/SMAPI/Enums/LoadStage.cs
@@ -24,10 +24,10 @@ namespace StardewModdingAPI.Enums
         /// <summary>The game is loading a save slot, and has applied the basic save info (including player data). Not applicable when connecting to a multiplayer host. Note that some basic info (like daily luck) is not initialized at this point. This is equivalent to <see cref="StardewValley.SaveGame.getLoadEnumerator"/> value 36.</summary>
         SaveLoadedBasicInfo = 5,
 
-        /// <summary>The game is loading a save slot and has added the location instances, but hasn't applied the data yet. Not applicable when connecting to a multiplayer host.</summary>
+        /// <summary>The game is loading a save slot and has added the location instances, but hasn't restored their save data yet. Not applicable when connecting to a multiplayer host.</summary>
         SaveAddedLocations = 11,
 
-        /// <summary>The game is loading a save slot, and has applied the in-game location data. Not applicable when connecting to a multiplayer host. This is equivalent to <see cref="StardewValley.SaveGame.getLoadEnumerator"/> value 50.</summary>
+        /// <summary>The game is loading a save slot, and has restored the in-game location data. Not applicable when connecting to a multiplayer host. This is equivalent to <see cref="StardewValley.SaveGame.getLoadEnumerator"/> value 50.</summary>
         SaveLoadedLocations = 6,
 
         /// <summary>The final metadata has been loaded from the save file. This happens before the game applies problem fixes, checks for achievements, starts music, etc. Not applicable when connecting to a multiplayer host.</summary>

From 00969f3b485fd0637980cb4dd8abead2fe621a3b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 7 Mar 2021 21:43:23 -0500
Subject: [PATCH 122/856] update the JSON schema for Content Patcher 1.21

---
 docs/release-notes.md                         |  3 +
 .../wwwroot/schemas/content-patcher.json      | 94 ++++++++++++++++---
 2 files changed, 84 insertions(+), 13 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 36351f34..ed03b3db 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -20,6 +20,9 @@ Released 07 March 2021 for Stardew Valley 1.5.4 or later.
   * Fixed `RewriteMods` option ignored when rewriting for OS compatibility.
   * Fixed edge case when playing as a farmhand in non-English where translatable assets loaded via `IAssetLoader` weren't reapplied immediately when the server disconnects.
 
+* For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.21.
+
 ## 3.9.2
 Released 21 February 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index 21514979..f5056eb1 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -11,9 +11,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features and avoid obsolete behavior.",
             "type": "string",
-            "const": "1.20.0",
+            "const": "1.21.0",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.20.0'."
+                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.21.0'."
             }
         },
         "ConfigSchema": {
@@ -69,6 +69,65 @@
                 }
             }
         },
+        "CustomLocations": {
+            "title": "Custom locations",
+            "description": "The custom in-game locations to make available.",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "properties": {
+                    "Name": {
+                        "title": "Name",
+                        "description": "The location's unique internal name. This can't contain tokens. The name must begin with 'Custom_' (to avoid conflicting with current or future vanilla locations), can only contain alphanumeric or underscore characters, and must be *globally* unique. Prefixing it with your mod name is strongly recommended.",
+                        "type": "string",
+                        "allOf": [
+                            {
+                                "pattern": "^ *Custom_"
+                            },
+                            {
+                                "pattern": "^ *[a-zA-Z0-9_]+ *$"
+                            },
+                            {
+                                "pattern": "^ *Custom_.+_.+ *$"
+                            }
+                        ],
+                        "@errorMessages": {
+                            "allOf:indexes: 0": "Custom location names must start with the exact text 'Custom_'.",
+                            "allOf:indexes: 1": "Custom location names can only contain alphanumeric or underscore characters.",
+                            "allOf:indexes: 2": "The location name should have three parts separated by underscores: the exact text 'Custom', a short label or acronym for your mod, and a map name (like 'Custom_YourModName_MapName'). Although not strictly required, this is very strongly recommended due to the consequences if two mods accidentally use the same location name."
+                        }
+                    },
+                    "FromMapFile": {
+                        "title": "From map file",
+                        "description": "The relative path to the location's map file in your content pack folder (file can be .tmx, .tbin, or .xnb). This can't contain tokens, but you can make conditional changes using EditMap.",
+                        "type": "string",
+                        "allOf": [
+                            {
+                                "not": {
+                                    "pattern": "\b\\.\\.[/\\]"
+                                }
+                            },
+                            {
+                                "pattern": "\\.(tbin|tmx|xnb) *$"
+                            }
+                        ],
+                        "@errorMessages": {
+                            "allOf:indexes: 0": "Invalid value; must not contain directory climbing (like '../').",
+                            "allOf:indexes: 1": "Invalid value; must be a file path ending with .tbin, .tmx, or .xnb."
+                        }
+                    },
+                    "MigrateLegacyNames": {
+                        "title": "Migrate legacy names",
+                        "description": "An optional list of former location names that may appear in the save file instead of the one given by Name. This can't contain tokens. This is only meant to allow migrating older locations, and shouldn't be used in most cases.",
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "additionalProperties": false
+            }
+        },
         "DynamicTokens": {
             "title": "Dynamic tokens",
             "description": "Custom tokens that you can use.",
@@ -127,7 +186,7 @@
                     },
                     "Enabled": {
                         "title": "Enabled",
-                        "description": "Whether to apply this patch. Default true. This fields supports immutable tokens (e.g. config tokens) if they return true/false.",
+                        "description": "Whether to apply this patch. Default true. This field does not allow tokens.",
                         "anyOf": [
                             {
                                 "type": "boolean"
@@ -135,10 +194,6 @@
                             {
                                 "type": "string",
                                 "enum": [ "true", "false" ]
-                            },
-                            {
-                                "type": "string",
-                                "pattern": "\\{\\{[^{}]+\\}\\}"
                             }
                         ],
                         "@errorMessages": {
@@ -267,6 +322,18 @@
                             }
                         }
                     },
+                    "AddWarps": {
+                        "title": "Add warps",
+                        "description": "The warp values to add to the location, in the format recognized by the game's Warp map property.",
+                        "type": "array",
+                        "items": {
+                            "type": "string",
+                            "pattern": " *-?\\d+ -?\\d+ [A-Za-z0-9_]+ -?\\d+ -?\\d+ *$",
+                            "@errorMessages": {
+                                "pattern": "Each warp must match the exact format recognized by the game's Warp map property (i.e. 'fromX fromY targetMap targetX targetY', like '10 10 Town 0 30'."
+                            }
+                        }
+                    },
                     "MapProperties": {
                         "title": "Map properties",
                         "description": "The map properties (not tile properties) to add, replace, or delete. To add an property, just specify a key that doesn't exist; to delete an entry, set the value to null (like \"some key\": null). This field supports tokens in property keys and values.",
@@ -441,6 +508,7 @@
                                     "Update",
                                     "When",
 
+                                    "AddWarps",
                                     "FromArea",
                                     "MapProperties",
                                     "MapTiles",
@@ -495,13 +563,13 @@
                     "title": "X position",
                     "description": "The X position, measured in pixels for a texture or tiles for a map. This can contain tokens.",
                     "type": [ "integer", "string" ],
-                    "minimum:": 0
+                    "minimum": 0
                 },
                 "Y": {
                     "title": "Y position",
                     "description": "The Y position, measured in pixels for a texture or tiles for a map. This can contain tokens.",
                     "type": [ "integer", "string" ],
-                    "minimum:": 0
+                    "minimum": 0
                 }
             },
 
@@ -515,25 +583,25 @@
                     "title": "X position",
                     "description": "The X position of the area's top-left corner, measured in pixels for a texture or tiles for a map. This can contain tokens.",
                     "type": [ "integer", "string" ],
-                    "minimum:": 0
+                    "minimum": 0
                 },
                 "Y": {
                     "title": "Y position",
                     "description": "The Y position of the area's top-left corner, measured in pixels for a texture or tiles for a map. This can contain tokens.",
                     "type": [ "integer", "string" ],
-                    "minimum:": 0
+                    "minimum": 0
                 },
                 "Width": {
                     "title": "Width",
                     "description": "The width of the area, measured in pixels for a texture or tiles for a map. This can contain tokens.",
                     "type": [ "integer", "string" ],
-                    "minimum:": 0
+                    "minimum": 0
                 },
                 "Height": {
                     "title": "Height",
                     "description": "The height of the area, measured in pixels for a texture or tiles for a map. This can contain tokens.",
                     "type": [ "integer", "string" ],
-                    "minimum:": 0
+                    "minimum": 0
                 }
             },
 

From 35ba5cc58510a754b9377e33ebf01e3c2731d31e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Mar 2021 00:05:58 -0500
Subject: [PATCH 123/856] fix installer error when Mods folder doesn't exist in
 3.9.3 (#764)

---
 docs/release-notes.md                        | 4 ++++
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ed03b3db..6112f99c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Fixed installer error if the `Mods` folder doesn't exist in 3.9.3.
+
 ## 3.9.3
 Released 07 March 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index a394edba..babc0981 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -139,6 +139,9 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <param name="rootPath">The root path to search.</param>
         internal static IEnumerable<string> GetTooLongPaths(string rootPath)
         {
+            if (!Directory.Exists(rootPath))
+                return new string[0];
+
             return Directory
                 .EnumerateFileSystemEntries(rootPath, "*.*", SearchOption.AllDirectories)
                 .Where(PathUtilities.IsPathTooLong);

From b8309e90173172dd88a50b429b760271b4a150cf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Mar 2021 00:08:15 -0500
Subject: [PATCH 124/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 50c839e1..d9d21466 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.9.3</Version>
+    <Version>3.9.4</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6112f99c..045a5168 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,7 +7,9 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.9.4
+Released 07 March 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
   * Fixed installer error if the `Mods` folder doesn't exist in 3.9.3.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 58692de1..2811a11c 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.9.3",
+    "Version": "3.9.4",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.9.3"
+    "MinimumApiVersion": "3.9.4"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 962b27f8..52bf4f6a 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.9.3",
+    "Version": "3.9.4",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.9.3"
+    "MinimumApiVersion": "3.9.4"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index d51bc5d9..b88582ba 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.9.3",
+    "Version": "3.9.4",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.9.3"
+    "MinimumApiVersion": "3.9.4"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index a81a6bc9..0de2b12f 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.3");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.4");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");

From 77629a528a2f93a2977a1bf63e2e18faaaffaaaf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 13 Mar 2021 23:51:55 -0500
Subject: [PATCH 125/856] disable aggressive memory optimizations by default

---
 docs/release-notes.md       | 4 ++++
 src/SMAPI/SMAPI.config.json | 5 +++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 045a5168..cf7643b3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Aggressive memory optimization (added in 3.9.2) is now disabled by default. The option reduces errors for a subset of players who use certain mods, but may cause crashes for farmhands in multiplayer. You can edit `smapi-internal/config.json` to enable it if you experience frequent `OutOfMemoryException` errors.
+
 ## 3.9.4
 Released 07 March 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index a9e6f389..034eceed 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -41,9 +41,10 @@ copy all the settings, or you may cause bugs due to overridden changes in future
 
     /**
      * Whether to enable more aggressive memory optimizations.
-     * You can try disabling this if you get ObjectDisposedException errors.
+     * If you get frequent 'OutOfMemoryException' errors, you can try enabling this to reduce their
+     * frequency. This may cause crashes for farmhands in multiplayer.
      */
-    "AggressiveMemoryOptimizations": true,
+    "AggressiveMemoryOptimizations": false,
 
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially

From 04388fe7e3b721358de25d64607d47d5f6113eda Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 14 Mar 2021 04:43:28 -0400
Subject: [PATCH 126/856] fix some assets not reapplied correctly when playing
 in non-English and returning to title

---
 docs/release-notes.md                         |  3 ++
 src/SMAPI/Framework/ContentCoordinator.cs     | 37 ++++++++++++++-----
 .../ContentManagers/BaseContentManager.cs     |  3 --
 .../ContentManagers/GameContentManager.cs     | 25 -------------
 .../ContentManagers/IContentManager.cs        |  4 --
 .../Framework/ModHelpers/ContentHelper.cs     |  2 +-
 6 files changed, 32 insertions(+), 42 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index cf7643b3..c2e76b56 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,9 @@
 * For players:
   * Aggressive memory optimization (added in 3.9.2) is now disabled by default. The option reduces errors for a subset of players who use certain mods, but may cause crashes for farmhands in multiplayer. You can edit `smapi-internal/config.json` to enable it if you experience frequent `OutOfMemoryException` errors.
 
+* For mod authors:
+  * Fixed assets changed by a mod not reapplied if playing in non-English, the changes are only applicable after the save is loaded, the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
+
 ## 3.9.4
 Released 07 March 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 32195fff..6d2ff441 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -207,11 +207,30 @@ namespace StardewModdingAPI.Framework
         /// <remarks>This is called after the player returns to the title screen, but before <see cref="Game1.CleanupReturningToTitle"/> runs.</remarks>
         public void OnReturningToTitleScreen()
         {
-            this.ContentManagerLock.InReadLock(() =>
-            {
-                foreach (IContentManager contentManager in this.ContentManagers)
-                    contentManager.OnReturningToTitleScreen();
-            });
+            // The game clears LocalizedContentManager.localizedAssetNames after returning to the title screen. That
+            // causes an inconsistency in the SMAPI asset cache, which leads to an edge case where assets already
+            // provided by mods via IAssetLoader when playing in non-English are ignored.
+            //
+            // For example, let's say a mod provides the 'Data\mail' asset through IAssetLoader when playing in
+            // Portuguese. Here's the normal load process after it's loaded:
+            //   1. The game requests Data\mail.
+            //   2. SMAPI sees that it's already cached, and calls LoadRaw to bypass asset interception.
+            //   3. LoadRaw sees that there's a localized key mapping, and gets the mapped key.
+            //   4. In this case "Data\mail" is mapped to "Data\mail" since it was loaded by a mod, so it loads that
+            //      asset.
+            //
+            // When the game clears localizedAssetNames, that process goes wrong in step 4:
+            //  3. LoadRaw sees that there's no localized key mapping *and* the locale is non-English, so it attempts
+            //     to load from the localized key format.
+            //  4. In this case that's 'Data\mail.pt-BR', so it successfully loads that asset.
+            //  5. Since we've bypassed asset interception at this point, it's loaded directly from the base content
+            //     manager without mod changes.
+            //
+            // To avoid issues, we just remove affected assets from the cache here so they'll be reloaded normally.
+            // Note that we *must* propagate changes here, otherwise when mods invalidate the cache later to reapply
+            // their changes, the assets won't be found in the cache so no changes will be propagated.
+            if (LocalizedContentManager.CurrentLanguageCode != LocalizedContentManager.LanguageCode.en)
+                this.InvalidateCache((contentManager, key, type) => contentManager is GameContentManager);
         }
 
         /// <summary>Get whether this asset is mapped to a mod folder.</summary>
@@ -275,7 +294,7 @@ namespace StardewModdingAPI.Framework
         public IEnumerable<string> InvalidateCache(Func<IAssetInfo, bool> predicate, bool dispose = false)
         {
             string locale = this.GetLocale();
-            return this.InvalidateCache((assetName, type) =>
+            return this.InvalidateCache((contentManager, assetName, type) =>
             {
                 IAssetInfo info = new AssetInfo(locale, assetName, type, this.MainContentManager.AssertAndNormalizeAssetName);
                 return predicate(info);
@@ -286,7 +305,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="predicate">Matches the asset keys to invalidate.</param>
         /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
         /// <returns>Returns the invalidated asset names.</returns>
-        public IEnumerable<string> InvalidateCache(Func<string, Type, bool> predicate, bool dispose = false)
+        public IEnumerable<string> InvalidateCache(Func<IContentManager, string, Type, bool> predicate, bool dispose = false)
         {
             // invalidate cache & track removed assets
             IDictionary<string, Type> removedAssets = new Dictionary<string, Type>(StringComparer.OrdinalIgnoreCase);
@@ -295,7 +314,7 @@ namespace StardewModdingAPI.Framework
                 // cached assets
                 foreach (IContentManager contentManager in this.ContentManagers)
                 {
-                    foreach (var entry in contentManager.InvalidateCache(predicate, dispose))
+                    foreach (var entry in contentManager.InvalidateCache((key, type) => predicate(contentManager, key, type), dispose))
                     {
                         if (!removedAssets.ContainsKey(entry.Key))
                             removedAssets[entry.Key] = entry.Value.GetType();
@@ -313,7 +332,7 @@ namespace StardewModdingAPI.Framework
 
                         // get map path
                         string mapPath = this.MainContentManager.AssertAndNormalizeAssetName(location.mapPath.Value);
-                        if (!removedAssets.ContainsKey(mapPath) && predicate(mapPath, typeof(Map)))
+                        if (!removedAssets.ContainsKey(mapPath) && predicate(this.MainContentManager, mapPath, typeof(Map)))
                             removedAssets[mapPath] = typeof(Map);
                     }
                 }
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 1a64dab8..7244a534 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -121,9 +121,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <inheritdoc />
         public virtual void OnLocaleChanged() { }
 
-        /// <inheritdoc />
-        public virtual void OnReturningToTitleScreen() { }
-
         /// <inheritdoc />
         [Pure]
         public string NormalizePathSeparators(string path)
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 8e78faba..80a9937a 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -136,31 +136,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 this.Monitor.Log($"Invalidated {invalidated.Length} asset names: {string.Join(", ", invalidated)} for locale change.");
         }
 
-        /// <inheritdoc />
-        public override void OnReturningToTitleScreen()
-        {
-            // The game clears LocalizedContentManager.localizedAssetNames after returning to the title screen. That
-            // causes an inconsistency in the SMAPI asset cache, which leads to an edge case where assets already
-            // provided by mods via IAssetLoader when playing in non-English are ignored.
-            //
-            // For example, let's say a mod provides the 'Data\mail' asset through IAssetLoader when playing in
-            // Portuguese. Here's the normal load process after it's loaded:
-            //   1. The game requests Data\mail.
-            //   2. SMAPI sees that it's already cached, and calls LoadRaw to bypass asset interception.
-            //   3. LoadRaw sees that there's a localized key mapping, and gets the mapped key.
-            //   4. In this case "Data\mail" is mapped to "Data\mail" since it was loaded by a mod, so it loads that
-            //      asset.
-            //
-            // When the game clears localizedAssetNames, that process goes wrong in step 4:
-            //  3. LoadRaw sees that there's no localized key mapping *and* the locale is non-English, so it attempts
-            //     to load from the localized key format.
-            //  4. In this case that's 'Data\mail.pt-BR', so it successfully loads that asset.
-            //  5. Since we've bypassed asset interception at this point, it's loaded directly from the base content
-            //     manager without mod changes.
-            if (LocalizedContentManager.CurrentLanguageCode != LocalizedContentManager.LanguageCode.en)
-                this.InvalidateCache((_, _) => true);
-        }
-
         /// <inheritdoc />
         public override LocalizedContentManager CreateTemporary()
         {
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index 1e222472..d7963305 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -69,9 +69,5 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Perform any cleanup needed when the locale changes.</summary>
         void OnLocaleChanged();
-
-        /// <summary>Clean up when the player is returning to the title screen.</summary>
-        /// <remarks>This is called after the player returns to the title screen, but before <see cref="Game1.CleanupReturningToTitle"/> runs.</remarks>
-        void OnReturningToTitleScreen();
     }
 }
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 5fd8f5e9..bfca2264 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -136,7 +136,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public bool InvalidateCache<T>()
         {
             this.Monitor.Log($"Requested cache invalidation for all assets of type {typeof(T)}. This is an expensive operation and should be avoided if possible.", LogLevel.Trace);
-            return this.ContentCore.InvalidateCache((key, type) => typeof(T).IsAssignableFrom(type)).Any();
+            return this.ContentCore.InvalidateCache((contentManager, key, type) => typeof(T).IsAssignableFrom(type)).Any();
         }
 
         /// <inheritdoc />

From 6805c90e2cdac734341b692298670b0beb50faa6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 14 Mar 2021 14:17:09 -0400
Subject: [PATCH 127/856] add asset propagation for interior door sprites

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 32 +++++++++++++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c2e76b56..9835dd64 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,6 +12,7 @@
   * Aggressive memory optimization (added in 3.9.2) is now disabled by default. The option reduces errors for a subset of players who use certain mods, but may cause crashes for farmhands in multiplayer. You can edit `smapi-internal/config.json` to enable it if you experience frequent `OutOfMemoryException` errors.
 
 * For mod authors:
+  * Added asset propagation for interior door sprites.
   * Fixed assets changed by a mod not reapplied if playing in non-English, the changes are only applicable after the save is loaded, the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
 
 ## 3.9.4
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 8b591bc1..ae56dc9c 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -366,6 +366,8 @@ namespace StardewModdingAPI.Metadata
                         foreach (ClickableTextureComponent button in new[] { menu.questButton, menu.zoomInButton, menu.zoomOutButton })
                             button.texture = Game1.mouseCursors;
                     }
+
+                    this.ReloadDoorSprites(content, key);
                     return true;
 
                 case "loosesprites\\cursors2": // Game1.LoadContent
@@ -739,6 +741,36 @@ namespace StardewModdingAPI.Metadata
             return critters.Length;
         }
 
+        /// <summary>Reload the sprites for interior doors.</summary>
+        /// <param name="content">The content manager through which to reload the asset.</param>
+        /// <param name="key">The asset key to reload.</param>
+        /// <returns>Returns whether any doors were affected.</returns>
+        private bool ReloadDoorSprites(LocalizedContentManager content, string key)
+        {
+            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
+
+            foreach (GameLocation location in this.GetLocations())
+            {
+                IEnumerable<InteriorDoor> doors = location.interiorDoors?.Doors;
+                if (doors == null)
+                    continue;
+
+                foreach (InteriorDoor door in doors)
+                {
+                    if (door?.Sprite == null)
+                        continue;
+
+                    string textureName = this.NormalizeAssetNameIgnoringEmpty(this.Reflection.GetField<string>(door.Sprite, "textureName").GetValue());
+                    if (textureName != key)
+                        continue;
+
+                    door.Sprite.texture = texture.Value;
+                }
+            }
+
+            return texture.IsValueCreated;
+        }
+
         /// <summary>Reload the data for matching farm animals.</summary>
         /// <returns>Returns whether any farm animals were affected.</returns>
         /// <remarks>Derived from the <see cref="FarmAnimal"/> constructor.</remarks>

From 749f0321f01b2f2ad865f31ab6f447c5a590fdd0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 16 Mar 2021 18:56:56 -0400
Subject: [PATCH 128/856] avoid asset propagation into the world if it's
 unloaded

Propagating changes into world locations has no effect at this point (since they'll just be recreated when a save is loaded), and can noticeably impact performance.
---
 docs/release-notes.md                     |   1 +
 src/SMAPI/Context.cs                      |   3 +
 src/SMAPI/Framework/ContentCoordinator.cs |  13 ++-
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 109 +++++++++++++---------
 4 files changed, 76 insertions(+), 50 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9835dd64..0a4cd667 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
 
 * For mod authors:
   * Added asset propagation for interior door sprites.
+  * Reduced performance impact of invalidating cached assets before a save is loaded.
   * Fixed assets changed by a mod not reapplied if playing in non-English, the changes are only applicable after the save is loaded, the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
 
 ## 3.9.4
diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index b1b33cd6..5f70d0f7 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -38,6 +38,9 @@ namespace StardewModdingAPI
             set => Context.LoadStageForScreen.Value = value;
         }
 
+        /// <summary>Whether the in-game world is completely unloaded and not in the process of being loaded. The world may still exist in memory at this point, but should be ignored.</summary>
+        internal static bool IsWorldFullyUnloaded => Context.LoadStage == LoadStage.ReturningToTitle || Context.LoadStage == LoadStage.None;
+
 
         /*********
         ** Accessors
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 6d2ff441..5d4855ef 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -341,11 +341,16 @@ namespace StardewModdingAPI.Framework
             // reload core game assets
             if (removedAssets.Any())
             {
-                IDictionary<string, bool> propagated = this.CoreAssets.Propagate(removedAssets.ToDictionary(p => p.Key, p => p.Value)); // use an intercepted content manager
-                this.Monitor.Log($"Invalidated {removedAssets.Count} asset names ({string.Join(", ", removedAssets.Keys.OrderBy(p => p, StringComparer.OrdinalIgnoreCase))}); propagated {propagated.Count(p => p.Value)} core assets.", LogLevel.Trace);
+                IDictionary<string, bool> propagated = this.CoreAssets.Propagate(removedAssets.ToDictionary(p => p.Key, p => p.Value), ignoreWorld: Context.IsWorldFullyUnloaded);
+
+                string[] invalidatedKeys = removedAssets.Keys.ToArray();
+                string[] propagatedKeys = propagated.Where(p => p.Value).Select(p => p.Key).ToArray();
+
+                string FormatKeyList(IEnumerable<string> keys) => string.Join(", ", keys.OrderBy(p => p, StringComparer.OrdinalIgnoreCase));
+                this.Monitor.Log($"Invalidated {invalidatedKeys.Length} asset names ({FormatKeyList(invalidatedKeys)}); propagated {propagatedKeys.Length} core assets ({FormatKeyList(propagatedKeys)}).");
             }
             else
-                this.Monitor.Log("Invalidated 0 cache entries.", LogLevel.Trace);
+                this.Monitor.Log("Invalidated 0 cache entries.");
 
             return removedAssets.Keys;
         }
@@ -391,7 +396,7 @@ namespace StardewModdingAPI.Framework
                 return;
             this.IsDisposed = true;
 
-            this.Monitor.Log("Disposing the content coordinator. Content managers will no longer be usable after this point.", LogLevel.Trace);
+            this.Monitor.Log("Disposing the content coordinator. Content managers will no longer be usable after this point.");
             foreach (IContentManager contentManager in this.ContentManagers)
                 contentManager.Dispose();
             this.ContentManagers.Clear();
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index ae56dc9c..debbaffd 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -79,8 +79,9 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload one of the game's core assets (if applicable).</summary>
         /// <param name="assets">The asset keys and types to reload.</param>
+        /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
         /// <returns>Returns a lookup of asset names to whether they've been propagated.</returns>
-        public IDictionary<string, bool> Propagate(IDictionary<string, Type> assets)
+        public IDictionary<string, bool> Propagate(IDictionary<string, Type> assets, bool ignoreWorld)
         {
             // group into optimized lists
             var buckets = assets.GroupBy(p =>
@@ -101,16 +102,18 @@ namespace StardewModdingAPI.Metadata
                 switch (bucket.Key)
                 {
                     case AssetBucket.Sprite:
-                        this.ReloadNpcSprites(bucket.Select(p => p.Key), propagated);
+                        if (!ignoreWorld)
+                            this.ReloadNpcSprites(bucket.Select(p => p.Key), propagated);
                         break;
 
                     case AssetBucket.Portrait:
-                        this.ReloadNpcPortraits(bucket.Select(p => p.Key), propagated);
+                        if (!ignoreWorld)
+                            this.ReloadNpcPortraits(bucket.Select(p => p.Key), propagated);
                         break;
 
                     default:
                         foreach (var entry in bucket)
-                            propagated[entry.Key] = this.PropagateOther(entry.Key, entry.Value);
+                            propagated[entry.Key] = this.PropagateOther(entry.Key, entry.Value, ignoreWorld);
                         break;
                 }
             }
@@ -124,9 +127,10 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Reload one of the game's core assets (if applicable).</summary>
         /// <param name="key">The asset key to reload.</param>
         /// <param name="type">The asset type to reload.</param>
+        /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
         /// <returns>Returns whether an asset was loaded. The return value may be true or false, or a non-null value for true.</returns>
         [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These deliberately match the asset names.")]
-        private bool PropagateOther(string key, Type type)
+        private bool PropagateOther(string key, Type type, bool ignoreWorld)
         {
             var content = this.MainContentManager;
             key = this.AssertAndNormalizeAssetName(key);
@@ -136,7 +140,7 @@ namespace StardewModdingAPI.Metadata
             ** We only need to do this for the current location, since tilesheets are reloaded when you enter a location.
             ** Just in case, we should still propagate by key even if a tilesheet is matched.
             ****/
-            if (Game1.currentLocation?.map?.TileSheets != null)
+            if (!ignoreWorld && Game1.currentLocation?.map?.TileSheets != null)
             {
                 foreach (TileSheet tilesheet in Game1.currentLocation.map.TileSheets)
                 {
@@ -151,14 +155,19 @@ namespace StardewModdingAPI.Metadata
             if (type == typeof(Map))
             {
                 bool anyChanged = false;
-                foreach (GameLocation location in this.GetLocations())
+
+                if (!ignoreWorld)
                 {
-                    if (!string.IsNullOrWhiteSpace(location.mapPath.Value) && this.NormalizeAssetNameIgnoringEmpty(location.mapPath.Value) == key)
+                    foreach (GameLocation location in this.GetLocations())
                     {
-                        this.ReloadMap(location);
-                        anyChanged = true;
+                        if (!string.IsNullOrWhiteSpace(location.mapPath.Value) && this.NormalizeAssetNameIgnoringEmpty(location.mapPath.Value) == key)
+                        {
+                            this.ReloadMap(location);
+                            anyChanged = true;
+                        }
                     }
                 }
+
                 return anyChanged;
             }
 
@@ -172,7 +181,7 @@ namespace StardewModdingAPI.Metadata
                 ** Animals
                 ****/
                 case "animals\\horse":
-                    return this.ReloadPetOrHorseSprites<Horse>(content, key);
+                    return !ignoreWorld && this.ReloadPetOrHorseSprites<Horse>(content, key);
 
                 /****
                 ** Buildings
@@ -197,7 +206,7 @@ namespace StardewModdingAPI.Metadata
                 case "characters\\farmer\\farmer_base_bald":
                 case "characters\\farmer\\farmer_girl_base":
                 case "characters\\farmer\\farmer_girl_base_bald":
-                    return this.ReloadPlayerSprites(key);
+                    return !ignoreWorld && this.ReloadPlayerSprites(key);
 
                 case "characters\\farmer\\hairstyles": // Game1.LoadContent
                     FarmerRenderer.hairStylesTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.hairStylesTexture, key);
@@ -270,7 +279,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "data\\farmanimals": // FarmAnimal constructor
-                    return this.ReloadFarmAnimalData();
+                    return !ignoreWorld && this.ReloadFarmAnimalData();
 
                 case "data\\hairdata": // Farmer.GetHairStyleMetadataFile
                     return this.ReloadHairData();
@@ -288,7 +297,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "data\\npcdispositions": // NPC constructor
-                    return this.ReloadNpcDispositions(content, key);
+                    return !ignoreWorld && this.ReloadNpcDispositions(content, key);
 
                 case "data\\npcgifttastes": // Game1.LoadContent
                     Game1.NPCGiftTastes = content.Load<Dictionary<string, string>>(key);
@@ -367,7 +376,8 @@ namespace StardewModdingAPI.Metadata
                             button.texture = Game1.mouseCursors;
                     }
 
-                    this.ReloadDoorSprites(content, key);
+                    if (!ignoreWorld)
+                        this.ReloadDoorSprites(content, key);
                     return true;
 
                 case "loosesprites\\cursors2": // Game1.LoadContent
@@ -395,7 +405,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "loosesprites\\suspensionbridge": // SuspensionBridge constructor
-                    return this.ReloadSuspensionBridges(content, key);
+                    return !ignoreWorld && this.ReloadSuspensionBridges(content, key);
 
                 /****
                 ** Content\Maps
@@ -454,14 +464,14 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "tilesheets\\chairtiles": // Game1.LoadContent
-                    return this.ReloadChairTiles(content, key);
+                    return this.ReloadChairTiles(content, key, ignoreWorld);
 
                 case "tilesheets\\craftables": // Game1.LoadContent
                     Game1.bigCraftableSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
                 case "tilesheets\\critters": // Critter constructor
-                    return this.ReloadCritterTextures(content, key) > 0;
+                    return !ignoreWorld && this.ReloadCritterTextures(content, key) > 0;
 
                 case "tilesheets\\crops": // Game1.LoadContent
                     Game1.cropSpriteSheet = content.Load<Texture2D>(key);
@@ -515,7 +525,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures\\grass": // from Grass
-                    return this.ReloadGrassTextures(content, key);
+                    return !ignoreWorld && this.ReloadGrassTextures(content, key);
 
                 case "terrainfeatures\\hoedirt": // from HoeDirt
                     HoeDirt.lightTexture = content.Load<Texture2D>(key);
@@ -530,52 +540,55 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures\\mushroom_tree": // from Tree
-                    return this.ReloadTreeTextures(content, key, Tree.mushroomTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.mushroomTree);
 
                 case "terrainfeatures\\tree_palm": // from Tree
-                    return this.ReloadTreeTextures(content, key, Tree.palmTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.palmTree);
 
                 case "terrainfeatures\\tree1_fall": // from Tree
                 case "terrainfeatures\\tree1_spring": // from Tree
                 case "terrainfeatures\\tree1_summer": // from Tree
                 case "terrainfeatures\\tree1_winter": // from Tree
-                    return this.ReloadTreeTextures(content, key, Tree.bushyTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.bushyTree);
 
                 case "terrainfeatures\\tree2_fall": // from Tree
                 case "terrainfeatures\\tree2_spring": // from Tree
                 case "terrainfeatures\\tree2_summer": // from Tree
                 case "terrainfeatures\\tree2_winter": // from Tree
-                    return this.ReloadTreeTextures(content, key, Tree.leafyTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.leafyTree);
 
                 case "terrainfeatures\\tree3_fall": // from Tree
                 case "terrainfeatures\\tree3_spring": // from Tree
                 case "terrainfeatures\\tree3_winter": // from Tree
-                    return this.ReloadTreeTextures(content, key, Tree.pineTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.pineTree);
             }
 
             /****
             ** Dynamic assets
             ****/
-            // dynamic textures
-            if (this.KeyStartsWith(key, "animals\\cat"))
-                return this.ReloadPetOrHorseSprites<Cat>(content, key);
-            if (this.KeyStartsWith(key, "animals\\dog"))
-                return this.ReloadPetOrHorseSprites<Dog>(content, key);
-            if (this.IsInFolder(key, "Animals"))
-                return this.ReloadFarmAnimalSprites(content, key);
+            if (!ignoreWorld)
+            {
+                // dynamic textures
+                if (this.KeyStartsWith(key, "animals\\cat"))
+                    return this.ReloadPetOrHorseSprites<Cat>(content, key);
+                if (this.KeyStartsWith(key, "animals\\dog"))
+                    return this.ReloadPetOrHorseSprites<Dog>(content, key);
+                if (this.IsInFolder(key, "Animals"))
+                    return this.ReloadFarmAnimalSprites(content, key);
 
-            if (this.IsInFolder(key, "Buildings"))
-                return this.ReloadBuildings(content, key);
+                if (this.IsInFolder(key, "Buildings"))
+                    return this.ReloadBuildings(content, key);
 
-            if (this.KeyStartsWith(key, "LooseSprites\\Fence"))
-                return this.ReloadFenceTextures(key);
+                if (this.KeyStartsWith(key, "LooseSprites\\Fence"))
+                    return this.ReloadFenceTextures(key);
 
-            // dynamic data
-            if (this.IsInFolder(key, "Characters\\Dialogue"))
-                return this.ReloadNpcDialogue(key);
+                // dynamic data
+                if (this.IsInFolder(key, "Characters\\Dialogue"))
+                    return this.ReloadNpcDialogue(key);
 
-            if (this.IsInFolder(key, "Characters\\schedules"))
-                return this.ReloadNpcSchedules(key);
+                if (this.IsInFolder(key, "Characters\\schedules"))
+                    return this.ReloadNpcSchedules(key);
+            }
 
             return false;
         }
@@ -695,19 +708,23 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Reload map seat textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="key">The asset key to reload.</param>
+        /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadChairTiles(LocalizedContentManager content, string key)
+        private bool ReloadChairTiles(LocalizedContentManager content, string key, bool ignoreWorld)
         {
             MapSeat.mapChairTexture = content.Load<Texture2D>(key);
 
-            foreach (var location in this.GetLocations())
+            if (!ignoreWorld)
             {
-                foreach (MapSeat seat in location.mapSeats.Where(p => p != null))
+                foreach (var location in this.GetLocations())
                 {
-                    string curKey = this.NormalizeAssetNameIgnoringEmpty(seat._loadedTextureFile);
+                    foreach (MapSeat seat in location.mapSeats.Where(p => p != null))
+                    {
+                        string curKey = this.NormalizeAssetNameIgnoringEmpty(seat._loadedTextureFile);
 
-                    if (curKey == null || key.Equals(curKey, StringComparison.OrdinalIgnoreCase))
-                        seat.overlayTexture = MapSeat.mapChairTexture;
+                        if (curKey == null || key.Equals(curKey, StringComparison.OrdinalIgnoreCase))
+                            seat.overlayTexture = MapSeat.mapChairTexture;
+                    }
                 }
             }
 

From bb88e42f54c274db3c382eecb54b541dd2599163 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 16 Mar 2021 19:20:37 -0400
Subject: [PATCH 129/856] add console command to regenerate bundles

---
 docs/release-notes.md                         |  3 +-
 .../Commands/Other/RegenerateBundles.cs       | 66 +++++++++++++++++++
 2 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0a4cd667..2ebf061e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,8 @@
 
 ## Upcoming release
 * For players:
-  * Aggressive memory optimization (added in 3.9.2) is now disabled by default. The option reduces errors for a subset of players who use certain mods, but may cause crashes for farmhands in multiplayer. You can edit `smapi-internal/config.json` to enable it if you experience frequent `OutOfMemoryException` errors.
+  * Added `regenerate_bundles` console command to reset community center bundles if they're corrupted by a bug _(in Console Commands)_.
+  * Disabled aggressive memory optimization (added in 3.9.2) by default. The option reduces errors for a subset of players who use certain mods, but may cause crashes for farmhands in multiplayer. You can edit `smapi-internal/config.json` to enable it if you experience frequent `OutOfMemoryException` errors.
 
 * For mod authors:
   * Added asset propagation for interior door sprites.
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
new file mode 100644
index 00000000..d28abd13
--- /dev/null
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
@@ -0,0 +1,66 @@
+using System;
+using System.Linq;
+using StardewValley;
+
+namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
+{
+    /// <summary>A command which regenerates the game's bundles.</summary>
+    internal class RegenerateBundlesCommand : ConsoleCommand
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public RegenerateBundlesCommand()
+            : base("regenerate_bundles", $"Regenerate the game's community center bundle data. WARNING: this will reset all bundle progress, and may have unintended effects if you've already completed bundles. DO NOT USE THIS unless you're absolutely sure.\n\nUsage: regenerate_bundles confirm [<type>] [ignore_seed]\nRegenerate all bundles for this save. If the <type> is set to '{string.Join("' or '", Enum.GetNames(typeof(Game1.BundleType)))}', change the bundle type for the save. If an 'ignore_seed' option is included, remixed bundles are re-randomized without using the predetermined save seed.\n\nExample: regenerate_bundles remixed confirm") { }
+
+        /// <summary>Handle the command.</summary>
+        /// <param name="monitor">Writes messages to the console and log file.</param>
+        /// <param name="command">The command name.</param>
+        /// <param name="args">The command arguments.</param>
+        public override void Handle(IMonitor monitor, string command, ArgumentParser args)
+        {
+            // get flags
+            var bundleType = Game1.bundleType;
+            bool confirmed = false;
+            bool useSeed = true;
+            foreach (string arg in args)
+            {
+                if (arg.Equals("confirm", StringComparison.OrdinalIgnoreCase))
+                    confirmed = true;
+                else if (arg.Equals("ignore_seed", StringComparison.OrdinalIgnoreCase))
+                    useSeed = false;
+                else if (Enum.TryParse(arg, ignoreCase: true, out Game1.BundleType type))
+                    bundleType = type;
+                else
+                {
+                    monitor.Log($"Invalid option '{arg}'. Type 'help {command}' for usage.", LogLevel.Error);
+                    return;
+                }
+            }
+
+            // require confirmation
+            if (!confirmed)
+            {
+                monitor.Log($"WARNING: this may have unintended consequences (type 'help {command}' for details). Are you sure?", LogLevel.Warn);
+
+                string[] newArgs = args.Concat(new[] { "confirm" }).ToArray();
+                monitor.Log($"To confirm, enter this command: '{command} {string.Join(" ", newArgs)}'.", LogLevel.Info);
+                return;
+            }
+
+            // need a loaded save
+            if (!Context.IsWorldReady)
+            {
+                monitor.Log("You need to load a save to use this command.", LogLevel.Error);
+                return;
+            }
+
+            // regenerate bundles
+            Game1.bundleType = bundleType;
+            Game1.GenerateBundles(bundleType, use_seed: useSeed);
+            monitor.Log("Regenerated bundles and reset bundle progress.", LogLevel.Info);
+            monitor.Log("This may have unintended effects if you've already completed any bundles. If you're not sure, exit your game without saving to cancel.", LogLevel.Warn);
+        }
+    }
+}

From c39b2b17663f79da92f3d0abe8c01ea73187cbab Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 19 Mar 2021 20:16:13 -0400
Subject: [PATCH 130/856] update NPC pathfinding cache when map warps change

---
 docs/release-notes.md                     |  8 +++--
 src/SMAPI/Framework/ContentCoordinator.cs | 29 ++++++++++++++---
 src/SMAPI/Framework/SCore.cs              |  1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 38 ++++++++++++++++++-----
 4 files changed, 60 insertions(+), 16 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2ebf061e..4eb196b6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,9 +13,11 @@
   * Disabled aggressive memory optimization (added in 3.9.2) by default. The option reduces errors for a subset of players who use certain mods, but may cause crashes for farmhands in multiplayer. You can edit `smapi-internal/config.json` to enable it if you experience frequent `OutOfMemoryException` errors.
 
 * For mod authors:
-  * Added asset propagation for interior door sprites.
-  * Reduced performance impact of invalidating cached assets before a save is loaded.
-  * Fixed assets changed by a mod not reapplied if playing in non-English, the changes are only applicable after the save is loaded, the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
+  * Improved asset propagation:
+    * Added for interior door sprites.
+    * SMAPI now updates the NPC pathfinding cache when map warps are changed through the content API.
+    * Reduced performance impact of invalidating cached assets before a save is loaded.
+    * Fixed asset changes not reapplied in the edge case where you're playing in non-English, and the changes are only applied after the save is loaded, and the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
 
 ## 3.9.4
 Released 07 March 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 5d4855ef..2920e670 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -4,6 +4,7 @@ using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
 using System.IO;
 using System.Linq;
+using System.Text;
 using System.Threading;
 using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Content;
@@ -341,13 +342,31 @@ namespace StardewModdingAPI.Framework
             // reload core game assets
             if (removedAssets.Any())
             {
-                IDictionary<string, bool> propagated = this.CoreAssets.Propagate(removedAssets.ToDictionary(p => p.Key, p => p.Value), ignoreWorld: Context.IsWorldFullyUnloaded);
+                // propagate changes to the game
+                this.CoreAssets.Propagate(
+                    assets: removedAssets.ToDictionary(p => p.Key, p => p.Value),
+                    ignoreWorld: Context.IsWorldFullyUnloaded,
+                    out IDictionary<string, bool> propagated,
+                    out bool updatedNpcWarps
+                );
 
-                string[] invalidatedKeys = removedAssets.Keys.ToArray();
-                string[] propagatedKeys = propagated.Where(p => p.Value).Select(p => p.Key).ToArray();
+                // log summary
+                StringBuilder report = new StringBuilder();
+                {
+                    string[] invalidatedKeys = removedAssets.Keys.ToArray();
+                    string[] propagatedKeys = propagated.Where(p => p.Value).Select(p => p.Key).ToArray();
 
-                string FormatKeyList(IEnumerable<string> keys) => string.Join(", ", keys.OrderBy(p => p, StringComparer.OrdinalIgnoreCase));
-                this.Monitor.Log($"Invalidated {invalidatedKeys.Length} asset names ({FormatKeyList(invalidatedKeys)}); propagated {propagatedKeys.Length} core assets ({FormatKeyList(propagatedKeys)}).");
+                    string FormatKeyList(IEnumerable<string> keys) => string.Join(", ", keys.OrderBy(p => p, StringComparer.OrdinalIgnoreCase));
+
+                    report.AppendLine($"Invalidated {invalidatedKeys.Length} asset names ({FormatKeyList(invalidatedKeys)}).");
+                    report.AppendLine(propagated.Count > 0
+                        ? $"Propagated {propagatedKeys.Length} core assets ({FormatKeyList(propagatedKeys)})."
+                        : "Propagated 0 core assets."
+                    );
+                    if (updatedNpcWarps)
+                        report.AppendLine("Updated NPC pathfinding cache.");
+                }
+                this.Monitor.Log(report.ToString().TrimEnd());
             }
             else
                 this.Monitor.Log("Invalidated 0 cache entries.");
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 5df4b61b..e98dc04c 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -482,6 +482,7 @@ namespace StardewModdingAPI.Framework
                                     + ")"
                                 )
                         )
+                        + "."
                     );
 
                     // reload affected assets
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index debbaffd..52da3946 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -80,8 +80,9 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Reload one of the game's core assets (if applicable).</summary>
         /// <param name="assets">The asset keys and types to reload.</param>
         /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
-        /// <returns>Returns a lookup of asset names to whether they've been propagated.</returns>
-        public IDictionary<string, bool> Propagate(IDictionary<string, Type> assets, bool ignoreWorld)
+        /// <param name="propagatedAssets">A lookup of asset names to whether they've been propagated.</param>
+        /// <param name="updatedNpcWarps">Whether the NPC pathfinding cache was reloaded.</param>
+        public void Propagate(IDictionary<string, Type> assets, bool ignoreWorld, out IDictionary<string, bool> propagatedAssets, out bool updatedNpcWarps)
         {
             // group into optimized lists
             var buckets = assets.GroupBy(p =>
@@ -96,28 +97,36 @@ namespace StardewModdingAPI.Metadata
             });
 
             // reload assets
-            IDictionary<string, bool> propagated = assets.ToDictionary(p => p.Key, _ => false, StringComparer.OrdinalIgnoreCase);
+            propagatedAssets = assets.ToDictionary(p => p.Key, _ => false, StringComparer.OrdinalIgnoreCase);
+            updatedNpcWarps = false;
             foreach (var bucket in buckets)
             {
                 switch (bucket.Key)
                 {
                     case AssetBucket.Sprite:
                         if (!ignoreWorld)
-                            this.ReloadNpcSprites(bucket.Select(p => p.Key), propagated);
+                            this.ReloadNpcSprites(bucket.Select(p => p.Key), propagatedAssets);
                         break;
 
                     case AssetBucket.Portrait:
                         if (!ignoreWorld)
-                            this.ReloadNpcPortraits(bucket.Select(p => p.Key), propagated);
+                            this.ReloadNpcPortraits(bucket.Select(p => p.Key), propagatedAssets);
                         break;
 
                     default:
                         foreach (var entry in bucket)
-                            propagated[entry.Key] = this.PropagateOther(entry.Key, entry.Value, ignoreWorld);
+                        {
+                            bool changed = this.PropagateOther(entry.Key, entry.Value, ignoreWorld, out bool curChangedMapWarps);
+                            propagatedAssets[entry.Key] = changed;
+                            updatedNpcWarps = updatedNpcWarps || curChangedMapWarps;
+                        }
                         break;
                 }
             }
-            return propagated;
+
+            // reload NPC pathfinding cache if any map changed
+            if (updatedNpcWarps)
+                NPC.populateRoutesFromLocationToLocationList();
         }
 
 
@@ -128,12 +137,14 @@ namespace StardewModdingAPI.Metadata
         /// <param name="key">The asset key to reload.</param>
         /// <param name="type">The asset type to reload.</param>
         /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
+        /// <param name="changedWarps">Whether any map warps were changed as part of this propagation.</param>
         /// <returns>Returns whether an asset was loaded. The return value may be true or false, or a non-null value for true.</returns>
         [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These deliberately match the asset names.")]
-        private bool PropagateOther(string key, Type type, bool ignoreWorld)
+        private bool PropagateOther(string key, Type type, bool ignoreWorld, out bool changedWarps)
         {
             var content = this.MainContentManager;
             key = this.AssertAndNormalizeAssetName(key);
+            changedWarps = false;
 
             /****
             ** Special case: current map tilesheet
@@ -162,7 +173,18 @@ namespace StardewModdingAPI.Metadata
                     {
                         if (!string.IsNullOrWhiteSpace(location.mapPath.Value) && this.NormalizeAssetNameIgnoringEmpty(location.mapPath.Value) == key)
                         {
+                            static ISet<string> GetWarpSet(GameLocation location)
+                            {
+                                return new HashSet<string>(
+                                    location.warps.Select(p => $"{p.X} {p.Y} {p.TargetName} {p.TargetX} {p.TargetY}")
+                                );
+                            }
+
+                            var oldWarps = GetWarpSet(location);
                             this.ReloadMap(location);
+                            var newWarps = GetWarpSet(location);
+
+                            changedWarps = changedWarps || oldWarps.Count != newWarps.Count || oldWarps.Any(p => !newWarps.Contains(p));
                             anyChanged = true;
                         }
                     }

From c070e34c2f18a18d03dbe9f86f5d17491215b6e2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Mar 2021 00:44:42 -0400
Subject: [PATCH 131/856] fix double-localization issue in regenerated bundles

---
 .../Commands/Other/RegenerateBundles.cs       | 33 +++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
index d28abd13..9beedb96 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
@@ -1,6 +1,10 @@
 using System;
+using System.Collections.Generic;
 using System.Linq;
+using System.Reflection;
+using Netcode;
 using StardewValley;
+using StardewValley.Network;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
@@ -56,9 +60,34 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
                 return;
             }
 
+            // get private fields
+            IWorldState state = Game1.netWorldState.Value;
+            var bundleData = state.GetType().GetField("_bundleData", BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Instance)?.GetValue(state) as IDictionary<string, string>
+                ?? throw new InvalidOperationException("Can't access '_bundleData' field on world state.");
+            var netBundleData = state.GetType().GetField("netBundleData", BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Instance)?.GetValue(state) as NetStringDictionary<string, NetString>
+                ?? throw new InvalidOperationException("Can't access 'netBundleData' field on world state.");
+
+            // clear bundle data
+            state.BundleData.Clear();
+            state.Bundles.Clear();
+            state.BundleRewards.Clear();
+            bundleData.Clear();
+            netBundleData.Clear();
+
             // regenerate bundles
-            Game1.bundleType = bundleType;
-            Game1.GenerateBundles(bundleType, use_seed: useSeed);
+            var locale = LocalizedContentManager.CurrentLanguageCode;
+            try
+            {
+                LocalizedContentManager.CurrentLanguageCode = LocalizedContentManager.LanguageCode.en; // the base bundle data needs to be unlocalized (the game will add localized names later)
+
+                Game1.bundleType = bundleType;
+                Game1.GenerateBundles(bundleType, use_seed: useSeed);
+            }
+            finally
+            {
+                LocalizedContentManager.CurrentLanguageCode = locale;
+            }
+
             monitor.Log("Regenerated bundles and reset bundle progress.", LogLevel.Info);
             monitor.Log("This may have unintended effects if you've already completed any bundles. If you're not sure, exit your game without saving to cancel.", LogLevel.Warn);
         }

From d61bb78b2add425eb385931d36ab4b54e115d870 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Mar 2021 15:18:30 -0400
Subject: [PATCH 132/856] simplify creating keybind list for single key

---
 docs/release-notes.md              | 1 +
 src/SMAPI/Utilities/KeybindList.cs | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4eb196b6..075dfe4d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,6 +18,7 @@
     * SMAPI now updates the NPC pathfinding cache when map warps are changed through the content API.
     * Reduced performance impact of invalidating cached assets before a save is loaded.
     * Fixed asset changes not reapplied in the edge case where you're playing in non-English, and the changes are only applied after the save is loaded, and the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
+  * Added a second `KeybindList` constructor to simplify single-key default bindings.
 
 ## 3.9.4
 Released 07 March 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
index 1845285a..28cae240 100644
--- a/src/SMAPI/Utilities/KeybindList.cs
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -30,6 +30,11 @@ namespace StardewModdingAPI.Utilities
             this.IsBound = this.Keybinds.Any();
         }
 
+        /// <summary>Construct an instance.</summary>
+        /// <param name="singleKey">A single-key binding.</param>
+        public KeybindList(SButton singleKey)
+            : this(new Keybind(singleKey)) { }
+
         /// <summary>Parse a keybind list from a string, and throw an exception if it's not valid.</summary>
         /// <param name="input">The keybind string. See remarks on <see cref="ToString"/> for format details.</param>
         /// <exception cref="FormatException">The <paramref name="input"/> format is invalid.</exception>

From fdfb060795a0cca62bc98df97c28160160f4317a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 17 Mar 2021 20:36:31 -0400
Subject: [PATCH 133/856] remove unused code (#767)

---
 docs/technical/smapi.md                                   | 1 -
 src/SMAPI.Tests/SMAPI.Tests.csproj                        | 2 --
 src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs | 7 -------
 src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs         | 7 -------
 src/SMAPI.Web/SMAPI.Web.csproj                            | 2 --
 5 files changed, 19 deletions(-)

diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index e2832710..223e9c5b 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -50,7 +50,6 @@ environment variable | purpose
 `SMAPI_NO_TERMINAL` | Equivalent to `--no-terminal` above.
 `SMAPI_MODS_PATH` | Equivalent to `--mods-path` above.
 
-
 ### Compile flags
 SMAPI uses a small number of conditional compilation constants, which you can set by editing the
 `<DefineConstants>` element in `SMAPI.csproj`. Supported constants:
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 51fe32bf..00623b83 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -1,5 +1,4 @@
 <Project Sdk="Microsoft.NET.Sdk">
-
   <PropertyGroup>
     <AssemblyName>SMAPI.Tests</AssemblyName>
     <RootNamespace>SMAPI.Tests</RootNamespace>
@@ -33,5 +32,4 @@
   </ItemGroup>
 
   <Import Project="..\..\build\common.targets" />
-
 </Project>
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index b01d8b21..e635725c 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -89,13 +89,6 @@ namespace StardewModdingAPI.Toolkit.Framework
                 : "StardewValley.exe";
         }
 
-        /// <summary>Get whether the platform uses Mono.</summary>
-        /// <param name="platform">The current platform.</param>
-        public static bool IsMono(string platform)
-        {
-            return platform == nameof(Platform.Linux) || platform == nameof(Platform.Mac);
-        }
-
 
         /*********
         ** Private methods
diff --git a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
index 4ef578f7..62bd13cd 100644
--- a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
@@ -46,12 +46,5 @@ namespace StardewModdingAPI.Toolkit.Utilities
         {
             return LowLevelEnvironmentUtility.GetExecutableName(platform.ToString());
         }
-
-        /// <summary>Get whether the platform uses Mono.</summary>
-        /// <param name="platform">The current platform.</param>
-        public static bool IsMono(this Platform platform)
-        {
-            return LowLevelEnvironmentUtility.IsMono(platform.ToString());
-        }
     }
 }
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index 6f9f50f0..6cf8207f 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -1,5 +1,4 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
-
   <PropertyGroup>
     <AssemblyName>SMAPI.Web</AssemblyName>
     <RootNamespace>StardewModdingAPI.Web</RootNamespace>
@@ -47,5 +46,4 @@
   </ItemGroup>
 
   <Import Project="..\..\build\common.targets" />
-
 </Project>

From 73321eceb96f263f10857667d7b3726a5098e770 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 17 Mar 2021 20:36:31 -0400
Subject: [PATCH 134/856] split compile flag into separate Windows + XNA flags
 (#767)

---
 build/common.targets                          |  2 +-
 docs/technical/smapi.md                       |  3 ++-
 src/SMAPI.ModBuildConfig/build/smapi.targets  | 26 ++++++++++++-------
 .../SMAPI.Mods.ConsoleCommands.csproj         | 15 ++++++-----
 .../Patches/SpriteBatchValidationPatches.cs   |  4 +--
 .../SMAPI.Mods.ErrorHandler.csproj            | 15 ++++++-----
 .../SMAPI.Mods.SaveBackup.csproj              |  3 ++-
 src/SMAPI.Tests/SMAPI.Tests.csproj            |  4 +--
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj        |  2 ++
 src/SMAPI.Web/SMAPI.Web.csproj                |  4 +--
 src/SMAPI/Framework/InternalExtensions.cs     |  2 +-
 src/SMAPI/Framework/SCore.cs                  |  4 +--
 src/SMAPI/SMAPI.csproj                        | 17 +++++++-----
 13 files changed, 61 insertions(+), 40 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index d9d21466..21945321 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -9,7 +9,7 @@
 
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
-    <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
+    <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS;SMAPI_FOR_XNA</DefineConstants>
   </PropertyGroup>
 
   <!-- if game path is invalid, show one user-friendly error instead of a slew of reference errors -->
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 223e9c5b..e77d9d82 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -56,7 +56,8 @@ SMAPI uses a small number of conditional compilation constants, which you can se
 
 flag | purpose
 ---- | -------
-`SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled on Windows for players on Windows. Set automatically in `crossplatform.targets`.
+`SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/MacOS. Set automatically in `common.targets`.
+`SMAPI_FOR_XNA` | Whether SMAPI is being compiled for XNA Framework; if not set, the code assumes MonoGame. Set automatically in `common.targets` with the same value as `SMAPI_FOR_WINDOWS`.
 `HARMONY_2` | Whether to enable experimental Harmony 2.0 support and rewrite existing Harmony 1._x_ mods for compatibility. Note that you need to replace `build/0Harmony.dll` with a Harmony 2.0 build (or switch to a package reference) to use this flag.
 
 ## For SMAPI developers
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 65544b12..76a1536c 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -47,19 +47,27 @@
     <Reference Include="0Harmony" Condition="'$(EnableHarmony)' == 'true'" HintPath="$(GamePath)\smapi-internal\0Harmony.dll" Private="$(CopyModReferencesToBuildOutput)" />
   </ItemGroup>
 
-  <!-- Windows -->
+  <!-- Windows only -->
   <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
-    <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
-    <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
-    <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="$(CopyModReferencesToBuildOutput)" />
   </ItemGroup>
 
-  <!-- Linux/Mac -->
-  <ItemGroup Condition="'$(OS)' != 'Windows_NT'">
-    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(CopyModReferencesToBuildOutput)" />
-  </ItemGroup>
+  <!-- Game framework -->
+  <Choose>
+    <When Condition="$(DefineConstants.Contains(SMAPI_FOR_XNA))">
+      <ItemGroup>
+        <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
+        <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
+        <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
+        <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
+      </ItemGroup>
+    </When>
+    <Otherwise>
+      <ItemGroup>
+        <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(CopyModReferencesToBuildOutput)" />
+      </ItemGroup>
+    </Otherwise>
+  </Choose>
 
 
   <!--*********************************************
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index 1e3208de..2f5adc8a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -7,6 +7,8 @@
     <PlatformTarget>x86</PlatformTarget>
   </PropertyGroup>
 
+  <Import Project="..\..\build\common.targets" />
+
   <ItemGroup>
     <ProjectReference Include="..\SMAPI\SMAPI.csproj" Private="False" />
   </ItemGroup>
@@ -16,19 +18,21 @@
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
   </ItemGroup>
 
+  <!-- Windows only -->
+  <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
+  </ItemGroup>
+
+  <!-- Game framework -->
   <Choose>
-    <!-- Windows -->
-    <When Condition="$(OS) == 'Windows_NT'">
+    <When Condition="$(DefineConstants.Contains(SMAPI_FOR_XNA))">
       <ItemGroup>
-        <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
         <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
       </ItemGroup>
     </When>
-
-    <!-- Linux/Mac -->
     <Otherwise>
       <ItemGroup>
         <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
@@ -41,5 +45,4 @@
   </ItemGroup>
 
   <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
-  <Import Project="..\..\build\common.targets" />
 </Project>
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
index 95e4f5ef..f605b2ce 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
@@ -27,7 +27,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 #endif
         {
             harmony.Patch(
-#if SMAPI_FOR_WINDOWS
+#if SMAPI_FOR_XNA
                 original: AccessTools.Method(typeof(SpriteBatch), "InternalDraw"),
 #else
                 original: AccessTools.Method(typeof(SpriteBatch), "CheckValid", new[] { typeof(Texture2D) }),
@@ -40,7 +40,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
-#if SMAPI_FOR_WINDOWS
+#if SMAPI_FOR_XNA
         /// <summary>The method to call instead of <see cref="SpriteBatch.InternalDraw"/>.</summary>
         /// <param name="texture">The texture to validate.</param>
 #else
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 5c0cf952..e5ce8f5e 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -7,6 +7,8 @@
     <PlatformTarget>x86</PlatformTarget>
   </PropertyGroup>
 
+  <Import Project="..\..\build\common.targets" />
+
   <ItemGroup>
     <ProjectReference Include="..\SMAPI\SMAPI.csproj" Private="False" />
     <Reference Include="..\..\build\0Harmony.dll" Private="False" />
@@ -16,19 +18,21 @@
     <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
   </ItemGroup>
 
+  <!-- Windows only -->
+  <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
+  </ItemGroup>
+
+  <!-- Game framework -->
   <Choose>
-    <!-- Windows -->
-    <When Condition="$(OS) == 'Windows_NT'">
+    <When Condition="$(DefineConstants.Contains(SMAPI_FOR_XNA))">
       <ItemGroup>
-        <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
         <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
       </ItemGroup>
     </When>
-
-    <!-- Linux/Mac -->
     <Otherwise>
       <ItemGroup>
         <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
@@ -42,5 +46,4 @@
   </ItemGroup>
 
   <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
-  <Import Project="..\..\build\common.targets" />
 </Project>
diff --git a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
index 98a3f0cc..a30c2c1d 100644
--- a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
+++ b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
@@ -7,6 +7,8 @@
     <PlatformTarget>x86</PlatformTarget>
   </PropertyGroup>
 
+  <Import Project="..\..\build\common.targets" />
+
   <ItemGroup>
     <ProjectReference Include="..\SMAPI\SMAPI.csproj" Private="False" />
   </ItemGroup>
@@ -20,5 +22,4 @@
   </ItemGroup>
 
   <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
-  <Import Project="..\..\build\common.targets" />
 </Project>
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 00623b83..f08b69ed 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -8,6 +8,8 @@
     <PlatformTarget>x86</PlatformTarget>
   </PropertyGroup>
 
+  <Import Project="..\..\build\common.targets" />
+
   <ItemGroup>
     <ProjectReference Include="..\SMAPI.Toolkit.CoreInterfaces\SMAPI.Toolkit.CoreInterfaces.csproj" />
     <ProjectReference Include="..\SMAPI.Toolkit\SMAPI.Toolkit.csproj" />
@@ -30,6 +32,4 @@
   <ItemGroup>
     <Service Include="{82A7F48D-3B50-4B1E-B82E-3ADA8210C358}" />
   </ItemGroup>
-
-  <Import Project="..\..\build\common.targets" />
 </Project>
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 3fc9de58..986a5f04 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -7,6 +7,8 @@
     <PlatformTarget Condition="'$(TargetFramework)' == 'net4.5'">x86</PlatformTarget>
   </PropertyGroup>
 
+  <Import Project="..\..\build\common.targets" />
+
   <ItemGroup>
     <PackageReference Include="HtmlAgilityPack" Version="1.11.28" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index 6cf8207f..ce5ffdbd 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -6,6 +6,8 @@
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
 
+  <Import Project="..\..\build\common.targets" />
+
   <ItemGroup>
     <Content Remove="aws-beanstalk-tools-defaults.json" />
   </ItemGroup>
@@ -44,6 +46,4 @@
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
   </ItemGroup>
-
-  <Import Project="..\..\build\common.targets" />
 </Project>
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index ba1879da..449aa2b7 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -181,7 +181,7 @@ namespace StardewModdingAPI.Framework
         {
             // get field name
             const string fieldName =
-#if SMAPI_FOR_WINDOWS
+#if SMAPI_FOR_XNA
                 "inBeginEndPair";
 #else
                 "_beginCalled";
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index e98dc04c..c758a793 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -12,7 +12,7 @@ using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Xna.Framework;
-#if SMAPI_FOR_WINDOWS
+#if SMAPI_FOR_XNA
 using System.Windows.Forms;
 #endif
 using Newtonsoft.Json;
@@ -217,7 +217,7 @@ namespace StardewModdingAPI.Framework
                     this.Toolkit.JsonHelper.JsonSettings.Converters.Add(converter);
 
                 // add error handlers
-#if SMAPI_FOR_WINDOWS
+#if SMAPI_FOR_XNA
                 Application.ThreadException += (sender, e) => this.Monitor.Log($"Critical thread exception: {e.Exception.GetLogSummary()}", LogLevel.Error);
                 Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);
 #endif
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 6344cb2f..ceef33df 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -12,6 +12,8 @@
     <ApplicationIcon>icon.ico</ApplicationIcon>
   </PropertyGroup>
 
+  <Import Project="..\..\build\common.targets" />
+
   <ItemGroup>
     <PackageReference Include="LargeAddressAware" Version="1.0.5" />
     <PackageReference Include="Mono.Cecil" Version="0.11.3" />
@@ -30,20 +32,22 @@
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
 
+  <!-- Windows only -->
+  <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
+    <Reference Include="System.Windows.Forms" />
+  </ItemGroup>
+
+  <!-- Game framework -->
   <Choose>
-    <!-- Windows -->
-    <When Condition="$(OS) == 'Windows_NT'">
+    <When Condition="$(DefineConstants.Contains(SMAPI_FOR_XNA))">
       <ItemGroup>
-        <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
         <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
         <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="System.Windows.Forms" />
       </ItemGroup>
     </When>
-
-    <!-- Linux/Mac -->
     <Otherwise>
       <ItemGroup>
         <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
@@ -67,5 +71,4 @@
   </ItemGroup>
 
   <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
-  <Import Project="..\..\build\common.targets" />
 </Project>

From ca67dcc920560f3fd19a4531c40fdb03d19e96c5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 17 Mar 2021 20:36:32 -0400
Subject: [PATCH 135/856] add Constants.GameFramework field (#767)

---
 docs/release-notes.md                         |  2 +
 .../Patches/SpriteBatchValidationPatches.cs   |  8 +-
 src/SMAPI/Constants.cs                        | 99 +++++++++++++------
 src/SMAPI/Framework/Content/ContentCache.cs   |  2 +-
 src/SMAPI/Framework/InternalExtensions.cs     | 11 +--
 src/SMAPI/Framework/Logging/LogManager.cs     |  7 +-
 .../Framework/ModLoading/AssemblyLoader.cs    |  5 +-
 src/SMAPI/Framework/SCore.cs                  |  2 +-
 src/SMAPI/GameFramework.cs                    | 12 +++
 9 files changed, 98 insertions(+), 50 deletions(-)
 create mode 100644 src/SMAPI/GameFramework.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 075dfe4d..728b50c0 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -19,6 +19,8 @@
     * Reduced performance impact of invalidating cached assets before a save is loaded.
     * Fixed asset changes not reapplied in the edge case where you're playing in non-English, and the changes are only applied after the save is loaded, and the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
   * Added a second `KeybindList` constructor to simplify single-key default bindings.
+  * Added a `Constants.GameFramework` field which indicates whether the game is using XNA Framework or MonoGame.  
+    _Note: mods don't need to handle the difference in most cases, but some players may use MonoGame on Windows in upcoming versions. Mods which use the `Constants.TargetPlatform` should review usages to determine whether they're actually checking the platform or the game framework._
 
 ## 3.9.4
 Released 07 March 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
index f605b2ce..8056fd71 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
@@ -27,11 +27,9 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 #endif
         {
             harmony.Patch(
-#if SMAPI_FOR_XNA
-                original: AccessTools.Method(typeof(SpriteBatch), "InternalDraw"),
-#else
-                original: AccessTools.Method(typeof(SpriteBatch), "CheckValid", new[] { typeof(Texture2D) }),
-#endif
+                original: Constants.GameFramework == GameFramework.Xna
+                    ? AccessTools.Method(typeof(SpriteBatch), "InternalDraw")
+                    : AccessTools.Method(typeof(SpriteBatch), "CheckValid", new[] { typeof(Texture2D) }),
                 postfix: new HarmonyMethod(this.GetType(), nameof(SpriteBatchValidationPatches.After_SpriteBatch_CheckValid))
             );
         }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 0de2b12f..ec5cbe17 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Reflection;
@@ -37,6 +38,14 @@ namespace StardewModdingAPI
         /// <summary>The target game platform.</summary>
         internal static GamePlatform Platform { get; } = (GamePlatform)Enum.Parse(typeof(GamePlatform), LowLevelEnvironmentUtility.DetectPlatform());
 
+        /// <summary>The game framework running the game.</summary>
+        internal static GameFramework GameFramework { get; } =
+#if SMAPI_FOR_XNA
+            GameFramework.Xna;
+#else
+            GameFramework.MonoGame;
+#endif
+
         /// <summary>The game's assembly name.</summary>
         internal static string GameAssemblyName => EarlyConstants.Platform == GamePlatform.Windows ? "Stardew Valley" : "StardewValley";
 
@@ -65,6 +74,9 @@ namespace StardewModdingAPI
         /// <summary>The target game platform.</summary>
         public static GamePlatform TargetPlatform { get; } = EarlyConstants.Platform;
 
+        /// <summary>The game framework running the game.</summary>
+        public static GameFramework GameFramework { get; } = EarlyConstants.GameFramework;
+
         /// <summary>The path to the game folder.</summary>
         public static string ExecutionPath { get; } = EarlyConstants.ExecutionPath;
 
@@ -208,56 +220,79 @@ namespace StardewModdingAPI
 
         /// <summary>Get metadata for mapping assemblies to the current platform.</summary>
         /// <param name="targetPlatform">The target game platform.</param>
-        internal static PlatformAssemblyMap GetAssemblyMap(Platform targetPlatform)
+        /// <param name="framework">The game framework running the game.</param>
+        internal static PlatformAssemblyMap GetAssemblyMap(Platform targetPlatform, GameFramework framework)
         {
-            // get assembly changes needed for platform
-            string[] removeAssemblyReferences;
-            Assembly[] targetAssemblies;
+            var removeAssemblyReferences = new List<string>();
+            var targetAssemblies = new List<Assembly>();
+
+            // get assembly renamed in SMAPI 3.0
+            removeAssemblyReferences.Add("StardewModdingAPI.Toolkit.CoreInterfaces");
+            targetAssemblies.Add(typeof(StardewModdingAPI.IManifest).Assembly);
+
+            // get changes for platform
             switch (targetPlatform)
             {
                 case Platform.Linux:
                 case Platform.Mac:
-                    removeAssemblyReferences = new[]
+                    removeAssemblyReferences.AddRange(new[]
                     {
                         "Netcode",
-                        "Stardew Valley",
-                        "Microsoft.Xna.Framework",
-                        "Microsoft.Xna.Framework.Game",
-                        "Microsoft.Xna.Framework.Graphics",
-                        "Microsoft.Xna.Framework.Xact",
-                        "StardewModdingAPI.Toolkit.CoreInterfaces" // renamed in SMAPI 3.0
-                    };
-                    targetAssemblies = new[]
-                    {
-                        typeof(StardewValley.Game1).Assembly, // note: includes Netcode types on Linux/Mac
-                        typeof(Microsoft.Xna.Framework.Vector2).Assembly,
-                        typeof(StardewModdingAPI.IManifest).Assembly
-                    };
+                        "Stardew Valley"
+                    });
+                    targetAssemblies.Add(
+                        typeof(StardewValley.Game1).Assembly // note: includes Netcode types on Linux/Mac
+                    );
                     break;
 
                 case Platform.Windows:
-                    removeAssemblyReferences = new[]
-                    {
-                        "StardewValley",
-                        "MonoGame.Framework",
-                        "StardewModdingAPI.Toolkit.CoreInterfaces" // renamed in SMAPI 3.0
-                    };
-                    targetAssemblies = new[]
+                    removeAssemblyReferences.Add(
+                        "StardewValley"
+                    );
+                    targetAssemblies.AddRange(new[]
                     {
                         typeof(Netcode.NetBool).Assembly,
-                        typeof(StardewValley.Game1).Assembly,
-                        typeof(Microsoft.Xna.Framework.Vector2).Assembly,
-                        typeof(Microsoft.Xna.Framework.Game).Assembly,
-                        typeof(Microsoft.Xna.Framework.Graphics.SpriteBatch).Assembly,
-                        typeof(StardewModdingAPI.IManifest).Assembly
-                    };
+                        typeof(StardewValley.Game1).Assembly
+                    });
                     break;
 
                 default:
                     throw new InvalidOperationException($"Unknown target platform '{targetPlatform}'.");
             }
 
-            return new PlatformAssemblyMap(targetPlatform, removeAssemblyReferences, targetAssemblies);
+            // get changes for game framework
+            switch (framework)
+            {
+                case GameFramework.MonoGame:
+                    removeAssemblyReferences.AddRange(new[]
+                    {
+                        "Microsoft.Xna.Framework",
+                        "Microsoft.Xna.Framework.Game",
+                        "Microsoft.Xna.Framework.Graphics",
+                        "Microsoft.Xna.Framework.Xact"
+                    });
+                    targetAssemblies.Add(
+                        typeof(Microsoft.Xna.Framework.Vector2).Assembly
+                    );
+                    break;
+
+                case GameFramework.Xna:
+                    removeAssemblyReferences.Add(
+                        "MonoGame.Framework"
+                    );
+                    targetAssemblies.AddRange(new[]
+                    {
+                        typeof(Microsoft.Xna.Framework.Vector2).Assembly,
+                        typeof(Microsoft.Xna.Framework.Game).Assembly,
+                        typeof(Microsoft.Xna.Framework.Graphics.SpriteBatch).Assembly
+                    });
+                    break;
+
+                default:
+                    throw new InvalidOperationException($"Unknown game framework '{framework}'.");
+            }
+
+            return new PlatformAssemblyMap(targetPlatform, removeAssemblyReferences.ToArray(), targetAssemblies.ToArray());
         }
 
 
diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index af65e07e..7edc9ab9 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI.Framework.Content
             this.Cache = reflection.GetField<Dictionary<string, object>>(contentManager, "loadedAssets").GetValue();
 
             // get key normalization logic
-            if (Constants.Platform == Platform.Windows)
+            if (Constants.GameFramework == GameFramework.Xna)
             {
                 IReflectedMethod method = reflection.GetMethod(typeof(TitleContainer), "GetCleanPath");
                 this.NormalizeAssetNameForPlatform = path => method.Invoke<string>(path);
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index 449aa2b7..ab7f1e6c 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -179,15 +179,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="reflection">The reflection helper with which to access private fields.</param>
         public static bool IsOpen(this SpriteBatch spriteBatch, Reflector reflection)
         {
-            // get field name
-            const string fieldName =
-#if SMAPI_FOR_XNA
-                "inBeginEndPair";
-#else
-                "_beginCalled";
-#endif
+            string fieldName = Constants.GameFramework == GameFramework.Xna
+                ? "inBeginEndPair"
+                : "_beginCalled";
 
-            // get result
             return reflection.GetField<bool>(Game1.spriteBatch, fieldName).GetValue();
         }
     }
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 0dd45355..243ca3ae 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -283,8 +283,13 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="customSettings">The custom SMAPI settings.</param>
         public void LogIntro(string modsPath, IDictionary<string, object> customSettings)
         {
+            // get platform label
+            string platformLabel = EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform);
+            if ((Constants.GameFramework == GameFramework.Xna) != (Constants.Platform == Platform.Windows))
+                platformLabel += $" with {Constants.GameFramework}";
+
             // init logging
-            this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
+            this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {platformLabel}", LogLevel.Info);
             this.Monitor.Log($"Mods go here: {modsPath}", LogLevel.Info);
             if (modsPath != Constants.DefaultModsPath)
                 this.Monitor.Log("(Using custom --mods-path argument.)");
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 69535aa5..3606eb66 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -46,15 +46,16 @@ namespace StardewModdingAPI.Framework.ModLoading
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="targetPlatform">The current game platform.</param>
+        /// <param name="framework">The game framework running the game.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
         /// <param name="paranoidMode">Whether to detect paranoid mode issues.</param>
         /// <param name="rewriteMods">Whether to rewrite mods for compatibility.</param>
-        public AssemblyLoader(Platform targetPlatform, IMonitor monitor, bool paranoidMode, bool rewriteMods)
+        public AssemblyLoader(Platform targetPlatform, GameFramework framework, IMonitor monitor, bool paranoidMode, bool rewriteMods)
         {
             this.Monitor = monitor;
             this.ParanoidMode = paranoidMode;
             this.RewriteMods = rewriteMods;
-            this.AssemblyMap = this.TrackForDisposal(Constants.GetAssemblyMap(targetPlatform));
+            this.AssemblyMap = this.TrackForDisposal(Constants.GetAssemblyMap(targetPlatform, framework));
 
             // init resolver
             this.AssemblyDefinitionResolver = this.TrackForDisposal(new AssemblyDefinitionResolver());
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c758a793..ebb21555 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1410,7 +1410,7 @@ namespace StardewModdingAPI.Framework
 
             // load mods
             IList<IModMetadata> skippedMods = new List<IModMetadata>();
-            using (AssemblyLoader modAssemblyLoader = new AssemblyLoader(Constants.Platform, this.Monitor, this.Settings.ParanoidWarnings, this.Settings.RewriteMods))
+            using (AssemblyLoader modAssemblyLoader = new AssemblyLoader(Constants.Platform, Constants.GameFramework, this.Monitor, this.Settings.ParanoidWarnings, this.Settings.RewriteMods))
             {
                 // init
                 HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
diff --git a/src/SMAPI/GameFramework.cs b/src/SMAPI/GameFramework.cs
new file mode 100644
index 00000000..7670ce8f
--- /dev/null
+++ b/src/SMAPI/GameFramework.cs
@@ -0,0 +1,12 @@
+namespace StardewModdingAPI
+{
+    /// <summary>The game framework running the game.</summary>
+    public enum GameFramework
+    {
+        /// <summary>The XNA Framework on Windows.</summary>
+        Xna,
+
+        /// <summary>The MonoGame framework, usually on non-Windows platforms.</summary>
+        MonoGame
+    }
+}

From b93e3cf522ebcc8711a8662a17cca1d034752269 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 17 Mar 2021 20:36:32 -0400
Subject: [PATCH 136/856] Drop hardcoded 32-bit restrictions on most SMAPI
 assemblies (#767)

SMAPI itself needs to be 32-bit to avoid errors trying to load the 32-bit game.
---
 src/SMAPI.Installer/SMAPI.Installer.csproj                       | 1 -
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj             | 1 -
 src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj | 1 -
 src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj       | 1 -
 src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj           | 1 -
 src/SMAPI.Tests/SMAPI.Tests.csproj                               | 1 -
 .../SMAPI.Toolkit.CoreInterfaces.csproj                          | 1 -
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj                           | 1 -
 8 files changed, 8 deletions(-)

diff --git a/src/SMAPI.Installer/SMAPI.Installer.csproj b/src/SMAPI.Installer/SMAPI.Installer.csproj
index 44ed3bd1..1777be5f 100644
--- a/src/SMAPI.Installer/SMAPI.Installer.csproj
+++ b/src/SMAPI.Installer/SMAPI.Installer.csproj
@@ -4,7 +4,6 @@
     <Description>The SMAPI installer for players.</Description>
     <TargetFramework>net45</TargetFramework>
     <OutputType>Exe</OutputType>
-    <PlatformTarget>x86</PlatformTarget>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
 
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 1813f58b..5992fbbf 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -3,7 +3,6 @@
     <!--build-->
     <RootNamespace>StardewModdingAPI.ModBuildConfig</RootNamespace>
     <TargetFramework>net45</TargetFramework>
-    <PlatformTarget>x86</PlatformTarget>
     <LangVersion>latest</LangVersion>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index 2f5adc8a..a187c1ff 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -4,7 +4,6 @@
     <RootNamespace>StardewModdingAPI.Mods.ConsoleCommands</RootNamespace>
     <TargetFramework>net45</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
-    <PlatformTarget>x86</PlatformTarget>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index e5ce8f5e..788f6f16 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -4,7 +4,6 @@
     <RootNamespace>StardewModdingAPI.Mods.ErrorHandler</RootNamespace>
     <TargetFramework>net45</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
-    <PlatformTarget>x86</PlatformTarget>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
diff --git a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
index a30c2c1d..a6f76781 100644
--- a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
+++ b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
@@ -4,7 +4,6 @@
     <RootNamespace>StardewModdingAPI.Mods.SaveBackup</RootNamespace>
     <TargetFramework>net45</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
-    <PlatformTarget>x86</PlatformTarget>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index f08b69ed..a0e5b2df 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -5,7 +5,6 @@
     <TargetFramework>net45</TargetFramework>
     <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
     <LangVersion>latest</LangVersion>
-    <PlatformTarget>x86</PlatformTarget>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
index 2bddc46a..d36a1882 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
+++ b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
@@ -4,7 +4,6 @@
     <Description>Provides toolkit interfaces which are available to SMAPI mods.</Description>
     <TargetFrameworks>net4.5;netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    <PlatformTarget Condition="'$(TargetFramework)' == 'net4.5'">x86</PlatformTarget>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 986a5f04..d8e32acf 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -4,7 +4,6 @@
     <Description>A library which encapsulates mod-handling logic for mod managers and tools. Not intended for use by mods.</Description>
     <TargetFrameworks>net4.5;netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    <PlatformTarget Condition="'$(TargetFramework)' == 'net4.5'">x86</PlatformTarget>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />

From 74215e844ae2af0075e5df3ab6a5f58efff4f981 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 21 Mar 2021 16:37:43 -0400
Subject: [PATCH 137/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 14 ++++++++++----
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 21945321..d680fa74 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -4,7 +4,7 @@
 
   <!--set properties -->
   <PropertyGroup>
-    <Version>3.9.4</Version>
+    <Version>3.9.5</Version>
     <Product>SMAPI</Product>
 
     <LangVersion>latest</LangVersion>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 728b50c0..ad644532 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,10 +7,16 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.9.5
+Released 21 March 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
-  * Added `regenerate_bundles` console command to reset community center bundles if they're corrupted by a bug _(in Console Commands)_.
-  * Disabled aggressive memory optimization (added in 3.9.2) by default. The option reduces errors for a subset of players who use certain mods, but may cause crashes for farmhands in multiplayer. You can edit `smapi-internal/config.json` to enable it if you experience frequent `OutOfMemoryException` errors.
+  * Added console command to reset community center bundles _(in Console Commands)_.
+  * Disabled aggressive memory optimization by default.  
+    _The option was added in SMAPI 3.9.2 to reduce errors for some players, but it can cause multiplayer crashes with some mods. If you often see `OutOfMemoryException` errors, you can edit `smapi-internal/config.json` to re-enable it. We're experimenting with making Stardew Valley 64-bit to address memory issues more systematically._
+  * Fixed bundles corrupted in non-English saves created after SMAPI 3.9.2.  
+    _If you have an affected save, you can load your save and then enter the `regenerate_bundles confirm` command in the SMAPI console to fix it._
+  * Internal changes to prepare for unofficial 64-bit.
 
 * For mod authors:
   * Improved asset propagation:
@@ -20,7 +26,7 @@
     * Fixed asset changes not reapplied in the edge case where you're playing in non-English, and the changes are only applied after the save is loaded, and the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
   * Added a second `KeybindList` constructor to simplify single-key default bindings.
   * Added a `Constants.GameFramework` field which indicates whether the game is using XNA Framework or MonoGame.  
-    _Note: mods don't need to handle the difference in most cases, but some players may use MonoGame on Windows in upcoming versions. Mods which use the `Constants.TargetPlatform` should review usages to determine whether they're actually checking the platform or the game framework._
+    _Note: mods don't need to handle the difference in most cases, but some players may use MonoGame on Windows in upcoming versions. Mods which check `Constants.TargetPlatform` should review usages as needed._
 
 ## 3.9.4
 Released 07 March 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 2811a11c..65c66d33 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.9.4",
+    "Version": "3.9.5",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.9.4"
+    "MinimumApiVersion": "3.9.5"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 52bf4f6a..1e810113 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.9.4",
+    "Version": "3.9.5",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.9.4"
+    "MinimumApiVersion": "3.9.5"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index b88582ba..ced7888a 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.9.4",
+    "Version": "3.9.5",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.9.4"
+    "MinimumApiVersion": "3.9.5"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index ec5cbe17..8b0c952d 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -63,7 +63,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.4");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.5");
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");

From 551153bb00c8a3a448db4b3a059e8322108b772a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 30 Mar 2021 20:10:55 -0400
Subject: [PATCH 138/856] prepare mod build package for 64-bit SMAPI (#767)

---
 build/find-game-folder.targets                |  4 ++++
 docs/technical/mod-package.md                 | 24 +++++++++++++++++++
 .../SMAPI.ModBuildConfig.csproj               |  5 ----
 src/SMAPI.ModBuildConfig/build/smapi.targets  | 21 ++++++++++++----
 4 files changed, 44 insertions(+), 10 deletions(-)

diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index 0a766ad4..ec8a3787 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -44,7 +44,11 @@
 
   <!-- set game metadata -->
   <PropertyGroup>
+    <!--standard executable name-->
     <GameExecutableName>Stardew Valley</GameExecutableName>
     <GameExecutableName Condition="$(OS) != 'Windows_NT'">StardewValley</GameExecutableName>
+
+    <!--Linux install on Windows (for 64-bit hack)-->
+    <GameExecutableName Condition="$(OS) == 'Windows_NT' AND !Exists('$(GamePath)\$(GameExecutableName).exe') AND Exists('$(GamePath)\StardewValley.exe')">StardewValley</GameExecutableName>
   </PropertyGroup>
 </Project>
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index f7475e37..d89f86c9 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -135,6 +135,15 @@ The absolute path to the folder containing the game's installed mods (defaults t
 The filename for the game's executable (i.e. `StardewValley.exe` on Linux/Mac or
 `Stardew Valley.exe` on Windows). This is auto-detected, and you should almost never change this.
 
+</td>
+</tr>
+<tr>
+<td><code>GameFramework</code></td>
+<td>
+
+The game framework for which the mod is being compiled (one of `Xna` or `MonoGame`). This is
+auto-detected based on the platform, and you should almost never change this.
+
 </td>
 </tr>
 </table>
@@ -291,6 +300,15 @@ Warning text:
 
 Your code accesses a field which is obsolete or no longer works. Use the suggested field instead.
 
+### Wrong processor architecture
+Warning text:
+> The target platform should be set to 'Any CPU' for compatibility with both 32-bit and 64-bit
+> versions of Stardew Valley (currently set to '{{current platform}}').
+
+Mods can be used in either 32-bit or 64-bit mode. Your project's target platform isn't set to the
+default 'Any CPU', so it won't work in both. You can fix it by [setting the target platform to
+'Any CPU'](https://docs.microsoft.com/en-ca/visualstudio/ide/how-to-configure-projects-to-target-platforms).
+
 ## FAQs
 ### How do I set the game path?<span id="custom-game-path"></span>
 The package detects where your game is installed automatically, so you usually don't need to set it
@@ -347,6 +365,12 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
+## Upcoming release
+* Added a build warning when the mod isn't compiled for `Any CPU`.
+* Added a `GameFramework` build property set to `MonoGame` or `Xna` based on the platform. This can be overridden to change which framework it references.
+* Added support for building mods against the 64-bit Linux version of the game on Windows.
+* The package now suppresses the misleading 'processor architecture mismatch' warnings.
+
 ## 3.2.2
 Released 23 September 2020.
 
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 5992fbbf..2d15678c 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -15,10 +15,6 @@
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <PackageIcon>images/icon.png</PackageIcon>
     <PackageProjectUrl>https://smapi.io/package/readme</PackageProjectUrl>
-    <PackageReleaseNotes>
-      - Reworked and streamlined how the package is compiled.
-      - Added SMAPI-ModTranslationClassBuilder files to the ignore list.
-    </PackageReleaseNotes>
     <IncludeBuildOutput>false</IncludeBuildOutput>
   </PropertyGroup>
 
@@ -48,5 +44,4 @@
     <None PackagePath="build/Pathoschild.Stardew.ModBuildConfig.targets" Include="build\smapi.targets" Pack="true" />
     <None PackagePath="images/icon.png" Include="assets\nuget-icon.png" Pack="true" />
   </ItemGroup>
-
 </Project>
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 76a1536c..698765ad 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -15,6 +15,9 @@
     <!-- recognise XNA Framework DLLs in the GAC (only affects mods using new csproj format) -->
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
 
+    <!-- suppress processor architecture mismatch warning (mods should be compiled in 'Any CPU' so they work in both 32-bit and 64-bit mode) -->
+    <ResolveAssemblyWarnOrErrorOnTargetArchitectureMismatch>None</ResolveAssemblyWarnOrErrorOnTargetArchitectureMismatch>
+
     <!-- set default package options -->
     <ModFolderName Condition="'$(ModFolderName)' == ''">$(MSBuildProjectName)</ModFolderName>
     <ModZipPath Condition="'$(ModZipPath)' == ''">$(TargetDir)</ModZipPath>
@@ -24,6 +27,9 @@
     <EnableHarmony Condition="'$(EnableHarmony)' == ''">false</EnableHarmony>
     <EnableGameDebugging Condition="'$(EnableGameDebugging)' == ''">true</EnableGameDebugging>
     <CopyModReferencesToBuildOutput Condition="'$(CopyModReferencesToBuildOutput)' == '' OR ('$(CopyModReferencesToBuildOutput)' != 'true' AND '$(CopyModReferencesToBuildOutput)' != 'false')">false</CopyModReferencesToBuildOutput>
+
+    <GameFramework Condition="'$(GameFramework)' == '' AND '$(OS)' == 'Windows_NT'">Xna</GameFramework>
+    <GameFramework Condition="'$(GameFramework)' == ''">MonoGame</GameFramework>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(OS)' == 'Windows_NT' AND '$(EnableGameDebugging)' == 'true'">
@@ -54,7 +60,7 @@
 
   <!-- Game framework -->
   <Choose>
-    <When Condition="$(DefineConstants.Contains(SMAPI_FOR_XNA))">
+    <When Condition="'$(GameFramework)' == 'Xna'">
       <ItemGroup>
         <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
         <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
@@ -71,14 +77,19 @@
 
 
   <!--*********************************************
-  ** Show friendly error for invalid OS or game path
+  ** Show validation messages
   **********************************************-->
   <Target Name="BeforeBuild">
+    <!-- unknown OS type -->
     <Error Condition="'$(OS)' != 'OSX' AND '$(OS)' != 'Unix' AND '$(OS)' != 'Windows_NT'" Text="The mod build package doesn't recognise OS type '$(OS)'." />
 
-    <Error Condition="!Exists('$(GamePath)')" Text="The mod build package can't find your game folder. You can specify where to find it; see https://smapi.io/package/custom-game-path." />
-    <Error Condition="!Exists('$(GamePath)\$(GameExecutableName).exe')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain the $(GameExecutableName) file. If this folder is invalid, delete it and the package will autodetect another game install path." />
-    <Error Condition="!Exists('$(GamePath)\StardewModdingAPI.exe')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain SMAPI. You need to install SMAPI before building the mod." />
+    <!-- invalid game path -->
+    <Error Condition="!Exists('$(GamePath)')" Text="The mod build package can't find your game folder. You can specify where to find it; see https://smapi.io/package/custom-game-path." ContinueOnError="false" />
+    <Error Condition="!Exists('$(GamePath)\$(GameExecutableName).exe')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain the $(GameExecutableName) file. If this folder is invalid, delete it and the package will autodetect another game install path." ContinueOnError="false" />
+    <Error Condition="!Exists('$(GamePath)\StardewModdingAPI.exe')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain SMAPI. You need to install SMAPI before building the mod." ContinueOnError="false" />
+
+    <!-- invalid target architecture (note: internal value is 'AnyCPU', value shown in Visual Studio is 'Any CPU') -->
+    <Warning Condition="'$(Platform)' != 'AnyCPU'" Text="The target platform should be set to 'Any CPU' for compatibility with both 32-bit and 64-bit versions of Stardew Valley (currently set to '$(Platform)'). See https://smapi.io/package/wrong-processor-architecture for details." HelpLink="https://smapi.io/package/wrong-processor-architecture" />
   </Target>
 
 

From 58dde207afe2d99a5f4c047334a79acdd312ec58 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 30 Mar 2021 20:11:49 -0400
Subject: [PATCH 139/856] prepare for release

---
 docs/technical/mod-package.md                        | 4 +++-
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index d89f86c9..8c9c59fb 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -365,7 +365,9 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
-## Upcoming release
+## 3.3
+Released 30 March 2021.
+
 * Added a build warning when the mod isn't compiled for `Any CPU`.
 * Added a `GameFramework` build property set to `MonoGame` or `Xna` based on the platform. This can be overridden to change which framework it references.
 * Added support for building mods against the 64-bit Linux version of the game on Windows.
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 2d15678c..b18e79d5 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -9,7 +9,7 @@
     <!--NuGet package-->
     <PackageId>Pathoschild.Stardew.ModBuildConfig</PackageId>
     <Title>Build package for SMAPI mods</Title>
-    <Version>3.2.2</Version>
+    <Version>3.3.0</Version>
     <Authors>Pathoschild</Authors>
     <Description>Automates the build configuration for crossplatform Stardew Valley SMAPI mods. For SMAPI 3.0 or later.</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>

From 0d5b4e9983dd30fc7c586c22d69d54cd44e7a627 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 2 Apr 2021 20:13:23 -0400
Subject: [PATCH 140/856] update resource clump logic for SDV 1.5 (#770)

---
 docs/release-notes.md                         |  4 ++++
 .../Framework/Commands/World/ClearCommand.cs  | 20 +++++++++----------
 2 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ad644532..3d505b8b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
+
 ## 3.9.5
 Released 21 March 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index 4b0e45a0..4cfaf242 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using System.Linq;
 using StardewValley;
 using StardewValley.Locations;
@@ -224,18 +223,17 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         {
             int removed = 0;
 
-            // get resource clumps
-            IList<ResourceClump> resourceClumps =
-                (location as Farm)?.resourceClumps
-                ?? (IList<ResourceClump>)(location as Woods)?.stumps
-                ?? new List<ResourceClump>();
-
-            // remove matching clumps
-            foreach (var clump in resourceClumps.ToArray())
+            foreach (var clump in location.resourceClumps.Where(shouldRemove).ToArray())
             {
-                if (shouldRemove(clump))
+                location.resourceClumps.Remove(clump);
+                removed++;
+            }
+
+            if (location is Woods woods)
+            {
+                foreach (ResourceClump clump in woods.stumps.Where(shouldRemove).ToArray())
                 {
-                    resourceClumps.Remove(clump);
+                    woods.stumps.Remove(clump);
                     removed++;
                 }
             }

From 3dc344054a701379528ca5de256210ce232c8cc3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 2 Apr 2021 20:35:02 -0400
Subject: [PATCH 141/856] don't overwrite .bin.osx file unnecessarily to avoid
 resetting file permissions (#768)

---
 docs/release-notes.md                       | 1 +
 src/SMAPI.Installer/assets/unix-launcher.sh | 7 ++++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3d505b8b..a9074ba9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For players:
+  * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
 
 ## 3.9.5
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 1d97d487..93bf58d8 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -37,8 +37,13 @@ if [ "$UNAME" == "Darwin" ]; then
         ln -s /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib libgdiplus.dylib
     fi
 
+    # create bin file
+    # Note: don't overwrite if it's identical, to avoid resetting permission flags
+    if [ ! -x StardewModdingAPI.bin.osx ] || ! cmp StardewValley.bin.osx StardewModdingAPI.bin.osx >/dev/null 2>&1; then
+        cp -p StardewValley.bin.osx StardewModdingAPI.bin.osx
+    fi
+
     # launch SMAPI
-    cp StardewValley.bin.osx StardewModdingAPI.bin.osx
     open -a Terminal ./StardewModdingAPI.bin.osx "$@"
 else
     # choose launcher

From 1a4cdd71a5d5bd69a76d67c346562fdc2ccef22b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 2 Apr 2021 21:18:18 -0400
Subject: [PATCH 142/856] fix asset propagation for localized movie data

---
 docs/release-notes.md                     |  4 ++++
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 15 ++++++---------
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a9074ba9..74c68075 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,8 +10,12 @@
 ## Upcoming release
 * For players:
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
+  * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
 
+* For modders:
+  * Added asset propagation for `Data\Concessions`.
+
 ## 3.9.5
 Released 21 March 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 52da3946..83ed52ad 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -286,6 +286,10 @@ namespace StardewModdingAPI.Metadata
                     Game1.clothingInformation = content.Load<Dictionary<int, string>>(key);
                     return true;
 
+                case "data\\concessions": // MovieTheater.GetConcessions
+                    MovieTheater.ClearCachedLocalizedData();
+                    return true;
+
                 case "data\\concessiontastes": // MovieTheater.GetConcessionTasteForCharacter
                     this.Reflection
                         .GetField<List<ConcessionTaste>>(typeof(MovieTheater), "_concessionTastes")
@@ -306,16 +310,9 @@ namespace StardewModdingAPI.Metadata
                 case "data\\hairdata": // Farmer.GetHairStyleMetadataFile
                     return this.ReloadHairData();
 
-                case "data\\moviesreactions": // MovieTheater.GetMovieReactions
-                    this.Reflection
-                        .GetField<List<MovieCharacterReaction>>(typeof(MovieTheater), "_genericReactions")
-                        .SetValue(content.Load<List<MovieCharacterReaction>>(key));
-                    return true;
-
                 case "data\\movies": // MovieTheater.GetMovieData
-                    this.Reflection
-                        .GetField<Dictionary<string, MovieData>>(typeof(MovieTheater), "_movieData")
-                        .SetValue(content.Load<Dictionary<string, MovieData>>(key));
+                case "data\\moviesreactions": // MovieTheater.GetMovieReactions
+                    MovieTheater.ClearCachedLocalizedData();
                     return true;
 
                 case "data\\npcdispositions": // NPC constructor

From 62c1f11109b3a16e4e1d526e8ddc891015c507b0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 2 Apr 2021 21:30:55 -0400
Subject: [PATCH 143/856] remove unneeded compile switch (#767)

This was originally added to reduce antivirus false positives, but they do it anyway at this point.
---
 docs/release-notes.md                       | 1 +
 src/SMAPI.Installer/InteractiveInstaller.cs | 5 -----
 2 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 74c68075..748651bb 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,6 +12,7 @@
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
+  * Internal changes to prepare for unofficial 64-bit.
 
 * For modders:
   * Added asset propagation for `Data\Concessions`.
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 3d673719..2dcd81e7 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -10,9 +10,7 @@ using StardewModdingAPI.Internal.ConsoleWriting;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Utilities;
-#if !SMAPI_FOR_WINDOWS
 using System.Diagnostics;
-#endif
 
 namespace StardewModdingApi.Installer
 {
@@ -433,8 +431,6 @@ namespace StardewModdingApi.Installer
 
                         // mark file executable
                         // (MSBuild doesn't keep permission flags for files zipped in a build task.)
-                        // (Note: exclude from Windows build because antivirus apps can flag the process start code as suspicious.)
-#if !SMAPI_FOR_WINDOWS
                         new Process
                         {
                             StartInfo = new ProcessStartInfo
@@ -444,7 +440,6 @@ namespace StardewModdingApi.Installer
                                 CreateNoWindow = true
                             }
                         }.Start();
-#endif
                     }
 
                     // create mods directory (if needed)

From 3fa0433c9862d1922cd0540848d2bd8716934d1f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 2 Apr 2021 21:30:55 -0400
Subject: [PATCH 144/856] add initial support for 64-bit Windows hack (#767)

---
 build/common.targets                          | 12 ++--
 docs/technical/smapi.md                       |  3 +-
 .../SMAPI.Mods.ConsoleCommands.csproj         |  2 +-
 .../SMAPI.Mods.ErrorHandler.csproj            |  2 +-
 src/SMAPI/Constants.cs                        | 56 ++++++++++---------
 src/SMAPI/Framework/Logging/LogManager.cs     |  3 +
 src/SMAPI/Framework/SCore.cs                  |  2 +-
 src/SMAPI/SMAPI.csproj                        |  6 +-
 8 files changed, 49 insertions(+), 37 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index d680fa74..8137a6f3 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,4 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-
-  <Import Project="find-game-folder.targets" />
-
   <!--set properties -->
   <PropertyGroup>
     <Version>3.9.5</Version>
@@ -9,9 +6,15 @@
 
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
-    <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS;SMAPI_FOR_XNA</DefineConstants>
+
+    <!--<DefineConstants>$(DefineConstants);SMAPI_FOR_WINDOWS_64BIT_HACK</DefineConstants>-->
+    <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
+    <DefineConstants Condition="$(OS) == 'Windows_NT' AND !$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))">$(DefineConstants);SMAPI_FOR_XNA</DefineConstants>
   </PropertyGroup>
 
+  <!--find game folder-->
+  <Import Project="find-game-folder.targets" />
+
   <!-- if game path is invalid, show one user-friendly error instead of a slew of reference errors -->
   <Target Name="ValidateInstallPath" AfterTargets="BeforeBuild">
     <Error Condition="!Exists('$(GamePath)')" Text="Failed to find the game install path automatically. You can specify where to find it; see https://smapi.io/package/custom-game-path." />
@@ -76,5 +79,4 @@
 
   <!-- Somehow this makes Visual Studio for Mac recognise the previous section. Nobody knows why. -->
   <PropertyGroup Condition="'$(RunConfiguration)' == 'Default'" />
-
 </Project>
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index e77d9d82..993bddfb 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -57,7 +57,8 @@ SMAPI uses a small number of conditional compilation constants, which you can se
 flag | purpose
 ---- | -------
 `SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/MacOS. Set automatically in `common.targets`.
-`SMAPI_FOR_XNA` | Whether SMAPI is being compiled for XNA Framework; if not set, the code assumes MonoGame. Set automatically in `common.targets` with the same value as `SMAPI_FOR_WINDOWS`.
+`SMAPI_FOR_WINDOWS_64BIT_HACK` | Whether SMAPI is being [compiled for Windows with a 64-bit Linux version of the game](https://github.com/Pathoschild/SMAPI/issues/767). This is highly specialized and shouldn't be used in most cases. False by default.
+`SMAPI_FOR_XNA` | Whether SMAPI is being compiled for XNA Framework; if not set, the code assumes MonoGame. Set automatically in `common.targets` with the same value as `SMAPI_FOR_WINDOWS` (unless `SMAPI_FOR_WINDOWS_64BIT_HACK` is set).
 `HARMONY_2` | Whether to enable experimental Harmony 2.0 support and rewrite existing Harmony 1._x_ mods for compatibility. Note that you need to replace `build/0Harmony.dll` with a Harmony 2.0 build (or switch to a package reference) to use this flag.
 
 ## For SMAPI developers
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index a187c1ff..432fdc35 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -19,7 +19,7 @@
 
   <!-- Windows only -->
   <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" Condition="!$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))" />
   </ItemGroup>
 
   <!-- Game framework -->
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 788f6f16..56daa710 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -19,7 +19,7 @@
 
   <!-- Windows only -->
   <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" Condition="!$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))" />
   </ItemGroup>
 
   <!-- Game framework -->
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 8b0c952d..af9b7aa2 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -38,6 +38,14 @@ namespace StardewModdingAPI
         /// <summary>The target game platform.</summary>
         internal static GamePlatform Platform { get; } = (GamePlatform)Enum.Parse(typeof(GamePlatform), LowLevelEnvironmentUtility.DetectPlatform());
 
+        /// <summary>Whether SMAPI is being compiled for Windows with a 64-bit Linux version of the game. This is highly specialized and shouldn't be used in most cases.</summary>
+        internal static bool IsWindows64BitHack { get; } =
+#if SMAPI_FOR_WINDOWS_64BIT_HACK
+            true;
+#else
+            false;
+#endif
+
         /// <summary>The game framework running the game.</summary>
         internal static GameFramework GameFramework { get; } =
 #if SMAPI_FOR_XNA
@@ -47,7 +55,7 @@ namespace StardewModdingAPI
 #endif
 
         /// <summary>The game's assembly name.</summary>
-        internal static string GameAssemblyName => EarlyConstants.Platform == GamePlatform.Windows ? "Stardew Valley" : "StardewValley";
+        internal static string GameAssemblyName => EarlyConstants.Platform == GamePlatform.Windows && !EarlyConstants.IsWindows64BitHack ? "Stardew Valley" : "StardewValley";
 
         /// <summary>The <see cref="Context.ScreenId"/> value which should appear in the SMAPI log, if any.</summary>
         internal static int? LogScreenId { get; set; }
@@ -231,33 +239,27 @@ namespace StardewModdingAPI
             targetAssemblies.Add(typeof(StardewModdingAPI.IManifest).Assembly);
 
             // get changes for platform
-            switch (targetPlatform)
+            if (Constants.Platform != Platform.Windows || EarlyConstants.IsWindows64BitHack)
             {
-                case Platform.Linux:
-                case Platform.Mac:
-                    removeAssemblyReferences.AddRange(new[]
-                    {
-                        "Netcode",
-                        "Stardew Valley"
-                    });
-                    targetAssemblies.Add(
-                        typeof(StardewValley.Game1).Assembly // note: includes Netcode types on Linux/Mac
-                    );
-                    break;
-
-                case Platform.Windows:
-                    removeAssemblyReferences.Add(
-                        "StardewValley"
-                    );
-                    targetAssemblies.AddRange(new[]
-                    {
-                        typeof(Netcode.NetBool).Assembly,
-                        typeof(StardewValley.Game1).Assembly
-                    });
-                    break;
-
-                default:
-                    throw new InvalidOperationException($"Unknown target platform '{targetPlatform}'.");
+                removeAssemblyReferences.AddRange(new[]
+                {
+                    "Netcode",
+                    "Stardew Valley"
+                });
+                targetAssemblies.Add(
+                    typeof(StardewValley.Game1).Assembly // note: includes Netcode types on Linux/Mac
+                );
+            }
+            else
+            {
+                removeAssemblyReferences.Add(
+                    "StardewValley"
+                );
+                targetAssemblies.AddRange(new[]
+                {
+                    typeof(Netcode.NetBool).Assembly,
+                    typeof(StardewValley.Game1).Assembly
+                });
             }
 
             // get changes for game framework
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 243ca3ae..38d561e5 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -287,6 +287,9 @@ namespace StardewModdingAPI.Framework.Logging
             string platformLabel = EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform);
             if ((Constants.GameFramework == GameFramework.Xna) != (Constants.Platform == Platform.Windows))
                 platformLabel += $" with {Constants.GameFramework}";
+#if SMAPI_FOR_WINDOWS_64BIT_HACK
+            platformLabel += " 64-bit hack";
+#endif
 
             // init logging
             this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {platformLabel}", LogLevel.Info);
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index ebb21555..22c58099 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -419,7 +419,7 @@ namespace StardewModdingAPI.Framework
             Game1.mapDisplayDevice = new SDisplayDevice(Game1.content, Game1.game1.GraphicsDevice);
 
             // log GPU info
-#if SMAPI_FOR_WINDOWS
+#if SMAPI_FOR_WINDOWS && !SMAPI_FOR_WINDOWS_64BIT_HACK
             this.Monitor.Log($"Running on GPU: {Game1.game1.GraphicsDevice?.Adapter?.Description ?? "<unknown>"}");
 #endif
         }
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index ceef33df..413d9f33 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -14,6 +14,10 @@
 
   <Import Project="..\..\build\common.targets" />
 
+  <PropertyGroup Condition="$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))">
+    <PlatformTarget>x64</PlatformTarget>
+  </PropertyGroup>
+
   <ItemGroup>
     <PackageReference Include="LargeAddressAware" Version="1.0.5" />
     <PackageReference Include="Mono.Cecil" Version="0.11.3" />
@@ -34,7 +38,7 @@
 
   <!-- Windows only -->
   <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" Condition="!$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))" />
     <Reference Include="System.Windows.Forms" />
   </ItemGroup>
 

From 60b563267ea7bc308d7eda55477f61fa063b069a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 2 Apr 2021 21:30:55 -0400
Subject: [PATCH 145/856] fix asset key normalization for 64-bit hack (#767)

---
 src/SMAPI/Framework/Content/ContentCache.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index 7edc9ab9..5c7ad778 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -57,6 +57,8 @@ namespace StardewModdingAPI.Framework.Content
                 IReflectedMethod method = reflection.GetMethod(typeof(TitleContainer), "GetCleanPath");
                 this.NormalizeAssetNameForPlatform = path => method.Invoke<string>(path);
             }
+            else if (EarlyConstants.IsWindows64BitHack)
+                this.NormalizeAssetNameForPlatform = PathUtilities.NormalizePath;
             else
                 this.NormalizeAssetNameForPlatform = key => key.Replace('\\', '/'); // based on MonoGame's ContentManager.Load<T> logic
         }

From 2d8f916053a1b4b039a41a8bbe8018ebe2654022 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 3 Apr 2021 11:39:58 -0400
Subject: [PATCH 146/856] log failed root dependencies in their own group

---
 docs/release-notes.md                         |   1 +
 src/SMAPI/Framework/IModMetadata.cs           |   5 +
 src/SMAPI/Framework/Logging/LogManager.cs     | 165 ++++++++++++------
 src/SMAPI/Framework/ModLoading/ModMetadata.cs |  53 ++++--
 4 files changed, 157 insertions(+), 67 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 748651bb..2ed46af1 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For players:
+  * When many mods fail to load, root dependencies are now listed in their own group so it's easier to see which ones you should try updating first.
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
diff --git a/src/SMAPI/Framework/IModMetadata.cs b/src/SMAPI/Framework/IModMetadata.cs
index 5d2f352d..f5babafb 100644
--- a/src/SMAPI/Framework/IModMetadata.cs
+++ b/src/SMAPI/Framework/IModMetadata.cs
@@ -117,6 +117,11 @@ namespace StardewModdingAPI.Framework
         /// <param name="validOnly">Only return valid update keys.</param>
         IEnumerable<UpdateKey> GetUpdateKeys(bool validOnly = true);
 
+        /// <summary>Get whether the given mod ID must be installed to load this mod.</summary>
+        /// <param name="modId">The mod ID to check.</param>
+        /// <param name="includeOptional">Whether to include optional dependencies.</param>
+        bool HasRequiredModId(string modId, bool includeOptional);
+
         /// <summary>Get the mod IDs that must be installed to load this mod.</summary>
         /// <param name="includeOptional">Whether to include optional dependencies.</param>
         IEnumerable<string> GetRequiredModIds(bool includeOptional = false);
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 38d561e5..4ba4fffc 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -429,67 +429,38 @@ namespace StardewModdingAPI.Framework.Logging
             // log skipped mods
             if (skippedMods.Any())
             {
-                // get logging logic
-                HashSet<string> loggedDuplicateIds = new HashSet<string>();
-                void LogSkippedMod(IModMetadata mod)
-                {
-                    string message = $"      - {mod.DisplayName}{(mod.Manifest?.Version != null ? " " + mod.Manifest.Version.ToString() : "")} because {mod.Error}";
+                var loggedDuplicateIds = new HashSet<string>();
 
-                    // handle duplicate mods
-                    // (log first duplicate only, don't show redundant version)
-                    if (mod.FailReason == ModFailReason.Duplicate && mod.HasManifest())
-                    {
-                        if (!loggedDuplicateIds.Add(mod.Manifest.UniqueID))
-                            return; // already logged
-
-                        message = $"      - {mod.DisplayName} because {mod.Error}";
-                    }
-
-                    // log message
-                    this.Monitor.Log(message, LogLevel.Error);
-                    if (mod.ErrorDetails != null)
-                        this.Monitor.Log($"        ({mod.ErrorDetails})");
-                }
-
-                // group mods
-                List<IModMetadata> skippedDependencies = new List<IModMetadata>();
-                List<IModMetadata> otherSkippedMods = new List<IModMetadata>();
-                {
-                    // track broken dependencies
-                    HashSet<string> skippedDependencyIds = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
-                    HashSet<string> skippedModIds = new HashSet<string>(from mod in skippedMods where mod.HasID() select mod.Manifest.UniqueID, StringComparer.OrdinalIgnoreCase);
-                    foreach (IModMetadata mod in skippedMods)
-                    {
-                        foreach (string requiredId in skippedModIds.Intersect(mod.GetRequiredModIds()))
-                            skippedDependencyIds.Add(requiredId);
-                    }
-
-                    // collect mod groups
-                    foreach (IModMetadata mod in skippedMods)
-                    {
-                        if (mod.HasID() && skippedDependencyIds.Contains(mod.Manifest.UniqueID))
-                            skippedDependencies.Add(mod);
-                        else
-                            otherSkippedMods.Add(mod);
-                    }
-                }
-
-                // log skipped mods
                 this.Monitor.Log("   Skipped mods", LogLevel.Error);
                 this.Monitor.Log("   " + "".PadRight(50, '-'), LogLevel.Error);
                 this.Monitor.Log("      These mods could not be added to your game.", LogLevel.Error);
                 this.Monitor.Newline();
-
-                if (skippedDependencies.Any())
+                foreach (var list in this.GroupFailedModsByPriority(skippedMods))
                 {
-                    foreach (IModMetadata mod in skippedDependencies.OrderBy(p => p.DisplayName))
-                        LogSkippedMod(mod);
-                    this.Monitor.Newline();
-                }
+                    if (list.Any())
+                    {
+                        foreach (IModMetadata mod in list.OrderBy(p => p.DisplayName))
+                        {
+                            string message = $"      - {mod.DisplayName}{(" " + mod.Manifest?.Version?.ToString()).TrimEnd()} because {mod.Error}";
 
-                foreach (IModMetadata mod in otherSkippedMods.OrderBy(p => p.DisplayName))
-                    LogSkippedMod(mod);
-                this.Monitor.Newline();
+                            // duplicate mod: log first one only, don't show redundant version
+                            if (mod.FailReason == ModFailReason.Duplicate && mod.HasManifest())
+                            {
+                                if (loggedDuplicateIds.Add(mod.Manifest.UniqueID))
+                                    continue; // already logged
+
+                                message = $"      - {mod.DisplayName} because {mod.Error}";
+                            }
+
+                            // log message
+                            this.Monitor.Log(message, LogLevel.Error);
+                            if (mod.ErrorDetails != null)
+                                this.Monitor.Log($"        ({mod.ErrorDetails})");
+                        }
+
+                        this.Monitor.Newline();
+                    }
+                }
             }
 
             // log warnings
@@ -561,6 +532,92 @@ namespace StardewModdingAPI.Framework.Logging
             }
         }
 
+        /// <summary>Group failed mods by the priority players should update them, where mods in earlier groups are more likely to fix multiple mods.</summary>
+        /// <param name="failedMods">The failed mods to group.</param>
+        private IEnumerable<IList<IModMetadata>> GroupFailedModsByPriority(IList<IModMetadata> failedMods)
+        {
+            var failedOthers = failedMods.ToList();
+            var skippedModIds = new HashSet<string>(from mod in failedMods where mod.HasID() select mod.Manifest.UniqueID, StringComparer.OrdinalIgnoreCase);
+
+            // group B: dependencies which failed
+            var failedOtherDependencies = new List<IModMetadata>();
+            {
+                // get failed dependency IDs
+                var skippedDependencyIds = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+                foreach (IModMetadata mod in failedMods)
+                {
+                    foreach (string requiredId in skippedModIds.Intersect(mod.GetRequiredModIds()))
+                        skippedDependencyIds.Add(requiredId);
+                }
+
+                // group matching mods
+                this.FilterThrough(
+                    fromList: failedOthers,
+                    toList: failedOtherDependencies,
+                    match: mod => mod.HasID() && skippedDependencyIds.Contains(mod.Manifest.UniqueID)
+                );
+            }
+
+            // group A: failed root dependencies which other dependencies need
+            var failedRootDependencies = new List<IModMetadata>();
+            {
+                var skippedDependencyIds = new HashSet<string>(failedOtherDependencies.Select(p => p.Manifest.UniqueID));
+                this.FilterThrough(
+                    fromList: failedOtherDependencies,
+                    toList: failedRootDependencies,
+                    match: mod =>
+                    {
+                        // has no failed dependency
+                        foreach (string requiredId in mod.GetRequiredModIds())
+                        {
+                            if (skippedDependencyIds.Contains(requiredId))
+                                return false;
+                        }
+
+                        // another dependency depends on this mod
+                        bool isDependedOn = false;
+                        foreach (IModMetadata other in failedOtherDependencies)
+                        {
+                            if (other.HasRequiredModId(mod.Manifest.UniqueID, includeOptional: false))
+                            {
+                                isDependedOn = true;
+                                break;
+                            }
+                        }
+
+                        return isDependedOn;
+                    }
+                );
+            }
+
+            // return groups
+            return new[]
+            {
+                failedRootDependencies,
+                failedOtherDependencies,
+                failedOthers
+            };
+        }
+
+        /// <summary>Filter matching items from one list and add them to the other.</summary>
+        /// <typeparam name="TItem">The list item type.</typeparam>
+        /// <param name="fromList">The list to filter.</param>
+        /// <param name="toList">The list to which to add filtered items.</param>
+        /// <param name="match">Matches items to filter through.</param>
+        private void FilterThrough<TItem>(IList<TItem> fromList, IList<TItem> toList, Func<TItem, bool> match)
+        {
+            for (int i = 0; i < fromList.Count; i++)
+            {
+                TItem item = fromList[i];
+                if (match(item))
+                {
+                    toList.Add(item);
+                    fromList.RemoveAt(i);
+                    i--;
+                }
+            }
+        }
+
         /// <summary>Write a mod warning group to the console and log.</summary>
         /// <param name="mods">The mods to search.</param>
         /// <param name="match">Matches mods to include in the warning group.</param>
diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index b4de3d6c..0d89fd20 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -19,6 +19,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>The non-error issues with the mod, including warnings suppressed by the data record.</summary>
         private ModWarning ActualWarnings = ModWarning.None;
 
+        /// <summary>The mod IDs which are listed as a requirement by this mod. The value for each pair indicates whether the dependency is required (i.e. not an optional dependency).</summary>
+        private Lazy<IDictionary<string, bool>> Dependencies;
+
 
         /*********
         ** Accessors
@@ -100,6 +103,8 @@ namespace StardewModdingAPI.Framework.ModLoading
             this.Manifest = manifest;
             this.DataRecord = dataRecord;
             this.IsIgnored = isIgnored;
+
+            this.Dependencies = new Lazy<IDictionary<string, bool>>(this.ExtractDependencies);
         }
 
         /// <inheritdoc />
@@ -198,24 +203,22 @@ namespace StardewModdingAPI.Framework.ModLoading
             }
         }
 
+        /// <inheritdoc />
+        public bool HasRequiredModId(string modId, bool includeOptional)
+        {
+            return
+                this.Dependencies.Value.TryGetValue(modId, out bool isRequired)
+                && (includeOptional || isRequired);
+        }
+
         /// <inheritdoc />
         public IEnumerable<string> GetRequiredModIds(bool includeOptional = false)
         {
-            HashSet<string> required = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
-
-            // yield dependencies
-            if (this.Manifest?.Dependencies != null)
+            foreach (var pair in this.Dependencies.Value)
             {
-                foreach (var entry in this.Manifest?.Dependencies)
-                {
-                    if ((entry.IsRequired || includeOptional) && required.Add(entry.UniqueID))
-                        yield return entry.UniqueID;
-                }
+                if (includeOptional || pair.Value)
+                    yield return pair.Key;
             }
-
-            // yield content pack parent
-            if (this.Manifest?.ContentPackFor?.UniqueID != null && required.Add(this.Manifest.ContentPackFor.UniqueID))
-                yield return this.Manifest.ContentPackFor.UniqueID;
         }
 
         /// <inheritdoc />
@@ -237,5 +240,29 @@ namespace StardewModdingAPI.Framework.ModLoading
             string rootFolderName = Path.GetFileName(this.RootPath) ?? "";
             return Path.Combine(rootFolderName, this.RelativeDirectoryPath);
         }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Extract mod IDs from the manifest that must be installed to load this mod.</summary>
+        /// <returns>Returns a dictionary of mod ID => is required (i.e. not an optional dependency).</returns>
+        public IDictionary<string, bool> ExtractDependencies()
+        {
+            var ids = new Dictionary<string, bool>(StringComparer.OrdinalIgnoreCase);
+
+            // yield dependencies
+            if (this.Manifest?.Dependencies != null)
+            {
+                foreach (var entry in this.Manifest?.Dependencies)
+                    ids[entry.UniqueID] = entry.IsRequired;
+            }
+
+            // yield content pack parent
+            if (this.Manifest?.ContentPackFor?.UniqueID != null)
+                ids[this.Manifest.ContentPackFor.UniqueID] = true;
+
+            return ids;
+        }
     }
 }

From 222183c651c5b5d9e402db1b8009e2e0a0681b06 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 4 Apr 2021 11:37:11 -0400
Subject: [PATCH 147/856] standardize spelling of 'macOS'

---
 build/common.targets                          |  2 +-
 build/find-game-folder.targets                |  2 +-
 build/prepare-install-package.targets         |  8 +--
 docs/README.md                                |  6 +-
 docs/release-notes-archived.md                | 62 +++++++++----------
 docs/release-notes.md                         | 13 ++--
 docs/technical/mod-package.md                 | 12 ++--
 docs/technical/smapi.md                       | 12 ++--
 .../Framework/InstallerContext.cs             |  2 +-
 .../Framework/InstallerPaths.cs               |  6 +-
 src/SMAPI.Installer/InteractiveInstaller.cs   | 18 +++---
 src/SMAPI.Installer/assets/README.txt         |  9 +--
 src/SMAPI.Installer/assets/unix-install.sh    |  2 +-
 .../ConsoleWriting/ColorfulConsoleWriter.cs   |  2 +-
 src/SMAPI.Mods.SaveBackup/ModEntry.cs         |  4 +-
 .../Utilities/PathUtilitiesTests.cs           |  2 +-
 .../Framework/Clients/WebApi/WebApiClient.cs  |  2 +-
 .../Framework/GameScanning/GameScanner.cs     |  2 +-
 .../Framework/LowLevelEnvironmentUtility.cs   |  8 +--
 .../Framework/ModData/ModWarning.cs           |  2 +-
 .../Framework/ModScanning/ModScanner.cs       |  4 +-
 src/SMAPI.Toolkit/Utilities/Platform.cs       |  2 +-
 src/SMAPI.Web/Startup.cs                      |  2 +-
 src/SMAPI.Web/Views/Index/Index.cshtml        |  2 +-
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  2 +-
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json     |  2 +-
 src/SMAPI/Constants.cs                        |  2 +-
 .../Framework/Content/AssetDataForImage.cs    |  4 +-
 src/SMAPI/Framework/ContentPack.cs            |  2 +-
 src/SMAPI/Framework/Logging/LogFileManager.cs |  2 +-
 src/SMAPI/Framework/Logging/LogManager.cs     |  2 +-
 .../ModLoading/InstructionHandleResult.cs     |  2 +-
 .../RewriteFacades/SpriteBatchFacade.cs       |  4 +-
 src/SMAPI/Framework/SCore.cs                  |  4 +-
 .../Framework/Serialization/ColorConverter.cs |  2 +-
 .../Framework/Serialization/PointConverter.cs |  2 +-
 .../Serialization/RectangleConverter.cs       |  2 +-
 .../Serialization/Vector2Converter.cs         |  2 +-
 src/SMAPI/GamePlatform.cs                     |  2 +-
 src/SMAPI/SMAPI.config.json                   |  4 +-
 40 files changed, 114 insertions(+), 112 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 8137a6f3..4068c491 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -77,6 +77,6 @@
     <StartWorkingDirectory>$(GamePath)</StartWorkingDirectory>
   </PropertyGroup>
 
-  <!-- Somehow this makes Visual Studio for Mac recognise the previous section. Nobody knows why. -->
+  <!-- Somehow this makes Visual Studio for macOS recognise the previous section. Nobody knows why. -->
   <PropertyGroup Condition="'$(RunConfiguration)' == 'Default'" />
 </Project>
diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index ec8a3787..7a9bfc50 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -13,7 +13,7 @@
         <GamePath Condition="!Exists('$(GamePath)')">$(HOME)/.local/share/Steam/steamapps/common/Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">$(HOME)/.var/app/com.valvesoftware.Steam/data/Steam/steamapps/common/Stardew Valley</GamePath>
 
-        <!-- Mac (may be 'Unix' or 'OSX') -->
+        <!-- macOS (may be 'Unix' or 'OSX') -->
         <GamePath Condition="!Exists('$(GamePath)')">/Applications/Stardew Valley.app/Contents/MacOS</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">$(HOME)/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS</GamePath>
       </PropertyGroup>
diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index 205040db..408230a9 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -33,7 +33,7 @@
 
     <!-- copy installer files -->
     <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on Linux.sh" />
-    <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on Mac.command" />
+    <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on macOS.command" />
     <Copy SourceFiles="$(TargetDir)\assets\windows-install.bat" DestinationFiles="$(PackagePath)\install on Windows.bat" />
     <Copy SourceFiles="$(TargetDir)\assets\README.txt" DestinationFiles="$(PackagePath)\README.txt" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install.exe" />
@@ -74,13 +74,13 @@
     <Copy SourceFiles="$(SaveBackupBin)\SaveBackup.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
     <Copy SourceFiles="$(SaveBackupBin)\manifest.json" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
 
-    <!-- fix errors on Linux/Mac (sample: https://smapi.io/log/mMdFUpgB) -->
+    <!-- fix errors on Linux/macOS (sample: https://smapi.io/log/mMdFUpgB) -->
     <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(TargetDir)\assets\System.Numerics.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(TargetDir)\assets\System.Runtime.Caching.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
 
-    <!-- fix Linux/Mac permissions -->
+    <!-- fix Linux/macOS permissions -->
     <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)\install on Linux.sh&quot;" />
-    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)\install on Mac.command&quot;" />
+    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)\install on macOS.command&quot;" />
 
     <!-- finalise 'for developers' installer -->
     <ItemGroup>
diff --git a/docs/README.md b/docs/README.md
index 4726c190..e7b8a9b3 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -11,9 +11,9 @@ doesn't change any of your game files. It serves seven main purposes:
    couldn't._
 
 3. **Rewrite mods for compatibility.**  
-   _SMAPI rewrites mods' compiled code before loading them so they work on Linux/Mac/Windows
-   without the mods needing to handle differences between the Linux/Mac and Windows versions of the
-   game. In some cases it also rewrites code broken by a game update so the mod doesn't break._
+   _SMAPI rewrites mods' compiled code before loading them so they work on Linux/macOS/Windows
+   without the mods needing to handle differences between the Linux/macOS and Windows versions of
+   the game. In some cases it also rewrites code broken by a game update so the mod doesn't break._
 
 5. **Intercept errors and automatically fix saves.**  
    _SMAPI intercepts errors, shows the error info in the SMAPI console, and in most cases
diff --git a/docs/release-notes-archived.md b/docs/release-notes-archived.md
index b5dd538b..9801c226 100644
--- a/docs/release-notes-archived.md
+++ b/docs/release-notes-archived.md
@@ -30,7 +30,7 @@ Released 13 September 2019 for Stardew Valley 1.3.36.
 Released 23 April 2019 for Stardew Valley 1.3.36.
 
 * For players:
-  * Fixed error when a custom map references certain vanilla tilesheets on Linux/Mac.
+  * Fixed error when a custom map references certain vanilla tilesheets on Linux/macOS.
   * Fixed compatibility with some Linux distros.
 
 ## 2.11.1
@@ -68,7 +68,7 @@ Released 09 January 2019 for Stardew Valley 1.3.32–33.
 
 * For players:
   * SMAPI now keeps the first save backup created for the day, instead of the last one.
-  * Fixed save backup for some Linux/Mac players. (When compression isn't available, SMAPI will now create uncompressed backups instead.)
+  * Fixed save backup for some Linux/macOS players. (When compression isn't available, SMAPI will now create uncompressed backups instead.)
   * Fixed some common dependencies not linking to the mod page in 'missing mod' errors.
   * Fixed 'unknown mod' deprecation warnings showing a stack trace when developers mode not enabled.
   * Fixed 'unknown mod' deprecation warnings when they occur in the Mod constructor.
@@ -90,7 +90,7 @@ Released 09 January 2019 for Stardew Valley 1.3.32–33.
   * Fixed 'unknown mod' deprecation warnings showing the wrong stack trace.
   * Fixed `e.Cursor` in input events showing wrong grab tile when player using a controller moves without moving the viewpoint.
   * Fixed incorrect 'bypassed safety checks' warning for mods using the new `Specialized.LoadStageChanged` event in 2.10.
-  * Deprecated `EntryDll` values whose capitalization don't match the actual file. (This works on Windows, but causes errors for Linux/Mac players.)
+  * Deprecated `EntryDll` values whose capitalization don't match the actual file. (This works on Windows, but causes errors for Linux/macOS players.)
 
 ## 2.10.1
 Released 30 December 2018 for Stardew Valley 1.3.32–33.
@@ -183,7 +183,7 @@ Released 07 December 2018 for Stardew Valley 1.3.32.
 ## 2.8.2
 Released 19 November 2018 for Stardew Valley 1.3.32.
 
-* Fixed game crash in MacOS with SMAPI 2.8.
+* Fixed game crash in macOS with SMAPI 2.8.
 
 ## 2.8.1
 Released 19 November 2018 for Stardew Valley 1.3.32.
@@ -205,7 +205,7 @@ Released 19 November 2018 for Stardew Valley 1.3.32.
   * SMAPI now recommends a compatible SMAPI version if you have an older game version.
   * Improved various error messages to be more clear and intuitive.
   * Improved compatibility with various Linux shells (thanks to lqdev!), and prefer xterm when available.
-  * Fixed transparency issues on Linux/Mac for some mod images.
+  * Fixed transparency issues on Linux/macOS for some mod images.
   * Fixed error when a mod manifest is corrupted.
   * Fixed error when a mod adds an unnamed location.
   * Fixed friendly error no longer shown when SMAPI isn't run from the game folder.
@@ -223,7 +223,7 @@ Released 19 November 2018 for Stardew Valley 1.3.32.
   * The log parser now has a separate filter for game messages.
   * The log parser now shows content pack authors (thanks to danvolchek!).
   * Tweaked log parser UI (thanks to danvolchek!).
-  * Fixed log parser instructions for Mac.
+  * Fixed log parser instructions for macOS.
 
 * For mod authors:
   * Added [data API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Data) to store mod data in the save file or app data.
@@ -267,7 +267,7 @@ Released 14 August 2018 for Stardew Valley 1.3.28.
   * Improved how mod issues are listed in the console and log.
   * Revamped installer. It now...
     * uses a new format that should be more intuitive;
-    * lets players on Linux/Mac choose the console color scheme (SMAPI will auto-detect it on Windows);
+    * lets players on Linux/macOS choose the console color scheme (SMAPI will auto-detect it on Windows);
     * and validates requirements earlier.
   * Fixed custom festival maps always using spring tilesheets.
   * Fixed `player_add` command not recognising return scepter.
@@ -314,8 +314,8 @@ Released 01 August 2018 for Stardew Valley 1.3.27.
     * Removed the `player_setlevel` and `player_setspeed` commands, which weren't implemented in a useful way. Use a mod like CJB Cheats Menu if you need those.
   * Fixed `SEHException` errors for some players.
   * Fixed performance issues for some players.
-  * Fixed default color scheme on Mac or in PowerShell (configurable via `StardewModdingAPI.config.json`).
-  * Fixed installer error on Linux/Mac in some cases.
+  * Fixed default color scheme on macOS or in PowerShell (configurable via `StardewModdingAPI.config.json`).
+  * Fixed installer error on Linux/macOS in some cases.
   * Fixed installer not finding some game paths or showing duplicate paths.
   * Fixed installer not removing some SMAPI files.
   * Fixed launch issue for Linux players with some terminals. (Thanks to HanFox and kurumushi!)
@@ -345,7 +345,7 @@ Released 01 August 2018 for Stardew Valley 1.3.27.
     * each event now provides a list of added/removed values;
     * added buildings-changed event.
   * Added `Context.IsMultiplayer` and `Context.IsMainPlayer` flags.
-  * Added `Constants.TargetPlatform` which says whether the game is running on Linux, Mac, or Windows.
+  * Added `Constants.TargetPlatform` which says whether the game is running on Linux, macOS, or Windows.
   * Added `semanticVersion.IsPrerelease()` method.
   * Added support for launching multiple instances transparently. This removes the former `--log-path` command-line argument.
   * Added support for custom seasonal tilesheets when loading an unpacked `.tbin` map.
@@ -376,7 +376,7 @@ Released 01 August 2018 for Stardew Valley 1.3.27.
      * Mod IDs should only contain letters, numbers, hyphens, dots, and underscores. That allows their use in many contexts like URLs. This restriction is now enforced. (In regex form: `^[a-zA-Z0-9_.-]+$`.)
 
 * For SMAPI developers:
-  * Added more consistent crossplatform handling, including MacOS detection.
+  * Added more consistent crossplatform handling, including macOS detection.
   * Added beta update channel.
   * Added optional mod metadata to the web API (including Nexus info, wiki metadata, etc).
   * Added early prototype of SMAPI 3.0 events via `helper.Events`.
@@ -411,7 +411,7 @@ Released 26 March 2018 for Stardew Valley 1.2.30–1.2.33.
 
 * For players:
   * Fixed some textures not updated when a mod changes them.
-  * Fixed visual bug on Linux/Mac when mods overlay textures.
+  * Fixed visual bug on Linux/macOS when mods overlay textures.
   * Fixed error when mods remove an asset editor/loader.
   * Fixed minimum game version incorrectly increased in SMAPI 2.5.3.
 
@@ -467,9 +467,9 @@ Released 24 February 2018 for Stardew Valley 1.2.30–1.2.33.
   * **Added support for [content packs](https://stardewvalleywiki.com/Modding:Content_packs)**.  
     <small>_Content packs are collections of files for a SMAPI mod to load. These can be installed directly under `Mods` like a normal SMAPI mod, get automatic update and compatibility checks, and provide convenient APIs to the mods that read them._</small>
   * Added mod detection for unhandled errors (so most errors now mention which mod caused them).
-  * Added install scripts for Linux/Mac (no more manual terminal commands!).
+  * Added install scripts for Linux/macOS (no more manual terminal commands!).
   * Added the missing mod's name and URL to dependency errors.
-  * Fixed uninstall script not reporting when done on Linux/Mac.
+  * Fixed uninstall script not reporting when done on Linux/macOS.
   * Updated compatibility list and enabled update checks for more mods.
 
 * For mod authors:
@@ -524,7 +524,7 @@ Released 26 December 2017 for Stardew Valley 1.2.30–1.2.33.
 
 * For players:
   * Added a user-friendly [download page](https://smapi.io).
-  * Improved cryptic libgdiplus errors on Mac when Mono isn't installed.
+  * Improved cryptic libgdiplus errors on macOS when Mono isn't installed.
   * Fixed mod UIs hidden when menu backgrounds are enabled.
 
 * For mod authors:
@@ -545,9 +545,9 @@ Released 26 December 2017 for Stardew Valley 1.2.30–1.2.33.
 Released 02 December 2017 for Stardew Valley 1.2.30–1.2.33.
 
 * For players:
-  * Fixed error when a mod loads custom assets on Linux/Mac.
-  * Fixed error when checking for updates on Linux/Mac due to API HTTPS redirect.
-  * Fixed error when Mac adds an `mcs` symlink to the installer package.
+  * Fixed error when a mod loads custom assets on Linux/macOS.
+  * Fixed error when checking for updates on Linux/macOS due to API HTTPS redirect.
+  * Fixed error when macOS adds an `mcs` symlink to the installer package.
   * Fixed `player_add` command not handling tool upgrade levels.
   * Improved error when a mod has an invalid `EntryDLL` filename format.
   * Updated compatibility list.
@@ -651,7 +651,7 @@ For players:
 * The console is now simpler and easier to read, and adjusts its colors to fit your terminal background color.
 * Renamed installer folder to avoid confusion.
 * Updated compatibility list.
-* Fixed update check errors on Linux/Mac.
+* Fixed update check errors on Linux/macOS.
 * Fixed collection-changed errors during startup for some players.
 
 For mod developers:
@@ -685,7 +685,7 @@ For SMAPI developers:
 Released 09 September 2017 for Stardew Valley 1.2.30–1.2.33.
 
 For players:
-* Fixed errors when loading some custom maps on Linux/Mac or using XNB Loader.
+* Fixed errors when loading some custom maps on Linux/macOS or using XNB Loader.
 * Fixed errors in rare cases when a mod calculates an in-game date.
 
 For mod authors:
@@ -772,7 +772,7 @@ For players:
   * you have Stardew Valley 1.11 or earlier (which aren't compatible);
   * you run `install.exe` from within the downloaded zip file.
 * Fixed "unknown mod" deprecation warnings by improving how SMAPI detects the mod using the event.
-* Fixed `libgdiplus.dylib` errors for some players on Mac.
+* Fixed `libgdiplus.dylib` errors for some players on macOS.
 * Fixed rare crash when window loses focus for a few players.
 * Bumped minimum game version to 1.2.30.
 * Updated mod compatibility list.
@@ -805,8 +805,8 @@ For players:
 * SMAPI now recovers automatically from errors in the game loop when possible.
 * SMAPI now remembers if your game crashed and offers help next time you launch it.
 * Fixed installer sometimes finding redundant game paths.
-* Fixed save events not being raised after the first day on Linux/Mac.
-* Fixed error on Linux/Mac when a mod loads a PNG immediately after the save is loaded.
+* Fixed save events not being raised after the first day on Linux/macOS.
+* Fixed error on Linux/macOS when a mod loads a PNG immediately after the save is loaded.
 * Updated mod compatibility list for Stardew Valley 1.2.
 
 For mod developers:
@@ -826,15 +826,15 @@ Released 03 May 2017 for Stardew Valley 1.2.26–1.2.29.
 For players:
 * The installer now lets you choose the install path if you have multiple copies of the game, instead of using the first path found.
 * Fixed mod draw errors breaking the game.
-* Fixed mods on Linux/Mac no longer working after the game saves.
-* Fixed `libgdiplus.dylib` errors on Mac when mods read PNG files.
+* Fixed mods on Linux/macOS no longer working after the game saves.
+* Fixed `libgdiplus.dylib` errors on macOS when mods read PNG files.
 * Adopted pufferchick.
 
 For mod developers:
 * Unknown mod manifest fields are now stored in `IManifest::ExtraFields`.
 * The content API now defaults to `ContentSource.ModFolder`.
 * Fixed content API error when loading a PNG during early game init (e.g. in mod's `Entry`).
-* Fixed content API error when loading an XNB from the mod folder on Mac.
+* Fixed content API error when loading an XNB from the mod folder on macOS.
 
 ## 1.11
 Released 30 April 2017 for Stardew Valley 1.2.26.
@@ -888,7 +888,7 @@ For players:
 * Fixed the game-needs-an-update error not pausing before exit.
 * Fixed installer errors for some players when deleting files.
 * Fixed installer not ignoring potential game folders that don't contain a Stardew Valley exe.
-* Fixed installer not recognising Linux/Mac paths starting with `~/` or containing an escaped space.
+* Fixed installer not recognising Linux/macOS paths starting with `~/` or containing an escaped space.
 * Fixed TrainerMod letting you add invalid items which may crash the game.
 * Fixed TrainerMod's `world_downminelevel` command not working.
 * Fixed rare issue where mod dependencies would override SMAPI dependencies and cause unpredictable bugs.
@@ -912,7 +912,7 @@ For mod developers:
 * Removed the experimental `IConfigFile`.
 
 For SMAPI developers:
-* Added support for debugging SMAPI on Linux/Mac if supported by the editor.
+* Added support for debugging SMAPI on Linux/macOS if supported by the editor.
 
 ## 1.8
 Released 04 February 2017 for Stardew Valley 1.1–1.11.
@@ -1004,7 +1004,7 @@ For players:
   * Improved installer wording to reduce confusion.
   * Fixed the installer not removing TrainerMod from appdata if it's already in the game mods directory.
   * Fixed the installer not moving mods out of appdata if the game isn't installed on the same Windows partition.
-  * Fixed the SMAPI console not being shown on Linux and Mac.
+  * Fixed the SMAPI console not being shown on Linux and macOS.
 
 For developers:
   * Added a reflection API (via `helper.Reflection`) that simplifies robust access to the game's private fields and methods.
@@ -1016,7 +1016,7 @@ For developers:
 Released 04 December 2016 for Stardew Valley 1.1–1.11.
 
 For players:
-  * You can now run most mods on any platform (e.g. run Windows mods on Linux/Mac).
+  * You can now run most mods on any platform (e.g. run Windows mods on Linux/macOS).
   * Fixed the normal uninstaller not removing files added by the 'SMAPI for developers' installer.
 
 ## 1.2
@@ -1063,7 +1063,7 @@ For developers:
 Released 11 November 2016 for Stardew Valley 1.1–1.11.
 
 For players:
-  * Added support for Linux and Mac.
+  * Added support for Linux and macOS.
   * Added installer to automate adding & removing SMAPI.
   * Added background update check on launch.
   * Fixed missing `steam_appid.txt` file.
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2ed46af1..cb0be542 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
+  * Fixed inconsistent spelling/style for 'macOS'.
   * Internal changes to prepare for unofficial 64-bit.
 
 * For modders:
@@ -247,7 +248,7 @@ Released 03 October 2020 for Stardew Valley 1.4.1 or later.
 Released 16 September 2020 for Stardew Valley 1.4.1 or later.
 
 * For players:
-  * Fixed errors on Linux/Mac due to content packs with incorrect filename case.
+  * Fixed errors on Linux/macOS due to content packs with incorrect filename case.
   * Fixed map rendering crash due to conflict between SMAPI and PyTK.
   * Fixed error in heuristically-rewritten mods in rare cases (thanks to collaboration with ZaneYork!).
 
@@ -291,7 +292,7 @@ Released 07 September 2020 for Stardew Valley 1.4.1 or later. See [release highl
 * For mod authors:
   * Added `PathUtilities` to simplify working with file/asset names.
   * You can now read/write `SDate` values to JSON (e.g. for `config.json`, network mod messages, etc).
-  * Fixed asset propagation not updating title menu buttons immediately on Linux/Mac.
+  * Fixed asset propagation not updating title menu buttons immediately on Linux/macOS.
 
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.16 and 1.17.
@@ -336,7 +337,7 @@ Released 20 June 2020 for Stardew Valley 1.4.1 or later. See [release highlights
   * Added experimental option to reduce startup time when loading mod DLLs (thanks to ZaneYork!). Enable `RewriteInParallel` in the `smapi-internal/config.json` to try it.
   * Reduced processing time when a mod loads many unpacked images (thanks to Entoarox!).
   * Mod load warnings are now listed alphabetically.
-  * MacOS files starting with `._` are now ignored and can no longer cause skipped mods.
+  * macOS files starting with `._` are now ignored and can no longer cause skipped mods.
   * Simplified paranoid warning logs and reduced their log level.
   * Fixed black maps on Android for mods which use `.tmx` files.
   * Fixed `BadImageFormatException` error detection.
@@ -392,7 +393,7 @@ Released 27 April 2020 for Stardew Valley 1.4.1 or later. See [release highlight
   * Added `SDate` fields/methods: `SeasonIndex`, `FromDaysSinceStart`, `FromWorldDate`, `ToWorldDate`, and `ToLocaleString` (thanks to kdau!).
   * Added `SDate` translations taken from the Lookup Anything mod.¹
   * Fixed asset propagation for certain maps loaded through temporary content managers. This notably fixes unreliable patches to the farmhouse and town maps.
-  * Fixed asset propagation on Linux/Mac for monster sprites, NPC dialogue, and NPC schedules.
+  * Fixed asset propagation on Linux/macOS for monster sprites, NPC dialogue, and NPC schedules.
   * Fixed asset propagation for NPC dialogue sometimes causing a spouse to skip marriage dialogue or not allow kisses.
 
 ¹ Date format translations were taken from the Lookup Anything mod; thanks to translators FixThisPlz (improved Russian), LeecanIt (added Italian), pomepome (added Japanese), S2SKY (added Korean), Sasara (added German), SteaNN (added Russian), ThomasGabrielDelavault (added Spanish), VincentRoth (added French), Yllelder (improved Spanish), and yuwenlan (added Chinese). Some translations for Korean, Hungarian, and Turkish were derived from the game translations.
@@ -408,7 +409,7 @@ Released 24 March 2020 for Stardew Valley 1.4.1 or later.
 Released 22 March 2020 for Stardew Valley 1.4.1 or later. See [release highlights](https://www.patreon.com/posts/35161371).
 
 * For players:
-  * Fixed semi-transparency issues on Linux/Mac in recent versions of Mono (e.g. pink shadows).
+  * Fixed semi-transparency issues on Linux/macOS in recent versions of Mono (e.g. pink shadows).
   * Fixed `player_add` command error if you have broken XNB mods.
   * Removed invalid-location check now handled by the game.
   * Updated translations. Thanks to Annosz (added Hungarian)!
@@ -450,7 +451,7 @@ Released 22 February 2020 for Stardew Valley 1.4.1 or later. See [release highli
   * Updated translations. Thanks to xCarloC (added Italian)!
 
 * For the Save Backup mod:
-  * Fixed warning on MacOS when you have no saves yet.
+  * Fixed warning on macOS when you have no saves yet.
   * Reduced log messages.
 
 * For the web UI:
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 8c9c59fb..6d04722c 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -1,7 +1,7 @@
 &larr; [SMAPI](../README.md)
 
 The **mod build package** is an open-source NuGet package which automates the MSBuild configuration
-for SMAPI mods and related tools. The package is fully compatible with Linux, Mac, and Windows.
+for SMAPI mods and related tools. The package is fully compatible with Linux, macOS, and Windows.
 
 ## Contents
 * [Use](#use)
@@ -33,7 +33,7 @@ change how these work):
 
 * **Add assembly references:**  
   The package adds assembly references to SMAPI, Stardew Valley, xTile, and the game framework
-  (MonoGame on Linux/Mac, XNA Framework on Windows). It automatically adjusts depending on which OS
+  (MonoGame on Linux/macOS, XNA Framework on Windows). It automatically adjusts depending on which OS
   you're compiling it on. If you use [Harmony](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Harmony),
   it can optionally add a reference to that too.
 
@@ -55,7 +55,7 @@ change how these work):
   breakpoints](https://docs.microsoft.com/en-us/visualstudio/debugger/using-breakpoints?view=vs-2019)
   in your code while the game is running, or [make simple changes to the mod code without needing to
   restart the game](https://docs.microsoft.com/en-us/visualstudio/debugger/edit-and-continue?view=vs-2019).
-  This is disabled on Linux/Mac due to limitations with the Mono wrapper.
+  This is disabled on Linux/macOS due to limitations with the Mono wrapper.
 
 * **Preconfigure common settings:**  
   The package automatically enables `.pdb` files (so error logs show line numbers to simplify
@@ -82,7 +82,7 @@ There are two places you can put them:
 
   1. Open the home folder on your computer (see instructions for
      [Linux](https://superuser.com/questions/409218/where-is-my-users-home-folder-in-ubuntu),
-     [MacOS](https://www.cnet.com/how-to/how-to-find-your-macs-home-folder-and-add-it-to-finder/),
+     [macOS](https://www.cnet.com/how-to/how-to-find-your-macs-home-folder-and-add-it-to-finder/),
      or [Windows](https://www.computerhope.com/issues/ch000109.htm)).
   2. Create a `stardewvalley.targets` file with this content:
      ```xml
@@ -132,7 +132,7 @@ The absolute path to the folder containing the game's installed mods (defaults t
 <td><code>GameExecutableName</code></td>
 <td>
 
-The filename for the game's executable (i.e. `StardewValley.exe` on Linux/Mac or
+The filename for the game's executable (i.e. `StardewValley.exe` on Linux/macOS or
 `Stardew Valley.exe` on Windows). This is auto-detected, and you should almost never change this.
 
 </td>
@@ -484,7 +484,7 @@ Released 05 June 2017.
 Released 23 January 2017.
 
 * Added support for setting a custom game path globally.
-* Added default GOG path on Mac.
+* Added default GOG path on macOS.
 
 ### 1.4
 Released 11 January 2017.
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 993bddfb..ca1631cd 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -33,7 +33,7 @@ argument | purpose
 `--game-path "path"` | Specifies the full path to the folder containing the Stardew Valley executable, skipping automatic detection and any prompt to choose a path. If the path is not valid, the installer displays an error.
 
 SMAPI itself recognises two arguments **on Windows only**, but these are intended for internal use
-or testing and may change without warning. On Linux/Mac, see _environment variables_ below.
+or testing and may change without warning. On Linux/macOS, see _environment variables_ below.
 
 argument | purpose
 -------- | -------
@@ -41,7 +41,7 @@ argument | purpose
 `--mods-path` | The path to search for mods, if not the standard `Mods` folder. This can be a path relative to the game folder (like `--mods-path "Mods (test)"`) or an absolute path.
 
 ### Environment variables
-The above SMAPI arguments don't work on Linux/Mac due to the way the game launcher works. You can
+The above SMAPI arguments don't work on Linux/macOS due to the way the game launcher works. You can
 set temporary environment variables instead. For example:
 > SMAPI_MODS_PATH="Mods (multiplayer)" /path/to/StardewValley
 
@@ -56,7 +56,7 @@ SMAPI uses a small number of conditional compilation constants, which you can se
 
 flag | purpose
 ---- | -------
-`SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/MacOS. Set automatically in `common.targets`.
+`SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/macOS. Set automatically in `common.targets`.
 `SMAPI_FOR_WINDOWS_64BIT_HACK` | Whether SMAPI is being [compiled for Windows with a 64-bit Linux version of the game](https://github.com/Pathoschild/SMAPI/issues/767). This is highly specialized and shouldn't be used in most cases. False by default.
 `SMAPI_FOR_XNA` | Whether SMAPI is being compiled for XNA Framework; if not set, the code assumes MonoGame. Set automatically in `common.targets` with the same value as `SMAPI_FOR_WINDOWS` (unless `SMAPI_FOR_WINDOWS_64BIT_HACK` is set).
 `HARMONY_2` | Whether to enable experimental Harmony 2.0 support and rewrite existing Harmony 1._x_ mods for compatibility. Note that you need to replace `build/0Harmony.dll` with a Harmony 2.0 build (or switch to a package reference) to use this flag.
@@ -73,7 +73,7 @@ placed in a `bin` folder at the root of the Git repository.
 
 ### Debugging a local build
 Rebuilding the solution in debug mode will copy the SMAPI files into your game folder. Starting
-the `SMAPI` project with debugging from Visual Studio (on Mac or Windows) will launch SMAPI with
+the `SMAPI` project with debugging from Visual Studio (on macOS or Windows) will launch SMAPI with
 the debugger attached, so you can intercept errors and step through the code being executed. That
 doesn't work in MonoDevelop on Linux, unfortunately.
 
@@ -93,9 +93,9 @@ on the wiki for the first-time setup.
 
 2. In Windows:
    1. Rebuild the solution with the _release_ solution configuration.
-   2. Copy `bin/SMAPI installer` and `bin/SMAPI installer for developers` to Linux/Mac.
+   2. Copy `bin/SMAPI installer` and `bin/SMAPI installer for developers` to Linux/macOS.
 
-3. In Linux/Mac:
+3. In Linux/macOS:
    1. Rebuild the solution with the _release_ solution configuration.
    2. Add the `windows-install.*` files from Windows to the `bin/SMAPI installer` and
       `bin/SMAPI installer for developers` folders compiled on Linux.
diff --git a/src/SMAPI.Installer/Framework/InstallerContext.cs b/src/SMAPI.Installer/Framework/InstallerContext.cs
index 7531eaee..88e57760 100644
--- a/src/SMAPI.Installer/Framework/InstallerContext.cs
+++ b/src/SMAPI.Installer/Framework/InstallerContext.cs
@@ -35,7 +35,7 @@ namespace StardewModdingAPI.Installer.Framework
         /// <summary>Whether the installer is running on Windows.</summary>
         public bool IsWindows => this.Platform == Platform.Windows;
 
-        /// <summary>Whether the installer is running on a Unix OS (including Linux or MacOS).</summary>
+        /// <summary>Whether the installer is running on a Unix OS (including Linux or macOS).</summary>
         public bool IsUnix => !this.IsWindows;
 
 
diff --git a/src/SMAPI.Installer/Framework/InstallerPaths.cs b/src/SMAPI.Installer/Framework/InstallerPaths.cs
index ac6c3a8e..2cabf88b 100644
--- a/src/SMAPI.Installer/Framework/InstallerPaths.cs
+++ b/src/SMAPI.Installer/Framework/InstallerPaths.cs
@@ -47,13 +47,13 @@ namespace StardewModdingAPI.Installer.Framework
         /// <summary>The full path to the installed SMAPI executable file.</summary>
         public string ExecutablePath { get; }
 
-        /// <summary>The full path to the vanilla game launcher on Linux/Mac.</summary>
+        /// <summary>The full path to the vanilla game launcher on Linux/macOS.</summary>
         public string UnixLauncherPath { get; }
 
-        /// <summary>The full path to the installed SMAPI launcher on Linux/Mac before it's renamed.</summary>
+        /// <summary>The full path to the installed SMAPI launcher on Linux/macOS before it's renamed.</summary>
         public string UnixSmapiLauncherPath { get; }
 
-        /// <summary>The full path to the vanilla game launcher on Linux/Mac after SMAPI is installed.</summary>
+        /// <summary>The full path to the vanilla game launcher on Linux/macOS after SMAPI is installed.</summary>
         public string UnixBackupLauncherPath { get; }
 
 
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 2dcd81e7..376949da 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -38,11 +38,11 @@ namespace StardewModdingApi.Installer
             string GetInstallPath(string path) => Path.Combine(installDir.FullName, path);
 
             // current files
-            yield return GetInstallPath("libgdiplus.dylib");           // Linux/Mac only
-            yield return GetInstallPath("StardewModdingAPI");          // Linux/Mac only
+            yield return GetInstallPath("libgdiplus.dylib");           // Linux/macOS only
+            yield return GetInstallPath("StardewModdingAPI");          // Linux/macOS only
             yield return GetInstallPath("StardewModdingAPI.exe");
             yield return GetInstallPath("StardewModdingAPI.exe.config");
-            yield return GetInstallPath("StardewModdingAPI.exe.mdb");  // Linux/Mac only
+            yield return GetInstallPath("StardewModdingAPI.exe.mdb");  // Linux/macOS only
             yield return GetInstallPath("StardewModdingAPI.pdb");      // Windows only
             yield return GetInstallPath("StardewModdingAPI.xml");
             yield return GetInstallPath("smapi-internal");
@@ -104,13 +104,13 @@ namespace StardewModdingApi.Installer
         ///     2. Ask the user whether to install or uninstall.
         ///
         /// Uninstall logic:
-        ///     1. On Linux/Mac: if a backup of the launcher exists, delete the launcher and restore the backup.
+        ///     1. On Linux/macOS: if a backup of the launcher exists, delete the launcher and restore the backup.
         ///     2. Delete all files and folders in the game directory matching one of the values returned by <see cref="GetUninstallPaths"/>.
         ///
         /// Install flow:
         ///     1. Run the uninstall flow.
         ///     2. Copy the SMAPI files from package/Windows or package/Mono into the game directory.
-        ///     3. On Linux/Mac: back up the game launcher and replace it with the SMAPI launcher. (This isn't possible on Windows, so the user needs to configure it manually.)
+        ///     3. On Linux/macOS: back up the game launcher and replace it with the SMAPI launcher. (This isn't possible on Windows, so the user needs to configure it manually.)
         ///     4. Create the 'Mods' directory.
         ///     5. Copy the bundled mods into the 'Mods' directory (deleting any existing versions).
         ///     6. Move any mods from app data into game's mods directory.
@@ -141,7 +141,7 @@ namespace StardewModdingApi.Installer
 #else
             if (context.IsWindows)
             {
-                this.PrintError($"This is the installer for Linux/Mac. Run the 'install on Windows.exe' file instead.");
+                this.PrintError($"This is the installer for Linux/macOS. Run the 'install on Windows.exe' file instead.");
                 Console.ReadLine();
                 return;
             }
@@ -194,7 +194,7 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 2: choose a theme (can't auto-detect on Linux/Mac)
+            ** Step 2: choose a theme (can't auto-detect on Linux/macOS)
             *********/
             MonitorColorScheme scheme = MonitorColorScheme.AutoDetect;
             if (context.IsUnix)
@@ -720,7 +720,7 @@ namespace StardewModdingApi.Installer
                 // normalize path
                 path = context.IsWindows
                     ? path.Replace("\"", "") // in Windows, quotes are used to escape spaces and aren't part of the file path
-                    : path.Replace("\\ ", " "); // in Linux/Mac, spaces in paths may be escaped if copied from the command line
+                    : path.Replace("\\ ", " "); // in Linux/macOS, spaces in paths may be escaped if copied from the command line
                 if (path.StartsWith("~/"))
                 {
                     string home = Environment.GetEnvironmentVariable("HOME") ?? Environment.GetEnvironmentVariable("USERPROFILE");
@@ -840,7 +840,7 @@ namespace StardewModdingApi.Installer
             switch (entry.Name)
             {
                 case "mcs":
-                    return false; // ignore Mac symlink
+                    return false; // ignore macOS symlink
                 case "Mods":
                     return false; // Mods folder handled separately
                 default:
diff --git a/src/SMAPI.Installer/assets/README.txt b/src/SMAPI.Installer/assets/README.txt
index 0da49a46..c3a7e271 100644
--- a/src/SMAPI.Installer/assets/README.txt
+++ b/src/SMAPI.Installer/assets/README.txt
@@ -24,19 +24,20 @@ Manual install
 THIS IS NOT RECOMMENDED FOR MOST PLAYERS. See instructions above instead.
 If you really want to install SMAPI manually, here's how.
 
-1. Unzip "internal/windows-install.dat" (on Windows) or "internal/unix-install.dat" (on Linux/Mac).
-   You can change '.dat' to '.zip', it's just a normal zip file renamed to prevent confusion.
+1. Unzip "internal/windows-install.dat" (on Windows) or "internal/unix-install.dat" (on
+   Linux/macOS). You can change '.dat' to '.zip', it's just a normal zip file renamed to prevent
+   confusion.
 2. Copy the files from the folder you just unzipped into your game folder. The
    `StardewModdingAPI.exe` file should be right next to the game's executable.
 3.
   - Windows only: if you use Steam, see the install guide above to enable achievements and
     overlay. Otherwise, just run StardewModdingAPI.exe in your game folder to play with mods.
 
-  - Linux/Mac only: rename the "StardewValley" file (no extension) to "StardewValley-original", and
+  - Linux/macOS only: rename the "StardewValley" file (no extension) to "StardewValley-original", and
     "StardewModdingAPI" (no extension) to "StardewValley". Now just launch the game as usual to
     play with mods.
 
-When installing on Linux or Mac:
+When installing on Linux or macOS:
 - Make sure Mono is installed (normally the installer checks for you). While it's not required,
   many mods won't work correctly without it. (Specifically, mods which load PNG images may crash or
   freeze the game.)
diff --git a/src/SMAPI.Installer/assets/unix-install.sh b/src/SMAPI.Installer/assets/unix-install.sh
index 6d0c86ce..311c5469 100644
--- a/src/SMAPI.Installer/assets/unix-install.sh
+++ b/src/SMAPI.Installer/assets/unix-install.sh
@@ -1,5 +1,5 @@
 #!/bin/bash
-# Run the SMAPI installer through Mono on Linux or Mac.
+# Run the SMAPI installer through Mono on Linux or macOS.
 
 # Move to script's directory
 cd "`dirname "$0"`"
diff --git a/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs b/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
index b5bd4600..bfe155e0 100644
--- a/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
+++ b/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
@@ -129,7 +129,7 @@ namespace StardewModdingAPI.Internal.ConsoleWriting
             if (schemeID == MonitorColorScheme.AutoDetect)
             {
                 schemeID = platform == Platform.Mac
-                    ? MonitorColorScheme.LightBackground // MacOS doesn't provide console background color info, but it's usually white.
+                    ? MonitorColorScheme.LightBackground // macOS doesn't provide console background color info, but it's usually white.
                     : ColorfulConsoleWriter.IsDark(Console.BackgroundColor) ? MonitorColorScheme.DarkBackground : MonitorColorScheme.LightBackground;
             }
 
diff --git a/src/SMAPI.Mods.SaveBackup/ModEntry.cs b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
index b8d3be1c..d6414e9c 100644
--- a/src/SMAPI.Mods.SaveBackup/ModEntry.cs
+++ b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
@@ -145,7 +145,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
             try
             {
                 if (Constants.TargetPlatform == GamePlatform.Mac)
-                    this.CompressUsingMacProcess(sourcePath, destination); // due to limitations with the bundled Mono on Mac, we can't reference System.IO.Compression
+                    this.CompressUsingMacProcess(sourcePath, destination); // due to limitations with the bundled Mono on macOS, we can't reference System.IO.Compression
                 else
                     this.CompressUsingNetFramework(sourcePath, destination);
 
@@ -185,7 +185,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
             createFromDirectory.Invoke(null, new object[] { sourcePath, destination.FullName, CompressionLevel.Fastest, false });
         }
 
-        /// <summary>Create a zip using a process command on MacOS.</summary>
+        /// <summary>Create a zip using a process command on macOS.</summary>
         /// <param name="sourcePath">The file or directory path to zip.</param>
         /// <param name="destination">The destination file to create.</param>
         private void CompressUsingMacProcess(string sourcePath, FileInfo destination)
diff --git a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
index b5494003..5a342974 100644
--- a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
+++ b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
@@ -251,7 +251,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(
             @"~/parent",
             @"~/PARENT/child",
-            ExpectedResult = @"child" // note: incorrect on Linux and sometimes MacOS, but not worth the complexity of detecting whether the filesystem is case-sensitive for SMAPI's purposes
+            ExpectedResult = @"child" // note: incorrect on Linux and sometimes macOS, but not worth the complexity of detecting whether the filesystem is case-sensitive for SMAPI's purposes
         )]
 #endif
         public string GetRelativePath(string sourceDir, string targetPath)
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
index 2fb6ed20..c2d906a0 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
@@ -61,7 +61,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         /// <param name="content">The body content to post.</param>
         private TResult Post<TBody, TResult>(string url, TBody content)
         {
-            // note: avoid HttpClient for Mac compatibility
+            // note: avoid HttpClient for macOS compatibility
             using WebClient client = new WebClient();
 
             Uri fullUrl = new Uri(this.BaseUrl, url);
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 785daba3..d18a2204 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -82,7 +82,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                             ? $"{home}/.steam/steam/steamapps/common/Stardew Valley"
                             : $"{home}/.local/share/Steam/steamapps/common/Stardew Valley";
 
-                        // Mac
+                        // macOS
                         yield return "/Applications/Stardew Valley.app/Contents/MacOS";
                         yield return $"{home}/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS";
                     }
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index e635725c..8cbd8e51 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -74,7 +74,7 @@ namespace StardewModdingAPI.Toolkit.Framework
                     break;
 
                 case nameof(Platform.Mac):
-                    name = $"MacOS {name}";
+                    name = $"macOS {name}";
                     break;
             }
             return name;
@@ -124,10 +124,10 @@ namespace StardewModdingAPI.Toolkit.Framework
             }
         }
 
-        /// <summary>Detect whether the code is running on Mac.</summary>
+        /// <summary>Detect whether the code is running on macOS.</summary>
         /// <remarks>
-        /// This code is derived from the Mono project (see System.Windows.Forms/System.Windows.Forms/XplatUI.cs). It detects Mac by calling the
-        /// <c>uname</c> system command and checking the response, which is always 'Darwin' for MacOS.
+        /// This code is derived from the Mono project (see System.Windows.Forms/System.Windows.Forms/XplatUI.cs). It detects macOS by calling the
+        /// <c>uname</c> system command and checking the response, which is always 'Darwin' for macOS.
         /// </remarks>
         private static bool IsRunningMac()
         {
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
index 925e0b5c..afebba87 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
@@ -18,7 +18,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <summary>The mod patches the game in a way that may impact stability.</summary>
         PatchesGame = 4,
 
-        /// <summary>The mod uses the <c>dynamic</c> keyword which won't work on Linux/Mac.</summary>
+        /// <summary>The mod uses the <c>dynamic</c> keyword which won't work on Linux/macOS.</summary>
         UsesDynamic = 8,
 
         /// <summary>The mod references specialized 'unvalidated update tick' events which may impact stability.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index fd206d9d..30177fc5 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -21,7 +21,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         private readonly HashSet<Regex> IgnoreFilesystemNames = new HashSet<Regex>
         {
             new Regex(@"^__folder_managed_by_vortex$", RegexOptions.Compiled | RegexOptions.IgnoreCase), // Vortex mod manager
-            new Regex(@"(?:^\._|^\.DS_Store$|^__MACOSX$|^mcs$)", RegexOptions.Compiled | RegexOptions.IgnoreCase), // MacOS
+            new Regex(@"(?:^\._|^\.DS_Store$|^__MACOSX$|^mcs$)", RegexOptions.Compiled | RegexOptions.IgnoreCase), // macOS
             new Regex(@"^(?:desktop\.ini|Thumbs\.db)$", RegexOptions.Compiled | RegexOptions.IgnoreCase) // Windows
         };
 
@@ -136,7 +136,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
                     return new ModFolder(root, searchFolder, ModType.Xnb, null, ModParseError.XnbMod, "it's not a SMAPI mod (see https://smapi.io/xnb for info).");
 
                 // SMAPI installer
-                if (relevantFiles.Any(p => p.Name == "install on Linux.sh" || p.Name == "install on Mac.command" || p.Name == "install on Windows.bat"))
+                if (relevantFiles.Any(p => p.Name == "install on Linux.sh" || p.Name == "install on macOS.command" || p.Name == "install on Windows.bat"))
                     return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.ManifestMissing, "the SMAPI installer isn't a mod (you can delete this folder after running the installer file).");
 
                 // not a mod?
diff --git a/src/SMAPI.Toolkit/Utilities/Platform.cs b/src/SMAPI.Toolkit/Utilities/Platform.cs
index f780e812..563d3250 100644
--- a/src/SMAPI.Toolkit/Utilities/Platform.cs
+++ b/src/SMAPI.Toolkit/Utilities/Platform.cs
@@ -9,7 +9,7 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <summary>The Linux version of the game.</summary>
         Linux,
 
-        /// <summary>The Mac version of the game.</summary>
+        /// <summary>The macOS version of the game.</summary>
         Mac,
 
         /// <summary>The Windows version of the game.</summary>
diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index bd1f8c9b..2556936c 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -231,7 +231,7 @@ namespace StardewModdingAPI.Web
                         : null
                 }))
 
-                // redirect to HTTPS (except API for Linux/Mac Mono compatibility)
+                // redirect to HTTPS (except API for Linux/macOS Mono compatibility)
                 .Add(
                     new RedirectToHttpsRule(except: req => req.Host.Host == "localhost" || req.Path.StartsWithSegments("/api"))
                 );
diff --git a/src/SMAPI.Web/Views/Index/Index.cshtml b/src/SMAPI.Web/Views/Index/Index.cshtml
index d78a155e..9d6e4bed 100644
--- a/src/SMAPI.Web/Views/Index/Index.cshtml
+++ b/src/SMAPI.Web/Views/Index/Index.cshtml
@@ -19,7 +19,7 @@
 </h1>
 <div id="blurb">
     <p>The mod loader for Stardew Valley.</p>
-    <p>Compatible with GOG/Steam achievements and Linux/Mac/Windows, uninstall anytime, and there's a friendly community if you need help.</p>
+    <p>Compatible with GOG/Steam achievements and Linux/macOS/Windows, uninstall anytime, and there's a friendly community if you need help.</p>
 </div>
 
 <div id="call-to-action">
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index fd472673..06d46c9e 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -120,7 +120,7 @@ else if (Model.ParsedLog?.IsValid == true)
         </ol>
     </div>
     <div data-os="@Platform.Mac">
-        On Mac:
+        On macOS:
         <ol>
             <li>Open the Finder app.</li>
             <li>Click <em>Go</em> at the top, then <em>Go to Folder</em>.</li>
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 8cc60a73..eeda13eb 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -109,7 +109,7 @@
 
         "Rubydew": {
             "ID": "bwdy.rubydew",
-            "SuppressWarnings": "UsesDynamic", // mod explicitly loads DLLs for Linux/Mac compatibility
+            "SuppressWarnings": "UsesDynamic", // mod explicitly loads DLLs for Linux/macOS compatibility
             "Default | UpdateKey": "Nexus:3656"
         },
 
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index af9b7aa2..079c9251 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -247,7 +247,7 @@ namespace StardewModdingAPI
                     "Stardew Valley"
                 });
                 targetAssemblies.Add(
-                    typeof(StardewValley.Game1).Assembly // note: includes Netcode types on Linux/Mac
+                    typeof(StardewValley.Game1).Assembly // note: includes Netcode types on Linux/macOS
                 );
             }
             else
diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 5f91610e..529fb93a 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -12,7 +12,7 @@ namespace StardewModdingAPI.Framework.Content
         ** Fields
         *********/
         /// <summary>The minimum value to consider non-transparent.</summary>
-        /// <remarks>On Linux/Mac, fully transparent pixels may have an alpha up to 4 for some reason.</remarks>
+        /// <remarks>On Linux/macOS, fully transparent pixels may have an alpha up to 4 for some reason.</remarks>
         private const byte MinOpacity = 5;
 
 
@@ -82,7 +82,7 @@ namespace StardewModdingAPI.Framework.Content
                     // premultiplied by the content pipeline. The formula is derived from
                     // https://blogs.msdn.microsoft.com/shawnhar/2009/11/06/premultiplied-alpha/.
                     // Note: don't use named arguments here since they're different between
-                    // Linux/Mac and Windows.
+                    // Linux/macOS and Windows.
                     float alphaBelow = 1 - (above.A / 255f);
                     newData[i] = new Color(
                         (int)(above.R + (below.R * alphaBelow)), // r
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index a6835dbe..0660a367 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -18,7 +18,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Encapsulates SMAPI's JSON file parsing.</summary>
         private readonly JsonHelper JsonHelper;
 
-        /// <summary>A cache of case-insensitive => exact relative paths within the content pack, for case-insensitive file lookups on Linux/Mac.</summary>
+        /// <summary>A cache of case-insensitive => exact relative paths within the content pack, for case-insensitive file lookups on Linux/macOS.</summary>
         private readonly IDictionary<string, string> RelativePaths = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
 
 
diff --git a/src/SMAPI/Framework/Logging/LogFileManager.cs b/src/SMAPI/Framework/Logging/LogFileManager.cs
index 6b5babcd..6ab2bdfb 100644
--- a/src/SMAPI/Framework/Logging/LogFileManager.cs
+++ b/src/SMAPI/Framework/Logging/LogFileManager.cs
@@ -44,7 +44,7 @@ namespace StardewModdingAPI.Framework.Logging
         public void WriteLine(string message)
         {
             // always use Windows-style line endings for convenience
-            // (Linux/Mac editors are fine with them, Windows editors often require them)
+            // (Linux/macOS editors are fine with them, Windows editors often require them)
             this.Stream.Write(message + "\r\n");
         }
 
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 4ba4fffc..0cc2da9f 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -527,7 +527,7 @@ namespace StardewModdingAPI.Framework.Logging
 
                 // not crossplatform
                 this.LogModWarningGroup(modsWithWarnings, ModWarning.UsesDynamic, LogLevel.Debug, "Not crossplatform",
-                    "These mods use the 'dynamic' keyword, and won't work on Linux/Mac."
+                    "These mods use the 'dynamic' keyword, and won't work on Linux/macOS."
                 );
             }
         }
diff --git a/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs b/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
index a948213b..baffc50e 100644
--- a/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
+++ b/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
@@ -20,7 +20,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>The instruction is compatible, but affects the save serializer in a way that may make saves unloadable without the mod.</summary>
         DetectedSaveSerializer,
 
-        /// <summary>The instruction is compatible, but uses the <c>dynamic</c> keyword which won't work on Linux/Mac.</summary>
+        /// <summary>The instruction is compatible, but uses the <c>dynamic</c> keyword which won't work on Linux/macOS.</summary>
         DetectedDynamic,
 
         /// <summary>The instruction is compatible, but references <see cref="ISpecializedEvents.UnvalidatedUpdateTicking"/> or <see cref="ISpecializedEvents.UnvalidatedUpdateTicked"/> which may impact stability.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
index cf71af77..aefd1c20 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
@@ -4,10 +4,10 @@ using Microsoft.Xna.Framework.Graphics;
 
 namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
 {
-    /// <summary>Provides <see cref="SpriteBatch"/> method signatures that can be injected into mod code for compatibility between Linux/Mac or Windows.</summary>
+    /// <summary>Provides <see cref="SpriteBatch"/> method signatures that can be injected into mod code for compatibility between Linux/macOS or Windows.</summary>
     /// <remarks>This is public to support SMAPI rewriting and should not be referenced directly by mods.</remarks>
     [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Used via assembly rewriting")]
-    [SuppressMessage("ReSharper", "CS0109", Justification = "The 'new' modifier applies when compiled on Linux/Mac.")]
+    [SuppressMessage("ReSharper", "CS0109", Justification = "The 'new' modifier applies when compiled on Linux/macOS.")]
     [SuppressMessage("ReSharper", "CS1591", Justification = "Documentation not needed for facade classes.")]
     public class SpriteBatchFacade : SpriteBatch
     {
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 22c58099..e8c8a8e5 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -187,7 +187,7 @@ namespace StardewModdingAPI.Framework
 #if SMAPI_FOR_WINDOWS
             if (Constants.Platform != Platform.Windows)
             {
-                this.Monitor.Log("Oops! You're running Windows, but this version of SMAPI is for Linux or Mac. Please reinstall SMAPI to fix this.", LogLevel.Error);
+                this.Monitor.Log("Oops! You're running Windows, but this version of SMAPI is for Linux or macOS. Please reinstall SMAPI to fix this.", LogLevel.Error);
                 this.LogManager.PressAnyKeyToExit();
             }
 #else
@@ -1259,7 +1259,7 @@ namespace StardewModdingAPI.Framework
                 // create client
                 string url = this.Settings.WebApiBaseUrl;
 #if !SMAPI_FOR_WINDOWS
-                url = url.Replace("https://", "http://"); // workaround for OpenSSL issues with the game's bundled Mono on Linux/Mac
+                url = url.Replace("https://", "http://"); // workaround for OpenSSL issues with the game's bundled Mono on Linux/macOS
 #endif
                 WebApiClient client = new WebApiClient(url, Constants.ApiVersion);
                 this.Monitor.Log("Checking for updates...");
diff --git a/src/SMAPI/Framework/Serialization/ColorConverter.cs b/src/SMAPI/Framework/Serialization/ColorConverter.cs
index 7315f1a5..3b3720b5 100644
--- a/src/SMAPI/Framework/Serialization/ColorConverter.cs
+++ b/src/SMAPI/Framework/Serialization/ColorConverter.cs
@@ -8,7 +8,7 @@ namespace StardewModdingAPI.Framework.Serialization
 {
     /// <summary>Handles deserialization of <see cref="Color"/> for crossplatform compatibility.</summary>
     /// <remarks>
-    /// - Linux/Mac format: { "B": 76, "G": 51, "R": 25, "A": 102 }
+    /// - Linux/macOS format: { "B": 76, "G": 51, "R": 25, "A": 102 }
     /// - Windows format:   "26, 51, 76, 102"
     /// </remarks>
     internal class ColorConverter : SimpleReadOnlyConverter<Color>
diff --git a/src/SMAPI/Framework/Serialization/PointConverter.cs b/src/SMAPI/Framework/Serialization/PointConverter.cs
index 6cf795dc..21d1f845 100644
--- a/src/SMAPI/Framework/Serialization/PointConverter.cs
+++ b/src/SMAPI/Framework/Serialization/PointConverter.cs
@@ -8,7 +8,7 @@ namespace StardewModdingAPI.Framework.Serialization
 {
     /// <summary>Handles deserialization of <see cref="Point"/> for crossplatform compatibility.</summary>
     /// <remarks>
-    /// - Linux/Mac format: { "X": 1, "Y": 2 }
+    /// - Linux/macOS format: { "X": 1, "Y": 2 }
     /// - Windows format:   "1, 2"
     /// </remarks>
     internal class PointConverter : SimpleReadOnlyConverter<Point>
diff --git a/src/SMAPI/Framework/Serialization/RectangleConverter.cs b/src/SMAPI/Framework/Serialization/RectangleConverter.cs
index 8f7318b3..31f3ad77 100644
--- a/src/SMAPI/Framework/Serialization/RectangleConverter.cs
+++ b/src/SMAPI/Framework/Serialization/RectangleConverter.cs
@@ -9,7 +9,7 @@ namespace StardewModdingAPI.Framework.Serialization
 {
     /// <summary>Handles deserialization of <see cref="Rectangle"/> for crossplatform compatibility.</summary>
     /// <remarks>
-    /// - Linux/Mac format: { "X": 1, "Y": 2, "Width": 3, "Height": 4 }
+    /// - Linux/macOS format: { "X": 1, "Y": 2, "Width": 3, "Height": 4 }
     /// - Windows format:   "{X:1 Y:2 Width:3 Height:4}"
     /// </remarks>
     internal class RectangleConverter : SimpleReadOnlyConverter<Rectangle>
diff --git a/src/SMAPI/Framework/Serialization/Vector2Converter.cs b/src/SMAPI/Framework/Serialization/Vector2Converter.cs
index 3e2ab776..589febf8 100644
--- a/src/SMAPI/Framework/Serialization/Vector2Converter.cs
+++ b/src/SMAPI/Framework/Serialization/Vector2Converter.cs
@@ -8,7 +8,7 @@ namespace StardewModdingAPI.Framework.Serialization
 {
     /// <summary>Handles deserialization of <see cref="Vector2"/> for crossplatform compatibility.</summary>
     /// <remarks>
-    /// - Linux/Mac format: { "X": 1, "Y": 2 }
+    /// - Linux/macOS format: { "X": 1, "Y": 2 }
     /// - Windows format:   "1, 2"
     /// </remarks>
     internal class Vector2Converter : SimpleReadOnlyConverter<Vector2>
diff --git a/src/SMAPI/GamePlatform.cs b/src/SMAPI/GamePlatform.cs
index b64595e4..cce5ed8d 100644
--- a/src/SMAPI/GamePlatform.cs
+++ b/src/SMAPI/GamePlatform.cs
@@ -11,7 +11,7 @@ namespace StardewModdingAPI
         /// <summary>The Linux version of the game.</summary>
         Linux = Platform.Linux,
 
-        /// <summary>The Mac version of the game.</summary>
+        /// <summary>The macOS version of the game.</summary>
         Mac = Platform.Mac,
 
         /// <summary>The Windows version of the game.</summary>
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 034eceed..b8179207 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -71,7 +71,7 @@ copy all the settings, or you may cause bugs due to overridden changes in future
 
     /**
      * The base URL for SMAPI's web API, used to perform update checks.
-     * Note: the protocol will be changed to http:// on Linux/Mac due to OpenSSL issues with the
+     * Note: the protocol will be changed to http:// on Linux/macOS due to OpenSSL issues with the
      * game's bundled Mono.
      */
     "WebApiBaseUrl": "https://smapi.io/api/",
@@ -85,7 +85,7 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      * The colors to use for text written to the SMAPI console.
      *
      * The possible values for 'UseScheme' are:
-     *  - AutoDetect: SMAPI will assume a light background on Mac, and detect the background color
+     *  - AutoDetect: SMAPI will assume a light background on macOS, and detect the background color
      *    automatically on Linux or Windows.
      *  - LightBackground: use darker text colors that look better on a white or light background.
      *  - DarkBackground: use lighter text colors that look better on a black or dark background.

From 2b1b3b19a507876e106a444c93b4c33aca35c353 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 4 Apr 2021 11:40:08 -0400
Subject: [PATCH 148/856] improve error-handling during asset propagation

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Framework/ContentCoordinator.cs |  2 +-
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 26 ++++++++++++++++++-----
 3 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index cb0be542..77c3bfbe 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,6 +18,7 @@
 
 * For modders:
   * Added asset propagation for `Data\Concessions`.
+  * Improved error-handling during asset propagation.
 
 ## 3.9.5
 Released 21 March 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 2920e670..d0e759c2 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -132,7 +132,7 @@ namespace StardewModdingAPI.Framework
             );
             this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
-            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, reflection, aggressiveMemoryOptimizations);
+            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations);
         }
 
         /// <summary>Get a new content manager which handles reading files from the game content folder with support for interception.</summary>
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 83ed52ad..3146ceaf 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -5,6 +5,7 @@ using System.IO;
 using System.Linq;
 using Microsoft.Xna.Framework.Graphics;
 using Netcode;
+using StardewModdingAPI.Framework;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -36,15 +37,18 @@ namespace StardewModdingAPI.Metadata
         /// <summary>An internal content manager used only for asset propagation. See remarks on <see cref="GameContentManagerForAssetPropagation"/>.</summary>
         private readonly GameContentManagerForAssetPropagation DisposableContentManager;
 
+        /// <summary>Writes messages to the console.</summary>
+        private readonly IMonitor Monitor;
+
+        /// <summary>Simplifies access to private game code.</summary>
+        private readonly Reflector Reflection;
+
         /// <summary>Whether to enable more aggressive memory optimizations.</summary>
         private readonly bool AggressiveMemoryOptimizations;
 
         /// <summary>Normalizes an asset key to match the cache key and assert that it's valid.</summary>
         private readonly Func<string, string> AssertAndNormalizeAssetName;
 
-        /// <summary>Simplifies access to private game code.</summary>
-        private readonly Reflector Reflection;
-
         /// <summary>Optimized bucket categories for batch reloading assets.</summary>
         private enum AssetBucket
         {
@@ -65,12 +69,14 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Initialize the core asset data.</summary>
         /// <param name="mainContent">The main content manager through which to reload assets.</param>
         /// <param name="disposableContent">An internal content manager used only for asset propagation.</param>
+        /// <param name="monitor">Writes messages to the console.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, Reflector reflection, bool aggressiveMemoryOptimizations)
+        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, IMonitor monitor, Reflector reflection, bool aggressiveMemoryOptimizations)
         {
             this.MainContentManager = mainContent;
             this.DisposableContentManager = disposableContent;
+            this.Monitor = monitor;
             this.Reflection = reflection;
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
 
@@ -116,7 +122,17 @@ namespace StardewModdingAPI.Metadata
                     default:
                         foreach (var entry in bucket)
                         {
-                            bool changed = this.PropagateOther(entry.Key, entry.Value, ignoreWorld, out bool curChangedMapWarps);
+                            bool changed = false;
+                            bool curChangedMapWarps = false;
+                            try
+                            {
+                                changed = this.PropagateOther(entry.Key, entry.Value, ignoreWorld, out curChangedMapWarps);
+                            }
+                            catch (Exception ex)
+                            {
+                                this.Monitor.Log($"An error occurred while propagating asset changes. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                            }
+
                             propagatedAssets[entry.Key] = changed;
                             updatedNpcWarps = updatedNpcWarps || curChangedMapWarps;
                         }

From c7db35818b93ea4735c2b69ce28cd0a24e603d14 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 4 Apr 2021 12:09:07 -0400
Subject: [PATCH 149/856] fix Context.IsMainPlayer incorrectly true when
 split-screen player is joining

---
 docs/release-notes.md | 1 +
 src/SMAPI/Context.cs  | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 77c3bfbe..8e749490 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -19,6 +19,7 @@
 * For modders:
   * Added asset propagation for `Data\Concessions`.
   * Improved error-handling during asset propagation.
+  * Fixed `Context.IsMainPlayer` returning true for a farmhand in split-screen mode before the screen is initialized.
 
 ## 3.9.5
 Released 21 March 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index 5f70d0f7..a745592c 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -86,7 +86,7 @@ namespace StardewModdingAPI
         public static bool HasRemotePlayers => Context.IsMultiplayer && !Game1.hasLocalClientsOnly;
 
         /// <summary>Whether the current player is the main player. This is always true in single-player, and true when hosting in multiplayer.</summary>
-        public static bool IsMainPlayer => Game1.IsMasterGame && !(TitleMenu.subMenu is FarmhandMenu);
+        public static bool IsMainPlayer => Game1.IsMasterGame && Context.ScreenId == 0 && !(TitleMenu.subMenu is FarmhandMenu);
 
 
         /*********

From bca1e63c3e66011aef8cb9736e091ced05aa4992 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 4 Apr 2021 12:11:06 -0400
Subject: [PATCH 150/856] fix error when mod edits bundle data while a
 split-screen player is joining

---
 docs/release-notes.md                     | 1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 1 +
 2 files changed, 2 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8e749490..fabc6684 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -20,6 +20,7 @@
   * Added asset propagation for `Data\Concessions`.
   * Improved error-handling during asset propagation.
   * Fixed `Context.IsMainPlayer` returning true for a farmhand in split-screen mode before the screen is initialized.
+  * Fixed error when editing bundle data while a split-screen player is joining.
 
 ## 3.9.5
 Released 21 March 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 3146ceaf..623c65d5 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -274,6 +274,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "data\\bundles": // NetWorldState constructor
+                    if (Context.IsMainPlayer && Game1.netWorldState != null)
                     {
                         var bundles = this.Reflection.GetField<NetBundles>(Game1.netWorldState.Value, "bundles").GetValue();
                         var rewards = this.Reflection.GetField<NetIntDictionary<bool, NetBool>>(Game1.netWorldState.Value, "bundleRewards").GetValue();

From f961a376ee5347d5ac2b830ce82b28f116889e72 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 15 Apr 2021 21:17:19 -0400
Subject: [PATCH 151/856] log Stardew64Installer patch version if applicable
 (#767)

---
 src/SMAPI/Framework/Logging/LogManager.cs | 37 +++++++++++++++++------
 1 file changed, 28 insertions(+), 9 deletions(-)

diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 0cc2da9f..804acfb3 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
+using System.Reflection;
 using System.Text.RegularExpressions;
 using System.Threading;
 using StardewModdingAPI.Framework.Commands;
@@ -11,6 +12,7 @@ using StardewModdingAPI.Framework.ModLoading;
 using StardewModdingAPI.Internal.ConsoleWriting;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Utilities;
+using StardewValley;
 
 namespace StardewModdingAPI.Framework.Logging
 {
@@ -283,16 +285,16 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="customSettings">The custom SMAPI settings.</param>
         public void LogIntro(string modsPath, IDictionary<string, object> customSettings)
         {
-            // get platform label
-            string platformLabel = EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform);
-            if ((Constants.GameFramework == GameFramework.Xna) != (Constants.Platform == Platform.Windows))
-                platformLabel += $" with {Constants.GameFramework}";
-#if SMAPI_FOR_WINDOWS_64BIT_HACK
-            platformLabel += " 64-bit hack";
-#endif
+            // log platform & patches
+            {
+                this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
 
-            // init logging
-            this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {platformLabel}", LogLevel.Info);
+                string[] patchLabels = this.GetPatchLabels().ToArray();
+                if (patchLabels.Any())
+                    this.Monitor.Log($"Detected custom version: {string.Join(", ", patchLabels)}", LogLevel.Info);
+            }
+
+            // log basic info
             this.Monitor.Log($"Mods go here: {modsPath}", LogLevel.Info);
             if (modsPath != Constants.DefaultModsPath)
                 this.Monitor.Log("(Using custom --mods-path argument.)");
@@ -409,6 +411,23 @@ namespace StardewModdingAPI.Framework.Logging
             gameMonitor.Log(message, level);
         }
 
+        /// <summary>Get human-readable labels to log for detected SMAPI and Stardew Valley customizations.</summary>
+        private IEnumerable<string> GetPatchLabels()
+        {
+            // custom game framework
+            if (EarlyConstants.IsWindows64BitHack)
+                yield return $"running 64-bit SMAPI with {Constants.GameFramework}";
+            else if ((Constants.GameFramework == GameFramework.Xna) != (Constants.Platform == Platform.Windows))
+                yield return $"running {Constants.GameFramework}";
+
+            // patched by Stardew64Installer
+            {
+                PropertyInfo patcherProperty = typeof(Game1).GetProperty("Stardew64InstallerVersion");
+                if (patcherProperty != null)
+                    yield return $"patched by Stardew64Installer {patcherProperty.GetValue(null)}";
+            }
+        }
+
         /// <summary>Write a summary of mod warnings to the console and log.</summary>
         /// <param name="mods">The loaded mods.</param>
         /// <param name="skippedMods">The mods which could not be loaded.</param>

From 9174e17f5372905d3f494e1b36688f41dff367cc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 17 Apr 2021 22:10:51 -0400
Subject: [PATCH 152/856] mark field readonly

---
 src/SMAPI/Framework/ModLoading/ModMetadata.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index 0d89fd20..17e6d59a 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -20,7 +20,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         private ModWarning ActualWarnings = ModWarning.None;
 
         /// <summary>The mod IDs which are listed as a requirement by this mod. The value for each pair indicates whether the dependency is required (i.e. not an optional dependency).</summary>
-        private Lazy<IDictionary<string, bool>> Dependencies;
+        private readonly Lazy<IDictionary<string, bool>> Dependencies;
 
 
         /*********

From ed47c2a0cebfbb68ca5f429ff77159180c7f03e8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 17 Apr 2021 22:11:21 -0400
Subject: [PATCH 153/856] update schema for Content Patcher 1.22

---
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index f5056eb1..49900da6 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -11,9 +11,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features and avoid obsolete behavior.",
             "type": "string",
-            "const": "1.21.0",
+            "const": "1.22.0",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.21.0'."
+                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.22.0'."
             }
         },
         "ConfigSchema": {

From 13a3c8fbddb9dd47d30e1b9684d3ceb048086e91 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 22 Apr 2021 18:13:45 -0400
Subject: [PATCH 154/856] add SMAPI version and bitness to console title
 earlier

---
 docs/release-notes.md  | 1 +
 src/SMAPI/Constants.cs | 5 ++++-
 src/SMAPI/Program.cs   | 4 +++-
 3 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index fabc6684..974c0ef3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,7 @@
 * For players:
   * When many mods fail to load, root dependencies are now listed in their own group so it's easier to see which ones you should try updating first.
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
+  * Added SMAPI version and bitness to the console title before startup to simplify troubleshooting.
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
   * Fixed inconsistent spelling/style for 'macOS'.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 079c9251..b55104c0 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -59,6 +59,9 @@ namespace StardewModdingAPI
 
         /// <summary>The <see cref="Context.ScreenId"/> value which should appear in the SMAPI log, if any.</summary>
         internal static int? LogScreenId { get; set; }
+
+        /// <summary>SMAPI's current raw semantic version.</summary>
+        internal static string RawApiVersion = "3.9.5";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>
@@ -71,7 +74,7 @@ namespace StardewModdingAPI
         ** Public
         ****/
         /// <summary>SMAPI's current semantic version.</summary>
-        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion("3.9.5");
+        public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion(EarlyConstants.RawApiVersion);
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 986d2780..e830f799 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -24,6 +24,8 @@ namespace StardewModdingAPI
         /// <param name="args">The command-line arguments.</param>
         public static void Main(string[] args)
         {
+            Console.Title = $"SMAPI {EarlyConstants.RawApiVersion}{(EarlyConstants.IsWindows64BitHack ? " 64-bit" : "")} - {Console.Title}";
+
             try
             {
                 AppDomain.CurrentDomain.AssemblyResolve += Program.CurrentDomain_AssemblyResolve;
@@ -159,7 +161,7 @@ namespace StardewModdingAPI
                 Console.ResetColor();
                 Console.WriteLine();
             }
-            
+
             Program.PressAnyKeyToExit(showMessage: true);
         }
 

From 665c6806d3797f8329ef8c6fcaa80d469fef5005 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 22 Apr 2021 21:52:09 -0400
Subject: [PATCH 155/856] add update alerts for Stardew64Installer (#767)

---
 docs/release-notes.md                     |  3 +-
 src/SMAPI/Constants.cs                    | 15 ++++++++++
 src/SMAPI/Framework/Logging/LogManager.cs |  9 ++----
 src/SMAPI/Framework/Models/SConfig.cs     |  3 ++
 src/SMAPI/Framework/SCore.cs              | 35 +++++++++++++++++++++++
 src/SMAPI/SMAPI.config.json               |  5 ++++
 6 files changed, 62 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 974c0ef3..748e62c5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,7 +11,7 @@
 * For players:
   * When many mods fail to load, root dependencies are now listed in their own group so it's easier to see which ones you should try updating first.
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
-  * Added SMAPI version and bitness to the console title before startup to simplify troubleshooting.
+  * Added update checks for Stardew64Installer if it patched the game.
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
   * Fixed inconsistent spelling/style for 'macOS'.
@@ -19,6 +19,7 @@
 
 * For modders:
   * Added asset propagation for `Data\Concessions`.
+  * Added SMAPI version and bitness to the console title before startup to simplify troubleshooting.
   * Improved error-handling during asset propagation.
   * Fixed `Context.IsMainPlayer` returning true for a farmhand in split-screen mode before the screen is initialized.
   * Fixed error when editing bundle data while a split-screen player is joining.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index b55104c0..161e92b4 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -300,6 +300,21 @@ namespace StardewModdingAPI
             return new PlatformAssemblyMap(targetPlatform, removeAssemblyReferences.ToArray(), targetAssemblies.ToArray());
         }
 
+        /// <summary>Get whether the game assembly was patched by Stardew64Installer.</summary>
+        /// <param name="version">The version of Stardew64Installer which was applied to the game assembly, if any.</param>
+        internal static bool IsPatchedByStardew64Installer(out ISemanticVersion version)
+        {
+            PropertyInfo property = typeof(Game1).GetProperty("Stardew64InstallerVersion");
+            if (property == null)
+            {
+                version = null;
+                return false;
+            }
+
+            version = new SemanticVersion((string)property.GetValue(null));
+            return true;
+        }
+
 
         /*********
         ** Private methods
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 804acfb3..a4df3c18 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -3,7 +3,6 @@ using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
-using System.Reflection;
 using System.Text.RegularExpressions;
 using System.Threading;
 using StardewModdingAPI.Framework.Commands;
@@ -12,7 +11,6 @@ using StardewModdingAPI.Framework.ModLoading;
 using StardewModdingAPI.Internal.ConsoleWriting;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Utilities;
-using StardewValley;
 
 namespace StardewModdingAPI.Framework.Logging
 {
@@ -421,11 +419,8 @@ namespace StardewModdingAPI.Framework.Logging
                 yield return $"running {Constants.GameFramework}";
 
             // patched by Stardew64Installer
-            {
-                PropertyInfo patcherProperty = typeof(Game1).GetProperty("Stardew64InstallerVersion");
-                if (patcherProperty != null)
-                    yield return $"patched by Stardew64Installer {patcherProperty.GetValue(null)}";
-            }
+            if (Constants.IsPatchedByStardew64Installer(out ISemanticVersion patchedByVersion))
+                yield return $"patched by Stardew64Installer {patchedByVersion}";
         }
 
         /// <summary>Write a summary of mod warnings to the console and log.</summary>
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 4a80e34c..a71bafd9 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -52,6 +52,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>SMAPI's GitHub project name, used to perform update checks.</summary>
         public string GitHubProjectName { get; set; }
 
+        /// <summary>Stardew64Installer's GitHub project name, used to perform update checks.</summary>
+        public string Stardew64InstallerGitHubProjectName { get; set; }
+
         /// <summary>The base URL for SMAPI's web API, used to perform update checks.</summary>
         public string WebApiBaseUrl { get; set; }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index e8c8a8e5..85a2bb8f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1302,6 +1302,41 @@ namespace StardewModdingAPI.Framework
                         this.LogManager.WriteUpdateMarker(updateFound.ToString(), updateUrl);
                 }
 
+                // check Stardew64Installer version
+                if (Constants.IsPatchedByStardew64Installer(out ISemanticVersion patchedByVersion))
+                {
+                    ISemanticVersion updateFound = null;
+                    string updateUrl = null;
+                    try
+                    {
+                        // fetch update check
+                        ModEntryModel response = client.GetModInfo(new[] { new ModSearchEntryModel("Steviegt6.Stardew64Installer", patchedByVersion, new[] { $"GitHub:{this.Settings.Stardew64InstallerGitHubProjectName}" }) }, apiVersion: Constants.ApiVersion, gameVersion: Constants.GameVersion, platform: Constants.Platform).Single().Value;
+                        updateFound = response.SuggestedUpdate?.Version;
+                        updateUrl = response.SuggestedUpdate?.Url ?? Constants.HomePageUrl;
+
+                        // log message
+                        if (updateFound != null)
+                            this.Monitor.Log($"You can update Stardew64Installer to {updateFound}: {updateUrl}", LogLevel.Alert);
+                        else
+                            this.Monitor.Log("   Stardew64Installer okay.");
+
+                        // show errors
+                        if (response.Errors.Any())
+                        {
+                            this.Monitor.Log("Couldn't check for a new version of Stardew64Installer. This won't affect your game, but you may not be notified of new versions if this keeps happening.", LogLevel.Warn);
+                            this.Monitor.Log($"Error: {string.Join("\n", response.Errors)}");
+                        }
+                    }
+                    catch (Exception ex)
+                    {
+                        this.Monitor.Log("Couldn't check for a new version of Stardew64Installer. This won't affect your game, but you won't be notified of new versions if this keeps happening.", LogLevel.Warn);
+                        this.Monitor.Log(ex is WebException && ex.InnerException == null
+                            ? $"Error: {ex.Message}"
+                            : $"Error: {ex.GetLogSummary()}"
+                        );
+                    }
+                }
+
                 // check mod versions
                 if (mods.Any())
                 {
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index b8179207..7b5625d6 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -69,6 +69,11 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "GitHubProjectName": "Pathoschild/SMAPI",
 
+    /**
+     * Stardew64Installer's GitHub project name, used to perform update checks.
+     */
+    "Stardew64InstallerGitHubProjectName": "Steviegt6/Stardew64Installer",
+
     /**
      * The base URL for SMAPI's web API, used to perform update checks.
      * Note: the protocol will be changed to http:// on Linux/macOS due to OpenSSL issues with the

From 47a806533b9fbcfe3fc771316283a7734702baae Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 23 Apr 2021 02:05:14 -0400
Subject: [PATCH 156/856] add 64-bit support to the SMAPI installer (#767)

---
 build/common.targets                          | 15 +++---
 docs/release-notes.md                         |  4 +-
 docs/technical/smapi.md                       | 17 +++---
 .../Framework/InstallerPaths.cs               | 11 +++-
 src/SMAPI.Installer/InteractiveInstaller.cs   | 53 ++++++++++++++++---
 .../Framework/GameScanning/GameScanner.cs     | 11 ++--
 6 files changed, 84 insertions(+), 27 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 4068c491..6834c162 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,13 +1,16 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <!--set properties -->
   <PropertyGroup>
+    <!--set general build properties -->
     <Version>3.9.5</Version>
     <Product>SMAPI</Product>
-
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
 
-    <!--<DefineConstants>$(DefineConstants);SMAPI_FOR_WINDOWS_64BIT_HACK</DefineConstants>-->
+    <!--uncomment for 64-bit Stardew Valley on Windows-->
+    <!--<GamePath>D:\dev\SDV 64-bit\6125897</GamePath>
+    <DefineConstants>$(DefineConstants);SMAPI_FOR_WINDOWS_64BIT_HACK</DefineConstants>-->
+
+    <!--set platform-->
     <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
     <DefineConstants Condition="$(OS) == 'Windows_NT' AND !$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))">$(DefineConstants);SMAPI_FOR_XNA</DefineConstants>
   </PropertyGroup>
@@ -53,9 +56,9 @@
   </Target>
 
   <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit' AND $(TargetFramework) == 'net4.5'" AfterTargets="PostBuildEvent">
-      <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
-      <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
-      <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
 
   <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces' AND $(TargetFramework) == 'net4.5'" AfterTargets="PostBuildEvent">
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 748e62c5..9de285ae 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,13 +9,13 @@
 
 ## Upcoming release
 * For players:
+  * Added support for unofficial 64-bit Stardew Valley, including automatic support in the SMAPI installer.
+  * Added update checks for Stardew64Installer if it patched the game.
   * When many mods fail to load, root dependencies are now listed in their own group so it's easier to see which ones you should try updating first.
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
-  * Added update checks for Stardew64Installer if it patched the game.
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
   * Fixed inconsistent spelling/style for 'macOS'.
-  * Internal changes to prepare for unofficial 64-bit.
 
 * For modders:
   * Added asset propagation for `Data\Concessions`.
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index ca1631cd..b64239c1 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -82,7 +82,9 @@ To prepare a crossplatform SMAPI release, you'll need to compile it on two platf
 [crossplatforming info](https://stardewvalleywiki.com/Modding:Modder_Guide/Test_and_Troubleshoot#Testing_on_all_platforms)
 on the wiki for the first-time setup.
 
-1. Update the version numbers in `build/common.targets`, `Constants`, and the `manifest.json` for
+1. [Install a separate 64-bit version of Stardew Valley](https://github.com/Steviegt6/Stardew64Installer#readme)
+   on Windows.
+2. Update the version numbers in `build/common.targets`, `Constants`, and the `manifest.json` for
    bundled mods. Make sure you use a [semantic version](https://semver.org). Recommended format:
 
    build type | format                   | example
@@ -90,12 +92,15 @@ on the wiki for the first-time setup.
    dev build  | `<version>-alpha.<date>` | `3.0.0-alpha.20171230`
    prerelease | `<version>-beta.<date>`  | `3.0.0-beta.20171230`
    release    | `<version>`              | `3.0.0`
-
-2. In Windows:
+3. In Windows:
    1. Rebuild the solution with the _release_ solution configuration.
-   2. Copy `bin/SMAPI installer` and `bin/SMAPI installer for developers` to Linux/macOS.
-
-3. In Linux/macOS:
+   2. Back up the `bin/SMAPI installer` and `bin/SMAPI installer for developers` folders.
+   3. Edit `common.targets` and uncomment the Stardew Valley 64-bit section at the top.
+   4. Rebuild the solution again.
+   5. Rename the compiled `StardewModdingAPI.exe` file to `StardewModdingAPI-x64.exe`, and copy it
+      into the `windows-install.dat` files from step ii.
+   6. Copy the folders from step ii to Linux/MacOS.
+4. In Linux/macOS:
    1. Rebuild the solution with the _release_ solution configuration.
    2. Add the `windows-install.*` files from Windows to the `bin/SMAPI installer` and
       `bin/SMAPI installer for developers` folders compiled on Linux.
diff --git a/src/SMAPI.Installer/Framework/InstallerPaths.cs b/src/SMAPI.Installer/Framework/InstallerPaths.cs
index 2cabf88b..6ba5fa5f 100644
--- a/src/SMAPI.Installer/Framework/InstallerPaths.cs
+++ b/src/SMAPI.Installer/Framework/InstallerPaths.cs
@@ -44,8 +44,8 @@ namespace StardewModdingAPI.Installer.Framework
         /// <summary>The full path to the user's config overrides file.</summary>
         public string ApiUserConfigPath { get; }
 
-        /// <summary>The full path to the installed SMAPI executable file.</summary>
-        public string ExecutablePath { get; }
+        /// <summary>The full path to the installed game executable file.</summary>
+        public string ExecutablePath { get; private set; }
 
         /// <summary>The full path to the vanilla game launcher on Linux/macOS.</summary>
         public string UnixLauncherPath { get; }
@@ -79,5 +79,12 @@ namespace StardewModdingAPI.Installer.Framework
             this.ApiConfigPath = Path.Combine(gameDir.FullName, "smapi-internal", "config.json");
             this.ApiUserConfigPath = Path.Combine(gameDir.FullName, "smapi-internal", "config.user.json");
         }
+
+        /// <summary>Override the filename for the <see cref="ExecutablePath"/>.</summary>
+        /// <param name="filename">the file name.</param>
+        public void SetExecutableFileName(string filename)
+        {
+            this.ExecutablePath = Path.Combine(this.GamePath, filename);
+        }
     }
 }
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 376949da..6bfc6874 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Globalization;
 using System.IO;
 using System.Linq;
@@ -10,7 +11,6 @@ using StardewModdingAPI.Internal.ConsoleWriting;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Utilities;
-using System.Diagnostics;
 
 namespace StardewModdingApi.Installer
 {
@@ -275,7 +275,20 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 4: validate assumptions
+            ** Step 4: detect 64-bit Stardew Valley
+            *********/
+            // detect 64-bit mode
+            bool isWindows64Bit = false;
+            if (context.Platform == Platform.Windows)
+            {
+                FileInfo linuxExecutable = new FileInfo(Path.Combine(paths.GamePath, "StardewValley.exe"));
+                isWindows64Bit = linuxExecutable.Exists && this.Is64Bit(linuxExecutable.FullName);
+                if (isWindows64Bit)
+                    paths.SetExecutableFileName(linuxExecutable.Name);
+            }
+
+            /*********
+            ** Step 5: validate assumptions
             *********/
             // executable exists
             if (!File.Exists(paths.ExecutablePath))
@@ -298,7 +311,7 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 5: ask what to do
+            ** Step 6: ask what to do
             *********/
             ScriptAction action;
             {
@@ -306,7 +319,7 @@ namespace StardewModdingApi.Installer
                 ** print header
                 ****/
                 this.PrintInfo("Hi there! I'll help you install or remove SMAPI. Just one question first.");
-                this.PrintDebug($"Game path: {paths.GamePath}");
+                this.PrintDebug($"Game path: {paths.GamePath}{(context.IsWindows ? $" [{(isWindows64Bit ? "64-bit" : "32-bit")}]" : "")}");
                 this.PrintDebug($"Color scheme: {this.GetDisplayText(scheme)}");
                 this.PrintDebug("----------------------------------------------------------------------------");
                 Console.WriteLine();
@@ -344,14 +357,14 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 6: apply
+            ** Step 7: apply
             *********/
             {
                 /****
                 ** print header
                 ****/
                 this.PrintInfo($"That's all I need! I'll {action.ToString().ToLower()} SMAPI now.");
-                this.PrintDebug($"Game path: {paths.GamePath}");
+                this.PrintDebug($"Game path: {paths.GamePath}{(context.IsWindows ? $" [{(isWindows64Bit ? "64-bit" : "32-bit")}]" : "")}");
                 this.PrintDebug($"Color scheme: {this.GetDisplayText(scheme)}");
                 this.PrintDebug("----------------------------------------------------------------------------");
                 Console.WriteLine();
@@ -412,6 +425,27 @@ namespace StardewModdingApi.Installer
                         this.RecursiveCopy(sourceEntry, paths.GameDir);
                     }
 
+                    if (isWindows64Bit)
+                    {
+                        this.PrintDebug("Making SMAPI 64-bit...");
+                        FileInfo x64Executable = new FileInfo(Path.Combine(paths.BundleDir.FullName, "StardewModdingAPI-x64.exe"));
+                        if (x64Executable.Exists)
+                        {
+                            string targetName = "StardewModdingAPI.exe";
+                            this.InteractivelyDelete(Path.Combine(paths.GameDir.FullName, targetName));
+                            this.InteractivelyDelete(Path.Combine(paths.GameDir.FullName, x64Executable.Name));
+
+                            this.RecursiveCopy(x64Executable, paths.GameDir);
+                            File.Move(Path.Combine(paths.GamePath, x64Executable.Name), Path.Combine(paths.GamePath, targetName));
+                        }
+                        else
+                        {
+                            this.PrintError($"Oops! Could not find the required '{x64Executable.Name}' installer file. SMAPI was unable to install correctly.");
+                            Console.ReadLine();
+                            return;
+                        }
+                    }
+
                     // replace mod launcher (if possible)
                     if (context.IsUnix)
                     {
@@ -535,6 +569,13 @@ namespace StardewModdingApi.Installer
         /*********
         ** Private methods
         *********/
+        /// <summary>Get whether an executable is 64-bit.</summary>
+        /// <param name="executablePath">The absolute path to the executable file.</param>
+        private bool Is64Bit(string executablePath)
+        {
+            return AssemblyName.GetAssemblyName(executablePath).ProcessorArchitecture != ProcessorArchitecture.X86;
+        }
+
         /// <summary>Get the display text for a color scheme.</summary>
         /// <param name="scheme">The color scheme.</param>
         private string GetDisplayText(MonitorColorScheme scheme)
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index d18a2204..c90fc1d3 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -20,9 +20,6 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         /// <summary>The current OS.</summary>
         private readonly Platform Platform;
 
-        /// <summary>The name of the Stardew Valley executable.</summary>
-        private readonly string ExecutableName;
-
 
         /*********
         ** Public methods
@@ -31,7 +28,6 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         public GameScanner()
         {
             this.Platform = EnvironmentUtility.DetectPlatform();
-            this.ExecutableName = EnvironmentUtility.GetExecutableName(this.Platform);
         }
 
         /// <summary>Find all valid Stardew Valley install folders.</summary>
@@ -58,7 +54,12 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         /// <param name="dir">The folder to check.</param>
         public bool LooksLikeGameFolder(DirectoryInfo dir)
         {
-            return dir.Exists && dir.EnumerateFiles(this.ExecutableName).Any();
+            return
+                dir.Exists
+                && (
+                    dir.EnumerateFiles("StardewValley.exe").Any()
+                    || dir.EnumerateFiles("Stardew Valley.exe").Any()
+                );
         }
 
 

From fa72198d1d38a77df6b92fcf936862f644a04f10 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 23 Apr 2021 22:12:41 -0400
Subject: [PATCH 157/856] add [64-bit] tag to window titles (#767)

---
 src/SMAPI/Framework/SCore.cs | 38 ++++++++++++++++++------------------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 85a2bb8f..5862b112 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -263,10 +263,7 @@ namespace StardewModdingAPI.Framework
                 });
 
                 // set window titles
-                this.SetWindowTitles(
-                    game: $"Stardew Valley {Constants.GameVersion} - running SMAPI {Constants.ApiVersion}",
-                    smapi: $"SMAPI {Constants.ApiVersion} - running Stardew Valley {Constants.GameVersion}"
-                );
+                this.UpdateWindowTitles();
             }
             catch (Exception ex)
             {
@@ -280,10 +277,7 @@ namespace StardewModdingAPI.Framework
             this.LogManager.LogSettingsHeader(this.Settings);
 
             // set window titles
-            this.SetWindowTitles(
-                game: $"Stardew Valley {Constants.GameVersion} - running SMAPI {Constants.ApiVersion}",
-                smapi: $"SMAPI {Constants.ApiVersion} - running Stardew Valley {Constants.GameVersion}"
-            );
+            this.UpdateWindowTitles();
 
             // start game
             this.Monitor.Log("Starting game...", LogLevel.Debug);
@@ -387,11 +381,7 @@ namespace StardewModdingAPI.Framework
             }
 
             // update window titles
-            int modsLoaded = this.ModRegistry.GetAll().Count();
-            this.SetWindowTitles(
-                game: $"Stardew Valley {Constants.GameVersion} - running SMAPI {Constants.ApiVersion} with {modsLoaded} mods",
-                smapi: $"SMAPI {Constants.ApiVersion} - running Stardew Valley {Constants.GameVersion} with {modsLoaded} mods"
-            );
+            this.UpdateWindowTitles();
         }
 
         /// <summary>Raised after the game finishes initializing.</summary>
@@ -1238,13 +1228,23 @@ namespace StardewModdingAPI.Framework
             return !issuesFound;
         }
 
-        /// <summary>Set the window titles for the game and console windows.</summary>
-        /// <param name="game">The game window text.</param>
-        /// <param name="smapi">The SMAPI window text.</param>
-        private void SetWindowTitles(string game, string smapi)
+        /// <summary>Set the titles for the game and console windows.</summary>
+        private void UpdateWindowTitles()
         {
-            this.Game.Window.Title = game;
-            this.LogManager.SetConsoleTitle(smapi);
+            string smapiVersion = $"{Constants.ApiVersion}{(EarlyConstants.IsWindows64BitHack ? " [64-bit]" : "")}";
+
+            string consoleTitle = $"SMAPI {smapiVersion} - running Stardew Valley {Constants.GameVersion}";
+            string gameTitle = $"Stardew Valley {Constants.GameVersion} - running SMAPI {smapiVersion}";
+
+            if (this.ModRegistry.AreAllModsLoaded)
+            {
+                int modsLoaded = this.ModRegistry.GetAll().Count();
+                consoleTitle += $" with {modsLoaded} mods";
+                gameTitle += $" with {modsLoaded} mods";
+            }
+
+            this.Game.Window.Title = gameTitle;
+            this.LogManager.SetConsoleTitle(consoleTitle);
         }
 
         /// <summary>Asynchronously check for a new version of SMAPI and any installed mods, and print alerts to the console if an update is available.</summary>

From 9e8a7fa986329986b8f725a21c9b22fe347347bf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 24 Apr 2021 11:10:53 -0400
Subject: [PATCH 158/856] ignore *.ico files when scanning for mods (#773)

---
 docs/release-notes.md                                 | 1 +
 src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs | 1 +
 2 files changed, 2 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9de285ae..ddc3ab30 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
   * Added update checks for Stardew64Installer if it patched the game.
   * When many mods fail to load, root dependencies are now listed in their own group so it's easier to see which ones you should try updating first.
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
+  * `*.ico` files are now ignored when scanning for mods.
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
   * Fixed inconsistent spelling/style for 'macOS'.
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 30177fc5..e6105f9c 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -38,6 +38,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             // images
             ".bmp",
             ".gif",
+            ".ico",
             ".jpeg",
             ".jpg",
             ".png",

From 3de9858c9b89d13cfb69662a2d9e0ce03ff0593a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 30 Apr 2021 18:52:19 -0400
Subject: [PATCH 159/856] fix update subkeys for Nexus mods marked as adult
 content

---
 docs/release-notes.md                                | 3 +++
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj               | 2 +-
 src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs | 2 +-
 src/SMAPI.Web/SMAPI.Web.csproj                       | 4 ++--
 4 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ddc3ab30..b6b14f97 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -25,6 +25,9 @@
   * Fixed `Context.IsMainPlayer` returning true for a farmhand in split-screen mode before the screen is initialized.
   * Fixed error when editing bundle data while a split-screen player is joining.
 
+* For the web API:
+  * Fixed update subkeys not working in file descriptions for Nexus mods marked as adult content.
+
 ## 3.9.5
 Released 21 March 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index d8e32acf..0d96b486 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -11,7 +11,7 @@
   <ItemGroup>
     <PackageReference Include="HtmlAgilityPack" Version="1.11.28" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.0.0" />
+    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
     <PackageReference Include="System.Management" Version="4.5.0" Condition="'$(OS)' == 'Windows_NT'" />
     <PackageReference Include="Microsoft.Win32.Registry" Version="4.5.0" Condition="'$(OS)' == 'Windows_NT' AND '$(TargetFramework)' == 'netstandard2.0'" />
   </ItemGroup>
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
index ef3ef22e..4ba94f81 100644
--- a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
@@ -186,7 +186,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
                 Version = SemanticVersion.TryParse(mod.Version, out ISemanticVersion version) ? version?.ToString() : mod.Version,
                 Url = this.GetModUrl(id),
                 Downloads = files.Files
-                    .Select(file => (IModDownload)new GenericModDownload(file.Name, null, file.FileVersion))
+                    .Select(file => (IModDownload)new GenericModDownload(file.Name, file.Description, file.FileVersion))
                     .ToArray()
             };
         }
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index ce5ffdbd..f1bdb866 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -22,8 +22,8 @@
     <PackageReference Include="Markdig" Version="0.22.0" />
     <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.8" />
     <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.13" />
-    <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.1" />
-    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.0.0" />
+    <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.2" />
+    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
   </ItemGroup>
   <ItemGroup>
     <DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="1.0.1" />

From 621b989c243a8aa1ff5c4928026f2cfe087f378d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 30 Apr 2021 19:16:52 -0400
Subject: [PATCH 160/856] update web and unit test packages

---
 .../SMAPI.ModBuildConfig.Analyzer.Tests.csproj     |  4 ++--
 src/SMAPI.Tests/SMAPI.Tests.csproj                 |  4 ++--
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj             |  2 +-
 src/SMAPI.Web/SMAPI.Web.csproj                     | 14 +++++++-------
 4 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
index d0123e93..8cc61f44 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
@@ -7,8 +7,8 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="2.10.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.8.0" />
-    <PackageReference Include="NUnit" Version="3.12.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.9.4" />
+    <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="3.17.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index a0e5b2df..27520baf 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -16,9 +16,9 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Moq" Version="4.15.1" />
+    <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="NUnit" Version="3.12.0" />
+    <PackageReference Include="NUnit" Version="3.13.2" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 0d96b486..8dc4d559 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -9,7 +9,7 @@
   <Import Project="..\..\build\common.targets" />
 
   <ItemGroup>
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.28" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.33" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
     <PackageReference Include="System.Management" Version="4.5.0" Condition="'$(OS)' == 'Windows_NT'" />
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index f1bdb866..e9d209ec 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -13,15 +13,15 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Azure.Storage.Blobs" Version="12.7.0" />
-    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.17" />
+    <PackageReference Include="Azure.Storage.Blobs" Version="12.8.3" />
+    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.22" />
     <PackageReference Include="Hangfire.MemoryStorage" Version="1.7.0" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.28" />
-    <PackageReference Include="Humanizer.Core" Version="2.8.26" />
-    <PackageReference Include="JetBrains.Annotations" Version="2020.1.0" />
-    <PackageReference Include="Markdig" Version="0.22.0" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.33" />
+    <PackageReference Include="Humanizer.Core" Version="2.9.9" />
+    <PackageReference Include="JetBrains.Annotations" Version="2021.1.0" />
+    <PackageReference Include="Markdig" Version="0.24.0" />
     <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.8" />
-    <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.13" />
+    <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.14" />
     <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.2" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
   </ItemGroup>

From 99f70f963459912ce66f5a586eb4fc36e561b69d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 1 May 2021 12:33:09 -0400
Subject: [PATCH 161/856] match tilesheets without extension to .png files
 automatically if possible

---
 docs/release-notes.md                           |  1 +
 .../ContentManagers/ModContentManager.cs        | 17 +++++++++++++----
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b6b14f97..701471ee 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -21,6 +21,7 @@
 * For modders:
   * Added asset propagation for `Data\Concessions`.
   * Added SMAPI version and bitness to the console title before startup to simplify troubleshooting.
+  * If a map loads a tilesheet path with no file extension, SMAPI now automatically links it to a `.png` version in the map folder if possible.
   * Improved error-handling during asset propagation.
   * Fixed `Context.IsMainPlayer` returning true for a farmhand in split-screen mode before the screen is initialized.
   * Fixed error when editing bundle data while a split-screen player is joining.
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 9af14cb5..0cd431e8 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -34,6 +34,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>The language code for language-agnostic mod assets.</summary>
         private readonly LanguageCode DefaultLanguage = Constants.DefaultLanguage;
 
+        /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
+        private readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
+
 
         /*********
         ** Public methods
@@ -215,11 +218,17 @@ namespace StardewModdingAPI.Framework.ContentManagers
             FileInfo file = new FileInfo(Path.Combine(this.FullRootDirectory, path));
 
             // try with default extension
-            if (!file.Exists && file.Extension.ToLower() != ".xnb")
+            if (!file.Exists && file.Extension == string.Empty)
             {
-                FileInfo result = new FileInfo(file.FullName + ".xnb");
-                if (result.Exists)
-                    file = result;
+                foreach (string extension in this.LocalTilesheetExtensions)
+                {
+                    FileInfo result = new FileInfo(file.FullName + extension);
+                    if (result.Exists)
+                    {
+                        file = result;
+                        break;
+                    }
+                }
             }
 
             return file;

From 28c5cb79d4ca671881c54f473a9cfb6235298099 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 1 May 2021 17:39:34 -0400
Subject: [PATCH 162/856] add error-handling for seasonal tilesheet crash

---
 docs/release-notes.md                         |  3 +-
 .../Patches/GameLocationPatches.cs            | 59 +++++++++++++++++--
 .../SMAPI.Mods.ErrorHandler.csproj            |  1 +
 3 files changed, 58 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 701471ee..8b81264a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,7 +11,8 @@
 * For players:
   * Added support for unofficial 64-bit Stardew Valley, including automatic support in the SMAPI installer.
   * Added update checks for Stardew64Installer if it patched the game.
-  * When many mods fail to load, root dependencies are now listed in their own group so it's easier to see which ones you should try updating first.
+  * Added smarter grouping for skipped mods, so it's easier to see root dependencies to update first.
+  * Added error-handling to prevent a crash when the game can't update a map's seasonal tilesheets _(in Error Handler)_.
   * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
   * `*.ico` files are now ignored when scanning for mods.
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
index 1edf2d6a..7a48133e 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
@@ -8,10 +8,11 @@ using Harmony;
 #endif
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
+using xTile;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>A Harmony patch for <see cref="GameLocation.checkEventPrecondition"/> which intercepts invalid preconditions and logs an error instead of crashing.</summary>
+    /// <summary>Harmony patches for <see cref="GameLocation.checkEventPrecondition"/> and <see cref="GameLocation.updateSeasonalTileSheets"/> which intercept errors instead of crashing.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
@@ -39,17 +40,25 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         public void Apply(Harmony harmony)
         {
             harmony.Patch(
-                original: AccessTools.Method(typeof(GameLocation), "checkEventPrecondition"),
+                original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.checkEventPrecondition)),
                 finalizer: new HarmonyMethod(this.GetType(), nameof(EventErrorPatch.Finalize_GameLocation_CheckEventPrecondition))
             );
+harmony.Patch(
+                original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.updateSeasonalTileSheets)),
+                finalizer: new HarmonyMethod(this.GetType(), nameof(EventErrorPatch.Before_GameLocation_UpdateSeasonalTileSheets))
+            );
         }
 #else
         public void Apply(HarmonyInstance harmony)
         {
             harmony.Patch(
-                original: AccessTools.Method(typeof(GameLocation), "checkEventPrecondition"),
+                original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.checkEventPrecondition)),
                 prefix: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Before_GameLocation_CheckEventPrecondition))
             );
+            harmony.Patch(
+                original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.updateSeasonalTileSheets)),
+                prefix: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Before_GameLocation_UpdateSeasonalTileSheets))
+            );
         }
 #endif
 
@@ -74,7 +83,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             return null;
         }
 #else
-        /// <summary>The method to call instead of GameLocation.checkEventPrecondition.</summary>
+        /// <summary>The method to call instead of <see cref="GameLocation.checkEventPrecondition"/>.</summary>
         /// <param name="__instance">The instance being patched.</param>
         /// <param name="__result">The return value of the original method.</param>
         /// <param name="precondition">The precondition to be parsed.</param>
@@ -103,5 +112,47 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             }
         }
 #endif
+
+#if HARMONY_2
+        /// <summary>The method to call instead of <see cref="GameLocation.updateSeasonalTileSheets"/>.</summary>
+        /// <param name="__instance">The instance being patched.</param>
+        /// <param name="map">The map whose tilesheets to update.</param>
+        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
+        /// <returns>Returns the exception to throw, if any.</returns>
+        private static Exception Before_GameLocation_UpdateSeasonalTileSheets(GameLocation __instance, Map map, Exception __exception)
+        {
+            if (__exception != null)
+                GameLocationPatches.MonitorForGame.Log($"Failed updating seasonal tilesheets for location '{__instance.NameOrUniqueName}': \n{__exception}", LogLevel.Error);
+
+            return null;
+        }
+#else
+        /// <summary>The method to call instead of <see cref="GameLocation.updateSeasonalTileSheets"/>.</summary>
+        /// <param name="__instance">The instance being patched.</param>
+        /// <param name="map">The map whose tilesheets to update.</param>
+        /// <param name="__originalMethod">The method being wrapped.</param>
+        /// <returns>Returns whether to execute the original method.</returns>
+        private static bool Before_GameLocation_UpdateSeasonalTileSheets(GameLocation __instance, Map map, MethodInfo __originalMethod)
+        {
+            const string key = nameof(GameLocationPatches.Before_GameLocation_UpdateSeasonalTileSheets);
+            if (!PatchHelper.StartIntercept(key))
+                return true;
+
+            try
+            {
+                __originalMethod.Invoke(__instance, new object[] { map });
+                return false;
+            }
+            catch (TargetInvocationException ex)
+            {
+                GameLocationPatches.MonitorForGame.Log($"Failed updating seasonal tilesheets for location '{__instance.NameOrUniqueName}'. Technical details:\n{ex.InnerException}", LogLevel.Error);
+                return false;
+            }
+            finally
+            {
+                PatchHelper.StopIntercept(key);
+            }
+        }
+#endif
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 56daa710..006a09ca 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -15,6 +15,7 @@
 
   <ItemGroup>
     <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+    <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
 
   <!-- Windows only -->

From ec9914efad9e4ba46d49337b473b79bcdfd20d1f Mon Sep 17 00:00:00 2001
From: kuesji koesnu <kuesji@koesnu.com>
Date: Sun, 2 May 2021 17:37:08 +0300
Subject: [PATCH 163/856] launcher strict sandbox fix on linux

i added a check for is found terminal is executable.
game will launch with standart exec if found terminal is not exist or executable.

( fix for issue #775 )
---
 src/SMAPI.Installer/assets/unix-launcher.sh | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 93bf58d8..0046e716 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -80,8 +80,14 @@ else
         export LAUNCHTERM="$(basename "$(readlink -f $(COMMAND x-terminal-emulator))")"
     fi
 
-    # run in selected terminal and account for quirks
-    case $LAUNCHTERM in
+
+    if [ ! -x $LAUNCHTERM ]; then
+        echo "looks like found no terminal available for launch. maybe in sandbox or misconfigured system? fallbacking to execution without terminal"
+        export TERM="xterm"
+        exec $LAUNCHER $@
+    else
+        # run in selected terminal and account for quirks
+        case $LAUNCHTERM in
         terminal|termite)
             # LAUNCHTERM consumes only one argument after -e
             # options containing space characters are unsupported
@@ -110,5 +116,6 @@ else
             if [ $? -eq 127 ]; then
                 exec $LAUNCHER --no-terminal "$@"
             fi
-    esac
+        esac
+    fi
 fi

From f067b33ee4755cb7e6bc904f5c847360fec00c91 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 May 2021 12:11:28 -0400
Subject: [PATCH 164/856] let user install to a custom path even if a game
 folder was detected

---
 docs/release-notes.md                       |  3 +-
 src/SMAPI.Installer/InteractiveInstaller.cs | 78 +++++++++++++--------
 2 files changed, 50 insertions(+), 31 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8b81264a..271609e2 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,8 +13,9 @@
   * Added update checks for Stardew64Installer if it patched the game.
   * Added smarter grouping for skipped mods, so it's easier to see root dependencies to update first.
   * Added error-handling to prevent a crash when the game can't update a map's seasonal tilesheets _(in Error Handler)_.
-  * On macOS, the `StardewModdingAPI.bin.osx` file is no longer overwritten if it's identical to avoid resetting file permissions (thanks to 007wayne!).
+  * Added installer option to enter a custom game path even if it detected a game folder.
   * `*.ico` files are now ignored when scanning for mods.
+  * Fixed `StardewModdingAPI.bin.osx` on macOS overwritten with an identical file on launch, which resets file permissions (thanks to 007wayne!).
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
   * Fixed inconsistent spelling/style for 'macOS'.
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 6bfc6874..83ecd257 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -258,7 +258,6 @@ namespace StardewModdingApi.Installer
                 ** collect details
                 ****/
                 // get game path
-                this.PrintInfo("Where is your game folder?");
                 DirectoryInfo installDir = this.InteractivelyGetInstallPath(toolkit, context, gamePathArg);
                 if (installDir == null)
                 {
@@ -712,49 +711,37 @@ namespace StardewModdingApi.Installer
                 return dir;
             }
 
-            // use game folder which contains the installer, if any
-            {
-                DirectoryInfo curPath = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory;
-                while (curPath?.Parent != null) // must be in a folder (not at the root)
-                {
-                    if (context.LooksLikeGameFolder(curPath))
-                        return curPath;
-
-                    curPath = curPath.Parent;
-                }
-            }
-
-            // use an installed path
-            DirectoryInfo[] defaultPaths = toolkit.GetGameFolders().ToArray();
+            // let user choose detected path
+            DirectoryInfo[] defaultPaths = this.DetectGameFolders(toolkit, context).ToArray();
             if (defaultPaths.Any())
             {
-                // only one path
-                if (defaultPaths.Length == 1)
-                    return defaultPaths.First();
-
-                // let user choose path
+                this.PrintInfo("Where do you want to add or remove SMAPI?");
                 Console.WriteLine();
-                this.PrintInfo("Found multiple copies of the game:");
                 for (int i = 0; i < defaultPaths.Length; i++)
                     this.PrintInfo($"[{i + 1}] {defaultPaths[i].FullName}");
+                this.PrintInfo($"[{defaultPaths.Length + 1}] Enter a custom game path.");
                 Console.WriteLine();
 
-                string[] validOptions = Enumerable.Range(1, defaultPaths.Length).Select(p => p.ToString(CultureInfo.InvariantCulture)).ToArray();
-                string choice = this.InteractivelyChoose("Where do you want to add/remove SMAPI? Type the number next to your choice, then press enter.", validOptions);
+                string[] validOptions = Enumerable.Range(1, defaultPaths.Length + 1).Select(p => p.ToString(CultureInfo.InvariantCulture)).ToArray();
+                string choice = this.InteractivelyChoose("Type the number next to your choice, then press enter.", validOptions);
                 int index = int.Parse(choice, CultureInfo.InvariantCulture) - 1;
-                return defaultPaths[index];
-            }
 
-            // ask user
-            this.PrintInfo("Oops, couldn't find the game automatically.");
+                if (index < defaultPaths.Length)
+                    return defaultPaths[index];
+            }
+            else
+                this.PrintInfo("Oops, couldn't find the game automatically.");
+
+            // let user enter manual path
             while (true)
             {
                 // get path from user
+                Console.WriteLine();
                 this.PrintInfo($"Type the file path to the game directory (the one containing '{context.ExecutableName}'), then press enter.");
                 string path = Console.ReadLine()?.Trim();
                 if (string.IsNullOrWhiteSpace(path))
                 {
-                    this.PrintInfo("   You must specify a directory path to continue.");
+                    this.PrintWarning("You must specify a directory path to continue.");
                     continue;
                 }
 
@@ -776,12 +763,12 @@ namespace StardewModdingApi.Installer
                 // validate path
                 if (!directory.Exists)
                 {
-                    this.PrintInfo("   That directory doesn't seem to exist.");
+                    this.PrintWarning("That directory doesn't seem to exist.");
                     continue;
                 }
                 if (!context.LooksLikeGameFolder(directory))
                 {
-                    this.PrintInfo("   That directory doesn't contain a Stardew Valley executable.");
+                    this.PrintWarning("That directory doesn't contain a Stardew Valley executable.");
                     continue;
                 }
 
@@ -791,6 +778,37 @@ namespace StardewModdingApi.Installer
             }
         }
 
+        /// <summary>Get the possible game paths to update.</summary>
+        /// <param name="toolkit">The mod toolkit.</param>
+        /// <param name="context">The installer context.</param>
+        private IEnumerable<DirectoryInfo> DetectGameFolders(ModToolkit toolkit, InstallerContext context)
+        {
+            HashSet<string> foundPaths = new HashSet<string>();
+
+            // game folder which contains the installer, if any
+            {
+                DirectoryInfo curPath = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory;
+                while (curPath?.Parent != null) // must be in a folder (not at the root)
+                {
+                    if (context.LooksLikeGameFolder(curPath))
+                    {
+                        foundPaths.Add(curPath.FullName);
+                        yield return curPath;
+                        break;
+                    }
+
+                    curPath = curPath.Parent;
+                }
+            }
+
+            // game paths detected by toolkit
+            foreach (DirectoryInfo dir in toolkit.GetGameFolders())
+            {
+                if (foundPaths.Add(dir.FullName))
+                    yield return dir;
+            }
+        }
+
         /// <summary>Interactively move mods out of the appdata directory.</summary>
         /// <param name="properModsDir">The directory which should contain all mods.</param>
         /// <param name="packagedModsDir">The installer directory containing packaged mods.</param>

From bc9b5a84f0ecbf563d5f682f8ed38e50e7e675fc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 May 2021 18:07:05 -0400
Subject: [PATCH 165/856] use POSIX command directly in Linux launcher

---
 src/SMAPI.Installer/assets/unix-launcher.sh | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 0046e716..7611dfcd 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -59,17 +59,9 @@ else
     fi
     export LAUNCHER
 
-    # get cross-distro version of POSIX command
-    COMMAND=""
-    if command -v command 2>/dev/null; then
-        COMMAND="command -v"
-    elif type type 2>/dev/null; then
-        COMMAND="type -p"
-    fi
-
     # select terminal (prefer xterm for best compatibility, then known supported terminals)
     for terminal in xterm gnome-terminal kitty terminator xfce4-terminal konsole terminal termite alacritty mate-terminal x-terminal-emulator; do
-        if $COMMAND "$terminal" 2>/dev/null; then
+        if command -v "$terminal" 2>/dev/null; then
             export LAUNCHTERM=$terminal
             break;
         fi
@@ -77,7 +69,7 @@ else
 
     # find the true shell behind x-terminal-emulator
     if [ "$LAUNCHTERM" = "x-terminal-emulator" ]; then
-        export LAUNCHTERM="$(basename "$(readlink -f $(COMMAND x-terminal-emulator))")"
+        export LAUNCHTERM="$(basename "$(readlink -f $(command -v x-terminal-emulator))")"
     fi
 
 

From b8b120b759f292da8b6583831de2894fe44a0012 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 May 2021 18:11:58 -0400
Subject: [PATCH 166/856] rename variables in Linux launcher for clarity

---
 src/SMAPI.Installer/assets/unix-launcher.sh | 78 ++++++++++-----------
 1 file changed, 39 insertions(+), 39 deletions(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 7611dfcd..e0a106cb 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -46,68 +46,68 @@ if [ "$UNAME" == "Darwin" ]; then
     # launch SMAPI
     open -a Terminal ./StardewModdingAPI.bin.osx "$@"
 else
-    # choose launcher
-    LAUNCHER=""
+    # choose binary file to launch
+    LAUNCH_FILE=""
     if [ "$ARCH" == "x86_64" ]; then
         ln -sf mcs.bin.x86_64 mcs
         cp StardewValley.bin.x86_64 StardewModdingAPI.bin.x86_64
-        LAUNCHER="./StardewModdingAPI.bin.x86_64"
+        LAUNCH_FILE="./StardewModdingAPI.bin.x86_64"
     else
         ln -sf mcs.bin.x86 mcs
         cp StardewValley.bin.x86 StardewModdingAPI.bin.x86
-        LAUNCHER="./StardewModdingAPI.bin.x86"
+        LAUNCH_FILE="./StardewModdingAPI.bin.x86"
     fi
-    export LAUNCHER
+    export LAUNCH_FILE
 
     # select terminal (prefer xterm for best compatibility, then known supported terminals)
     for terminal in xterm gnome-terminal kitty terminator xfce4-terminal konsole terminal termite alacritty mate-terminal x-terminal-emulator; do
         if command -v "$terminal" 2>/dev/null; then
-            export LAUNCHTERM=$terminal
+            export TERMINAL_NAME=$terminal
             break;
         fi
     done
 
     # find the true shell behind x-terminal-emulator
-    if [ "$LAUNCHTERM" = "x-terminal-emulator" ]; then
-        export LAUNCHTERM="$(basename "$(readlink -f $(command -v x-terminal-emulator))")"
+    if [ "$TERMINAL_NAME" = "x-terminal-emulator" ]; then
+        export TERMINAL_NAME="$(basename "$(readlink -f $(command -v x-terminal-emulator))")"
     fi
 
 
-    if [ ! -x $LAUNCHTERM ]; then
+    if [ ! -x $TERMINAL_NAME ]; then
         echo "looks like found no terminal available for launch. maybe in sandbox or misconfigured system? fallbacking to execution without terminal"
         export TERM="xterm"
-        exec $LAUNCHER $@
+        exec $LAUNCH_FILE $@
     else
         # run in selected terminal and account for quirks
-        case $LAUNCHTERM in
-        terminal|termite)
-            # LAUNCHTERM consumes only one argument after -e
-            # options containing space characters are unsupported
-            exec $LAUNCHTERM -e "env TERM=xterm $LAUNCHER $@"
-            ;;
-        xterm|konsole|alacritty)
-            # LAUNCHTERM consumes all arguments after -e
-            exec $LAUNCHTERM -e env TERM=xterm $LAUNCHER "$@"
-            ;;
-        terminator|xfce4-terminal|mate-terminal)
-            # LAUNCHTERM consumes all arguments after -x
-            exec $LAUNCHTERM -x env TERM=xterm $LAUNCHER "$@"
-            ;;
-        gnome-terminal)
-            # LAUNCHTERM consumes all arguments after --
-            exec $LAUNCHTERM -- env TERM=xterm $LAUNCHER "$@"
-            ;;
-        kitty)
-            # LAUNCHTERM consumes all trailing arguments
-            exec $LAUNCHTERM env TERM=xterm $LAUNCHER "$@"
-            ;;
-        *)
-            # If we don't know the terminal, just try to run it in the current shell.
-            env TERM=xterm $LAUNCHER "$@"
-            # if THAT fails, launch with no output
-            if [ $? -eq 127 ]; then
-                exec $LAUNCHER --no-terminal "$@"
-            fi
+        case $TERMINAL_NAME in
+            terminal|termite)
+                # consumes only one argument after -e
+                # options containing space characters are unsupported
+                exec $TERMINAL_NAME -e "env TERM=xterm $LAUNCH_FILE $@"
+                ;;
+            xterm|konsole|alacritty)
+                # consumes all arguments after -e
+                exec $TERMINAL_NAME -e env TERM=xterm $LAUNCH_FILE "$@"
+                ;;
+            terminator|xfce4-terminal|mate-terminal)
+                # consumes all arguments after -x
+                exec $TERMINAL_NAME -x env TERM=xterm $LAUNCH_FILE "$@"
+                ;;
+            gnome-terminal)
+                # consumes all arguments after --
+                exec $TERMINAL_NAME -- env TERM=xterm $LAUNCH_FILE "$@"
+                ;;
+            kitty)
+                # consumes all trailing arguments
+                exec $TERMINAL_NAME env TERM=xterm $LAUNCH_FILE "$@"
+                ;;
+            *)
+                # If we don't know the terminal, just try to run it in the current shell.
+                env TERM=xterm $LAUNCH_FILE "$@"
+                # if THAT fails, launch with no output
+                if [ $? -eq 127 ]; then
+                    exec $LAUNCH_FILE --no-terminal "$@"
+                fi
         esac
     fi
 fi

From 0f27d6f4c18812d90e51b10c05bfa1a69953c721 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 May 2021 18:26:02 -0400
Subject: [PATCH 167/856] fix new executable check in Linux launcher, update
 release notes (#775)

---
 docs/release-notes.md                       |  1 +
 src/SMAPI.Installer/assets/unix-launcher.sh | 25 ++++++++++++++-------
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 271609e2..73b9376d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,6 +18,7 @@
   * Fixed `StardewModdingAPI.bin.osx` on macOS overwritten with an identical file on launch, which resets file permissions (thanks to 007wayne!).
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
+  * Fixed error running SMAPI in a strict sandbox on Linux (thanks to kuesji!).
   * Fixed inconsistent spelling/style for 'macOS'.
 
 * For modders:
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index e0a106cb..a33c0d7f 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -72,42 +72,51 @@ else
         export TERMINAL_NAME="$(basename "$(readlink -f $(command -v x-terminal-emulator))")"
     fi
 
-
-    if [ ! -x $TERMINAL_NAME ]; then
-        echo "looks like found no terminal available for launch. maybe in sandbox or misconfigured system? fallbacking to execution without terminal"
-        export TERM="xterm"
-        exec $LAUNCH_FILE $@
-    else
-        # run in selected terminal and account for quirks
+    # run in selected terminal and account for quirks
+    export TERMINAL_PATH="$(command -v $TERMINAL_NAME)"
+    if [ -x $TERMINAL_PATH ]; then
         case $TERMINAL_NAME in
             terminal|termite)
                 # consumes only one argument after -e
                 # options containing space characters are unsupported
                 exec $TERMINAL_NAME -e "env TERM=xterm $LAUNCH_FILE $@"
                 ;;
+
             xterm|konsole|alacritty)
                 # consumes all arguments after -e
                 exec $TERMINAL_NAME -e env TERM=xterm $LAUNCH_FILE "$@"
                 ;;
+
             terminator|xfce4-terminal|mate-terminal)
                 # consumes all arguments after -x
                 exec $TERMINAL_NAME -x env TERM=xterm $LAUNCH_FILE "$@"
                 ;;
+
             gnome-terminal)
                 # consumes all arguments after --
                 exec $TERMINAL_NAME -- env TERM=xterm $LAUNCH_FILE "$@"
                 ;;
+
             kitty)
                 # consumes all trailing arguments
                 exec $TERMINAL_NAME env TERM=xterm $LAUNCH_FILE "$@"
                 ;;
+
             *)
                 # If we don't know the terminal, just try to run it in the current shell.
+                # If THAT fails, launch with no output.
                 env TERM=xterm $LAUNCH_FILE "$@"
-                # if THAT fails, launch with no output
                 if [ $? -eq 127 ]; then
                     exec $LAUNCH_FILE --no-terminal "$@"
                 fi
         esac
+
+    ## terminal isn't executable; fallback to current shell or no terminal
+    else
+        echo "The '$TERMINAL_NAME' terminal isn't executable. SMAPI might be running in a sandbox or the system might be misconfigured? Falling back to current shell."
+        env TERM=xterm $LAUNCH_FILE "$@"
+        if [ $? -eq 127 ]; then
+            exec $LAUNCH_FILE --no-terminal "$@"
+        fi
     fi
 fi

From eef6a9c2e8d124ad0856a8b351f9cae68e54f6eb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 May 2021 18:34:26 -0400
Subject: [PATCH 168/856] add support for dot-ignoring local map tilesheet
 files (#732)

---
 docs/release-notes.md                                    | 1 +
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 9 +++++++++
 2 files changed, 10 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 73b9376d..27786e18 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -24,6 +24,7 @@
 * For modders:
   * Added asset propagation for `Data\Concessions`.
   * Added SMAPI version and bitness to the console title before startup to simplify troubleshooting.
+  * Added support for [ignoring local map tilesheet files when loading a map](https://stardewvalleywiki.com/Modding:Maps#Local_copy_of_a_vanilla_tilesheet).
   * If a map loads a tilesheet path with no file extension, SMAPI now automatically links it to a `.png` version in the map folder if possible.
   * Improved error-handling during asset propagation.
   * Fixed `Context.IsMainPlayer` returning true for a farmhand in split-screen mode before the screen is initialized.
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 0cd431e8..f32e3be6 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -317,6 +317,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return true;
             }
 
+            // special case: local filenames starting with a dot should be ignored
+            // For example, this lets mod authors have a '.spring_town.png' file in their map folder so it can be
+            // opened in Tiled, while still mapping it to the vanilla 'Maps/spring_town' asset at runtime.
+            {
+                string filename = Path.GetFileName(relativePath);
+                if (filename.StartsWith("."))
+                    relativePath = Path.Combine(Path.GetDirectoryName(relativePath) ?? "", filename.TrimStart('.'));
+            }
+
             // get relative to map file
             {
                 string localKey = Path.Combine(modRelativeMapFolder, relativePath);

From 2cc5509e9828fd5194ca6ef7ae9ea23bd3628971 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 May 2021 18:35:34 -0400
Subject: [PATCH 169/856] add verbose logs for map tilesheet changes

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index f32e3be6..4f6aa775 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -268,6 +268,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             string relativeMapFolder = Path.GetDirectoryName(relativeMapPath) ?? ""; // folder path containing the map, relative to the mod folder
 
             // fix tilesheets
+            this.Monitor.VerboseLog($"Fixing tilesheet paths for map '{relativeMapPath}' from mod '{this.ModName}'...");
             foreach (TileSheet tilesheet in map.TileSheets)
             {
                 // get image source
@@ -289,6 +290,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out string assetName, out string error))
                         throw new SContentLoadException($"{errorPrefix} {error}");
 
+                    if (assetName != tilesheet.ImageSource)
+                        this.Monitor.VerboseLog($"   Mapped tilesheet '{tilesheet.ImageSource}' to '{assetName}'.");
+
                     tilesheet.ImageSource = assetName;
                 }
                 catch (Exception ex) when (!(ex is SContentLoadException))

From 3447e2f575c2c83af729777e4d37e93f4c2a6467 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 3 May 2021 18:11:06 -0400
Subject: [PATCH 170/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 15 +++++++--------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 15 insertions(+), 16 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 6834c162..3278a0da 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.9.5</Version>
+    <Version>3.10.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 27786e18..b697cd2b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,30 +7,29 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.10
+Released 03 May 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/50764911).
+
 * For players:
-  * Added support for unofficial 64-bit Stardew Valley, including automatic support in the SMAPI installer.
-  * Added update checks for Stardew64Installer if it patched the game.
+  * Added full support for the [unofficial 64-bit Stardew Valley patch](https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows), which removes memory limits. The installer detects which version of SMAPI you need, and SMAPI shows update alerts for Stardew64Installer if applicable.
   * Added smarter grouping for skipped mods, so it's easier to see root dependencies to update first.
-  * Added error-handling to prevent a crash when the game can't update a map's seasonal tilesheets _(in Error Handler)_.
+  * Added crash recovery when the game can't update a map's seasonal tilesheets _(in Error Handler)_. SMAPI will log an error and keep the previous tilesheets in that case.
   * Added installer option to enter a custom game path even if it detected a game folder.
   * `*.ico` files are now ignored when scanning for mods.
-  * Fixed `StardewModdingAPI.bin.osx` on macOS overwritten with an identical file on launch, which resets file permissions (thanks to 007wayne!).
   * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
   * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
   * Fixed error running SMAPI in a strict sandbox on Linux (thanks to kuesji!).
+  * Fixed `StardewModdingAPI.bin.osx` on macOS overwritten with an identical file on launch which would reset file permissions (thanks to 007wayne!).
   * Fixed inconsistent spelling/style for 'macOS'.
 
 * For modders:
+  * Added support for [ignoring local map tilesheet files when loading a map](https://stardewvalleywiki.com/Modding:Maps#Local_copy_of_a_vanilla_tilesheet).
   * Added asset propagation for `Data\Concessions`.
   * Added SMAPI version and bitness to the console title before startup to simplify troubleshooting.
-  * Added support for [ignoring local map tilesheet files when loading a map](https://stardewvalleywiki.com/Modding:Maps#Local_copy_of_a_vanilla_tilesheet).
   * If a map loads a tilesheet path with no file extension, SMAPI now automatically links it to a `.png` version in the map folder if possible.
   * Improved error-handling during asset propagation.
   * Fixed `Context.IsMainPlayer` returning true for a farmhand in split-screen mode before the screen is initialized.
   * Fixed error when editing bundle data while a split-screen player is joining.
-
-* For the web API:
   * Fixed update subkeys not working in file descriptions for Nexus mods marked as adult content.
 
 ## 3.9.5
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 65c66d33..10e6733f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.9.5",
+    "Version": "3.10.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.9.5"
+    "MinimumApiVersion": "3.10.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 1e810113..ab519781 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.9.5",
+    "Version": "3.10.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.9.5"
+    "MinimumApiVersion": "3.10.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index ced7888a..0d421b8f 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.9.5",
+    "Version": "3.10.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.9.5"
+    "MinimumApiVersion": "3.10.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 161e92b4..3c21b205 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -61,7 +61,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.9.5";
+        internal static string RawApiVersion = "3.10.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 8d9d8341cdd7e78bbb281c1576a434d982126a44 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 3 May 2021 19:42:30 -0400
Subject: [PATCH 171/856] fix installer leaving unneeded
 StardewModdingAPI-x64.exe file in installer

---
 docs/release-notes.md                       |  4 +++
 src/SMAPI.Installer/InteractiveInstaller.cs | 31 ++++++++++-----------
 2 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b697cd2b..b25be131 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Fixed installer leaving unneeded `StardewModdingAPI-x64.exe` file in the game folder.
+
 ## 3.10
 Released 03 May 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/50764911).
 
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 83ecd257..55e9c064 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -45,6 +45,7 @@ namespace StardewModdingApi.Installer
             yield return GetInstallPath("StardewModdingAPI.exe.mdb");  // Linux/macOS only
             yield return GetInstallPath("StardewModdingAPI.pdb");      // Windows only
             yield return GetInstallPath("StardewModdingAPI.xml");
+            yield return GetInstallPath("StardewModdingAPI-x64.exe");  // not normally added to game folder, but may be mistakenly added by a manual install
             yield return GetInstallPath("smapi-internal");
             yield return GetInstallPath("steam_appid.txt");
 
@@ -424,25 +425,23 @@ namespace StardewModdingApi.Installer
                         this.RecursiveCopy(sourceEntry, paths.GameDir);
                     }
 
-                    if (isWindows64Bit)
+                    // handle 64-bit file
                     {
-                        this.PrintDebug("Making SMAPI 64-bit...");
-                        FileInfo x64Executable = new FileInfo(Path.Combine(paths.BundleDir.FullName, "StardewModdingAPI-x64.exe"));
-                        if (x64Executable.Exists)
+                        FileInfo x64Executable = new FileInfo(Path.Combine(paths.GameDir.FullName, "StardewModdingAPI-x64.exe"));
+                        if (isWindows64Bit)
                         {
-                            string targetName = "StardewModdingAPI.exe";
-                            this.InteractivelyDelete(Path.Combine(paths.GameDir.FullName, targetName));
-                            this.InteractivelyDelete(Path.Combine(paths.GameDir.FullName, x64Executable.Name));
-
-                            this.RecursiveCopy(x64Executable, paths.GameDir);
-                            File.Move(Path.Combine(paths.GamePath, x64Executable.Name), Path.Combine(paths.GamePath, targetName));
-                        }
-                        else
-                        {
-                            this.PrintError($"Oops! Could not find the required '{x64Executable.Name}' installer file. SMAPI was unable to install correctly.");
-                            Console.ReadLine();
-                            return;
+                            this.PrintDebug("Making SMAPI 64-bit...");
+                            if (x64Executable.Exists)
+                            {
+                                string targetPath = Path.Combine(paths.GameDir.FullName, "StardewModdingAPI.exe");
+                                this.InteractivelyDelete(targetPath);
+                                x64Executable.MoveTo(targetPath);
+                            }
+                            else
+                                this.PrintError($"Oops! Could not find the required '{x64Executable.Name}' installer file. SMAPI may not work correctly.");
                         }
+                        else if (x64Executable.Exists)
+                            x64Executable.Delete();
                     }
 
                     // replace mod launcher (if possible)

From 6b1c4589e96f25b771ff8ddd4bbdbb9198a0ab9c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 3 May 2021 19:49:44 -0400
Subject: [PATCH 172/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 6 ++++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 3278a0da..d538cc53 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.10.0</Version>
+    <Version>3.10.1</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index b25be131..caa90d19 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,9 +7,11 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.10.1
+Released 03 May 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
-  * Fixed installer leaving unneeded `StardewModdingAPI-x64.exe` file in the game folder.
+  * Fixed installer leaving an unneeded `StardewModdingAPI-x64.exe` file in 32-bit game folders.
 
 ## 3.10
 Released 03 May 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/50764911).
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 10e6733f..e9513309 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.10.0",
+    "Version": "3.10.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.10.0"
+    "MinimumApiVersion": "3.10.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index ab519781..b0b29379 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.10.0",
+    "Version": "3.10.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.10.0"
+    "MinimumApiVersion": "3.10.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 0d421b8f..fea9b62e 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.10.0",
+    "Version": "3.10.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.10.0"
+    "MinimumApiVersion": "3.10.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 3c21b205..2e476208 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -61,7 +61,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.10.0";
+        internal static string RawApiVersion = "3.10.1";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From d9c001a39f4562038fb608468169ea22cf074111 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 May 2021 12:06:18 -0400
Subject: [PATCH 173/856] fix version zero validation

---
 docs/release-notes.md                         | 4 ++++
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index caa90d19..859bf155 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For mod authors:
+  * Fixed validation for mods with version `0.0.0`.
+
 ## 3.10.1
 Released 03 May 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index c70820e4..7761a567 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -173,7 +173,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
                     if (string.IsNullOrWhiteSpace(mod.Manifest.Name))
                         missingFields.Add(nameof(IManifest.Name));
-                    if (mod.Manifest.Version == null || mod.Manifest.Version.ToString() == "0.0")
+                    if (mod.Manifest.Version == null || mod.Manifest.Version.ToString() == "0.0.0")
                         missingFields.Add(nameof(IManifest.Version));
                     if (string.IsNullOrWhiteSpace(mod.Manifest.UniqueID))
                         missingFields.Add(nameof(IManifest.UniqueID));

From 4b391d631ccde301969ae0c04f407a01ba4055b1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 May 2021 12:12:03 -0400
Subject: [PATCH 174/856] normalize manifest array fields

---
 .../Framework/ModData/ModDataField.cs         |  2 +-
 .../Framework/ModScanning/ModFolder.cs        |  2 +-
 .../Serialization/Models/Manifest.cs          | 10 ++++++++++
 src/SMAPI/Framework/ModLoading/ModMetadata.cs | 19 +++++++++++--------
 src/SMAPI/Framework/ModLoading/ModResolver.cs |  2 +-
 src/SMAPI/Framework/SCore.cs                  | 19 ++++++++-----------
 6 files changed, 32 insertions(+), 22 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
index 6658d219..b02be3e4 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
@@ -66,7 +66,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
             {
                 // update key
                 case ModDataFieldKey.UpdateKey:
-                    return manifest.UpdateKeys != null && manifest.UpdateKeys.Any(p => !string.IsNullOrWhiteSpace(p));
+                    return manifest.UpdateKeys.Any(p => !string.IsNullOrWhiteSpace(p));
 
                 // non-manifest fields
                 case ModDataFieldKey.StatusReasonPhrase:
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
index d0df09a1..825b98e5 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         public IEnumerable<string> GetUpdateKeys(Manifest manifest)
         {
             return
-                (manifest.UpdateKeys ?? new string[0])
+                manifest.UpdateKeys
                 .Where(p => !string.IsNullOrWhiteSpace(p))
                 .ToArray();
         }
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 99e85cbd..46b654a5 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using System.Runtime.Serialization;
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Converters;
 
@@ -70,5 +71,14 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
             this.UpdateKeys = new string[0];
             this.ContentPackFor = new ManifestContentPackFor { UniqueID = contentPackFor };
         }
+
+        /// <summary>Normalize the model after it's deserialized.</summary>
+        /// <param name="context">The deserialization context.</param>
+        [OnDeserialized]
+        public void OnDeserialized(StreamingContext context)
+        {
+            this.Dependencies ??= new IManifestDependency[0];
+            this.UpdateKeys ??= new string[0];
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index 17e6d59a..b703f74c 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -195,7 +195,10 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <inheritdoc />
         public IEnumerable<UpdateKey> GetUpdateKeys(bool validOnly = false)
         {
-            foreach (string rawKey in this.Manifest?.UpdateKeys ?? new string[0])
+            if (this.Manifest == null)
+                yield break;
+
+            foreach (string rawKey in this.Manifest.UpdateKeys)
             {
                 UpdateKey updateKey = UpdateKey.Parse(rawKey);
                 if (updateKey.LooksValid || !validOnly)
@@ -251,16 +254,16 @@ namespace StardewModdingAPI.Framework.ModLoading
         {
             var ids = new Dictionary<string, bool>(StringComparer.OrdinalIgnoreCase);
 
-            // yield dependencies
-            if (this.Manifest?.Dependencies != null)
+            if (this.Manifest != null)
             {
-                foreach (var entry in this.Manifest?.Dependencies)
+                // yield dependencies
+                foreach (IManifestDependency entry in this.Manifest.Dependencies)
                     ids[entry.UniqueID] = entry.IsRequired;
-            }
 
-            // yield content pack parent
-            if (this.Manifest?.ContentPackFor?.UniqueID != null)
-                ids[this.Manifest.ContentPackFor.UniqueID] = true;
+                // yield content pack parent
+                if (this.Manifest.ContentPackFor?.UniqueID != null)
+                    ids[this.Manifest.ContentPackFor.UniqueID] = true;
+            }
 
             return ids;
         }
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 7761a567..3bf2b0a1 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -82,7 +82,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
                             // get update URLs
                             List<string> updateUrls = new List<string>();
-                            foreach (string key in mod.Manifest.UpdateKeys ?? new string[0])
+                            foreach (string key in mod.Manifest.UpdateKeys)
                             {
                                 string url = getUpdateUrl(key);
                                 if (url != null)
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 5862b112..8b2c7544 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1593,19 +1593,16 @@ namespace StardewModdingAPI.Framework
 
             // validate dependencies
             // Although dependencies are validated before mods are loaded, a dependency may have failed to load.
-            if (mod.Manifest.Dependencies?.Any() == true)
+            foreach (IManifestDependency dependency in mod.Manifest.Dependencies.Where(p => p.IsRequired))
             {
-                foreach (IManifestDependency dependency in mod.Manifest.Dependencies.Where(p => p.IsRequired))
+                if (this.ModRegistry.Get(dependency.UniqueID) == null)
                 {
-                    if (this.ModRegistry.Get(dependency.UniqueID) == null)
-                    {
-                        string dependencyName = mods
-                            .FirstOrDefault(otherMod => otherMod.HasID(dependency.UniqueID))
-                            ?.DisplayName ?? dependency.UniqueID;
-                        errorReasonPhrase = $"it needs the '{dependencyName}' mod, which couldn't be loaded.";
-                        failReason = ModFailReason.MissingDependencies;
-                        return false;
-                    }
+                    string dependencyName = mods
+                        .FirstOrDefault(otherMod => otherMod.HasID(dependency.UniqueID))
+                        ?.DisplayName ?? dependency.UniqueID;
+                    errorReasonPhrase = $"it needs the '{dependencyName}' mod, which couldn't be loaded.";
+                    failReason = ModFailReason.MissingDependencies;
+                    return false;
                 }
             }
 

From 7c76c5cad2c6edac75d6387dbaa5999295be46d8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 May 2021 12:13:39 -0400
Subject: [PATCH 175/856] add validation for the manifest 'Dependencies' field

---
 docs/release-notes.md                         |  1 +
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 22 +++++++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 859bf155..f3440d43 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For mod authors:
+  * Added validation for the manifest `Dependencies` field.
   * Fixed validation for mods with version `0.0.0`.
 
 ## 3.10.1
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 3bf2b0a1..2f506571 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -188,6 +188,28 @@ namespace StardewModdingAPI.Framework.ModLoading
                 // validate ID format
                 if (!PathUtilities.IsSlug(mod.Manifest.UniqueID))
                     mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, "its manifest specifies an invalid ID (IDs must only contain letters, numbers, underscores, periods, or hyphens).");
+
+                // validate dependencies
+                foreach (var dependency in mod.Manifest.Dependencies)
+                {
+                    // null dependency
+                    if (dependency == null)
+                    {
+                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has a null entry under {nameof(IManifest.Dependencies)}.");
+                        continue;
+                    }
+
+                    // missing ID
+                    if (string.IsNullOrWhiteSpace(dependency.UniqueID))
+                    {
+                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has a {nameof(IManifest.Dependencies)} entry with no {nameof(IManifestDependency.UniqueID)} field.");
+                        continue;
+                    }
+
+                    // invalid ID
+                    if (!PathUtilities.IsSlug(dependency.UniqueID))
+                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has a {nameof(IManifest.Dependencies)} entry with an invalid {nameof(IManifestDependency.UniqueID)} field (IDs must only contain letters, numbers, underscores, periods, or hyphens).");
+                }
             }
 
             // validate IDs are unique

From 4ac04ee3aca00f7c1e105ddabd1ed16995b17086 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 May 2021 12:19:30 -0400
Subject: [PATCH 176/856] fix error if a mod has a 'Dependencies' entry with no
 ID

---
 src/SMAPI/Framework/ModLoading/ModMetadata.cs | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index b703f74c..0ace084f 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -195,7 +195,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <inheritdoc />
         public IEnumerable<UpdateKey> GetUpdateKeys(bool validOnly = false)
         {
-            if (this.Manifest == null)
+            if (!this.HasManifest())
                 yield break;
 
             foreach (string rawKey in this.Manifest.UpdateKeys)
@@ -254,14 +254,17 @@ namespace StardewModdingAPI.Framework.ModLoading
         {
             var ids = new Dictionary<string, bool>(StringComparer.OrdinalIgnoreCase);
 
-            if (this.Manifest != null)
+            if (this.HasManifest())
             {
                 // yield dependencies
                 foreach (IManifestDependency entry in this.Manifest.Dependencies)
-                    ids[entry.UniqueID] = entry.IsRequired;
+                {
+                    if (!string.IsNullOrWhiteSpace(entry.UniqueID))
+                        ids[entry.UniqueID] = entry.IsRequired;
+                }
 
                 // yield content pack parent
-                if (this.Manifest.ContentPackFor?.UniqueID != null)
+                if (!string.IsNullOrWhiteSpace(this.Manifest.ContentPackFor?.UniqueID))
                     ids[this.Manifest.ContentPackFor.UniqueID] = true;
             }
 

From 9b09941bd53dff2bf47c9fa8b5afffe267b01aaf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 10 May 2021 22:40:13 -0400
Subject: [PATCH 177/856] set script path in Windows launch script (#777)

---
 docs/release-notes.md                          | 3 +++
 src/SMAPI.Installer/assets/windows-install.bat | 1 +
 2 files changed, 4 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f3440d43..304423fc 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Fixed error when running the Windows installer as administrator (thanks to LostLogic!).
+
 * For mod authors:
   * Added validation for the manifest `Dependencies` field.
   * Fixed validation for mods with version `0.0.0`.
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index 2cc54e80..18c40a64 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -4,5 +4,6 @@ if not errorlevel 1 (
    echo Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first.
    pause
 ) else (
+   cd "%~dp0"
    start /WAIT /B ./internal/windows-install.exe
 )

From 3c3920b86e302de52113d93c5c1e162b29ce495a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 12 May 2021 20:57:23 -0400
Subject: [PATCH 178/856] clarify common mistake when setting game path

---
 docs/technical/mod-package.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 6d04722c..91da971b 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -324,7 +324,7 @@ To do that:
        <GamePath>PATH_HERE</GamePath>
    </PropertyGroup>
    ```
-3. Replace `PATH_HERE` with your game's folder path.
+3. Replace `PATH_HERE` with your game's folder path (don't add quotes).
 
 The configuration will check your custom path first, then fall back to the default paths (so it'll
 still compile on a different computer).

From fe25a122f44fcd1454df3d5185efe9e54714a684 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 17 May 2021 20:45:46 -0400
Subject: [PATCH 179/856] fix some vanilla shirts not returned by item repo

---
 docs/release-notes.md                         |  1 +
 .../Framework/ItemRepository.cs               | 59 +++++++++++++------
 2 files changed, 41 insertions(+), 19 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 304423fc..666dc8e4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Fixed error when running the Windows installer as administrator (thanks to LostLogic!).
+  * Fixed `player_add` and `list_items` console commands not including some shirts _(in Console Commands)_.
 
 * For mod authors:
   * Added validation for the manifest `Dependencies` field.
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 34149209..69194f75 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -62,25 +62,8 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                 yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset + 3, _ => new Wand());
 
                 // clothing
-                {
-                    // items
-                    HashSet<int> clothingIds = new HashSet<int>();
-                    foreach (int id in Game1.clothingInformation.Keys)
-                    {
-                        if (id < 0)
-                            continue; // placeholder data for character customization clothing below
-
-                        clothingIds.Add(id);
-                        yield return this.TryCreate(ItemType.Clothing, id, p => new Clothing(p.ID));
-                    }
-
-                    // character customization shirts (some shirts in this range have no data, but game has special logic to handle them)
-                    for (int id = 1000; id <= 1111; id++)
-                    {
-                        if (!clothingIds.Contains(id))
-                            yield return this.TryCreate(ItemType.Clothing, id, p => new Clothing(p.ID));
-                    }
-                }
+                foreach (int id in this.GetShirtIds())
+                    yield return this.TryCreate(ItemType.Clothing, id, p => new Clothing(p.ID));
 
                 // wallpapers
                 for (int id = 0; id < 112; id++)
@@ -333,5 +316,43 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                 ? new Color(61, 55, 42)
                 : (TailoringMenu.GetDyeColor(fish) ?? Color.Orange);
         }
+
+        /// <summary>Get valid shirt IDs.</summary>
+        /// <remarks>
+        /// Shirts have a possible range of 1000–1999, but not all of those IDs are valid. There are two sets of IDs:
+        ///
+        /// <list type="number">
+        ///   <item>
+        ///     Shirts which exist in <see cref="Game1.clothingInformation"/>.
+        ///   </item>
+        ///   <item>
+        ///     Shirts with a dynamic ID and no entry in <see cref="Game1.clothingInformation"/>. These automatically
+        ///     use the generic shirt entry with ID <c>-1</c> and are mapped to a calculated position in the
+        ///     <c>Characters/Farmer/shirts</c> spritesheet. There's no constant we can use, but some known valid
+        ///     ranges are 1000–1111 (used in <see cref="Farmer.changeShirt"/> for the customization screen and
+        ///     1000–1127 (used in <see cref="Utility.getShopStock"/> and <see cref="GameLocation.sandyShopStock"/>).
+        ///     Based on the spritesheet, the max valid ID is 1299.
+        ///   </item>
+        /// </list>
+        /// </remarks>
+        private IEnumerable<int> GetShirtIds()
+        {
+            // defined shirt items
+            foreach (int id in Game1.clothingInformation.Keys)
+            {
+                if (id < 0)
+                    continue; // placeholder data for character customization clothing below
+
+                yield return id;
+            }
+
+            // dynamic shirts
+            HashSet<int> clothingIds = new HashSet<int>(Game1.clothingInformation.Keys);
+            for (int id = 1000; id <= 1299; id++)
+            {
+                if (!clothingIds.Contains(id))
+                    yield return id;
+            }
+        }
     }
 }

From 75d7c101441f034c85ee91afbe4ae83599a17995 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 17 May 2021 20:52:01 -0400
Subject: [PATCH 180/856] add support for filtering the item repo

This isn't used by SMAPI itself, but is used by some mods like Lookup Anything that copy this code.
---
 .../Framework/ItemRepository.cs               | 365 ++++++++++--------
 1 file changed, 204 insertions(+), 161 deletions(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 69194f75..0357fe6b 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -28,8 +28,10 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
         ** Public methods
         *********/
         /// <summary>Get all spawnable items.</summary>
+        /// <param name="itemTypes">The item types to fetch (or null for any type).</param>
+        /// <param name="includeVariants">Whether to include flavored variants like "Sunflower Honey".</param>
         [SuppressMessage("ReSharper", "AccessToModifiedClosure", Justification = "TryCreate invokes the lambda immediately.")]
-        public IEnumerable<SearchableItem> GetAll()
+        public IEnumerable<SearchableItem> GetAll(ItemType[] itemTypes = null, bool includeVariants = true)
         {
             //
             //
@@ -41,205 +43,246 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
             //
             //
 
-
             IEnumerable<SearchableItem> GetAllRaw()
             {
-                // get tools
-                for (int q = Tool.stone; q <= Tool.iridium; q++)
-                {
-                    int quality = q;
+                HashSet<ItemType> types = itemTypes?.Any() == true ? new HashSet<ItemType>(itemTypes) : null;
+                bool ShouldGet(ItemType type) => types == null || types.Contains(type);
 
-                    yield return this.TryCreate(ItemType.Tool, ToolFactory.axe, _ => ToolFactory.getToolFromDescription(ToolFactory.axe, quality));
-                    yield return this.TryCreate(ItemType.Tool, ToolFactory.hoe, _ => ToolFactory.getToolFromDescription(ToolFactory.hoe, quality));
-                    yield return this.TryCreate(ItemType.Tool, ToolFactory.pickAxe, _ => ToolFactory.getToolFromDescription(ToolFactory.pickAxe, quality));
-                    yield return this.TryCreate(ItemType.Tool, ToolFactory.wateringCan, _ => ToolFactory.getToolFromDescription(ToolFactory.wateringCan, quality));
-                    if (quality != Tool.iridium)
-                        yield return this.TryCreate(ItemType.Tool, ToolFactory.fishingRod, _ => ToolFactory.getToolFromDescription(ToolFactory.fishingRod, quality));
+                // get tools
+                if (ShouldGet(ItemType.Tool))
+                {
+                    for (int q = Tool.stone; q <= Tool.iridium; q++)
+                    {
+                        int quality = q;
+
+                        yield return this.TryCreate(ItemType.Tool, ToolFactory.axe, _ => ToolFactory.getToolFromDescription(ToolFactory.axe, quality));
+                        yield return this.TryCreate(ItemType.Tool, ToolFactory.hoe, _ => ToolFactory.getToolFromDescription(ToolFactory.hoe, quality));
+                        yield return this.TryCreate(ItemType.Tool, ToolFactory.pickAxe, _ => ToolFactory.getToolFromDescription(ToolFactory.pickAxe, quality));
+                        yield return this.TryCreate(ItemType.Tool, ToolFactory.wateringCan, _ => ToolFactory.getToolFromDescription(ToolFactory.wateringCan, quality));
+                        if (quality != Tool.iridium)
+                            yield return this.TryCreate(ItemType.Tool, ToolFactory.fishingRod, _ => ToolFactory.getToolFromDescription(ToolFactory.fishingRod, quality));
+                    }
+                    yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset, _ => new MilkPail()); // these don't have any sort of ID, so we'll just assign some arbitrary ones
+                    yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset + 1, _ => new Shears());
+                    yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset + 2, _ => new Pan());
+                    yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset + 3, _ => new Wand());
                 }
-                yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset, _ => new MilkPail()); // these don't have any sort of ID, so we'll just assign some arbitrary ones
-                yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset + 1, _ => new Shears());
-                yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset + 2, _ => new Pan());
-                yield return this.TryCreate(ItemType.Tool, this.CustomIDOffset + 3, _ => new Wand());
 
                 // clothing
-                foreach (int id in this.GetShirtIds())
-                    yield return this.TryCreate(ItemType.Clothing, id, p => new Clothing(p.ID));
+                if (ShouldGet(ItemType.Clothing))
+                {
+                    foreach (int id in this.GetShirtIds())
+                        yield return this.TryCreate(ItemType.Clothing, id, p => new Clothing(p.ID));
+                }
 
                 // wallpapers
-                for (int id = 0; id < 112; id++)
-                    yield return this.TryCreate(ItemType.Wallpaper, id, p => new Wallpaper(p.ID) { Category = SObject.furnitureCategory });
+                if (ShouldGet(ItemType.Wallpaper))
+                {
+                    for (int id = 0; id < 112; id++)
+                        yield return this.TryCreate(ItemType.Wallpaper, id, p => new Wallpaper(p.ID) { Category = SObject.furnitureCategory });
+                }
 
                 // flooring
-                for (int id = 0; id < 56; id++)
-                    yield return this.TryCreate(ItemType.Flooring, id, p => new Wallpaper(p.ID, isFloor: true) { Category = SObject.furnitureCategory });
+                if (ShouldGet(ItemType.Flooring))
+                {
+                    for (int id = 0; id < 56; id++)
+                        yield return this.TryCreate(ItemType.Flooring, id, p => new Wallpaper(p.ID, isFloor: true) { Category = SObject.furnitureCategory });
+                }
 
                 // equipment
-                foreach (int id in this.TryLoad<int, string>("Data\\Boots").Keys)
-                    yield return this.TryCreate(ItemType.Boots, id, p => new Boots(p.ID));
-                foreach (int id in this.TryLoad<int, string>("Data\\hats").Keys)
-                    yield return this.TryCreate(ItemType.Hat, id, p => new Hat(p.ID));
+                if (ShouldGet(ItemType.Boots))
+                {
+                    foreach (int id in this.TryLoad<int, string>("Data\\Boots").Keys)
+                        yield return this.TryCreate(ItemType.Boots, id, p => new Boots(p.ID));
+                }
+                if (ShouldGet(ItemType.Hat))
+                {
+                    foreach (int id in this.TryLoad<int, string>("Data\\hats").Keys)
+                        yield return this.TryCreate(ItemType.Hat, id, p => new Hat(p.ID));
+                }
 
                 // weapons
-                foreach (int id in this.TryLoad<int, string>("Data\\weapons").Keys)
+                if (ShouldGet(ItemType.Weapon))
                 {
-                    yield return this.TryCreate(ItemType.Weapon, id, p => (p.ID >= 32 && p.ID <= 34)
-                        ? (Item)new Slingshot(p.ID)
-                        : new MeleeWeapon(p.ID)
-                    );
+                    foreach (int id in this.TryLoad<int, string>("Data\\weapons").Keys)
+                    {
+                        yield return this.TryCreate(ItemType.Weapon, id, p => (p.ID >= 32 && p.ID <= 34)
+                            ? (Item)new Slingshot(p.ID)
+                            : new MeleeWeapon(p.ID)
+                        );
+                    }
                 }
 
                 // furniture
-                foreach (int id in this.TryLoad<int, string>("Data\\Furniture").Keys)
-                    yield return this.TryCreate(ItemType.Furniture, id, p => Furniture.GetFurnitureInstance(p.ID));
+                if (ShouldGet(ItemType.Furniture))
+                {
+                    foreach (int id in this.TryLoad<int, string>("Data\\Furniture").Keys)
+                        yield return this.TryCreate(ItemType.Furniture, id, p => Furniture.GetFurnitureInstance(p.ID));
+                }
 
                 // craftables
-                foreach (int id in Game1.bigCraftablesInformation.Keys)
-                    yield return this.TryCreate(ItemType.BigCraftable, id, p => new SObject(Vector2.Zero, p.ID));
+                if (ShouldGet(ItemType.BigCraftable))
+                {
+                    foreach (int id in Game1.bigCraftablesInformation.Keys)
+                        yield return this.TryCreate(ItemType.BigCraftable, id, p => new SObject(Vector2.Zero, p.ID));
+                }
 
                 // objects
-                foreach (int id in Game1.objectInformation.Keys)
+                if (ShouldGet(ItemType.Object) || ShouldGet(ItemType.Ring))
                 {
-                    string[] fields = Game1.objectInformation[id]?.Split('/');
-
-                    // secret notes
-                    if (id == 79)
+                    foreach (int id in Game1.objectInformation.Keys)
                     {
-                        foreach (int secretNoteId in this.TryLoad<int, string>("Data\\SecretNotes").Keys)
+                        string[] fields = Game1.objectInformation[id]?.Split('/');
+
+                        // secret notes
+                        if (id == 79)
                         {
-                            yield return this.TryCreate(ItemType.Object, this.CustomIDOffset + secretNoteId, _ =>
+                            if (ShouldGet(ItemType.Object))
                             {
-                                SObject note = new SObject(79, 1);
-                                note.name = $"{note.name} #{secretNoteId}";
-                                return note;
-                            });
+                                foreach (int secretNoteId in this.TryLoad<int, string>("Data\\SecretNotes").Keys)
+                                {
+                                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset + secretNoteId, _ =>
+                                    {
+                                        SObject note = new SObject(79, 1);
+                                        note.name = $"{note.name} #{secretNoteId}";
+                                        return note;
+                                    });
+                                }
+                            }
                         }
-                    }
 
-                    // ring
-                    else if (id != 801 && fields?.Length >= 4 && fields[3] == "Ring") // 801 = wedding ring, which isn't an equippable ring
-                        yield return this.TryCreate(ItemType.Ring, id, p => new Ring(p.ID));
-
-                    // item
-                    else
-                    {
-                        // spawn main item
-                        SObject item = null;
-                        yield return this.TryCreate(ItemType.Object, id, p =>
+                        // ring
+                        else if (id != 801 && fields?.Length >= 4 && fields[3] == "Ring") // 801 = wedding ring, which isn't an equippable ring
                         {
-                            return item = (p.ID == 812 // roe
-                                ? new ColoredObject(p.ID, 1, Color.White)
-                                : new SObject(p.ID, 1)
-                            );
-                        });
-                        if (item == null)
-                            continue;
+                            if (ShouldGet(ItemType.Ring))
+                                yield return this.TryCreate(ItemType.Ring, id, p => new Ring(p.ID));
+                        }
 
-                        // flavored items
-                        switch (item.Category)
+                        // item
+                        else if (ShouldGet(ItemType.Object))
                         {
-                            // fruit products
-                            case SObject.FruitsCategory:
-                                // wine
-                                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 2 + item.ParentSheetIndex, _ => new SObject(348, 1)
+                            // spawn main item
+                            SObject item = null;
+                            yield return this.TryCreate(ItemType.Object, id, p =>
+                            {
+                                return item = (p.ID == 812 // roe
+                                    ? new ColoredObject(p.ID, 1, Color.White)
+                                    : new SObject(p.ID, 1)
+                                );
+                            });
+                            if (item == null)
+                                continue;
+
+                            // flavored items
+                            if (includeVariants)
+                            {
+                                switch (item.Category)
                                 {
-                                    Name = $"{item.Name} Wine",
-                                    Price = item.Price * 3,
-                                    preserve = { SObject.PreserveType.Wine },
-                                    preservedParentSheetIndex = { item.ParentSheetIndex }
-                                });
-
-                                // jelly
-                                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 3 + item.ParentSheetIndex, _ => new SObject(344, 1)
-                                {
-                                    Name = $"{item.Name} Jelly",
-                                    Price = 50 + item.Price * 2,
-                                    preserve = { SObject.PreserveType.Jelly },
-                                    preservedParentSheetIndex = { item.ParentSheetIndex }
-                                });
-                                break;
-
-                            // vegetable products
-                            case SObject.VegetableCategory:
-                                // juice
-                                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 4 + item.ParentSheetIndex, _ => new SObject(350, 1)
-                                {
-                                    Name = $"{item.Name} Juice",
-                                    Price = (int)(item.Price * 2.25d),
-                                    preserve = { SObject.PreserveType.Juice },
-                                    preservedParentSheetIndex = { item.ParentSheetIndex }
-                                });
-
-                                // pickled
-                                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + item.ParentSheetIndex, _ => new SObject(342, 1)
-                                {
-                                    Name = $"Pickled {item.Name}",
-                                    Price = 50 + item.Price * 2,
-                                    preserve = { SObject.PreserveType.Pickle },
-                                    preservedParentSheetIndex = { item.ParentSheetIndex }
-                                });
-                                break;
-
-                            // flower honey
-                            case SObject.flowersCategory:
-                                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + item.ParentSheetIndex, _ =>
-                                {
-                                    SObject honey = new SObject(Vector2.Zero, 340, $"{item.Name} Honey", false, true, false, false)
-                                    {
-                                        Name = $"{item.Name} Honey",
-                                        preservedParentSheetIndex = { item.ParentSheetIndex }
-                                    };
-                                    honey.Price += item.Price * 2;
-                                    return honey;
-                                });
-                                break;
-
-                            // roe and aged roe (derived from FishPond.GetFishProduce)
-                            case SObject.sellAtFishShopCategory when item.ParentSheetIndex == 812:
-                                {
-                                    this.GetRoeContextTagLookups(out HashSet<string> simpleTags, out List<List<string>> complexTags);
-
-                                    foreach (var pair in Game1.objectInformation)
-                                    {
-                                        // get input
-                                        SObject input = this.TryCreate(ItemType.Object, pair.Key, p => new SObject(p.ID, 1))?.Item as SObject;
-                                        var inputTags = input?.GetContextTags();
-                                        if (inputTags?.Any() != true)
-                                            continue;
-
-                                        // check if roe-producing fish
-                                        if (!inputTags.Any(tag => simpleTags.Contains(tag)) && !complexTags.Any(set => set.All(tag => input.HasContextTag(tag))))
-                                            continue;
-
-                                        // yield roe
-                                        SObject roe = null;
-                                        Color color = this.GetRoeColor(input);
-                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + item.ParentSheetIndex, _ =>
+                                    // fruit products
+                                    case SObject.FruitsCategory:
+                                        // wine
+                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 2 + item.ParentSheetIndex, _ => new SObject(348, 1)
                                         {
-                                            roe = new ColoredObject(812, 1, color)
-                                            {
-                                                name = $"{input.Name} Roe",
-                                                preserve = { Value = SObject.PreserveType.Roe },
-                                                preservedParentSheetIndex = { Value = input.ParentSheetIndex }
-                                            };
-                                            roe.Price += input.Price / 2;
-                                            return roe;
+                                            Name = $"{item.Name} Wine",
+                                            Price = item.Price * 3,
+                                            preserve = { SObject.PreserveType.Wine },
+                                            preservedParentSheetIndex = { item.ParentSheetIndex }
                                         });
 
-                                        // aged roe
-                                        if (roe != null && pair.Key != 698) // aged sturgeon roe is caviar, which is a separate item
+                                        // jelly
+                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 3 + item.ParentSheetIndex, _ => new SObject(344, 1)
                                         {
-                                            yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + item.ParentSheetIndex, _ => new ColoredObject(447, 1, color)
+                                            Name = $"{item.Name} Jelly",
+                                            Price = 50 + item.Price * 2,
+                                            preserve = { SObject.PreserveType.Jelly },
+                                            preservedParentSheetIndex = { item.ParentSheetIndex }
+                                        });
+                                        break;
+
+                                    // vegetable products
+                                    case SObject.VegetableCategory:
+                                        // juice
+                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 4 + item.ParentSheetIndex, _ => new SObject(350, 1)
+                                        {
+                                            Name = $"{item.Name} Juice",
+                                            Price = (int)(item.Price * 2.25d),
+                                            preserve = { SObject.PreserveType.Juice },
+                                            preservedParentSheetIndex = { item.ParentSheetIndex }
+                                        });
+
+                                        // pickled
+                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + item.ParentSheetIndex, _ => new SObject(342, 1)
+                                        {
+                                            Name = $"Pickled {item.Name}",
+                                            Price = 50 + item.Price * 2,
+                                            preserve = { SObject.PreserveType.Pickle },
+                                            preservedParentSheetIndex = { item.ParentSheetIndex }
+                                        });
+                                        break;
+
+                                    // flower honey
+                                    case SObject.flowersCategory:
+                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + item.ParentSheetIndex, _ =>
+                                        {
+                                            SObject honey = new SObject(Vector2.Zero, 340, $"{item.Name} Honey", false, true, false, false)
                                             {
-                                                name = $"Aged {input.Name} Roe",
-                                                Category = -27,
-                                                preserve = { Value = SObject.PreserveType.AgedRoe },
-                                                preservedParentSheetIndex = { Value = input.ParentSheetIndex },
-                                                Price = roe.Price * 2
-                                            });
+                                                Name = $"{item.Name} Honey",
+                                                preservedParentSheetIndex = { item.ParentSheetIndex }
+                                            };
+                                            honey.Price += item.Price * 2;
+                                            return honey;
+                                        });
+                                        break;
+
+                                    // roe and aged roe (derived from FishPond.GetFishProduce)
+                                    case SObject.sellAtFishShopCategory when item.ParentSheetIndex == 812:
+                                        {
+                                            this.GetRoeContextTagLookups(out HashSet<string> simpleTags, out List<List<string>> complexTags);
+
+                                            foreach (var pair in Game1.objectInformation)
+                                            {
+                                                // get input
+                                                SObject input = this.TryCreate(ItemType.Object, pair.Key, p => new SObject(p.ID, 1))?.Item as SObject;
+                                                var inputTags = input?.GetContextTags();
+                                                if (inputTags?.Any() != true)
+                                                    continue;
+
+                                                // check if roe-producing fish
+                                                if (!inputTags.Any(tag => simpleTags.Contains(tag)) && !complexTags.Any(set => set.All(tag => input.HasContextTag(tag))))
+                                                    continue;
+
+                                                // yield roe
+                                                SObject roe = null;
+                                                Color color = this.GetRoeColor(input);
+                                                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + item.ParentSheetIndex, _ =>
+                                                {
+                                                    roe = new ColoredObject(812, 1, color)
+                                                    {
+                                                        name = $"{input.Name} Roe",
+                                                        preserve = { Value = SObject.PreserveType.Roe },
+                                                        preservedParentSheetIndex = { Value = input.ParentSheetIndex }
+                                                    };
+                                                    roe.Price += input.Price / 2;
+                                                    return roe;
+                                                });
+
+                                                // aged roe
+                                                if (roe != null && pair.Key != 698) // aged sturgeon roe is caviar, which is a separate item
+                                                {
+                                                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + item.ParentSheetIndex, _ => new ColoredObject(447, 1, color)
+                                                    {
+                                                        name = $"Aged {input.Name} Roe",
+                                                        Category = -27,
+                                                        preserve = { Value = SObject.PreserveType.AgedRoe },
+                                                        preservedParentSheetIndex = { Value = input.ParentSheetIndex },
+                                                        Price = roe.Price * 2
+                                                    });
+                                                }
+                                            }
                                         }
-                                    }
+                                        break;
                                 }
-                                break;
+                            }
                         }
                     }
                 }

From c310875f902f82ef3b9486e2ff3705106b2ad40c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 19 May 2021 23:38:10 -0400
Subject: [PATCH 181/856] fix 'loaded with custom settings' message shown with
 default settings

---
 docs/release-notes.md                 | 1 +
 src/SMAPI/Framework/Models/SConfig.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 666dc8e4..a0b64bdc 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -15,6 +15,7 @@
 * For mod authors:
   * Added validation for the manifest `Dependencies` field.
   * Fixed validation for mods with version `0.0.0`.
+  * Fixed _loaded with custom settings_ trace log when using default settings.
 
 ## 3.10.1
 Released 03 May 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index a71bafd9..10bf9f94 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(VerboseLogging)] = false,
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
-            [nameof(AggressiveMemoryOptimizations)] = true
+            [nameof(AggressiveMemoryOptimizations)] = false
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>

From 38a76b5108f679fedb0032a1d70bd8ca89f47283 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 22 May 2021 11:24:34 -0400
Subject: [PATCH 182/856] allow comments and trailing commas in schemas for
 VSCode

The `allowComments` and `allowTrailingCommas` fields are VSCode-specific extensions to JSON Schema.
---
 docs/release-notes.md                              | 1 +
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 5 ++++-
 src/SMAPI.Web/wwwroot/schemas/i18n.json            | 5 ++++-
 src/SMAPI.Web/wwwroot/schemas/manifest.json        | 4 ++++
 4 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a0b64bdc..1497d6c9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -14,6 +14,7 @@
 
 * For mod authors:
   * Added validation for the manifest `Dependencies` field.
+  * When using Visual Studio Code to edit JSON files [with a SMAPI JSON schema](technical/web.md#using-a-schema-file-directly), it will no longer warn about comments or trailing commas.
   * Fixed validation for mods with version `0.0.0`.
   * Fixed _loaded with custom settings_ trace log when using default settings.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index 49900da6..6e6278de 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -4,8 +4,11 @@
     "title": "Content Patcher content pack",
     "description": "Content Patcher content file for mods",
     "@documentationUrl": "https://github.com/Pathoschild/StardewMods/tree/develop/ContentPatcher#readme",
-    "type": "object",
 
+    "allowComments": true,
+    "allowTrailingCommas": true,
+
+    "type": "object",
     "properties": {
         "Format": {
             "title": "Format version",
diff --git a/src/SMAPI.Web/wwwroot/schemas/i18n.json b/src/SMAPI.Web/wwwroot/schemas/i18n.json
index 493ad213..313daa59 100644
--- a/src/SMAPI.Web/wwwroot/schemas/i18n.json
+++ b/src/SMAPI.Web/wwwroot/schemas/i18n.json
@@ -4,8 +4,11 @@
     "title": "SMAPI i18n file",
     "description": "A translation file for a SMAPI mod or content pack.",
     "@documentationUrl": "https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Translation",
-    "type": "object",
 
+    "allowComments": true,
+    "allowTrailingCommas": true,
+
+    "type": "object",
     "properties": {
         "$schema": {
             "title": "Schema",
diff --git a/src/SMAPI.Web/wwwroot/schemas/manifest.json b/src/SMAPI.Web/wwwroot/schemas/manifest.json
index 0b265201..05698ba2 100644
--- a/src/SMAPI.Web/wwwroot/schemas/manifest.json
+++ b/src/SMAPI.Web/wwwroot/schemas/manifest.json
@@ -4,6 +4,10 @@
     "title": "SMAPI manifest",
     "description": "Manifest file for a SMAPI mod or content pack",
     "@documentationUrl": "https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Manifest",
+
+    "allowComments": true,
+    "allowTrailingCommas": true,
+
     "type": "object",
     "properties": {
         "Name": {

From 112b505118e65d2741a5cfebce44abd02742dd2f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 25 May 2021 17:42:24 -0400
Subject: [PATCH 183/856] update schema for Content Patcher 1.23

---
 docs/release-notes.md                              | 3 +++
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 4 ++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1497d6c9..b12e8931 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,6 +18,9 @@
   * Fixed validation for mods with version `0.0.0`.
   * Fixed _loaded with custom settings_ trace log when using default settings.
 
+* For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.23.
+
 ## 3.10.1
 Released 03 May 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index 6e6278de..aac4ff0f 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -14,9 +14,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features and avoid obsolete behavior.",
             "type": "string",
-            "const": "1.22.0",
+            "const": "1.23.0",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.22.0'."
+                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.23.0'."
             }
         },
         "ConfigSchema": {

From b149e11338ba2dbaf030a70783d28b6be21ccf1e Mon Sep 17 00:00:00 2001
From: DiscipleOfEris <discipleoferis1@gmail.com>
Date: Wed, 26 May 2021 11:50:49 -0700
Subject: [PATCH 184/856] Add `World.FurnitureListChanged` event

Create a new event available to SMAPI mods to track furniture changes. To facilitate the event, a `FurnitureListChangedEventArgs` class is added as well.

Fixes #778
---
 .../Events/FurnitureListChangedEventArgs.cs   | 44 +++++++++++++++++++
 src/SMAPI/Events/IWorldEvents.cs              |  3 ++
 src/SMAPI/Framework/Events/EventManager.cs    |  4 ++
 src/SMAPI/Framework/Events/ModWorldEvents.cs  |  7 +++
 src/SMAPI/Framework/SCore.cs                  |  4 ++
 .../StateTracking/LocationTracker.cs          |  7 ++-
 .../Snapshots/LocationSnapshot.cs             |  4 ++
 7 files changed, 72 insertions(+), 1 deletion(-)
 create mode 100644 src/SMAPI/Events/FurnitureListChangedEventArgs.cs

diff --git a/src/SMAPI/Events/FurnitureListChangedEventArgs.cs b/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
new file mode 100644
index 00000000..04fcf9ff
--- /dev/null
+++ b/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
@@ -0,0 +1,44 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using StardewValley;
+using StardewValley.Objects;
+
+namespace StardewModdingAPI.Events
+{
+    /// <summary>Event arguments for a <see cref="IWorldEvents.FurnitureListChanged"/> event.</summary>
+    public class FurnitureListChangedEventArgs : EventArgs
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The location which changed.</summary>
+        public GameLocation Location { get; }
+
+        /// <summary>The furniture added to the location.</summary>
+        public IEnumerable<Furniture> Added { get; }
+
+        /// <summary>The furniture removed from the location.</summary>
+        public IEnumerable<Furniture> Removed { get; }
+
+        /// <summary>Whether this is the location containing the local player.</summary>
+        public bool IsCurrentLocation => object.ReferenceEquals(this.Location, Game1.player?.currentLocation);
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="location">The location which changed.</param>
+        /// <param name="added">The furniture added to the location.</param>
+        /// <param name="removed">The furniture removed from the location.</param>
+        internal FurnitureListChangedEventArgs(GameLocation location, IEnumerable<Furniture> added, IEnumerable<Furniture> removed)
+        {
+            this.Location = location;
+            this.Added = added.ToArray();
+            this.Removed = removed.ToArray();
+        }
+    }
+}
diff --git a/src/SMAPI/Events/IWorldEvents.cs b/src/SMAPI/Events/IWorldEvents.cs
index 9569a57b..c023e1f0 100644
--- a/src/SMAPI/Events/IWorldEvents.cs
+++ b/src/SMAPI/Events/IWorldEvents.cs
@@ -28,5 +28,8 @@ namespace StardewModdingAPI.Events
 
         /// <summary>Raised after terrain features (like floors and trees) are added or removed in a location.</summary>
         event EventHandler<TerrainFeatureListChangedEventArgs> TerrainFeatureListChanged;
+
+        /// <summary>Raised after furniture are added or removed in a location.</summary>
+        event EventHandler<FurnitureListChangedEventArgs> FurnitureListChanged;
     }
 }
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index f4abfffe..dfc289ed 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -162,6 +162,9 @@ namespace StardewModdingAPI.Framework.Events
         /// <summary>Raised after terrain features (like floors and trees) are added or removed in a location.</summary>
         public readonly ManagedEvent<TerrainFeatureListChangedEventArgs> TerrainFeatureListChanged;
 
+        /// <summary>Raised after furniture are added or removed in a location.</summary>
+        public readonly ManagedEvent<FurnitureListChangedEventArgs> FurnitureListChanged;
+
         /****
         ** Specialized
         ****/
@@ -238,6 +241,7 @@ namespace StardewModdingAPI.Framework.Events
             this.ObjectListChanged = ManageEventOf<ObjectListChangedEventArgs>(nameof(IModEvents.World), nameof(IWorldEvents.ObjectListChanged));
             this.ChestInventoryChanged = ManageEventOf<ChestInventoryChangedEventArgs>(nameof(IModEvents.World), nameof(IWorldEvents.ChestInventoryChanged));
             this.TerrainFeatureListChanged = ManageEventOf<TerrainFeatureListChangedEventArgs>(nameof(IModEvents.World), nameof(IWorldEvents.TerrainFeatureListChanged));
+            this.FurnitureListChanged = ManageEventOf<FurnitureListChangedEventArgs>(nameof(IModEvents.World), nameof(IWorldEvents.FurnitureListChanged));
 
             this.LoadStageChanged = ManageEventOf<LoadStageChangedEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.LoadStageChanged));
             this.UnvalidatedUpdateTicking = ManageEventOf<UnvalidatedUpdateTickingEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.UnvalidatedUpdateTicking), isPerformanceCritical: true);
diff --git a/src/SMAPI/Framework/Events/ModWorldEvents.cs b/src/SMAPI/Framework/Events/ModWorldEvents.cs
index 21b1b664..f4c40abc 100644
--- a/src/SMAPI/Framework/Events/ModWorldEvents.cs
+++ b/src/SMAPI/Framework/Events/ModWorldEvents.cs
@@ -65,6 +65,13 @@ namespace StardewModdingAPI.Framework.Events
             remove => this.EventManager.TerrainFeatureListChanged.Remove(value);
         }
 
+        /// <summary>Raised after furniture are added or removed in a location.</summary>
+        public event EventHandler<FurnitureListChangedEventArgs> FurnitureListChanged
+        {
+            add => this.EventManager.FurnitureListChanged.Add(value, this.Mod);
+            remove => this.EventManager.FurnitureListChanged.Remove(value);
+        }
+
 
         /*********
         ** Public methods
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 8b2c7544..bf88798b 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -914,6 +914,10 @@ namespace StardewModdingAPI.Framework
                                 // terrain features changed
                                 if (locState.TerrainFeatures.IsChanged)
                                     events.TerrainFeatureListChanged.Raise(new TerrainFeatureListChangedEventArgs(location, locState.TerrainFeatures.Added, locState.TerrainFeatures.Removed));
+
+                                // furniture changed
+                                if (locState.Furniture.IsChanged)
+                                    events.FurnitureListChanged.Raise(new FurnitureListChangedEventArgs(location, locState.Furniture.Added, locState.Furniture.Removed));
                             }
                         }
 
diff --git a/src/SMAPI/Framework/StateTracking/LocationTracker.cs b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
index 519fe8f4..6d3a62bb 100644
--- a/src/SMAPI/Framework/StateTracking/LocationTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
@@ -48,6 +48,9 @@ namespace StardewModdingAPI.Framework.StateTracking
         /// <summary>Tracks added or removed terrain features.</summary>
         public IDictionaryWatcher<Vector2, TerrainFeature> TerrainFeaturesWatcher { get; }
 
+        /// <summary>Tracks added or removed furniture.</summary>
+        public ICollectionWatcher<Furniture> FurnitureWatcher { get; }
+
         /// <summary>Tracks items added or removed to chests.</summary>
         public IDictionary<Vector2, ChestTracker> ChestWatchers { get; } = new Dictionary<Vector2, ChestTracker>();
 
@@ -68,6 +71,7 @@ namespace StardewModdingAPI.Framework.StateTracking
             this.NpcsWatcher = WatcherFactory.ForNetCollection(location.characters);
             this.ObjectsWatcher = WatcherFactory.ForNetDictionary(location.netObjects);
             this.TerrainFeaturesWatcher = WatcherFactory.ForNetDictionary(location.terrainFeatures);
+            this.FurnitureWatcher = WatcherFactory.ForNetCollection(location.furniture);
 
             this.Watchers.AddRange(new IWatcher[]
             {
@@ -76,7 +80,8 @@ namespace StardewModdingAPI.Framework.StateTracking
                 this.LargeTerrainFeaturesWatcher,
                 this.NpcsWatcher,
                 this.ObjectsWatcher,
-                this.TerrainFeaturesWatcher
+                this.TerrainFeaturesWatcher,
+                this.FurnitureWatcher
             });
 
             this.UpdateChestWatcherList(added: location.Objects.Pairs, removed: new KeyValuePair<Vector2, SObject>[0]);
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
index 6ae52fd0..6c9cc4f5 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
@@ -34,6 +34,9 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         /// <summary>Tracks added or removed terrain features.</summary>
         public SnapshotListDiff<KeyValuePair<Vector2, TerrainFeature>> TerrainFeatures { get; } = new SnapshotListDiff<KeyValuePair<Vector2, TerrainFeature>>();
 
+        /// <summary>Tracks added or removed furniture.</summary>
+        public SnapshotListDiff<Furniture> Furniture { get; } = new SnapshotListDiff<Furniture>();
+
         /// <summary>Tracks changed chest inventories.</summary>
         public IDictionary<Chest, SnapshotItemListDiff> ChestItems { get; } = new Dictionary<Chest, SnapshotItemListDiff>();
 
@@ -59,6 +62,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
             this.Npcs.Update(watcher.NpcsWatcher);
             this.Objects.Update(watcher.ObjectsWatcher);
             this.TerrainFeatures.Update(watcher.TerrainFeaturesWatcher);
+            this.Furniture.Update(watcher.FurnitureWatcher);
 
             // chest inventories
             this.ChestItems.Clear();

From 9d7b31afc45b89278f5a74697da51a47215d6592 Mon Sep 17 00:00:00 2001
From: DiscipleOfEris <discipleoferis1@gmail.com>
Date: Wed, 26 May 2021 11:57:52 -0700
Subject: [PATCH 185/856] Update FurnitureListChangedEventArgs.cs

Prune unnecessary `using` statements
---
 src/SMAPI/Events/FurnitureListChangedEventArgs.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/SMAPI/Events/FurnitureListChangedEventArgs.cs b/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
index 04fcf9ff..683f4620 100644
--- a/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
+++ b/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
@@ -1,8 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 using StardewValley;
 using StardewValley.Objects;
 

From be93327a80efdc6d592854f7c552c45cbb43b569 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 26 May 2021 20:11:01 -0400
Subject: [PATCH 186/856] update release notes

---
 docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b12e8931..5904c192 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
   * Fixed `player_add` and `list_items` console commands not including some shirts _(in Console Commands)_.
 
 * For mod authors:
+  * Added `World.FurnitureListChanged` event (thanks to DiscipleOfEris!).
   * Added validation for the manifest `Dependencies` field.
   * When using Visual Studio Code to edit JSON files [with a SMAPI JSON schema](technical/web.md#using-a-schema-file-directly), it will no longer warn about comments or trailing commas.
   * Fixed validation for mods with version `0.0.0`.

From 03f8777afd4f0707dc8e61eae6e5eae73a88d738 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 27 May 2021 22:59:06 -0400
Subject: [PATCH 187/856] add asset propagation for paint masks

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 50 +++++++++++++++++++----
 2 files changed, 43 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5904c192..b7b053b8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -14,6 +14,7 @@
 
 * For mod authors:
   * Added `World.FurnitureListChanged` event (thanks to DiscipleOfEris!).
+  * Added asset propagation for building/house paint masks.
   * Added validation for the manifest `Dependencies` field.
   * When using Visual Studio Code to edit JSON files [with a SMAPI JSON schema](technical/web.md#using-a-schema-file-directly), it will no longer warn about comments or trailing commas.
   * Fixed validation for mods with version `0.0.0`.
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 623c65d5..5641f90f 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -233,6 +233,16 @@ namespace StardewModdingAPI.Metadata
                         return true;
                     }
 
+                case "buildings\\houses_paintmask": // Farm
+                    {
+                        bool removedFromCache = this.RemoveFromPaintMaskCache(key);
+
+                        Farm farm = Game1.getFarm();
+                        farm?.ApplyHousePaint();
+
+                        return removedFromCache || farm != null;
+                    }
+
                 /****
                 ** Content\Characters\Farmer
                 ****/
@@ -613,7 +623,7 @@ namespace StardewModdingAPI.Metadata
                     return this.ReloadFarmAnimalSprites(content, key);
 
                 if (this.IsInFolder(key, "Buildings"))
-                    return this.ReloadBuildings(content, key);
+                    return this.ReloadBuildings(key);
 
                 if (this.KeyStartsWith(key, "LooseSprites\\Fence"))
                     return this.ReloadFenceTextures(key);
@@ -717,28 +727,39 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Reload building textures.</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="key">The asset key to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadBuildings(LocalizedContentManager content, string key)
+        private bool ReloadBuildings(string key)
         {
-            // get buildings
+            // get paint mask info
+            const string paintMaskSuffix = "_PaintMask";
+            bool isPaintMask = key.EndsWith(paintMaskSuffix, StringComparison.OrdinalIgnoreCase);
+
+            // get building type
             string type = Path.GetFileName(key);
+            if (isPaintMask)
+                type = type.Substring(0, type.Length - paintMaskSuffix.Length);
+
+            // get buildings
             Building[] buildings = this.GetLocations(buildingInteriors: false)
                 .OfType<BuildableGameLocation>()
                 .SelectMany(p => p.buildings)
                 .Where(p => p.buildingType.Value == type)
                 .ToArray();
 
-            // reload buildings
+            // remove from paint mask cache
+            bool removedFromCache = this.RemoveFromPaintMaskCache(key);
+
+            // reload textures
             if (buildings.Any())
             {
-                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
                 foreach (Building building in buildings)
-                    building.texture = texture;
+                    building.resetTexture();
+
                 return true;
             }
-            return false;
+
+            return removedFromCache;
         }
 
         /// <summary>Reload map seat textures.</summary>
@@ -1295,5 +1316,18 @@ namespace StardewModdingAPI.Metadata
             // else just (re)load it from the main content manager
             return this.MainContentManager.Load<Texture2D>(key);
         }
+
+        /// <summary>Remove a case-insensitive key from the paint mask cache.</summary>
+        /// <param name="key">The paint mask asset key.</param>
+        private bool RemoveFromPaintMaskCache(string key)
+        {
+            // make cache case-insensitive
+            // This is needed for cache invalidation since mods may specify keys with a different capitalization
+            if (!object.ReferenceEquals(BuildingPainter.paintMaskLookup.Comparer, StringComparer.OrdinalIgnoreCase))
+                BuildingPainter.paintMaskLookup = new Dictionary<string, List<List<int>>>(BuildingPainter.paintMaskLookup, StringComparer.OrdinalIgnoreCase);
+
+            // remove key from cache
+            return BuildingPainter.paintMaskLookup.Remove(key);
+        }
     }
 }

From dfa3beb6a6ba09d350aecc5bc3a8db3f2bd99ab7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 28 May 2021 20:24:29 -0400
Subject: [PATCH 188/856] fix i18n schema requiring wrong $schema value

---
 docs/release-notes.md                   | 3 ++-
 src/SMAPI.Web/wwwroot/schemas/i18n.json | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b7b053b8..3475a26a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,7 +16,8 @@
   * Added `World.FurnitureListChanged` event (thanks to DiscipleOfEris!).
   * Added asset propagation for building/house paint masks.
   * Added validation for the manifest `Dependencies` field.
-  * When using Visual Studio Code to edit JSON files [with a SMAPI JSON schema](technical/web.md#using-a-schema-file-directly), it will no longer warn about comments or trailing commas.
+  * Fixed [JSON schema](technical/web.md#using-a-schema-file-directly) in Visual Studio Code warning about comments or trailing commas.
+  * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.
   * Fixed validation for mods with version `0.0.0`.
   * Fixed _loaded with custom settings_ trace log when using default settings.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/i18n.json b/src/SMAPI.Web/wwwroot/schemas/i18n.json
index 313daa59..36c04890 100644
--- a/src/SMAPI.Web/wwwroot/schemas/i18n.json
+++ b/src/SMAPI.Web/wwwroot/schemas/i18n.json
@@ -14,7 +14,7 @@
             "title": "Schema",
             "description": "A reference to this JSON schema. Not part of the actual format, but useful for validation tools.",
             "type": "string",
-            "const": "https://smapi.io/schemas/manifest.json"
+            "const": "https://smapi.io/schemas/i18n.json"
         }
     },
 

From c212ff15d28ead57588e130247e9bbfd0b3eab0d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Jun 2021 18:39:38 -0400
Subject: [PATCH 189/856] fix installer error for some Windows players

---
 docs/release-notes.md                          | 1 +
 src/SMAPI.Installer/assets/windows-install.bat | 5 ++---
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3475a26a..7ac1b518 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -20,6 +20,7 @@
   * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.
   * Fixed validation for mods with version `0.0.0`.
   * Fixed _loaded with custom settings_ trace log when using default settings.
+  * Fixed installer error on some older Windows systems (thanks to eddyballs!).
 
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.23.
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index 18c40a64..2cd98554 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -1,9 +1,8 @@
 @echo off
-echo %~dp0 | findstr /C:"%TEMP%" 1>nul
+echo "%~dp0" | findstr /C:"%TEMP%" 1>nul
 if not errorlevel 1 (
    echo Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first.
    pause
 ) else (
-   cd "%~dp0"
-   start /WAIT /B ./internal/windows-install.exe
+   start /WAIT /B internal\windows-install.exe
 )

From 4df8f4a656ce68b5bb7dc76eefd6da9c27620928 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Jun 2021 19:14:59 -0400
Subject: [PATCH 190/856] fix edge case where save constants aren't set
 correctly

---
 docs/release-notes.md  |  3 ++-
 src/SMAPI/Constants.cs | 47 ++++++++++++++++++++++++++----------------
 2 files changed, 31 insertions(+), 19 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7ac1b518..0879a072 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,7 @@
 * For players:
   * Fixed error when running the Windows installer as administrator (thanks to LostLogic!).
   * Fixed `player_add` and `list_items` console commands not including some shirts _(in Console Commands)_.
+  * Fixed installer error on some older Windows systems (thanks to eddyballs!).
 
 * For mod authors:
   * Added `World.FurnitureListChanged` event (thanks to DiscipleOfEris!).
@@ -20,7 +21,7 @@
   * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.
   * Fixed validation for mods with version `0.0.0`.
   * Fixed _loaded with custom settings_ trace log when using default settings.
-  * Fixed installer error on some older Windows systems (thanks to eddyballs!).
+  * Fixed `Constants.SaveFolderName` and `Constants.CurrentSavePath` not set correctly in rare cases.
 
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.23.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 2e476208..38e8c500 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -322,31 +322,42 @@ namespace StardewModdingAPI
         /// <summary>Get the name of the save folder, if any.</summary>
         private static string GetSaveFolderName()
         {
-            // save not available
-            if (Context.LoadStage == LoadStage.None)
-                return null;
-
-            // get basic info
-            string saveName = Game1.GetSaveGameName(set_value: false);
-            ulong saveID = Context.LoadStage == LoadStage.SaveParsed
-                ? SaveGame.loaded.uniqueIDForThisGame
-                : Game1.uniqueIDForThisGame;
-
-            // build folder name
-            return $"{new string(saveName.Where(char.IsLetterOrDigit).ToArray())}_{saveID}";
+            return Constants.GetSaveFolder()?.Name;
         }
 
         /// <summary>Get the path to the current save folder, if any.</summary>
         private static string GetSaveFolderPathIfExists()
         {
-            string folderName = Constants.GetSaveFolderName();
-            if (folderName == null)
+            DirectoryInfo saveFolder = Constants.GetSaveFolder();
+            return saveFolder?.Exists == true
+                ? saveFolder.FullName
+                : null;
+        }
+
+        /// <summary>Get the current save folder, if any.</summary>
+        private static DirectoryInfo GetSaveFolder()
+        {
+            // save not available
+            if (Context.LoadStage == LoadStage.None)
                 return null;
 
-            string path = Path.Combine(Constants.SavesPath, folderName);
-            return Directory.Exists(path)
-                ? path
-                : null;
+            // get basic info
+            string rawSaveName = Game1.GetSaveGameName(set_value: false);
+            ulong saveID = Context.LoadStage == LoadStage.SaveParsed
+                ? SaveGame.loaded.uniqueIDForThisGame
+                : Game1.uniqueIDForThisGame;
+
+            // get best match (accounting for rare case where folder name isn't sanitized)
+            DirectoryInfo folder = null;
+            foreach (string saveName in new[] { rawSaveName, new string(rawSaveName.Where(char.IsLetterOrDigit).ToArray()) })
+            {
+                folder = new DirectoryInfo(Path.Combine(Constants.SavesPath, $"{saveName}_{saveID}"));
+                if (folder.Exists)
+                    return folder;
+            }
+
+            // if save doesn't exist yet, return the default one we expect to be created
+            return folder;
         }
     }
 }

From 66f8920c29567de615dbcb0a06e78f774d128f6b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 24 Jun 2021 20:17:34 -0400
Subject: [PATCH 191/856] log trace message if conflicting software is detected

---
 docs/release-notes.md        |  1 +
 src/SMAPI/Framework/SCore.cs | 55 ++++++++++++++++++++++++++++++++++++
 2 files changed, 56 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0879a072..f3f66430 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -17,6 +17,7 @@
   * Added `World.FurnitureListChanged` event (thanks to DiscipleOfEris!).
   * Added asset propagation for building/house paint masks.
   * Added validation for the manifest `Dependencies` field.
+  * Added `TRACE` message if software known to cause issues is installed (currently MSI Afterburner and RivaTuner), to simplify troubleshooting.
   * Fixed [JSON schema](technical/web.md#using-a-schema-file-directly) in Visual Studio Code warning about comments or trailing commas.
   * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.
   * Fixed validation for mods with version `0.0.0`.
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index bf88798b..2de2b21a 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -11,6 +11,9 @@ using System.Security;
 using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
+#if SMAPI_FOR_WINDOWS
+using Microsoft.Win32;
+#endif
 using Microsoft.Xna.Framework;
 #if SMAPI_FOR_XNA
 using System.Windows.Forms;
@@ -376,6 +379,9 @@ namespace StardewModdingAPI.Framework
                 mods = resolver.ProcessDependencies(mods, modDatabase).ToArray();
                 this.LoadMods(mods, this.Toolkit.JsonHelper, this.ContentCore, modDatabase);
 
+                // check for software likely to cause issues
+                this.CheckForSoftwareConflicts();
+
                 // check for updates
                 this.CheckForUpdatesAsync(mods);
             }
@@ -1251,6 +1257,55 @@ namespace StardewModdingAPI.Framework
             this.LogManager.SetConsoleTitle(consoleTitle);
         }
 
+        /// <summary>Log a warning if software known to cause issues is installed.</summary>
+        private void CheckForSoftwareConflicts()
+        {
+#if SMAPI_FOR_WINDOWS
+            this.Monitor.Log("Checking for known software conflicts...");
+
+            try
+            {
+                string[] registryKeys = { @"SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall", @"SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" };
+
+                string[] installedNames = registryKeys
+                    .SelectMany(registryKey =>
+                    {
+                        using RegistryKey key = Registry.LocalMachine.OpenSubKey(registryKey);
+                        if (key == null)
+                            return new string[0];
+
+                        return key
+                            .GetSubKeyNames()
+                            .Select(subkeyName =>
+                            {
+                                using RegistryKey subkey = key.OpenSubKey(subkeyName);
+                                string displayName = (string)subkey?.GetValue("DisplayName");
+                                string displayVersion = (string)subkey?.GetValue("DisplayVersion");
+
+                                if (displayName != null && displayVersion != null && displayName.EndsWith($" {displayVersion}"))
+                                    displayName = displayName.Substring(0, displayName.Length - displayVersion.Length - 1);
+
+                                return displayName;
+                            })
+                            .ToArray();
+                    })
+                    .Where(name => name != null && (name.Contains("MSI Afterburner") || name.Contains("RivaTuner")))
+                    .Distinct()
+                    .OrderBy(name => name)
+                    .ToArray();
+
+                if (installedNames.Any())
+                    this.Monitor.Log($"   Found {string.Join(" and ", installedNames)} installed, which can conflict with SMAPI. If you experience errors or crashes, try disabling that software or adding an exception for SMAPI / Stardew Valley.");
+                else
+                    this.Monitor.Log("   None found!");
+            }
+            catch (Exception ex)
+            {
+                this.Monitor.Log($"Failed when checking for conflicting software. Technical details:\n{ex}");
+            }
+#endif
+        }
+
         /// <summary>Asynchronously check for a new version of SMAPI and any installed mods, and print alerts to the console if an update is available.</summary>
         /// <param name="mods">The mods to include in the update check (if eligible).</param>
         private void CheckForUpdatesAsync(IModMetadata[] mods)

From 5e3a1abbd421196ee63442c82cb6606b6630a6ca Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Jun 2021 11:16:12 -0400
Subject: [PATCH 192/856] improve error if SMAPI fails to dispose on exit

---
 docs/release-notes.md        | 7 ++++---
 src/SMAPI/Framework/SCore.cs | 9 ++++++++-
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f3f66430..76539ff6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For players:
+  * Improved error if SMAPI fails to dispose on game exit.
   * Fixed error when running the Windows installer as administrator (thanks to LostLogic!).
   * Fixed `player_add` and `list_items` console commands not including some shirts _(in Console Commands)_.
   * Fixed installer error on some older Windows systems (thanks to eddyballs!).
@@ -18,14 +19,14 @@
   * Added asset propagation for building/house paint masks.
   * Added validation for the manifest `Dependencies` field.
   * Added `TRACE` message if software known to cause issues is installed (currently MSI Afterburner and RivaTuner), to simplify troubleshooting.
-  * Fixed [JSON schema](technical/web.md#using-a-schema-file-directly) in Visual Studio Code warning about comments or trailing commas.
-  * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.
   * Fixed validation for mods with version `0.0.0`.
   * Fixed _loaded with custom settings_ trace log when using default settings.
   * Fixed `Constants.SaveFolderName` and `Constants.CurrentSavePath` not set correctly in rare cases.
 
-* For the web UI:
+* For the web UI and JSON validator:
   * Updated the JSON validator/schema for Content Patcher 1.23.
+  * Fixed [JSON schema](technical/web.md#using-a-schema-file-directly) in Visual Studio Code warning about comments or trailing commas.
+  * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.
 
 ## 3.10.1
 Released 03 May 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 2de2b21a..c3285979 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -297,7 +297,14 @@ namespace StardewModdingAPI.Framework
             }
             finally
             {
-                this.Dispose();
+                try
+                {
+                    this.Dispose();
+                }
+                catch (Exception ex)
+                {
+                    this.Monitor.Log($"The game ended, but SMAPI wasn't able to dispose correctly. Technical details: {ex}", LogLevel.Error);
+                }
             }
         }
 

From 7b097c4f6fd4f716b2afef6a684122ca0c060ac0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 2 Jul 2021 20:52:22 -0400
Subject: [PATCH 193/856] update launch script on Linux for 1.4.5 multiplayer
 hotfix (#789)

---
 docs/release-notes.md                       |  1 +
 src/SMAPI.Installer/assets/unix-launcher.sh | 18 +++++++++---------
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 76539ff6..c9fcbc12 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Improved error if SMAPI fails to dispose on game exit.
+  * Updated Linux launch script for Stardew Valley 1.4.5 multiplayer hotfix.
   * Fixed error when running the Windows installer as administrator (thanks to LostLogic!).
   * Fixed `player_add` and `list_items` console commands not including some shirts _(in Console Commands)_.
   * Fixed installer error on some older Windows systems (thanks to eddyballs!).
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index a33c0d7f..71056c21 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -79,44 +79,44 @@ else
             terminal|termite)
                 # consumes only one argument after -e
                 # options containing space characters are unsupported
-                exec $TERMINAL_NAME -e "env TERM=xterm $LAUNCH_FILE $@"
+                exec $TERMINAL_NAME -e "env TERM=xterm LC_ALL=\"C\" $LAUNCH_FILE $@"
                 ;;
 
             xterm|konsole|alacritty)
                 # consumes all arguments after -e
-                exec $TERMINAL_NAME -e env TERM=xterm $LAUNCH_FILE "$@"
+                exec $TERMINAL_NAME -e env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
                 ;;
 
             terminator|xfce4-terminal|mate-terminal)
                 # consumes all arguments after -x
-                exec $TERMINAL_NAME -x env TERM=xterm $LAUNCH_FILE "$@"
+                exec $TERMINAL_NAME -x env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
                 ;;
 
             gnome-terminal)
                 # consumes all arguments after --
-                exec $TERMINAL_NAME -- env TERM=xterm $LAUNCH_FILE "$@"
+                exec $TERMINAL_NAME -- env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
                 ;;
 
             kitty)
                 # consumes all trailing arguments
-                exec $TERMINAL_NAME env TERM=xterm $LAUNCH_FILE "$@"
+                exec $TERMINAL_NAME env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
                 ;;
 
             *)
                 # If we don't know the terminal, just try to run it in the current shell.
                 # If THAT fails, launch with no output.
-                env TERM=xterm $LAUNCH_FILE "$@"
+                env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
                 if [ $? -eq 127 ]; then
-                    exec $LAUNCH_FILE --no-terminal "$@"
+                    exec LC_ALL="C" $LAUNCH_FILE --no-terminal "$@"
                 fi
         esac
 
     ## terminal isn't executable; fallback to current shell or no terminal
     else
         echo "The '$TERMINAL_NAME' terminal isn't executable. SMAPI might be running in a sandbox or the system might be misconfigured? Falling back to current shell."
-        env TERM=xterm $LAUNCH_FILE "$@"
+        env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
         if [ $? -eq 127 ]; then
-            exec $LAUNCH_FILE --no-terminal "$@"
+            exec LC_ALL="C" $LAUNCH_FILE --no-terminal "$@"
         fi
     fi
 fi

From 40a4992170fe080111cb732f2ac79e0a59f1e199 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 7 Jul 2021 13:10:55 -0400
Subject: [PATCH 194/856] update launch script on macOS for 1.4.5 multiplayer
 hotfix (#789)

Thanks to Mr. Podunkian for his help investigating this on macOS!
---
 docs/release-notes.md                       |  2 +-
 src/SMAPI.Installer/assets/unix-launcher.sh | 28 ++++++++++++++++++++-
 2 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c9fcbc12..3214c09e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,7 +10,7 @@
 ## Upcoming release
 * For players:
   * Improved error if SMAPI fails to dispose on game exit.
-  * Updated Linux launch script for Stardew Valley 1.4.5 multiplayer hotfix.
+  * Updated Linux/macOS launch script for Stardew Valley 1.4.5 multiplayer hotfix.
   * Fixed error when running the Windows installer as administrator (thanks to LostLogic!).
   * Fixed `player_add` and `list_items` console commands not including some shirts _(in Console Commands)_.
   * Fixed installer error on some older Windows systems (thanks to eddyballs!).
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 71056c21..d309f750 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -43,8 +43,34 @@ if [ "$UNAME" == "Darwin" ]; then
         cp -p StardewValley.bin.osx StardewModdingAPI.bin.osx
     fi
 
+    # Make sure we're running in Terminal (so the user can see errors/warnings/update alerts).
+    # Previously we would just use `open -a Terminal` to launch the .bin.osx file, but that
+    # doesn't let us set environment variables.
+    if [ ! -t 1 ]; then # https://stackoverflow.com/q/911168/262123
+        # sanity check to make sure we don't have an infinite loop of opening windows
+        SKIP_TERMINAL=false
+        for argument in "$@"; do
+            if [ "$argument" == "--no-reopen-terminal" ]; then
+                SKIP_TERMINAL=true
+                break
+            fi
+        done
+
+        # reopen in Terminal if needed
+        # https://stackoverflow.com/a/29511052/262123
+        if [ "$SKIP_TERMINAL" == "false" ]; then
+            echo "Reopening in the Terminal app..."
+            echo "\"$0\" $@ --no-reopen-terminal" > /tmp/open-smapi-terminal.sh
+            chmod +x /tmp/open-smapi-terminal.sh
+            cat /tmp/open-smapi-terminal.sh
+            open -W -a Terminal /tmp/open-smapi-terminal.sh
+            rm /tmp/open-smapi-terminal.sh
+            exit 0
+        fi
+    fi
+
     # launch SMAPI
-    open -a Terminal ./StardewModdingAPI.bin.osx "$@"
+    LC_ALL="C" ./StardewModdingAPI.bin.osx "$@"
 else
     # choose binary file to launch
     LAUNCH_FILE=""

From 60af28760a6edc509b16e7c62aa8b00ba9798793 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 9 Jul 2021 22:29:43 -0400
Subject: [PATCH 195/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 24 +++++++++++---------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index d538cc53..ce805402 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.10.1</Version>
+    <Version>3.11.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3214c09e..d0aa2fbf 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,26 +7,28 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
-## Upcoming release
+## 3.11.0
+Released 09 July 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/53514295).
+
 * For players:
-  * Improved error if SMAPI fails to dispose on game exit.
-  * Updated Linux/macOS launch script for Stardew Valley 1.4.5 multiplayer hotfix.
-  * Fixed error when running the Windows installer as administrator (thanks to LostLogic!).
+  * Updated for Stardew Valley 1.4.5 multiplayer hotfix on Linux/macOS.
+  * Fixed installer error on Windows when running as administrator (thanks to LostLogic!).
+  * Fixed installer error on some Windows systems (thanks to eddyballs!).
+  * Fixed error if SMAPI fails to dispose on game exit.
   * Fixed `player_add` and `list_items` console commands not including some shirts _(in Console Commands)_.
-  * Fixed installer error on some older Windows systems (thanks to eddyballs!).
 
 * For mod authors:
   * Added `World.FurnitureListChanged` event (thanks to DiscipleOfEris!).
   * Added asset propagation for building/house paint masks.
-  * Added validation for the manifest `Dependencies` field.
-  * Added `TRACE` message if software known to cause issues is installed (currently MSI Afterburner and RivaTuner), to simplify troubleshooting.
-  * Fixed validation for mods with version `0.0.0`.
-  * Fixed _loaded with custom settings_ trace log when using default settings.
+  * Added log message for troubleshooting if Windows software which often causes issues is installed (currently MSI Afterburner and RivaTuner).
+  * Improved validation for the manifest `Dependencies` field.
+  * Fixed validation for mods with invalid version `0.0.0`.
+  * Fixed _loaded with custom settings_ trace log added when using default settings.
   * Fixed `Constants.SaveFolderName` and `Constants.CurrentSavePath` not set correctly in rare cases.
 
 * For the web UI and JSON validator:
-  * Updated the JSON validator/schema for Content Patcher 1.23.
-  * Fixed [JSON schema](technical/web.md#using-a-schema-file-directly) in Visual Studio Code warning about comments or trailing commas.
+  * Updated the JSON validator/schema for Content Patcher 1.23.0.
+  * Fixed [JSON schema](technical/web.md#using-a-schema-file-directly) in Visual Studio Code warning about comments and trailing commas.
   * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.
 
 ## 3.10.1
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index e9513309..1781c40d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.10.1",
+    "Version": "3.11.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.10.1"
+    "MinimumApiVersion": "3.11.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index b0b29379..82e6152d 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.10.1",
+    "Version": "3.11.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.10.1"
+    "MinimumApiVersion": "3.11.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index fea9b62e..6042dee4 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.10.1",
+    "Version": "3.11.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.10.1"
+    "MinimumApiVersion": "3.11.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 38e8c500..9e93551c 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -61,7 +61,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.10.1";
+        internal static string RawApiVersion = "3.11.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From bd20c2e1375ed5e32315ef5e292802bccc42f530 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 11 Jul 2021 01:44:02 -0400
Subject: [PATCH 196/856] alias Mono.Cecil references (#711)

This is needed to migrate to Harmony 2.0 because it uses MonoMod, which has a copy of Mono.Cecil merged into its assembly, which leads to "type X exists in both 0Harmony.dll and Mono.Cecil.dll" errors. We can't use the version bundled with MonoMod since only some of the types are publicly accessible.
---
 .../Framework/ModLoading/AssemblyDefinitionResolver.cs    | 4 +++-
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs          | 6 ++++--
 src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs     | 4 +++-
 src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs     | 6 ++++--
 src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs     | 6 ++++--
 src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs    | 6 ++++--
 src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs  | 6 ++++--
 .../Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs  | 6 ++++--
 .../ModLoading/Finders/ReferenceToMissingMemberFinder.cs  | 6 ++++--
 .../Framework/ModLoading/Finders/TypeAssemblyFinder.cs    | 4 +++-
 src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs      | 4 +++-
 .../ModLoading/Framework/BaseInstructionHandler.cs        | 6 ++++--
 .../Framework/ModLoading/Framework/RecursiveRewriter.cs   | 8 +++++---
 src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs | 6 ++++--
 src/SMAPI/Framework/ModLoading/IInstructionHandler.cs     | 6 ++++--
 src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs     | 4 +++-
 .../ModLoading/Rewriters/FieldReplaceRewriter.cs          | 6 ++++--
 .../ModLoading/Rewriters/Harmony1AssemblyRewriter.cs      | 6 ++++--
 .../ModLoading/Rewriters/HeuristicFieldRewriter.cs        | 6 ++++--
 .../ModLoading/Rewriters/HeuristicMethodRewriter.cs       | 6 ++++--
 .../ModLoading/Rewriters/MethodParentRewriter.cs          | 6 ++++--
 .../ModLoading/Rewriters/TypeReferenceRewriter.cs         | 4 +++-
 src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs   | 4 +++-
 src/SMAPI/SMAPI.csproj                                    | 4 +++-
 24 files changed, 89 insertions(+), 41 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
index aefb0126..9867ed8b 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
@@ -1,5 +1,7 @@
+extern alias MonoCecilPackage;
+
 using System.Collections.Generic;
-using Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 3606eb66..8311a4b9 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -1,10 +1,12 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Reflection;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 using StardewModdingAPI.Metadata;
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs b/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
index b56a776c..6493ccf8 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
@@ -1,5 +1,7 @@
+extern alias MonoCecilPackage;
+
 using System.IO;
-using Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
diff --git a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
index 01ed153b..2e349616 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
@@ -1,5 +1,7 @@
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+extern alias MonoCecilPackage;
+
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
index 2c062243..434ff5ab 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
@@ -1,5 +1,7 @@
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+extern alias MonoCecilPackage;
+
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
index d2340f01..80229155 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
@@ -1,5 +1,7 @@
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+extern alias MonoCecilPackage;
+
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
index 99344848..5ef66df4 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
@@ -1,5 +1,7 @@
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+extern alias MonoCecilPackage;
+
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
index b01a3240..80296e38 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
@@ -1,7 +1,9 @@
+extern alias MonoCecilPackage;
+
 using System.Collections.Generic;
 using System.Linq;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
index b64a255e..fae8ee95 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
@@ -1,6 +1,8 @@
+extern alias MonoCecilPackage;
+
 using System.Collections.Generic;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
index 24ab2eca..3e107b90 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
@@ -1,5 +1,7 @@
+extern alias MonoCecilPackage;
+
 using System;
-using Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
index bbd081e8..9453c39f 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
@@ -1,5 +1,7 @@
+extern alias MonoCecilPackage;
+
 using System;
-using Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
index 624113b3..3979d431 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
@@ -1,7 +1,9 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Collections.Generic;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 
 namespace StardewModdingAPI.Framework.ModLoading.Framework
 {
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
index 10f68f0d..e79bb488 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
@@ -1,9 +1,11 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
-using Mono.Collections.Generic;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.ModLoading.Framework
 {
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
index 60bbd2c7..e88b75ed 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
@@ -1,8 +1,10 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Linq;
 using System.Reflection;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage::Mono.Cecil;
+using MonoCecilPackage::Mono.Cecil.Cil;
 
 namespace StardewModdingAPI.Framework.ModLoading.Framework
 {
diff --git a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
index 17c9ba68..342721cd 100644
--- a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
@@ -1,7 +1,9 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Collections.Generic;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
diff --git a/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs b/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
index d4366294..ee123e75 100644
--- a/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
+++ b/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
@@ -1,8 +1,10 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
-using Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil;
 using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Framework.ModLoading
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
index 0b679e9d..d40d4111 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
@@ -1,7 +1,9 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Reflection;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
index 4b3675bc..147a12f9 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
@@ -1,8 +1,10 @@
 #if HARMONY_2
+extern alias MonoCecilPackage;
+
 using System;
 using HarmonyLib;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 using StardewModdingAPI.Framework.ModLoading.RewriteFacades;
 
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
index f59a6ab1..c381e4e5 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
@@ -1,7 +1,9 @@
+extern alias MonoCecilPackage;
+
 using System.Collections.Generic;
 using System.Linq;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
index e133b6fa..748c1e6f 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
@@ -1,7 +1,9 @@
+extern alias MonoCecilPackage;
+
 using System.Collections.Generic;
 using System.Linq;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
index 9933e2ca..5e0d9c70 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
@@ -1,7 +1,9 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Linq;
-using Mono.Cecil;
-using Mono.Cecil.Cil;
+using MonoCecilPackage.Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
index ad5cb96f..a4d09ae9 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
@@ -1,5 +1,7 @@
+extern alias MonoCecilPackage;
+
 using System;
-using Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs b/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
index a4ac54e2..fab424f3 100644
--- a/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
+++ b/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
@@ -1,7 +1,9 @@
+extern alias MonoCecilPackage;
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using Mono.Cecil;
+using MonoCecilPackage.Mono.Cecil;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 413d9f33..d36d0d7a 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -20,7 +20,9 @@
 
   <ItemGroup>
     <PackageReference Include="LargeAddressAware" Version="1.0.5" />
-    <PackageReference Include="Mono.Cecil" Version="0.11.3" />
+    <PackageReference Include="Mono.Cecil" Version="0.11.3">
+      <Aliases>MonoCecilPackage</Aliases>
+    </PackageReference>
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.8" />
   </ItemGroup>

From 8df578edb6d135796a48b219ecc7a7291c7ef460 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 13 Jul 2021 09:14:07 -0400
Subject: [PATCH 197/856] migrate to Harmony 2.1 (#711)

---
 build/0Harmony.dll                            |  Bin 115200 -> 802816 bytes
 build/0Harmony.xml                            | 3130 +++++++++++++++++
 build/common.targets                          |    1 +
 build/prepare-install-package.targets         |    1 +
 docs/release-notes.md                         |    6 +-
 docs/technical/smapi.md                       |    1 -
 .../Patches/DialogueErrorPatch.cs             |   92 +-
 .../Patches/EventPatches.cs                   |    8 -
 .../Patches/GameLocationPatches.cs            |   87 +-
 .../Patches/LoadErrorPatch.cs                 |    8 -
 .../Patches/ObjectErrorPatch.cs               |   50 +-
 .../Patches/ScheduleErrorPatch.cs             |   50 +-
 .../Patches/SpriteBatchValidationPatches.cs   |   10 +-
 .../Patches/UtilityErrorPatches.cs            |   48 +-
 .../Commands/HarmonySummaryCommand.cs         |   26 -
 .../RewriteFacades/AccessToolsFacade.cs       |    2 -
 .../RewriteFacades/HarmonyInstanceFacade.cs   |    2 -
 .../RewriteFacades/HarmonyMethodFacade.cs     |    2 -
 .../Rewriters/Harmony1AssemblyRewriter.cs     |    4 +-
 src/SMAPI/Framework/Patching/GamePatcher.cs   |    8 -
 src/SMAPI/Framework/Patching/IHarmonyPatch.cs |    8 -
 src/SMAPI/Framework/Patching/PatchHelper.cs   |   36 -
 src/SMAPI/Metadata/InstructionMetadata.cs     |    8 +-
 src/SMAPI/Patches/LoadContextPatch.cs         |    8 -
 24 files changed, 3149 insertions(+), 447 deletions(-)
 create mode 100644 build/0Harmony.xml
 delete mode 100644 src/SMAPI/Framework/Patching/PatchHelper.cs

diff --git a/build/0Harmony.dll b/build/0Harmony.dll
index 2e893d0e538bdb274d9f1877e3491cd2193ed374..1c5b9c0948858a6ea17ae8c842db65b9b0857cc4 100644
GIT binary patch
literal 802816
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%0A2!Ra_hG9nvY-lJ9J4#^l
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%0D<3Z9+Ou%S0w}-%=N{
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

literal 115200
zcmeFad7NBDx&ME1PWS1a?wLt?dZuTxkeL889HwVNfPj<85>^Ef*~Ea#zDD3+cY;dO
z?cjon0ma>@C{Yk`UoI{e7u<K_cHJZH%k^HpUawcLI{x0Dr%rdDo&@B6f8W>duU}r7
zK6R>|dg`gCo_gx3r<U{Bb6@NQp66xw`}^NL?*lybZ<GB#^v^uWgX13>^xoI^r8OT|
za>|$1oOQ*O^@(e1@#VD(ub#O0!fURHw@zGi=|pYYH4|4}GjaUm&YZY9zU0!i0|SNq
z6V#`j;CZJk3A_h>^@8o~(jM^kohU9@=XoDm;(4Kqz4tqWCkQ{l)AN>D*mra*A^`)2
zNdD_z;9c-sf$D$vnY=2Bf0uywaSDL<mtw>o|9r2XxJLuGYLB#sh?wxad@4E5`=e9u
zYqwtd^sT(#_rauIs%t`b8;mR$tgY2+7ZYK$sqSj1`*^1QZKAo>)-Js&22ivbBH{Yj
z9&pE6a_Z+*;w%3|o9|`4&+hiT`Ty~}-kb*VuzpVU>)U9J<}j4{(SDv+@TRBy2z0d2
z^x5r@-w;61Jdoe%oAws#ATrIFe+V%xh<hIjhaeojti$(?e+Zo&%tRFtJ-y>0VC#r+
zp;;9HpMO|jJyd-B;brNP@=#?oQ<Y4SwFk$ITYGT4n>pe5^^0jUh)njun36(}Dt*f$
zEUBc$Z0#oXwEV3Piox#?vqv3GW=`(p4BAcko=#LEekrPFg0bq7(JmDvmDl;+TabE$
zx8!AJa+zBz3rheh=4OUGM`d90G<OqF!L3(jZoP6L)1RMNRwK)`wFW=+NhIX@`V_x~
z%0TrvFX-D*&Sd&tRt`&HIa|t(o-=xQU)3vRm#-bDR!W)p06@!`YLQ^%f?i0No>K6<
zzR}GCeU!A2Dd$SL*>^iC!We1`PP8AQv&~9Q_h8oAy~ZA-*nQhQ`2Q@h+HZ_FG(pn>
zM9`;%H)vXbh|zY01=jk(a71OKEG$glQW$|XUE=wH0-@)RL~xd8CW2vf(=Nnt0ud~N
zIJS$UIi^zY_3NN7G*|NC*AbdR6BUozf>H1qBA4qm(_A5FCl8NJwBSF=+E7-PKWHew
zA@PHT3X9=+K{~N&WrG@73p_ZWA)w^>bpXQ2E_H>f7fu_@1TewgVM0f5Sgd-vY2kx0
z{|MHR<+6Ay*JZt9po$@;<kcB}3kAg72tJsXf$F-UAUcFlITP0IK)8o83zaqWkN8kU
zW{0xTdIHg5{KSXz;{pE&p0l6Xy>uv8sKC^fF|03m-v_aH9nbMr4y%tG3Zo4Q=EB<B
z!CcDSP$zkzLZlyWB&GIG>QeXf6F-vIbRl7M1TnMsQAoH@DRv79<0DC^tjk%x>UixF
z!tptN!uTj5Ihvo^S9p&$5i0uDQqd_(ys$rSd7@*8FXv17nf}_>fy-OD{k}DCxo@a%
zp+bu+F$(iJ!&0WPN(Hs)5^Css!`_jndrNsGe2w?$dtJD^F5{h~NdEbChUG$YH5Km4
zUh6fyPR@=_wRVUR;cXCAKMuIbd8I@MN;N_fsu9gqZSF(d^ignCSc3RO06o#5a^N8&
zyH~3307n5dk5X}O5}+S0gs%~1#{Yt=@lO!FVkT@T{q$Ua)yuc>JV2Rr#!~&Y!V~(<
zI{^s?GtIkr5^Cr@rdEYwZe(GJwA)O+QV!?tR>tAxn+4twumcTmP)vL>8BnZJXb$`t
z0&gg-_ARy54R;IdF$tI&!?2zqu&|-TZFw5K`4&Q1D)c&4=oG*sYF+Kmk1qJa-&g9J
z$&W(La>Fm^)@%7mG5ICRc`7+4=amvs+v-5rFwocag1)p1suTk)XZmJxrOdEKiAuRp
zDs1?^+BcIM-5ljW1#P!?XoKWxxmYR=F9hZOQvZf`2^7fkKxrUT8n6seA3&v|@pSX(
zIpskTN`s|=bK=t>G8+|yV`(<%;(z^K@h>Yan>oV+OvpRndtlF|v6oAwrKM6tcd8m-
zd8jlL_46iPhI8K#xnAF_)i+Rm%cb&$4=OTK$r*iA_YEC#21M#`X;{@ADUEEnH4RxB
zj?bn-<w~wRnkiLEqoqnu700rbppEj5y`o%RT0V26*9Pn03(BL}G`{kR(pYJQRjRzQ
zw6a^DD(!=8&~?M<mFq$j6pdkeHhuz>#hdvlgu76NOQLfWajt%z$WPIapTwiGqd&}z
z-m)Bk$x41_{Nx^>fxhTGBFY&?^79GQeuiMj7bq&5sb9$RbT5eMyHbX8r7&KlV9v{z
zazlO6Ibk`UIjxj0^~D#Fg1J!2jNUSCg_S7nVj`!YJ*ND^>_>N3O5wHxNtF=J<V%G_
z>y|RxrWDH%Q7TR^VP52Wb?<}^c#OuLcis3xeJ9+V^qcRHum??KGBcTJzJ~`&Kw}Ek
z(!7Q-D!zoGT6YMdtEFD4#<`S)$$6zjgS2{UXD`gF1aq0eC?!HSRtq6U8bd`g61lRj
zp)5K;ss2`SNZ))E@G#T-m>${Y{XD>QIhdLsAsjf0-bgS-(W|=@Da9y4FyE%=E65tb
z1V-0}FxbfH%088{>0PDz+pX-N`3ce~`;$Dp&~NO+v-xp;oW=#?JB0B{a>ZMeHEbv~
zDuLb9bb@;&Hsu-MrdyHJq6IVYRlpaj`we-~)r5-v(2|I%7owOStjPlJ*Ag7qy&90G
z5}N%6L!Gx!p|RWJsXtKl`e-B9rUTx(BfI0wpD9oO>NWCCwis9ot*!jT+xYP&Th}S#
zX{m^(E8-cci0c*6NJZSBh-NCHrHE&yBIXrwV=CfVig<P^;yH?VZYts?MLaJR@q9(R
zAQf@5B3_t^*sh3MQW3W*;zgZ^c`+Ea*f>Zx)%>{B9%Nf<NF3cfuSf0Q=#bA;sB6R2
zUksi?bQ{0nX#5f$ML$<7FWCbyekp0q2^Cddm-BW}4(hJtO)ObLg5OX|?XW%bg}WX}
zi#dJrGNI2++=MuejwNbj7u37tos*-xXr|;PemTJX`Q`B|c%nDd69;m&Gbv%>(-a=W
zuOy}~`cFDk{3?RdJImu&3%XLyR#%lWOguJM`byayG3G@fehoiUiqoLoXY&i@C$rzm
z#jjQN9Qr~wWzK^c-k|E{kFOuD7@foM>wqbQ!_n<L2l|*C)h>h-KYBgy^*8WyeeEir
zi1-e|W<iZtM!S_8_DAbz0;(U=MX6ZpO+3Q*PJX?7>n<Mgn-$LOT7kxL{JNWnt$Jmy
z<du>(4m`TF1RwfF<F^1(@Z)=UMD)3^i~p@eIh6U<+X#p8+xdlA;#)pC3*bcskM$O;
zSL<=oi5E~N%_g1LDGQXUOEK5#mX&M0gD5|Kr^@o<ck#%%vT~_PhP(DsmYHFik0JyV
zr2j#oQmkGO=63XZyQ*!`$VVtBTH@W{rX`m7E+RUWSQvFg8uBv+`5qw6QWLDAqQ^Se
zWim#Jx$xF257{x?VY2FrBJhS19>16DZ62RV#=Z0SeLy*WhbF9*9WmxSoPIo6;B=}D
zdfOWfmu_#pIz=Zsu7Zwoitj3a?|ko;-)6fNoNL_+6-k5iw!vNsPTC;!Hd5}e%B{Vm
zSE{=r-8KZeF*_0R_lsFJl|vte-lIBr?pcHfZR)!E-Zep2E%YE2PoUcyaXk5eN(*NO
zg4PGEmLK9bnG-w++&`z_nDWmi8HATUFCzgN4=NExK-j5A;32O`n(F}ZePm2Qsjj#C
z=r!Zn$2)bceV1TnHdoutvzo2_jz{!i@^-nl_xi77+%qk(GZ?Kia8pg!+x+;WDms~a
ztn_+%U(!3zm&kde{my_H(EQ{|)U?-E3Y}DHA`*WLJev2J0o6yu{fbbE*vec2Q|$bi
zFhg0geX-+bMk%f<Xt`1tU1&w^HI_+CuGE+0#{8ezhul~Usk+D3VBQ=(8e6pW2@+i&
zD)q^X-+*F)q4_ouqvgTU;0DH10jnjU)i6+rrKP1aPa#@@(2mZvK-^ZWtxu&=@@35z
zDqf{Ow`*0K)uS;Z3pQr1g_7uG`)n%wxlS0H2kp^=(`XGDUl>;0_);pBHa>6R?|*k~
zrrE{JvYcrGe>na;xV-9MuJr{1?RVeQ^R7<kh`vaorX4c?eyLM>bs*;;qYK3U-hNGe
z(h5bd8XU{R3?joA3X=5*VyzDa*4Xr+rM_`Aa15;u_^mHfT=HtZmQKIx<N-*n&;|l$
zPybBAsaY1m<q%2wRmlsAxk5N{&Itt&Wci~Lnqy~<=SloMfxk=ntMhjwf7m|W+^hKU
zTVLt0WDZJ*z%WT#ZjOP9h_7}dUTqOy>qb1^BEH^<s9x{4zR`WV%5QzM`*xn+`j_t8
zX@2Wl-M3@?*0;NF>w}4B{{8QNKe!M~%u~WbhVCPmso(kzK*8nlcX=@D_FLc6d;ER9
z$`k3dk^C8=9e(4Z`T>bd3>y1lV6~7>XZRz_I85Fxdwe$llk-Z67_qAH4~2~k`zZs0
zoX+r`ZU&|FX4qdDkoI(j_jWTVC7mH+T&l(oP+DhB;oEq%0=nDwXMm#s;mTKTnW8b4
zEs^5@-*Wri&+-my+V26rPllap{3FmdRb`x?-3V35&!!?o@-!aSNj=N>_8yB&txT2Q
zqS#C!+%Q7CC!L%0jLjlD7yp<?{1blqbMa4kU{4J6IUmu_c*PN}&OC!Y`8lukU+@$C
zQgEwoxt8&3vQk?>p<}rQJ156#s{@6X=O<?~Q^VD)dCYcBuBffI_?3M-qhARD&UT!-
z(G~Pun=I4TZt^V~<-y31=V*xJMRe3o0e2}A{T^hsYYF$+=;F$#J)el^*Pt)whw`;o
z>Fr-d!C@UT<N+4*S_kl>K}8;<L2q<k@6jVgX)>Pr9^BLVAmgKJ)MD*pV66WJWY_ze
z?Itr@*>Jph`v`Wl{%@qq?)-P2#Y%tms9b)>fY%rQmiKP`f5%&@ee~)alk%{!IDpTf
z;^jv-_vdq1YxmWD+9?`uhV+haDr2?Etp5kOM`L(Wuu>R0|5IUWbUznuk<Ogn!W`lc
zMEeWjRw7a}Wy6>C4x|p$nfliM3%JQ3{v!|kZ-bdS#;5GC_wk6(qt&Df;9t&o0DBYU
ztG^HSG3#$KYGjz&f1ZZ~@Ttm#j;j{ET>K|c_Rrl-mioPb5A=miRDPy!$dCR^Qj@_U
z<N19JJvBu(kuhb^*AU=B_)lc3{|~Tz3*q|}{tMv<Lqu~1(*k>g{J<WN>PvfrWc4<U
z(}S|VQo_blP;t!Bee;jE=jgC5nV(O4|NOJ|{5<Q?mAy54@^W~1IALWbD|4A<QCnsO
z`w!sbdlPUQbB+a`GD>yUn9YyESeb$KjA5|PSdRbVpH-E=i9KVmhX_`g!}@|EP`2$x
zEU#N)Ys_dH#-`{!lw+2l;)|36qe@=%oOZO8uc3*4RH}bi<$FO&lqGdtMRR&sr~en4
z3|x4^B?^%75s|Tk=m_13@m%)>vP)HH2oR8u3nUN->P^lZrJB?oUYVaFT(K@I{%Z_A
zj3=?8|Cu5*oGFG8ofprh&uD}SUXBo6Pg1`h<m>MuFwke>JmpOv>yI=UiaMTpYZKo)
z0-UG?*~iUD$qoGuM;WN1fc@~yD<YZ)Suuwb6vaM}vqJpn1|m@<7cD}KzQ0Z>j_!=f
z2}nwdz=BM6IHDVc1wZU$P(6==Ci-c~+cnYF?a_CE)8OpJv40`35Pnwd%R=bnyiy``
zQ`H8rl#MT3&{3*?&f3rx`HRwZ)FYD{sO}f$q9Kx+-v)zL6+SPdSTTh-&yNR)`KLtJ
z$>6FA*Ov@eSewXr*ESjMQ3MXj_eI7tAQePk7NR~ODhN^75TIMMp&`5DYv3IN-WlQj
zis9ApN?ZEXgW6~@7m#~b#O_oPyLyXo{Ptx7dNegUb6dh)Yp5O{<+;GDRheJylqrrd
zOFhBysLhujsqCbBKTOf_K#Gp9_0o~%+4+=nkZ8fLQG^dI24>fW4AZpXH<k4i_%S)J
zlxVfu5CvUr{j?YGUj*0>hRJ!QL=yr;qf}jEt9{V;-a0F5+tFw&gjH5beSl2G>XX_8
zU<0HH_*RzyrKAY>c`x9%y96kuOMrD)jS-C{o_DayZ$U){H%EvEbWn}&MbDxo`t!rl
zQeI^eY`7C*J@e5SwE66uvrg8D#hH7qoSV22yv*rx7Fo*2%Y=h5y>=Axw+rsNN#%GY
zE|D@t!pTaA+mrDmp#^Q3?TU?&czp4F<|LcyrA?0aV(nZII3oZrhiYR>28K7rk%&z-
z91V*MO(2W4cXhz~hGWdK!ksE+{tz;zvx{EKE)yX^pgCl*#uOnbj|9U&C(vwhW{`+_
z1(fk9Ka74Zd8?{j9^6ew$%WCFlD=OWoc4}ch01`lef(Vl->&9Q`d$AdBkOrW7P|g6
zsqp1wZ2b~4&GU{ah)8}<4ZVVd$$6zj3_(uFWREaTc!yg48);EnnP(Be_1MgCf3+`+
zUa6+m@}tHU^+obfp5Wt^ppAHU2+we_=*w3qag}N@eNk-_%$OI`$1j;zn~fMFwT>Pd
zzG30>YnK6LI`sKuPE?+)h0AYGJ?a17rz!={>}9Rh&8)B8N+#z}NE@`aw(O^4oW;2S
zW;nngSk2n+=A!QpW^>UCNRSa~GQAIUTU+Ia%Y#37E9?*R=GSQc3hIXk@WQn=5VGm~
zn$WMk2_onk(CEz8p<pN@BQ~@Qe%MgH(Fh}xttMf8HTatpmKiRGImSAh=0|8$f%(zb
z0gEt1!!oO?0&AgPGps3%i=Q^o{y<H7r5bz-KS|DbLUiX6G>pp1TgpW*6{>tfMJZdS
zTZiR7Z!i<DQHD~LIe)aTf<vXg(olQ@=^j!05jFc$tf$gK1rcjoPqrJPT(Er_beFzT
zfrZhg^03?<)4sR@s-r_?w?kprky9FunDv0R>^34i0NQfzMg*|TDf0-KN8BcaN|Lz}
zJ<c+ZxD5u%JkqnlpoGM-#8?`gDZ4DK{UILD&*{pC<7KQgHZz!D%Q;fqo1b-jszfh?
zO|0ArkrpxAh$d5rdb5nWEJ=ZPL3?zXigV(*qO@XWwO4x&q7j+cxfz=Uqra;x&j}IB
zpEFDGdS#;DC>D|1{m6XuTZQw44=S(nYWJyY)E0zm6Xldv)u$lq`lP6RO8d-&2~H`E
zV;CN#GoFC1nBe&|o=bV^pW^S~UHzUBy(j(`NqiBYHoWo>?fn;Vf8-Ct&U*||!lU?Q
z^vx1~^kMrao%9$I5Lx=P`Qh8$kRiHI^TW>i!zSJf7zcP(Hoy=(>5WGsu|eYqexoV+
zXwW#a9c;l6r_|_0D7Bx!>BOs`6r1z6e%A~0Q^7cUN-55s!Z@t9{-YQ0X97GBj!w=i
zCBnF?MhEiKUkjnPwwj;3+oZBTL2HA7{H-%Xeen#rCjLN$ZEu5IkPHRbv9?&u$XGo#
z&u+EAX6UQJ8ru`D&EI;Zjas%WW7Ax~Rx&j{gG4u=^(3*#EM4h)=Tgk!j<2&6D|@-M
zmOydtSW^65&!tJs9cvCb%%5WGAWNnvlYCQ8GG2sY3x!T@Y-5t2*OTn3(K^@wuw(#0
zEvL}iT1ByShyi@u0AA1wAg4sJb*KT{VE{Mx0?1uZY^^tdc>{Q1FMw?^X&okj>P7yp
z?Y*hCkEC_Dr5^8h%>(C-v;}v^p6Zmp>z3ZU8s_t^=xV<82*cs!rrnqdkG)42pDXbk
zNv+@aip$R>F3!eNN|Z-Zwv}N~%1%d;J=7U}pyKSr|Lny<Uu)w~iZjzFzZzBf>DqvM
z;Q2!@o?mwHDCI%$__kkwF$;Pkn9N+OJH$UKjQ1rf+CWwDt{@nFE~dXa6UHctuyV+N
z3)qgwj*tf~az}qvmO^`fQs5y;TAL}=e+_Z+E&LJ6JYTyuWs?sNRJUkm@~<L&BZWpY
zR9Ta;B_?$OI4RddlL=d&iyNrU<l0oZfNl2_RVHy67rA2qs=8}bo1h6^s{V*km<gg6
zC2T<b%w#Zd_Dj|!kd&Te_@U%XCb5A6?*wq6qu7fYM7OrFP_sf1$~#&eU@w?0=NA1S
z7rnR*VU_E`WJZ#ynE7L_&w3upj=6Aq=>(taC1^-iF8`~y$$urj9SPqi=amvM?Mbv%
z#&SdliH5<<%!bTjNBvRcn%TE6K3YwE@bbP&yor#l0XkUgJM9MU>#K~$#{hu&8KYuQ
zXLBFOu;!SJj?<flORHyVz3BKE)XIL|fTBQ|Z##-ECo63@I$qGMip)&n>pp>(Qh#(F
zwczb-WNINSndpg%nA;5gU>ibb*0P(oo1N9kI^ZDp%(@R*eOrHU<M3QR5p4<&?NF#S
zmB%J*W^Yw#W-y(pI!lg!f~fdos*YAeSadiMnky0dH)KrkZ7De^<8F<A2^Z+^nfOtv
ztF~ZK&qYZZE8<5h-S%IFClRcl%uj@ITrF2hl^OOW+n9;Hbczx_h45&bRx-Jeg|koX
zGR6r9X1kwk2q_J_9nN0$h%Smx_U4umv`_8chss?ViLuiPW&y2N#k#DJLBs06sU(+1
zqBD#aunx<t^X^qo?ad?GW;KoSR(R<c=C`nsQW;h)N__{AZS-i+ldv<|>_sgnLbj^3
zYUYTZl4f(QN$^&)EiAr5c^|*DPc~zmbQ{DVx8RJyxj)h_ZIp*~P_8bmp1B-H)YoCz
z;+3t5(!@-q_DAu}eAvctH=9gzXb}zLerY^wrhA+!{pqRF8DkQ8SyNgw^NbEv7T*<?
zeM|ce<svqf*n;YQrTu1B)sD*HQFmfjJBx6%3BDyH<tm5tmvVTZ7u>4oXnFtA{xhSs
zmjMSN`l_3yB=h0wMkckG%C|{a7?QPPbh0!#vv2LosX~5EIH~=IJ4Jbb?}*QWvRUPH
z%eK~Wk_A=py5v%tQAr}Jx#4V3Vf|t=tGle@Qt(u1Y6czMdOSEwg`~$ls%Me*fYJd5
zqCVLH*}pf7-=QYDnQA%FlioU;OdF5*i#dg}3l%usp4Kq-w&&Wfr{jJB-LVCoyp*v1
z$*w(#CrYhU{|&;geQ^Ix12Vk*Nsnyv&w8*6_kVaYW;XxAQ(n=31G;Cjri8XHzKs_L
zPpSUzh8Gln6)L~^H$8$Ta|YqZM%M1$h48mRh;d(tm~F{J{JVAunsZeXKV|5}M!DzJ
zhVx9or2%Wx3Q1enPEknmUpr4BbuP1W=Oul$YZNDaR+-mKcNZhHv;At<k<!^!adta;
zXS5l5=B3D|8P5Xw>%2|W$*Z43Lcyz}JQ>SEKSs}MrR7OH`ga#Y+#SiLNZa4+_RZzI
z<rB`$A^u<y$)^Y|A(^cIp6bR=7Mg-zXB;UM!(4nm&#jY;0L~JTz5H789jkoK-B$=}
zw?n*Uy`gr>SBqioo=yZzsrHAp`+6b<vNQd72Q;XUm`~cq@azZ%`*94g46;3mvOlt;
zBu-`W3ri4l^@^E+rR?ar0P-#+rGM#?K6@c7!=Cd}U}uE&-Rff#BPG)gYa-MRYbJz@
zYVQ|Z_Kvf9*@VfK8Zonc_ePsmM>lH$XfRv91L==16s!C&zKEycH#`~dEbtr;p89{n
z5!q?X=#boo9<|TH2piHdkCygOSKZflMIm|2eB8QDgaB1Fx39Vq7SXAibm_FWe?X^T
zQgogmI{z!7bBUu<j|ZVsxs6T*pcAFP2c1^JB09z8E}i!F59sW)i{s~sqVvBKI(<i{
z9uGpNavPlrK<A(KLZ_9W_4aMF*Q130&k6oO_`8kqKYPh+;^f<u8uWkJ3xwDJj)Z`}
z?ghdKpltQU^LUOxLtAWvlxuor?TZMF8zpM{_VtWPoZdlovM}C6(`9^g+$MWwoAhkn
z!zMj7!=ep>?b<!`-b-1JrYzQM6zhyxvL~}p8M6o{hd`9tZ->7U$dA&c=zf~YB&pS>
zBuST$R0tz<TXod+QBBx8V8@5ap17{ci&T)CfwYmany)g4+grZ_xAWV0(bYeQukp$Y
zW+nn{`1WVUT*hFl-V8^y57@D|J9EdZ`DPevm<#v~V_L&_)i6#q#HZ+0^lQr@pKOV8
z4Blb1Q$Pti+AQ>_vetTZc5X0}tcST$N8ylPJvq}r2W3Xq=3Stgop|vQ*pz87wZQ3;
zo2uAOf?}q@)FKtp?>lrsn9FM-z!KRs3vb%Rs@1ap@5+8{x9r#be_i(N-LhZb4ZgvV
z0S|obL6*-9IS!(hx~|)LX#J^1+9{;f|E2`Se4H^EFKC54%!i*Pun^*JbNXv?UMZ$+
zTdeA(VSK?{j5JNoD@86;83zmM(U%Y%F>X{N6he0mIrI=D@3D?HH+*1#vw)d6;q<~J
z*16&ILW|SZLBte~wb)@3Uh5i_+9&Ane#$<+lp?S9`=V<oU&E#xs~RBpsg(+C$l4l$
zcs@UjwAC+5GN9E$udlP$Iq<HAM*VYJ9Ga+v&Z;j8gONdJ15vza7YXZd{b^9wL{mzy
z=@B&*K^N(bpilHh&`4l@Kfs9%71*|}e^|CrlrGzf8nm90P-A5creRc=vz1PxfK$~5
zEk@(sbv8eGHq@}tX38wf%ERudyfswbbb8*JrcMus$GwY3ndDqapSR&yXG`hKLqu7R
z+k08ITL6<RwE~sz;22uj#u0i)q8y-kZ}iqLrxE*6ZDNV-8yT4UF-39!5%ZX>G+OYA
zt^mk6YidtK0P0s-%a69TX(_W)j{d3yOBU1y`W3}xj2GGrDo>HTf4TarRdHhchQuJg
zlvlqY?nieK#Pi>iphk%9-b;eoBDzNjdA8)IGez$tHr@h(5KziT&lQlLrj*gK>T38`
zYPfO8?Kt6-<(lr~g6*q4e0Ap%kHO~j$;wz@`*Bvn*QJE@Pw{>HO%aC^*D;@W+15Yc
zdHUY@pXPl39G))igc0Z2%;eZ-J<**BOxTwRX2O86u)UFtrHD-QX4O*(V=h64tR=jq
zov_>`$VY1lZ&d=J6vvHuQ^Yy8b#~=kvA110UJr++A$`dz@nOPy{YM>Jd^qyiueRkd
z@Lmqg84rUG)sr6v6G}Mqa7I1MD$Krpk6lF%PX800)}?>`1&)5%bMFj1?@ZC}k5=pq
znMr*i#B#x#n4NnG={|=$#%1zg2$+vFV8||eY!IsuVY<+pdouz;%S+WYki|@yM$pR*
zdWoKb@M<n1<y&$ImG1d^zah=JD-Qy<c5oHo($z`ln>oIX`9NW&Z>Ve26TSkov?fxG
zuU7Bq#P8~j_vYAllB&lha;WnrTEN`&e)It{rDEkp{5ZM1+STX>IT345)u7?3C_>tc
zN{nd*TkW+m#2{bPg+z)ni&Ec0Dm(QCh6WZYS@qDpV7R}Ffr)P>`VUnJ!V8A~horh?
zoBrBQ3{o64Ka-tJ#<^+Z83P{!pkr5`+m@$R60p-zH$)aZncpP%n07E?*hkNpDogEP
zGAHV_>G-y{*w&CIYX=p@rISG8wmGpr5!N0<q>*1wNb07~i|<PvUrS4E8&uRHE>WU4
z5ERWKF-?ZtrXr&g-yuW0z}sYWQr*taJ;>;$8yQ0h8AE9@1e5H`@*84Lnhe~iMn)&T
zLxy~*Z8AEk4?;#a-N+b8$QVhJA(-~|FzmLBozG|fthtGLS|MymDu>N~t`T&&e{KS~
z4_$wxFAXpRswZxsWi=eegk=_;fDqb-a?CaFO8#EK-#z@zeV?DOF)g%7?-kb1TdWFm
zX<<VmIvjl#;Ql!@SSpW{w(<z2BhclEKFzy3m(^drp<9M@xt4OS+zT+1u|j|KaqSfA
z7hh7D)knHGQwXiTwoOW}$8OEaCcT!bPR=VOI)>gK9m`Meno;OI53W4k@lzedG19y(
zc~p^|4B3SWbUTCMJJjo+f>_t?*ZEy++Csq&piU;E&r>PVE9NqBO@Ulo=MjBJ<hl+R
z<|8I>Rhh6D+=ZFZU1&0gywB#D@m8YSYf8)eh8>FdVoJJGpwRS9xSC+=IK)uZPL1w-
zxcJpZ<9(f(q@&+WCzFDzaZ*Zan`)7!Tc*#<W4yf*Zx#}iTP_`+NfTdPxj118HdnLy
zN!FV~Pm+4}UfU!)_Zuqzf6ySo!)y?nQ<S_OzE5%T!L(=ikJxQP-3oHI?X)ykr>ciO
zI6u`I!(?<!gS*DGDSWDH>$9}|yexFOq|M!)$ny!}&oF085#CHN<i*#~Ms5JFc=f08
z(oPFweE$V@N)*G)(31EW4$ek%&Rl;I*(4zsUvEIU_CY`STvX2Hb~!YNmD6zfF%&3=
zEjud5(n4*<>6XKUGjWBKJ<9n^yPRhlP^TQ(m1ukK9F;SX9m$RqLN>y)g<~J8Jy1Qi
zFJ3_a13o|YWLXoaw3(4`<wfD<aD3&(n>kO9OSN!ep<2$ZyePLhmyRrIPdsag%Ym4^
zcXtuXy)SY4hPjDLU%2_n=W-wk!3&f5M%g>{!mgbp^>uE${xIC?KM(y=TE#Xc0S|5@
z0v=d;7(dIZm+<=8g0=N!QH>w@IYbz@pX<Q-v(ZOj%s`GU?eR^5W@}?-mNEk4lC8b{
zxxRdiu7bb$WQKZ|Uw=LkO$mTse}RH(2fu!^f+DATW+w1HNL^^pQoVp?)O^2yT0}YP
zQHfqi78b(W`!_aeQ6|~c*AIX>1d0R}!lhEI+X0`PS4xCjYO>GP9e1YRPV=`>A!KP(
z1HGu0bx|p$jjDeUs<uQ*_I=G)y(g(ns>kD|if@IILbzQT+BWpqlKDY?_W+?)2|5P2
zt7b%CCDzji{rE*>T&61@veox%0YJDf1oxAL`@s;OzzPu^A`|1LDsXZz!_63_%#Lyv
z)fGf1z=|#{rVIS)Ak#P2nHX?6^>)Zt-G)ZWQU78*l3%k_uTW+A!OO4#%iCz4Ert!f
zBWdo+DGiV#+P^R=2Hge)5hE4@nr(m({X^h8U-bLY*O00p!a_*4bXa**)4RaZlOjTG
zkp??EdNRYs>QX;&)q5$(lZB!-o$#hqA4}*QUPPzf_oS0+R>JzrL?@Pem(I|uLB~aV
zqa)d+@r24POf#1h&HjLMtb`|oy&P<X>ayf@7`62Z#c<$Renry_+I&&r<dk#z<il+I
zN&`tYJxJd$c6$t{rTU7bJ|oc2-43IRs-<XGEeOjE56s<6#?TShtSC=ISpYFzfF4rw
ztW>pMMVS%iZnfy`9-FfGRg2?E9kG;s7NyV;AFMh#SDj*eYq*^!(X4#*3UBNTn5Od~
z^nLkWkpoCec=~932QMOhvNFE$b@8i>CAVJ5BwIRFJYH67$gcTse%y*a4(SL^aati9
z-GK)GoD`L9;+IU|yVJ2lm0{v)JH*$aHHy_oB%Ndjg|r4?P)dE2RMppzFgdT3=wz5+
zM-95`lD@a5i`yNLv%9E@>b8h?A^L)-(j`~GslIbOFYBd6;yfkkruv+pV*psPY>A_5
zIB+d!w-y+hc6~0FOss}N^~EvBYgZ1#TD@;=*ibB3Q7HWgg3ubE+I?JAd#&0XqrENe
z*6%hz-xb0=VYvO~a^VgedbkevI<kRcjZnyHjgAptPT{9p&%o|+!cs5Q_f7DuaCr1^
zc*Jt>>?b@=5T1jD2QzgKJX?fk{{#;XAkm|T!*jdCGbuc;7ap3ss!Ig+!1EO0nM&}i
za(MJ`c;4Xf93VV*2+!k$2OnMvkFT=^Iva^B+1?#>=i>o}>jT{_5z^XQ_lMzTCU^Ek
zNrzr78n_V4+KrymX*cOmz0+cgbm)PiXs0Mb)3h5)asbb{r3-x13BJ{f@aeq=-*{?F
zfcI5lMj8t?5_aem-dK2N61?M!@alc9c#}4r6<%voy1ApcP4BhByEehg?60T(dfzMF
zMCJ|>UXwXoLcMsOD!hy<#@98A@alc9coW$<Sa?l#n67s5BG}UZPB)=6`dlw6R%iXz
zQc$LJ#gH((kv5u~S4xDTQ;jfjQnK@~^pJ$GwX7F+S-9V1xRny2GXM8_=(|07=wZ<!
z=Cn$^v<!=uJB=2lL|7RAds>*Zr*vZIA*MPK&e<;+J?3Ha$EV`EC`SE@5!(%ym2P@`
z2U6?Taq4kj%XmL0UpiSWsdgxFp#{y+RLphff1R08C(F)mZg=rTf8GvWafJ9t@YrsM
zZhpJ<GN!MFQ+>5FA2Qt?iO`s3+q;r05i+*FD|C0OkaQPyaY^}I2w*aQznj>tdQGf;
zXZH;ulUv2BKzyqD@!jH5`<{-htz&LedhKc`^X&{>_x`{_5~~*I#uit$4?!zWV4Ju(
z3SE0DZybjXISO5SjfGd_+|lRyTf}(Taq1)2xjxb!TQ#0x*0#`pJv*%xKkC~x1&m33
zzTGlbWCv<@+z9P%->0SUp;(KxFHv~105U#2yu5vt&poPoqJSAY6O02@0&gYB3;^Aa
z_CnwDo(|6XAxLk5T|)aJy4X<r@i4o?j0z62Walmf)Q#L6Dt{YD%rwsXB%Mf7E}m7K
zX29jZw*ybn+ZB_YW85J59lXrs1AEFd!t8j%0xV*+a;Uc_ji@I{M^4TwCHfbd#Cdn+
zY>_Ww1M^)ny35!&L=rKV2+RFJa)nzNqkfQKXiDSEYJ{b{wEC3NQg<8MGOsi^i7h`^
z9v&LD?QG>z*igM~H-2SZrc|m9xfnZd!0maPgkz|*ti&yXVhva5{X`{}OZ}x{+e=U?
z@6_?@aLS`7Y>L9{b}n#R>Mn3&6DAk9jkGUtE5a5umiY3{gfDuEFZdoe?6m5|_p8`Z
zf9tKP$GcSbv7l4hn4JRH8NHkMZ7bComiz9xqEcR2J<S_h>1wxXQSDas)^3%n-9Dw|
zrIn=>rIkBMqe&(Au}bdrN-JR(dofF6+*iv^$JsZPmNVfxGZ+630=Z&ybRgO6Gh5DU
zOI|Twn^e@JtV*Nh@zVHA7D1^_1ksP-(172^5PPVa`8|L{2e~EN#CPQOaQ(=8`Z-G~
z;zNsxTvrQmU9ebxr!>@!`r%xe@9hiRi1iKYL^EYS`UOz4MPGLrXh|f!N5Z!Sl@vVb
zPElw-#Ap|n#C$gIn`mo-Wy(b5i7=OcQD-)gwG&4i;d%22gPc7p*>m+R;GdE7U2_b`
zlTfT32AAsZrI730H8$)l`A^7=a932hknp3hSBAZoUWRg&?sPbQA9;`+uowE>kuUio
zzsT!szAye5Psp{-$f9q)O7{r3tE-Qy+(VkXrweDy?%Wh7hVr|QsFeGv`?EsH#l&H$
zkDZv{x4;g-<9m7I93@h~$_qD1AqI59*{`q=lE>}B#9M8q8jjuO<*=KXzl7eOh`C;M
zu3f5Xz8FmGf_^`^iW&1vgv+^xhu70Hr-ktcRigdYZj|gCrh-32WPdhadm%B7bT@7(
zanufep3cO@7%Eq0FGDpB28M^h>Xl%q(Vv{Rcfhe*%B{=ra<<EHEf1GV**#d!?G)m9
zIn18c2SXj}*_`^%5Gr=Z_bGr7utY04K}K}XmiFbpmV5=j_BsfOKMYi7kHF)BxdE8^
zdegx{bAL1pI(U)?8uuf>wwJ3uO4v?1NT*kBIT=n5R9EEaOoyp6eT?J?_fS>(kaGlf
zRNLk*XQ6AFj*gFs4h{kbre2mU38J4PattO1Ywykdpy+4A;bUw8DYYHmw=;2hw+lKy
zV5fcp?eMeR88e5sGsDGFww?WSu<^!2oAp1=TM(VE7Zx<;K2E&@>!uR$4e#W&gCys3
z^3Z4q7M)8npLN-9eF9|a^`186vakMvV9^OBb6}79txp2Dp8)kQI>&$y4Hlp1(Ly5I
z(?11pWs7!Lf-<?hCfT{~7ywyTn-Wv^<ba6A(M#ZOOZ*+*zc3yZWf3JCUcW+nhmkxU
zI`3=)nDY|n*_t^n#f}f7Ff~VOd%NguNw(jTEoa#VQpg4d+sGukX#{tkP1bUDmmX$X
z)DG*y!rr84^^(JJl$NsF1(~9NBb{A`cd0MAi}VK!J=$QfTW2_MMsPo>?dfMP^rxxP
z_UlxfX7je-A+0bok;0P(OE6ZC?m?6glER_0RV!0C5{Pzo&wRXmJi%N3O)u+oO-6no
z@0sdDpMk0Zo#(SWnf`x{2UB7_nB^eklVR)gyx9EY3j`LzFY>D^46rtoVp)7s6?CgF
zEAcD*=(4nAf~oa8`Az0k-Xqm#%~Aq+zIHlH@2{>8YfmK5oTdlc60{r(N2rH>6;y6T
z`8@E|Y%O>b>`UB#^wo^{eQuO2IVIJa0gKUFC9n`4Ej;*apjRn&6RORplKcDIN^<w0
zWa!qPKTHm1O=`Zm4*H*EWwbEc(&#sJ(JLi|UW1?VPLTK6mRAcFU!z7;U1yy7xg2~1
z$zR#mnJ?o^^PbazrL_cG3FRP=r&nss4dnyXlxw%`pYnANg!f#_@0!oAPWbWHDY8%<
z;QZJ(2*uyz2b*0MSATx?SJTI8qZ~3>%|sXQo9NlBCna!`;hLNcr=kl<8@)w@Ojd$7
z=^0%_RCkQu2l(e1d?D=Q2n;Af-cs{d=d*pjt7k+vsTzPoW%?K2jrRi5$NT0P+u0V6
zmd=<zY#vpe@!YuB`j%?O?XchGS$hBxiZ)TJd8RWM67BKiW|h+tnwDYtjxwon&hRQ0
z<8O|>OPrO#XeD3i9Ob{z@(EYZT?{P|pzCfpzHfu>;S@=ar=dDm33T>x?KjijKjYi}
zne7jO)7{#>;M2$#c`cP2eGjq*(3C1N{ys1G-iJ8s{sRTG++!N=Cgc(GL!PrgW0wq<
z$6r7l62lp?Qma1>&jZS`m|!B7M2sh#xEOzOd;iQj@95akuf0I+y)@zvJ~8i>2dPVk
z@_sL$=97^MK{%E3UGmaggN9Y2VYOFT-z~ShpDwVwBT=!m=N|2n5(zE-_lg9w@E=*V
zdz;DZFxBmlN4DE3<DJRKg3owwW%v*Do2DBWE$3~!mzTO3%m&b~2J@~R=*!pgJfj~|
zsO?gTHX$VgrTpl+&gL&E|4mqftDnrBi21;rb#@^J3$e*%UH4;v4S3b%rThw81=J-B
z{e2FhWN*N(zXAuQCPP)=ZhYt7i;Wkv=PS5{?ueV)kA4CfrA#G=ekvwJKjT-c2CO3f
zT*0vZ3q5ko0;_9ET;W(6e37zt>k$7EfT_};=7HSA?rd7FSDgK7ZIF7Fa&3!iBUD+p
za5Y%eEjnj@`jDTa;4?EG$9TPaEd~uXrN_UbFc00CF~1~+FuJ|#>23X*WK;0}N?;-U
z4Zq3sS1G#lR(ERHVgj9#-L>p*_#FMU;Fh7@!~CeW3aW=AhK1_s8NW7dZ<pyU>(@5g
z+vR#=9s1wEIWNLc4d@hi4-{PmnxX=BkExRXeZ1T2dYj>i|D7_nQ3m(op|?>0#oB2Q
z;WiM3@o!1i;v$YBT}QW1?RzBl-nSuXa3{>#Ys^#aGXvb+)IRhQG=B$*=|lX6p79k_
zar#vE5^P5guXMgBr#ok<?+Eni*gE4VPK&VqA7q<{YZ<S_h#^lXrg5SEF}ORgh%}F0
zVs)#toYdtJ_&kg6PEey|ZGaSilf0}pb@P_mdHslf5q1&py`~q4oSRcszmNz&m<@)j
ztPw(Np=lr=|A!!KcV?v1VG3B3nZ9Rn26t4#umQ?Y*8xRdLhsYi{ZivaLuj@gLpw8;
z!?;zx#cWlK-w=IvcTI8b<z#Vb+cr69WMVpjR*ZwTJ~8Y!L{{{BwdjBHQ>>ojH$=s7
z^aoxMm=*5bWpdzVMa#Kn#m)};jSDOXozlE2n9Dk)p~xa$FoQ~*YZ_M%@I3EjR;P&N
z9D0^BH~P8y&6b<<xX#*!ie^=^gJj!KG5SqHo#vr%p;%k93|apTEy9iyW1kflBs6-g
zcqzZe<X8N!^PA(tDA(Deo#1%oUfW{7J=(%8z79La{ui_^Y7%tIfqOJbk}2ILe{@;9
zEkawati{yX)i$+>-|--sh>FiF)9B2Ac(zD($|-v7PVHhfp(Z6VZJ<qvO#I)_(d#31
zYf!It_$7XO$N|lh@wEhL&8&-*oV#7LF#>x`z?iGM#xK_1tafznnM9nvNTX8Se0`Xl
z1J$aNs37`=sblAXaW2yYqR;i~^jw_2<GrR`j_Jl!InlU@U#d7cgbf+C(vwU}g_auV
zer8=l*IfnZz^%{OIczPQi4D}Jy%((mg3nV)x#9XKCAN2Ghz~>1_gdp&5V1TI*8e2A
zZu`-f*ges&v-C8v=1x!K(%mh7`#-9q%Gb3z7l=f2Ug5M#S9e2Cbw8X`_s@`Hdj$5V
zOJ-4B0^KX#u1hA`zqc|P<HkteOI^ONqTKhFGMZO<uW#1{@_OVV&4N_(C!}SoCuVHl
zU@={jT>Me+%N<~zD|z=i@Z4D>w&ZP%G*cf_+jRESW$fPgH?(Q_-^tF=X%aF<f`rFN
zkT<f!&4h%Uk&tyHv@hp>2%deR%QGiKjE(JnJ{<i|T84VkyLzM}V?F5?m~=>wcha5i
zy#xI9M=^?PqJJ=Bx@Ise7=+D3c=4m}K@juqM{At#BfGnJ(COZzX;XA(sm=`n<j*t@
zP3K?FOZ$Ss!_v4;elT2b6t2f4xDHR_dPEA>TpHIYd&8wM<xRr%Si==GH>7cGwERDC
z^*VKL`BkqwmH%-GEssp+KZ2Kby^c)dI_<%5-6dS7C%9;XE{~5+;o6kO#rK>R^V_$%
z_nX0$jFmcP<y3HiGyE7Zq3xr$E~n4eoCyv-UvmO@`FssVwLV{S5|8O~Nqv$_#Sf=c
zrZ>75InW+Q?`|t2xijYp0?<co&L*%BUM|8;L4i-sE5+S)b0sEYd$iAt^jF716CroC
zpR`}R9*D%B;cVrbtqdFGOd@qIO6_Lyj??BZ$lB~aws|eNiJ7^&`^eC+9R}4>#BP>}
z_|^B|obP;zH;szLLxS(z&Dq`}-fx9y?eoLIsJ$I}*p0s2>#~_}s(M$bdVi(t$$6#d
z2H<M0bxtqPl>+*k0VySV3P5%WBf84K&+P@@BJc$RSBgGtQ*Ax57v?E~`Mbd=Mc=&X
zLHVR!@T<BgmEur7xfkZ@E=r{=LP?+ACIBYZ_HmtR>%89V*C>@Ek8naMx>C4m=Utqa
zO?!>-DS7u;JH|g&<NSml{AWMqff>X{Sng-0YUkG(lF+jyf6=YforU3?mV>{7p`hj9
z^sJGkVL#?jWq~gv2peBU_@;raFt?vuEpFQd`exq?1J8S_+Wb1`=gNbCyeze5c(C2x
z?wC$p`0Q>cLFNn1%c!KgHBNqX^e_sdp~!CC%DG*KVS<}y*zSl<B{9*)tIbw>yG3(m
zi&y&vboNexYe6Y-MkO=(5#CEZw}7W+$*D`Z3qysyUdlc92A>@yJA|cYuHAKsCKK+k
z9zt33QmW%BrHiJ*79RSv@W*X|n4DLNzPY6RtWPsZKsMc_!`=O`q&;0}E0o3tnQBzy
zr{8f=$A@qic--}QVQ(={Rh}I5OwKDMs*}m9eNnvepbEB&&NvT5>!RMQH6z8cD#e7d
zb#X6Dy-n`qyiy#|UPW6}`QDG0kNe19?w?Z=5A{dv0p_AfBxb;PV&^5xgLC+LyrDrm
zwpZq6Kt46<$l`zwgHbrNEG{ae4&hwpm6k;eS0RhrZhz}i_sTh((h$phIwG?vxhGId
z*!$J;Lp0e^cNS(!;em)@DYUI5jtR;4hn9l+8d9blIe$e`H(u&a?hW>wZd6s+EnL`m
zpiAvvsL*5E9zWM4I*{|!@xJzEjCB-Dzhij;?Of2k^ru+NavWtYW<~8hi(#X1DSJ+N
zbZ9h5SXJ9<3H#*Y0kL6hXe=5euyb;C?Zrw-U0{!HUM2tC(f-aK`Aew>;Whs5zq|0h
z$-H@b%dX*0-!fItXi%8P`;zH#Rp5Y0{0SL5v-vjDKcmr!Fo|(d$s9Pwhrw~6(alW-
z!rN>}bo(PWQ2yI3PvG)6e;AwAEvw}W@rf;^HoDe92!aGpf`)l##_p4Thv6CPDcdsK
zmc}-^`L@*;U2sJqK{nQlOt>)KymuO|6%Pwn8vEGh+s2n&bU`|5IZ<O5UC=IYMNfe$
z?|qc_E-P>K|JCwREL^d<hX*T-2WcW#?Me4Oj_zXan(>K?!fP(*PdK*PRRHe+P6OE}
zkB9zui~iO!T8XuNMw=C$zaqkfVnz_Lv6gRTRU$Ucu}No!gtT;63t8G?4z<UTb{X&4
zvy9b?%V6`Im9ZC2MoMd!kyIktHSG3Ut)?D{eecA~F^H`JK2z+l&Stp6^*GNoUnl}=
zHdE~t^e;1+I$fvjdwH+Xi!qk*<6{`UZ2wT9b}t#i?roP&iZy=I%_Ix(5%ofUnRy)Q
z@)UT;fXS*@_hYeHb1wJSz6hojw%$5f@gq!0wr-6E+b6KMP#<{)>)g(WjYkD{+o~3g
z<m<xz_5LYU&W2YJ;f)kqTPRkR>oN;DqPH@Tti)Kz*`1x5am(uza$#q&T53I|w{peW
z&-X@BZuA_tuV->Bh&fQ;zEBByLCk@Hlr1q<maY=Te3Wtlmf6Mb;td9|cduyHzH#KM
z=vF1?jwIe~;NlCIXxP*iG-kDH?0#6^tnuViy`2kV`{$OBH{7+RCzI7~ZS4+h8~;uv
z>C?gKFA0Zy4OrUPEQ9_z=I`KOoOQeSY{G9_R8Fi-QyI7aZmZH;OiJD8emQ}Ku%U5r
zjH*t~D<#^h0sBDxFyBegS1$~Ao!m>G7Q2u1w<<Q~6a(u52|=|v%1aW&<Fwi43=n8#
zO_rVN8wtc5Fi2KtC9elb0#Y)8+tUOp*lzrh6gpeTS_St%M+vmsLw)m?OFZxW%F8hp
zYOykCU_xZ{ZJ^FU&f`E2h=&{5!-(_d-p`MTIifZ0)sBMp<VxU2cY>qQ-%JGPJ{(Xe
z)H#b#xKRbnJ)@nQHa>@C2dsla{n4WFWPZF6m$7zA2UYDdf<c4KG(q<xFR3ck_AHl6
zK9nJ5+kL^C%eKoj5n(;{VU&7Zmw>&XkJ*+FVusAb7?H=~;UT{1p%G6AarJCxX2=!u
z@UXt@p|NrV0IXW`3A_^_`U7fn*Vrp<jo}fl9&}ILO!**<a#yDiIxeRL3P~S#^UV*Y
zWpE;q!Q#-8)VHitjfNb)nWpzxC1wH1H9mouLk4?BGNkVr$uR>WFH?3W=_WwJ!2yFk
z!8uLP0cX0kq+2BWK|3kW>q&`HDKG3v`L0pq3csl*g);yhY;jKtUc5cY!h-66Z|?!;
zsKB1!)xAaHVc8S%Ln*|!^dRP}0O0ihtlj<EqdV5sK1(A%_{fw&^=H!~6a3D`pSQA*
zE8&z+y$9#U+V8-*@<B(t%y!H+hCL8Zt{CLDl<v4E?A+|mDFspN#z6U1dhj1z+jrQz
zcGW}RX8|XLe{$vE9#zowa`9R#Ms=X!>|gi8mSb&O|4EdkIrcSr>f}i{FFT<NIogJt
z??P<ZJH)MB2o1;6=cSguq=;GWk{X--ns3+CH=m(6yQ;o<y@K6!M>akQ`f2X*bRP6|
z-@b{0Ajr>U5Dlg1=r5Nd-JqE0AnJ??pyTKGmih{!xGh2DG*`N?3TiU#(2knqOkiMk
z$UhrihlQfB&$<}<^Tpf=Wmvc-^#?+GKa{8b^sZ+ch8cJ#d;np{v_GXQTs@dWiVan<
zy90UiigPy?@RF_OcPL!JZ+|$(Z^)EIrd?u)%2uCZ6u3_`oBM-pEq=5`Lrz$`n`TIe
z=X^;a+JrbWjZsO?WXW+C!LOho>~0N6*H+$t4K3q^btNpU3AS4jUVEM0R6ww})<rE{
zo1J?$Xeio{yYlDIEJ?)HZE!{3j;!kRu)d|By?NZ@sNMdiJRw_Olyo_PVZ#7}g!}X%
z_QmXHtD8b+Iavwm5z}3`FH53OT}dOWdg*kBAD(sEIjeiVJaRBrY<na`$}_18rYC&=
zwAwr1T6hB#XKMEnjM%d8Sa*7LMLRuN4mPvJ*n0Z(+4>f9COQ=8m>s5t_%ME4-_Gd!
zEZ#>{Ui1{220MDn^XrELFj{{EzvG*@`sON9ihO87$K}HM9MRV&y1}<QO<Bx9-uZyV
zQw>FBi$NB0@diLySUNCB()#mCv!$DEYLUAXVluW@pqx%)0P;R&c%!RH^rDU6T5Tg|
zP4_2h*qE$LNJd^8)r>$6-ut6lHb+}|>-SgYH*eXz3>J<hu;Y(@?d0eL<1iVX2FNn)
z62mxBpbazecO?V%Knl#O^3|vDE28U?OjkxvccF<-0F^|0sk_3ly}kR5_U`3|Zr(7y
ze|l%AHgmcyo}HbcvT7<l8$;c`&airEY8U8zw0<tWi)oHFeKVbO$1axj`R-#gXTuys
z`jAwXFL$!2-}J)a_hc6%*0K5kf+2r4!smV5@&8(Civu!Z|6+k%R@o`r4ay?v>1<Rx
zl1NOB=qR53yV<`J^qpSW(!X1ZOTH6)XkM}G_G#*CkClVG0y2(|+qZj2VIi{f0ACZ+
zXY<zN^0#r*RQRawdDg5xbUiHP()}{tcXZs_u9;x`bMwnjCV0X}wdaT~{!{JvlY8So
z-Htz{9q;Sg&)#R+@xd7qCQB5plcarCY3_T?r7(A!c1b&#=zL)LSMATYLzlz%xemUw
z{1qvDDyu_7@OXc9lJ<@|+dB)BWAP>)Q<Ge<ZqL!=x!gVH)uYX}JPkY=oBjH+h(YrO
z#J2~jz^(1kr;D}SG=H*?9c1dyq(z(07idGj+4x2x(1?18=M|nlidP{E;uFE^O`n@2
zC$X9MIR<9+lwa!es%KK7O*y+I2EG-DDs$z8u86SlGVmv=&-N%XZ}+~Sy0k~xO!H<y
zxT6n+t!-4tz>6j}8&rJ+;kRWQbka(@5iq$ov@n8Z+yu?-y++59$+pbfT%=OlAAs~d
z+_)&&rje^3C8oSc1#$KD=;pB}){j$hA~G;vdw<@JE}8nm{o&{Buu&6Jk8>3L=*{6I
zjEuy`lh=-I2r`II5UN{KkS;7pw5Of%uz|-9>NhagZN6A^xC{K7w<#RPABE25OI(<(
zONHi32~WE|cBi-OpS=EY`jzK>#as467uMY4a@yvLYMbgKXhBuad`Ja8<3N3fb!lQa
z88$Vj6uA`aCbg<>Et88`TBXCMawS1<+9wm(Z2ML}dX{C0o~?&$+>Gu7cJm#-q4r}$
zM+W`sp=_(rSk^~_zMS}~?g6$6Erhp{d(r6ygPGR42)fk!lIoC97C#!o3Uly?fjwdY
zx4=gxyQWavIG7nSv!J+ke|s)n>sQau`8gYg&An8Ko=34}!c|Xj@mn#(@Zj8f<t-Y0
z%`g~Y`1iSp{ACV&XWIk-2>&>(HoH65=a3jZED;wrUgA92-a-ZYukFd6hG4Dr`QD)S
z#&^3tsoHzWs+srYq<(7Dm~~|8$Dt@zA6X?<^<vh8^#NBsa`CDBZXP{nAQ!XD%Mk0H
zx%e~}&k+n<h^m}Kupxu8GF)e6B8*Q5!sCF(s7r=?OJ12y&c!U@+83;JUzzzOWR_(4
zQx#}3@2ULFA^BV+7oQ1mQW^%4p&Lu1t6t%=RnwKnu^Izd(F5?PE&zK-4PZ1Ep9S6&
z(bY9wC>Cf8YIzSDv1>WKY2&B)9Cgpt;N9<_4MOuVF!pi$6$$H~+Tbs|e}y)vH|c&_
zZ^cs8862!4&fv7=7za#t?(2Z2C2?TxFGR5LAW5_vDpRru|0Rzb=y|vUN?A-(EM%Tb
z*FMt@z+kzWL~f%Cu9P^@N$iNrd7k@HR-aeOl?!~Dyn2{Em9?X+>oL`@-1oW$O8qu_
zC=JAqr+mI**A97{Ox&#fx1|DCmV82oyW+L5r>QB4SABG+WQn?V!K!3^VSJ{ifMumY
zSHQBQfJ|wbP5%=-R&^8lKa1^4IRlUudhA}Q&^q&uuz4li3|M+=$)9&6w73iB!-f)E
zt^9_Ry{_b91I{U4E`l#rTdU%yLG!vZ!O;__td6+p3mbkl3L9!EAXX~(W^p2yi_hUX
zdQN<<Ub!QtTzx0^>SNAkbYkk6BI1c8>0_HZC2$P(il#*C`5UB>kL7PEVg1v1eiP4K
z>Zh1Ke#|BW#+5?2dfh}gdd>+M5-0dm4|x)QLV{_(dhJ~GtZ;nU+7oygpIEz|$HY8o
zYp1J61pd~ePzk434<U4qg(5=7SZFn&{Vg<1h>8POAhgLsD#!L>(ks7eG<Ai}yoqJX
zcr|~^APjGx_iO&{3S2Kfk4*35UC#+>{1g6$fL%fQ#r%DjJXi7lDgIi(oyq&$IRI00
zYxTJ^^x}pCec46VqIJfW75Q^F59Du&q0^Qvt7BS%O9A(7zCBqY%;r&{bdlK~1SL0@
zp8FGJwK22BB)q(w3re{Z`pxDZH-$T=uPn5IMMgOv==RkPDQVc(3pTJ>xqYHsOT=!$
z`>-|&S6(3~6}BUUORS6_a07-ST&(Lphom!=i$STl9iyx_k0M;G<(XTxnB4xL)ZeX6
zyC`wa#VXs}&uNi%VaKbI13_tE`*Rl;rU(~nx!#q^b%JsY2BpF6h;T27ig2-(>-to#
z<CJS@P+GbjMc<oC5iZtp9iPf&&9KaG$V@9Oi=Rv{DVKs$$uX0sa#U)UV1?DL;m7rN
zx18K++iuZ$>ahvbvxqH~T1+n8k^u7&mIR)w-g`b^lk-Z6m|Ry|Oa#*~HwoqfgHcLE
z(bd|bLZXXQ)ZC5g_$e7J4{>?A)nO>U7>KkiY`s?eu$rUydb4r#-DP8^DqKRT$<m82
z>7X!a+Ik)sf*XV)dM<4C=Gd*$i-=C|5V0LPh3L`_A}5!o7#uB_#Jwm++9<e^GKJ!@
z4hlE$NCiptYl*#_$e`&ZLt8DiqxSFA`mDtzjkZg|U6d+`4OhL4JEnu8ltQ6y$H8{%
zn$h$1q7NvZh?z1Ly+E&gItU|DC(vh*$FXjgs;>5e(hAo$enUoOX@#xy>@eDC?tM5L
z0h*gZlSp7HyJt5+wVNHYAS|y+lc5hIii}l`3{Jj_3>{{Nj8)qa4<`mj#_Aq2R_}$3
zRcSI(+1aU5zXDdd_0p`3JztYfcSC1<C26DQ6oSej75J>tlpCdqYcMos^jQ(@nLVWT
zTKdV-CAQ#J`=s@(E~t5p+*+LcQEqQKALQ+?KEuo9bLWgbk-N<tZqCpMc{yvEd1ik&
zoVAiToOJ~(!tR6#nyqk%l;hu*c-65E3@JJ}?NUzeM%#IDP6cH~&*`snOlNd6Hf`RW
z?!iLY_%!V0+JaRe<=Z-}L#mFL+Za5GjE{&nOT9?0!`fVh<J4?HOE!mUoMx=_zV7&^
z>4kH-g+a{Dv-TEJa0TZ2{DzI4I{wcdT))Abg5v=LenXS4VDy|F&O6}BJ_5Yoba*ww
z=qqTLiW3V&A3EB46;X)-QNkN1kdA7x^-7}Mi=mQl<qk6Zi|}|YM(9j@wb8X7bD3)h
z$(zD%CJst}k?Lb{7Kpf(h=JW#1M*Ztv){nXVs7!Q?%X1U3P;)$2k3-L3$hNGJD$r>
z3%YEAZZ%Mb?yK&YT?$>|&7uls6AgIlj&!DwcF7;Q-Gw#R+eJVA7ImrDAa=5avMbnP
zR*Y;GyvY_Wg+dEQLZKaTvmzKwI}vq7Y)wUAjTKs`^9}^_mqM$NifAd~nW+dUFSMSW
zieOkP$nDv|fvPREo{@^UK@rVV#JnPIOhwSW3oW!+2gh?1!7!Ud%)f%h^Co^oYu=*9
zo>x<kkGrs>VHZ_%YwY7=@f+l@z^28^bww_}120$dWoTtBXK0EV4aP-o=3nruM-zjr
z6u4O3{0Ji^NkrC(EM?xLY}Mr^bxEW-FV9bsy3VqfXbWj!UXs>bGKsbkXBUdK+;IB5
zUW=S>*xMY#Z9#Bb58_W#b<U5y80nth0lMkVE{@ef%tC!QeRyYulO8oa-Fce^;J3<c
zefR>;^S*8U&h7x?)`xe%9OqxwCkm>^@p&hpi*m#`PoVswmK5bGJ8;CDOY$!CKx%)j
zZPwK8g(dmKmAo(hD7-oamHtmE{U&$$%*<#IKY{m{j##K|k^*@YVC>iEKz3>-J#iZJ
zen<3X^nL8Gz!eZYpciKbSE)DN1TQ#?%&yIX$MtekL2WZQjUE(pIlNPCrMua~?Fw;q
zvGe$M3YkW&-w6_Urt&VPycH_XZ`>u+{ta*D5uXgTPElnl#p-c>L$NhFA4@5B3*a#h
z0F@yCc~=y@EsvIHzJ-wA&~HR9sIt=GG~54Q9*Y0}9zVAvzDrzO_lV;W8&C_)w-IFg
zlI~wa+nz+*`VFNQ!tuYY<pz~-6z5bwx3T!qoru==-I;agE8=d+Q7=a}@`v8-KGU;K
zegu%*xzV+mYOdNp$GQ!B%71_d(ep=)0MD=gha~;q`DxuwiMC%{op&L8870-(1d9c&
z6kS(djZm}I*6Vu#UoODw4Nxh%$GqBlLoduL1aldsOwKDsUred$CirUey}TldZ&xfj
zo2yn8`#!~vH0hSOSNw)vW9Tk4?^VM1-;DY>oQkC0ptuOfOriOHgKsDs?sqmxDnx$8
z`wbN}T)SU8w|^pc!v`$(-S%q`H++z=b)<p54KPO7le~tg@lJy^;u^}Q59Nf-4=L7f
z2%S4$^3Q~n)zIP0C^YXQrg{~$DiGmXC^Rv&<T_I3*-`%ny+-pSSeK2CfmiZhXouJV
zenS{jFm|n4^3K$x;Eu6+E@okbQFUcf)U!yPectY}dtIn7=(YWgNz{m<<ej!MTs4|+
zRe7Vv<<Y|K$F?~xFyq>AQ+4Cb@y%M`*%Y<$YMeYyN})#43nL7+D>=%L_oFu=1>X0y
zhSdHx2|}iOXApR7C^4LW8TasBMx6doQ1)+2BD4wKitxH~_0xPXOB7G9aE5aG)!Ai_
zBlq_@ePVp!P`;9-E@z$Z(4t>)eX&r@RdiRR+<T38klvI`5`LG$YI(x%QCKY>QfBlP
zpu3}-Y|Be13kKl>>JFx6TcJjnseOc;e&eJ3#>`6D0kkpbehAFq=&~KSk9Fbrc!A4{
z^d@<`1yiPMEle!$`zqUKy!be9n1dT6p9<Uc^+g;dda;h?u1fbCpCEz^pX8CGZX{E`
z9}MU1UVA&0YFDKhBE(uKxcXtPjhjLLU2tOlQ^a?vS{*cwR>b0GXIQ(=Z+s2_CY1*0
z-r8p>x_CGv`$fPSpXbMKe1YG<ec9|9%J-)K-z9g5Ioxl2NvO5&KAb+;&f?PEUnVYo
z4uajK$9R1+y#9f;bA(-q$k<1d{Ki*-pPa2s`Tj!qQFv1Si*#PGsrXzpk80x#z!ALo
zjjyFZKb8Vjd<XPM1O0jm^!^m6;uFy6Tm8mYcy+vV9O@nciE)RpO80*YM)DTe_Z@eO
z2h1vQr4(X}#6s(vMk|M^zCmCi{FKOjJ_(caN{McS1?^o6%l*bK;>i92075%t6W>fw
z*WrJXjPt_L<@||3{6bP|m$gkYz&<0ef9U}`B&gji14}Bjo7vHP2<`SmXs&;OeDdRe
zm#n%&dx-bucX*Ngqho<zBqDt*up=pEqpk<f1J>6X$`rV-ewz80Y{@{$2zTS#o#ZgN
zY@mbbyBZ_VOqrneDhT!)^xib8p3NYP4~3?H(^WEB4(if^NTw0A8I7}vhDuWQAVY0=
z6gYn5>H~XvaQF=>nvN;@4M39^4(Iq&ZIo;4-%xY>nA9$n)4{foffN^#RKc*)_7b(W
z{#|ALMNigqgBV-|yY;QLjwGAOcTu}GeFC%tR;up?gWB{rKyu{sUwP2m^suX`T39*G
z!1*@<3*nE|!rM(Wl@dJ*(WK#jsOVdWR?o)L>NJ=5^hnCWc989@QX0SF$ITuhaIlHX
zMgN*;-<5oiDsV18VLUFCkIeo^H5CnA+=%uLU|QG{?jzLGr@Ee;$Uvkm#_&xCd1U2J
z7XopSA=4PU_aO5cA?=oeTAPAOzwyUTF`e3pmsvYMVdIzI_;0JjpZH~T_%n}6^b#^t
zbEVjq)dTmf^uXq6sf!LZt75>rn&s<PLcp$fXo7PNA)9Y8#I3Kr7J(1a0$%%oVhlbV
z?Y?ycuXR^~75oCie&c_jAvz02V*WN!vYAvv0r^*A_DYt`p|T#Mo%d7Mj(-ExZ!9Q-
z-}pO^(RMwR@^I?eq@E1?1%2U;k7zNVSv7Jtt4z+VSJ>QS`<@=>*%F@Yx_xW;(ZyUi
zo|tG8$ea(Z_Od-7-qQ==?u~gm_4%3Vv)pbgpRDYfL^O=&?2X)YE2dKNGPVm5NK$Y(
z^j8L|`{w(0lrvCda%v;6c^N|PZw#wzbV96;<?KVgUHd&{Ge+L3-ti)Sin(N05MuOV
z-cyZma(h(w<XZ35#htVz50U2YHSIWStw3oRq>Pc;i~+y#kWn2eKb$ruUnbs(DAN@^
z{2KFFBD$RfCxr@e7via(t*vJSmG6O~Z+(<j>Sm*Fsh9iqsSV?ytcW`nMXjw53RiJ4
zu0IGDINML<n?5(tEsW<AtQNX=dkV~w+s~J{_Zsc*yb3eR5_z0M9_`C}l{B5ceQ?6v
zFQiRky=lXc=F(oeM;ce#Bx%g~3ezo^*@@yqa?9!Fexm}AeXn6rx^G`mNT+vN<+9E#
zB4cDu-P@lg&8!*UZqv6uwU;zbYi1rSZRJCxt=e0fZ+FT&R@^4-+aVWQaWy%D_$7;@
z(eOmSbaC{AMKhP_MY6`CU)~c<Kb9UokLS;we%cqP<jhhKRPhWb!Y&>TOi>_m`w=sn
zckU++rPzDOzO7e)x|ro-5|E457g%Uh-^G>)Wd<H&kH`3{v2A}K_weme&?NCFI2_=D
z2;B{wi@a6$20`t9iQ+K`Zu@LArN0tl{Kl*J&BU+f*NCTc?I1k=8h*MA-nf)Q3TRaK
z^}KHUT>)P@wr)1V=_l9SrXj?Y_gZjph&nUoT?^Wy)X%CUcC*uAn8tVgeQWElQ`z`T
zQe~eP>{7|5El1<mlcujrR>8<7t#E!_55}X!CRu%p8G4!DI2cI3aR|SOb$AE3QVQ}F
ze&bLBS>FNi8;5nm@y=fG9e(3*CHf5x=_V-s##|>Hzp)p7i{HRjfC5h6W`g0E2IErq
zUYOhY(7M4K(S_kt-QAbPMC{~?(Mt6jM|Xkz#-{E|LPpBbbqtA#qw6?=(~JCEO5Tf~
z>ui|)pnfjjd%_aW`z5mKH<TZdO#8Vo2ju61m-2H70FgeChuiUp19Vw!5Gko`;>Udj
zh3_bK(s9Zr=_hy6WvL$zM7#z8YMx9;E)k)gdlRLRs<?PUsgEI~7(E*+7)rLypctE{
z@ai|*uZVFstH=(});j?^BH}mENV7RJJgV6i=nG9WE2&)=I~UL{qj{|Ijv6&MYmRAC
zCTEQmH*6#&B!a52@f6n6{75_&kVtn9nzIxm2aWc+WT=?_Jr+LdukDAaB}{b)^?`J&
z`xuBld16FP$`fO+@{Pz3gT0)zne)R)BD#JU@zXay44cNx4|4)BO)(w?f)k$aFuU+c
z3aiP?55oqYa5^P&P}>$cHgfIhTUB~T=9YJSt85o|aG47|MiB4UM!)iNo<a=r`O}jr
zjxmT^KbKWER_k*gBmyBsNF{{I!8xuwX<EN=1}}Ezqj@SJT285>g&*A4h4roZcQLhd
zrdsVZL~+<%>zB$p*3NokH><?rG!QybJxe7Zsw#p{_V^7&I5~a1lK8S54@b!I1l#Vz
z+c^*pgL1hfI<xork@zIJ5h^D)PgcxgxzQTF{?c+IG8_$(8>6KoH)2LgZtPWZgEi(c
zi9>Fb+sTcZwJSG<)#Qd<S0*>7lim~;kQ>gsW}4!;$;!n*pv>9j5YC@XWOsPD$k|#p
zuGrV+T9?tbOc+i~K1;O&qsJ~onLZ?md7aFl_RH;hVT`$pM&2Xx&5B&@HWp9+n3bnL
z06oKH_;Hay>wG9l-PLj})FoHZC?&dy5lHJ#%=4H)+m!FT+Ga!|aF;6_M$5R%6*^^{
zSG&&Ae~)asV}2Oo_{%z0%&l!A7)tLUzg_#mJ#H#*DKx3P4)7Vi-CPma4G}?nH?{Gm
zFA5^YpKxZ7@!&FLdkfLZwpPml;r!*qbx~krEU|m>Poga~z^_3o8lQEe?RqGf{*WKt
zBg}X(n{Oq+7H3h`e4E0x8>mn7?Fx=G-@&7cdZTYU1cMkX+GQ*oD)in%-(=#5FV=Sb
z`HicgXL5GToOAQy@H@dWS<W<-z)kNs!m9vF_4$o!Qoy*_!}_}nINMYLca}fj0ZTI%
z0#ozF&^|}vHjZg2eI0sz3(%?Um^oW9E|hZHReL-sPZ749+dApBUIDg{Zv?)ZvTT>9
zpD(a`Lz^ZxyqT_~4b2BBjg7b3y1CMJix$WG)~=enLn@$KUKk<%>>P^8X5S{{mQ-%i
zyh%dQGr^YZxXEU2TMSV+YM80or-0Yj-UE2frXcA&HC^n{i$(4!hb2uz&Nfm<=Ncu<
zPaGxMMEcN_I2^9vXgj%eb9nN(v}L7b_z!;mzbDKc;nlS!81S8Tv7_1CZ!$ErP??ZK
zZlor5tSo022Dpn$a1U@PJ-WM-Z!9_9=oW36Wam0JkauJV-gg9!g_y1kDWNSxe&Z_M
z%4NS)X2D8fT~XR8Cy3B)Ce*UgEASA{k!<uX1VVwb1g1CN<1B7%9rtxOf35I#y7P&(
z)yru?+bI>jo(i)xZ*|T@oAhS$0sLX!zgz!_k*z}Q5VAza5W;}+t6SV0v%uB3?(=e(
zO+I^BTXjk@Ri+{rLVUmN>&TVTy)T?2V>@<<<6X~?t#<j<rMB-S$LHu``ml_O#Ble#
zW6wMpdjgT>Uq64>tzWxt?V;-qJ$Qp+vbHUC*%r^+uf;bLcz*JD!e?%+U3tyrbwO-;
zr{^6(pWW~AXL>h$mhG>^?f0n1p9Gk<o%cT+%=@ud#TN;ff2fcpPdI<)c;6r||Fh&!
zHGoP7jfV#CsFFtw@gO@~(m5v+e?NbMgMT*u4e%`SH^QIdU!FV_Caay3+n1+svdQ)U
z#Y^PQShH<?=q=q>zxUejb0!WvwCw%BG~IhA&L;kN`yE^p?H_vE_x;j=q4&u(`hB#8
ze`4WF?e|&sdyvI{W<oIUKk%CyLhtT1`aNUf+T%G%7d>!5=>2s<zn|Y%zZV~&->WR<
zy{i>|y2W2UaOp_s9XKJ{{(JnuLqqRX&=z`+JyI~oE<gUL(AzzA{86#@2;A<W_h0>j
zUpu36pS4us$E?U~488hsih0_>3dbvycemj@^AKS;Wc*79zB0j3w_KZ-3TEF`D(n4*
z?Np;=;~K?$Z&tZ}u~IlUtyTEkM=1O&i=VZaFIo7r<HGZiqxAb9lluLXVLNzKxqfTm
zQTy#TY#RoCJyr0YWM$<K6#NmZ^!u(cmAh_0;a~Ubcd3=~jjF;s57=)w^nSPQN5_TU
zGuA#EN{+TVzIskneS58bpIp`N6H9`>%<vy?<-XBDt`mlfN*)-NtUdXdg16tm?X=fN
zp`qZ79eDeOf_EUlq4ze+wZ-^z^|A*J81(*af6?~)gH)sUO-ow7vr%PzZIxm?YsbxH
zmHT4&9C|-IR=>Y7m^%(v_%iT>-WRD$!8>QgS+k+{N~`Jl`z!waM&Xr*DE!&=!uc$d
zpLItloH<nSCmH{*wBJ?6nY%1}lhyr&#-*=XTdc2$=5JVA{PB<i^87JtsSUut();a!
z=pHW^5DmYya-VO%zqeZa#kjZKXuHm6-fi*WkZ5>;#eC^lg>RbG@7>leWh?zY`<=Gm
zzfCLkP7A+$z1nM=g;yW_zyTNg7p#>eKj)E>`RgXtE+-kazg?m5UDi@Bo)Vvbae#MR
z!8_F2<?NYjp#O)^A9`<IEBs$ur{7}?^S2IAIDl7!-nXaw2!GSs@&2`HyZ?u^Hvx~T
z$o@d9syq9>uWU(3AS8i=utY*63rI99LI4>VLz6U+AxVdHf}o%<Ad2FG3yL}lf*=Db
zI_M~(f*^{6jte?24B&tYf{u<WBkKE|Q+2y<0?zk;-+S=gbI<RbQ+w5^<=(#ejPvs&
zx7T>oZKUW~@icq8o;dv{Z-W1D7l+fIt-RESmL?MlGP--a6ACrxiEf0V*fv@`obhbs
zR1t5``&rLcCc{f9;Al~lqfrv0DODOJGx|5;B+C>=3kPVF%IF2?rb3s-s61bzbVj3*
zGtzZq<Sf>xJEP$h8ueh*W>8N?oBL~BFGeL7YD7LWTAb-aC>ehZf^wab`)uVR<SU=i
zRS35TsSRY*7iCx^dg6H()!Bv6eIYW$2u2ePs$!I7&}a@fs+7WI;QQ<pF5Kv*u<n-v
zt-G92<sgmf8NG(mF2b)v-HbXI^${In30~eATSB@4_}e~&j`z@L38U9I&Vl&*5~N$(
zmvqDMHE7v0T6E-Tw1&|UwAdn)XB}H6T|lS`-vgkUxS~*_ZLGV3%U*-u+>>r=3h5>R
zQ40MyFPCB7A{57HDt5bsW*YPrqZI~y4}|Xsaq3gWPps?7y59?jq;T^YT_J){Wzixz
zg3`M}gi!^Gd0g5$JUS*z*D%t}6va?Qi?pnO5<-JH+|326vKHZYie-%6uO!rn@90yw
zk%bynON#W9ZmY5`#R|a9mi@Cy=QSuemrw^jm_wF7_a)1##T<?$t%`Kl15rLd=k#t6
zSCgT5B%gFQ;%6?7UdSh=??w0q^sUl?)N3(uFT&SY?`8B9qld-)jQ$c!x<8AD7|nvK
zU4-A!Z($UIco&J6#G|%2UlxzE?rGNT$Iovlg~wpJ2)}uKn$cgewpfH;I__XZzgJm=
z-=sZni{+r$V?*zWeQb$yOIW@y_A~mK<NQGU%@*fJ;&nzYPW_+a?~H;t+!67XEzW<5
zcWmf0@c~<I44@QFibIUtVT4YJ!#2w=#8K8Q<y!h4KR2TC_2Be=5T_YokB@L?#h227
zc32KiivvvgHS2Wk3i%DA@3`zze#c1Hu9816(zWZ5XBg?6Ipxo`yadQ!Z75heltNS2
zMbXMSR0b-_8BPX}mr#i<XfLbX!(;^Obi2pNL`FI<@iLi_&P#$!Wu#jyS$1cn%bp^8
zGWs{yM5@eSq+2shW-$uo`b?MEjC3t^lYJQJTIw!y8ExTw_K<mu@M|^Xx~D8)^g5$n
zasZ=juCokT#0ZDWu*{OhjCNxwy$Ijq7|f-8pHUw<ly$l$a^)~vP4tt)8GX!_1+v_x
z8z8G}=@rV07(K<Q50ur6s<?cE<t2>1XH+7`Fv4~ec^M|hF{1M$csF?|qYJt3mdlBZ
z)^h4&<TP9Alck$=x{VrSJEI#pb+?>nvz#RtDC%dGc(34P(I^+P<x$Q{qg-UOY?Vt@
zU|{crlJv=opUi%?+vLSV3W=66JzPZmVo=LwNa6FWecmT|GJ7{9fmuWcmJ@wxz;2(m
zI_G6bsw#*sV7jgU%iRJ+bpHNsQcOt9#=9vi5=-!qsueuseM`~<#rTxNjzIB7;v2C1
zW$0U=Zw>tr_Cqc>2HHIAbhkqBX7P93dWpC+)jdYMHlQRuTg)69)ID2V&D1q4sCzFl
z7;z?w*W#KJW5l@h=EOj8M{-Q}Kyg>MK}e+{jZ!?Bo(RdegEJxmMYl>y{papIAXzb>
zNB2U}Ej>GSpxE7~Bt1^N1)3;M$5EW`F&z?5d_L2|OkV{p6hCo_HzZM7o}rnb*D-A#
zmWdpuR#0wF_s@>a7PG2|rxdd}#cc6eRt!q?L%|y;-G|A2QHp=`AC%rp+&+YA?8wl3
zJny=sg7_s&pX<LLbsJSqEx3>AYfLw1>oz5N5A#1|5&r|z9N0*4?ZCl^ZO5R|NM&sC
z@46?72{~<`Q+iXm7UxIDC5j$7CFwEZv4Sg+t4+n%!2a4EXX8-kDc6I4ru!hob9lrX
z$WKWA0PwdbuY`O^$tuLtKJYHoVQO!x)yE1RLOpEBElDpFv4tBU@5wYD)aqTi*?;an
zd2uk)GNzN5x|t?};x8+9Bl;4zV2`q{y`}oX&V9y;xg!2?#QZhWyW@!emHFqH@5^)}
z)5rwUHZwn;>2;um;?d#TQA^L}zW_=-u$QPS+5`R$l$ZM9tDyIkW<>N7H!uwx`Z^?6
z40s##`C<P6eShdbLDPnPMs;|>*Pt<j|BG53G3-0^=hMZaN1^zcX-aWmkHI1~F1AOa
z*e#PlZwk!>4U8oEH)jFpJE6ls3nDK9{awJNpg)HaA0BvVk3i9y^?T3@@~Jj189Ebu
zWFko}8cq^Dnv!}_A9#k_ZXY~=6bCNofXyqQQjEFaD)6I0(cd_RQJ_++4WkynEt2G?
zqbO8u%o6bL#!w#^9!qp%?C&A@DYiKgr=oFZ<1p2U6_8vPay#OzA3!lv?a_E#398f8
z)GwzRxDO>dt=58G7)tbD#9E30qc2cAKeR8xKATN3v_x!yTuZce!JuuByj%7h=*Gx>
zpg%?t4UXBzb^9h_dphP_=8uA(BR_%mnewx7=v_=(BEE#=-7-o`OIEY|0j3+6u4GD~
zD7W7rp1JBr(6~_9lX6b{h2TjW!IIdXfues7mHm=o-N0W`L0+OIq7U2T!{+DEBGB+a
zD(_WcpMYK#IUJICf?}H^iKcVR&jpM^4CJG%ICX8r45pZmXI~1Mmrs7L#~`9QUAql=
zA?%55l>CpbRm$^Zr2D&o%Q;swIfq{GuQ}$MbjfBZBsua1(8nW)&J$}u*ElwS1~?xB
z?HTYa=wCv&p>B0<?R3hpy@>7kVdQ}|eHLB?c{qpaP>=Mu2<`Gn4~p%P9+Z<udb|eu
z?g%PNbK$$-bxDVmQ>kwqK=LC4`o>ajhrzR5BKkt|BYrDJlH<tRZb>6(uDX=_!*lR^
zyX7`+)02p8U*9i5|Hy5<ukT%`AI(2zBtQDJmgN79J^t#h8Hs_tq_9TfF^tn!c)pA7
zLp?kUREpGm;uAoncrrW`_SZyGs3TD%`QP!(ET?*Kf!f1T4aD`L7NmZ4S|x+OFtjh|
z!H5e$?}@qubayoIo*3e<kG%{uA(re*o%P`V8r1@NG@9hM#LVv%C>B=!5i}^}deAGt
zQ!2MZTk5<Uk`?_Q0)2ky3n<ICJimX4`H05pM#z7R+6EdNvyDUTK&S)aMbNz=uYw*6
zxwOalo>)kU<;mV6@+=LVP>T=Ij(M36z1>TRjXv~IFQ<6bhyI21zW1Tiy+TArFM)rQ
z!kJzXqS}XKMwD3SL*W^*;!z(;%|IRa5S<=;??agxsUkVUinCuvx)|a^gEM-FD|~1;
zl3w6Ll^Gdgtq;{?WQn~#bXi7@_|S*yGWv)we5f%aSEOfBdP~H{(z=X1@fIUpX9eOT
z9|{l!;%gsj&FC+JvaEczW(*MBd`OByk=+UP?}UbSLgk&%#huW^PH37&!PC>yWua(b
zv?O?LS_0B*HoC**$+Adv7~P5T08u2aF}j@yH&84$x>pfyptx1*(0&Q{9L0S;6d(qP
zO+Ivs7%cYt(7cSH;*<{s;2T|MeQ06EFoCa?;vd!EvW(&4293n@^cyqE#8w}=73h5*
zx;x`S5uQ!q_KERX>9SnR&#_`zn^7)a*GQa5*pg8pjxt&;8grk_sKjYCS*{j$<?YTG
zCF1*O)MM!3j7vm#o<_G^@I%H}fzOt(<%|nrGcOhQ7<9+5yv$k=pHI5w;%{XmGA|RY
zj8=()VdFA?Cyr{Ayr5`D%H`q&cBR&+x?GI!ufr8}yDal^VsVyFWuGRe8MIFxNqHfd
z-sU3RKKWtF^h~_aXV9A|b24Wbq{G$wbVpM51iO9c!<4qnSw8e;$~BpDI)!WU>5imS
zh!!9EFy*>TKce(n1)fXd-)hml|E-yG#Q}p#`mfGx6C?2agLEbRAIS8Itp<t0jhXFY
z08a5qH>UsNne)UmKJ?ejE5(3;q+2Col3vW5FXkK62WWvfV9-|yuVh{&zBNcBzLL36
zq~JM*RiAidgMU^HT8L`!7q!^vs0QE6{G$(1iI$5jj%BrQ_5Ww)^<sn%oyc4v8W^n-
z4gJ5$yir6Cp`fe8vE;LvH;XER&L*7Ayj3(AbQ)-txYM97$^x?P5S#ESrIpXS#5RqB
z7YvKYx=YOF(^zW1M4+P@1#d`5m-mPhjF#{iyGK;f>*J`wCwpXPtr4w^mWX}*J%RU%
z<BXPz5<L64S0t5kdO&$u_ljbJj${qYx=%D2RFRW_zdN;fxVHQxYh>11vCW6ZWvv%S
z4H`aZQ|QBDK$*5|%bS|DQH(Zd+dx;=CNbTh6?siSM;NW*KL3dLiqR5L6qtv<pHp}t
z$AS_`u~}3xS|X+;Z^_s!R{C^XGX5+c@u7e9+9KX(v|7v@xG?K6ku`#1SuHlEECXs~
zq(}eb;#H%I$Xk{5xJWM7mebSk%X&hT8niKGL)MdGgF&Um+p@Nc=n8FFTD&vsDRCR4
zRU)$I{;a1(aTV!SiHj@W18Qe<hiJ<?1hm1RZ392a`m1=^pc#2z0ez^$aZNlczGbvp
zxRd^y^{hx9snc^OCHH<_ygFK^ke_xz?>(X?Jp@F0V+u$1-Y0IjM5FqQF}+_A2MpRV
zWK!=}MSP9c?HF=J@BLz$K^xL$_I^#g>O-F12gI~7+HynMg5G}@j~EnEv9$Nw;;cc1
z18(j8u2?(Kq&IY9?+?X~2F)M3r}q&tzLs@dqT}KKqt)WE%)`Bpi{we9TP>c+{IvHc
zV!T1o1HSD2srZo*^>T@`J^F*v<T0}=&h$PdS`8Xdks!VjZyGcey01m@6m8i6-S=X?
zK~4S7^!`EYGU%TE2{`xbd6~96khLY_XR$#eq!*a|i-?}8b%n|C*-rT;qkZD!&~DiQ
zG8iv{;%!;!$jitMltUTq6GbV>GDu#=Xf^VglN}^qHE2LZQFf?2XwX#X!etdZ@YSLL
zx+po`pr-yg*)ejLLHG18%8r+RGw49p1=)%6eS<b#P?eo5zcuLHfwkGGvYn@a)j|z$
zXQ#{L-*XvIqPFZF@=hOGl${}eWV9MR@{a5r*>D9}t`-lVNA{7AFj_8-WZjqDNA{V{
zv4~Hy9tIlVve1@{T=^BFB_b00%YJezPajLff0I0c{p8u1WVu8nC2!5{CvTf=p{KL+
z<+?^fdb}6NZH$(S_`K({3uN*iNVi;^&fAwgKrUvqO7u$kdv=jb=1FL|=$H3F_CUEq
zBkm!C<#9%<#i6u~X@lifo}gBXYX^UlJwygKQ=F^Cqd+BczCr5~zt0{fU-hA1vxmzQ
z2HjE>oO7Y<$y3>Cu??tPwi>h`DJG{<er3>2$uT(>$u~VZg`1Ll=3F9+TQ%xCI6r5s
zyv>J(<cyQM47$B&M9z5WoU1Jl15J?A4SIXnB{{Y75rbYDI3;J2{K}wZgX(i8%b{&L
zT<Jhh&J?-Wpxe@~&bdtPH0aa*OLL~maId!fxc^N#m&*o&8k6tM`Mum}&<90Za_VG!
zySCg?wKK;hn+!TN`1PE6xznIDl&C=_cWBGB!9#M~a<oC?pqnW-_|TA?S@NJky-MHB
znJvYYI$W>PV>ykor$KA`eUURq-e%C`%#*5F9yRE><ddpJ7SGq={#N;2jz=E4%0i)i
zyz;C;Ylrv3cXacv*1G==>xIwajy5PSvll+C+hkBtVy`||$y*rdK6tgf-{^i$%;|Hr
zyltV5<)Ng)K8xg?i!^#Wsj|-!`HVq74H|=wOr~F>b)TnPj*nF?yjG(Vi8JxxptFlL
zdZ14;KG@T=M5ELF{)jh>UNz`MzZHFMmU+CuSS^Bv+}7t7IoqHqDfjldRo-b(Smu^K
ztK>n0MBcM~?vUY2b)2tf9_VwI>}k-6gwOiiBgY%`*NUI|+$$Fvw6!9*@BQ+AM!M_|
z$m1G`saf%TACLjdbesVf;z_?uHz+%CQrv^G)u4L{cBHJ8rPpc89a)p&*2?V$ofy6&
zWt~i3u5~{T>DG6hyz_dEh7Ql{yIyWE=u}eQz7NZ@1{Dn&-1iaLmtRQHIom3SGFpxC
zKDzH#Io^jR_kC2(_MyhUkIBV8bWPvK<uOLI3X)=*{DKk9Bu~U|lfP&b`~&t2Psp$p
zl(Xf*GP47yCs0r0m!6c<SVya;>-#<_+kNQPzJHPT_|R&gZ3ey9?N5ET%hws{)Sr_7
zU_`0siKpZVA9^zQX&H7SrB0R``u<gx`p{#2cgWd{mW!&)3OsWwy@~S)^i1F9WvdUp
z0JP1A_V#^2erwQ}%maO2lp9v+aFe>-Cw58a&77XNCG(xWyW|K)%f(;1e*pA|LF*Gg
z=(}5vzD0*ypLn$IOLDeB^9P>pyGO1xXj|2{K=HR~%WYLZ_kCFw8}#^~(|uo&ml<?Z
z^0z?8eJCt<znp!W4mYa!bl(GVr9t~ji^KuB)u6W-9Wdw!qtlF5i?IWfau3M7RTK-M
ztlT%`d><N=`<C2m(7l6_at})9?b`C*L0P%)$?-lkDE9+-KO?;!JS6{SbZhc2$~`1c
z8uV1b6}d+w{h?`EXC3L&n)|VAFz7!OEAW@-7aH`3$}4k^$pZ$R8hB0aahZ3Q372<M
z?k92=qt&8!@s5;FW&0Y^>6Ol>auFjv0zQ@Z_;kI(K9yTF62~)c&;3juHRz)u*QR_X
z``pX1;KS!DQ%}ftgYJk(mM7$KgBC>(NjxDp+@~!+N?o0MLI&Tj(bcK<0yQyOB0fq8
zz~6?shmo$Alk#zG$)oC|e1;KLI>R2wJt<Ec^k&?{xu470KT({k#jh#ba=(zl4``Ho
z;f~yY%h?ZV^kMdkxnIc*1|8|XKleZKo^@K+Jm667ck;ABlgmEM{XzD7Nb4q-eU*Dg
zj_{$MbI;02J`~#TSNR7YO75rBG9T*QFF>vFp#lAZ)n9yQSidm!x(|)QkD5O7p-b^2
zD7oHBeOkYGmF7dU`X#9WKGcp6-(T!Q*Y@kC>U?Nrzn-eyht~AVR4aVw;eOd_gF$0*
zw&4#=|7g%Fy?6D?SC?(jslU?u?S4gSCnMcMhN>YCla6}NXZ?n%aXz##;{vrzBaxVU
zV@9buWYB||$+A@4wvoc=wk=hAHxXJTUdsNeU#UuagwX2X&r5&khu<~f-(s=4=hef1
z0xH%zF*_wVuR^sO)GIk6uTmW_C?h{9Z=||mGlg6w)~0sLyGYginb2x+YD9M4Xtm9t
zPlgocU95gI=y=A^yc!j~MOz*!8=f~t^)YCDRz==eHNv1TGA_y+r=}V7pCM!NE>*V~
zbiAxKZ=%|2(AKQq<xNtrGSYQ6MSaVN>TG)66g7S;rMFx(_1}{5J2l;)y_qd}m#g`V
zRts8f|6c9VI)q!CSEu41)8Vo&kiw;IFzDq$H|Dw2`;3-|DEugBhI;04vRop<@av};
zs`LpR?wR7-^Jb{&e<8F=q-1W%bE|I|EfFszZqJ*gUVWByOT_PTpUa!Aj_=Tx(W!g#
z{-A=N)4JZNujS2A0}Q%!z*~7uYPvyXDevbst49o)+5Iq3`%eEH*P_P1pkrxte45vy
z8X4(Y@~93*+An$3HH?;uGxFbg9<|({J41iSYgKm|6czbH-dy#dK?j|`<h7|s3_28g
zS*BOTzewpV6+<G^BidCrgO&sY<#(vw28{?ykC>+}GN>{zDE~?|j*-sGe07=8g$G6D
z&sW=Rx~tXmMmIUATlUrJRf7gbcgtR=hVIg-_loJ3y+}P`&|#o!RPt`E8xz|t`&xB9
zBT6qoELIyBeJm&7dD#+m+@SLEBA~r{DcllqO$6zVF#0&;k`Wa^pJ^ob4=3H1Mt3vo
zel)tb3RCl!sEIFAEFa5+qA9SvoRKc=64k(HskjCQj7!u(o9>V5sL{P0yd~q0>WY07
zi*CQA>JN-`EK8M_(NfXdk(s|#U2V|((9Ha0YN<irL}cb)r*5)^TdwXjx~7oa{N?IN
zo9=q`oY8$BR+xXi`p}?HBMb9yP-hH^jxNk!p^{&roawyWsCqG4D*6Ra&AL(bH)u-u
z(EOWJh0SuMsxi8%ptAgx>R$%^fD~?4fv-}WOGPiFaEr<{C@Q8f|5i2LpxE${`M0TU
zjC8%MQac&xysT0$8_QiW6Y^K7f7mQ<SI2CYx2w~}vO{hPy<MHL>F!X@{W>qZ1E=QS
zp(+^Z6z)_tM)yis0=_S_(x$sh-DPyA0u#ht>VQqRTD@;{LxK{-Y8CeyrJ&=yTctBv
zDt05>-D)NyUA}u%o6YhbMc=WZTDnSg%f3e~Hz+-Hdj1-9i$P(IZrS&$H3nS)-F<2u
zBOT}c>QP2I_50P+#&W1*cK-e9b(`)_>V2cTD{xE3pVY9w`E&h%s$#TM?1=Q_KcH@6
zq*HiM-EFgcP^~qVfnoFVA5>2oln|JizgF!tXldA{&~@r9gItlL10PZc4O%R^Wv^F9
z3|c9>Wp7ZQ8<dTjcvyXB(8~df@;9oV8R_zEQh^6_oxL8oEPs<qVWf4Bs4Szq6(jBu
zb=;=gtiCY1b-{b%HmmU0bu4qjaXP6EG1`Y87u<+HQ!xDvf4w}a8atsjMoY!Nf^+j9
zRoB^ckEvUX?mOrnQ|oNH$JL*W&Ks1Q|G0YIrrW0W8Qp&abMv>U4-7gUmYe^CI&ILw
z$lUxV)vva2e^J4I*JTKaT9yA7mB>i9*mjk{NY~4D)z4Vg2ju2&S0x5zgx#C}lq$7_
zds>aQg?n0EYAg>r*5^OXYYpo}p5A8DPce?9+#UU_4}F;O=lmT$^k&M_`OmAVwm4r<
zGfbTCU?zD%br|$(RC>gV>IO!-47=2wws5=DpN!=I`C|Sq^{_$DM7)^4TRm#f1L8pb
zOX?|u);r$G-=hu~6y^LNf3G@dP;S7{{Fl`sgPsrF8@Er%H~sDYiV9`4R4feqEdLeN
z&8B-*WgA_3$iMSnRV6mvepO*~Hv}He+pi`Wv?J_r-fODEphqJQ=lxCHWeayeJz#X3
zf_}(9pq{bmURS$~ZhP?h{MXe%o9+$uPop~<v^VYz^_5NccXh_-E)4!P|L-dNEr0pm
zR0)ihiZ_D-3*J<HY`V8pq0!wK6jAV&s<P?cR%48Abx?Z5+v;+g?j6-&bdLw_jeAG6
z*>nf_b6Di-o()=`e^9Nk>E2bhn{fR?e$9VZt+naiQ(KKLBqYAzJ(c*jzYHI!o{W|X
zZ}6viAE+5N-G^$9(FKK1jQvopVWfN3A@#7$@{oGWSk{WF*hA`ho9>@#pV9RW>QV4d
z^%Wx>%VBlaW_efzyhAx#igg11%7=<D=uQ=se?%oP(&3J(UX1kEJgRby<!f?p+)-6w
zv;0_%wOM|wrWnhS&fWzdt64VPG1Y2xComr!Q#aal$JHG+-EsA-P4|g<$)@{6owVsb
zRsS)%%Yzfdrz+y0zve$viHw#C(tW1NY`PQbBAf1nYW3*?#7VW1kzTERt_~PPtF_Nn
z&3lxBUaftu8X0{Y^6P~+W_+&ZYQ(Fx&((aRqt)8yiaz;8>$9bW{R=)<9~nfewa?Wt
zMpV}UK=k=xvZS@*DK)|%O8t~t_CD!!>ZjB?MmqIVYO_Y1`YE-|=qUA5>KUV>)K96P
z4|EEY`Y9E~NVoebmBvW7`ze*hXsM{g{C7$XH|RT6QgB+0GiY?^sDdxlG=u&bF|puF
z)o9SVsObg&R&xz{EqY?XSBm~v0rkQ8G1CjaR?7{#Ew-`XKk62PYMreG->6p%>W&rl
zx9V+!c17i7eWyM*=wx(b!T0Jv2HhP~mj8na{g6`7W%yCWF<L7A5ZhYtqZ(q<olzr<
zE-Sn&|BRYsQ17VO`TtcdjC8&Hq^`1s`$;V`mR{$T1wW~cK3!S<S@o_DN%6BfY%CKn
z+yAV-GN?R!S;jBwv485CsE9h4_^aA$(D>+U3WVcRgUVvADUgo;GSYcbj=;nI@+n6Y
zqow!)_jP!Ux|cz3g!GpV#{h$*+>#OCc)_4ALW1(?_kR-a%vx08ZCO8Gk=B`aoTJqe
zr}(<WZ+SAkGv7HBY0npmzR2ys8@m)%r%TkzkDqs#wDcFewY{HO_9W4~Wv|OcRCS8s
z+3u90UEZydBtNr!#Q@@GW_G22<eEvXAUW|$9P~*P-h(4~bYG(5Q=+34-ghQ`VXl@~
z)RJF&0ZE?gPn7b5zaf{eP#cjP>VkZdNTlV!o16HhwfHM2{-)wkzkNe0*=xxGXcb#p
z5{en$__W#76_JGG4!oyHaZ)IWH#bR663RJI&DRe1%klCP<V2PDwKv5;TD&D%MzpJ?
zGPS4esU{s9%K4k2C{EQ$tJ~;o9>w2_sjj8z+*iBGbsbtYNhRvc+jIC5m+RGGWaH=0
zm%|dItMD!`SrV@)Nur}2BD|C&{d34h=k|Z|x<`4?f(q}CQ=K$(9tLxZYr2s8;j`J)
ze=ez@RF;4`(Q47r67R`UiqB^26iI8Be3nI8Ex99^eiiq5AGYUSeNPhcx@C1uc1x!i
zp65KgIfS&)uvd5|kwYOBDNbT6DA5mPv}#z#;HOGlt6PV2MWu6a>71r?I=91+a|hm?
zr(Q>84}dm0I<Qk%ipL>7Ecd5X&m+;FXOxcfGnD%P<yntAhtLwTRLncfc%(Y9B#(0`
zOdBD$4!oOB`H4Yn0RlgKLmBN_om;Iv&b49JQYoykJqA%&T@R6vOYs@^XYv*JyLDA$
zNxmfjzX@P1=jt?%#B;SIM-2Zz+E}sa{80Q(&Q$>CihdhGDN;-6oLiJir0_N|l_HvZ
zg<qn}`~OX=d#v66=-zS(*Qe%nuNcEU|3hwH>b(x3d#sim8A?5w#*353OMvmK{+^@E
zxX>vs<hs>8UsG#Da6KS?%b#D)W8ANGh@C9a-d@Z1vClu3x7+x8wH32JPRmnS<B>|y
zbD%vZdYt;@kr=rOBbVfUONrl?=uldFE^ozYjb+M1SD#?nD7=OJf93sk=+6U%)%nR}
z|EXI_^SbQXlj}Tas^^Qv-Kkv7g;d^mM^HQ>MWIFBE$b?`hwa3(FPhBh>RvRVg67Kc
z1qwa?JMPKj3#gSfuWkD0Q2ayK|Co_(tDhNtsaB5+Ae&oxyy#NvJ{HAsMq{Kaah6vI
zcK!$Mx4NHb{sycH@Qx+-94&d9y_4oI<dv0OJ|ThXA&Gm1reWZfxQ0DErD)B$2e7WA
zK1TV}IXuvfYVQ)RfhC|cn^0_Jocg)+T5fkeTj^Ro!mZ%%&v-wbB}DPJVNrGmeg#Ew
zY6;Z|<|eKsJzg}`aq4(FQ>t4X1LfS$Q~WwC*(<SnFqKP7bZ^mhsCk;rty=vp$^YG6
zuc>HGMCrJFwPYsu5Z&&Y>RH=PA4BhwVhhhHf9JZQ9%aoh)mTS4MD>M!$>3Dt?GpQp
zb7eO5-p&$#SiNS`J(hTfxY0ISX~||@W7ute8QM99&hhI|x~JJg?SkjDN}+B3|B_s7
zn}2^R<^=AU_WZ2p{%@Cjbxyg?%^|JjoZ@9(McBi(qGg?;2S$B>ICPG7AI7X*i*InS
z&5zxvXTAj5dF4;FhrcS$t$ZnF4J9`5O8Ca%GzOc{SEa~+$Ivsc60vMa5+x?{*tGf>
zjo-ulEPExUaT#^kuGI1aIv&4eXSp7U;TWe%R20#edXMK^?HRsB{7SsSsn};{%8%mx
zf;9HDg2kQ-mJVYdja>}+YRawN`}6>>M2T%5q({1@+QZNr_EOZa&6V7HH64smZ=a#0
z7|SEEk;mW;9#dm^t+fUo(!p=wN|C^R^0#PGPl{8gtIMn7v{Sv7JD1W-fps$HLATCz
z?Dy<cYbUeE{*_k?2Qw&CFpr&cX&UGDT&iQZgyVmlORA|opPD~6tlh?*H_d;GnGw51
zo*(s!$WHBHe~W*JOK0Cz(TZ2E8_%~xT*ak0m-gfFt5dPpjF#(G{@>IZBiyDunzXOe
zp=R3p&*yqq$ToU5S<8JUp8JySfpfqs@e5n(80<Ch7MD@y&AwN%=lr*L-Rm^f?bT_;
z!YhrT+^@7;^Y+r|P<ocJ%k8|@uI1jM<+_LW<&mXl5c~M5<94K;hH=fj4mCDETMU<#
z_zp`Y{`6|42*mX;u61Iuh{d%AS0t{7ajnCtWGt>VxFT^qjBA|;5%dOK3}^tRV&Z#&
zhT=Cs-lAwx0-7MonN~Bsl<8EaE~br4=Q3TubP3Z{ps7fW;@r%V-Jm`3w_{22G1IR>
zv&E&7-khtJZk(r<OFBml7h6XR2Y&)j)yw5poRG$g;-WF4P!{7vbPepKNN1ZYEq9RQ
z363)lv_mvPa*HTt$$rs+cjNYp$=&aR<U~RT=!+F=MJa2mn4V!;%JR96p5;&DyDSuE
zDdG>1wVc)&egk}ggMLx8#1T5Yr>x=FY6a!FiY=!ZOKo#+a)118hqN`~<q^rSr*xM%
z9_TZOV<-i!uBwy`oK_R)G&$FC`S2N_Q&Mk)oO0XF+J&rLCf>^wYNaU8j92YU?=+$I
zkLa!LH~glui_~04xBMAunfOym2lyGo7lR%jL3IC!HK1!?vrN2=*!GLtbE$rEDqjJ=
zKlOFcTk-2Iyhq*rUGVLtAAz={f2>wH=xyCIVm@kezbH)pH*!L?v=aIJUb*;pH7@!1
zun5Nn&dFA$%h+Z+^E;U~h`m|Acg%H!md|$VMZG=fIDmTltK*>fyka=MhcmqD@8EyP
z_yBUMy}ca68posYhaGDi<MR(A6s5SvF_k3^_;SG-$71I5`w;&O^Vwy@-^Y9f%j=l`
zl<ikAU(E6sn4iw}8<?+V`R&XPW8TgD#XTra5A#i##Q%l)>B!X@$9(4JL%tckG(oI$
ztn72zvCdIk`5(s<^4HW~9P6Z`Te@?%+*s7dxnFJ^I>gyaMx#D=%fBX-Ip1Q*3Ym)f
ze@pfnFb0-6+<RXun&tc&HFK47i6dtCGUvzW;R)hvMV4of){V|Ha(vOBoNFA%dmna8
zm6OZXgWo({^N%8xXM1dSN>z~jn)7S56mhO`G=xx|FU`?5Z^8cYM9qKd3{kt%?-L=a
zy6Pu{s;&wMkZKshu5mmYe%P@>Rw2)896Mo8sTTz77bCkBL9(Jk$8cf58pry|!;byp
z+te`uG+sIa$Z~OjOD;|*LjU<Cljuzx&&3IplM`H@!?`AJ=6DumuR=W2IG^9Jwif(U
zIVR^`$YnXjKfG!a_*Rr+jYE|Zy^rmWDdGo*68&2Q(OaX4J`+uJW(?8rSfbZ3{SVXe
zXhEvIrx53@uq6KZfYaOqzvbS0T0GhNbU=-`uJWgVvrJ3m{rFR9o8?n|1_zeN>b~S3
zhGSfp$l*QEI^0rc9Cf|5-zW_%RBx15fR4`^9XM4{JC=aL->R8|X9q5kg~^`4{o<iy
zj6uk8o~iQFuL=BGtwoEJ$WwzqQclz)zI`akKg@M(Dq9`sgl`Ox;qaEjMLe|AWIEGu
z_NZCR=P{k@*jyPIR16;ejU`pg*D&8pR#&YHs%3tz<Mr;lgQhXxAZg4tF<-;u_iJ^{
zkb>ZLqovrS^N9hAgHh_L>w~GEuL|BROA<E*hd9raJsG@TtWErDaEKa?9u=ahGG7Q@
zh_LvAg&LE&Cs;Z!FWVoy&M{}u!Qf>a=R)~o=~>w9&-q^ULY(V@R<iv{mQ0mzWOsx#
zu-CnlOMNGobdBQ<?n^g=Qr#{KfuCXTclYoc<^3G<T*n<14?_N8#fu?J9E*D=%l#q)
ze;Iy_V>S1UjZ9B+e|VVt(njt-kF)#(mfz0uKe7BUdgcmAwSm~GehArMQfVMR?0he?
zSLjxj>=)JOtJ@{b1>5DWoZCaU%T+1&fKuD-<WhW%`o9XJY##fZN|a)WV`uM8p-UVy
zv$lpVa1JheB6P2bzd9!}Xn~`($4j9hipJC$$1pDYQy7(N9L3D%gRVqcuY@jeH1~KT
zbcM`^M_uE1A?vVXC)d~klefa;)1fZzZ;ggNmMOzrYC}OtSfgqwNCodL>IMFp%$%?V
z4oBXFVP|=UI?MCgL5}AT(-ltY)vK5uhXn6Wq6PbfuQ3wpw|Sx%9^eU)(`!e#Q{Iqr
zI)G;F1jyUVhT{uP)Q6XG{L2JsmvJil#eZ|sBlZh5BqPG9XdVpb+&UG_2;oLTd_42%
ztc_=Fx{;7Ji}^g(X0bMpCB-bsV@a`*kiFByLuJWgem~~Hu*g#IG;2RvnGso~j-<R2
zx?iNS$8H_$iL5c&<z;Ik_lpOs9*eAH3C*6zAt_A$GP0MvFiAyCWBC$CSy@rkesN}C
zMN|VznvDJD!)}0l>!7Vs?M5<f;OkKfnP0|qCDS{Z-p`aq+`Q;@sPkLI2ITGT=*?XJ
z`^9TT+oPXwCJ#S}nf)5H!aC7^_)pQ`)5#~lQc)!4I%!<cjIUz0a%|6X*kbYD5ydep
zWbTk*F=zA)<!tWlilI4fcFbm;xoD>Ah@ly6QOsLBD?K5-nF;6vhblJ3R69-#dNgJ`
z$2nCl%03yh#&HO9)*8oyJih+L<LhnEC)5uak+C~rDaB4jUzFIX=!+726@5!$ucGft
z>{ax}#Q~0Or=s^X4l+O2@nMe!yoo`rbDZ1pw4ycSw~9RES=0u3&Ks(}jQzmbh;QyJ
zaOyRiw<sy@W9NJ2-QrF<CzlV6t6>l0bWo_Tog>o|gwvr{boKdo^5V?sIVr9LVMhl(
z;m9p(k2~Xhr*c8uZuMl3KgP*`;k|E&+t2ymuii_%H7?vi-Ynih-?@l)#Kt`bO7Coh
zqvvB)tlp_O5qDDkGx1COU2yv1PafpcWK2Mh9+~kHKC^GU3;v;BIQh)Ukc`Q6gKokc
zS`5o4zz@ev{Wa$6Z{kbjZIwl$lw+u3TEn!K=`^MdOiSc5DMca#JiM{v+YwUqRhRYo
zIiZOq?QGNJh##7oxX?kKY8lr?lY>UzGOmpf$MS(g5*xV=dj;&SyeP46z^p#aiF2Jd
z^k@bDY3h}r%Tt#p76wo%w1&ASakEm$`DT@pSS0S}R5q*s;F|+W9N*=n%c=6i?1PC@
zWiI^u2539PR2iI|2U?abK_@YFGfieXx$GC%Pc92iA{xiE8`IuQ^O+7}I-Kc9rsF_g
z={<$%%p@t_NM8)P8gJ1{?$5O5A04>cxv9^#q>_MyK2IlYcZ@7~Iq3=H>R?hiO7uZe
zHJ59uT9}e9pKz?s{3^*MZ%qwJe#^NxDK+^C_16KBu}?Uz$L}+?Ba{@|9VZfAPWoEW
z>ZsarUqwjRPRIi=MlMY%0;N@VwIgE4mB~9{*&%jv&F|%!-^+D=5Rx(C5KGD(F=ffJ
z-0>%j*>cC1!-?JmzKZ>4x#QNMUnZC1kFt?`J-kyX%V`&|I#8lV{oPT@KK8hS=BDEg
zIXpm|Mt-KruhpRLH7PO5+2h)jsR28(u1oor<!71FD0>L<Q@wY<rUElmjJhfR1@JSv
z{SEY=N&f&HnRq<K#r3n3<KO9^xo-*Ta8sz$Nqo4Ib^-BD+6AOLX%~?0r1gKilg65q
z-=;55mGXy-m8s$ILJ~ge%)r}H+XaoL-OeouUnONhPJXzh+iXXk;d9DY2QK6BTa1{8
zV<$zalyWLnoJtj^Qp%|mGp%t_%NFw*qn5QLa^j$pv}qh?tq#T7&60LW4J>bBO1=8Q
zG@2JSrp?u(UObt;HEpY)dEo%|N3VpQX4=j(#X`t;q%CxkXItnb&$i4-HY*Vuc2!RD
zZwmtMO)iypvgA%ko{OV(*H>w@iu*C`e%NCsbsS0gUTsC35$P`ZOcBlRQ3DS<Xtn=k
z9Ie~GjB7$K`d(pminZAao{?9`n{x)FuaNiT3<A9}Cp&h9T#WCIZQ!zOWxAL5nBh*U
z=U{wy`l0k-?9MlV;(MQ<@!|>4Wbrg;Pu6C!HjnuM%onreP_`Vw@+y{(W_b<dvEplO
zFDd?F`5fp_xeK&Zz6?4-z6M$){|-7@9t5qCAApXRhe5Y<sAnYQ3Tr6PU6OLOS5mHC
zmB&E8V(quA{gLHo<q61z`U2Fc{sS7UegF+uXF;Qt?1s{*K+t3rhG#Q{D!N-NzE$)P
za@)al0n<fHS1^5wX^4YtRym2@#dHnRgaDGHFzwB>FVjM%gP4wFI)>@XppjyK0DYtX
zUFJUkuS7y%EOOE}khJ-M@!<aiK32p8ar{j4nSK#W5_iZ$={e#i)OmpjV;UzOEhxaZ
zbe{&z6z_ue6Nf<uisPWeL}dR0oFZKYdWmQOohYsby<FT5S}#5Tox{{CJ_UcZ_@;k7
zel|C_@R+zy+*|07_lfO=PPrawWrBacu##y#)1{#M3fD8;!}J(aha!0<(=0_{E19nc
z{d?h3(36F0)g3|(Sf{o?yH5Q@<QMK{emC<UGygI34GvD-N#z~kB>U-1>siv^B<*6B
zEM>`B=65kY%5;4Ih26vScmUZu1BosTB>CFF8S=IPBIr4>29)@vL2>9~j$leFlW8T>
zdZtU6u4lT3=`p5`5VmJp$+Vv7Ql{&f?qPb2sUwu_nN~8bXS$T>dZv4r9%JeVV|%9c
zOqViU&vXydV@w_4Y{|5q=~AZaneJhFjHx4nEtys_t!KKF>3XJnm>y&5h-7=Fl}ziI
zE@rxv>3XIcBB_S=Fn^4xBZ|W^tz=ryba7M|wFUEQnP1QRF6Q?zf0X%S%!_EUci@L-
zXdR}NOzW90WxAf}(P(PTW6V2Z$bNbZg<Z^aEz@00MJ&m8F<qR*{h>QadNLisbUM?;
zOxH5q#q=ms(Sz-oj$k^y2gS3jH`T)iri-(m69)$@&L+#X;8o#T=67Y2<x!?0hxqAC
zm*rE~U4>gfM-=}AI-Th*rbn5IK_u_VbOh54Lnzc<rp^-Lr(aAqi<ur}DlXwrOh+)C
z&U7);wM<0~+b|u$bUM?;OoMSkozm@Ud~x_~@d3VTyhA>$0vv-JqaE`c#~cC9%bYu%
zA348rMg?>W=o2t3V06I5fX4$~4hRTL2^<qRF|Z@>y1>nWp9G!?%n8a18WMC(&|N`W
zf}RNaDCkU3P;g{$QgBvqP4JZ9H-b+E2ZyW-c|GKC$gz+wL(Yc8hNj?89=;oTDD?Z#
z$gqO2s<5$PlftHj)rU2PT^V+D*s`!&!d?#hH0<lJU&2O&PYItBejxlzcuquV#GHtG
zBQ{6;8gX&t^vL;<cSLTAd?xap$grsFsFJAPN4cY}j=DYS!KhtPA4h#2^>b8UbaZrT
zbXN4V=o_OSjNTBvCHl4Kq?q!UTVw8wc_-%UnAq55v3JGZANx@3)3Li^kH?;g4U7wq
zi;K&Q>k~IBZfxA|;vR_mFfJiJExshaBL1TIG4b=_7sW4&zcv2B_-Eqx#J?SXJpSi+
zM?y$KR6;^RT0*ac?1a38?Fr8(3`-o5SerOC@rp!u;x&mkC*Gd;VB+J6A0_@L@rT6u
zNz0Q~C2danThigAlS$tuMJ4x2&Py&z9-3U1T$NmtJRx~{@*k6LOnx%?+vLiW2`OKv
zI8)<NQ&W4Twx!;k`f%#j)NfMHq^73zNgJOwIqmYa>1hknu1#B!_Eg%-X-Vll(tD@p
zrkAEKNneTYwMx-l;Q1?_%@(1xhvSR!l~^|{#xsf~SUCvMk#-}Vy2n@C0(yY?MZ<0f
z|9%3=r)S;=`eo@_(0ec3Kys!NE_~!Xyb>A0ffO@AmB>Px5-*4afY0VH)#rfXogzHt
zQ21VY7-)oyfK4Q*!Z#hGKsQSK=@apYj02sb=sWdORTAiQl>$0Lr6K>L9EG5x9RopY
z9D_i|I);Fbca(rma0~;jbqq%-A8{6f{@FPY^f6~S=r-pN&?lWGpxd35pieu8qb_#9
za*5ap%OzqLEb)s_SS}HJVTms|!E%Xs6_%5828&VR_sD;<xKnHtkBMLLjq_|-EiaWD
z<W~7#d|$eo8jd|>j$?$Q)^Uepi(`*tQNS$$2LnC|hzYzUaDU+2frkSB6BrOQDrkJr
z)S&vHXM;`zeH|o%OM>qU{wR1($kicthlGTBLvIXyAoS_be}&!`wk<3({A74cL`uZ?
z2v@|l5w}IW5%EdHcM-9XlOz8a`BG$BR83TC)YDP_i25d~U-Sjhmqag)4vl#xrhDwb
z*o$L-7rQccYwUs8gRzHVFN|9q_ek8gae?t6@tfmI6KWHh5|$;bNm!o{lo*qkomi0g
z=foEh_avT7+>o?0$&<V>`SIjK$)6+_rwmJ3nX)D&H1*QdX{obPx2Nt;J(PMZ^;BwH
zTK}{WX*1JW)9y|Cd)hzJj;5VRbEbRJ=cfz#f&OEIi|IL|LT{6}=-)GVW7DZwrfbqK
z!*jH*vUl)&udD1Rp3(_1LL}ljSfZ%FRf($#*GOEW(AzIUZy$}T8rQ|RF2PlU)$kZx
zV{whcH6G8^F2ywg*F^N%TJ+gTxF+M8g6lF|Q*r$cz4&tU;c2*jkLwCtbs|Sh$K?`z
z#0=37{kflLz~#m@6W1(UvvD=z`U9>xxSDV^<7&a>!PSauF0M9QUOHhD`S^ByKE4{7
zk59Jbi}_-JSb+84Rk*IkwGh`LT-V^b7T01tGh2e|kNA?`Qe4Y$T_=X(H`N#7JNFmj
zugu`J2>ip7op`$M#a;4!ALA27{<*n-W$s@265DyD4%Y!p;jc6JdUJmscZ%<MspEUm
z;1><vZ|puc_md{xlLntM_b<%--{$_cxqoBs-<f-e()o!o_c+`s{W$eB-jl#z^fB^5
z=3Zj%BhCF1-0Q?EVue^F>rk4TaN+D;Jt(HBb$l;Tb+|u_YZI=`xVGS0A$m9-6ayTm
z<p9S&5N3t=B%n_GfGaHU-*SCmo!Arjr3?#PA$|`0Rb~X8mU{wE%eJ7+;?|%D^+P~}
zDpCIs#lb5?Rd5|-4~kEMPsneBZ$h}u*a?hNVS$&zZj#y&G6na4h?BUV47n250$}7f
zv`#Dwy<5Ey8ll`Fr=>fj81iB@ENnCK5P|ShaBYUoB((`2SJ@d>hj`oMpzwA%EWAxV
z8vYNY)h73bN2qVY|1G}>4_5IJX^x7><uX2EnY=l&x8vr>W%6}g?vNE?a?~=|)QN9k
z|9WJdcs(*g-Hbcg3_xADLmq_gLC9B#;^--AfCFWVULht$@07Pi*P*Ufh`ljW)ay8b
zye9T2!bBjw(@5)4M|{LM@KbPo1stsY78k7E#Px1mv6Aus#?zHFM@>SSqak6O+7p=O
zSeURv+?Eglev*0=_fJrVp9G(lpP)WpPkhvQojfh6P3}zD<NP6DGum>6*p>Q?lge>0
zH3E72!Ab2_qE4fY9uya+MW|)i@h=PgH?H!467?(6JS|_r={EkZApUSvnYXU4Z~*T0
zb#+yZ-qt49g32bB*IPKC?mW_>^Gb`gw4|<%nTtJ*EoCzd=o+ujw6Ks8xX9gJ-ZrbF
z+1=7!-j2U%HKU{5O<{f7G4A%+o`$imX1CWb?;5GLE<*;2IMxYnSHrkgcbluFfdXk^
z*FaiYP+#BfX(OwF9JH%dv6dogW@;C-x+@k?b~rbt2$S7y-bN1>`n-|&<0zsKqg`#y
zo|Xlp8r@9|x>PJaUtQSLU2|5%fw<5n8{=K=^|N(_aj{7}s-vl?%I&RhYiw;dS>$j9
zR<U&~U0UB4b>To0_c^VkbH?hfIn#l<N{h5DYSN0+)Pv43$Hy9~V?XK|&G}O-rfhaK
zEh1@6Lw#MfRwHR<sG^&iY{^>Eb2G%6S?>0_aaXpWk*Qi)G;y}8&D}7u-PP_c_j=vU
zGny9obX~K-0jk{fO$ajC)z;{m(PTRFp!4OrP)n&ZGl$&zYD7!ACg2NDIM}q-xVFYw
zjV&%yM((Pt>Kal9;67vp<zDF<Z$;+~Hc(5EMP~eCh#_~waZL^9)+Vb*dD@y?zEMwk
z)3J5wg69<$4mn?q4b)O(hnY%G%RF~md#z_&M_YA^x4o^Sp1M9a-g(2HS6DcdlcHu|
z4$UyW%>$>>&cmN$)0(c8I?xx=3OLcz*6wbw4NnfuT3==_a-)N}n!09K$JM27d<hhm
zP$ow<H?~*0nwrMD+TfVl-R#b^s%zfPFCECyP&Z%(MXg%U;%aWJ*JH$TcdX=6VE9nO
zS=P1iwBFXnCU;w>Y;Y-c)Lja|Lhfl44T_)>GN7`}jd8^Zxf?oZMm4s1+dE0dxZ7s2
zFGeKDx7G12cV%TA+FFnPqlqSw3GQakJe`P@tnN3q7BGq~{u6OkdRiCMdW_n5|LT^R
zmSo~=Pe)Tjc|*g<`Sou0yEdgx*k5HPmg*L?zu~!<b^&^c?#FtnLJrvETroAB_B0Lt
z=>_K1=oP5bPBNRVu2OC<jvKC{@hW$9O{J$nyDCUWyS(Ks3v{bkmbNI&;Ar&On<USX
zoBY*y>RnBp+#%9Hm5pz6&upCUi-jZ}Z@XP&OVm~Ywk%C>dpnxiO<kIH=2$z6bhJh`
z#x=)X<#xAH%Nmh2+zsR!?;_LnHo=W$Q$1R*f%<YyLzAZ-_lfQLUen-en?-$mQcEjM
z&@^^t)z#s(yV>sgISZkfNeh9pLA2^Y=*E_Yx@uy0-Wp?xCKaAL!C~D)Qu0yEoxAQa
zYOHO*`TexU=QxLfR&>mup3imRq%m1DaTik{*mj*#we;K=*nU=*Db>U^h~oO~(Zgyg
zE+!xtc5O2)CH)Xm`&{dJ=K+)AP_{h3!(kmt_FL}Tp2lywZ%U_&_v3iAw}lo7{D!xM
zvK|A_=8$M1z#YZzF=6KOg5bL>QAKGNPX`lQPlWr0z*@3{?c&WK;URzC`5ekow9M%2
zD<D0`S3uTvBtwLv`~Bd#QwJ=n+%r06)p%yj(xVF!-mstx(x4*PrEammm~O;ArU;U;
zSO?R>3vBhs7Hl}$EHtjI!Hu<CCn0i$C4`r(N6v3;b9-rd4^Yl42{1g;TACJAdYYQt
zme7hA8w!}94rWhuw}Y#$Y4p;)a$;6#+0eQ=_yt#!mvY%$SH~6Dw4hK-s%~i?Si~`F
z&bR`+yURXd5?-aCPE&}VT6Aq>h|HigM#W@=>g_rxA)VD_=$R0MD8&C7dd6-D+5PXK
zWh_ff9)6>D!>ZB0I-_0<NsIeRTX**wDHR(^|HKdQ8;b;Jy7YHQI`?-7x^!|#P*>+4
z=Ft820D$s51E5HZ>S(E-jvG1l3GSI-P0uM3m$(;9b~SZi<<Zy%c~v9#9#`7}0Mmv8
zbwd}|fjLhb8uegO|8~|`-ORgZszumhVsXzmJk=;foqYuaoofn$E;R+oZ}$->&r=%%
zb!`l^s$d}Z^ufhePX|})L665>m*4dFYK<q*jpjrjGs!ZnE4C^M%y}xxs0WkX|Eee}
znsZ7E#c!7u%JY<#;=++iu`YD67*jRK6svBKm0K|9$*oZjCcFQYTVsc<5V$VQqlKPU
zYGr7DJM)9M5ef%ejR4MczQH<|gX_TjuWUf=ZgSJX4Hm*k4*0i|gYujb`%)ZY)eD$&
ztcvR(<pmNu1AyQ3Jy?AW(WMxQ8!w}Xsjr)0VP<$)HB^+kx-QRA2#Cu{L}`25JSq~n
zF`kBwCU=<_Uw+ZZx{;TStejLkvTnl2@+yG?06N4WZ{=#KcjM2klQ%Q$_$F8TOzd+Z
zwd|^N92ZS0pJ3Rr<0{K5M~~F<DHEz|M^=s-Q&BzENGKJSo}2i&Vo^1+V$wwdGi7y+
z7&oE%qUy2bHFaY~){Y)mRX4tTLird`J$7Pk`Pj;l266z);-ZmbM@}fOtsXbFu3~Ck
zRZUG@C6XsBCNA){yPFHD#|Z>S;U||*5EDjDoK#cGELY6fapjejBPUL@`p`sCG0R;C
z+QhVNCZ;>hVKYuljT`eT8Nh5(i?P&9izS)WZmBHBJ(n!oI9xjiB3g^*7{0QNsvcQ`
z0#6t@s`@h28_Hc*J+^A(WquLbk!p6_*qW)GYJR+dRwJ7Rfp{Ld>$*A=jwWv0W;Qj@
z&1>#hi4dgG;1amCyF|0M-qY69I0N0O-l{?WQo&omtHs88F$;5XwU>^O062cVZ4l^z
z6Wi*A7Z=+!@U60=tqlWijH|^p%iT~r8_U*)>INjzR9Dy7(%9bUYVrwrcTwqTp_Pij
z+Dp(WL4{|2^~|wucY|BwNi8#Ml8zP}{5H;Nfl_B|d?Plc4b-bDI%dwKRg$RoPWCi5
zh$?K-TJ&}jF2w6;nrA?%wFBp!_nf-A3RnG{#+F$;6^hca?kmr)sOHJ3t3BL-4#*xr
zSG}ouR21r;{g*lF6?8g-BVSS8+UmxQ%Al7F0-MTKSDU-jN<`=t#Q9`M_IzTj<~oaM
z17e!eB&6%Dv+O)871SRe2b$9j%BqgQMAJUoZ8#lxB8CgCSB+5Dz5%9e29c#<O}iL`
zGO;`NL#w5XWM-SE*$UawVz?@IyQibg9|p1b0qVm5v&*Z+Q1HpBn_F@0WejWwH&__6
z=QJ8?M{QtTGcQ@tuDqw_Mx-9&ZN&~7ZI0fA#W`4AF_!zaBK2X*8FRO<ba^pLVIhVt
z3|}q0?ztVBLE(T~J?$7)7(F@@-dfM3)>&<?2BhL?o`H^zvrO-7It&r003Xkr0Gt>=
z?6GdNVIw16<4ttUbd!%0SXQ+mje1l^v!@M*D3GD1&^^6g;xRraxLUyIwX5b4i)MIt
zhvic}tSephvvt^unmjXHP1fnNmXB;{sBW3(nS)f_H~_ZzCb!k$YV4;jG_X4hbOU-j
z3z3h`f_df;TU4WZFs`U)+ILl=-0R;>3Ab;zg&&{b36sam_EdRQo(>9H>oJV35_;e>
z8siums)7!*Otb0JMr>rXdi5I;8ihV=*&zOja6BBpVMgJIQrA0A>&A;&V_M6a^^LMZ
z{Z6pwVGfzGOnncfgzm1aZ$}20X{BQx<|r0xn6bdyRp2ov^*(cYV8Z~(S$8Xna`ULn
zXKdUlIy7>tU8}$riuL}rJ=#M*qF_0EJU_2sfNtqK(iT(z%u*gR_*<y>JmN;txiU3|
zW@a+1!g*pXT1HH1YixJdV3Z&mO*7fapx&!I5L6;Eh&yIbW`xaMGN#(8_8Mo&5+pIf
z-QLlL5$ChOu%#`wkx;F;u_E#7d4lj+o4J6o9?i_^X0ln)sAZ^qDYM3t`m8EkUTvd&
z4a+rKg~@&vm7j{Gi@^h)F|z0f#tE}x+)TbvHB>A>v3#NRY=BB*NdwOf7NXcIsY9{O
z_)e~57S#Jx-0N7T^EjokU5D`<LRU0-;5{kJGkhFH&!d~=gmeQiY~!|IwgT(vT93~N
zer$%j%?Eu?9#}#J9FK><ICEx9D-Yckc=p2*R1x2CvVxOZOEl8#Cn$$jS7#k%%bF)x
zP}fd2R%PhPT}+t`_wHY9fgj^)o5O{!aAP&@3t-R;Ei^4O5epv|x*oc#kE3+WnyV7|
zB&99~^$c!z>P8GI^di?v-sb5Fw9|u|Bgc<JB{2GQ39CHAOmOpY6Aqiq^8$8a=mK~a
z-+>S~f@)|)Q(M!XwRSPxP>ezDp!eeNUw2GVK5JGRcTuaBY)>rV_i(C)BejY)&z0<r
zX$8syTr;I*g>`jamQjS1EF3*O-{HXu+Xmm$dT~)lqYX`>XK#%&`5`A&j^ED5O`<8!
zhfHQ@PUtGLWzereP9`^c8#|d>{;jsL-5!g60^w=nLXE-12_NN;Xxt1eTTwQ@M9+Tg
z<F53y&G9SHT`N1h?Ve`8$g0B8jSUU%7QcMtd@LpCw9qfIa!0d|*{`3gqz6RwTofVk
zSVX^1;J2FSuJ3@CT`=C=*4)U4k$#;OJ@&;j8)tRkG0%BZw>`x2haJ`An&tIF-O3!n
z1b35bK65s`l@!Ke10JgS16m4tdV&dUwoQe)v&ORDp8Z96TbpZvU*?YkYl;?|!VGi2
zrJ4SD@zLHmqp=A!<JY>Z_ejLViUsJpw9sIN=PBlBT(gVjiBogPC%KjeAJQ(4+C_`7
z^P!C(4|^;DHNcogK+R)0tQkl!tGF;GHJ-=eD%xoCD`<hP_rGT17~j?i|JVqr@kA`2
zh%<GXarxeGCEq4uWbt7;#*Ej;TZd4h%2Pd4)W8YwUTPe8eQxF^4#T(^u6-sZbRRnl
z)llu_smStMdiw~+BPQDBa!YF}zQFWPGPArV-rWJRp0NtbLQA`T;3_6|%)rx2(zke8
zM$X4!IPnd-im)H`wEKjntqbVUW9tH)fUBX#1AD#9AdUtSmaZrj_8S6o%1DfD<iz(t
z*YbHhP153<CP|ds(|RRy$p3=T=%&Ke)a1F6_9omR$Gg1V_StQo4rn^`2B6kc18?VT
zHzl?fXS4-ipNQ9$m>=V6pDk#?gd}H+CeJLsQw8(n$_TAF%F~304UA|-!Yy6nZkc6R
zy>xA}NzlIxYSLztS}?k4YDaNgZS7uWtrq|qMQfv&)Yd4P<~5=T8rwZH{vfa}q+3Os
z+cgI(!38b#^rU45Hc|qQAvD9g1zu(FbSbcp@J&Tp!WO?RLz7^(x0#Nj?r+ERoTzDm
zmdv2#2RbqDfw_WEWylOo*xuQ=Q{!OqFx%BKmb_vUb}CnP!q&3c?DcD0Gu%yxkPam@
zPgB3<@Yn}BbBtv_gc&#E540o0BxO@$)7nBuEG)&E2Yd}C=O%R5c2^^ErZ=x>LVl8K
zb*}QJCbQE7GsleuY}3G^f(C#AR+lDF)6jzDy`ZHxw#Q8ZkG3)NJuM83!y!4QeXrLN
zV#A1m<aRZSR!Wt-Dp)MSwFklR9Q!d$cg+Gz@n*q`U>an))X20KkDX_s(%NS?WBJk8
zjB_0LTUzK~BBfmu4v_}d)zKLMM`|5l>J)f8XAbK`1rGHlwTKEnsDqGB=OENK52jRC
z3%0{`7a_;A07M%iv6{wqOwH(4jes=`?bxEW2y|&`zba3&tFeVsGK(!Ep{J6f-lJ9H
zCYmwGh8E9@O#h52T=nf8zWI~<r)7xwla9_TX!iGAhPRlfCti5b<{1qx|D!*%?4yBW
z6S{qm202gEk*P7!Rmj6>-t2x^Zu+3!xHn#<4UEuot(K41O73Pf1$7o%%K`mRi3&~0
zS~2PU5=nUa@ppN8_GCkt#py_b46AGC;KaNrMb$=2H@m353vNW0Xc#xsZqjIfcZuS#
zE6t(3UDRkx5sloy1A)TXHiSH)wF2h`nxRHO*X9^;G=SWb8|y5Y(%3Sv$mgvDW|)Z`
zt#llP=e*VuTa2NVlsTC^N2=HPela~i_8lPk#n#ehTu1x3nS5Gf)8Xi7R)?p<i^-vW
zwoPvB;t{1y+S=MgOMDc_FT`~0xzglQy9d7x^B&fVer#pMFLC>d+T|@!awHg=Em$(}
zEaqx+*AhoBHBk%jmYTYqKK)=0VqGVUX!i2ptO+LUzpWQ}SYq}{%ui}<fE)1jV~X7m
zkd6A;Y-YwK^XGqzgds><PPSkdNH4lELQl|r*Q4>sc^K%dv6hq!C}nfn!MN29aD0xU
zv@&H+*zOS%=QOtJRma60&8_HVEu*n^W1hl_s*YA`I;bSC2Uy{rYYjsjh|I;L3s>%T
zwc#;u8-^Nrayp21fvcPiv7TU<H47<SO5<;=7mEz6@HF7qz=airfODlAH&jJOBdsbd
zBMb34mZhVmt;N&c+2S#=U<g=<o6-WlO11>HdbUJX1zQ-i7N0Fycw(!&9!ple?BPj@
z&JmE;PX5fuXlbsWGl)@59p2f7N4ptr20w(rH1B&SMDy6mn!<C}0`lb@^Efu6K0UfP
z0W3B!N1HJEkQ8;vD`z@9HOsJ0N6a`KrlHwcg{+|yc9vlmV3WbZQsayl8-MejBnBJK
zpZt*gs}1V4tW97R5jIJ?KQI!3|M509xXCx7U~s2ctl)h@bP&8S$!`)0552)Ge8(K4
z-Ay?86MB43X>;M33F@t_kroM<CFooi0==a2Ri|%_<CoOVZq%!18jpH-o3~I!J5+Uu
z#|3Wzo$oZJd?rCtBn@0F!b*(xLQv`j4=?%KM6G*%yJ1Jtp%S|&ykS8NV$PXRWSkR2
zRe@Jw^?RHEs0YmGByL9IvbF_pT4>KnSf7;fDAH|-APsJ;xD7%_!J|t%sHAj^KsPnl
z2}M@p!P7X*iu@=5X`mO<a;?on=k|bb8iupIC}g<{|GeybI#^(tVToq_W}txjjcpb!
z!=uD@bJz~2@_&uZEEV($`2P@xEhk+PZ1+^xm_s2XkIdNNEPkh%@<l6^dF1v4|L_2m
zydmvjaBgLDEa-6h!B}S*t?TWQS-f+#OOUc1a=*6=>iv_17~`R>5xNJ~go0kX8sCoA
z!G&kKpu8{<bc}#y9mY&!z1OPOsz%qW7Q8n~BBW?#mOGGF=<_D?k}Y>q{)LCt(~T8P
zvxc3i^;DXXO|Dii-ga)pQpW2>ZX3L!oL=ch7qVW0<}}ZhSh>*CGaH@zDidV~@!4!F
z)^aV_OIuUCSGavgwqD(h&w2lkA~Zp*n3{P};HxZaNs9`0W4?sTpVx>1VAZ9i)`w2+
zHlN-%Jbe=EUom_7mS0}DwN7sxV#7n@!b|&knx8e$M|7CpXfx*(*w@v~z!X#GX{AB#
z7427gSm5<Z%p6<+*NR&AVwvPS5YW|bYXL9qs{AiR>%AGmpjvzxZ7}mAUW(@W*Rvxb
zGf^6a)q?O9^fZQ~rZ3qfh}eeUOe|9q+FF94@yrp6UxJp^2N8ae3Ds%!=Eb`X=JzR-
zU+$%}SLNL6R@Ttke*2~YpOwj?{*45mh;U#&RAtWp^oE-e9<#ow0|!;Jtfwth?U*uX
z#p1;jZ9Qk`V$E}!w(;;A_AZPSGt+3XZ{pDq<<SiKc?Z9?#0iXSZf#$n6;w&S#WT;^
z$dx{T_wokMcg9G0!JB<HtSiSRpeSun>uE=C6Cz7pj+MRssoQ4fE0|4&u-1a#CUse7
zpI#h?>0?i?wZf<6l~=E4HA}B`u&l93-)AtQYT%6{h2;6uHs7GfH%#)qCSuHZ!R&u|
z#7O7SsVAJ6|CN4vjKMGRv(S30A5Y)S`~6(Wd?bx&92-LH&FFj@i^X=TIeyuUS7BOQ
zT2@?FM{5i`Vs7ArC9i(4<<+N281m-fs#lDhi(>)QE-o1J!4RzIWQfKwzmHH*i^B`A
zFpqdO;8Cwx{rFw;dQs!$!xpY3T5b6v(rxW~5J0^ivxp0OJ@aUQTwwDIk6qxO{ySOm
zt5>v>DDWRU_#7xLiwY*VXLaC*W#>^_hXe)VeGd)bcTDGJKS1jzUu^yy7>`fyuxbnH
zO7=d$i=<8h?g3V9chZ<HRO>O7&`H_p$iUa#&iUaM`JztY@QAw;=Hwgw=Lv`kGXafW
z>cD(RfG%L|hC2`KaqK;)%y=~CvmqyH9>r0<8t^=mh7`Y(g8gY*J54iQ;q|kvZM49l
zANYAiv)Ofc=~16q@ngQR@ifTvPYQ*Z2laZKU8Fw{6~j0BS!YA7mcKI|6SFLvShEQV
zZ|#d&-U(NG`HT@2<!#4`%j*>lyhX(uVmy9zch`On^O=EWK3ib+ca{<2Fl<vR#(Nvq
zyF$;|82^?_GVhj9V{%_;thXE(DvVbSe%wyp({xqSG-fO5m%4m<cE<b&fhG((m@t5x
zuwkjft8rT1(tt;v>}YTpMomf&4a(ce)#31k9wy*Wh4P4lcKt>j9>g^0g)$y*7zV+3
zVlt4=v%Lm*c(FpyPq1deDLgd`aZRl=o3M()1WBiEVsc{}9aUOzW)sfoEr2J+I6$P(
zcsGzv<&e*IVKQ$W%~n^zFA6*aK+&u<m2D9Fb`MzT!b^BzM0H?xqvK}Iv?TiI-X_2^
z2ZKD?3TM1@q6;5`6RJkaRTX|-ibR2ZNu!gPUqTen;|L5l5F86*$4M{YjBCSIlAZ}r
z-Et4}OGawfUXEYySw{32%a3?9?}xQ04#iYmPERuoK(vNy(^~DdP;K;j3YvlUX?l~7
zOquP%|I^<2hsbfBdH${H?x~)hnVRVyjV0OLayfRebe80iBL7h0#E~s|EmpF<_Sole
z@yW8(vbEN)lVq)Q@j{hu&7C2J9k4-$%v}uYWdkeNVK3YU*05e~zzg~#hBdc=TZq8{
z1$10|?7|A-yZd~fx8CZW(b!4$&*P-&s<+-B&-=X3@As{$w+@oe@(Yh%F>}LGu&`n}
zt^k3%Am@&rK6%2@UND061)ot}2Vq=|5v8;bGvxE9bL9&7uM20zMD7b(hbf%I;R~w$
zM#xH_enVI*5dIYqhLIkw`oK4~A2@KxFX@|D+q4|N#N=F&_)AZoJbBg~IIW|%=@L6{
z8|=OrdU=LO+x!GfR^rTAyLsxE1M2bH-7Mmx@OpK}ucBB#d(W`aqWgQCPLbM=^>_?F
z9QY-lT;7wiq+d%^Cb7>s_sWUm{@Gm_b~z_^#-2c&JAJOa!K9S#!svYVq>g^+!mdr%
zmGUBPd0er0dVw2chTvnI_a8j(jvhYm5k{=f``bg75*01xm%N`xt^FD51X=bON3EFX
zf=X2gSDH(nlOl`@I#6Eu*p6qtj;Kscd{`ISlvic26$;DP&*65smBz!!&R)lQ=z{pQ
zci%4VPV<C@9uyGBxsz4$N$G63)}XkdW!03{Lg|3vcBO1Ae(4{SdYNA-ja8`h@aYSu
z&YtAa&r>g5fMd28cJzV~GPu5SNvsSLtK6Z-YpOh0Tc!7&DMw!A94yyLxhE@A^*C>n
zSw{myYFS2=157kakHW*>7pj|z7+97vwW0vi2QRSt=L@joVSr(-&5YWfAh0NUYc<h6
zvz2(8g)w3P3;C2}=EZU~p4m=%3@AMC_6YZzR3w+6u$uKkrT3oTsak&(m|U(V21-`w
z1bX91bYJE1(>4pM)_%eqQY@^}<^!s$Q-1n;L0jQmILNL-FS47^adsp+!OlX@uu~Ds
zI2_M%JW1Xec0f90sk7uBEpv{ObDB08zhnGDd(}S6jz$Nmml>>K=yU8-bc)(%_!i`^
z)3Y1f2aFf250~s=r=<hVjXgw<C&B4uZ4uST*mKD>Hq)D{J;#sp#0ymodP;V&v(aIC
zeAMs}<|n{oH*Y^YqVJ>dU-+vHG`VfHTKj2p7%FL`uD4o^Ffuo>7wG4x|FY^9qjL~L
zWI9_8J!6ZeS+-}&=<*f1K1=E_H4Xt>BvD;YJRx<;+64xv_Gwxj;w<uKY$_#UtBq&T
zjWvz~?E>W@Vg@`h_Z)d=xfapHP^C|EJ_ruVQ>~MhtDgGcw|egCtvzO^z*8hW3TB%e
z`@elzgb{ukorKHd@Hn-8mp;@J%w4-1Y=sH8<H`FiN><B%s>*+ax`H}PcHq?bwKcZG
zz!6mi-%TvLy7hK8?Yf=uE@!Alb(qcX+>Azjj<%=i!7Br~YnAH-aG)gQ-yWbnMNi_S
zr(DK1U!vx5TCLue{K?RE7p=Iy^8!@R|1E4pwx6Q}ID^wKLCNF%-wH-&Ty(oI74Jn;
z9v!gOp3^5xT#q^TwWlfRvq_i~FYr@pE81kVIl|HNMJgppJq^4=)L1F%`^l5MNf}VO
zG2cq#bd$^J<eq+b8BRx_U+7PAdx$>z)KFWEOY{ngDQtX>Bro7*y*&PTP;Z1F9(d@>
zF%v(I(koA;IQQT`2i{Qo6(;4WA-ug57}j?_ikW#5K0eNta^FJApWu3qt>_*ly$xRa
zpPLC%@Py%h2xu~9s;{x=+KuiuD0`gSwFjPxOR^DOI)`O#xl9l1p4wz=W9Mr6p_yxk
zdl1bZLh|^k8XK2Mlh`wD)9N+6B|Bi8<1<K(n$yEIeYxXJxRdlapqtVskxwrX8e4`F
zl3kKidaELvc)m<aUSu65^HAhL5ATdwLeXd#vfAldGB4>-YDN3sTF&(ssVNL3k%D>5
zt_E5wWA61#PA<qlc+7||(iNXCJ0a|3&rcexjJ~~2E_a}^@Ukqjw;r<B4vpCD^rJhq
z3hW!HHfTrBYgfYu9&h;)y#-8$VR+iC9F@4P60hAnBEneQZOWBpKWd!vzGB!OxVCBx
z)6h*SXUIk*x<;bz^j3Yi^&_;Djg-_%D$LQ2on(7M@$oda+<PvMfqbbO8;sr6`1aZg
zi!*HL<=8!cj~Fybnb(5DlnlI$eDW}dp<Vu;L_ANZ<tnw6{HGb7lu7J7!cpc`D5|^V
zpaMZ<^dy!NBQN;B2lQk7_XwUv0Og8(4Z;2*6j9#&%Y}KlVO`l)>^VhW-n<J#xni%5
zCcKlwOhKe}uI^kUoZcWw$wY}Kfh7f1Z1q*HU3;alxEdcK><x!Hq6yEvLM^!_T<H2?
znmq<QU1us;J6tl<q9+AhJ;J0_jZb|3wpS<bl7p%bLz9E?uJLGTNW>qhiFZ^(hUXS3
zm>>5_{<>R-13K@5gXk-eag)oX$9-o%V;dNgK`<EF-iVXvo3WQ@pp5YLoZMPbQLZG=
zXFHr2?j^K~?vw%v{=<w?q0EV8^}Ir$^cZum(np}Nutj-C4;Yn5%}APpyoNr-L*M3x
zk{X|c-Sjm^aL`Pjq+YSTRDIZlpYigu?el8-;8fTv#F8s7TkQQJO$hoY^Ws%MaQHE_
zcpv`<A-bD*3i^n93c=mv@D&<&_e#lLT}P?_?3UfYc>%qC5x2i$wlTWZj2&Ux*r1kc
zJRn!PZMnn@%2z_EVBGpJGznpq52T0r?|KJ}<C<28`n-|DFUa6(W?6l5=Le`f9!*V+
z+}(1c`Q8gvMNc;xsOj>5r#SiBSn#`S_V5g#hU4ge#VlwGAF15RR=K{$!=>+)0hBqA
z<<|!k<zfB2<O#0BoZ`1By@06uiPj0~2Z#rOd&Hndx5~&4BFnA7ISCuK0`)vUm)s7H
z7^}v!j_;99C{B9{A7ln>;t9h;u>@Xu@(Ef>B+BcVIm1g{G7uBe<gbeo!;W1+nj}_q
z43h}i%hmFI;H$t$!KtLm&%gOfCmn}SUA|_RZ(jPm2T^@FJEU~aa&7P-k)R$2m%#IZ
zom1$s5>E)T{}2QmOf6QopMJcr05^l(M@#5p-SXbteaoTAcdE{Cdp{jnj-$IXSfpQ}
zX^oA*a%~BodQ!kF|Kx57f%S5YQqQg(CKzGDhUA9onq?k?<69t2F#O(WWiUx((TvKo
zR&o~R+3H+#druG@RqD^jETteowFhv0wEBYOo^#Q*FY4PnmVmHU0ci0xNvKR#m|ZKR
z7$&4&no%VF3jMwa9>SuJw7cFH^%jkW0Lb04T0M_>1R*8513`5&H}+2maEl23vKbT^
z@x!bRRPY--jqlv88;yQ4Hxf7>0gC><wwu|9i_zTTs|f85)>2Gg*ZbMVcbHB6KBe33
zsEx4QHea$2c;bxcB9W7O_qEl2S&Q~YC?rm+Z(-;r_R&JFnGd~UFGO>P@s@QW7Oj1U
z;6-aXck_QRw=PR3w_3j;aBy5p9W~Fe*mgqKk{IQ<wl9^)OR2Rabt7ciwGby`ckc8f
ze7I~A#uY}T^Dresy`vQcR@T(DDC>4Ehy1HssO3Fs*_Qc|d>vpE;-YISH1O#c8R<(<
zHLRl;RV{QF<S00imO+z-aX8tFn<ntUTJI>K4a>KiJZ?dCpo_a}Km86&op?VmWj@TR
zob-CX3LzcQOiAly!XE0EYXpNCR4{_VM)fYxhipJF(8D-kLRkUagIAfuhwLXchktpT
z#YakNEu`itB!QQ^z|99tvJzic>78;V()6(67v}gfkw+-;##14>97NDQIT=wsm{mW&
zl&&k-R{ku%E&QULl7j(71};L9zgo{BWO9k;l3Tl%5s8Kxv-<GioSWczaAe-|-`zfI
z^SXf_mVsU#54ee8s<|4$JHfVWruVnQmJ-@LzMNaKIbSl4DV)`W%?IyaLeKr&U3r2Q
zg3>{-XOi``Cs!>C96bdT(c|-Q8O-;!+8Xpc1la+K9HaOoD2jxHwd}v>=0|VVptn5I
zSTS-|7Y0)WSplt?_zCE*Gg{a7`YaB3+vi3r9oV+|N?|DXUTk=><wnCQiEGGOyF@nj
zMf}MloWuIgN~h}@CVivQOi8Z0>t8|xg)T3G)#vwSochXe-96AkRJ{?i0e_K}`!ueX
z`T6w(1z*2byXjf{i|8dkGix5jjfS@F-Hmtux4V!2<k3I>#`pf$Crj`AmF_%5^(=~-
z4G!%YC1V{@yWV5R=j`~3j-5UY;*pt7{x?y#p1ElO=<527sEf<Bf@!&$PX10}SDiVX
z--vW>7hjIr*44D@B+Z%5aUjNVv(s-+wWs1n7Ds6cG-U(5(+5y*+5zBr)XrbCb0@z#
zH5En5+Mxd4;M8cTxSr6-ND_DEI&)u6##AFs)0uYux=Q(LS{eZS#qGRE8&*entJ1Xd
z6{yLmn*36}>;j0Y9SCwcqRbwr8W*a<Wr^B+3yj{2JNdQFoJP}Kck@&ndn`fOkhK~c
z+=eJ=`HJ-xc(-j#p@IgLB(+Xa?{-DLx8k%rG1Dpb*V9gZg}?5DNw-rpo6T}GvHo@A
zCNu>`moAS-T|2Cjs~R@+E<9~cJ0Q~o)vcdq7RS?WYC2NK@6mjEDvCW^Blvsq1{c>_
z@Y~8o%Qe)fm|?k8fhj_cB62jK^3-f)h92Z@uDhYMtTYBWLZ7!K<DGn=)7SrQC!a^O
zx&hfv{%$9K+vIH_afnU3SYl9}J_77|oqnP;XFk-^?es^u%IDJr&P==MXe5if-Cj3A
zWcolEQHy*juyBdi;t*$H0$2O7Sk-S)znC)OLZad}vc{CPMp>OXDl0FaZ=o=jhQb5x
z(or|5BXB>I2=YhrM`cnc<Q6vgqA`=qAHt65Xl$s7&;L=CAKLTTp|YiPGpdgOrU`2K
zN1a@s^6L~Ij%8f_gq(Kqk&)xW^rocQ&i}rXf85D`CIWQwpEnuoSXLu1RZ%}x`e*Ip
z@7u*Z)TCk5E<R4PI(1XBjm9l16+dgXi=U$pjZS{OlYiF9FUOsiI;wcRUF_-<|AXee
zcCkmOT9xajW8F@cM1n*I1`J{wS1*skEQUc{>oqUL(&8UG{fPvi2!s0QJnvZ>SGDI`
zs83lIGK)ql8R@0XH10ef8v;e6Q#5=EpwTjrhX)W2H!v;vXX9BTN&|Ma1g$7>>&x_<
z628UgZBiQ>x6$&Htea_PdFY%<TwR7EjeFgR0mNc7jwd4^c8X237|&{c*rGQdm6C||
z8%eF%j3vHMq+XtzX@Wi#?I`6q5y^h)B53EObVO2oDfQxrCStT(l*?LEA8Vb|z|GY4
z638RN`K6mo^cOnC3<hTr^+T|V^`0dk*+6GdDXbt;MFB1YOPGM=t80>^Q}h`7``D)U
zX-wyfUbWsgjxL%+3a0Vw{ia=iAEK3=FOH)vmANpyK3k7K6=u+YX4YD06<O!Jl`jSp
zy;u!fCd>5jk}>c5aty^CanSC?&UqUm=Tf`Ro1q&rR%Ym=@#n?f^R2{Na5{$KonoUY
zY6^+eCl;C!g+2`pWkEkf!<1Y###&L8p27|oxpQcgck=JsSn@IW5%NtoCFS!riupuH
z;MXK%@5O1nel-JXh>xQl#SY*KcEBqyNt_!s9xz$C4Uy4!z8M=Mz$3S|yUVttzDuq!
zti7(;z;z`V*O4nS>Wo<oXm3m=(J^ec=@%&s&WGN{NDGWykg?aml}6nuuZvXA7f{vG
z=%|OcxS*CS(ZvRu*S<Ka;G`?TDH<v1E-nlZ-MS;&NQ6|$j4uR1Sn!g)&`fH*2JqhW
zY!_4%;NpZC(QhXkI>i$R>}Q7S$2}=wv58247XKuQlk_~fD!cU=gHXs|258=rR8SqC
zYY~Qq+9|g9{^x^`6r0cjY6gj&ml`7|TUtqiNx&?mamn4(2M-t918p$2D|o24h&tp}
zdX=V3CF8RG>em00*zSWUz0N*~@xCTXv=8tx)QZz_DeAX<hWU3q+`f1usT&4K15BFn
zDDu^$3qCrQY>c7nQV)TaiC790z+Wsi3F06N7JuG%&43yu7DCC;qGSFAzASmWw3M3A
zFO`BR=S^TBrV`wg)LeqmvACT!g?Y`Br=}pJMn*G59;RuAG{xyu)1>+NSkh1&4&BYm
zHGp1<IhA2AwsneodJPf3b8(kqStLUF_oyg;6Oc6D2|5vCil9+zJV8RPq?lmFOXp2c
z;<JxIKQ39v#~>kWKjlwnJsRgHa6F=!ClI~^t5<LKFrabO{@S=2zUs+4uQ))F<R$)^
zX2D4eWzL7p`K*kj^ZBxAc|uGfImcGg=yHBD?wlV_Y6=eV0%+D9$(WB6sZ){~v%CnC
zRM|rbM)@;uiB#SIn^`jhJ8nuwf#79cMQX>t>15=F>|M#)s$*%7O$F2yp%+~er~4e=
zZC=@uL1LVK9|*XEPUl;l;(`y-?gvIU8TA$m|6rin$WQ1ch{1KQjn~&EV<yL4#6djS
z5D9Or8{d*_p>AZrdXTHbxBi-BbXjeyI-L+ho89+T4&F703T3qVRY9fojiKraHDns1
zmDQuFIu<^W0@y^0xc(0DSe@AsF<h(?q!CA0ws@1}h2E<Qla?B^^qmOCn7rzD6`v5(
zLC}60tFpvyfiptVzxDIxFIHYoViptukBDmaR}#Cw!7&QUf`$r%nm7=J=(|RxX~-iH
zneVSpQigz|)V6_T8_X!A(IS^LxKNbn+h5YvpnYWRqbbZ<KCcjyQOFvVdQYqAjHq;8
z?FVrvD5-j<KPhwgJvH&oD!}<XWa{C4tN>Gh*4A*9rXYk-3@M)%P9^2$y<uaTfgi^v
z#w~f`@B3sJZGPR9{g1q~U-wWHAzSvJlp1Uoe`*&RJv|k~-JvIh$SVAquh8%n8bcKt
zxOAf6>u^?y;y;rJ%qg?}LRl*NOAXIbe<f5c^<PC{5nuc>)R{z~{v1m%cwvQ?oI(cC
zgfgOZy$FiemQQ8MdKr2Z{{g0M@O*3-AFDjrKD8mDsm+YDi23KVt0y=)JQ9;oMxr?c
zliV3`v7Ai!>4=y;n`E8h10=Ys${Gt;o|4!xTTIg~=XXVh9uvMMt}RC18Ag-Pnp3Yk
z4kkqnY;AU(jLBLXT{U}@jlkst^|NNotWlF@dGX@sw<crErD*mcj%Bz-{&Q8oJVKD%
zzSt+4uV!7EeyV=j)<A6f6ec}#*!_;g<qGKh4vO$Jq_>EnQ@q=<h~08aKTtePq5Oa)
zO#U~`Bx6z*g)chUFJ{gFFy<BAWE}b64+8nWcJVC{OH^aUV;w$_u74~Os36m)M$%Dc
z71)JoG@8u6rMRhi#@}lCfM3?qiOSJ<$dhu7I24Pul#KOLacx6b{7{1Y4FJHxirZ3?
zPVsj!t1M=D`ie%OInxOli_xTxZKi%{8%=)X&m<_$uw^X@Y%OTAbrawyM~L3W+5D?5
zK(wZ!un2+TP)*edZq(BThf}V_BQ;K}9mG+s$;1>BEE$X^lM%Vn;yLqmS^|Qc&k;V$
z^=SlzyTx-pc2Y<p>7SxmBkf^f59-jDkye;Q@w!&i)uVO2Mw3pMG#->y;S<!HsA$1G
z>oHyFptnaF%TGbJ<=LQIqyJA8^~g`<^NR4ksl#p^9-WYBe?=8lsEOCb*KGPV53KwH
zDc1<XPF=o3Jnayu;`ga3>6Zo0uOvysG)V|ve0?%&bh{E8Ch&wpucM9fm3T|61A({L
zL7wTzl{9M*lKa}!oytb4OKUtL!`N4Vq#lV*%md|DATzf63Rc4kFx@ug`oJ?2q&H}=
zLQYFCIXa>hzC`1|;P^Ie10kJNR6z-1Y!$+##WBPU#RZMCxN661cKn4M|G|#`WXE4J
zye^VR(A1oS8yClcY-S-}EIp-sy+u=+SE$z&`Pa+*>&x>CTmHlCv9M!uU&s%cE-O)5
zQ;@Dw-mNUAGK5Sk<MhE~edpp-r+CdHw1BW8g)nl)=IUiwwjf_V9HA{D)e^*(r-bUO
z51YU;kM@)11wT7_!)8ZFj3Rz!w;s*{hN1;!nhmKcay#xCMA18&`bl9%MpTO1uJe^=
z<~8+ks*T4Z7+u(RaVNHS9O0*6f`SPyC%9A_(ONd&mRP%p2D1+gR~pytM2Oed1V-~G
zrZGLvo<1Z*A3Gr;oF|f`oqxigw2t|Wg@Rfn=1P*sl!VB@)>w*7EJ-S5@O%;o*lA_j
zav|sO^4jJMTu+qOBNdp}%bXSqV`|wh-mujo486bfOIwJLY~CCT)#gOrB0yl(>@EJ9
z9U{$GuH;&op;2-L#vEf)#szC-YYlC}0WKrhWZKuxe__k_EoLUsD63s9O)R09oG8?-
zIoDj1G?9;82pNhdUBd%tVTTila9pQG;*{l#Ov2zM8i|rmHVDt+NvsyfR?Bk4URAKG
zW@|z=>z5WAfpE%<sdyLjM~KP4Qjo3<JlQ)?0@r*kzJ&nSOV>3ndvJX~f~q9$H8&*+
zWd8=ueTP3pUaeRBwTmC{Cx3!sQYkdBLH^*uWKHLyUrL$_a~DDI1XsU?Jp!P#z>`$2
zPICy4X@l-+6t`))H-Uhc`7`L3Hz!%ixn>VNtMk`rj!(3j&`1gjCFRve><H(`=0*Z@
z*m6mSRgG5MkTaC~Ow+Z)fv{!D>f)_<k3>;LaRE{(M$sY(;f<v&+*lmCC>rHOCmA;^
zG#-;E@f9LHtqv`;@K$+=Qv(scJK?SkOVzS$TIcwYPtjCYH|CeCHmcnkR8X>PIh`bE
zazj5vLtTIY!guk97?lyfb~Ddx*~Wp`@Q3UwsFOpI<qC7)_p!A$2Uent){$wyXwTU@
zXKtSe&(zL8;%vhmU#~C+n};08@|igJgTfkCQ75EuZ<2<`xy|hJkFdoWhnDd?q8|n0
z{E?qleq_M!$HuTs#=&<s7iuk4Ym!S=anmS6(yBllGi!l$HfT+hn0F$4m+Tf3P>44A
zX_K(Aub>&oX_v+J>6-2fOyeaH0}J#dlRw6xOX7!uHM@gG{J=S5jthL<UI_t^IIlro
z8D+`YLo`x@m9V^ME*_01Stn*FF4SO7Jks2rtbu!7anK;39wj8*TzgI8#k5FPO{y<@
ztNAQlQ5gEXszue(GLJLMf*6p2+Rgv+Z@>M_`W-)gz3%u|k93H2K<-^#nf1due4xW-
zitB%<!$0WoEEVg2sY6EXIyTeQn>tMCkm>ME9daFb8;gS~^Ph_-s_Q;;{vWqS`5&x&
zU2te;g{|S8wn1L?=KJO>d=F-GR&I3n^&MMh^?!3#ZkG4;6a81%AmG^M><PY!aP$yw
zD9&k<%&)(2-+c$~Idspx+jf3sM}PMIoiou~Jf*GafW+2je#gM5HqvhL8|OF0Z;gVv
zJRa#PDzwE)pWp_Z60(DHA!mMEIpG$Q8h)tg9-&9#bU9B=zi?9HZb?H6SC`=Vs{z1b
z+XDy-4N~KkInmnXIo2b#bdh^f#jX(w3Ed1e1-k0>PjpzM$FA_Jf>AOWbpE{VWqqQ<
zFAQ08d}{Ga9WHYyMwR+I9hMB|C97yQtxCNU#&Atlm{^VA@{6&6D`OWVK09v;gpusb
zRU!A)*a)Y^5m}t74yH!%wQ7Q5g_cVgV-Gg%YMFh=)(FM7Jqfx=X{D&^&6Fi%r-aD5
zs`E>!uDf<^k=jC)BzyzDw^ORLxoY%Ltm|3BLpKX_wL^zT%dBpNuNLrCvaf2q5D$9T
zq@pKuc(y9XnEA1$=^zg*(QZ}DtISISx@j#_g?~^LUN@xvaLR)kEIU;d=EKwzvlTK~
zRj86o*5F~WXOI!wU5&w=a&`FMb@-&B)0GKPteWm4U#1-jE9R(qu^I5Gg8P*j*H>f|
zQ4o#-HJT6DaI0vLjH~_^sucRbpskJ%z}5YlvJIq6!R^_yHkVbqtE!ik9ANQ9<FR-F
zFM+ebh-#Sve<7pJiHvcAQlILzrxdBO634xG6}J@~Ojx-ksnGQ8+D+B8MRPKArc9ty
z{~SlVsSd3X0f<jn4VKN(3(AI@j1%y%e5UC&cP-Tr2ckU4&J1-fVg5TOM}e!;887Fb
z^gt8+%x^w*H6)?yS5DJz*D*`Qn}nwwmMPjgM=bibLYKFF{ow6y_67OdWy2xmTwfNk
zI<le>GiIx<+s#@$VX^z|)IZ9=6DP`CY&whc{XJ@nfe6a-PkCtJA9c@)^QU9F75-^A
zWFah{+5+XLRtHD_5)lli=b0In=SI_U!y3w`$~asWaBk?D<+VN);37D{V?oEq(_@Qf
zr&L~ysv^nxF-E5|S+O+&ZMvg%ei=^sJHqKCoRrZIKgA!f>Lv@-7TW6KGaJ5c74l~y
zmM^x~AZ&sJVYsQq9aEAP>HGQdWTr(RNqI5DtaT=FbcYuh*C28w1<P;|RA|YOzcGek
z2}=XRDk9IWO6QB?0tRrp>@_q?Vzw#(Zwd!1!v*Gx9y|!X*>mMEJiHaRPHuCkr3Pus
z{)}gNE!wwu`iF8-EFp^Po^AW^K6K0-Hxa=n#2)H$=WLWl6mi!_DQa-L50>B;Nm1h_
z&7)0{tV>U<O|gXBXIE&HMVN$}t2QeOWA)zvL(Up;qvaaSZqx2M=}`vyNbO>R1sX1z
z{>rb2GdAXsF*nAdCX$4e$lnCT+zZQ_3_z@gyz`ST%=SEvQ{j3Z7!sjzsg#$PH+c#H
zP_If@a~5(*daNO&cx@ec$+71X#OlvvZX{f@EHbeU*z1nWMwpSVtOPSy9~onIF?QSx
zL=1SmNwXoiV}_5%#aNxPXhlAng(@V<H!KrP%MpZBVu43DOD7ovjNLPoHS+?;od7s2
zw28tco7c_Wjs<b#vPuIfq=jIW25T_|Dl9@!&g$9Dpl^W$R5V2VHOqLG0qip4x@8Ec
z&tUz_#EqrwiK!U$%C+`%lp8p#tZSiFEW?VdaXeL~c0-Sor8iAQb#BG$X7X@0st;N)
zyHtm^=p$2?PO+fP?_)0r+~EIs!qpU0iSDfSi!{2xz-TRj_B<t4)8xH;7R*+QwUR1Y
z>qJ9HEPsJ2Oo6to8o#AwM$oVB2x+>O>aj8gS;8u`&U-W92U)fl?I$K1oStB-DqEWk
zj)zQQR(<^+^P%#>X4Waw0v?HkUM)LzyVRB>c)@@O5R$>qhu?%W3?oq-WiEXj<f=>Z
zgxnf<5^5O3G$^xB*y4X<3VH=9ut3d33}SHX`jdHZp7p!X;{nT>e8_yS+n9}51Hg0Y
z@inx8ao9r<v})i;0g(wrIz}1YY2_4u>+P-7h9cx-)~I5IJ+CojL;mhKBga>QIW?zH
zem!qjh2-s!Q3X&pInAcAuyf_fWMHu^OE8=*Zfg?22^<zG3y#1nkcR|lX|cg?oFD6g
z%DU{W&t=5}Uf3=pSa2u}msr6LIGJExoeJ~GP&dC?rT~CGtD4Mpv1$0Cf$)|kS_B*v
zaWUvW9VEvGN$hH9TOTAR2Fd0C9NZh^j|}A(uMb`1*YOGg(f*)8Yf_Tu@wc0nZEyS;
zPgrYQ<7CS<!f;awj>2+W)F)E2IGRekOpD`jCe-WJGoPB`CwbR;uyl|=J(Abr9)(r_
zxkQy)oN(GK3&wG)*Pwo*#i6MK3xQN<H7ILQW*1VMR;x9UX&ABxvJ7p|kllo)-s)ei
z0*1>;riiiFw2l_O(0uNoDkd7;x-ca<2j(@xM~>W%LzWn=1fEqallvu}AK?)jds0w3
zE03ldVo%eFLN&#bG`^~QA@{!WvBgU`Crpdo1hHU<34yvJ>ymGx6KyUv1mL{CSR5yB
zXkkd8^=KvaaskGxt@Ew*z#G>~{z@kx>xma0yur!I2^dQA^k50imwe^xV{&Mp^4K(i
z9cA1e<&vJgf`Pn%1CCogjKyPJG%Sxmk~}#)J5y|E;Y$oQcX)+?RhB1`hc1Z#EWDj(
z(iP}pKG|kTRnO3mnMH|)Tw!%l&`~)Y>jIcO2Po?3#B-&uabgr#2{F<}ZKF&1HJcmd
zfmnd6Z`9M}aGl&P7fjJ2Jh%RBV423v#W!ge^T&ohpI~24I1^DXVO58BZtS=za(CRj
z^I*Tf?cRf1Ubwe^-<BQs?%2NN{@MGtZTZU1?f1X%mF+w3x##c^=k`YK=B<zInXA4C
zwmGccoZGSW9=c4|R7Lv8+p&YT?QKVGvZ^Gb?o8yS*g5rd|KOR79UKq$kG|Y@ZXCq;
z&K8+m+!VRCHgdAhXJvo=gKYckwtJm>ByziUWiR?2L^Hmhw1usU{g*n<^)t3QJM>b<
zhlWqHWm9(K<mt@%=Hr<en_QpF*oczPSMz#;y4tpNJ4;U6{6)D%6R$5p#qf<9=djK$
z|M%L{J*)PT&3=zfsk0aQ*=gG>@o;wZM8*edvlDD<mK{I%yYza_e>Y`o_Vk&47IuF!
z+}KTv9U1$l0dn@G%<sUaZ5g$VI6EU|G#<)iTRvrKD^Iq>;^u@ntAAgO+&v{++X8*C
zMdn?<;)CFBOXN0&rh{f@?s~xY8@{pd4L%<}>)gMH*kdVd2s_xY^R5SmzB-_)kP+nk
zzeADx*G4jZ?BzG1*4)YLuzj;AJL5l;kRA71Xm8H=>faDyc*iPoyXj4GKCw$*t+G%4
zu_>;^yKZ=pP!&V$o0d=`RAlu=&s&w{2d#(>|NHJw!Wf<VW2Lj<(n0#tP(9}kJbd!>
zZuS~yQ(XTg?0(-qg{1ob=gYuY+06jZKRbnj(RLjYyc~oVAQ*c?zUn>7@7bS5?z>t>
zF8_VE#*2CG8TS;g={>`1Hcyh;Ya7-a;QW|-gtY#>SO1^?TeOY&iAv%8pp|L?S$WI<
zi9Zog^}^I6y!N9P3H6Gcy?0L89oA~_TDEo<2pi*gNPkwp2G9tc^irK(a^nkVH$eKp
z>df-OkN>}e7t5f5`ySikMCJSQdR<E|CSo0UWn7!r3|><`#<gBGI>AeJdJ%8=i*){V
zt-))*+DhsuJ?JGc{{nG%$!;t3((8g5C3>Y%Z+#1@UQX0jNnt-S;qZ`aSGWnb_BVTs
zv+&fvT?Rof!1+BSp5T1iusiDaDWlF;-6${uJ$4)BgE#;E%ZGxs@?}1sM}SkcUGZuk
z6|^hGc7C(`(0=-wpuV{0UxD>6yACj3*~eCJ)yuH@_lS*kANak<DEQtNv^d3h{nj)u
z0nx3Jm$@H6x9woC&EXpO_mJW6c-c<UAZTIyy7JWfB3x$iq7mCO>Gd`7L;JrBMj;&$
zox{dfj@MRitiO_4D`|DVwOP66!woM`-aum;<mVlJ966SG++XbcybAw6|NmtQ{9iyN
BzPbPa

diff --git a/build/0Harmony.xml b/build/0Harmony.xml
new file mode 100644
index 00000000..ba2f340e
--- /dev/null
+++ b/build/0Harmony.xml
@@ -0,0 +1,3130 @@
+<?xml version="1.0"?>
+<doc>
+    <assembly>
+        <name>0Harmony</name>
+    </assembly>
+    <members>
+        <member name="T:HarmonyLib.DelegateTypeFactory">
+            <summary>A factory to create delegate types</summary>
+        </member>
+        <member name="M:HarmonyLib.DelegateTypeFactory.#ctor">
+            <summary>Default constructor</summary>
+        </member>
+        <member name="M:HarmonyLib.DelegateTypeFactory.CreateDelegateType(System.Reflection.MethodInfo)">
+             <summary>Creates a delegate type for a method</summary>
+             <param name="method">The method</param>
+             <returns>The new delegate type</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.GetterHandler`2">
+             <summary>A getter delegate type</summary>
+             <typeparam name="T">Type that getter gets field/property value from</typeparam>
+             <typeparam name="S">Type of the value that getter gets</typeparam>
+             <param name="source">The instance get getter uses</param>
+             <returns>An delegate</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.SetterHandler`2">
+             <summary>A setter delegate type</summary>
+             <typeparam name="T">Type that setter sets field/property value for</typeparam>
+             <typeparam name="S">Type of the value that setter sets</typeparam>
+             <param name="source">The instance the setter uses</param>
+             <param name="value">The value the setter uses</param>
+             <returns>An delegate</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.InstantiationHandler`1">
+             <summary>A constructor delegate type</summary>
+             <typeparam name="T">Type that constructor creates</typeparam>
+             <returns>An delegate</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.FastAccess">
+            <summary>A helper class for fast access to getters and setters</summary>
+        </member>
+        <member name="M:HarmonyLib.FastAccess.CreateInstantiationHandler``1">
+             <summary>Creates an instantiation delegate</summary>
+             <typeparam name="T">Type that constructor creates</typeparam>
+             <returns>The new instantiation delegate</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.FastAccess.CreateGetterHandler``2(System.Reflection.PropertyInfo)">
+             <summary>Creates an getter delegate for a property</summary>
+             <typeparam name="T">Type that getter reads property from</typeparam>
+             <typeparam name="S">Type of the property that gets accessed</typeparam>
+             <param name="propertyInfo">The property</param>
+             <returns>The new getter delegate</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.FastAccess.CreateGetterHandler``2(System.Reflection.FieldInfo)">
+             <summary>Creates an getter delegate for a field</summary>
+             <typeparam name="T">Type that getter reads field from</typeparam>
+             <typeparam name="S">Type of the field that gets accessed</typeparam>
+             <param name="fieldInfo">The field</param>
+             <returns>The new getter delegate</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.FastAccess.CreateFieldGetter``2(System.String[])">
+             <summary>Creates an getter delegate for a field (with a list of possible field names)</summary>
+             <typeparam name="T">Type that getter reads field/property from</typeparam>
+             <typeparam name="S">Type of the field/property that gets accessed</typeparam>
+             <param name="names">A list of possible field names</param>
+             <returns>The new getter delegate</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.FastAccess.CreateSetterHandler``2(System.Reflection.PropertyInfo)">
+             <summary>Creates an setter delegate</summary>
+             <typeparam name="T">Type that setter assigns property value to</typeparam>
+             <typeparam name="S">Type of the property that gets assigned</typeparam>
+             <param name="propertyInfo">The property</param>
+             <returns>The new setter delegate</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.FastAccess.CreateSetterHandler``2(System.Reflection.FieldInfo)">
+             <summary>Creates an setter delegate for a field</summary>
+             <typeparam name="T">Type that setter assigns field value to</typeparam>
+             <typeparam name="S">Type of the field that gets assigned</typeparam>
+             <param name="fieldInfo">The field</param>
+             <returns>The new getter delegate</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.FastInvokeHandler">
+            <summary>A delegate to invoke a method</summary>
+            <param name="target">The instance</param>
+            <param name="parameters">The method parameters</param>
+            <returns>The method result</returns>
+        </member>
+        <member name="T:HarmonyLib.MethodInvoker">
+            <summary>A helper class to invoke method with delegates</summary>
+        </member>
+        <member name="M:HarmonyLib.MethodInvoker.GetHandler(System.Reflection.MethodInfo,System.Boolean)">
+            <summary>Creates a fast invocation handler from a method</summary>
+            <param name="methodInfo">The method to invoke</param>
+            <param name="directBoxValueAccess">Controls if boxed value object is accessed/updated directly</param>
+            <returns>The <see cref="T:HarmonyLib.FastInvokeHandler"/></returns>
+            <remarks>
+            <para>
+            The <c>directBoxValueAccess</c> option controls how value types passed by reference (e.g. ref int, out my_struct) are handled in the arguments array
+            passed to the fast invocation handler.
+            Since the arguments array is an object array, any value types contained within it are actually references to a boxed value object.
+            Like any other object, there can be other references to such boxed value objects, other than the reference within the arguments array.
+            <example>For example,
+            <code>
+            var val = 5;
+            var box = (object)val;
+            var arr = new object[] { box };
+            handler(arr); // for a method with parameter signature: ref/out/in int
+            </code>
+            </example>
+            </para>
+            <para>
+            If <c>directBoxValueAccess</c> is <c>true</c>, the boxed value object is accessed (and potentially updated) directly when the handler is called,
+            such that all references to the boxed object reflect the potentially updated value.
+            In the above example, if the method associated with the handler updates the passed (boxed) value to 10, both <c>box</c> and <c>arr[0]</c>
+            now reflect the value 10. Note that the original <c>val</c> is not updated, since boxing always copies the value into the new boxed value object.
+            </para>
+            <para>
+            If <c>directBoxValueAccess</c> is <c>false</c> (default), the boxed value object in the arguments array is replaced with a "reboxed" value object,
+            such that potential updates to the value are reflected only in the arguments array.
+            In the above example, if the method associated with the handler updates the passed (boxed) value to 10, only <c>arr[0]</c> now reflects the value 10.
+            </para>
+            </remarks>
+        </member>
+        <member name="T:HarmonyLib.Memory">
+             <summary>A low level memory helper</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.Memory.MarkForNoInlining(System.Reflection.MethodBase)">
+             <summary>Mark method for no inlining (currently only works on Mono)</summary>
+             <param name="method">The method/constructor to change</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Memory.DetourMethod(System.Reflection.MethodBase,System.Reflection.MethodBase)">
+             <summary>Detours a method</summary>
+             <param name="original">The original method/constructor</param>
+             <param name="replacement">The replacement method/constructor</param>
+             <returns>An error string</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Memory.WriteJump(System.Int64,System.Int64)">
+             <summary>Writes a jump to memory</summary>
+             <param name="memory">The memory address</param>
+             <param name="destination">Jump destination</param>
+             <returns>An error string</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Memory.GetMethodStart(System.Reflection.MethodBase,System.Exception@)">
+             <summary>Gets the start of a method in memory</summary>
+             <param name="method">The method/constructor</param>
+             <param name="exception">[out] Details of the exception</param>
+             <returns>The method start address</returns>
+            
+        </member>
+        <member name="F:HarmonyLib.MethodPatcher.INSTANCE_PARAM">
+            special parameter names that can be used in prefix and postfix methods
+        </member>
+        <member name="T:HarmonyLib.PatchFunctions">
+            <summary>Patch function helpers</summary>
+        </member>
+        <member name="M:HarmonyLib.PatchFunctions.GetSortedPatchMethods(System.Reflection.MethodBase,HarmonyLib.Patch[],System.Boolean)">
+             <summary>Sorts patch methods by their priority rules</summary>
+             <param name="original">The original method</param>
+             <param name="patches">Patches to sort</param>
+             <param name="debug">Use debug mode</param>
+             <returns>The sorted patch methods</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchFunctions.UpdateWrapper(System.Reflection.MethodBase,HarmonyLib.PatchInfo)">
+             <summary>Creates new replacement method with the latest patches and detours the original method</summary>
+             <param name="original">The original method</param>
+             <param name="patchInfo">Information describing the patches</param>
+             <returns>The newly created replacement method</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.#ctor(HarmonyLib.Patch[],System.Boolean)">
+            <summary>Creates a patch sorter</summary>
+            <param name="patches">Array of patches that will be sorted</param>
+            <param name="debug">Use debugging</param>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.Sort(System.Reflection.MethodBase)">
+            <summary>Sorts internal PatchSortingWrapper collection and caches the results.
+            After first run the result is provided from the cache.</summary>
+            <param name="original">The original method</param>
+            <returns>The sorted patch methods</returns>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.ComparePatchLists(HarmonyLib.Patch[])">
+            <summary>Checks if the sorter was created with the same patch list and as a result can be reused to
+            get the sorted order of the patches.</summary>
+            <param name="patches">List of patches to check against</param>
+            <returns>true if equal</returns>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.CullDependency">
+            <summary>Removes one unresolved dependency from the least important patch.</summary>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.ProcessWaitingList">
+            <summary>Outputs all unblocked patches from the waiting list to results list</summary>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.AddNodeToResult(HarmonyLib.PatchSorter.PatchSortingWrapper)">
+            <summary>Adds patch to both results list and handled patches set</summary>
+            <param name="node">Patch to add</param>
+        </member>
+        <member name="T:HarmonyLib.PatchSorter.PatchSortingWrapper">
+            <summary>Wrapper used over the Patch object to allow faster dependency access and
+            dependency removal in case of cyclic dependencies</summary>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.PatchSortingWrapper.#ctor(HarmonyLib.Patch)">
+            <summary>Create patch wrapper object used for sorting</summary>
+            <param name="patch">Patch to wrap</param>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.PatchSortingWrapper.CompareTo(System.Object)">
+            <summary>Determines how patches sort</summary>
+            <param name="obj">The other patch</param>
+            <returns>integer to define sort order (-1, 0, 1)</returns>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.PatchSortingWrapper.Equals(System.Object)">
+            <summary>Determines whether patches are equal</summary>
+            <param name="obj">The other patch</param>
+            <returns>true if equal</returns>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.PatchSortingWrapper.GetHashCode">
+            <summary>Hash function</summary>
+            <returns>A hash code</returns>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.PatchSortingWrapper.AddBeforeDependency(System.Collections.Generic.IEnumerable{HarmonyLib.PatchSorter.PatchSortingWrapper})">
+            <summary>Bidirectionally registers Patches as after dependencies</summary>
+            <param name="dependencies">List of dependencies to register</param>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.PatchSortingWrapper.AddAfterDependency(System.Collections.Generic.IEnumerable{HarmonyLib.PatchSorter.PatchSortingWrapper})">
+            <summary>Bidirectionally registers Patches as before dependencies</summary>
+            <param name="dependencies">List of dependencies to register</param>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.PatchSortingWrapper.RemoveAfterDependency(HarmonyLib.PatchSorter.PatchSortingWrapper)">
+            <summary>Bidirectionally removes Patch from after dependencies</summary>
+            <param name="afterNode">Patch to remove</param>
+        </member>
+        <member name="M:HarmonyLib.PatchSorter.PatchSortingWrapper.RemoveBeforeDependency(HarmonyLib.PatchSorter.PatchSortingWrapper)">
+            <summary>Bidirectionally removes Patch from before dependencies</summary>
+            <param name="beforeNode">Patch to remove</param>
+        </member>
+        <member name="T:HarmonyLib.MethodType">
+             <summary>Specifies the type of method</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.MethodType.Normal">
+            <summary>This is a normal method</summary>
+        </member>
+        <member name="F:HarmonyLib.MethodType.Getter">
+            <summary>This is a getter</summary>
+        </member>
+        <member name="F:HarmonyLib.MethodType.Setter">
+            <summary>This is a setter</summary>
+        </member>
+        <member name="F:HarmonyLib.MethodType.Constructor">
+            <summary>This is a constructor</summary>
+        </member>
+        <member name="F:HarmonyLib.MethodType.StaticConstructor">
+            <summary>This is a static constructor</summary>
+        </member>
+        <member name="T:HarmonyLib.ArgumentType">
+             <summary>Specifies the type of argument</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ArgumentType.Normal">
+            <summary>This is a normal argument</summary>
+        </member>
+        <member name="F:HarmonyLib.ArgumentType.Ref">
+            <summary>This is a reference argument (ref)</summary>
+        </member>
+        <member name="F:HarmonyLib.ArgumentType.Out">
+            <summary>This is an out argument (out)</summary>
+        </member>
+        <member name="F:HarmonyLib.ArgumentType.Pointer">
+            <summary>This is a pointer argument (&amp;)</summary>
+        </member>
+        <member name="T:HarmonyLib.HarmonyPatchType">
+             <summary>Specifies the type of patch</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyPatchType.All">
+            <summary>Any patch</summary>
+        </member>
+        <member name="F:HarmonyLib.HarmonyPatchType.Prefix">
+            <summary>A prefix patch</summary>
+        </member>
+        <member name="F:HarmonyLib.HarmonyPatchType.Postfix">
+            <summary>A postfix patch</summary>
+        </member>
+        <member name="F:HarmonyLib.HarmonyPatchType.Transpiler">
+            <summary>A transpiler</summary>
+        </member>
+        <member name="F:HarmonyLib.HarmonyPatchType.Finalizer">
+            <summary>A finalizer</summary>
+        </member>
+        <member name="F:HarmonyLib.HarmonyPatchType.ReversePatch">
+            <summary>A reverse patch</summary>
+        </member>
+        <member name="T:HarmonyLib.HarmonyReversePatchType">
+             <summary>Specifies the type of reverse patch</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyReversePatchType.Original">
+            <summary>Use the unmodified original method (directly from IL)</summary>
+        </member>
+        <member name="F:HarmonyLib.HarmonyReversePatchType.Snapshot">
+            <summary>Use the original as it is right now including previous patches but excluding future ones</summary>
+        </member>
+        <member name="T:HarmonyLib.MethodDispatchType">
+             <summary>Specifies the type of method call dispatching mechanics</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.MethodDispatchType.VirtualCall">
+            <summary>Call the method using dynamic dispatching if method is virtual (including overriden)</summary>
+            <remarks>
+            <para>
+            This is the built-in form of late binding (a.k.a. dynamic binding) and is the default dispatching mechanic in C#.
+            This directly corresponds with the <see cref="F:System.Reflection.Emit.OpCodes.Callvirt"/> instruction.
+            </para>
+            <para>
+            For virtual (including overriden) methods, the instance type's most-derived/overriden implementation of the method is called.
+            For non-virtual (including static) methods, same behavior as <see cref="F:HarmonyLib.MethodDispatchType.Call"/>: the exact specified method implementation is called.
+            </para>
+            <para>
+            Note: This is not a fully dynamic dispatch, since non-virtual (including static) methods are still called non-virtually.
+            A fully dynamic dispatch in C# involves using
+            the <see href="https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/reference-types#the-dynamic-type"><c>dynamic</c> type</see>
+            (actually a fully dynamic binding, since even the name and overload resolution happens at runtime), which <see cref="T:HarmonyLib.MethodDispatchType"/> does not support.
+            </para>
+            </remarks>
+        </member>
+        <member name="F:HarmonyLib.MethodDispatchType.Call">
+            <summary>Call the method using static dispatching, regardless of whether method is virtual (including overriden) or non-virtual (including static)</summary>
+            <remarks>
+            <para>
+            a.k.a. non-virtual dispatching, early binding, or static binding.
+            This directly corresponds with the <see cref="F:System.Reflection.Emit.OpCodes.Call"/> instruction.
+            </para>
+            <para>
+            For both virtual (including overriden) and non-virtual (including static) methods, the exact specified method implementation is called, without virtual/override mechanics.
+            </para>
+            </remarks>
+        </member>
+        <member name="T:HarmonyLib.HarmonyAttribute">
+             <summary>The base class for all Harmony annotations (not meant to be used directly)</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyAttribute.info">
+            <summary>The common information for all attributes</summary>
+        </member>
+        <member name="T:HarmonyLib.HarmonyPatch">
+             <summary>Annotation to define your Harmony patch methods</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor">
+             <summary>An empty annotation can be used together with TargetMethod(s)</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type)">
+             <summary>An annotation that specifies a class to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="argumentTypes">The argument types of the method or constructor to patch</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type,System.String)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type,System.String,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type,System.String,System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">Array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type,HarmonyLib.MethodType)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type,HarmonyLib.MethodType,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type,HarmonyLib.MethodType,System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">Array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type,System.String,HarmonyLib.MethodType)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.String)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.String,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.String,System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">An array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.String,HarmonyLib.MethodType)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(HarmonyLib.MethodType)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(HarmonyLib.MethodType,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(HarmonyLib.MethodType,System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">An array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">An array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyDelegate">
+             <summary>Annotation to define the original method for delegate injection</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type)">
+             <summary>An annotation that specifies a class to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="argumentTypes">The argument types of the method or constructor to patch</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type,System.String)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type,System.String,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type,System.String,System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">Array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type,HarmonyLib.MethodDispatchType)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodDispatchType">The <see cref="T:HarmonyLib.MethodDispatchType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type,HarmonyLib.MethodDispatchType,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodDispatchType">The <see cref="T:HarmonyLib.MethodDispatchType"/></param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type,HarmonyLib.MethodDispatchType,System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodDispatchType">The <see cref="T:HarmonyLib.MethodDispatchType"/></param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">Array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type,System.String,HarmonyLib.MethodDispatchType)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="declaringType">The declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="methodDispatchType">The <see cref="T:HarmonyLib.MethodDispatchType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.String)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.String,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.String,System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">An array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.String,HarmonyLib.MethodDispatchType)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="methodDispatchType">The <see cref="T:HarmonyLib.MethodDispatchType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(HarmonyLib.MethodDispatchType)">
+             <summary>An annotation that specifies call dispatching mechanics for the delegate</summary>
+             <param name="methodDispatchType">The <see cref="T:HarmonyLib.MethodDispatchType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(HarmonyLib.MethodDispatchType,System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodDispatchType">The <see cref="T:HarmonyLib.MethodDispatchType"/></param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(HarmonyLib.MethodDispatchType,System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="methodDispatchType">The <see cref="T:HarmonyLib.MethodDispatchType"/></param>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">An array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyDelegate.#ctor(System.Type[],HarmonyLib.ArgumentType[])">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="argumentTypes">An array of argument types to target overloads</param>
+             <param name="argumentVariations">An array of <see cref="T:HarmonyLib.ArgumentType"/></param>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyReversePatch">
+             <summary>Annotation to define your standin methods for reverse patching</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyReversePatch.#ctor(HarmonyLib.HarmonyReversePatchType)">
+             <summary>An annotation that specifies the type of reverse patching</summary>
+             <param name="type">The <see cref="T:HarmonyLib.HarmonyReversePatchType"/> of the reverse patch</param>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyPatchAll">
+             <summary>A Harmony annotation to define that all methods in a class are to be patched</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyPriority">
+             <summary>A Harmony annotation</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyPriority.#ctor(System.Int32)">
+             <summary>A Harmony annotation to define patch priority</summary>
+             <param name="priority">The priority</param>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyBefore">
+             <summary>A Harmony annotation</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyBefore.#ctor(System.String[])">
+             <summary>A Harmony annotation to define that a patch comes before another patch</summary>
+             <param name="before">The array of harmony IDs of the other patches</param>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyAfter">
+            <summary>A Harmony annotation</summary>
+        </member>
+        <member name="M:HarmonyLib.HarmonyAfter.#ctor(System.String[])">
+             <summary>A Harmony annotation to define that a patch comes after another patch</summary>
+             <param name="after">The array of harmony IDs of the other patches</param>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyDebug">
+            <summary>A Harmony annotation</summary>
+        </member>
+        <member name="M:HarmonyLib.HarmonyDebug.#ctor">
+             <summary>A Harmony annotation to debug a patch (output uses <see cref="T:HarmonyLib.FileLog"/> to log to your Desktop)</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyPrepare">
+             <summary>Specifies the Prepare function in a patch class</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyCleanup">
+             <summary>Specifies the Cleanup function in a patch class</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyTargetMethod">
+             <summary>Specifies the TargetMethod function in a patch class</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyTargetMethods">
+             <summary>Specifies the TargetMethods function in a patch class</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyPrefix">
+             <summary>Specifies the Prefix function in a patch class</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyPostfix">
+             <summary>Specifies the Postfix function in a patch class</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyTranspiler">
+             <summary>Specifies the Transpiler function in a patch class</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyFinalizer">
+             <summary>Specifies the Finalizer function in a patch class</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyArgument">
+             <summary>A Harmony annotation</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.HarmonyArgument.OriginalName">
+             <summary>The name of the original argument</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.HarmonyArgument.Index">
+             <summary>The index of the original argument</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.HarmonyArgument.NewName">
+             <summary>The new name of the original argument</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyArgument.#ctor(System.String)">
+             <summary>An annotation to declare injected arguments by name</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyArgument.#ctor(System.Int32)">
+             <summary>An annotation to declare injected arguments by index</summary>
+             <param name="index">Zero-based index</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyArgument.#ctor(System.String,System.String)">
+             <summary>An annotation to declare injected arguments by renaming them</summary>
+             <param name="originalName">Name of the original argument</param>
+             <param name="newName">New name</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyArgument.#ctor(System.Int32,System.String)">
+             <summary>An annotation to declare injected arguments by index and renaming them</summary>
+             <param name="index">Zero-based index</param>
+             <param name="name">New name</param>
+            
+        </member>
+        <member name="T:HarmonyLib.CodeInstruction">
+             <summary>An abstract wrapper around OpCode and their operands. Used by transpilers</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.CodeInstruction.opcode">
+             <summary>The opcode</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.CodeInstruction.operand">
+             <summary>The operand</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.CodeInstruction.labels">
+             <summary>All labels defined on this instruction</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.CodeInstruction.blocks">
+             <summary>All exception block boundaries defined on this instruction</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.#ctor(System.Reflection.Emit.OpCode,System.Object)">
+             <summary>Creates a new CodeInstruction with a given opcode and optional operand</summary>
+             <param name="opcode">The opcode</param>
+             <param name="operand">The operand</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.#ctor(HarmonyLib.CodeInstruction)">
+             <summary>Create a full copy (including labels and exception blocks) of a CodeInstruction</summary>
+             <param name="instruction">The <see cref="T:HarmonyLib.CodeInstruction"/> to copy</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Clone">
+             <summary>Clones a CodeInstruction and resets its labels and exception blocks</summary>
+             <returns>A lightweight copy of this code instruction</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Clone(System.Reflection.Emit.OpCode)">
+             <summary>Clones a CodeInstruction, resets labels and exception blocks and sets its opcode</summary>
+             <param name="opcode">The opcode</param>
+             <returns>A copy of this CodeInstruction with a new opcode</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Clone(System.Object)">
+             <summary>Clones a CodeInstruction, resets labels and exception blocks and sets its operand</summary>
+             <param name="operand">The operand</param>
+             <returns>A copy of this CodeInstruction with a new operand</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Call(System.Type,System.String,System.Type[],System.Type[])">
+             <summary>Creates a CodeInstruction calling a method (CALL)</summary>
+             <param name="type">The class/type where the method is declared</param>
+             <param name="name">The name of the method (case sensitive)</param>
+             <param name="parameters">Optional parameters to target a specific overload of the method</param>
+             <param name="generics">Optional list of types that define the generic version of the method</param>
+             <returns>A code instruction that calls the method matching the arguments</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Call(System.String,System.Type[],System.Type[])">
+             <summary>Creates a CodeInstruction calling a method (CALL)</summary>
+             <param name="typeColonMethodname">The target method in the form <c>TypeFullName:MethodName</c>, where the type name matches a form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <param name="parameters">Optional parameters to target a specific overload of the method</param>
+             <param name="generics">Optional list of types that define the generic version of the method</param>
+             <returns>A code instruction that calls the method matching the arguments</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Call(System.Linq.Expressions.Expression{System.Action})">
+             <summary>Creates a CodeInstruction calling a method (CALL)</summary>
+             <param name="expression">The lambda expression using the method</param>
+             <returns></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Call``1(System.Linq.Expressions.Expression{System.Action{``0}})">
+             <summary>Creates a CodeInstruction calling a method (CALL)</summary>
+             <param name="expression">The lambda expression using the method</param>
+             <returns></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Call``2(System.Linq.Expressions.Expression{System.Func{``0,``1}})">
+             <summary>Creates a CodeInstruction calling a method (CALL)</summary>
+             <param name="expression">The lambda expression using the method</param>
+             <returns></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.Call(System.Linq.Expressions.LambdaExpression)">
+             <summary>Creates a CodeInstruction calling a method (CALL)</summary>
+             <param name="expression">The lambda expression using the method</param>
+             <returns></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.LoadField(System.Type,System.String,System.Boolean)">
+            <summary>Creates a CodeInstruction loading a field (LD[S]FLD[A])</summary>
+            <param name="type">The class/type where the field is defined</param>
+            <param name="name">The name of the field (case sensitive)</param>
+            <param name="useAddress">Use address of field</param>
+            <returns></returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.StoreField(System.Type,System.String)">
+            <summary>Creates a CodeInstruction storing to a field (ST[S]FLD)</summary>
+            <param name="type">The class/type where the field is defined</param>
+            <param name="name">The name of the field (case sensitive)</param>
+            <returns></returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.ToString">
+             <summary>Returns a string representation of the code instruction</summary>
+             <returns>A string representation of the code instruction</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.ExceptionBlockType">
+            <summary>Exception block types</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ExceptionBlockType.BeginExceptionBlock">
+            <summary>The beginning of an exception block</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ExceptionBlockType.BeginCatchBlock">
+            <summary>The beginning of a catch block</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ExceptionBlockType.BeginExceptFilterBlock">
+            <summary>The beginning of an except filter block</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ExceptionBlockType.BeginFaultBlock">
+            <summary>The beginning of a fault block</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ExceptionBlockType.BeginFinallyBlock">
+            <summary>The beginning of a finally block</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ExceptionBlockType.EndExceptionBlock">
+            <summary>The end of an exception block</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.ExceptionBlock">
+            <summary>An exception block</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ExceptionBlock.blockType">
+            <summary>Block type</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.ExceptionBlock.catchType">
+            <summary>Catch type</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.ExceptionBlock.#ctor(HarmonyLib.ExceptionBlockType,System.Type)">
+             <summary>Creates an exception block</summary>
+             <param name="blockType">The <see cref="T:HarmonyLib.ExceptionBlockType"/></param>
+             <param name="catchType">The catch type</param>
+            
+        </member>
+        <member name="T:HarmonyLib.Harmony">
+            <summary>The Harmony instance is the main entry to Harmony. After creating one with an unique identifier, it is used to patch and query the current application domain</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.Harmony.Id">
+            <summary>The unique identifier</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Harmony.DEBUG">
+            <summary>Set to true before instantiating Harmony to debug Harmony or use an environment variable to set HARMONY_DEBUG to '1' like this: cmd /C "set HARMONY_DEBUG=1 &amp;&amp; game.exe"</summary>
+            <remarks>This is for full debugging. To debug only specific patches, use the <see cref="T:HarmonyLib.HarmonyDebug"/> attribute</remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.#ctor(System.String)">
+             <summary>Creates a new Harmony instance</summary>
+             <param name="id">A unique identifier (you choose your own)</param>
+             <returns>A Harmony instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.PatchAll">
+            <summary>Searches the current assembly for Harmony annotations and uses them to create patches</summary>
+            <remarks>This method can fail to use the correct assembly when being inlined. It calls StackTrace.GetFrame(1) which can point to the wrong method/assembly. If you are unsure or run into problems, use <code>PatchAll(Assembly.GetExecutingAssembly())</code> instead.</remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.CreateProcessor(System.Reflection.MethodBase)">
+             <summary>Creates a empty patch processor for an original method</summary>
+             <param name="original">The original method/constructor</param>
+             <returns>A new <see cref="T:HarmonyLib.PatchProcessor"/> instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.CreateClassProcessor(System.Type)">
+            <summary>Creates a patch class processor from an annotated class</summary>
+            <param name="type">The class/type</param>
+            <returns>A new <see cref="T:HarmonyLib.PatchClassProcessor"/> instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.CreateReversePatcher(System.Reflection.MethodBase,HarmonyLib.HarmonyMethod)">
+             <summary>Creates a reverse patcher for one of your stub methods</summary>
+             <param name="original">The original method/constructor</param>
+             <param name="standin">The stand-in stub method as <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+             <returns>A new <see cref="T:HarmonyLib.ReversePatcher"/> instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.PatchAll(System.Reflection.Assembly)">
+            <summary>Searches an assembly for Harmony annotations and uses them to create patches</summary>
+            <param name="assembly">The assembly</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.Patch(System.Reflection.MethodBase,HarmonyLib.HarmonyMethod,HarmonyLib.HarmonyMethod,HarmonyLib.HarmonyMethod,HarmonyLib.HarmonyMethod)">
+             <summary>Creates patches by manually specifying the methods</summary>
+             <param name="original">The original method/constructor</param>
+             <param name="prefix">An optional prefix method wrapped in a <see cref="T:HarmonyLib.HarmonyMethod"/> object</param>
+             <param name="postfix">An optional postfix method wrapped in a <see cref="T:HarmonyLib.HarmonyMethod"/> object</param>
+             <param name="transpiler">An optional transpiler method wrapped in a <see cref="T:HarmonyLib.HarmonyMethod"/> object</param>
+             <param name="finalizer">An optional finalizer method wrapped in a <see cref="T:HarmonyLib.HarmonyMethod"/> object</param>
+             <returns>The replacement method that was created to patch the original method</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.ReversePatch(System.Reflection.MethodBase,HarmonyLib.HarmonyMethod,System.Reflection.MethodInfo)">
+            <summary>Patches a foreign method onto a stub method of yours and optionally applies transpilers during the process</summary>
+            <param name="original">The original method/constructor you want to duplicate</param>
+            <param name="standin">Your stub method as <see cref="T:HarmonyLib.HarmonyMethod"/> that will become the original. Needs to have the correct signature (either original or whatever your transpilers generates)</param>
+            <param name="transpiler">An optional transpiler as method that will be applied during the process</param>
+            <returns>The replacement method that was created to patch the stub method</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.UnpatchAll(System.String)">
+             <summary>Unpatches methods by patching them with zero patches. Fully unpatching is not supported. Be careful, unpatching is global</summary>
+             <param name="harmonyID">The optional Harmony ID to restrict unpatching to a specific Harmony instance</param>
+             <remarks>This method could be static if it wasn't for the fact that unpatching creates a new replacement method that contains your harmony ID</remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.Unpatch(System.Reflection.MethodBase,HarmonyLib.HarmonyPatchType,System.String)">
+             <summary>Unpatches a method by patching it with zero patches. Fully unpatching is not supported. Be careful, unpatching is global</summary>
+             <param name="original">The original method/constructor</param>
+             <param name="type">The <see cref="T:HarmonyLib.HarmonyPatchType"/></param>
+             <param name="harmonyID">The optional Harmony ID to restrict unpatching to a specific Harmony instance</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.Unpatch(System.Reflection.MethodBase,System.Reflection.MethodInfo)">
+             <summary>Unpatches a method by patching it with zero patches. Fully unpatching is not supported. Be careful, unpatching is global</summary>
+             <param name="original">The original method/constructor</param>
+             <param name="patch">The patch method as method to remove</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.HasAnyPatches(System.String)">
+             <summary>Test for patches from a specific Harmony ID</summary>
+             <param name="harmonyID">The Harmony ID</param>
+             <returns>True if patches for this ID exist</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.GetPatchInfo(System.Reflection.MethodBase)">
+             <summary>Gets patch information for a given original method</summary>
+             <param name="method">The original method/constructor</param>
+             <returns>The patch information as <see cref="T:HarmonyLib.Patches"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.GetPatchedMethods">
+             <summary>Gets the methods this instance has patched</summary>
+             <returns>An enumeration of original methods/constructors</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.GetAllPatchedMethods">
+             <summary>Gets all patched original methods in the appdomain</summary>
+             <returns>An enumeration of patched original methods/constructors</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.GetOriginalMethod(System.Reflection.MethodInfo)">
+             <summary>Gets the original method from a given replacement method</summary>
+             <param name="replacement">A replacement method, for example from a stacktrace</param>
+             <returns>The original method/constructor or <c>null</c> if not found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.GetMethodFromStackframe(System.Diagnostics.StackFrame)">
+             <summary>Tries to get the method from a stackframe including dynamic replacement methods</summary>
+             <param name="frame">The <see cref="T:System.Diagnostics.StackFrame"/></param>
+             <returns>For normal frames, <c>frame.GetMethod()</c> is returned. For frames containing patched methods, the replacement method is returned or <c>null</c> if no method can be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Harmony.VersionInfo(System.Version@)">
+             <summary>Gets Harmony version for all active Harmony instances</summary>
+             <param name="currentVersion">[out] The current Harmony version</param>
+             <returns>A dictionary containing assembly versions keyed by Harmony IDs</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyException">
+            <summary>Under Mono, HarmonyException wraps IL compile errors with detailed information about the failure</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
+            <summary>Default serialization constructor (not implemented)</summary>
+            <param name="serializationInfo">The info</param>
+            <param name="streamingContext">The context</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyException.GetInstructionsWithOffsets">
+            <summary>Get a list of IL instructions in pairs of offset+code</summary>
+            <returns>A list of key/value pairs which represent an offset and the code at that offset</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyException.GetInstructions">
+            <summary>Get a list of IL instructions without offsets</summary>
+            <returns>A list of <see cref="T:HarmonyLib.CodeInstruction"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyException.GetErrorOffset">
+            <summary>Get the error offset of the errornous IL instruction</summary>
+            <returns>The offset</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyException.GetErrorIndex">
+            <summary>Get the index of the errornous IL instruction</summary>
+            <returns>The index into the list of instructions or -1 if not found</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyMethod">
+            <summary>A wrapper around a method to use it as a patch (for example a Prefix)</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.method">
+            <summary>The original method</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.declaringType">
+            <summary>Class/type declaring this patch</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.methodName">
+            <summary>Patch method name</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.methodType">
+            <summary>Optional patch <see cref="T:HarmonyLib.MethodType"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.argumentTypes">
+            <summary>Array of argument types of the patch method</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.priority">
+            <summary><see cref="T:HarmonyLib.Priority"/> of the patch</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.before">
+            <summary>Install this patch before patches with these Harmony IDs</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.after">
+            <summary>Install this patch after patches with these Harmony IDs</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.reversePatchType">
+            <summary>Reverse patch type, see <see cref="T:HarmonyLib.HarmonyReversePatchType"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.debug">
+            <summary>Create debug output for this patch</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.HarmonyMethod.nonVirtualDelegate">
+            <summary>Whether to use <see cref="F:HarmonyLib.MethodDispatchType.Call"/> (<c>true</c>) or <see cref="F:HarmonyLib.MethodDispatchType.VirtualCall"/> (<c>false</c>) mechanics
+            for <see cref="T:HarmonyLib.HarmonyDelegate"/>-attributed delegate</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethod.#ctor">
+            <summary>Default constructor</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethod.#ctor(System.Reflection.MethodInfo)">
+             <summary>Creates a patch from a given method</summary>
+             <param name="method">The original method</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethod.#ctor(System.Reflection.MethodInfo,System.Int32,System.String[],System.String[],System.Nullable{System.Boolean})">
+             <summary>Creates a patch from a given method</summary>
+             <param name="method">The original method</param>
+             <param name="priority">The patch <see cref="T:HarmonyLib.Priority"/></param>
+             <param name="before">A list of harmony IDs that should come after this patch</param>
+             <param name="after">A list of harmony IDs that should come before this patch</param>
+             <param name="debug">Set to true to generate debug output</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethod.#ctor(System.Type,System.String,System.Type[])">
+             <summary>Creates a patch from a given method</summary>
+             <param name="methodType">The patch class/type</param>
+             <param name="methodName">The patch method name</param>
+             <param name="argumentTypes">The optional argument types of the patch method (for overloaded methods)</param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethod.HarmonyFields">
+             <summary>Gets the names of all internal patch info fields</summary>
+             <returns>A list of field names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethod.Merge(System.Collections.Generic.List{HarmonyLib.HarmonyMethod})">
+             <summary>Merges annotations</summary>
+             <param name="attributes">The list of <see cref="T:HarmonyLib.HarmonyMethod"/> to merge</param>
+             <returns>The merged <see cref="T:HarmonyLib.HarmonyMethod"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethod.ToString">
+             <summary>Returns a string that represents the annotation</summary>
+             <returns>A string representation</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.HarmonyMethodExtensions">
+            <summary>Annotation extensions</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethodExtensions.CopyTo(HarmonyLib.HarmonyMethod,HarmonyLib.HarmonyMethod)">
+             <summary>Copies annotation information</summary>
+             <param name="from">The source <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+             <param name="to">The destination <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethodExtensions.Clone(HarmonyLib.HarmonyMethod)">
+             <summary>Clones an annotation</summary>
+             <param name="original">The <see cref="T:HarmonyLib.HarmonyMethod"/> to clone</param>
+             <returns>A copied <see cref="T:HarmonyLib.HarmonyMethod"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethodExtensions.Merge(HarmonyLib.HarmonyMethod,HarmonyLib.HarmonyMethod)">
+             <summary>Merges annotations</summary>
+             <param name="master">The master <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+             <param name="detail">The detail <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+             <returns>A new, merged <see cref="T:HarmonyLib.HarmonyMethod"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethodExtensions.GetFromType(System.Type)">
+             <summary>Gets all annotations on a class/type</summary>
+             <param name="type">The class/type</param>
+             <returns>A list of all <see cref="T:HarmonyLib.HarmonyMethod"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethodExtensions.GetMergedFromType(System.Type)">
+             <summary>Gets merged annotations on a class/type</summary>
+             <param name="type">The class/type</param>
+             <returns>The merged <see cref="T:HarmonyLib.HarmonyMethod"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethodExtensions.GetFromMethod(System.Reflection.MethodBase)">
+             <summary>Gets all annotations on a method</summary>
+             <param name="method">The method/constructor</param>
+             <returns>A list of <see cref="T:HarmonyLib.HarmonyMethod"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.HarmonyMethodExtensions.GetMergedFromMethod(System.Reflection.MethodBase)">
+             <summary>Gets merged annotations on a method</summary>
+             <param name="method">The method/constructor</param>
+             <returns>The merged <see cref="T:HarmonyLib.HarmonyMethod"/></returns>
+            
+        </member>
+        <member name="T:HarmonyLib.InlineSignature">
+             <summary>
+             A mutable representation of an inline signature, similar to Mono.Cecil's CallSite.
+             Used by the calli instruction, can be used by transpilers
+             </summary>
+            
+        </member>
+        <member name="P:HarmonyLib.InlineSignature.HasThis">
+             <summary>See <see cref="F:System.Reflection.CallingConventions.HasThis"/></summary>
+            
+        </member>
+        <member name="P:HarmonyLib.InlineSignature.ExplicitThis">
+             <summary>See <see cref="F:System.Reflection.CallingConventions.ExplicitThis"/></summary>
+            
+        </member>
+        <member name="P:HarmonyLib.InlineSignature.CallingConvention">
+             <summary>See <see cref="T:System.Runtime.InteropServices.CallingConvention"/></summary>
+            
+        </member>
+        <member name="P:HarmonyLib.InlineSignature.Parameters">
+             <summary>The list of all parameter types or function pointer signatures received by the call site</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.InlineSignature.ReturnType">
+             <summary>The return type or function pointer signature returned by the call site</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.InlineSignature.ToString">
+             <summary>Returns a string representation of the inline signature</summary>
+             <returns>A string representation of the inline signature</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.InlineSignature.ModifierType">
+            <summary>
+            A mutable representation of a parameter type with an attached type modifier,
+            similar to Mono.Cecil's OptionalModifierType / RequiredModifierType and C#'s modopt / modreq
+            </summary>
+            
+        </member>
+        <member name="F:HarmonyLib.InlineSignature.ModifierType.IsOptional">
+             <summary>Whether this is a modopt (optional modifier type) or a modreq (required modifier type)</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.InlineSignature.ModifierType.Modifier">
+             <summary>The modifier type attached to the parameter type</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.InlineSignature.ModifierType.Type">
+             <summary>The modified parameter type</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.InlineSignature.ModifierType.ToString">
+             <summary>Returns a string representation of the modifier type</summary>
+             <returns>A string representation of the modifier type</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.PatchInfoSerialization">
+            <summary>Patch serialization</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfoSerialization.Binder.BindToType(System.String,System.String)">
+             <summary>Control the binding of a serialized object to a type</summary>
+             <param name="assemblyName">Specifies the assembly name of the serialized object</param>
+             <param name="typeName">Specifies the type name of the serialized object</param>
+             <returns>The type of the object the formatter creates a new instance of</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfoSerialization.Serialize(HarmonyLib.PatchInfo)">
+             <summary>Serializes a patch info</summary>
+             <param name="patchInfo">The <see cref="T:HarmonyLib.PatchInfo"/></param>
+             <returns>The serialized data</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfoSerialization.Deserialize(System.Byte[])">
+             <summary>Deserialize a patch info</summary>
+             <param name="bytes">The serialized data</param>
+             <returns>A <see cref="T:HarmonyLib.PatchInfo"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfoSerialization.PriorityComparer(System.Object,System.Int32,System.Int32)">
+             <summary>Compare function to sort patch priorities</summary>
+             <param name="obj">The patch</param>
+             <param name="index">Zero-based index</param>
+             <param name="priority">The priority</param>
+             <returns>A standard sort integer (-1, 0, 1)</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.PatchInfo">
+            <summary>Serializable patch information</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.PatchInfo.prefixes">
+            <summary>Prefixes as an array of <see cref="T:HarmonyLib.Patch"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.PatchInfo.postfixes">
+            <summary>Postfixes as an array of <see cref="T:HarmonyLib.Patch"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.PatchInfo.transpilers">
+            <summary>Transpilers as an array of <see cref="T:HarmonyLib.Patch"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.PatchInfo.finalizers">
+            <summary>Finalizers as an array of <see cref="T:HarmonyLib.Patch"/></summary>
+            
+        </member>
+        <member name="P:HarmonyLib.PatchInfo.Debugging">
+            <summary>Returns if any of the patches wants debugging turned on</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.AddPrefixes(System.String,HarmonyLib.HarmonyMethod[])">
+             <summary>Adds prefixes</summary>
+             <param name="owner">An owner (Harmony ID)</param>
+             <param name="methods">The patch methods</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.AddPrefix(System.Reflection.MethodInfo,System.String,System.Int32,System.String[],System.String[],System.Boolean)">
+            <summary>Adds a prefix</summary>
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.RemovePrefix(System.String)">
+             <summary>Removes prefixes</summary>
+             <param name="owner">The owner of the prefixes, or <c>*</c> for all</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.AddPostfixes(System.String,HarmonyLib.HarmonyMethod[])">
+             <summary>Adds postfixes</summary>
+             <param name="owner">An owner (Harmony ID)</param>
+             <param name="methods">The patch methods</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.AddPostfix(System.Reflection.MethodInfo,System.String,System.Int32,System.String[],System.String[],System.Boolean)">
+            <summary>Adds a postfix</summary>
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.RemovePostfix(System.String)">
+             <summary>Removes postfixes</summary>
+             <param name="owner">The owner of the postfixes, or <c>*</c> for all</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.AddTranspilers(System.String,HarmonyLib.HarmonyMethod[])">
+             <summary>Adds transpilers</summary>
+             <param name="owner">An owner (Harmony ID)</param>
+             <param name="methods">The patch methods</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.AddTranspiler(System.Reflection.MethodInfo,System.String,System.Int32,System.String[],System.String[],System.Boolean)">
+            <summary>Adds a transpiler</summary>
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.RemoveTranspiler(System.String)">
+             <summary>Removes transpilers</summary>
+             <param name="owner">The owner of the transpilers, or <c>*</c> for all</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.AddFinalizers(System.String,HarmonyLib.HarmonyMethod[])">
+             <summary>Adds finalizers</summary>
+             <param name="owner">An owner (Harmony ID)</param>
+             <param name="methods">The patch methods</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.AddFinalizer(System.Reflection.MethodInfo,System.String,System.Int32,System.String[],System.String[],System.Boolean)">
+            <summary>Adds a finalizer</summary>
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.RemoveFinalizer(System.String)">
+             <summary>Removes finalizers</summary>
+             <param name="owner">The owner of the finalizers, or <c>*</c> for all</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.RemovePatch(System.Reflection.MethodInfo)">
+             <summary>Removes a patch using its method</summary>
+             <param name="patch">The method of the patch to remove</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.Add(System.String,HarmonyLib.HarmonyMethod[],HarmonyLib.Patch[])">
+             <summary>Gets a concatenated list of patches</summary>
+             <param name="owner">The Harmony instance ID adding the new patches</param>
+             <param name="add">The patches to add</param>
+             <param name="current">The current patches</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchInfo.Remove(System.String,HarmonyLib.Patch[])">
+             <summary>Gets a list of patches with any from the given owner removed</summary>
+             <param name="owner">The owner of the methods, or <c>*</c> for all</param>
+             <param name="current">The current patches</param>
+            
+        </member>
+        <member name="T:HarmonyLib.Patch">
+            <summary>A serializable patch</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patch.index">
+            <summary>Zero-based index</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patch.owner">
+            <summary>The owner (Harmony ID)</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patch.priority">
+            <summary>The priority, see <see cref="T:HarmonyLib.Priority"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patch.before">
+            <summary>Keep this patch before the patches indicated in the list of Harmony IDs</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patch.after">
+            <summary>Keep this patch after the patches indicated in the list of Harmony IDs</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patch.debug">
+            <summary>A flag that will log the replacement method via <see cref="T:HarmonyLib.FileLog"/> every time this patch is used to build the replacement, even in the future</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.Patch.PatchMethod">
+            <summary>The method of the static patch method</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.Patch.#ctor(System.Reflection.MethodInfo,System.Int32,System.String,System.Int32,System.String[],System.String[],System.Boolean)">
+             <summary>Creates a patch</summary>
+             <param name="patch">The method of the patch</param>
+             <param name="index">Zero-based index</param>
+             <param name="owner">An owner (Harmony ID)</param>
+             <param name="priority">The priority, see <see cref="T:HarmonyLib.Priority"/></param>
+             <param name="before">A list of Harmony IDs for patches that should run after this patch</param>
+             <param name="after">A list of Harmony IDs for patches that should run before this patch</param>
+             <param name="debug">A flag that will log the replacement method via <see cref="T:HarmonyLib.FileLog"/> every time this patch is used to build the replacement, even in the future</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Patch.#ctor(HarmonyLib.HarmonyMethod,System.Int32,System.String)">
+            <summary>Creates a patch</summary>
+            <param name="method">The method of the patch</param>
+            <param name="index">Zero-based index</param>
+            <param name="owner">An owner (Harmony ID)</param>
+        </member>
+        <member name="M:HarmonyLib.Patch.GetMethod(System.Reflection.MethodBase)">
+             <summary>Get the patch method or a DynamicMethod if original patch method is a patch factory</summary>
+             <param name="original">The original method/constructor</param>
+             <returns>The method of the patch</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Patch.Equals(System.Object)">
+             <summary>Determines whether patches are equal</summary>
+             <param name="obj">The other patch</param>
+             <returns>true if equal</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Patch.CompareTo(System.Object)">
+             <summary>Determines how patches sort</summary>
+             <param name="obj">The other patch</param>
+             <returns>integer to define sort order (-1, 0, 1)</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Patch.GetHashCode">
+             <summary>Hash function</summary>
+             <returns>A hash code</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.PatchClassProcessor">
+            <summary>A PatchClassProcessor used to turn <see cref="T:HarmonyLib.HarmonyAttribute"/> on a class/type into patches</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchClassProcessor.#ctor(HarmonyLib.Harmony,System.Type)">
+             <summary>Creates a patch class processor by pointing out a class. Similar to PatchAll() but without searching through all classes.</summary>
+             <param name="instance">The Harmony instance</param>
+             <param name="type">The class to process (need to have at least a [HarmonyPatch] attribute)</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchClassProcessor.Patch">
+             <summary>Applies the patches</summary>
+             <returns>A list of all created replacement methods or null if patch class is not annotated</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.Patches">
+            <summary>A group of patches</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patches.Prefixes">
+            <summary>A collection of prefix <see cref="T:HarmonyLib.Patch"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patches.Postfixes">
+            <summary>A collection of postfix <see cref="T:HarmonyLib.Patch"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patches.Transpilers">
+            <summary>A collection of transpiler <see cref="T:HarmonyLib.Patch"/></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Patches.Finalizers">
+            <summary>A collection of finalizer <see cref="T:HarmonyLib.Patch"/></summary>
+            
+        </member>
+        <member name="P:HarmonyLib.Patches.Owners">
+             <summary>Gets all owners (Harmony IDs) or all known patches</summary>
+             <value>The patch owners</value>
+            
+        </member>
+        <member name="M:HarmonyLib.Patches.#ctor(HarmonyLib.Patch[],HarmonyLib.Patch[],HarmonyLib.Patch[],HarmonyLib.Patch[])">
+             <summary>Creates a group of patches</summary>
+             <param name="prefixes">An array of prefixes as <see cref="T:HarmonyLib.Patch"/></param>
+             <param name="postfixes">An array of postfixes as <see cref="T:HarmonyLib.Patch"/></param>
+             <param name="transpilers">An array of transpileres as <see cref="T:HarmonyLib.Patch"/></param>
+             <param name="finalizers">An array of finalizeres as <see cref="T:HarmonyLib.Patch"/></param>
+            
+        </member>
+        <member name="T:HarmonyLib.PatchProcessor">
+            <summary>A PatchProcessor handles patches on a method/constructor</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.#ctor(HarmonyLib.Harmony,System.Reflection.MethodBase)">
+             <summary>Creates an empty patch processor</summary>
+             <param name="instance">The Harmony instance</param>
+             <param name="original">The original method/constructor</param>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.AddPrefix(HarmonyLib.HarmonyMethod)">
+             <summary>Adds a prefix</summary>
+             <param name="prefix">The prefix as a <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.AddPrefix(System.Reflection.MethodInfo)">
+             <summary>Adds a prefix</summary>
+             <param name="fixMethod">The prefix method</param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.AddPostfix(HarmonyLib.HarmonyMethod)">
+             <summary>Adds a postfix</summary>
+             <param name="postfix">The postfix as a <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.AddPostfix(System.Reflection.MethodInfo)">
+             <summary>Adds a postfix</summary>
+             <param name="fixMethod">The postfix method</param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.AddTranspiler(HarmonyLib.HarmonyMethod)">
+             <summary>Adds a transpiler</summary>
+             <param name="transpiler">The transpiler as a <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.AddTranspiler(System.Reflection.MethodInfo)">
+             <summary>Adds a transpiler</summary>
+             <param name="fixMethod">The transpiler method</param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.AddFinalizer(HarmonyLib.HarmonyMethod)">
+             <summary>Adds a finalizer</summary>
+             <param name="finalizer">The finalizer as a <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.AddFinalizer(System.Reflection.MethodInfo)">
+             <summary>Adds a finalizer</summary>
+             <param name="fixMethod">The finalizer method</param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.GetAllPatchedMethods">
+             <summary>Gets all patched original methods in the appdomain</summary>
+             <returns>An enumeration of patched method/constructor</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.Patch">
+             <summary>Applies all registered patches</summary>
+             <returns>The generated replacement method</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.Unpatch(HarmonyLib.HarmonyPatchType,System.String)">
+             <summary>Unpatches patches of a given type and/or Harmony ID</summary>
+             <param name="type">The <see cref="T:HarmonyLib.HarmonyPatchType"/> patch type</param>
+             <param name="harmonyID">Harmony ID or <c>*</c> for any</param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.Unpatch(System.Reflection.MethodInfo)">
+             <summary>Unpatches a specific patch</summary>
+             <param name="patch">The method of the patch</param>
+             <returns>A <see cref="T:HarmonyLib.PatchProcessor"/> for chaining calls</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.GetPatchInfo(System.Reflection.MethodBase)">
+             <summary>Gets patch information on an original</summary>
+             <param name="method">The original method/constructor</param>
+             <returns>The patch information as <see cref="T:HarmonyLib.Patches"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.GetSortedPatchMethods(System.Reflection.MethodBase,HarmonyLib.Patch[])">
+             <summary>Sort patch methods by their priority rules</summary>
+             <param name="original">The original method</param>
+             <param name="patches">Patches to sort</param>
+             <returns>The sorted patch methods</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.VersionInfo(System.Version@)">
+             <summary>Gets Harmony version for all active Harmony instances</summary>
+             <param name="currentVersion">[out] The current Harmony version</param>
+             <returns>A dictionary containing assembly version keyed by Harmony ID</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.CreateILGenerator">
+            <summary>Creates a new empty <see cref="T:System.Reflection.Emit.ILGenerator">generator</see> to use when reading method bodies</summary>
+            <returns>A new <see cref="T:System.Reflection.Emit.ILGenerator"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.CreateILGenerator(System.Reflection.MethodBase)">
+            <summary>Creates a new <see cref="T:System.Reflection.Emit.ILGenerator">generator</see> matching the method/constructor to use when reading method bodies</summary>
+            <param name="original">The original method/constructor to copy method information from</param>
+            <returns>A new <see cref="T:System.Reflection.Emit.ILGenerator"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.GetOriginalInstructions(System.Reflection.MethodBase,System.Reflection.Emit.ILGenerator)">
+            <summary>Returns the methods unmodified list of code instructions</summary>
+            <param name="original">The original method/constructor</param>
+            <param name="generator">Optionally an existing generator that will be used to create all local variables and labels contained in the result (if not specified, an internal generator is used)</param>
+            <returns>A list containing all the original <see cref="T:HarmonyLib.CodeInstruction"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.GetOriginalInstructions(System.Reflection.MethodBase,System.Reflection.Emit.ILGenerator@)">
+            <summary>Returns the methods unmodified list of code instructions</summary>
+            <param name="original">The original method/constructor</param>
+            <param name="generator">A new generator that now contains all local variables and labels contained in the result</param>
+            <returns>A list containing all the original <see cref="T:HarmonyLib.CodeInstruction"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.GetCurrentInstructions(System.Reflection.MethodBase,System.Int32,System.Reflection.Emit.ILGenerator)">
+            <summary>Returns the methods current list of code instructions after all existing transpilers have been applied</summary>
+            <param name="original">The original method/constructor</param>
+            <param name="maxTranspilers">Apply only the first count of transpilers</param>
+            <param name="generator">Optionally an existing generator that will be used to create all local variables and labels contained in the result (if not specified, an internal generator is used)</param>
+            <returns>A list of <see cref="T:HarmonyLib.CodeInstruction"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.GetCurrentInstructions(System.Reflection.MethodBase,System.Reflection.Emit.ILGenerator@,System.Int32)">
+            <summary>Returns the methods current list of code instructions after all existing transpilers have been applied</summary>
+            <param name="original">The original method/constructor</param>
+            <param name="generator">A new generator that now contains all local variables and labels contained in the result</param>
+            <param name="maxTranspilers">Apply only the first count of transpilers</param>
+            <returns>A list of <see cref="T:HarmonyLib.CodeInstruction"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.ReadMethodBody(System.Reflection.MethodBase)">
+             <summary>A low level way to read the body of a method. Used for quick searching in methods</summary>
+             <param name="method">The original method</param>
+             <returns>All instructions as opcode/operand pairs</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.PatchProcessor.ReadMethodBody(System.Reflection.MethodBase,System.Reflection.Emit.ILGenerator)">
+             <summary>A low level way to read the body of a method. Used for quick searching in methods</summary>
+             <param name="method">The original method</param>
+             <param name="generator">An existing generator that will be used to create all local variables and labels contained in the result</param>
+             <returns>All instructions as opcode/operand pairs</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.Priority">
+            <summary>A patch priority</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.Last">
+            <summary>Patch last</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.VeryLow">
+            <summary>Patch with very low priority</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.Low">
+            <summary>Patch with low priority</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.LowerThanNormal">
+            <summary>Patch with lower than normal priority</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.Normal">
+            <summary>Patch with normal priority</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.HigherThanNormal">
+            <summary>Patch with higher than normal priority</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.High">
+            <summary>Patch with high priority</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.VeryHigh">
+            <summary>Patch with very high priority</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.Priority.First">
+            <summary>Patch first</summary>
+            
+        </member>
+        <member name="T:HarmonyLib.ReversePatcher">
+            <summary>A reverse patcher</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.ReversePatcher.#ctor(HarmonyLib.Harmony,System.Reflection.MethodBase,HarmonyLib.HarmonyMethod)">
+             <summary>Creates a reverse patcher</summary>
+             <param name="instance">The Harmony instance</param>
+             <param name="original">The original method/constructor</param>
+             <param name="standin">Your stand-in stub method as <see cref="T:HarmonyLib.HarmonyMethod"/></param>
+            
+        </member>
+        <member name="M:HarmonyLib.ReversePatcher.Patch(HarmonyLib.HarmonyReversePatchType)">
+             <summary>Applies the patch</summary>
+             <param name="type">The type of patch, see <see cref="T:HarmonyLib.HarmonyReversePatchType"/></param>
+             <returns>The generated replacement method</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.Transpilers">
+            <summary>A collection of commonly used transpilers</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.Transpilers.MethodReplacer(System.Collections.Generic.IEnumerable{HarmonyLib.CodeInstruction},System.Reflection.MethodBase,System.Reflection.MethodBase)">
+             <summary>A transpiler that replaces all occurrences of a given method with another one using the same signature</summary>
+             <param name="instructions">The enumeration of <see cref="T:HarmonyLib.CodeInstruction"/> to act on</param>
+             <param name="from">Method or constructor to search for</param>
+             <param name="to">Method or constructor to replace with</param>
+             <returns>Modified enumeration of <see cref="T:HarmonyLib.CodeInstruction"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Transpilers.Manipulator(System.Collections.Generic.IEnumerable{HarmonyLib.CodeInstruction},System.Func{HarmonyLib.CodeInstruction,System.Boolean},System.Action{HarmonyLib.CodeInstruction})">
+             <summary>A transpiler that alters instructions that match a predicate by calling an action</summary>
+             <param name="instructions">The enumeration of <see cref="T:HarmonyLib.CodeInstruction"/> to act on</param>
+             <param name="predicate">A predicate selecting the instructions to change</param>
+             <param name="action">An action to apply to matching instructions</param>
+             <returns>Modified enumeration of <see cref="T:HarmonyLib.CodeInstruction"/></returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Transpilers.DebugLogger(System.Collections.Generic.IEnumerable{HarmonyLib.CodeInstruction},System.String)">
+             <summary>A transpiler that logs a text at the beginning of the method</summary>
+             <param name="instructions">The instructions to act on</param>
+             <param name="text">The log text</param>
+             <returns>Modified enumeration of <see cref="T:HarmonyLib.CodeInstruction"/></returns>
+            
+        </member>
+        <member name="T:HarmonyLib.AccessTools">
+             <summary>A helper class for reflection related functions</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.AccessTools.all">
+             <summary>Shortcut for <see cref="T:System.Reflection.BindingFlags"/> to simplify the use of reflections and make it work for any access level</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.AccessTools.allDeclared">
+             <summary>Shortcut for <see cref="T:System.Reflection.BindingFlags"/> to simplify the use of reflections and make it work for any access level but only within the current type</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.AllAssemblies">
+            <summary>Enumerates all assemblies in the current app domain, excluding visual studio assemblies</summary>
+            <returns>An enumeration of <see cref="T:System.Reflection.Assembly"/></returns>
+        </member>
+        <member name="M:HarmonyLib.AccessTools.TypeByName(System.String)">
+             <summary>Gets a type by name. Prefers a full name with namespace but falls back to the first type matching the name otherwise</summary>
+             <param name="name">The name</param>
+             <returns>A type or null if not found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetTypesFromAssembly(System.Reflection.Assembly)">
+             <summary>Gets all successfully loaded types from a given assembly</summary>
+             <param name="assembly">The assembly</param>
+             <returns>An array of types</returns>
+             <remarks>
+             This calls and returns <see cref="M:System.Reflection.Assembly.GetTypes"/>, while catching any thrown <see cref="T:System.Reflection.ReflectionTypeLoadException"/>.
+             If such an exception is thrown, returns the successfully loaded types (<see cref="P:System.Reflection.ReflectionTypeLoadException.Types"/>,
+             filtered for non-null values).
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.AllTypes">
+            <summary>Enumerates all successfully loaded types in the current app domain, excluding visual studio assemblies</summary>
+            <returns>An enumeration of all <see cref="T:System.Type"/> in all assemblies, excluding visual studio assemblies</returns>
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FindIncludingBaseTypes``1(System.Type,System.Func{System.Type,``0})">
+             <summary>Applies a function going up the type hierarchy and stops at the first non-<c>null</c> result</summary>
+             <typeparam name="T">Result type of func()</typeparam>
+             <param name="type">The class/type to start with</param>
+             <param name="func">The evaluation function returning T</param>
+             <returns>The first non-<c>null</c> result, or <c>null</c> if no match</returns>
+             <remarks>
+             The type hierarchy of a class or value type (including struct) does NOT include implemented interfaces,
+             and the type hierarchy of an interface is only itself (regardless of whether that interface implements other interfaces).
+             The top-most type in the type hierarchy of all non-interface types (including value types) is <see cref="T:System.Object"/>.
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FindIncludingInnerTypes``1(System.Type,System.Func{System.Type,``0})">
+             <summary>Applies a function going into inner types and stops at the first non-<c>null</c> result</summary>
+             <typeparam name="T">Generic type parameter</typeparam>
+             <param name="type">The class/type to start with</param>
+             <param name="func">The evaluation function returning T</param>
+             <returns>The first non-<c>null</c> result, or <c>null</c> if no match</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredField(System.Type,System.String)">
+             <summary>Gets the reflection information for a directly declared field</summary>
+             <param name="type">The class/type where the field is defined</param>
+             <param name="name">The name of the field</param>
+             <returns>A field or null when type/name is null or when the field cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.Field(System.Type,System.String)">
+             <summary>Gets the reflection information for a field by searching the type and all its super types</summary>
+             <param name="type">The class/type where the field is defined</param>
+             <param name="name">The name of the field (case sensitive)</param>
+             <returns>A field or null when type/name is null or when the field cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredField(System.Type,System.Int32)">
+             <summary>Gets the reflection information for a field</summary>
+             <param name="type">The class/type where the field is declared</param>
+             <param name="idx">The zero-based index of the field inside the class definition</param>
+             <returns>A field or null when type is null or when the field cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredProperty(System.Type,System.String)">
+             <summary>Gets the reflection information for a directly declared property</summary>
+             <param name="type">The class/type where the property is declared</param>
+             <param name="name">The name of the property (case sensitive)</param>
+             <returns>A property or null when type/name is null or when the property cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredPropertyGetter(System.Type,System.String)">
+             <summary>Gets the reflection information for the getter method of a directly declared property</summary>
+             <param name="type">The class/type where the property is declared</param>
+             <param name="name">The name of the property (case sensitive)</param>
+             <returns>A method or null when type/name is null or when the property cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredPropertySetter(System.Type,System.String)">
+             <summary>Gets the reflection information for the setter method of a directly declared property</summary>
+             <param name="type">The class/type where the property is declared</param>
+             <param name="name">The name of the property (case sensitive)</param>
+             <returns>A method or null when type/name is null or when the property cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.Property(System.Type,System.String)">
+             <summary>Gets the reflection information for a property by searching the type and all its super types</summary>
+             <param name="type">The class/type</param>
+             <param name="name">The name</param>
+             <returns>A property or null when type/name is null or when the property cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.PropertyGetter(System.Type,System.String)">
+             <summary>Gets the reflection information for the getter method of a property by searching the type and all its super types</summary>
+             <param name="type">The class/type</param>
+             <param name="name">The name</param>
+             <returns>A method or null when type/name is null or when the property cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.PropertySetter(System.Type,System.String)">
+             <summary>Gets the reflection information for the setter method of a property by searching the type and all its super types</summary>
+             <param name="type">The class/type</param>
+             <param name="name">The name</param>
+             <returns>A method or null when type/name is null or when the property cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredMethod(System.Type,System.String,System.Type[],System.Type[])">
+             <summary>Gets the reflection information for a directly declared method</summary>
+             <param name="type">The class/type where the method is declared</param>
+             <param name="name">The name of the method (case sensitive)</param>
+             <param name="parameters">Optional parameters to target a specific overload of the method</param>
+             <param name="generics">Optional list of types that define the generic version of the method</param>
+             <returns>A method or null when type/name is null or when the method cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.Method(System.Type,System.String,System.Type[],System.Type[])">
+             <summary>Gets the reflection information for a method by searching the type and all its super types</summary>
+             <param name="type">The class/type where the method is declared</param>
+             <param name="name">The name of the method (case sensitive)</param>
+             <param name="parameters">Optional parameters to target a specific overload of the method</param>
+             <param name="generics">Optional list of types that define the generic version of the method</param>
+             <returns>A method or null when type/name is null or when the method cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.Method(System.String,System.Type[],System.Type[])">
+             <summary>Gets the reflection information for a method by searching the type and all its super types</summary>
+             <param name="typeColonMethodname">The target method in the form <c>TypeFullName:MethodName</c>, where the type name matches a form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <param name="parameters">Optional parameters to target a specific overload of the method</param>
+             <param name="generics">Optional list of types that define the generic version of the method</param>
+             <returns>A method or null when type/name is null or when the method cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetMethodNames(System.Type)">
+             <summary>Gets the names of all method that are declared in a type</summary>
+             <param name="type">The declaring class/type</param>
+             <returns>A list of method names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetMethodNames(System.Object)">
+             <summary>Gets the names of all method that are declared in the type of the instance</summary>
+             <param name="instance">An instance of the type to search in</param>
+             <returns>A list of method names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetFieldNames(System.Type)">
+             <summary>Gets the names of all fields that are declared in a type</summary>
+             <param name="type">The declaring class/type</param>
+             <returns>A list of field names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetFieldNames(System.Object)">
+             <summary>Gets the names of all fields that are declared in the type of the instance</summary>
+             <param name="instance">An instance of the type to search in</param>
+             <returns>A list of field names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetPropertyNames(System.Type)">
+             <summary>Gets the names of all properties that are declared in a type</summary>
+             <param name="type">The declaring class/type</param>
+             <returns>A list of property names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetPropertyNames(System.Object)">
+             <summary>Gets the names of all properties that are declared in the type of the instance</summary>
+             <param name="instance">An instance of the type to search in</param>
+             <returns>A list of property names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetUnderlyingType(System.Reflection.MemberInfo)">
+             <summary>Gets the type of any class member of</summary>
+             <param name="member">A member</param>
+             <returns>The class/type of this member</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsDeclaredMember``1(``0)">
+             <summary>Test if a class member is actually an concrete implementation</summary>
+             <param name="member">A member</param>
+             <returns>True if the member is a declared</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetDeclaredMember``1(``0)">
+             <summary>Gets the real implementation of a class member</summary>
+             <param name="member">A member</param>
+             <returns>The member itself if its declared. Otherwise the member that is actually implemented in some base type</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredConstructor(System.Type,System.Type[],System.Boolean)">
+             <summary>Gets the reflection information for a directly declared constructor</summary>
+             <param name="type">The class/type where the constructor is declared</param>
+             <param name="parameters">Optional parameters to target a specific overload of the constructor</param>
+             <param name="searchForStatic">Optional parameters to only consider static constructors</param>
+             <returns>A constructor info or null when type is null or when the constructor cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.Constructor(System.Type,System.Type[],System.Boolean)">
+             <summary>Gets the reflection information for a constructor by searching the type and all its super types</summary>
+             <param name="type">The class/type where the constructor is declared</param>
+             <param name="parameters">Optional parameters to target a specific overload of the method</param>
+             <param name="searchForStatic">Optional parameters to only consider static constructors</param>
+             <returns>A constructor info or null when type is null or when the method cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetDeclaredConstructors(System.Type,System.Nullable{System.Boolean})">
+             <summary>Gets reflection information for all declared constructors</summary>
+             <param name="type">The class/type where the constructors are declared</param>
+             <param name="searchForStatic">Optional parameters to only consider static constructors</param>
+             <returns>A list of constructor infos</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetDeclaredMethods(System.Type)">
+             <summary>Gets reflection information for all declared methods</summary>
+             <param name="type">The class/type where the methods are declared</param>
+             <returns>A list of methods</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetDeclaredProperties(System.Type)">
+             <summary>Gets reflection information for all declared properties</summary>
+             <param name="type">The class/type where the properties are declared</param>
+             <returns>A list of properties</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetDeclaredFields(System.Type)">
+             <summary>Gets reflection information for all declared fields</summary>
+             <param name="type">The class/type where the fields are declared</param>
+             <returns>A list of fields</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetReturnedType(System.Reflection.MethodBase)">
+             <summary>Gets the return type of a method or constructor</summary>
+             <param name="methodOrConstructor">The method/constructor</param>
+             <returns>The return type</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.Inner(System.Type,System.String)">
+             <summary>Given a type, returns the first inner type matching a recursive search by name</summary>
+             <param name="type">The class/type to start searching at</param>
+             <param name="name">The name of the inner type (case sensitive)</param>
+             <returns>The inner type or null if type/name is null or if a type with that name cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FirstInner(System.Type,System.Func{System.Type,System.Boolean})">
+             <summary>Given a type, returns the first inner type matching a recursive search with a predicate</summary>
+             <param name="type">The class/type to start searching at</param>
+             <param name="predicate">The predicate to search with</param>
+             <returns>The inner type or null if type/predicate is null or if a type with that name cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FirstMethod(System.Type,System.Func{System.Reflection.MethodInfo,System.Boolean})">
+             <summary>Given a type, returns the first method matching a predicate</summary>
+             <param name="type">The class/type to start searching at</param>
+             <param name="predicate">The predicate to search with</param>
+             <returns>The method or null if type/predicate is null or if a type with that name cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FirstConstructor(System.Type,System.Func{System.Reflection.ConstructorInfo,System.Boolean})">
+             <summary>Given a type, returns the first constructor matching a predicate</summary>
+             <param name="type">The class/type to start searching at</param>
+             <param name="predicate">The predicate to search with</param>
+             <returns>The constructor info or null if type/predicate is null or if a type with that name cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FirstProperty(System.Type,System.Func{System.Reflection.PropertyInfo,System.Boolean})">
+             <summary>Given a type, returns the first property matching a predicate</summary>
+             <param name="type">The class/type to start searching at</param>
+             <param name="predicate">The predicate to search with</param>
+             <returns>The property or null if type/predicate is null or if a type with that name cannot be found</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetTypes(System.Object[])">
+             <summary>Returns an array containing the type of each object in the given array</summary>
+             <param name="parameters">An array of objects</param>
+             <returns>An array of types or an empty array if parameters is null (if an object is null, the type for it will be object)</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.ActualParameters(System.Reflection.MethodBase,System.Object[])">
+             <summary>Creates an array of input parameters for a given method and a given set of potential inputs</summary>
+             <param name="method">The method/constructor you are planing to call</param>
+             <param name="inputs"> The possible input parameters in any order</param>
+             <returns>An object array matching the method signature</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.AccessTools.FieldRef`2">
+             <summary>A readable/assignable reference delegate to an instance field of a class or static field (NOT an instance field of a struct)</summary>
+             <typeparam name="T">
+             An arbitrary type if the field is static; otherwise the class that defines the field, or a parent class (including <see cref="T:System.Object"/>),
+             implemented interface, or derived class of this type
+             </typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="instance">The runtime instance to access the field (ignored and can be omitted for static fields)</param>
+             <returns>A readable/assignable reference to the field</returns>
+             <exception cref="T:System.NullReferenceException">Null instance passed to a non-static field ref delegate</exception>
+             <exception cref="T:System.InvalidCastException">
+             Instance of invalid type passed to a non-static field ref delegate
+             (this can happen if <typeparamref name="T"/> is a parent class or interface of the field's declaring type)
+             </exception>
+             <remarks>
+             <para>
+             This delegate cannot be used for instance fields of structs, since a struct instance passed to the delegate would be passed by
+             value and thus would be a copy that only exists within the delegate's invocation. This is fine for a readonly reference,
+             but makes assignment futile. Use <see cref="T:HarmonyLib.AccessTools.StructFieldRef`2"/> instead.
+             </para>
+             <para>
+             Note that <typeparamref name="T"/> is not required to be the field's declaring type. It can be a parent class (including <see cref="T:System.Object"/>),
+             implemented interface, or a derived class of the field's declaring type ("<c>instanceOfT is FieldDeclaringType</c>" must be possible).
+             Specifically, <typeparamref name="F"/> must be <see cref="M:System.Type.IsAssignableFrom(System.Type)">assignable from</see> OR to the field's declaring type.
+             Technically, this allows <c>Nullable</c>, although <c>Nullable</c> is only relevant for structs, and since only static fields of structs
+             are allowed for this delegate, and the instance passed to such a delegate is ignored, this hardly matters.
+             </para>
+             <para>
+             Similarly, <typeparamref name="F"/> is not required to be the field's field type, unless that type is a non-enum value type.
+             It can be a parent class (including <c>object</c>) or implemented interface of the field's field type. It cannot be a derived class.
+             This variance is not allowed for value types, since that would require boxing/unboxing, which is not allowed for ref values.
+             Special case for enum types: <typeparamref name="F"/> can also be the underlying integral type of the enum type.
+             Specifically, for reference types, <typeparamref name="F"/> must be <see cref="M:System.Type.IsAssignableFrom(System.Type)">assignable from</see>
+             the field's field type; for non-enum value types, <typeparamref name="F"/> must be exactly the field's field type; for enum types,
+             <typeparamref name="F"/> must be either the field's field type or the underyling integral type of that field type.
+             </para>
+             <para>
+             This delegate supports static fields, even those defined in structs, for legacy reasons.
+             For such static fields, <typeparamref name="T"/> is effectively ignored.
+             Consider using <see cref="T:HarmonyLib.AccessTools.FieldRef`1"/> (and <c>StaticFieldRefAccess</c> methods that return it) instead for static fields.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FieldRefAccess``2(System.String)">
+             <summary>Creates a field reference delegate for an instance field of a class</summary>
+             <typeparam name="T">The class that defines the instance field, or derived class of this type</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="fieldName">The name of the field</param>
+             <returns>A readable/assignable <see cref="T:HarmonyLib.AccessTools.FieldRef`2"/> delegate</returns>
+             <remarks>
+             <para>
+             For backwards compatibility, there is no class constraint on <typeparamref name="T"/>.
+             Instead, the non-value-type check is done at runtime within the method.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FieldRefAccess``2(``0,System.String)">
+             <summary>Creates an instance field reference for a specific instance of a class</summary>
+             <typeparam name="T">The class that defines the instance field, or derived class of this type</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="instance">The instance</param>
+             <param name="fieldName">The name of the field</param>
+             <returns>A readable/assignable reference to the field</returns>
+             <remarks>
+             <para>
+             This method is meant for one-off access to a field's value for a single instance.
+             If you need to access a field's value for potentially multiple instances, use <see cref="M:HarmonyLib.AccessTools.FieldRefAccess``2(System.String)"/> instead.
+             <c>FieldRefAccess&lt;T, F&gt;(instance, fieldName)</c> is functionally equivalent to <c>FieldRefAccess&lt;T, F&gt;(fieldName)(instance)</c>.
+             </para>
+             <para>
+             For backwards compatibility, there is no class constraint on <typeparamref name="T"/>.
+             Instead, the non-value-type check is done at runtime within the method.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FieldRefAccess``1(System.Type,System.String)">
+             <summary>Creates a field reference delegate for an instance field of a class or static field (NOT an instance field of a struct)</summary>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="type">
+             The type that defines the field, or derived class of this type; must not be a struct type unless the field is static
+             </param>
+             <param name="fieldName">The name of the field</param>
+             <returns>
+             A readable/assignable <see cref="T:HarmonyLib.AccessTools.FieldRef`2"/> delegate with <c>T=object</c>
+             (for static fields, the <c>instance</c> delegate parameter is ignored)
+             </returns>
+             <remarks>
+             <para>
+             This method is meant for cases where the given type is only known at runtime and thus can't be used as a type parameter <c>T</c>
+             in e.g. <see cref="M:HarmonyLib.AccessTools.FieldRefAccess``2(System.String)"/>.
+             </para>
+             <para>
+             This method supports static fields, even those defined in structs, for legacy reasons.
+             Consider using <see cref="M:HarmonyLib.AccessTools.StaticFieldRefAccess``1(System.Type,System.String)"/> (and other overloads) instead for static fields.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FieldRefAccess``2(System.Reflection.FieldInfo)">
+             <summary>Creates a field reference delegate for an instance field of a class or static field (NOT an instance field of a struct)</summary>
+             <typeparam name="T">
+             An arbitrary type if the field is static; otherwise the class that defines the field, or a parent class (including <see cref="T:System.Object"/>),
+             implemented interface, or derived class of this type ("<c>instanceOfT is FieldDeclaringType</c>" must be possible)
+             </typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="fieldInfo">The field</param>
+             <returns>A readable/assignable <see cref="T:HarmonyLib.AccessTools.FieldRef`2"/> delegate</returns>
+             <remarks>
+             <para>
+             This method is meant for cases where the field has already been obtained, avoiding the field searching cost in
+             e.g. <see cref="M:HarmonyLib.AccessTools.FieldRefAccess``2(System.String)"/>.
+             </para>
+             <para>
+             This method supports static fields, even those defined in structs, for legacy reasons.
+             For such static fields, <typeparamref name="T"/> is effectively ignored.
+             Consider using <see cref="M:HarmonyLib.AccessTools.StaticFieldRefAccess``2(System.Reflection.FieldInfo)"/> (and other overloads) instead for static fields.
+             </para>
+             <para>
+             For backwards compatibility, there is no class constraint on <typeparamref name="T"/>.
+             Instead, the non-value-type check is done at runtime within the method.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.FieldRefAccess``2(``0,System.Reflection.FieldInfo)">
+             <summary>Creates a field reference for an instance field of a class</summary>
+             <typeparam name="T">
+             The type that defines the field; or a parent class (including <see cref="T:System.Object"/>), implemented interface, or derived class of this type
+             ("<c>instanceOfT is FieldDeclaringType</c>" must be possible)
+             </typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="instance">The instance</param>
+             <param name="fieldInfo">The field</param>
+             <returns>A readable/assignable reference to the field</returns>
+             <remarks>
+             <para>
+             This method is meant for one-off access to a field's value for a single instance and where the field has already been obtained.
+             If you need to access a field's value for potentially multiple instances, use <see cref="M:HarmonyLib.AccessTools.FieldRefAccess``2(System.Reflection.FieldInfo)"/> instead.
+             <c>FieldRefAccess&lt;T, F&gt;(instance, fieldInfo)</c> is functionally equivalent to <c>FieldRefAccess&lt;T, F&gt;(fieldInfo)(instance)</c>.
+             </para>
+             <para>
+             For backwards compatibility, there is no class constraint on <typeparamref name="T"/>.
+             Instead, the non-value-type check is done at runtime within the method.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="T:HarmonyLib.AccessTools.StructFieldRef`2">
+             <summary>A readable/assignable reference delegate to an instance field of a struct</summary>
+             <typeparam name="T">The struct that defines the instance field</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="instance">A reference to the runtime instance to access the field</param>
+             <returns>A readable/assignable reference to the field</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StructFieldRefAccess``2(System.String)">
+             <summary>Creates a field reference delegate for an instance field of a struct</summary>
+             <typeparam name="T">The struct that defines the instance field</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="fieldName">The name of the field</param>
+             <returns>A readable/assignable <see cref="T:HarmonyLib.AccessTools.StructFieldRef`2"/> delegate</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StructFieldRefAccess``2(``0@,System.String)">
+             <summary>Creates an instance field reference for a specific instance of a struct</summary>
+             <typeparam name="T">The struct that defines the instance field</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="instance">The instance</param>
+             <param name="fieldName">The name of the field</param>
+             <returns>A readable/assignable reference to the field</returns>
+             <remarks>
+             <para>
+             This method is meant for one-off access to a field's value for a single instance.
+             If you need to access a field's value for potentially multiple instances, use <see cref="M:HarmonyLib.AccessTools.StructFieldRefAccess``2(System.String)"/> instead.
+             <c>StructFieldRefAccess&lt;T, F&gt;(ref instance, fieldName)</c> is functionally equivalent to <c>StructFieldRefAccess&lt;T, F&gt;(fieldName)(ref instance)</c>.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StructFieldRefAccess``2(System.Reflection.FieldInfo)">
+             <summary>Creates a field reference delegate for an instance field of a struct</summary>
+             <typeparam name="T">The struct that defines the instance field</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="fieldInfo">The field</param>
+             <returns>A readable/assignable <see cref="T:HarmonyLib.AccessTools.StructFieldRef`2"/> delegate</returns>
+             <remarks>
+             <para>
+             This method is meant for cases where the field has already been obtained, avoiding the field searching cost in
+             e.g. <see cref="M:HarmonyLib.AccessTools.StructFieldRefAccess``2(System.String)"/>.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StructFieldRefAccess``2(``0@,System.Reflection.FieldInfo)">
+             <summary>Creates a field reference for an instance field of a struct</summary>
+             <typeparam name="T">The struct that defines the instance field</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="instance">The instance</param>
+             <param name="fieldInfo">The field</param>
+             <returns>A readable/assignable reference to the field</returns>
+             <remarks>
+             <para>
+             This method is meant for one-off access to a field's value for a single instance and where the field has already been obtained.
+             If you need to access a field's value for potentially multiple instances, use <see cref="M:HarmonyLib.AccessTools.StructFieldRefAccess``2(System.Reflection.FieldInfo)"/> instead.
+             <c>StructFieldRefAccess&lt;T, F&gt;(ref instance, fieldInfo)</c> is functionally equivalent to <c>StructFieldRefAccess&lt;T, F&gt;(fieldInfo)(ref instance)</c>.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="T:HarmonyLib.AccessTools.FieldRef`1">
+             <summary>A readable/assignable reference delegate to a static field</summary>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <returns>A readable/assignable reference to the field</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StaticFieldRefAccess``2(System.String)">
+             <summary>Creates a static field reference</summary>
+             <typeparam name="T">The type (can be class or struct) the field is defined in</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="fieldName">The name of the field</param>
+             <returns>A readable/assignable reference to the field</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StaticFieldRefAccess``1(System.Type,System.String)">
+             <summary>Creates a static field reference</summary>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="type">The type (can be class or struct) the field is defined in</param>
+             <param name="fieldName">The name of the field</param>
+             <returns>A readable/assignable reference to the field</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StaticFieldRefAccess``2(System.Reflection.FieldInfo)">
+             <summary>Creates a static field reference</summary>
+             <typeparam name="T">An arbitrary type (by convention, the type the field is defined in)</typeparam>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="fieldInfo">The field</param>
+             <returns>A readable/assignable reference to the field</returns>
+             <remarks>
+             The type parameter <typeparamref name="T"/> is only used in exception messaging and to distinguish between this method overload
+             and the <see cref="M:HarmonyLib.AccessTools.StaticFieldRefAccess``1(System.Reflection.FieldInfo)"/> overload (which returns a <see cref="T:HarmonyLib.AccessTools.FieldRef`1"/> rather than a reference).
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StaticFieldRefAccess``1(System.Reflection.FieldInfo)">
+             <summary>Creates a static field reference delegate</summary>
+             <typeparam name="F">
+             The type of the field; or if the field's type is a reference type (a class or interface, NOT a struct or other value type),
+             a type that <see cref="M:System.Type.IsAssignableFrom(System.Type)">is assignable from</see> that type; or if the field's type is an enum type,
+             either that type or the underlying integral type of that enum type
+             </typeparam>
+             <param name="fieldInfo">The field</param>
+             <returns>A readable/assignable <see cref="T:HarmonyLib.AccessTools.FieldRef`1"/> delegate</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.MethodDelegate``1(System.Reflection.MethodInfo,System.Object,System.Boolean)">
+             <summary>Creates a delegate to a given method</summary>
+             <typeparam name="DelegateType">The delegate Type</typeparam>
+             <param name="method">The method to create a delegate from.</param>
+             <param name="instance">
+             Only applies for instance methods. If <c>null</c> (default), returned delegate is an open (a.k.a. unbound) instance delegate
+             where an instance is supplied as the first argument to the delegate invocation; else, delegate is a closed (a.k.a. bound)
+             instance delegate where the delegate invocation always applies to the given <paramref name="instance"/>.
+             </param>
+             <param name="virtualCall">
+             Only applies for instance methods. If <c>true</c> (default) and <paramref name="method"/> is virtual, invocation of the delegate
+             calls the instance method virtually (the instance type's most-derived/overriden implementation of the method is called);
+             else, invocation of the delegate calls the exact specified <paramref name="method"/> (this is useful for calling base class methods)
+             Note: if <c>false</c> and <paramref name="method"/> is an interface method, an ArgumentException is thrown.
+             </param>
+             <returns>A delegate of given <typeparamref name="DelegateType"/> to given <paramref name="method"/></returns>
+             <remarks>
+             <para>
+             Delegate invocation is more performant and more convenient to use than <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])"/>
+             at a one-time setup cost.
+             </para>
+             <para>
+             Works for both type of static and instance methods, both open and closed (a.k.a. unbound and bound) instance methods,
+             and both class and struct methods.
+             </para>
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.HarmonyDelegate``1(System.Object)">
+             <summary>Creates a delegate for a given delegate definition, attributed with [<see cref="T:HarmonyLib.HarmonyDelegate"/>]</summary>
+             <typeparam name="DelegateType">The delegate Type, attributed with [<see cref="T:HarmonyLib.HarmonyDelegate"/>]</typeparam>
+             <param name="instance">
+             Only applies for instance methods. If <c>null</c> (default), returned delegate is an open (a.k.a. unbound) instance delegate
+             where an instance is supplied as the first argument to the delegate invocation; else, delegate is a closed (a.k.a. bound)
+             instance delegate where the delegate invocation always applies to the given <paramref name="instance"/>.
+             </param>
+             <returns>A delegate of given <typeparamref name="DelegateType"/> to the method specified via [<see cref="T:HarmonyLib.HarmonyDelegate"/>]
+             attributes on <typeparamref name="DelegateType"/></returns>
+             <remarks>
+             This calls <see cref="M:HarmonyLib.AccessTools.MethodDelegate``1(System.Reflection.MethodInfo,System.Object,System.Boolean)"/> with the <c>method</c> and <c>virtualCall</c> arguments
+             determined from the [<see cref="T:HarmonyLib.HarmonyDelegate"/>] attributes on <typeparamref name="DelegateType"/>,
+             and the given <paramref name="instance"/> (for closed instance delegates).
+             </remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetOutsideCaller">
+             <summary>Returns who called the current method</summary>
+             <returns>The calling method/constructor (excluding the caller)</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.RethrowException(System.Exception)">
+             <summary>Rethrows an exception while preserving its stack trace (throw statement typically clobbers existing stack traces)</summary>
+             <param name="exception">The exception to rethrow</param>
+            
+        </member>
+        <member name="P:HarmonyLib.AccessTools.IsMonoRuntime">
+             <summary>True if the current runtime is based on Mono, false otherwise (.NET)</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.AccessTools.IsNetFrameworkRuntime">
+             <summary>True if the current runtime is .NET Framework, false otherwise (.NET Core or Mono, although latter isn't guaranteed)</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.AccessTools.IsNetCoreRuntime">
+             <summary>True if the current runtime is .NET Core, false otherwise (Mono or .NET Framework)</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.ThrowMissingMemberException(System.Type,System.String[])">
+             <summary>Throws a missing member runtime exception</summary>
+             <param name="type">The type that is involved</param>
+             <param name="names">A list of names</param>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.GetDefaultValue(System.Type)">
+             <summary>Gets default value for a specific type</summary>
+             <param name="type">The class/type</param>
+             <returns>The default value</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.CreateInstance(System.Type)">
+             <summary>Creates an (possibly uninitialized) instance of a given type</summary>
+             <param name="type">The class/type</param>
+             <returns>The new instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.CreateInstance``1">
+             <summary>Creates an (possibly uninitialized) instance of a given type</summary>
+             <typeparam name="T">The class/type</typeparam>
+             <returns>The new instance</returns>
+            
+        </member>
+        <member name="F:HarmonyLib.AccessTools.addHandlerCache">
+            <summary>
+            A cache for the <see cref="M:System.Collections.Generic.ICollection`1.Add(`0)"/> or similar Add methods for different types.
+            </summary>
+        </member>
+        <member name="M:HarmonyLib.AccessTools.MakeDeepCopy``1(System.Object)">
+             <summary>Makes a deep copy of any object</summary>
+             <typeparam name="T">The type of the instance that should be created; for legacy reasons, this must be a class or interface</typeparam>
+             <param name="source">The original object</param>
+             <returns>A copy of the original object but of type T</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.MakeDeepCopy``1(System.Object,``0@,System.Func{System.String,HarmonyLib.Traverse,HarmonyLib.Traverse,System.Object},System.String)">
+             <summary>Makes a deep copy of any object</summary>
+             <typeparam name="T">The type of the instance that should be created</typeparam>
+             <param name="source">The original object</param>
+             <param name="result">[out] The copy of the original object</param>
+             <param name="processor">Optional value transformation function (taking a field name and src/dst <see cref="T:HarmonyLib.Traverse"/> instances)</param>
+             <param name="pathRoot">The optional path root to start with</param>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.MakeDeepCopy(System.Object,System.Type,System.Func{System.String,HarmonyLib.Traverse,HarmonyLib.Traverse,System.Object},System.String)">
+             <summary>Makes a deep copy of any object</summary>
+             <param name="source">The original object</param>
+             <param name="resultType">The type of the instance that should be created</param>
+             <param name="processor">Optional value transformation function (taking a field name and src/dst <see cref="T:HarmonyLib.Traverse"/> instances)</param>
+             <param name="pathRoot">The optional path root to start with</param>
+             <returns>The copy of the original object</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsStruct(System.Type)">
+             <summary>Tests if a type is a struct</summary>
+             <param name="type">The type</param>
+             <returns>True if the type is a struct</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsClass(System.Type)">
+             <summary>Tests if a type is a class</summary>
+             <param name="type">The type</param>
+             <returns>True if the type is a class</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsValue(System.Type)">
+             <summary>Tests if a type is a value type</summary>
+             <param name="type">The type</param>
+             <returns>True if the type is a value type</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsInteger(System.Type)">
+             <summary>Tests if a type is an integer type</summary>
+             <param name="type">The type</param>
+             <returns>True if the type represents some integer</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsFloatingPoint(System.Type)">
+             <summary>Tests if a type is a floating point type</summary>
+             <param name="type">The type</param>
+             <returns>True if the type represents some floating point</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsNumber(System.Type)">
+             <summary>Tests if a type is a numerical type</summary>
+             <param name="type">The type</param>
+             <returns>True if the type represents some number</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsVoid(System.Type)">
+             <summary>Tests if a type is void</summary>
+             <param name="type">The type</param>
+             <returns>True if the type is void</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsOfNullableType``1(``0)">
+             <summary>Test whether an instance is of a nullable type</summary>
+             <typeparam name="T">Type of instance</typeparam>
+             <param name="instance">An instance to test</param>
+             <returns>True if instance is of nullable type, false if not</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsStatic(System.Reflection.MemberInfo)">
+             <summary>Tests whether a type or member is static, as defined in C#</summary>
+             <param name="member">The type or member</param>
+             <returns>True if the type or member is static</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsStatic(System.Type)">
+             <summary>Tests whether a type is static, as defined in C#</summary>
+             <param name="type">The type</param>
+             <returns>True if the type is static</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsStatic(System.Reflection.PropertyInfo)">
+             <summary>Tests whether a property is static, as defined in C#</summary>
+             <param name="propertyInfo">The property</param>
+             <returns>True if the property is static</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.IsStatic(System.Reflection.EventInfo)">
+             <summary>Tests whether an event is static, as defined in C#</summary>
+             <param name="eventInfo">The event</param>
+             <returns>True if the event is static</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.AccessTools.CombinedHashCode(System.Collections.Generic.IEnumerable{System.Object})">
+             <summary>Calculates a combined hash code for an enumeration of objects</summary>
+             <param name="objects">The objects</param>
+             <returns>The hash code</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.GeneralExtensions">
+             <summary>General extensions for common cases</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.GeneralExtensions.Join``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.String},System.String)">
+             <summary>Joins an enumeration with a value converter and a delimiter to a string</summary>
+             <typeparam name="T">The inner type of the enumeration</typeparam>
+             <param name="enumeration">The enumeration</param>
+             <param name="converter">An optional value converter (from T to string)</param>
+             <param name="delimiter">An optional delimiter</param>
+             <returns>The values joined into a string</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.GeneralExtensions.Description(System.Type[])">
+             <summary>Converts an array of types (for example methods arguments) into a human readable form</summary>
+             <param name="parameters">The array of types</param>
+             <returns>A human readable description including brackets</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.GeneralExtensions.FullDescription(System.Type)">
+             <summary>A full description of a type</summary>
+             <param name="type">The type</param>
+             <returns>A human readable description</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.GeneralExtensions.FullDescription(System.Reflection.MethodBase)">
+             <summary>A a full description of a method or a constructor without assembly details but with generics</summary>
+             <param name="member">The method/constructor</param>
+             <returns>A human readable description</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.GeneralExtensions.Types(System.Reflection.ParameterInfo[])">
+             <summary>A helper converting parameter infos to types</summary>
+             <param name="pinfo">The array of parameter infos</param>
+             <returns>An array of types</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.GeneralExtensions.GetValueSafe``2(System.Collections.Generic.Dictionary{``0,``1},``0)">
+             <summary>A helper to access a value via key from a dictionary</summary>
+             <typeparam name="S">The key type</typeparam>
+             <typeparam name="T">The value type</typeparam>
+             <param name="dictionary">The dictionary</param>
+             <param name="key">The key</param>
+             <returns>The value for the key or the default value (of T) if that key does not exist</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.GeneralExtensions.GetTypedValue``1(System.Collections.Generic.Dictionary{System.String,System.Object},System.String)">
+             <summary>A helper to access a value via key from a dictionary with extra casting</summary>
+             <typeparam name="T">The value type</typeparam>
+             <param name="dictionary">The dictionary</param>
+             <param name="key">The key</param>
+             <returns>The value for the key or the default value (of T) if that key does not exist or cannot be cast to T</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.GeneralExtensions.ToLiteral(System.String,System.String)">
+             <summary>Escapes Unicode and ASCII non printable characters</summary>
+             <param name="input">The string to convert</param>
+             <param name="quoteChar">The string to convert</param>
+             <returns>A string literal surrounded by <paramref name="quoteChar"/></returns>
+            
+        </member>
+        <member name="T:HarmonyLib.CodeInstructionExtensions">
+             <summary>Extensions for <see cref="T:HarmonyLib.CodeInstruction"/></summary>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.OperandIs(HarmonyLib.CodeInstruction,System.Object)">
+             <summary>Shortcut for testing whether the operand is equal to a non-null value</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="value">The value</param>
+             <returns>True if the operand has the same type and is equal to the value</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.OperandIs(HarmonyLib.CodeInstruction,System.Reflection.MemberInfo)">
+             <summary>Shortcut for testing whether the operand is equal to a non-null value</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="value">The <see cref="T:System.Reflection.MemberInfo"/> value</param>
+             <returns>True if the operand is equal to the value</returns>
+             <remarks>This is an optimized version of <see cref="M:HarmonyLib.CodeInstructionExtensions.OperandIs(HarmonyLib.CodeInstruction,System.Object)"/> for <see cref="T:System.Reflection.MemberInfo"/></remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.Is(HarmonyLib.CodeInstruction,System.Reflection.Emit.OpCode,System.Object)">
+             <summary>Shortcut for <code>code.opcode == opcode &amp;&amp; code.OperandIs(operand)</code></summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="opcode">The <see cref="T:System.Reflection.Emit.OpCode"/></param>
+             <param name="operand">The operand value</param>
+             <returns>True if the opcode is equal to the given opcode and the operand has the same type and is equal to the given operand</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.Is(HarmonyLib.CodeInstruction,System.Reflection.Emit.OpCode,System.Reflection.MemberInfo)">
+             <summary>Shortcut for <code>code.opcode == opcode &amp;&amp; code.OperandIs(operand)</code></summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="opcode">The <see cref="T:System.Reflection.Emit.OpCode"/></param>
+             <param name="operand">The <see cref="T:System.Reflection.MemberInfo"/> operand value</param>
+             <returns>True if the opcode is equal to the given opcode and the operand is equal to the given operand</returns>
+             <remarks>This is an optimized version of <see cref="M:HarmonyLib.CodeInstructionExtensions.Is(HarmonyLib.CodeInstruction,System.Reflection.Emit.OpCode,System.Object)"/> for <see cref="T:System.Reflection.MemberInfo"/></remarks>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.IsLdarg(HarmonyLib.CodeInstruction,System.Nullable{System.Int32})">
+             <summary>Tests for any form of Ldarg*</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="n">The (optional) index</param>
+             <returns>True if it matches one of the variations</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.IsLdarga(HarmonyLib.CodeInstruction,System.Nullable{System.Int32})">
+             <summary>Tests for Ldarga/Ldarga_S</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="n">The (optional) index</param>
+             <returns>True if it matches one of the variations</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.IsStarg(HarmonyLib.CodeInstruction,System.Nullable{System.Int32})">
+             <summary>Tests for Starg/Starg_S</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="n">The (optional) index</param>
+             <returns>True if it matches one of the variations</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.IsLdloc(HarmonyLib.CodeInstruction,System.Reflection.Emit.LocalBuilder)">
+             <summary>Tests for any form of Ldloc*</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="variable">The optional local variable</param>
+             <returns>True if it matches one of the variations</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.IsStloc(HarmonyLib.CodeInstruction,System.Reflection.Emit.LocalBuilder)">
+             <summary>Tests for any form of Stloc*</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="variable">The optional local variable</param>
+             <returns>True if it matches one of the variations</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.Branches(HarmonyLib.CodeInstruction,System.Nullable{System.Reflection.Emit.Label}@)">
+             <summary>Tests if the code instruction branches</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="label">The label if the instruction is a branch operation or <see langword="null"/> if not</param>
+             <returns>True if the instruction branches</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.Calls(HarmonyLib.CodeInstruction,System.Reflection.MethodInfo)">
+             <summary>Tests if the code instruction calls the method/constructor</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="method">The method</param>
+             <returns>True if the instruction calls the method or constructor</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.LoadsConstant(HarmonyLib.CodeInstruction)">
+             <summary>Tests if the code instruction loads a constant</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <returns>True if the instruction loads a constant</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.LoadsConstant(HarmonyLib.CodeInstruction,System.Int64)">
+             <summary>Tests if the code instruction loads an integer constant</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="number">The integer constant</param>
+             <returns>True if the instruction loads the constant</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.LoadsConstant(HarmonyLib.CodeInstruction,System.Double)">
+             <summary>Tests if the code instruction loads a floating point constant</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="number">The floating point constant</param>
+             <returns>True if the instruction loads the constant</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.LoadsConstant(HarmonyLib.CodeInstruction,System.Enum)">
+             <summary>Tests if the code instruction loads an enum constant</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="e">The enum</param>
+             <returns>True if the instruction loads the constant</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.LoadsField(HarmonyLib.CodeInstruction,System.Reflection.FieldInfo,System.Boolean)">
+             <summary>Tests if the code instruction loads a field</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="field">The field</param>
+             <param name="byAddress">Set to true if the address of the field is loaded</param>
+             <returns>True if the instruction loads the field</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.StoresField(HarmonyLib.CodeInstruction,System.Reflection.FieldInfo)">
+             <summary>Tests if the code instruction stores a field</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="field">The field</param>
+             <returns>True if the instruction stores this field</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.WithLabels(HarmonyLib.CodeInstruction,System.Reflection.Emit.Label[])">
+            <summary>Adds labels to the code instruction and return it</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+            <param name="labels">One or several <see cref="T:System.Reflection.Emit.Label"/> to add</param>
+            <returns>The same code instruction</returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.WithLabels(HarmonyLib.CodeInstruction,System.Collections.Generic.IEnumerable{System.Reflection.Emit.Label})">
+            <summary>Adds labels to the code instruction and return it</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+            <param name="labels">An enumeration of <see cref="T:System.Reflection.Emit.Label"/></param>
+            <returns>The same code instruction</returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.ExtractLabels(HarmonyLib.CodeInstruction)">
+            <summary>Extracts all labels from the code instruction and returns them</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+            <returns>A list of <see cref="T:System.Reflection.Emit.Label"/></returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.MoveLabelsTo(HarmonyLib.CodeInstruction,HarmonyLib.CodeInstruction)">
+            <summary>Moves all labels from the code instruction to a different one</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels from</param>
+            <param name="other">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels to</param>
+            <returns>The code instruction labels were moved from (now empty)</returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.MoveLabelsFrom(HarmonyLib.CodeInstruction,HarmonyLib.CodeInstruction)">
+            <summary>Moves all labels from a different code instruction to the current one</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels from</param>
+            <param name="other">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels to</param>
+            <returns>The code instruction that received the labels</returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.WithBlocks(HarmonyLib.CodeInstruction,HarmonyLib.ExceptionBlock[])">
+            <summary>Adds ExceptionBlocks to the code instruction and return it</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+            <param name="blocks">One or several <see cref="T:HarmonyLib.ExceptionBlock"/> to add</param>
+            <returns>The same code instruction</returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.WithBlocks(HarmonyLib.CodeInstruction,System.Collections.Generic.IEnumerable{HarmonyLib.ExceptionBlock})">
+            <summary>Adds ExceptionBlocks to the code instruction and return it</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+            <param name="blocks">An enumeration of <see cref="T:HarmonyLib.ExceptionBlock"/></param>
+            <returns>The same code instruction</returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.ExtractBlocks(HarmonyLib.CodeInstruction)">
+            <summary>Extracts all ExceptionBlocks from the code instruction and returns them</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+            <returns>A list of <see cref="T:HarmonyLib.ExceptionBlock"/></returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.MoveBlocksTo(HarmonyLib.CodeInstruction,HarmonyLib.CodeInstruction)">
+            <summary>Moves all ExceptionBlocks from the code instruction to a different one</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks from</param>
+            <param name="other">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks to</param>
+            <returns>The code instruction blocks were moved from (now empty)</returns>
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.MoveBlocksFrom(HarmonyLib.CodeInstruction,HarmonyLib.CodeInstruction)">
+            <summary>Moves all ExceptionBlocks from a different code instruction to the current one</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks from</param>
+            <param name="other">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks to</param>
+            <returns>The code instruction that received the blocks</returns>
+        </member>
+        <member name="T:HarmonyLib.CollectionExtensions">
+            <summary>General extensions for collections</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.CollectionExtensions.Do``1(System.Collections.Generic.IEnumerable{``0},System.Action{``0})">
+             <summary>A simple way to execute code for every element in a collection</summary>
+             <typeparam name="T">The inner type of the collection</typeparam>
+             <param name="sequence">The collection</param>
+             <param name="action">The action to execute</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CollectionExtensions.DoIf``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean},System.Action{``0})">
+             <summary>A simple way to execute code for elements in a collection matching a condition</summary>
+             <typeparam name="T">The inner type of the collection</typeparam>
+             <param name="sequence">The collection</param>
+             <param name="condition">The predicate</param>
+             <param name="action">The action to execute</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CollectionExtensions.AddItem``1(System.Collections.Generic.IEnumerable{``0},``0)">
+             <summary>A helper to add an item to a collection</summary>
+             <typeparam name="T">The inner type of the collection</typeparam>
+             <param name="sequence">The collection</param>
+             <param name="item">The item to add</param>
+             <returns>The collection containing the item</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CollectionExtensions.AddToArray``1(``0[],``0)">
+             <summary>A helper to add an item to an array</summary>
+             <typeparam name="T">The inner type of the collection</typeparam>
+             <param name="sequence">The array</param>
+             <param name="item">The item to add</param>
+             <returns>The array containing the item</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CollectionExtensions.AddRangeToArray``1(``0[],``0[])">
+             <summary>A helper to add items to an array</summary>
+             <typeparam name="T">The inner type of the collection</typeparam>
+             <param name="sequence">The array</param>
+             <param name="items">The items to add</param>
+             <returns>The array containing the items</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.MethodBaseExtensions">
+            <summary>General extensions for collections</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.MethodBaseExtensions.HasMethodBody(System.Reflection.MethodBase)">
+            <summary>Tests a class member if it has an IL method body (external methods for example don't have a body)</summary>
+            <param name="member">The member to test</param>
+            <returns>Returns true if the member has an IL body or false if not</returns>
+        </member>
+        <member name="T:HarmonyLib.FileLog">
+             <summary>A file log for debugging</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.FileLog.logPath">
+             <summary>Full pathname of the log file, defaults to a file called <c>harmony.log.txt</c> on your Desktop</summary>
+            
+        </member>
+        <member name="F:HarmonyLib.FileLog.indentChar">
+             <summary>The indent character. The default is <c>tab</c></summary>
+            
+        </member>
+        <member name="F:HarmonyLib.FileLog.indentLevel">
+             <summary>The current indent level</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.ChangeIndent(System.Int32)">
+             <summary>Changes the indentation level</summary>
+             <param name="delta">The value to add to the indentation level</param>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.LogBuffered(System.String)">
+             <summary>Log a string in a buffered way. Use this method only if you are sure that FlushBuffer will be called
+             or else logging information is incomplete in case of a crash</summary>
+             <param name="str">The string to log</param>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.LogBuffered(System.Collections.Generic.List{System.String})">
+             <summary>Logs a list of string in a buffered way. Use this method only if you are sure that FlushBuffer will be called
+             or else logging information is incomplete in case of a crash</summary>
+             <param name="strings">A list of strings to log (they will not be re-indented)</param>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.GetBuffer(System.Boolean)">
+             <summary>Returns the log buffer and optionally empties it</summary>
+             <param name="clear">True to empty the buffer</param>
+             <returns>The buffer.</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.SetBuffer(System.Collections.Generic.List{System.String})">
+             <summary>Replaces the buffer with new lines</summary>
+             <param name="buffer">The lines to store</param>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.FlushBuffer">
+             <summary>Flushes the log buffer to disk (use in combination with LogBuffered)</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.Log(System.String)">
+             <summary>Log a string directly to disk. Slower method that prevents missing information in case of a crash</summary>
+             <param name="str">The string to log.</param>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.Reset">
+             <summary>Resets and deletes the log</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.FileLog.LogBytes(System.Int64,System.Int32)">
+             <summary>Logs some bytes as hex values</summary>
+             <param name="ptr">The pointer to some memory</param>
+             <param name="len">The length of bytes to log</param>
+            
+        </member>
+        <member name="T:HarmonyLib.SymbolExtensions">
+            <summary>A helper class to retrieve reflection info for non-private methods</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.SymbolExtensions.GetMethodInfo(System.Linq.Expressions.Expression{System.Action})">
+             <summary>Given a lambda expression that calls a method, returns the method info</summary>
+             <param name="expression">The lambda expression using the method</param>
+             <returns>The method in the lambda expression</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.SymbolExtensions.GetMethodInfo``1(System.Linq.Expressions.Expression{System.Action{``0}})">
+             <summary>Given a lambda expression that calls a method, returns the method info</summary>
+             <typeparam name="T">The generic type</typeparam>
+             <param name="expression">The lambda expression using the method</param>
+             <returns>The method in the lambda expression</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.SymbolExtensions.GetMethodInfo``2(System.Linq.Expressions.Expression{System.Func{``0,``1}})">
+             <summary>Given a lambda expression that calls a method, returns the method info</summary>
+             <typeparam name="T">The generic type</typeparam>
+             <typeparam name="TResult">The generic result type</typeparam>
+             <param name="expression">The lambda expression using the method</param>
+             <returns>The method in the lambda expression</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.SymbolExtensions.GetMethodInfo(System.Linq.Expressions.LambdaExpression)">
+             <summary>Given a lambda expression that calls a method, returns the method info</summary>
+             <param name="expression">The lambda expression using the method</param>
+             <returns>The method in the lambda expression</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.Traverse`1">
+             <summary>A reflection helper to read and write private elements</summary>
+             <typeparam name="T">The result type defined by GetValue()</typeparam>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse`1.#ctor(HarmonyLib.Traverse)">
+             <summary>Creates a traverse instance from an existing instance</summary>
+             <param name="traverse">The existing <see cref="T:HarmonyLib.Traverse"/> instance</param>
+            
+        </member>
+        <member name="P:HarmonyLib.Traverse`1.Value">
+             <summary>Gets/Sets the current value</summary>
+             <value>The value to read or write</value>
+            
+        </member>
+        <member name="T:HarmonyLib.Traverse">
+            <summary>A reflection helper to read and write private elements</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Create(System.Type)">
+             <summary>Creates a new traverse instance from a class/type</summary>
+             <param name="type">The class/type</param>
+             <returns>A <see cref="T:HarmonyLib.Traverse"/> instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Create``1">
+             <summary>Creates a new traverse instance from a class T</summary>
+             <typeparam name="T">The class</typeparam>
+             <returns>A <see cref="T:HarmonyLib.Traverse"/> instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Create(System.Object)">
+             <summary>Creates a new traverse instance from an instance</summary>
+             <param name="root">The object</param>
+             <returns>A <see cref="T:HarmonyLib.Traverse"/> instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.CreateWithType(System.String)">
+             <summary>Creates a new traverse instance from a named type</summary>
+             <param name="name">The type name, for format see <see cref="M:HarmonyLib.AccessTools.TypeByName(System.String)"/></param>
+             <returns>A <see cref="T:HarmonyLib.Traverse"/> instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.#ctor">
+             <summary>Creates a new and empty traverse instance</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.#ctor(System.Type)">
+             <summary>Creates a new traverse instance from a class/type</summary>
+             <param name="type">The class/type</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.#ctor(System.Object)">
+             <summary>Creates a new traverse instance from an instance</summary>
+             <param name="root">The object</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.GetValue">
+             <summary>Gets the current value</summary>
+             <value>The value</value>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.GetValue``1">
+             <summary>Gets the current value</summary>
+             <typeparam name="T">The type of the value</typeparam>
+             <value>The value</value>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.GetValue(System.Object[])">
+             <summary>Invokes the current method with arguments and returns the result</summary>
+             <param name="arguments">The method arguments</param>
+             <value>The value returned by the method</value>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.GetValue``1(System.Object[])">
+             <summary>Invokes the current method with arguments and returns the result</summary>
+             <typeparam name="T">The type of the value</typeparam>
+             <param name="arguments">The method arguments</param>
+             <value>The value returned by the method</value>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.SetValue(System.Object)">
+             <summary>Sets a value of the current field or property</summary>
+             <param name="value">The value</param>
+             <returns>The same traverse instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.GetValueType">
+             <summary>Gets the type of the current field or property</summary>
+             <returns>The type</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Type(System.String)">
+             <summary>Moves the current traverse instance to a inner type</summary>
+             <param name="name">The type name</param>
+             <returns>A traverse instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Field(System.String)">
+             <summary>Moves the current traverse instance to a field</summary>
+             <param name="name">The type name</param>
+             <returns>A traverse instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Field``1(System.String)">
+             <summary>Moves the current traverse instance to a field</summary>
+             <typeparam name="T">The type of the field</typeparam>
+             <param name="name">The type name</param>
+             <returns>A traverse instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Fields">
+             <summary>Gets all fields of the current type</summary>
+             <returns>A list of field names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Property(System.String,System.Object[])">
+             <summary>Moves the current traverse instance to a property</summary>
+             <param name="name">The type name</param>
+             <param name="index">Optional property index</param>
+             <returns>A traverse instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Property``1(System.String,System.Object[])">
+             <summary>Moves the current traverse instance to a field</summary>
+             <typeparam name="T">The type of the property</typeparam>
+             <param name="name">The type name</param>
+             <param name="index">Optional property index</param>
+             <returns>A traverse instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Properties">
+             <summary>Gets all properties of the current type</summary>
+             <returns>A list of property names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Method(System.String,System.Object[])">
+             <summary>Moves the current traverse instance to a method</summary>
+             <param name="name">The name of the method</param>
+             <param name="arguments">The arguments defining the argument types of the method overload</param>
+             <returns>A traverse instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Method(System.String,System.Type[],System.Object[])">
+             <summary>Moves the current traverse instance to a method</summary>
+             <param name="name">The name of the method</param>
+             <param name="paramTypes">The argument types of the method</param>
+             <param name="arguments">The arguments for the method</param>
+             <returns>A traverse instance</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.Methods">
+             <summary>Gets all methods of the current type</summary>
+             <returns>A list of method names</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.FieldExists">
+             <summary>Checks if the current traverse instance is for a field</summary>
+             <returns>True if its a field</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.PropertyExists">
+             <summary>Checks if the current traverse instance is for a property</summary>
+             <returns>True if its a property</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.MethodExists">
+             <summary>Checks if the current traverse instance is for a method</summary>
+             <returns>True if its a method</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.TypeExists">
+             <summary>Checks if the current traverse instance is for a type</summary>
+             <returns>True if its a type</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.IterateFields(System.Object,System.Action{HarmonyLib.Traverse})">
+             <summary>Iterates over all fields of the current type and executes a traverse action</summary>
+             <param name="source">Original object</param>
+             <param name="action">The action receiving a <see cref="T:HarmonyLib.Traverse"/> instance for each field</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.IterateFields(System.Object,System.Object,System.Action{HarmonyLib.Traverse,HarmonyLib.Traverse})">
+             <summary>Iterates over all fields of the current type and executes a traverse action</summary>
+             <param name="source">Original object</param>
+             <param name="target">Target object</param>
+             <param name="action">The action receiving a pair of <see cref="T:HarmonyLib.Traverse"/> instances for each field pair</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.IterateFields(System.Object,System.Object,System.Action{System.String,HarmonyLib.Traverse,HarmonyLib.Traverse})">
+             <summary>Iterates over all fields of the current type and executes a traverse action</summary>
+             <param name="source">Original object</param>
+             <param name="target">Target object</param>
+             <param name="action">The action receiving a dot path representing the field pair and the <see cref="T:HarmonyLib.Traverse"/> instances</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.IterateProperties(System.Object,System.Action{HarmonyLib.Traverse})">
+             <summary>Iterates over all properties of the current type and executes a traverse action</summary>
+             <param name="source">Original object</param>
+             <param name="action">The action receiving a <see cref="T:HarmonyLib.Traverse"/> instance for each property</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.IterateProperties(System.Object,System.Object,System.Action{HarmonyLib.Traverse,HarmonyLib.Traverse})">
+             <summary>Iterates over all properties of the current type and executes a traverse action</summary>
+             <param name="source">Original object</param>
+             <param name="target">Target object</param>
+             <param name="action">The action receiving a pair of <see cref="T:HarmonyLib.Traverse"/> instances for each property pair</param>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.IterateProperties(System.Object,System.Object,System.Action{System.String,HarmonyLib.Traverse,HarmonyLib.Traverse})">
+             <summary>Iterates over all properties of the current type and executes a traverse action</summary>
+             <param name="source">Original object</param>
+             <param name="target">Target object</param>
+             <param name="action">The action receiving a dot path representing the property pair and the <see cref="T:HarmonyLib.Traverse"/> instances</param>
+            
+        </member>
+        <member name="F:HarmonyLib.Traverse.CopyFields">
+            <summary>A default field action that copies fields to fields</summary>
+            
+        </member>
+        <member name="M:HarmonyLib.Traverse.ToString">
+             <summary>Returns a string that represents the current traverse</summary>
+             <returns>A string representation</returns>
+            
+        </member>
+    </members>
+</doc>
diff --git a/build/common.targets b/build/common.targets
index ce805402..f5d01606 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -38,6 +38,7 @@
     <Copy SourceFiles="$(TargetDir)\SMAPI.config.json" DestinationFiles="$(GamePath)\smapi-internal\config.json" />
     <Copy SourceFiles="$(TargetDir)\SMAPI.metadata.json" DestinationFiles="$(GamePath)\smapi-internal\metadata.json" />
     <Copy SourceFiles="$(TargetDir)\0Harmony.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\0Harmony.xml" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\Mono.Cecil.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\Newtonsoft.Json.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\TMXTile.dll" DestinationFolder="$(GamePath)\smapi-internal" />
diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index 408230a9..0c1a6c1a 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -45,6 +45,7 @@
     <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.xml" DestinationFolder="$(PackagePath)\bundle" />
     <Copy SourceFiles="$(SmapiBin)\steam_appid.txt" DestinationFolder="$(PackagePath)\bundle" />
     <Copy SourceFiles="$(SmapiBin)\0Harmony.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
+    <Copy SourceFiles="$(SmapiBin)\0Harmony.xml" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(SmapiBin)\Mono.Cecil.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(SmapiBin)\Newtonsoft.Json.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(SmapiBin)\TMXTile.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
diff --git a/docs/release-notes.md b/docs/release-notes.md
index d0aa2fbf..50ed5f29 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,11 +1,9 @@
 ← [README](README.md)
 
 # Release notes
-<!--
-## Future release
+## Upcoming release
 * For mod authors:
-  * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
--->
+  * Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 
 ## 3.11.0
 Released 09 July 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/53514295).
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index b64239c1..586b17aa 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -59,7 +59,6 @@ flag | purpose
 `SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/macOS. Set automatically in `common.targets`.
 `SMAPI_FOR_WINDOWS_64BIT_HACK` | Whether SMAPI is being [compiled for Windows with a 64-bit Linux version of the game](https://github.com/Pathoschild/SMAPI/issues/767). This is highly specialized and shouldn't be used in most cases. False by default.
 `SMAPI_FOR_XNA` | Whether SMAPI is being compiled for XNA Framework; if not set, the code assumes MonoGame. Set automatically in `common.targets` with the same value as `SMAPI_FOR_WINDOWS` (unless `SMAPI_FOR_WINDOWS_64BIT_HACK` is set).
-`HARMONY_2` | Whether to enable experimental Harmony 2.0 support and rewrite existing Harmony 1._x_ mods for compatibility. Note that you need to replace `build/0Harmony.dll` with a Harmony 2.0 build (or switch to a package reference) to use this flag.
 
 ## For SMAPI developers
 ### Compiling from source
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
index cce13064..a065e3d7 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
@@ -1,15 +1,10 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
-using StardewModdingAPI.Framework.Patching;
-using StardewValley;
-#if HARMONY_2
 using HarmonyLib;
 using StardewModdingAPI.Framework;
-#else
-using System.Reflection;
-using Harmony;
-#endif
+using StardewModdingAPI.Framework.Patching;
+using StardewValley;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
@@ -41,9 +36,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             DialogueErrorPatch.Reflection = reflector;
         }
 
-
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
         {
             harmony.Patch(
@@ -55,25 +48,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 finalizer: new HarmonyMethod(this.GetType(), nameof(DialogueErrorPatch.Finalize_NPC_CurrentDialogue))
             );
         }
-#else
-        public void Apply(HarmonyInstance harmony)
-        {
-            harmony.Patch(
-                original: AccessTools.Constructor(typeof(Dialogue), new[] { typeof(string), typeof(NPC) }),
-                prefix: new HarmonyMethod(this.GetType(), nameof(DialogueErrorPatch.Before_Dialogue_Constructor))
-            );
-            harmony.Patch(
-                original: AccessTools.Property(typeof(NPC), nameof(NPC.CurrentDialogue)).GetMethod,
-                prefix: new HarmonyMethod(this.GetType(), nameof(DialogueErrorPatch.Before_NPC_CurrentDialogue))
-            );
-        }
-#endif
 
 
         /*********
         ** Private methods
         *********/
-#if HARMONY_2
         /// <summary>The method to call after the Dialogue constructor.</summary>
         /// <param name="__instance">The instance being patched.</param>
         /// <param name="masterDialogue">The dialogue being parsed.</param>
@@ -113,72 +92,5 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 
             return null;
         }
-#else
-
-        /// <summary>The method to call instead of the Dialogue constructor.</summary>
-        /// <param name="__instance">The instance being patched.</param>
-        /// <param name="masterDialogue">The dialogue being parsed.</param>
-        /// <param name="speaker">The NPC for which the dialogue is being parsed.</param>
-        /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_Dialogue_Constructor(Dialogue __instance, string masterDialogue, NPC speaker)
-        {
-            // get private members
-            bool nameArraysTranslated = DialogueErrorPatch.Reflection.GetField<bool>(typeof(Dialogue), "nameArraysTranslated").GetValue();
-            IReflectedMethod translateArraysOfStrings = DialogueErrorPatch.Reflection.GetMethod(typeof(Dialogue), "TranslateArraysOfStrings");
-            IReflectedMethod parseDialogueString = DialogueErrorPatch.Reflection.GetMethod(__instance, "parseDialogueString");
-            IReflectedMethod checkForSpecialDialogueAttributes = DialogueErrorPatch.Reflection.GetMethod(__instance, "checkForSpecialDialogueAttributes");
-
-            // replicate base constructor
-            __instance.dialogues ??= new List<string>();
-
-            // duplicate code with try..catch
-            try
-            {
-                if (!nameArraysTranslated)
-                    translateArraysOfStrings.Invoke();
-                __instance.speaker = speaker;
-                parseDialogueString.Invoke(masterDialogue);
-                checkForSpecialDialogueAttributes.Invoke();
-            }
-            catch (Exception baseEx) when (baseEx.InnerException is TargetInvocationException invocationEx && invocationEx.InnerException is Exception ex)
-            {
-                string name = !string.IsNullOrWhiteSpace(speaker?.Name) ? speaker.Name : null;
-                DialogueErrorPatch.MonitorForGame.Log($"Failed parsing dialogue string{(name != null ? $" for {name}" : "")}:\n{masterDialogue}\n{ex}", LogLevel.Error);
-
-                parseDialogueString.Invoke("...");
-                checkForSpecialDialogueAttributes.Invoke();
-            }
-
-            return false;
-        }
-
-        /// <summary>The method to call instead of <see cref="NPC.CurrentDialogue"/>.</summary>
-        /// <param name="__instance">The instance being patched.</param>
-        /// <param name="__result">The return value of the original method.</param>
-        /// <param name="__originalMethod">The method being wrapped.</param>
-        /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_NPC_CurrentDialogue(NPC __instance, ref Stack<Dialogue> __result, MethodInfo __originalMethod)
-        {
-            const string key = nameof(DialogueErrorPatch.Before_NPC_CurrentDialogue);
-            if (!PatchHelper.StartIntercept(key))
-                return true;
-
-            try
-            {
-                __result = (Stack<Dialogue>)__originalMethod.Invoke(__instance, new object[0]);
-                return false;
-            }
-            catch (TargetInvocationException ex)
-            {
-                DialogueErrorPatch.MonitorForGame.Log($"Failed loading current dialogue for NPC {__instance.Name}:\n{ex.InnerException ?? ex}", LogLevel.Error);
-                __result = new Stack<Dialogue>();
-                return false;
-            }
-            finally
-            {
-                PatchHelper.StopIntercept(key);
-            }
-        }
-#endif
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
index 72863d17..390aa778 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
@@ -1,10 +1,6 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
-#if HARMONY_2
 using HarmonyLib;
-#else
-using Harmony;
-#endif
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
 
@@ -34,11 +30,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         }
 
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
-#else
-        public void Apply(HarmonyInstance harmony)
-#endif
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(Event), nameof(Event.LogErrorAndHalt)),
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
index 7a48133e..ec809fba 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
@@ -1,11 +1,6 @@
-using System.Diagnostics.CodeAnalysis;
-#if HARMONY_2
 using System;
+using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-#else
-using System.Reflection;
-using Harmony;
-#endif
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
 using xTile;
@@ -36,37 +31,22 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         }
 
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.checkEventPrecondition)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(EventErrorPatch.Finalize_GameLocation_CheckEventPrecondition))
-            );
-harmony.Patch(
-                original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.updateSeasonalTileSheets)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(EventErrorPatch.Before_GameLocation_UpdateSeasonalTileSheets))
-            );
-        }
-#else
-        public void Apply(HarmonyInstance harmony)
-        {
-            harmony.Patch(
-                original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.checkEventPrecondition)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Before_GameLocation_CheckEventPrecondition))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Finalize_GameLocation_CheckEventPrecondition))
             );
             harmony.Patch(
                 original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.updateSeasonalTileSheets)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Before_GameLocation_UpdateSeasonalTileSheets))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Before_GameLocation_UpdateSeasonalTileSheets))
             );
         }
-#endif
 
 
         /*********
         ** Private methods
         *********/
-#if HARMONY_2
         /// <summary>The method to call instead of GameLocation.checkEventPrecondition.</summary>
         /// <param name="__result">The return value of the original method.</param>
         /// <param name="precondition">The precondition to be parsed.</param>
@@ -77,43 +57,12 @@ harmony.Patch(
             if (__exception != null)
             {
                 __result = -1;
-                EventErrorPatch.MonitorForGame.Log($"Failed parsing event precondition ({precondition}):\n{__exception.InnerException}", LogLevel.Error);
+                GameLocationPatches.MonitorForGame.Log($"Failed parsing event precondition ({precondition}):\n{__exception.InnerException}", LogLevel.Error);
             }
 
             return null;
         }
-#else
-        /// <summary>The method to call instead of <see cref="GameLocation.checkEventPrecondition"/>.</summary>
-        /// <param name="__instance">The instance being patched.</param>
-        /// <param name="__result">The return value of the original method.</param>
-        /// <param name="precondition">The precondition to be parsed.</param>
-        /// <param name="__originalMethod">The method being wrapped.</param>
-        /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_GameLocation_CheckEventPrecondition(GameLocation __instance, ref int __result, string precondition, MethodInfo __originalMethod)
-        {
-            const string key = nameof(GameLocationPatches.Before_GameLocation_CheckEventPrecondition);
-            if (!PatchHelper.StartIntercept(key))
-                return true;
 
-            try
-            {
-                __result = (int)__originalMethod.Invoke(__instance, new object[] { precondition });
-                return false;
-            }
-            catch (TargetInvocationException ex)
-            {
-                __result = -1;
-                GameLocationPatches.MonitorForGame.Log($"Failed parsing event precondition ({precondition}):\n{ex.InnerException}", LogLevel.Error);
-                return false;
-            }
-            finally
-            {
-                PatchHelper.StopIntercept(key);
-            }
-        }
-#endif
-
-#if HARMONY_2
         /// <summary>The method to call instead of <see cref="GameLocation.updateSeasonalTileSheets"/>.</summary>
         /// <param name="__instance">The instance being patched.</param>
         /// <param name="map">The map whose tilesheets to update.</param>
@@ -126,33 +75,5 @@ harmony.Patch(
 
             return null;
         }
-#else
-        /// <summary>The method to call instead of <see cref="GameLocation.updateSeasonalTileSheets"/>.</summary>
-        /// <param name="__instance">The instance being patched.</param>
-        /// <param name="map">The map whose tilesheets to update.</param>
-        /// <param name="__originalMethod">The method being wrapped.</param>
-        /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_GameLocation_UpdateSeasonalTileSheets(GameLocation __instance, Map map, MethodInfo __originalMethod)
-        {
-            const string key = nameof(GameLocationPatches.Before_GameLocation_UpdateSeasonalTileSheets);
-            if (!PatchHelper.StartIntercept(key))
-                return true;
-
-            try
-            {
-                __originalMethod.Invoke(__instance, new object[] { map });
-                return false;
-            }
-            catch (TargetInvocationException ex)
-            {
-                GameLocationPatches.MonitorForGame.Log($"Failed updating seasonal tilesheets for location '{__instance.NameOrUniqueName}'. Technical details:\n{ex.InnerException}", LogLevel.Error);
-                return false;
-            }
-            finally
-            {
-                PatchHelper.StopIntercept(key);
-            }
-        }
-#endif
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
index 52d5f5a1..e14dc662 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
@@ -2,11 +2,7 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
-#if HARMONY_2
 using HarmonyLib;
-#else
-using Harmony;
-#endif
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
@@ -45,11 +41,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 
 
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
-#else
-        public void Apply(HarmonyInstance harmony)
-#endif
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(SaveGame), nameof(SaveGame.loadDataToLocations)),
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
index 9f8a98cd..a68e359c 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
@@ -1,16 +1,11 @@
+using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
+using HarmonyLib;
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
 using StardewValley.Menus;
 using SObject = StardewValley.Object;
-#if HARMONY_2
-using System;
-using HarmonyLib;
-#else
-using System.Reflection;
-using Harmony;
-#endif
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
@@ -24,11 +19,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Public methods
         *********/
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
-#else
-        public void Apply(HarmonyInstance harmony)
-#endif
         {
             // object.getDescription
             harmony.Patch(
@@ -39,11 +30,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             // object.getDisplayName
             harmony.Patch(
                 original: AccessTools.Method(typeof(SObject), "loadDisplayName"),
-#if HARMONY_2
                 finalizer: new HarmonyMethod(this.GetType(), nameof(ObjectErrorPatch.Finalize_Object_loadDisplayName))
-#else
-                prefix: new HarmonyMethod(this.GetType(), nameof(ObjectErrorPatch.Before_Object_loadDisplayName))
-#endif
             );
 
             // IClickableMenu.drawToolTip
@@ -73,7 +60,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             return true;
         }
 
-#if HARMONY_2
         /// <summary>The method to call after <see cref="StardewValley.Object.loadDisplayName"/>.</summary>
         /// <param name="__result">The patched method's return value.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
@@ -88,38 +74,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 
             return __exception;
         }
-#else
-        /// <summary>The method to call instead of <see cref="StardewValley.Object.loadDisplayName"/>.</summary>
-        /// <param name="__instance">The instance being patched.</param>
-        /// <param name="__result">The patched method's return value.</param>
-        /// <param name="__originalMethod">The method being wrapped.</param>
-        /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_Object_loadDisplayName(SObject __instance, ref string __result, MethodInfo __originalMethod)
-        {
-            const string key = nameof(ObjectErrorPatch.Before_Object_loadDisplayName);
-            if (!PatchHelper.StartIntercept(key))
-                return true;
-
-            try
-            {
-                __result = (string)__originalMethod.Invoke(__instance, new object[0]);
-                return false;
-            }
-            catch (TargetInvocationException ex) when (ex.InnerException is KeyNotFoundException)
-            {
-                __result = "???";
-                return false;
-            }
-            catch
-            {
-                return true;
-            }
-            finally
-            {
-                PatchHelper.StopIntercept(key);
-            }
-        }
-#endif
 
         /// <summary>The method to call instead of <see cref="IClickableMenu.drawToolTip"/>.</summary>
         /// <param name="hoveredItem">The item for which to draw a tooltip.</param>
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
index d2a5e988..d2e332b4 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
@@ -1,15 +1,10 @@
+using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
-using StardewModdingAPI.Framework.Patching;
-using StardewValley;
-#if HARMONY_2
-using System;
 using HarmonyLib;
 using StardewModdingAPI.Framework;
-#else
-using System.Reflection;
-using Harmony;
-#endif
+using StardewModdingAPI.Framework.Patching;
+using StardewValley;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
@@ -37,19 +32,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         }
 
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
-#else
-        public void Apply(HarmonyInstance harmony)
-#endif
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(NPC), nameof(NPC.parseMasterSchedule)),
-#if HARMONY_2
                 finalizer: new HarmonyMethod(this.GetType(), nameof(ScheduleErrorPatch.Finalize_NPC_parseMasterSchedule))
-#else
-                prefix: new HarmonyMethod(this.GetType(), nameof(ScheduleErrorPatch.Before_NPC_parseMasterSchedule))
-#endif
             );
         }
 
@@ -57,7 +44,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
-#if HARMONY_2
         /// <summary>The method to call instead of <see cref="NPC.parseMasterSchedule"/>.</summary>
         /// <param name="rawData">The raw schedule data to parse.</param>
         /// <param name="__instance">The instance being patched.</param>
@@ -74,35 +60,5 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 
             return null;
         }
-#else
-        /// <summary>The method to call instead of <see cref="NPC.parseMasterSchedule"/>.</summary>
-        /// <param name="rawData">The raw schedule data to parse.</param>
-        /// <param name="__instance">The instance being patched.</param>
-        /// <param name="__result">The patched method's return value.</param>
-        /// <param name="__originalMethod">The method being wrapped.</param>
-        /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_NPC_parseMasterSchedule(string rawData, NPC __instance, ref Dictionary<int, SchedulePathDescription> __result, MethodInfo __originalMethod)
-        {
-            const string key = nameof(ScheduleErrorPatch.Before_NPC_parseMasterSchedule);
-            if (!PatchHelper.StartIntercept(key))
-                return true;
-
-            try
-            {
-                __result = (Dictionary<int, SchedulePathDescription>)__originalMethod.Invoke(__instance, new object[] { rawData });
-                return false;
-            }
-            catch (TargetInvocationException ex)
-            {
-                ScheduleErrorPatch.MonitorForGame.Log($"Failed parsing schedule for NPC {__instance.Name}:\n{rawData}\n{ex.InnerException ?? ex}", LogLevel.Error);
-                __result = new Dictionary<int, SchedulePathDescription>();
-                return false;
-            }
-            finally
-            {
-                PatchHelper.StopIntercept(key);
-            }
-        }
-#endif
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
index 8056fd71..7fdf5a48 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
@@ -1,10 +1,6 @@
-#if HARMONY_2
-using HarmonyLib;
-#else
-using Harmony;
-#endif
 using System;
 using System.Diagnostics.CodeAnalysis;
+using HarmonyLib;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Patching;
 
@@ -20,11 +16,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Public methods
         *********/
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
-#else
-        public void Apply(HarmonyInstance harmony)
-#endif
         {
             harmony.Patch(
                 original: Constants.GameFramework == GameFramework.Xna
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
index 1ddd407c..cd57736f 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
@@ -1,12 +1,6 @@
-#if HARMONY_2
-using System;
-using HarmonyLib;
-#else
-using Harmony;
-#endif
 using System;
 using System.Diagnostics.CodeAnalysis;
-using System.Reflection;
+using HarmonyLib;
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
 
@@ -22,7 +16,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Public methods
         *********/
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
         {
             harmony.Patch(
@@ -30,21 +23,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 finalizer: new HarmonyMethod(this.GetType(), nameof(UtilityErrorPatches.Finalize_Utility_GetItemFromStandardTextDescription))
             );
         }
-#else
-        public void Apply(HarmonyInstance harmony)
-        {
-            harmony.Patch(
-                original: AccessTools.Method(typeof(Utility), nameof(Utility.getItemFromStandardTextDescription)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(UtilityErrorPatches.Before_Utility_GetItemFromStandardTextDescription))
-            );
-        }
-#endif
 
 
         /*********
         ** Private methods
         *********/
-#if HARMONY_2
         /// <summary>The method to call instead of <see cref="Utility.getItemFromStandardTextDescription"/>.</summary>
         /// <param name="description">The item text description to parse.</param>
         /// <param name="delimiter">The delimiter by which to split the text description.</param>
@@ -56,34 +39,5 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 ? new FormatException($"Failed to parse item text description \"{description}\" with delimiter \"{delimiter}\".", __exception)
                 : null;
         }
-#else
-        /// <summary>The method to call instead of <see cref="Utility.getItemFromStandardTextDescription"/>.</summary>
-        /// <param name="__result">The return value of the original method.</param>
-        /// <param name="description">The item text description to parse.</param>
-        /// <param name="who">The player for which the item is being parsed.</param>
-        /// <param name="delimiter">The delimiter by which to split the text description.</param>
-        /// <param name="__originalMethod">The method being wrapped.</param>
-        /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_Utility_GetItemFromStandardTextDescription(ref Item __result, string description, Farmer who, char delimiter, MethodInfo __originalMethod)
-        {
-            const string key = nameof(UtilityErrorPatches.Before_Utility_GetItemFromStandardTextDescription);
-            if (!PatchHelper.StartIntercept(key))
-                return true;
-
-            try
-            {
-                __result = (Item)__originalMethod.Invoke(null, new object[] { description, who, delimiter });
-                return false;
-            }
-            catch (TargetInvocationException ex)
-            {
-                throw new FormatException($"Failed to parse item text description \"{description}\" with delimiter \"{delimiter}\".", ex.InnerException);
-            }
-            finally
-            {
-                PatchHelper.StopIntercept(key);
-            }
-        }
-#endif
     }
 }
diff --git a/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs b/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
index f3731d16..45b34556 100644
--- a/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
+++ b/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
@@ -3,25 +3,13 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
 using System.Text;
-#if HARMONY_2
 using HarmonyLib;
-#else
-using Harmony;
-#endif
 
 namespace StardewModdingAPI.Framework.Commands
 {
     /// <summary>The 'harmony_summary' SMAPI console command.</summary>
     internal class HarmonySummaryCommand : IInternalCommand
     {
-#if !HARMONY_2
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The Harmony instance through which to fetch patch info.</summary>
-        private readonly HarmonyInstance HarmonyInstance = HarmonyInstance.Create($"SMAPI.{nameof(HarmonySummaryCommand)}");
-#endif
-
         /*********
         ** Accessors
         *********/
@@ -60,9 +48,7 @@ namespace StardewModdingAPI.Framework.Commands
                             {
                                 PatchType.Prefix => 0,
                                 PatchType.Postfix => 1,
-#if HARMONY_2
                                 PatchType.Finalizer => 2,
-#endif
                                 PatchType.Transpiler => 3,
                                 _ => 4
                             });
@@ -111,26 +97,16 @@ namespace StardewModdingAPI.Framework.Commands
         /// <summary>Get all current Harmony patches.</summary>
         private IEnumerable<SearchResult> GetAllPatches()
         {
-#if HARMONY_2
             foreach (MethodBase method in Harmony.GetAllPatchedMethods().ToArray())
-#else
-            foreach (MethodBase method in this.HarmonyInstance.GetPatchedMethods().ToArray())
-#endif
             {
                 // get metadata for method
-#if HARMONY_2
                 HarmonyLib.Patches patchInfo = Harmony.GetPatchInfo(method);
-#else
-                Harmony.Patches patchInfo = this.HarmonyInstance.GetPatchInfo(method);
-#endif
 
                 IDictionary<PatchType, IReadOnlyCollection<Patch>> patchGroups = new Dictionary<PatchType, IReadOnlyCollection<Patch>>
                 {
                     [PatchType.Prefix] = patchInfo.Prefixes,
                     [PatchType.Postfix] = patchInfo.Postfixes,
-#if HARMONY_2
                     [PatchType.Finalizer] = patchInfo.Finalizers,
-#endif
                     [PatchType.Transpiler] = patchInfo.Transpilers
                 };
 
@@ -160,10 +136,8 @@ namespace StardewModdingAPI.Framework.Commands
             /// <summary>A postfix patch.</summary>
             Postfix,
 
-#if HARMONY_2
             /// <summary>A finalizer patch.</summary>
             Finalizer,
-#endif
 
             /// <summary>A transpiler patch.</summary>
             Transpiler
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
index 102f3364..8e4320b3 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
@@ -1,4 +1,3 @@
-#if HARMONY_2
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -41,4 +40,3 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
         }
     }
 }
-#endif
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
index ad6d5e4f..54b91679 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
@@ -1,4 +1,3 @@
-#if HARMONY_2
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -81,4 +80,3 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
         }
     }
 }
-#endif
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
index f3975558..44c97401 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
@@ -1,4 +1,3 @@
-#if HARMONY_2
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
@@ -44,4 +43,3 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
         }
     }
 }
-#endif
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
index 147a12f9..5a84a16a 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
@@ -1,4 +1,3 @@
-#if HARMONY_2
 extern alias MonoCecilPackage;
 
 using System;
@@ -44,7 +43,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         }
 
         /// <inheritdoc />
-        public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction, Action<Instruction> replaceWith)
+        public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
             // rewrite Harmony 1.x methods to Harmony 2.0
             MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
@@ -119,4 +118,3 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         }
     }
 }
-#endif
diff --git a/src/SMAPI/Framework/Patching/GamePatcher.cs b/src/SMAPI/Framework/Patching/GamePatcher.cs
index ddecda08..3ce22ee9 100644
--- a/src/SMAPI/Framework/Patching/GamePatcher.cs
+++ b/src/SMAPI/Framework/Patching/GamePatcher.cs
@@ -1,9 +1,5 @@
 using System;
-#if HARMONY_2
 using HarmonyLib;
-#else
-using Harmony;
-#endif
 
 namespace StardewModdingAPI.Framework.Patching
 {
@@ -31,11 +27,7 @@ namespace StardewModdingAPI.Framework.Patching
         /// <param name="patches">The patches to apply.</param>
         public void Apply(params IHarmonyPatch[] patches)
         {
-#if HARMONY_2
             Harmony harmony = new Harmony("SMAPI");
-#else
-            HarmonyInstance harmony = HarmonyInstance.Create("SMAPI");
-#endif
             foreach (IHarmonyPatch patch in patches)
             {
                 try
diff --git a/src/SMAPI/Framework/Patching/IHarmonyPatch.cs b/src/SMAPI/Framework/Patching/IHarmonyPatch.cs
index 38d30ab2..c1ff3040 100644
--- a/src/SMAPI/Framework/Patching/IHarmonyPatch.cs
+++ b/src/SMAPI/Framework/Patching/IHarmonyPatch.cs
@@ -1,8 +1,4 @@
-#if HARMONY_2
 using HarmonyLib;
-#else
-using Harmony;
-#endif
 
 namespace StardewModdingAPI.Framework.Patching
 {
@@ -14,10 +10,6 @@ namespace StardewModdingAPI.Framework.Patching
         *********/
         /// <summary>Apply the Harmony patch.</summary>
         /// <param name="harmony">The Harmony instance.</param>
-#if HARMONY_2
         void Apply(Harmony harmony);
-#else
-        void Apply(HarmonyInstance harmony);
-#endif
     }
 }
diff --git a/src/SMAPI/Framework/Patching/PatchHelper.cs b/src/SMAPI/Framework/Patching/PatchHelper.cs
deleted file mode 100644
index d1aa0185..00000000
--- a/src/SMAPI/Framework/Patching/PatchHelper.cs
+++ /dev/null
@@ -1,36 +0,0 @@
-#if !HARMONY_2
-using System;
-using System.Collections.Generic;
-
-namespace StardewModdingAPI.Framework.Patching
-{
-    /// <summary>Provides generic methods for implementing Harmony patches.</summary>
-    internal class PatchHelper
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The interception keys currently being intercepted.</summary>
-        private static readonly HashSet<string> InterceptingKeys = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Track a method that will be intercepted.</summary>
-        /// <param name="key">The intercept key.</param>
-        /// <returns>Returns false if the method was already marked for interception, else true.</returns>
-        public static bool StartIntercept(string key)
-        {
-            return PatchHelper.InterceptingKeys.Add(key);
-        }
-
-        /// <summary>Track a method as no longer being intercepted.</summary>
-        /// <param name="key">The intercept key.</param>
-        public static void StopIntercept(string key)
-        {
-            PatchHelper.InterceptingKeys.Remove(key);
-        }
-    }
-}
-#endif
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index d1699636..a787993a 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -48,10 +48,8 @@ namespace StardewModdingAPI.Metadata
                 yield return new HeuristicFieldRewriter(this.ValidateReferencesToAssemblies);
                 yield return new HeuristicMethodRewriter(this.ValidateReferencesToAssemblies);
 
-#if HARMONY_2
-                // rewrite for SMAPI 3.x (Harmony 1.x => 2.0 update)
+                // rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
                 yield return new Harmony1AssemblyRewriter();
-#endif
             }
 
             /****
@@ -64,11 +62,7 @@ namespace StardewModdingAPI.Metadata
             /****
             ** detect code which may impact game stability
             ****/
-#if HARMONY_2
             yield return new TypeFinder(typeof(HarmonyLib.Harmony).FullName, InstructionHandleResult.DetectedGamePatch);
-#else
-            yield return new TypeFinder(typeof(Harmony.HarmonyInstance).FullName, InstructionHandleResult.DetectedGamePatch);
-#endif
             yield return new TypeFinder("System.Runtime.CompilerServices.CallSite", InstructionHandleResult.DetectedDynamic);
             yield return new FieldFinder(typeof(SaveGame).FullName, nameof(SaveGame.serializer), InstructionHandleResult.DetectedSaveSerializer);
             yield return new FieldFinder(typeof(SaveGame).FullName, nameof(SaveGame.farmerSerializer), InstructionHandleResult.DetectedSaveSerializer);
diff --git a/src/SMAPI/Patches/LoadContextPatch.cs b/src/SMAPI/Patches/LoadContextPatch.cs
index c43d7071..721cf53d 100644
--- a/src/SMAPI/Patches/LoadContextPatch.cs
+++ b/src/SMAPI/Patches/LoadContextPatch.cs
@@ -1,10 +1,6 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
-#if HARMONY_2
 using HarmonyLib;
-#else
-using Harmony;
-#endif
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Framework.Patching;
 using StardewModdingAPI.Framework.Reflection;
@@ -46,11 +42,7 @@ namespace StardewModdingAPI.Patches
         }
 
         /// <inheritdoc />
-#if HARMONY_2
         public void Apply(Harmony harmony)
-#else
-        public void Apply(HarmonyInstance harmony)
-#endif
         {
             // detect CreatedBasicInfo
             harmony.Patch(

From 72b3c9d14314a3f69a0ca9d6ac9de9de1d31943d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 14 Jul 2021 18:02:13 -0400
Subject: [PATCH 198/856] add workaround for Harmony 2.x breaking XNA content
 pipeline for some assets (#711, #722)

---
 src/SMAPI/Framework/SCore.cs                  |   2 +
 .../TemporaryHacks/MiniMonoModHotfix.cs       | 176 ++++++++++++++++++
 2 files changed, 178 insertions(+)
 create mode 100644 src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c3285979..4211abc5 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -46,6 +46,7 @@ using StardewModdingAPI.Toolkit.Utilities;
 using StardewModdingAPI.Utilities;
 using StardewValley;
 using xTile.Display;
+using MiniMonoModHotfix = MonoMod.Utils.MiniMonoModHotfix;
 using SObject = StardewValley.Object;
 
 namespace StardewModdingAPI.Framework
@@ -251,6 +252,7 @@ namespace StardewModdingAPI.Framework
                 StardewValley.GameRunner.instance = this.Game;
 
                 // apply game patches
+                MiniMonoModHotfix.Apply();
                 new GamePatcher(this.Monitor).Apply(
                     new LoadContextPatch(this.Reflection, this.OnLoadStageChanged)
                 );
diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
new file mode 100644
index 00000000..6814abea
--- /dev/null
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -0,0 +1,176 @@
+// This temporary utility fixes an esoteric issue in XNA Framework where deserialization depends on
+// the order of fields returned by Type.GetFields, but that order changes after Harmony/MonoMod use
+// reflection to access the fields due to an issue in .NET Framework.
+// https://twitter.com/0x0ade/status/1414992316964687873
+//
+// This will be removed when Harmony/MonoMod are updated to incorporate the fix.
+//
+// Special thanks to 0x0ade for submitting this worokaround! Copy/pasted and adapted from MonoMod.
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using System.Reflection;
+using System.Reflection.Emit;
+using System.Runtime.CompilerServices;
+using HarmonyLib;
+
+// ReSharper disable once CheckNamespace -- Temporary hotfix submitted by the MonoMod author.
+namespace MonoMod.Utils
+{
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Temporary hotfix submitted by the MonoMod author.")]
+    [SuppressMessage("ReSharper", "PossibleNullReferenceException", Justification = "Temporary hotfix submitted by the MonoMod author.")]
+    static class MiniMonoModHotfix
+    {
+        // .NET Framework can break member ordering if using Module.Resolve* on certain members.
+
+        private static readonly object[] _NoArgs = new object[0];
+        private static readonly object[] _CacheGetterArgs = { /* MemberListType.All */ 0, /* name apparently always null? */ null };
+
+        private static readonly Type t_RuntimeModule =
+            typeof(Module).Assembly
+            .GetType("System.Reflection.RuntimeModule");
+
+        private static readonly PropertyInfo p_RuntimeModule_RuntimeType =
+            typeof(Module).Assembly
+            .GetType("System.Reflection.RuntimeModule")
+            ?.GetProperty("RuntimeType", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
+
+        private static readonly Type t_RuntimeType =
+            typeof(Type).Assembly
+            .GetType("System.RuntimeType");
+
+        private static readonly PropertyInfo p_RuntimeType_Cache =
+            typeof(Type).Assembly
+            .GetType("System.RuntimeType")
+            ?.GetProperty("Cache", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
+
+        private static readonly MethodInfo m_RuntimeTypeCache_GetFieldList =
+            typeof(Type).Assembly
+            .GetType("System.RuntimeType+RuntimeTypeCache")
+            ?.GetMethod("GetFieldList", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
+
+        private static readonly MethodInfo m_RuntimeTypeCache_GetPropertyList =
+            typeof(Type).Assembly
+            .GetType("System.RuntimeType+RuntimeTypeCache")
+            ?.GetMethod("GetPropertyList", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
+
+        private static readonly ConditionalWeakTable<Type, object> _CacheFixed = new ConditionalWeakTable<Type, object>();
+
+        public static void Apply()
+        {
+            var harmony = new Harmony("MiniMonoModHotfix");
+
+            harmony.Patch(
+                original: typeof(Harmony).Assembly
+                    .GetType("HarmonyLib.MethodBodyReader")
+                    .GetMethod("ReadOperand", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance),
+                transpiler: new HarmonyMethod(typeof(MiniMonoModHotfix), nameof(ResolveTokenFix))
+            );
+
+            harmony.Patch(
+                original: typeof(Harmony).Assembly
+                    .GetType("MonoMod.Utils.DynamicMethodDefinition+<>c__DisplayClass3_0")
+                    .GetMethod("<_CopyMethodToDefinition>g__ResolveTokenAs|1", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance),
+                transpiler: new HarmonyMethod(typeof(MiniMonoModHotfix), nameof(ResolveTokenFix))
+            );
+
+        }
+
+        private static IEnumerable<CodeInstruction> ResolveTokenFix(IEnumerable<CodeInstruction> instrs)
+        {
+            MethodInfo getdecl = typeof(MiniMonoModHotfix).GetMethod(nameof(GetRealDeclaringType));
+            MethodInfo fixup = typeof(MiniMonoModHotfix).GetMethod(nameof(FixReflectionCache));
+
+            foreach (CodeInstruction instr in instrs)
+            {
+                yield return instr;
+
+                if (instr.operand is MethodInfo called)
+                {
+                    switch (called.Name)
+                    {
+                        case "ResolveType":
+                            // type.FixReflectionCache();
+                            yield return new CodeInstruction(OpCodes.Dup);
+                            yield return new CodeInstruction(OpCodes.Call, fixup);
+                            break;
+
+                        case "ResolveMember":
+                        case "ResolveMethod":
+                        case "ResolveField":
+                            // member.GetRealDeclaringType().FixReflectionCache();
+                            yield return new CodeInstruction(OpCodes.Dup);
+                            yield return new CodeInstruction(OpCodes.Call, getdecl);
+                            yield return new CodeInstruction(OpCodes.Call, fixup);
+                            break;
+                    }
+                }
+            }
+        }
+
+        public static Type GetModuleType(this Module module)
+        {
+            // Sadly we can't blindly resolve type 0x02000001 as the runtime throws ArgumentException.
+
+            if (module == null || t_RuntimeModule == null || !t_RuntimeModule.IsInstanceOfType(module))
+                return null;
+
+            // .NET
+            if (p_RuntimeModule_RuntimeType != null)
+                return (Type)p_RuntimeModule_RuntimeType.GetValue(module, _NoArgs);
+
+            // The hotfix doesn't apply to Mono anyway, thus that's not copied over.
+
+            return null;
+        }
+
+        public static Type GetRealDeclaringType(this MemberInfo member)
+            => member.DeclaringType ?? member.Module?.GetModuleType();
+
+        public static void FixReflectionCache(this Type type)
+        {
+            if (t_RuntimeType == null ||
+                p_RuntimeType_Cache == null ||
+                m_RuntimeTypeCache_GetFieldList == null ||
+                m_RuntimeTypeCache_GetPropertyList == null)
+                return;
+
+            for (; type != null; type = type.DeclaringType)
+            {
+                // All types SHOULD inherit RuntimeType, including those built at runtime.
+                // One might never know what awaits us in the depths of reflection hell though.
+                if (!t_RuntimeType.IsInstanceOfType(type))
+                    continue;
+
+                _CacheFixed.GetValue(type, rt =>
+                {
+
+                    object cache = p_RuntimeType_Cache.GetValue(rt, _NoArgs);
+                    _FixReflectionCacheOrder<PropertyInfo>(cache, m_RuntimeTypeCache_GetPropertyList);
+                    _FixReflectionCacheOrder<FieldInfo>(cache, m_RuntimeTypeCache_GetFieldList);
+
+                    return new object();
+                });
+            }
+        }
+
+        private static void _FixReflectionCacheOrder<T>(object cache, MethodInfo getter) where T : MemberInfo
+        {
+            // Get and discard once, otherwise we might not be getting the actual backing array.
+            getter.Invoke(cache, _CacheGetterArgs);
+            Array orig = (Array)getter.Invoke(cache, _CacheGetterArgs);
+
+            // Sort using a short-lived list.
+            List<T> list = new List<T>(orig.Length);
+            for (int i = 0; i < orig.Length; i++)
+                list.Add((T)orig.GetValue(i));
+
+            list.Sort((a, b) => a.MetadataToken - b.MetadataToken);
+
+            for (int i = orig.Length - 1; i >= 0; --i)
+                orig.SetValue(list[i], i);
+        }
+
+    }
+}

From 735893c1d5549915c2874a9e17dc1d9844408710 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 17 Jul 2021 18:52:06 -0400
Subject: [PATCH 199/856] add error if player manually installs wrong SMAPI
 bitness

---
 docs/release-notes.md                               |  4 ++++
 src/SMAPI.Installer/InteractiveInstaller.cs         |  3 ++-
 .../Framework/LowLevelEnvironmentUtility.cs         |  9 ++++++++-
 src/SMAPI/Program.cs                                | 13 ++++++++++++-
 4 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d0aa2fbf..9727dd6a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   * Migrated to Harmony 2.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
 -->
 
+## Upcoming release
+* For players:
+  * Added error message if you manually install the wrong SMAPI bitness (e.g. 32-bit SMAPI with 64-bit game).
+
 ## 3.11.0
 Released 09 July 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/53514295).
 
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 55e9c064..ab07c864 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -9,6 +9,7 @@ using StardewModdingApi.Installer.Enums;
 using StardewModdingAPI.Installer.Framework;
 using StardewModdingAPI.Internal.ConsoleWriting;
 using StardewModdingAPI.Toolkit;
+using StardewModdingAPI.Toolkit.Framework;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Utilities;
 
@@ -571,7 +572,7 @@ namespace StardewModdingApi.Installer
         /// <param name="executablePath">The absolute path to the executable file.</param>
         private bool Is64Bit(string executablePath)
         {
-            return AssemblyName.GetAssemblyName(executablePath).ProcessorArchitecture != ProcessorArchitecture.X86;
+            return LowLevelEnvironmentUtility.Is64BitAssembly(executablePath);
         }
 
         /// <summary>Get the display text for a color scheme.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index 8cbd8e51..be0c18ce 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -2,6 +2,7 @@ using System;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
+using System.Reflection;
 #if SMAPI_FOR_WINDOWS
 using System.Management;
 #endif
@@ -48,7 +49,6 @@ namespace StardewModdingAPI.Toolkit.Framework
             }
         }
 
-
         /// <summary>Get the human-readable OS name and version.</summary>
         /// <param name="platform">The current platform.</param>
         [SuppressMessage("ReSharper", "EmptyGeneralCatchClause", Justification = "Error suppressed deliberately to fallback to default behaviour.")]
@@ -89,6 +89,13 @@ namespace StardewModdingAPI.Toolkit.Framework
                 : "StardewValley.exe";
         }
 
+        /// <summary>Get whether an executable is 64-bit.</summary>
+        /// <param name="executablePath">The absolute path to the executable file.</param>
+        public static bool Is64BitAssembly(string executablePath)
+        {
+            return AssemblyName.GetAssemblyName(executablePath).ProcessorArchitecture != ProcessorArchitecture.X86;
+        }
+
 
         /*********
         ** Private methods
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index e830f799..0257a03e 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -4,6 +4,7 @@ using System.Linq;
 using System.Reflection;
 using System.Threading;
 using StardewModdingAPI.Framework;
+using StardewModdingAPI.Toolkit.Framework;
 
 namespace StardewModdingAPI
 {
@@ -107,8 +108,18 @@ namespace StardewModdingAPI
             }
 
             // max version
-            else if (Constants.MaximumGameVersion != null && Constants.GameVersion.IsNewerThan(Constants.MaximumGameVersion))
+            if (Constants.MaximumGameVersion != null && Constants.GameVersion.IsNewerThan(Constants.MaximumGameVersion))
                 Program.PrintErrorAndExit($"Oops! You're running Stardew Valley {Constants.GameVersion}, but this version of SMAPI is only compatible up to Stardew Valley {Constants.MaximumGameVersion}. Please check for a newer version of SMAPI: https://smapi.io.");
+
+            // bitness
+            bool is64BitGame = LowLevelEnvironmentUtility.Is64BitAssembly(Path.Combine(EarlyConstants.ExecutionPath, $"{EarlyConstants.GameAssemblyName}.exe"));
+#if SMAPI_FOR_WINDOWS_64BIT_HACK
+            if (!is64bit)
+                Program.PrintErrorAndExit("Oops! This is the 64-bit version of SMAPI, but you have the 32-bit version of Stardew Valley. You can reinstall SMAPI using its installer to automatically install the correct version of SMAPI.");
+#elif SMAPI_FOR_WINDOWS
+            if (is64BitGame)
+                Program.PrintErrorAndExit("Oops! This is the 32-bit version of SMAPI, but you have the 64-bit version of Stardew Valley. You can reinstall SMAPI using its installer to automatically install the correct version of SMAPI.");
+#endif
         }
 
         /// <summary>Initialize SMAPI and launch the game.</summary>

From defa1b9a95c6bcb680bef3506ab94a71ed6189d6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 20 Jul 2021 18:43:56 -0400
Subject: [PATCH 200/856] fix concurrency issue in interface proxying

---
 docs/release-notes.md                         |  1 +
 .../Reflection/InterfaceProxyFactory.cs       | 33 ++++++++++---------
 2 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9727dd6a..bfea8bfb 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Added error message if you manually install the wrong SMAPI bitness (e.g. 32-bit SMAPI with 64-bit game).
+  * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
 
 ## 3.11.0
 Released 09 July 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/53514295).
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index 464367b6..8d1b6034 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -36,23 +36,26 @@ namespace StardewModdingAPI.Framework.Reflection
         public TInterface CreateProxy<TInterface>(object instance, string sourceModID, string targetModID)
             where TInterface : class
         {
-            // validate
-            if (instance == null)
-                throw new InvalidOperationException("Can't proxy access to a null API.");
-            if (!typeof(TInterface).IsInterface)
-                throw new InvalidOperationException("The proxy type must be an interface, not a class.");
-
-            // get proxy type
-            Type targetType = instance.GetType();
-            string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{typeof(TInterface).FullName}>_To<{targetModID}_{targetType.FullName}>";
-            if (!this.Builders.TryGetValue(proxyTypeName, out InterfaceProxyBuilder builder))
+            lock (this.Builders)
             {
-                builder = new InterfaceProxyBuilder(proxyTypeName, this.ModuleBuilder, typeof(TInterface), targetType);
-                this.Builders[proxyTypeName] = builder;
-            }
+                // validate
+                if (instance == null)
+                    throw new InvalidOperationException("Can't proxy access to a null API.");
+                if (!typeof(TInterface).IsInterface)
+                    throw new InvalidOperationException("The proxy type must be an interface, not a class.");
 
-            // create instance
-            return (TInterface)builder.CreateInstance(instance);
+                // get proxy type
+                Type targetType = instance.GetType();
+                string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{typeof(TInterface).FullName}>_To<{targetModID}_{targetType.FullName}>";
+                if (!this.Builders.TryGetValue(proxyTypeName, out InterfaceProxyBuilder builder))
+                {
+                    builder = new InterfaceProxyBuilder(proxyTypeName, this.ModuleBuilder, typeof(TInterface), targetType);
+                    this.Builders[proxyTypeName] = builder;
+                }
+
+                // create instance
+                return (TInterface)builder.CreateInstance(instance);
+            }
         }
     }
 }

From c74702b027aeab927b4e038e440cbbb24d859cfd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 20 Jul 2021 22:18:57 -0400
Subject: [PATCH 201/856] fix error loading .xnb files from the local mod
 folder since SMAPI 3.0

---
 docs/release-notes.md                                    | 3 +++
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 4 +++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index bfea8bfb..fea93104 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,6 +12,9 @@
   * Added error message if you manually install the wrong SMAPI bitness (e.g. 32-bit SMAPI with 64-bit game).
   * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
 
+* For mod authors:
+  * Fixed error loading `.xnb` files from the local mod folder since SMAPI 3.0.
+
 ## 3.11.0
 Released 09 July 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/53514295).
 
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 4f6aa775..bc5a8b74 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -77,6 +77,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <inheritdoc />
         public override T Load<T>(string assetName, LanguageCode language, bool useCache)
         {
+            // normalize key
+            bool isXnbFile = Path.GetExtension(assetName).ToLower() == ".xnb";
             assetName = this.AssertAndNormalizeAssetName(assetName);
 
             // disable caching
@@ -108,7 +110,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             try
             {
                 // get file
-                FileInfo file = this.GetModFile(assetName);
+                FileInfo file = this.GetModFile(isXnbFile ? $"{assetName}.xnb" : assetName); // .xnb extension is stripped from asset names passed to the content manager
                 if (!file.Exists)
                     throw GetContentError("the specified path doesn't exist.");
 

From 7e5d77fb8c2606795af239717a596de460bc58f7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 21 Jul 2021 00:43:43 -0400
Subject: [PATCH 202/856] add error if some SMAPI DLLs have mismatched versions

---
 docs/release-notes.md |  3 ++-
 src/SMAPI/Program.cs  | 16 ++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index fea93104..1614f169 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,8 @@
 
 ## Upcoming release
 * For players:
-  * Added error message if you manually install the wrong SMAPI bitness (e.g. 32-bit SMAPI with 64-bit game).
+  * Added error if the wrong SMAPI bitness is installed (e.g. 32-bit SMAPI with 64-bit game).
+  * Added error if some SMAPI files aren't updated correctly.
   * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
 
 * For mod authors:
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 0257a03e..e6e51ac6 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -5,6 +5,7 @@ using System.Reflection;
 using System.Threading;
 using StardewModdingAPI.Framework;
 using StardewModdingAPI.Toolkit.Framework;
+using StardewModdingAPI.Toolkit.Serialization.Models;
 
 namespace StardewModdingAPI
 {
@@ -32,6 +33,7 @@ namespace StardewModdingAPI
                 AppDomain.CurrentDomain.AssemblyResolve += Program.CurrentDomain_AssemblyResolve;
                 Program.AssertGamePresent();
                 Program.AssertGameVersion();
+                Program.AssertSmapiVersions();
                 Program.Start(args);
             }
             catch (BadImageFormatException ex) when (ex.FileName == "StardewValley" || ex.FileName == "Stardew Valley") // don't use EarlyConstants.GameAssemblyName, since we want to check both possible names
@@ -122,6 +124,20 @@ namespace StardewModdingAPI
 #endif
         }
 
+        /// <summary>Assert that the versions of all SMAPI components are correct.</summary>
+        /// <remarks>Players sometimes have mismatched versions (particularly when installed through Vortex), which can cause some very confusing bugs without this check.</remarks>
+        private static void AssertSmapiVersions()
+        {
+            // SMAPI toolkit
+            foreach (var type in new[] { typeof(IManifest), typeof(Manifest) })
+            {
+                Assembly assembly = type.Assembly;
+                var assemblyVersion = new SemanticVersion(assembly.GetName().Version);
+                if (!assemblyVersion.Equals(Constants.ApiVersion))
+                    Program.PrintErrorAndExit($"Oops! The 'smapi-internal/{assembly.GetName().Name}.dll' file is version {assemblyVersion} instead of the required {Constants.ApiVersion}. SMAPI doesn't seem to be installed correctly.");
+            }
+        }
+
         /// <summary>Initialize SMAPI and launch the game.</summary>
         /// <param name="args">The command-line arguments.</param>
         /// <remarks>This method is separate from <see cref="Main"/> because that can't contain any references to assemblies loaded by <see cref="CurrentDomain_AssemblyResolve"/> (e.g. via <see cref="Constants"/>), or Mono will incorrectly show an assembly resolution error before assembly resolution is set up.</remarks>

From 163511e68e3e94dcda6ffc8b7e32d91c1f6c0c17 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 21 Jul 2021 23:08:18 -0400
Subject: [PATCH 203/856] merge release note sections

---
 docs/release-notes.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4fdfa247..26188ff3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,10 +1,6 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
-* For mod authors:
-  * Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
-
 ## Upcoming release
 * For players:
   * Added error if the wrong SMAPI bitness is installed (e.g. 32-bit SMAPI with 64-bit game).
@@ -12,6 +8,7 @@
   * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
 
 * For mod authors:
+  * Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
   * Fixed error loading `.xnb` files from the local mod folder since SMAPI 3.0.
 
 ## 3.11.0

From 88be0cee94cced9a31efe7ff76684514fcdc638d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 21 Jul 2021 23:28:18 -0400
Subject: [PATCH 204/856] fix new validation checks

---
 src/SMAPI/Program.cs | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index e6e51ac6..3249e02f 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -116,7 +116,7 @@ namespace StardewModdingAPI
             // bitness
             bool is64BitGame = LowLevelEnvironmentUtility.Is64BitAssembly(Path.Combine(EarlyConstants.ExecutionPath, $"{EarlyConstants.GameAssemblyName}.exe"));
 #if SMAPI_FOR_WINDOWS_64BIT_HACK
-            if (!is64bit)
+            if (!is64BitGame)
                 Program.PrintErrorAndExit("Oops! This is the 64-bit version of SMAPI, but you have the 32-bit version of Stardew Valley. You can reinstall SMAPI using its installer to automatically install the correct version of SMAPI.");
 #elif SMAPI_FOR_WINDOWS
             if (is64BitGame)
@@ -128,13 +128,16 @@ namespace StardewModdingAPI
         /// <remarks>Players sometimes have mismatched versions (particularly when installed through Vortex), which can cause some very confusing bugs without this check.</remarks>
         private static void AssertSmapiVersions()
         {
-            // SMAPI toolkit
+            // get SMAPI version without prerelease suffix (since we can't get that from the assembly versions)
+            ISemanticVersion smapiVersion = new SemanticVersion(Constants.ApiVersion.MajorVersion, Constants.ApiVersion.MinorVersion, Constants.ApiVersion.PatchVersion);
+
+            // compare with assembly versions
             foreach (var type in new[] { typeof(IManifest), typeof(Manifest) })
             {
-                Assembly assembly = type.Assembly;
-                var assemblyVersion = new SemanticVersion(assembly.GetName().Version);
-                if (!assemblyVersion.Equals(Constants.ApiVersion))
-                    Program.PrintErrorAndExit($"Oops! The 'smapi-internal/{assembly.GetName().Name}.dll' file is version {assemblyVersion} instead of the required {Constants.ApiVersion}. SMAPI doesn't seem to be installed correctly.");
+                AssemblyName assemblyName = type.Assembly.GetName();
+                ISemanticVersion assemblyVersion = new SemanticVersion(assemblyName.Version);
+                if (!assemblyVersion.Equals(smapiVersion))
+                    Program.PrintErrorAndExit($"Oops! The 'smapi-internal/{assemblyName.Name}.dll' file is version {assemblyVersion} instead of the required {Constants.ApiVersion}. SMAPI doesn't seem to be installed correctly.");
             }
         }
 

From 167d5831d12f0b7c58b3533b716f9041f6ae02e7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 23 Jul 2021 20:29:44 -0400
Subject: [PATCH 205/856] use unmerged Harmony assembly (#711)

Harmony merges Mono.Cecil and MonoMod.Common into its DLL, and keeps some (but not all) of the merged types public. That causes type conflicts in SMAPI's code since it uses both Harmony and Mono.Cecil, and extern aliases break on Linux due to IDE/compiler limitations. This commit uses a custom build of Harmony without the assembly merging, so SMAPI can use and manage Mono.Cecil itself.
---
 build/0Harmony.dll                            | Bin 802816 -> 166912 bytes
 build/common.targets                          |   3 +++
 build/prepare-install-package.targets         |   3 +++
 .../TemporaryHacks/MiniMonoModHotfix.cs       |   2 +-
 src/SMAPI/SMAPI.csproj                        |   3 ++-
 5 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/build/0Harmony.dll b/build/0Harmony.dll
index 1c5b9c0948858a6ea17ae8c842db65b9b0857cc4..bab3bb4d1375bde11b88013653d36bdad5ebab14 100644
GIT binary patch
literal 166912
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

literal 802816
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%0A2!Ra_hG9nvY-lJ9J4#^l
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%0D<3Z9+Ou%S0w}-%=N{
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

diff --git a/build/common.targets b/build/common.targets
index f5d01606..aed619da 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -40,6 +40,9 @@
     <Copy SourceFiles="$(TargetDir)\0Harmony.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\0Harmony.xml" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\Mono.Cecil.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Mdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Pdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\MonoMod.Common.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\Newtonsoft.Json.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\TMXTile.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\smapi-internal\i18n" />
diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index 0c1a6c1a..88e565f9 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -47,6 +47,9 @@
     <Copy SourceFiles="$(SmapiBin)\0Harmony.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(SmapiBin)\0Harmony.xml" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(SmapiBin)\Mono.Cecil.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
+    <Copy SourceFiles="$(SmapiBin)\Mono.Cecil.Mdb.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
+    <Copy SourceFiles="$(SmapiBin)\Mono.Cecil.Pdb.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
+    <Copy SourceFiles="$(SmapiBin)\MonoMod.Common.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(SmapiBin)\Newtonsoft.Json.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(SmapiBin)\TMXTile.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(SmapiBin)\SMAPI.config.json" DestinationFiles="$(PackagePath)\bundle\smapi-internal\config.json" />
diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
index 6814abea..9f5819d7 100644
--- a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -69,7 +69,7 @@ namespace MonoMod.Utils
             );
 
             harmony.Patch(
-                original: typeof(Harmony).Assembly
+                original: typeof(MonoMod.Utils.ReflectionHelper).Assembly
                     .GetType("MonoMod.Utils.DynamicMethodDefinition+<>c__DisplayClass3_0")
                     .GetMethod("<_CopyMethodToDefinition>g__ResolveTokenAs|1", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance),
                 transpiler: new HarmonyMethod(typeof(MiniMonoModHotfix), nameof(ResolveTokenFix))
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index d36d0d7a..d06e3364 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -20,9 +20,10 @@
 
   <ItemGroup>
     <PackageReference Include="LargeAddressAware" Version="1.0.5" />
-    <PackageReference Include="Mono.Cecil" Version="0.11.3">
+    <PackageReference Include="Mono.Cecil" Version="0.11.4">
       <Aliases>MonoCecilPackage</Aliases>
     </PackageReference>
+    <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.8" />
   </ItemGroup>

From 175eaad68373185b010410c5e2de1af9afbba1f5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 23 Jul 2021 20:37:26 -0400
Subject: [PATCH 206/856] remove now-unneeded Mono.Cecil aliases (#711)

---
 .../Framework/ModLoading/AssemblyDefinitionResolver.cs    | 4 +---
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs          | 6 ++----
 src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs     | 4 +---
 src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs     | 6 ++----
 src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs     | 6 ++----
 src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs    | 6 ++----
 src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs  | 6 ++----
 .../Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs  | 6 ++----
 .../ModLoading/Finders/ReferenceToMissingMemberFinder.cs  | 6 ++----
 .../Framework/ModLoading/Finders/TypeAssemblyFinder.cs    | 4 +---
 src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs      | 4 +---
 .../ModLoading/Framework/BaseInstructionHandler.cs        | 6 ++----
 .../Framework/ModLoading/Framework/RecursiveRewriter.cs   | 8 +++-----
 src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs | 6 ++----
 src/SMAPI/Framework/ModLoading/IInstructionHandler.cs     | 6 ++----
 src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs     | 4 +---
 .../ModLoading/Rewriters/FieldReplaceRewriter.cs          | 6 ++----
 .../ModLoading/Rewriters/Harmony1AssemblyRewriter.cs      | 6 ++----
 .../ModLoading/Rewriters/HeuristicFieldRewriter.cs        | 6 ++----
 .../ModLoading/Rewriters/HeuristicMethodRewriter.cs       | 6 ++----
 .../ModLoading/Rewriters/MethodParentRewriter.cs          | 6 ++----
 .../ModLoading/Rewriters/TypeReferenceRewriter.cs         | 4 +---
 src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs   | 4 +---
 src/SMAPI/SMAPI.csproj                                    | 4 +---
 24 files changed, 41 insertions(+), 89 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
index 9867ed8b..aefb0126 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
 using System.Collections.Generic;
-using MonoCecilPackage.Mono.Cecil;
+using Mono.Cecil;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 8311a4b9..3606eb66 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -1,12 +1,10 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Reflection;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 using StardewModdingAPI.Metadata;
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs b/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
index 6493ccf8..b56a776c 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
 using System.IO;
-using MonoCecilPackage.Mono.Cecil;
+using Mono.Cecil;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
diff --git a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
index 2e349616..01ed153b 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
index 434ff5ab..2c062243 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
index 80229155..d2340f01 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
index 5ef66df4..99344848 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
index 80296e38..b01a3240 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System.Collections.Generic;
 using System.Linq;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
index fae8ee95..b64a255e 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
@@ -1,8 +1,6 @@
-extern alias MonoCecilPackage;
-
 using System.Collections.Generic;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
index 3e107b90..24ab2eca 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
 using System;
-using MonoCecilPackage.Mono.Cecil;
+using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
index 9453c39f..bbd081e8 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
 using System;
-using MonoCecilPackage.Mono.Cecil;
+using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Finders
diff --git a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
index 3979d431..624113b3 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Collections.Generic;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 
 namespace StardewModdingAPI.Framework.ModLoading.Framework
 {
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
index e79bb488..10f68f0d 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
@@ -1,11 +1,9 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
-using MonoCecilPackage.Mono.Collections.Generic;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+using Mono.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.ModLoading.Framework
 {
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
index e88b75ed..60bbd2c7 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
@@ -1,10 +1,8 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Linq;
 using System.Reflection;
-using MonoCecilPackage::Mono.Cecil;
-using MonoCecilPackage::Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 
 namespace StardewModdingAPI.Framework.ModLoading.Framework
 {
diff --git a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
index 342721cd..17c9ba68 100644
--- a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Collections.Generic;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
diff --git a/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs b/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
index ee123e75..d4366294 100644
--- a/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
+++ b/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
@@ -1,10 +1,8 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
-using MonoCecilPackage.Mono.Cecil;
+using Mono.Cecil;
 using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Framework.ModLoading
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
index d40d4111..0b679e9d 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Reflection;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
index 5a84a16a..723983be 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System;
 using HarmonyLib;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 using StardewModdingAPI.Framework.ModLoading.RewriteFacades;
 
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
index c381e4e5..f59a6ab1 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System.Collections.Generic;
 using System.Linq;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
index 748c1e6f..e133b6fa 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System.Collections.Generic;
 using System.Linq;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
index 5e0d9c70..9933e2ca 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Linq;
-using MonoCecilPackage.Mono.Cecil;
-using MonoCecilPackage.Mono.Cecil.Cil;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
index a4d09ae9..ad5cb96f 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
@@ -1,7 +1,5 @@
-extern alias MonoCecilPackage;
-
 using System;
-using MonoCecilPackage.Mono.Cecil;
+using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
diff --git a/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs b/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
index fab424f3..a4ac54e2 100644
--- a/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
+++ b/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
@@ -1,9 +1,7 @@
-extern alias MonoCecilPackage;
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using MonoCecilPackage.Mono.Cecil;
+using Mono.Cecil;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index d06e3364..0c6cfdd3 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -20,9 +20,7 @@
 
   <ItemGroup>
     <PackageReference Include="LargeAddressAware" Version="1.0.5" />
-    <PackageReference Include="Mono.Cecil" Version="0.11.4">
-      <Aliases>MonoCecilPackage</Aliases>
-    </PackageReference>
+    <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.8" />

From bdae52c9ae76303fd8082b10763b9ab7660fbd35 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 26 Jul 2021 22:28:32 -0400
Subject: [PATCH 207/856] fix rewriting for Harmony ExceptionBlock type (#711)

---
 .../Rewriters/Harmony1AssemblyRewriter.cs     | 46 +++++++++----------
 1 file changed, 22 insertions(+), 24 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
index 723983be..3197c151 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
@@ -28,7 +28,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         public override bool Handle(ModuleDefinition module, TypeReference type, Action<TypeReference> replaceWith)
         {
             // rewrite Harmony 1.x type to Harmony 2.0 type
-            if (type.Scope is AssemblyNameReference scope && scope.Name == "0Harmony" && scope.Version.Major == 1)
+            if (type.Scope is AssemblyNameReference { Name: "0Harmony" } scope && scope.Version.Major == 1)
             {
                 Type targetType = this.GetMappedType(type);
                 replaceWith(module.ImportReference(targetType));
@@ -72,24 +72,15 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
                 return false; // not Harmony (or already using Harmony 2.0)
 
             // get facade type
-            Type toType;
-            switch (methodRef?.DeclaringType.FullName)
+            Type toType = methodRef?.DeclaringType.FullName switch
             {
-                case "HarmonyLib.Harmony":
-                    toType = typeof(HarmonyInstanceFacade);
-                    break;
-
-                case "HarmonyLib.AccessTools":
-                    toType = typeof(AccessToolsFacade);
-                    break;
-
-                case "HarmonyLib.HarmonyMethod":
-                    toType = typeof(HarmonyMethodFacade);
-                    break;
-
-                default:
-                    return false;
-            }
+                "HarmonyLib.Harmony" => typeof(HarmonyInstanceFacade),
+                "HarmonyLib.AccessTools" => typeof(AccessToolsFacade),
+                "HarmonyLib.HarmonyMethod" => typeof(HarmonyMethodFacade),
+                _ => null
+            };
+            if (toType == null)
+                return false;
 
             // map if there's a matching method
             if (RewriteHelper.HasMatchingSignature(toType, methodRef))
@@ -102,16 +93,23 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         }
 
         /// <summary>Get an equivalent Harmony 2.x type.</summary>
-        /// <param name="type">The Harmony 1.x method.</param>
+        /// <param name="type">The Harmony 1.x type.</param>
         private Type GetMappedType(TypeReference type)
         {
-            // main Harmony object
-            if (type.FullName == "Harmony.HarmonyInstance")
-                return typeof(Harmony);
+            return type.FullName switch
+            {
+                "Harmony.HarmonyInstance" => typeof(Harmony),
+                "Harmony.ILCopying.ExceptionBlock" => typeof(ExceptionBlock),
+                _ => this.GetMappedTypeByConvention(type)
+            };
+        }
 
-            // other objects
+        /// <summary>Get an equivalent Harmony 2.x type using the convention expected for most types.</summary>
+        /// <param name="type">The Harmony 1.x type.</param>
+        private Type GetMappedTypeByConvention(TypeReference type)
+        {
             string fullName = type.FullName.Replace("Harmony.", "HarmonyLib.");
-            string targetName = typeof(Harmony).AssemblyQualifiedName.Replace(typeof(Harmony).FullName, fullName);
+            string targetName = typeof(Harmony).AssemblyQualifiedName!.Replace(typeof(Harmony).FullName!, fullName);
             return Type.GetType(targetName, throwOnError: true);
         }
     }

From 97710d6f47ca180540d8b5c203ae6f4ca089fcb8 Mon Sep 17 00:00:00 2001
From: bladeoflight16 <1159076+bladeoflight16@users.noreply.github.com>
Date: Tue, 27 Jul 2021 17:17:56 -0400
Subject: [PATCH 208/856] Fixing mono incompatibility (case exception type
 statement without variable)

---
 src/SMAPI/Framework/Logging/LogManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index a4df3c18..2cd512e0 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -258,7 +258,7 @@ namespace StardewModdingAPI.Framework.Logging
                     break;
 
                 // path too long exception
-                case PathTooLongException:
+                case PathTooLongException _:
                     {
                         string[] affectedPaths = PathUtilities.GetTooLongPaths(Constants.ModsPath).ToArray();
                         string message = affectedPaths.Any()

From ec7af3e2eede702425a50458aa0536e5da849247 Mon Sep 17 00:00:00 2001
From: bladeoflight16 <1159076+bladeoflight16@users.noreply.github.com>
Date: Mon, 26 Jul 2021 21:31:28 -0400
Subject: [PATCH 209/856] world_clear: Lining up parameter descriptions

---
 .../Framework/Commands/World/ClearCommand.cs                    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index 4cfaf242..2f34d381 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -30,8 +30,8 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                 name: "world_clear",
                 description: "Clears in-game entities in a given location.\n\n"
                     + "Usage: world_clear <location> <object type>\n"
-                    + "- location: the location name for which to clear objects (like Farm), or 'current' for the current location.\n"
                     + " - object type: the type of object clear. You can specify 'crops', 'debris' (stones/twigs/weeds and dead crops), 'furniture', 'grass', and 'trees' / 'fruit-trees'. You can also specify 'everything', which includes things not removed by the other types (like resource clumps)."
+                    + " - location: the location name for which to clear objects (like Farm), or 'current' for the current location.\n"
             )
         { }
 

From 428f0c5880fa8b133f601beda2e27c87dc7134af Mon Sep 17 00:00:00 2001
From: bladeoflight16 <1159076+bladeoflight16@users.noreply.github.com>
Date: Mon, 26 Jul 2021 21:32:29 -0400
Subject: [PATCH 210/856] world_clear: Adding 'removeable' option that includes
 everything except permanent bushes

---
 docs/release-notes.md                            |  1 +
 .../Framework/Commands/World/ClearCommand.cs     | 16 ++++++++++++++--
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 26188ff3..3072a0d6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,7 @@
 * For players:
   * Added error if the wrong SMAPI bitness is installed (e.g. 32-bit SMAPI with 64-bit game).
   * Added error if some SMAPI files aren't updated correctly.
+  * Added `removeable` option to `world_clear`
   * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
 
 * For mod authors:
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index 2f34d381..d7cd40ec 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -15,7 +15,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         ** Fields
         *********/
         /// <summary>The valid types that can be cleared.</summary>
-        private readonly string[] ValidTypes = { "crops", "debris", "fruit-trees", "furniture", "grass", "trees", "everything" };
+        private readonly string[] ValidTypes = { "crops", "debris", "fruit-trees", "furniture", "grass", "trees", "removeable", "everything" };
 
         /// <summary>The resource clump IDs to consider debris.</summary>
         private readonly int[] DebrisClumps = { ResourceClump.stumpIndex, ResourceClump.hollowLogIndex, ResourceClump.meteoriteIndex, ResourceClump.boulderIndex };
@@ -30,8 +30,8 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                 name: "world_clear",
                 description: "Clears in-game entities in a given location.\n\n"
                     + "Usage: world_clear <location> <object type>\n"
-                    + " - object type: the type of object clear. You can specify 'crops', 'debris' (stones/twigs/weeds and dead crops), 'furniture', 'grass', and 'trees' / 'fruit-trees'. You can also specify 'everything', which includes things not removed by the other types (like resource clumps)."
                     + " - location: the location name for which to clear objects (like Farm), or 'current' for the current location.\n"
+                    + " - object type: the type of object clear. You can specify 'crops', 'debris' (stones/twigs/weeds and dead crops), 'furniture', 'grass', and 'trees' / 'fruit-trees'. You can also specify 'removeable', which includes everything that can be removed or destroyed during normal game play, or 'everything', which includes permanent bushes."
             )
         { }
 
@@ -133,6 +133,18 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                         break;
                     }
 
+                case "removeable":
+                    {
+                        int removed =
+                            this.RemoveFurniture(location, p => true)
+                            + this.RemoveObjects(location, p => true)
+                            + this.RemoveTerrainFeatures(location, p => true)
+                            + this.RemoveLargeTerrainFeatures(location, p => !(p is Bush) || ((Bush)p).isDestroyable(location, p.currentTileLocation))
+                            + this.RemoveResourceClumps(location, p => true);
+                        monitor.Log($"Done! Removed {removed} entities from {location.Name}.", LogLevel.Info);
+                        break;
+                    }
+
                 case "everything":
                     {
                         int removed =

From e3010f7c41028c3420df06e025f9af594b866c2b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 28 Jul 2021 00:36:34 -0400
Subject: [PATCH 211/856] refactor new code a bit

---
 docs/release-notes.md                         |  2 +-
 .../Framework/Commands/World/ClearCommand.cs  | 20 +++++--------------
 src/SMAPI.sln.DotSettings                     |  1 +
 3 files changed, 7 insertions(+), 16 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3072a0d6..fab3f25c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,7 +5,7 @@
 * For players:
   * Added error if the wrong SMAPI bitness is installed (e.g. 32-bit SMAPI with 64-bit game).
   * Added error if some SMAPI files aren't updated correctly.
-  * Added `removeable` option to `world_clear`
+  * Added `removable` option to the `world_clear` console command (thanks to bladeoflight16!).
   * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
 
 * For mod authors:
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index d7cd40ec..44adc4c9 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -15,7 +15,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         ** Fields
         *********/
         /// <summary>The valid types that can be cleared.</summary>
-        private readonly string[] ValidTypes = { "crops", "debris", "fruit-trees", "furniture", "grass", "trees", "removeable", "everything" };
+        private readonly string[] ValidTypes = { "crops", "debris", "fruit-trees", "furniture", "grass", "trees", "removable", "everything" };
 
         /// <summary>The resource clump IDs to consider debris.</summary>
         private readonly int[] DebrisClumps = { ResourceClump.stumpIndex, ResourceClump.hollowLogIndex, ResourceClump.meteoriteIndex, ResourceClump.boulderIndex };
@@ -31,7 +31,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                 description: "Clears in-game entities in a given location.\n\n"
                     + "Usage: world_clear <location> <object type>\n"
                     + " - location: the location name for which to clear objects (like Farm), or 'current' for the current location.\n"
-                    + " - object type: the type of object clear. You can specify 'crops', 'debris' (stones/twigs/weeds and dead crops), 'furniture', 'grass', and 'trees' / 'fruit-trees'. You can also specify 'removeable', which includes everything that can be removed or destroyed during normal game play, or 'everything', which includes permanent bushes."
+                    + " - object type: the type of object clear. You can specify 'crops', 'debris' (stones/twigs/weeds and dead crops), 'furniture', 'grass', and 'trees' / 'fruit-trees'. You can also specify 'removable' (remove everything that can be removed or destroyed during normal gameplay) or 'everything' (remove everything including permanent bushes)."
             )
         { }
 
@@ -133,25 +133,15 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                         break;
                     }
 
-                case "removeable":
-                    {
-                        int removed =
-                            this.RemoveFurniture(location, p => true)
-                            + this.RemoveObjects(location, p => true)
-                            + this.RemoveTerrainFeatures(location, p => true)
-                            + this.RemoveLargeTerrainFeatures(location, p => !(p is Bush) || ((Bush)p).isDestroyable(location, p.currentTileLocation))
-                            + this.RemoveResourceClumps(location, p => true);
-                        monitor.Log($"Done! Removed {removed} entities from {location.Name}.", LogLevel.Info);
-                        break;
-                    }
-
+                case "removable":
                 case "everything":
                     {
+                        bool everything = type == "everything";
                         int removed =
                             this.RemoveFurniture(location, p => true)
                             + this.RemoveObjects(location, p => true)
                             + this.RemoveTerrainFeatures(location, p => true)
-                            + this.RemoveLargeTerrainFeatures(location, p => true)
+                            + this.RemoveLargeTerrainFeatures(location, p => everything || p is not Bush bush || bush.isDestroyable(location, p.currentTileLocation))
                             + this.RemoveResourceClumps(location, p => true);
                         monitor.Log($"Done! Removed {removed} entities from {location.Name}.", LogLevel.Info);
                         break;
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index 29d4ade5..305b1c7d 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -36,6 +36,7 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=fallbacks/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=filenames/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gamepad/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=gameplay/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hangfire/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=initializers/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Junimo/@EntryIndexedValue">True</s:Boolean>

From 6a6c484b9867524d2eaa617da4dde36fec8c3110 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 28 Jul 2021 00:49:54 -0400
Subject: [PATCH 212/856] add accessed key to dictionary KeyNotFoundException
 message

---
 docs/release-notes.md                         |  1 +
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  1 +
 .../Patches/DictionaryPatches.cs              | 81 +++++++++++++++++++
 .../SMAPI.Mods.ErrorHandler.csproj            |  1 +
 4 files changed, 84 insertions(+)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatches.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index fab3f25c..782d64bb 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 
 * For mod authors:
   * Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
+  * SMAPI now intercepts `KeyNotFoundException` dictionary errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
   * Fixed error loading `.xnb` files from the local mod folder since SMAPI 3.0.
 
 ## 3.11.0
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index d9426d75..719eddab 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -31,6 +31,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
             // apply patches
             new GamePatcher(this.Monitor).Apply(
                 new DialogueErrorPatch(monitorForGame, this.Helper.Reflection),
+                new DictionaryPatches(this.Helper.Reflection),
                 new EventPatches(monitorForGame),
                 new GameLocationPatches(monitorForGame),
                 new ObjectErrorPatch(),
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatches.cs
new file mode 100644
index 00000000..ce88999d
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatches.cs
@@ -0,0 +1,81 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using HarmonyLib;
+using StardewModdingAPI.Framework.Patching;
+using StardewValley.GameData;
+using StardewValley.GameData.HomeRenovations;
+using StardewValley.GameData.Movies;
+
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
+{
+    /// <summary>A Harmony patch for <see cref="Dictionary{TKey,TValue}"/> which adds the accessed key to <see cref="KeyNotFoundException"/> exceptions.</summary>
+    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    internal class DictionaryPatches : IHarmonyPatch
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Simplifies access to private code.</summary>
+        private static IReflectionHelper Reflection;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="reflector">Simplifies access to private code.</param>
+        public DictionaryPatches(IReflectionHelper reflector)
+        {
+            DictionaryPatches.Reflection = reflector;
+        }
+
+        /// <inheritdoc />
+        public void Apply(Harmony harmony)
+        {
+            Type[] keyTypes = { typeof(int), typeof(string) };
+            Type[] valueTypes = { typeof(int), typeof(string), typeof(HomeRenovation), typeof(MovieData), typeof(SpecialOrderData) };
+
+            foreach (Type keyType in keyTypes)
+            {
+                foreach (Type valueType in valueTypes)
+                {
+                    Type dictionaryType = typeof(Dictionary<,>).MakeGenericType(keyType, valueType);
+
+                    harmony.Patch(
+                        original: AccessTools.Method(dictionaryType, "get_Item"),
+                        finalizer: new HarmonyMethod(this.GetType(), nameof(DictionaryPatches.Finalize_GetItem))
+                    );
+                }
+            }
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>The method to call after the dictionary indexer throws an exception.</summary>
+        /// <param name="key">The dictionary key being fetched.</param>
+        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
+        /// <returns>Returns the exception to throw, if any.</returns>
+        private static Exception Finalize_GetItem(object key, Exception __exception)
+        {
+            if (__exception is KeyNotFoundException)
+                AddKeyTo(__exception, key?.ToString());
+
+            return __exception;
+        }
+
+        /// <summary>Add the accessed key to an exception message.</summary>
+        /// <param name="exception">The exception to modify.</param>
+        /// <param name="key">The dictionary key.</param>
+        private static void AddKeyTo(Exception exception, string key)
+        {
+            DictionaryPatches.Reflection
+                .GetField<string>(exception, "_message")
+                .SetValue($"{exception.Message}\nkey: '{key}'");
+        }
+    }
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 006a09ca..531d3699 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -15,6 +15,7 @@
 
   <ItemGroup>
     <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+    <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
 

From b4f307e1ba88df072efed3b94975fa45789ae1ef Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 28 Jul 2021 00:51:45 -0400
Subject: [PATCH 213/856] fix rewritten Harmony 1.x code not raising 'detected
 game patch' flag (#711)

---
 .../Rewriters/Harmony1AssemblyRewriter.cs         | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
index 3197c151..7a3b428d 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
@@ -32,7 +32,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
             {
                 Type targetType = this.GetMappedType(type);
                 replaceWith(module.ImportReference(targetType));
-                this.MarkRewritten();
+                this.OnChanged();
                 this.ReplacedTypes = true;
                 return true;
             }
@@ -46,14 +46,20 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
             // rewrite Harmony 1.x methods to Harmony 2.0
             MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
             if (this.TryRewriteMethodsToFacade(module, methodRef))
+            {
+                this.OnChanged();
                 return true;
+            }
 
             // rewrite renamed fields
             FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
             if (fieldRef != null)
             {
                 if (fieldRef.DeclaringType.FullName == "HarmonyLib.HarmonyMethod" && fieldRef.Name == "prioritiy")
+                {
                     fieldRef.Name = nameof(HarmonyMethod.priority);
+                    this.OnChanged();
+                }
             }
 
             return false;
@@ -63,6 +69,13 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /*********
         ** Private methods
         *********/
+        /// <summary>Update the mod metadata when any Harmony 1.x code is migrated.</summary>
+        private void OnChanged()
+        {
+            this.MarkRewritten();
+            this.MarkFlag(InstructionHandleResult.DetectedGamePatch);
+        }
+
         /// <summary>Rewrite methods to use Harmony facades if needed.</summary>
         /// <param name="module">The assembly module containing the method reference.</param>
         /// <param name="methodRef">The method reference to map.</param>

From e8ad5d0a2404720ec4f8cc75117e62bcc72cd068 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 28 Jul 2021 18:03:49 -0400
Subject: [PATCH 214/856] fix Data\Movies error regression when patching
 dictionary (#711)

---
 .../TemporaryHacks/MiniMonoModHotfix.cs       | 101 ++++++++++++++----
 1 file changed, 82 insertions(+), 19 deletions(-)

diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
index 9f5819d7..9d63ab2c 100644
--- a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -8,12 +8,12 @@
 // Special thanks to 0x0ade for submitting this worokaround! Copy/pasted and adapted from MonoMod.
 
 using System;
+using System.Reflection;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
-using System.Reflection;
-using System.Reflection.Emit;
 using System.Runtime.CompilerServices;
 using HarmonyLib;
+using System.Reflection.Emit;
 
 // ReSharper disable once CheckNamespace -- Temporary hotfix submitted by the MonoMod author.
 namespace MonoMod.Utils
@@ -24,38 +24,38 @@ namespace MonoMod.Utils
     {
         // .NET Framework can break member ordering if using Module.Resolve* on certain members.
 
-        private static readonly object[] _NoArgs = new object[0];
-        private static readonly object[] _CacheGetterArgs = { /* MemberListType.All */ 0, /* name apparently always null? */ null };
+        private static object[] _NoArgs = new object[0];
+        private static object[] _CacheGetterArgs = { /* MemberListType.All */ 0, /* name apparently always null? */ null };
 
-        private static readonly Type t_RuntimeModule =
+        private static Type t_RuntimeModule =
             typeof(Module).Assembly
             .GetType("System.Reflection.RuntimeModule");
 
-        private static readonly PropertyInfo p_RuntimeModule_RuntimeType =
+        private static PropertyInfo p_RuntimeModule_RuntimeType =
             typeof(Module).Assembly
             .GetType("System.Reflection.RuntimeModule")
             ?.GetProperty("RuntimeType", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
 
-        private static readonly Type t_RuntimeType =
+        private static Type t_RuntimeType =
             typeof(Type).Assembly
             .GetType("System.RuntimeType");
 
-        private static readonly PropertyInfo p_RuntimeType_Cache =
+        private static PropertyInfo p_RuntimeType_Cache =
             typeof(Type).Assembly
             .GetType("System.RuntimeType")
             ?.GetProperty("Cache", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
 
-        private static readonly MethodInfo m_RuntimeTypeCache_GetFieldList =
+        private static MethodInfo m_RuntimeTypeCache_GetFieldList =
             typeof(Type).Assembly
             .GetType("System.RuntimeType+RuntimeTypeCache")
             ?.GetMethod("GetFieldList", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
 
-        private static readonly MethodInfo m_RuntimeTypeCache_GetPropertyList =
+        private static MethodInfo m_RuntimeTypeCache_GetPropertyList =
             typeof(Type).Assembly
             .GetType("System.RuntimeType+RuntimeTypeCache")
             ?.GetMethod("GetPropertyList", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
 
-        private static readonly ConditionalWeakTable<Type, object> _CacheFixed = new ConditionalWeakTable<Type, object>();
+        private static readonly ConditionalWeakTable<Type, CacheFixEntry> _CacheFixed = new ConditionalWeakTable<Type, CacheFixEntry>();
 
         public static void Apply()
         {
@@ -143,24 +143,80 @@ namespace MonoMod.Utils
                 if (!t_RuntimeType.IsInstanceOfType(type))
                     continue;
 
-                _CacheFixed.GetValue(type, rt =>
-                {
+                CacheFixEntry entry = _CacheFixed.GetValue(type, rt => {
+                    CacheFixEntry entryNew = new CacheFixEntry();
+                    object cache;
+                    Array properties, fields;
 
-                    object cache = p_RuntimeType_Cache.GetValue(rt, _NoArgs);
-                    _FixReflectionCacheOrder<PropertyInfo>(cache, m_RuntimeTypeCache_GetPropertyList);
-                    _FixReflectionCacheOrder<FieldInfo>(cache, m_RuntimeTypeCache_GetFieldList);
+                    // All RuntimeTypes MUST have a cache, the getter is non-virtual, it creates on demand and asserts non-null.
+                    entryNew.Cache = cache = p_RuntimeType_Cache.GetValue(rt, _NoArgs);
+                    entryNew.Properties = properties = _GetArray(cache, m_RuntimeTypeCache_GetPropertyList);
+                    entryNew.Fields = fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList);
 
-                    return new object();
+                    _FixReflectionCacheOrder<PropertyInfo>(properties);
+                    _FixReflectionCacheOrder<FieldInfo>(fields);
+
+                    entryNew.NeedsVerify = false;
+                    return entryNew;
                 });
+
+                if (entry.NeedsVerify && !_Verify(entry, type))
+                {
+                    lock (entry)
+                    {
+                        _FixReflectionCacheOrder<PropertyInfo>(entry.Properties);
+                        _FixReflectionCacheOrder<FieldInfo>(entry.Fields);
+                    }
+                }
+
+                entry.NeedsVerify = true;
             }
         }
 
-        private static void _FixReflectionCacheOrder<T>(object cache, MethodInfo getter) where T : MemberInfo
+        private static bool _Verify(CacheFixEntry entry, Type type)
+        {
+            object cache;
+            Array properties, fields;
+
+            // The cache can sometimes be invalidated.
+            // TODO: Figure out if only the arrays get replaced or if the entire cache object gets replaced!
+            if (entry.Cache != (cache = p_RuntimeType_Cache.GetValue(type, _NoArgs)))
+            {
+                entry.Cache = cache;
+                entry.Properties = _GetArray(cache, m_RuntimeTypeCache_GetPropertyList);
+                entry.Fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList);
+                return false;
+
+            }
+            else if (entry.Properties != (properties = _GetArray(cache, m_RuntimeTypeCache_GetPropertyList)))
+            {
+                entry.Properties = properties;
+                entry.Fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList);
+                return false;
+
+            }
+            else if (entry.Fields != (fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList)))
+            {
+                entry.Fields = fields;
+                return false;
+
+            }
+            else
+            {
+                // Cache should still be the same, no re-fix necessary.
+                return true;
+            }
+        }
+
+        private static Array _GetArray(object cache, MethodInfo getter)
         {
             // Get and discard once, otherwise we might not be getting the actual backing array.
             getter.Invoke(cache, _CacheGetterArgs);
-            Array orig = (Array)getter.Invoke(cache, _CacheGetterArgs);
+            return (Array)getter.Invoke(cache, _CacheGetterArgs);
+        }
 
+        private static void _FixReflectionCacheOrder<T>(Array orig) where T : MemberInfo
+        {
             // Sort using a short-lived list.
             List<T> list = new List<T>(orig.Length);
             for (int i = 0; i < orig.Length; i++)
@@ -172,5 +228,12 @@ namespace MonoMod.Utils
                 orig.SetValue(list[i], i);
         }
 
+        private class CacheFixEntry
+        {
+            public object Cache;
+            public Array Properties;
+            public Array Fields;
+            public bool NeedsVerify;
+        }
     }
 }

From 880cd7b8bacfcee2cc6a8e15b6b8ea5e05e9467c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 28 Jul 2021 21:20:44 -0400
Subject: [PATCH 215/856] fix handling of Unicode characters in console

---
 docs/release-notes.md                     | 1 +
 src/SMAPI/Framework/Logging/LogManager.cs | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 782d64bb..0f144bf5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@
   * Added error if the wrong SMAPI bitness is installed (e.g. 32-bit SMAPI with 64-bit game).
   * Added error if some SMAPI files aren't updated correctly.
   * Added `removable` option to the `world_clear` console command (thanks to bladeoflight16!).
+  * Fixed handling of Unicode characters in console commands.
   * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
 
 * For mod authors:
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 2cd512e0..e16b5c0d 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
+using System.Text;
 using System.Text.RegularExpressions;
 using System.Threading;
 using StardewModdingAPI.Framework.Commands;
@@ -106,6 +107,10 @@ namespace StardewModdingAPI.Framework.Logging
             if (writeToConsole)
                 output.OnMessageIntercepted += message => this.HandleConsoleMessage(this.MonitorForGame, message);
             Console.SetOut(output);
+
+            // enable Unicode handling
+            Console.InputEncoding = Encoding.Unicode;
+            Console.OutputEncoding = Encoding.Unicode;
         }
 
         /// <summary>Get a monitor instance derived from SMAPI's current settings.</summary>

From 737a434ad6704d22776f463c192b9a9748ce2a21 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 29 Jul 2021 22:50:50 -0400
Subject: [PATCH 216/856] reduce ErrorHandler's direct references to internal
 SMAPI code

That will allow removing the InternalsVisibleTo attribute to avoid namespace conflicts in an upcoming commit.
---
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs          | 16 +++++++++++-----
 .../Patches/LoadErrorPatch.cs                    |  3 ++-
 src/SMAPI/Framework/SCore.cs                     |  9 +++++++++
 3 files changed, 22 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index 719eddab..b1081218 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Reflection;
 using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework;
@@ -71,12 +72,17 @@ namespace StardewModdingAPI.Mods.ErrorHandler
         /// <summary>Get the monitor with which to log game errors.</summary>
         private IMonitor GetMonitorForGame()
         {
-            SCore core = SCore.Instance;
-            LogManager logManager = core.GetType().GetField("LogManager", BindingFlags.Instance | BindingFlags.NonPublic)?.GetValue(core) as LogManager;
-            if (logManager == null)
-                this.Monitor.Log("Can't access SMAPI's internal log manager. Some game errors may be reported as being from Error Handler.", LogLevel.Error);
+            // get SMAPI core
+            Type coreType = Type.GetType("StardewModdingAPI.Framework.SCore, StardewModdingAPI", throwOnError: false)
+                ?? throw new InvalidOperationException("Can't access SMAPI's core type. This mod may not work correctly.");
+            object core = coreType.GetProperty("Instance", BindingFlags.Static | BindingFlags.NonPublic)?.GetValue(null)
+                ?? throw new InvalidOperationException("Can't access SMAPI's core instance. This mod may not work correctly.");
 
-            return logManager?.MonitorForGame ?? this.Monitor;
+            // get monitor
+            MethodInfo getMonitorForGame = coreType.GetMethod("GetMonitorForGame")
+                ?? throw new InvalidOperationException("Can't access the SMAPI's 'GetMonitorForGame' method. This mod may not work correctly.");
+
+            return (IMonitor)getMonitorForGame.Invoke(core, new object[0]) ?? this.Monitor;
         }
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
index e14dc662..cc0e5e52 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using HarmonyLib;
+using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
@@ -82,7 +83,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                     {
                         BluePrint _ = new BluePrint(building.buildingType.Value);
                     }
-                    catch (SContentLoadException)
+                    catch (ContentLoadException)
                     {
                         LoadErrorPatch.Monitor.Log($"Removed invalid building type '{building.buildingType.Value}' in {location.Name} ({building.tileX}, {building.tileY}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom building mod?)", LogLevel.Warn);
                         location.buildings.Remove(building);
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 4211abc5..b607f95d 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -2,6 +2,7 @@ using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using System.Net;
@@ -310,6 +311,14 @@ namespace StardewModdingAPI.Framework
             }
         }
 
+        /// <summary>Get the core logger and monitor on behalf of the game.</summary>
+        /// <remarks>This method is called using reflection by the ErrorHandler mod to log game errors.</remarks>
+        [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Used via reflection")]
+        public IMonitor GetMonitorForGame()
+        {
+            return this.LogManager.MonitorForGame;
+        }
+
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         public void Dispose()
         {

From aa65b2e2f6ae2578f9d1f81d6fc1f4c5a261d90f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 30 Jul 2021 00:34:53 -0400
Subject: [PATCH 217/856] split patch classes which target multiple types

---
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  3 +-
 .../Patches/DialogueErrorPatch.cs             | 21 -------
 .../Patches/IClickableMenuPatcher.cs          | 44 +++++++++++++++
 .../Patches/ObjectErrorPatch.cs               | 19 -------
 .../Patches/ScheduleErrorPatch.cs             | 21 +++++++
 src/SMAPI/Framework/SCore.cs                  |  3 +-
 src/SMAPI/Patches/LoadContextPatch.cs         | 15 -----
 src/SMAPI/Patches/TitleMenuPatcher.cs         | 56 +++++++++++++++++++
 8 files changed, 124 insertions(+), 58 deletions(-)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
 create mode 100644 src/SMAPI/Patches/TitleMenuPatcher.cs

diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index b1081218..f6f9a150 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -1,8 +1,6 @@
 using System;
 using System.Reflection;
 using StardewModdingAPI.Events;
-using StardewModdingAPI.Framework;
-using StardewModdingAPI.Framework.Logging;
 using StardewModdingAPI.Framework.Patching;
 using StardewModdingAPI.Mods.ErrorHandler.Patches;
 using StardewValley;
@@ -35,6 +33,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
                 new DictionaryPatches(this.Helper.Reflection),
                 new EventPatches(monitorForGame),
                 new GameLocationPatches(monitorForGame),
+                new IClickablePatcher(),
                 new ObjectErrorPatch(),
                 new LoadErrorPatch(this.Monitor, this.OnSaveContentRemoved),
                 new ScheduleErrorPatch(monitorForGame),
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
index a065e3d7..ca5bb0bf 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
 using StardewModdingAPI.Framework;
@@ -43,10 +42,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 original: AccessTools.Constructor(typeof(Dialogue), new[] { typeof(string), typeof(NPC) }),
                 finalizer: new HarmonyMethod(this.GetType(), nameof(DialogueErrorPatch.Finalize_Dialogue_Constructor))
             );
-            harmony.Patch(
-                original: AccessTools.Property(typeof(NPC), nameof(NPC.CurrentDialogue)).GetMethod,
-                finalizer: new HarmonyMethod(this.GetType(), nameof(DialogueErrorPatch.Finalize_NPC_CurrentDialogue))
-            );
         }
 
 
@@ -76,21 +71,5 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 
             return null;
         }
-
-        /// <summary>The method to call after <see cref="NPC.CurrentDialogue"/>.</summary>
-        /// <param name="__instance">The instance being patched.</param>
-        /// <param name="__result">The return value of the original method.</param>
-        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
-        /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_NPC_CurrentDialogue(NPC __instance, ref Stack<Dialogue> __result, Exception __exception)
-        {
-            if (__exception == null)
-                return null;
-
-            DialogueErrorPatch.MonitorForGame.Log($"Failed loading current dialogue for NPC {__instance.Name}:\n{__exception.GetLogSummary()}", LogLevel.Error);
-            __result = new Stack<Dialogue>();
-
-            return null;
-        }
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
new file mode 100644
index 00000000..a5a90db2
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
@@ -0,0 +1,44 @@
+using System.Diagnostics.CodeAnalysis;
+using HarmonyLib;
+using StardewModdingAPI.Framework.Patching;
+using StardewValley;
+using StardewValley.Menus;
+using SObject = StardewValley.Object;
+
+namespace StardewModdingAPI.Mods.ErrorHandler.Patches
+{
+    /// <summary>A Harmony patch for <see cref="IClickableMenu"/> which intercepts crashes due to invalid items.</summary>
+    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    internal class IClickablePatcher : IHarmonyPatch
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <inheritdoc />
+        public void Apply(Harmony harmony)
+        {
+            harmony.Patch(
+                original: AccessTools.Method(typeof(IClickableMenu), nameof(IClickableMenu.drawToolTip)),
+                prefix: new HarmonyMethod(this.GetType(), nameof(IClickablePatcher.Before_IClickableMenu_DrawTooltip))
+            );
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>The method to call instead of <see cref="IClickableMenu.drawToolTip"/>.</summary>
+        /// <param name="hoveredItem">The item for which to draw a tooltip.</param>
+        /// <returns>Returns whether to execute the original method.</returns>
+        private static bool Before_IClickableMenu_DrawTooltip(Item hoveredItem)
+        {
+            // invalid edible item cause crash when drawing tooltips
+            if (hoveredItem is SObject obj && obj.Edibility != -300 && !Game1.objectInformation.ContainsKey(obj.ParentSheetIndex))
+                return false;
+
+            return true;
+        }
+    }
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
index a68e359c..7a4b3cfa 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
@@ -4,7 +4,6 @@ using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
-using StardewValley.Menus;
 using SObject = StardewValley.Object;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
@@ -32,12 +31,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 original: AccessTools.Method(typeof(SObject), "loadDisplayName"),
                 finalizer: new HarmonyMethod(this.GetType(), nameof(ObjectErrorPatch.Finalize_Object_loadDisplayName))
             );
-
-            // IClickableMenu.drawToolTip
-            harmony.Patch(
-                original: AccessTools.Method(typeof(IClickableMenu), nameof(IClickableMenu.drawToolTip)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(ObjectErrorPatch.Before_IClickableMenu_DrawTooltip))
-            );
         }
 
 
@@ -74,17 +67,5 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 
             return __exception;
         }
-
-        /// <summary>The method to call instead of <see cref="IClickableMenu.drawToolTip"/>.</summary>
-        /// <param name="hoveredItem">The item for which to draw a tooltip.</param>
-        /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_IClickableMenu_DrawTooltip(Item hoveredItem)
-        {
-            // invalid edible item cause crash when drawing tooltips
-            if (hoveredItem is SObject obj && obj.Edibility != -300 && !Game1.objectInformation.ContainsKey(obj.ParentSheetIndex))
-                return false;
-
-            return true;
-        }
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
index d2e332b4..b8ab9361 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
@@ -34,6 +34,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <inheritdoc />
         public void Apply(Harmony harmony)
         {
+            harmony.Patch(
+                original: AccessTools.Property(typeof(NPC), nameof(NPC.CurrentDialogue)).GetMethod,
+                finalizer: new HarmonyMethod(this.GetType(), nameof(ScheduleErrorPatch.Finalize_NPC_CurrentDialogue))
+            );
+
             harmony.Patch(
                 original: AccessTools.Method(typeof(NPC), nameof(NPC.parseMasterSchedule)),
                 finalizer: new HarmonyMethod(this.GetType(), nameof(ScheduleErrorPatch.Finalize_NPC_parseMasterSchedule))
@@ -44,6 +49,22 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
+        /// <summary>The method to call after <see cref="NPC.CurrentDialogue"/>.</summary>
+        /// <param name="__instance">The instance being patched.</param>
+        /// <param name="__result">The return value of the original method.</param>
+        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
+        /// <returns>Returns the exception to throw, if any.</returns>
+        private static Exception Finalize_NPC_CurrentDialogue(NPC __instance, ref Stack<Dialogue> __result, Exception __exception)
+        {
+            if (__exception == null)
+                return null;
+
+            ScheduleErrorPatch.MonitorForGame.Log($"Failed loading current dialogue for NPC {__instance.Name}:\n{__exception.GetLogSummary()}", LogLevel.Error);
+            __result = new Stack<Dialogue>();
+
+            return null;
+        }
+
         /// <summary>The method to call instead of <see cref="NPC.parseMasterSchedule"/>.</summary>
         /// <param name="rawData">The raw schedule data to parse.</param>
         /// <param name="__instance">The instance being patched.</param>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index b607f95d..419afd4b 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -255,7 +255,8 @@ namespace StardewModdingAPI.Framework
                 // apply game patches
                 MiniMonoModHotfix.Apply();
                 new GamePatcher(this.Monitor).Apply(
-                    new LoadContextPatch(this.Reflection, this.OnLoadStageChanged)
+                    new LoadContextPatch(this.Reflection, this.OnLoadStageChanged),
+                    new TitleMenuPatcher(this.OnLoadStageChanged)
                 );
 
                 // add exit handler
diff --git a/src/SMAPI/Patches/LoadContextPatch.cs b/src/SMAPI/Patches/LoadContextPatch.cs
index 721cf53d..c7f7d986 100644
--- a/src/SMAPI/Patches/LoadContextPatch.cs
+++ b/src/SMAPI/Patches/LoadContextPatch.cs
@@ -44,12 +44,6 @@ namespace StardewModdingAPI.Patches
         /// <inheritdoc />
         public void Apply(Harmony harmony)
         {
-            // detect CreatedBasicInfo
-            harmony.Patch(
-                original: AccessTools.Method(typeof(TitleMenu), nameof(TitleMenu.createdNewCharacter)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_TitleMenu_CreatedNewCharacter))
-            );
-
             // detect CreatedInitialLocations and SaveAddedLocations
             harmony.Patch(
                 original: AccessTools.Method(typeof(Game1), nameof(Game1.AddModNPCs)),
@@ -74,15 +68,6 @@ namespace StardewModdingAPI.Patches
         /*********
         ** Private methods
         *********/
-        /// <summary>Called before <see cref="TitleMenu.createdNewCharacter"/>.</summary>
-        /// <returns>Returns whether to execute the original method.</returns>
-        /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
-        private static bool Before_TitleMenu_CreatedNewCharacter()
-        {
-            LoadContextPatch.OnStageChanged(LoadStage.CreatedBasicInfo);
-            return true;
-        }
-
         /// <summary>Called before <see cref="Game1.AddModNPCs"/>.</summary>
         /// <returns>Returns whether to execute the original method.</returns>
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
diff --git a/src/SMAPI/Patches/TitleMenuPatcher.cs b/src/SMAPI/Patches/TitleMenuPatcher.cs
new file mode 100644
index 00000000..a889adfc
--- /dev/null
+++ b/src/SMAPI/Patches/TitleMenuPatcher.cs
@@ -0,0 +1,56 @@
+using System;
+using System.Diagnostics.CodeAnalysis;
+using HarmonyLib;
+using StardewModdingAPI.Enums;
+using StardewModdingAPI.Framework.Patching;
+using StardewValley.Menus;
+
+namespace StardewModdingAPI.Patches
+{
+    /// <summary>Harmony patches which notify SMAPI for save creation load stages.</summary>
+    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    internal class TitleMenuPatcher : IHarmonyPatch
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>A callback to invoke when the load stage changes.</summary>
+        private static Action<LoadStage> OnStageChanged;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="onStageChanged">A callback to invoke when the load stage changes.</param>
+        public TitleMenuPatcher(Action<LoadStage> onStageChanged)
+        {
+            TitleMenuPatcher.OnStageChanged = onStageChanged;
+        }
+
+        /// <inheritdoc />
+        public void Apply(Harmony harmony)
+        {
+            // detect CreatedBasicInfo
+            harmony.Patch(
+                original: AccessTools.Method(typeof(TitleMenu), nameof(TitleMenu.createdNewCharacter)),
+                prefix: new HarmonyMethod(this.GetType(), nameof(TitleMenuPatcher.Before_TitleMenu_CreatedNewCharacter))
+            );
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Called before <see cref="TitleMenu.createdNewCharacter"/>.</summary>
+        /// <returns>Returns whether to execute the original method.</returns>
+        /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
+        private static bool Before_TitleMenu_CreatedNewCharacter()
+        {
+            TitleMenuPatcher.OnStageChanged(LoadStage.CreatedBasicInfo);
+            return true;
+        }
+    }
+}

From 4074f697d73f5cac6699836550b144fd0c4e2803 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 30 Jul 2021 00:40:12 -0400
Subject: [PATCH 218/856] rename patch classes for consistency

---
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       | 20 ++++++------
 ...alogueErrorPatch.cs => DialoguePatcher.cs} | 16 +++++-----
 ...tionaryPatches.cs => DictionaryPatcher.cs} | 10 +++---
 .../{EventPatches.cs => EventPatcher.cs}      | 10 +++---
 ...ationPatches.cs => GameLocationPatcher.cs} | 14 ++++----
 .../Patches/IClickableMenuPatcher.cs          |  4 +--
 .../{ScheduleErrorPatch.cs => NpcPatcher.cs}  | 14 ++++----
 .../{ObjectErrorPatch.cs => ObjectPatcher.cs} |  6 ++--
 .../{LoadErrorPatch.cs => SaveGamePatcher.cs} | 23 +++++++------
 ...dationPatches.cs => SpriteBatchPatcher.cs} |  4 +--
 ...ilityErrorPatches.cs => UtilityPatcher.cs} |  4 +--
 src/SMAPI/Framework/SCore.cs                  |  2 +-
 .../{LoadContextPatch.cs => Game1Patcher.cs}  | 32 +++++++++----------
 13 files changed, 79 insertions(+), 80 deletions(-)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{DialogueErrorPatch.cs => DialoguePatcher.cs} (80%)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{DictionaryPatches.cs => DictionaryPatcher.cs} (92%)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{EventPatches.cs => EventPatcher.cs} (87%)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{GameLocationPatches.cs => GameLocationPatcher.cs} (88%)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{ScheduleErrorPatch.cs => NpcPatcher.cs} (84%)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{ObjectErrorPatch.cs => ObjectPatcher.cs} (95%)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{LoadErrorPatch.cs => SaveGamePatcher.cs} (81%)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{SpriteBatchValidationPatches.cs => SpriteBatchPatcher.cs} (93%)
 rename src/SMAPI.Mods.ErrorHandler/Patches/{UtilityErrorPatches.cs => UtilityPatcher.cs} (93%)
 rename src/SMAPI/Patches/{LoadContextPatch.cs => Game1Patcher.cs} (82%)

diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index f6f9a150..ac9d1b94 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -29,16 +29,16 @@ namespace StardewModdingAPI.Mods.ErrorHandler
 
             // apply patches
             new GamePatcher(this.Monitor).Apply(
-                new DialogueErrorPatch(monitorForGame, this.Helper.Reflection),
-                new DictionaryPatches(this.Helper.Reflection),
-                new EventPatches(monitorForGame),
-                new GameLocationPatches(monitorForGame),
-                new IClickablePatcher(),
-                new ObjectErrorPatch(),
-                new LoadErrorPatch(this.Monitor, this.OnSaveContentRemoved),
-                new ScheduleErrorPatch(monitorForGame),
-                new SpriteBatchValidationPatches(),
-                new UtilityErrorPatches()
+                new DialoguePatcher(monitorForGame, this.Helper.Reflection),
+                new DictionaryPatcher(this.Helper.Reflection),
+                new EventPatcher(monitorForGame),
+                new GameLocationPatcher(monitorForGame),
+                new IClickableMenuPatcher(),
+                new NpcPatcher(monitorForGame),
+                new ObjectPatcher(),
+                new SaveGamePatcher(this.Monitor, this.OnSaveContentRemoved),
+                new SpriteBatchPatcher(),
+                new UtilityPatcher()
             );
 
             // hook events
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
similarity index 80%
rename from src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
index ca5bb0bf..7b730ee5 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DialogueErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
@@ -11,7 +11,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class DialogueErrorPatch : IHarmonyPatch
+    internal class DialoguePatcher : IHarmonyPatch
     {
         /*********
         ** Fields
@@ -29,10 +29,10 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <summary>Construct an instance.</summary>
         /// <param name="monitorForGame">Writes messages to the console and log file on behalf of the game.</param>
         /// <param name="reflector">Simplifies access to private code.</param>
-        public DialogueErrorPatch(IMonitor monitorForGame, IReflectionHelper reflector)
+        public DialoguePatcher(IMonitor monitorForGame, IReflectionHelper reflector)
         {
-            DialogueErrorPatch.MonitorForGame = monitorForGame;
-            DialogueErrorPatch.Reflection = reflector;
+            DialoguePatcher.MonitorForGame = monitorForGame;
+            DialoguePatcher.Reflection = reflector;
         }
 
         /// <inheritdoc />
@@ -40,7 +40,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             harmony.Patch(
                 original: AccessTools.Constructor(typeof(Dialogue), new[] { typeof(string), typeof(NPC) }),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(DialogueErrorPatch.Finalize_Dialogue_Constructor))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(DialoguePatcher.Finalize_Dialogue_Constructor))
             );
         }
 
@@ -60,11 +60,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             {
                 // log message
                 string name = !string.IsNullOrWhiteSpace(speaker?.Name) ? speaker.Name : null;
-                DialogueErrorPatch.MonitorForGame.Log($"Failed parsing dialogue string{(name != null ? $" for {name}" : "")}:\n{masterDialogue}\n{__exception.GetLogSummary()}", LogLevel.Error);
+                DialoguePatcher.MonitorForGame.Log($"Failed parsing dialogue string{(name != null ? $" for {name}" : "")}:\n{masterDialogue}\n{__exception.GetLogSummary()}", LogLevel.Error);
 
                 // set default dialogue
-                IReflectedMethod parseDialogueString = DialogueErrorPatch.Reflection.GetMethod(__instance, "parseDialogueString");
-                IReflectedMethod checkForSpecialDialogueAttributes = DialogueErrorPatch.Reflection.GetMethod(__instance, "checkForSpecialDialogueAttributes");
+                IReflectedMethod parseDialogueString = DialoguePatcher.Reflection.GetMethod(__instance, "parseDialogueString");
+                IReflectedMethod checkForSpecialDialogueAttributes = DialoguePatcher.Reflection.GetMethod(__instance, "checkForSpecialDialogueAttributes");
                 parseDialogueString.Invoke("...");
                 checkForSpecialDialogueAttributes.Invoke();
             }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
similarity index 92%
rename from src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatches.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
index ce88999d..3c5240b6 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class DictionaryPatches : IHarmonyPatch
+    internal class DictionaryPatcher : IHarmonyPatch
     {
         /*********
         ** Fields
@@ -27,9 +27,9 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="reflector">Simplifies access to private code.</param>
-        public DictionaryPatches(IReflectionHelper reflector)
+        public DictionaryPatcher(IReflectionHelper reflector)
         {
-            DictionaryPatches.Reflection = reflector;
+            DictionaryPatcher.Reflection = reflector;
         }
 
         /// <inheritdoc />
@@ -46,7 +46,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 
                     harmony.Patch(
                         original: AccessTools.Method(dictionaryType, "get_Item"),
-                        finalizer: new HarmonyMethod(this.GetType(), nameof(DictionaryPatches.Finalize_GetItem))
+                        finalizer: new HarmonyMethod(this.GetType(), nameof(DictionaryPatcher.Finalize_GetItem))
                     );
                 }
             }
@@ -73,7 +73,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="key">The dictionary key.</param>
         private static void AddKeyTo(Exception exception, string key)
         {
-            DictionaryPatches.Reflection
+            DictionaryPatcher.Reflection
                 .GetField<string>(exception, "_message")
                 .SetValue($"{exception.Message}\nkey: '{key}'");
         }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
similarity index 87%
rename from src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
index 390aa778..9a7b34d8 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
@@ -10,7 +10,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class EventPatches : IHarmonyPatch
+    internal class EventPatcher : IHarmonyPatch
     {
         /*********
         ** Fields
@@ -24,9 +24,9 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="monitorForGame">Writes messages to the console and log file on behalf of the game.</param>
-        public EventPatches(IMonitor monitorForGame)
+        public EventPatcher(IMonitor monitorForGame)
         {
-            EventPatches.MonitorForGame = monitorForGame;
+            EventPatcher.MonitorForGame = monitorForGame;
         }
 
         /// <inheritdoc />
@@ -34,7 +34,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(Event), nameof(Event.LogErrorAndHalt)),
-                postfix: new HarmonyMethod(this.GetType(), nameof(EventPatches.After_Event_LogErrorAndHalt))
+                postfix: new HarmonyMethod(this.GetType(), nameof(EventPatcher.After_Event_LogErrorAndHalt))
             );
         }
 
@@ -46,7 +46,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="e">The exception being logged.</param>
         private static void After_Event_LogErrorAndHalt(Exception e)
         {
-            EventPatches.MonitorForGame.Log(e.ToString(), LogLevel.Error);
+            EventPatcher.MonitorForGame.Log(e.ToString(), LogLevel.Error);
         }
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
similarity index 88%
rename from src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
index ec809fba..7427fe48 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
@@ -11,7 +11,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class GameLocationPatches : IHarmonyPatch
+    internal class GameLocationPatcher : IHarmonyPatch
     {
         /*********
         ** Fields
@@ -25,9 +25,9 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="monitorForGame">Writes messages to the console and log file on behalf of the game.</param>
-        public GameLocationPatches(IMonitor monitorForGame)
+        public GameLocationPatcher(IMonitor monitorForGame)
         {
-            GameLocationPatches.MonitorForGame = monitorForGame;
+            GameLocationPatcher.MonitorForGame = monitorForGame;
         }
 
         /// <inheritdoc />
@@ -35,11 +35,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.checkEventPrecondition)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Finalize_GameLocation_CheckEventPrecondition))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(GameLocationPatcher.Finalize_GameLocation_CheckEventPrecondition))
             );
             harmony.Patch(
                 original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.updateSeasonalTileSheets)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(GameLocationPatches.Before_GameLocation_UpdateSeasonalTileSheets))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(GameLocationPatcher.Before_GameLocation_UpdateSeasonalTileSheets))
             );
         }
 
@@ -57,7 +57,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             if (__exception != null)
             {
                 __result = -1;
-                GameLocationPatches.MonitorForGame.Log($"Failed parsing event precondition ({precondition}):\n{__exception.InnerException}", LogLevel.Error);
+                GameLocationPatcher.MonitorForGame.Log($"Failed parsing event precondition ({precondition}):\n{__exception.InnerException}", LogLevel.Error);
             }
 
             return null;
@@ -71,7 +71,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static Exception Before_GameLocation_UpdateSeasonalTileSheets(GameLocation __instance, Map map, Exception __exception)
         {
             if (__exception != null)
-                GameLocationPatches.MonitorForGame.Log($"Failed updating seasonal tilesheets for location '{__instance.NameOrUniqueName}': \n{__exception}", LogLevel.Error);
+                GameLocationPatcher.MonitorForGame.Log($"Failed updating seasonal tilesheets for location '{__instance.NameOrUniqueName}': \n{__exception}", LogLevel.Error);
 
             return null;
         }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
index a5a90db2..d6f9fbf4 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
@@ -11,7 +11,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class IClickablePatcher : IHarmonyPatch
+    internal class IClickableMenuPatcher : IHarmonyPatch
     {
         /*********
         ** Public methods
@@ -21,7 +21,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(IClickableMenu), nameof(IClickableMenu.drawToolTip)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(IClickablePatcher.Before_IClickableMenu_DrawTooltip))
+                prefix: new HarmonyMethod(this.GetType(), nameof(IClickableMenuPatcher.Before_IClickableMenu_DrawTooltip))
             );
         }
 
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
similarity index 84%
rename from src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
index b8ab9361..4a07ea1d 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ScheduleErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
@@ -12,7 +12,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class ScheduleErrorPatch : IHarmonyPatch
+    internal class NpcPatcher : IHarmonyPatch
     {
         /*********
         ** Fields
@@ -26,9 +26,9 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="monitorForGame">Writes messages to the console and log file on behalf of the game.</param>
-        public ScheduleErrorPatch(IMonitor monitorForGame)
+        public NpcPatcher(IMonitor monitorForGame)
         {
-            ScheduleErrorPatch.MonitorForGame = monitorForGame;
+            NpcPatcher.MonitorForGame = monitorForGame;
         }
 
         /// <inheritdoc />
@@ -36,12 +36,12 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             harmony.Patch(
                 original: AccessTools.Property(typeof(NPC), nameof(NPC.CurrentDialogue)).GetMethod,
-                finalizer: new HarmonyMethod(this.GetType(), nameof(ScheduleErrorPatch.Finalize_NPC_CurrentDialogue))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(NpcPatcher.Finalize_NPC_CurrentDialogue))
             );
 
             harmony.Patch(
                 original: AccessTools.Method(typeof(NPC), nameof(NPC.parseMasterSchedule)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(ScheduleErrorPatch.Finalize_NPC_parseMasterSchedule))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(NpcPatcher.Finalize_NPC_parseMasterSchedule))
             );
         }
 
@@ -59,7 +59,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             if (__exception == null)
                 return null;
 
-            ScheduleErrorPatch.MonitorForGame.Log($"Failed loading current dialogue for NPC {__instance.Name}:\n{__exception.GetLogSummary()}", LogLevel.Error);
+            NpcPatcher.MonitorForGame.Log($"Failed loading current dialogue for NPC {__instance.Name}:\n{__exception.GetLogSummary()}", LogLevel.Error);
             __result = new Stack<Dialogue>();
 
             return null;
@@ -75,7 +75,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             if (__exception != null)
             {
-                ScheduleErrorPatch.MonitorForGame.Log($"Failed parsing schedule for NPC {__instance.Name}:\n{rawData}\n{__exception.GetLogSummary()}", LogLevel.Error);
+                NpcPatcher.MonitorForGame.Log($"Failed parsing schedule for NPC {__instance.Name}:\n{rawData}\n{__exception.GetLogSummary()}", LogLevel.Error);
                 __result = new Dictionary<int, SchedulePathDescription>();
             }
 
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
similarity index 95%
rename from src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
index 7a4b3cfa..c4b25b96 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
@@ -12,7 +12,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class ObjectErrorPatch : IHarmonyPatch
+    internal class ObjectPatcher : IHarmonyPatch
     {
         /*********
         ** Public methods
@@ -23,13 +23,13 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             // object.getDescription
             harmony.Patch(
                 original: AccessTools.Method(typeof(SObject), nameof(SObject.getDescription)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(ObjectErrorPatch.Before_Object_GetDescription))
+                prefix: new HarmonyMethod(this.GetType(), nameof(ObjectPatcher.Before_Object_GetDescription))
             );
 
             // object.getDisplayName
             harmony.Patch(
                 original: AccessTools.Method(typeof(SObject), "loadDisplayName"),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(ObjectErrorPatch.Finalize_Object_loadDisplayName))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(ObjectPatcher.Finalize_Object_loadDisplayName))
             );
         }
 
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
similarity index 81%
rename from src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index cc0e5e52..ef165831 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/LoadErrorPatch.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -4,7 +4,6 @@ using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using HarmonyLib;
 using Microsoft.Xna.Framework.Content;
-using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Patching;
 using StardewValley;
 using StardewValley.Buildings;
@@ -16,7 +15,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class LoadErrorPatch : IHarmonyPatch
+    internal class SaveGamePatcher : IHarmonyPatch
     {
         /*********
         ** Fields
@@ -34,10 +33,10 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <summary>Construct an instance.</summary>
         /// <param name="monitor">Writes messages to the console and log file.</param>
         /// <param name="onContentRemoved">A callback invoked when custom content is removed from the save data to avoid a crash.</param>
-        public LoadErrorPatch(IMonitor monitor, Action onContentRemoved)
+        public SaveGamePatcher(IMonitor monitor, Action onContentRemoved)
         {
-            LoadErrorPatch.Monitor = monitor;
-            LoadErrorPatch.OnContentRemoved = onContentRemoved;
+            SaveGamePatcher.Monitor = monitor;
+            SaveGamePatcher.OnContentRemoved = onContentRemoved;
         }
 
 
@@ -46,7 +45,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(SaveGame), nameof(SaveGame.loadDataToLocations)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(LoadErrorPatch.Before_SaveGame_LoadDataToLocations))
+                prefix: new HarmonyMethod(this.GetType(), nameof(SaveGamePatcher.Before_SaveGame_LoadDataToLocations))
             );
         }
 
@@ -60,11 +59,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static bool Before_SaveGame_LoadDataToLocations(List<GameLocation> gamelocations)
         {
             bool removedAny =
-                LoadErrorPatch.RemoveBrokenBuildings(gamelocations)
-                | LoadErrorPatch.RemoveInvalidNpcs(gamelocations);
+                SaveGamePatcher.RemoveBrokenBuildings(gamelocations)
+                | SaveGamePatcher.RemoveInvalidNpcs(gamelocations);
 
             if (removedAny)
-                LoadErrorPatch.OnContentRemoved();
+                SaveGamePatcher.OnContentRemoved();
 
             return true;
         }
@@ -85,7 +84,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                     }
                     catch (ContentLoadException)
                     {
-                        LoadErrorPatch.Monitor.Log($"Removed invalid building type '{building.buildingType.Value}' in {location.Name} ({building.tileX}, {building.tileY}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom building mod?)", LogLevel.Warn);
+                        SaveGamePatcher.Monitor.Log($"Removed invalid building type '{building.buildingType.Value}' in {location.Name} ({building.tileX}, {building.tileY}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom building mod?)", LogLevel.Warn);
                         location.buildings.Remove(building);
                         removedAny = true;
                     }
@@ -102,7 +101,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             bool removedAny = false;
 
             IDictionary<string, string> data = Game1.content.Load<Dictionary<string, string>>("Data\\NPCDispositions");
-            foreach (GameLocation location in LoadErrorPatch.GetAllLocations(locations))
+            foreach (GameLocation location in SaveGamePatcher.GetAllLocations(locations))
             {
                 foreach (NPC npc in location.characters.ToArray())
                 {
@@ -114,7 +113,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                         }
                         catch
                         {
-                            LoadErrorPatch.Monitor.Log($"Removed invalid villager '{npc.Name}' in {location.Name} ({npc.getTileLocation()}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom NPC mod?)", LogLevel.Warn);
+                            SaveGamePatcher.Monitor.Log($"Removed invalid villager '{npc.Name}' in {location.Name} ({npc.getTileLocation()}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom NPC mod?)", LogLevel.Warn);
                             location.characters.Remove(npc);
                             removedAny = true;
                         }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
similarity index 93%
rename from src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
index 7fdf5a48..1099afee 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchValidationPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
@@ -10,7 +10,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class SpriteBatchValidationPatches : IHarmonyPatch
+    internal class SpriteBatchPatcher : IHarmonyPatch
     {
         /*********
         ** Public methods
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 original: Constants.GameFramework == GameFramework.Xna
                     ? AccessTools.Method(typeof(SpriteBatch), "InternalDraw")
                     : AccessTools.Method(typeof(SpriteBatch), "CheckValid", new[] { typeof(Texture2D) }),
-                postfix: new HarmonyMethod(this.GetType(), nameof(SpriteBatchValidationPatches.After_SpriteBatch_CheckValid))
+                postfix: new HarmonyMethod(this.GetType(), nameof(SpriteBatchPatcher.After_SpriteBatch_CheckValid))
             );
         }
 
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
similarity index 93%
rename from src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
rename to src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
index cd57736f..e29e3030 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityErrorPatches.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
@@ -10,7 +10,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class UtilityErrorPatches : IHarmonyPatch
+    internal class UtilityPatcher : IHarmonyPatch
     {
         /*********
         ** Public methods
@@ -20,7 +20,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         {
             harmony.Patch(
                 original: AccessTools.Method(typeof(Utility), nameof(Utility.getItemFromStandardTextDescription)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(UtilityErrorPatches.Finalize_Utility_GetItemFromStandardTextDescription))
+                finalizer: new HarmonyMethod(this.GetType(), nameof(UtilityPatcher.Finalize_Utility_GetItemFromStandardTextDescription))
             );
         }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 419afd4b..35db2da2 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -255,7 +255,7 @@ namespace StardewModdingAPI.Framework
                 // apply game patches
                 MiniMonoModHotfix.Apply();
                 new GamePatcher(this.Monitor).Apply(
-                    new LoadContextPatch(this.Reflection, this.OnLoadStageChanged),
+                    new Game1Patcher(this.Reflection, this.OnLoadStageChanged),
                     new TitleMenuPatcher(this.OnLoadStageChanged)
                 );
 
diff --git a/src/SMAPI/Patches/LoadContextPatch.cs b/src/SMAPI/Patches/Game1Patcher.cs
similarity index 82%
rename from src/SMAPI/Patches/LoadContextPatch.cs
rename to src/SMAPI/Patches/Game1Patcher.cs
index c7f7d986..82b13869 100644
--- a/src/SMAPI/Patches/LoadContextPatch.cs
+++ b/src/SMAPI/Patches/Game1Patcher.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class LoadContextPatch : IHarmonyPatch
+    internal class Game1Patcher : IHarmonyPatch
     {
         /*********
         ** Fields
@@ -35,10 +35,10 @@ namespace StardewModdingAPI.Patches
         /// <summary>Construct an instance.</summary>
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="onStageChanged">A callback to invoke when the load stage changes.</param>
-        public LoadContextPatch(Reflector reflection, Action<LoadStage> onStageChanged)
+        public Game1Patcher(Reflector reflection, Action<LoadStage> onStageChanged)
         {
-            LoadContextPatch.Reflection = reflection;
-            LoadContextPatch.OnStageChanged = onStageChanged;
+            Game1Patcher.Reflection = reflection;
+            Game1Patcher.OnStageChanged = onStageChanged;
         }
 
         /// <inheritdoc />
@@ -47,20 +47,20 @@ namespace StardewModdingAPI.Patches
             // detect CreatedInitialLocations and SaveAddedLocations
             harmony.Patch(
                 original: AccessTools.Method(typeof(Game1), nameof(Game1.AddModNPCs)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_Game1_AddModNPCs))
+                prefix: new HarmonyMethod(this.GetType(), nameof(Game1Patcher.Before_Game1_AddModNPCs))
             );
 
             // detect CreatedLocations, and track IsInLoadForNewGame
             harmony.Patch(
                 original: AccessTools.Method(typeof(Game1), nameof(Game1.loadForNewGame)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_Game1_LoadForNewGame)),
-                postfix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.After_Game1_LoadForNewGame))
+                prefix: new HarmonyMethod(this.GetType(), nameof(Game1Patcher.Before_Game1_LoadForNewGame)),
+                postfix: new HarmonyMethod(this.GetType(), nameof(Game1Patcher.After_Game1_LoadForNewGame))
             );
 
             // detect ReturningToTitle
             harmony.Patch(
                 original: AccessTools.Method(typeof(Game1), nameof(Game1.CleanupReturningToTitle)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(LoadContextPatch.Before_Game1_CleanupReturningToTitle))
+                prefix: new HarmonyMethod(this.GetType(), nameof(Game1Patcher.Before_Game1_CleanupReturningToTitle))
             );
         }
 
@@ -75,9 +75,9 @@ namespace StardewModdingAPI.Patches
         {
             // When this method is called from Game1.loadForNewGame, it happens right after adding the vanilla
             // locations but before initializing them.
-            if (LoadContextPatch.IsInLoadForNewGame)
+            if (Game1Patcher.IsInLoadForNewGame)
             {
-                LoadContextPatch.OnStageChanged(LoadContextPatch.IsCreating()
+                Game1Patcher.OnStageChanged(Game1Patcher.IsCreating()
                     ? LoadStage.CreatedInitialLocations
                     : LoadStage.SaveAddedLocations
                 );
@@ -91,7 +91,7 @@ namespace StardewModdingAPI.Patches
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
         private static bool Before_Game1_CleanupReturningToTitle()
         {
-            LoadContextPatch.OnStageChanged(LoadStage.ReturningToTitle);
+            Game1Patcher.OnStageChanged(LoadStage.ReturningToTitle);
             return true;
         }
 
@@ -100,7 +100,7 @@ namespace StardewModdingAPI.Patches
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
         private static bool Before_Game1_LoadForNewGame()
         {
-            LoadContextPatch.IsInLoadForNewGame = true;
+            Game1Patcher.IsInLoadForNewGame = true;
             return true;
         }
 
@@ -108,10 +108,10 @@ namespace StardewModdingAPI.Patches
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
         private static void After_Game1_LoadForNewGame()
         {
-            LoadContextPatch.IsInLoadForNewGame = false;
+            Game1Patcher.IsInLoadForNewGame = false;
 
-            if (LoadContextPatch.IsCreating())
-                LoadContextPatch.OnStageChanged(LoadStage.CreatedLocations);
+            if (Game1Patcher.IsCreating())
+                Game1Patcher.OnStageChanged(LoadStage.CreatedLocations);
         }
 
         /// <summary>Get whether the save file is currently being created.</summary>
@@ -119,7 +119,7 @@ namespace StardewModdingAPI.Patches
         {
             return
                 (Game1.currentMinigame is Intro) // creating save with intro
-                || (Game1.activeClickableMenu is TitleMenu menu && LoadContextPatch.Reflection.GetField<bool>(menu, "transitioningCharacterCreationMenu").GetValue()); // creating save, skipped intro
+                || (Game1.activeClickableMenu is TitleMenu menu && Game1Patcher.Reflection.GetField<bool>(menu, "transitioningCharacterCreationMenu").GetValue()); // creating save, skipped intro
         }
     }
 }

From 948c800a98f00b1bdcfd05ee6228e3423f9eb465 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 30 Jul 2021 00:54:15 -0400
Subject: [PATCH 219/856] migrate to the new Harmony patch pattern used in my
 mods

That improves validation and error-handling.
---
 src/SMAPI.Internal.Patching/BasePatcher.cs    | 54 +++++++++++++
 src/SMAPI.Internal.Patching/HarmonyPatcher.cs | 36 +++++++++
 src/SMAPI.Internal.Patching/IPatcher.cs       | 16 ++++
 src/SMAPI.Internal.Patching/PatchHelper.cs    | 77 +++++++++++++++++++
 .../SMAPI.Internal.Patching.projitems         | 17 ++++
 .../SMAPI.Internal.Patching.shproj            | 13 ++++
 src/SMAPI.Internal/ExceptionExtensions.cs     | 41 ++++++++++
 src/SMAPI.Internal/SMAPI.Internal.projitems   |  1 +
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  4 +-
 .../Patches/DialoguePatcher.cs                | 18 ++---
 .../Patches/DictionaryPatcher.cs              | 28 +++----
 .../Patches/EventPatcher.cs                   | 12 +--
 .../Patches/GameLocationPatcher.cs            | 24 +++---
 .../Patches/IClickableMenuPatcher.cs          | 14 ++--
 .../Patches/NpcPatcher.cs                     | 24 +++---
 .../Patches/ObjectPatcher.cs                  | 16 ++--
 .../Patches/SaveGamePatcher.cs                | 15 ++--
 .../Patches/SpriteBatchPatcher.cs             | 20 ++---
 .../Patches/UtilityPatcher.cs                 | 14 ++--
 .../SMAPI.Mods.ErrorHandler.csproj            |  1 +
 src/SMAPI.sln                                 |  6 ++
 .../Content/AssetInterceptorChange.cs         |  1 +
 .../ContentManagers/GameContentManager.cs     |  1 +
 .../ContentManagers/ModContentManager.cs      |  1 +
 src/SMAPI/Framework/Events/ManagedEvent.cs    |  1 +
 src/SMAPI/Framework/InternalExtensions.cs     | 35 +--------
 src/SMAPI/Framework/Logging/LogManager.cs     |  1 +
 src/SMAPI/Framework/Patching/GamePatcher.cs   | 45 -----------
 src/SMAPI/Framework/Patching/IHarmonyPatch.cs | 15 ----
 src/SMAPI/Framework/SCore.cs                  |  5 +-
 src/SMAPI/Framework/SGame.cs                  |  1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs     |  1 +
 src/SMAPI/Patches/Game1Patcher.cs             | 38 ++++-----
 src/SMAPI/Patches/TitleMenuPatcher.cs         | 17 ++--
 src/SMAPI/Properties/AssemblyInfo.cs          |  1 -
 src/SMAPI/SMAPI.csproj                        |  1 +
 36 files changed, 394 insertions(+), 221 deletions(-)
 create mode 100644 src/SMAPI.Internal.Patching/BasePatcher.cs
 create mode 100644 src/SMAPI.Internal.Patching/HarmonyPatcher.cs
 create mode 100644 src/SMAPI.Internal.Patching/IPatcher.cs
 create mode 100644 src/SMAPI.Internal.Patching/PatchHelper.cs
 create mode 100644 src/SMAPI.Internal.Patching/SMAPI.Internal.Patching.projitems
 create mode 100644 src/SMAPI.Internal.Patching/SMAPI.Internal.Patching.shproj
 create mode 100644 src/SMAPI.Internal/ExceptionExtensions.cs
 delete mode 100644 src/SMAPI/Framework/Patching/GamePatcher.cs
 delete mode 100644 src/SMAPI/Framework/Patching/IHarmonyPatch.cs

diff --git a/src/SMAPI.Internal.Patching/BasePatcher.cs b/src/SMAPI.Internal.Patching/BasePatcher.cs
new file mode 100644
index 00000000..87155d7f
--- /dev/null
+++ b/src/SMAPI.Internal.Patching/BasePatcher.cs
@@ -0,0 +1,54 @@
+using System;
+using System.Reflection;
+using HarmonyLib;
+
+namespace StardewModdingAPI.Internal.Patching
+{
+    /// <summary>Provides base implementation logic for <see cref="IPatcher"/> instances.</summary>
+    internal abstract class BasePatcher : IPatcher
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <inheritdoc />
+        public abstract void Apply(Harmony harmony, IMonitor monitor);
+
+
+        /*********
+        ** Protected methods
+        *********/
+        /// <summary>Get a method and assert that it was found.</summary>
+        /// <typeparam name="TTarget">The type containing the method.</typeparam>
+        /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
+        protected ConstructorInfo RequireConstructor<TTarget>(params Type[] parameters)
+        {
+            return PatchHelper.RequireConstructor<TTarget>(parameters);
+        }
+
+        /// <summary>Get a method and assert that it was found.</summary>
+        /// <typeparam name="TTarget">The type containing the method.</typeparam>
+        /// <param name="name">The method name.</param>
+        /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
+        /// <param name="generics">The method generic types, or <c>null</c> if it's not generic.</param>
+        protected MethodInfo RequireMethod<TTarget>(string name, Type[] parameters = null, Type[] generics = null)
+        {
+            return PatchHelper.RequireMethod<TTarget>(name, parameters, generics);
+        }
+
+        /// <summary>Get a Harmony patch method on the current patcher instance.</summary>
+        /// <param name="name">The method name.</param>
+        /// <param name="priority">The patch priority to apply, usually specified using Harmony's <see cref="Priority"/> enum, or <c>null</c> to keep the default value.</param>
+        protected HarmonyMethod GetHarmonyMethod(string name, int? priority = null)
+        {
+            var method = new HarmonyMethod(
+                AccessTools.Method(this.GetType(), name)
+                ?? throw new InvalidOperationException($"Can't find patcher method {PatchHelper.GetMethodString(this.GetType(), name)}.")
+            );
+
+            if (priority.HasValue)
+                method.priority = priority.Value;
+
+            return method;
+        }
+    }
+}
diff --git a/src/SMAPI.Internal.Patching/HarmonyPatcher.cs b/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
new file mode 100644
index 00000000..c07e3b41
--- /dev/null
+++ b/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
@@ -0,0 +1,36 @@
+using System;
+using HarmonyLib;
+
+namespace StardewModdingAPI.Internal.Patching
+{
+    /// <summary>Simplifies applying <see cref="IPatcher"/> instances to the game.</summary>
+    internal static class HarmonyPatcher
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Apply the given Harmony patchers.</summary>
+        /// <param name="id">The mod ID applying the patchers.</param>
+        /// <param name="monitor">The monitor with which to log any errors.</param>
+        /// <param name="patchers">The patchers to apply.</param>
+        public static Harmony Apply(string id, IMonitor monitor, params IPatcher[] patchers)
+        {
+            Harmony harmony = new Harmony(id);
+
+            foreach (IPatcher patcher in patchers)
+            {
+                try
+                {
+                    patcher.Apply(harmony, monitor);
+                }
+                catch (Exception ex)
+                {
+                    monitor.Log($"Couldn't apply runtime patch '{patcher.GetType().Name}' to the game. Some SMAPI features may not work correctly. See log file for details.", LogLevel.Error);
+                    monitor.Log($"Technical details:\n{ex.GetLogSummary()}");
+                }
+            }
+
+            return harmony;
+        }
+    }
+}
diff --git a/src/SMAPI.Internal.Patching/IPatcher.cs b/src/SMAPI.Internal.Patching/IPatcher.cs
new file mode 100644
index 00000000..a732d64f
--- /dev/null
+++ b/src/SMAPI.Internal.Patching/IPatcher.cs
@@ -0,0 +1,16 @@
+using HarmonyLib;
+
+namespace StardewModdingAPI.Internal.Patching
+{
+    /// <summary>A set of Harmony patches to apply.</summary>
+    internal interface IPatcher
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Apply the Harmony patches for this instance.</summary>
+        /// <param name="harmony">The Harmony instance.</param>
+        /// <param name="monitor">The monitor with which to log any errors.</param>
+        public void Apply(Harmony harmony, IMonitor monitor);
+    }
+}
diff --git a/src/SMAPI.Internal.Patching/PatchHelper.cs b/src/SMAPI.Internal.Patching/PatchHelper.cs
new file mode 100644
index 00000000..c9758616
--- /dev/null
+++ b/src/SMAPI.Internal.Patching/PatchHelper.cs
@@ -0,0 +1,77 @@
+using System;
+using System.Linq;
+using System.Reflection;
+using System.Text;
+using HarmonyLib;
+
+namespace StardewModdingAPI.Internal.Patching
+{
+    /// <summary>Provides utility methods for patching game code with Harmony.</summary>
+    internal static class PatchHelper
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get a constructor and assert that it was found.</summary>
+        /// <typeparam name="TTarget">The type containing the method.</typeparam>
+        /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
+        /// <exception cref="InvalidOperationException">The type has no matching constructor.</exception>
+        public static ConstructorInfo RequireConstructor<TTarget>(Type[] parameters = null)
+        {
+            return
+                AccessTools.Constructor(typeof(TTarget), parameters)
+                ?? throw new InvalidOperationException($"Can't find constructor {PatchHelper.GetMethodString(typeof(TTarget), null, parameters)} to patch.");
+        }
+
+        /// <summary>Get a method and assert that it was found.</summary>
+        /// <typeparam name="TTarget">The type containing the method.</typeparam>
+        /// <param name="name">The method name.</param>
+        /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
+        /// <param name="generics">The method generic types, or <c>null</c> if it's not generic.</param>
+        /// <exception cref="InvalidOperationException">The type has no matching method.</exception>
+        public static MethodInfo RequireMethod<TTarget>(string name, Type[] parameters = null, Type[] generics = null)
+        {
+            return
+                AccessTools.Method(typeof(TTarget), name, parameters, generics)
+                ?? throw new InvalidOperationException($"Can't find method {PatchHelper.GetMethodString(typeof(TTarget), name, parameters, generics)} to patch.");
+        }
+
+        /// <summary>Get a human-readable representation of a method target.</summary>
+        /// <param name="type">The type containing the method.</param>
+        /// <param name="name">The method name, or <c>null</c> for a constructor.</param>
+        /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
+        /// <param name="generics">The method generic types, or <c>null</c> if it's not generic.</param>
+        public static string GetMethodString(Type type, string name, Type[] parameters = null, Type[] generics = null)
+        {
+            StringBuilder str = new();
+
+            // type
+            str.Append(type.FullName);
+
+            // method name (if not constructor)
+            if (name != null)
+            {
+                str.Append('.');
+                str.Append(name);
+            }
+
+            // generics
+            if (generics?.Any() == true)
+            {
+                str.Append('<');
+                str.Append(string.Join(", ", generics.Select(p => p.FullName)));
+                str.Append('>');
+            }
+
+            // parameters
+            if (parameters?.Any() == true)
+            {
+                str.Append('(');
+                str.Append(string.Join(", ", parameters.Select(p => p.FullName)));
+                str.Append(')');
+            }
+
+            return str.ToString();
+        }
+    }
+}
diff --git a/src/SMAPI.Internal.Patching/SMAPI.Internal.Patching.projitems b/src/SMAPI.Internal.Patching/SMAPI.Internal.Patching.projitems
new file mode 100644
index 00000000..4fa2a062
--- /dev/null
+++ b/src/SMAPI.Internal.Patching/SMAPI.Internal.Patching.projitems
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <PropertyGroup>
+    <MSBuildAllProjects Condition="'$(MSBuildVersion)' == '' Or '$(MSBuildVersion)' &lt; '16.0'">$(MSBuildAllProjects);$(MSBuildThisFileFullPath)</MSBuildAllProjects>
+    <HasSharedItems>true</HasSharedItems>
+    <SharedGUID>6c16e948-3e5c-47a7-bf4b-07a7469a87a5</SharedGUID>
+  </PropertyGroup>
+  <PropertyGroup Label="Configuration">
+    <Import_RootNamespace>SMAPI.Internal.Patching</Import_RootNamespace>
+  </PropertyGroup>
+  <ItemGroup>
+    <Compile Include="$(MSBuildThisFileDirectory)BasePatcher.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)HarmonyPatcher.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)IPatcher.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)PatchHelper.cs" />
+  </ItemGroup>
+</Project>
\ No newline at end of file
diff --git a/src/SMAPI.Internal.Patching/SMAPI.Internal.Patching.shproj b/src/SMAPI.Internal.Patching/SMAPI.Internal.Patching.shproj
new file mode 100644
index 00000000..1a102c82
--- /dev/null
+++ b/src/SMAPI.Internal.Patching/SMAPI.Internal.Patching.shproj
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <PropertyGroup Label="Globals">
+    <ProjectGuid>6c16e948-3e5c-47a7-bf4b-07a7469a87a5</ProjectGuid>
+    <MinimumVisualStudioVersion>14.0</MinimumVisualStudioVersion>
+  </PropertyGroup>
+  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
+  <Import Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\CodeSharing\Microsoft.CodeSharing.Common.Default.props" />
+  <Import Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\CodeSharing\Microsoft.CodeSharing.Common.props" />
+  <PropertyGroup />
+  <Import Project="SMAPI.Internal.Patching.projitems" Label="Shared" />
+  <Import Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\CodeSharing\Microsoft.CodeSharing.CSharp.targets" />
+</Project>
diff --git a/src/SMAPI.Internal/ExceptionExtensions.cs b/src/SMAPI.Internal/ExceptionExtensions.cs
new file mode 100644
index 00000000..d7a2252b
--- /dev/null
+++ b/src/SMAPI.Internal/ExceptionExtensions.cs
@@ -0,0 +1,41 @@
+using System;
+using System.Reflection;
+
+namespace StardewModdingAPI.Internal
+{
+    /// <summary>Provides extension methods for handling exceptions.</summary>
+    internal static class ExceptionExtensions
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get a string representation of an exception suitable for writing to the error log.</summary>
+        /// <param name="exception">The error to summarize.</param>
+        public static string GetLogSummary(this Exception exception)
+        {
+            switch (exception)
+            {
+                case TypeLoadException ex:
+                    return $"Failed loading type '{ex.TypeName}': {exception}";
+
+                case ReflectionTypeLoadException ex:
+                    string summary = exception.ToString();
+                    foreach (Exception childEx in ex.LoaderExceptions)
+                        summary += $"\n\n{childEx.GetLogSummary()}";
+                    return summary;
+
+                default:
+                    return exception.ToString();
+            }
+        }
+
+        /// <summary>Get the lowest exception in an exception stack.</summary>
+        /// <param name="exception">The exception from which to search.</param>
+        public static Exception GetInnermostException(this Exception exception)
+        {
+            while (exception.InnerException != null)
+                exception = exception.InnerException;
+            return exception;
+        }
+    }
+}
diff --git a/src/SMAPI.Internal/SMAPI.Internal.projitems b/src/SMAPI.Internal/SMAPI.Internal.projitems
index 0d583a6d..0ee94a5b 100644
--- a/src/SMAPI.Internal/SMAPI.Internal.projitems
+++ b/src/SMAPI.Internal/SMAPI.Internal.projitems
@@ -14,5 +14,6 @@
     <Compile Include="$(MSBuildThisFileDirectory)ConsoleWriting\ConsoleLogLevel.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)ConsoleWriting\IConsoleWriter.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)ConsoleWriting\MonitorColorScheme.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)ExceptionExtensions.cs" />
   </ItemGroup>
 </Project>
\ No newline at end of file
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index ac9d1b94..067f6a8d 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -1,7 +1,7 @@
 using System;
 using System.Reflection;
 using StardewModdingAPI.Events;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewModdingAPI.Mods.ErrorHandler.Patches;
 using StardewValley;
 
@@ -28,7 +28,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
             IMonitor monitorForGame = this.GetMonitorForGame();
 
             // apply patches
-            new GamePatcher(this.Monitor).Apply(
+            HarmonyPatcher.Apply(this.ModManifest.UniqueID, this.Monitor,
                 new DialoguePatcher(monitorForGame, this.Helper.Reflection),
                 new DictionaryPatcher(this.Helper.Reflection),
                 new EventPatcher(monitorForGame),
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
index 7b730ee5..7a3af39c 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
@@ -1,17 +1,17 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-using StardewModdingAPI.Framework;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>A Harmony patch for the <see cref="Dialogue"/> constructor which intercepts invalid dialogue lines and logs an error instead of crashing.</summary>
+    /// <summary>Harmony patches for <see cref="Dialogue"/> which intercept invalid dialogue lines and logs an error instead of crashing.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class DialoguePatcher : IHarmonyPatch
+    internal class DialoguePatcher : BasePatcher
     {
         /*********
         ** Fields
@@ -36,11 +36,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         }
 
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
-                original: AccessTools.Constructor(typeof(Dialogue), new[] { typeof(string), typeof(NPC) }),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(DialoguePatcher.Finalize_Dialogue_Constructor))
+                original: this.RequireConstructor<Dialogue>(typeof(string), typeof(NPC)),
+                finalizer: this.GetHarmonyMethod(nameof(DialoguePatcher.Finalize_Constructor))
             );
         }
 
@@ -48,13 +48,13 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
-        /// <summary>The method to call after the Dialogue constructor.</summary>
+        /// <summary>The method to call when the Dialogue constructor throws an exception.</summary>
         /// <param name="__instance">The instance being patched.</param>
         /// <param name="masterDialogue">The dialogue being parsed.</param>
         /// <param name="speaker">The NPC for which the dialogue is being parsed.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_Dialogue_Constructor(Dialogue __instance, string masterDialogue, NPC speaker, Exception __exception)
+        private static Exception Finalize_Constructor(Dialogue __instance, string masterDialogue, NPC speaker, Exception __exception)
         {
             if (__exception != null)
             {
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
index 3c5240b6..6ad64e16 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
@@ -2,18 +2,18 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley.GameData;
 using StardewValley.GameData.HomeRenovations;
 using StardewValley.GameData.Movies;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>A Harmony patch for <see cref="Dictionary{TKey,TValue}"/> which adds the accessed key to <see cref="KeyNotFoundException"/> exceptions.</summary>
+    /// <summary>Harmony patches for <see cref="Dictionary{TKey,TValue}"/> which add the accessed key to <see cref="KeyNotFoundException"/> exceptions.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class DictionaryPatcher : IHarmonyPatch
+    internal class DictionaryPatcher : BasePatcher
     {
         /*********
         ** Fields
@@ -33,7 +33,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         }
 
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             Type[] keyTypes = { typeof(int), typeof(string) };
             Type[] valueTypes = { typeof(int), typeof(string), typeof(HomeRenovation), typeof(MovieData), typeof(SpecialOrderData) };
@@ -45,8 +45,8 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                     Type dictionaryType = typeof(Dictionary<,>).MakeGenericType(keyType, valueType);
 
                     harmony.Patch(
-                        original: AccessTools.Method(dictionaryType, "get_Item"),
-                        finalizer: new HarmonyMethod(this.GetType(), nameof(DictionaryPatcher.Finalize_GetItem))
+                        original: AccessTools.Method(dictionaryType, "get_Item") ?? throw new InvalidOperationException($"Can't find method {PatchHelper.GetMethodString(dictionaryType, "get_Item")} to patch."),
+                        finalizer: this.GetHarmonyMethod(nameof(DictionaryPatcher.Finalize_GetItem))
                     );
                 }
             }
@@ -63,19 +63,13 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static Exception Finalize_GetItem(object key, Exception __exception)
         {
             if (__exception is KeyNotFoundException)
-                AddKeyTo(__exception, key?.ToString());
+            {
+                DictionaryPatcher.Reflection
+                    .GetField<string>(__exception, "_message")
+                    .SetValue($"{__exception.Message}\nkey: '{key}'");
+            }
 
             return __exception;
         }
-
-        /// <summary>Add the accessed key to an exception message.</summary>
-        /// <param name="exception">The exception to modify.</param>
-        /// <param name="key">The dictionary key.</param>
-        private static void AddKeyTo(Exception exception, string key)
-        {
-            DictionaryPatcher.Reflection
-                .GetField<string>(exception, "_message")
-                .SetValue($"{exception.Message}\nkey: '{key}'");
-        }
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
index 9a7b34d8..1b706147 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
@@ -1,7 +1,7 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
@@ -10,7 +10,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class EventPatcher : IHarmonyPatch
+    internal class EventPatcher : BasePatcher
     {
         /*********
         ** Fields
@@ -30,11 +30,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         }
 
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
-                original: AccessTools.Method(typeof(Event), nameof(Event.LogErrorAndHalt)),
-                postfix: new HarmonyMethod(this.GetType(), nameof(EventPatcher.After_Event_LogErrorAndHalt))
+                original: this.RequireMethod<Event>(nameof(Event.LogErrorAndHalt)),
+                postfix: this.GetHarmonyMethod(nameof(EventPatcher.After_LogErrorAndHalt))
             );
         }
 
@@ -44,7 +44,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         *********/
         /// <summary>The method to call after <see cref="Event.LogErrorAndHalt"/>.</summary>
         /// <param name="e">The exception being logged.</param>
-        private static void After_Event_LogErrorAndHalt(Exception e)
+        private static void After_LogErrorAndHalt(Exception e)
         {
             EventPatcher.MonitorForGame.Log(e.ToString(), LogLevel.Error);
         }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
index 7427fe48..7df6b0a2 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
@@ -1,17 +1,17 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 using xTile;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>Harmony patches for <see cref="GameLocation.checkEventPrecondition"/> and <see cref="GameLocation.updateSeasonalTileSheets"/> which intercept errors instead of crashing.</summary>
+    /// <summary>Harmony patches for <see cref="GameLocation"/> which intercept errors instead of crashing.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class GameLocationPatcher : IHarmonyPatch
+    internal class GameLocationPatcher : BasePatcher
     {
         /*********
         ** Fields
@@ -31,15 +31,15 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         }
 
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
-                original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.checkEventPrecondition)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(GameLocationPatcher.Finalize_GameLocation_CheckEventPrecondition))
+                original: this.RequireMethod<GameLocation>(nameof(GameLocation.checkEventPrecondition)),
+                finalizer: this.GetHarmonyMethod(nameof(GameLocationPatcher.Finalize_CheckEventPrecondition))
             );
             harmony.Patch(
-                original: AccessTools.Method(typeof(GameLocation), nameof(GameLocation.updateSeasonalTileSheets)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(GameLocationPatcher.Before_GameLocation_UpdateSeasonalTileSheets))
+                original: this.RequireMethod<GameLocation>(nameof(GameLocation.updateSeasonalTileSheets)),
+                finalizer: this.GetHarmonyMethod(nameof(GameLocationPatcher.Finalize_UpdateSeasonalTileSheets))
             );
         }
 
@@ -47,12 +47,12 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
-        /// <summary>The method to call instead of GameLocation.checkEventPrecondition.</summary>
+        /// <summary>The method to call when <see cref="GameLocation.checkEventPrecondition"/> throws an exception.</summary>
         /// <param name="__result">The return value of the original method.</param>
         /// <param name="precondition">The precondition to be parsed.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_GameLocation_CheckEventPrecondition(ref int __result, string precondition, Exception __exception)
+        private static Exception Finalize_CheckEventPrecondition(ref int __result, string precondition, Exception __exception)
         {
             if (__exception != null)
             {
@@ -63,12 +63,12 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             return null;
         }
 
-        /// <summary>The method to call instead of <see cref="GameLocation.updateSeasonalTileSheets"/>.</summary>
+        /// <summary>The method to call when <see cref="GameLocation.updateSeasonalTileSheets"/> throws an exception.</summary>
         /// <param name="__instance">The instance being patched.</param>
         /// <param name="map">The map whose tilesheets to update.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Before_GameLocation_UpdateSeasonalTileSheets(GameLocation __instance, Map map, Exception __exception)
+        private static Exception Finalize_UpdateSeasonalTileSheets(GameLocation __instance, Map map, Exception __exception)
         {
             if (__exception != null)
                 GameLocationPatcher.MonitorForGame.Log($"Failed updating seasonal tilesheets for location '{__instance.NameOrUniqueName}': \n{__exception}", LogLevel.Error);
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
index d6f9fbf4..b65a695a 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
@@ -1,27 +1,27 @@
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 using StardewValley.Menus;
 using SObject = StardewValley.Object;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>A Harmony patch for <see cref="IClickableMenu"/> which intercepts crashes due to invalid items.</summary>
+    /// <summary>Harmony patches for <see cref="IClickableMenu"/> which intercept crashes due to invalid items.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class IClickableMenuPatcher : IHarmonyPatch
+    internal class IClickableMenuPatcher : BasePatcher
     {
         /*********
         ** Public methods
         *********/
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
-                original: AccessTools.Method(typeof(IClickableMenu), nameof(IClickableMenu.drawToolTip)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(IClickableMenuPatcher.Before_IClickableMenu_DrawTooltip))
+                original: this.RequireMethod<IClickableMenu>(nameof(IClickableMenu.drawToolTip)),
+                prefix: this.GetHarmonyMethod(nameof(IClickableMenuPatcher.Before_DrawTooltip))
             );
         }
 
@@ -32,7 +32,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <summary>The method to call instead of <see cref="IClickableMenu.drawToolTip"/>.</summary>
         /// <param name="hoveredItem">The item for which to draw a tooltip.</param>
         /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_IClickableMenu_DrawTooltip(Item hoveredItem)
+        private static bool Before_DrawTooltip(Item hoveredItem)
         {
             // invalid edible item cause crash when drawing tooltips
             if (hoveredItem is SObject obj && obj.Edibility != -300 && !Game1.objectInformation.ContainsKey(obj.ParentSheetIndex))
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
index 4a07ea1d..275bb5bf 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
@@ -2,17 +2,17 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-using StardewModdingAPI.Framework;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>A Harmony patch for <see cref="NPC.parseMasterSchedule"/> which intercepts crashes due to invalid schedule data.</summary>
+    /// <summary>Harmony patches for <see cref="NPC"/> which intercept crashes due to invalid schedule data.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class NpcPatcher : IHarmonyPatch
+    internal class NpcPatcher : BasePatcher
     {
         /*********
         ** Fields
@@ -32,16 +32,16 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         }
 
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
-                original: AccessTools.Property(typeof(NPC), nameof(NPC.CurrentDialogue)).GetMethod,
-                finalizer: new HarmonyMethod(this.GetType(), nameof(NpcPatcher.Finalize_NPC_CurrentDialogue))
+                original: this.RequireMethod<NPC>($"get_{nameof(NPC.CurrentDialogue)}"),
+                finalizer: this.GetHarmonyMethod(nameof(NpcPatcher.Finalize_CurrentDialogue))
             );
 
             harmony.Patch(
-                original: AccessTools.Method(typeof(NPC), nameof(NPC.parseMasterSchedule)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(NpcPatcher.Finalize_NPC_parseMasterSchedule))
+                original: this.RequireMethod<NPC>(nameof(NPC.parseMasterSchedule)),
+                finalizer: this.GetHarmonyMethod(nameof(NpcPatcher.Finalize_ParseMasterSchedule))
             );
         }
 
@@ -49,12 +49,12 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
-        /// <summary>The method to call after <see cref="NPC.CurrentDialogue"/>.</summary>
+        /// <summary>The method to call when <see cref="NPC.CurrentDialogue"/> throws an exception.</summary>
         /// <param name="__instance">The instance being patched.</param>
         /// <param name="__result">The return value of the original method.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_NPC_CurrentDialogue(NPC __instance, ref Stack<Dialogue> __result, Exception __exception)
+        private static Exception Finalize_CurrentDialogue(NPC __instance, ref Stack<Dialogue> __result, Exception __exception)
         {
             if (__exception == null)
                 return null;
@@ -71,7 +71,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="__result">The patched method's return value.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_NPC_parseMasterSchedule(string rawData, NPC __instance, ref Dictionary<int, SchedulePathDescription> __result, Exception __exception)
+        private static Exception Finalize_ParseMasterSchedule(string rawData, NPC __instance, ref Dictionary<int, SchedulePathDescription> __result, Exception __exception)
         {
             if (__exception != null)
             {
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
index c4b25b96..fd4ea35c 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
@@ -2,34 +2,34 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 using SObject = StardewValley.Object;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>A Harmony patch for <see cref="SObject.getDescription"/> which intercepts crashes due to the item no longer existing.</summary>
+    /// <summary>Harmony patches for <see cref="SObject"/> which intercept crashes due to invalid items.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class ObjectPatcher : IHarmonyPatch
+    internal class ObjectPatcher : BasePatcher
     {
         /*********
         ** Public methods
         *********/
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             // object.getDescription
             harmony.Patch(
-                original: AccessTools.Method(typeof(SObject), nameof(SObject.getDescription)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(ObjectPatcher.Before_Object_GetDescription))
+                original: this.RequireMethod<SObject>(nameof(SObject.getDescription)),
+                prefix: this.GetHarmonyMethod(nameof(ObjectPatcher.Before_Object_GetDescription))
             );
 
             // object.getDisplayName
             harmony.Patch(
-                original: AccessTools.Method(typeof(SObject), "loadDisplayName"),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(ObjectPatcher.Finalize_Object_loadDisplayName))
+                original: this.RequireMethod<SObject>("loadDisplayName"),
+                finalizer: this.GetHarmonyMethod(nameof(ObjectPatcher.Finalize_Object_loadDisplayName))
             );
         }
 
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index ef165831..8945e4f3 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -4,18 +4,18 @@ using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using HarmonyLib;
 using Microsoft.Xna.Framework.Content;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 using StardewValley.Buildings;
 using StardewValley.Locations;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>A Harmony patch for <see cref="SaveGame"/> which prevents some errors due to broken save data.</summary>
+    /// <summary>Harmony patches for <see cref="SaveGame"/> which prevent some errors due to broken save data.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class SaveGamePatcher : IHarmonyPatch
+    internal class SaveGamePatcher : BasePatcher
     {
         /*********
         ** Fields
@@ -39,13 +39,12 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
             SaveGamePatcher.OnContentRemoved = onContentRemoved;
         }
 
-
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
-                original: AccessTools.Method(typeof(SaveGame), nameof(SaveGame.loadDataToLocations)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(SaveGamePatcher.Before_SaveGame_LoadDataToLocations))
+                original: this.RequireMethod<SaveGame>(nameof(SaveGame.loadDataToLocations)),
+                prefix: this.GetHarmonyMethod(nameof(SaveGamePatcher.Before_LoadDataToLocations))
             );
         }
 
@@ -56,7 +55,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <summary>The method to call instead of <see cref="SaveGame.loadDataToLocations"/>.</summary>
         /// <param name="gamelocations">The game locations being loaded.</param>
         /// <returns>Returns whether to execute the original method.</returns>
-        private static bool Before_SaveGame_LoadDataToLocations(List<GameLocation> gamelocations)
+        private static bool Before_LoadDataToLocations(List<GameLocation> gamelocations)
         {
             bool removedAny =
                 SaveGamePatcher.RemoveBrokenBuildings(gamelocations)
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
index 1099afee..6860a4ec 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
@@ -2,27 +2,27 @@ using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
 using Microsoft.Xna.Framework.Graphics;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
-    /// <summary>Harmony patch for <see cref="SpriteBatch"/> to validate textures earlier.</summary>
+    /// <summary>Harmony patches for <see cref="SpriteBatch"/> which validate textures earlier.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class SpriteBatchPatcher : IHarmonyPatch
+    internal class SpriteBatchPatcher : BasePatcher
     {
         /*********
         ** Public methods
         *********/
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
                 original: Constants.GameFramework == GameFramework.Xna
-                    ? AccessTools.Method(typeof(SpriteBatch), "InternalDraw")
-                    : AccessTools.Method(typeof(SpriteBatch), "CheckValid", new[] { typeof(Texture2D) }),
-                postfix: new HarmonyMethod(this.GetType(), nameof(SpriteBatchPatcher.After_SpriteBatch_CheckValid))
+                    ? this.RequireMethod<SpriteBatch>("InternalDraw")
+                    : this.RequireMethod<SpriteBatch>("CheckValid", new[] { typeof(Texture2D) }),
+                postfix: this.GetHarmonyMethod(nameof(SpriteBatchPatcher.After_CheckValid))
             );
         }
 
@@ -31,13 +31,13 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Private methods
         *********/
 #if SMAPI_FOR_XNA
-        /// <summary>The method to call instead of <see cref="SpriteBatch.InternalDraw"/>.</summary>
+        /// <summary>The method to call after <see cref="SpriteBatch.InternalDraw"/>.</summary>
         /// <param name="texture">The texture to validate.</param>
 #else
-        /// <summary>The method to call instead of <see cref="SpriteBatch.CheckValid"/>.</summary>
+        /// <summary>The method to call after <see cref="SpriteBatch.CheckValid"/>.</summary>
         /// <param name="texture">The texture to validate.</param>
 #endif
-        private static void After_SpriteBatch_CheckValid(Texture2D texture)
+        private static void After_CheckValid(Texture2D texture)
         {
             if (texture?.IsDisposed == true)
                 throw new ObjectDisposedException("Cannot draw this texture because it's disposed.");
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
index e29e3030..ce85d0c2 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
@@ -1,7 +1,7 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
@@ -10,17 +10,17 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class UtilityPatcher : IHarmonyPatch
+    internal class UtilityPatcher : BasePatcher
     {
         /*********
         ** Public methods
         *********/
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
-                original: AccessTools.Method(typeof(Utility), nameof(Utility.getItemFromStandardTextDescription)),
-                finalizer: new HarmonyMethod(this.GetType(), nameof(UtilityPatcher.Finalize_Utility_GetItemFromStandardTextDescription))
+                original: this.RequireMethod<Utility>(nameof(Utility.getItemFromStandardTextDescription)),
+                finalizer: this.GetHarmonyMethod(nameof(UtilityPatcher.Finalize_GetItemFromStandardTextDescription))
             );
         }
 
@@ -28,12 +28,12 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
-        /// <summary>The method to call instead of <see cref="Utility.getItemFromStandardTextDescription"/>.</summary>
+        /// <summary>The method to call when <see cref="Utility.getItemFromStandardTextDescription"/> throws an exception.</summary>
         /// <param name="description">The item text description to parse.</param>
         /// <param name="delimiter">The delimiter by which to split the text description.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_Utility_GetItemFromStandardTextDescription(string description, char delimiter, ref Exception __exception)
+        private static Exception Finalize_GetItemFromStandardTextDescription(string description, char delimiter, ref Exception __exception)
         {
             return __exception != null
                 ? new FormatException($"Failed to parse item text description \"{description}\" with delimiter \"{delimiter}\".", __exception)
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 531d3699..ffda5f89 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -47,4 +47,5 @@
   </ItemGroup>
 
   <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
+  <Import Project="..\SMAPI.Internal.Patching\SMAPI.Internal.Patching.projitems" Label="Shared" />
 </Project>
diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index 58228ce9..92c6cb24 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -52,6 +52,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Mods", "Mods", "{AE9A4D46-E
 EndProject
 Project("{D954291E-2A0B-460D-934E-DC6B0785DB48}") = "SMAPI.Internal", "SMAPI.Internal\SMAPI.Internal.shproj", "{85208F8D-6FD1-4531-BE05-7142490F59FE}"
 EndProject
+Project("{D954291E-2A0B-460D-934E-DC6B0785DB48}") = "SMAPI.Internal.Patching", "SMAPI.Internal.Patching\SMAPI.Internal.Patching.shproj", "{6C16E948-3E5C-47A7-BF4B-07A7469A87A5}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.ModBuildConfig.Analyzer.Tests", "SMAPI.ModBuildConfig.Analyzer.Tests\SMAPI.ModBuildConfig.Analyzer.Tests.csproj", "{680B2641-81EA-467C-86A5-0E81CDC57ED0}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Tests", "SMAPI.Tests\SMAPI.Tests.csproj", "{AA95884B-7097-476E-92C8-D0500DE9D6D1}"
@@ -86,10 +88,13 @@ Global
 	GlobalSection(SharedMSBuildProjectFiles) = preSolution
 		SMAPI.Internal\SMAPI.Internal.projitems*{0634ea4c-3b8f-42db-aea6-ca9e4ef6e92f}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{0a9bb24f-15ff-4c26-b1a2-81f7ae316518}*SharedItemsImports = 5
+		SMAPI.Internal.Patching\SMAPI.Internal.Patching.projitems*{491e775b-ead0-44d4-b6ca-f1fc3e316d33}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{491e775b-ead0-44d4-b6ca-f1fc3e316d33}*SharedItemsImports = 5
+		SMAPI.Internal.Patching\SMAPI.Internal.Patching.projitems*{6c16e948-3e5c-47a7-bf4b-07a7469a87a5}*SharedItemsImports = 13
 		SMAPI.Internal\SMAPI.Internal.projitems*{80efd92f-728f-41e0-8a5b-9f6f49a91899}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{85208f8d-6fd1-4531-be05-7142490f59fe}*SharedItemsImports = 13
 		SMAPI.Internal\SMAPI.Internal.projitems*{cd53ad6f-97f4-4872-a212-50c2a0fd3601}*SharedItemsImports = 5
+		SMAPI.Internal.Patching\SMAPI.Internal.Patching.projitems*{e6da2198-7686-4f1d-b312-4a4dc70884c0}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{e6da2198-7686-4f1d-b312-4a4dc70884c0}*SharedItemsImports = 5
 	EndGlobalSection
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -156,6 +161,7 @@ Global
 		{EB35A917-67B9-4EFA-8DFC-4FB49B3949BB} = {86C452BE-D2D8-45B4-B63F-E329EB06CEDA}
 		{5947303D-3512-413A-9009-7AC43F5D3513} = {EB35A917-67B9-4EFA-8DFC-4FB49B3949BB}
 		{85208F8D-6FD1-4531-BE05-7142490F59FE} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
+		{6C16E948-3E5C-47A7-BF4B-07A7469A87A5} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
 		{680B2641-81EA-467C-86A5-0E81CDC57ED0} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
 		{AA95884B-7097-476E-92C8-D0500DE9D6D1} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
 		{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
diff --git a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
index 037d9f89..10488b84 100644
--- a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
+++ b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Reflection;
+using StardewModdingAPI.Internal;
 
 namespace StardewModdingAPI.Framework.Content
 {
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 80a9937a..63cd1759 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -9,6 +9,7 @@ using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Utilities;
+using StardewModdingAPI.Internal;
 using StardewValley;
 using xTile;
 
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index bc5a8b74..d24ffb81 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -7,6 +7,7 @@ using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Internal;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index 2204966c..fa20a079 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
 using StardewModdingAPI.Events;
+using StardewModdingAPI.Internal;
 
 namespace StardewModdingAPI.Framework.Events
 {
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index ab7f1e6c..6c9a5f3b 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -14,6 +14,9 @@ namespace StardewModdingAPI.Framework
     /// <summary>Provides extension methods for SMAPI's internal use.</summary>
     internal static class InternalExtensions
     {
+        /*********
+        ** Public methods
+        *********/
         /****
         ** IMonitor
         ****/
@@ -54,38 +57,6 @@ namespace StardewModdingAPI.Framework
             @event.Raise(Singleton<TEventArgs>.Instance);
         }
 
-        /****
-        ** Exceptions
-        ****/
-        /// <summary>Get a string representation of an exception suitable for writing to the error log.</summary>
-        /// <param name="exception">The error to summarize.</param>
-        public static string GetLogSummary(this Exception exception)
-        {
-            switch (exception)
-            {
-                case TypeLoadException ex:
-                    return $"Failed loading type '{ex.TypeName}': {exception}";
-
-                case ReflectionTypeLoadException ex:
-                    string summary = exception.ToString();
-                    foreach (Exception childEx in ex.LoaderExceptions)
-                        summary += $"\n\n{childEx.GetLogSummary()}";
-                    return summary;
-
-                default:
-                    return exception.ToString();
-            }
-        }
-
-        /// <summary>Get the lowest exception in an exception stack.</summary>
-        /// <param name="exception">The exception from which to search.</param>
-        public static Exception GetInnermostException(this Exception exception)
-        {
-            while (exception.InnerException != null)
-                exception = exception.InnerException;
-            return exception;
-        }
-
         /****
         ** ReaderWriterLockSlim
         ****/
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index e16b5c0d..a3d4f23d 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -9,6 +9,7 @@ using System.Threading;
 using StardewModdingAPI.Framework.Commands;
 using StardewModdingAPI.Framework.Models;
 using StardewModdingAPI.Framework.ModLoading;
+using StardewModdingAPI.Internal;
 using StardewModdingAPI.Internal.ConsoleWriting;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Utilities;
diff --git a/src/SMAPI/Framework/Patching/GamePatcher.cs b/src/SMAPI/Framework/Patching/GamePatcher.cs
deleted file mode 100644
index 3ce22ee9..00000000
--- a/src/SMAPI/Framework/Patching/GamePatcher.cs
+++ /dev/null
@@ -1,45 +0,0 @@
-using System;
-using HarmonyLib;
-
-namespace StardewModdingAPI.Framework.Patching
-{
-    /// <summary>Encapsulates applying Harmony patches to the game.</summary>
-    internal class GamePatcher
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>Encapsulates monitoring and logging.</summary>
-        private readonly IMonitor Monitor;
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="monitor">Encapsulates monitoring and logging.</param>
-        public GamePatcher(IMonitor monitor)
-        {
-            this.Monitor = monitor;
-        }
-
-        /// <summary>Apply all loaded patches to the game.</summary>
-        /// <param name="patches">The patches to apply.</param>
-        public void Apply(params IHarmonyPatch[] patches)
-        {
-            Harmony harmony = new Harmony("SMAPI");
-            foreach (IHarmonyPatch patch in patches)
-            {
-                try
-                {
-                    patch.Apply(harmony);
-                }
-                catch (Exception ex)
-                {
-                    this.Monitor.Log($"Couldn't apply runtime patch '{patch.GetType().Name}' to the game. Some SMAPI features may not work correctly. See log file for details.", LogLevel.Error);
-                    this.Monitor.Log(ex.GetLogSummary(), LogLevel.Trace);
-                }
-            }
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/Patching/IHarmonyPatch.cs b/src/SMAPI/Framework/Patching/IHarmonyPatch.cs
deleted file mode 100644
index c1ff3040..00000000
--- a/src/SMAPI/Framework/Patching/IHarmonyPatch.cs
+++ /dev/null
@@ -1,15 +0,0 @@
-using HarmonyLib;
-
-namespace StardewModdingAPI.Framework.Patching
-{
-    /// <summary>A Harmony patch to apply.</summary>
-    internal interface IHarmonyPatch
-    {
-        /*********
-        ** Methods
-        *********/
-        /// <summary>Apply the Harmony patch.</summary>
-        /// <param name="harmony">The Harmony instance.</param>
-        void Apply(Harmony harmony);
-    }
-}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 35db2da2..a34b3eff 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -31,13 +31,14 @@ using StardewModdingAPI.Framework.Models;
 using StardewModdingAPI.Framework.ModHelpers;
 using StardewModdingAPI.Framework.ModLoading;
 using StardewModdingAPI.Framework.Networking;
-using StardewModdingAPI.Framework.Patching;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Rendering;
 using StardewModdingAPI.Framework.Serialization;
 using StardewModdingAPI.Framework.StateTracking.Comparers;
 using StardewModdingAPI.Framework.StateTracking.Snapshots;
 using StardewModdingAPI.Framework.Utilities;
+using StardewModdingAPI.Internal;
+using StardewModdingAPI.Internal.Patching;
 using StardewModdingAPI.Patches;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.Clients.WebApi;
@@ -254,7 +255,7 @@ namespace StardewModdingAPI.Framework
 
                 // apply game patches
                 MiniMonoModHotfix.Apply();
-                new GamePatcher(this.Monitor).Apply(
+                HarmonyPatcher.Apply("SMAPI", this.Monitor,
                     new Game1Patcher(this.Reflection, this.OnLoadStageChanged),
                     new TitleMenuPatcher(this.OnLoadStageChanged)
                 );
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index af7fa387..55ab8377 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -11,6 +11,7 @@ using StardewModdingAPI.Framework.Input;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.StateTracking.Snapshots;
 using StardewModdingAPI.Framework.Utilities;
+using StardewModdingAPI.Internal;
 using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.BellsAndWhistles;
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 5641f90f..9273864e 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -8,6 +8,7 @@ using Netcode;
 using StardewModdingAPI.Framework;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Internal;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
 using StardewValley.BellsAndWhistles;
diff --git a/src/SMAPI/Patches/Game1Patcher.cs b/src/SMAPI/Patches/Game1Patcher.cs
index 82b13869..173a2055 100644
--- a/src/SMAPI/Patches/Game1Patcher.cs
+++ b/src/SMAPI/Patches/Game1Patcher.cs
@@ -2,19 +2,19 @@ using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
 using StardewModdingAPI.Enums;
-using StardewModdingAPI.Framework.Patching;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 using StardewValley.Menus;
 using StardewValley.Minigames;
 
 namespace StardewModdingAPI.Patches
 {
-    /// <summary>Harmony patches which notify SMAPI for save creation load stages.</summary>
+    /// <summary>Harmony patches for <see cref="Game1"/> which notify SMAPI for save load stages.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class Game1Patcher : IHarmonyPatch
+    internal class Game1Patcher : BasePatcher
     {
         /*********
         ** Fields
@@ -42,25 +42,25 @@ namespace StardewModdingAPI.Patches
         }
 
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
             // detect CreatedInitialLocations and SaveAddedLocations
             harmony.Patch(
-                original: AccessTools.Method(typeof(Game1), nameof(Game1.AddModNPCs)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(Game1Patcher.Before_Game1_AddModNPCs))
+                original: this.RequireMethod<Game1>(nameof(Game1.AddModNPCs)),
+                prefix: this.GetHarmonyMethod(nameof(Game1Patcher.Before_AddModNpcs))
             );
 
             // detect CreatedLocations, and track IsInLoadForNewGame
             harmony.Patch(
-                original: AccessTools.Method(typeof(Game1), nameof(Game1.loadForNewGame)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(Game1Patcher.Before_Game1_LoadForNewGame)),
-                postfix: new HarmonyMethod(this.GetType(), nameof(Game1Patcher.After_Game1_LoadForNewGame))
+                original: this.RequireMethod<Game1>(nameof(Game1.loadForNewGame)),
+                prefix: this.GetHarmonyMethod(nameof(Game1Patcher.Before_LoadForNewGame)),
+                postfix: this.GetHarmonyMethod(nameof(Game1Patcher.After_LoadForNewGame))
             );
 
             // detect ReturningToTitle
             harmony.Patch(
-                original: AccessTools.Method(typeof(Game1), nameof(Game1.CleanupReturningToTitle)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(Game1Patcher.Before_Game1_CleanupReturningToTitle))
+                original: this.RequireMethod<Game1>(nameof(Game1.CleanupReturningToTitle)),
+                prefix: this.GetHarmonyMethod(nameof(Game1Patcher.Before_CleanupReturningToTitle))
             );
         }
 
@@ -68,10 +68,10 @@ namespace StardewModdingAPI.Patches
         /*********
         ** Private methods
         *********/
-        /// <summary>Called before <see cref="Game1.AddModNPCs"/>.</summary>
+        /// <summary>The method to call before <see cref="Game1.AddModNPCs"/>.</summary>
         /// <returns>Returns whether to execute the original method.</returns>
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
-        private static bool Before_Game1_AddModNPCs()
+        private static bool Before_AddModNpcs()
         {
             // When this method is called from Game1.loadForNewGame, it happens right after adding the vanilla
             // locations but before initializing them.
@@ -86,27 +86,27 @@ namespace StardewModdingAPI.Patches
             return true;
         }
 
-        /// <summary>Called before <see cref="Game1.CleanupReturningToTitle"/>.</summary>
+        /// <summary>The method to call before <see cref="Game1.CleanupReturningToTitle"/>.</summary>
         /// <returns>Returns whether to execute the original method.</returns>
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
-        private static bool Before_Game1_CleanupReturningToTitle()
+        private static bool Before_CleanupReturningToTitle()
         {
             Game1Patcher.OnStageChanged(LoadStage.ReturningToTitle);
             return true;
         }
 
-        /// <summary>Called before <see cref="Game1.loadForNewGame"/>.</summary>
+        /// <summary>The method to call before <see cref="Game1.loadForNewGame"/>.</summary>
         /// <returns>Returns whether to execute the original method.</returns>
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
-        private static bool Before_Game1_LoadForNewGame()
+        private static bool Before_LoadForNewGame()
         {
             Game1Patcher.IsInLoadForNewGame = true;
             return true;
         }
 
-        /// <summary>Called after <see cref="Game1.loadForNewGame"/>.</summary>
+        /// <summary>The method to call after <see cref="Game1.loadForNewGame"/>.</summary>
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
-        private static void After_Game1_LoadForNewGame()
+        private static void After_LoadForNewGame()
         {
             Game1Patcher.IsInLoadForNewGame = false;
 
diff --git a/src/SMAPI/Patches/TitleMenuPatcher.cs b/src/SMAPI/Patches/TitleMenuPatcher.cs
index a889adfc..b4320ce0 100644
--- a/src/SMAPI/Patches/TitleMenuPatcher.cs
+++ b/src/SMAPI/Patches/TitleMenuPatcher.cs
@@ -2,16 +2,16 @@ using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
 using StardewModdingAPI.Enums;
-using StardewModdingAPI.Framework.Patching;
+using StardewModdingAPI.Internal.Patching;
 using StardewValley.Menus;
 
 namespace StardewModdingAPI.Patches
 {
-    /// <summary>Harmony patches which notify SMAPI for save creation load stages.</summary>
+    /// <summary>Harmony patches for <see cref="TitleMenu"/> which notify SMAPI when a new character was created.</summary>
     /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
     [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
     [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class TitleMenuPatcher : IHarmonyPatch
+    internal class TitleMenuPatcher : BasePatcher
     {
         /*********
         ** Fields
@@ -31,12 +31,11 @@ namespace StardewModdingAPI.Patches
         }
 
         /// <inheritdoc />
-        public void Apply(Harmony harmony)
+        public override void Apply(Harmony harmony, IMonitor monitor)
         {
-            // detect CreatedBasicInfo
             harmony.Patch(
-                original: AccessTools.Method(typeof(TitleMenu), nameof(TitleMenu.createdNewCharacter)),
-                prefix: new HarmonyMethod(this.GetType(), nameof(TitleMenuPatcher.Before_TitleMenu_CreatedNewCharacter))
+                original: this.RequireMethod<TitleMenu>(nameof(TitleMenu.createdNewCharacter)),
+                prefix: this.GetHarmonyMethod(nameof(TitleMenuPatcher.Before_CreatedNewCharacter))
             );
         }
 
@@ -44,10 +43,10 @@ namespace StardewModdingAPI.Patches
         /*********
         ** Private methods
         *********/
-        /// <summary>Called before <see cref="TitleMenu.createdNewCharacter"/>.</summary>
+        /// <summary>The method to call before <see cref="TitleMenu.createdNewCharacter"/>.</summary>
         /// <returns>Returns whether to execute the original method.</returns>
         /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
-        private static bool Before_TitleMenu_CreatedNewCharacter()
+        private static bool Before_CreatedNewCharacter()
         {
             TitleMenuPatcher.OnStageChanged(LoadStage.CreatedBasicInfo);
             return true;
diff --git a/src/SMAPI/Properties/AssemblyInfo.cs b/src/SMAPI/Properties/AssemblyInfo.cs
index ae758e9b..ee8a1674 100644
--- a/src/SMAPI/Properties/AssemblyInfo.cs
+++ b/src/SMAPI/Properties/AssemblyInfo.cs
@@ -1,5 +1,4 @@
 using System.Runtime.CompilerServices;
 
 [assembly: InternalsVisibleTo("SMAPI.Tests")]
-[assembly: InternalsVisibleTo("ErrorHandler")]
 [assembly: InternalsVisibleTo("DynamicProxyGenAssembly2")] // Moq for unit testing
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 0c6cfdd3..7d5e7ef9 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -76,4 +76,5 @@
   </ItemGroup>
 
   <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
+  <Import Project="..\SMAPI.Internal.Patching\SMAPI.Internal.Patching.projitems" Label="Shared" />
 </Project>

From 10b7758bd218536490dbb5613981ef7771917a85 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 30 Jul 2021 00:56:37 -0400
Subject: [PATCH 220/856] fix build error on Linux

---
 .../Framework/Commands/World/ClearCommand.cs                    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index 44adc4c9..ceaeb278 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -141,7 +141,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                             this.RemoveFurniture(location, p => true)
                             + this.RemoveObjects(location, p => true)
                             + this.RemoveTerrainFeatures(location, p => true)
-                            + this.RemoveLargeTerrainFeatures(location, p => everything || p is not Bush bush || bush.isDestroyable(location, p.currentTileLocation))
+                            + this.RemoveLargeTerrainFeatures(location, p => everything || !(p is Bush bush) || bush.isDestroyable(location, p.currentTileLocation))
                             + this.RemoveResourceClumps(location, p => true);
                         monitor.Log($"Done! Removed {removed} entities from {location.Name}.", LogLevel.Info);
                         break;

From 940bf922418da9ddac10c67cc5682a9bbf13c063 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 30 Jul 2021 01:40:43 -0400
Subject: [PATCH 221/856] refactor save game patcher to minimize repeated
 iterations

---
 .../Patches/SaveGamePatcher.cs                | 99 +++++++++----------
 1 file changed, 45 insertions(+), 54 deletions(-)

diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index 8945e4f3..635a01c1 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -57,25 +57,40 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <returns>Returns whether to execute the original method.</returns>
         private static bool Before_LoadDataToLocations(List<GameLocation> gamelocations)
         {
-            bool removedAny =
-                SaveGamePatcher.RemoveBrokenBuildings(gamelocations)
-                | SaveGamePatcher.RemoveInvalidNpcs(gamelocations);
+            IDictionary<string, string> npcs = Game1.content.Load<Dictionary<string, string>>("Data\\NPCDispositions");
 
-            if (removedAny)
+            if (SaveGamePatcher.RemoveBrokenContent(gamelocations, npcs))
                 SaveGamePatcher.OnContentRemoved();
 
             return true;
         }
 
-        /// <summary>Remove buildings which don't exist in the game data.</summary>
+        /// <summary>Remove content which no longer exists in the game data.</summary>
         /// <param name="locations">The current game locations.</param>
-        private static bool RemoveBrokenBuildings(IEnumerable<GameLocation> locations)
+        /// <param name="npcs">The NPC data.</param>
+        private static bool RemoveBrokenContent(IEnumerable<GameLocation> locations, IDictionary<string, string> npcs)
         {
             bool removedAny = false;
 
-            foreach (BuildableGameLocation location in locations.OfType<BuildableGameLocation>())
+            foreach (GameLocation location in locations)
+                removedAny |= SaveGamePatcher.RemoveBrokenContent(location, npcs);
+
+            return removedAny;
+        }
+
+        /// <summary>Remove content which no longer exists in the game data.</summary>
+        /// <param name="location">The current game location.</param>
+        /// <param name="npcs">The NPC data.</param>
+        private static bool RemoveBrokenContent(GameLocation location, IDictionary<string, string> npcs)
+        {
+            bool removedAny = false;
+            if (location == null)
+                return false;
+
+            // check buildings
+            if (location is BuildableGameLocation buildableLocation)
             {
-                foreach (Building building in location.buildings.ToArray())
+                foreach (Building building in buildableLocation.buildings.ToArray())
                 {
                     try
                     {
@@ -84,7 +99,28 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                     catch (ContentLoadException)
                     {
                         SaveGamePatcher.Monitor.Log($"Removed invalid building type '{building.buildingType.Value}' in {location.Name} ({building.tileX}, {building.tileY}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom building mod?)", LogLevel.Warn);
-                        location.buildings.Remove(building);
+                        buildableLocation.buildings.Remove(building);
+                        removedAny = true;
+                        continue;
+                    }
+
+                    SaveGamePatcher.RemoveBrokenContent(building.indoors.Value, npcs);
+                }
+            }
+
+            // check NPCs
+            foreach (NPC npc in location.characters.ToArray())
+            {
+                if (npc.isVillager() && !npcs.ContainsKey(npc.Name))
+                {
+                    try
+                    {
+                        npc.reloadSprite(); // this won't crash for special villagers like Bouncer
+                    }
+                    catch
+                    {
+                        SaveGamePatcher.Monitor.Log($"Removed invalid villager '{npc.Name}' in {location.Name} ({npc.getTileLocation()}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom NPC mod?)", LogLevel.Warn);
+                        location.characters.Remove(npc);
                         removedAny = true;
                     }
                 }
@@ -92,50 +128,5 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 
             return removedAny;
         }
-
-        /// <summary>Remove NPCs which don't exist in the game data.</summary>
-        /// <param name="locations">The current game locations.</param>
-        private static bool RemoveInvalidNpcs(IEnumerable<GameLocation> locations)
-        {
-            bool removedAny = false;
-
-            IDictionary<string, string> data = Game1.content.Load<Dictionary<string, string>>("Data\\NPCDispositions");
-            foreach (GameLocation location in SaveGamePatcher.GetAllLocations(locations))
-            {
-                foreach (NPC npc in location.characters.ToArray())
-                {
-                    if (npc.isVillager() && !data.ContainsKey(npc.Name))
-                    {
-                        try
-                        {
-                            npc.reloadSprite(); // this won't crash for special villagers like Bouncer
-                        }
-                        catch
-                        {
-                            SaveGamePatcher.Monitor.Log($"Removed invalid villager '{npc.Name}' in {location.Name} ({npc.getTileLocation()}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom NPC mod?)", LogLevel.Warn);
-                            location.characters.Remove(npc);
-                            removedAny = true;
-                        }
-                    }
-                }
-            }
-
-            return removedAny;
-        }
-
-        /// <summary>Get all locations, including building interiors.</summary>
-        /// <param name="locations">The main game locations.</param>
-        private static IEnumerable<GameLocation> GetAllLocations(IEnumerable<GameLocation> locations)
-        {
-            foreach (GameLocation location in locations)
-            {
-                yield return location;
-                if (location is BuildableGameLocation buildableLocation)
-                {
-                    foreach (GameLocation interior in buildableLocation.buildings.Select(p => p.indoors.Value).Where(p => p != null))
-                        yield return interior;
-                }
-            }
-        }
     }
 }

From dc78d944e8663c02f305bbadff1c13e8c63eb42f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 30 Jul 2021 01:48:22 -0400
Subject: [PATCH 222/856] recover save when mods leave null objects in the
 world

---
 docs/release-notes.md                               |  1 +
 .../Patches/SaveGamePatcher.cs                      | 13 +++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0f144bf5..44807dcb 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Added automatic save recovery when custom content mods leave null objects in the save.
   * Added error if the wrong SMAPI bitness is installed (e.g. 32-bit SMAPI with 64-bit game).
   * Added error if some SMAPI files aren't updated correctly.
   * Added `removable` option to the `world_clear` console command (thanks to bladeoflight16!).
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index 635a01c1..2a43cb10 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -8,6 +8,7 @@ using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 using StardewValley.Buildings;
 using StardewValley.Locations;
+using SObject = StardewValley.Object;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
@@ -126,6 +127,18 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 }
             }
 
+            // check objects
+            foreach (var pair in location.objects.Pairs.ToArray())
+            {
+                // SpaceCore can leave null values when removing its custom content
+                if (pair.Value == null)
+                {
+                    location.Objects.Remove(pair.Key);
+                    SaveGamePatcher.Monitor.Log($"Removed invalid null object in {location.Name} ({pair.Key}) to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom item mod?)", LogLevel.Warn);
+                    removedAny = true;
+                }
+            }
+
             return removedAny;
         }
     }

From 80d5672cdb04e8cba40b085b32ffcaf1fea78552 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 31 Jul 2021 01:50:31 -0400
Subject: [PATCH 223/856] fix crash when farm name contains
 invalid-in-file-path characters (#791)

---
 docs/release-notes.md  |  1 +
 src/SMAPI/Constants.cs | 13 ++++++++++---
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 44807dcb..9e26a974 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
   * Added `removable` option to the `world_clear` console command (thanks to bladeoflight16!).
   * Fixed handling of Unicode characters in console commands.
   * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
+  * Fixed crash when creating a farm name containing characters that aren't allowed in a folder path.
 
 * For mod authors:
   * Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 9e93551c..6fb796de 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -351,9 +351,16 @@ namespace StardewModdingAPI
             DirectoryInfo folder = null;
             foreach (string saveName in new[] { rawSaveName, new string(rawSaveName.Where(char.IsLetterOrDigit).ToArray()) })
             {
-                folder = new DirectoryInfo(Path.Combine(Constants.SavesPath, $"{saveName}_{saveID}"));
-                if (folder.Exists)
-                    return folder;
+                try
+                {
+                    folder = new DirectoryInfo(Path.Combine(Constants.SavesPath, $"{saveName}_{saveID}"));
+                    if (folder.Exists)
+                        return folder;
+                }
+                catch (ArgumentException)
+                {
+                    // ignore invalid path
+                }
             }
 
             // if save doesn't exist yet, return the default one we expect to be created

From f7f49aa8dfc4a608a5c5571815263cca195dd540 Mon Sep 17 00:00:00 2001
From: bladeoflight16 <1159076+bladeoflight16@users.noreply.github.com>
Date: Sat, 31 Jul 2021 15:28:22 -0400
Subject: [PATCH 224/856] Target typed constructors are not yet supported by
 Mono. Adding explicit class name to resolve build error.

---
 src/SMAPI.Internal.Patching/PatchHelper.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Internal.Patching/PatchHelper.cs b/src/SMAPI.Internal.Patching/PatchHelper.cs
index c9758616..fc79ddf2 100644
--- a/src/SMAPI.Internal.Patching/PatchHelper.cs
+++ b/src/SMAPI.Internal.Patching/PatchHelper.cs
@@ -43,7 +43,7 @@ namespace StardewModdingAPI.Internal.Patching
         /// <param name="generics">The method generic types, or <c>null</c> if it's not generic.</param>
         public static string GetMethodString(Type type, string name, Type[] parameters = null, Type[] generics = null)
         {
-            StringBuilder str = new();
+            StringBuilder str = new StringBuilder();
 
             // type
             str.Append(type.FullName);

From db06291fdbc9a3e9f1afa65f6649e4671fff4756 Mon Sep 17 00:00:00 2001
From: bladeoflight16 <1159076+bladeoflight16@users.noreply.github.com>
Date: Sat, 31 Jul 2021 15:30:27 -0400
Subject: [PATCH 225/856] Removing duplicate import of common.targets,
 eliminates several warnings

---
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 8dc4d559..0e051c84 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -19,6 +19,4 @@
   <ItemGroup>
     <ProjectReference Include="..\SMAPI.Toolkit.CoreInterfaces\SMAPI.Toolkit.CoreInterfaces.csproj" />
   </ItemGroup>
-
-  <Import Project="..\..\build\common.targets" />
 </Project>

From c15d43049a08e73090d77cc150ac48476011a68c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 31 Jul 2021 19:22:14 -0400
Subject: [PATCH 226/856] fix map reload not correctly reloading interior doors

---
 docs/release-notes.md                     |  1 +
 src/SMAPI.sln.DotSettings                 |  1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 18 +++++++++---------
 3 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9e26a974..4f874e38 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -15,6 +15,7 @@
   * Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
   * SMAPI now intercepts `KeyNotFoundException` dictionary errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
   * Fixed error loading `.xnb` files from the local mod folder since SMAPI 3.0.
+  * Fixed reloading a map not correctly reapplying interior doors.
 
 ## 3.11.0
 Released 09 July 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/53514295).
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index 305b1c7d..9a6cad37 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -49,6 +49,7 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Netcode/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=overworld/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pastebin/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=pathfinding/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pathoschild/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=premultiplied/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=premultiply/@EntryIndexedValue">True</s:Boolean>
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 9273864e..a8686ca4 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -5,7 +5,6 @@ using System.IO;
 using System.Linq;
 using Microsoft.Xna.Framework.Graphics;
 using Netcode;
-using StardewModdingAPI.Framework;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Internal;
@@ -939,16 +938,17 @@ namespace StardewModdingAPI.Metadata
             // reload map
             location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist
             location.reloadMap();
-            location.updateWarps();
+
+            // reload interior doors
+            location.interiorDoors.Clear();
+            location.interiorDoors.ResetSharedState(); // load doors from map properties
+            location.interiorDoors.ResetLocalState(); // reapply door tiles
+
+            // reapply map changes (after reloading doors so they apply theirs too)
             location.MakeMapModifications(force: true);
 
-            // update interior doors
-            location.interiorDoors.Clear();
-            foreach (var entry in new InteriorDoorDictionary(location))
-                location.interiorDoors.Add(entry);
-
-            // update doors
-            location.doors.Clear();
+            // update for changes
+            location.updateWarps();
             location.updateDoors();
         }
 

From d688cdf8c3c852d4b11cdd046d67c4b35443cc95 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 1 Aug 2021 13:11:27 -0400
Subject: [PATCH 227/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 16 +++++++++-------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index aed619da..d526a2bb 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.11.0</Version>
+    <Version>3.12.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4f874e38..36f07129 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,20 +1,22 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.0
+01 August 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/54388616).
+
 * For players:
-  * Added automatic save recovery when custom content mods leave null objects in the save.
+  * Added save recovery when content mods leave null objects in the save (in _Error Handler_).
   * Added error if the wrong SMAPI bitness is installed (e.g. 32-bit SMAPI with 64-bit game).
   * Added error if some SMAPI files aren't updated correctly.
-  * Added `removable` option to the `world_clear` console command (thanks to bladeoflight16!).
+  * Added `removable` option to the `world_clear` console command (in _Console Commands_, thanks to bladeoflight16!).
   * Fixed handling of Unicode characters in console commands.
-  * Fixed intermittent error if a mod fetches mod-provided APIs asynchronously.
+  * Fixed intermittent error if a mod gets mod-provided APIs asynchronously.
   * Fixed crash when creating a farm name containing characters that aren't allowed in a folder path.
 
 * For mod authors:
-  * Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).
-  * SMAPI now intercepts `KeyNotFoundException` dictionary errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
-  * Fixed error loading `.xnb` files from the local mod folder since SMAPI 3.0.
+  * **Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).**
+  * SMAPI now intercepts `KeyNotFoundException` errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
+  * Fixed error loading `.xnb` files from the local mod folder.
   * Fixed reloading a map not correctly reapplying interior doors.
 
 ## 3.11.0
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 1781c40d..09684f32 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.11.0",
+    "Version": "3.12.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.11.0"
+    "MinimumApiVersion": "3.12.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 82e6152d..c83ca3d0 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.11.0",
+    "Version": "3.12.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.11.0"
+    "MinimumApiVersion": "3.12.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 6042dee4..42f1af59 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.11.0",
+    "Version": "3.12.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.11.0"
+    "MinimumApiVersion": "3.12.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 6fb796de..3877e17a 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -61,7 +61,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.11.0";
+        internal static string RawApiVersion = "3.12.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 5256b738b486aa1591c6b25b41410973f1feaf46 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 2 Aug 2021 21:14:22 -0400
Subject: [PATCH 228/856] use more reliable method to get save folder name

SMAPI now tracks the actual folder name being loaded to avoid edge cases where the folder name doesn't match the save ID.
---
 docs/release-notes.md                |  4 ++
 src/SMAPI/Constants.cs               | 31 +++-------------
 src/SMAPI/Framework/SCore.cs         |  8 ++++
 src/SMAPI/Patches/SaveGamePatcher.cs | 55 ++++++++++++++++++++++++++++
 4 files changed, 73 insertions(+), 25 deletions(-)
 create mode 100644 src/SMAPI/Patches/SaveGamePatcher.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 36f07129..eeff3347 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For mod authors:
+  * Fixed save constants not set correctly in edge cases where the folder name doesn't match the save ID.
+
 ## 3.12.0
 01 August 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/54388616).
 
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 3877e17a..bfaee70e 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
-using System.Linq;
 using System.Reflection;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Framework;
@@ -165,6 +164,9 @@ namespace StardewModdingAPI
         /// <summary>The language code for non-translated mod assets.</summary>
         internal static LocalizedContentManager.LanguageCode DefaultLanguage { get; } = LocalizedContentManager.LanguageCode.en;
 
+        /// <summary>The name of the last save file loaded by the game.</summary>
+        internal static string LastRawSaveFileName { get; set; }
+
 
         /*********
         ** Internal methods
@@ -341,30 +343,9 @@ namespace StardewModdingAPI
             if (Context.LoadStage == LoadStage.None)
                 return null;
 
-            // get basic info
-            string rawSaveName = Game1.GetSaveGameName(set_value: false);
-            ulong saveID = Context.LoadStage == LoadStage.SaveParsed
-                ? SaveGame.loaded.uniqueIDForThisGame
-                : Game1.uniqueIDForThisGame;
-
-            // get best match (accounting for rare case where folder name isn't sanitized)
-            DirectoryInfo folder = null;
-            foreach (string saveName in new[] { rawSaveName, new string(rawSaveName.Where(char.IsLetterOrDigit).ToArray()) })
-            {
-                try
-                {
-                    folder = new DirectoryInfo(Path.Combine(Constants.SavesPath, $"{saveName}_{saveID}"));
-                    if (folder.Exists)
-                        return folder;
-                }
-                catch (ArgumentException)
-                {
-                    // ignore invalid path
-                }
-            }
-
-            // if save doesn't exist yet, return the default one we expect to be created
-            return folder;
+            // get save
+            string rawSaveName = Constants.LastRawSaveFileName;
+            return new DirectoryInfo(Path.Combine(Constants.SavesPath, rawSaveName));
         }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index a34b3eff..b826789d 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -257,6 +257,7 @@ namespace StardewModdingAPI.Framework
                 MiniMonoModHotfix.Apply();
                 HarmonyPatcher.Apply("SMAPI", this.Monitor,
                     new Game1Patcher(this.Reflection, this.OnLoadStageChanged),
+                    new SaveGamePatcher(this.OnSaveFileReading),
                     new TitleMenuPatcher(this.OnLoadStageChanged)
                 );
 
@@ -1101,6 +1102,13 @@ namespace StardewModdingAPI.Framework
                 this.EventManager.ReturnedToTitle.RaiseEmpty();
         }
 
+        /// <summary>Raised before the game begins reading a save file.</summary>
+        /// <param name="fileName">The save folder name.</param>
+        internal void OnSaveFileReading(string fileName)
+        {
+            Constants.LastRawSaveFileName = fileName;
+        }
+
         /// <summary>Apply fixes to the save after it's loaded.</summary>
         private void ApplySaveFixes()
         {
diff --git a/src/SMAPI/Patches/SaveGamePatcher.cs b/src/SMAPI/Patches/SaveGamePatcher.cs
new file mode 100644
index 00000000..969c514e
--- /dev/null
+++ b/src/SMAPI/Patches/SaveGamePatcher.cs
@@ -0,0 +1,55 @@
+using System;
+using System.Diagnostics.CodeAnalysis;
+using HarmonyLib;
+using StardewModdingAPI.Internal.Patching;
+using StardewValley;
+using StardewValley.Menus;
+
+namespace StardewModdingAPI.Patches
+{
+    /// <summary>Harmony patches for <see cref="SaveGame"/> which track the last loaded save ID.</summary>
+    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    internal class SaveGamePatcher : BasePatcher
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>A callback to invoke when a save file is being loaded.</summary>
+        private static Action<string> OnSaveFileReading;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="onSaveFileReading">A callback to invoke when a save file is being loaded.</param>
+        public SaveGamePatcher(Action<string> onSaveFileReading)
+        {
+            SaveGamePatcher.OnSaveFileReading = onSaveFileReading;
+        }
+
+        /// <inheritdoc />
+        public override void Apply(Harmony harmony, IMonitor monitor)
+        {
+            harmony.Patch(
+                original: this.RequireMethod<SaveGame>(nameof(SaveGame.getLoadEnumerator)),
+                prefix: this.GetHarmonyMethod(nameof(SaveGamePatcher.Before_GetLoadEnumerator))
+            );
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>The method to call before <see cref="TitleMenu.createdNewCharacter"/>.</summary>
+        /// <returns>Returns whether to execute the original method.</returns>
+        /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
+        private static bool Before_GetLoadEnumerator(string file)
+        {
+            SaveGamePatcher.OnSaveFileReading(file);
+            return true;
+        }
+    }
+}

From 848460a34e105f08dec506e97655de7f30c6a493 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 2 Aug 2021 21:30:59 -0400
Subject: [PATCH 229/856] update compatibility list

---
 docs/release-notes.md                     | 3 +++
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 9 +++++++++
 2 files changed, 12 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index eeff3347..460b64fb 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Updated compatibility list.
+
 * For mod authors:
   * Fixed save constants not set correctly in edge cases where the folder name doesn't match the save ID.
 
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index eeda13eb..b38c1f7a 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -167,6 +167,15 @@
             "~ | StatusReasonPhrase": "split-screen mode was added in Stardew Valley 1.5"
         },
 
+        /*********
+        ** Broke in SMAPI 3.12.0
+        *********/
+        "Stardew Hack": {
+            "ID": "bcmpinc.StardewHack",
+            "~5.0.0 | Status": "AssumeBroken",
+            "~5.0.0 | StatusReasonDetails": "causes Harmony patching errors for other mods"
+        },
+
         /*********
         ** Broke in SDV 1.5 (Content Patcher packs)
         *********/

From cf261ff36ee0c96acd0a8b0b233517991740b8cf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 3 Aug 2021 12:00:15 -0400
Subject: [PATCH 230/856] increase software conflict message to warning level
 to simplify troubleshooting

---
 docs/release-notes.md        | 5 +++--
 src/SMAPI/Framework/SCore.cs | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 460b64fb..8e354585 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,13 +3,14 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * The software conflict message added in SMAPI 3.11.0 now appears as a warning to simplify troubleshooting.
   * Updated compatibility list.
 
 * For mod authors:
-  * Fixed save constants not set correctly in edge cases where the folder name doesn't match the save ID.
+  * Fixed `Constants.Save*` fields incorrect if the save's folder name and ID don't match.
 
 ## 3.12.0
-01 August 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/54388616).
+Released 01 August 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/54388616).
 
 * For players:
   * Added save recovery when content mods leave null objects in the save (in _Error Handler_).
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index b826789d..3f97bd4e 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1323,7 +1323,7 @@ namespace StardewModdingAPI.Framework
                     .ToArray();
 
                 if (installedNames.Any())
-                    this.Monitor.Log($"   Found {string.Join(" and ", installedNames)} installed, which can conflict with SMAPI. If you experience errors or crashes, try disabling that software or adding an exception for SMAPI / Stardew Valley.");
+                    this.Monitor.Log($"Found {string.Join(" and ", installedNames)} installed, which may conflict with SMAPI. If you experience errors or crashes, try disabling that software or adding an exception for SMAPI and Stardew Valley.", LogLevel.Warn);
                 else
                     this.Monitor.Log("   None found!");
             }

From ef1eff669d8a6a277c12c0b84e16402de7f026d4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 3 Aug 2021 13:05:48 -0400
Subject: [PATCH 231/856] update compatibility list

---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 52 +++++++++++++++++------
 1 file changed, 40 insertions(+), 12 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index b38c1f7a..a5cfadb4 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -175,6 +175,46 @@
             "~5.0.0 | Status": "AssumeBroken",
             "~5.0.0 | StatusReasonDetails": "causes Harmony patching errors for other mods"
         },
+        "Always Scroll Map": {
+            "ID": "bcmpinc.AlwaysScrollMap",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Fix Animal Tools": {
+            "ID": "bcmpinc.FixAnimalTools",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Harvest With Scythe (bcmpinc)": {
+            "ID": "bcmpinc.HarvestWithScythe",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Grass Growth": {
+            "ID": "bcmpinc.GrassGrowth",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Tilled Soil Decay": {
+            "ID": "bcmpinc.TilledSoilDecay",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Movement Speed": {
+            "ID": "bcmpinc.MovementSpeed",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Tree Spread": {
+            "ID": "bcmpinc.TreeSpread",
+            "~4.2.0 | Status": "AssumeBroken",
+            "~4.2.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Wear More Rings": {
+            "ID": "bcmpinc.WearMoreRings",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
 
         /*********
         ** Broke in SDV 1.5 (Content Patcher packs)
@@ -231,18 +271,6 @@
             "~1.0.8 | StatusReasonDetails": "crashes on save load"
         },
 
-        "Movement Speed": {
-            "ID": "bcmpinc.MovementSpeed",
-            "~3.0.0 | Status": "AssumeBroken",
-            "~3.0.0 | StatusReasonDetails": "broken due to transpiler errors"
-        },
-
-        "Tree Spread": {
-            "ID": "bcmpinc.TreeSpread",
-            "~3.0.0 | Status": "AssumeBroken",
-            "~3.0.0 | StatusReasonDetails": "broken due to transpiler errors"
-        },
-
         "TreeTransplant": {
             "ID": "TreeTransplant",
             "~1.0.9 | Status": "AssumeBroken",

From 6b0d13be7c8383785cc3152d502959b15468b234 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 3 Aug 2021 19:03:51 -0400
Subject: [PATCH 232/856] fix Mono.Cecil failing to resolve references to SMAPI
 in some edge cases

---
 docs/release-notes.md                            | 1 +
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs | 1 +
 2 files changed, 2 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8e354585..22eecc3a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For players:
   * The software conflict message added in SMAPI 3.11.0 now appears as a warning to simplify troubleshooting.
+  * Fixed error loading older Harmony mods for some players who launch the unofficial 64-bit Stardew Valley through Steam.
   * Updated compatibility list.
 
 * For mod authors:
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 3606eb66..2b71038a 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -61,6 +61,7 @@ namespace StardewModdingAPI.Framework.ModLoading
             this.AssemblyDefinitionResolver = this.TrackForDisposal(new AssemblyDefinitionResolver());
             this.AssemblyDefinitionResolver.AddSearchDirectory(Constants.ExecutionPath);
             this.AssemblyDefinitionResolver.AddSearchDirectory(Constants.InternalFilesPath);
+            this.AssemblyDefinitionResolver.Add(AssemblyDefinition.ReadAssembly(typeof(SGame).Assembly.Location)); // for some reason Mono.Cecil can't resolve SMAPI in very specific cases involving unofficial 64-bit Stardew Valley when launched through Steam (for some players only)
 
             // generate type => assembly lookup for types which should be rewritten
             this.TypeAssemblies = new Dictionary<string, Assembly>();

From e73f5a10c7682719ea2e5d0805125010f69e896c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 3 Aug 2021 19:04:15 -0400
Subject: [PATCH 233/856] add PlatoTK to compatibility list

---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index a5cfadb4..7dff16c4 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -170,6 +170,11 @@
         /*********
         ** Broke in SMAPI 3.12.0
         *********/
+        "PlatoTK": {
+            "ID": "Platonymous.PlatoTK",
+            "~1.9.3 | Status": "AssumeBroken",
+            "~1.9.3 | StatusReasonDetails": "fails to load with 'ReflectionTypeLoadException' error"
+        },
         "Stardew Hack": {
             "ID": "bcmpinc.StardewHack",
             "~5.0.0 | Status": "AssumeBroken",

From 1bb51b2c41bf5acdffb8e25c37187e9bdf9d3dd4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 3 Aug 2021 19:11:26 -0400
Subject: [PATCH 234/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 8 +++++---
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index d526a2bb..f2614998 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.0</Version>
+    <Version>3.12.1</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 22eecc3a..16744b24 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,10 +1,12 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.1
+Released 03 August 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
-  * The software conflict message added in SMAPI 3.11.0 now appears as a warning to simplify troubleshooting.
-  * Fixed error loading older Harmony mods for some players who launch the unofficial 64-bit Stardew Valley through Steam.
+  * The software conflict message is now shown as a warning to simplify troubleshooting.
+  * Fixed error loading older Harmony mods for some Windows players using unofficial 64-bit Stardew Valley.
   * Updated compatibility list.
 
 * For mod authors:
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 09684f32..7023180b 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.0",
+    "Version": "3.12.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.0"
+    "MinimumApiVersion": "3.12.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index c83ca3d0..8aa2a6a4 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.0",
+    "Version": "3.12.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.0"
+    "MinimumApiVersion": "3.12.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 42f1af59..dbd65cbe 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.0",
+    "Version": "3.12.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.0"
+    "MinimumApiVersion": "3.12.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index bfaee70e..05800970 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -60,7 +60,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.0";
+        internal static string RawApiVersion = "3.12.1";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 807dcfec7723156a36524d5f1889b5f3208d97cf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 4 Aug 2021 18:02:15 -0400
Subject: [PATCH 235/856] undo Constants.Save* changes in 3.12.1

---
 docs/release-notes.md                |  8 ++++
 src/SMAPI/Constants.cs               | 31 +++++++++++++---
 src/SMAPI/Framework/SCore.cs         |  8 ----
 src/SMAPI/Patches/SaveGamePatcher.cs | 55 ----------------------------
 4 files changed, 33 insertions(+), 69 deletions(-)
 delete mode 100644 src/SMAPI/Patches/SaveGamePatcher.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 16744b24..25a0b4fa 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,14 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Fixed error creating a new save or joining a multiplayer world in 3.12.1.
+
+* For mod authors:
+  * Reversed the `Constants.Save*` fix in SMAPI 3.12.1.  
+    _The change caused a number of other issues, and was only needed for edge cases where the save folder was invalid._
+
 ## 3.12.1
 Released 03 August 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 05800970..c3105202 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Linq;
 using System.Reflection;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Framework;
@@ -164,9 +165,6 @@ namespace StardewModdingAPI
         /// <summary>The language code for non-translated mod assets.</summary>
         internal static LocalizedContentManager.LanguageCode DefaultLanguage { get; } = LocalizedContentManager.LanguageCode.en;
 
-        /// <summary>The name of the last save file loaded by the game.</summary>
-        internal static string LastRawSaveFileName { get; set; }
-
 
         /*********
         ** Internal methods
@@ -343,9 +341,30 @@ namespace StardewModdingAPI
             if (Context.LoadStage == LoadStage.None)
                 return null;
 
-            // get save
-            string rawSaveName = Constants.LastRawSaveFileName;
-            return new DirectoryInfo(Path.Combine(Constants.SavesPath, rawSaveName));
+            // get basic info
+            string rawSaveName = Game1.GetSaveGameName(set_value: false);
+            ulong saveID = Context.LoadStage == LoadStage.SaveParsed
+                ? SaveGame.loaded.uniqueIDForThisGame
+                : Game1.uniqueIDForThisGame;
+
+            // get best match (accounting for rare case where folder name isn't sanitized)
+            DirectoryInfo folder = null;
+            foreach (string saveName in new[] { rawSaveName, new string(rawSaveName.Where(char.IsLetterOrDigit).ToArray()) })
+            {
+                try
+                {
+                    folder = new DirectoryInfo(Path.Combine(Constants.SavesPath, $"{saveName}_{saveID}"));
+                    if (folder.Exists)
+                        return folder;
+                }
+                catch (ArgumentException)
+                {
+                    // ignore invalid path
+                }
+            }
+
+            // if save doesn't exist yet, return the default one we expect to be created
+            return folder;
         }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 3f97bd4e..5fb4aa03 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -257,7 +257,6 @@ namespace StardewModdingAPI.Framework
                 MiniMonoModHotfix.Apply();
                 HarmonyPatcher.Apply("SMAPI", this.Monitor,
                     new Game1Patcher(this.Reflection, this.OnLoadStageChanged),
-                    new SaveGamePatcher(this.OnSaveFileReading),
                     new TitleMenuPatcher(this.OnLoadStageChanged)
                 );
 
@@ -1102,13 +1101,6 @@ namespace StardewModdingAPI.Framework
                 this.EventManager.ReturnedToTitle.RaiseEmpty();
         }
 
-        /// <summary>Raised before the game begins reading a save file.</summary>
-        /// <param name="fileName">The save folder name.</param>
-        internal void OnSaveFileReading(string fileName)
-        {
-            Constants.LastRawSaveFileName = fileName;
-        }
-
         /// <summary>Apply fixes to the save after it's loaded.</summary>
         private void ApplySaveFixes()
         {
diff --git a/src/SMAPI/Patches/SaveGamePatcher.cs b/src/SMAPI/Patches/SaveGamePatcher.cs
deleted file mode 100644
index 969c514e..00000000
--- a/src/SMAPI/Patches/SaveGamePatcher.cs
+++ /dev/null
@@ -1,55 +0,0 @@
-using System;
-using System.Diagnostics.CodeAnalysis;
-using HarmonyLib;
-using StardewModdingAPI.Internal.Patching;
-using StardewValley;
-using StardewValley.Menus;
-
-namespace StardewModdingAPI.Patches
-{
-    /// <summary>Harmony patches for <see cref="SaveGame"/> which track the last loaded save ID.</summary>
-    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
-    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class SaveGamePatcher : BasePatcher
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>A callback to invoke when a save file is being loaded.</summary>
-        private static Action<string> OnSaveFileReading;
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="onSaveFileReading">A callback to invoke when a save file is being loaded.</param>
-        public SaveGamePatcher(Action<string> onSaveFileReading)
-        {
-            SaveGamePatcher.OnSaveFileReading = onSaveFileReading;
-        }
-
-        /// <inheritdoc />
-        public override void Apply(Harmony harmony, IMonitor monitor)
-        {
-            harmony.Patch(
-                original: this.RequireMethod<SaveGame>(nameof(SaveGame.getLoadEnumerator)),
-                prefix: this.GetHarmonyMethod(nameof(SaveGamePatcher.Before_GetLoadEnumerator))
-            );
-        }
-
-
-        /*********
-        ** Private methods
-        *********/
-        /// <summary>The method to call before <see cref="TitleMenu.createdNewCharacter"/>.</summary>
-        /// <returns>Returns whether to execute the original method.</returns>
-        /// <remarks>This method must be static for Harmony to work correctly. See the Harmony documentation before renaming arguments.</remarks>
-        private static bool Before_GetLoadEnumerator(string file)
-        {
-            SaveGamePatcher.OnSaveFileReading(file);
-            return true;
-        }
-    }
-}

From b6f3ecc143b3a76240775fe75c9b7b643433bbe5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 4 Aug 2021 18:05:05 -0400
Subject: [PATCH 236/856] fix error when error-handling invalid
 ReflectionTypeLoadException errors

---
 docs/release-notes.md                     | 1 +
 src/SMAPI.Internal/ExceptionExtensions.cs | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 25a0b4fa..9075a471 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,7 @@
 * For mod authors:
   * Reversed the `Constants.Save*` fix in SMAPI 3.12.1.  
     _The change caused a number of other issues, and was only needed for edge cases where the save folder was invalid._
+  * Fixed `NullReferenceException` in SMAPI's error-handling when trying to handle an invalid `ReflectionTypeLoadException`.
 
 ## 3.12.1
 Released 03 August 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Internal/ExceptionExtensions.cs b/src/SMAPI.Internal/ExceptionExtensions.cs
index d7a2252b..5f1ee1fa 100644
--- a/src/SMAPI.Internal/ExceptionExtensions.cs
+++ b/src/SMAPI.Internal/ExceptionExtensions.cs
@@ -19,9 +19,9 @@ namespace StardewModdingAPI.Internal
                     return $"Failed loading type '{ex.TypeName}': {exception}";
 
                 case ReflectionTypeLoadException ex:
-                    string summary = exception.ToString();
-                    foreach (Exception childEx in ex.LoaderExceptions)
-                        summary += $"\n\n{childEx.GetLogSummary()}";
+                    string summary = ex.ToString();
+                    foreach (Exception childEx in ex.LoaderExceptions ?? new Exception[0])
+                        summary += $"\n\n{childEx?.GetLogSummary()}";
                     return summary;
 
                 default:

From b6e058c322f3b904a047ba09cb1701a1bb812e47 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 4 Aug 2021 18:34:29 -0400
Subject: [PATCH 237/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 8 +++++---
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index f2614998..498ec7af 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.1</Version>
+    <Version>3.12.2</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9075a471..4e9dacbf 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,13 +1,15 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.2
+Released 04 August 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
   * Fixed error creating a new save or joining a multiplayer world in 3.12.1.
 
 * For mod authors:
-  * Reversed the `Constants.Save*` fix in SMAPI 3.12.1.  
-    _The change caused a number of other issues, and was only needed for edge cases where the save folder was invalid._
+  * Reverted the `Constants.Save*` fix in SMAPI 3.12.1.  
+    _The change caused a number of other issues, and is only needed for rare cases where the save folder was invalid. This may be revisited in a future version instead._
   * Fixed `NullReferenceException` in SMAPI's error-handling when trying to handle an invalid `ReflectionTypeLoadException`.
 
 ## 3.12.1
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 7023180b..6b49cd5f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.1",
+    "Version": "3.12.2",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.1"
+    "MinimumApiVersion": "3.12.2"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 8aa2a6a4..7759d1d5 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.1",
+    "Version": "3.12.2",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.1"
+    "MinimumApiVersion": "3.12.2"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index dbd65cbe..1e5b8b97 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.1",
+    "Version": "3.12.2",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.1"
+    "MinimumApiVersion": "3.12.2"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index c3105202..6cbdeb8e 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -61,7 +61,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.1";
+        internal static string RawApiVersion = "3.12.2";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 94d41cd67a1591fff01c17e3aece48e1f19d297b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 5 Aug 2021 12:21:18 -0400
Subject: [PATCH 238/856] correct release date

---
 docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4e9dacbf..20fdd2c1 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,7 +2,7 @@
 
 # Release notes
 ## 3.12.2
-Released 04 August 2021 for Stardew Valley 1.5.4 or later.
+Released 05 August 2021 for Stardew Valley 1.5.4 or later.
 
 * For players:
   * Fixed error creating a new save or joining a multiplayer world in 3.12.1.

From 5e16ed0eea2cae21badd525afa0d464700bb8647 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 5 Aug 2021 14:28:29 -0400
Subject: [PATCH 239/856] prevent weird null reference exception in
 error-handling

---
 docs/release-notes.md                     |  4 ++++
 src/SMAPI.Internal/ExceptionExtensions.cs | 27 ++++++++++++++---------
 2 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 20fdd2c1..8c98af5d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For mod authors:
+  * Fixed rare `NullReferenceException` in SMAPI's error-handling.
+
 ## 3.12.2
 Released 05 August 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Internal/ExceptionExtensions.cs b/src/SMAPI.Internal/ExceptionExtensions.cs
index 5f1ee1fa..d8189048 100644
--- a/src/SMAPI.Internal/ExceptionExtensions.cs
+++ b/src/SMAPI.Internal/ExceptionExtensions.cs
@@ -13,19 +13,26 @@ namespace StardewModdingAPI.Internal
         /// <param name="exception">The error to summarize.</param>
         public static string GetLogSummary(this Exception exception)
         {
-            switch (exception)
+            try
             {
-                case TypeLoadException ex:
-                    return $"Failed loading type '{ex.TypeName}': {exception}";
+                switch (exception)
+                {
+                    case TypeLoadException ex:
+                        return $"Failed loading type '{ex.TypeName}': {exception}";
 
-                case ReflectionTypeLoadException ex:
-                    string summary = ex.ToString();
-                    foreach (Exception childEx in ex.LoaderExceptions ?? new Exception[0])
-                        summary += $"\n\n{childEx?.GetLogSummary()}";
-                    return summary;
+                    case ReflectionTypeLoadException ex:
+                        string summary = ex.ToString();
+                        foreach (Exception childEx in ex.LoaderExceptions ?? new Exception[0])
+                            summary += $"\n\n{childEx?.GetLogSummary()}";
+                        return summary;
 
-                default:
-                    return exception.ToString();
+                    default:
+                        return exception?.ToString() ?? $"<null exception>\n{Environment.StackTrace}";
+                }
+            }
+            catch (Exception ex)
+            {
+                throw new InvalidOperationException($"Failed handling {exception?.GetType().FullName} (original message: {exception?.Message})", ex);
             }
         }
 

From 885808fb66233caf3057f0baa6368f4763a8eade Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 Aug 2021 00:21:28 -0400
Subject: [PATCH 240/856] move assembly resolver setup into Constants to
 centralize hardcoded logic

---
 src/SMAPI/Constants.cs                           | 16 ++++++++++++++++
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs |  4 +---
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 6cbdeb8e..7f633a46 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Reflection;
+using Mono.Cecil;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Framework;
 using StardewModdingAPI.Framework.ModLoading;
@@ -229,6 +230,21 @@ namespace StardewModdingAPI
             }
         }
 
+        /// <summary>Configure the Mono.Cecil assembly resolver.</summary>
+        /// <param name="resolver">The assembly resolver.</param>
+        internal static void ConfigureAssemblyResolver(AssemblyDefinitionResolver resolver)
+        {
+            // add search paths
+            resolver.AddSearchDirectory(Constants.ExecutionPath);
+            resolver.AddSearchDirectory(Constants.InternalFilesPath);
+
+            // add SMAPI explicitly
+            // Normally this would be handled automatically by the search paths, but for some reason there's a specific
+            // case involving unofficial 64-bit Stardew Valley when launched through Steam (for some players only)
+            // where Mono.Cecil can't resolve references to SMAPI.
+            resolver.Add(AssemblyDefinition.ReadAssembly(typeof(SGame).Assembly.Location));
+        }
+
         /// <summary>Get metadata for mapping assemblies to the current platform.</summary>
         /// <param name="targetPlatform">The target game platform.</param>
         /// <param name="framework">The game framework running the game.</param>
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 2b71038a..86b43990 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -59,9 +59,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
             // init resolver
             this.AssemblyDefinitionResolver = this.TrackForDisposal(new AssemblyDefinitionResolver());
-            this.AssemblyDefinitionResolver.AddSearchDirectory(Constants.ExecutionPath);
-            this.AssemblyDefinitionResolver.AddSearchDirectory(Constants.InternalFilesPath);
-            this.AssemblyDefinitionResolver.Add(AssemblyDefinition.ReadAssembly(typeof(SGame).Assembly.Location)); // for some reason Mono.Cecil can't resolve SMAPI in very specific cases involving unofficial 64-bit Stardew Valley when launched through Steam (for some players only)
+            Constants.ConfigureAssemblyResolver(this.AssemblyDefinitionResolver);
 
             // generate type => assembly lookup for types which should be rewritten
             this.TypeAssemblies = new Dictionary<string, Assembly>();

From 976c66537c9f4493ce859c574675bb8651b5323f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 Aug 2021 00:24:20 -0400
Subject: [PATCH 241/856] fix edge case where Netcode references aren't
 rewritten correctly

---
 docs/release-notes.md                            |  1 +
 src/SMAPI/Constants.cs                           | 11 +++++++++++
 .../ModLoading/AssemblyDefinitionResolver.cs     | 16 +++++++++++-----
 3 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8c98af5d..9e42a847 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For mod authors:
   * Fixed rare `NullReferenceException` in SMAPI's error-handling.
+  * Internal changes to prepare for upcoming releases.
 
 ## 3.12.2
 Released 05 August 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 7f633a46..de6b63d6 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -243,6 +243,17 @@ namespace StardewModdingAPI
             // case involving unofficial 64-bit Stardew Valley when launched through Steam (for some players only)
             // where Mono.Cecil can't resolve references to SMAPI.
             resolver.Add(AssemblyDefinition.ReadAssembly(typeof(SGame).Assembly.Location));
+
+            // make sure game assembly names can be resolved
+            // The game assembly can have one of three names depending how the mod was compiled:
+            //   - 'StardewValley': assembly name on Linux/macOS;
+            //   - 'Stardew Valley': assembly name on Windows;
+            //   - 'Netcode': an assembly that's separate on Windows only.
+            resolver.Add(AssemblyDefinition.ReadAssembly(typeof(Game1).Assembly.Location), "StardewValley", "Stardew Valley"
+#if !SMAPI_FOR_WINDOWS
+                , "Netcode"
+#endif
+            );
         }
 
         /// <summary>Get metadata for mapping assemblies to the current platform.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
index aefb0126..b3415609 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
@@ -21,11 +21,17 @@ namespace StardewModdingAPI.Framework.ModLoading
         public void Add(params AssemblyDefinition[] assemblies)
         {
             foreach (AssemblyDefinition assembly in assemblies)
-            {
-                this.RegisterAssembly(assembly);
-                this.Lookup[assembly.Name.Name] = assembly;
-                this.Lookup[assembly.Name.FullName] = assembly;
-            }
+                this.Add(assembly, assembly.Name.Name, assembly.Name.FullName);
+        }
+
+        /// <summary>Add known assemblies to the resolver.</summary>
+        /// <param name="assembly">The assembly to add.</param>
+        /// <param name="names">The assembly names for which it should be returned.</param>
+        public void Add(AssemblyDefinition assembly, params string[] names)
+        {
+            this.RegisterAssembly(assembly);
+            foreach (string name in names)
+                this.Lookup[name] = assembly;
         }
 
         /// <summary>Resolve an assembly reference.</summary>

From a4c6c6168405bb0441a40e4f6f4e86dfa46a76b2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 Aug 2021 00:32:19 -0400
Subject: [PATCH 242/856] enable parallel analyzer execution

---
 docs/technical/mod-package.md                 | 33 ++++++++++---------
 .../NetFieldAnalyzer.cs                       |  3 ++
 .../ObsoleteFieldAnalyzer.cs                  |  3 ++
 3 files changed, 24 insertions(+), 15 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 91da971b..7eefc7a4 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -365,7 +365,10 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
-## 3.3
+## Upcoming release
+* Improved analyzer performance by enabling parallel execution.
+
+## 3.3.0
 Released 30 March 2021.
 
 * Added a build warning when the mod isn't compiled for `Any CPU`.
@@ -385,19 +388,19 @@ Released 11 September 2020.
 * Added more detailed logging.
 * Fixed _path's format is not supported_ error when using default `Mods` path in 3.2.
 
-### 3.2
+### 3.2.0
 Released 07 September 2020.
 
 * Added option to change `Mods` folder path.
 * Rewrote documentation to make it easier to read.
 
-### 3.1
+### 3.1.0
 Released 01 February 2020.
 
 * Added support for semantic versioning 2.0.
 * `0Harmony.dll` is now ignored if the mod references Harmony directly (it's bundled with SMAPI).
 
-### 3.0
+### 3.0.0
 Released 26 November 2019.
 
 * Updated for SMAPI 3.0 and Stardew Valley 1.4.
@@ -412,14 +415,14 @@ Released 26 November 2019.
 * Dropped support for older versions of SMAPI and Visual Studio.
 * Migrated package icon to NuGet's new format.
 
-### 2.2
+### 2.2.0
 Released 28 October 2018.
 
 * Added support for SMAPI 2.8+ (still compatible with earlier versions).
 * Added default game paths for 32-bit Windows.
 * Fixed valid manifests marked invalid in some cases.
 
-### 2.1
+### 2.1.0
 Released 27 July 2018.
 
 * Added support for Stardew Valley 1.3.
@@ -439,7 +442,7 @@ Released 11 October 2017.
 
 * Fixed mod deploy failing to create subfolders if they don't already exist.
 
-### 2.0
+### 2.0.0
 Released 11 October 2017.
 
 * Added: mods are now copied into the `Mods` folder automatically (configurable).
@@ -457,7 +460,7 @@ Released 28 July 2017.
 * The manifest/i18n files in the project now take precedence over those in the build output if both
   are present.
 
-### 1.7
+### 1.7.0
 Released 28 July 2017.
 
 * Added option to create release zips on build.
@@ -474,19 +477,19 @@ Released 09 July 2017.
 
 * Improved crossplatform game path detection.
 
-### 1.6
+### 1.6.0
 Released 05 June 2017.
 
 * Added support for deploying mod files into `Mods` automatically.
 * Added a build error if a game folder is found, but doesn't contain Stardew Valley or SMAPI.
 
-### 1.5
+### 1.5.0
 Released 23 January 2017.
 
 * Added support for setting a custom game path globally.
 * Added default GOG path on macOS.
 
-### 1.4
+### 1.4.0
 Released 11 January 2017.
 
 * Fixed detection of non-default game paths on 32-bit Windows.
@@ -494,22 +497,22 @@ Released 11 January 2017.
 * Removed support for overriding the target platform (no longer needed since SMAPI crossplatforms
   mods automatically).
 
-### 1.3
+### 1.3.0
 Released 31 December 2016.
 
 * Added support for non-default game paths on Windows.
 
-### 1.2
+### 1.2.0
 Released 24 October 2016.
 
 * Exclude game binaries from mod build output.
 
-### 1.1
+### 1.1.0
 Released 21 October 2016.
 
 * Added support for overriding the target platform.
 
-### 1.0
+### 1.0.0
 Released 21 October 2016.
 
 * Initial release.
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
index a9b981bd..1efc1616 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
@@ -174,6 +174,9 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
         /// <param name="context">The analysis context.</param>
         public override void Initialize(AnalysisContext context)
         {
+            context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.Analyze | GeneratedCodeAnalysisFlags.ReportDiagnostics);
+            context.EnableConcurrentExecution();
+
             context.RegisterSyntaxNodeAction(
                 this.AnalyzeMemberAccess,
                 SyntaxKind.SimpleMemberAccessExpression,
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
index d071f0c1..722d5227 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
@@ -56,6 +56,9 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
         /// <param name="context">The analysis context.</param>
         public override void Initialize(AnalysisContext context)
         {
+            context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.Analyze | GeneratedCodeAnalysisFlags.ReportDiagnostics);
+            context.EnableConcurrentExecution();
+
             context.RegisterSyntaxNodeAction(
                 this.AnalyzeObsoleteFields,
                 SyntaxKind.SimpleMemberAccessExpression,

From 6cf7c49f34eac8edd18012d41d1f49a149fb1f5a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 15 Aug 2021 01:25:56 -0400
Subject: [PATCH 243/856] add GetInAllLocales to translation API

---
 docs/release-notes.md                         |  1 +
 .../Framework/ModHelpers/TranslationHelper.cs |  6 ++
 src/SMAPI/Framework/Translator.cs             | 65 +++++++++++++++----
 src/SMAPI/ITranslationHelper.cs               |  7 +-
 4 files changed, 67 insertions(+), 12 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9e42a847..409c4bd5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For mod authors:
+  * Added `GetInAllLocales` method in translation API, to get a translation in every available locale.
   * Fixed rare `NullReferenceException` in SMAPI's error-handling.
   * Internal changes to prepare for upcoming releases.
 
diff --git a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
index a88ca9c9..869664fe 100644
--- a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
@@ -55,6 +55,12 @@ namespace StardewModdingAPI.Framework.ModHelpers
             return this.Translator.Get(key, tokens);
         }
 
+        /// <inheritdoc />
+        public IDictionary<string, Translation> GetInAllLocales(string key, bool withFallback = false)
+        {
+            return this.Translator.GetInAllLocales(key, withFallback);
+        }
+
         /// <summary>Set the translations to use.</summary>
         /// <param name="translations">The translations to use.</param>
         internal TranslationHelper SetTranslations(IDictionary<string, IDictionary<string, string>> translations)
diff --git a/src/SMAPI/Framework/Translator.cs b/src/SMAPI/Framework/Translator.cs
index 11ec983b..4492b17f 100644
--- a/src/SMAPI/Framework/Translator.cs
+++ b/src/SMAPI/Framework/Translator.cs
@@ -46,18 +46,10 @@ namespace StardewModdingAPI.Framework
             this.LocaleEnum = localeEnum;
 
             this.ForLocale = new Dictionary<string, Translation>(StringComparer.OrdinalIgnoreCase);
-            foreach (string next in this.GetRelevantLocales(this.Locale))
+            foreach (string key in this.GetAllKeysRaw())
             {
-                // skip if locale not defined
-                if (!this.All.TryGetValue(next, out IDictionary<string, string> translations))
-                    continue;
-
-                // add missing translations
-                foreach (var pair in translations)
-                {
-                    if (!this.ForLocale.ContainsKey(pair.Key))
-                        this.ForLocale.Add(pair.Key, new Translation(this.Locale, pair.Key, pair.Value));
-                }
+                string text = this.GetRaw(key, locale, withFallback: true);
+                this.ForLocale.Add(key, new Translation(this.Locale, key, text));
             }
         }
 
@@ -83,6 +75,25 @@ namespace StardewModdingAPI.Framework
             return this.Get(key).Tokens(tokens);
         }
 
+        /// <summary>Get a translation in every locale for which it's defined.</summary>
+        /// <param name="key">The translation key.</param>
+        /// <param name="withFallback">Whether to add duplicate translations for locale fallback. For example, if a translation is defined in <c>default.json</c> but not <c>fr.json</c>, setting this to true will add a <c>fr</c> entry which duplicates the default text.</param>
+        public IDictionary<string, Translation> GetInAllLocales(string key, bool withFallback)
+        {
+            IDictionary<string, Translation> translations = new Dictionary<string, Translation>();
+
+            foreach (var localeSet in this.All)
+            {
+                string locale = localeSet.Key;
+                string text = this.GetRaw(key, locale, withFallback);
+
+                if (text != null)
+                    translations[locale] = new Translation(locale, key, text);
+            }
+
+            return translations;
+        }
+
         /// <summary>Set the translations to use.</summary>
         /// <param name="translations">The translations to use.</param>
         internal Translator SetTranslations(IDictionary<string, IDictionary<string, string>> translations)
@@ -102,6 +113,38 @@ namespace StardewModdingAPI.Framework
         /*********
         ** Private methods
         *********/
+        /// <summary>Get all translation keys in the underlying translation data, ignoring the <see cref="ForLocale"/> cache.</summary>
+        private IEnumerable<string> GetAllKeysRaw()
+        {
+            return new HashSet<string>(
+                this.All.SelectMany(p => p.Value.Keys),
+                StringComparer.OrdinalIgnoreCase
+            );
+        }
+
+        /// <summary>Get a translation from the underlying translation data, ignoring the <see cref="ForLocale"/> cache.</summary>
+        /// <param name="key">The translation key.</param>
+        /// <param name="locale">The locale to get.</param>
+        /// <param name="withFallback">Whether to add duplicate translations for locale fallback. For example, if a translation is defined in <c>default.json</c> but not <c>fr.json</c>, setting this to true will add a <c>fr</c> entry which duplicates the default text.</param>
+        private string GetRaw(string key, string locale, bool withFallback)
+        {
+            foreach (string next in this.GetRelevantLocales(locale))
+            {
+                string translation = null;
+                bool hasTranslation =
+                    this.All.TryGetValue(next, out IDictionary<string, string> translations)
+                    && translations.TryGetValue(key, out translation);
+
+                if (hasTranslation)
+                    return translation;
+
+                if (!withFallback)
+                    break;
+            }
+
+            return null;
+        }
+
         /// <summary>Get the locales which can provide translations for the given locale, in precedence order.</summary>
         /// <param name="locale">The locale for which to find valid locales.</param>
         private IEnumerable<string> GetRelevantLocales(string locale)
diff --git a/src/SMAPI/ITranslationHelper.cs b/src/SMAPI/ITranslationHelper.cs
index c4b72444..b30d9b14 100644
--- a/src/SMAPI/ITranslationHelper.cs
+++ b/src/SMAPI/ITranslationHelper.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using StardewValley;
 
 namespace StardewModdingAPI
@@ -30,5 +30,10 @@ namespace StardewModdingAPI
         /// <param name="key">The translation key.</param>
         /// <param name="tokens">An object containing token key/value pairs. This can be an anonymous object (like <c>new { value = 42, name = "Cranberries" }</c>), a dictionary, or a class instance.</param>
         Translation Get(string key, object tokens);
+
+        /// <summary>Get a translation in every locale for which it's defined.</summary>
+        /// <param name="key">The translation key.</param>
+        /// <param name="withFallback">Whether to add duplicate translations for locale fallback. For example, if a translation is defined in <c>default.json</c> but not <c>fr.json</c>, setting this to true will add a <c>fr</c> entry which duplicates the default text.</param>
+        IDictionary<string, Translation> GetInAllLocales(string key, bool withFallback = false);
     }
 }

From c20fcec169d75b395636b06adcbec8d5101447fd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 16 Aug 2021 17:21:44 -0400
Subject: [PATCH 244/856] expand data helper docs (#799)

---
 src/SMAPI/IDataHelper.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/IDataHelper.cs b/src/SMAPI/IDataHelper.cs
index 252030bd..4922c8da 100644
--- a/src/SMAPI/IDataHelper.cs
+++ b/src/SMAPI/IDataHelper.cs
@@ -38,7 +38,7 @@ namespace StardewModdingAPI
         /// <summary>Save arbitrary data to the current save slot. This is only possible if a save has been loaded, and the data will be lost if the player exits without saving the current day.</summary>
         /// <typeparam name="TModel">The model type. This should be a plain class that has public properties for the data you want. The properties can be complex types.</typeparam>
         /// <param name="key">The unique key identifying the data.</param>
-        /// <param name="data">The arbitrary data to save.</param>
+        /// <param name="data">The arbitrary data to save, or <c>null</c> to remove the entry.</param>
         /// <exception cref="InvalidOperationException">The player hasn't loaded a save file yet or isn't the main player.</exception>
         void WriteSaveData<TModel>(string key, TModel data) where TModel : class;
 
@@ -55,7 +55,7 @@ namespace StardewModdingAPI
         /// <summary>Save arbitrary data to the local computer, synchronised by GOG/Steam if applicable.</summary>
         /// <typeparam name="TModel">The model type. This should be a plain class that has public properties for the data you want. The properties can be complex types.</typeparam>
         /// <param name="key">The unique key identifying the data.</param>
-        /// <param name="data">The arbitrary data to save.</param>
+        /// <param name="data">The arbitrary data to save, or <c>null</c> to delete the file.</param>
         void WriteGlobalData<TModel>(string key, TModel data) where TModel : class;
     }
 }

From 68e629f17c349b685ef3c4836552adcbed0c4976 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 16 Aug 2021 17:22:44 -0400
Subject: [PATCH 245/856] fix data helper's WriteJsonFile not deleting file if
 data is null (#799)

---
 docs/release-notes.md                        | 5 +++--
 src/SMAPI/Framework/ModHelpers/DataHelper.cs | 6 +++++-
 src/SMAPI/IDataHelper.cs                     | 2 +-
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 409c4bd5..d0b794ee 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,8 +3,9 @@
 # Release notes
 ## Upcoming release
 * For mod authors:
-  * Added `GetInAllLocales` method in translation API, to get a translation in every available locale.
-  * Fixed rare `NullReferenceException` in SMAPI's error-handling.
+  * Added `helper.Translation.GetInAllLocales` to get a translation in every available locale.
+  * Fixed `helper.Data.WriteJsonFile` not deleting the file if the model is null, unlike the other `Write*` methods.
+  * Fixed error-handling for `StackOverflowException` thrown on Linux/macOS.
   * Internal changes to prepare for upcoming releases.
 
 ## 3.12.2
diff --git a/src/SMAPI/Framework/ModHelpers/DataHelper.cs b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
index 0fe3209f..4cbfd73f 100644
--- a/src/SMAPI/Framework/ModHelpers/DataHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
@@ -58,7 +58,11 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 throw new InvalidOperationException($"You must call {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.WriteJsonFile)} with a relative path (without directory climbing).");
 
             path = Path.Combine(this.ModFolderPath, PathUtilities.NormalizePath(path));
-            this.JsonHelper.WriteJsonFile(path, data);
+
+            if (data != null)
+                this.JsonHelper.WriteJsonFile(path, data);
+            else
+                File.Delete(path);
         }
 
         /****
diff --git a/src/SMAPI/IDataHelper.cs b/src/SMAPI/IDataHelper.cs
index 4922c8da..901266d7 100644
--- a/src/SMAPI/IDataHelper.cs
+++ b/src/SMAPI/IDataHelper.cs
@@ -21,7 +21,7 @@ namespace StardewModdingAPI
         /// <summary>Save data to a JSON file in the mod's folder.</summary>
         /// <typeparam name="TModel">The model type. This should be a plain class that has public properties for the data you want. The properties can be complex types.</typeparam>
         /// <param name="path">The file path relative to the mod folder.</param>
-        /// <param name="data">The arbitrary data to save.</param>
+        /// <param name="data">The arbitrary data to save, or <c>null</c> to delete the file.</param>
         /// <exception cref="InvalidOperationException">The <paramref name="path"/> is not relative or contains directory climbing (../).</exception>
         void WriteJsonFile<TModel>(string path, TModel data) where TModel : class;
 

From 596a4616b343bc527c0a90df0f0be0ece970c3c7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 18 Aug 2021 23:38:23 -0400
Subject: [PATCH 246/856] no longer abort input thread when exiting

`thread.Abort` is unimplemented in .NET 5, but it's not needed anyway since all threads will be aborted when the game exits.
---
 src/SMAPI/Framework/Logging/LogManager.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index a3d4f23d..7f1b76e7 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -162,8 +162,6 @@ namespace StardewModdingAPI.Framework.Logging
             // keep console thread alive while the game is running
             while (continueWhile())
                 Thread.Sleep(1000 / 10);
-            if (inputThread.ThreadState == ThreadState.Running)
-                inputThread.Abort();
         }
 
         /// <summary>Show a 'press any key to exit' message, and exit when they press a key.</summary>

From 26a629f41b98faafed8af38a89f25d9b821fac0f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 19 Aug 2021 21:21:57 -0400
Subject: [PATCH 247/856] fix prerelease update alerts shown for non-prerelease
 players

---
 docs/release-notes.md                        |  3 +
 src/SMAPI.Toolkit/SemanticVersionComparer.cs | 32 ++++++++
 src/SMAPI.Web/Framework/ModSiteManager.cs    | 81 +++++++++++++-------
 3 files changed, 90 insertions(+), 26 deletions(-)
 create mode 100644 src/SMAPI.Toolkit/SemanticVersionComparer.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d0b794ee..85971e1d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
   * Fixed error-handling for `StackOverflowException` thrown on Linux/macOS.
   * Internal changes to prepare for upcoming releases.
 
+* For the web API:
+  * Fixed update checks recommending prerelease versions if the player has a working non-prerelease version.
+
 ## 3.12.2
 Released 05 August 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Toolkit/SemanticVersionComparer.cs b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
new file mode 100644
index 00000000..9f6b57a2
--- /dev/null
+++ b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
@@ -0,0 +1,32 @@
+using System.Collections.Generic;
+
+namespace StardewModdingAPI.Toolkit
+{
+    /// <summary>A comparer for semantic versions based on the <see cref="SemanticVersion.CompareTo(ISemanticVersion)"/> field.</summary>
+    public class SemanticVersionComparer : IComparer<ISemanticVersion>
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>A singleton instance of the comparer.</summary>
+        public static SemanticVersionComparer Instance { get; } = new SemanticVersionComparer();
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <inheritdoc />
+        public int Compare(ISemanticVersion x, ISemanticVersion y)
+        {
+            if (object.ReferenceEquals(x, y))
+                return 0;
+
+            if (x is null)
+                return -1;
+            if (y is null)
+                return 1;
+
+            return x.CompareTo(y);
+        }
+    }
+}
diff --git a/src/SMAPI.Web/Framework/ModSiteManager.cs b/src/SMAPI.Web/Framework/ModSiteManager.cs
index 68b4c6ac..8f21d2f5 100644
--- a/src/SMAPI.Web/Framework/ModSiteManager.cs
+++ b/src/SMAPI.Web/Framework/ModSiteManager.cs
@@ -110,41 +110,70 @@ namespace StardewModdingAPI.Web.Framework
             main = null;
             preview = null;
 
-            ISemanticVersion ParseVersion(string raw)
+            // parse all versions from the mod page
+            IEnumerable<(string name, string description, ISemanticVersion version)> GetAllVersions()
             {
-                raw = this.NormalizeVersion(raw);
-                return this.GetMappedVersion(raw, mapRemoteVersions, allowNonStandardVersions);
-            }
-
-            if (mod != null)
-            {
-                // get mod version
-                if (subkey == null)
-                    main = ParseVersion(mod.Version);
-
-                // get file versions
-                foreach (IModDownload download in mod.Downloads)
+                if (mod != null)
                 {
-                    // check for subkey if specified
-                    if (subkey != null && download.Name?.Contains(subkey, StringComparison.OrdinalIgnoreCase) != true && download.Description?.Contains(subkey, StringComparison.OrdinalIgnoreCase) != true)
+                    ISemanticVersion ParseAndMapVersion(string raw)
+                    {
+                        raw = this.NormalizeVersion(raw);
+                        return this.GetMappedVersion(raw, mapRemoteVersions, allowNonStandardVersions);
+                    }
+
+                    // get mod version
+                    ISemanticVersion modVersion = ParseAndMapVersion(mod.Version);
+                    if (modVersion != null)
+                        yield return (name: null, description: null, version: ParseAndMapVersion(mod.Version));
+
+                    // get file versions
+                    foreach (IModDownload download in mod.Downloads)
+                    {
+                        ISemanticVersion cur = ParseAndMapVersion(download.Version);
+                        if (cur != null)
+                            yield return (download.Name, download.Description, cur);
+                    }
+                }
+            }
+            var versions = GetAllVersions()
+                .OrderByDescending(p => p.version, SemanticVersionComparer.Instance)
+                .ToArray();
+
+            // get main + preview versions
+            void TryGetVersions(out ISemanticVersion mainVersion, out ISemanticVersion previewVersion, Func<(string name, string description, ISemanticVersion version), bool> filter = null)
+            {
+                mainVersion = null;
+                previewVersion = null;
+
+                // get latest main + preview version
+                foreach (var entry in versions)
+                {
+                    if (filter?.Invoke(entry) == false)
                         continue;
 
-                    // parse version
-                    ISemanticVersion cur = ParseVersion(download.Version);
-                    if (cur == null)
-                        continue;
+                    if (entry.version.IsPrerelease())
+                        previewVersion ??= entry.version;
+                    else
+                        mainVersion ??= entry.version;
 
-                    // track highest versions
-                    if (main == null || cur.IsNewerThan(main))
-                        main = cur;
-                    if (cur.IsPrerelease() && (preview == null || cur.IsNewerThan(preview)))
-                        preview = cur;
+                    if (mainVersion != null)
+                        break; // any other values will be older
                 }
 
-                if (preview != null && !preview.IsNewerThan(main))
-                    preview = null;
+                // normalize values
+                if (previewVersion is not null)
+                {
+                    mainVersion ??= previewVersion; // if every version is prerelease, latest one is the main version
+                    if (!previewVersion.IsNewerThan(mainVersion))
+                        previewVersion = null;
+                }
             }
 
+            if (subkey is not null)
+                TryGetVersions(out main, out preview, entry => entry.name?.Contains(subkey, StringComparison.OrdinalIgnoreCase) == true || entry.description?.Contains(subkey, StringComparison.OrdinalIgnoreCase) == true);
+            if (main is null)
+                TryGetVersions(out main, out preview);
+
             return main != null;
         }
 

From 3804ae6284aeca449e1ca95c6ae7291519ed6937 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 22 Aug 2021 12:14:59 -0400
Subject: [PATCH 248/856] fix some installer errors not showing info header

---
 docs/release-notes.md                       | 3 +++
 src/SMAPI.Installer/InteractiveInstaller.cs | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 85971e1d..9ad95a43 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Fixed some installer errors now show info header.
+
 * For mod authors:
   * Added `helper.Translation.GetInAllLocales` to get a translation in every available locale.
   * Fixed `helper.Data.WriteJsonFile` not deleting the file if the model is null, unlike the other `Write*` methods.
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index ab07c864..b91d0dd3 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -272,7 +272,6 @@ namespace StardewModdingApi.Installer
                 DirectoryInfo bundleDir = new DirectoryInfo(this.BundlePath);
                 paths = new InstallerPaths(bundleDir, installDir, context.ExecutableName);
             }
-            Console.Clear();
 
 
             /*********
@@ -309,6 +308,7 @@ namespace StardewModdingApi.Installer
                     return;
                 }
             }
+            Console.Clear();
 
 
             /*********

From e1d8838587329bd64f3627c4cdc4ac57d187ad7f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 24 Aug 2021 18:29:03 -0400
Subject: [PATCH 249/856] fix update checks not recommending prerelease mod
 versions for SMAPI beta

---
 docs/release-notes.md                          | 4 +++-
 src/SMAPI.Web/Controllers/ModsApiController.cs | 6 +++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9ad95a43..e71457af 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,7 +12,9 @@
   * Internal changes to prepare for upcoming releases.
 
 * For the web API:
-  * Fixed update checks recommending prerelease versions if the player has a working non-prerelease version.
+  * Fixed update checks...
+    * not recommending prerelease mod versions if the player has a beta SMAPI version;
+    * recommending prerelease versions if the player has a working non-prerelease version.
 
 ## 3.12.2
 Released 05 August 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index 1956bf29..c6e9a713 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -123,6 +123,10 @@ namespace StardewModdingAPI.Web.Controllers
             ModOverrideConfig overrides = this.Config.Value.ModOverrides.FirstOrDefault(p => p.ID.Equals(search.ID?.Trim(), StringComparison.OrdinalIgnoreCase));
             bool allowNonStandardVersions = overrides?.AllowNonStandardVersions ?? false;
 
+            // SMAPI versions with a '-beta' tag indicate major changes that may need beta mod versions.
+            // This doesn't apply to normal prerelease versions which have an '-alpha' tag.
+            bool isSmapiBeta = apiVersion.IsPrerelease() && apiVersion.PrereleaseTag.StartsWith("beta");
+
             // get latest versions
             ModEntryModel result = new ModEntryModel { ID = search.ID };
             IList<string> errors = new List<string>();
@@ -198,7 +202,7 @@ namespace StardewModdingAPI.Web.Controllers
                 List<ModEntryVersionModel> updates = new List<ModEntryVersionModel>();
                 if (this.IsRecommendedUpdate(installedVersion, main?.Version, useBetaChannel: true))
                     updates.Add(main);
-                if (this.IsRecommendedUpdate(installedVersion, optional?.Version, useBetaChannel: installedVersion.IsPrerelease() || search.IsBroken))
+                if (this.IsRecommendedUpdate(installedVersion, optional?.Version, useBetaChannel: isSmapiBeta || installedVersion.IsPrerelease() || search.IsBroken))
                     updates.Add(optional);
                 if (this.IsRecommendedUpdate(installedVersion, unofficial?.Version, useBetaChannel: true))
                     updates.Add(unofficial);

From f8c76bde39ba2afb11540c9af5d88aad4c73f789 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 24 Aug 2021 21:59:52 -0400
Subject: [PATCH 250/856] add 64-bit compatibility check before loading mods

That reduces time spent trying to rewrite them (which won't work anyway), and shows a more informative message than the default 'DLL couldn't be loaded' error.
---
 docs/release-notes.md                             |  1 +
 .../Framework/LowLevelEnvironmentUtility.cs       |  6 +++---
 src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs |  7 +++++++
 src/SMAPI/Framework/SCore.cs                      | 15 ++++++++++++---
 4 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e71457af..a00c73da 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Added friendly error in 64-bit mode when a mod is 32-bit only.
   * Fixed some installer errors now show info header.
 
 * For mod authors:
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index be0c18ce..2636aae0 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -90,10 +90,10 @@ namespace StardewModdingAPI.Toolkit.Framework
         }
 
         /// <summary>Get whether an executable is 64-bit.</summary>
-        /// <param name="executablePath">The absolute path to the executable file.</param>
-        public static bool Is64BitAssembly(string executablePath)
+        /// <param name="path">The absolute path to the assembly file.</param>
+        public static bool Is64BitAssembly(string path)
         {
-            return AssemblyName.GetAssemblyName(executablePath).ProcessorArchitecture != ProcessorArchitecture.X86;
+            return AssemblyName.GetAssemblyName(path).ProcessorArchitecture != ProcessorArchitecture.X86;
         }
 
 
diff --git a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
index 62bd13cd..6de79a85 100644
--- a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
@@ -46,5 +46,12 @@ namespace StardewModdingAPI.Toolkit.Utilities
         {
             return LowLevelEnvironmentUtility.GetExecutableName(platform.ToString());
         }
+
+        /// <summary>Get whether an executable is 64-bit.</summary>
+        /// <param name="path">The absolute path to the assembly file.</param>
+        public static bool Is64BitAssembly(string path)
+        {
+            return LowLevelEnvironmentUtility.Is64BitAssembly(path);
+        }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 5fb4aa03..dff0fc55 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1704,12 +1704,21 @@ namespace StardewModdingAPI.Framework
             // load as mod
             else
             {
+                // get mod info
                 IManifest manifest = mod.Manifest;
+                string assemblyPath = Path.Combine(mod.DirectoryPath, manifest.EntryDll);
+
+                // assert 64-bit
+#if SMAPI_FOR_WINDOWS_64BIT_HACK
+                if (!EnvironmentUtility.Is64BitAssembly(assemblyPath))
+                {
+                    errorReasonPhrase = "it needs to be updated for 64-bit mode.";
+                    failReason = ModFailReason.LoadFailed;
+                    return false;
+                }
+#endif
 
                 // load mod
-                string assemblyPath = manifest?.EntryDll != null
-                    ? Path.Combine(mod.DirectoryPath, manifest.EntryDll)
-                    : null;
                 Assembly modAssembly;
                 try
                 {

From 911843e1beb72a3fc0337a697f732215b66304c0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 18:26:02 -0400
Subject: [PATCH 251/856] fix console encoding issues (#798)

---
 docs/release-notes.md                     | 1 +
 src/SMAPI/Framework/Logging/LogManager.cs | 5 ++++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a00c73da..79129024 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For players:
   * Added friendly error in 64-bit mode when a mod is 32-bit only.
+  * Fixed console encoding issues on Linux/macOS.
   * Fixed some installer errors now show info header.
 
 * For mod authors:
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 7f1b76e7..c6faa90d 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -109,9 +109,12 @@ namespace StardewModdingAPI.Framework.Logging
                 output.OnMessageIntercepted += message => this.HandleConsoleMessage(this.MonitorForGame, message);
             Console.SetOut(output);
 
-            // enable Unicode handling
+            // enable Unicode handling on Windows
+            // (the terminal defaults to UTF-8 on Linux/macOS)
+#if SMAPI_FOR_WINDOWS
             Console.InputEncoding = Encoding.Unicode;
             Console.OutputEncoding = Encoding.Unicode;
+#endif
         }
 
         /// <summary>Get a monitor instance derived from SMAPI's current settings.</summary>

From b8dac41da8aa7ea8f42b89acd1e9a74829d70532 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 18:26:15 -0400
Subject: [PATCH 252/856] fix beta label in web UI

---
 src/SMAPI.Web/Views/Mods/Index.cshtml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/Views/Mods/Index.cshtml b/src/SMAPI.Web/Views/Mods/Index.cshtml
index fa77c220..7dcd0718 100644
--- a/src/SMAPI.Web/Views/Mods/Index.cshtml
+++ b/src/SMAPI.Web/Views/Mods/Index.cshtml
@@ -9,7 +9,7 @@
     TimeSpan staleAge = DateTimeOffset.UtcNow - Model.LastUpdated;
 
     bool hasBeta = Model.BetaVersion != null;
-    string betaLabel = "SDV @Model.BetaVersion only";
+    string betaLabel = $"SDV {Model.BetaVersion} only";
 }
 @section Head {
     <link rel="stylesheet" href="~/Content/css/mods.css?r=20200218" />

From c5c7201151709bed374931268b9c592ca526bfc9 Mon Sep 17 00:00:00 2001
From: Chase Warrington <spacechase0.and.cat@gmail.com>
Date: Thu, 19 Aug 2021 17:19:42 -0400
Subject: [PATCH 253/856] Fix assembly rewriting causing VS to error/crash when
 debugging

---
 .../Framework/ModLoading/AssemblyLoader.cs    | 31 +++++++++-------
 .../ModLoading/SymbolReaderProvider.cs        | 37 +++++++++++++++++++
 .../ModLoading/SymbolWriterProvider.cs        | 25 +++++++++++++
 3 files changed, 79 insertions(+), 14 deletions(-)
 create mode 100644 src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs
 create mode 100644 src/SMAPI/Framework/ModLoading/SymbolWriterProvider.cs

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 86b43990..98154b53 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -34,6 +34,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>A minimal assembly definition resolver which resolves references to known loaded assemblies.</summary>
         private readonly AssemblyDefinitionResolver AssemblyDefinitionResolver;
 
+        private readonly SymbolReaderProvider SymbolReaderProvider;
+        private readonly SymbolWriterProvider SymbolWriterProvider;
+
         /// <summary>The objects to dispose as part of this instance.</summary>
         private readonly HashSet<IDisposable> Disposables = new HashSet<IDisposable>();
 
@@ -61,6 +64,9 @@ namespace StardewModdingAPI.Framework.ModLoading
             this.AssemblyDefinitionResolver = this.TrackForDisposal(new AssemblyDefinitionResolver());
             Constants.ConfigureAssemblyResolver(this.AssemblyDefinitionResolver);
 
+            this.SymbolReaderProvider = new SymbolReaderProvider();
+            this.SymbolWriterProvider = new SymbolWriterProvider();
+
             // generate type => assembly lookup for types which should be rewritten
             this.TypeAssemblies = new Dictionary<string, Assembly>();
             foreach (Assembly assembly in this.AssemblyMap.Targets)
@@ -114,7 +120,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
                 // rewrite assembly
                 bool changed = this.RewriteAssembly(mod, assembly.Definition, loggedMessages, logPrefix: "      ");
-
+                
                 // detect broken assembly reference
                 foreach (AssemblyNameReference reference in assembly.Definition.MainModule.AssemblyReferences)
                 {
@@ -134,20 +140,12 @@ namespace StardewModdingAPI.Framework.ModLoading
                     if (!oneAssembly)
                         this.Monitor.Log($"      Loading {assembly.File.Name} (rewritten)...", LogLevel.Trace);
 
-                    // load PDB file if present
-                    byte[] symbols;
-                    {
-                        string symbolsPath = Path.Combine(Path.GetDirectoryName(assemblyPath), Path.GetFileNameWithoutExtension(assemblyPath)) + ".pdb";
-                        symbols = File.Exists(symbolsPath)
-                            ? File.ReadAllBytes(symbolsPath)
-                            : null;
-                    }
-
                     // load assembly
                     using MemoryStream outStream = new MemoryStream();
-                    assembly.Definition.Write(outStream);
+                    using MemoryStream outSymbolStream = new MemoryStream();
+                    assembly.Definition.Write(outStream, new WriterParameters() { WriteSymbols = true, SymbolStream = outSymbolStream, SymbolWriterProvider = this.SymbolWriterProvider } );
                     byte[] bytes = outStream.ToArray();
-                    lastAssembly = Assembly.Load(bytes, symbols);
+                    lastAssembly = Assembly.Load(bytes, outSymbolStream.ToArray());
                 }
                 else
                 {
@@ -234,10 +232,15 @@ namespace StardewModdingAPI.Framework.ModLoading
             if (!file.Exists)
                 yield break; // not a local assembly
 
-            // read assembly
+            // read assembly and PDB (if present)
             byte[] assemblyBytes = File.ReadAllBytes(file.FullName);
             Stream readStream = this.TrackForDisposal(new MemoryStream(assemblyBytes));
-            AssemblyDefinition assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true }));
+            {
+                string symbolsPath = Path.Combine(Path.GetDirectoryName(file.FullName), Path.GetFileNameWithoutExtension(file.FullName)) + ".pdb";
+                if ( File.Exists( symbolsPath ) )
+                    this.SymbolReaderProvider.AddSymbolMapping( Path.GetFileName( file.FullName ), this.TrackForDisposal( new MemoryStream( File.ReadAllBytes( symbolsPath ) ) ) );
+            }
+            AssemblyDefinition assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true, ReadSymbols = true, SymbolReaderProvider = this.SymbolReaderProvider }));
 
             // skip if already visited
             if (visitedAssemblyNames.Contains(assembly.Name.Name))
diff --git a/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs
new file mode 100644
index 00000000..a651c167
--- /dev/null
+++ b/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs
@@ -0,0 +1,37 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+using Mono.Cecil.Pdb;
+
+namespace StardewModdingAPI.Framework.ModLoading
+{
+    internal class SymbolReaderProvider : ISymbolReaderProvider
+    {
+        private readonly ISymbolReaderProvider BaseProvider = new DefaultSymbolReaderProvider();
+
+        private readonly Dictionary<string, Stream> SymbolMapping = new Dictionary<string, Stream>();
+
+        public void AddSymbolMapping( string dllName, Stream symbolStream )
+        {
+            this.SymbolMapping.Add( dllName, symbolStream );
+        }
+
+        public ISymbolReader GetSymbolReader( ModuleDefinition module, string fileName )
+        {
+            if ( this.SymbolMapping.ContainsKey( module.Name ) )
+                return new NativePdbReaderProvider().GetSymbolReader( module, this.SymbolMapping[ module.Name ] );
+            
+            return this.BaseProvider.GetSymbolReader( module, fileName );
+        }
+
+        public ISymbolReader GetSymbolReader( ModuleDefinition module, Stream symbolStream )
+        {
+            if ( this.SymbolMapping.ContainsKey( module.Name ) )
+                return new PortablePdbReaderProvider().GetSymbolReader( module, this.SymbolMapping[ module.Name ] );
+
+            return this.BaseProvider.GetSymbolReader( module, symbolStream );
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ModLoading/SymbolWriterProvider.cs b/src/SMAPI/Framework/ModLoading/SymbolWriterProvider.cs
new file mode 100644
index 00000000..116e341a
--- /dev/null
+++ b/src/SMAPI/Framework/ModLoading/SymbolWriterProvider.cs
@@ -0,0 +1,25 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+using Mono.Cecil.Pdb;
+
+namespace StardewModdingAPI.Framework.ModLoading
+{
+    internal class SymbolWriterProvider : ISymbolWriterProvider
+    {
+        private readonly ISymbolWriterProvider BaseProvider = new DefaultSymbolWriterProvider();
+
+        public ISymbolWriter GetSymbolWriter( ModuleDefinition module, string fileName )
+        {
+            return this.BaseProvider.GetSymbolWriter( module, fileName );
+        }
+
+        public ISymbolWriter GetSymbolWriter( ModuleDefinition module, Stream symbolStream )
+        {
+            // Not implemented in default native pdb writer, so fallback to portable
+            return new PortablePdbWriterProvider().GetSymbolWriter( module, symbolStream );
+        }
+    }
+}

From 5030e965dcfa4b8d9c6ed2285ceed5f7cdc472a9 Mon Sep 17 00:00:00 2001
From: Chase Warrington <spacechase0.and.cat@gmail.com>
Date: Fri, 20 Aug 2021 01:25:52 -0400
Subject: [PATCH 254/856] Fix for loading both types of PDBs

---
 .../Framework/ModLoading/MySymbolReader.cs    | 55 +++++++++++++++++++
 .../ModLoading/SymbolReaderProvider.cs        |  4 +-
 2 files changed, 57 insertions(+), 2 deletions(-)
 create mode 100644 src/SMAPI/Framework/ModLoading/MySymbolReader.cs

diff --git a/src/SMAPI/Framework/ModLoading/MySymbolReader.cs b/src/SMAPI/Framework/ModLoading/MySymbolReader.cs
new file mode 100644
index 00000000..215631c6
--- /dev/null
+++ b/src/SMAPI/Framework/ModLoading/MySymbolReader.cs
@@ -0,0 +1,55 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+using Mono.Cecil.Pdb;
+
+namespace StardewModdingAPI.Framework.ModLoading
+{
+    internal class MySymbolReader : ISymbolReader
+    {
+        private ModuleDefinition Module;
+        private Stream Stream;
+        private ISymbolReader Using;
+
+        public MySymbolReader( ModuleDefinition module, Stream stream )
+        {
+            this.Module = module;
+            this.Stream = stream;
+            this.Using = new NativePdbReaderProvider().GetSymbolReader( module, stream );
+        }
+        
+        public void Dispose()
+        {
+            this.Using.Dispose();
+        }
+
+        public ISymbolWriterProvider GetWriterProvider()
+        {
+            return new PortablePdbWriterProvider();
+        }
+
+        public bool ProcessDebugHeader( ImageDebugHeader header )
+        {
+            try
+            {
+                return this.Using.ProcessDebugHeader( header );
+            }
+            catch (Exception e)
+            {
+                this.Using.Dispose();
+                this.Using = new PortablePdbReaderProvider().GetSymbolReader( this.Module, this.Stream );
+                return this.Using.ProcessDebugHeader( header );
+            }
+        }
+
+        public MethodDebugInformation Read( MethodDefinition method )
+        {
+            return Using.Read( method );
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs
index a651c167..c92e1e4d 100644
--- a/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs
@@ -21,7 +21,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         public ISymbolReader GetSymbolReader( ModuleDefinition module, string fileName )
         {
             if ( this.SymbolMapping.ContainsKey( module.Name ) )
-                return new NativePdbReaderProvider().GetSymbolReader( module, this.SymbolMapping[ module.Name ] );
+                return new MySymbolReader( module, this.SymbolMapping[ module.Name ] );
             
             return this.BaseProvider.GetSymbolReader( module, fileName );
         }
@@ -29,7 +29,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         public ISymbolReader GetSymbolReader( ModuleDefinition module, Stream symbolStream )
         {
             if ( this.SymbolMapping.ContainsKey( module.Name ) )
-                return new PortablePdbReaderProvider().GetSymbolReader( module, this.SymbolMapping[ module.Name ] );
+                return new MySymbolReader( module, this.SymbolMapping[ module.Name ] );
 
             return this.BaseProvider.GetSymbolReader( module, symbolStream );
         }

From e3b38a70f8d710af07732b325a6013ed18aa0fb0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 19:17:29 -0400
Subject: [PATCH 255/856] reorganize new classes

---
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs     |  1 +
 .../{MySymbolReader.cs => Symbols/SymbolReader.cs}   | 12 ++++--------
 .../ModLoading/{ => Symbols}/SymbolReaderProvider.cs |  8 +++-----
 .../ModLoading/{ => Symbols}/SymbolWriterProvider.cs |  5 +----
 4 files changed, 9 insertions(+), 17 deletions(-)
 rename src/SMAPI/Framework/ModLoading/{MySymbolReader.cs => Symbols/SymbolReader.cs} (78%)
 rename src/SMAPI/Framework/ModLoading/{ => Symbols}/SymbolReaderProvider.cs (80%)
 rename src/SMAPI/Framework/ModLoading/{ => Symbols}/SymbolWriterProvider.cs (85%)

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 98154b53..72cfd119 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -7,6 +7,7 @@ using Mono.Cecil;
 using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.ModLoading.Framework;
+using StardewModdingAPI.Framework.ModLoading.Symbols;
 using StardewModdingAPI.Metadata;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Utilities;
diff --git a/src/SMAPI/Framework/ModLoading/MySymbolReader.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
similarity index 78%
rename from src/SMAPI/Framework/ModLoading/MySymbolReader.cs
rename to src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
index 215631c6..f1ae86a2 100644
--- a/src/SMAPI/Framework/ModLoading/MySymbolReader.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
@@ -1,22 +1,18 @@
 using System;
-using System.Collections.Generic;
 using System.IO;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using Mono.Cecil.Pdb;
 
-namespace StardewModdingAPI.Framework.ModLoading
+namespace StardewModdingAPI.Framework.ModLoading.Symbols
 {
-    internal class MySymbolReader : ISymbolReader
+    internal class SymbolReader : ISymbolReader
     {
         private ModuleDefinition Module;
         private Stream Stream;
         private ISymbolReader Using;
 
-        public MySymbolReader( ModuleDefinition module, Stream stream )
+        public SymbolReader( ModuleDefinition module, Stream stream )
         {
             this.Module = module;
             this.Stream = stream;
@@ -49,7 +45,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
         public MethodDebugInformation Read( MethodDefinition method )
         {
-            return Using.Read( method );
+            return this.Using.Read( method );
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
similarity index 80%
rename from src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs
rename to src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
index c92e1e4d..e2a6d21e 100644
--- a/src/SMAPI/Framework/ModLoading/SymbolReaderProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
@@ -1,11 +1,9 @@
-using System;
 using System.Collections.Generic;
 using System.IO;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
-using Mono.Cecil.Pdb;
 
-namespace StardewModdingAPI.Framework.ModLoading
+namespace StardewModdingAPI.Framework.ModLoading.Symbols
 {
     internal class SymbolReaderProvider : ISymbolReaderProvider
     {
@@ -21,7 +19,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         public ISymbolReader GetSymbolReader( ModuleDefinition module, string fileName )
         {
             if ( this.SymbolMapping.ContainsKey( module.Name ) )
-                return new MySymbolReader( module, this.SymbolMapping[ module.Name ] );
+                return new SymbolReader( module, this.SymbolMapping[ module.Name ] );
             
             return this.BaseProvider.GetSymbolReader( module, fileName );
         }
@@ -29,7 +27,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         public ISymbolReader GetSymbolReader( ModuleDefinition module, Stream symbolStream )
         {
             if ( this.SymbolMapping.ContainsKey( module.Name ) )
-                return new MySymbolReader( module, this.SymbolMapping[ module.Name ] );
+                return new SymbolReader( module, this.SymbolMapping[ module.Name ] );
 
             return this.BaseProvider.GetSymbolReader( module, symbolStream );
         }
diff --git a/src/SMAPI/Framework/ModLoading/SymbolWriterProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
similarity index 85%
rename from src/SMAPI/Framework/ModLoading/SymbolWriterProvider.cs
rename to src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
index 116e341a..33e91db0 100644
--- a/src/SMAPI/Framework/ModLoading/SymbolWriterProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
@@ -1,11 +1,8 @@
-using System;
-using System.Collections.Generic;
 using System.IO;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
-using Mono.Cecil.Pdb;
 
-namespace StardewModdingAPI.Framework.ModLoading
+namespace StardewModdingAPI.Framework.ModLoading.Symbols
 {
     internal class SymbolWriterProvider : ISymbolWriterProvider
     {

From 0b29eb3bc37553aa2e9776e17727ba07018606ea Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 20:01:59 -0400
Subject: [PATCH 256/856] minor refactoring in new symbol code

---
 .../Framework/ModLoading/AssemblyLoader.cs    | 26 ++++----
 .../ModLoading/Symbols/SymbolReader.cs        | 59 +++++++++++++------
 .../Symbols/SymbolReaderProvider.cs           | 44 ++++++++++----
 .../Symbols/SymbolWriterProvider.cs           | 28 +++++++--
 4 files changed, 107 insertions(+), 50 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 72cfd119..5180f072 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -35,8 +35,11 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>A minimal assembly definition resolver which resolves references to known loaded assemblies.</summary>
         private readonly AssemblyDefinitionResolver AssemblyDefinitionResolver;
 
-        private readonly SymbolReaderProvider SymbolReaderProvider;
-        private readonly SymbolWriterProvider SymbolWriterProvider;
+        /// <summary>Provides assembly symbol readers for Mono.Cecil.</summary>
+        private readonly SymbolReaderProvider SymbolReaderProvider = new SymbolReaderProvider();
+
+        /// <summary>Provides assembly symbol writers for Mono.Cecil.</summary>
+        private readonly SymbolWriterProvider SymbolWriterProvider = new SymbolWriterProvider();
 
         /// <summary>The objects to dispose as part of this instance.</summary>
         private readonly HashSet<IDisposable> Disposables = new HashSet<IDisposable>();
@@ -65,9 +68,6 @@ namespace StardewModdingAPI.Framework.ModLoading
             this.AssemblyDefinitionResolver = this.TrackForDisposal(new AssemblyDefinitionResolver());
             Constants.ConfigureAssemblyResolver(this.AssemblyDefinitionResolver);
 
-            this.SymbolReaderProvider = new SymbolReaderProvider();
-            this.SymbolWriterProvider = new SymbolWriterProvider();
-
             // generate type => assembly lookup for types which should be rewritten
             this.TypeAssemblies = new Dictionary<string, Assembly>();
             foreach (Assembly assembly in this.AssemblyMap.Targets)
@@ -121,7 +121,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
                 // rewrite assembly
                 bool changed = this.RewriteAssembly(mod, assembly.Definition, loggedMessages, logPrefix: "      ");
-                
+
                 // detect broken assembly reference
                 foreach (AssemblyNameReference reference in assembly.Definition.MainModule.AssemblyReferences)
                 {
@@ -142,10 +142,10 @@ namespace StardewModdingAPI.Framework.ModLoading
                         this.Monitor.Log($"      Loading {assembly.File.Name} (rewritten)...", LogLevel.Trace);
 
                     // load assembly
-                    using MemoryStream outStream = new MemoryStream();
+                    using MemoryStream outAssemblyStream = new MemoryStream();
                     using MemoryStream outSymbolStream = new MemoryStream();
-                    assembly.Definition.Write(outStream, new WriterParameters() { WriteSymbols = true, SymbolStream = outSymbolStream, SymbolWriterProvider = this.SymbolWriterProvider } );
-                    byte[] bytes = outStream.ToArray();
+                    assembly.Definition.Write(outAssemblyStream, new WriterParameters { WriteSymbols = true, SymbolStream = outSymbolStream, SymbolWriterProvider = this.SymbolWriterProvider });
+                    byte[] bytes = outAssemblyStream.ToArray();
                     lastAssembly = Assembly.Load(bytes, outSymbolStream.ToArray());
                 }
                 else
@@ -233,13 +233,13 @@ namespace StardewModdingAPI.Framework.ModLoading
             if (!file.Exists)
                 yield break; // not a local assembly
 
-            // read assembly and PDB (if present)
+            // read assembly and symbols
             byte[] assemblyBytes = File.ReadAllBytes(file.FullName);
             Stream readStream = this.TrackForDisposal(new MemoryStream(assemblyBytes));
             {
-                string symbolsPath = Path.Combine(Path.GetDirectoryName(file.FullName), Path.GetFileNameWithoutExtension(file.FullName)) + ".pdb";
-                if ( File.Exists( symbolsPath ) )
-                    this.SymbolReaderProvider.AddSymbolMapping( Path.GetFileName( file.FullName ), this.TrackForDisposal( new MemoryStream( File.ReadAllBytes( symbolsPath ) ) ) );
+                FileInfo symbolsFile = new FileInfo(Path.Combine(Path.GetDirectoryName(file.FullName)!, Path.GetFileNameWithoutExtension(file.FullName)) + ".pdb");
+                if (symbolsFile.Exists)
+                    this.SymbolReaderProvider.TryAddSymbolData(file.Name, this.TrackForDisposal(symbolsFile.OpenRead()));
             }
             AssemblyDefinition assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true, ReadSymbols = true, SymbolReaderProvider = this.SymbolReaderProvider }));
 
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
index f1ae86a2..2171895d 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
@@ -1,4 +1,3 @@
-using System;
 using System.IO;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -6,46 +5,68 @@ using Mono.Cecil.Pdb;
 
 namespace StardewModdingAPI.Framework.ModLoading.Symbols
 {
+    /// <summary>Reads symbol data for an assembly.</summary>
     internal class SymbolReader : ISymbolReader
     {
-        private ModuleDefinition Module;
-        private Stream Stream;
-        private ISymbolReader Using;
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The module for which to read symbols.</summary>
+        private readonly ModuleDefinition Module;
 
-        public SymbolReader( ModuleDefinition module, Stream stream )
+        /// <summary>The symbol file stream.</summary>
+        private readonly Stream Stream;
+
+        /// <summary>The underlying symbol reader.</summary>
+        private ISymbolReader Reader;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="module">The module for which to read symbols.</param>
+        /// <param name="stream">The symbol file stream.</param>
+        public SymbolReader(ModuleDefinition module, Stream stream)
         {
             this.Module = module;
             this.Stream = stream;
-            this.Using = new NativePdbReaderProvider().GetSymbolReader( module, stream );
-        }
-        
-        public void Dispose()
-        {
-            this.Using.Dispose();
+            this.Reader = new NativePdbReaderProvider().GetSymbolReader(module, stream);
         }
 
+        /// <summary>Get the symbol writer provider for the assembly.</summary>
         public ISymbolWriterProvider GetWriterProvider()
         {
             return new PortablePdbWriterProvider();
         }
 
-        public bool ProcessDebugHeader( ImageDebugHeader header )
+        /// <summary>Process a debug header in the symbol file.</summary>
+        /// <param name="header">The debug header.</param>
+        public bool ProcessDebugHeader(ImageDebugHeader header)
         {
             try
             {
-                return this.Using.ProcessDebugHeader( header );
+                return this.Reader.ProcessDebugHeader(header);
             }
-            catch (Exception e)
+            catch
             {
-                this.Using.Dispose();
-                this.Using = new PortablePdbReaderProvider().GetSymbolReader( this.Module, this.Stream );
-                return this.Using.ProcessDebugHeader( header );
+                this.Reader.Dispose();
+                this.Reader = new PortablePdbReaderProvider().GetSymbolReader(this.Module, this.Stream);
+                return this.Reader.ProcessDebugHeader(header);
             }
         }
 
-        public MethodDebugInformation Read( MethodDefinition method )
+        /// <summary>Read the method debug information for a method in the assembly.</summary>
+        /// <param name="method">The method definition.</param>
+        public MethodDebugInformation Read(MethodDefinition method)
         {
-            return this.Using.Read( method );
+            return this.Reader.Read(method);
+        }
+
+        /// <inheritdoc />
+        public void Dispose()
+        {
+            this.Reader.Dispose();
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
index e2a6d21e..02a70f1c 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.IO;
 using Mono.Cecil;
@@ -5,31 +6,48 @@ using Mono.Cecil.Cil;
 
 namespace StardewModdingAPI.Framework.ModLoading.Symbols
 {
+    /// <summary>Provides assembly symbol readers for Mono.Cecil.</summary>
     internal class SymbolReaderProvider : ISymbolReaderProvider
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The underlying symbol reader provider.</summary>
         private readonly ISymbolReaderProvider BaseProvider = new DefaultSymbolReaderProvider();
 
-        private readonly Dictionary<string, Stream> SymbolMapping = new Dictionary<string, Stream>();
+        /// <summary>The symbol data loaded by absolute assembly path.</summary>
+        private readonly Dictionary<string, Stream> SymbolsByAssemblyPath = new Dictionary<string, Stream>(StringComparer.OrdinalIgnoreCase);
 
-        public void AddSymbolMapping( string dllName, Stream symbolStream )
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Add the symbol file for a given assembly name, if it's not already registered.</summary>
+        /// <param name="fileName">The assembly file name.</param>
+        /// <param name="symbolStream">The raw file stream for the symbols.</param>
+        public void AddSymbolData(string fileName, Stream symbolStream)
         {
-            this.SymbolMapping.Add( dllName, symbolStream );
+            this.SymbolsByAssemblyPath.Add(fileName, symbolStream);
         }
 
-        public ISymbolReader GetSymbolReader( ModuleDefinition module, string fileName )
+        /// <summary>Get a symbol reader for a given module and assembly name.</summary>
+        /// <param name="module">The loaded assembly module.</param>
+        /// <param name="fileName">The assembly file name.</param>
+        public ISymbolReader GetSymbolReader(ModuleDefinition module, string fileName)
         {
-            if ( this.SymbolMapping.ContainsKey( module.Name ) )
-                return new SymbolReader( module, this.SymbolMapping[ module.Name ] );
-            
-            return this.BaseProvider.GetSymbolReader( module, fileName );
+            return this.SymbolsByAssemblyPath.TryGetValue(module.Name, out Stream symbolData)
+                ? new SymbolReader(module, symbolData)
+                : this.BaseProvider.GetSymbolReader(module, fileName);
         }
 
-        public ISymbolReader GetSymbolReader( ModuleDefinition module, Stream symbolStream )
+        /// <summary>Get a symbol reader for a given module and symbol stream.</summary>
+        /// <param name="module">The loaded assembly module.</param>
+        /// <param name="symbolStream">The loaded symbol file stream.</param>
+        public ISymbolReader GetSymbolReader(ModuleDefinition module, Stream symbolStream)
         {
-            if ( this.SymbolMapping.ContainsKey( module.Name ) )
-                return new SymbolReader( module, this.SymbolMapping[ module.Name ] );
-
-            return this.BaseProvider.GetSymbolReader( module, symbolStream );
+            return this.SymbolsByAssemblyPath.TryGetValue(module.Name, out Stream symbolData)
+                ? new SymbolReader(module, symbolData)
+                : this.BaseProvider.GetSymbolReader(module, symbolStream);
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
index 33e91db0..8f7e05d1 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
@@ -4,19 +4,37 @@ using Mono.Cecil.Cil;
 
 namespace StardewModdingAPI.Framework.ModLoading.Symbols
 {
+    /// <summary>Provides assembly symbol writers for Mono.Cecil.</summary>
     internal class SymbolWriterProvider : ISymbolWriterProvider
     {
-        private readonly ISymbolWriterProvider BaseProvider = new DefaultSymbolWriterProvider();
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The default symbol writer provider.</summary>
+        private readonly ISymbolWriterProvider DefaultProvider = new DefaultSymbolWriterProvider();
 
-        public ISymbolWriter GetSymbolWriter( ModuleDefinition module, string fileName )
+        /// <summary>The symbol writer provider for the portable PDB format.</summary>
+        private readonly ISymbolWriterProvider PortablePdbProvider = new PortablePdbWriterProvider();
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get a symbol writer for a given module and assembly path.</summary>
+        /// <param name="module">The loaded assembly module.</param>
+        /// <param name="fileName">The assembly name.</param>
+        public ISymbolWriter GetSymbolWriter(ModuleDefinition module, string fileName)
         {
-            return this.BaseProvider.GetSymbolWriter( module, fileName );
+            return this.DefaultProvider.GetSymbolWriter(module, fileName);
         }
 
-        public ISymbolWriter GetSymbolWriter( ModuleDefinition module, Stream symbolStream )
+        /// <summary>Get a symbol writer for a given module and symbol stream.</summary>
+        /// <param name="module">The loaded assembly module.</param>
+        /// <param name="symbolStream">The loaded symbol file stream.</param>
+        public ISymbolWriter GetSymbolWriter(ModuleDefinition module, Stream symbolStream)
         {
             // Not implemented in default native pdb writer, so fallback to portable
-            return new PortablePdbWriterProvider().GetSymbolWriter( module, symbolStream );
+            return this.PortablePdbProvider.GetSymbolWriter(module, symbolStream);
         }
     }
 }

From 687a396e9c7581ebc2b35e58fc9b44d20d93a5d3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 20:02:51 -0400
Subject: [PATCH 257/856] fix error when reading a duplicate assembly

---
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs           | 2 +-
 .../Framework/ModLoading/Symbols/SymbolReaderProvider.cs   | 7 ++++---
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 5180f072..e1ad9d37 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -239,7 +239,7 @@ namespace StardewModdingAPI.Framework.ModLoading
             {
                 FileInfo symbolsFile = new FileInfo(Path.Combine(Path.GetDirectoryName(file.FullName)!, Path.GetFileNameWithoutExtension(file.FullName)) + ".pdb");
                 if (symbolsFile.Exists)
-                    this.SymbolReaderProvider.TryAddSymbolData(file.Name, this.TrackForDisposal(symbolsFile.OpenRead()));
+                    this.SymbolReaderProvider.TryAddSymbolData(file.Name, () => this.TrackForDisposal(symbolsFile.OpenRead()));
             }
             AssemblyDefinition assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true, ReadSymbols = true, SymbolReaderProvider = this.SymbolReaderProvider }));
 
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
index 02a70f1c..1b160690 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
@@ -24,10 +24,11 @@ namespace StardewModdingAPI.Framework.ModLoading.Symbols
         *********/
         /// <summary>Add the symbol file for a given assembly name, if it's not already registered.</summary>
         /// <param name="fileName">The assembly file name.</param>
-        /// <param name="symbolStream">The raw file stream for the symbols.</param>
-        public void AddSymbolData(string fileName, Stream symbolStream)
+        /// <param name="getSymbolStream">Get the raw file stream for the symbols.</param>
+        public void TryAddSymbolData(string fileName, Func<Stream> getSymbolStream)
         {
-            this.SymbolsByAssemblyPath.Add(fileName, symbolStream);
+            if (!this.SymbolsByAssemblyPath.ContainsKey(fileName))
+                this.SymbolsByAssemblyPath.Add(fileName, getSymbolStream());
         }
 
         /// <summary>Get a symbol reader for a given module and assembly name.</summary>

From 11ecd578e960379db609cae5f9922df11ae79820 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 20:03:06 -0400
Subject: [PATCH 258/856] fix error when no symbols are found

---
 src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
index 1b160690..44074337 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Symbols
         ** Fields
         *********/
         /// <summary>The underlying symbol reader provider.</summary>
-        private readonly ISymbolReaderProvider BaseProvider = new DefaultSymbolReaderProvider();
+        private readonly ISymbolReaderProvider BaseProvider = new DefaultSymbolReaderProvider(throwIfNoSymbol: false);
 
         /// <summary>The symbol data loaded by absolute assembly path.</summary>
         private readonly Dictionary<string, Stream> SymbolsByAssemblyPath = new Dictionary<string, Stream>(StringComparer.OrdinalIgnoreCase);

From 8f77c1d1ef60e58356c5eef4ee0e5e58fd062809 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 20:46:57 -0400
Subject: [PATCH 259/856] update release notes

---
 docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 79129024..4f597758 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 * For mod authors:
   * Added `helper.Translation.GetInAllLocales` to get a translation in every available locale.
+  * Fixed Visual Studio debugger crash when any mods are rewritten for compatibility (thanks to spacechase0!).
   * Fixed `helper.Data.WriteJsonFile` not deleting the file if the model is null, unlike the other `Write*` methods.
   * Fixed error-handling for `StackOverflowException` thrown on Linux/macOS.
   * Internal changes to prepare for upcoming releases.

From 2b14524280e493b26f4ed35b2593e9ad5b74fdcf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 Aug 2021 20:43:42 -0400
Subject: [PATCH 260/856] migrate web project to .NET 5

---
 src/SMAPI.Web/SMAPI.Web.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index e9d209ec..4c8465a6 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>SMAPI.Web</AssemblyName>
     <RootNamespace>StardewModdingAPI.Web</RootNamespace>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
 

From 31ac964a8b19623b0472931403a33d51db6fb271 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 21:53:45 -0400
Subject: [PATCH 261/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 13 +++++++------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 15 insertions(+), 14 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 498ec7af..06e0a245 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.2</Version>
+    <Version>3.12.3</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4f597758..07eb6c03 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,23 +1,24 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.3
+Released 25 August 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
   * Added friendly error in 64-bit mode when a mod is 32-bit only.
   * Fixed console encoding issues on Linux/macOS.
-  * Fixed some installer errors now show info header.
+  * Fixed some installer errors not showing info header.
 
 * For mod authors:
   * Added `helper.Translation.GetInAllLocales` to get a translation in every available locale.
   * Fixed Visual Studio debugger crash when any mods are rewritten for compatibility (thanks to spacechase0!).
   * Fixed `helper.Data.WriteJsonFile` not deleting the file if the model is null, unlike the other `Write*` methods.
   * Fixed error-handling for `StackOverflowException` thrown on Linux/macOS.
-  * Internal changes to prepare for upcoming releases.
+  * Internal changes to prepare for Stardew Valley 1.5.5.
 
 * For the web API:
-  * Fixed update checks...
-    * not recommending prerelease mod versions if the player has a beta SMAPI version;
-    * recommending prerelease versions if the player has a working non-prerelease version.
+  * Fixed update checks not shown for prerelease mod versions when you have a SMAPI beta.
+  * Fixed update checks shown for prerelease mod versions if you have a working non-prerelease version.
 
 ## 3.12.2
 Released 05 August 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 6b49cd5f..e04d3497 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.2",
+    "Version": "3.12.3",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.2"
+    "MinimumApiVersion": "3.12.3"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 7759d1d5..54758a36 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.2",
+    "Version": "3.12.3",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.2"
+    "MinimumApiVersion": "3.12.3"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 1e5b8b97..f23f0958 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.2",
+    "Version": "3.12.3",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.2"
+    "MinimumApiVersion": "3.12.3"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index de6b63d6..cce267ba 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -62,7 +62,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.2";
+        internal static string RawApiVersion = "3.12.3";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From fd7f81ac9c1fbf1ba0427f23fb0f2de3d9c5a028 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 23:19:47 -0400
Subject: [PATCH 262/856] fix assembly resolver not tracking loaded mods
 correctly

---
 docs/release-notes.md                            |  4 ++++
 src/SMAPI/Constants.cs                           |  2 +-
 .../ModLoading/AssemblyDefinitionResolver.cs     | 16 +++++++++++-----
 3 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 07eb6c03..5aded254 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Fixed error loading some mods which reference other mod DLLs in SMAPI 3.12.3.
+
 ## 3.12.3
 Released 25 August 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index cce267ba..07a5e8e6 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -249,7 +249,7 @@ namespace StardewModdingAPI
             //   - 'StardewValley': assembly name on Linux/macOS;
             //   - 'Stardew Valley': assembly name on Windows;
             //   - 'Netcode': an assembly that's separate on Windows only.
-            resolver.Add(AssemblyDefinition.ReadAssembly(typeof(Game1).Assembly.Location), "StardewValley", "Stardew Valley"
+            resolver.AddWithExplicitNames(AssemblyDefinition.ReadAssembly(typeof(Game1).Assembly.Location), "StardewValley", "Stardew Valley"
 #if !SMAPI_FOR_WINDOWS
                 , "Netcode"
 #endif
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
index b3415609..8e2f5ef3 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
@@ -21,13 +21,13 @@ namespace StardewModdingAPI.Framework.ModLoading
         public void Add(params AssemblyDefinition[] assemblies)
         {
             foreach (AssemblyDefinition assembly in assemblies)
-                this.Add(assembly, assembly.Name.Name, assembly.Name.FullName);
+                this.AddWithExplicitNames(assembly, assembly.Name.Name, assembly.Name.FullName);
         }
 
-        /// <summary>Add known assemblies to the resolver.</summary>
+        /// <summary>Add a known assembly to the resolver with the given names. This overrides the assembly names that would normally be assigned.</summary>
         /// <param name="assembly">The assembly to add.</param>
         /// <param name="names">The assembly names for which it should be returned.</param>
-        public void Add(AssemblyDefinition assembly, params string[] names)
+        public void AddWithExplicitNames(AssemblyDefinition assembly, params string[] names)
         {
             this.RegisterAssembly(assembly);
             foreach (string name in names)
@@ -36,12 +36,18 @@ namespace StardewModdingAPI.Framework.ModLoading
 
         /// <summary>Resolve an assembly reference.</summary>
         /// <param name="name">The assembly name.</param>
-        public override AssemblyDefinition Resolve(AssemblyNameReference name) => this.ResolveName(name.Name) ?? base.Resolve(name);
+        public override AssemblyDefinition Resolve(AssemblyNameReference name)
+        {
+            return this.ResolveName(name.Name) ?? base.Resolve(name);
+        }
 
         /// <summary>Resolve an assembly reference.</summary>
         /// <param name="name">The assembly name.</param>
         /// <param name="parameters">The assembly reader parameters.</param>
-        public override AssemblyDefinition Resolve(AssemblyNameReference name, ReaderParameters parameters) => this.ResolveName(name.Name) ?? base.Resolve(name, parameters);
+        public override AssemblyDefinition Resolve(AssemblyNameReference name, ReaderParameters parameters)
+        {
+            return this.ResolveName(name.Name) ?? base.Resolve(name, parameters);
+        }
 
 
         /*********

From 08b180ca891e51773fb5f96d3cf3721b865ec04c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 23:56:46 -0400
Subject: [PATCH 263/856] add failsafe when loading symbols

---
 .../Framework/ModLoading/AssemblyLoader.cs    | 27 ++++++++++++++-----
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index e1ad9d37..3e35c9dd 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -233,15 +233,28 @@ namespace StardewModdingAPI.Framework.ModLoading
             if (!file.Exists)
                 yield break; // not a local assembly
 
-            // read assembly and symbols
-            byte[] assemblyBytes = File.ReadAllBytes(file.FullName);
-            Stream readStream = this.TrackForDisposal(new MemoryStream(assemblyBytes));
+            // read assembly
+            AssemblyDefinition assembly;
             {
-                FileInfo symbolsFile = new FileInfo(Path.Combine(Path.GetDirectoryName(file.FullName)!, Path.GetFileNameWithoutExtension(file.FullName)) + ".pdb");
-                if (symbolsFile.Exists)
-                    this.SymbolReaderProvider.TryAddSymbolData(file.Name, () => this.TrackForDisposal(symbolsFile.OpenRead()));
+                byte[] assemblyBytes = File.ReadAllBytes(file.FullName);
+                Stream readStream = this.TrackForDisposal(new MemoryStream(assemblyBytes));
+
+                try
+                {
+                    // read assembly with symbols
+                    FileInfo symbolsFile = new FileInfo(Path.Combine(Path.GetDirectoryName(file.FullName)!, Path.GetFileNameWithoutExtension(file.FullName)) + ".pdb");
+                    if (symbolsFile.Exists)
+                        this.SymbolReaderProvider.TryAddSymbolData(file.Name, () => this.TrackForDisposal(symbolsFile.OpenRead()));
+                    assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true, ReadSymbols = true, SymbolReaderProvider = this.SymbolReaderProvider }));
+                }
+                catch (SymbolsNotMatchingException ex)
+                {
+                    // read assembly without symbols
+                    this.Monitor.Log($"      Failed loading PDB for '{file.Name}'. Technical details:\n{ex}");
+                    readStream.Position = 0;
+                    assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true }));
+                }
             }
-            AssemblyDefinition assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true, ReadSymbols = true, SymbolReaderProvider = this.SymbolReaderProvider }));
 
             // skip if already visited
             if (visitedAssemblyNames.Contains(assembly.Name.Name))

From 69b1c229de0dd374470768d89f3ea1cbcd48ba9a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 Aug 2021 23:57:13 -0400
Subject: [PATCH 264/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 6 ++++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 06e0a245..ca02ba30 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.3</Version>
+    <Version>3.12.4</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5aded254..3c9c0895 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,9 +1,11 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.4
+Released 25 August 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
-  * Fixed error loading some mods which reference other mod DLLs in SMAPI 3.12.3.
+  * Fixed error loading some mods in SMAPI 3.12.3.
 
 ## 3.12.3
 Released 25 August 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index e04d3497..e89dd582 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.3",
+    "Version": "3.12.4",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.3"
+    "MinimumApiVersion": "3.12.4"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 54758a36..ba51ed68 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.3",
+    "Version": "3.12.4",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.3"
+    "MinimumApiVersion": "3.12.4"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index f23f0958..a4d7aeac 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.3",
+    "Version": "3.12.4",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.3"
+    "MinimumApiVersion": "3.12.4"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 07a5e8e6..8086ffa9 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -62,7 +62,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.3";
+        internal static string RawApiVersion = "3.12.4";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 22a895d27c79f2f0cc04e02de89bf55f2448994e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 26 Aug 2021 01:12:37 -0400
Subject: [PATCH 265/856] only check 64-bit compatibility if an assembly fails
 to load

Apparently some 32-bit-only DLLs load successfully with the unofficial 64-bit version of the game.
---
 docs/release-notes.md        |  3 +++
 src/SMAPI/Framework/SCore.cs | 14 ++++----------
 2 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3c9c0895..6a75b895 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,9 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* Fixed some mods in unofficial 64-bit mode no longer loading after SMAPI 3.12.3.
+
 ## 3.12.4
 Released 25 August 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index dff0fc55..c1aa3721 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1708,16 +1708,6 @@ namespace StardewModdingAPI.Framework
                 IManifest manifest = mod.Manifest;
                 string assemblyPath = Path.Combine(mod.DirectoryPath, manifest.EntryDll);
 
-                // assert 64-bit
-#if SMAPI_FOR_WINDOWS_64BIT_HACK
-                if (!EnvironmentUtility.Is64BitAssembly(assemblyPath))
-                {
-                    errorReasonPhrase = "it needs to be updated for 64-bit mode.";
-                    failReason = ModFailReason.LoadFailed;
-                    return false;
-                }
-#endif
-
                 // load mod
                 Assembly modAssembly;
                 try
@@ -1741,6 +1731,10 @@ namespace StardewModdingAPI.Framework
                 catch (Exception ex)
                 {
                     errorReasonPhrase = "its DLL couldn't be loaded.";
+#if SMAPI_FOR_WINDOWS_64BIT_HACK
+                    if (!EnvironmentUtility.Is64BitAssembly(assemblyPath))
+                        errorReasonPhrase = "it needs to be updated for 64-bit mode.";
+#endif
                     errorDetails = $"Error: {ex.GetLogSummary()}";
                     failReason = ModFailReason.LoadFailed;
                     return false;

From c065675604a1d93f55828be6030baa3131dd7553 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 26 Aug 2021 01:13:24 -0400
Subject: [PATCH 266/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index ca02ba30..70f0a741 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.4</Version>
+    <Version>3.12.5</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6a75b895..db0c3a2a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,7 +1,9 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.5
+Released 26 August 2021 for Stardew Valley 1.5.4 or later.
+
 * Fixed some mods in unofficial 64-bit mode no longer loading after SMAPI 3.12.3.
 
 ## 3.12.4
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index e89dd582..540d0488 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.4",
+    "Version": "3.12.5",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.4"
+    "MinimumApiVersion": "3.12.5"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index ba51ed68..645a7514 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.4",
+    "Version": "3.12.5",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.4"
+    "MinimumApiVersion": "3.12.5"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index a4d7aeac..d8b77339 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.4",
+    "Version": "3.12.5",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.4"
+    "MinimumApiVersion": "3.12.5"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 8086ffa9..04e15998 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -62,7 +62,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.4";
+        internal static string RawApiVersion = "3.12.5";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 9316fe303827cb31f38f4a5bb068f8fa0190ac5e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 27 Aug 2021 19:14:41 -0400
Subject: [PATCH 267/856] add hurry_all console command

---
 docs/release-notes.md                         |  4 ++
 .../Commands/World/HurryAllCommand.cs         | 54 +++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index db0c3a2a..31a114a2 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For console commands:
+  * Added `hurry_all` command which immediately warps all NPCs to their scheduled positions.
+
 ## 3.12.5
 Released 26 August 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
new file mode 100644
index 00000000..2deac5f8
--- /dev/null
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
@@ -0,0 +1,54 @@
+using System;
+using StardewValley;
+
+namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
+{
+    /// <summary>A command which immediately warps all NPCs to their scheduled positions. To hurry a single NPC, see <c>debug hurry npc-name</c> instead.</summary>
+    internal class HurryAllCommand : ConsoleCommand
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public HurryAllCommand()
+            : base(
+                name: "hurry_all",
+                description: "Immediately warps all NPCs to their scheduled positions. (To hurry a single NPC, use `debug hurry npc-name` instead.)\n\n"
+                    + "Usage: hurry_all"
+            )
+        { }
+
+        /// <summary>Handle the command.</summary>
+        /// <param name="monitor">Writes messages to the console and log file.</param>
+        /// <param name="command">The command name.</param>
+        /// <param name="args">The command arguments.</param>
+        public override void Handle(IMonitor monitor, string command, ArgumentParser args)
+        {
+            // check context
+            if (!Context.IsWorldReady)
+            {
+                monitor.Log("You need to load a save to use this command.", LogLevel.Error);
+                return;
+            }
+
+            // hurry all NPCs
+            foreach (NPC npc in Utility.getAllCharacters())
+            {
+                if (!npc.isVillager())
+                    continue;
+
+                monitor.Log($"Hurrying {npc.Name}...");
+                try
+                {
+                    npc.warpToPathControllerDestination();
+                }
+                catch (Exception ex)
+                {
+                    monitor.Log($"Failed hurrying {npc.Name}. Technical details:\n{ex}", LogLevel.Error);
+                }
+            }
+
+            monitor.Log("Done!", LogLevel.Info);
+        }
+    }
+}

From ec5fbb06113b29342e6d4b213144f4dc3e358b03 Mon Sep 17 00:00:00 2001
From: Chase Warrington <spacechase0.and.cat@gmail.com>
Date: Sun, 29 Aug 2021 15:48:28 -0400
Subject: [PATCH 268/856] Rewrite 32-bit assemblies for 64-bit

---
 .../Framework/ModLoading/AssemblyLoader.cs    |  7 ++++
 .../Framework/BaseInstructionHandler.cs       |  6 ++++
 .../ModLoading/Framework/RecursiveRewriter.cs | 13 ++++++-
 .../ModLoading/IInstructionHandler.cs         |  5 +++
 .../Rewriters/ArchitectureAssemblyRewriter.cs | 34 +++++++++++++++++++
 src/SMAPI/Metadata/InstructionMetadata.cs     |  3 ++
 6 files changed, 67 insertions(+), 1 deletion(-)
 create mode 100644 src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 3e35c9dd..ae42909c 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -336,6 +336,13 @@ namespace StardewModdingAPI.Framework.ModLoading
             IInstructionHandler[] handlers = new InstructionMetadata().GetHandlers(this.ParanoidMode, platformChanged, this.RewriteMods).ToArray();
             RecursiveRewriter rewriter = new RecursiveRewriter(
                 module: module,
+                rewriteModule: (module) =>
+                {
+                    bool rewritten = false;
+                    foreach (IInstructionHandler handler in handlers)
+                        rewritten |= handler.Handle(module);
+                    return rewritten;
+                },
                 rewriteType: (type, replaceWith) =>
                 {
                     bool rewritten = false;
diff --git a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
index 624113b3..d5d1b38e 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
@@ -24,6 +24,12 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         /*********
         ** Public methods
         *********/
+        /// <inheritdoc />
+        public virtual bool Handle(ModuleDefinition module)
+        {
+            return false;
+        }
+
         /// <inheritdoc />
         public virtual bool Handle(ModuleDefinition module, TypeReference type, Action<TypeReference> replaceWith)
         {
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
index 10f68f0d..52f4003c 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
@@ -13,6 +13,11 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         /*********
         ** Delegates
         *********/
+        /// <summary>Rewrite a module definition in the assembly code.</summary>
+        /// <param name="module">The current module definition.</param>
+        /// <returns>Returns whether the module was changed.</returns>
+        public delegate bool RewriteModuleDelegate(ModuleDefinition module);
+
         /// <summary>Rewrite a type reference in the assembly code.</summary>
         /// <param name="type">The current type reference.</param>
         /// <param name="replaceWith">Replaces the type reference with the given type.</param>
@@ -32,6 +37,9 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         /// <summary>The module to rewrite.</summary>
         public ModuleDefinition Module { get; }
 
+        /// <summary>Handle or rewrite a type reference if needed.</summary>
+        public RewriteModuleDelegate RewriteModuleImpl { get; }
+
         /// <summary>Handle or rewrite a type reference if needed.</summary>
         public RewriteTypeDelegate RewriteTypeImpl { get; }
 
@@ -46,9 +54,10 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         /// <param name="module">The module to rewrite.</param>
         /// <param name="rewriteType">Handle or rewrite a type reference if needed.</param>
         /// <param name="rewriteInstruction">Handle or rewrite a CIL instruction if needed.</param>
-        public RecursiveRewriter(ModuleDefinition module, RewriteTypeDelegate rewriteType, RewriteInstructionDelegate rewriteInstruction)
+        public RecursiveRewriter(ModuleDefinition module, RewriteModuleDelegate rewriteModule, RewriteTypeDelegate rewriteType, RewriteInstructionDelegate rewriteInstruction)
         {
             this.Module = module;
+            this.RewriteModuleImpl = rewriteModule;
             this.RewriteTypeImpl = rewriteType;
             this.RewriteInstructionImpl = rewriteInstruction;
         }
@@ -63,6 +72,8 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
 
             try
             {
+                changed |= this.RewriteModuleImpl( this.Module );
+
                 foreach (var type in types)
                     changed |= this.RewriteTypeDefinition(type);
             }
diff --git a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
index 17c9ba68..d41732f8 100644
--- a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
@@ -24,6 +24,11 @@ namespace StardewModdingAPI.Framework.ModLoading
         /*********
         ** Methods
         *********/
+        /// <summary>Rewrite a module definition if needed.</summary>
+        /// <param name="module">The assembly module.</param>
+        /// <returns>Returns whether the module was changed.</returns>
+        bool Handle(ModuleDefinition module);
+
         /// <summary>Rewrite a type reference if needed.</summary>
         /// <param name="module">The assembly module containing the instruction.</param>
         /// <param name="type">The type definition to handle.</param>
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
new file mode 100644
index 00000000..216c042a
--- /dev/null
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
@@ -0,0 +1,34 @@
+using System;
+using HarmonyLib;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+using StardewModdingAPI.Framework.ModLoading.Framework;
+using StardewModdingAPI.Framework.ModLoading.RewriteFacades;
+
+namespace StardewModdingAPI.Framework.ModLoading.Rewriters
+{
+    /// <summary>Rewrites Harmony 1.x assembly references to work with Harmony 2.x.</summary>
+    internal class ArchitectureAssemblyRewriter : BaseInstructionHandler
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public ArchitectureAssemblyRewriter()
+            : base(defaultPhrase: "32-bit architecture") { }
+
+
+        /// <inheritdoc />
+        public override bool Handle( ModuleDefinition module )
+        {
+            if ( module.Attributes.HasFlag( ModuleAttributes.Required32Bit ) )
+            {
+                module.Attributes = module.Attributes & ~ModuleAttributes.Required32Bit;
+                this.MarkRewritten();
+                return true;
+            }
+            return false;
+        }
+
+    }
+}
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index a787993a..54e46ed3 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -50,6 +50,9 @@ namespace StardewModdingAPI.Metadata
 
                 // rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
                 yield return new Harmony1AssemblyRewriter();
+
+                // rewrite for 64-bit mode
+                yield return new ArchitectureAssemblyRewriter();
             }
 
             /****

From 6edcfb1358e470a636a9e97780e05f2a0dcb6752 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 29 Aug 2021 23:01:47 -0400
Subject: [PATCH 269/856] tweak new code

---
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs    |  4 ++--
 .../ModLoading/Framework/RecursiveRewriter.cs       |  5 +++--
 .../Rewriters/ArchitectureAssemblyRewriter.cs       | 13 +++++--------
 src/SMAPI/Framework/SCore.cs                        |  2 +-
 4 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index ae42909c..7668e8a9 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -336,11 +336,11 @@ namespace StardewModdingAPI.Framework.ModLoading
             IInstructionHandler[] handlers = new InstructionMetadata().GetHandlers(this.ParanoidMode, platformChanged, this.RewriteMods).ToArray();
             RecursiveRewriter rewriter = new RecursiveRewriter(
                 module: module,
-                rewriteModule: (module) =>
+                rewriteModule: curModule =>
                 {
                     bool rewritten = false;
                     foreach (IInstructionHandler handler in handlers)
-                        rewritten |= handler.Handle(module);
+                        rewritten |= handler.Handle(curModule);
                     return rewritten;
                 },
                 rewriteType: (type, replaceWith) =>
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
index 52f4003c..4f14a579 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
@@ -37,7 +37,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         /// <summary>The module to rewrite.</summary>
         public ModuleDefinition Module { get; }
 
-        /// <summary>Handle or rewrite a type reference if needed.</summary>
+        /// <summary>Handle or rewrite a module definition if needed.</summary>
         public RewriteModuleDelegate RewriteModuleImpl { get; }
 
         /// <summary>Handle or rewrite a type reference if needed.</summary>
@@ -52,6 +52,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="module">The module to rewrite.</param>
+        /// <param name="rewriteModule">Handle or rewrite a module if needed.</param>
         /// <param name="rewriteType">Handle or rewrite a type reference if needed.</param>
         /// <param name="rewriteInstruction">Handle or rewrite a CIL instruction if needed.</param>
         public RecursiveRewriter(ModuleDefinition module, RewriteModuleDelegate rewriteModule, RewriteTypeDelegate rewriteType, RewriteInstructionDelegate rewriteInstruction)
@@ -72,7 +73,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
 
             try
             {
-                changed |= this.RewriteModuleImpl( this.Module );
+                changed |= this.RewriteModuleImpl(this.Module);
 
                 foreach (var type in types)
                     changed |= this.RewriteTypeDefinition(type);
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
index 216c042a..cc830216 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
@@ -1,13 +1,9 @@
-using System;
-using HarmonyLib;
 using Mono.Cecil;
-using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
-using StardewModdingAPI.Framework.ModLoading.RewriteFacades;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
 {
-    /// <summary>Rewrites Harmony 1.x assembly references to work with Harmony 2.x.</summary>
+    /// <summary>Removes the 32-bit-only from loaded assemblies.</summary>
     internal class ArchitectureAssemblyRewriter : BaseInstructionHandler
     {
         /*********
@@ -19,14 +15,15 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
 
 
         /// <inheritdoc />
-        public override bool Handle( ModuleDefinition module )
+        public override bool Handle(ModuleDefinition module)
         {
-            if ( module.Attributes.HasFlag( ModuleAttributes.Required32Bit ) )
+            if (module.Attributes.HasFlag(ModuleAttributes.Required32Bit))
             {
-                module.Attributes = module.Attributes & ~ModuleAttributes.Required32Bit;
+                module.Attributes &= ~ModuleAttributes.Required32Bit;
                 this.MarkRewritten();
                 return true;
             }
+
             return false;
         }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c1aa3721..61fb77b2 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1732,7 +1732,7 @@ namespace StardewModdingAPI.Framework
                 {
                     errorReasonPhrase = "its DLL couldn't be loaded.";
 #if SMAPI_FOR_WINDOWS_64BIT_HACK
-                    if (!EnvironmentUtility.Is64BitAssembly(assemblyPath))
+                    if (ex is BadImageFormatException && !EnvironmentUtility.Is64BitAssembly(assemblyPath))
                         errorReasonPhrase = "it needs to be updated for 64-bit mode.";
 #endif
                     errorDetails = $"Error: {ex.GetLogSummary()}";

From 789b62bcd6af0f87ab8d71ff5190fdb9163d9bef Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 1 Sep 2021 19:56:17 -0400
Subject: [PATCH 270/856] adjust rewriter for backport to Stardew Valley 1.5.4

---
 src/SMAPI/Metadata/InstructionMetadata.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 54e46ed3..9f537c92 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -52,7 +52,9 @@ namespace StardewModdingAPI.Metadata
                 yield return new Harmony1AssemblyRewriter();
 
                 // rewrite for 64-bit mode
+#if SMAPI_FOR_WINDOWS_64BIT_HACK
                 yield return new ArchitectureAssemblyRewriter();
+#endif
             }
 
             /****

From c6cc1513c5ab5544094fe30b13ee0d73e1e04109 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 1 Sep 2021 19:57:24 -0400
Subject: [PATCH 271/856] update release notes

---
 docs/release-notes.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 31a114a2..e8b019a9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Improved mod compatibility in 64-bit mode (thanks to spacechase0!).
+
 * For console commands:
   * Added `hurry_all` command which immediately warps all NPCs to their scheduled positions.
 

From 8bfab94213e86c4245961150bd3423ee85213c5d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 31 Aug 2021 01:13:22 -0400
Subject: [PATCH 272/856] reduce unneeded operations when scanning/rewriting
 mod DLLs

---
 docs/release-notes.md                         |  1 +
 .../Framework/ModLoading/AssemblyLoader.cs    | 15 ++---
 .../ModLoading/Finders/EventFinder.cs         | 61 +++++++++++--------
 .../ModLoading/Finders/FieldFinder.cs         | 38 +++++++++---
 ...ferenceToMemberWithUnexpectedTypeFinder.cs |  6 +-
 .../Finders/ReferenceToMissingMemberFinder.cs |  6 +-
 .../ModLoading/Finders/TypeFinder.cs          | 27 +++++---
 ...AssemblyRewriter.cs => HarmonyRewriter.cs} | 50 +++++++++------
 .../Rewriters/HeuristicFieldRewriter.cs       |  6 +-
 .../Rewriters/HeuristicMethodRewriter.cs      |  6 +-
 src/SMAPI/Metadata/InstructionMetadata.cs     | 36 ++++++-----
 11 files changed, 155 insertions(+), 97 deletions(-)
 rename src/SMAPI/Framework/ModLoading/Rewriters/{Harmony1AssemblyRewriter.cs => HarmonyRewriter.cs} (71%)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e8b019a9..a8db9cbd 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For players:
   * Improved mod compatibility in 64-bit mode (thanks to spacechase0!).
+  * Reducing load time when scanning/rewriting many mods for compatibility.
 
 * For console commands:
   * Added `hurry_all` command which immediately warps all NPCs to their scheduled positions.
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 7668e8a9..57a76a35 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -300,10 +300,10 @@ namespace StardewModdingAPI.Framework.ModLoading
                     // remove old assembly reference
                     if (this.AssemblyMap.RemoveNames.Any(name => module.AssemblyReferences[i].Name == name))
                     {
-                        this.Monitor.LogOnce(loggedMessages, $"{logPrefix}Rewriting {filename} for OS...");
                         platformChanged = true;
                         module.AssemblyReferences.RemoveAt(i);
                         i--;
+                        this.Monitor.LogOnce(loggedMessages, $"{logPrefix}Rewrote {filename} for OS...");
                     }
                 }
                 if (platformChanged)
@@ -394,7 +394,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                     break;
 
                 case InstructionHandleResult.DetectedGamePatch:
-                    template = $"{logPrefix}Detected game patcher ($phrase) in assembly {filename}.";
+                    template = $"{logPrefix}Detected game patcher in assembly {filename}."; // no need for phrase, which would confusingly be 'Harmony 1.x' here
                     mod.SetWarning(ModWarning.PatchesGame);
                     break;
 
@@ -438,13 +438,10 @@ namespace StardewModdingAPI.Framework.ModLoading
                 return;
 
             // format messages
-            if (handler.Phrases.Any())
-            {
-                foreach (string message in handler.Phrases)
-                    this.Monitor.LogOnce(loggedMessages, template.Replace("$phrase", message));
-            }
-            else
-                this.Monitor.LogOnce(loggedMessages, template.Replace("$phrase", handler.DefaultPhrase ?? handler.GetType().Name));
+            string phrase = handler.Phrases.Any()
+                ? string.Join(", ", handler.Phrases)
+                : handler.DefaultPhrase ?? handler.GetType().Name;
+            this.Monitor.LogOnce(loggedMessages, template.Replace("$phrase", phrase));
         }
 
         /// <summary>Get the correct reference to use for compatibility with the current platform.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
index 01ed153b..a2ea3232 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
@@ -1,3 +1,5 @@
+using System.Collections.Generic;
+using System.Linq;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
@@ -13,8 +15,8 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /// <summary>The full type name for which to find references.</summary>
         private readonly string FullTypeName;
 
-        /// <summary>The event name for which to find references.</summary>
-        private readonly string EventName;
+        /// <summary>The method names for which to find references.</summary>
+        private readonly ISet<string> MethodNames;
 
         /// <summary>The result to return for matching instructions.</summary>
         private readonly InstructionHandleResult Result;
@@ -23,40 +25,49 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="fullTypeName">The full type name for which to find references.</param>
+        /// <param name="eventNames">The event names for which to find references.</param>
+        /// <param name="result">The result to return for matching instructions.</param>
+        public EventFinder(string fullTypeName, string[] eventNames, InstructionHandleResult result)
+            : base(defaultPhrase: $"{string.Join(", ", eventNames.Select(p => $"{fullTypeName}.{p}"))} event{(eventNames.Length != 1 ? "s" : "")}") // default phrase should never be used
+        {
+            this.FullTypeName = fullTypeName;
+            this.Result = result;
+
+            this.MethodNames = new HashSet<string>();
+            foreach (string name in eventNames)
+            {
+                this.MethodNames.Add($"add_{name}");
+                this.MethodNames.Add($"remove_{name}");
+            }
+        }
+
         /// <summary>Construct an instance.</summary>
         /// <param name="fullTypeName">The full type name for which to find references.</param>
         /// <param name="eventName">The event name for which to find references.</param>
         /// <param name="result">The result to return for matching instructions.</param>
         public EventFinder(string fullTypeName, string eventName, InstructionHandleResult result)
-            : base(defaultPhrase: $"{fullTypeName}.{eventName} event")
-        {
-            this.FullTypeName = fullTypeName;
-            this.EventName = eventName;
-            this.Result = result;
-        }
+            : this(fullTypeName, new[] { eventName }, result) { }
 
         /// <inheritdoc />
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
-            if (!this.Flags.Contains(this.Result) && this.IsMatch(instruction))
-                this.MarkFlag(this.Result);
+            if (this.MethodNames.Any())
+            {
+                MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+                if (methodRef is not null && methodRef.DeclaringType.FullName == this.FullTypeName && this.MethodNames.Contains(methodRef.Name))
+                {
+                    string eventName = methodRef.Name.Split(new[] { '_' }, 2)[1];
+                    this.MethodNames.Remove($"add_{eventName}");
+                    this.MethodNames.Remove($"remove_{eventName}");
+
+                    this.MarkFlag(this.Result);
+                    this.Phrases.Add($"{this.FullTypeName}.{eventName} event");
+                }
+            }
 
             return false;
         }
-
-
-        /*********
-        ** Protected methods
-        *********/
-        /// <summary>Get whether a CIL instruction matches.</summary>
-        /// <param name="instruction">The IL instruction.</param>
-        protected bool IsMatch(Instruction instruction)
-        {
-            MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
-            return
-                methodRef != null
-                && methodRef.DeclaringType.FullName == this.FullTypeName
-                && (methodRef.Name == "add_" + this.EventName || methodRef.Name == "remove_" + this.EventName);
-        }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
index 2c062243..0947062c 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
@@ -1,3 +1,5 @@
+using System.Collections.Generic;
+using System.Linq;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
@@ -13,8 +15,8 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /// <summary>The full type name for which to find references.</summary>
         private readonly string FullTypeName;
 
-        /// <summary>The field name for which to find references.</summary>
-        private readonly string FieldName;
+        /// <summary>The field names for which to find references.</summary>
+        private readonly ISet<string> FieldNames;
 
         /// <summary>The result to return for matching instructions.</summary>
         private readonly InstructionHandleResult Result;
@@ -23,23 +25,39 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="fullTypeName">The full type name for which to find references.</param>
+        /// <param name="fieldNames">The field names for which to find references.</param>
+        /// <param name="result">The result to return for matching instructions.</param>
+        public FieldFinder(string fullTypeName, string[] fieldNames, InstructionHandleResult result)
+            : base(defaultPhrase: $"{string.Join(", ", fieldNames.Select(p => $"{fullTypeName}.{p}"))} field{(fieldNames.Length != 1 ? "s" : "")}") // default phrase should never be used
+        {
+            this.FullTypeName = fullTypeName;
+            this.FieldNames = new HashSet<string>(fieldNames);
+            this.Result = result;
+        }
+
         /// <summary>Construct an instance.</summary>
         /// <param name="fullTypeName">The full type name for which to find references.</param>
         /// <param name="fieldName">The field name for which to find references.</param>
         /// <param name="result">The result to return for matching instructions.</param>
         public FieldFinder(string fullTypeName, string fieldName, InstructionHandleResult result)
-            : base(defaultPhrase: $"{fullTypeName}.{fieldName} field")
-        {
-            this.FullTypeName = fullTypeName;
-            this.FieldName = fieldName;
-            this.Result = result;
-        }
+            : this(fullTypeName, new[] { fieldName }, result) { }
 
         /// <inheritdoc />
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
-            if (!this.Flags.Contains(this.Result) && RewriteHelper.IsFieldReferenceTo(instruction, this.FullTypeName, this.FieldName))
-                this.MarkFlag(this.Result);
+            if (this.FieldNames.Any())
+            {
+                FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
+                if (fieldRef is not null && fieldRef.DeclaringType.FullName == this.FullTypeName && this.FieldNames.Contains(fieldRef.Name))
+                {
+                    this.FieldNames.Remove(fieldRef.Name);
+
+                    this.MarkFlag(this.Result);
+                    this.Phrases.Add($"{this.FullTypeName}.{fieldRef.Name} field");
+                }
+            }
 
             return false;
         }
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
index b01a3240..8c1cae2b 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         ** Fields
         *********/
         /// <summary>The assembly names to which to heuristically detect broken references.</summary>
-        private readonly HashSet<string> ValidateReferencesToAssemblies;
+        private readonly ISet<string> ValidateReferencesToAssemblies;
 
 
         /*********
@@ -22,10 +22,10 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="validateReferencesToAssemblies">The assembly names to which to heuristically detect broken references.</param>
-        public ReferenceToMemberWithUnexpectedTypeFinder(string[] validateReferencesToAssemblies)
+        public ReferenceToMemberWithUnexpectedTypeFinder(ISet<string> validateReferencesToAssemblies)
             : base(defaultPhrase: "")
         {
-            this.ValidateReferencesToAssemblies = new HashSet<string>(validateReferencesToAssemblies);
+            this.ValidateReferencesToAssemblies = validateReferencesToAssemblies;
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
index b64a255e..d305daf4 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         ** Fields
         *********/
         /// <summary>The assembly names to which to heuristically detect broken references.</summary>
-        private readonly HashSet<string> ValidateReferencesToAssemblies;
+        private readonly ISet<string> ValidateReferencesToAssemblies;
 
 
         /*********
@@ -21,10 +21,10 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="validateReferencesToAssemblies">The assembly names to which to heuristically detect broken references.</param>
-        public ReferenceToMissingMemberFinder(string[] validateReferencesToAssemblies)
+        public ReferenceToMissingMemberFinder(ISet<string> validateReferencesToAssemblies)
             : base(defaultPhrase: "")
         {
-            this.ValidateReferencesToAssemblies = new HashSet<string>(validateReferencesToAssemblies);
+            this.ValidateReferencesToAssemblies = validateReferencesToAssemblies;
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
index bbd081e8..260a8df8 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
@@ -10,8 +11,8 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /*********
         ** Fields
         *********/
-        /// <summary>The full type name to match.</summary>
-        private readonly string FullTypeName;
+        /// <summary>The full type names remaining to match.</summary>
+        private readonly ISet<string> FullTypeNames;
 
         /// <summary>The result to return for matching instructions.</summary>
         private readonly InstructionHandleResult Result;
@@ -24,22 +25,34 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="fullTypeName">The full type name to match.</param>
+        /// <param name="fullTypeNames">The full type names to match.</param>
         /// <param name="result">The result to return for matching instructions.</param>
         /// <param name="shouldIgnore">Get whether a matched type should be ignored.</param>
-        public TypeFinder(string fullTypeName, InstructionHandleResult result, Func<TypeReference, bool> shouldIgnore = null)
-            : base(defaultPhrase: $"{fullTypeName} type")
+        public TypeFinder(string[] fullTypeNames, InstructionHandleResult result, Func<TypeReference, bool> shouldIgnore = null)
+            : base(defaultPhrase: $"{string.Join(", ", fullTypeNames)} type{(fullTypeNames.Length != 1 ? "s" : "")}") // default phrase should never be used
         {
-            this.FullTypeName = fullTypeName;
+            this.FullTypeNames = new HashSet<string>(fullTypeNames);
             this.Result = result;
             this.ShouldIgnore = shouldIgnore;
         }
 
+        /// <summary>Construct an instance.</summary>
+        /// <param name="fullTypeName">The full type name to match.</param>
+        /// <param name="result">The result to return for matching instructions.</param>
+        /// <param name="shouldIgnore">Get whether a matched type should be ignored.</param>
+        public TypeFinder(string fullTypeName, InstructionHandleResult result, Func<TypeReference, bool> shouldIgnore = null)
+            : this(new[] { fullTypeName }, result, shouldIgnore) { }
+
         /// <inheritdoc />
         public override bool Handle(ModuleDefinition module, TypeReference type, Action<TypeReference> replaceWith)
         {
-            if (type.FullName == this.FullTypeName && this.ShouldIgnore?.Invoke(type) != true)
+            if (this.FullTypeNames.Contains(type.FullName) && this.ShouldIgnore?.Invoke(type) != true)
+            {
+                this.FullTypeNames.Remove(type.FullName);
+
                 this.MarkFlag(this.Result);
+                this.Phrases.Add($"{type.FullName} type");
+            }
 
             return false;
         }
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
similarity index 71%
rename from src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
rename to src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
index 7a3b428d..38ab3d80 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/Harmony1AssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
@@ -7,8 +7,8 @@ using StardewModdingAPI.Framework.ModLoading.RewriteFacades;
 
 namespace StardewModdingAPI.Framework.ModLoading.Rewriters
 {
-    /// <summary>Rewrites Harmony 1.x assembly references to work with Harmony 2.x.</summary>
-    internal class Harmony1AssemblyRewriter : BaseInstructionHandler
+    /// <summary>Detects Harmony references, and rewrites Harmony 1.x assembly references to work with Harmony 2.x.</summary>
+    internal class HarmonyRewriter : BaseInstructionHandler
     {
         /*********
         ** Fields
@@ -16,19 +16,29 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /// <summary>Whether any Harmony 1.x types were replaced.</summary>
         private bool ReplacedTypes;
 
+        /// <summary>Whether to rewrite Harmony 1.x code.</summary>
+        private readonly bool ShouldRewrite;
+
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        public Harmony1AssemblyRewriter()
-            : base(defaultPhrase: "Harmony 1.x") { }
+        public HarmonyRewriter(bool shouldRewrite = true)
+            : base(defaultPhrase: "Harmony 1.x")
+        {
+            this.ShouldRewrite = shouldRewrite;
+        }
 
         /// <inheritdoc />
         public override bool Handle(ModuleDefinition module, TypeReference type, Action<TypeReference> replaceWith)
         {
+            // detect Harmony
+            if (type.Scope is not AssemblyNameReference { Name: "0Harmony" } scope)
+                return false;
+
             // rewrite Harmony 1.x type to Harmony 2.0 type
-            if (type.Scope is AssemblyNameReference { Name: "0Harmony" } scope && scope.Version.Major == 1)
+            if (this.ShouldRewrite && scope.Version.Major == 1)
             {
                 Type targetType = this.GetMappedType(type);
                 replaceWith(module.ImportReference(targetType));
@@ -37,28 +47,32 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
                 return true;
             }
 
+            this.MarkFlag(InstructionHandleResult.DetectedGamePatch);
             return false;
         }
 
         /// <inheritdoc />
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
-            // rewrite Harmony 1.x methods to Harmony 2.0
-            MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
-            if (this.TryRewriteMethodsToFacade(module, methodRef))
+            if (this.ShouldRewrite)
             {
-                this.OnChanged();
-                return true;
-            }
-
-            // rewrite renamed fields
-            FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
-            if (fieldRef != null)
-            {
-                if (fieldRef.DeclaringType.FullName == "HarmonyLib.HarmonyMethod" && fieldRef.Name == "prioritiy")
+                // rewrite Harmony 1.x methods to Harmony 2.0
+                MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+                if (this.TryRewriteMethodsToFacade(module, methodRef))
                 {
-                    fieldRef.Name = nameof(HarmonyMethod.priority);
                     this.OnChanged();
+                    return true;
+                }
+
+                // rewrite renamed fields
+                FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
+                if (fieldRef != null)
+                {
+                    if (fieldRef.DeclaringType.FullName == "HarmonyLib.HarmonyMethod" && fieldRef.Name == "prioritiy")
+                    {
+                        fieldRef.Name = nameof(HarmonyMethod.priority);
+                        this.OnChanged();
+                    }
                 }
             }
 
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
index f59a6ab1..57f1dd17 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         ** Fields
         *********/
         /// <summary>The assembly names to which to rewrite broken references.</summary>
-        private readonly HashSet<string> RewriteReferencesToAssemblies;
+        private readonly ISet<string> RewriteReferencesToAssemblies;
 
 
         /*********
@@ -21,10 +21,10 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="rewriteReferencesToAssemblies">The assembly names to which to rewrite broken references.</param>
-        public HeuristicFieldRewriter(string[] rewriteReferencesToAssemblies)
+        public HeuristicFieldRewriter(ISet<string> rewriteReferencesToAssemblies)
             : base(defaultPhrase: "field changed to property") // ignored since we specify phrases
         {
-            this.RewriteReferencesToAssemblies = new HashSet<string>(rewriteReferencesToAssemblies);
+            this.RewriteReferencesToAssemblies = rewriteReferencesToAssemblies;
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
index e133b6fa..89de437e 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         ** Fields
         *********/
         /// <summary>The assembly names to which to rewrite broken references.</summary>
-        private readonly HashSet<string> RewriteReferencesToAssemblies;
+        private readonly ISet<string> RewriteReferencesToAssemblies;
 
 
         /*********
@@ -21,10 +21,10 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="rewriteReferencesToAssemblies">The assembly names to which to rewrite broken references.</param>
-        public HeuristicMethodRewriter(string[] rewriteReferencesToAssemblies)
+        public HeuristicMethodRewriter(ISet<string> rewriteReferencesToAssemblies)
             : base(defaultPhrase: "methods with missing parameters") // ignored since we specify phrases
         {
-            this.RewriteReferencesToAssemblies = new HashSet<string>(rewriteReferencesToAssemblies);
+            this.RewriteReferencesToAssemblies = rewriteReferencesToAssemblies;
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 9f537c92..44d906ea 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -18,7 +18,7 @@ namespace StardewModdingAPI.Metadata
         *********/
         /// <summary>The assembly names to which to heuristically detect broken references.</summary>
         /// <remarks>The current implementation only works correctly with assemblies that should always be present.</remarks>
-        private readonly string[] ValidateReferencesToAssemblies = { "StardewModdingAPI", "Stardew Valley", "StardewValley", "Netcode" };
+        private readonly ISet<string> ValidateReferencesToAssemblies = new HashSet<string> { "StardewModdingAPI", "Stardew Valley", "StardewValley", "Netcode" };
 
 
         /*********
@@ -48,14 +48,16 @@ namespace StardewModdingAPI.Metadata
                 yield return new HeuristicFieldRewriter(this.ValidateReferencesToAssemblies);
                 yield return new HeuristicMethodRewriter(this.ValidateReferencesToAssemblies);
 
-                // rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
-                yield return new Harmony1AssemblyRewriter();
+                // detect Harmony & rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
+                yield return new HarmonyRewriter();
 
                 // rewrite for 64-bit mode
 #if SMAPI_FOR_WINDOWS_64BIT_HACK
                 yield return new ArchitectureAssemblyRewriter();
 #endif
             }
+            else
+                yield return new HarmonyRewriter(shouldRewrite: false);
 
             /****
             ** detect mod issues
@@ -67,13 +69,9 @@ namespace StardewModdingAPI.Metadata
             /****
             ** detect code which may impact game stability
             ****/
-            yield return new TypeFinder(typeof(HarmonyLib.Harmony).FullName, InstructionHandleResult.DetectedGamePatch);
             yield return new TypeFinder("System.Runtime.CompilerServices.CallSite", InstructionHandleResult.DetectedDynamic);
-            yield return new FieldFinder(typeof(SaveGame).FullName, nameof(SaveGame.serializer), InstructionHandleResult.DetectedSaveSerializer);
-            yield return new FieldFinder(typeof(SaveGame).FullName, nameof(SaveGame.farmerSerializer), InstructionHandleResult.DetectedSaveSerializer);
-            yield return new FieldFinder(typeof(SaveGame).FullName, nameof(SaveGame.locationSerializer), InstructionHandleResult.DetectedSaveSerializer);
-            yield return new EventFinder(typeof(ISpecializedEvents).FullName, nameof(ISpecializedEvents.UnvalidatedUpdateTicked), InstructionHandleResult.DetectedUnvalidatedUpdateTick);
-            yield return new EventFinder(typeof(ISpecializedEvents).FullName, nameof(ISpecializedEvents.UnvalidatedUpdateTicking), InstructionHandleResult.DetectedUnvalidatedUpdateTick);
+            yield return new FieldFinder(typeof(SaveGame).FullName, new[] { nameof(SaveGame.serializer), nameof(SaveGame.farmerSerializer), nameof(SaveGame.locationSerializer) }, InstructionHandleResult.DetectedSaveSerializer);
+            yield return new EventFinder(typeof(ISpecializedEvents).FullName, new[] { nameof(ISpecializedEvents.UnvalidatedUpdateTicked), nameof(ISpecializedEvents.UnvalidatedUpdateTicking) }, InstructionHandleResult.DetectedUnvalidatedUpdateTick);
 
             /****
             ** detect paranoid issues
@@ -82,13 +80,19 @@ namespace StardewModdingAPI.Metadata
             {
                 // filesystem access
                 yield return new TypeFinder(typeof(System.Console).FullName, InstructionHandleResult.DetectedConsoleAccess);
-                yield return new TypeFinder(typeof(System.IO.File).FullName, InstructionHandleResult.DetectedFilesystemAccess);
-                yield return new TypeFinder(typeof(System.IO.FileStream).FullName, InstructionHandleResult.DetectedFilesystemAccess);
-                yield return new TypeFinder(typeof(System.IO.FileInfo).FullName, InstructionHandleResult.DetectedFilesystemAccess);
-                yield return new TypeFinder(typeof(System.IO.Directory).FullName, InstructionHandleResult.DetectedFilesystemAccess);
-                yield return new TypeFinder(typeof(System.IO.DirectoryInfo).FullName, InstructionHandleResult.DetectedFilesystemAccess);
-                yield return new TypeFinder(typeof(System.IO.DriveInfo).FullName, InstructionHandleResult.DetectedFilesystemAccess);
-                yield return new TypeFinder(typeof(System.IO.FileSystemWatcher).FullName, InstructionHandleResult.DetectedFilesystemAccess);
+                yield return new TypeFinder(
+                    new[]
+                    {
+                        typeof(System.IO.File).FullName,
+                        typeof(System.IO.FileStream).FullName,
+                        typeof(System.IO.FileInfo).FullName,
+                        typeof(System.IO.Directory).FullName,
+                        typeof(System.IO.DirectoryInfo).FullName,
+                        typeof(System.IO.DriveInfo).FullName,
+                        typeof(System.IO.FileSystemWatcher).FullName
+                        },
+                    InstructionHandleResult.DetectedFilesystemAccess
+                );
 
                 // shell access
                 yield return new TypeFinder(typeof(System.Diagnostics.Process).FullName, InstructionHandleResult.DetectedShellAccess);

From 1240cb21024c3b715a6dacb2bec170a588a08791 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 1 Sep 2021 20:58:21 -0400
Subject: [PATCH 273/856] fix translations not initialized for temporary
 content packs

---
 docs/release-notes.md                         |  3 ++
 src/SMAPI/Framework/ContentPack.cs            | 10 ++--
 src/SMAPI/Framework/IModMetadata.cs           |  7 +++
 src/SMAPI/Framework/ModLoading/ModMetadata.cs | 18 +++++++
 src/SMAPI/Framework/SCore.cs                  | 50 ++++++++++++++++---
 5 files changed, 77 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a8db9cbd..1db50e26 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,9 @@
   * Improved mod compatibility in 64-bit mode (thanks to spacechase0!).
   * Reducing load time when scanning/rewriting many mods for compatibility.
 
+* For mod authors:
+  * Fixed content packs created via `helper.ContentPacks.CreateFake` or `CreateTemporary` not initializing translations correctly.
+
 * For console commands:
   * Added `hurry_all` command which immediately warps all NPCs to their scheduled positions.
 
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index 0660a367..b6add7b5 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using StardewModdingAPI.Framework.ModHelpers;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
 
@@ -32,7 +33,10 @@ namespace StardewModdingAPI.Framework
         public IManifest Manifest { get; }
 
         /// <inheritdoc />
-        public ITranslationHelper Translation { get; }
+        public ITranslationHelper Translation => this.TranslationImpl;
+
+        /// <summary>The underlying translation helper.</summary>
+        internal TranslationHelper TranslationImpl { get; set; }
 
 
         /*********
@@ -44,12 +48,12 @@ namespace StardewModdingAPI.Framework
         /// <param name="content">Provides an API for loading content assets.</param>
         /// <param name="translation">Provides translations stored in the content pack's <c>i18n</c> folder.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
-        public ContentPack(string directoryPath, IManifest manifest, IContentHelper content, ITranslationHelper translation, JsonHelper jsonHelper)
+        public ContentPack(string directoryPath, IManifest manifest, IContentHelper content, TranslationHelper translation, JsonHelper jsonHelper)
         {
             this.DirectoryPath = directoryPath;
             this.Manifest = manifest;
             this.Content = content;
-            this.Translation = translation;
+            this.TranslationImpl = translation;
             this.JsonHelper = jsonHelper;
 
             foreach (string path in Directory.EnumerateFiles(this.DirectoryPath, "*", SearchOption.AllDirectories))
diff --git a/src/SMAPI/Framework/IModMetadata.cs b/src/SMAPI/Framework/IModMetadata.cs
index f5babafb..cb876ee4 100644
--- a/src/SMAPI/Framework/IModMetadata.cs
+++ b/src/SMAPI/Framework/IModMetadata.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.ModHelpers;
 using StardewModdingAPI.Framework.ModLoading;
@@ -64,6 +65,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>The update-check metadata for this mod (if any).</summary>
         ModEntryModel UpdateCheckData { get; }
 
+        /// <summary>The fake content packs created by this mod, if any.</summary>
+        ISet<WeakReference<ContentPack>> FakeContentPacks { get; }
+
 
         /*********
         ** Public methods
@@ -135,5 +139,8 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Get a relative path which includes the root folder name.</summary>
         string GetRelativePathWithRoot();
+
+        /// <summary>Get the currently live fake content packs created by this mod.</summary>
+        IEnumerable<ContentPack> GetFakeContentPacks();
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index 0ace084f..9e6bc61f 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -83,6 +83,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <inheritdoc />
         public bool IsContentPack => this.Manifest?.ContentPackFor != null;
 
+        /// <summary>The fake content packs created by this mod, if any.</summary>
+        public ISet<WeakReference<ContentPack>> FakeContentPacks { get; } = new HashSet<WeakReference<ContentPack>>();
+
 
         /*********
         ** Public methods
@@ -244,6 +247,21 @@ namespace StardewModdingAPI.Framework.ModLoading
             return Path.Combine(rootFolderName, this.RelativeDirectoryPath);
         }
 
+        /// <summary>Get the currently live fake content packs created by this mod.</summary>
+        public IEnumerable<ContentPack> GetFakeContentPacks()
+        {
+            foreach (var reference in this.FakeContentPacks.ToArray())
+            {
+                if (!reference.TryGetTarget(out ContentPack pack))
+                {
+                    this.FakeContentPacks.Remove(reference);
+                    continue;
+                }
+
+                yield return pack;
+            }
+        }
+
 
         /*********
         ** Private methods
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 61fb77b2..f7efc89e 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -49,6 +49,7 @@ using StardewModdingAPI.Utilities;
 using StardewValley;
 using xTile.Display;
 using MiniMonoModHotfix = MonoMod.Utils.MiniMonoModHotfix;
+using PathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 using SObject = StardewValley.Object;
 
 namespace StardewModdingAPI.Framework
@@ -1060,7 +1061,12 @@ namespace StardewModdingAPI.Framework
 
             // update mod translation helpers
             foreach (IModMetadata mod in this.ModRegistry.GetAll())
+            {
                 mod.Translations.SetLocale(locale, languageCode);
+
+                foreach (ContentPack contentPack in mod.GetFakeContentPacks())
+                    contentPack.TranslationImpl.SetLocale(locale, languageCode);
+            }
         }
 
         /// <summary>Raised when the low-level stage while loading a save changes.</summary>
@@ -1772,8 +1778,12 @@ namespace StardewModdingAPI.Framework
                         {
                             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
                             IContentHelper packContentHelper = new ContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, packMonitor);
-                            ITranslationHelper packTranslationHelper = new TranslationHelper(packManifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
-                            return new ContentPack(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper);
+                            TranslationHelper packTranslationHelper = new TranslationHelper(packManifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
+
+                            ContentPack contentPack = new ContentPack(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper);
+                            this.ReloadTranslationsForTemporaryContentPack(mod, contentPack);
+                            mod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
+                            return contentPack;
                         }
 
                         IModEvents events = new ModEvents(mod, this.EventManager);
@@ -1867,17 +1877,41 @@ namespace StardewModdingAPI.Framework
             // mod translations
             foreach (IModMetadata metadata in mods)
             {
-                var translations = this.ReadTranslationFiles(Path.Combine(metadata.DirectoryPath, "i18n"), out IList<string> errors);
-                if (errors.Any())
+                // top-level mod
                 {
-                    metadata.LogAsMod("Mod couldn't load some translation files:", LogLevel.Warn);
-                    foreach (string error in errors)
-                        metadata.LogAsMod($"  - {error}", LogLevel.Warn);
+                    var translations = this.ReadTranslationFiles(Path.Combine(metadata.DirectoryPath, "i18n"), out IList<string> errors);
+                    if (errors.Any())
+                    {
+                        metadata.LogAsMod("Mod couldn't load some translation files:", LogLevel.Warn);
+                        foreach (string error in errors)
+                            metadata.LogAsMod($"  - {error}", LogLevel.Warn);
+                    }
+
+                    metadata.Translations.SetTranslations(translations);
                 }
-                metadata.Translations.SetTranslations(translations);
+
+                // fake content packs
+                foreach (ContentPack pack in metadata.GetFakeContentPacks())
+                    this.ReloadTranslationsForTemporaryContentPack(metadata, pack);
             }
         }
 
+        /// <summary>Load or reload translations for a temporary content pack created by a mod.</summary>
+        /// <param name="parentMod">The parent mod which created the content pack.</param>
+        /// <param name="contentPack">The content pack instance.</param>
+        private void ReloadTranslationsForTemporaryContentPack(IModMetadata parentMod, ContentPack contentPack)
+        {
+            var translations = this.ReadTranslationFiles(Path.Combine(contentPack.DirectoryPath, "i18n"), out IList<string> errors);
+            if (errors.Any())
+            {
+                parentMod.LogAsMod($"Generated content pack at '{PathUtilities.GetRelativePath(Constants.ModsPath, contentPack.DirectoryPath)}' couldn't load some translation files:", LogLevel.Warn);
+                foreach (string error in errors)
+                    parentMod.LogAsMod($"  - {error}", LogLevel.Warn);
+            }
+
+            contentPack.TranslationImpl.SetTranslations(translations);
+        }
+
         /// <summary>Read translations from a directory containing JSON translation files.</summary>
         /// <param name="folderPath">The folder path to search.</param>
         /// <param name="errors">The errors indicating why translation files couldn't be parsed, indexed by translation filename.</param>

From cf1d800b58bdd8c5f0ebb018da4cce6fad27adb0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 1 Sep 2021 21:03:02 -0400
Subject: [PATCH 274/856] add Big Silo to compatibility list

---
 docs/release-notes.md                     |  1 +
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 55 ++++++++++++-----------
 2 files changed, 31 insertions(+), 25 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1db50e26..ba2fe46a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,7 @@
 * For players:
   * Improved mod compatibility in 64-bit mode (thanks to spacechase0!).
   * Reducing load time when scanning/rewriting many mods for compatibility.
+  * Updated compatibility list.
 
 * For mod authors:
   * Fixed content packs created via `helper.ContentPacks.CreateFake` or `CreateTemporary` not initializing translations correctly.
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 7dff16c4..dcdd6298 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -170,6 +170,36 @@
         /*********
         ** Broke in SMAPI 3.12.0
         *********/
+        "Always Scroll Map": {
+            "ID": "bcmpinc.AlwaysScrollMap",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Big Silo": {
+            "ID": "lperkins2.BigSilo",
+            "~0.0.3 | Status": "AssumeBroken",
+            "~0.0.3 | StatusReasonDetails": "not compatible with Harmony 2.x"
+        },
+        "Fix Animal Tools": {
+            "ID": "bcmpinc.FixAnimalTools",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Grass Growth": {
+            "ID": "bcmpinc.GrassGrowth",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Harvest With Scythe (bcmpinc)": {
+            "ID": "bcmpinc.HarvestWithScythe",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
+        "Movement Speed": {
+            "ID": "bcmpinc.MovementSpeed",
+            "~4.1.0 | Status": "AssumeBroken",
+            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
+        },
         "PlatoTK": {
             "ID": "Platonymous.PlatoTK",
             "~1.9.3 | Status": "AssumeBroken",
@@ -180,36 +210,11 @@
             "~5.0.0 | Status": "AssumeBroken",
             "~5.0.0 | StatusReasonDetails": "causes Harmony patching errors for other mods"
         },
-        "Always Scroll Map": {
-            "ID": "bcmpinc.AlwaysScrollMap",
-            "~4.1.0 | Status": "AssumeBroken",
-            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
-        },
-        "Fix Animal Tools": {
-            "ID": "bcmpinc.FixAnimalTools",
-            "~4.1.0 | Status": "AssumeBroken",
-            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
-        },
-        "Harvest With Scythe (bcmpinc)": {
-            "ID": "bcmpinc.HarvestWithScythe",
-            "~4.1.0 | Status": "AssumeBroken",
-            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
-        },
-        "Grass Growth": {
-            "ID": "bcmpinc.GrassGrowth",
-            "~4.1.0 | Status": "AssumeBroken",
-            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
-        },
         "Tilled Soil Decay": {
             "ID": "bcmpinc.TilledSoilDecay",
             "~4.1.0 | Status": "AssumeBroken",
             "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
         },
-        "Movement Speed": {
-            "ID": "bcmpinc.MovementSpeed",
-            "~4.1.0 | Status": "AssumeBroken",
-            "~4.1.0 | StatusReasonDetails": "causes Harmony patching errors for other mods" // requested by the mod author
-        },
         "Tree Spread": {
             "ID": "bcmpinc.TreeSpread",
             "~4.2.0 | Status": "AssumeBroken",

From 5848a355bac789ba8d879df64bea400d17ea83f5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 1 Sep 2021 21:48:08 -0400
Subject: [PATCH 275/856] add friendly errors when using SMAPI 3.12.x with
 Stardew Valley 1.5.5+

---
 docs/release-notes.md                       | 1 +
 src/SMAPI.Installer/InteractiveInstaller.cs | 8 ++++++++
 src/SMAPI/Constants.cs                      | 2 +-
 src/SMAPI/Program.cs                        | 4 ++++
 4 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ba2fe46a..45670c29 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Added friendly error when using SMAPI 3.2._x_ with Stardew Valley 1.5.5 or later.
   * Improved mod compatibility in 64-bit mode (thanks to spacechase0!).
   * Reducing load time when scanning/rewriting many mods for compatibility.
   * Updated compatibility list.
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index b91d0dd3..17c3198f 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -298,6 +298,14 @@ namespace StardewModdingApi.Installer
                 return;
             }
 
+            // not Stardew Valley 1.5.5+
+            if (File.Exists(Path.Combine(paths.GamePath, "Stardew Valley.dll")))
+            {
+                this.PrintError($"Oops! The detected game install path seems to be Stardew Valley 1.5.5 or later, but this version of SMAPI is only compatible up to Stardew Valley 1.5.4. Please check for a newer version of SMAPI: https://smapi.io.");
+                Console.ReadLine();
+                return;
+            }
+
             // game folder doesn't contain paths beyond the max limit
             {
                 string[] tooLongPaths = PathUtilities.GetTooLongPaths(Path.Combine(paths.GamePath, "Mods")).ToArray();
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 04e15998..247e32b7 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -81,7 +81,7 @@ namespace StardewModdingAPI
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");
 
         /// <summary>The maximum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MaximumGameVersion { get; } = null;
+        public static ISemanticVersion MaximumGameVersion { get; } = new GameVersion("1.5.4");
 
         /// <summary>The target game platform.</summary>
         public static GamePlatform TargetPlatform { get; } = EarlyConstants.Platform;
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 3249e02f..b6464f3c 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -88,6 +88,10 @@ namespace StardewModdingAPI
                 if (!File.Exists(Path.Combine(EarlyConstants.ExecutionPath, $"{EarlyConstants.GameAssemblyName}.exe")))
                     Program.PrintErrorAndExit("Oops! SMAPI can't find the game. Make sure you're running StardewModdingAPI.exe in your game folder.");
 
+                // Stardew Valley 1.5.5+
+                if (File.Exists(Path.Combine(EarlyConstants.ExecutionPath, "Stardew Valley.dll")))
+                    Program.PrintErrorAndExit("Oops! You're running Stardew Valley 1.5.5 or later, but this version of SMAPI is only compatible up to Stardew Valley 1.5.4. Please check for a newer version of SMAPI: https://smapi.io.");
+
                 // can't load file
                 Program.PrintErrorAndExit(
                     message: "Oops! SMAPI couldn't load the game executable. The technical details below may have more info.",

From 8789b7efa816aab0f4ce9d3149c26b8033e0b0a5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 2 Sep 2021 18:54:56 -0400
Subject: [PATCH 276/856] prepare path utilities for the upcoming Stardew
 Valley 1.5.5

The game will use Linux-style paths for assets on all platforms, which will break the current equivalence between path and asset name formats.
---
 docs/release-notes.md                         |  6 +++++
 .../Utilities/PathUtilitiesTests.cs           | 26 +++++++++++++++++--
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs  | 15 +++++++++--
 .../Framework/Content/AssetDataForMap.cs      |  6 ++---
 src/SMAPI/Utilities/PathUtilities.cs          | 17 +++++++++++-
 5 files changed, 62 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 45670c29..53640c93 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,11 +9,17 @@
   * Updated compatibility list.
 
 * For mod authors:
+  * Added `PathUtilities.NormalizeAssetName` and `PathUtilities.PreferredAssetSeparator` to prepare for the upcoming Stardew Valley 1.5.5.
   * Fixed content packs created via `helper.ContentPacks.CreateFake` or `CreateTemporary` not initializing translations correctly.
 
 * For console commands:
   * Added `hurry_all` command which immediately warps all NPCs to their scheduled positions.
 
+**Update note for mod authors:**  
+Stardew Valley 1.5.5 will change how asset names are formatted. If you use `PathUtilities.NormalizePath`
+to format asset names, you should switch to `PathUtilities.NormalizeAssetName` now so your code will
+continue working in the next game update.
+
 ## 3.12.5
 Released 26 August 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
index 5a342974..c18f47a5 100644
--- a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
+++ b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
@@ -1,3 +1,4 @@
+using System.IO;
 using NUnit.Framework;
 using StardewModdingAPI.Toolkit.Utilities;
 
@@ -175,9 +176,30 @@ namespace SMAPI.Tests.Utilities
         }
 
         /****
-        ** NormalizePathSeparators
+        ** NormalizeAssetName
         ****/
-        [Test(Description = "Assert that PathUtilities.NormalizePathSeparators normalizes paths correctly.")]
+        [Test(Description = "Assert that PathUtilities.NormalizeAssetName normalizes paths correctly.")]
+        [TestCaseSource(nameof(PathUtilitiesTests.SamplePaths))]
+        public void NormalizeAssetName(SamplePath path)
+        {
+            if (Path.IsPathRooted(path.OriginalPath) || path.OriginalPath.StartsWith("/") || path.OriginalPath.StartsWith("\\"))
+                Assert.Ignore("Absolute paths can't be used as asset names.");
+
+            // act
+            string normalized = PathUtilities.NormalizeAssetName(path.OriginalPath);
+
+            // assert
+#if SMAPI_FOR_WINDOWS
+            Assert.AreEqual(path.NormalizedOnWindows, normalized);
+#else
+            Assert.AreEqual(path.NormalizedOnUnix, normalized);
+#endif
+        }
+
+        /****
+        ** NormalizePath
+        ****/
+        [Test(Description = "Assert that PathUtilities.NormalizePath normalizes paths correctly.")]
         [TestCaseSource(nameof(PathUtilitiesTests.SamplePaths))]
         public void NormalizePath(SamplePath path)
         {
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index babc0981..020ebc6d 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -23,9 +23,12 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <summary>The possible directory separator characters in a file path.</summary>
         public static readonly char[] PossiblePathSeparators = new[] { '/', '\\', Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar }.Distinct().ToArray();
 
-        /// <summary>The preferred directory separator character in an asset key.</summary>
+        /// <summary>The preferred directory separator character in a file path.</summary>
         public static readonly char PreferredPathSeparator = Path.DirectorySeparatorChar;
 
+        /// <summary>The preferred directory separator character in an asset key.</summary>
+        public static readonly char PreferredAssetSeparator = PathUtilities.PreferredPathSeparator;
+
 
         /*********
         ** Public methods
@@ -41,8 +44,16 @@ namespace StardewModdingAPI.Toolkit.Utilities
                 : path.Split(PathUtilities.PossiblePathSeparators, StringSplitOptions.RemoveEmptyEntries);
         }
 
-        /// <summary>Normalize separators in a file path.</summary>
+        /// <summary>Normalize an asset name to match how MonoGame's content APIs would normalize and cache it.</summary>
+        /// <param name="assetName">The asset name to normalize.</param>
+        public static string NormalizeAssetName(string assetName)
+        {
+            return string.Join(PathUtilities.PreferredAssetSeparator.ToString(), PathUtilities.GetSegments(assetName)); // based on MonoGame's ContentManager.Load<T> logic
+        }
+
+        /// <summary>Normalize separators in a file path for the current platform.</summary>
         /// <param name="path">The file path to normalize.</param>
+        /// <remarks>This should only be used for file paths. For asset names, use <see cref="NormalizeAssetName"/> instead.</remarks>
         [Pure]
         public static string NormalizePath(string path)
         {
diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 20f0ed0f..4f810948 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -153,9 +153,9 @@ namespace StardewModdingAPI.Framework.Content
             if (string.IsNullOrWhiteSpace(path))
                 return string.Empty;
 
-            path = PathUtilities.NormalizePath(path);
-            if (path.StartsWith($"Maps{PathUtilities.PreferredPathSeparator}", StringComparison.OrdinalIgnoreCase))
-                path = path.Substring($"Maps{PathUtilities.PreferredPathSeparator}".Length);
+            path = PathUtilities.NormalizeAssetName(path);
+            if (path.StartsWith($"Maps{PathUtilities.PreferredAssetSeparator}", StringComparison.OrdinalIgnoreCase))
+                path = path.Substring($"Maps{PathUtilities.PreferredAssetSeparator}".Length);
             if (path.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
                 path = path.Substring(0, path.Length - 4);
 
diff --git a/src/SMAPI/Utilities/PathUtilities.cs b/src/SMAPI/Utilities/PathUtilities.cs
index 19f16ea9..541b163c 100644
--- a/src/SMAPI/Utilities/PathUtilities.cs
+++ b/src/SMAPI/Utilities/PathUtilities.cs
@@ -6,6 +6,13 @@ namespace StardewModdingAPI.Utilities
     /// <summary>Provides utilities for normalizing file paths.</summary>
     public static class PathUtilities
     {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The preferred directory separator character in an asset key.</summary>
+        public static char PreferredAssetSeparator { get; } = ToolkitPathUtilities.PreferredAssetSeparator;
+
+
         /*********
         ** Public methods
         *********/
@@ -18,8 +25,16 @@ namespace StardewModdingAPI.Utilities
             return ToolkitPathUtilities.GetSegments(path, limit);
         }
 
-        /// <summary>Normalize separators in a file path.</summary>
+        /// <summary>Normalize an asset name to match how MonoGame's content APIs would normalize and cache it.</summary>
+        /// <param name="assetName">The asset name to normalize.</param>
+        public static string NormalizeAssetName(string assetName)
+        {
+            return ToolkitPathUtilities.NormalizeAssetName(assetName);
+        }
+
+        /// <summary>Normalize separators in a file path for the current platform.</summary>
         /// <param name="path">The file path to normalize.</param>
+        /// <remarks>This should only be used for file paths. For asset names, use <see cref="NormalizeAssetName"/> instead.</remarks>
         [Pure]
         public static string NormalizePath(string path)
         {

From 0ce8939988159723851e4e64eeb82b026f982ef5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 2 Sep 2021 19:27:49 -0400
Subject: [PATCH 277/856] avoid duplicate update key parsing logic, fix unit
 tests

---
 src/SMAPI.Tests/Core/ModResolverTests.cs      |  5 ++++-
 src/SMAPI.Toolkit/ModToolkit.cs               | 21 ++++++++-----------
 src/SMAPI/Framework/ModLoading/ModResolver.cs |  5 +++--
 3 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index 28262111..da3446bb 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -10,6 +10,7 @@ using StardewModdingAPI.Framework;
 using StardewModdingAPI.Framework.ModLoading;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.ModData;
+using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Toolkit.Serialization.Models;
 using SemanticVersion = StardewModdingAPI.SemanticVersion;
 
@@ -489,7 +490,8 @@ namespace SMAPI.Tests.Core
                 EntryDll = entryDll ?? $"{Sample.String()}.dll",
                 ContentPackFor = contentPackForID != null ? new ManifestContentPackFor { UniqueID = contentPackForID } : null,
                 MinimumApiVersion = minimumApiVersion != null ? new SemanticVersion(minimumApiVersion) : null,
-                Dependencies = dependencies
+                Dependencies = dependencies ?? new IManifestDependency[0],
+                UpdateKeys = new string[0]
             };
         }
 
@@ -541,6 +543,7 @@ namespace SMAPI.Tests.Core
             mod.Setup(p => p.Manifest).Returns(this.GetManifest());
             mod.Setup(p => p.DirectoryPath).Returns(Path.GetTempPath());
             mod.Setup(p => p.DataRecord).Returns(modRecord);
+            mod.Setup(p => p.GetUpdateKeys(It.IsAny<bool>())).Returns(Enumerable.Empty<UpdateKey>());
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/ModToolkit.cs b/src/SMAPI.Toolkit/ModToolkit.cs
index 695a2c52..38a67ae5 100644
--- a/src/SMAPI.Toolkit/ModToolkit.cs
+++ b/src/SMAPI.Toolkit/ModToolkit.cs
@@ -1,4 +1,3 @@
-using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -8,6 +7,7 @@ using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
 using StardewModdingAPI.Toolkit.Framework.GameScanning;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
+using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Toolkit.Serialization;
 
 namespace StardewModdingAPI.Toolkit
@@ -22,11 +22,11 @@ namespace StardewModdingAPI.Toolkit
         private readonly string UserAgent;
 
         /// <summary>Maps vendor keys (like <c>Nexus</c>) to their mod URL template (where <c>{0}</c> is the mod ID). This doesn't affect update checks, which defer to the remote web API.</summary>
-        private readonly IDictionary<string, string> VendorModUrls = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)
+        private readonly IDictionary<ModSiteKey, string> VendorModUrls = new Dictionary<ModSiteKey, string>()
         {
-            ["Chucklefish"] = "https://community.playstarbound.com/resources/{0}",
-            ["GitHub"] = "https://github.com/{0}/releases",
-            ["Nexus"] = "https://www.nexusmods.com/stardewvalley/mods/{0}"
+            [ModSiteKey.Chucklefish] = "https://community.playstarbound.com/resources/{0}",
+            [ModSiteKey.GitHub] = "https://github.com/{0}/releases",
+            [ModSiteKey.Nexus] = "https://www.nexusmods.com/stardewvalley/mods/{0}"
         };
 
 
@@ -89,15 +89,12 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="updateKey">The update key.</param>
         public string GetUpdateUrl(string updateKey)
         {
-            string[] parts = updateKey.Split(new[] { ':' }, 2);
-            if (parts.Length != 2)
+            UpdateKey parsed = UpdateKey.Parse(updateKey);
+            if (!parsed.LooksValid)
                 return null;
 
-            string vendorKey = parts[0].Trim();
-            string modID = parts[1].Trim();
-
-            if (this.VendorModUrls.TryGetValue(vendorKey, out string urlTemplate))
-                return string.Format(urlTemplate, modID);
+            if (this.VendorModUrls.TryGetValue(parsed.Site, out string urlTemplate))
+                return string.Format(urlTemplate, parsed.ID);
 
             return null;
         }
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 2f506571..4b05d1e5 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
+using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Toolkit.Serialization.Models;
 using StardewModdingAPI.Toolkit.Utilities;
 
@@ -82,9 +83,9 @@ namespace StardewModdingAPI.Framework.ModLoading
 
                             // get update URLs
                             List<string> updateUrls = new List<string>();
-                            foreach (string key in mod.Manifest.UpdateKeys)
+                            foreach (UpdateKey key in mod.GetUpdateKeys(validOnly: true))
                             {
-                                string url = getUpdateUrl(key);
+                                string url = getUpdateUrl(key.ToString());
                                 if (url != null)
                                     updateUrls.Add(url);
                             }

From 169ce01810a66cbaaf793adaad1659809721336d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 2 Sep 2021 21:24:10 -0400
Subject: [PATCH 278/856] fix build errors on Linux

---
 src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs       | 2 +-
 src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs       | 2 +-
 src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
index a2ea3232..124951a5 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
@@ -56,7 +56,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
             if (this.MethodNames.Any())
             {
                 MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
-                if (methodRef is not null && methodRef.DeclaringType.FullName == this.FullTypeName && this.MethodNames.Contains(methodRef.Name))
+                if (methodRef != null && methodRef.DeclaringType.FullName == this.FullTypeName && this.MethodNames.Contains(methodRef.Name))
                 {
                     string eventName = methodRef.Name.Split(new[] { '_' }, 2)[1];
                     this.MethodNames.Remove($"add_{eventName}");
diff --git a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
index 0947062c..68415123 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
             if (this.FieldNames.Any())
             {
                 FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
-                if (fieldRef is not null && fieldRef.DeclaringType.FullName == this.FullTypeName && this.FieldNames.Contains(fieldRef.Name))
+                if (fieldRef != null && fieldRef.DeclaringType.FullName == this.FullTypeName && this.FieldNames.Contains(fieldRef.Name))
                 {
                     this.FieldNames.Remove(fieldRef.Name);
 
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
index 38ab3d80..922d4bc4 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
@@ -34,7 +34,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         public override bool Handle(ModuleDefinition module, TypeReference type, Action<TypeReference> replaceWith)
         {
             // detect Harmony
-            if (type.Scope is not AssemblyNameReference { Name: "0Harmony" } scope)
+            if (!(type.Scope is AssemblyNameReference scope) || scope.Name != "0Harmony")
                 return false;
 
             // rewrite Harmony 1.x type to Harmony 2.0 type

From bbaa260007f67d6e3c88c1aae387b42b0c237063 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 2 Sep 2021 23:01:40 -0400
Subject: [PATCH 279/856] drop support for unofficial 64-bit mode

---
 build/common.targets                          |  7 +--
 docs/release-notes.md                         |  3 +-
 docs/technical/smapi.md                       | 16 ++-----
 src/SMAPI.Installer/InteractiveInstaller.cs   | 48 ++++++-------------
 .../SMAPI.Mods.ConsoleCommands.csproj         |  2 +-
 .../SMAPI.Mods.ErrorHandler.csproj            |  2 +-
 src/SMAPI/Constants.cs                        | 12 +----
 src/SMAPI/Framework/Content/ContentCache.cs   |  2 -
 src/SMAPI/Framework/Logging/LogManager.cs     | 22 +--------
 src/SMAPI/Framework/SCore.cs                  | 18 ++++---
 src/SMAPI/Metadata/InstructionMetadata.cs     |  9 ++--
 src/SMAPI/Program.cs                          | 20 ++++----
 src/SMAPI/SMAPI.csproj                        |  6 +--
 13 files changed, 48 insertions(+), 119 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 70f0a741..e688ae65 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -6,13 +6,8 @@
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
 
-    <!--uncomment for 64-bit Stardew Valley on Windows-->
-    <!--<GamePath>D:\dev\SDV 64-bit\6125897</GamePath>
-    <DefineConstants>$(DefineConstants);SMAPI_FOR_WINDOWS_64BIT_HACK</DefineConstants>-->
-
     <!--set platform-->
-    <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
-    <DefineConstants Condition="$(OS) == 'Windows_NT' AND !$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))">$(DefineConstants);SMAPI_FOR_XNA</DefineConstants>
+    <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS;SMAPI_FOR_XNA</DefineConstants>
   </PropertyGroup>
 
   <!--find game folder-->
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 53640c93..3779bcac 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,7 +5,8 @@
 * For players:
   * Added friendly error when using SMAPI 3.2._x_ with Stardew Valley 1.5.5 or later.
   * Improved mod compatibility in 64-bit mode (thanks to spacechase0!).
-  * Reducing load time when scanning/rewriting many mods for compatibility.
+  * Reduced load time when scanning/rewriting many mods for compatibility.
+  * **Dropped support for unofficial 64-bit mode**. You can now use the [official 64-bit Stardew Valley 1.5.5 beta](https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows) instead.
   * Updated compatibility list.
 
 * For mod authors:
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 586b17aa..4be062e2 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -57,8 +57,7 @@ SMAPI uses a small number of conditional compilation constants, which you can se
 flag | purpose
 ---- | -------
 `SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/macOS. Set automatically in `common.targets`.
-`SMAPI_FOR_WINDOWS_64BIT_HACK` | Whether SMAPI is being [compiled for Windows with a 64-bit Linux version of the game](https://github.com/Pathoschild/SMAPI/issues/767). This is highly specialized and shouldn't be used in most cases. False by default.
-`SMAPI_FOR_XNA` | Whether SMAPI is being compiled for XNA Framework; if not set, the code assumes MonoGame. Set automatically in `common.targets` with the same value as `SMAPI_FOR_WINDOWS` (unless `SMAPI_FOR_WINDOWS_64BIT_HACK` is set).
+`SMAPI_FOR_XNA` | Whether SMAPI is being compiled for XNA Framework; if not set, the code assumes MonoGame. Set automatically in `common.targets` with the same value as `SMAPI_FOR_WINDOWS`.
 
 ## For SMAPI developers
 ### Compiling from source
@@ -81,9 +80,7 @@ To prepare a crossplatform SMAPI release, you'll need to compile it on two platf
 [crossplatforming info](https://stardewvalleywiki.com/Modding:Modder_Guide/Test_and_Troubleshoot#Testing_on_all_platforms)
 on the wiki for the first-time setup.
 
-1. [Install a separate 64-bit version of Stardew Valley](https://github.com/Steviegt6/Stardew64Installer#readme)
-   on Windows.
-2. Update the version numbers in `build/common.targets`, `Constants`, and the `manifest.json` for
+1. Update the version numbers in `build/common.targets`, `Constants`, and the `manifest.json` for
    bundled mods. Make sure you use a [semantic version](https://semver.org). Recommended format:
 
    build type | format                   | example
@@ -91,14 +88,9 @@ on the wiki for the first-time setup.
    dev build  | `<version>-alpha.<date>` | `3.0.0-alpha.20171230`
    prerelease | `<version>-beta.<date>`  | `3.0.0-beta.20171230`
    release    | `<version>`              | `3.0.0`
-3. In Windows:
+2. In Windows:
    1. Rebuild the solution with the _release_ solution configuration.
-   2. Back up the `bin/SMAPI installer` and `bin/SMAPI installer for developers` folders.
-   3. Edit `common.targets` and uncomment the Stardew Valley 64-bit section at the top.
-   4. Rebuild the solution again.
-   5. Rename the compiled `StardewModdingAPI.exe` file to `StardewModdingAPI-x64.exe`, and copy it
-      into the `windows-install.dat` files from step ii.
-   6. Copy the folders from step ii to Linux/MacOS.
+   2. Copy the `bin/SMAPI installer` and `bin/SMAPI installer for developers` folders to Linux/macOS.
 4. In Linux/macOS:
    1. Rebuild the solution with the _release_ solution configuration.
    2. Add the `windows-install.*` files from Windows to the `bin/SMAPI installer` and
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 17c3198f..9f49137f 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -275,21 +275,20 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 4: detect 64-bit Stardew Valley
+            ** Step 4: validate assumptions
             *********/
-            // detect 64-bit mode
-            bool isWindows64Bit = false;
+            // not 64-bit on Windows
             if (context.Platform == Platform.Windows)
             {
                 FileInfo linuxExecutable = new FileInfo(Path.Combine(paths.GamePath, "StardewValley.exe"));
-                isWindows64Bit = linuxExecutable.Exists && this.Is64Bit(linuxExecutable.FullName);
-                if (isWindows64Bit)
-                    paths.SetExecutableFileName(linuxExecutable.Name);
+                if (linuxExecutable.Exists && this.Is64Bit(linuxExecutable.FullName))
+                {
+                    this.PrintError("Oops! The detected game install path seems to be unofficial 64-bit mode, which is no longer supported. You can update to Stardew Valley 1.5.5 or later instead. See https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows for more info.");
+                    Console.ReadLine();
+                    return;
+                }
             }
 
-            /*********
-            ** Step 5: validate assumptions
-            *********/
             // executable exists
             if (!File.Exists(paths.ExecutablePath))
             {
@@ -301,7 +300,7 @@ namespace StardewModdingApi.Installer
             // not Stardew Valley 1.5.5+
             if (File.Exists(Path.Combine(paths.GamePath, "Stardew Valley.dll")))
             {
-                this.PrintError($"Oops! The detected game install path seems to be Stardew Valley 1.5.5 or later, but this version of SMAPI is only compatible up to Stardew Valley 1.5.4. Please check for a newer version of SMAPI: https://smapi.io.");
+                this.PrintError("Oops! The detected game install path seems to be Stardew Valley 1.5.5 or later, but this version of SMAPI is only compatible up to Stardew Valley 1.5.4. Please check for a newer version of SMAPI: https://smapi.io.");
                 Console.ReadLine();
                 return;
             }
@@ -320,7 +319,7 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 6: ask what to do
+            ** Step 5: ask what to do
             *********/
             ScriptAction action;
             {
@@ -328,7 +327,7 @@ namespace StardewModdingApi.Installer
                 ** print header
                 ****/
                 this.PrintInfo("Hi there! I'll help you install or remove SMAPI. Just one question first.");
-                this.PrintDebug($"Game path: {paths.GamePath}{(context.IsWindows ? $" [{(isWindows64Bit ? "64-bit" : "32-bit")}]" : "")}");
+                this.PrintDebug($"Game path: {paths.GamePath}");
                 this.PrintDebug($"Color scheme: {this.GetDisplayText(scheme)}");
                 this.PrintDebug("----------------------------------------------------------------------------");
                 Console.WriteLine();
@@ -366,14 +365,14 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 7: apply
+            ** Step 6: apply
             *********/
             {
                 /****
                 ** print header
                 ****/
                 this.PrintInfo($"That's all I need! I'll {action.ToString().ToLower()} SMAPI now.");
-                this.PrintDebug($"Game path: {paths.GamePath}{(context.IsWindows ? $" [{(isWindows64Bit ? "64-bit" : "32-bit")}]" : "")}");
+                this.PrintDebug($"Game path: {paths.GamePath}");
                 this.PrintDebug($"Color scheme: {this.GetDisplayText(scheme)}");
                 this.PrintDebug("----------------------------------------------------------------------------");
                 Console.WriteLine();
@@ -434,25 +433,6 @@ namespace StardewModdingApi.Installer
                         this.RecursiveCopy(sourceEntry, paths.GameDir);
                     }
 
-                    // handle 64-bit file
-                    {
-                        FileInfo x64Executable = new FileInfo(Path.Combine(paths.GameDir.FullName, "StardewModdingAPI-x64.exe"));
-                        if (isWindows64Bit)
-                        {
-                            this.PrintDebug("Making SMAPI 64-bit...");
-                            if (x64Executable.Exists)
-                            {
-                                string targetPath = Path.Combine(paths.GameDir.FullName, "StardewModdingAPI.exe");
-                                this.InteractivelyDelete(targetPath);
-                                x64Executable.MoveTo(targetPath);
-                            }
-                            else
-                                this.PrintError($"Oops! Could not find the required '{x64Executable.Name}' installer file. SMAPI may not work correctly.");
-                        }
-                        else if (x64Executable.Exists)
-                            x64Executable.Delete();
-                    }
-
                     // replace mod launcher (if possible)
                     if (context.IsUnix)
                     {
@@ -547,7 +527,7 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 7: final instructions
+            ** Step 6: final instructions
             *********/
             if (context.IsWindows)
             {
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index 432fdc35..a187c1ff 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -19,7 +19,7 @@
 
   <!-- Windows only -->
   <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" Condition="!$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))" />
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
   </ItemGroup>
 
   <!-- Game framework -->
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index ffda5f89..eb878bc5 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -21,7 +21,7 @@
 
   <!-- Windows only -->
   <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" Condition="!$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))" />
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
   </ItemGroup>
 
   <!-- Game framework -->
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 247e32b7..ebb504db 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -39,14 +39,6 @@ namespace StardewModdingAPI
         /// <summary>The target game platform.</summary>
         internal static GamePlatform Platform { get; } = (GamePlatform)Enum.Parse(typeof(GamePlatform), LowLevelEnvironmentUtility.DetectPlatform());
 
-        /// <summary>Whether SMAPI is being compiled for Windows with a 64-bit Linux version of the game. This is highly specialized and shouldn't be used in most cases.</summary>
-        internal static bool IsWindows64BitHack { get; } =
-#if SMAPI_FOR_WINDOWS_64BIT_HACK
-            true;
-#else
-            false;
-#endif
-
         /// <summary>The game framework running the game.</summary>
         internal static GameFramework GameFramework { get; } =
 #if SMAPI_FOR_XNA
@@ -56,7 +48,7 @@ namespace StardewModdingAPI
 #endif
 
         /// <summary>The game's assembly name.</summary>
-        internal static string GameAssemblyName => EarlyConstants.Platform == GamePlatform.Windows && !EarlyConstants.IsWindows64BitHack ? "Stardew Valley" : "StardewValley";
+        internal static string GameAssemblyName => EarlyConstants.Platform == GamePlatform.Windows ? "Stardew Valley" : "StardewValley";
 
         /// <summary>The <see cref="Context.ScreenId"/> value which should appear in the SMAPI log, if any.</summary>
         internal static int? LogScreenId { get; set; }
@@ -269,7 +261,7 @@ namespace StardewModdingAPI
             targetAssemblies.Add(typeof(StardewModdingAPI.IManifest).Assembly);
 
             // get changes for platform
-            if (Constants.Platform != Platform.Windows || EarlyConstants.IsWindows64BitHack)
+            if (Constants.Platform != Platform.Windows)
             {
                 removeAssemblyReferences.AddRange(new[]
                 {
diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index 5c7ad778..7edc9ab9 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -57,8 +57,6 @@ namespace StardewModdingAPI.Framework.Content
                 IReflectedMethod method = reflection.GetMethod(typeof(TitleContainer), "GetCleanPath");
                 this.NormalizeAssetNameForPlatform = path => method.Invoke<string>(path);
             }
-            else if (EarlyConstants.IsWindows64BitHack)
-                this.NormalizeAssetNameForPlatform = PathUtilities.NormalizePath;
             else
                 this.NormalizeAssetNameForPlatform = key => key.Replace('\\', '/'); // based on MonoGame's ContentManager.Load<T> logic
         }
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index c6faa90d..6fe44d98 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -291,13 +291,7 @@ namespace StardewModdingAPI.Framework.Logging
         public void LogIntro(string modsPath, IDictionary<string, object> customSettings)
         {
             // log platform & patches
-            {
-                this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
-
-                string[] patchLabels = this.GetPatchLabels().ToArray();
-                if (patchLabels.Any())
-                    this.Monitor.Log($"Detected custom version: {string.Join(", ", patchLabels)}", LogLevel.Info);
-            }
+            this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
 
             // log basic info
             this.Monitor.Log($"Mods go here: {modsPath}", LogLevel.Info);
@@ -416,20 +410,6 @@ namespace StardewModdingAPI.Framework.Logging
             gameMonitor.Log(message, level);
         }
 
-        /// <summary>Get human-readable labels to log for detected SMAPI and Stardew Valley customizations.</summary>
-        private IEnumerable<string> GetPatchLabels()
-        {
-            // custom game framework
-            if (EarlyConstants.IsWindows64BitHack)
-                yield return $"running 64-bit SMAPI with {Constants.GameFramework}";
-            else if ((Constants.GameFramework == GameFramework.Xna) != (Constants.Platform == Platform.Windows))
-                yield return $"running {Constants.GameFramework}";
-
-            // patched by Stardew64Installer
-            if (Constants.IsPatchedByStardew64Installer(out ISemanticVersion patchedByVersion))
-                yield return $"patched by Stardew64Installer {patchedByVersion}";
-        }
-
         /// <summary>Write a summary of mod warnings to the console and log.</summary>
         /// <param name="mods">The loaded mods.</param>
         /// <param name="skippedMods">The mods which could not be loaded.</param>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index f7efc89e..ce5a701d 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -12,10 +12,10 @@ using System.Security;
 using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
+using Microsoft.Xna.Framework;
 #if SMAPI_FOR_WINDOWS
 using Microsoft.Win32;
 #endif
-using Microsoft.Xna.Framework;
 #if SMAPI_FOR_XNA
 using System.Windows.Forms;
 #endif
@@ -436,7 +436,7 @@ namespace StardewModdingAPI.Framework
             Game1.mapDisplayDevice = new SDisplayDevice(Game1.content, Game1.game1.GraphicsDevice);
 
             // log GPU info
-#if SMAPI_FOR_WINDOWS && !SMAPI_FOR_WINDOWS_64BIT_HACK
+#if SMAPI_FOR_WINDOWS
             this.Monitor.Log($"Running on GPU: {Game1.game1.GraphicsDevice?.Adapter?.Description ?? "<unknown>"}");
 #endif
         }
@@ -1267,10 +1267,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>Set the titles for the game and console windows.</summary>
         private void UpdateWindowTitles()
         {
-            string smapiVersion = $"{Constants.ApiVersion}{(EarlyConstants.IsWindows64BitHack ? " [64-bit]" : "")}";
-
-            string consoleTitle = $"SMAPI {smapiVersion} - running Stardew Valley {Constants.GameVersion}";
-            string gameTitle = $"Stardew Valley {Constants.GameVersion} - running SMAPI {smapiVersion}";
+            string consoleTitle = $"SMAPI {Constants.ApiVersion} - running Stardew Valley {Constants.GameVersion}";
+            string gameTitle = $"Stardew Valley {Constants.GameVersion} - running SMAPI {Constants.ApiVersion}";
 
             if (this.ModRegistry.AreAllModsLoaded)
             {
@@ -1737,10 +1735,10 @@ namespace StardewModdingAPI.Framework
                 catch (Exception ex)
                 {
                     errorReasonPhrase = "its DLL couldn't be loaded.";
-#if SMAPI_FOR_WINDOWS_64BIT_HACK
-                    if (ex is BadImageFormatException && !EnvironmentUtility.Is64BitAssembly(assemblyPath))
-                        errorReasonPhrase = "it needs to be updated for 64-bit mode.";
-#endif
+                    // re-enable in Stardew Valley 1.5.5
+                    //if (ex is BadImageFormatException && !EnvironmentUtility.Is64BitAssembly(assemblyPath))
+                    //    errorReasonPhrase = "it needs to be updated for 64-bit mode.";
+
                     errorDetails = $"Error: {ex.GetLogSummary()}";
                     failReason = ModFailReason.LoadFailed;
                     return false;
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 44d906ea..76371e50 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -48,13 +48,12 @@ namespace StardewModdingAPI.Metadata
                 yield return new HeuristicFieldRewriter(this.ValidateReferencesToAssemblies);
                 yield return new HeuristicMethodRewriter(this.ValidateReferencesToAssemblies);
 
+                // rewrite for 64-bit mode
+                // re-enable in Stardew Valley 1.5.5
+                //yield return new ArchitectureAssemblyRewriter();
+
                 // detect Harmony & rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
                 yield return new HarmonyRewriter();
-
-                // rewrite for 64-bit mode
-#if SMAPI_FOR_WINDOWS_64BIT_HACK
-                yield return new ArchitectureAssemblyRewriter();
-#endif
             }
             else
                 yield return new HarmonyRewriter(shouldRewrite: false);
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index b6464f3c..3f97e531 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -26,7 +26,7 @@ namespace StardewModdingAPI
         /// <param name="args">The command-line arguments.</param>
         public static void Main(string[] args)
         {
-            Console.Title = $"SMAPI {EarlyConstants.RawApiVersion}{(EarlyConstants.IsWindows64BitHack ? " 64-bit" : "")} - {Console.Title}";
+            Console.Title = $"SMAPI {EarlyConstants.RawApiVersion} - {Console.Title}";
 
             try
             {
@@ -84,6 +84,14 @@ namespace StardewModdingAPI
             }
             catch (Exception ex)
             {
+                // unofficial 64-bit
+                if (EarlyConstants.Platform == GamePlatform.Windows)
+                {
+                    FileInfo linuxExecutable = new FileInfo(Path.Combine(EarlyConstants.ExecutionPath, "StardewValley.exe"));
+                    if (linuxExecutable.Exists && LowLevelEnvironmentUtility.Is64BitAssembly(linuxExecutable.FullName))
+                        Program.PrintErrorAndExit("Oops! You're running Stardew Valley in unofficial 64-bit mode, which is no longer supported. You can update to Stardew Valley 1.5.5 or later instead. See https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows for more info.");
+                }
+
                 // file doesn't exist
                 if (!File.Exists(Path.Combine(EarlyConstants.ExecutionPath, $"{EarlyConstants.GameAssemblyName}.exe")))
                     Program.PrintErrorAndExit("Oops! SMAPI can't find the game. Make sure you're running StardewModdingAPI.exe in your game folder.");
@@ -116,16 +124,6 @@ namespace StardewModdingAPI
             // max version
             if (Constants.MaximumGameVersion != null && Constants.GameVersion.IsNewerThan(Constants.MaximumGameVersion))
                 Program.PrintErrorAndExit($"Oops! You're running Stardew Valley {Constants.GameVersion}, but this version of SMAPI is only compatible up to Stardew Valley {Constants.MaximumGameVersion}. Please check for a newer version of SMAPI: https://smapi.io.");
-
-            // bitness
-            bool is64BitGame = LowLevelEnvironmentUtility.Is64BitAssembly(Path.Combine(EarlyConstants.ExecutionPath, $"{EarlyConstants.GameAssemblyName}.exe"));
-#if SMAPI_FOR_WINDOWS_64BIT_HACK
-            if (!is64BitGame)
-                Program.PrintErrorAndExit("Oops! This is the 64-bit version of SMAPI, but you have the 32-bit version of Stardew Valley. You can reinstall SMAPI using its installer to automatically install the correct version of SMAPI.");
-#elif SMAPI_FOR_WINDOWS
-            if (is64BitGame)
-                Program.PrintErrorAndExit("Oops! This is the 32-bit version of SMAPI, but you have the 64-bit version of Stardew Valley. You can reinstall SMAPI using its installer to automatically install the correct version of SMAPI.");
-#endif
         }
 
         /// <summary>Assert that the versions of all SMAPI components are correct.</summary>
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 7d5e7ef9..0f1b0516 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -14,10 +14,6 @@
 
   <Import Project="..\..\build\common.targets" />
 
-  <PropertyGroup Condition="$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))">
-    <PlatformTarget>x64</PlatformTarget>
-  </PropertyGroup>
-
   <ItemGroup>
     <PackageReference Include="LargeAddressAware" Version="1.0.5" />
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
@@ -39,7 +35,7 @@
 
   <!-- Windows only -->
   <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" Condition="!$(DefineConstants.Contains(SMAPI_FOR_WINDOWS_64BIT_HACK))" />
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
     <Reference Include="System.Windows.Forms" />
   </ItemGroup>
 

From 9f1c4549345ba20d799cf46ee44851a1f61f561e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 3 Sep 2021 18:35:23 -0400
Subject: [PATCH 280/856] remove asset propagation for Data/Bundles

---
 docs/release-notes.md                     |  2 ++
 src/SMAPI/Framework/SCore.cs              | 37 -----------------------
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 28 -----------------
 3 files changed, 2 insertions(+), 65 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3779bcac..65e6a489 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,8 @@
 
 * For mod authors:
   * Added `PathUtilities.NormalizeAssetName` and `PathUtilities.PreferredAssetSeparator` to prepare for the upcoming Stardew Valley 1.5.5.
+  * **SMAPI no longer propagates changes to `Data/Bundles`.**  
+    _You can still load/edit the asset like usual, but if bundles have already been loaded for a save, SMAPI will no longer dynamically update the in-game bundles to reflect the changes. Unfortunately this caused bundle corruption when playing in non-English._
   * Fixed content packs created via `helper.ContentPacks.CreateFake` or `CreateTemporary` not initializing translations correctly.
 
 * For console commands:
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index ce5a701d..5913430e 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -787,9 +787,6 @@ namespace StardewModdingAPI.Framework
 
                         this.Monitor.Log(context);
 
-                        // apply save fixes
-                        this.ApplySaveFixes();
-
                         // raise events
                         this.OnLoadStageChanged(LoadStage.Ready);
                         events.SaveLoaded.RaiseEmpty();
@@ -1107,40 +1104,6 @@ namespace StardewModdingAPI.Framework
                 this.EventManager.ReturnedToTitle.RaiseEmpty();
         }
 
-        /// <summary>Apply fixes to the save after it's loaded.</summary>
-        private void ApplySaveFixes()
-        {
-            // get last SMAPI version used with this save
-            const string migrationKey = "Pathoschild.SMAPI/api-version";
-            if (!Game1.CustomData.TryGetValue(migrationKey, out string rawVersion) || !SemanticVersion.TryParse(rawVersion, out ISemanticVersion lastVersion))
-                lastVersion = new SemanticVersion(3, 8, 0);
-
-            // fix bundle corruption in SMAPI 3.8.0
-            // For non-English players who created a new save in SMAPI 3.8.0, bundle data was
-            // incorrectly translated which caused the code to crash whenever the game tried to
-            // read it.
-            if (lastVersion.IsOlderThan(new SemanticVersion(3, 8, 1)) && Game1.netWorldState?.Value?.BundleData != null)
-            {
-                var oldData = new Dictionary<string, string>(Game1.netWorldState.Value.BundleData);
-
-                try
-                {
-                    Game1.applySaveFix(SaveGame.SaveFixes.FixBotchedBundleData);
-                    bool changed = Game1.netWorldState.Value.BundleData.Any(p => oldData.TryGetValue(p.Key, out string oldValue) && oldValue != p.Value);
-                    if (changed)
-                        this.Monitor.Log("Found broken community center bundles and fixed them automatically.", LogLevel.Info);
-                }
-                catch (Exception ex)
-                {
-                    this.Monitor.Log("Failed to verify community center data.", LogLevel.Error); // should never happen
-                    this.Monitor.Log($"Technical details: {ex}");
-                }
-            }
-
-            // update last run
-            Game1.CustomData[migrationKey] = Constants.ApiVersion.ToString();
-        }
-
         /// <summary>A callback invoked before <see cref="Game1.newDayAfterFade"/> runs.</summary>
         protected void OnNewDayAfterFade()
         {
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index a8686ca4..708673c3 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -4,7 +4,6 @@ using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using Microsoft.Xna.Framework.Graphics;
-using Netcode;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Internal;
@@ -16,7 +15,6 @@ using StardewValley.Characters;
 using StardewValley.GameData.Movies;
 using StardewValley.Locations;
 using StardewValley.Menus;
-using StardewValley.Network;
 using StardewValley.Objects;
 using StardewValley.Projectiles;
 using StardewValley.TerrainFeatures;
@@ -283,32 +281,6 @@ namespace StardewModdingAPI.Metadata
                     Game1.bigCraftablesInformation = content.Load<Dictionary<int, string>>(key);
                     return true;
 
-                case "data\\bundles": // NetWorldState constructor
-                    if (Context.IsMainPlayer && Game1.netWorldState != null)
-                    {
-                        var bundles = this.Reflection.GetField<NetBundles>(Game1.netWorldState.Value, "bundles").GetValue();
-                        var rewards = this.Reflection.GetField<NetIntDictionary<bool, NetBool>>(Game1.netWorldState.Value, "bundleRewards").GetValue();
-                        foreach (var pair in content.Load<Dictionary<string, string>>(key))
-                        {
-                            int bundleKey = int.Parse(pair.Key.Split('/')[1]);
-                            int rewardsCount = pair.Value.Split('/')[2].Split(' ').Length;
-
-                            // add bundles
-                            if (!bundles.TryGetValue(bundleKey, out bool[] values) || values.Length < rewardsCount)
-                            {
-                                values ??= new bool[0];
-
-                                bundles.Remove(bundleKey);
-                                bundles[bundleKey] = values.Concat(Enumerable.Repeat(false, rewardsCount - values.Length)).ToArray();
-                            }
-
-                            // add bundle rewards
-                            if (!rewards.ContainsKey(bundleKey))
-                                rewards[bundleKey] = false;
-                        }
-                    }
-                    break;
-
                 case "data\\clothinginformation": // Game1.LoadContent
                     Game1.clothingInformation = content.Load<Dictionary<int, string>>(key);
                     return true;

From 6d4ea7f0bd584602632e6e308d52bb369b30006f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 3 Sep 2021 18:36:12 -0400
Subject: [PATCH 281/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index e688ae65..5eb69901 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.5</Version>
+    <Version>3.12.6</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 65e6a489..4e0a9df6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,7 +1,9 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.6
+Released 03 September 2021 for Stardew Valley 1.5.4 or later.
+
 * For players:
   * Added friendly error when using SMAPI 3.2._x_ with Stardew Valley 1.5.5 or later.
   * Improved mod compatibility in 64-bit mode (thanks to spacechase0!).
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 540d0488..de223c01 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.5",
+    "Version": "3.12.6",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.5"
+    "MinimumApiVersion": "3.12.6"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 645a7514..fcb6d7eb 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.5",
+    "Version": "3.12.6",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.5"
+    "MinimumApiVersion": "3.12.6"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index d8b77339..1c84b5c2 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.5",
+    "Version": "3.12.6",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.5"
+    "MinimumApiVersion": "3.12.6"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index ebb504db..d0c693bf 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.5";
+        internal static string RawApiVersion = "3.12.6";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From a9fcbc686d203b20f8e4b127e213b7028b3a9ae1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 8 Sep 2021 19:01:40 -0400
Subject: [PATCH 282/856] fix error when loading corrupted translation files

---
 docs/release-notes.md        | 4 ++++
 src/SMAPI/Framework/SCore.cs | 4 ++--
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4e0a9df6..c04ac4e5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Fixed crash loading mods if they have corrupted translation files.
+
 ## 3.12.6
 Released 03 September 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 5913430e..df6cd129 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1891,9 +1891,9 @@ namespace StardewModdingAPI.Framework
                     string locale = Path.GetFileNameWithoutExtension(file.Name.ToLower().Trim());
                     try
                     {
-                        if (!jsonHelper.ReadJsonFileIfExists(file.FullName, out IDictionary<string, string> data))
+                        if (!jsonHelper.ReadJsonFileIfExists(file.FullName, out IDictionary<string, string> data) || data == null)
                         {
-                            errors.Add($"{file.Name} file couldn't be read"); // should never happen, since we're iterating files that exist
+                            errors.Add($"{file.Name} file couldn't be read"); // mainly happens when the file is corrupted or empty
                             continue;
                         }
 

From 4fccaa35709440f98e275f0da3d2b65204b7d6e2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 13 Sep 2021 00:01:14 -0400
Subject: [PATCH 283/856] add nullable support in JSON converters

---
 docs/release-notes.md                                      | 5 ++++-
 .../Serialization/Converters/SimpleReadOnlyConverter.cs    | 7 ++++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c04ac4e5..0678f6e1 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,7 +3,10 @@
 # Release notes
 ## Upcoming release
 * For players:
-  * Fixed crash loading mods if they have corrupted translation files.
+  * Fixed crash loading mods with corrupted translation files.
+
+* For mod authors:
+  * Improved SMAPI's crossplatform read/writing of `Color`, `Point`, `Rectangle`, and `Vector2` in JSON to support nullable fields too.
 
 ## 3.12.6
 Released 03 September 2021 for Stardew Valley 1.5.4 or later.
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
index 549f0c18..ccc5158b 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         /// <param name="objectType">The object type.</param>
         public override bool CanConvert(Type objectType)
         {
-            return objectType == typeof(T);
+            return objectType == typeof(T) || Nullable.GetUnderlyingType(objectType) == typeof(T);
         }
 
         /// <summary>Writes the JSON representation of the object.</summary>
@@ -44,10 +44,15 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
             string path = reader.Path;
             switch (reader.TokenType)
             {
+                case JsonToken.Null when Nullable.GetUnderlyingType(objectType) != null:
+                    return null;
+
                 case JsonToken.StartObject:
                     return this.ReadObject(JObject.Load(reader), path);
+
                 case JsonToken.String:
                     return this.ReadString(JToken.Load(reader).Value<string>(), path);
+
                 default:
                     throw new SParseException($"Can't parse {typeof(T).Name} from {reader.TokenType} node (path: {reader.Path}).");
             }

From a40ef854f3769a0e5d3c2629de538e272a6fcecf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 13 Sep 2021 18:20:36 -0400
Subject: [PATCH 284/856] fix JSON validator line numbers sometimes incorrect

---
 docs/release-notes.md                         |  3 +++
 .../Controllers/JsonValidatorController.cs    | 26 ++++++++++++-------
 2 files changed, 19 insertions(+), 10 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0678f6e1..ddd0526b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 * For mod authors:
   * Improved SMAPI's crossplatform read/writing of `Color`, `Point`, `Rectangle`, and `Vector2` in JSON to support nullable fields too.
 
+* For the web UI:
+  * Fixed JSON validator line numbers sometimes incorrect.
+
 ## 3.12.6
 Released 03 September 2021 for Stardew Valley 1.5.4 or later.
 
diff --git a/src/SMAPI.Web/Controllers/JsonValidatorController.cs b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
index c77a3036..e06c1236 100644
--- a/src/SMAPI.Web/Controllers/JsonValidatorController.cs
+++ b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
@@ -90,21 +90,27 @@ namespace StardewModdingAPI.Web.Controllers
 
             // parse JSON
             JToken parsed;
-            try
             {
-                parsed = JToken.Parse(file.Content, new JsonLoadSettings
+                // load raw JSON
+                var settings = new JsonLoadSettings
                 {
                     DuplicatePropertyNameHandling = DuplicatePropertyNameHandling.Error,
                     CommentHandling = CommentHandling.Load
-                });
-            }
-            catch (JsonReaderException ex)
-            {
-                return this.View("Index", result.AddErrors(new JsonValidatorErrorModel(ex.LineNumber, ex.Path, ex.Message, ErrorType.None)));
-            }
+                };
+                try
+                {
+                    parsed = JToken.Parse(file.Content, settings);
+                }
+                catch (JsonReaderException ex)
+                {
+                    return this.View("Index", result.AddErrors(new JsonValidatorErrorModel(ex.LineNumber, ex.Path, ex.Message, ErrorType.None)));
+                }
 
-            // format JSON
-            result.SetContent(parsed.ToString(Formatting.Indented), expiry: file.Expiry, uploadWarning: file.Warning);
+                // format JSON
+                string formatted = parsed.ToString(Formatting.Indented);
+                result.SetContent(formatted, expiry: file.Expiry, uploadWarning: file.Warning);
+                parsed = JToken.Parse(formatted); // update line number references
+            }
 
             // skip if no schema selected
             if (schemaName == "none")

From f6f4470d955c75531d40a9dc3a353d261c715d4a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 13 Sep 2021 18:30:59 -0400
Subject: [PATCH 285/856] enable beta info on the mod compatibility list by
 default

---
 docs/release-notes.md                 | 1 +
 src/SMAPI.Web/Views/Mods/Index.cshtml | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ddd0526b..c706619c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
   * Improved SMAPI's crossplatform read/writing of `Color`, `Point`, `Rectangle`, and `Vector2` in JSON to support nullable fields too.
 
 * For the web UI:
+  * The mod compatibility list now shows the beta status by default (if any).
   * Fixed JSON validator line numbers sometimes incorrect.
 
 ## 3.12.6
diff --git a/src/SMAPI.Web/Views/Mods/Index.cshtml b/src/SMAPI.Web/Views/Mods/Index.cshtml
index 7dcd0718..5df49afb 100644
--- a/src/SMAPI.Web/Views/Mods/Index.cshtml
+++ b/src/SMAPI.Web/Views/Mods/Index.cshtml
@@ -45,7 +45,7 @@ else
 
             @if (hasBeta)
             {
-                <p id="beta-blurb" v-show="showAdvanced"><strong>Note:</strong> "@betaLabel" lines are for an unreleased version of SMAPI, not the stable version most players have. If a mod doesn't have that line, the info applies to both versions of SMAPI.</p>
+                <p id="beta-blurb"><strong>Note:</strong> "@betaLabel" lines are for the beta version of Stardew Valley, not the stable version most players have. If a mod doesn't have that line, the info applies to both versions.</p>
             }
         </div>
 
@@ -99,7 +99,7 @@ else
                     </td>
                     <td>
                         <div v-html="mod.Compatibility.Summary"></div>
-                        <div v-if="mod.BetaCompatibility" v-show="showAdvanced">
+                        <div v-if="mod.BetaCompatibility">
                             <strong v-if="mod.BetaCompatibility">@betaLabel:</strong>
                             <span v-html="mod.BetaCompatibility.Summary"></span>
                         </div>

From 4a7eb97306c2663ff214cd1c914f910d269ea780 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 13 Sep 2021 18:48:22 -0400
Subject: [PATCH 286/856] add asset propagation for giftbox texture

---
 docs/release-notes.md                     | 1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c706619c..c51dec39 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@
   * Fixed crash loading mods with corrupted translation files.
 
 * For mod authors:
+  * Added asset propagation for `LooseSprites\Giftbox`.
   * Improved SMAPI's crossplatform read/writing of `Color`, `Point`, `Rectangle`, and `Vector2` in JSON to support nullable fields too.
 
 * For the web UI:
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 708673c3..35ae26b3 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -414,6 +414,10 @@ namespace StardewModdingAPI.Metadata
                     SpriteText.coloredTexture = content.Load<Texture2D>(key);
                     return true;
 
+                case "loosesprites\\giftbox": // Game1.LoadContent
+                    Game1.giftboxTexture = content.Load<Texture2D>(key);
+                    return true;
+
                 case "loosesprites\\nightbg": // Game1.LoadContent
                     Game1.nightbg = content.Load<Texture2D>(key);
                     return true;

From 1a8bb63e0d08552525e09130c4928c0c4526e901 Mon Sep 17 00:00:00 2001
From: ELL <ellipszist@gmail.com>
Date: Thu, 16 Sep 2021 11:41:13 +0700
Subject: [PATCH 287/856] Add Thai translations

---
 src/SMAPI.Mods.ErrorHandler/i18n/th.json | 4 ++++
 src/SMAPI/i18n/th.json                   | 6 ++++++
 2 files changed, 10 insertions(+)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/th.json
 create mode 100644 src/SMAPI/i18n/th.json

diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/th.json b/src/SMAPI.Mods.ErrorHandler/i18n/th.json
new file mode 100644
index 00000000..e2a67dda
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/th.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "ทำการลบเนื้อหาที่ไม่ถูกต้องออก เพื่อป้องกันไฟล์เกมเสียหาย (ดูรายละเอียดที่หน้าคอลโซลของ SMAPI)"
+}
diff --git a/src/SMAPI/i18n/th.json b/src/SMAPI/i18n/th.json
new file mode 100644
index 00000000..361b7aa7
--- /dev/null
+++ b/src/SMAPI/i18n/th.json
@@ -0,0 +1,6 @@
+{
+    // short date format for SDate
+    // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
+    "generic.date": "วันที่ {{day}} {{season}}",
+    "generic.date-with-year": "วันที่ {{day}} {{season}} ปีที่ {{year}}"
+}

From 54a7c1f9bde0f98d9f81aa9dcd7bd4c18e409877 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 18 Sep 2021 11:07:06 -0400
Subject: [PATCH 288/856] add more visible log output for players during early
 startup

---
 docs/release-notes.md        | 1 +
 src/SMAPI/Framework/SCore.cs | 9 ++++++---
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c51dec39..ab120994 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Added more progress updates in the log during startup.
   * Fixed crash loading mods with corrupted translation files.
 
 * For mod authors:
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index df6cd129..86b69239 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -289,7 +289,7 @@ namespace StardewModdingAPI.Framework
             this.UpdateWindowTitles();
 
             // start game
-            this.Monitor.Log("Starting game...", LogLevel.Debug);
+            this.Monitor.Log("Waiting for game to launch...", LogLevel.Debug);
             try
             {
                 this.IsGameRunning = true;
@@ -377,7 +377,7 @@ namespace StardewModdingAPI.Framework
 
             // load mods
             {
-                this.Monitor.Log("Loading mod metadata...");
+                this.Monitor.Log("Loading mod metadata...", LogLevel.Debug);
                 ModResolver resolver = new ModResolver();
 
                 // log loose files
@@ -1487,7 +1487,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="modDatabase">Handles access to SMAPI's internal mod metadata list.</param>
         private void LoadMods(IModMetadata[] mods, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase)
         {
-            this.Monitor.Log("Loading mods...");
+            this.Monitor.Log("Loading mods...", LogLevel.Debug);
 
             // load mods
             IList<IModMetadata> skippedMods = new List<IModMetadata>();
@@ -1523,6 +1523,7 @@ namespace StardewModdingAPI.Framework
             this.ReloadTranslations(loaded);
 
             // initialize loaded non-content-pack mods
+            this.Monitor.Log("Launching mods...", LogLevel.Debug);
             foreach (IModMetadata metadata in loadedMods)
             {
                 // add interceptors
@@ -1572,6 +1573,8 @@ namespace StardewModdingAPI.Framework
 
             // unlock mod integrations
             this.ModRegistry.AreAllModsInitialized = true;
+
+            this.Monitor.Log("Mods loaded and ready!", LogLevel.Debug);
         }
 
         /// <summary>Raised after a mod adds or removes asset interceptors.</summary>

From 8a117744608dfff970855defbffb1f40466ab755 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 18 Sep 2021 11:48:20 -0400
Subject: [PATCH 289/856] add simpler error when an asset isn't found

---
 docs/release-notes.md                         |  1 +
 .../ContentManagers/GameContentManager.cs     | 48 +++++++++++--------
 2 files changed, 29 insertions(+), 20 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ab120994..f330c677 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For players:
   * Added more progress updates in the log during startup.
+  * Simplified common asset load error message.
   * Fixed crash loading mods with corrupted translation files.
 
 * For mod authors:
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 63cd1759..38bcf153 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Globalization;
+using System.IO;
 using System.Linq;
 using System.Reflection;
 using Microsoft.Xna.Framework.Content;
@@ -205,28 +206,35 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <remarks>Derived from <see cref="LocalizedContentManager.Load{T}(string, LocalizedContentManager.LanguageCode)"/>.</remarks>
         private T RawLoad<T>(string assetName, LanguageCode language, bool useCache)
         {
-            // use cached key
-            if (language == this.Language && this.LocalizedAssetNames.TryGetValue(assetName, out string cachedKey))
-                return base.RawLoad<T>(cachedKey, useCache);
-
-            // try translated key
-            if (language != LocalizedContentManager.LanguageCode.en)
+            try
             {
-                string translatedKey = $"{assetName}.{this.GetLocale(language)}";
-                try
-                {
-                    T obj = base.RawLoad<T>(translatedKey, useCache);
-                    this.LocalizedAssetNames[assetName] = translatedKey;
-                    return obj;
-                }
-                catch (ContentLoadException)
-                {
-                    this.LocalizedAssetNames[assetName] = assetName;
-                }
-            }
+                // use cached key
+                if (language == this.Language && this.LocalizedAssetNames.TryGetValue(assetName, out string cachedKey))
+                    return base.RawLoad<T>(cachedKey, useCache);
 
-            // try base asset
-            return base.RawLoad<T>(assetName, useCache);
+                // try translated key
+                if (language != LocalizedContentManager.LanguageCode.en)
+                {
+                    string translatedKey = $"{assetName}.{this.GetLocale(language)}";
+                    try
+                    {
+                        T obj = base.RawLoad<T>(translatedKey, useCache);
+                        this.LocalizedAssetNames[assetName] = translatedKey;
+                        return obj;
+                    }
+                    catch (ContentLoadException)
+                    {
+                        this.LocalizedAssetNames[assetName] = assetName;
+                    }
+                }
+
+                // try base asset
+                return base.RawLoad<T>(assetName, useCache);
+            }
+            catch (ContentLoadException ex) when (ex.InnerException is FileNotFoundException innerEx && innerEx.InnerException == null)
+            {
+                throw new SContentLoadException($"Error loading \"{assetName}\": it isn't in the Content folder and no mod provided it.");
+            }
         }
 
         /// <summary>Parse an asset key that contains an explicit language into its asset name and language, if applicable.</summary>

From 6ac5ca090da088e96b0c6508866cebe7eedc439d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 18 Sep 2021 12:43:31 -0400
Subject: [PATCH 290/856] simplify exception logs

---
 docs/release-notes.md                         |  3 +-
 ...eptionExtensions.cs => ExceptionHelper.cs} | 36 ++++++++++++++++---
 src/SMAPI.Internal/SMAPI.Internal.projitems   |  2 +-
 src/SMAPI/Framework/Logging/LogManager.cs     |  4 +++
 4 files changed, 39 insertions(+), 6 deletions(-)
 rename src/SMAPI.Internal/{ExceptionExtensions.cs => ExceptionHelper.cs} (51%)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f330c677..f619623f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,7 +4,8 @@
 ## Upcoming release
 * For players:
   * Added more progress updates in the log during startup.
-  * Simplified common asset load error message.
+  * Simplified asset load error message.
+  * Simplified exception logs.
   * Fixed crash loading mods with corrupted translation files.
 
 * For mod authors:
diff --git a/src/SMAPI.Internal/ExceptionExtensions.cs b/src/SMAPI.Internal/ExceptionHelper.cs
similarity index 51%
rename from src/SMAPI.Internal/ExceptionExtensions.cs
rename to src/SMAPI.Internal/ExceptionHelper.cs
index d8189048..4bc55f95 100644
--- a/src/SMAPI.Internal/ExceptionExtensions.cs
+++ b/src/SMAPI.Internal/ExceptionHelper.cs
@@ -1,10 +1,11 @@
 using System;
 using System.Reflection;
+using System.Text.RegularExpressions;
 
 namespace StardewModdingAPI.Internal
 {
     /// <summary>Provides extension methods for handling exceptions.</summary>
-    internal static class ExceptionExtensions
+    internal static class ExceptionHelper
     {
         /*********
         ** Public methods
@@ -15,20 +16,26 @@ namespace StardewModdingAPI.Internal
         {
             try
             {
+                string message;
                 switch (exception)
                 {
                     case TypeLoadException ex:
-                        return $"Failed loading type '{ex.TypeName}': {exception}";
+                        message = $"Failed loading type '{ex.TypeName}': {exception}";
+                        break;
 
                     case ReflectionTypeLoadException ex:
                         string summary = ex.ToString();
                         foreach (Exception childEx in ex.LoaderExceptions ?? new Exception[0])
                             summary += $"\n\n{childEx?.GetLogSummary()}";
-                        return summary;
+                        message = summary;
+                        break;
 
                     default:
-                        return exception?.ToString() ?? $"<null exception>\n{Environment.StackTrace}";
+                        message = exception?.ToString() ?? $"<null exception>\n{Environment.StackTrace}";
+                        break;
                 }
+
+                return ExceptionHelper.SimplifyExtensionMessage(message);
             }
             catch (Exception ex)
             {
@@ -44,5 +51,26 @@ namespace StardewModdingAPI.Internal
                 exception = exception.InnerException;
             return exception;
         }
+
+        /// <summary>Simplify common patterns in exception log messages that don't convey useful info.</summary>
+        /// <param name="message">The log message to simplify.</param>
+        public static string SimplifyExtensionMessage(string message)
+        {
+            // remove namespace for core exception types
+            message = Regex.Replace(
+                message,
+                @"(?:StardewModdingAPI\.Framework\.Exceptions|Microsoft\.Xna\.Framework|System|System\.IO)\.([a-zA-Z]+Exception):",
+                "$1:"
+            );
+
+            // remove unneeded root build paths for SMAPI and Stardew Valley
+            message = message
+                .Replace(@"C:\source\_Stardew\SMAPI\src\", "")
+                .Replace(@"C:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\", "");
+
+            // remove placeholder info in Linux/macOS stack traces
+            return message
+                .Replace(@"<filename unknown>:0", "");
+        }
     }
 }
diff --git a/src/SMAPI.Internal/SMAPI.Internal.projitems b/src/SMAPI.Internal/SMAPI.Internal.projitems
index 0ee94a5b..41d356c0 100644
--- a/src/SMAPI.Internal/SMAPI.Internal.projitems
+++ b/src/SMAPI.Internal/SMAPI.Internal.projitems
@@ -14,6 +14,6 @@
     <Compile Include="$(MSBuildThisFileDirectory)ConsoleWriting\ConsoleLogLevel.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)ConsoleWriting\IConsoleWriter.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)ConsoleWriting\MonitorColorScheme.cs" />
-    <Compile Include="$(MSBuildThisFileDirectory)ExceptionExtensions.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)ExceptionHelper.cs" />
   </ItemGroup>
 </Project>
\ No newline at end of file
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 6fe44d98..f2876146 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -406,6 +406,10 @@ namespace StardewModdingAPI.Framework.Logging
                 }
             }
 
+            // simplify exception messages
+            if (level == LogLevel.Error)
+                message = ExceptionHelper.SimplifyExtensionMessage(message);
+
             // forward to monitor
             gameMonitor.Log(message, level);
         }

From 6643da4574bec2d71ac9c25a2c9ab15b8c855e2b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 18 Sep 2021 13:06:50 -0400
Subject: [PATCH 291/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 36 +++++++++++---------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 +--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 +--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 +--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 27 insertions(+), 25 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 5eb69901..1f6cf0b6 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.6</Version>
+    <Version>3.12.7</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index f619623f..8ed155bd 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,7 +1,9 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.7
+Released 18 September 2021 for Stardew Valley 1.5.4.
+
 * For players:
   * Added more progress updates in the log during startup.
   * Simplified asset load error message.
@@ -17,7 +19,7 @@
   * Fixed JSON validator line numbers sometimes incorrect.
 
 ## 3.12.6
-Released 03 September 2021 for Stardew Valley 1.5.4 or later.
+Released 03 September 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Added friendly error when using SMAPI 3.2._x_ with Stardew Valley 1.5.5 or later.
@@ -41,18 +43,18 @@ to format asset names, you should switch to `PathUtilities.NormalizeAssetName` n
 continue working in the next game update.
 
 ## 3.12.5
-Released 26 August 2021 for Stardew Valley 1.5.4 or later.
+Released 26 August 2021 for Stardew Valley 1.5.4.
 
 * Fixed some mods in unofficial 64-bit mode no longer loading after SMAPI 3.12.3.
 
 ## 3.12.4
-Released 25 August 2021 for Stardew Valley 1.5.4 or later.
+Released 25 August 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Fixed error loading some mods in SMAPI 3.12.3.
 
 ## 3.12.3
-Released 25 August 2021 for Stardew Valley 1.5.4 or later.
+Released 25 August 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Added friendly error in 64-bit mode when a mod is 32-bit only.
@@ -71,7 +73,7 @@ Released 25 August 2021 for Stardew Valley 1.5.4 or later.
   * Fixed update checks shown for prerelease mod versions if you have a working non-prerelease version.
 
 ## 3.12.2
-Released 05 August 2021 for Stardew Valley 1.5.4 or later.
+Released 05 August 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Fixed error creating a new save or joining a multiplayer world in 3.12.1.
@@ -82,7 +84,7 @@ Released 05 August 2021 for Stardew Valley 1.5.4 or later.
   * Fixed `NullReferenceException` in SMAPI's error-handling when trying to handle an invalid `ReflectionTypeLoadException`.
 
 ## 3.12.1
-Released 03 August 2021 for Stardew Valley 1.5.4 or later.
+Released 03 August 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * The software conflict message is now shown as a warning to simplify troubleshooting.
@@ -93,7 +95,7 @@ Released 03 August 2021 for Stardew Valley 1.5.4 or later.
   * Fixed `Constants.Save*` fields incorrect if the save's folder name and ID don't match.
 
 ## 3.12.0
-Released 01 August 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/54388616).
+Released 01 August 2021 for Stardew Valley 1.5.4. See [release highlights](https://www.patreon.com/posts/54388616).
 
 * For players:
   * Added save recovery when content mods leave null objects in the save (in _Error Handler_).
@@ -111,7 +113,7 @@ Released 01 August 2021 for Stardew Valley 1.5.4 or later. See [release highligh
   * Fixed reloading a map not correctly reapplying interior doors.
 
 ## 3.11.0
-Released 09 July 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/53514295).
+Released 09 July 2021 for Stardew Valley 1.5.4. See [release highlights](https://www.patreon.com/posts/53514295).
 
 * For players:
   * Updated for Stardew Valley 1.4.5 multiplayer hotfix on Linux/macOS.
@@ -135,13 +137,13 @@ Released 09 July 2021 for Stardew Valley 1.5.4 or later. See [release highlights
   * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.
 
 ## 3.10.1
-Released 03 May 2021 for Stardew Valley 1.5.4 or later.
+Released 03 May 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Fixed installer leaving an unneeded `StardewModdingAPI-x64.exe` file in 32-bit game folders.
 
 ## 3.10
-Released 03 May 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/50764911).
+Released 03 May 2021 for Stardew Valley 1.5.4. See [release highlights](https://www.patreon.com/posts/50764911).
 
 * For players:
   * Added full support for the [unofficial 64-bit Stardew Valley patch](https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows), which removes memory limits. The installer detects which version of SMAPI you need, and SMAPI shows update alerts for Stardew64Installer if applicable.
@@ -166,7 +168,7 @@ Released 03 May 2021 for Stardew Valley 1.5.4 or later. See [release highlights]
   * Fixed update subkeys not working in file descriptions for Nexus mods marked as adult content.
 
 ## 3.9.5
-Released 21 March 2021 for Stardew Valley 1.5.4 or later.
+Released 21 March 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Added console command to reset community center bundles _(in Console Commands)_.
@@ -187,13 +189,13 @@ Released 21 March 2021 for Stardew Valley 1.5.4 or later.
     _Note: mods don't need to handle the difference in most cases, but some players may use MonoGame on Windows in upcoming versions. Mods which check `Constants.TargetPlatform` should review usages as needed._
 
 ## 3.9.4
-Released 07 March 2021 for Stardew Valley 1.5.4 or later.
+Released 07 March 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Fixed installer error if the `Mods` folder doesn't exist in 3.9.3.
 
 ## 3.9.3
-Released 07 March 2021 for Stardew Valley 1.5.4 or later.
+Released 07 March 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Added descriptive error if possible when a `PathTooLongException` crashes SMAPI or the installer.
@@ -209,7 +211,7 @@ Released 07 March 2021 for Stardew Valley 1.5.4 or later.
   * Updated the JSON validator/schema for Content Patcher 1.21.
 
 ## 3.9.2
-Released 21 February 2021 for Stardew Valley 1.5.4 or later.
+Released 21 February 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Added more aggressive memory optimization to reduce `OutOfMemoryException` errors with some mods.
@@ -232,14 +234,14 @@ Released 21 February 2021 for Stardew Valley 1.5.4 or later.
   * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.
 
 ## 3.9.1
-Released 25 January 2021 for Stardew Valley 1.5.4 or later.
+Released 25 January 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Fixed _tile contains an invalid TileSheet reference_ crash after mods change certain maps.
   * Fixed _patched game code_ issue shown for the bundled Error Handler mod.
 
 ## 3.9
-Released 22 January 2021 for Stardew Valley 1.5.4 or later. See [release highlights](https://www.patreon.com/posts/46553874).
+Released 22 January 2021 for Stardew Valley 1.5.4. See [release highlights](https://www.patreon.com/posts/46553874).
 
 * For players:
   * Updated for Stardew Valley 1.5.4.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index de223c01..e53bf991 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.6",
+    "Version": "3.12.7",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.6"
+    "MinimumApiVersion": "3.12.7"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index fcb6d7eb..37a7e9bf 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.6",
+    "Version": "3.12.7",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.6"
+    "MinimumApiVersion": "3.12.7"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 1c84b5c2..28c7ec14 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.6",
+    "Version": "3.12.7",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.6"
+    "MinimumApiVersion": "3.12.7"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index d0c693bf..fbc00d1d 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.6";
+        internal static string RawApiVersion = "3.12.7";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 87536fbd9a9572d2b11bc429ecab91c5f8aeefa3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 25 Sep 2021 00:52:08 -0400
Subject: [PATCH 292/856] remove obsolete buildmsg redirect

---
 src/SMAPI.Web/Startup.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index 2556936c..4b22ca67 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -205,15 +205,20 @@ namespace StardewModdingAPI.Web
                 // shortcut paths
                 .Add(new RedirectPathsToUrlsRule(new Dictionary<string, string>
                 {
+                    // wiki pages
                     [@"^/3\.0\.?$"] = "https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_3.0",
-                    [@"^/(?:buildmsg|package)(?:/?(.*))$"] = "https://github.com/Pathoschild/SMAPI/blob/develop/docs/technical/mod-package.md#$1", // buildmsg deprecated, remove when SDV 1.4 is released
                     [@"^/community\.?$"] = "https://stardewvalleywiki.com/Modding:Community",
-                    [@"^/compat\.?$"] = "https://smapi.io/mods",
                     [@"^/docs\.?$"] = "https://stardewvalleywiki.com/Modding:Index",
                     [@"^/help\.?$"] = "https://stardewvalleywiki.com/Modding:Help",
                     [@"^/install\.?$"] = "https://stardewvalleywiki.com/Modding:Player_Guide/Getting_Started#Install_SMAPI",
                     [@"^/troubleshoot(.*)$"] = "https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting$1",
-                    [@"^/xnb\.?$"] = "https://stardewvalleywiki.com/Modding:Using_XNB_mods"
+                    [@"^/xnb\.?$"] = "https://stardewvalleywiki.com/Modding:Using_XNB_mods",
+
+                    // GitHub docs
+                    [@"^/package(?:/?(.*))$"] = "https://github.com/Pathoschild/SMAPI/blob/develop/docs/technical/mod-package.md#$1",
+
+                    // legacy redirects
+                    [@"^/compat\.?$"] = "https://smapi.io/mods"
                 }))
 
                 // legacy paths

From 0e3e4f565ad4cda17759f2ebf9a8d35d4a8252b8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 25 Sep 2021 00:52:21 -0400
Subject: [PATCH 293/856] add redirect for SMAPI release notes

---
 src/SMAPI.Web/Startup.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index 4b22ca67..d8561172 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -216,6 +216,7 @@ namespace StardewModdingAPI.Web
 
                     // GitHub docs
                     [@"^/package(?:/?(.*))$"] = "https://github.com/Pathoschild/SMAPI/blob/develop/docs/technical/mod-package.md#$1",
+                    [@"^/release(?:/?(.*))$"] = "https://github.com/Pathoschild/SMAPI/blob/develop/docs/release-notes.md#$1",
 
                     // legacy redirects
                     [@"^/compat\.?$"] = "https://smapi.io/mods"

From 31e31538f128f2a79b553a2cc20fe8a6f13e8a06 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 25 Sep 2021 20:22:26 -0400
Subject: [PATCH 294/856] fix farmhouse edits shifting player down one tile

---
 docs/release-notes.md                     |  4 ++++
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 11 +++++++++++
 2 files changed, 15 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8ed155bd..25698ffa 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Fixed mod edits to the farmhouse shifting the player down one tile in some cases.
+
 ## 3.12.7
 Released 18 September 2021 for Stardew Valley 1.5.4.
 
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 35ae26b3..8bf7a32b 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
+using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
@@ -908,6 +909,8 @@ namespace StardewModdingAPI.Metadata
         /// <param name="location">The location whose map to reload.</param>
         private void ReloadMap(GameLocation location)
         {
+            Vector2? playerPos = Game1.player?.Position;
+
             if (this.AggressiveMemoryOptimizations)
                 location.map.DisposeTileSheets(Game1.mapDisplayDevice);
 
@@ -926,6 +929,14 @@ namespace StardewModdingAPI.Metadata
             // update for changes
             location.updateWarps();
             location.updateDoors();
+
+            // reset player position
+            // The game may move the player as part of the map changes, even if they're not in that
+            // location. That's not needed in this case, and it can have weird effects like players
+            // warping onto the wrong tile (or even off-screen) if a patch changes the farmhouse
+            // map on location change.
+            if (playerPos.HasValue)
+                Game1.player.Position = playerPos.Value;
         }
 
         /// <summary>Reload the disposition data for matching NPCs.</summary>

From ab8599583e549bda59bc3e0783bd5e1657ef7b1b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 27 Sep 2021 17:06:15 -0400
Subject: [PATCH 295/856] fix SMAPI's display device not hooked correctly in
 split-screen mode

---
 docs/release-notes.md              |  3 +++
 src/SMAPI/Framework/SCore.cs       |  6 +++---
 src/SMAPI/Framework/SGame.cs       | 14 +++++++++++++-
 src/SMAPI/Framework/SGameRunner.cs | 10 +---------
 4 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 25698ffa..c03b6005 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,9 @@
 * For players:
   * Fixed mod edits to the farmhouse shifting the player down one tile in some cases.
 
+* For mod authors:
+  * Fixed map tile rotations/flips not working for farmhands in split-screen mode.
+
 ## 3.12.7
 Released 18 September 2021 for Stardew Valley 1.5.4.
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 86b69239..6dffb1de 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -247,7 +247,7 @@ namespace StardewModdingAPI.Framework
                     multiplayer: this.Multiplayer,
                     exitGameImmediately: this.ExitGameImmediately,
 
-                    onGameContentLoaded: this.OnGameContentLoaded,
+                    onGameContentLoaded: this.OnInstanceContentLoaded,
                     onGameUpdating: this.OnGameUpdating,
                     onPlayerInstanceUpdating: this.OnPlayerInstanceUpdating,
                     onGameExiting: this.OnGameExiting
@@ -429,8 +429,8 @@ namespace StardewModdingAPI.Framework
             ).Start();
         }
 
-        /// <summary>Raised after the game finishes loading its initial content.</summary>
-        private void OnGameContentLoaded()
+        /// <summary>Raised after an instance finishes loading its initial content.</summary>
+        private void OnInstanceContentLoaded()
         {
             // override map display device
             Game1.mapDisplayDevice = new SDisplayDevice(Game1.content, Game1.game1.GraphicsDevice);
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 55ab8377..4e134455 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -54,6 +54,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>Raised when the instance is updating its state (roughly 60 times per second).</summary>
         private readonly Action<SGame, GameTime, Action> OnUpdating;
 
+        /// <summary>Raised after the instance finishes loading its initial content.</summary>
+        private readonly Action OnContentLoaded;
+
 
         /*********
         ** Accessors
@@ -106,7 +109,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="multiplayer">The core multiplayer logic.</param>
         /// <param name="exitGameImmediately">Immediately exit the game without saving. This should only be invoked when an irrecoverable fatal error happens that risks save corruption or game-breaking bugs.</param>
         /// <param name="onUpdating">Raised when the instance is updating its state (roughly 60 times per second).</param>
-        public SGame(PlayerIndex playerIndex, int instanceIndex, Monitor monitor, Reflector reflection, EventManager eventManager, SInputState input, SModHooks modHooks, SMultiplayer multiplayer, Action<string> exitGameImmediately, Action<SGame, GameTime, Action> onUpdating)
+        /// <param name="onContentLoaded">Raised after the game finishes loading its initial content.</param>
+        public SGame(PlayerIndex playerIndex, int instanceIndex, Monitor monitor, Reflector reflection, EventManager eventManager, SInputState input, SModHooks modHooks, SMultiplayer multiplayer, Action<string> exitGameImmediately, Action<SGame, GameTime, Action> onUpdating, Action onContentLoaded)
             : base(playerIndex, instanceIndex)
         {
             // init XNA
@@ -124,6 +128,7 @@ namespace StardewModdingAPI.Framework
             this.Reflection = reflection;
             this.ExitGameImmediately = exitGameImmediately;
             this.OnUpdating = onUpdating;
+            this.OnContentLoaded = onContentLoaded;
         }
 
         /// <summary>Get the current input state for a button.</summary>
@@ -138,6 +143,13 @@ namespace StardewModdingAPI.Framework
             return input.GetState(button);
         }
 
+        /// <inheritdoc />
+        protected override void LoadContent()
+        {
+            base.LoadContent();
+
+            this.OnContentLoaded();
+        }
 
         /*********
         ** Protected methods
diff --git a/src/SMAPI/Framework/SGameRunner.cs b/src/SMAPI/Framework/SGameRunner.cs
index 45e7369c..b816bb7c 100644
--- a/src/SMAPI/Framework/SGameRunner.cs
+++ b/src/SMAPI/Framework/SGameRunner.cs
@@ -94,7 +94,7 @@ namespace StardewModdingAPI.Framework
         public override Game1 CreateGameInstance(PlayerIndex playerIndex = PlayerIndex.One, int instanceIndex = 0)
         {
             SInputState inputState = new SInputState();
-            return new SGame(playerIndex, instanceIndex, this.Monitor, this.Reflection, this.Events, inputState, this.ModHooks, this.Multiplayer, this.ExitGameImmediately, this.OnPlayerInstanceUpdating);
+            return new SGame(playerIndex, instanceIndex, this.Monitor, this.Reflection, this.Events, inputState, this.ModHooks, this.Multiplayer, this.ExitGameImmediately, this.OnPlayerInstanceUpdating, this.OnGameContentLoaded);
         }
 
         /// <inheritdoc />
@@ -129,14 +129,6 @@ namespace StardewModdingAPI.Framework
         /*********
         ** Protected methods
         *********/
-        /// <summary>Load content when the game is launched.</summary>
-        protected override void LoadContent()
-        {
-            base.LoadContent();
-
-            this.OnGameContentLoaded();
-        }
-
         /// <summary>Perform cleanup logic when the game exits.</summary>
         /// <param name="sender">The event sender.</param>
         /// <param name="args">The event args.</param>

From 0888f71a5c7fe2bbf815409a70834ac85013c7f8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 29 Sep 2021 20:48:51 -0400
Subject: [PATCH 296/856] show separate beta stats in mod compatibility list

---
 docs/release-notes.md                    |  3 +++
 src/SMAPI.Web/Views/Mods/Index.cshtml    | 12 +++++++---
 src/SMAPI.Web/wwwroot/Content/js/mods.js | 30 +++++++++++++++++-------
 3 files changed, 34 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c03b6005..6573e602 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 * For mod authors:
   * Fixed map tile rotations/flips not working for farmhands in split-screen mode.
 
+* For the web UI:
+  * The mod compatibility list now shows separate beta stats when 'show advanced info' is enabled.
+
 ## 3.12.7
 Released 18 September 2021 for Stardew Valley 1.5.4.
 
diff --git a/src/SMAPI.Web/Views/Mods/Index.cshtml b/src/SMAPI.Web/Views/Mods/Index.cshtml
index 5df49afb..8a764803 100644
--- a/src/SMAPI.Web/Views/Mods/Index.cshtml
+++ b/src/SMAPI.Web/Views/Mods/Index.cshtml
@@ -16,7 +16,7 @@
     <script src="https://cdn.jsdelivr.net/npm/vue@2.6.11" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/tablesorter@2.31.3" crossorigin="anonymous"></script>
-    <script src="~/Content/js/mods.js?r=20200218"></script>
+    <script src="~/Content/js/mods.js?r=20210929"></script>
     <script>
         $(function() {
             var data = @this.ForJson(Model.Mods ?? new ModModel[0]);
@@ -65,9 +65,15 @@ else
             </div>
         </div>
         <div id="mod-count" v-show="showAdvanced">
-            <div v-if="visibleStats.total > 0">
-                {{visibleStats.total}} mods shown ({{Math.round((visibleStats.compatible + visibleStats.workaround) / visibleStats.total * 100)}}% compatible or have a workaround, {{Math.round((visibleStats.soon + visibleStats.broken) / visibleStats.total * 100)}}% broken, {{Math.round(visibleStats.abandoned / visibleStats.total * 100)}}% obsolete).
+            <div v-if="visibleMainStats.total > 0">
+                {{visibleMainStats.total}} mods shown ({{visibleMainStats.percentCompatible}}% compatible or have a workaround, {{visibleMainStats.percentBroken}}% broken, {{visibleMainStats.percentObsolete}}% obsolete).
             </div>
+            @if (hasBeta)
+            {
+                <div v-if="visibleBetaStats.total > 0">
+                    <strong>@betaLabel</strong>: {{visibleBetaStats.total}} mods shown ({{visibleBetaStats.percentCompatible}}% compatible or have a workaround, {{visibleBetaStats.percentBroken}}% broken, {{visibleBetaStats.percentObsolete}}% obsolete).
+                </div>
+            }
             <span v-else>No matching mods found.</span>
         </div>
         <table class="wikitable" id="mod-list">
diff --git a/src/SMAPI.Web/wwwroot/Content/js/mods.js b/src/SMAPI.Web/wwwroot/Content/js/mods.js
index ac2754a4..945f93ef 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/mods.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/mods.js
@@ -9,12 +9,16 @@ smapi.modList = function (mods, enableBeta) {
         soon: 0,
         broken: 0,
         abandoned: 0,
-        invalid: 0
+        invalid: 0,
+        percentCompatible: 0,
+        percentBroken: 0,
+        percentObsolete: 0
     };
     var data = {
         mods: mods,
         showAdvanced: false,
-        visibleStats: $.extend({}, defaultStats),
+        visibleMainStats: $.extend({}, defaultStats),
+        visibleBetaStats: $.extend({}, defaultStats),
         filters: {
             source: {
                 value: {
@@ -124,7 +128,8 @@ smapi.modList = function (mods, enableBeta) {
                 var words = data.search.toLowerCase().split(" ");
 
                 // apply criteria
-                var stats = data.visibleStats = $.extend({}, defaultStats);
+                var mainStats = data.visibleMainStats = $.extend({}, defaultStats);
+                var betaStats = data.visibleBetaStats = $.extend({}, defaultStats);
                 for (var i = 0; i < data.mods.length; i++) {
                     var mod = data.mods[i];
                     mod.Visible = true;
@@ -132,10 +137,20 @@ smapi.modList = function (mods, enableBeta) {
                     // check filters
                     mod.Visible = this.matchesFilters(mod, words);
                     if (mod.Visible) {
-                        stats.total++;
-                        stats[this.getCompatibilityGroup(mod)]++;
+                        mainStats.total++;
+                        betaStats.total++;
+
+                        mainStats[this.getCompatibilityGroup(mod.Compatibility.Status)]++;
+                        betaStats[this.getCompatibilityGroup(mod.LatestCompatibility.Status)]++;
                     }
                 }
+
+                // add aggregate stats
+                for (let stats of [mainStats, betaStats]) {
+                    stats.percentCompatible = Math.round((stats.compatible + stats.workaround) / stats.total * 100);
+                    stats.percentBroken = Math.round((stats.soon + stats.broken) / stats.total * 100);
+                    stats.percentObsolete = Math.round(stats.abandoned / stats.total * 100);
+                }
             },
 
             /**
@@ -220,11 +235,10 @@ smapi.modList = function (mods, enableBeta) {
 
             /**
              * Get a mod's compatibility group for mod metrics.
-             * @param {object} mod The mod to check.
+             * @param {string} mod The mod status for which to get the group.
              * @returns {string} The compatibility group (one of 'compatible', 'workaround', 'soon', 'broken', 'abandoned', or 'invalid').
              */
-            getCompatibilityGroup: function (mod) {
-                var status = mod.LatestCompatibility.Status;
+            getCompatibilityGroup: function (status) {
                 switch (status) {
                     // obsolete
                     case "abandoned":

From b5c88d87d2cb1739585651e02513fef73dfc0e27 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Oct 2021 16:40:23 -0400
Subject: [PATCH 297/856] add support for unified mod data overrides on the
 wiki

---
 docs/release-notes.md                         |   1 +
 .../WikiClient/ChangeDescriptorTests.cs       | 139 +++++++++++++
 .../WebApi/ModExtendedMetadataModel.cs        |  28 +--
 .../Clients/Wiki/ChangeDescriptor.cs          | 194 ++++++++++++++++++
 .../Framework/Clients/Wiki/WikiClient.cs      | 105 ++++++----
 .../Clients/Wiki/WikiDataOverrideEntry.cs     |  31 +++
 .../Framework/Clients/Wiki/WikiModEntry.cs    |  13 +-
 .../Framework/UpdateData/UpdateKey.cs         |  10 +
 .../Controllers/ModsApiController.cs          |  30 +--
 src/SMAPI.Web/Framework/ModSiteManager.cs     |  39 ++--
 10 files changed, 479 insertions(+), 111 deletions(-)
 create mode 100644 src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
 create mode 100644 src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
 create mode 100644 src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6573e602..618dd696 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
   * Fixed map tile rotations/flips not working for farmhands in split-screen mode.
 
 * For the web UI:
+  * Added support for unified [mod data overrides](https://stardewvalleywiki.com/Modding:Mod_compatibility#Mod_data_overrides) defined on the wiki.
   * The mod compatibility list now shows separate beta stats when 'show advanced info' is enabled.
 
 ## 3.12.7
diff --git a/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs b/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
new file mode 100644
index 00000000..b896b09c
--- /dev/null
+++ b/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
@@ -0,0 +1,139 @@
+using System.Collections.Generic;
+using System.Linq;
+using NUnit.Framework;
+using StardewModdingAPI;
+using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
+
+namespace SMAPI.Tests.WikiClient
+{
+    /// <summary>Unit tests for <see cref="ChangeDescriptor"/>.</summary>
+    [TestFixture]
+    internal class ChangeDescriptorTests
+    {
+        /*********
+        ** Unit tests
+        *********/
+        /****
+        ** Constructor
+        ****/
+        [Test(Description = "Assert that Parse sets the expected values for valid and invalid descriptors.")]
+        public void Parse_SetsExpectedValues_Raw()
+        {
+            // arrange
+            string rawDescriptor = "-Nexus:2400,    -B, XX → YY, Nexus:451,+A, XXX → YYY, invalidA →, → invalidB";
+            string[] expectedAdd = new[] { "Nexus:451", "A" };
+            string[] expectedRemove = new[] { "Nexus:2400", "B" };
+            IDictionary<string, string> expectedReplace = new Dictionary<string, string>
+            {
+                ["XX"] = "YY",
+                ["XXX"] = "YYY"
+            };
+            string[] expectedErrors = new[]
+            {
+                "Failed parsing ' invalidA →': can't map to a blank value. Use the '-value' format to remove a value.",
+                "Failed parsing ' → invalidB': can't map from a blank old value. Use the '+value' format to add a value."
+            };
+
+            // act
+            ChangeDescriptor parsed = ChangeDescriptor.Parse(rawDescriptor, out string[] errors);
+
+            // assert
+            Assert.That(parsed.Add, Is.EquivalentTo(expectedAdd), $"{nameof(parsed.Add)} doesn't match the expected value.");
+            Assert.That(parsed.Remove, Is.EquivalentTo(expectedRemove), $"{nameof(parsed.Replace)} doesn't match the expected value.");
+            Assert.That(parsed.Replace, Is.EquivalentTo(expectedReplace), $"{nameof(parsed.Replace)} doesn't match the expected value.");
+            Assert.That(errors, Is.EquivalentTo(expectedErrors), $"{nameof(errors)} doesn't match the expected value.");
+        }
+
+        [Test(Description = "Assert that Parse sets the expected values for descriptors when a format callback is specified.")]
+        public void Parse_SetsExpectedValues_Formatted()
+        {
+            // arrange
+            string rawDescriptor = "-1.0.1,    -2.0-beta, 1.00 → 1.0, 1.0.0,+2.0-beta.15, 2.0 → 2.0-beta, invalidA →, → invalidB";
+            string[] expectedAdd = new[] { "1.0.0", "2.0.0-beta.15" };
+            string[] expectedRemove = new[] { "1.0.1", "2.0.0-beta" };
+            IDictionary<string, string> expectedReplace = new Dictionary<string, string>
+            {
+                ["1.00"] = "1.0.0",
+                ["2.0.0"] = "2.0.0-beta"
+            };
+            string[] expectedErrors = new[]
+            {
+                "Failed parsing ' invalidA →': can't map to a blank value. Use the '-value' format to remove a value.",
+                "Failed parsing ' → invalidB': can't map from a blank old value. Use the '+value' format to add a value."
+            };
+
+            // act
+            ChangeDescriptor parsed = ChangeDescriptor.Parse(
+                rawDescriptor,
+                out string[] errors,
+                formatValue: raw => SemanticVersion.TryParse(raw, out ISemanticVersion version)
+                    ? version.ToString()
+                    : raw
+            );
+
+            // assert
+            Assert.That(parsed.Add, Is.EquivalentTo(expectedAdd), $"{nameof(parsed.Add)} doesn't match the expected value.");
+            Assert.That(parsed.Remove, Is.EquivalentTo(expectedRemove), $"{nameof(parsed.Replace)} doesn't match the expected value.");
+            Assert.That(parsed.Replace, Is.EquivalentTo(expectedReplace), $"{nameof(parsed.Replace)} doesn't match the expected value.");
+            Assert.That(errors, Is.EquivalentTo(expectedErrors), $"{nameof(errors)} doesn't match the expected value.");
+        }
+
+        [Test(Description = "Assert that Apply returns the expected value for the given descriptor.")]
+
+        // null input
+        [TestCase(null, "", ExpectedResult = null)]
+        [TestCase(null, "+Nexus:2400", ExpectedResult = "Nexus:2400")]
+        [TestCase(null, "-Nexus:2400", ExpectedResult = null)]
+
+        // blank input
+        [TestCase("", null, ExpectedResult = "")]
+        [TestCase("", "", ExpectedResult = "")]
+
+        // add value
+        [TestCase("", "+Nexus:2400", ExpectedResult = "Nexus:2400")]
+        [TestCase("Nexus:2400", "+Nexus:2400", ExpectedResult = "Nexus:2400")]
+        [TestCase("Nexus:2400", "Nexus:2400", ExpectedResult = "Nexus:2400")]
+        [TestCase("Nexus:2400", "+Nexus:2401", ExpectedResult = "Nexus:2400, Nexus:2401")]
+        [TestCase("Nexus:2400", "Nexus:2401", ExpectedResult = "Nexus:2400, Nexus:2401")]
+
+        // remove value
+        [TestCase("", "-Nexus:2400", ExpectedResult = "")]
+        [TestCase("Nexus:2400", "-Nexus:2400", ExpectedResult = "")]
+        [TestCase("Nexus:2400", "-Nexus:2401", ExpectedResult = "Nexus:2400")]
+
+        // replace value
+        [TestCase("", "Nexus:2400 → Nexus:2401", ExpectedResult = "")]
+        [TestCase("Nexus:2400", "Nexus:2400 → Nexus:2401", ExpectedResult = "Nexus:2401")]
+        [TestCase("Nexus:1", "Nexus: 2400 → Nexus: 2401", ExpectedResult = "Nexus:1")]
+
+        // complex strings
+        [TestCase("", "+Nexus:A, Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A→Nexus:B", ExpectedResult = "Nexus:A, Nexus:B")]
+        [TestCase("Nexus:2400", "+Nexus:A, Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A→Nexus:B", ExpectedResult = "Nexus:2401, Nexus:A, Nexus:B")]
+        [TestCase("Nexus:2400, Nexus:2401, Nexus:B,Chucklefish:14", "+Nexus:A, Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A→Nexus:B", ExpectedResult = "Nexus:2401, Nexus:2401, Nexus:B, Nexus:A")]
+        public string Apply_Raw(string input, string descriptor)
+        {
+            var parsed = ChangeDescriptor.Parse(descriptor, out string[] errors);
+
+            Assert.IsEmpty(errors, "Parsing the descriptor failed.");
+
+            return parsed.ApplyToCopy(input);
+        }
+
+        [Test(Description = "Assert that ToString returns the expected normalized descriptors.")]
+        [TestCase(null, ExpectedResult = "")]
+        [TestCase("", ExpectedResult = "")]
+        [TestCase("+   Nexus:2400", ExpectedResult = "+Nexus:2400")]
+        [TestCase("  Nexus:2400  ", ExpectedResult = "+Nexus:2400")]
+        [TestCase("-Nexus:2400", ExpectedResult = "-Nexus:2400")]
+        [TestCase("  Nexus:2400   →Nexus:2401  ", ExpectedResult = "Nexus:2400 → Nexus:2401")]
+        [TestCase("+Nexus:A, Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A→Nexus:B", ExpectedResult = "+Nexus:A, +Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A → Nexus:B")]
+        public string ToString(string descriptor)
+        {
+            var parsed = ChangeDescriptor.Parse(descriptor, out string[] errors);
+
+            Assert.IsEmpty(errors, "Parsing the descriptor failed.");
+
+            return parsed.ToString();
+        }
+    }
+}
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
index 8c21e4e0..5945ff6e 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
@@ -1,4 +1,3 @@
-using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
@@ -87,11 +86,14 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         /****
         ** Version mappings
         ****/
-        /// <summary>Maps local versions to a semantic version for update checks.</summary>
-        public IDictionary<string, string> MapLocalVersions { get; set; }
+        /// <summary>A serialized change descriptor to apply to the local version during update checks (see <see cref="ChangeDescriptor"/>).</summary>
+        public string ChangeLocalVersions { get; set; }
 
-        /// <summary>Maps remote versions to a semantic version for update checks.</summary>
-        public IDictionary<string, string> MapRemoteVersions { get; set; }
+        /// <summary>A serialized change descriptor to apply to the remote version during update checks (see <see cref="ChangeDescriptor"/>).</summary>
+        public string ChangeRemoteVersions { get; set; }
+
+        /// <summary>A serialized change descriptor to apply to the update keys during update checks (see <see cref="ChangeDescriptor"/>).</summary>
+        public string ChangeUpdateKeys { get; set; }
 
 
         /*********
@@ -137,8 +139,9 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
                 this.BetaCompatibilitySummary = wiki.BetaCompatibility?.Summary;
                 this.BetaBrokeIn = wiki.BetaCompatibility?.BrokeIn;
 
-                this.MapLocalVersions = wiki.MapLocalVersions;
-                this.MapRemoteVersions = wiki.MapRemoteVersions;
+                this.ChangeLocalVersions = wiki.Overrides?.ChangeLocalVersions?.ToString();
+                this.ChangeRemoteVersions = wiki.Overrides?.ChangeRemoteVersions?.ToString();
+                this.ChangeUpdateKeys = wiki.Overrides?.ChangeUpdateKeys?.ToString();
             }
 
             // internal DB data
@@ -148,16 +151,5 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
                 this.Name ??= db.DisplayName;
             }
         }
-
-        /// <summary>Get update keys based on the metadata.</summary>
-        public IEnumerable<string> GetUpdateKeys()
-        {
-            if (this.NexusID.HasValue)
-                yield return $"Nexus:{this.NexusID}";
-            if (this.ChucklefishID.HasValue)
-                yield return $"Chucklefish:{this.ChucklefishID}";
-            if (this.GitHubRepo != null)
-                yield return $"GitHub:{this.GitHubRepo}";
-        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
new file mode 100644
index 00000000..6fcc3b18
--- /dev/null
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
@@ -0,0 +1,194 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.Linq;
+using System.Text;
+
+namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
+{
+    /// <summary>A set of changes which can be applied to a mod data field.</summary>
+    public class ChangeDescriptor
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The values to add to the field.</summary>
+        public ISet<string> Add { get; }
+
+        /// <summary>The values to remove from the field.</summary>
+        public ISet<string> Remove { get; }
+
+        /// <summary>The values to replace in the field, if matched.</summary>
+        public IReadOnlyDictionary<string, string> Replace { get; }
+
+        /// <summary>Whether the change descriptor would make any changes.</summary>
+        public bool HasChanges { get; }
+
+        /// <summary>Format a raw value into a normalized form.</summary>
+        public Func<string, string> FormatValue { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="add">The values to add to the field.</param>
+        /// <param name="remove">The values to remove from the field.</param>
+        /// <param name="replace">The values to replace in the field, if matched.</param>
+        /// <param name="formatValue">Format a raw value into a normalized form.</param>
+        public ChangeDescriptor(ISet<string> add, ISet<string> remove, IReadOnlyDictionary<string, string> replace, Func<string, string> formatValue)
+        {
+            this.Add = add;
+            this.Remove = remove;
+            this.Replace = replace;
+            this.HasChanges = add.Any() || remove.Any() || replace.Any();
+            this.FormatValue = formatValue;
+        }
+
+        /// <summary>Apply the change descriptors to a comma-delimited field.</summary>
+        /// <param name="rawField">The raw field text.</param>
+        /// <returns>Returns the modified field.</returns>
+        public string ApplyToCopy(string rawField)
+        {
+            // get list
+            List<string> values = !string.IsNullOrWhiteSpace(rawField)
+                ? new List<string>(rawField.Split(','))
+                : new List<string>();
+
+            // apply changes
+            this.Apply(values);
+
+            // format
+            if (rawField == null && !values.Any())
+                return null;
+            return string.Join(", ", values);
+        }
+
+        /// <summary>Apply the change descriptors to the given field values.</summary>
+        /// <param name="values">The field values.</param>
+        /// <returns>Returns the modified field values.</returns>
+        public void Apply(List<string> values)
+        {
+            // replace/remove values
+            if (this.Replace.Any() || this.Remove.Any())
+            {
+                for (int i = values.Count - 1; i >= 0; i--)
+                {
+                    string value = this.FormatValue(values[i]?.Trim() ?? string.Empty);
+
+                    if (this.Remove.Contains(value))
+                        values.RemoveAt(i);
+
+                    else if (this.Replace.TryGetValue(value, out string newValue))
+                        values[i] = newValue;
+                }
+            }
+
+            // add values
+            if (this.Add.Any())
+            {
+                HashSet<string> curValues = new(values.Select(p => p?.Trim() ?? string.Empty), StringComparer.OrdinalIgnoreCase);
+                foreach (string add in this.Add)
+                {
+                    if (!curValues.Contains(add))
+                    {
+                        values.Add(add);
+                        curValues.Add(add);
+                    }
+                }
+            }
+        }
+
+        /// <inheritdoc />
+        public override string ToString()
+        {
+            if (!this.HasChanges)
+                return string.Empty;
+
+            List<string> descriptors = new List<string>(this.Add.Count + this.Remove.Count + this.Replace.Count);
+            foreach (string add in this.Add)
+                descriptors.Add($"+{add}");
+            foreach (string remove in this.Remove)
+                descriptors.Add($"-{remove}");
+            foreach (var pair in this.Replace)
+                descriptors.Add($"{pair.Key} → {pair.Value}");
+
+            return string.Join(", ", descriptors);
+        }
+
+        /// <summary>Parse a raw change descriptor string into a <see cref="ChangeDescriptor"/> model.</summary>
+        /// <param name="descriptor">The raw change descriptor.</param>
+        /// <param name="errors">The human-readable error message describing any invalid values that were ignored.</param>
+        /// <param name="formatValue">Format a raw value into a normalized form if needed.</param>
+        public static ChangeDescriptor Parse(string descriptor, out string[] errors, Func<string, string> formatValue = null)
+        {
+            // init
+            formatValue ??= p => p;
+            var add = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+            var remove = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+            var replace = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
+
+            // parse each change in the descriptor
+            if (!string.IsNullOrWhiteSpace(descriptor))
+            {
+                List<string> rawErrors = new();
+                foreach (string rawEntry in descriptor.Split(','))
+                {
+                    // normalzie entry
+                    string entry = rawEntry.Trim();
+                    if (entry == string.Empty)
+                        continue;
+
+                    // parse as replace (old value → new value)
+                    if (entry.Contains('→'))
+                    {
+                        string[] parts = entry.Split(new[] { '→' }, 2);
+                        string oldValue = formatValue(parts[0].Trim());
+                        string newValue = formatValue(parts[1].Trim());
+
+                        if (oldValue == string.Empty)
+                        {
+                            rawErrors.Add($"Failed parsing '{rawEntry}': can't map from a blank old value. Use the '+value' format to add a value.");
+                            continue;
+                        }
+
+                        if (newValue == string.Empty)
+                        {
+                            rawErrors.Add($"Failed parsing '{rawEntry}': can't map to a blank value. Use the '-value' format to remove a value.");
+                            continue;
+                        }
+
+                        replace[oldValue] = newValue;
+                    }
+
+                    // else as remove
+                    else if (entry.StartsWith("-"))
+                    {
+                        entry = formatValue(entry.Substring(1).Trim());
+                        remove.Add(entry);
+                    }
+
+                    // else as add
+                    else
+                    {
+                        if (entry.StartsWith("+"))
+                            entry = formatValue(entry.Substring(1).Trim());
+                        add.Add(entry);
+                    }
+                }
+
+                errors = rawErrors.ToArray();
+            }
+            else
+                errors = Array.Empty<string>();
+
+            // build model
+            return new ChangeDescriptor(
+                add: add,
+                remove: remove,
+                replace: new ReadOnlyDictionary<string, string>(replace),
+                formatValue: formatValue
+            );
+        }
+    }
+}
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index da312471..f48c4ffa 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -6,6 +6,7 @@ using System.Net;
 using System.Threading.Tasks;
 using HtmlAgilityPack;
 using Pathoschild.Http.Client;
+using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
@@ -55,13 +56,33 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             if (betaVersion == stableVersion)
                 betaVersion = null;
 
-            // find mod entries
-            HtmlNodeCollection modNodes = doc.DocumentNode.SelectNodes("//table[@id='mod-list']//tr[@class='mod']");
-            if (modNodes == null)
-                throw new InvalidOperationException("Can't parse wiki compatibility list, no mods found.");
+            // parse mod data overrides
+            Dictionary<string, WikiDataOverrideEntry> overrides = new(StringComparer.OrdinalIgnoreCase);
+            {
+                HtmlNodeCollection modNodes = doc.DocumentNode.SelectNodes("//table[@id='mod-overrides-list']//tr[@class='mod']");
+                if (modNodes == null)
+                    throw new InvalidOperationException("Can't parse wiki compatibility list, no mod data overrides section found.");
 
-            // parse
-            WikiModEntry[] mods = this.ParseEntries(modNodes).ToArray();
+                foreach (var entry in this.ParseOverrideEntries(modNodes))
+                {
+                    if (entry.Ids?.Any() != true || !entry.HasChanges)
+                        continue;
+
+                    foreach (string id in entry.Ids)
+                        overrides[id] = entry;
+                }
+            }
+
+            // parse mod entries
+            WikiModEntry[] mods;
+            {
+                HtmlNodeCollection modNodes = doc.DocumentNode.SelectNodes("//table[@id='mod-list']//tr[@class='mod']");
+                if (modNodes == null)
+                    throw new InvalidOperationException("Can't parse wiki compatibility list, no mods found.");
+                mods = this.ParseModEntries(modNodes, overrides).ToArray();
+            }
+
+            // build model
             return new WikiModList
             {
                 StableVersion = stableVersion,
@@ -82,7 +103,8 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         *********/
         /// <summary>Parse valid mod compatibility entries.</summary>
         /// <param name="nodes">The HTML compatibility entries.</param>
-        private IEnumerable<WikiModEntry> ParseEntries(IEnumerable<HtmlNode> nodes)
+        /// <param name="overridesById">The mod data overrides to apply, if any.</param>
+        private IEnumerable<WikiModEntry> ParseModEntries(IEnumerable<HtmlNode> nodes, IDictionary<string, WikiDataOverrideEntry> overridesById)
         {
             foreach (HtmlNode node in nodes)
             {
@@ -103,9 +125,6 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                 string contentPackFor = this.GetAttribute(node, "data-content-pack-for");
                 string devNote = this.GetAttribute(node, "data-dev-note");
                 string pullRequestUrl = this.GetAttribute(node, "data-pr");
-                IDictionary<string, string> mapLocalVersions = this.GetAttributeAsVersionMapping(node, "data-map-local-versions");
-                IDictionary<string, string> mapRemoteVersions = this.GetAttributeAsVersionMapping(node, "data-map-remote-versions");
-                string[] changeUpdateKeys = this.GetAttributeAsCsv(node, "data-change-update-keys");
 
                 // parse stable compatibility
                 WikiCompatibilityInfo compatibility = new WikiCompatibilityInfo
@@ -134,6 +153,11 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                     }
                 }
 
+                // find data overrides
+                WikiDataOverrideEntry overrides = ids
+                    .Select(id => overridesById.TryGetValue(id, out overrides) ? overrides : null)
+                    .FirstOrDefault(p => p != null);
+
                 // yield model
                 yield return new WikiModEntry
                 {
@@ -154,14 +178,35 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                     Warnings = warnings,
                     PullRequestUrl = pullRequestUrl,
                     DevNote = devNote,
-                    ChangeUpdateKeys = changeUpdateKeys,
-                    MapLocalVersions = mapLocalVersions,
-                    MapRemoteVersions = mapRemoteVersions,
+                    Overrides = overrides,
                     Anchor = anchor
                 };
             }
         }
 
+        /// <summary>Parse valid mod data override entries.</summary>
+        /// <param name="nodes">The HTML mod data override entries.</param>
+        private IEnumerable<WikiDataOverrideEntry> ParseOverrideEntries(IEnumerable<HtmlNode> nodes)
+        {
+            foreach (HtmlNode node in nodes)
+            {
+                yield return new WikiDataOverrideEntry
+                {
+                    Ids = this.GetAttributeAsCsv(node, "data-id"),
+                    ChangeLocalVersions = this.GetAttributeAsChangeDescriptor(node, "data-local-version",
+                        raw => SemanticVersion.TryParse(raw, out ISemanticVersion version) ? version.ToString() : raw
+                    ),
+                    ChangeRemoteVersions = this.GetAttributeAsChangeDescriptor(node, "data-remote-version",
+                        raw => SemanticVersion.TryParse(raw, out ISemanticVersion version) ? version.ToString() : raw
+                    ),
+
+                    ChangeUpdateKeys = this.GetAttributeAsChangeDescriptor(node, "data-update-keys",
+                        raw => UpdateKey.TryParse(raw, out UpdateKey key) ? key.ToString() : raw
+                    )
+                };
+            }
+        }
+
         /// <summary>Get an attribute value.</summary>
         /// <param name="element">The element whose attributes to read.</param>
         /// <param name="name">The attribute name.</param>
@@ -174,6 +219,18 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             return WebUtility.HtmlDecode(value);
         }
 
+        /// <summary>Get an attribute value and parse it as a change descriptor.</summary>
+        /// <param name="element">The element whose attributes to read.</param>
+        /// <param name="name">The attribute name.</param>
+        /// <param name="formatValue">Format an raw entry value when applying changes.</param>
+        private ChangeDescriptor GetAttributeAsChangeDescriptor(HtmlNode element, string name, Func<string, string> formatValue)
+        {
+            string raw = this.GetAttribute(element, name);
+            return raw != null
+                ? ChangeDescriptor.Parse(raw, out _, formatValue)
+                : null;
+        }
+
         /// <summary>Get an attribute value and parse it as a comma-delimited list of strings.</summary>
         /// <param name="element">The element whose attributes to read.</param>
         /// <param name="name">The attribute name.</param>
@@ -221,28 +278,6 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             return null;
         }
 
-        /// <summary>Get an attribute value and parse it as a version mapping.</summary>
-        /// <param name="element">The element whose attributes to read.</param>
-        /// <param name="name">The attribute name.</param>
-        private IDictionary<string, string> GetAttributeAsVersionMapping(HtmlNode element, string name)
-        {
-            // get raw value
-            string raw = this.GetAttribute(element, name);
-            if (raw?.Contains("→") != true)
-                return null;
-
-            // parse
-            // Specified on the wiki in the form "remote version → mapped version; another remote version → mapped version"
-            IDictionary<string, string> map = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
-            foreach (string pair in raw.Split(';'))
-            {
-                string[] versions = pair.Split('→');
-                if (versions.Length == 2 && !string.IsNullOrWhiteSpace(versions[0]) && !string.IsNullOrWhiteSpace(versions[1]))
-                    map[versions[0].Trim()] = versions[1].Trim();
-            }
-            return map;
-        }
-
         /// <summary>Get the text of an element with the given class name.</summary>
         /// <param name="container">The metadata container.</param>
         /// <param name="className">The field name.</param>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
new file mode 100644
index 00000000..e5ee81be
--- /dev/null
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
@@ -0,0 +1,31 @@
+#nullable enable
+
+using System;
+
+namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
+{
+    /// <summary>The data overrides to apply to matching mods.</summary>
+    public class WikiDataOverrideEntry
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The unique mod IDs for the mods to override.</summary>
+        public string[] Ids { get; set; } = Array.Empty<string>();
+
+        /// <summary>Maps local versions to a semantic version for update checks.</summary>
+        public ChangeDescriptor? ChangeLocalVersions { get; set; }
+
+        /// <summary>Maps remote versions to a semantic version for update checks.</summary>
+        public ChangeDescriptor? ChangeRemoteVersions { get; set; }
+
+        /// <summary>Update keys to add (optionally prefixed by '+'), remove (prefixed by '-'), or replace.</summary>
+        public ChangeDescriptor? ChangeUpdateKeys { get; set; }
+
+        /// <summary>Whether the entry has any changes.</summary>
+        public bool HasChanges =>
+            this.ChangeLocalVersions?.HasChanges == true
+            || this.ChangeRemoteVersions?.HasChanges == true
+            || this.ChangeUpdateKeys?.HasChanges == true;
+    }
+}
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
index 21466c6a..4e0104da 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
@@ -1,6 +1,3 @@
-using System;
-using System.Collections.Generic;
-
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>A mod entry in the wiki list.</summary>
@@ -63,14 +60,8 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <summary>Special notes intended for developers who maintain unofficial updates or submit pull requests. </summary>
         public string DevNote { get; set; }
 
-        /// <summary>Update keys to add (optionally prefixed by '+') or remove (prefixed by '-').</summary>
-        public string[] ChangeUpdateKeys { get; set; }
-
-        /// <summary>Maps local versions to a semantic version for update checks.</summary>
-        public IDictionary<string, string> MapLocalVersions { get; set; }
-
-        /// <summary>Maps remote versions to a semantic version for update checks.</summary>
-        public IDictionary<string, string> MapRemoteVersions { get; set; }
+        /// <summary>The data overrides to apply to the mod's manifest or remote mod page data, if any.</summary>
+        public WikiDataOverrideEntry Overrides { get; set; }
 
         /// <summary>The link anchor for the mod entry in the wiki compatibility list.</summary>
         public string Anchor { get; set; }
diff --git a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
index 7e4d0220..077c0361 100644
--- a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
+++ b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
@@ -89,6 +89,16 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
             return new UpdateKey(raw, site, id, subkey);
         }
 
+        /// <summary>Parse a raw update key if it's valid.</summary>
+        /// <param name="raw">The raw update key to parse.</param>
+        /// <param name="parsed">The parsed update key, if valid.</param>
+        /// <returns>Returns whether the update key was successfully parsed.</returns>
+        public static bool TryParse(string raw, out UpdateKey parsed)
+        {
+            parsed = UpdateKey.Parse(raw);
+            return parsed.LooksValid;
+        }
+
         /// <summary>Get a string that represents the current object.</summary>
         public override string ToString()
         {
diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index c6e9a713..3ca07a08 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -144,7 +144,7 @@ namespace StardewModdingAPI.Web.Controllers
                 }
 
                 // fetch data
-                ModInfoModel data = await this.GetInfoForUpdateKeyAsync(updateKey, allowNonStandardVersions, wikiEntry?.MapRemoteVersions);
+                ModInfoModel data = await this.GetInfoForUpdateKeyAsync(updateKey, allowNonStandardVersions, wikiEntry?.Overrides?.ChangeRemoteVersions);
                 if (data.Status != RemoteModStatus.Ok)
                 {
                     errors.Add(data.Error ?? data.Status.ToString());
@@ -195,7 +195,7 @@ namespace StardewModdingAPI.Web.Controllers
             }
 
             // get recommended update (if any)
-            ISemanticVersion installedVersion = this.ModSites.GetMappedVersion(search.InstalledVersion?.ToString(), wikiEntry?.MapLocalVersions, allowNonStandard: allowNonStandardVersions);
+            ISemanticVersion installedVersion = this.ModSites.GetMappedVersion(search.InstalledVersion?.ToString(), wikiEntry?.Overrides?.ChangeLocalVersions, allowNonStandard: allowNonStandardVersions);
             if (apiVersion != null && installedVersion != null)
             {
                 // get newer versions
@@ -255,8 +255,8 @@ namespace StardewModdingAPI.Web.Controllers
         /// <summary>Get the mod info for an update key.</summary>
         /// <param name="updateKey">The namespaced update key.</param>
         /// <param name="allowNonStandardVersions">Whether to allow non-standard versions.</param>
-        /// <param name="mapRemoteVersions">Maps remote versions to a semantic version for update checks.</param>
-        private async Task<ModInfoModel> GetInfoForUpdateKeyAsync(UpdateKey updateKey, bool allowNonStandardVersions, IDictionary<string, string> mapRemoteVersions)
+        /// <param name="mapRemoteVersions">The changes to apply to remote versions for update checks.</param>
+        private async Task<ModInfoModel> GetInfoForUpdateKeyAsync(UpdateKey updateKey, bool allowNonStandardVersions, ChangeDescriptor mapRemoteVersions)
         {
             // get mod page
             IModPage page;
@@ -290,15 +290,12 @@ namespace StardewModdingAPI.Web.Controllers
                 .Distinct()
                 .ToList();
 
-            // apply remove overrides from wiki
+            // apply overrides from wiki
+            if (entry.Overrides?.ChangeUpdateKeys?.HasChanges == true)
             {
-                var removeKeys = new HashSet<UpdateKey>(
-                    from key in entry?.ChangeUpdateKeys ?? new string[0]
-                    where key.StartsWith('-')
-                    select UpdateKey.Parse(key.Substring(1))
-                );
-                if (removeKeys.Any())
-                    updateKeys.RemoveAll(removeKeys.Contains);
+                List<string> newKeys = updateKeys.Select(p => p.ToString()).ToList();
+                entry.Overrides.ChangeUpdateKeys.Apply(newKeys);
+                updateKeys = newKeys.Select(UpdateKey.Parse).ToList();
             }
 
             // if the list has both an update key (like "Nexus:2400") and subkey (like "Nexus:2400@subkey") for the same page, the subkey takes priority
@@ -348,15 +345,6 @@ namespace StardewModdingAPI.Web.Controllers
                 if (entry.ChucklefishID.HasValue)
                     yield return UpdateKey.GetString(ModSiteKey.Chucklefish, entry.ChucklefishID.ToString());
             }
-
-            // overrides from wiki
-            foreach (string key in entry?.ChangeUpdateKeys ?? Array.Empty<string>())
-            {
-                if (key.StartsWith('+'))
-                    yield return key.Substring(1);
-                else if (!key.StartsWith("-"))
-                    yield return key;
-            }
         }
     }
 }
diff --git a/src/SMAPI.Web/Framework/ModSiteManager.cs b/src/SMAPI.Web/Framework/ModSiteManager.cs
index 8f21d2f5..a2b92aa4 100644
--- a/src/SMAPI.Web/Framework/ModSiteManager.cs
+++ b/src/SMAPI.Web/Framework/ModSiteManager.cs
@@ -4,6 +4,7 @@ using System.Linq;
 using System.Text.RegularExpressions;
 using System.Threading.Tasks;
 using StardewModdingAPI.Toolkit;
+using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Web.Framework.Clients;
 
@@ -55,9 +56,9 @@ namespace StardewModdingAPI.Web.Framework
         /// <summary>Parse version info for the given mod page info.</summary>
         /// <param name="page">The mod page info.</param>
         /// <param name="subkey">The optional update subkey to match in available files. (If no file names or descriptions contain the subkey, it'll be ignored.)</param>
-        /// <param name="mapRemoteVersions">Maps remote versions to a semantic version for update checks.</param>
+        /// <param name="mapRemoteVersions">The changes to apply to remote versions for update checks.</param>
         /// <param name="allowNonStandardVersions">Whether to allow non-standard versions.</param>
-        public ModInfoModel GetPageVersions(IModPage page, string subkey, bool allowNonStandardVersions, IDictionary<string, string> mapRemoteVersions)
+        public ModInfoModel GetPageVersions(IModPage page, string subkey, bool allowNonStandardVersions, ChangeDescriptor mapRemoteVersions)
         {
             // get base model
             ModInfoModel model = new ModInfoModel()
@@ -79,9 +80,9 @@ namespace StardewModdingAPI.Web.Framework
 
         /// <summary>Get a semantic local version for update checks.</summary>
         /// <param name="version">The version to parse.</param>
-        /// <param name="map">A map of version replacements.</param>
+        /// <param name="map">Changes to apply to the raw version, if any.</param>
         /// <param name="allowNonStandard">Whether to allow non-standard versions.</param>
-        public ISemanticVersion GetMappedVersion(string version, IDictionary<string, string> map, bool allowNonStandard)
+        public ISemanticVersion GetMappedVersion(string version, ChangeDescriptor map, bool allowNonStandard)
         {
             // try mapped version
             string rawNewVersion = this.GetRawMappedVersion(version, map, allowNonStandard);
@@ -102,10 +103,10 @@ namespace StardewModdingAPI.Web.Framework
         /// <param name="mod">The mod to check.</param>
         /// <param name="subkey">The optional update subkey to match in available files. (If no file names or descriptions contain the subkey, it'll be ignored.)</param>
         /// <param name="allowNonStandardVersions">Whether to allow non-standard versions.</param>
-        /// <param name="mapRemoteVersions">Maps remote versions to a semantic version for update checks.</param>
+        /// <param name="mapRemoteVersions">The changes to apply to remote versions for update checks.</param>
         /// <param name="main">The main mod version.</param>
         /// <param name="preview">The latest prerelease version, if newer than <paramref name="main"/>.</param>
-        private bool TryGetLatestVersions(IModPage mod, string subkey, bool allowNonStandardVersions, IDictionary<string, string> mapRemoteVersions, out ISemanticVersion main, out ISemanticVersion preview)
+        private bool TryGetLatestVersions(IModPage mod, string subkey, bool allowNonStandardVersions, ChangeDescriptor mapRemoteVersions, out ISemanticVersion main, out ISemanticVersion preview)
         {
             main = null;
             preview = null;
@@ -179,31 +180,17 @@ namespace StardewModdingAPI.Web.Framework
 
         /// <summary>Get a semantic local version for update checks.</summary>
         /// <param name="version">The version to map.</param>
-        /// <param name="map">A map of version replacements.</param>
+        /// <param name="map">Changes to apply to the raw version, if any.</param>
         /// <param name="allowNonStandard">Whether to allow non-standard versions.</param>
-        private string GetRawMappedVersion(string version, IDictionary<string, string> map, bool allowNonStandard)
+        private string GetRawMappedVersion(string version, ChangeDescriptor map, bool allowNonStandard)
         {
-            if (version == null || map == null || !map.Any())
+            if (version == null || map?.HasChanges != true)
                 return version;
 
-            // match exact raw version
-            if (map.ContainsKey(version))
-                return map[version];
+            var mapped = new List<string> { version };
+            map.Apply(mapped);
 
-            // match parsed version
-            if (SemanticVersion.TryParse(version, allowNonStandard, out ISemanticVersion parsed))
-            {
-                if (map.ContainsKey(parsed.ToString()))
-                    return map[parsed.ToString()];
-
-                foreach ((string fromRaw, string toRaw) in map)
-                {
-                    if (SemanticVersion.TryParse(fromRaw, allowNonStandard, out ISemanticVersion target) && parsed.Equals(target) && SemanticVersion.TryParse(toRaw, allowNonStandard, out ISemanticVersion newVersion))
-                        return newVersion.ToString();
-                }
-            }
-
-            return version;
+            return mapped.FirstOrDefault();
         }
 
         /// <summary>Normalize a version string.</summary>

From 2e9a26c4395d79485f819145882fe51d69b65f4b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Oct 2021 17:53:45 -0400
Subject: [PATCH 298/856] restore toolkit method used by external tools

---
 .../Clients/WebApi/ModExtendedMetadataModel.cs       | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
index 5945ff6e..5c2ce366 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
@@ -1,3 +1,4 @@
+using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
@@ -151,5 +152,16 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
                 this.Name ??= db.DisplayName;
             }
         }
+
+        /// <summary>Get update keys based on the metadata.</summary>
+        public IEnumerable<string> GetUpdateKeys()
+        {
+            if (this.NexusID.HasValue)
+                yield return $"Nexus:{this.NexusID}";
+            if (this.ChucklefishID.HasValue)
+                yield return $"Chucklefish:{this.ChucklefishID}";
+            if (this.GitHubRepo != null)
+                yield return $"GitHub:{this.GitHubRepo}";
+        }
     }
 }

From 307c2919f4660d7774bd5f9cedb9c69940ba1069 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Oct 2021 19:55:37 -0400
Subject: [PATCH 299/856] fix error performing update check for mods with no
 wiki entry

---
 src/SMAPI.Web/Controllers/ModsApiController.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index 3ca07a08..dcddaf10 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -291,7 +291,7 @@ namespace StardewModdingAPI.Web.Controllers
                 .ToList();
 
             // apply overrides from wiki
-            if (entry.Overrides?.ChangeUpdateKeys?.HasChanges == true)
+            if (entry?.Overrides?.ChangeUpdateKeys?.HasChanges == true)
             {
                 List<string> newKeys = updateKeys.Select(p => p.ToString()).ToList();
                 entry.Overrides.ChangeUpdateKeys.Apply(newKeys);

From 2a0a7191a7b943a50e30077b5cdd36eb11aa5dd1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Oct 2021 23:37:48 -0400
Subject: [PATCH 300/856] fix barn/coop map edits resetting the exit warp

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 49 ++++++++++++++++++++---
 2 files changed, 44 insertions(+), 6 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 618dd696..65a2e93b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,7 @@
 
 * For mod authors:
   * Fixed map tile rotations/flips not working for farmhands in split-screen mode.
+  * Fixed barn/coop exit warps being reset when you edit their interior map.
 
 * For the web UI:
   * Added support for unified [mod data overrides](https://stardewvalleywiki.com/Modding:Mod_compatibility#Mod_data_overrides) defined on the wiki.
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 8bf7a32b..b176185b 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -184,8 +184,10 @@ namespace StardewModdingAPI.Metadata
 
                 if (!ignoreWorld)
                 {
-                    foreach (GameLocation location in this.GetLocations())
+                    foreach (LocationInfo info in this.GetLocationsWithInfo())
                     {
+                        GameLocation location = info.Location;
+
                         if (!string.IsNullOrWhiteSpace(location.mapPath.Value) && this.NormalizeAssetNameIgnoringEmpty(location.mapPath.Value) == key)
                         {
                             static ISet<string> GetWarpSet(GameLocation location)
@@ -196,7 +198,7 @@ namespace StardewModdingAPI.Metadata
                             }
 
                             var oldWarps = GetWarpSet(location);
-                            this.ReloadMap(location);
+                            this.ReloadMap(info);
                             var newWarps = GetWarpSet(location);
 
                             changedWarps = changedWarps || oldWarps.Count != newWarps.Count || oldWarps.Any(p => !newWarps.Contains(p));
@@ -906,9 +908,10 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Reload the map for a location.</summary>
-        /// <param name="location">The location whose map to reload.</param>
-        private void ReloadMap(GameLocation location)
+        /// <param name="locationInfo">The location whose map to reload.</param>
+        private void ReloadMap(LocationInfo locationInfo)
         {
+            GameLocation location = locationInfo.Location;
             Vector2? playerPos = Game1.player?.Position;
 
             if (this.AggressiveMemoryOptimizations)
@@ -929,6 +932,7 @@ namespace StardewModdingAPI.Metadata
             // update for changes
             location.updateWarps();
             location.updateDoors();
+            locationInfo.ParentBuilding?.updateInteriorWarps();
 
             // reset player position
             // The game may move the player as part of the map changes, even if they're not in that
@@ -1212,6 +1216,13 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Get all locations in the game.</summary>
         /// <param name="buildingInteriors">Whether to also get the interior locations for constructable buildings.</param>
         private IEnumerable<GameLocation> GetLocations(bool buildingInteriors = true)
+        {
+            return this.GetLocationsWithInfo(buildingInteriors).Select(info => info.Location);
+        }
+
+        /// <summary>Get all locations in the game.</summary>
+        /// <param name="buildingInteriors">Whether to also get the interior locations for constructable buildings.</param>
+        private IEnumerable<LocationInfo> GetLocationsWithInfo(bool buildingInteriors = true)
         {
             // get available root locations
             IEnumerable<GameLocation> rootLocations = Game1.locations;
@@ -1221,7 +1232,7 @@ namespace StardewModdingAPI.Metadata
             // yield root + child locations
             foreach (GameLocation location in rootLocations)
             {
-                yield return location;
+                yield return new(location, null);
 
                 if (buildingInteriors && location is BuildableGameLocation buildableLocation)
                 {
@@ -1229,7 +1240,7 @@ namespace StardewModdingAPI.Metadata
                     {
                         GameLocation indoors = building.indoors.Value;
                         if (indoors != null)
-                            yield return indoors;
+                            yield return new(indoors, building);
                     }
                 }
             }
@@ -1317,5 +1328,31 @@ namespace StardewModdingAPI.Metadata
             // remove key from cache
             return BuildingPainter.paintMaskLookup.Remove(key);
         }
+
+        /// <summary>Metadata about a location used in asset propagation.</summary>
+        private readonly struct LocationInfo
+        {
+            /*********
+            ** Accessors
+            *********/
+            /// <summary>The location instance.</summary>
+            public GameLocation Location { get; }
+
+            /// <summary>The building which contains the location, if any.</summary>
+            public Building ParentBuilding { get; }
+
+
+            /*********
+            ** Public methods
+            *********/
+            /// <summary>Construct an instance.</summary>
+            /// <param name="location">The location instance.</param>
+            /// <param name="parentBuilding">The building which contains the location, if any.</param>
+            public LocationInfo(GameLocation location, Building parentBuilding)
+            {
+                this.Location = location;
+                this.ParentBuilding = parentBuilding;
+            }
+        }
     }
 }

From 8263a4406be34b438d295220b99c48502a6636bd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Oct 2021 18:46:41 -0400
Subject: [PATCH 301/856] add key to duplicate-dictionary-key exceptions

---
 docs/release-notes.md                         |  1 +
 .../Patches/DictionaryPatcher.cs              | 33 ++++++++++++++++---
 2 files changed, 29 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 65a2e93b..a7a5e6dd 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@
   * Fixed mod edits to the farmhouse shifting the player down one tile in some cases.
 
 * For mod authors:
+  * SMAPI now intercepts dictionary duplicate-key errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
   * Fixed map tile rotations/flips not working for farmhands in split-screen mode.
   * Fixed barn/coop exit warps being reset when you edit their interior map.
 
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
index 6ad64e16..8ceafcc5 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
@@ -48,6 +48,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                         original: AccessTools.Method(dictionaryType, "get_Item") ?? throw new InvalidOperationException($"Can't find method {PatchHelper.GetMethodString(dictionaryType, "get_Item")} to patch."),
                         finalizer: this.GetHarmonyMethod(nameof(DictionaryPatcher.Finalize_GetItem))
                     );
+
+                    harmony.Patch(
+                        original: AccessTools.Method(dictionaryType, "Add") ?? throw new InvalidOperationException($"Can't find method {PatchHelper.GetMethodString(dictionaryType, "Add")} to patch."),
+                        finalizer: this.GetHarmonyMethod(nameof(DictionaryPatcher.Finalize_Add))
+                    );
                 }
             }
         }
@@ -63,13 +68,31 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static Exception Finalize_GetItem(object key, Exception __exception)
         {
             if (__exception is KeyNotFoundException)
-            {
-                DictionaryPatcher.Reflection
-                    .GetField<string>(__exception, "_message")
-                    .SetValue($"{__exception.Message}\nkey: '{key}'");
-            }
+                DictionaryPatcher.AddKey(__exception, key);
 
             return __exception;
         }
+
+        /// <summary>The method to call after a dictionary insert throws an exception.</summary>
+        /// <param name="key">The dictionary key being inserted.</param>
+        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
+        /// <returns>Returns the exception to throw, if any.</returns>
+        private static Exception Finalize_Add(object key, Exception __exception)
+        {
+            if (__exception is ArgumentException)
+                DictionaryPatcher.AddKey(__exception, key);
+
+            return __exception;
+        }
+
+        /// <summary>Add the dictionary key to an exception message.</summary>
+        /// <param name="exception">The exception whose message to edit.</param>
+        /// <param name="key">The dictionary key.</param>
+        private static void AddKey(Exception exception, object key)
+        {
+            DictionaryPatcher.Reflection
+                .GetField<string>(exception, "_message")
+                .SetValue($"{exception.Message}\nkey: '{key}'");
+        }
     }
 }

From 52758e4e43ad60e7b9e69d00cf4a75d1515277fe Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Oct 2021 18:47:28 -0400
Subject: [PATCH 302/856] fix build error with Stardew Valley 1.5.4

---
 src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs  | 3 +--
 .../Framework/Clients/Wiki/WikiDataOverrideEntry.cs           | 4 +---
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
index 6fcc3b18..44ebf297 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
@@ -2,7 +2,6 @@ using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using System.Linq;
-using System.Text;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
@@ -180,7 +179,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                 errors = rawErrors.ToArray();
             }
             else
-                errors = Array.Empty<string>();
+                errors = new string[0];
 
             // build model
             return new ChangeDescriptor(
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
index e5ee81be..0587e09d 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
@@ -1,7 +1,5 @@
 #nullable enable
 
-using System;
-
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>The data overrides to apply to matching mods.</summary>
@@ -11,7 +9,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         ** Accessors
         *********/
         /// <summary>The unique mod IDs for the mods to override.</summary>
-        public string[] Ids { get; set; } = Array.Empty<string>();
+        public string[] Ids { get; set; } = new string[0];
 
         /// <summary>Maps local versions to a semantic version for update checks.</summary>
         public ChangeDescriptor? ChangeLocalVersions { get; set; }

From 08ba5dc52053a62be1fe3319ab3428a2c41fee28 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Oct 2021 19:41:26 -0400
Subject: [PATCH 303/856] bump to .NET Framework 4.5.2

---
 build/common.targets                                          | 4 ++--
 build/prepare-install-package.targets                         | 2 +-
 src/SMAPI.Installer/SMAPI.Installer.csproj                    | 2 +-
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj          | 2 +-
 .../SMAPI.Mods.ConsoleCommands.csproj                         | 2 +-
 src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj    | 2 +-
 src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj        | 2 +-
 src/SMAPI.Tests/SMAPI.Tests.csproj                            | 2 +-
 .../SMAPI.Toolkit.CoreInterfaces.csproj                       | 2 +-
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj                        | 2 +-
 src/SMAPI/SMAPI.csproj                                        | 2 +-
 11 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 1f6cf0b6..11584d33 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -54,13 +54,13 @@
     <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)\i18n" />
   </Target>
 
-  <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit' AND $(TargetFramework) == 'net4.5'" AfterTargets="PostBuildEvent">
+  <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit' AND $(TargetFramework) == 'net452'" AfterTargets="PostBuildEvent">
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
 
-  <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces' AND $(TargetFramework) == 'net4.5'" AfterTargets="PostBuildEvent">
+  <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces' AND $(TargetFramework) == 'net452'" AfterTargets="PostBuildEvent">
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index 88e565f9..601f6496 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -14,7 +14,7 @@
       <OutRootPath>$(SolutionDir)\..\bin</OutRootPath>
 
       <SmapiBin>$(BuildRootPath)\SMAPI\bin\$(Configuration)</SmapiBin>
-      <ToolkitBin>$(BuildRootPath)\SMAPI.Toolkit\bin\$(Configuration)\net4.5</ToolkitBin>
+      <ToolkitBin>$(BuildRootPath)\SMAPI.Toolkit\bin\$(Configuration)\net452</ToolkitBin>
       <ConsoleCommandsBin>$(BuildRootPath)\SMAPI.Mods.ConsoleCommands\bin\$(Configuration)</ConsoleCommandsBin>
       <ErrorHandlerBin>$(BuildRootPath)\SMAPI.Mods.ErrorHandler\bin\$(Configuration)</ErrorHandlerBin>
       <SaveBackupBin>$(BuildRootPath)\SMAPI.Mods.SaveBackup\bin\$(Configuration)</SaveBackupBin>
diff --git a/src/SMAPI.Installer/SMAPI.Installer.csproj b/src/SMAPI.Installer/SMAPI.Installer.csproj
index 1777be5f..c47f3e6e 100644
--- a/src/SMAPI.Installer/SMAPI.Installer.csproj
+++ b/src/SMAPI.Installer/SMAPI.Installer.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI.Installer</RootNamespace>
     <Description>The SMAPI installer for players.</Description>
-    <TargetFramework>net45</TargetFramework>
+    <TargetFramework>net452</TargetFramework>
     <OutputType>Exe</OutputType>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index b18e79d5..93769650 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <!--build-->
     <RootNamespace>StardewModdingAPI.ModBuildConfig</RootNamespace>
-    <TargetFramework>net45</TargetFramework>
+    <TargetFramework>net452</TargetFramework>
     <LangVersion>latest</LangVersion>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index a187c1ff..528348a0 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>ConsoleCommands</AssemblyName>
     <RootNamespace>StardewModdingAPI.Mods.ConsoleCommands</RootNamespace>
-    <TargetFramework>net45</TargetFramework>
+    <TargetFramework>net452</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index eb878bc5..182a978e 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>ErrorHandler</AssemblyName>
     <RootNamespace>StardewModdingAPI.Mods.ErrorHandler</RootNamespace>
-    <TargetFramework>net45</TargetFramework>
+    <TargetFramework>net452</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
index a6f76781..079beb08 100644
--- a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
+++ b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>SaveBackup</AssemblyName>
     <RootNamespace>StardewModdingAPI.Mods.SaveBackup</RootNamespace>
-    <TargetFramework>net45</TargetFramework>
+    <TargetFramework>net452</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 27520baf..8f7bfab4 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>SMAPI.Tests</AssemblyName>
     <RootNamespace>SMAPI.Tests</RootNamespace>
-    <TargetFramework>net45</TargetFramework>
+    <TargetFramework>net452</TargetFramework>
     <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
index d36a1882..0e1e40b2 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
+++ b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI</RootNamespace>
     <Description>Provides toolkit interfaces which are available to SMAPI mods.</Description>
-    <TargetFrameworks>net4.5;netstandard2.0</TargetFrameworks>
+    <TargetFrameworks>net452;netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 0e051c84..3d87c169 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI.Toolkit</RootNamespace>
     <Description>A library which encapsulates mod-handling logic for mod managers and tools. Not intended for use by mods.</Description>
-    <TargetFrameworks>net4.5;netstandard2.0</TargetFrameworks>
+    <TargetFrameworks>net452;netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 0f1b0516..c147e7dc 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -3,7 +3,7 @@
     <AssemblyName>StardewModdingAPI</AssemblyName>
     <RootNamespace>StardewModdingAPI</RootNamespace>
     <Description>The modding API for Stardew Valley.</Description>
-    <TargetFramework>net45</TargetFramework>
+    <TargetFramework>net452</TargetFramework>
     <PlatformTarget>x86</PlatformTarget>
     <OutputType>Exe</OutputType>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>

From 2b76309b53f8cf322152801d0c1ca6e3b3c777f5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Oct 2021 19:53:43 -0400
Subject: [PATCH 304/856] fix compile errors on Linux

---
 .../Framework/Clients/Wiki/ChangeDescriptor.cs              | 6 +++---
 src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs      | 2 +-
 src/SMAPI/Metadata/CoreAssetPropagator.cs                   | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
index 44ebf297..f1feb44b 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
@@ -86,7 +86,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             // add values
             if (this.Add.Any())
             {
-                HashSet<string> curValues = new(values.Select(p => p?.Trim() ?? string.Empty), StringComparer.OrdinalIgnoreCase);
+                HashSet<string> curValues = new HashSet<string>(values.Select(p => p?.Trim() ?? string.Empty), StringComparer.OrdinalIgnoreCase);
                 foreach (string add in this.Add)
                 {
                     if (!curValues.Contains(add))
@@ -130,10 +130,10 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             // parse each change in the descriptor
             if (!string.IsNullOrWhiteSpace(descriptor))
             {
-                List<string> rawErrors = new();
+                List<string> rawErrors = new List<string>();
                 foreach (string rawEntry in descriptor.Split(','))
                 {
-                    // normalzie entry
+                    // normalize entry
                     string entry = rawEntry.Trim();
                     if (entry == string.Empty)
                         continue;
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index f48c4ffa..f85e82e1 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -57,7 +57,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                 betaVersion = null;
 
             // parse mod data overrides
-            Dictionary<string, WikiDataOverrideEntry> overrides = new(StringComparer.OrdinalIgnoreCase);
+            Dictionary<string, WikiDataOverrideEntry> overrides = new Dictionary<string, WikiDataOverrideEntry>(StringComparer.OrdinalIgnoreCase);
             {
                 HtmlNodeCollection modNodes = doc.DocumentNode.SelectNodes("//table[@id='mod-overrides-list']//tr[@class='mod']");
                 if (modNodes == null)
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index b176185b..7efd99a0 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1232,7 +1232,7 @@ namespace StardewModdingAPI.Metadata
             // yield root + child locations
             foreach (GameLocation location in rootLocations)
             {
-                yield return new(location, null);
+                yield return new LocationInfo(location, null);
 
                 if (buildingInteriors && location is BuildableGameLocation buildableLocation)
                 {
@@ -1240,7 +1240,7 @@ namespace StardewModdingAPI.Metadata
                     {
                         GameLocation indoors = building.indoors.Value;
                         if (indoors != null)
-                            yield return new(indoors, building);
+                            yield return new LocationInfo(indoors, building);
                     }
                 }
             }

From 50fdc7bb34975e4be1d5781964785bdd3f05a923 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Oct 2021 21:06:32 -0400
Subject: [PATCH 305/856] update translation docs

---
 docs/README.md        | 3 +++
 docs/release-notes.md | 2 ++
 2 files changed, 5 insertions(+)

diff --git a/docs/README.md b/docs/README.md
index e7b8a9b3..d058c091 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -69,4 +69,7 @@ Korean     | ✓ [fully translated](../src/SMAPI/i18n/ko.json)
 Portuguese | ✓ [fully translated](../src/SMAPI/i18n/pt.json)
 Russian    | ✓ [fully translated](../src/SMAPI/i18n/ru.json)
 Spanish    | ✓ [fully translated](../src/SMAPI/i18n/es.json)
+Thai¹      | ✓ [fully translated](../src/SMAPI/i18n/th.json)
 Turkish    | ✓ [fully translated](../src/SMAPI/i18n/tr.json)
+
+¹ Requires [Stardew Valley - THAI](https://www.nexusmods.com/stardewvalley/mods/7052) or similar.
diff --git a/docs/release-notes.md b/docs/release-notes.md
index a7a5e6dd..3fa97cd4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,8 @@
 ## Upcoming release
 * For players:
   * Fixed mod edits to the farmhouse shifting the player down one tile in some cases.
+  * Improved translations. Thanks to ellipszist (added Thai)!  
+    _Note: Thai requires Stardew Valley 1.5.5 and the [Thai mod](https://www.nexusmods.com/stardewvalley/mods/7052)._
 
 * For mod authors:
   * SMAPI now intercepts dictionary duplicate-key errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)

From 65e0de3920ce83be1c7c6671733103cdbef20d19 Mon Sep 17 00:00:00 2001
From: Zangorr <91568890+Zangorr@users.noreply.github.com>
Date: Wed, 29 Sep 2021 05:55:03 +0200
Subject: [PATCH 306/856] Add Polish translation

---
 src/SMAPI/i18n/pl.json | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 src/SMAPI/i18n/pl.json

diff --git a/src/SMAPI/i18n/pl.json b/src/SMAPI/i18n/pl.json
new file mode 100644
index 00000000..b9c788fc
--- /dev/null
+++ b/src/SMAPI/i18n/pl.json
@@ -0,0 +1,6 @@
+{
+    // short date format for SDate
+    // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
+    "generic.date": "{{day}} {{seasonLowercase}}",
+    "generic.date-with-year": "{{day}} {{seasonLowercase}} w roku {{year}}"
+}

From db89ff0fcdbecf5dc69033157f03f586e2311ad7 Mon Sep 17 00:00:00 2001
From: Zangorr <91568890+Zangorr@users.noreply.github.com>
Date: Wed, 29 Sep 2021 05:55:27 +0200
Subject: [PATCH 307/856] Add Polish translation

---
 src/SMAPI.Mods.ErrorHandler/i18n/pl.json | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/pl.json

diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/pl.json b/src/SMAPI.Mods.ErrorHandler/i18n/pl.json
new file mode 100644
index 00000000..05a9d411
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/pl.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Nieprawidłowa zawartość została usunięta, aby zapobiec awarii (zobacz konsolę SMAPI po więcej informacji)."
+}

From 6268abed37cefe581bedc958b7d29b653d0468be Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Oct 2021 19:01:01 -0400
Subject: [PATCH 308/856] update translation docs

---
 docs/README.md        | 4 +++-
 docs/release-notes.md | 4 ++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index d058c091..ecfa6f2b 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -66,10 +66,12 @@ Hungarian  | ✓ [fully translated](../src/SMAPI/i18n/hu.json)
 Italian    | ✓ [fully translated](../src/SMAPI/i18n/it.json)
 Japanese   | ✓ [fully translated](../src/SMAPI/i18n/ja.json)
 Korean     | ✓ [fully translated](../src/SMAPI/i18n/ko.json)
+Polish¹    | ✓ [fully translated](../src/SMAPI/i18n/pl.json)
 Portuguese | ✓ [fully translated](../src/SMAPI/i18n/pt.json)
 Russian    | ✓ [fully translated](../src/SMAPI/i18n/ru.json)
 Spanish    | ✓ [fully translated](../src/SMAPI/i18n/es.json)
 Thai¹      | ✓ [fully translated](../src/SMAPI/i18n/th.json)
 Turkish    | ✓ [fully translated](../src/SMAPI/i18n/tr.json)
 
-¹ Requires [Stardew Valley - THAI](https://www.nexusmods.com/stardewvalley/mods/7052) or similar.
+¹ This is a custom language provided by a mod (see [Polish](https://www.nexusmods.com/stardewvalley/mods/3616)
+and [Thai](https://www.nexusmods.com/stardewvalley/mods/7052)).
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3fa97cd4..422435a6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,8 +4,8 @@
 ## Upcoming release
 * For players:
   * Fixed mod edits to the farmhouse shifting the player down one tile in some cases.
-  * Improved translations. Thanks to ellipszist (added Thai)!  
-    _Note: Thai requires Stardew Valley 1.5.5 and the [Thai mod](https://www.nexusmods.com/stardewvalley/mods/7052)._
+  * Improved translations. Thanks to ellipszist (added Thai) and Zangorr (added Polish)!  
+    _(These are custom languages which require Stardew Valley 1.5.5 and the [Polish](https://www.nexusmods.com/stardewvalley/mods/3616) or [Thai](https://www.nexusmods.com/stardewvalley/mods/7052) mod.)_
 
 * For mod authors:
   * SMAPI now intercepts dictionary duplicate-key errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)

From ccbf589a5b1bce13d5e1897de854bebf15c53105 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Oct 2021 19:28:14 -0400
Subject: [PATCH 309/856] update for new build path

---
 src/SMAPI.Internal/ExceptionHelper.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Internal/ExceptionHelper.cs b/src/SMAPI.Internal/ExceptionHelper.cs
index 4bc55f95..05b96c2e 100644
--- a/src/SMAPI.Internal/ExceptionHelper.cs
+++ b/src/SMAPI.Internal/ExceptionHelper.cs
@@ -65,7 +65,7 @@ namespace StardewModdingAPI.Internal
 
             // remove unneeded root build paths for SMAPI and Stardew Valley
             message = message
-                .Replace(@"C:\source\_Stardew\SMAPI\src\", "")
+                .Replace(@"E:\source\_Stardew\SMAPI\src\", "")
                 .Replace(@"C:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\", "");
 
             // remove placeholder info in Linux/macOS stack traces

From 6bb156b3184d78789b5c8ddc8ce544b0fcb10a1e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Oct 2021 19:50:39 -0400
Subject: [PATCH 310/856] update release process to use Windows 11 WSL instead
 of a Linux VM

---
 docs/technical/smapi.md | 48 ++++++++++++++++++++++++++++++++++++-----
 1 file changed, 43 insertions(+), 5 deletions(-)

diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 4be062e2..f454e99c 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -76,10 +76,48 @@ the debugger attached, so you can intercept errors and step through the code bei
 doesn't work in MonoDevelop on Linux, unfortunately.
 
 ### Preparing a release
-To prepare a crossplatform SMAPI release, you'll need to compile it on two platforms. See
-[crossplatforming info](https://stardewvalleywiki.com/Modding:Modder_Guide/Test_and_Troubleshoot#Testing_on_all_platforms)
-on the wiki for the first-time setup.
+To prepare a crossplatform SMAPI release, you'll need to compile it on two platforms: Windows and
+Linux. The instructions below assume you have Windows 11, but you can adapt them for
+a different setup if needed.
 
+#### Initial setup
+First-time setup on Windows:
+1. [Install Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/install).
+2. Install the needed software in WSL:
+   1. Run `sudo apt update` to update the package list.
+   2. Install [the .NET 5 SDK](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu)
+      (for Stardew Valley 1.5.5+) or [`mono-complete`](https://www.mono-project.com/download/stable/)
+      (for earlier versions).
+      _You can run `lsb_release -a` to get the Ubuntu version number._
+   3. [Install Steam](https://linuxconfig.org/how-to-install-steam-on-ubuntu-20-04-focal-fossa-linux).
+   4. Launch `steam` and install the game like usual.
+   5. Download and install your preferred IDE. For the [latest standalone Rider
+      version](https://www.jetbrains.com/help/rider/Installation_guide.html#prerequisites):
+      ```sh
+      wget "<download url here>" -O rider-install.tar.gz
+      sudo tar -xzvf rider-install.tar.gz -C /opt
+      ln -s "/opt/JetBrains Rider-<version>/bin/rider.sh"
+      ./rider.sh
+      ```
+   3. Clone the SMAPI repo in WSL:
+      ```sh
+      git clone https://github.com/Pathoschild/SMAPI.git
+      ```
+
+To compile SMAPI in WSL:
+1. Run `./rider.sh` to open the Rider GUI.
+2. Use the GUI to compile the solution.
+
+To launch the game:
+1. Open a WSL terminal.
+2. Run these commands to start Steam:
+   ```sh
+   export TERM=xterm
+   steam
+   ```
+3. Launch the game through the Steam UI.
+
+#### Prepare the release
 1. Update the version numbers in `build/common.targets`, `Constants`, and the `manifest.json` for
    bundled mods. Make sure you use a [semantic version](https://semver.org). Recommended format:
 
@@ -90,8 +128,8 @@ on the wiki for the first-time setup.
    release    | `<version>`              | `3.0.0`
 2. In Windows:
    1. Rebuild the solution with the _release_ solution configuration.
-   2. Copy the `bin/SMAPI installer` and `bin/SMAPI installer for developers` folders to Linux/macOS.
-4. In Linux/macOS:
+   2. Copy the `bin/SMAPI installer` and `bin/SMAPI installer for developers` folders to Linux.
+4. In Linux:
    1. Rebuild the solution with the _release_ solution configuration.
    2. Add the `windows-install.*` files from Windows to the `bin/SMAPI installer` and
       `bin/SMAPI installer for developers` folders compiled on Linux.

From f8c9a2929bb42ef7f71fa3a2d258c5566960aa69 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Oct 2021 19:53:24 -0400
Subject: [PATCH 311/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 6 ++++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 11584d33..02142351 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.7</Version>
+    <Version>3.12.8</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 422435a6..25b0d740 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,11 +1,13 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.12.8
+Released 18 October 2021 for Stardew Valley 1.5.4.
+
 * For players:
   * Fixed mod edits to the farmhouse shifting the player down one tile in some cases.
   * Improved translations. Thanks to ellipszist (added Thai) and Zangorr (added Polish)!  
-    _(These are custom languages which require Stardew Valley 1.5.5 and the [Polish](https://www.nexusmods.com/stardewvalley/mods/3616) or [Thai](https://www.nexusmods.com/stardewvalley/mods/7052) mod.)_
+    _These are custom languages which require Stardew Valley 1.5.5 and the [Polish](https://www.nexusmods.com/stardewvalley/mods/3616) or [Thai](https://www.nexusmods.com/stardewvalley/mods/7052) mod._
 
 * For mod authors:
   * SMAPI now intercepts dictionary duplicate-key errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index e53bf991..9af3ce5d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.7",
+    "Version": "3.12.8",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.7"
+    "MinimumApiVersion": "3.12.8"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 37a7e9bf..cfbaa661 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.7",
+    "Version": "3.12.8",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.7"
+    "MinimumApiVersion": "3.12.8"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 28c7ec14..1efd1d89 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.7",
+    "Version": "3.12.8",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.7"
+    "MinimumApiVersion": "3.12.8"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index fbc00d1d..42c3b21b 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -54,7 +54,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.7";
+        internal static string RawApiVersion = "3.12.8";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 68c58a477783fc2ab3e0d3558ce3b6345a21236e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 18 Oct 2021 17:17:54 -0400
Subject: [PATCH 312/856] move release note

---
 docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 25b0d740..fa2ec91b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,12 +6,12 @@ Released 18 October 2021 for Stardew Valley 1.5.4.
 
 * For players:
   * Fixed mod edits to the farmhouse shifting the player down one tile in some cases.
+  * Fixed map tile rotations/flips not working for farmhands in split-screen mode.
   * Improved translations. Thanks to ellipszist (added Thai) and Zangorr (added Polish)!  
     _These are custom languages which require Stardew Valley 1.5.5 and the [Polish](https://www.nexusmods.com/stardewvalley/mods/3616) or [Thai](https://www.nexusmods.com/stardewvalley/mods/7052) mod._
 
 * For mod authors:
   * SMAPI now intercepts dictionary duplicate-key errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
-  * Fixed map tile rotations/flips not working for farmhands in split-screen mode.
   * Fixed barn/coop exit warps being reset when you edit their interior map.
 
 * For the web UI:

From e89de6316d8a8b2e0169790b2a14427892828be5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 30 Oct 2021 19:53:28 -0400
Subject: [PATCH 313/856] add set_farm_type console command

---
 docs/release-notes.md                         |  4 +
 .../Commands/Player/SetFarmTypeCommand.cs     | 91 +++++++++++++++++++
 2 files changed, 95 insertions(+)
 create mode 100644 src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index fa2ec91b..42519b1f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Added `set_farm_type` [console command](https://stardewvalleywiki.com/Modding:Console_commands#Console_commands) to change the current farm type.
+
 ## 3.12.8
 Released 18 October 2021 for Stardew Valley 1.5.4.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
new file mode 100644
index 00000000..0bebd2b7
--- /dev/null
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
@@ -0,0 +1,91 @@
+using System.Collections.Generic;
+using System.Linq;
+using StardewValley;
+
+namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
+{
+    /// <summary>A command which changes the player's farm type.</summary>
+    internal class SetFarmTypeCommand : ConsoleCommand
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The vanilla farm type IDs.</summary>
+        private static readonly ISet<int> VanillaFarmTypes = new HashSet<int>(
+            Enumerable.Range(0, Farm.layout_max + 1)
+        );
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public SetFarmTypeCommand()
+            : base("set_farm_type", $"Sets the current player's farm type.\n\nUsage: set_farm_type <farm type>\n- farm type: one of {string.Join(", ", SetFarmTypeCommand.VanillaFarmTypes.Select(id => $"{id} ({SetFarmTypeCommand.GetFarmLabel(id)})"))}.") { }
+
+        /// <summary>Handle the command.</summary>
+        /// <param name="monitor">Writes messages to the console and log file.</param>
+        /// <param name="command">The command name.</param>
+        /// <param name="args">The command arguments.</param>
+        public override void Handle(IMonitor monitor, string command, ArgumentParser args)
+        {
+            // validation checks
+            if (!Context.IsWorldReady)
+            {
+                monitor.Log("You must load a save to use this command.", LogLevel.Error);
+                return;
+            }
+
+            // parse argument
+            if (!args.TryGetInt(0, "farm type", out int farmType, min: 0, max: Farm.layout_max))
+                return;
+
+            // handle
+            if (Game1.whichFarm == farmType)
+            {
+                monitor.Log($"Your current farm is already set to {farmType} ({SetFarmTypeCommand.GetFarmLabel(farmType)}).", LogLevel.Info);
+                return;
+            }
+
+            this.SetFarmType(farmType);
+            monitor.Log($"Your current farm has been converted to {farmType} ({SetFarmTypeCommand.GetFarmLabel(farmType)}).", LogLevel.Warn);
+            monitor.Log("Saving and reloading is recommended to make sure everything is updated for the change.", LogLevel.Warn);
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Change the farm type to the given value.</summary>
+        /// <param name="type">The farm type ID.</param>
+        private void SetFarmType(int type)
+        {
+            Game1.whichFarm = type;
+
+            Farm farm = Game1.getFarm();
+            farm.mapPath.Value = $@"Maps\{Farm.getMapNameFromTypeInt(Game1.whichFarm)}";
+            farm.reloadMap();
+        }
+
+        /// <summary>Get the display name for a vanilla farm type.</summary>
+        /// <param name="type">The farm type.</param>
+        private static string GetFarmLabel(int type)
+        {
+            string translationKey = type switch
+            {
+                Farm.default_layout => "Character_FarmStandard",
+                Farm.riverlands_layout => "Character_FarmFishing",
+                Farm.forest_layout => "Character_FarmForaging",
+                Farm.mountains_layout => "Character_FarmMining",
+                Farm.combat_layout => "Character_FarmCombat",
+                Farm.fourCorners_layout => "Character_FarmFourCorners",
+                Farm.beach_layout => "Character_FarmBeach",
+                _ => null
+            };
+
+            return translationKey != null
+                ? Game1.content.LoadString(@$"Strings\UI:{translationKey}").Split('_')[0]
+                : type.ToString();
+        }
+    }
+}

From 96db1d931552ef8973cdf07e3f1d4a4618992276 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 31 Oct 2021 14:14:21 -0400
Subject: [PATCH 314/856] update Content Patcher schema for 1.24.0

---
 docs/release-notes.md                              | 3 +++
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 6 +++---
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 42519b1f..efda7267 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,9 @@
 * For players:
   * Added `set_farm_type` [console command](https://stardewvalleywiki.com/Modding:Console_commands#Console_commands) to change the current farm type.
 
+* For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.24.0.
+
 ## 3.12.8
 Released 18 October 2021 for Stardew Valley 1.5.4.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index aac4ff0f..d39574ef 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -12,11 +12,11 @@
     "properties": {
         "Format": {
             "title": "Format version",
-            "description": "The format version. You should always use the latest version to enable the latest features and avoid obsolete behavior.",
+            "description": "The format version. You should always use the latest version to enable the latest features, avoid obsolete behavior, and reduce load times.",
             "type": "string",
-            "const": "1.23.0",
+            "const": "1.24.0",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. This should be set to the latest format version, currently '1.23.0'."
+                "const": "Incorrect value '@value'. You should always use the latest format version (currently 1.24.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
             }
         },
         "ConfigSchema": {

From 01f59000e96357ec5288c4cc86348c90ce272ba4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 31 Oct 2021 14:37:51 -0400
Subject: [PATCH 315/856] ignore WebDeploy files

---
 .gitignore                     | 2 ++
 src/SMAPI.Web/SMAPI.Web.csproj | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/.gitignore b/.gitignore
index b7f0d3e6..527ac6bb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,6 +11,7 @@
 [Oo]bj/
 
 # Visual Studio cache/options
+.config/
 .vs/
 
 # ReSharper
@@ -32,3 +33,4 @@ appsettings.Development.json
 
 # Azure generated files
 src/SMAPI.Web/Properties/PublishProfiles/*.pubxml
+src/SMAPI.Web/Properties/ServiceDependencies/* - Web Deploy/
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index 4c8465a6..c1ba3ddc 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -9,6 +9,8 @@
   <Import Project="..\..\build\common.targets" />
 
   <ItemGroup>
+    <None Remove="Properties\PublishProfiles\**" />
+    <None Remove="Properties\ServiceDependencies\**" />
     <Content Remove="aws-beanstalk-tools-defaults.json" />
   </ItemGroup>
 

From 12e0c1519663b7106c5672ce75c6e94d8ab7638f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 27 Nov 2021 22:37:21 -0500
Subject: [PATCH 316/856] migrate web project to .NET 6, update web & unit test
 packages

---
 .../SMAPI.ModBuildConfig.Analyzer.Tests.csproj   |  4 ++--
 src/SMAPI.Web/SMAPI.Web.csproj                   | 16 ++++++++--------
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
index 8cc61f44..dc3d8320 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
@@ -7,9 +7,9 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="2.10.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.9.4" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="3.17.0">
+    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index c1ba3ddc..f1400e62 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>SMAPI.Web</AssemblyName>
     <RootNamespace>StardewModdingAPI.Web</RootNamespace>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
 
@@ -15,16 +15,16 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Azure.Storage.Blobs" Version="12.8.3" />
-    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.22" />
+    <PackageReference Include="Azure.Storage.Blobs" Version="12.10.0" />
+    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.27" />
     <PackageReference Include="Hangfire.MemoryStorage" Version="1.7.0" />
     <PackageReference Include="HtmlAgilityPack" Version="1.11.33" />
-    <PackageReference Include="Humanizer.Core" Version="2.9.9" />
-    <PackageReference Include="JetBrains.Annotations" Version="2021.1.0" />
-    <PackageReference Include="Markdig" Version="0.24.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.8" />
+    <PackageReference Include="Humanizer.Core" Version="2.13.14" />
+    <PackageReference Include="JetBrains.Annotations" Version="2021.3.0" />
+    <PackageReference Include="Markdig" Version="0.26.0" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="6.0.0" />
     <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.14" />
-    <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.2" />
+    <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.5" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
   </ItemGroup>
   <ItemGroup>

From b64cec918d1511b6b71c9d2e30f987e9b5cc24fd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 27 Nov 2021 22:45:14 -0500
Subject: [PATCH 317/856] remove direct download for beta versions

With this change, only the main version has a direct download.

Showing beta info here caused a few issues:
* The vast majority of players don't use the game beta, so they were often confused about which version to download.
* Beta versions typically have much longer release info (e.g. detailed summary, release notes, caveats and warnings, etc), and the extra download button made the player guide button under it less prominent and visible. Those both contributed to information overload and the above confusion.
* Unlike main versions, beta versions aren't permanently archived on GitHub (since the beta branch is routinely rebased onto the latest stable update). That makes it messy to manage beta releases through GitHub.

Instead there's now a message under the download button which clearly links to where the beta version can be downloaded.
---
 src/SMAPI.Web/Controllers/IndexController.cs  | 52 ++++------------
 .../Framework/ConfigModels/SiteConfig.cs      |  7 +--
 src/SMAPI.Web/ViewModels/IndexModel.cs        | 15 ++---
 src/SMAPI.Web/Views/Index/Index.cshtml        | 59 ++++---------------
 src/SMAPI.Web/appsettings.json                |  3 +-
 src/SMAPI.Web/wwwroot/Content/css/index.css   |  4 ++
 6 files changed, 36 insertions(+), 104 deletions(-)

diff --git a/src/SMAPI.Web/Controllers/IndexController.cs b/src/SMAPI.Web/Controllers/IndexController.cs
index 080285ab..f2f4c342 100644
--- a/src/SMAPI.Web/Controllers/IndexController.cs
+++ b/src/SMAPI.Web/Controllers/IndexController.cs
@@ -57,21 +57,16 @@ namespace StardewModdingAPI.Web.Controllers
         {
             // choose versions
             ReleaseVersion[] versions = await this.GetReleaseVersionsAsync();
-            ReleaseVersion stableVersion = versions.LastOrDefault(version => !version.IsBeta && !version.IsForDevs);
-            ReleaseVersion stableVersionForDevs = versions.LastOrDefault(version => !version.IsBeta && version.IsForDevs);
-            ReleaseVersion betaVersion = versions.LastOrDefault(version => version.IsBeta && !version.IsForDevs);
-            ReleaseVersion betaVersionForDevs = versions.LastOrDefault(version => version.IsBeta && version.IsForDevs);
+            ReleaseVersion stableVersion = versions.LastOrDefault(version => !version.IsForDevs);
+            ReleaseVersion stableVersionForDevs = versions.LastOrDefault(version => version.IsForDevs);
 
             // render view
             IndexVersionModel stableVersionModel = stableVersion != null
                 ? new IndexVersionModel(stableVersion.Version.ToString(), stableVersion.Release.Body, stableVersion.Asset.DownloadUrl, stableVersionForDevs?.Asset.DownloadUrl)
-                : new IndexVersionModel("unknown", "", "https://github.com/Pathoschild/SMAPI/releases", null); // just in case something goes wrong)
-            IndexVersionModel betaVersionModel = betaVersion != null && this.SiteConfig.BetaEnabled
-                ? new IndexVersionModel(betaVersion.Version.ToString(), betaVersion.Release.Body, betaVersion.Asset.DownloadUrl, betaVersionForDevs?.Asset.DownloadUrl)
-                : null;
+                : new IndexVersionModel("unknown", "", "https://github.com/Pathoschild/SMAPI/releases", null); // just in case something goes wrong
 
             // render view
-            var model = new IndexModel(stableVersionModel, betaVersionModel, this.SiteConfig.BetaBlurb, this.SiteConfig.SupporterList);
+            var model = new IndexModel(stableVersionModel, this.SiteConfig.OtherBlurb, this.SiteConfig.SupporterList);
             return this.View(model);
         }
 
@@ -93,27 +88,12 @@ namespace StardewModdingAPI.Web.Controllers
             {
                 entry.AbsoluteExpiration = DateTimeOffset.UtcNow.Add(this.CacheTime);
 
-                // get latest release (whether preview or stable)
-                GitRelease stableRelease = await this.GitHub.GetLatestReleaseAsync(this.RepositoryName, includePrerelease: true);
+                // get latest stable release
+                GitRelease release = await this.GitHub.GetLatestReleaseAsync(this.RepositoryName, includePrerelease: false);
 
-                // split stable/prerelease if applicable
-                GitRelease betaRelease = null;
-                if (stableRelease.IsPrerelease)
+                // strip 'noinclude' blocks from release description
+                if (release != null)
                 {
-                    GitRelease result = await this.GitHub.GetLatestReleaseAsync(this.RepositoryName, includePrerelease: false);
-                    if (result != null)
-                    {
-                        betaRelease = stableRelease;
-                        stableRelease = result;
-                    }
-                }
-
-                // strip 'noinclude' blocks from release descriptions
-                foreach (GitRelease release in new[] { stableRelease, betaRelease })
-                {
-                    if (release == null)
-                        continue;
-
                     HtmlDocument doc = new HtmlDocument();
                     doc.LoadHtml(release.Body);
                     foreach (HtmlNode node in doc.DocumentNode.SelectNodes("//*[@class='noinclude']")?.ToArray() ?? new HtmlNode[0])
@@ -122,10 +102,8 @@ namespace StardewModdingAPI.Web.Controllers
                 }
 
                 // get versions
-                ReleaseVersion[] stableVersions = this.ParseReleaseVersions(stableRelease).ToArray();
-                ReleaseVersion[] betaVersions = this.ParseReleaseVersions(betaRelease).ToArray();
-                return stableVersions
-                    .Concat(betaVersions)
+                return this
+                    .ParseReleaseVersions(release)
                     .OrderBy(p => p.Version)
                     .ToArray();
             });
@@ -146,10 +124,9 @@ namespace StardewModdingAPI.Web.Controllers
                 Match match = Regex.Match(asset.FileName, @"SMAPI-(?<version>[\d\.]+(?:-.+)?)-installer(?<forDevs>-for-developers)?.zip");
                 if (!match.Success || !SemanticVersion.TryParse(match.Groups["version"].Value, out ISemanticVersion version))
                     continue;
-                bool isBeta = version.IsPrerelease();
                 bool isForDevs = match.Groups["forDevs"].Success;
 
-                yield return new ReleaseVersion(release, asset, version, isBeta, isForDevs);
+                yield return new ReleaseVersion(release, asset, version, isForDevs);
             }
         }
 
@@ -168,9 +145,6 @@ namespace StardewModdingAPI.Web.Controllers
             /// <summary>The SMAPI version.</summary>
             public ISemanticVersion Version { get; }
 
-            /// <summary>Whether this is a beta download.</summary>
-            public bool IsBeta { get; }
-
             /// <summary>Whether this is a 'for developers' download.</summary>
             public bool IsForDevs { get; }
 
@@ -182,14 +156,12 @@ namespace StardewModdingAPI.Web.Controllers
             /// <param name="release">The underlying GitHub release.</param>
             /// <param name="asset">The underlying download asset.</param>
             /// <param name="version">The SMAPI version.</param>
-            /// <param name="isBeta">Whether this is a beta download.</param>
             /// <param name="isForDevs">Whether this is a 'for developers' download.</param>
-            public ReleaseVersion(GitRelease release, GitAsset asset, ISemanticVersion version, bool isBeta, bool isForDevs)
+            public ReleaseVersion(GitRelease release, GitAsset asset, ISemanticVersion version, bool isForDevs)
             {
                 this.Release = release;
                 this.Asset = asset;
                 this.Version = version;
-                this.IsBeta = isBeta;
                 this.IsForDevs = isForDevs;
             }
         }
diff --git a/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
index 43969f51..664dbef3 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
@@ -6,11 +6,8 @@ namespace StardewModdingAPI.Web.Framework.ConfigModels
         /*********
         ** Accessors
         *********/
-        /// <summary>Whether to show SMAPI beta versions on the main page, if any.</summary>
-        public bool BetaEnabled { get; set; }
-
-        /// <summary>A short sentence shown under the beta download button, if any.</summary>
-        public string BetaBlurb { get; set; }
+        /// <summary>A message to show below the download button (e.g. for details on downloading a beta version), in Markdown format.</summary>
+        public string OtherBlurb { get; set; }
 
         /// <summary>A list of supports to credit on the main page, in Markdown format.</summary>
         public string SupporterList { get; set; }
diff --git a/src/SMAPI.Web/ViewModels/IndexModel.cs b/src/SMAPI.Web/ViewModels/IndexModel.cs
index 450fdc0e..d8d2d27f 100644
--- a/src/SMAPI.Web/ViewModels/IndexModel.cs
+++ b/src/SMAPI.Web/ViewModels/IndexModel.cs
@@ -9,11 +9,8 @@ namespace StardewModdingAPI.Web.ViewModels
         /// <summary>The latest stable SMAPI version.</summary>
         public IndexVersionModel StableVersion { get; set; }
 
-        /// <summary>The latest prerelease SMAPI version (if newer than <see cref="StableVersion"/>).</summary>
-        public IndexVersionModel BetaVersion { get; set; }
-
-        /// <summary>A short sentence shown under the beta download button, if any.</summary>
-        public string BetaBlurb { get; set; }
+        /// <summary>A message to show below the download button (e.g. for details on downloading a beta version), in Markdown format.</summary>
+        public string OtherBlurb { get; set; }
 
         /// <summary>A list of supports to credit on the main page, in Markdown format.</summary>
         public string SupporterList { get; set; }
@@ -27,14 +24,12 @@ namespace StardewModdingAPI.Web.ViewModels
 
         /// <summary>Construct an instance.</summary>
         /// <param name="stableVersion">The latest stable SMAPI version.</param>
-        /// <param name="betaVersion">The latest prerelease SMAPI version (if newer than <paramref name="stableVersion"/>).</param>
-        /// <param name="betaBlurb">A short sentence shown under the beta download button, if any.</param>
+        /// <param name="otherBlurb">A message to show below the download button (e.g. for details on downloading a beta version), in Markdown format.</param>
         /// <param name="supporterList">A list of supports to credit on the main page, in Markdown format.</param>
-        internal IndexModel(IndexVersionModel stableVersion, IndexVersionModel betaVersion, string betaBlurb, string supporterList)
+        internal IndexModel(IndexVersionModel stableVersion, string otherBlurb, string supporterList)
         {
             this.StableVersion = stableVersion;
-            this.BetaVersion = betaVersion;
-            this.BetaBlurb = betaBlurb;
+            this.OtherBlurb = otherBlurb;
             this.SupporterList = supporterList;
         }
     }
diff --git a/src/SMAPI.Web/Views/Index/Index.cshtml b/src/SMAPI.Web/Views/Index/Index.cshtml
index 9d6e4bed..669cfd99 100644
--- a/src/SMAPI.Web/Views/Index/Index.cshtml
+++ b/src/SMAPI.Web/Views/Index/Index.cshtml
@@ -8,9 +8,9 @@
     ViewData["ViewTitle"] = string.Empty;
 }
 @section Head {
-    <link rel="stylesheet" href="~/Content/css/index.css?r=20200105" />
+    <link rel="stylesheet" href="~/Content/css/index.css" />
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
-    <script src="~/Content/js/index.js?r=20200105"></script>
+    <script src="~/Content/js/index.js"></script>
 }
 
 <h1>
@@ -29,25 +29,12 @@
             <a href="https://www.nexusmods.com/stardewvalley/mods/2400"><img src="Content/images/nexus-icon.png" /> Download from Nexus</a>
             <a href="@Model.StableVersion.DownloadUrl"><img src="Content/images/direct-download-icon.png" /> Direct download</a>
         </div>
-    </div><br />
-
-    @if (Model.BetaVersion != null)
-    {
-        <div class="cta-dropdown secondary-cta-dropdown">
-            <a href="@Model.BetaVersion.DownloadUrl" class="secondary-cta download">
-                Download SMAPI @Model.BetaVersion.Version
-                @if (!string.IsNullOrWhiteSpace(Model.BetaBlurb))
-                {
-                    <br /><small>@Model.BetaBlurb</small>
-                }
-            </a><br />
-            <div class="dropdown-content">
-                <a href="https://www.nexusmods.com/stardewvalley/mods/2400"><img src="Content/images/nexus-icon.png" /> Download from Nexus</a>
-                <a href="@Model.BetaVersion.DownloadUrl"><img src="Content/images/direct-download-icon.png" /> Direct download</a>
-            </div>
-        </div><br />
-    }
+    </div>
     <div><a href="https://stardewvalleywiki.com/Modding:Player_Guide" class="secondary-cta">Player guide</a></div>
+    @if (Model.OtherBlurb != null)
+    {
+        <div>@Html.Raw(Markdig.Markdown.ToHtml(Model.OtherBlurb))</div>
+    }
 </div>
 
 <div class="area">
@@ -61,29 +48,11 @@
 </div>
 
 <div class="area">
-    @if (Model.BetaVersion == null)
-    {
-        <h2 id="whatsnew">What's new</h2>
-        <div class="github-description">
-            @Html.Raw(Markdig.Markdown.ToHtml(Model.StableVersion.Description))
-        </div>
-        <p>See the <a href="https://github.com/Pathoschild/SMAPI/blob/develop/docs/release-notes.md#release-notes">release notes</a> and <a href="@Url.PlainAction("Index", "Mods")">mod compatibility list</a> for more info.</p>
-    }
-    else
-    {
-        <h2 id="whatsnew">What's new in...</h2>
-        <h3>SMAPI @Model.StableVersion.Version?</h3>
-        <div class="github-description">
-            @Html.Raw(Markdig.Markdown.ToHtml(Model.StableVersion.Description))
-        </div>
-        <p>See the <a href="https://github.com/Pathoschild/SMAPI/blob/develop/docs/release-notes.md#release-notes">release notes</a> and <a href="@Url.PlainAction("Index", "Mods")">mod compatibility list</a> for more info.</p>
-
-        <h3>SMAPI @Model.BetaVersion.Version?</h3>
-        <div class="github-description">
-            @Html.Raw(Markdig.Markdown.ToHtml(Model.BetaVersion.Description))
-        </div>
-        <p>See the <a href="https://github.com/Pathoschild/SMAPI/blob/develop/docs/release-notes.md#release-notes">release notes</a> and <a href="@Url.PlainAction("Index", "Mods")">mod compatibility list</a> for more info.</p>
-    }
+    <h2 id="whatsnew">What's new</h2>
+    <div class="github-description">
+        @Html.Raw(Markdig.Markdown.ToHtml(Model.StableVersion.Description))
+    </div>
+    <p>See the <a href="https://github.com/Pathoschild/SMAPI/blob/develop/docs/release-notes.md#release-notes">release notes</a> and <a href="@Url.PlainAction("Index", "Mods")">mod compatibility list</a> for more info.</p>
 </div>
 
 <div class="area">
@@ -122,10 +91,6 @@
     <h2 id="modcreators">For mod creators</h2>
     <ul>
         <li><a href="@Model.StableVersion.DevDownloadUrl">SMAPI @Model.StableVersion.Version for developers</a> (includes <a href="https://docs.microsoft.com/en-us/visualstudio/ide/using-intellisense">intellisense</a> and full console output)</li>
-        @if (Model.BetaVersion != null)
-        {
-            <li><a href="@Model.BetaVersion.DevDownloadUrl">SMAPI @Model.BetaVersion.Version for developers</a> (includes <a href="https://docs.microsoft.com/en-us/visualstudio/ide/using-intellisense">intellisense</a> and full console output)</li>
-        }
         <li><a href="https://stardewvalleywiki.com/Modding:Index">Modding documentation</a></li>
         <li><a href="https://github.com/Pathoschild/SMAPI">Source code</a></li>
     </ul>
diff --git a/src/SMAPI.Web/appsettings.json b/src/SMAPI.Web/appsettings.json
index 22fd7396..1837170b 100644
--- a/src/SMAPI.Web/appsettings.json
+++ b/src/SMAPI.Web/appsettings.json
@@ -17,8 +17,7 @@
 
     "Site": {
         "BetaEnabled": false,
-        "BetaBlurb": null,
-        "SupporterList": null
+        "OtherBlurb": null
     },
 
     "ApiClients": {
diff --git a/src/SMAPI.Web/wwwroot/Content/css/index.css b/src/SMAPI.Web/wwwroot/Content/css/index.css
index 1cf8d261..150ccc0a 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/index.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/index.css
@@ -97,6 +97,10 @@ h1 {
     display: block;
 }
 
+.cta-blurb {
+    font-size: 0.85em;
+}
+
 .sublinks {
     font-size: 0.9em;
     margin-bottom: 1em;

From 3ca6fb562417748c87567d6bb6915d56b2c1b57c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 27 Nov 2021 23:59:13 -0500
Subject: [PATCH 318/856] automatically include beta versions on Nexus for
 SMAPI update checks

---
 src/SMAPI.Web/Controllers/ModsApiController.cs    |  7 +++++++
 .../ConfigModels/ModUpdateCheckConfig.cs          |  3 +++
 .../Framework/ConfigModels/SmapiInfoConfig.cs     | 15 +++++++++++++++
 src/SMAPI.Web/appsettings.json                    |  7 ++++++-
 4 files changed, 31 insertions(+), 1 deletion(-)
 create mode 100644 src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs

diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index dcddaf10..37d763cc 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -81,6 +81,8 @@ namespace StardewModdingAPI.Web.Controllers
             if (model?.Mods == null)
                 return new ModEntryModel[0];
 
+            ModUpdateCheckConfig config = this.Config.Value;
+
             // fetch wiki data
             WikiModEntry[] wikiData = this.WikiCache.GetWikiMods().Select(p => p.Data).ToArray();
             IDictionary<string, ModEntryModel> mods = new Dictionary<string, ModEntryModel>(StringComparer.CurrentCultureIgnoreCase);
@@ -89,6 +91,11 @@ namespace StardewModdingAPI.Web.Controllers
                 if (string.IsNullOrWhiteSpace(mod.ID))
                     continue;
 
+                // special case: if this is an update check for the official SMAPI repo, check the Nexus mod page for beta versions
+                if (mod.ID == config.SmapiInfo.ID && mod.UpdateKeys?.Any(key => key == config.SmapiInfo.DefaultUpdateKey) == true && mod.InstalledVersion?.IsPrerelease() == true)
+                    mod.UpdateKeys = mod.UpdateKeys.Concat(config.SmapiInfo.AddBetaUpdateKeys).ToArray();
+
+                // fetch result
                 ModEntryModel result = await this.GetModData(mod, wikiData, model.IncludeExtendedMetadata, model.ApiVersion);
                 if (!model.IncludeExtendedMetadata && (model.ApiVersion == null || mod.InstalledVersion == null))
                 {
diff --git a/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
index bd58dba0..aea695b8 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
@@ -14,5 +14,8 @@ namespace StardewModdingAPI.Web.Framework.ConfigModels
 
         /// <summary>Update-check metadata to override.</summary>
         public ModOverrideConfig[] ModOverrides { get; set; }
+
+        /// <summary>The update-check config for SMAPI's own update checks.</summary>
+        public SmapiInfoConfig SmapiInfo { get; set; }
     }
 }
diff --git a/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs
new file mode 100644
index 00000000..d69fabb3
--- /dev/null
+++ b/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs
@@ -0,0 +1,15 @@
+namespace StardewModdingAPI.Web.Framework.ConfigModels
+{
+    /// <summary>The update-check config for SMAPI's own update checks.</summary>
+    internal class SmapiInfoConfig
+    {
+        /// <summary>The mod ID used for SMAPI update checks.</summary>
+        public string ID { get; set; }
+
+        /// <summary>The default update key used for SMAPI update checks.</summary>
+        public string DefaultUpdateKey { get; set; }
+
+        /// <summary>The update keys to add for SMAPI update checks when the player has a beta version installed.</summary>
+        public string[] AddBetaUpdateKeys { get; set; }
+    }
+}
diff --git a/src/SMAPI.Web/appsettings.json b/src/SMAPI.Web/appsettings.json
index 1837170b..0265a928 100644
--- a/src/SMAPI.Web/appsettings.json
+++ b/src/SMAPI.Web/appsettings.json
@@ -75,6 +75,11 @@
                 "ID": "MartyrPher.SMAPI-Android-Installer",
                 "AllowNonStandardVersions": true
             }
-        ]
+        ],
+        "SmapiInfo": {
+            "ID": "Pathoschild.SMAPI",
+            "DefaultUpdateKey": "GitHub:Pathoschild/SMAPI",
+            "AddBetaUpdateKeys": [ "Nexus:2400" ]
+        }
     }
 }

From c8c6b3897cd080ef3261f5642d31d8a51971981b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 2 Sep 2021 19:31:22 -0400
Subject: [PATCH 319/856] update versions for Stardew Valley 1.5.5 and remove
 1.5.4-specific checks

---
 src/SMAPI.Installer/InteractiveInstaller.cs | 20 --------------------
 src/SMAPI/Constants.cs                      |  4 ++--
 src/SMAPI/Program.cs                        | 13 -------------
 3 files changed, 2 insertions(+), 35 deletions(-)

diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 9f49137f..79c3b891 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -277,18 +277,6 @@ namespace StardewModdingApi.Installer
             /*********
             ** Step 4: validate assumptions
             *********/
-            // not 64-bit on Windows
-            if (context.Platform == Platform.Windows)
-            {
-                FileInfo linuxExecutable = new FileInfo(Path.Combine(paths.GamePath, "StardewValley.exe"));
-                if (linuxExecutable.Exists && this.Is64Bit(linuxExecutable.FullName))
-                {
-                    this.PrintError("Oops! The detected game install path seems to be unofficial 64-bit mode, which is no longer supported. You can update to Stardew Valley 1.5.5 or later instead. See https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows for more info.");
-                    Console.ReadLine();
-                    return;
-                }
-            }
-
             // executable exists
             if (!File.Exists(paths.ExecutablePath))
             {
@@ -297,14 +285,6 @@ namespace StardewModdingApi.Installer
                 return;
             }
 
-            // not Stardew Valley 1.5.5+
-            if (File.Exists(Path.Combine(paths.GamePath, "Stardew Valley.dll")))
-            {
-                this.PrintError("Oops! The detected game install path seems to be Stardew Valley 1.5.5 or later, but this version of SMAPI is only compatible up to Stardew Valley 1.5.4. Please check for a newer version of SMAPI: https://smapi.io.");
-                Console.ReadLine();
-                return;
-            }
-
             // game folder doesn't contain paths beyond the max limit
             {
                 string[] tooLongPaths = PathUtilities.GetTooLongPaths(Path.Combine(paths.GamePath, "Mods")).ToArray();
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 42c3b21b..4d6a2a0b 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -70,10 +70,10 @@ namespace StardewModdingAPI
         public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion(EarlyConstants.RawApiVersion);
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.4");
+        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.5");
 
         /// <summary>The maximum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MaximumGameVersion { get; } = new GameVersion("1.5.4");
+        public static ISemanticVersion MaximumGameVersion { get; } = null;
 
         /// <summary>The target game platform.</summary>
         public static GamePlatform TargetPlatform { get; } = EarlyConstants.Platform;
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 3f97e531..574e781d 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -4,7 +4,6 @@ using System.Linq;
 using System.Reflection;
 using System.Threading;
 using StardewModdingAPI.Framework;
-using StardewModdingAPI.Toolkit.Framework;
 using StardewModdingAPI.Toolkit.Serialization.Models;
 
 namespace StardewModdingAPI
@@ -84,22 +83,10 @@ namespace StardewModdingAPI
             }
             catch (Exception ex)
             {
-                // unofficial 64-bit
-                if (EarlyConstants.Platform == GamePlatform.Windows)
-                {
-                    FileInfo linuxExecutable = new FileInfo(Path.Combine(EarlyConstants.ExecutionPath, "StardewValley.exe"));
-                    if (linuxExecutable.Exists && LowLevelEnvironmentUtility.Is64BitAssembly(linuxExecutable.FullName))
-                        Program.PrintErrorAndExit("Oops! You're running Stardew Valley in unofficial 64-bit mode, which is no longer supported. You can update to Stardew Valley 1.5.5 or later instead. See https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows for more info.");
-                }
-
                 // file doesn't exist
                 if (!File.Exists(Path.Combine(EarlyConstants.ExecutionPath, $"{EarlyConstants.GameAssemblyName}.exe")))
                     Program.PrintErrorAndExit("Oops! SMAPI can't find the game. Make sure you're running StardewModdingAPI.exe in your game folder.");
 
-                // Stardew Valley 1.5.5+
-                if (File.Exists(Path.Combine(EarlyConstants.ExecutionPath, "Stardew Valley.dll")))
-                    Program.PrintErrorAndExit("Oops! You're running Stardew Valley 1.5.5 or later, but this version of SMAPI is only compatible up to Stardew Valley 1.5.4. Please check for a newer version of SMAPI: https://smapi.io.");
-
                 // can't load file
                 Program.PrintErrorAndExit(
                     message: "Oops! SMAPI couldn't load the game executable. The technical details below may have more info.",

From 6efaa651cb2b026b7bace55ffeba9d7c5a3d0567 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:01 -0400
Subject: [PATCH 320/856] drop support for XNA Framework

Stardew Valley 1.5.5 migrates to MonoGame on all platforms.
---
 docs/technical/smapi.md                       |  1 -
 src/SMAPI.ModBuildConfig/build/smapi.targets  | 32 ++------
 .../SMAPI.Mods.ConsoleCommands.csproj         | 18 +---
 .../Patches/SpriteBatchPatcher.cs             |  9 +-
 .../SMAPI.Mods.ErrorHandler.csproj            | 18 +---
 src/SMAPI/Constants.cs                        | 82 ++++++-------------
 src/SMAPI/Framework/Content/ContentCache.cs   |  9 +-
 .../Framework/Input/GamePadStateBuilder.cs    | 19 ++---
 src/SMAPI/Framework/InternalExtensions.cs     |  7 +-
 src/SMAPI/Framework/Logging/LogManager.cs     |  8 +-
 .../RewriteFacades/SpriteBatchFacade.cs       | 10 +--
 src/SMAPI/Framework/SCore.cs                  |  8 +-
 src/SMAPI/GameFramework.cs                    |  7 +-
 src/SMAPI/Metadata/InstructionMetadata.cs     |  8 +-
 src/SMAPI/SMAPI.csproj                        | 19 +----
 15 files changed, 60 insertions(+), 195 deletions(-)

diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index f454e99c..29fa43a8 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -57,7 +57,6 @@ SMAPI uses a small number of conditional compilation constants, which you can se
 flag | purpose
 ---- | -------
 `SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/macOS. Set automatically in `common.targets`.
-`SMAPI_FOR_XNA` | Whether SMAPI is being compiled for XNA Framework; if not set, the code assumes MonoGame. Set automatically in `common.targets` with the same value as `SMAPI_FOR_WINDOWS`.
 
 ## For SMAPI developers
 ### Compiling from source
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 698765ad..664ba7df 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -43,38 +43,24 @@
   <!--*********************************************
   ** Add assembly references
   **********************************************-->
-  <!-- common -->
   <ItemGroup>
+    <!-- game -->
     <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="$(CopyModReferencesToBuildOutput)" />
+    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(CopyModReferencesToBuildOutput)" />
+    <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="$(CopyModReferencesToBuildOutput)" />
+
+    <!-- SMAPI -->
     <Reference Include="StardewModdingAPI" HintPath="$(GamePath)\StardewModdingAPI.exe" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="SMAPI.Toolkit.CoreInterfaces" HintPath="$(GamePath)\smapi-internal\SMAPI.Toolkit.CoreInterfaces.dll" Private="$(CopyModReferencesToBuildOutput)" />
-    <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="$(CopyModReferencesToBuildOutput)" />
+
+    <!-- Harmony -->
     <Reference Include="0Harmony" Condition="'$(EnableHarmony)' == 'true'" HintPath="$(GamePath)\smapi-internal\0Harmony.dll" Private="$(CopyModReferencesToBuildOutput)" />
-  </ItemGroup>
 
-  <!-- Windows only -->
-  <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="$(CopyModReferencesToBuildOutput)" />
+    <!-- Windows only -->
+    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="$(CopyModReferencesToBuildOutput)" Condition="'$(OS)' == 'Windows_NT'" />
   </ItemGroup>
 
-  <!-- Game framework -->
-  <Choose>
-    <When Condition="'$(GameFramework)' == 'Xna'">
-      <ItemGroup>
-        <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
-        <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
-        <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
-        <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="$(CopyModReferencesToBuildOutput)" />
-      </ItemGroup>
-    </When>
-    <Otherwise>
-      <ItemGroup>
-        <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(CopyModReferencesToBuildOutput)" />
-      </ItemGroup>
-    </Otherwise>
-  </Choose>
-
 
   <!--*********************************************
   ** Show validation messages
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index 528348a0..abde4162 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -14,6 +14,7 @@
 
   <ItemGroup>
     <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
   </ItemGroup>
 
@@ -22,23 +23,6 @@
     <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
   </ItemGroup>
 
-  <!-- Game framework -->
-  <Choose>
-    <When Condition="$(DefineConstants.Contains(SMAPI_FOR_XNA))">
-      <ItemGroup>
-        <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-      </ItemGroup>
-    </When>
-    <Otherwise>
-      <ItemGroup>
-        <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
-      </ItemGroup>
-    </Otherwise>
-  </Choose>
-
   <ItemGroup>
     <None Update="manifest.json" CopyToOutputDirectory="PreserveNewest" />
   </ItemGroup>
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
index 6860a4ec..f243c6d1 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
@@ -19,9 +19,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         public override void Apply(Harmony harmony, IMonitor monitor)
         {
             harmony.Patch(
-                original: Constants.GameFramework == GameFramework.Xna
-                    ? this.RequireMethod<SpriteBatch>("InternalDraw")
-                    : this.RequireMethod<SpriteBatch>("CheckValid", new[] { typeof(Texture2D) }),
+                original: this.RequireMethod<SpriteBatch>("CheckValid", new[] { typeof(Texture2D) }),
                 postfix: this.GetHarmonyMethod(nameof(SpriteBatchPatcher.After_CheckValid))
             );
         }
@@ -30,13 +28,8 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
-#if SMAPI_FOR_XNA
-        /// <summary>The method to call after <see cref="SpriteBatch.InternalDraw"/>.</summary>
-        /// <param name="texture">The texture to validate.</param>
-#else
         /// <summary>The method to call after <see cref="SpriteBatch.CheckValid"/>.</summary>
         /// <param name="texture">The texture to validate.</param>
-#endif
         private static void After_CheckValid(Texture2D texture)
         {
             if (texture?.IsDisposed == true)
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 182a978e..27b9144f 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -15,6 +15,7 @@
 
   <ItemGroup>
     <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
@@ -24,23 +25,6 @@
     <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
   </ItemGroup>
 
-  <!-- Game framework -->
-  <Choose>
-    <When Condition="$(DefineConstants.Contains(SMAPI_FOR_XNA))">
-      <ItemGroup>
-        <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-      </ItemGroup>
-    </When>
-    <Otherwise>
-      <ItemGroup>
-        <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
-      </ItemGroup>
-    </Otherwise>
-  </Choose>
-
   <ItemGroup>
     <None Update="i18n\*.json" CopyToOutputDirectory="PreserveNewest" />
     <None Update="manifest.json" CopyToOutputDirectory="PreserveNewest" />
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 4d6a2a0b..72456ae4 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -40,12 +40,7 @@ namespace StardewModdingAPI
         internal static GamePlatform Platform { get; } = (GamePlatform)Enum.Parse(typeof(GamePlatform), LowLevelEnvironmentUtility.DetectPlatform());
 
         /// <summary>The game framework running the game.</summary>
-        internal static GameFramework GameFramework { get; } =
-#if SMAPI_FOR_XNA
-            GameFramework.Xna;
-#else
-            GameFramework.MonoGame;
-#endif
+        internal static GameFramework GameFramework { get; } = GameFramework.MonoGame;
 
         /// <summary>The game's assembly name.</summary>
         internal static string GameAssemblyName => EarlyConstants.Platform == GamePlatform.Windows ? "Stardew Valley" : "StardewValley";
@@ -260,61 +255,32 @@ namespace StardewModdingAPI
             removeAssemblyReferences.Add("StardewModdingAPI.Toolkit.CoreInterfaces");
             targetAssemblies.Add(typeof(StardewModdingAPI.IManifest).Assembly);
 
-            // get changes for platform
-            if (Constants.Platform != Platform.Windows)
+            // XNA Framework before Stardew Valley 1.5.5
+            removeAssemblyReferences.AddRange(new[]
             {
-                removeAssemblyReferences.AddRange(new[]
-                {
-                    "Netcode",
-                    "Stardew Valley"
-                });
-                targetAssemblies.Add(
-                    typeof(StardewValley.Game1).Assembly // note: includes Netcode types on Linux/macOS
-                );
-            }
-            else
-            {
-                removeAssemblyReferences.Add(
-                    "StardewValley"
-                );
-                targetAssemblies.AddRange(new[]
-                {
-                    typeof(Netcode.NetBool).Assembly,
-                    typeof(StardewValley.Game1).Assembly
-                });
-            }
+                "Microsoft.Xna.Framework",
+                "Microsoft.Xna.Framework.Game",
+                "Microsoft.Xna.Framework.Graphics",
+                "Microsoft.Xna.Framework.Xact"
+            });
+            targetAssemblies.Add(
+                typeof(Microsoft.Xna.Framework.Vector2).Assembly
+            );
 
-            // get changes for game framework
-            switch (framework)
-            {
-                case GameFramework.MonoGame:
-                    removeAssemblyReferences.AddRange(new[]
-                    {
-                        "Microsoft.Xna.Framework",
-                        "Microsoft.Xna.Framework.Game",
-                        "Microsoft.Xna.Framework.Graphics",
-                        "Microsoft.Xna.Framework.Xact"
-                    });
-                    targetAssemblies.Add(
-                        typeof(Microsoft.Xna.Framework.Vector2).Assembly
-                    );
-                    break;
+            // `Netcode.dll` merged into the game assembly in Stardew Valley 1.5.5
+            removeAssemblyReferences.Add(
+                "Netcode"
+            );
 
-                case GameFramework.Xna:
-                    removeAssemblyReferences.Add(
-                        "MonoGame.Framework"
-                    );
-                    targetAssemblies.AddRange(new[]
-                    {
-                        typeof(Microsoft.Xna.Framework.Vector2).Assembly,
-                        typeof(Microsoft.Xna.Framework.Game).Assembly,
-                        typeof(Microsoft.Xna.Framework.Graphics.SpriteBatch).Assembly
-                    });
-                    break;
-
-                default:
-                    throw new InvalidOperationException($"Unknown game framework '{framework}'.");
-            }
+            // Stardew Valley reference
+            removeAssemblyReferences.Add(
+                Constants.Platform == Platform.Windows
+                    ? "StardewValley"
+                    : "Stardew Valley"
+            );
+            targetAssemblies.Add(
+                typeof(StardewValley.Game1).Assembly
+            );
 
             return new PlatformAssemblyMap(targetPlatform, removeAssemblyReferences.ToArray(), targetAssemblies.ToArray());
         }
diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index 7edc9ab9..87d15e32 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -2,7 +2,6 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics.Contracts;
 using System.Linq;
-using Microsoft.Xna.Framework;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
@@ -52,13 +51,7 @@ namespace StardewModdingAPI.Framework.Content
             this.Cache = reflection.GetField<Dictionary<string, object>>(contentManager, "loadedAssets").GetValue();
 
             // get key normalization logic
-            if (Constants.GameFramework == GameFramework.Xna)
-            {
-                IReflectedMethod method = reflection.GetMethod(typeof(TitleContainer), "GetCleanPath");
-                this.NormalizeAssetNameForPlatform = path => method.Invoke<string>(path);
-            }
-            else
-                this.NormalizeAssetNameForPlatform = key => key.Replace('\\', '/'); // based on MonoGame's ContentManager.Load<T> logic
+            this.NormalizeAssetNameForPlatform = PathUtilities.NormalizePath; //this.NormalizeAssetNameForPlatform = key => key.Replace('\\', '/'); // based on MonoGame's ContentManager.Load<T> logic
         }
 
         /****
diff --git a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
index f5f2d916..b0bb7f80 100644
--- a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using System.Linq;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Input;
 
@@ -157,11 +158,8 @@ namespace StardewModdingAPI.Framework.Input
                 yield break;
 
             // buttons
-            foreach (var pair in this.ButtonStates)
-            {
-                if (pair.Value == ButtonState.Pressed && pair.Key.TryGetController(out Buttons button))
-                    yield return button.ToSButton();
-            }
+            foreach (Buttons button in this.GetPressedGamePadButtons())
+                yield return button.ToSButton();
 
             // triggers
             if (this.LeftTrigger > 0.2f)
@@ -201,7 +199,7 @@ namespace StardewModdingAPI.Framework.Input
                 rightThumbStick: this.RightStickPos,
                 leftTrigger: this.LeftTrigger,
                 rightTrigger: this.RightTrigger,
-                buttons: this.GetButtonBitmask() // MonoGame requires one bitmask here; don't specify multiple values
+                buttons: this.GetPressedGamePadButtons().ToArray()
             );
 
             return this.State.Value;
@@ -211,17 +209,14 @@ namespace StardewModdingAPI.Framework.Input
         /*********
         ** Private methods
         *********/
-        /// <summary>Get a bitmask representing the pressed buttons.</summary>
-        private Buttons GetButtonBitmask()
+        /// <summary>Get the pressed gamepad buttons.</summary>
+        private IEnumerable<Buttons> GetPressedGamePadButtons()
         {
-            Buttons flag = 0;
             foreach (var pair in this.ButtonStates)
             {
                 if (pair.Value == ButtonState.Pressed && pair.Key.TryGetController(out Buttons button))
-                    flag |= button;
+                    yield return button;
             }
-
-            return flag;
         }
     }
 }
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index 6c9a5f3b..4cb77a45 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -6,7 +6,6 @@ using System.Threading;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Events;
 using StardewModdingAPI.Framework.Reflection;
-using StardewValley;
 using StardewValley.Menus;
 
 namespace StardewModdingAPI.Framework
@@ -150,11 +149,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="reflection">The reflection helper with which to access private fields.</param>
         public static bool IsOpen(this SpriteBatch spriteBatch, Reflector reflection)
         {
-            string fieldName = Constants.GameFramework == GameFramework.Xna
-                ? "inBeginEndPair"
-                : "_beginCalled";
-
-            return reflection.GetField<bool>(Game1.spriteBatch, fieldName).GetValue();
+            return reflection.GetField<bool>(spriteBatch, "_beginCalled").GetValue();
         }
     }
 }
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index f2876146..2e25a94a 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -253,10 +253,10 @@ namespace StardewModdingAPI.Framework.Logging
             switch (exception)
             {
                 // audio crash
-                case 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()}");
-                    break;
+                //case 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()}");
+                //    break;
 
                 // missing content folder exception
                 case FileNotFoundException ex when ex.Message == "Couldn't find file 'C:\\Program Files (x86)\\Steam\\SteamApps\\common\\Stardew Valley\\Content\\XACT\\FarmerSounds.xgs'.": // path in error is hardcoded regardless of install path
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
index aefd1c20..a064f503 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
@@ -4,7 +4,7 @@ using Microsoft.Xna.Framework.Graphics;
 
 namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
 {
-    /// <summary>Provides <see cref="SpriteBatch"/> method signatures that can be injected into mod code for compatibility between Linux/macOS or Windows.</summary>
+    /// <summary>Provides <see cref="SpriteBatch"/> method signatures that can be injected into mod code for compatibility with mods written for XNA Framework before Stardew Valley 1.5.5.</summary>
     /// <remarks>This is public to support SMAPI rewriting and should not be referenced directly by mods.</remarks>
     [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Used via assembly rewriting")]
     [SuppressMessage("ReSharper", "CS0109", Justification = "The 'new' modifier applies when compiled on Linux/macOS.")]
@@ -18,14 +18,6 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
         public SpriteBatchFacade(GraphicsDevice graphicsDevice) : base(graphicsDevice) { }
 
 
-        /****
-        ** MonoGame signatures
-        ****/
-        public new void Begin(SpriteSortMode sortMode, BlendState blendState, SamplerState samplerState, DepthStencilState depthStencilState, RasterizerState rasterizerState, Effect effect, Matrix? matrix)
-        {
-            base.Begin(sortMode, blendState, samplerState, depthStencilState, rasterizerState, effect, matrix ?? Matrix.Identity);
-        }
-
         /****
         ** XNA signatures
         ****/
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 6dffb1de..b049e868 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -16,9 +16,7 @@ using Microsoft.Xna.Framework;
 #if SMAPI_FOR_WINDOWS
 using Microsoft.Win32;
 #endif
-#if SMAPI_FOR_XNA
-using System.Windows.Forms;
-#endif
+using Microsoft.Xna.Framework;
 using Newtonsoft.Json;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Events;
@@ -224,10 +222,6 @@ namespace StardewModdingAPI.Framework
                     this.Toolkit.JsonHelper.JsonSettings.Converters.Add(converter);
 
                 // add error handlers
-#if SMAPI_FOR_XNA
-                Application.ThreadException += (sender, e) => this.Monitor.Log($"Critical thread exception: {e.Exception.GetLogSummary()}", LogLevel.Error);
-                Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);
-#endif
                 AppDomain.CurrentDomain.UnhandledException += (sender, e) => this.Monitor.Log($"Critical app domain exception: {e.ExceptionObject}", LogLevel.Error);
 
                 // add more lenient assembly resolver
diff --git a/src/SMAPI/GameFramework.cs b/src/SMAPI/GameFramework.cs
index 7670ce8f..a0154329 100644
--- a/src/SMAPI/GameFramework.cs
+++ b/src/SMAPI/GameFramework.cs
@@ -1,12 +1,15 @@
+using System;
+
 namespace StardewModdingAPI
 {
     /// <summary>The game framework running the game.</summary>
     public enum GameFramework
     {
-        /// <summary>The XNA Framework on Windows.</summary>
+        /// <summary>The XNA Framework, previously used on Windows.</summary>
+        [Obsolete("Stardew Valley no longer uses XNA Framework on any supported platform.")]
         Xna,
 
-        /// <summary>The MonoGame framework, usually on non-Windows platforms.</summary>
+        /// <summary>The MonoGame framework.</summary>
         MonoGame
     }
 }
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 76371e50..368306a1 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -36,9 +36,6 @@ namespace StardewModdingAPI.Metadata
             // rewrite for crossplatform compatibility
             if (rewriteMods)
             {
-                if (platformChanged)
-                    yield return new MethodParentRewriter(typeof(SpriteBatch), typeof(SpriteBatchFacade));
-
                 // rewrite for Stardew Valley 1.5
                 yield return new FieldReplaceRewriter(typeof(DecoratableLocation), "furniture", typeof(GameLocation), nameof(GameLocation.furniture));
                 yield return new FieldReplaceRewriter(typeof(Farm), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
@@ -48,8 +45,9 @@ namespace StardewModdingAPI.Metadata
                 yield return new HeuristicFieldRewriter(this.ValidateReferencesToAssemblies);
                 yield return new HeuristicMethodRewriter(this.ValidateReferencesToAssemblies);
 
-                // rewrite for 64-bit mode
-                // re-enable in Stardew Valley 1.5.5
+                // rewrite for Stardew Valley 1.5.5
+                if (platformChanged)
+                    yield return new MethodParentRewriter(typeof(SpriteBatch), typeof(SpriteBatchFacade));
                 //yield return new ArchitectureAssemblyRewriter();
 
                 // detect Harmony & rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index c147e7dc..7fb40722 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -30,32 +30,15 @@
     <Reference Include="System.Runtime.Caching" Private="True" />
     <Reference Include="GalaxyCSharp" HintPath="$(GamePath)\GalaxyCSharp.dll" Private="False" />
     <Reference Include="Lidgren.Network" HintPath="$(GamePath)\Lidgren.Network.dll" Private="False" />
+    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
 
   <!-- Windows only -->
   <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
     <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
-    <Reference Include="System.Windows.Forms" />
   </ItemGroup>
 
-  <!-- Game framework -->
-  <Choose>
-    <When Condition="$(DefineConstants.Contains(SMAPI_FOR_XNA))">
-      <ItemGroup>
-        <Reference Include="Microsoft.Xna.Framework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Game, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Graphics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-        <Reference Include="Microsoft.Xna.Framework.Xact, Version=4.0.0.0, Culture=neutral, PublicKeyToken=842cf8be1de50553, processorArchitecture=x86" Private="False" />
-      </ItemGroup>
-    </When>
-    <Otherwise>
-      <ItemGroup>
-        <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
-      </ItemGroup>
-    </Otherwise>
-  </Choose>
-
   <ItemGroup>
     <ProjectReference Include="..\SMAPI.Toolkit.CoreInterfaces\SMAPI.Toolkit.CoreInterfaces.csproj" />
     <ProjectReference Include="..\SMAPI.Toolkit\SMAPI.Toolkit.csproj" />

From 2b922a71a2a4f85712ab1e84b85c9229185a131a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:09 -0400
Subject: [PATCH 321/856] update for Netcode now merged into game assembly on
 all platforms

---
 src/SMAPI.ModBuildConfig/build/smapi.targets              | 3 ---
 .../SMAPI.Mods.ConsoleCommands.csproj                     | 5 -----
 .../SMAPI.Mods.ErrorHandler.csproj                        | 5 -----
 src/SMAPI/Constants.cs                                    | 8 ++------
 src/SMAPI/SMAPI.csproj                                    | 5 -----
 5 files changed, 2 insertions(+), 24 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 664ba7df..be10481b 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -56,9 +56,6 @@
 
     <!-- Harmony -->
     <Reference Include="0Harmony" Condition="'$(EnableHarmony)' == 'true'" HintPath="$(GamePath)\smapi-internal\0Harmony.dll" Private="$(CopyModReferencesToBuildOutput)" />
-
-    <!-- Windows only -->
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="$(CopyModReferencesToBuildOutput)" Condition="'$(OS)' == 'Windows_NT'" />
   </ItemGroup>
 
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index abde4162..fa192073 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -18,11 +18,6 @@
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
   </ItemGroup>
 
-  <!-- Windows only -->
-  <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
-  </ItemGroup>
-
   <ItemGroup>
     <None Update="manifest.json" CopyToOutputDirectory="PreserveNewest" />
   </ItemGroup>
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 27b9144f..7ba6025b 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -20,11 +20,6 @@
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
 
-  <!-- Windows only -->
-  <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
-  </ItemGroup>
-
   <ItemGroup>
     <None Update="i18n\*.json" CopyToOutputDirectory="PreserveNewest" />
     <None Update="manifest.json" CopyToOutputDirectory="PreserveNewest" />
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 72456ae4..776b3e3c 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -235,12 +235,8 @@ namespace StardewModdingAPI
             // The game assembly can have one of three names depending how the mod was compiled:
             //   - 'StardewValley': assembly name on Linux/macOS;
             //   - 'Stardew Valley': assembly name on Windows;
-            //   - 'Netcode': an assembly that's separate on Windows only.
-            resolver.AddWithExplicitNames(AssemblyDefinition.ReadAssembly(typeof(Game1).Assembly.Location), "StardewValley", "Stardew Valley"
-#if !SMAPI_FOR_WINDOWS
-                , "Netcode"
-#endif
-            );
+            //   - 'Netcode': an assembly that was separate on Windows only before Stardew Valley 1.5.5.
+            resolver.AddWithExplicitNames(AssemblyDefinition.ReadAssembly(typeof(Game1).Assembly.Location), "StardewValley", "Stardew Valley", "Netcode");
         }
 
         /// <summary>Get metadata for mapping assemblies to the current platform.</summary>
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 7fb40722..e5cc8da6 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -34,11 +34,6 @@
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
 
-  <!-- Windows only -->
-  <ItemGroup Condition="'$(OS)' == 'Windows_NT'">
-    <Reference Include="Netcode" HintPath="$(GamePath)\Netcode.dll" Private="False" />
-  </ItemGroup>
-
   <ItemGroup>
     <ProjectReference Include="..\SMAPI.Toolkit.CoreInterfaces\SMAPI.Toolkit.CoreInterfaces.csproj" />
     <ProjectReference Include="..\SMAPI.Toolkit\SMAPI.Toolkit.csproj" />

From 40b74398ace748a565199fb91325815804011a98 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:09 -0400
Subject: [PATCH 322/856] update for game assembly name now consistent on all
 platforms

---
 build/find-game-folder.targets |  5 -----
 src/SMAPI/Constants.cs         | 12 +++---------
 src/SMAPI/Program.cs           |  2 +-
 3 files changed, 4 insertions(+), 15 deletions(-)

diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index 7a9bfc50..3341226d 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -44,11 +44,6 @@
 
   <!-- set game metadata -->
   <PropertyGroup>
-    <!--standard executable name-->
     <GameExecutableName>Stardew Valley</GameExecutableName>
-    <GameExecutableName Condition="$(OS) != 'Windows_NT'">StardewValley</GameExecutableName>
-
-    <!--Linux install on Windows (for 64-bit hack)-->
-    <GameExecutableName Condition="$(OS) == 'Windows_NT' AND !Exists('$(GamePath)\$(GameExecutableName).exe') AND Exists('$(GamePath)\StardewValley.exe')">StardewValley</GameExecutableName>
   </PropertyGroup>
 </Project>
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 776b3e3c..2c16052b 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -43,7 +43,7 @@ namespace StardewModdingAPI
         internal static GameFramework GameFramework { get; } = GameFramework.MonoGame;
 
         /// <summary>The game's assembly name.</summary>
-        internal static string GameAssemblyName => EarlyConstants.Platform == GamePlatform.Windows ? "Stardew Valley" : "StardewValley";
+        internal static string GameAssemblyName { get; } = "Stardew Valley";
 
         /// <summary>The <see cref="Context.ScreenId"/> value which should appear in the SMAPI log, if any.</summary>
         internal static int? LogScreenId { get; set; }
@@ -269,14 +269,8 @@ namespace StardewModdingAPI
             );
 
             // Stardew Valley reference
-            removeAssemblyReferences.Add(
-                Constants.Platform == Platform.Windows
-                    ? "StardewValley"
-                    : "Stardew Valley"
-            );
-            targetAssemblies.Add(
-                typeof(StardewValley.Game1).Assembly
-            );
+            removeAssemblyReferences.Add("StardewValley");
+            targetAssemblies.Add(typeof(StardewValley.Game1).Assembly);
 
             return new PlatformAssemblyMap(targetPlatform, removeAssemblyReferences.ToArray(), targetAssemblies.ToArray());
         }
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 574e781d..3e2213ba 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -35,7 +35,7 @@ namespace StardewModdingAPI
                 Program.AssertSmapiVersions();
                 Program.Start(args);
             }
-            catch (BadImageFormatException ex) when (ex.FileName == "StardewValley" || ex.FileName == "Stardew Valley") // don't use EarlyConstants.GameAssemblyName, since we want to check both possible names
+            catch (BadImageFormatException ex) when (ex.FileName == EarlyConstants.GameAssemblyName)
             {
                 Console.WriteLine($"SMAPI failed to initialize because your game's {ex.FileName}.exe seems to be invalid.\nThis may be a pirated version which modified the executable in an incompatible way; if so, you can try a different download or buy a legitimate version.\n\nTechnical details:\n{ex}");
             }

From 727d75ae728ba6cc8fc070524264c454aac8404f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:10 -0400
Subject: [PATCH 323/856] update to .NET 5 and official 64-bit

---
 build/common.targets                          |  25 +++--
 build/prepare-install-package.targets         |  66 +++++-------
 docs/release-notes.md                         |  14 +++
 docs/technical/mod-package.md                 |   1 +
 docs/technical/web.md                         |   2 +-
 .../Framework/InstallerContext.cs             |  45 --------
 .../Framework/InstallerPaths.cs               |  44 ++++----
 src/SMAPI.Installer/InteractiveInstaller.cs   |  81 +++++----------
 src/SMAPI.Installer/SMAPI.Installer.csproj    |   2 +-
 .../assets/System.Numerics.dll                | Bin 54272 -> 0 bytes
 .../assets/System.Runtime.Caching.dll         | Bin 71168 -> 0 bytes
 src/SMAPI.Installer/assets/unix-install.sh    |  18 +---
 src/SMAPI.Installer/assets/unix-launcher.sh   |  96 ++++--------------
 ...SMAPI.ModBuildConfig.Analyzer.Tests.csproj |  13 +--
 .../SMAPI.ModBuildConfig.Analyzer.csproj      |   3 +-
 .../SMAPI.ModBuildConfig.csproj               |  16 +--
 src/SMAPI.ModBuildConfig/build/smapi.targets  |   8 +-
 .../SMAPI.Mods.ConsoleCommands.csproj         |   4 +-
 .../SMAPI.Mods.ErrorHandler.csproj            |   4 +-
 .../SMAPI.Mods.SaveBackup.csproj              |   4 +-
 src/SMAPI.Tests/SMAPI.Tests.csproj            |   5 +-
 .../SMAPI.Toolkit.CoreInterfaces.csproj       |   2 +-
 src/SMAPI.Toolkit/Framework/Constants.cs      |   9 ++
 .../Framework/GameScanning/GameScanner.cs     |   5 +-
 .../Framework/LowLevelEnvironmentUtility.cs   |   9 --
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj        |   6 +-
 .../Utilities/EnvironmentUtility.cs           |   7 --
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs  |  15 ++-
 src/SMAPI/Framework/Logging/LogManager.cs     |   2 +-
 .../Reflection/InterfaceProxyFactory.cs       |   2 +-
 src/SMAPI/Framework/SCore.cs                  |   9 +-
 src/SMAPI/Metadata/InstructionMetadata.cs     |   2 +-
 src/SMAPI/SMAPI.csproj                        |  14 ++-
 33 files changed, 192 insertions(+), 341 deletions(-)
 delete mode 100644 src/SMAPI.Installer/assets/System.Numerics.dll
 delete mode 100644 src/SMAPI.Installer/assets/System.Runtime.Caching.dll
 create mode 100644 src/SMAPI.Toolkit/Framework/Constants.cs

diff --git a/build/common.targets b/build/common.targets
index 02142351..a74002a6 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
 
     <!--set platform-->
-    <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS;SMAPI_FOR_XNA</DefineConstants>
+    <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
   </PropertyGroup>
 
   <!--find game folder-->
@@ -27,20 +27,31 @@
       <TranslationFiles Include="$(TargetDir)\i18n\*.json" />
     </ItemGroup>
 
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFolder="$(GamePath)" />
+    <!-- SMAPI -->
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFolder="$(GamePath)" Condition="$(OS) == 'Windows_NT'" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName)" DestinationFolder="$(GamePath)" Condition="$(OS) != 'Windows_NT'" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)" />
     <Copy SourceFiles="$(TargetDir)\SMAPI.config.json" DestinationFiles="$(GamePath)\smapi-internal\config.json" />
     <Copy SourceFiles="$(TargetDir)\SMAPI.metadata.json" DestinationFiles="$(GamePath)\smapi-internal\metadata.json" />
+    <Copy SourceFiles="$(TargetDir)\Newtonsoft.Json.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\TMXTile.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\smapi-internal\i18n" />
+
+    <!-- Harmony + dependencies -->
     <Copy SourceFiles="$(TargetDir)\0Harmony.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\0Harmony.xml" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\Mono.Cecil.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Mdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Pdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\MonoMod.Common.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\Newtonsoft.Json.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\TMXTile.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\smapi-internal\i18n" />
+
+    <!-- .NET dependencies -->
+    <Copy SourceFiles="$(TargetDir)\System.Configuration.ConfigurationManager.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\System.Management.dll" DestinationFolder="$(GamePath)\smapi-internal" Condition="$(OS) == 'Windows_NT'" />
+    <Copy SourceFiles="$(TargetDir)\System.Runtime.Caching.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\System.Security.Permissions.dll" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
 
   <Target Name="CopyDefaultMods" Condition="'$(MSBuildProjectName)' == 'SMAPI.Mods.ConsoleCommands' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.ErrorHandler' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.SaveBackup'">
@@ -54,13 +65,13 @@
     <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)\i18n" />
   </Target>
 
-  <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit' AND $(TargetFramework) == 'net452'" AfterTargets="PostBuildEvent">
+  <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit'" AfterTargets="PostBuildEvent">
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
 
-  <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces' AND $(TargetFramework) == 'net452'" AfterTargets="PostBuildEvent">
+  <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces'" AfterTargets="PostBuildEvent">
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index 601f6496..bc1716a3 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -14,7 +14,7 @@
       <OutRootPath>$(SolutionDir)\..\bin</OutRootPath>
 
       <SmapiBin>$(BuildRootPath)\SMAPI\bin\$(Configuration)</SmapiBin>
-      <ToolkitBin>$(BuildRootPath)\SMAPI.Toolkit\bin\$(Configuration)\net452</ToolkitBin>
+      <ToolkitBin>$(BuildRootPath)\SMAPI.Toolkit\bin\$(Configuration)\net5.0</ToolkitBin>
       <ConsoleCommandsBin>$(BuildRootPath)\SMAPI.Mods.ConsoleCommands\bin\$(Configuration)</ConsoleCommandsBin>
       <ErrorHandlerBin>$(BuildRootPath)\SMAPI.Mods.ErrorHandler\bin\$(Configuration)</ErrorHandlerBin>
       <SaveBackupBin>$(BuildRootPath)\SMAPI.Mods.SaveBackup\bin\$(Configuration)</SaveBackupBin>
@@ -35,12 +35,17 @@
     <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on Linux.sh" />
     <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on macOS.command" />
     <Copy SourceFiles="$(TargetDir)\assets\windows-install.bat" DestinationFiles="$(PackagePath)\install on Windows.bat" />
-    <Copy SourceFiles="$(TargetDir)\assets\README.txt" DestinationFiles="$(PackagePath)\README.txt" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install.exe" />
-    <Copy Condition="$(PlatformName) == 'windows'" SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install.exe.config" />
+    <Copy SourceFiles="$(TargetDir)\assets\README.txt" DestinationFolder="$(PackagePath)" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(PackagePath)\internal" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install.exe" Condition="$(PlatformName) == 'windows'" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName)" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install" Condition="$(PlatformName) != 'windows'" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).runtimeconfig.json" DestinationFolder="$(PackagePath)\internal" />
+    <Copy SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install.exe.config" Condition="$(PlatformName) == 'windows'" />
 
     <!--copy bundle files-->
-    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.exe" DestinationFolder="$(PackagePath)\bundle" />
+    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.dll" DestinationFolder="$(PackagePath)\bundle" />
+    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.exe" DestinationFolder="$(PackagePath)\bundle" Condition="$(PlatformName) == 'windows'" />
+    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI" DestinationFolder="$(PackagePath)\bundle" Condition="$(PlatformName) != 'windows'" />
     <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.pdb" DestinationFolder="$(PackagePath)\bundle" />
     <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.xml" DestinationFolder="$(PackagePath)\bundle" />
     <Copy SourceFiles="$(SmapiBin)\steam_appid.txt" DestinationFolder="$(PackagePath)\bundle" />
@@ -61,11 +66,16 @@
     <Copy SourceFiles="$(ToolkitBin)\SMAPI.Toolkit.CoreInterfaces.pdb" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="$(ToolkitBin)\SMAPI.Toolkit.CoreInterfaces.xml" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(PackagePath)\bundle\smapi-internal\i18n" />
-    <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(TargetDir)\assets\unix-launcher.sh" DestinationFiles="$(PackagePath)\bundle\StardewModdingAPI" />
-    <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(SmapiBin)\System.Numerics.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
+    <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(TargetDir)\assets\unix-launcher.sh" DestinationFolder="$(PackagePath)\bundle" />
     <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(SmapiBin)\System.Runtime.Caching.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
     <Copy Condition="$(PlatformName) == 'windows'" SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\bundle\StardewModdingAPI.exe.config" />
 
+    <!-- copy .NET dependencies -->
+    <Copy SourceFiles="$(SmapiBin)\System.Configuration.ConfigurationManager.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
+    <Copy SourceFiles="$(SmapiBin)\System.Management.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" Condition="$(PlatformName) == 'windows'" />
+    <Copy SourceFiles="$(SmapiBin)\System.Runtime.Caching.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
+    <Copy SourceFiles="$(SmapiBin)\System.Security.Permissions.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
+
     <!--copy bundled mods-->
     <Copy SourceFiles="$(ConsoleCommandsBin)\ConsoleCommands.dll" DestinationFolder="$(PackagePath)\bundle\Mods\ConsoleCommands" />
     <Copy SourceFiles="$(ConsoleCommandsBin)\ConsoleCommands.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\ConsoleCommands" />
@@ -78,63 +88,33 @@
     <Copy SourceFiles="$(SaveBackupBin)\SaveBackup.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
     <Copy SourceFiles="$(SaveBackupBin)\manifest.json" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
 
-    <!-- fix errors on Linux/macOS (sample: https://smapi.io/log/mMdFUpgB) -->
-    <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(TargetDir)\assets\System.Numerics.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(TargetDir)\assets\System.Runtime.Caching.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-
     <!-- fix Linux/macOS permissions -->
-    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)\install on Linux.sh&quot;" />
-    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)\install on macOS.command&quot;" />
+    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)/install on Linux.sh&quot;" />
+    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)/install on macOS.command&quot;" />
+    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)/bundle/unix-launcher.sh&quot;" />
 
     <!-- finalise 'for developers' installer -->
     <ItemGroup>
       <PackageFiles Include="$(PackagePath)\**\*.*" />
     </ItemGroup>
     <Copy SourceFiles="@(PackageFiles)" DestinationFolder="$(PackageDevPath)\%(RecursiveDir)" />
-    <ZipDirectory FromDirPath="$(PackageDevPath)\bundle" ToFilePath="$(PackageDevPath)\internal\$(PlatformName)-install.dat" />
+    <ZipDirectory SourceDirectory="$(PackageDevPath)\bundle" DestinationFile="$(PackageDevPath)\internal\$(PlatformName)-install.dat" />
     <RemoveDir Directories="$(PackageDevPath)\bundle" />
 
     <!-- finalise normal installer -->
     <ReplaceFileText FilePath="$(PackagePath)\bundle\smapi-internal\config.json" Search="&quot;DeveloperMode&quot;: true" Replace="&quot;DeveloperMode&quot;: false" />
-    <ZipDirectory FromDirPath="$(PackagePath)\bundle" ToFilePath="$(PackagePath)\internal\$(PlatformName)-install.dat" />
+    <ZipDirectory SourceDirectory="$(PackagePath)\bundle" DestinationFile="$(PackagePath)\internal\$(PlatformName)-install.dat" />
     <RemoveDir Directories="$(PackagePath)\bundle" />
   </Target>
 
-  <!-- Create a zip file with the contents of a given folder path. Derived from https://stackoverflow.com/a/38127938/262123. -->
-  <UsingTask TaskName="ZipDirectory" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.v12.0.dll">
-    <ParameterGroup>
-      <FromDirPath ParameterType="System.String" Required="true" />
-      <ToFilePath ParameterType="System.String" Required="true" />
-    </ParameterGroup>
-    <Task>
-      <Reference Include="System.IO.Compression.FileSystem" />
-      <Using Namespace="System.IO.Compression" />
-      <Code Type="Fragment" Language="cs">
-        <![CDATA[
-        try
-        {
-          ZipFile.CreateFromDirectory(FromDirPath, ToFilePath);
-          return true;
-        }
-        catch(Exception ex)
-        {
-          Log.LogErrorFromException(ex);
-          return false;
-        }
-        ]]>
-      </Code>
-    </Task>
-  </UsingTask>
-
   <!-- Replace text in a file based on a regex pattern. Derived from https://stackoverflow.com/a/22571621/262123. -->
-  <UsingTask TaskName="ReplaceFileText" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.v4.0.dll">
+  <UsingTask TaskName="ReplaceFileText" TaskFactory="RoslynCodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
     <ParameterGroup>
       <FilePath ParameterType="System.String" Required="true" />
       <Search ParameterType="System.String" Required="true" />
       <Replace ParameterType="System.String" Required="true" />
     </ParameterGroup>
     <Task>
-      <Reference Include="System.Core" />
       <Using Namespace="System" />
       <Using Namespace="System.IO" />
       <Using Namespace="System.Text.RegularExpressions" />
diff --git a/docs/release-notes.md b/docs/release-notes.md
index efda7267..43370409 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,8 +3,22 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Updated for Stardew Valley 1.5.5.
   * Added `set_farm_type` [console command](https://stardewvalleywiki.com/Modding:Console_commands#Console_commands) to change the current farm type.
 
+* For mod authors:
+  * Migrated to 64-bit MonoGame and .NET 5 on all platforms (see [migration guide for mod authors](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5)).
+
+**Update note for players with older systems:**  
+The game now has two branches: the _main branch_ which you'll get by default, and an optional
+_compatibility branch_ for [older systems](https://www.stardewvalley.net/compatibility/). The two
+branches have identical content, but use [different technologies](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5#Stardew_Valley_compatibility_branch).
+
+Unfortunately **SMAPI only supports the main branch of the game**. There are formidable difficulties
+across all mods in supporting all three variations, the [Steam hardware stats](https://store.steampowered.com/hwsurvey)
+show that 99.69% of players have 64-bit, and 32-bit imposes significant restrictions on what mods
+can do.
+
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.24.0.
 
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 7eefc7a4..a3ce8761 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -366,6 +366,7 @@ when you compile it.
 
 ## Release notes
 ## Upcoming release
+* Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. **The older versions are no longer supported.**
 * Improved analyzer performance by enabling parallel execution.
 
 ## 3.3.0
diff --git a/docs/technical/web.md b/docs/technical/web.md
index 50237bfe..f0d43fb1 100644
--- a/docs/technical/web.md
+++ b/docs/technical/web.md
@@ -367,7 +367,7 @@ accordingly.
 Initial setup:
 
 1. Create an Azure Blob storage account for uploaded files.
-2. Create an Azure App Services environment running the latest .NET Core on Linux or Windows.
+2. Create an Azure App Services environment running the latest .NET on Linux or Windows.
 3. Add these application settings in the new App Services environment:
 
    property name                   | description
diff --git a/src/SMAPI.Installer/Framework/InstallerContext.cs b/src/SMAPI.Installer/Framework/InstallerContext.cs
index 88e57760..95df32ca 100644
--- a/src/SMAPI.Installer/Framework/InstallerContext.cs
+++ b/src/SMAPI.Installer/Framework/InstallerContext.cs
@@ -1,6 +1,4 @@
-using System;
 using System.IO;
-using Microsoft.Win32;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.GameScanning;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -13,9 +11,6 @@ namespace StardewModdingAPI.Installer.Framework
         /*********
         ** Fields
         *********/
-        /// <summary>The <see cref="Environment.OSVersion"/> value that represents Windows 7.</summary>
-        private readonly Version Windows7Version = new Version(6, 1);
-
         /// <summary>The underlying toolkit game scanner.</summary>
         private readonly GameScanner GameScanner = new GameScanner();
 
@@ -29,9 +24,6 @@ namespace StardewModdingAPI.Installer.Framework
         /// <summary>The human-readable OS name and version.</summary>
         public string PlatformName { get; }
 
-        /// <summary>The name of the Stardew Valley executable.</summary>
-        public string ExecutableName { get; }
-
         /// <summary>Whether the installer is running on Windows.</summary>
         public bool IsWindows => this.Platform == Platform.Windows;
 
@@ -47,7 +39,6 @@ namespace StardewModdingAPI.Installer.Framework
         {
             this.Platform = EnvironmentUtility.DetectPlatform();
             this.PlatformName = EnvironmentUtility.GetFriendlyPlatformName(this.Platform);
-            this.ExecutableName = EnvironmentUtility.GetExecutableName(this.Platform);
         }
 
         /// <summary>Get the installer's version number.</summary>
@@ -57,42 +48,6 @@ namespace StardewModdingAPI.Installer.Framework
             return new SemanticVersion(raw);
         }
 
-        /// <summary>Get whether the current system has .NET Framework 4.5 or later installed. This only applies on Windows.</summary>
-        /// <exception cref="NotSupportedException">The current platform is not Windows.</exception>
-        public bool HasNetFramework45()
-        {
-            switch (this.Platform)
-            {
-                case Platform.Windows:
-                    using (RegistryKey versionKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(@"SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full"))
-                        return versionKey?.GetValue("Release") != null; // .NET Framework 4.5+
-
-                default:
-                    throw new NotSupportedException("The installed .NET Framework version can only be checked on Windows.");
-            }
-        }
-
-        /// <summary>Get whether the current system has XNA Framework installed. This only applies on Windows.</summary>
-        /// <exception cref="NotSupportedException">The current platform is not Windows.</exception>
-        public bool HasXna()
-        {
-            switch (this.Platform)
-            {
-                case Platform.Windows:
-                    using (RegistryKey key = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(@"SOFTWARE\Microsoft\XNA\Framework"))
-                        return key != null; // XNA Framework 4.0+
-
-                default:
-                    throw new NotSupportedException("The installed XNA Framework version can only be checked on Windows.");
-            }
-        }
-
-        /// <summary>Whether the current OS supports newer versions of .NET Framework.</summary>
-        public bool CanInstallLatestNetFramework()
-        {
-            return Environment.OSVersion.Version >= this.Windows7Version; // Windows 7+
-        }
-
         /// <summary>Get whether a folder seems to contain the game files.</summary>
         /// <param name="dir">The folder to check.</param>
         public bool LooksLikeGameFolder(DirectoryInfo dir)
diff --git a/src/SMAPI.Installer/Framework/InstallerPaths.cs b/src/SMAPI.Installer/Framework/InstallerPaths.cs
index 6ba5fa5f..0976eceb 100644
--- a/src/SMAPI.Installer/Framework/InstallerPaths.cs
+++ b/src/SMAPI.Installer/Framework/InstallerPaths.cs
@@ -1,4 +1,5 @@
 using System.IO;
+using StardewModdingAPI.Toolkit.Framework;
 
 namespace StardewModdingAPI.Installer.Framework
 {
@@ -44,17 +45,20 @@ namespace StardewModdingAPI.Installer.Framework
         /// <summary>The full path to the user's config overrides file.</summary>
         public string ApiUserConfigPath { get; }
 
-        /// <summary>The full path to the installed game executable file.</summary>
-        public string ExecutablePath { get; private set; }
+        /// <summary>The full path to the installed game DLL.</summary>
+        public string GameDllPath { get; }
 
-        /// <summary>The full path to the vanilla game launcher on Linux/macOS.</summary>
-        public string UnixLauncherPath { get; }
+        /// <summary>The full path to the installed SMAPI executable file.</summary>
+        public string UnixSmapiExecutablePath { get; }
 
-        /// <summary>The full path to the installed SMAPI launcher on Linux/macOS before it's renamed.</summary>
-        public string UnixSmapiLauncherPath { get; }
+        /// <summary>The full path to the vanilla game launch script on Linux/macOS.</summary>
+        public string VanillaLaunchScriptPath { get; }
 
-        /// <summary>The full path to the vanilla game launcher on Linux/macOS after SMAPI is installed.</summary>
-        public string UnixBackupLauncherPath { get; }
+        /// <summary>The full path to the installed SMAPI launch script on Linux/macOS before it's renamed.</summary>
+        public string NewLaunchScriptPath { get; }
+
+        /// <summary>The full path to the backed up game launch script on Linux/macOS after SMAPI is installed.</summary>
+        public string BackupLaunchScriptPath { get; }
 
 
         /*********
@@ -63,28 +67,24 @@ namespace StardewModdingAPI.Installer.Framework
         /// <summary>Construct an instance.</summary>
         /// <param name="bundleDir">The directory path containing the files to copy into the game folder.</param>
         /// <param name="gameDir">The directory path for the installed game.</param>
-        /// <param name="gameExecutableName">The name of the game's executable file for the current platform.</param>
-        public InstallerPaths(DirectoryInfo bundleDir, DirectoryInfo gameDir, string gameExecutableName)
+        public InstallerPaths(DirectoryInfo bundleDir, DirectoryInfo gameDir)
         {
+            // base paths
             this.BundleDir = bundleDir;
             this.GameDir = gameDir;
             this.ModsDir = new DirectoryInfo(Path.Combine(gameDir.FullName, "Mods"));
+            this.GameDllPath = Path.Combine(gameDir.FullName, Constants.GameDllName);
 
+            // launch scripts
+            this.VanillaLaunchScriptPath = Path.Combine(gameDir.FullName, "StardewValley");
+            this.NewLaunchScriptPath = Path.Combine(gameDir.FullName, "unix-launcher.sh");
+            this.BackupLaunchScriptPath = Path.Combine(gameDir.FullName, "StardewValley-original");
+            this.UnixSmapiExecutablePath = Path.Combine(gameDir.FullName, "StardewModdingAPI");
+
+            // internal files
             this.BundleApiUserConfigPath = Path.Combine(bundleDir.FullName, "smapi-internal", "config.user.json");
-
-            this.ExecutablePath = Path.Combine(gameDir.FullName, gameExecutableName);
-            this.UnixLauncherPath = Path.Combine(gameDir.FullName, "StardewValley");
-            this.UnixSmapiLauncherPath = Path.Combine(gameDir.FullName, "StardewModdingAPI");
-            this.UnixBackupLauncherPath = Path.Combine(gameDir.FullName, "StardewValley-original");
             this.ApiConfigPath = Path.Combine(gameDir.FullName, "smapi-internal", "config.json");
             this.ApiUserConfigPath = Path.Combine(gameDir.FullName, "smapi-internal", "config.user.json");
         }
-
-        /// <summary>Override the filename for the <see cref="ExecutablePath"/>.</summary>
-        /// <param name="filename">the file name.</param>
-        public void SetExecutableFileName(string filename)
-        {
-            this.ExecutablePath = Path.Combine(this.GamePath, filename);
-        }
     }
 }
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 79c3b891..34285cf7 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -41,12 +41,13 @@ namespace StardewModdingApi.Installer
             // current files
             yield return GetInstallPath("libgdiplus.dylib");           // Linux/macOS only
             yield return GetInstallPath("StardewModdingAPI");          // Linux/macOS only
+            yield return GetInstallPath("StardewModdingAPI.dll");
             yield return GetInstallPath("StardewModdingAPI.exe");
             yield return GetInstallPath("StardewModdingAPI.exe.config");
             yield return GetInstallPath("StardewModdingAPI.exe.mdb");  // Linux/macOS only
             yield return GetInstallPath("StardewModdingAPI.pdb");      // Windows only
+            yield return GetInstallPath("StardewModdingAPI.runtimeconfig.json");
             yield return GetInstallPath("StardewModdingAPI.xml");
-            yield return GetInstallPath("StardewModdingAPI-x64.exe");  // not normally added to game folder, but may be mistakenly added by a manual install
             yield return GetInstallPath("smapi-internal");
             yield return GetInstallPath("steam_appid.txt");
 
@@ -70,9 +71,7 @@ namespace StardewModdingApi.Installer
             yield return GetInstallPath("StardewModdingAPI.Toolkit.CoreInterfaces.dll"); // moved in 2.8
             yield return GetInstallPath("StardewModdingAPI.Toolkit.CoreInterfaces.pdb"); // moved in 2.8
             yield return GetInstallPath("StardewModdingAPI.Toolkit.CoreInterfaces.xml"); // moved in 2.8
-            yield return GetInstallPath("System.Numerics.dll");               // moved in 2.8
-            yield return GetInstallPath("System.Runtime.Caching.dll");        // moved in 2.8
-            yield return GetInstallPath("System.ValueTuple.dll");             // moved in 2.8
+            yield return GetInstallPath("StardewModdingAPI-x64.exe");         // 3.13
 
             if (modsDir.Exists)
             {
@@ -149,30 +148,6 @@ namespace StardewModdingApi.Installer
             }
 #endif
 
-            /****
-            ** Check Windows dependencies
-            ****/
-            if (context.IsWindows)
-            {
-                // .NET Framework 4.5+
-                if (!context.HasNetFramework45())
-                {
-                    this.PrintError(context.CanInstallLatestNetFramework()
-                            ? "Please install the latest version of .NET Framework before installing SMAPI."
-                            : "Please install .NET Framework 4.5 before installing SMAPI."
-                    );
-                    this.PrintError("See the download page at https://www.microsoft.com/net/download/framework for details.");
-                    Console.ReadLine();
-                    return;
-                }
-                if (!context.HasXna())
-                {
-                    this.PrintError("You don't seem to have XNA Framework installed. Please run the game at least once before installing SMAPI, so it can perform its first-time setup.");
-                    Console.ReadLine();
-                    return;
-                }
-            }
-
             /****
             ** read command-line arguments
             ****/
@@ -270,7 +245,7 @@ namespace StardewModdingApi.Installer
 
                 // get folders
                 DirectoryInfo bundleDir = new DirectoryInfo(this.BundlePath);
-                paths = new InstallerPaths(bundleDir, installDir, context.ExecutableName);
+                paths = new InstallerPaths(bundleDir, installDir);
             }
 
 
@@ -278,7 +253,7 @@ namespace StardewModdingApi.Installer
             ** Step 4: validate assumptions
             *********/
             // executable exists
-            if (!File.Exists(paths.ExecutablePath))
+            if (!File.Exists(paths.GameDllPath))
             {
                 this.PrintError("The detected game install path doesn't contain a Stardew Valley executable.");
                 Console.ReadLine();
@@ -367,11 +342,11 @@ namespace StardewModdingApi.Installer
                 ** Always uninstall old files
                 ****/
                 // restore game launcher
-                if (context.IsUnix && File.Exists(paths.UnixBackupLauncherPath))
+                if (context.IsUnix && File.Exists(paths.BackupLaunchScriptPath))
                 {
                     this.PrintDebug("Removing SMAPI launcher...");
-                    this.InteractivelyDelete(paths.UnixLauncherPath);
-                    File.Move(paths.UnixBackupLauncherPath, paths.UnixLauncherPath);
+                    this.InteractivelyDelete(paths.VanillaLaunchScriptPath);
+                    File.Move(paths.BackupLaunchScriptPath, paths.VanillaLaunchScriptPath);
                 }
 
                 // remove old files
@@ -419,28 +394,31 @@ namespace StardewModdingApi.Installer
                         this.PrintDebug("Safely replacing game launcher...");
 
                         // back up & remove current launcher
-                        if (File.Exists(paths.UnixLauncherPath))
+                        if (File.Exists(paths.VanillaLaunchScriptPath))
                         {
-                            if (!File.Exists(paths.UnixBackupLauncherPath))
-                                File.Move(paths.UnixLauncherPath, paths.UnixBackupLauncherPath);
+                            if (!File.Exists(paths.BackupLaunchScriptPath))
+                                File.Move(paths.VanillaLaunchScriptPath, paths.BackupLaunchScriptPath);
                             else
-                                this.InteractivelyDelete(paths.UnixLauncherPath);
+                                this.InteractivelyDelete(paths.VanillaLaunchScriptPath);
                         }
 
                         // add new launcher
-                        File.Move(paths.UnixSmapiLauncherPath, paths.UnixLauncherPath);
+                        File.Move(paths.NewLaunchScriptPath, paths.VanillaLaunchScriptPath);
 
-                        // mark file executable
+                        // mark files executable
                         // (MSBuild doesn't keep permission flags for files zipped in a build task.)
-                        new Process
+                        foreach (string path in new[] { paths.VanillaLaunchScriptPath, paths.UnixSmapiExecutablePath })
                         {
-                            StartInfo = new ProcessStartInfo
+                            new Process
                             {
-                                FileName = "chmod",
-                                Arguments = $"755 \"{paths.UnixLauncherPath}\"",
-                                CreateNoWindow = true
-                            }
-                        }.Start();
+                                StartInfo = new ProcessStartInfo
+                                {
+                                    FileName = "chmod",
+                                    Arguments = $"755 \"{path}\"",
+                                    CreateNoWindow = true
+                                }
+                            }.Start();
+                        }
                     }
 
                     // create mods directory (if needed)
@@ -507,7 +485,7 @@ namespace StardewModdingApi.Installer
 
 
             /*********
-            ** Step 6: final instructions
+            ** Step 7: final instructions
             *********/
             if (context.IsWindows)
             {
@@ -536,13 +514,6 @@ namespace StardewModdingApi.Installer
         /*********
         ** Private methods
         *********/
-        /// <summary>Get whether an executable is 64-bit.</summary>
-        /// <param name="executablePath">The absolute path to the executable file.</param>
-        private bool Is64Bit(string executablePath)
-        {
-            return LowLevelEnvironmentUtility.Is64BitAssembly(executablePath);
-        }
-
         /// <summary>Get the display text for a color scheme.</summary>
         /// <param name="scheme">The color scheme.</param>
         private string GetDisplayText(MonitorColorScheme scheme)
@@ -705,7 +676,7 @@ namespace StardewModdingApi.Installer
             {
                 // get path from user
                 Console.WriteLine();
-                this.PrintInfo($"Type the file path to the game directory (the one containing '{context.ExecutableName}'), then press enter.");
+                this.PrintInfo($"Type the file path to the game directory (the one containing '{Constants.GameDllName}'), then press enter.");
                 string path = Console.ReadLine()?.Trim();
                 if (string.IsNullOrWhiteSpace(path))
                 {
diff --git a/src/SMAPI.Installer/SMAPI.Installer.csproj b/src/SMAPI.Installer/SMAPI.Installer.csproj
index c47f3e6e..e3e01467 100644
--- a/src/SMAPI.Installer/SMAPI.Installer.csproj
+++ b/src/SMAPI.Installer/SMAPI.Installer.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI.Installer</RootNamespace>
     <Description>The SMAPI installer for players.</Description>
-    <TargetFramework>net452</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <OutputType>Exe</OutputType>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
diff --git a/src/SMAPI.Installer/assets/System.Numerics.dll b/src/SMAPI.Installer/assets/System.Numerics.dll
deleted file mode 100644
index fed0f92c4903b24e68b0297ab2804298e93af85d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 54272
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

diff --git a/src/SMAPI.Installer/assets/System.Runtime.Caching.dll b/src/SMAPI.Installer/assets/System.Runtime.Caching.dll
deleted file mode 100644
index a062391d766663e230e6c0bede7e61a8bdbbfbb2..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 71168
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
Vy@2)`S{?uGf%_+r{zx$J{{b*Wx-<X)

diff --git a/src/SMAPI.Installer/assets/unix-install.sh b/src/SMAPI.Installer/assets/unix-install.sh
index 311c5469..a830a22d 100644
--- a/src/SMAPI.Installer/assets/unix-install.sh
+++ b/src/SMAPI.Installer/assets/unix-install.sh
@@ -1,24 +1,10 @@
 #!/bin/bash
-# Run the SMAPI installer through Mono on Linux or macOS.
 
 # Move to script's directory
 cd "`dirname "$0"`"
 
-# get cross-distro version of POSIX command
-COMMAND=""
-if command -v command >/dev/null 2>&1; then
-    COMMAND="command -v"
-elif type type >/dev/null 2>&1; then
-    COMMAND="type"
-fi
-
 # if $TERM is not set to xterm, mono will bail out when attempting to write to the console.
 export TERM=xterm
 
-# validate Mono & run installer
-if $COMMAND mono >/dev/null 2>&1; then
-    mono internal/unix-install.exe
-else
-   echo "Oops! Looks like Mono isn't installed. Please install Mono from https://mono-project.com, reboot, and run this installer again."
-   read
-fi
+# run installer
+./internal/unix-install
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index d309f750..21bed803 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -1,34 +1,17 @@
 #!/usr/bin/env bash
-# MonoKickstart Shell Script
-# Written by Ethan "flibitijibibo" Lee
-# Modified for SMAPI by various contributors
 
 # Move to script's directory
 cd "$(dirname "$0")" || exit $?
 
-# Get the system architecture
-UNAME=$(uname)
-ARCH=$(uname -m)
+# validate script is being run from the game folder
+if [ ! -f "Stardew Valley.dll" ]; then
+    echo "Oops! SMAPI must be placed in the Stardew Valley game folder.\nSee instructions: https://stardewvalleywiki.com/Modding:Player_Guide";
+    read
+    exit 1
+fi
 
-# MonoKickstart picks the right libfolder, so just execute the right binary.
+# macOS
 if [ "$UNAME" == "Darwin" ]; then
-    # ... Except on OSX.
-    export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:./osx/
-
-    # El Capitan is a total idiot and wipes this variable out, making the
-    # Steam overlay disappear. This sidesteps "System Integrity Protection"
-    # and resets the variable with Valve's own variable (they provided this
-    # fix by the way, thanks Valve!). Note that you will need to update your
-    # launch configuration to the script location, NOT just the app location
-    # (i.e. Kick.app/Contents/MacOS/Kick, not just Kick.app).
-    # -flibit
-    if [ "$STEAM_DYLD_INSERT_LIBRARIES" != "" ] && [ "$DYLD_INSERT_LIBRARIES" == "" ]; then
-        export DYLD_INSERT_LIBRARIES="$STEAM_DYLD_INSERT_LIBRARIES"
-    fi
-
-    # this was here before
-    ln -sf mcs.bin.osx mcs
-
     # fix "DllNotFoundException: libgdiplus.dylib" errors when loading images in SMAPI
     if [ -f libgdiplus.dylib ]; then
         rm libgdiplus.dylib
@@ -37,52 +20,13 @@ if [ "$UNAME" == "Darwin" ]; then
         ln -s /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib libgdiplus.dylib
     fi
 
-    # create bin file
-    # Note: don't overwrite if it's identical, to avoid resetting permission flags
-    if [ ! -x StardewModdingAPI.bin.osx ] || ! cmp StardewValley.bin.osx StardewModdingAPI.bin.osx >/dev/null 2>&1; then
-        cp -p StardewValley.bin.osx StardewModdingAPI.bin.osx
-    fi
+    # launch smapi
+    open -a Terminal ./StardewModdingAPI "$@"
 
-    # Make sure we're running in Terminal (so the user can see errors/warnings/update alerts).
-    # Previously we would just use `open -a Terminal` to launch the .bin.osx file, but that
-    # doesn't let us set environment variables.
-    if [ ! -t 1 ]; then # https://stackoverflow.com/q/911168/262123
-        # sanity check to make sure we don't have an infinite loop of opening windows
-        SKIP_TERMINAL=false
-        for argument in "$@"; do
-            if [ "$argument" == "--no-reopen-terminal" ]; then
-                SKIP_TERMINAL=true
-                break
-            fi
-        done
-
-        # reopen in Terminal if needed
-        # https://stackoverflow.com/a/29511052/262123
-        if [ "$SKIP_TERMINAL" == "false" ]; then
-            echo "Reopening in the Terminal app..."
-            echo "\"$0\" $@ --no-reopen-terminal" > /tmp/open-smapi-terminal.sh
-            chmod +x /tmp/open-smapi-terminal.sh
-            cat /tmp/open-smapi-terminal.sh
-            open -W -a Terminal /tmp/open-smapi-terminal.sh
-            rm /tmp/open-smapi-terminal.sh
-            exit 0
-        fi
-    fi
-
-    # launch SMAPI
-    LC_ALL="C" ./StardewModdingAPI.bin.osx "$@"
+# Linux
 else
     # choose binary file to launch
-    LAUNCH_FILE=""
-    if [ "$ARCH" == "x86_64" ]; then
-        ln -sf mcs.bin.x86_64 mcs
-        cp StardewValley.bin.x86_64 StardewModdingAPI.bin.x86_64
-        LAUNCH_FILE="./StardewModdingAPI.bin.x86_64"
-    else
-        ln -sf mcs.bin.x86 mcs
-        cp StardewValley.bin.x86 StardewModdingAPI.bin.x86
-        LAUNCH_FILE="./StardewModdingAPI.bin.x86"
-    fi
+    LAUNCH_FILE="./StardewModdingAPI"
     export LAUNCH_FILE
 
     # select terminal (prefer xterm for best compatibility, then known supported terminals)
@@ -105,44 +49,44 @@ else
             terminal|termite)
                 # consumes only one argument after -e
                 # options containing space characters are unsupported
-                exec $TERMINAL_NAME -e "env TERM=xterm LC_ALL=\"C\" $LAUNCH_FILE $@"
+                exec $TERMINAL_NAME -e "env TERM=xterm $LAUNCH_FILE $@"
                 ;;
 
             xterm|konsole|alacritty)
                 # consumes all arguments after -e
-                exec $TERMINAL_NAME -e env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
+                exec $TERMINAL_NAME -e env TERM=xterm $LAUNCH_FILE "$@"
                 ;;
 
             terminator|xfce4-terminal|mate-terminal)
                 # consumes all arguments after -x
-                exec $TERMINAL_NAME -x env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
+                exec $TERMINAL_NAME -x env TERM=xterm $LAUNCH_FILE "$@"
                 ;;
 
             gnome-terminal)
                 # consumes all arguments after --
-                exec $TERMINAL_NAME -- env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
+                exec $TERMINAL_NAME -- env TERM=xterm $LAUNCH_FILE "$@"
                 ;;
 
             kitty)
                 # consumes all trailing arguments
-                exec $TERMINAL_NAME env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
+                exec $TERMINAL_NAME env TERM=xterm $LAUNCH_FILE "$@"
                 ;;
 
             *)
                 # If we don't know the terminal, just try to run it in the current shell.
                 # If THAT fails, launch with no output.
-                env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
+                env TERM=xterm $LAUNCH_FILE "$@"
                 if [ $? -eq 127 ]; then
-                    exec LC_ALL="C" $LAUNCH_FILE --no-terminal "$@"
+                    exec $LAUNCH_FILE --no-terminal "$@"
                 fi
         esac
 
     ## terminal isn't executable; fallback to current shell or no terminal
     else
         echo "The '$TERMINAL_NAME' terminal isn't executable. SMAPI might be running in a sandbox or the system might be misconfigured? Falling back to current shell."
-        env TERM=xterm LC_ALL="C" $LAUNCH_FILE "$@"
+        env TERM=xterm $LAUNCH_FILE "$@"
         if [ $? -eq 127 ]; then
-            exec LC_ALL="C" $LAUNCH_FILE --no-terminal "$@"
+            exec $LAUNCH_FILE --no-terminal "$@"
         fi
     fi
 fi
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
index dc3d8320..264932e4 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
@@ -1,18 +1,14 @@
 <Project Sdk="Microsoft.NET.Sdk">
-
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="2.10.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.0.0" />
+    <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="3.10.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.9.4" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.1.0">
-      <PrivateAssets>all</PrivateAssets>
-      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-    </PackageReference>
+    <PackageReference Include="NUnit3TestAdapter" Version="3.17.0" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
   </ItemGroup>
 
   <ItemGroup>
@@ -20,5 +16,4 @@
   </ItemGroup>
 
   <Import Project="..\..\build\common.targets" />
-
 </Project>
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj b/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
index 0d109b83..3fadc37a 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
@@ -9,8 +9,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="2.10.0" PrivateAssets="all" />
-    <PackageReference Update="NETStandard.Library" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="3.10.0" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 93769650..33356413 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -2,28 +2,28 @@
   <PropertyGroup>
     <!--build-->
     <RootNamespace>StardewModdingAPI.ModBuildConfig</RootNamespace>
-    <TargetFramework>net452</TargetFramework>
+    <TargetFramework>netstandard2.0</TargetFramework>
     <LangVersion>latest</LangVersion>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
 
     <!--NuGet package-->
     <PackageId>Pathoschild.Stardew.ModBuildConfig</PackageId>
     <Title>Build package for SMAPI mods</Title>
-    <Version>3.3.0</Version>
+    <Version>3.4.0</Version>
     <Authors>Pathoschild</Authors>
-    <Description>Automates the build configuration for crossplatform Stardew Valley SMAPI mods. For SMAPI 3.0 or later.</Description>
+    <Description>Automates the build configuration for crossplatform Stardew Valley SMAPI mods. For SMAPI 3.13.0 or later.</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <PackageIcon>images/icon.png</PackageIcon>
     <PackageProjectUrl>https://smapi.io/package/readme</PackageProjectUrl>
     <IncludeBuildOutput>false</IncludeBuildOutput>
+
+    <!--copy dependency DLLs to bin folder so we can include them in package -->
+    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
   </PropertyGroup>
 
   <ItemGroup>
-    <Reference Include="Microsoft.Build" />
-    <Reference Include="Microsoft.Build.Framework" />
-    <Reference Include="Microsoft.Build.Utilities.v4.0" />
-    <Reference Include="System.IO.Compression" />
-    <Reference Include="System.Web.Extensions" />
+    <PackageReference Include="Microsoft.Build.Utilities.Core" Version="16.10" />
+    <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index be10481b..a3cd6c45 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -45,13 +45,13 @@
   **********************************************-->
   <ItemGroup>
     <!-- game -->
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="$(CopyModReferencesToBuildOutput)" />
+    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="$(CopyModReferencesToBuildOutput)" />
 
     <!-- SMAPI -->
-    <Reference Include="StardewModdingAPI" HintPath="$(GamePath)\StardewModdingAPI.exe" Private="$(CopyModReferencesToBuildOutput)" />
+    <Reference Include="StardewModdingAPI" HintPath="$(GamePath)\StardewModdingAPI.dll" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="SMAPI.Toolkit.CoreInterfaces" HintPath="$(GamePath)\smapi-internal\SMAPI.Toolkit.CoreInterfaces.dll" Private="$(CopyModReferencesToBuildOutput)" />
 
     <!-- Harmony -->
@@ -68,8 +68,8 @@
 
     <!-- invalid game path -->
     <Error Condition="!Exists('$(GamePath)')" Text="The mod build package can't find your game folder. You can specify where to find it; see https://smapi.io/package/custom-game-path." ContinueOnError="false" />
-    <Error Condition="!Exists('$(GamePath)\$(GameExecutableName).exe')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain the $(GameExecutableName) file. If this folder is invalid, delete it and the package will autodetect another game install path." ContinueOnError="false" />
-    <Error Condition="!Exists('$(GamePath)\StardewModdingAPI.exe')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain SMAPI. You need to install SMAPI before building the mod." ContinueOnError="false" />
+    <Error Condition="!Exists('$(GamePath)\$(GameExecutableName).dll')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain the $(GameExecutableName) file. If this folder is invalid, delete it and the package will autodetect another game install path." ContinueOnError="false" />
+    <Error Condition="!Exists('$(GamePath)\StardewModdingAPI.dll')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain SMAPI. You need to install SMAPI before building the mod." ContinueOnError="false" />
 
     <!-- invalid target architecture (note: internal value is 'AnyCPU', value shown in Visual Studio is 'Any CPU') -->
     <Warning Condition="'$(Platform)' != 'AnyCPU'" Text="The target platform should be set to 'Any CPU' for compatibility with both 32-bit and 64-bit versions of Stardew Valley (currently set to '$(Platform)'). See https://smapi.io/package/wrong-processor-architecture for details." HelpLink="https://smapi.io/package/wrong-processor-architecture" />
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index fa192073..65d54599 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>ConsoleCommands</AssemblyName>
     <RootNamespace>StardewModdingAPI.Mods.ConsoleCommands</RootNamespace>
-    <TargetFramework>net452</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
 
@@ -13,7 +13,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
   </ItemGroup>
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 7ba6025b..2ad19df7 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>ErrorHandler</AssemblyName>
     <RootNamespace>StardewModdingAPI.Mods.ErrorHandler</RootNamespace>
-    <TargetFramework>net452</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
 
@@ -14,7 +14,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
diff --git a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
index 079beb08..f8908c7d 100644
--- a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
+++ b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>SaveBackup</AssemblyName>
     <RootNamespace>StardewModdingAPI.Mods.SaveBackup</RootNamespace>
-    <TargetFramework>net452</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
   </PropertyGroup>
 
@@ -13,7 +13,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 8f7bfab4..e19105ff 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>SMAPI.Tests</AssemblyName>
     <RootNamespace>SMAPI.Tests</RootNamespace>
-    <TargetFramework>net452</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
@@ -16,6 +16,7 @@
   </ItemGroup>
 
   <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.9.4" />
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
@@ -23,7 +24,7 @@
 
   <ItemGroup>
     <Reference Include="$(GameExecutableName)">
-      <HintPath>$(GamePath)\$(GameExecutableName).exe</HintPath>
+      <HintPath>$(GamePath)\$(GameExecutableName).dll</HintPath>
       <Private>True</Private>
     </Reference>
   </ItemGroup>
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
index 0e1e40b2..4c92b4db 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
+++ b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI</RootNamespace>
     <Description>Provides toolkit interfaces which are available to SMAPI mods.</Description>
-    <TargetFrameworks>net452;netstandard2.0</TargetFrameworks>
+    <TargetFrameworks>net5.0; netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Toolkit/Framework/Constants.cs b/src/SMAPI.Toolkit/Framework/Constants.cs
new file mode 100644
index 00000000..55f26582
--- /dev/null
+++ b/src/SMAPI.Toolkit/Framework/Constants.cs
@@ -0,0 +1,9 @@
+namespace StardewModdingAPI.Toolkit.Framework
+{
+    /// <summary>Contains the SMAPI installer's constants and assumptions.</summary>
+    internal static class Constants
+    {
+        /// <summary>The name of the game's main DLL, used to detect game folders.</summary>
+        public const string GameDllName = "Stardew Valley.dll";
+    }
+}
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index c90fc1d3..7553c07f 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -56,10 +56,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         {
             return
                 dir.Exists
-                && (
-                    dir.EnumerateFiles("StardewValley.exe").Any()
-                    || dir.EnumerateFiles("Stardew Valley.exe").Any()
-                );
+                && dir.EnumerateFiles("Stardew Valley.dll").Any();
         }
 
 
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index 2636aae0..8b6eb5fb 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -80,15 +80,6 @@ namespace StardewModdingAPI.Toolkit.Framework
             return name;
         }
 
-        /// <summary>Get the name of the Stardew Valley executable.</summary>
-        /// <param name="platform">The current platform.</param>
-        public static string GetExecutableName(string platform)
-        {
-            return platform == nameof(Platform.Windows)
-                ? "Stardew Valley.exe"
-                : "StardewValley.exe";
-        }
-
         /// <summary>Get whether an executable is 64-bit.</summary>
         /// <param name="path">The absolute path to the assembly file.</param>
         public static bool Is64BitAssembly(string path)
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 3d87c169..ec27bf79 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI.Toolkit</RootNamespace>
     <Description>A library which encapsulates mod-handling logic for mod managers and tools. Not intended for use by mods.</Description>
-    <TargetFrameworks>net452;netstandard2.0</TargetFrameworks>
+    <TargetFrameworks>net5.0; netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
@@ -12,8 +12,8 @@
     <PackageReference Include="HtmlAgilityPack" Version="1.11.33" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
-    <PackageReference Include="System.Management" Version="4.5.0" Condition="'$(OS)' == 'Windows_NT'" />
-    <PackageReference Include="Microsoft.Win32.Registry" Version="4.5.0" Condition="'$(OS)' == 'Windows_NT' AND '$(TargetFramework)' == 'netstandard2.0'" />
+    <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
+    <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
index 6de79a85..7536337a 100644
--- a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
@@ -40,13 +40,6 @@ namespace StardewModdingAPI.Toolkit.Utilities
             return LowLevelEnvironmentUtility.GetFriendlyPlatformName(platform.ToString());
         }
 
-        /// <summary>Get the name of the Stardew Valley executable.</summary>
-        /// <param name="platform">The current platform.</param>
-        public static string GetExecutableName(Platform platform)
-        {
-            return LowLevelEnvironmentUtility.GetExecutableName(platform.ToString());
-        }
-
         /// <summary>Get whether an executable is 64-bit.</summary>
         /// <param name="path">The absolute path to the assembly file.</param>
         public static bool Is64BitAssembly(string path)
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index 020ebc6d..c17bb354 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -88,14 +88,18 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <summary>Get a directory or file path relative to a given source path. If no relative path is possible (e.g. the paths are on different drives), an absolute path is returned.</summary>
         /// <param name="sourceDir">The source folder path.</param>
         /// <param name="targetPath">The target folder or file path.</param>
-        /// <remarks>
-        ///
-        /// NOTE: this is a heuristic implementation that works in the cases SMAPI needs it for, but it doesn't handle all edge cases (e.g. case-sensitivity on Linux, or traversing between UNC paths on Windows). This should be replaced with the more comprehensive <c>Path.GetRelativePath</c> if the game ever migrates to .NET Core.
-        ///
-        /// </remarks>
         [Pure]
         public static string GetRelativePath(string sourceDir, string targetPath)
         {
+#if NET5_0
+            return Path.GetRelativePath(sourceDir, targetPath);
+#else
+            // NOTE:
+            // this is a heuristic implementation that works in the cases SMAPI needs it for, but it
+            // doesn't handle all edge cases (e.g. case-sensitivity on Linux, or traversing between
+            // UNC paths on Windows). SMAPI and mods will use the more robust .NET 5 version anyway
+            // though, this is only for compatibility with the mod build package.
+
             // convert to URIs
             Uri from = new Uri(sourceDir.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
             Uri to = new Uri(targetPath.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
@@ -123,6 +127,7 @@ namespace StardewModdingAPI.Toolkit.Utilities
             }
 
             return relative;
+#endif
         }
 
         /// <summary>Get whether a path is relative and doesn't try to climb out of its containing folder (e.g. doesn't contain <c>../</c>).</summary>
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 2e25a94a..abcb2f64 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -290,7 +290,7 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="customSettings">The custom SMAPI settings.</param>
         public void LogIntro(string modsPath, IDictionary<string, object> customSettings)
         {
-            // log platform & patches
+            // log platform
             this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
 
             // log basic info
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index 8d1b6034..5acba569 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -24,7 +24,7 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <summary>Construct an instance.</summary>
         public InterfaceProxyFactory()
         {
-            AssemblyBuilder assemblyBuilder = AppDomain.CurrentDomain.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
+            AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
             this.ModuleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
         }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index b049e868..95a7ace6 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -16,7 +16,6 @@ using Microsoft.Xna.Framework;
 #if SMAPI_FOR_WINDOWS
 using Microsoft.Win32;
 #endif
-using Microsoft.Xna.Framework;
 using Newtonsoft.Json;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Events;
@@ -1298,9 +1297,6 @@ namespace StardewModdingAPI.Framework
             {
                 // create client
                 string url = this.Settings.WebApiBaseUrl;
-#if !SMAPI_FOR_WINDOWS
-                url = url.Replace("https://", "http://"); // workaround for OpenSSL issues with the game's bundled Mono on Linux/macOS
-#endif
                 WebApiClient client = new WebApiClient(url, Constants.ApiVersion);
                 this.Monitor.Log("Checking for updates...");
 
@@ -1695,9 +1691,8 @@ namespace StardewModdingAPI.Framework
                 catch (Exception ex)
                 {
                     errorReasonPhrase = "its DLL couldn't be loaded.";
-                    // re-enable in Stardew Valley 1.5.5
-                    //if (ex is BadImageFormatException && !EnvironmentUtility.Is64BitAssembly(assemblyPath))
-                    //    errorReasonPhrase = "it needs to be updated for 64-bit mode.";
+                    if (ex is BadImageFormatException && !EnvironmentUtility.Is64BitAssembly(assemblyPath))
+                        errorReasonPhrase = "it needs to be updated for 64-bit mode.";
 
                     errorDetails = $"Error: {ex.GetLogSummary()}";
                     failReason = ModFailReason.LoadFailed;
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 368306a1..232e54ce 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -48,7 +48,7 @@ namespace StardewModdingAPI.Metadata
                 // rewrite for Stardew Valley 1.5.5
                 if (platformChanged)
                     yield return new MethodParentRewriter(typeof(SpriteBatch), typeof(SpriteBatchFacade));
-                //yield return new ArchitectureAssemblyRewriter();
+                yield return new ArchitectureAssemblyRewriter();
 
                 // detect Harmony & rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
                 yield return new HarmonyRewriter();
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index e5cc8da6..a04dd1b6 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -3,13 +3,16 @@
     <AssemblyName>StardewModdingAPI</AssemblyName>
     <RootNamespace>StardewModdingAPI</RootNamespace>
     <Description>The modding API for Stardew Valley.</Description>
-    <TargetFramework>net452</TargetFramework>
-    <PlatformTarget>x86</PlatformTarget>
+    <TargetFramework>net5.0</TargetFramework>
+    <PlatformTarget>x64</PlatformTarget>
     <OutputType>Exe</OutputType>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
     <LargeAddressAware Condition="'$(OS)' == 'Windows_NT'">true</LargeAddressAware>
     <ApplicationIcon>icon.ico</ApplicationIcon>
+
+    <!--copy dependency DLLs to bin folder so we can include them in installer bundle -->
+    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
@@ -19,15 +22,16 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Platonymous.TMXTile" Version="1.5.8" />
+    <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
+    <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
+    <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />
   </ItemGroup>
 
   <ItemGroup>
     <Reference Include="..\..\build\0Harmony.dll" Private="True" />
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).exe" Private="False" />
+    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
     <Reference Include="System.Numerics" Private="True" />
-    <Reference Include="System.Runtime.Caching" Private="True" />
     <Reference Include="GalaxyCSharp" HintPath="$(GamePath)\GalaxyCSharp.dll" Private="False" />
     <Reference Include="Lidgren.Network" HintPath="$(GamePath)\Lidgren.Network.dll" Private="False" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />

From 8321cbf6eba7ca3fa46d6e452fd9ebff6baa99d0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:10 -0400
Subject: [PATCH 324/856] update for asset name format change

MonoGame uses Linux-style paths for assets on all platforms, which breaks the previous equivalence between path and asset name formats.
---
 src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs |  8 ++------
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs    |  2 +-
 src/SMAPI/Framework/Content/ContentCache.cs     | 14 ++++----------
 3 files changed, 7 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
index c18f47a5..ab4c2618 100644
--- a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
+++ b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
@@ -182,18 +182,14 @@ namespace SMAPI.Tests.Utilities
         [TestCaseSource(nameof(PathUtilitiesTests.SamplePaths))]
         public void NormalizeAssetName(SamplePath path)
         {
-            if (Path.IsPathRooted(path.OriginalPath) || path.OriginalPath.StartsWith("/") || path.OriginalPath.StartsWith("\\"))
+            if (Path.IsPathRooted(path.OriginalPath) || path.OriginalPath.StartsWith('/') || path.OriginalPath.StartsWith('\\'))
                 Assert.Ignore("Absolute paths can't be used as asset names.");
 
             // act
             string normalized = PathUtilities.NormalizeAssetName(path.OriginalPath);
 
             // assert
-#if SMAPI_FOR_WINDOWS
-            Assert.AreEqual(path.NormalizedOnWindows, normalized);
-#else
-            Assert.AreEqual(path.NormalizedOnUnix, normalized);
-#endif
+            Assert.AreEqual(path.NormalizedOnUnix, normalized); // MonoGame uses the Linux format
         }
 
         /****
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index c17bb354..1d378042 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -27,7 +27,7 @@ namespace StardewModdingAPI.Toolkit.Utilities
         public static readonly char PreferredPathSeparator = Path.DirectorySeparatorChar;
 
         /// <summary>The preferred directory separator character in an asset key.</summary>
-        public static readonly char PreferredAssetSeparator = PathUtilities.PreferredPathSeparator;
+        public static readonly char PreferredAssetSeparator = '/';
 
 
         /*********
diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index 87d15e32..8e0c6228 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -17,9 +17,6 @@ namespace StardewModdingAPI.Framework.Content
         /// <summary>The underlying asset cache.</summary>
         private readonly IDictionary<string, object> Cache;
 
-        /// <summary>Applies platform-specific asset key normalization so it's consistent with the underlying cache.</summary>
-        private readonly Func<string, string> NormalizeAssetNameForPlatform;
-
 
         /*********
         ** Accessors
@@ -47,11 +44,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="reflection">Simplifies access to private game code.</param>
         public ContentCache(LocalizedContentManager contentManager, Reflector reflection)
         {
-            // init
             this.Cache = reflection.GetField<Dictionary<string, object>>(contentManager, "loadedAssets").GetValue();
-
-            // get key normalization logic
-            this.NormalizeAssetNameForPlatform = PathUtilities.NormalizePath; //this.NormalizeAssetNameForPlatform = key => key.Replace('\\', '/'); // based on MonoGame's ContentManager.Load<T> logic
         }
 
         /****
@@ -68,23 +61,24 @@ namespace StardewModdingAPI.Framework.Content
         /****
         ** Normalize
         ****/
-        /// <summary>Normalize path separators in a file path. For asset keys, see <see cref="NormalizeKey"/> instead.</summary>
+        /// <summary>Normalize path separators in an asset name.</summary>
         /// <param name="path">The file path to normalize.</param>
         [Pure]
         public string NormalizePathSeparators(string path)
         {
-            return PathUtilities.NormalizePath(path);
+            return PathUtilities.NormalizeAssetName(path);
         }
 
         /// <summary>Normalize a cache key so it's consistent with the underlying cache.</summary>
         /// <param name="key">The asset key.</param>
+        /// <remarks>This is equivalent to <see cref="NormalizePathSeparators"/> with added file extension logic.</remarks>
         [Pure]
         public string NormalizeKey(string key)
         {
             key = this.NormalizePathSeparators(key);
             return key.EndsWith(".xnb", StringComparison.OrdinalIgnoreCase)
                 ? key.Substring(0, key.Length - 4)
-                : this.NormalizeAssetNameForPlatform(key);
+                : key;
         }
 
         /****

From b2520feeaeccf0dd9f52239f7e978c22d72a032a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:11 -0400
Subject: [PATCH 325/856] update for other changes in SDV 1.5.5

---
 src/SMAPI/Framework/SGame.cs | 162 +++++++++++++++++------------------
 1 file changed, 79 insertions(+), 83 deletions(-)

diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 4e134455..898ed1f5 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -252,7 +252,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Replicate the game's draw logic with some changes for SMAPI.</summary>
         /// <param name="gameTime">A snapshot of the game timing state.</param>
         /// <param name="target_screen">The render target, if any.</param>
-        /// <remarks>This implementation is identical to <see cref="Game1.Draw"/>, except for try..catch around menu draw code, private field references replaced by wrappers, and added events.</remarks>
+        /// <remarks>This implementation is identical to <see cref="Game1._draw"/>, except for try..catch around menu draw code, private field references replaced by wrappers, and added events.</remarks>
         [SuppressMessage("ReSharper", "CompareOfFloatsByEqualityOperator", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "LocalVariableHidesMember", Justification = "copied from game code as-is")]
@@ -286,7 +286,7 @@ namespace StardewModdingAPI.Framework
                 IClickableMenu menu = Game1.activeClickableMenu;
                 if (menu != null)
                 {
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                     events.Rendering.RaiseEmpty();
                     try
                     {
@@ -304,7 +304,7 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.overlayMenu != null)
                 {
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                     Game1.overlayMenu.draw(Game1.spriteBatch);
                     Game1.spriteBatch.End();
                 }
@@ -315,7 +315,7 @@ namespace StardewModdingAPI.Framework
             if (Game1.activeClickableMenu != null && Game1.options.showMenuBackground && Game1.activeClickableMenu.showWithoutTransparencyIfOptionIsSet() && !this.takingMapScreenshot)
             {
                 Game1.PushUIMode();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
 
                 events.Rendering.RaiseEmpty();
                 IClickableMenu curMenu = null;
@@ -346,11 +346,11 @@ namespace StardewModdingAPI.Framework
             }
             if (Game1.gameMode == 11)
             {
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 events.Rendering.RaiseEmpty();
-                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3685"), new Vector2(16f, 16f), Microsoft.Xna.Framework.Color.HotPink);
-                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3686"), new Vector2(16f, 32f), new Microsoft.Xna.Framework.Color(0, 255, 0));
-                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.parseText(Game1.errorMessage, Game1.dialogueFont, Game1.graphics.GraphicsDevice.Viewport.Width), new Vector2(16f, 48f), Microsoft.Xna.Framework.Color.White);
+                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3685"), new Vector2(16f, 16f), Color.HotPink);
+                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3686"), new Vector2(16f, 32f), new Color(0, 255, 0));
+                Game1.spriteBatch.DrawString(Game1.dialogueFont, Game1.parseText(Game1.errorMessage, Game1.dialogueFont, Game1.graphics.GraphicsDevice.Viewport.Width), new Vector2(16f, 48f), Color.White);
                 events.Rendered.RaiseEmpty();
                 Game1.spriteBatch.End();
                 return;
@@ -368,8 +368,8 @@ namespace StardewModdingAPI.Framework
                 if (Game1.globalFade && !Game1.menuUp && (!Game1.nameSelectUp || Game1.messagePause))
                 {
                     Game1.PushUIMode();
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.Black * ((Game1.gameMode == 0) ? (1f - Game1.fadeToBlackAlpha) : Game1.fadeToBlackAlpha));
+                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.Black * ((Game1.gameMode == 0) ? (1f - Game1.fadeToBlackAlpha) : Game1.fadeToBlackAlpha));
                     Game1.spriteBatch.End();
                     Game1.PopUIMode();
                 }
@@ -388,7 +388,7 @@ namespace StardewModdingAPI.Framework
             if (Game1.showingEndOfNightStuff)
             {
                 Game1.PushUIMode();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 events.Rendering.RaiseEmpty();
                 if (Game1.activeClickableMenu != null)
                 {
@@ -417,16 +417,16 @@ namespace StardewModdingAPI.Framework
             {
                 Game1.PushUIMode();
                 base.GraphicsDevice.Clear(Game1.bgColor);
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 events.Rendering.RaiseEmpty();
                 string addOn = "";
                 for (int i = 0; (double)i < gameTime.TotalGameTime.TotalMilliseconds % 999.0 / 333.0; i++)
                 {
                     addOn += ".";
                 }
-                string str = Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3688");
-                string msg = str + addOn;
-                string largestMessage = str + "... ";
+                string text = Game1.content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3688");
+                string msg = text + addOn;
+                string largestMessage = text + "... ";
                 int msgw = SpriteText.getWidthOfString(largestMessage);
                 int msgh = 64;
                 int msgx = 64;
@@ -442,7 +442,7 @@ namespace StardewModdingAPI.Framework
             byte batchOpens = 0; // used for rendering event
             if (Game1.gameMode == 0)
             {
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 if (++batchOpens == 1)
                     events.Rendering.RaiseEmpty();
             }
@@ -456,7 +456,7 @@ namespace StardewModdingAPI.Framework
                 if (Game1.drawLighting)
                 {
                     Game1.SetRenderTarget(Game1.lightmap);
-                    base.GraphicsDevice.Clear(Microsoft.Xna.Framework.Color.White * 0f);
+                    base.GraphicsDevice.Clear(Color.White * 0f);
                     Matrix lighting_matrix = Matrix.Identity;
                     if (this.useUnscaledLighting)
                     {
@@ -465,13 +465,13 @@ namespace StardewModdingAPI.Framework
                     Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.NonPremultiplied, SamplerState.PointClamp, null, null, null, lighting_matrix);
                     if (++batchOpens == 1)
                         events.Rendering.RaiseEmpty();
-                    Microsoft.Xna.Framework.Color lighting = (Game1.currentLocation.Name.StartsWith("UndergroundMine") && Game1.currentLocation is MineShaft) ? (Game1.currentLocation as MineShaft).getLightingColor(gameTime) : ((Game1.ambientLight.Equals(Microsoft.Xna.Framework.Color.White) || (Game1.IsRainingHere() && (bool)Game1.currentLocation.isOutdoors)) ? Game1.outdoorLight : Game1.ambientLight);
+                    Color lighting = ((Game1.currentLocation.Name.StartsWith("UndergroundMine") && Game1.currentLocation is MineShaft) ? (Game1.currentLocation as MineShaft).getLightingColor(gameTime) : ((Game1.ambientLight.Equals(Color.White) || (Game1.IsRainingHere() && (bool)Game1.currentLocation.isOutdoors)) ? Game1.outdoorLight : Game1.ambientLight));
                     float light_multiplier = 1f;
                     if (Game1.player.hasBuff(26))
                     {
-                        if (lighting == Microsoft.Xna.Framework.Color.White)
+                        if (lighting == Color.White)
                         {
-                            lighting = new Microsoft.Xna.Framework.Color(0.75f, 0.75f, 0.75f);
+                            lighting = new Color(0.75f, 0.75f, 0.75f);
                         }
                         else
                         {
@@ -504,12 +504,8 @@ namespace StardewModdingAPI.Framework
                     Game1.spriteBatch.End();
                     Game1.SetRenderTarget(target_screen);
                 }
-                if (Game1.bloomDay && Game1.bloom != null)
-                {
-                    Game1.bloom.BeginDraw();
-                }
                 base.GraphicsDevice.Clear(Game1.bgColor);
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 if (++batchOpens == 1)
                     events.Rendering.RaiseEmpty();
                 events.RenderingWorld.RaiseEmpty();
@@ -522,10 +518,10 @@ namespace StardewModdingAPI.Framework
                 Game1.currentLocation.Map.GetLayer("Back").Draw(Game1.mapDisplayDevice, Game1.viewport, Location.Origin, wrapAround: false, 4);
                 Game1.currentLocation.drawWater(Game1.spriteBatch);
                 Game1.spriteBatch.End();
-                Game1.spriteBatch.Begin(SpriteSortMode.FrontToBack, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.FrontToBack, BlendState.AlphaBlend, SamplerState.PointClamp);
                 Game1.currentLocation.drawFloorDecorations(Game1.spriteBatch);
                 Game1.spriteBatch.End();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 this._farmerShadows.Clear();
                 if (Game1.currentLocation.currentEvent != null && !Game1.currentLocation.currentEvent.isFestival && Game1.currentLocation.currentEvent.farmerActors.Count > 0)
                 {
@@ -555,17 +551,17 @@ namespace StardewModdingAPI.Framework
                         {
                             if (!k.swimming && !k.HideShadow && !k.IsInvisible && !this.checkCharacterTilesForShadowDrawFlag(k))
                             {
-                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, k.GetShadowOffset() + k.Position + new Vector2((float)(k.GetSpriteWidthForPositioning() * 4) / 2f, k.GetBoundingBox().Height + ((!k.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)k.yJumpOffset / 40f) * (float)k.scale), SpriteEffects.None, Math.Max(0f, (float)k.getStandingY() / 10000f) - 1E-06f);
+                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, k.GetShadowOffset() + k.Position + new Vector2((float)(k.GetSpriteWidthForPositioning() * 4) / 2f, k.GetBoundingBox().Height + ((!k.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)k.yJumpOffset / 40f) * (float)k.scale), SpriteEffects.None, Math.Max(0f, (float)k.getStandingY() / 10000f) - 1E-06f);
                             }
                         }
                     }
                     else
                     {
-                        foreach (NPC m in Game1.CurrentEvent.actors)
+                        foreach (NPC l in Game1.CurrentEvent.actors)
                         {
-                            if ((Game1.CurrentEvent == null || !Game1.CurrentEvent.ShouldHideCharacter(m)) && !m.swimming && !m.HideShadow && !this.checkCharacterTilesForShadowDrawFlag(m))
+                            if ((Game1.CurrentEvent == null || !Game1.CurrentEvent.ShouldHideCharacter(l)) && !l.swimming && !l.HideShadow && !this.checkCharacterTilesForShadowDrawFlag(l))
                             {
-                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, m.GetShadowOffset() + m.Position + new Vector2((float)(m.GetSpriteWidthForPositioning() * 4) / 2f, m.GetBoundingBox().Height + ((!m.IsMonster) ? ((m.Sprite.SpriteHeight <= 16) ? (-4) : 12) : 0))), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, 4f + (float)m.yJumpOffset / 40f) * (float)m.scale, SpriteEffects.None, Math.Max(0f, (float)m.getStandingY() / 10000f) - 1E-06f);
+                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, l.GetShadowOffset() + l.Position + new Vector2((float)(l.GetSpriteWidthForPositioning() * 4) / 2f, l.GetBoundingBox().Height + ((!l.IsMonster) ? ((l.Sprite.SpriteHeight <= 16) ? (-4) : 12) : 0))), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, 4f + (float)l.yJumpOffset / 40f) * (float)l.scale, SpriteEffects.None, Math.Max(0f, (float)l.getStandingY() / 10000f) - 1E-06f);
                             }
                         }
                     }
@@ -573,7 +569,7 @@ namespace StardewModdingAPI.Framework
                     {
                         if (!Game1.multiplayer.isDisconnecting(f3.UniqueMultiplayerID) && !f3.swimming && !f3.isRidingHorse() && !f3.IsSitting() && (Game1.currentLocation == null || !this.checkCharacterTilesForShadowDrawFlag(f3)))
                         {
-                            Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(f3.GetShadowOffset() + f3.Position + new Vector2(32f, 24f)), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), 4f - (((f3.running || f3.UsingTool) && f3.FarmerSprite.currentAnimationIndex > 1) ? ((float)Math.Abs(FarmerRenderer.featureYOffsetPerFrame[f3.FarmerSprite.CurrentFrame]) * 0.5f) : 0f), SpriteEffects.None, 0f);
+                            Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(f3.GetShadowOffset() + f3.Position + new Vector2(32f, 24f)), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), 4f - (((f3.running || f3.UsingTool) && f3.FarmerSprite.currentAnimationIndex > 1) ? ((float)Math.Abs(FarmerRenderer.featureYOffsetPerFrame[f3.FarmerSprite.CurrentFrame]) * 0.5f) : 0f), SpriteEffects.None, 0f);
                         }
                     }
                 }
@@ -581,26 +577,26 @@ namespace StardewModdingAPI.Framework
                 building_layer.Draw(Game1.mapDisplayDevice, Game1.viewport, Location.Origin, wrapAround: false, 4);
                 Game1.mapDisplayDevice.EndScene();
                 Game1.spriteBatch.End();
-                Game1.spriteBatch.Begin(SpriteSortMode.FrontToBack, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.FrontToBack, BlendState.AlphaBlend, SamplerState.PointClamp);
                 if (!Game1.currentLocation.shouldHideCharacters())
                 {
                     if (Game1.CurrentEvent == null)
                     {
-                        foreach (NPC n in Game1.currentLocation.characters)
+                        foreach (NPC m in Game1.currentLocation.characters)
                         {
-                            if (!n.swimming && !n.HideShadow && !n.isInvisible && this.checkCharacterTilesForShadowDrawFlag(n))
+                            if (!m.swimming && !m.HideShadow && !m.isInvisible && this.checkCharacterTilesForShadowDrawFlag(m))
                             {
-                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, n.GetShadowOffset() + n.Position + new Vector2((float)(n.GetSpriteWidthForPositioning() * 4) / 2f, n.GetBoundingBox().Height + ((!n.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)n.yJumpOffset / 40f) * (float)n.scale), SpriteEffects.None, Math.Max(0f, (float)n.getStandingY() / 10000f) - 1E-06f);
+                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, m.GetShadowOffset() + m.Position + new Vector2((float)(m.GetSpriteWidthForPositioning() * 4) / 2f, m.GetBoundingBox().Height + ((!m.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)m.yJumpOffset / 40f) * (float)m.scale), SpriteEffects.None, Math.Max(0f, (float)m.getStandingY() / 10000f) - 1E-06f);
                             }
                         }
                     }
                     else
                     {
-                        foreach (NPC n2 in Game1.CurrentEvent.actors)
+                        foreach (NPC n in Game1.CurrentEvent.actors)
                         {
-                            if ((Game1.CurrentEvent == null || !Game1.CurrentEvent.ShouldHideCharacter(n2)) && !n2.swimming && !n2.HideShadow && this.checkCharacterTilesForShadowDrawFlag(n2))
+                            if ((Game1.CurrentEvent == null || !Game1.CurrentEvent.ShouldHideCharacter(n)) && !n.swimming && !n.HideShadow && this.checkCharacterTilesForShadowDrawFlag(n))
                             {
-                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, n2.GetShadowOffset() + n2.Position + new Vector2((float)(n2.GetSpriteWidthForPositioning() * 4) / 2f, n2.GetBoundingBox().Height + ((!n2.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)n2.yJumpOffset / 40f) * (float)n2.scale), SpriteEffects.None, Math.Max(0f, (float)n2.getStandingY() / 10000f) - 1E-06f);
+                                Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(Game1.viewport, n.GetShadowOffset() + n.Position + new Vector2((float)(n.GetSpriteWidthForPositioning() * 4) / 2f, n.GetBoundingBox().Height + ((!n.IsMonster) ? 12 : 0))), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), Math.Max(0f, (4f + (float)n.yJumpOffset / 40f) * (float)n.scale), SpriteEffects.None, Math.Max(0f, (float)n.getStandingY() / 10000f) - 1E-06f);
                             }
                         }
                     }
@@ -609,7 +605,7 @@ namespace StardewModdingAPI.Framework
                         float draw_layer = Math.Max(0.0001f, f4.getDrawLayer() + 0.00011f) - 0.0001f;
                         if (!f4.swimming && !f4.isRidingHorse() && !f4.IsSitting() && Game1.currentLocation != null && this.checkCharacterTilesForShadowDrawFlag(f4))
                         {
-                            Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(f4.GetShadowOffset() + f4.Position + new Vector2(32f, 24f)), Game1.shadowTexture.Bounds, Microsoft.Xna.Framework.Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), 4f - (((f4.running || f4.UsingTool) && f4.FarmerSprite.currentAnimationIndex > 1) ? ((float)Math.Abs(FarmerRenderer.featureYOffsetPerFrame[f4.FarmerSprite.CurrentFrame]) * 0.5f) : 0f), SpriteEffects.None, draw_layer);
+                            Game1.spriteBatch.Draw(Game1.shadowTexture, Game1.GlobalToLocal(f4.GetShadowOffset() + f4.Position + new Vector2(32f, 24f)), Game1.shadowTexture.Bounds, Color.White, 0f, new Vector2(Game1.shadowTexture.Bounds.Center.X, Game1.shadowTexture.Bounds.Center.Y), 4f - (((f4.running || f4.UsingTool) && f4.FarmerSprite.currentAnimationIndex > 1) ? ((float)Math.Abs(FarmerRenderer.featureYOffsetPerFrame[f4.FarmerSprite.CurrentFrame]) * 0.5f) : 0f), SpriteEffects.None, draw_layer);
                         }
                     }
                 }
@@ -619,7 +615,7 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.player.currentUpgrade != null && Game1.player.currentUpgrade.daysLeftTillUpgradeDone <= 3 && Game1.currentLocation.Name.Equals("Farm"))
                 {
-                    Game1.spriteBatch.Draw(Game1.player.currentUpgrade.workerTexture, Game1.GlobalToLocal(Game1.viewport, Game1.player.currentUpgrade.positionOfCarpenter), Game1.player.currentUpgrade.getSourceRectangle(), Microsoft.Xna.Framework.Color.White, 0f, Vector2.Zero, 1f, SpriteEffects.None, (Game1.player.currentUpgrade.positionOfCarpenter.Y + 48f) / 10000f);
+                    Game1.spriteBatch.Draw(Game1.player.currentUpgrade.workerTexture, Game1.GlobalToLocal(Game1.viewport, Game1.player.currentUpgrade.positionOfCarpenter), Game1.player.currentUpgrade.getSourceRectangle(), Color.White, 0f, Vector2.Zero, 1f, SpriteEffects.None, (Game1.player.currentUpgrade.positionOfCarpenter.Y + 48f) / 10000f);
                 }
                 Game1.currentLocation.draw(Game1.spriteBatch);
                 foreach (Vector2 tile_position in Game1.crabPotOverlayTiles.Keys)
@@ -646,14 +642,14 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.tvStation >= 0)
                 {
-                    Game1.spriteBatch.Draw(Game1.tvStationTexture, Game1.GlobalToLocal(Game1.viewport, new Vector2(400f, 160f)), new Microsoft.Xna.Framework.Rectangle(Game1.tvStation * 24, 0, 24, 15), Microsoft.Xna.Framework.Color.White, 0f, Vector2.Zero, 4f, SpriteEffects.None, 1E-08f);
+                    Game1.spriteBatch.Draw(Game1.tvStationTexture, Game1.GlobalToLocal(Game1.viewport, new Vector2(400f, 160f)), new Microsoft.Xna.Framework.Rectangle(Game1.tvStation * 24, 0, 24, 15), Color.White, 0f, Vector2.Zero, 4f, SpriteEffects.None, 1E-08f);
                 }
                 if (Game1.panMode)
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle((int)Math.Floor((double)(Game1.getOldMouseX() + Game1.viewport.X) / 64.0) * 64 - Game1.viewport.X, (int)Math.Floor((double)(Game1.getOldMouseY() + Game1.viewport.Y) / 64.0) * 64 - Game1.viewport.Y, 64, 64), Microsoft.Xna.Framework.Color.Lime * 0.75f);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle((int)Math.Floor((double)(Game1.getOldMouseX() + Game1.viewport.X) / 64.0) * 64 - Game1.viewport.X, (int)Math.Floor((double)(Game1.getOldMouseY() + Game1.viewport.Y) / 64.0) * 64 - Game1.viewport.Y, 64, 64), Color.Lime * 0.75f);
                     foreach (Warp w in Game1.currentLocation.warps)
                     {
-                        Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(w.X * 64 - Game1.viewport.X, w.Y * 64 - Game1.viewport.Y, 64, 64), Microsoft.Xna.Framework.Color.Red * 0.75f);
+                        Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(w.X * 64 - Game1.viewport.X, w.Y * 64 - Game1.viewport.Y, 64, 64), Color.Red * 0.75f);
                     }
                 }
                 Game1.mapDisplayDevice.BeginScene(Game1.spriteBatch);
@@ -661,7 +657,7 @@ namespace StardewModdingAPI.Framework
                 Game1.mapDisplayDevice.EndScene();
                 Game1.currentLocation.drawAboveFrontLayer(Game1.spriteBatch);
                 Game1.spriteBatch.End();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 if (Game1.currentLocation.Map.GetLayer("AlwaysFront") != null)
                 {
                     Game1.mapDisplayDevice.BeginScene(Game1.spriteBatch);
@@ -670,7 +666,7 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.toolHold > 400f && Game1.player.CurrentTool.UpgradeLevel >= 1 && Game1.player.canReleaseTool)
                 {
-                    Microsoft.Xna.Framework.Color barColor = Microsoft.Xna.Framework.Color.White;
+                    Color barColor = Color.White;
                     switch ((int)(Game1.toolHold / 600f) + 2)
                     {
                         case 1:
@@ -686,7 +682,7 @@ namespace StardewModdingAPI.Framework
                             barColor = Tool.iridiumColor;
                             break;
                     }
-                    Game1.spriteBatch.Draw(Game1.littleEffect, new Microsoft.Xna.Framework.Rectangle((int)Game1.player.getLocalPosition(Game1.viewport).X - 2, (int)Game1.player.getLocalPosition(Game1.viewport).Y - ((!Game1.player.CurrentTool.Name.Equals("Watering Can")) ? 64 : 0) - 2, (int)(Game1.toolHold % 600f * 0.08f) + 4, 12), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.littleEffect, new Microsoft.Xna.Framework.Rectangle((int)Game1.player.getLocalPosition(Game1.viewport).X - 2, (int)Game1.player.getLocalPosition(Game1.viewport).Y - ((!Game1.player.CurrentTool.Name.Equals("Watering Can")) ? 64 : 0) - 2, (int)(Game1.toolHold % 600f * 0.08f) + 4, 12), Color.Black);
                     Game1.spriteBatch.Draw(Game1.littleEffect, new Microsoft.Xna.Framework.Rectangle((int)Game1.player.getLocalPosition(Game1.viewport).X, (int)Game1.player.getLocalPosition(Game1.viewport).Y - ((!Game1.player.CurrentTool.Name.Equals("Watering Can")) ? 64 : 0), (int)(Game1.toolHold % 600f * 0.08f), 8), barColor);
                 }
                 if (!Game1.IsFakedBlackScreen())
@@ -699,7 +695,7 @@ namespace StardewModdingAPI.Framework
                 }
                 if (Game1.currentLocation.LightLevel > 0f && Game1.timeOfDay < 2000)
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.Black * Game1.currentLocation.LightLevel);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.Black * Game1.currentLocation.LightLevel);
                 }
                 if (Game1.screenGlow)
                 {
@@ -711,51 +707,51 @@ namespace StardewModdingAPI.Framework
                     Game1.player.CurrentTool.draw(Game1.spriteBatch);
                 }
                 Game1.spriteBatch.End();
-                Game1.spriteBatch.Begin(SpriteSortMode.FrontToBack, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.FrontToBack, BlendState.AlphaBlend, SamplerState.PointClamp);
                 if (Game1.eventUp && Game1.currentLocation.currentEvent != null)
                 {
-                    foreach (NPC l in Game1.currentLocation.currentEvent.actors)
+                    foreach (NPC n2 in Game1.currentLocation.currentEvent.actors)
                     {
-                        if (l.isEmoting)
+                        if (n2.isEmoting)
                         {
-                            Vector2 emotePosition = l.getLocalPosition(Game1.viewport);
-                            if (l.NeedsBirdieEmoteHack())
+                            Vector2 emotePosition = n2.getLocalPosition(Game1.viewport);
+                            if (n2.NeedsBirdieEmoteHack())
                             {
                                 emotePosition.X += 64f;
                             }
                             emotePosition.Y -= 140f;
-                            if (l.Age == 2)
+                            if (n2.Age == 2)
                             {
                                 emotePosition.Y += 32f;
                             }
-                            else if (l.Gender == 1)
+                            else if (n2.Gender == 1)
                             {
                                 emotePosition.Y += 10f;
                             }
-                            Game1.spriteBatch.Draw(Game1.emoteSpriteSheet, emotePosition, new Microsoft.Xna.Framework.Rectangle(l.CurrentEmoteIndex * 16 % Game1.emoteSpriteSheet.Width, l.CurrentEmoteIndex * 16 / Game1.emoteSpriteSheet.Width * 16, 16, 16), Microsoft.Xna.Framework.Color.White, 0f, Vector2.Zero, 4f, SpriteEffects.None, (float)l.getStandingY() / 10000f);
+                            Game1.spriteBatch.Draw(Game1.emoteSpriteSheet, emotePosition, new Microsoft.Xna.Framework.Rectangle(n2.CurrentEmoteIndex * 16 % Game1.emoteSpriteSheet.Width, n2.CurrentEmoteIndex * 16 / Game1.emoteSpriteSheet.Width * 16, 16, 16), Color.White, 0f, Vector2.Zero, 4f, SpriteEffects.None, (float)n2.getStandingY() / 10000f);
                         }
                     }
                 }
                 Game1.spriteBatch.End();
                 if (Game1.drawLighting && !Game1.IsFakedBlackScreen())
                 {
-                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, this.lightingBlend, SamplerState.LinearClamp, null, null);
+                    Game1.spriteBatch.Begin(SpriteSortMode.Deferred, this.lightingBlend, SamplerState.LinearClamp);
                     Viewport vp = base.GraphicsDevice.Viewport;
-                    vp.Bounds = (target_screen?.Bounds ?? base.GraphicsDevice.PresentationParameters.Bounds);
+                    vp.Bounds = target_screen?.Bounds ?? base.GraphicsDevice.PresentationParameters.Bounds;
                     base.GraphicsDevice.Viewport = vp;
                     float render_zoom = Game1.options.lightingQuality / 2;
                     if (this.useUnscaledLighting)
                     {
                         render_zoom /= Game1.options.zoomLevel;
                     }
-                    Game1.spriteBatch.Draw(Game1.lightmap, Vector2.Zero, Game1.lightmap.Bounds, Microsoft.Xna.Framework.Color.White, 0f, Vector2.Zero, render_zoom, SpriteEffects.None, 1f);
+                    Game1.spriteBatch.Draw(Game1.lightmap, Vector2.Zero, Game1.lightmap.Bounds, Color.White, 0f, Vector2.Zero, render_zoom, SpriteEffects.None, 1f);
                     if (Game1.IsRainingHere() && (bool)Game1.currentLocation.isOutdoors && !(Game1.currentLocation is Desert))
                     {
-                        Game1.spriteBatch.Draw(Game1.staminaRect, vp.Bounds, Microsoft.Xna.Framework.Color.OrangeRed * 0.45f);
+                        Game1.spriteBatch.Draw(Game1.staminaRect, vp.Bounds, Color.OrangeRed * 0.45f);
                     }
                     Game1.spriteBatch.End();
                 }
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 events.RenderedWorld.RaiseEmpty();
                 if (Game1.drawGrid)
                 {
@@ -763,11 +759,11 @@ namespace StardewModdingAPI.Framework
                     float startingY = -Game1.viewport.Y % 64;
                     for (int x = startingX; x < Game1.graphics.GraphicsDevice.Viewport.Width; x += 64)
                     {
-                        Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(x, (int)startingY, 1, Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Red * 0.5f);
+                        Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(x, (int)startingY, 1, Game1.graphics.GraphicsDevice.Viewport.Height), Color.Red * 0.5f);
                     }
                     for (float y = startingY; y < (float)Game1.graphics.GraphicsDevice.Viewport.Height; y += 64f)
                     {
-                        Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(startingX, (int)y, Game1.graphics.GraphicsDevice.Viewport.Width, 1), Microsoft.Xna.Framework.Color.Red * 0.5f);
+                        Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle(startingX, (int)y, Game1.graphics.GraphicsDevice.Viewport.Width, 1), Color.Red * 0.5f);
                     }
                 }
                 if (Game1.ShouldShowOnscreenUsernames() && Game1.currentLocation != null)
@@ -780,14 +776,14 @@ namespace StardewModdingAPI.Framework
                 }
                 if (!Game1.eventUp && Game1.farmEvent == null && Game1.currentBillboard == 0 && Game1.gameMode == 3 && !this.takingMapScreenshot && Game1.isOutdoorMapSmallerThanViewport())
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, -Math.Min(Game1.viewport.X, GameRunner.MaxTextureSize), Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64, 0, Math.Min(GameRunner.MaxTextureSize, Game1.graphics.GraphicsDevice.Viewport.Width - (-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64)), Game1.graphics.GraphicsDevice.Viewport.Height), Microsoft.Xna.Framework.Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, Game1.graphics.GraphicsDevice.Viewport.Width, -Math.Min(Game1.viewport.Y, GameRunner.MaxTextureSize)), Microsoft.Xna.Framework.Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, -Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64, Game1.graphics.GraphicsDevice.Viewport.Width, Math.Min(GameRunner.MaxTextureSize, Game1.graphics.GraphicsDevice.Viewport.Height - (-Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64))), Microsoft.Xna.Framework.Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, -Math.Min(Game1.viewport.X, GameRunner.MaxTextureSize), Game1.graphics.GraphicsDevice.Viewport.Height), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64, 0, Math.Min(GameRunner.MaxTextureSize, Game1.graphics.GraphicsDevice.Viewport.Width - (-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64)), Game1.graphics.GraphicsDevice.Viewport.Height), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, Game1.graphics.GraphicsDevice.Viewport.Width, -Math.Min(Game1.viewport.Y, GameRunner.MaxTextureSize)), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, -Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64, Game1.graphics.GraphicsDevice.Viewport.Width, Math.Min(GameRunner.MaxTextureSize, Game1.graphics.GraphicsDevice.Viewport.Height - (-Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64))), Color.Black);
                 }
                 Game1.spriteBatch.End();
                 Game1.PushUIMode();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 if ((Game1.displayHUD || Game1.eventUp) && Game1.currentBillboard == 0 && Game1.gameMode == 3 && !Game1.freezeControls && !Game1.panMode && !Game1.HostPaused && !this.takingMapScreenshot)
                 {
                     events.RenderingHud.RaiseEmpty();
@@ -807,13 +803,13 @@ namespace StardewModdingAPI.Framework
                 }
                 Game1.spriteBatch.End();
                 Game1.PopUIMode();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
             }
             if (Game1.farmEvent != null)
             {
                 Game1.farmEvent.draw(Game1.spriteBatch);
                 Game1.spriteBatch.End();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
             }
             Game1.PushUIMode();
             if (Game1.dialogueUp && !Game1.nameSelectUp && !Game1.messagePause && (Game1.activeClickableMenu == null || !(Game1.activeClickableMenu is DialogueBox)) && !this.takingMapScreenshot)
@@ -822,35 +818,35 @@ namespace StardewModdingAPI.Framework
             }
             if (Game1.progressBar && !this.takingMapScreenshot)
             {
-                Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle((Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Width - Game1.dialogueWidth) / 2, Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Bottom - 128, Game1.dialogueWidth, 32), Microsoft.Xna.Framework.Color.LightGray);
-                Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle((Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Width - Game1.dialogueWidth) / 2, Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Bottom - 128, (int)(Game1.pauseAccumulator / Game1.pauseTime * (float)Game1.dialogueWidth), 32), Microsoft.Xna.Framework.Color.DimGray);
+                Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle((Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Width - Game1.dialogueWidth) / 2, Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Bottom - 128, Game1.dialogueWidth, 32), Color.LightGray);
+                Game1.spriteBatch.Draw(Game1.staminaRect, new Microsoft.Xna.Framework.Rectangle((Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Width - Game1.dialogueWidth) / 2, Game1.graphics.GraphicsDevice.Viewport.GetTitleSafeArea().Bottom - 128, (int)(Game1.pauseAccumulator / Game1.pauseTime * (float)Game1.dialogueWidth), 32), Color.DimGray);
             }
             Game1.spriteBatch.End();
             Game1.PopUIMode();
-            Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+            Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
             if (Game1.eventUp && Game1.currentLocation != null && Game1.currentLocation.currentEvent != null)
             {
                 Game1.currentLocation.currentEvent.drawAfterMap(Game1.spriteBatch);
             }
             if (!Game1.IsFakedBlackScreen() && Game1.IsRainingHere() && Game1.currentLocation != null && (bool)Game1.currentLocation.isOutdoors && !(Game1.currentLocation is Desert))
             {
-                Game1.spriteBatch.Draw(Game1.staminaRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.Blue * 0.2f);
+                Game1.spriteBatch.Draw(Game1.staminaRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.Blue * 0.2f);
             }
             if ((Game1.fadeToBlack || Game1.globalFade) && !Game1.menuUp && (!Game1.nameSelectUp || Game1.messagePause) && !this.takingMapScreenshot)
             {
                 Game1.spriteBatch.End();
                 Game1.PushUIMode();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
-                Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.Black * ((Game1.gameMode == 0) ? (1f - Game1.fadeToBlackAlpha) : Game1.fadeToBlackAlpha));
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
+                Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.Black * ((Game1.gameMode == 0) ? (1f - Game1.fadeToBlackAlpha) : Game1.fadeToBlackAlpha));
                 Game1.spriteBatch.End();
                 Game1.PopUIMode();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
             }
             else if (Game1.flashAlpha > 0f && !this.takingMapScreenshot)
             {
                 if (Game1.options.screenFlash)
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Microsoft.Xna.Framework.Color.White * Math.Min(1f, Game1.flashAlpha));
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, Game1.graphics.GraphicsDevice.Viewport.Bounds, Color.White * Math.Min(1f, Game1.flashAlpha));
                 }
                 Game1.flashAlpha -= 0.1f;
             }
@@ -866,14 +862,14 @@ namespace StardewModdingAPI.Framework
                 }
                 Game1.spriteBatch.End();
                 Game1.PushUIMode();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
                 foreach (TemporaryAnimatedSprite uiOverlayTempSprite in Game1.uiOverlayTempSprites)
                 {
                     uiOverlayTempSprite.draw(Game1.spriteBatch, localPosition: true);
                 }
                 Game1.spriteBatch.End();
                 Game1.PopUIMode();
-                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+                Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
             }
             if (Game1.debugMode)
             {
@@ -905,14 +901,14 @@ namespace StardewModdingAPI.Framework
                 sb.Append(Game1.getMouseY() + Game1.viewport.Y);
                 sb.Append("  debugOutput: ");
                 sb.Append(Game1.debugOutput);
-                Game1.spriteBatch.DrawString(Game1.smallFont, sb, new Vector2(base.GraphicsDevice.Viewport.GetTitleSafeArea().X, base.GraphicsDevice.Viewport.GetTitleSafeArea().Y + Game1.smallFont.LineSpacing * 8), Microsoft.Xna.Framework.Color.Red, 0f, Vector2.Zero, 1f, SpriteEffects.None, 0.9999999f);
+                Game1.spriteBatch.DrawString(Game1.smallFont, sb, new Vector2(base.GraphicsDevice.Viewport.GetTitleSafeArea().X, base.GraphicsDevice.Viewport.GetTitleSafeArea().Y + Game1.smallFont.LineSpacing * 8), Color.Red, 0f, Vector2.Zero, 1f, SpriteEffects.None, 0.9999999f);
             }
             Game1.spriteBatch.End();
             Game1.PushUIMode();
-            Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
+            Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp);
             if (Game1.showKeyHelp && !this.takingMapScreenshot)
             {
-                Game1.spriteBatch.DrawString(Game1.smallFont, Game1.keyHelpString, new Vector2(64f, (float)(Game1.viewport.Height - 64 - (Game1.dialogueUp ? (192 + (Game1.isQuestion ? (Game1.questionChoices.Count * 64) : 0)) : 0)) - Game1.smallFont.MeasureString(Game1.keyHelpString).Y), Microsoft.Xna.Framework.Color.LightGray, 0f, Vector2.Zero, 1f, SpriteEffects.None, 0.9999999f);
+                Game1.spriteBatch.DrawString(Game1.smallFont, Game1.keyHelpString, new Vector2(64f, (float)(Game1.viewport.Height - 64 - (Game1.dialogueUp ? (192 + (Game1.isQuestion ? (Game1.questionChoices.Count * 64) : 0)) : 0)) - Game1.smallFont.MeasureString(Game1.keyHelpString).Y), Color.LightGray, 0f, Vector2.Zero, 1f, SpriteEffects.None, 0.9999999f);
             }
             if (Game1.activeClickableMenu != null && !this.takingMapScreenshot)
             {

From e16d6e98dca581754023a618b3abe603e7905f44 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:11 -0400
Subject: [PATCH 326/856] update to .NET 5 build of Harmony 2.1.0

---
 build/0Harmony.dll | Bin 166912 -> 167424 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/build/0Harmony.dll b/build/0Harmony.dll
index bab3bb4d1375bde11b88013653d36bdad5ebab14..91d36ea25de3ab3e6d9db9fccb11d7f9fe5ede6e 100644
GIT binary patch
delta 50537
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
HLrnhzBS{&(

delta 50511
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


From 3a3688e09448b95f8b412154de743df6b2297fe9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:12 -0400
Subject: [PATCH 327/856] use new mod hooks to synchronize tasks

---
 src/SMAPI/Framework/SCore.cs     | 12 ++----------
 src/SMAPI/Framework/SModHooks.cs | 30 +++++++++++++++++++++++++++++-
 2 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 95a7ace6..947284a8 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -11,7 +11,6 @@ using System.Runtime.ExceptionServices;
 using System.Security;
 using System.Text;
 using System.Threading;
-using System.Threading.Tasks;
 using Microsoft.Xna.Framework;
 #if SMAPI_FOR_WINDOWS
 using Microsoft.Win32;
@@ -236,7 +235,7 @@ namespace StardewModdingAPI.Framework
                     monitor: this.Monitor,
                     reflection: this.Reflection,
                     eventManager: this.EventManager,
-                    modHooks: new SModHooks(this.OnNewDayAfterFade),
+                    modHooks: new SModHooks(this.OnNewDayAfterFade, this.Monitor),
                     multiplayer: this.Multiplayer,
                     exitGameImmediately: this.ExitGameImmediately,
 
@@ -650,13 +649,6 @@ namespace StardewModdingAPI.Framework
                     this.Monitor.Log("Game loader done.");
                 }
 
-                if (instance.NewDayTask?.Status == TaskStatus.Created)
-                {
-                    this.Monitor.Log("New day task synchronizing...");
-                    instance.NewDayTask.RunSynchronously();
-                    this.Monitor.Log("New day task done.");
-                }
-
                 // While a background task is in progress, the game may make changes to the game
                 // state while mods are running their code. This is risky, because data changes can
                 // conflict (e.g. collection changed during enumeration errors) and data may change
@@ -666,7 +658,7 @@ namespace StardewModdingAPI.Framework
                 // a small chance that the task will finish after we defer but before the game checks,
                 // which means technically events should be raised, but the effects of missing one
                 // update tick are negligible and not worth the complications of bypassing Game1.Update.
-                if (instance.NewDayTask != null || Game1.gameMode == Game1.loadingMode)
+                if (Game1.gameMode == Game1.loadingMode)
                 {
                     events.UnvalidatedUpdateTicking.RaiseEmpty();
                     runUpdate();
diff --git a/src/SMAPI/Framework/SModHooks.cs b/src/SMAPI/Framework/SModHooks.cs
index 7dafc746..101e022a 100644
--- a/src/SMAPI/Framework/SModHooks.cs
+++ b/src/SMAPI/Framework/SModHooks.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Threading.Tasks;
 using StardewValley;
 
 namespace StardewModdingAPI.Framework
@@ -12,15 +13,20 @@ namespace StardewModdingAPI.Framework
         /// <summary>A callback to invoke before <see cref="Game1.newDayAfterFade"/> runs.</summary>
         private readonly Action BeforeNewDayAfterFade;
 
+        /// <summary>Writes messages to the console.</summary>
+        private readonly IMonitor Monitor;
+
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="beforeNewDayAfterFade">A callback to invoke before <see cref="Game1.newDayAfterFade"/> runs.</param>
-        public SModHooks(Action beforeNewDayAfterFade)
+        /// <param name="monitor">Writes messages to the console.</param>
+        public SModHooks(Action beforeNewDayAfterFade, IMonitor monitor)
         {
             this.BeforeNewDayAfterFade = beforeNewDayAfterFade;
+            this.Monitor = monitor;
         }
 
         /// <summary>A hook invoked when <see cref="Game1.newDayAfterFade"/> is called.</summary>
@@ -30,5 +36,27 @@ namespace StardewModdingAPI.Framework
             this.BeforeNewDayAfterFade?.Invoke();
             action();
         }
+
+        /// <summary>Start an asynchronous task for the game.</summary>
+        /// <param name="task">The task to start.</param>
+        /// <param name="id">A unique key which identifies the task.</param>
+        public override Task StartTask(Task task, string id)
+        {
+            this.Monitor.Log($"Synchronizing '{id}' task...");
+            task.RunSynchronously();
+            this.Monitor.Log("   task complete.");
+            return task;
+        }
+
+        /// <summary>Start an asynchronous task for the game.</summary>
+        /// <param name="task">The task to start.</param>
+        /// <param name="id">A unique key which identifies the task.</param>
+        public override Task<T> StartTask<T>(Task<T> task, string id)
+        {
+            this.Monitor.Log($"Synchronizing '{id}' task...");
+            task.RunSynchronously();
+            this.Monitor.Log("   task complete.");
+            return task;
+        }
     }
 }

From e10a7858a0f3720dca1caf3e0f17db720bd69965 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 Aug 2021 21:26:12 -0400
Subject: [PATCH 328/856] fix error reading console title on Linux with .NET 5

The console title is now write-only on Linux.
---
 src/SMAPI/Program.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 3e2213ba..0417697b 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -25,7 +25,7 @@ namespace StardewModdingAPI
         /// <param name="args">The command-line arguments.</param>
         public static void Main(string[] args)
         {
-            Console.Title = $"SMAPI {EarlyConstants.RawApiVersion} - {Console.Title}";
+            Console.Title = $"SMAPI {EarlyConstants.RawApiVersion}";
 
             try
             {

From 897edd7ff0c4a69289330e086b9b03e7a756b15c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 13 Aug 2021 18:56:59 -0400
Subject: [PATCH 329/856] update for accessibility change in Stardew Valley
 1.5.5

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 7efd99a0..1780b280 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -226,13 +226,8 @@ namespace StardewModdingAPI.Metadata
                 ** Buildings
                 ****/
                 case "buildings\\houses": // Farm
-                    {
-                        var field = reflection.GetField<Texture2D>(typeof(Farm), nameof(Farm.houseTextures));
-                        field.SetValue(
-                            this.LoadAndDisposeIfNeeded(field.GetValue(), key)
-                        );
-                        return true;
-                    }
+                    Farm.houseTextures = this.LoadAndDisposeIfNeeded(Farm.houseTextures, key);
+                    return true;
 
                 case "buildings\\houses_paintmask": // Farm
                     {

From ce80c68135b08fea7caaa9581b3c4eba61c3ec65 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 16 Aug 2021 19:43:55 -0400
Subject: [PATCH 330/856] fix segfault on Linux/macOS after .NET 5 update

Harmony doesn't seem to support tiered compilation on Linux/macOS, but the vanilla game disables that too anyway. The bundled runtimeconfig files match the ones used by the vanilla game. Thanks to 0x0ade for identifying the cause!
---
 build/prepare-install-package.targets              |  3 ++-
 src/SMAPI.Installer/assets/runtimeconfig.unix.json | 14 ++++++++++++++
 .../assets/runtimeconfig.windows.json              | 12 ++++++++++++
 3 files changed, 28 insertions(+), 1 deletion(-)
 create mode 100644 src/SMAPI.Installer/assets/runtimeconfig.unix.json
 create mode 100644 src/SMAPI.Installer/assets/runtimeconfig.windows.json

diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index bc1716a3..21b02b87 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -36,13 +36,14 @@
     <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on macOS.command" />
     <Copy SourceFiles="$(TargetDir)\assets\windows-install.bat" DestinationFiles="$(PackagePath)\install on Windows.bat" />
     <Copy SourceFiles="$(TargetDir)\assets\README.txt" DestinationFolder="$(PackagePath)" />
+    <Copy SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\internal\windows-install.exe.config" Condition="$(PlatformName) == 'windows'" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(PackagePath)\internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install.exe" Condition="$(PlatformName) == 'windows'" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName)" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install" Condition="$(PlatformName) != 'windows'" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).runtimeconfig.json" DestinationFolder="$(PackagePath)\internal" />
-    <Copy SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install.exe.config" Condition="$(PlatformName) == 'windows'" />
 
     <!--copy bundle files-->
+    <Copy SourceFiles="$(TargetDir)\assets\runtimeconfig.$(PlatformName).json" DestinationFiles="$(PackagePath)\bundle\StardewModdingAPI.runtimeconfig.json" />
     <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.dll" DestinationFolder="$(PackagePath)\bundle" />
     <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.exe" DestinationFolder="$(PackagePath)\bundle" Condition="$(PlatformName) == 'windows'" />
     <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI" DestinationFolder="$(PackagePath)\bundle" Condition="$(PlatformName) != 'windows'" />
diff --git a/src/SMAPI.Installer/assets/runtimeconfig.unix.json b/src/SMAPI.Installer/assets/runtimeconfig.unix.json
new file mode 100644
index 00000000..8a01ceb1
--- /dev/null
+++ b/src/SMAPI.Installer/assets/runtimeconfig.unix.json
@@ -0,0 +1,14 @@
+{
+    "runtimeOptions": {
+        "tfm": "net5.0",
+        "includedFrameworks": [
+            {
+                "name": "Microsoft.NETCore.App",
+                "version": "5.0.7"
+            }
+        ],
+        "configProperties": {
+            "System.Runtime.TieredCompilation": false
+        }
+    }
+}
diff --git a/src/SMAPI.Installer/assets/runtimeconfig.windows.json b/src/SMAPI.Installer/assets/runtimeconfig.windows.json
new file mode 100644
index 00000000..b693d809
--- /dev/null
+++ b/src/SMAPI.Installer/assets/runtimeconfig.windows.json
@@ -0,0 +1,12 @@
+{
+    "runtimeOptions": {
+        "tfm": "net5.0",
+        "framework": {
+            "name": "Microsoft.NETCore.App",
+            "version": "5.0.0"
+        },
+        "configProperties": {
+            "System.Runtime.TieredCompilation": false
+        }
+    }
+}

From f6479ea2b61ebcc4eda434d7d5cb664534a99801 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 17 Aug 2021 16:42:04 -0400
Subject: [PATCH 331/856] restructure installer for .NET 5 changes

---
 build/prepare-install-package.targets          | 14 +++++++-------
 src/SMAPI.Installer/Program.cs                 |  3 +--
 src/SMAPI.Installer/assets/README.txt          |  2 +-
 src/SMAPI.Installer/assets/unix-install.sh     |  2 +-
 src/SMAPI.Installer/assets/windows-install.bat |  2 +-
 5 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index 21b02b87..dd28266d 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -36,11 +36,11 @@
     <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on macOS.command" />
     <Copy SourceFiles="$(TargetDir)\assets\windows-install.bat" DestinationFiles="$(PackagePath)\install on Windows.bat" />
     <Copy SourceFiles="$(TargetDir)\assets\README.txt" DestinationFolder="$(PackagePath)" />
-    <Copy SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\internal\windows-install.exe.config" Condition="$(PlatformName) == 'windows'" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(PackagePath)\internal" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install.exe" Condition="$(PlatformName) == 'windows'" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName)" DestinationFiles="$(PackagePath)\internal\$(PlatformName)-install" Condition="$(PlatformName) != 'windows'" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).runtimeconfig.json" DestinationFolder="$(PackagePath)\internal" />
+    <Copy SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\internal\$(PlatformName)\install.exe.config" Condition="$(PlatformName) == 'windows'" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(PackagePath)\internal\$(PlatformName)" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFiles="$(PackagePath)\internal\$(PlatformName)\install.exe" Condition="$(PlatformName) == 'windows'" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName)" DestinationFiles="$(PackagePath)\internal\$(PlatformName)\install" Condition="$(PlatformName) != 'windows'" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).runtimeconfig.json" DestinationFolder="$(PackagePath)\internal\$(PlatformName)" />
 
     <!--copy bundle files-->
     <Copy SourceFiles="$(TargetDir)\assets\runtimeconfig.$(PlatformName).json" DestinationFiles="$(PackagePath)\bundle\StardewModdingAPI.runtimeconfig.json" />
@@ -99,12 +99,12 @@
       <PackageFiles Include="$(PackagePath)\**\*.*" />
     </ItemGroup>
     <Copy SourceFiles="@(PackageFiles)" DestinationFolder="$(PackageDevPath)\%(RecursiveDir)" />
-    <ZipDirectory SourceDirectory="$(PackageDevPath)\bundle" DestinationFile="$(PackageDevPath)\internal\$(PlatformName)-install.dat" />
+    <ZipDirectory SourceDirectory="$(PackageDevPath)\bundle" DestinationFile="$(PackageDevPath)\internal\$(PlatformName)\install.dat" />
     <RemoveDir Directories="$(PackageDevPath)\bundle" />
 
     <!-- finalise normal installer -->
     <ReplaceFileText FilePath="$(PackagePath)\bundle\smapi-internal\config.json" Search="&quot;DeveloperMode&quot;: true" Replace="&quot;DeveloperMode&quot;: false" />
-    <ZipDirectory SourceDirectory="$(PackagePath)\bundle" DestinationFile="$(PackagePath)\internal\$(PlatformName)-install.dat" />
+    <ZipDirectory SourceDirectory="$(PackagePath)\bundle" DestinationFile="$(PackagePath)\internal\$(PlatformName)\install.dat" />
     <RemoveDir Directories="$(PackagePath)\bundle" />
   </Target>
 
diff --git a/src/SMAPI.Installer/Program.cs b/src/SMAPI.Installer/Program.cs
index d9c31dd6..45cfea75 100644
--- a/src/SMAPI.Installer/Program.cs
+++ b/src/SMAPI.Installer/Program.cs
@@ -31,8 +31,7 @@ namespace StardewModdingApi.Installer
         public static void Main(string[] args)
         {
             // find install bundle
-            PlatformID platform = Environment.OSVersion.Platform;
-            FileInfo zipFile = new FileInfo(Path.Combine(Program.InstallerPath, $"{(platform == PlatformID.Win32NT ? "windows" : "unix")}-install.dat"));
+            FileInfo zipFile = new FileInfo(Path.Combine(Program.InstallerPath, "install.dat"));
             if (!zipFile.Exists)
             {
                 Console.WriteLine($"Oops! Some of the installer files are missing; try re-downloading the installer. (Missing file: {zipFile.FullName})");
diff --git a/src/SMAPI.Installer/assets/README.txt b/src/SMAPI.Installer/assets/README.txt
index c3a7e271..5c20529a 100644
--- a/src/SMAPI.Installer/assets/README.txt
+++ b/src/SMAPI.Installer/assets/README.txt
@@ -24,7 +24,7 @@ Manual install
 THIS IS NOT RECOMMENDED FOR MOST PLAYERS. See instructions above instead.
 If you really want to install SMAPI manually, here's how.
 
-1. Unzip "internal/windows-install.dat" (on Windows) or "internal/unix-install.dat" (on
+1. Unzip "internal/windows/install.dat" (on Windows) or "internal/unix/install.dat" (on
    Linux/macOS). You can change '.dat' to '.zip', it's just a normal zip file renamed to prevent
    confusion.
 2. Copy the files from the folder you just unzipped into your game folder. The
diff --git a/src/SMAPI.Installer/assets/unix-install.sh b/src/SMAPI.Installer/assets/unix-install.sh
index a830a22d..f5de7b16 100644
--- a/src/SMAPI.Installer/assets/unix-install.sh
+++ b/src/SMAPI.Installer/assets/unix-install.sh
@@ -7,4 +7,4 @@ cd "`dirname "$0"`"
 export TERM=xterm
 
 # run installer
-./internal/unix-install
+./internal/unix/install
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index 2cd98554..3ca13528 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -4,5 +4,5 @@ if not errorlevel 1 (
    echo Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first.
    pause
 ) else (
-   start /WAIT /B internal\windows-install.exe
+   start /WAIT /B internal\windows\install.exe
 )

From 7c5c63d6846d93f772dfda37f394b5f501f49f25 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 17 Aug 2021 20:11:30 -0400
Subject: [PATCH 332/856] fix SMAPI not working on macOS, improve installer
 validation

---
 build/prepare-install-package.targets         |  2 --
 src/SMAPI.Installer/assets/unix-install.sh    | 10 ++++--
 src/SMAPI.Installer/assets/unix-launcher.sh   | 36 +++++++++++++++++--
 .../assets/windows-install.bat                | 29 ++++++++++++---
 4 files changed, 65 insertions(+), 12 deletions(-)

diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
index dd28266d..ef5624ad 100644
--- a/build/prepare-install-package.targets
+++ b/build/prepare-install-package.targets
@@ -38,8 +38,6 @@
     <Copy SourceFiles="$(TargetDir)\assets\README.txt" DestinationFolder="$(PackagePath)" />
     <Copy SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\internal\$(PlatformName)\install.exe.config" Condition="$(PlatformName) == 'windows'" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(PackagePath)\internal\$(PlatformName)" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFiles="$(PackagePath)\internal\$(PlatformName)\install.exe" Condition="$(PlatformName) == 'windows'" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName)" DestinationFiles="$(PackagePath)\internal\$(PlatformName)\install" Condition="$(PlatformName) != 'windows'" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).runtimeconfig.json" DestinationFolder="$(PackagePath)\internal\$(PlatformName)" />
 
     <!--copy bundle files-->
diff --git a/src/SMAPI.Installer/assets/unix-install.sh b/src/SMAPI.Installer/assets/unix-install.sh
index f5de7b16..07df4e6c 100644
--- a/src/SMAPI.Installer/assets/unix-install.sh
+++ b/src/SMAPI.Installer/assets/unix-install.sh
@@ -3,8 +3,12 @@
 # Move to script's directory
 cd "`dirname "$0"`"
 
-# if $TERM is not set to xterm, mono will bail out when attempting to write to the console.
-export TERM=xterm
+# make sure .NET 5 is installed
+if ! command -v dotnet >/dev/null 2>&1; then
+    echo "Oops! You must have .NET 5 installed to use SMAPI: https://dotnet.microsoft.com/download";
+    read
+    exit 1
+fi
 
 # run installer
-./internal/unix/install
+dotnet internal/unix/SMAPI.Installer.dll
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 21bed803..0e700b61 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -10,7 +10,15 @@ if [ ! -f "Stardew Valley.dll" ]; then
     exit 1
 fi
 
+# make sure .NET 5 is installed
+if ! command -v dotnet >/dev/null 2>&1; then
+    echo "Oops! You must have .NET 5 installed to use SMAPI: https://dotnet.microsoft.com/download";
+    read
+    exit 1
+fi
+
 # macOS
+UNAME=$(uname)
 if [ "$UNAME" == "Darwin" ]; then
     # fix "DllNotFoundException: libgdiplus.dylib" errors when loading images in SMAPI
     if [ -f libgdiplus.dylib ]; then
@@ -20,8 +28,32 @@ if [ "$UNAME" == "Darwin" ]; then
         ln -s /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib libgdiplus.dylib
     fi
 
-    # launch smapi
-    open -a Terminal ./StardewModdingAPI "$@"
+    # Make sure we're running in Terminal (so the user can see errors/warnings/update alerts).
+    if [ ! -t 1 ]; then # https://stackoverflow.com/q/911168/262123
+        # sanity check to make sure we don't have an infinite loop of opening windows
+        SKIP_TERMINAL=false
+        for argument in "$@"; do
+            if [ "$argument" == "--no-reopen-terminal" ]; then
+                SKIP_TERMINAL=true
+                break
+            fi
+        done
+
+        # reopen in Terminal if needed
+        # https://stackoverflow.com/a/29511052/262123
+        if [ "$SKIP_TERMINAL" == "false" ]; then
+            echo "Reopening in the Terminal app..."
+            echo "\"$0\" $@ --no-reopen-terminal" > /tmp/open-smapi-terminal.sh
+            chmod +x /tmp/open-smapi-terminal.sh
+            cat /tmp/open-smapi-terminal.sh
+            open -W -a Terminal /tmp/open-smapi-terminal.sh
+            rm /tmp/open-smapi-terminal.sh
+            exit 0
+        fi
+    fi
+
+    # launch SMAPI
+    dotnet StardewModdingAPI.dll "$@"
 
 # Linux
 else
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index 3ca13528..8623f321 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -1,8 +1,27 @@
 @echo off
+
+REM make sure we're not running within a zip folder
 echo "%~dp0" | findstr /C:"%TEMP%" 1>nul
-if not errorlevel 1 (
-   echo Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first.
-   pause
-) else (
-   start /WAIT /B internal\windows\install.exe
+if %ERRORLEVEL% EQU 0 (
+    echo "Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first."
+    pause
+    exit
 )
+
+REM make sure .NET 5 is installed
+WHERE dotnet /q
+if %ERRORLEVEL% NEQ 0 (
+    echo "Oops! You must have .NET 5 (desktop x64) installed to use SMAPI: https://dotnet.microsoft.com/download/dotnet/5.0/runtime"
+    pause
+    exit
+)
+
+REM make sure an antivirus hasn't deleted the installer DLL
+if not exist internal\windows\SMAPI.Installer.dll (
+    echo "Oops! SMAPI can't find its 'internal\windows\SMAPI.Installer.dll' file. Your antivirus might have deleted the file."
+    pause
+    exit
+)
+
+REM start installer
+dotnet internal\windows\SMAPI.Installer.dll

From 0f508c755aa679dc63b78507c54b5530d5b972d3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 17 Aug 2021 21:41:23 -0400
Subject: [PATCH 333/856] reorganize install script

This fixes an issue where Steam messes with the PATH, so dotnet isn't available until the terminal window is opened.
---
 src/SMAPI.Installer/assets/unix-launcher.sh | 70 +++++++++++++--------
 1 file changed, 44 insertions(+), 26 deletions(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 0e700b61..7e892fca 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -1,34 +1,19 @@
 #!/usr/bin/env bash
 
-# Move to script's directory
+##########
+## Initial setup
+##########
+# move to script's directory
 cd "$(dirname "$0")" || exit $?
 
-# validate script is being run from the game folder
-if [ ! -f "Stardew Valley.dll" ]; then
-    echo "Oops! SMAPI must be placed in the Stardew Valley game folder.\nSee instructions: https://stardewvalleywiki.com/Modding:Player_Guide";
-    read
-    exit 1
-fi
 
-# make sure .NET 5 is installed
-if ! command -v dotnet >/dev/null 2>&1; then
-    echo "Oops! You must have .NET 5 installed to use SMAPI: https://dotnet.microsoft.com/download";
-    read
-    exit 1
-fi
-
-# macOS
-UNAME=$(uname)
-if [ "$UNAME" == "Darwin" ]; then
-    # fix "DllNotFoundException: libgdiplus.dylib" errors when loading images in SMAPI
-    if [ -f libgdiplus.dylib ]; then
-        rm libgdiplus.dylib
-    fi
-    if [ -f /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib ]; then
-        ln -s /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib libgdiplus.dylib
-    fi
-
-    # Make sure we're running in Terminal (so the user can see errors/warnings/update alerts).
+##########
+## Open terminal if needed
+##########
+# on macOS, make sure we're running in a Terminal
+# Besides letting the player see errors/warnings/alerts in the console, this is also needed because
+# Steam messes with the PATH.
+if [ "$(uname)" == "Darwin" ]; then
     if [ ! -t 1 ]; then # https://stackoverflow.com/q/911168/262123
         # sanity check to make sure we don't have an infinite loop of opening windows
         SKIP_TERMINAL=false
@@ -51,6 +36,39 @@ if [ "$UNAME" == "Darwin" ]; then
             exit 0
         fi
     fi
+fi
+
+
+##########
+## Validate assumptions
+##########
+# script must be run from the game folder
+if [ ! -f "Stardew Valley.dll" ]; then
+    echo "Oops! SMAPI must be placed in the Stardew Valley game folder.\nSee instructions: https://stardewvalleywiki.com/Modding:Player_Guide";
+    read
+    exit 1
+fi
+
+# .NET 5 must be installed
+if ! command -v dotnet >/dev/null 2>&1; then
+    echo "Oops! You must have .NET 5 installed to use SMAPI: https://dotnet.microsoft.com/download";
+    read
+    exit 1
+fi
+
+
+##########
+## Launch SMAPI
+##########
+# macOS
+if [ "$(uname)" == "Darwin" ]; then
+    # fix "DllNotFoundException: libgdiplus.dylib" errors when loading images in SMAPI
+    if [ -f libgdiplus.dylib ]; then
+        rm libgdiplus.dylib
+    fi
+    if [ -f /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib ]; then
+        ln -s /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib libgdiplus.dylib
+    fi
 
     # launch SMAPI
     dotnet StardewModdingAPI.dll "$@"

From 33c7a0392cc9f39f885f50774e980a0bf3643fd6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 17 Aug 2021 23:25:09 -0400
Subject: [PATCH 334/856] remove libgdiplus workaround on macOS

This is no longer needed after the .NET 5 migration.
---
 src/SMAPI.Installer/InteractiveInstaller.cs              | 4 ++--
 src/SMAPI.Installer/assets/unix-launcher.sh              | 9 ---------
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 3 ---
 3 files changed, 2 insertions(+), 14 deletions(-)

diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 34285cf7..896017d3 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -39,7 +39,6 @@ namespace StardewModdingApi.Installer
             string GetInstallPath(string path) => Path.Combine(installDir.FullName, path);
 
             // current files
-            yield return GetInstallPath("libgdiplus.dylib");           // Linux/macOS only
             yield return GetInstallPath("StardewModdingAPI");          // Linux/macOS only
             yield return GetInstallPath("StardewModdingAPI.dll");
             yield return GetInstallPath("StardewModdingAPI.exe");
@@ -52,6 +51,7 @@ namespace StardewModdingApi.Installer
             yield return GetInstallPath("steam_appid.txt");
 
             // obsolete
+            yield return GetInstallPath("libgdiplus.dylib");                 // before 3.13 (macOS only)
             yield return GetInstallPath(Path.Combine("Mods", ".cache"));     // 1.3-1.4
             yield return GetInstallPath(Path.Combine("Mods", "TrainerMod")); // *–2.0 (renamed to ConsoleCommands)
             yield return GetInstallPath("Mono.Cecil.Rocks.dll");             // 1.3–1.8
@@ -71,7 +71,7 @@ namespace StardewModdingApi.Installer
             yield return GetInstallPath("StardewModdingAPI.Toolkit.CoreInterfaces.dll"); // moved in 2.8
             yield return GetInstallPath("StardewModdingAPI.Toolkit.CoreInterfaces.pdb"); // moved in 2.8
             yield return GetInstallPath("StardewModdingAPI.Toolkit.CoreInterfaces.xml"); // moved in 2.8
-            yield return GetInstallPath("StardewModdingAPI-x64.exe");         // 3.13
+            yield return GetInstallPath("StardewModdingAPI-x64.exe");         // before 3.13
 
             if (modsDir.Exists)
             {
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 7e892fca..58f7a5ae 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -62,15 +62,6 @@ fi
 ##########
 # macOS
 if [ "$(uname)" == "Darwin" ]; then
-    # fix "DllNotFoundException: libgdiplus.dylib" errors when loading images in SMAPI
-    if [ -f libgdiplus.dylib ]; then
-        rm libgdiplus.dylib
-    fi
-    if [ -f /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib ]; then
-        ln -s /Library/Frameworks/Mono.framework/Versions/Current/lib/libgdiplus.dylib libgdiplus.dylib
-    fi
-
-    # launch SMAPI
     dotnet StardewModdingAPI.dll "$@"
 
 # Linux
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index d24ffb81..bf0b54b9 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -7,7 +7,6 @@ using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
-using StardewModdingAPI.Internal;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
@@ -177,8 +176,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
             catch (Exception ex) when (!(ex is SContentLoadException))
             {
-                if (ex.GetInnermostException() is DllNotFoundException dllEx && dllEx.Message == "libgdiplus.dylib")
-                    throw GetContentError("couldn't find libgdiplus, which is needed to load mod images. Make sure Mono is installed and you're running the game through the normal launcher.");
                 throw new SContentLoadException($"The content manager failed loading content asset '{assetName}' from {this.Name}.", ex);
             }
 

From 3c6549db3e2716b1ebc1f2f9e970fb0dc15613eb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 18 Aug 2021 23:34:34 -0400
Subject: [PATCH 335/856] remove reference no longer needed in .NET 5

---
 src/SMAPI/SMAPI.csproj | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index a04dd1b6..16ddb92a 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -31,7 +31,6 @@
     <Reference Include="..\..\build\0Harmony.dll" Private="True" />
     <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
-    <Reference Include="System.Numerics" Private="True" />
     <Reference Include="GalaxyCSharp" HintPath="$(GamePath)\GalaxyCSharp.dll" Private="False" />
     <Reference Include="Lidgren.Network" HintPath="$(GamePath)\Lidgren.Network.dll" Private="False" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />

From b349e956c6bb4608b4e158282700bf39e0072817 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 18 Aug 2021 23:50:01 -0400
Subject: [PATCH 336/856] remove handling for exception no longer thrown by the
 game

---
 src/SMAPI/Framework/Logging/LogManager.cs | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index abcb2f64..dbcf8934 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -252,18 +252,6 @@ namespace StardewModdingAPI.Framework.Logging
         {
             switch (exception)
             {
-                // audio crash
-                //case 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()}");
-                //    break;
-
-                // missing content folder exception
-                case FileNotFoundException ex when ex.Message == "Couldn't find file 'C:\\Program Files (x86)\\Steam\\SteamApps\\common\\Stardew Valley\\Content\\XACT\\FarmerSounds.xgs'.": // path in error is hardcoded regardless of install path
-                    this.Monitor.Log("The game can't find its Content\\XACT\\FarmerSounds.xgs file. You can usually fix this by resetting your content files (see https://smapi.io/troubleshoot#reset-content ), or by uninstalling and reinstalling the game.", LogLevel.Error);
-                    this.Monitor.Log($"Technical details: {ex.GetLogSummary()}");
-                    break;
-
                 // path too long exception
                 case PathTooLongException _:
                     {

From 89c98223ebf6bfeee5ef587ab748995e09dd4310 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 18 Aug 2021 23:55:43 -0400
Subject: [PATCH 337/856] remove path-too-long exception handling

The path length limit no longer applies in .NET 5.
---
 src/SMAPI.Installer/InteractiveInstaller.cs  | 11 --------
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs | 28 --------------------
 src/SMAPI/Framework/Logging/LogManager.cs    | 19 +------------
 3 files changed, 1 insertion(+), 57 deletions(-)

diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 896017d3..714a959b 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -259,17 +259,6 @@ namespace StardewModdingApi.Installer
                 Console.ReadLine();
                 return;
             }
-
-            // game folder doesn't contain paths beyond the max limit
-            {
-                string[] tooLongPaths = PathUtilities.GetTooLongPaths(Path.Combine(paths.GamePath, "Mods")).ToArray();
-                if (tooLongPaths.Any())
-                {
-                    this.PrintError($"SMAPI can't install to the detected game folder, because some of its files exceed the maximum {context.Platform} path length.\nIf you need help fixing this error, see https://smapi.io/help\n\nAffected paths:\n   {string.Join("\n   ", tooLongPaths)}");
-                    Console.ReadLine();
-                    return;
-                }
-            }
             Console.Clear();
 
 
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index 1d378042..2e9e5eac 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using System.Diagnostics.Contracts;
 using System.IO;
 using System.Linq;
@@ -150,32 +149,5 @@ namespace StardewModdingAPI.Toolkit.Utilities
         {
             return !Regex.IsMatch(str, "[^a-z0-9_.-]", RegexOptions.IgnoreCase);
         }
-
-        /// <summary>Get the paths which exceed the OS length limit.</summary>
-        /// <param name="rootPath">The root path to search.</param>
-        internal static IEnumerable<string> GetTooLongPaths(string rootPath)
-        {
-            if (!Directory.Exists(rootPath))
-                return new string[0];
-
-            return Directory
-                .EnumerateFileSystemEntries(rootPath, "*.*", SearchOption.AllDirectories)
-                .Where(PathUtilities.IsPathTooLong);
-        }
-
-        /// <summary>Get whether a file or directory path exceeds the OS path length limit.</summary>
-        /// <param name="path">The path to test.</param>
-        internal static bool IsPathTooLong(string path)
-        {
-            try
-            {
-                _ = Path.GetFullPath(path);
-                return false;
-            }
-            catch (PathTooLongException)
-            {
-                return true;
-            }
-        }
     }
 }
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index dbcf8934..5a291d0a 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -250,24 +250,7 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="exception">The exception details.</param>
         public void LogFatalLaunchError(Exception exception)
         {
-            switch (exception)
-            {
-                // path too long exception
-                case PathTooLongException _:
-                    {
-                        string[] affectedPaths = PathUtilities.GetTooLongPaths(Constants.ModsPath).ToArray();
-                        string message = affectedPaths.Any()
-                            ? $"SMAPI can't launch because some of your mod files exceed the maximum path length on {Constants.Platform}.\nIf you need help fixing this error, see https://smapi.io/help\n\nAffected paths:\n   {string.Join("\n   ", affectedPaths)}"
-                            : $"The game failed to launch: {exception.GetLogSummary()}";
-                        this.MonitorForGame.Log(message, LogLevel.Error);
-                    }
-                    break;
-
-                // generic exception
-                default:
-                    this.MonitorForGame.Log($"The game failed to launch: {exception.GetLogSummary()}", LogLevel.Error);
-                    break;
-            }
+            this.MonitorForGame.Log($"The game failed to launch: {exception.GetLogSummary()}", LogLevel.Error);
         }
 
         /****

From 294f2a311ea2cfb590529522c0afae8e5a4f44fd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 19 Aug 2021 00:40:12 -0400
Subject: [PATCH 338/856] fix error resolving native DLLs like libSkiaSharp

---
 src/SMAPI.Installer/InteractiveInstaller.cs  |  8 ++++++++
 src/SMAPI.Toolkit/Utilities/FileUtilities.cs | 13 +++++++++++++
 src/SMAPI/Program.cs                         | 16 ++++++++++++++++
 3 files changed, 37 insertions(+)

diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 714a959b..d8c27a2d 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -410,6 +410,14 @@ namespace StardewModdingApi.Installer
                         }
                     }
 
+                    // copy the game's deps.json file
+                    // (This is needed to resolve native DLLs like libSkiaSharp.)
+                    File.Copy(
+                        sourceFileName: Path.Combine(paths.GamePath, "Stardew Valley.deps.json"),
+                        destFileName: Path.Combine(paths.GamePath, "StardewModdingAPI.deps.json"),
+                        overwrite: true
+                    );
+
                     // create mods directory (if needed)
                     if (!paths.ModsDir.Exists)
                     {
diff --git a/src/SMAPI.Toolkit/Utilities/FileUtilities.cs b/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
index 7856fdb1..a6bf5929 100644
--- a/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
@@ -1,4 +1,6 @@
+using System;
 using System.IO;
+using System.Security.Cryptography;
 using System.Threading;
 
 namespace StardewModdingAPI.Toolkit.Utilities
@@ -42,5 +44,16 @@ namespace StardewModdingAPI.Toolkit.Utilities
             if (entry.Exists)
                 throw new IOException($"Timed out trying to delete {entry.FullName}");
         }
+
+        /// <summary>Get the MD5 hash for a file.</summary>
+        /// <param name="absolutePath">The absolute file path.</param>
+        public static string GetFileHash(string absolutePath)
+        {
+            using FileStream stream = File.OpenRead(absolutePath);
+            using MD5 md5 = MD5.Create();
+
+            byte[] hash = md5.ComputeHash(stream);
+            return BitConverter.ToString(hash).Replace("-", "").ToLowerInvariant();
+        }
     }
 }
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 0417697b..67ff8322 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -5,6 +5,7 @@ using System.Reflection;
 using System.Threading;
 using StardewModdingAPI.Framework;
 using StardewModdingAPI.Toolkit.Serialization.Models;
+using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI
 {
@@ -33,6 +34,7 @@ namespace StardewModdingAPI
                 Program.AssertGamePresent();
                 Program.AssertGameVersion();
                 Program.AssertSmapiVersions();
+                Program.AssertDepsJson();
                 Program.Start(args);
             }
             catch (BadImageFormatException ex) when (ex.FileName == EarlyConstants.GameAssemblyName)
@@ -130,6 +132,20 @@ namespace StardewModdingAPI
             }
         }
 
+        /// <summary>Assert that SMAPI's <c>StardewModdingAPI.deps.json</c> matches <c>Stardew Valley.deps.json</c>, fixing it if necessary.</summary>
+        /// <remarks>This is needed to resolve native DLLs like libSkiaSharp.</remarks>
+        private static void AssertDepsJson()
+        {
+            string sourcePath = Path.Combine(Constants.ExecutionPath, "Stardew Valley.deps.json");
+            string targetPath = Path.Combine(Constants.ExecutionPath, "StardewModdingAPI.deps.json");
+
+            if (!File.Exists(targetPath) || FileUtilities.GetFileHash(sourcePath) != FileUtilities.GetFileHash(targetPath))
+            {
+                File.Copy(sourcePath, targetPath, overwrite: true);
+                Program.PrintErrorAndExit($"The '{Path.GetFileName(targetPath)}' file didn't match the game's version. SMAPI fixed it automatically, but you must restart SMAPI for the change to take effect.");
+            }
+        }
+
         /// <summary>Initialize SMAPI and launch the game.</summary>
         /// <param name="args">The command-line arguments.</param>
         /// <remarks>This method is separate from <see cref="Main"/> because that can't contain any references to assemblies loaded by <see cref="CurrentDomain_AssemblyResolve"/> (e.g. via <see cref="Constants"/>), or Mono will incorrectly show an assembly resolution error before assembly resolution is set up.</remarks>

From 1ab0420b6d2371095756e5049fd28d419bfe31f0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 30 Aug 2021 23:42:59 -0400
Subject: [PATCH 339/856] update compatibility list

---
 docs/release-notes.md                     |  1 +
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 65 +++++++++++++++++++----
 2 files changed, 55 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 43370409..d6e22af4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For players:
   * Updated for Stardew Valley 1.5.5.
+  * Updated compatibility list.
   * Added `set_farm_type` [console command](https://stardewvalleywiki.com/Modding:Console_commands#Console_commands) to change the current farm type.
 
 * For mod authors:
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index dcdd6298..bb166017 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -167,6 +167,60 @@
             "~ | StatusReasonPhrase": "split-screen mode was added in Stardew Valley 1.5"
         },
 
+        /*********
+        ** Broke in SDV 1.5.5
+        *********/
+        "Animated Portrait Framework": {
+            "ID": "akai.AnimatedPortrait",
+            "~1.0.0 | Status": "AssumeBroken",
+            "~1.0.0 | StatusReasonDetails": "requires the 'System.Windows.Forms' API, which isn't available in .NET 5"
+        },
+        "Audio Devices": {
+            "ID": "maxvollmer.audiodevices",
+            "~3.0.1 | Status": "AssumeBroken",
+            "~3.0.1 | StatusReasonDetails": "fails to load due to an outdated implementation of the game's 'IAudioEngine' interface"
+        },
+        "Battery Warning": {
+            "ID": "Husky110.BatteryWarningMod",
+            "~1.0.4 | Status": "AssumeBroken",
+            "~1.0.4 | StatusReasonDetails": "requires the 'System.Management' API, which is a different DLL in .NET 5"
+        },
+        "Junimo Studio": {
+            "ID": "Becks723.JunimoStudio",
+            "~2.0.1 | Status": "AssumeBroken",
+            "~2.0.1 | StatusReasonDetails": "requires 'Microsoft.Xna.Framework.Audio.AudioCategory' which doesn't exist in MonoGame"
+        },
+        "Skip Intro": {
+            "ID": "Pathoschild.SkipIntro",
+            "~1.9.1 | Status": "AssumeBroken",
+            "~1.9.1 | StatusReasonDetails": "causes freeze during game launch"
+        },
+        "Stardew Hack": {
+            "ID": "bcmpinc.StardewHack",
+            "~5.1.0 | Status": "AssumeBroken",
+            "~5.1.0 | StatusReasonDetails": "runtime error when initializing due to an API change between .NET Framework and .NET 5"
+        },
+        "Stardew Valley Expanded": {
+            "ID": "FlashShifter.SVECode",
+            "~1.13.11 | Status": "AssumeBroken",
+            "~1.13.11 | StatusReasonDetails": "fails to load due to an outdated implementation of the game's 'ICue' interface"
+        },
+        "Stardew Web": {
+            "ID": "prism99.stardewweb",
+            "~0.7.2 | Status": "AssumeBroken",
+            "~0.7.2 | StatusReasonDetails": "requires the 'System.Drawing' API, which isn't available in .NET 5"
+        },
+        "Sundrop City": {
+            "ID": "SundropTeam.SundropCity",
+            "~0.4.1 | Status": "AssumeBroken",
+            "~0.4.1 | StatusReasonDetails": "causes freeze during game launch"
+        },
+        "Video Player": {
+            "ID": "aedenthorn.VideoPlayer",
+            "~0.2.5 | Status": "AssumeBroken",
+            "~0.2.5 | StatusReasonDetails": "requires an XNA Framework API that's not available in MonoGame and causes a crash to desktop"
+        },
+
         /*********
         ** Broke in SMAPI 3.12.0
         *********/
@@ -205,11 +259,6 @@
             "~1.9.3 | Status": "AssumeBroken",
             "~1.9.3 | StatusReasonDetails": "fails to load with 'ReflectionTypeLoadException' error"
         },
-        "Stardew Hack": {
-            "ID": "bcmpinc.StardewHack",
-            "~5.0.0 | Status": "AssumeBroken",
-            "~5.0.0 | StatusReasonDetails": "causes Harmony patching errors for other mods"
-        },
         "Tilled Soil Decay": {
             "ID": "bcmpinc.TilledSoilDecay",
             "~4.1.0 | Status": "AssumeBroken",
@@ -238,12 +287,6 @@
         /*********
         ** Broke in SDV 1.5 (SMAPI mods)
         *********/
-        "Audio Devices": {
-            "ID": "maxvollmer.audiodevices",
-            "~2.0.0 | Status": "AssumeBroken",
-            "~2.0.0 | StatusReasonDetails": "causes crash to desktop when starting the game"
-        },
-
         "ChestEx": {
             "ID": "berkayylmao.ChestEx",
             "~1.3.4 | Status": "AssumeBroken",

From 25384ce6bc1b05cb5150915ab40effe7749f683b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 15 Sep 2021 00:27:17 -0400
Subject: [PATCH 340/856] update for custom languages

---
 src/SMAPI/Framework/ContentCoordinator.cs     | 41 +++++++++++++++++++
 .../ContentManagers/BaseContentManager.cs     | 17 +-------
 .../ContentManagers/GameContentManager.cs     |  2 +-
 src/SMAPI/Framework/SCore.cs                  |  4 +-
 4 files changed, 45 insertions(+), 19 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index d0e759c2..b6f1669a 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -64,6 +64,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>An unmodified content manager which doesn't intercept assets, used to compare asset data.</summary>
         private readonly LocalizedContentManager VanillaContentManager;
 
+        /// <summary>The language enum values indexed by locale code.</summary>
+        private Lazy<IDictionary<string, LocalizedContentManager.LanguageCode>> LocaleCodes;
+
 
         /*********
         ** Accessors
@@ -133,6 +136,7 @@ namespace StardewModdingAPI.Framework
             this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
             this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations);
+            this.LocaleCodes = new Lazy<IDictionary<string, LocalizedContentManager.LanguageCode>>(this.GetLocaleCodes);
         }
 
         /// <summary>Get a new content manager which handles reading files from the game content folder with support for interception.</summary>
@@ -195,6 +199,10 @@ namespace StardewModdingAPI.Framework
         /// <summary>Perform any cleanup needed when the locale changes.</summary>
         public void OnLocaleChanged()
         {
+            // rebuild locale cache (which may change due to custom mod languages)
+            this.LocaleCodes = new Lazy<IDictionary<string, LocalizedContentManager.LanguageCode>>(this.GetLocaleCodes);
+
+            // reload affected content
             this.ContentManagerLock.InReadLock(() =>
             {
                 foreach (IContentManager contentManager in this.ContentManagers)
@@ -408,6 +416,25 @@ namespace StardewModdingAPI.Framework
             return tilesheets ?? new TilesheetReference[0];
         }
 
+        /// <summary>Get the language enum which corresponds to a locale code (e.g. <see cref="LocalizedContentManager.LanguageCode.fr"/> given <c>fr-FR</c>).</summary>
+        /// <param name="locale">The locale code to search. This must exactly match the language; no fallback is performed.</param>
+        /// <param name="language">The matched language enum, if any.</param>
+        /// <returns>Returns whether a valid language was found.</returns>
+        public bool TryGetLanguageEnum(string locale, out LocalizedContentManager.LanguageCode language)
+        {
+            return this.LocaleCodes.Value.TryGetValue(locale, out language);
+        }
+
+        /// <summary>Get the locale code which corresponds to a language enum (e.g. <c>fr-FR</c> given <see cref="LocalizedContentManager.LanguageCode.fr"/>).</summary>
+        /// <param name="language">The language enum to search.</param>
+        public string GetLocaleCode(LocalizedContentManager.LanguageCode language)
+        {
+            if (language == LocalizedContentManager.LanguageCode.mod && LocalizedContentManager.CurrentModLanguage == null)
+                return null;
+
+            return Game1.content.LanguageCodeString(language);
+        }
+
         /// <summary>Dispose held resources.</summary>
         public void Dispose()
         {
@@ -457,5 +484,19 @@ namespace StardewModdingAPI.Framework
                 return false;
             }
         }
+
+        /// <summary>Get the language enums (like <see cref="LocalizedContentManager.LanguageCode.ja"/>) indexed by locale code (like <c>ja-JP</c>).</summary>
+        private IDictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes()
+        {
+            IDictionary<string, LocalizedContentManager.LanguageCode> map = new Dictionary<string, LocalizedContentManager.LanguageCode>();
+            foreach (LocalizedContentManager.LanguageCode code in Enum.GetValues(typeof(LocalizedContentManager.LanguageCode)))
+            {
+                string locale = this.GetLocaleCode(code);
+                if (locale != null)
+                    map[locale] = code;
+            }
+
+            return map;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 7244a534..5645c0fa 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -38,9 +38,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>A callback to invoke when the content manager is being disposed.</summary>
         private readonly Action<BaseContentManager> OnDisposing;
 
-        /// <summary>The language enum values indexed by locale code.</summary>
-        protected IDictionary<string, LanguageCode> LanguageCodes { get; }
-
         /// <summary>A list of disposable assets.</summary>
         private readonly List<WeakReference<IDisposable>> Disposables = new List<WeakReference<IDisposable>>();
 
@@ -92,7 +89,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
 
             // get asset data
-            this.LanguageCodes = this.GetKeyLocales().ToDictionary(p => p.Value, p => p.Key, StringComparer.OrdinalIgnoreCase);
             this.BaseDisposableReferences = reflection.GetField<List<IDisposable>>(this, "disposableAssets").GetValue();
         }
 
@@ -292,7 +288,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (lastSepIndex >= 0)
                 {
                     string suffix = cacheKey.Substring(lastSepIndex + 1, cacheKey.Length - lastSepIndex - 1);
-                    if (this.LanguageCodes.ContainsKey(suffix))
+                    if (this.Coordinator.TryGetLanguageEnum(suffix, out _))
                     {
                         assetName = cacheKey.Substring(0, lastSepIndex);
                         localeCode = cacheKey.Substring(lastSepIndex + 1, cacheKey.Length - lastSepIndex - 1);
@@ -311,17 +307,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="language">The language to check.</param>
         protected abstract bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language);
 
-        /// <summary>Get the locale codes (like <c>ja-JP</c>) used in asset keys.</summary>
-        private IDictionary<LanguageCode, string> GetKeyLocales()
-        {
-            // create locale => code map
-            IDictionary<LanguageCode, string> map = new Dictionary<LanguageCode, string>();
-            foreach (LanguageCode code in Enum.GetValues(typeof(LanguageCode)))
-                map[code] = this.GetLocale(code);
-
-            return map;
-        }
-
         /// <summary>Get the asset name from a cache key.</summary>
         /// <param name="cacheKey">The input cache key.</param>
         private string GetAssetName(string cacheKey)
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 38bcf153..7a49dd36 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -249,7 +249,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // extract language code
             int splitIndex = rawAsset.LastIndexOf('.');
-            if (splitIndex != -1 && this.LanguageCodes.TryGetValue(rawAsset.Substring(splitIndex + 1), out language))
+            if (splitIndex != -1 && this.Coordinator.TryGetLanguageEnum(rawAsset.Substring(splitIndex + 1), out language))
             {
                 assetName = rawAsset.Substring(0, splitIndex);
                 return true;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 947284a8..a0467daa 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -751,7 +751,7 @@ namespace StardewModdingAPI.Framework
                     ** Locale changed events
                     *********/
                     if (state.Locale.IsChanged)
-                        this.Monitor.Log($"Context: locale set to {state.Locale.New}.");
+                        this.Monitor.Log($"Context: locale set to {state.Locale.New} ({this.ContentCore.GetLocaleCode(state.Locale.New)}).");
 
                     /*********
                     ** Load / return-to-title events
@@ -761,7 +761,7 @@ namespace StardewModdingAPI.Framework
                     else if (Context.IsWorldReady && Context.LoadStage != LoadStage.Ready)
                     {
                         // print context
-                        string context = $"Context: loaded save '{Constants.SaveFolderName}', starting {Game1.currentSeason} {Game1.dayOfMonth} Y{Game1.year}, locale set to {this.ContentCore.Language}.";
+                        string context = $"Context: loaded save '{Constants.SaveFolderName}', starting {Game1.currentSeason} {Game1.dayOfMonth} Y{Game1.year}, locale set to {this.ContentCore.GetLocale()}.";
                         if (Context.IsMultiplayer)
                         {
                             int onlineCount = Game1.getOnlineFarmers().Count();

From 32dcdfe18c634804983f130c0b7bac4bddca93f7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Sep 2021 17:27:27 -0400
Subject: [PATCH 341/856] tweak assembly ignore logic in mod build package

---
 .../Framework/ModFileManager.cs               | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index 6dd595e5..7a1ed7a4 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -152,22 +152,22 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
         /// <param name="ignoreFilePatterns">Custom regex patterns matching files to ignore when deploying or zipping the mod.</param>
         private bool ShouldIgnore(FileInfo file, string relativePath, Regex[] ignoreFilePatterns)
         {
+            bool IsAssemblyFile(string baseName)
+            {
+                return
+                    this.EqualsInvariant(file.Name, $"{baseName}.dll")
+                    || this.EqualsInvariant(file.Name, $"{baseName}.pdb")
+                    || this.EqualsInvariant(file.Name, $"{baseName}.xnb");
+            }
+
             return
                 // release zips
                 this.EqualsInvariant(file.Extension, ".zip")
 
-                // Harmony (bundled into SMAPI)
-                || this.EqualsInvariant(file.Name, "0Harmony.dll")
-
-                // Json.NET (bundled into SMAPI)
-                || this.EqualsInvariant(file.Name, "Newtonsoft.Json.dll")
-                || this.EqualsInvariant(file.Name, "Newtonsoft.Json.pdb")
-                || this.EqualsInvariant(file.Name, "Newtonsoft.Json.xml")
-
-                // mod translation class builder (not used at runtime)
-                || this.EqualsInvariant(file.Name, "Pathoschild.Stardew.ModTranslationClassBuilder.dll")
-                || this.EqualsInvariant(file.Name, "Pathoschild.Stardew.ModTranslationClassBuilder.pdb")
-                || this.EqualsInvariant(file.Name, "Pathoschild.Stardew.ModTranslationClassBuilder.xml")
+                // dependencies bundled with SMAPI
+                || IsAssemblyFile("0Harmony")
+                || IsAssemblyFile("Newtonsoft.Json")
+                || IsAssemblyFile("Pathoschild.Stardew.ModTranslationClassBuilder") // not used at runtime
 
                 // code analysis files
                 || file.Name.EndsWith(".CodeAnalysisLog.xml", StringComparison.OrdinalIgnoreCase)

From 60c0e4fc31475847cbf94d201f0bd394c537d9c0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Sep 2021 17:29:22 -0400
Subject: [PATCH 342/856] ignore reference assemblies and *.deps.json when
 building a mod

These aren't useful for mods since they aren't the entry app.
---
 src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs | 3 +++
 src/SMAPI.ModBuildConfig/build/smapi.targets         | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index 7a1ed7a4..3d9b206b 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -164,6 +164,9 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
                 // release zips
                 this.EqualsInvariant(file.Extension, ".zip")
 
+                // unneeded *.deps.json (only SMAPI's top-level one is used)
+                || file.Name.EndsWith(".deps.json")
+
                 // dependencies bundled with SMAPI
                 || IsAssemblyFile("0Harmony")
                 || IsAssemblyFile("Newtonsoft.Json")
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index a3cd6c45..74ac56e6 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -15,6 +15,9 @@
     <!-- recognise XNA Framework DLLs in the GAC (only affects mods using new csproj format) -->
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
 
+    <!-- don't create the 'refs' folder (which isn't useful for mods) -->
+    <ProduceReferenceAssembly>false</ProduceReferenceAssembly>
+
     <!-- suppress processor architecture mismatch warning (mods should be compiled in 'Any CPU' so they work in both 32-bit and 64-bit mode) -->
     <ResolveAssemblyWarnOrErrorOnTargetArchitectureMismatch>None</ResolveAssemblyWarnOrErrorOnTargetArchitectureMismatch>
 

From 217cc7af21a501daabea16dc7331401a19706bf4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Sep 2021 17:34:31 -0400
Subject: [PATCH 343/856] add IgnoreModFilePaths option to package

---
 docs/technical/mod-package.md                 | 17 +++++++++-
 src/SMAPI.ModBuildConfig/DeployModTask.cs     | 32 +++++++++++++++++--
 .../Framework/ModFileManager.cs               |  9 ++++--
 src/SMAPI.ModBuildConfig/build/smapi.targets  |  1 +
 4 files changed, 53 insertions(+), 6 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index a3ce8761..0fdd4c4a 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -222,6 +222,20 @@ Whether to configure the project so you can launch or debug the game through the
 Visual Studio (default `true`). There's usually no reason to change this, unless it's a unit test
 project.
 
+</td>
+</tr>
+<tr>
+<td><code>IgnoreModFilePaths</code></td>
+<td>
+
+A comma-delimited list of literal file paths to ignore, relative to the mod's `bin` folder. Paths
+are case-sensitive, but path delimiters are normalized automatically. For example, this ignores a
+set of tilesheets:
+
+```xml
+<IgnoreModFilePaths>assets/paths.png, assets/springobjects.png</IgnoreModFilePaths>
+```
+
 </td>
 </tr>
 <tr>
@@ -366,7 +380,8 @@ when you compile it.
 
 ## Release notes
 ## Upcoming release
-* Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. **The older versions are no longer supported.**
+* Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. **Older versions are no longer supported.**
+* Added `IgnoreModFilePaths` option to ignore literal paths.
 * Improved analyzer performance by enabling parallel execution.
 
 ## 3.3.0
diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index 9ee6be12..0c64aed3 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -8,6 +8,7 @@ using System.Text.RegularExpressions;
 using Microsoft.Build.Framework;
 using Microsoft.Build.Utilities;
 using StardewModdingAPI.ModBuildConfig.Framework;
+using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.ModBuildConfig
 {
@@ -45,9 +46,12 @@ namespace StardewModdingAPI.ModBuildConfig
         [Required]
         public bool EnableModZip { get; set; }
 
-        /// <summary>Custom comma-separated regex patterns matching files to ignore when deploying or zipping the mod.</summary>
+        /// <summary>A comma-separated list of regex patterns matching files to ignore when deploying or zipping the mod.</summary>
         public string IgnoreModFilePatterns { get; set; }
 
+        /// <summary>A comma-separated list of relative file paths to ignore when deploying or zipping the mod.</summary>
+        public string IgnoreModFilePaths { get; set; }
+
 
         /*********
         ** Public methods
@@ -70,10 +74,11 @@ namespace StardewModdingAPI.ModBuildConfig
             try
             {
                 // parse ignore patterns
+                string[] ignoreFilePaths = this.GetCustomIgnoreFilePaths().ToArray();
                 Regex[] ignoreFilePatterns = this.GetCustomIgnorePatterns().ToArray();
 
                 // get mod info
-                ModFileManager package = new ModFileManager(this.ProjectDir, this.TargetDir, ignoreFilePatterns, validateRequiredModFiles: this.EnableModDeploy || this.EnableModZip);
+                ModFileManager package = new ModFileManager(this.ProjectDir, this.TargetDir, ignoreFilePaths, ignoreFilePatterns, validateRequiredModFiles: this.EnableModDeploy || this.EnableModZip);
 
                 // deploy mod files
                 if (this.EnableModDeploy)
@@ -157,6 +162,29 @@ namespace StardewModdingAPI.ModBuildConfig
             }
         }
 
+        /// <summary>Get the custom relative file paths provided by the user to ignore.</summary>
+        private IEnumerable<string> GetCustomIgnoreFilePaths()
+        {
+            if (string.IsNullOrWhiteSpace(this.IgnoreModFilePaths))
+                yield break;
+
+            foreach (string raw in this.IgnoreModFilePaths.Split(','))
+            {
+                string path;
+                try
+                {
+                    path = PathUtilities.NormalizePath(raw);
+                }
+                catch (Exception ex)
+                {
+                    this.Log.LogWarning($"[mod build package] Ignored invalid <{nameof(this.IgnoreModFilePaths)}> path {raw}:\n{ex}");
+                    continue;
+                }
+
+                yield return path;
+            }
+        }
+
         /// <summary>Copy the mod files into the game's mod folder.</summary>
         /// <param name="files">The files to include.</param>
         /// <param name="modFolderPath">The folder path to create with the mod files.</param>
diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index 3d9b206b..fbb91193 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -28,10 +28,11 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
         /// <summary>Construct an instance.</summary>
         /// <param name="projectDir">The folder containing the project files.</param>
         /// <param name="targetDir">The folder containing the build output.</param>
+        /// <param name="ignoreFilePaths">The custom relative file paths provided by the user to ignore.</param>
         /// <param name="ignoreFilePatterns">Custom regex patterns matching files to ignore when deploying or zipping the mod.</param>
         /// <param name="validateRequiredModFiles">Whether to validate that required mod files like the manifest are present.</param>
         /// <exception cref="UserErrorException">The mod package isn't valid.</exception>
-        public ModFileManager(string projectDir, string targetDir, Regex[] ignoreFilePatterns, bool validateRequiredModFiles)
+        public ModFileManager(string projectDir, string targetDir, string[] ignoreFilePaths, Regex[] ignoreFilePatterns, bool validateRequiredModFiles)
         {
             this.Files = new Dictionary<string, FileInfo>(StringComparer.OrdinalIgnoreCase);
 
@@ -47,7 +48,7 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
                 string relativePath = entry.Item1;
                 FileInfo file = entry.Item2;
 
-                if (!this.ShouldIgnore(file, relativePath, ignoreFilePatterns))
+                if (!this.ShouldIgnore(file, relativePath, ignoreFilePaths, ignoreFilePatterns))
                     this.Files[relativePath] = file;
             }
 
@@ -149,8 +150,9 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
         /// <summary>Get whether a build output file should be ignored.</summary>
         /// <param name="file">The file to check.</param>
         /// <param name="relativePath">The file's relative path in the package.</param>
+        /// <param name="ignoreFilePaths">The custom relative file paths provided by the user to ignore.</param>
         /// <param name="ignoreFilePatterns">Custom regex patterns matching files to ignore when deploying or zipping the mod.</param>
-        private bool ShouldIgnore(FileInfo file, string relativePath, Regex[] ignoreFilePatterns)
+        private bool ShouldIgnore(FileInfo file, string relativePath, string[] ignoreFilePaths, Regex[] ignoreFilePatterns)
         {
             bool IsAssemblyFile(string baseName)
             {
@@ -181,6 +183,7 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
                 || this.EqualsInvariant(file.Name, "Thumbs.db")
 
                 // custom ignore patterns
+                || ignoreFilePaths.Any(p => p == relativePath)
                 || ignoreFilePatterns.Any(p => p.IsMatch(relativePath));
         }
 
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 74ac56e6..b254dd7c 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -94,6 +94,7 @@
       TargetDir="$(TargetDir)"
       GameModsDir="$(GameModsPath)"
       IgnoreModFilePatterns="$(IgnoreModFilePatterns)"
+      IgnoreModFilePaths="$(IgnoreModFilePaths)"
     />
   </Target>
 </Project>

From 4a26c96fbe600a4a229a1e63abb716a62dc7f450 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Sep 2021 18:48:59 -0400
Subject: [PATCH 344/856] remove GameExecutableName build property from package

---
 build/find-game-folder.targets                |  5 ----
 docs/technical/mod-package.md                 | 24 +++++++++----------
 src/SMAPI.ModBuildConfig/build/smapi.targets  |  4 ++--
 .../SMAPI.Mods.ConsoleCommands.csproj         |  2 +-
 .../SMAPI.Mods.ErrorHandler.csproj            |  2 +-
 .../SMAPI.Mods.SaveBackup.csproj              |  2 +-
 src/SMAPI.Tests/SMAPI.Tests.csproj            |  5 +---
 src/SMAPI/SMAPI.csproj                        |  2 +-
 8 files changed, 19 insertions(+), 27 deletions(-)

diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index 3341226d..3164b071 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -41,9 +41,4 @@
       </PropertyGroup>
     </When>
   </Choose>
-
-  <!-- set game metadata -->
-  <PropertyGroup>
-    <GameExecutableName>Stardew Valley</GameExecutableName>
-  </PropertyGroup>
 </Project>
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 0fdd4c4a..5eff3d2e 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -29,7 +29,7 @@ change how these work):
 * **Detect game path:**  
   The package automatically finds your game folder by scanning the default install paths and
   Windows registry. It adds two MSBuild properties for use in your `.csproj` file if needed:
-  `$(GamePath)` and `$(GameExecutableName)`.
+  `$(GamePath)` and `$(GameModsPath)`.
 
 * **Add assembly references:**  
   The package adds assembly references to SMAPI, Stardew Valley, xTile, and the game framework
@@ -126,15 +126,6 @@ change it.
 The absolute path to the folder containing the game's installed mods (defaults to
 `$(GamePath)/Mods`), used when deploying the mod files.
 
-</td>
-</tr>
-<tr>
-<td><code>GameExecutableName</code></td>
-<td>
-
-The filename for the game's executable (i.e. `StardewValley.exe` on Linux/macOS or
-`Stardew Valley.exe` on Windows). This is auto-detected, and you should almost never change this.
-
 </td>
 </tr>
 <tr>
@@ -382,13 +373,21 @@ when you compile it.
 ## Upcoming release
 * Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. **Older versions are no longer supported.**
 * Added `IgnoreModFilePaths` option to ignore literal paths.
+* Removed the `GameExecutableName` build property (since it now has the same value on all platforms).
 * Improved analyzer performance by enabling parallel execution.
 
+**Migration guide for mod authors:**
+1. See [_migrate to 64-bit_](https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows) and
+   [_migrate to Stardew Valley 1.5.5_](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5).
+2. Possible changes in your `.csproj` or `.targets` files:
+   * If you use `$(GameExecutableName)`, replace it with `Stardew Valley`.
+
 ## 3.3.0
 Released 30 March 2021.
 
 * Added a build warning when the mod isn't compiled for `Any CPU`.
-* Added a `GameFramework` build property set to `MonoGame` or `Xna` based on the platform. This can be overridden to change which framework it references.
+* Added a `GameFramework` build property set to `MonoGame` or `Xna` based on the platform. This can
+  be overridden to change which framework it references.
 * Added support for building mods against the 64-bit Linux version of the game on Windows.
 * The package now suppresses the misleading 'processor architecture mismatch' warnings.
 
@@ -396,7 +395,8 @@ Released 30 March 2021.
 Released 23 September 2020.
 
 * Reworked and streamlined how the package is compiled.
-* Added [SMAPI-ModTranslationClassBuilder](https://github.com/Pathoschild/SMAPI-ModTranslationClassBuilder) files to the ignore list.
+* Added [SMAPI-ModTranslationClassBuilder](https://github.com/Pathoschild/SMAPI-ModTranslationClassBuilder)
+  files to the ignore list.
 
 ### 3.2.1
 Released 11 September 2020.
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index b254dd7c..6fc62046 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -48,7 +48,7 @@
   **********************************************-->
   <ItemGroup>
     <!-- game -->
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="$(CopyModReferencesToBuildOutput)" />
+    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(CopyModReferencesToBuildOutput)" />
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="$(CopyModReferencesToBuildOutput)" />
@@ -71,7 +71,7 @@
 
     <!-- invalid game path -->
     <Error Condition="!Exists('$(GamePath)')" Text="The mod build package can't find your game folder. You can specify where to find it; see https://smapi.io/package/custom-game-path." ContinueOnError="false" />
-    <Error Condition="!Exists('$(GamePath)\$(GameExecutableName).dll')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain the $(GameExecutableName) file. If this folder is invalid, delete it and the package will autodetect another game install path." ContinueOnError="false" />
+    <Error Condition="!Exists('$(GamePath)\Stardew Valley.dll')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain the Stardew Valley file. If this folder is invalid, delete it and the package will autodetect another game install path." ContinueOnError="false" />
     <Error Condition="!Exists('$(GamePath)\StardewModdingAPI.dll')" Text="The mod build package found a game folder at $(GamePath), but it doesn't contain SMAPI. You need to install SMAPI before building the mod." ContinueOnError="false" />
 
     <!-- invalid target architecture (note: internal value is 'AnyCPU', value shown in Visual Studio is 'Any CPU') -->
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index 65d54599..52439c41 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -13,8 +13,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
+    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
   </ItemGroup>
 
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 2ad19df7..78cdb315 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -14,8 +14,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
+    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
diff --git a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
index f8908c7d..a8b0dfdb 100644
--- a/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
+++ b/src/SMAPI.Mods.SaveBackup/SMAPI.Mods.SaveBackup.csproj
@@ -13,7 +13,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
+    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="False" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index e19105ff..8329b2e1 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -23,10 +23,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Reference Include="$(GameExecutableName)">
-      <HintPath>$(GamePath)\$(GameExecutableName).dll</HintPath>
-      <Private>True</Private>
-    </Reference>
+    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="True" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 16ddb92a..4f9aa9b1 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -29,7 +29,7 @@
 
   <ItemGroup>
     <Reference Include="..\..\build\0Harmony.dll" Private="True" />
-    <Reference Include="$(GameExecutableName)" HintPath="$(GamePath)\$(GameExecutableName).dll" Private="False" />
+    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
     <Reference Include="GalaxyCSharp" HintPath="$(GamePath)\GalaxyCSharp.dll" Private="False" />
     <Reference Include="Lidgren.Network" HintPath="$(GamePath)\Lidgren.Network.dll" Private="False" />

From bf10aeef0afae20e1d79f0772ba41a38fcb572ae Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Sep 2021 18:59:25 -0400
Subject: [PATCH 345/856] remove GameFramework build property from package

---
 docs/technical/mod-package.md                 | 20 +++++++------------
 src/SMAPI.ModBuildConfig/build/smapi.targets  |  3 ---
 src/SMAPI/Constants.cs                        |  3 +--
 .../Framework/ModLoading/AssemblyLoader.cs    |  5 ++---
 src/SMAPI/Framework/SCore.cs                  |  2 +-
 5 files changed, 11 insertions(+), 22 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 5eff3d2e..2e26275b 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -32,10 +32,10 @@ change how these work):
   `$(GamePath)` and `$(GameModsPath)`.
 
 * **Add assembly references:**  
-  The package adds assembly references to SMAPI, Stardew Valley, xTile, and the game framework
-  (MonoGame on Linux/macOS, XNA Framework on Windows). It automatically adjusts depending on which OS
-  you're compiling it on. If you use [Harmony](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Harmony),
-  it can optionally add a reference to that too.
+  The package adds assembly references to MonoGame, SMAPI, Stardew Valley, and xTile. It
+  automatically adjusts depending on which OS you're compiling it on. If you use
+  [Harmony](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Harmony), it can optionally add
+  a reference to that too.
 
 * **Copy files into the `Mods` folder:**  
   The package automatically copies your mod's DLL and PDB files, `manifest.json`, [`i18n`
@@ -129,14 +129,6 @@ The absolute path to the folder containing the game's installed mods (defaults t
 </td>
 </tr>
 <tr>
-<td><code>GameFramework</code></td>
-<td>
-
-The game framework for which the mod is being compiled (one of `Xna` or `MonoGame`). This is
-auto-detected based on the platform, and you should almost never change this.
-
-</td>
-</tr>
 </table>
 </li>
 
@@ -373,7 +365,8 @@ when you compile it.
 ## Upcoming release
 * Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. **Older versions are no longer supported.**
 * Added `IgnoreModFilePaths` option to ignore literal paths.
-* Removed the `GameExecutableName` build property (since it now has the same value on all platforms).
+* Removed the `GameExecutableName` and `GameFramework` build properties (since they now have the
+  same value on all platforms).
 * Improved analyzer performance by enabling parallel execution.
 
 **Migration guide for mod authors:**
@@ -381,6 +374,7 @@ when you compile it.
    [_migrate to Stardew Valley 1.5.5_](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5).
 2. Possible changes in your `.csproj` or `.targets` files:
    * If you use `$(GameExecutableName)`, replace it with `Stardew Valley`.
+   * If you use `$(GameFramework)`, replace it with `MonoGame` and remove any XNA-specific logic.
 
 ## 3.3.0
 Released 30 March 2021.
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 6fc62046..8ad298d0 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -30,9 +30,6 @@
     <EnableHarmony Condition="'$(EnableHarmony)' == ''">false</EnableHarmony>
     <EnableGameDebugging Condition="'$(EnableGameDebugging)' == ''">true</EnableGameDebugging>
     <CopyModReferencesToBuildOutput Condition="'$(CopyModReferencesToBuildOutput)' == '' OR ('$(CopyModReferencesToBuildOutput)' != 'true' AND '$(CopyModReferencesToBuildOutput)' != 'false')">false</CopyModReferencesToBuildOutput>
-
-    <GameFramework Condition="'$(GameFramework)' == '' AND '$(OS)' == 'Windows_NT'">Xna</GameFramework>
-    <GameFramework Condition="'$(GameFramework)' == ''">MonoGame</GameFramework>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(OS)' == 'Windows_NT' AND '$(EnableGameDebugging)' == 'true'">
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 2c16052b..3ae8661a 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -241,8 +241,7 @@ namespace StardewModdingAPI
 
         /// <summary>Get metadata for mapping assemblies to the current platform.</summary>
         /// <param name="targetPlatform">The target game platform.</param>
-        /// <param name="framework">The game framework running the game.</param>
-        internal static PlatformAssemblyMap GetAssemblyMap(Platform targetPlatform, GameFramework framework)
+        internal static PlatformAssemblyMap GetAssemblyMap(Platform targetPlatform)
         {
             var removeAssemblyReferences = new List<string>();
             var targetAssemblies = new List<Assembly>();
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 57a76a35..cb5fa2ae 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -53,16 +53,15 @@ namespace StardewModdingAPI.Framework.ModLoading
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="targetPlatform">The current game platform.</param>
-        /// <param name="framework">The game framework running the game.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
         /// <param name="paranoidMode">Whether to detect paranoid mode issues.</param>
         /// <param name="rewriteMods">Whether to rewrite mods for compatibility.</param>
-        public AssemblyLoader(Platform targetPlatform, GameFramework framework, IMonitor monitor, bool paranoidMode, bool rewriteMods)
+        public AssemblyLoader(Platform targetPlatform, IMonitor monitor, bool paranoidMode, bool rewriteMods)
         {
             this.Monitor = monitor;
             this.ParanoidMode = paranoidMode;
             this.RewriteMods = rewriteMods;
-            this.AssemblyMap = this.TrackForDisposal(Constants.GetAssemblyMap(targetPlatform, framework));
+            this.AssemblyMap = this.TrackForDisposal(Constants.GetAssemblyMap(targetPlatform));
 
             // init resolver
             this.AssemblyDefinitionResolver = this.TrackForDisposal(new AssemblyDefinitionResolver());
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index a0467daa..55a7f083 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1473,7 +1473,7 @@ namespace StardewModdingAPI.Framework
 
             // load mods
             IList<IModMetadata> skippedMods = new List<IModMetadata>();
-            using (AssemblyLoader modAssemblyLoader = new AssemblyLoader(Constants.Platform, Constants.GameFramework, this.Monitor, this.Settings.ParanoidWarnings, this.Settings.RewriteMods))
+            using (AssemblyLoader modAssemblyLoader = new AssemblyLoader(Constants.Platform, this.Monitor, this.Settings.ParanoidWarnings, this.Settings.RewriteMods))
             {
                 // init
                 HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);

From f5807e22be157d908e3b8c65f19acaa16c3588e7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Sep 2021 22:47:05 -0400
Subject: [PATCH 346/856] add BundleExtraAssemblies package option for new .NET
 5 reference model

---
 docs/technical/mod-package.md                 | 100 ++++++++++----
 src/SMAPI.ModBuildConfig/DeployModTask.cs     |  34 ++++-
 .../Framework/ExtraAssemblyType.cs            |  21 +++
 .../Framework/ModFileManager.cs               | 124 ++++++++++++++----
 src/SMAPI.ModBuildConfig/build/smapi.targets  |  22 ++--
 5 files changed, 244 insertions(+), 57 deletions(-)
 create mode 100644 src/SMAPI.ModBuildConfig/Framework/ExtraAssemblyType.cs

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 2e26275b..93e0009d 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -39,10 +39,9 @@ change how these work):
 
 * **Copy files into the `Mods` folder:**  
   The package automatically copies your mod's DLL and PDB files, `manifest.json`, [`i18n`
-  files](https://stardewvalleywiki.com/Modding:Translations) (if any), the `assets` folder (if
-  any), and [build output](https://stackoverflow.com/a/10828462/262123) into your game's `Mods`
-  folder when you rebuild the code, with a subfolder matching the mod's project name. That lets you
-  try the mod in-game right after building it.
+  files](https://stardewvalleywiki.com/Modding:Translations) (if any), and the `assets` folder (if
+  any) into the `Mods` folder when you rebuild the code, with a subfolder matching the mod's project
+  name. That lets you try the mod in-game right after building it.
 
 * **Create release zip:**  
   The package adds a zip file in your project's `bin` folder when you rebuild the code, in the
@@ -189,11 +188,63 @@ The folder path where the release zip is created (defaults to the project's `bin
   <th>effect</th>
 </tr>
 <tr>
-<td><code>CopyModReferencesToBuildOutput</code></td>
+<td><code>BundleExtraAssemblies</code></td>
 <td>
 
-Whether to copy game and framework DLLs into the mod folder (default `false`). This is useful for
-unit test projects, but not needed for mods that'll be run through SMAPI.
+**Most mods should not change this option.**
+
+By default (when this is _not_ enabled), only the mod files [normally considered part of the
+mod](#Features) will be added to the release `.zip` and copied into the `Mods` folder (i.e.
+"deployed"). That includes the assembly files (`*.dll`, `*.pdb`, and `*.xml`) for your mod project,
+but any other DLLs won't be deployed.
+
+Enabling this option will add _all_ dependencies to the build output, then deploy _some_ of them
+depending on the comma-separated value(s) you set:
+
+<table>
+<tr>
+  <th>option</th>
+  <th>result</th>
+</tr>
+<tr>
+<td><code>ThirdParty</code></td>
+<td>
+
+Assembly files which don't match any other category.
+
+</td>
+</tr>
+<tr>
+<td><code>System</code></td>
+<td>
+
+Assembly files whose names start with `Microsoft.*` or `System.*`.
+
+</td>
+</tr>
+<tr>
+<td><code>Game</code></td>
+<td>
+
+Assembly files which are part of MonoGame, SMAPI, or Stardew Valley.
+
+</td>
+</tr>
+<tr>
+<td><code>All</code></td>
+<td>
+
+Equivalent to `System, Game, ThirdParty`.
+
+</td>
+</tr>
+</table>
+
+Most mods should omit the option. Some mods may need `ThirdParty` if they bundle third-party DLLs
+with their mod. The other options are mainly useful for unit tests.
+
+When enabling this option, you should **manually review which files get deployed** and use the
+`IgnoreModFilePaths` or `IgnoreModFilePatterns` options to exclude files as needed.
 
 </td>
 </tr>
@@ -327,16 +378,15 @@ The configuration will check your custom path first, then fall back to the defau
 still compile on a different computer).
 
 ### How do I change which files are included in the mod deploy/zip?
-For custom files, you can [add/remove them in the build output](https://stackoverflow.com/a/10828462/262123).
-(If your project references another mod, make sure the reference is [_not_ marked 'copy
-local'](https://msdn.microsoft.com/en-us/library/t1zz5y8c(v=vs.100).aspx).)
-
-To exclude a file the package copies by default, see `IgnoreModFilePatterns` under
-[_configure_](#configure).
+* For normal files, you can [add/remove them in the build output](https://stackoverflow.com/a/10828462/262123).
+* For assembly files (`*.dll`, `*.exe`, `*.pdb`, or `*.xml`), see the
+  [`BundleExtraAssemblies` option](#configure).
+* To exclude a file which the package copies by default, see the [`IgnoreModFilePaths` or
+  `IgnoreModFilePatterns` options](#configure).
 
 ### Can I use the package for non-mod projects?
-You can use the package in non-mod projects too (e.g. unit tests or framework DLLs). Just disable
-the mod-related package features (see [_configure_](#configure)):
+Yep, this works in unit tests and framework projects too. Just disable the mod-related package
+features (see [_configure_](#configure)):
 
 ```xml
 <EnableGameDebugging>false</EnableGameDebugging>
@@ -344,9 +394,9 @@ the mod-related package features (see [_configure_](#configure)):
 <EnableModZip>false</EnableModZip>
 ```
 
-If you need to copy the referenced DLLs into your build output, add this too:
+To copy referenced DLLs into your build output for unit tests, add this too:
 ```xml
-<CopyModReferencesToBuildOutput>true</CopyModReferencesToBuildOutput>
+<BundleExtraAssemblies>All</BundleExtraAssemblies>
 ```
 
 ## For SMAPI developers
@@ -363,18 +413,24 @@ when you compile it.
 
 ## Release notes
 ## Upcoming release
-* Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. **Older versions are no longer supported.**
+* Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. (Older versions are no longer supported.)
 * Added `IgnoreModFilePaths` option to ignore literal paths.
-* Removed the `GameExecutableName` and `GameFramework` build properties (since they now have the
-  same value on all platforms).
+* Added `BundleExtraAssemblies` option to copy bundled DLLs into the mod zip/folder.
+* Removed the `GameExecutableName` and `GameFramework` options (since they now have the same value
+  on all platforms).
+* Removed the `CopyModReferencesToBuildOutput` option (superseded by `BundleExtraAssemblies`).
 * Improved analyzer performance by enabling parallel execution.
 
 **Migration guide for mod authors:**
 1. See [_migrate to 64-bit_](https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows) and
    [_migrate to Stardew Valley 1.5.5_](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5).
 2. Possible changes in your `.csproj` or `.targets` files:
-   * If you use `$(GameExecutableName)`, replace it with `Stardew Valley`.
-   * If you use `$(GameFramework)`, replace it with `MonoGame` and remove any XNA-specific logic.
+   * Replace `$(GameExecutableName)` with `Stardew Valley`.
+   * Replace `$(GameFramework)` with `MonoGame` and remove any XNA Framework-specific logic.
+   * Replace `<CopyModReferencesToBuildOutput>true</CopyModReferencesToBuildOutput>` with
+     `<BundleExtraAssemblies>Game</BundleExtraAssemblies>`.
+   * If you need to bundle extra DLLs besides your mod DLL, see the [`BundleExtraAssemblies`
+     documentation](#configure).
 
 ## 3.3.0
 Released 30 March 2021.
diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index 0c64aed3..140933bd 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -18,6 +18,10 @@ namespace StardewModdingAPI.ModBuildConfig
         /*********
         ** Accessors
         *********/
+        /// <summary>The name (without extension or path) of the current mod's DLL.</summary>
+        [Required]
+        public string ModDllName { get; set; }
+
         /// <summary>The name of the mod folder.</summary>
         [Required]
         public string ModFolderName { get; set; }
@@ -52,6 +56,9 @@ namespace StardewModdingAPI.ModBuildConfig
         /// <summary>A comma-separated list of relative file paths to ignore when deploying or zipping the mod.</summary>
         public string IgnoreModFilePaths { get; set; }
 
+        /// <summary>A comma-separated list of <see cref="ExtraAssemblyTypes"/> values which indicate which extra DLLs to bundle.</summary>
+        public string BundleExtraAssemblies { get; set; }
+
 
         /*********
         ** Public methods
@@ -73,12 +80,15 @@ namespace StardewModdingAPI.ModBuildConfig
 
             try
             {
+                // parse extra DLLs to bundle
+                ExtraAssemblyTypes bundleAssemblyTypes = this.GetExtraAssembliesToBundleOption();
+
                 // parse ignore patterns
                 string[] ignoreFilePaths = this.GetCustomIgnoreFilePaths().ToArray();
                 Regex[] ignoreFilePatterns = this.GetCustomIgnorePatterns().ToArray();
 
                 // get mod info
-                ModFileManager package = new ModFileManager(this.ProjectDir, this.TargetDir, ignoreFilePaths, ignoreFilePatterns, validateRequiredModFiles: this.EnableModDeploy || this.EnableModZip);
+                ModFileManager package = new ModFileManager(this.ProjectDir, this.TargetDir, ignoreFilePaths, ignoreFilePatterns, bundleAssemblyTypes, this.ModDllName, validateRequiredModFiles: this.EnableModDeploy || this.EnableModZip);
 
                 // deploy mod files
                 if (this.EnableModDeploy)
@@ -139,6 +149,28 @@ namespace StardewModdingAPI.ModBuildConfig
             }
         }
 
+        /// <summary>Parse the extra assembly types which should be bundled with the mod.</summary>
+        private ExtraAssemblyTypes GetExtraAssembliesToBundleOption()
+        {
+            ExtraAssemblyTypes flags = ExtraAssemblyTypes.None;
+
+            if (!string.IsNullOrWhiteSpace(this.BundleExtraAssemblies))
+            {
+                foreach (string raw in this.BundleExtraAssemblies.Split(','))
+                {
+                    if (!Enum.TryParse(raw, out ExtraAssemblyTypes type))
+                    {
+                        this.Log.LogWarning($"[mod build package] Ignored invalid <{nameof(this.BundleExtraAssemblies)}> value '{raw}', expected one of '{string.Join("', '", Enum.GetNames(typeof(ExtraAssemblyTypes)))}'.");
+                        continue;
+                    }
+
+                    flags |= type;
+                }
+            }
+
+            return flags;
+        }
+
         /// <summary>Get the custom ignore patterns provided by the user.</summary>
         private IEnumerable<Regex> GetCustomIgnorePatterns()
         {
diff --git a/src/SMAPI.ModBuildConfig/Framework/ExtraAssemblyType.cs b/src/SMAPI.ModBuildConfig/Framework/ExtraAssemblyType.cs
new file mode 100644
index 00000000..571bf7c7
--- /dev/null
+++ b/src/SMAPI.ModBuildConfig/Framework/ExtraAssemblyType.cs
@@ -0,0 +1,21 @@
+using System;
+
+namespace StardewModdingAPI.ModBuildConfig.Framework
+{
+    /// <summary>An extra assembly type for the <see cref="DeployModTask.BundleExtraAssemblies"/> field.</summary>
+    [Flags]
+    internal enum ExtraAssemblyTypes
+    {
+        /// <summary>Don't include extra assemblies.</summary>
+        None = 0,
+
+        /// <summary>Assembly files which are part of MonoGame, SMAPI, or Stardew Valley.</summary>
+        Game = 1,
+
+        /// <summary>Assembly files whose names start with <c>Microsoft.*</c> or <c>System.*</c>.</summary>
+        System = 2,
+
+        /// <summary>Assembly files which don't match any other category.</summary>
+        ThirdParty = 4
+    }
+}
diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index fbb91193..ad4ffdf9 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -21,6 +21,45 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
         /// <summary>The files that are part of the package.</summary>
         private readonly IDictionary<string, FileInfo> Files;
 
+        /// <summary>The file extensions used by assembly files.</summary>
+        private readonly ISet<string> AssemblyFileExtensions = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
+        {
+            ".dll",
+            ".exe",
+            ".pdb",
+            ".xml"
+        };
+
+        /// <summary>The DLLs which match the <see cref="ExtraAssemblyTypes.Game"/> type.</summary>
+        private readonly ISet<string> GameDllNames = new HashSet<string>
+        {
+            // SMAPI
+            "0Harmony",
+            "Mono.Cecil",
+            "Mono.Cecil.Mdb",
+            "Mono.Cecil.Pdb",
+            "MonoMod.Common",
+            "Newtonsoft.Json",
+            "StardewModdingAPI",
+            "SMAPI.Toolkit",
+            "SMAPI.Toolkit.CoreInterfaces",
+            "TMXTile",
+
+            // game + framework
+            "BmFont",
+            "FAudio-CS",
+            "GalaxyCSharp",
+            "GalaxyCSharpGlue",
+            "Lidgren.Network",
+            "MonoGame.Framework",
+            "SkiaSharp",
+            "Stardew Valley",
+            "StardewValley.GameData",
+            "Steamworks.NET",
+            "TextCopy",
+            "xTile"
+        };
+
 
         /*********
         ** Public methods
@@ -30,9 +69,11 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
         /// <param name="targetDir">The folder containing the build output.</param>
         /// <param name="ignoreFilePaths">The custom relative file paths provided by the user to ignore.</param>
         /// <param name="ignoreFilePatterns">Custom regex patterns matching files to ignore when deploying or zipping the mod.</param>
+        /// <param name="bundleAssemblyTypes">The extra assembly types which should be bundled with the mod.</param>
+        /// <param name="modDllName">The name (without extension or path) for the current mod's DLL.</param>
         /// <param name="validateRequiredModFiles">Whether to validate that required mod files like the manifest are present.</param>
         /// <exception cref="UserErrorException">The mod package isn't valid.</exception>
-        public ModFileManager(string projectDir, string targetDir, string[] ignoreFilePaths, Regex[] ignoreFilePatterns, bool validateRequiredModFiles)
+        public ModFileManager(string projectDir, string targetDir, string[] ignoreFilePaths, Regex[] ignoreFilePatterns, ExtraAssemblyTypes bundleAssemblyTypes, string modDllName, bool validateRequiredModFiles)
         {
             this.Files = new Dictionary<string, FileInfo>(StringComparer.OrdinalIgnoreCase);
 
@@ -48,7 +89,7 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
                 string relativePath = entry.Item1;
                 FileInfo file = entry.Item2;
 
-                if (!this.ShouldIgnore(file, relativePath, ignoreFilePaths, ignoreFilePatterns))
+                if (!this.ShouldIgnore(file, relativePath, ignoreFilePaths, ignoreFilePatterns, bundleAssemblyTypes, modDllName))
                     this.Files[relativePath] = file;
             }
 
@@ -152,39 +193,70 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
         /// <param name="relativePath">The file's relative path in the package.</param>
         /// <param name="ignoreFilePaths">The custom relative file paths provided by the user to ignore.</param>
         /// <param name="ignoreFilePatterns">Custom regex patterns matching files to ignore when deploying or zipping the mod.</param>
-        private bool ShouldIgnore(FileInfo file, string relativePath, string[] ignoreFilePaths, Regex[] ignoreFilePatterns)
+        /// <param name="bundleAssemblyTypes">The extra assembly types which should be bundled with the mod.</param>
+        /// <param name="modDllName">The name (without extension or path) for the current mod's DLL.</param>
+        private bool ShouldIgnore(FileInfo file, string relativePath, string[] ignoreFilePaths, Regex[] ignoreFilePatterns, ExtraAssemblyTypes bundleAssemblyTypes, string modDllName)
         {
-            bool IsAssemblyFile(string baseName)
+            // apply custom patterns
+            if (ignoreFilePaths.Any(p => p == relativePath) || ignoreFilePatterns.Any(p => p.IsMatch(relativePath)))
+                return true;
+
+            // ignore unneeded files
             {
-                return
-                    this.EqualsInvariant(file.Name, $"{baseName}.dll")
-                    || this.EqualsInvariant(file.Name, $"{baseName}.pdb")
-                    || this.EqualsInvariant(file.Name, $"{baseName}.xnb");
+                bool shouldIgnore =
+                    // release zips
+                    this.EqualsInvariant(file.Extension, ".zip")
+
+                    // *.deps.json (only SMAPI's top-level one is used)
+                    || file.Name.EndsWith(".deps.json")
+
+                    // code analysis files
+                    || file.Name.EndsWith(".CodeAnalysisLog.xml", StringComparison.OrdinalIgnoreCase)
+                    || file.Name.EndsWith(".lastcodeanalysissucceeded", StringComparison.OrdinalIgnoreCase)
+
+                    // translation class builder (not used at runtime)
+                    || (
+                        file.Name.StartsWith("Pathoschild.Stardew.ModTranslationClassBuilder")
+                        && this.AssemblyFileExtensions.Contains(file.Extension)
+                    )
+
+                    // OS metadata files
+                    || this.EqualsInvariant(file.Name, ".DS_Store")
+                    || this.EqualsInvariant(file.Name, "Thumbs.db");
+                if (shouldIgnore)
+                    return true;
             }
 
-            return
-                // release zips
-                this.EqualsInvariant(file.Extension, ".zip")
+            // check for bundled assembly types
+            // When bundleAssemblyTypes is set, *all* dependencies are copied into the build output but only those which match the given assembly types should be bundled.
+            if (bundleAssemblyTypes != ExtraAssemblyTypes.None)
+            {
+                var type = this.GetExtraAssemblyType(file, modDllName);
+                if (type != ExtraAssemblyTypes.None && !bundleAssemblyTypes.HasFlag(type))
+                    return true;
+            }
 
-                // unneeded *.deps.json (only SMAPI's top-level one is used)
-                || file.Name.EndsWith(".deps.json")
+            return false;
+        }
 
-                // dependencies bundled with SMAPI
-                || IsAssemblyFile("0Harmony")
-                || IsAssemblyFile("Newtonsoft.Json")
-                || IsAssemblyFile("Pathoschild.Stardew.ModTranslationClassBuilder") // not used at runtime
+        /// <summary>Get the extra assembly type for a file, assuming that the user specified one or more extra types to bundle.</summary>
+        /// <param name="file">The file to check.</param>
+        /// <param name="modDllName">The name (without extension or path) for the current mod's DLL.</param>
+        private ExtraAssemblyTypes GetExtraAssemblyType(FileInfo file, string modDllName)
+        {
+            string baseName = Path.GetFileNameWithoutExtension(file.Name);
+            string extension = file.Extension;
 
-                // code analysis files
-                || file.Name.EndsWith(".CodeAnalysisLog.xml", StringComparison.OrdinalIgnoreCase)
-                || file.Name.EndsWith(".lastcodeanalysissucceeded", StringComparison.OrdinalIgnoreCase)
+            if (baseName == modDllName || !this.AssemblyFileExtensions.Contains(extension))
+                return ExtraAssemblyTypes.None;
 
-                // OS metadata files
-                || this.EqualsInvariant(file.Name, ".DS_Store")
-                || this.EqualsInvariant(file.Name, "Thumbs.db")
+            if (this.GameDllNames.Contains(baseName))
+                return ExtraAssemblyTypes.Game;
 
-                // custom ignore patterns
-                || ignoreFilePaths.Any(p => p == relativePath)
-                || ignoreFilePatterns.Any(p => p.IsMatch(relativePath));
+            if (baseName.StartsWith("System.", StringComparison.OrdinalIgnoreCase) || baseName.StartsWith("Microsoft.", StringComparison.OrdinalIgnoreCase))
+                return ExtraAssemblyTypes.System;
+
+            return ExtraAssemblyTypes.ThirdParty;
         }
 
         /// <summary>Get whether a string is equal to another case-insensitively.</summary>
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 8ad298d0..de00cbe8 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -29,7 +29,10 @@
     <EnableModZip Condition="'$(EnableModZip)' == ''">true</EnableModZip>
     <EnableHarmony Condition="'$(EnableHarmony)' == ''">false</EnableHarmony>
     <EnableGameDebugging Condition="'$(EnableGameDebugging)' == ''">true</EnableGameDebugging>
-    <CopyModReferencesToBuildOutput Condition="'$(CopyModReferencesToBuildOutput)' == '' OR ('$(CopyModReferencesToBuildOutput)' != 'true' AND '$(CopyModReferencesToBuildOutput)' != 'false')">false</CopyModReferencesToBuildOutput>
+    <BundleExtraAssemblies Condition="'$(BundleExtraAssemblies)' == ''"></BundleExtraAssemblies>
+
+    <!-- coppy referenced DLLs into build output -->
+    <CopyLocalLockFileAssemblies Condition="$(BundleExtraAssemblies.Contains('ThirdParty')) OR $(BundleExtraAssemblies.Contains('Game')) OR $(BundleExtraAssemblies.Contains('System')) OR $(BundleExtraAssemblies.Contains('All'))">true</CopyLocalLockFileAssemblies>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(OS)' == 'Windows_NT' AND '$(EnableGameDebugging)' == 'true'">
@@ -45,17 +48,17 @@
   **********************************************-->
   <ItemGroup>
     <!-- game -->
-    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="$(CopyModReferencesToBuildOutput)" />
-    <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="$(CopyModReferencesToBuildOutput)" />
-    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(CopyModReferencesToBuildOutput)" />
-    <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="$(CopyModReferencesToBuildOutput)" />
+    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
+    <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
+    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
+    <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
 
     <!-- SMAPI -->
-    <Reference Include="StardewModdingAPI" HintPath="$(GamePath)\StardewModdingAPI.dll" Private="$(CopyModReferencesToBuildOutput)" />
-    <Reference Include="SMAPI.Toolkit.CoreInterfaces" HintPath="$(GamePath)\smapi-internal\SMAPI.Toolkit.CoreInterfaces.dll" Private="$(CopyModReferencesToBuildOutput)" />
+    <Reference Include="StardewModdingAPI" HintPath="$(GamePath)\StardewModdingAPI.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
+    <Reference Include="SMAPI.Toolkit.CoreInterfaces" HintPath="$(GamePath)\smapi-internal\SMAPI.Toolkit.CoreInterfaces.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
 
     <!-- Harmony -->
-    <Reference Include="0Harmony" Condition="'$(EnableHarmony)' == 'true'" HintPath="$(GamePath)\smapi-internal\0Harmony.dll" Private="$(CopyModReferencesToBuildOutput)" />
+    <Reference Include="0Harmony" Condition="'$(EnableHarmony)' == 'true'" HintPath="$(GamePath)\smapi-internal\0Harmony.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
   </ItemGroup>
 
 
@@ -81,6 +84,7 @@
   **********************************************-->
   <Target Name="AfterBuild">
     <DeployModTask
+      ModDllName="$(TargetName)"
       ModFolderName="$(ModFolderName)"
       ModZipPath="$(ModZipPath)"
 
@@ -92,6 +96,8 @@
       GameModsDir="$(GameModsPath)"
       IgnoreModFilePatterns="$(IgnoreModFilePatterns)"
       IgnoreModFilePaths="$(IgnoreModFilePaths)"
+
+      BundleExtraAssemblies="$(BundleExtraAssemblies)"
     />
   </Target>
 </Project>

From 3beb2a99402b9f0e570e9c46cac7667044f736d3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Sep 2021 22:51:25 -0400
Subject: [PATCH 347/856] remove package workaround no longer needed with
 MonoGame

---
 src/SMAPI.ModBuildConfig/build/smapi.targets | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index de00cbe8..b66ec27b 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -12,9 +12,6 @@
     <DebugType>pdbonly</DebugType>
     <DebugSymbols>true</DebugSymbols>
 
-    <!-- recognise XNA Framework DLLs in the GAC (only affects mods using new csproj format) -->
-    <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
-
     <!-- don't create the 'refs' folder (which isn't useful for mods) -->
     <ProduceReferenceAssembly>false</ProduceReferenceAssembly>
 

From 50a492f6e96ff596dd1642429fa7e3bd2adf975b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Sep 2021 22:52:29 -0400
Subject: [PATCH 348/856] bump upcoming mod build package version

---
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 33356413..0bc8c45e 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -9,7 +9,7 @@
     <!--NuGet package-->
     <PackageId>Pathoschild.Stardew.ModBuildConfig</PackageId>
     <Title>Build package for SMAPI mods</Title>
-    <Version>3.4.0</Version>
+    <Version>4.0.0</Version>
     <Authors>Pathoschild</Authors>
     <Description>Automates the build configuration for crossplatform Stardew Valley SMAPI mods. For SMAPI 3.13.0 or later.</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>

From f3626992cf17cfab6e9be65dd30f4a446c30c071 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 22 Sep 2021 00:36:31 -0400
Subject: [PATCH 349/856] remove walls_and_floors asset propagation

This is now added as a regular map tilesheet, so it'll be handled by the tilesheet asset propagation.
---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 1780b280..552bc000 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -442,10 +442,6 @@ namespace StardewModdingAPI.Metadata
                     Game1.objectSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
-                case "maps\\walls_and_floors": // Wallpaper
-                    Wallpaper.wallpaperTexture = content.Load<Texture2D>(key);
-                    return true;
-
                 /****
                 ** Content\Minigames
                 ****/

From 65046c3c409df9c2cd4897f8358b259726ff496a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 22 Sep 2021 00:38:42 -0400
Subject: [PATCH 350/856] remove outdated note in config.json

---
 src/SMAPI/SMAPI.config.json | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 7b5625d6..e62c8880 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -76,8 +76,6 @@ copy all the settings, or you may cause bugs due to overridden changes in future
 
     /**
      * The base URL for SMAPI's web API, used to perform update checks.
-     * Note: the protocol will be changed to http:// on Linux/macOS due to OpenSSL issues with the
-     * game's bundled Mono.
      */
     "WebApiBaseUrl": "https://smapi.io/api/",
 

From b791e854c1f2117f0cc218485ec767a493a3d847 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 23 Sep 2021 23:11:54 -0400
Subject: [PATCH 351/856] fix installer precheck errors showing quotes, tweak
 readability

---
 src/SMAPI.Installer/assets/windows-install.bat | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index 8623f321..00a2c6fb 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -3,7 +3,8 @@
 REM make sure we're not running within a zip folder
 echo "%~dp0" | findstr /C:"%TEMP%" 1>nul
 if %ERRORLEVEL% EQU 0 (
-    echo "Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first."
+    echo Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first.
+    echo.
     pause
     exit
 )
@@ -11,14 +12,17 @@ if %ERRORLEVEL% EQU 0 (
 REM make sure .NET 5 is installed
 WHERE dotnet /q
 if %ERRORLEVEL% NEQ 0 (
-    echo "Oops! You must have .NET 5 (desktop x64) installed to use SMAPI: https://dotnet.microsoft.com/download/dotnet/5.0/runtime"
+    echo Oops! You must have .NET 5 ^(desktop x64^) installed to use SMAPI: https://dotnet.microsoft.com/download/dotnet/5.0/runtime
+    echo.
     pause
     exit
 )
 
 REM make sure an antivirus hasn't deleted the installer DLL
 if not exist internal\windows\SMAPI.Installer.dll (
-    echo "Oops! SMAPI can't find its 'internal\windows\SMAPI.Installer.dll' file. Your antivirus might have deleted the file."
+    echo Oops! SMAPI is missing one of its files. Your antivirus might have deleted it.
+    echo Missing file: %installerDir%internal\windows\SMAPI.Installer.dll
+    echo.
     pause
     exit
 )

From 32ccc8e87294fae4caaf7878ee852ab89b9cfdfd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 23 Sep 2021 23:12:43 -0400
Subject: [PATCH 352/856] fix installer file precheck failing for some users

---
 src/SMAPI.Installer/assets/windows-install.bat | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index 00a2c6fb..bd6da962 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -1,7 +1,9 @@
 @echo off
 
+SET installerDir=%~dp0
+
 REM make sure we're not running within a zip folder
-echo "%~dp0" | findstr /C:"%TEMP%" 1>nul
+echo %installerDir% | findstr /C:"%TEMP%" 1>nul
 if %ERRORLEVEL% EQU 0 (
     echo Oops! It looks like you're running the installer from inside a zip file. Make sure you unzip the download first.
     echo.
@@ -19,7 +21,7 @@ if %ERRORLEVEL% NEQ 0 (
 )
 
 REM make sure an antivirus hasn't deleted the installer DLL
-if not exist internal\windows\SMAPI.Installer.dll (
+if not exist "%installerDir%internal\windows\SMAPI.Installer.dll" (
     echo Oops! SMAPI is missing one of its files. Your antivirus might have deleted it.
     echo Missing file: %installerDir%internal\windows\SMAPI.Installer.dll
     echo.

From 51c6ef9443c9d53448d39a97afde8a0fd23eec46 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 23 Sep 2021 23:13:17 -0400
Subject: [PATCH 353/856] fix .NET 5 precheck passing if player has .NET Core
 installed

---
 src/SMAPI.Installer/assets/windows-install.bat | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index bd6da962..cb96fc19 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -19,6 +19,13 @@ if %ERRORLEVEL% NEQ 0 (
     pause
     exit
 )
+dotnet --info | findstr /C:"Microsoft.WindowsDesktop.App 5." 1>nul
+if %ERRORLEVEL% NEQ 0 (
+    echo Oops! You must have .NET 5 ^(desktop x64^) installed to use SMAPI: https://dotnet.microsoft.com/download/dotnet/5.0/runtime
+    echo.
+    pause
+    exit
+)
 
 REM make sure an antivirus hasn't deleted the installer DLL
 if not exist "%installerDir%internal\windows\SMAPI.Installer.dll" (

From cb378a1c558dc2c5de9f2ab1ae9ba38b17d2ac7c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 23 Sep 2021 23:25:51 -0400
Subject: [PATCH 354/856] keep installer window open if it crashes

---
 docs/release-notes.md                          | 1 +
 src/SMAPI.Installer/assets/windows-install.bat | 9 +++++++++
 2 files changed, 10 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d6e22af4..f8c1b495 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@
   * Updated for Stardew Valley 1.5.5.
   * Updated compatibility list.
   * Added `set_farm_type` [console command](https://stardewvalleywiki.com/Modding:Console_commands#Console_commands) to change the current farm type.
+  * Fixed installer window closing immediately if the installer crashed.
 
 * For mod authors:
   * Migrated to 64-bit MonoGame and .NET 5 on all platforms (see [migration guide for mod authors](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5)).
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index cb96fc19..2e0be906 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -38,3 +38,12 @@ if not exist "%installerDir%internal\windows\SMAPI.Installer.dll" (
 
 REM start installer
 dotnet internal\windows\SMAPI.Installer.dll
+
+REM keep window open if it failed
+if %ERRORLEVEL% NEQ 0 (
+    echo.
+    echo Oops! The SMAPI installer seems to have failed. The error details may be shown above.
+    echo.
+    pause
+    exit
+)

From fe675540b5c3a48764e70c596132a3ed65a790fb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 25 Sep 2021 01:28:15 -0400
Subject: [PATCH 355/856] add map overlay patches

---
 docs/release-notes.md                         |  1 +
 .../Framework/Content/AssetDataForMap.cs      | 88 ++++++++++++-------
 src/SMAPI/IAssetDataForMap.cs                 |  3 +-
 src/SMAPI/PatchMapMode.cs                     | 15 ++++
 4 files changed, 72 insertions(+), 35 deletions(-)
 create mode 100644 src/SMAPI/PatchMapMode.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f8c1b495..69eab3ec 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 
 * For mod authors:
   * Migrated to 64-bit MonoGame and .NET 5 on all platforms (see [migration guide for mod authors](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5)).
+  * Added support for [map overlays via `asset.AsMap().PatchMap`](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Content#Edit_a_map).
 
 **Update note for players with older systems:**  
 The game now has two branches: the _main branch_ which you'll get by default, and an optional
diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 4f810948..0a5fa7e7 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Linq;
 using Microsoft.Xna.Framework;
 using StardewModdingAPI.Toolkit.Utilities;
+using StardewValley;
 using xTile;
 using xTile.Layers;
 using xTile.Tiles;
@@ -25,18 +26,17 @@ namespace StardewModdingAPI.Framework.Content
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced) { }
 
         /// <inheritdoc />
-        /// <remarks>Derived from <see cref="StardewValley.GameLocation.ApplyMapOverride"/> with a few changes:
+        /// <remarks>Derived from <see cref="GameLocation.ApplyMapOverride(Map,string,Rectangle?,Rectangle?)"/> with a few changes:
         /// - can be applied directly to the maps when loading, before the location is created;
-        /// - added support for source/target areas;
+        /// - added support for patch modes (overlay, replace by layer, or fully replace);
         /// - added disambiguation if source has a modified version of the same tilesheet, instead of copying tiles into the target tilesheet;
-        /// - changed to always overwrite tiles within the target area (to avoid edge cases where some tiles are only partly applied);
         /// - fixed copying tilesheets (avoid "The specified TileSheet was not created for use with this map" error);
         /// - fixed tilesheets not added at the end (via z_ prefix), which can cause crashes in game code which depends on hardcoded tilesheet indexes;
         /// - fixed issue where different tilesheets are linked by ID.
         /// </remarks>
-        public void PatchMap(Map source, Rectangle? sourceArea = null, Rectangle? targetArea = null)
+        public void PatchMap(Map source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMapMode patchMode = PatchMapMode.Overlay)
         {
-            var target = this.Data;
+            Map target = this.Data;
 
             // get areas
             {
@@ -84,10 +84,13 @@ namespace StardewModdingAPI.Framework.Content
                 tilesheetMap[sourceSheet] = targetSheet;
             }
 
-            // get layer map
-            IDictionary<Layer, Layer> layerMap = source.Layers.ToDictionary(p => p, p => target.GetLayer(p.Id));
+            // get target layers
+            IDictionary<Layer, Layer> sourceToTargetLayers = source.Layers.ToDictionary(p => p, p => target.GetLayer(p.Id));
+            HashSet<Layer> orphanedTargetLayers = new HashSet<Layer>(target.Layers.Except(sourceToTargetLayers.Values));
 
             // apply tiles
+            bool replaceAll = patchMode == PatchMapMode.Replace;
+            bool replaceByLayer = patchMode == PatchMapMode.ReplaceByLayer;
             for (int x = 0; x < sourceArea.Value.Width; x++)
             {
                 for (int y = 0; y < sourceArea.Value.Height; y++)
@@ -96,47 +99,37 @@ namespace StardewModdingAPI.Framework.Content
                     Point sourcePos = new Point(sourceArea.Value.X + x, sourceArea.Value.Y + y);
                     Point targetPos = new Point(targetArea.Value.X + x, targetArea.Value.Y + y);
 
+                    // replace tiles on target-only layers
+                    if (replaceAll)
+                    {
+                        foreach (Layer targetLayer in orphanedTargetLayers)
+                            targetLayer.Tiles[targetPos.X, targetPos.Y] = null;
+                    }
+
                     // merge layers
                     foreach (Layer sourceLayer in source.Layers)
                     {
                         // get layer
-                        Layer targetLayer = layerMap[sourceLayer];
+                        Layer targetLayer = sourceToTargetLayers[sourceLayer];
                         if (targetLayer == null)
                         {
                             target.AddLayer(targetLayer = new Layer(sourceLayer.Id, target, target.Layers[0].LayerSize, Layer.m_tileSize));
-                            layerMap[sourceLayer] = target.GetLayer(sourceLayer.Id);
+                            sourceToTargetLayers[sourceLayer] = target.GetLayer(sourceLayer.Id);
                         }
 
                         // copy layer properties
                         targetLayer.Properties.CopyFrom(sourceLayer.Properties);
 
-                        // copy tiles
+                        // create new tile
                         Tile sourceTile = sourceLayer.Tiles[sourcePos.X, sourcePos.Y];
-                        Tile targetTile;
-                        switch (sourceTile)
-                        {
-                            case StaticTile _:
-                                targetTile = new StaticTile(targetLayer, tilesheetMap[sourceTile.TileSheet], sourceTile.BlendMode, sourceTile.TileIndex);
-                                break;
+                        Tile newTile = sourceTile != null
+                            ? this.CreateTile(sourceTile, targetLayer, tilesheetMap[sourceTile.TileSheet])
+                            : null;
+                        newTile?.Properties.CopyFrom(sourceTile.Properties);
 
-                            case AnimatedTile animatedTile:
-                                {
-                                    StaticTile[] tileFrames = new StaticTile[animatedTile.TileFrames.Length];
-                                    for (int frame = 0; frame < animatedTile.TileFrames.Length; ++frame)
-                                    {
-                                        StaticTile frameTile = animatedTile.TileFrames[frame];
-                                        tileFrames[frame] = new StaticTile(targetLayer, tilesheetMap[frameTile.TileSheet], frameTile.BlendMode, frameTile.TileIndex);
-                                    }
-                                    targetTile = new AnimatedTile(targetLayer, tileFrames, animatedTile.FrameInterval);
-                                }
-                                break;
-
-                            default: // null or unhandled type
-                                targetTile = null;
-                                break;
-                        }
-                        targetTile?.Properties.CopyFrom(sourceTile.Properties);
-                        targetLayer.Tiles[targetPos.X, targetPos.Y] = targetTile;
+                        // replace tile
+                        if (newTile != null || replaceByLayer || replaceAll)
+                            targetLayer.Tiles[targetPos.X, targetPos.Y] = newTile;
                     }
                 }
             }
@@ -146,6 +139,33 @@ namespace StardewModdingAPI.Framework.Content
         /*********
         ** Private methods
         *********/
+        /// <summary>Create a new tile for the target map.</summary>
+        /// <param name="sourceTile">The source tile to copy.</param>
+        /// <param name="targetLayer">The target layer.</param>
+        /// <param name="targetSheet">The target tilesheet.</param>
+        private Tile CreateTile(Tile sourceTile, Layer targetLayer, TileSheet targetSheet)
+        {
+            switch (sourceTile)
+            {
+                case StaticTile _:
+                    return new StaticTile(targetLayer, targetSheet, sourceTile.BlendMode, sourceTile.TileIndex);
+
+                case AnimatedTile animatedTile:
+                    {
+                        StaticTile[] tileFrames = new StaticTile[animatedTile.TileFrames.Length];
+                        for (int frame = 0; frame < animatedTile.TileFrames.Length; ++frame)
+                        {
+                            StaticTile frameTile = animatedTile.TileFrames[frame];
+                            tileFrames[frame] = new StaticTile(targetLayer, targetSheet, frameTile.BlendMode, frameTile.TileIndex);
+                        }
+
+                        return new AnimatedTile(targetLayer, tileFrames, animatedTile.FrameInterval);
+                    }
+
+                default: // null or unhandled type
+                    return null;
+            }
+        }
         /// <summary>Normalize a map tilesheet path for comparison. This value should *not* be used as the actual tilesheet path.</summary>
         /// <param name="path">The path to normalize.</param>
         private string NormalizeTilesheetPathForComparison(string path)
diff --git a/src/SMAPI/IAssetDataForMap.cs b/src/SMAPI/IAssetDataForMap.cs
index bfaba9ba..47a33de8 100644
--- a/src/SMAPI/IAssetDataForMap.cs
+++ b/src/SMAPI/IAssetDataForMap.cs
@@ -13,6 +13,7 @@ namespace StardewModdingAPI
         /// <param name="source">The map from which to copy.</param>
         /// <param name="sourceArea">The tile area within the source map to copy, or <c>null</c> for the entire source map size. This must be within the bounds of the <paramref name="source"/> map.</param>
         /// <param name="targetArea">The tile area within the target map to overwrite, or <c>null</c> to patch the whole map. The original content within this area will be erased. This must be within the bounds of the existing map.</param>
-        void PatchMap(Map source, Rectangle? sourceArea = null, Rectangle? targetArea = null);
+        /// <param name="patchMode">Indicates how the map should be patched.</param>
+        void PatchMap(Map source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMapMode patchMode = PatchMapMode.Overlay);
     }
 }
diff --git a/src/SMAPI/PatchMapMode.cs b/src/SMAPI/PatchMapMode.cs
new file mode 100644
index 00000000..1f1ac6a9
--- /dev/null
+++ b/src/SMAPI/PatchMapMode.cs
@@ -0,0 +1,15 @@
+namespace StardewModdingAPI
+{
+    /// <summary>Indicates how a map should be patched.</summary>
+    public enum PatchMapMode
+    {
+        /// <summary>Replace matching tiles. Target tiles missing in the source area are kept as-is.</summary>
+        Overlay,
+
+        /// <summary>Replace all tiles on layers that exist in the source map.</summary>
+        ReplaceByLayer,
+
+        /// <summary>Replace all tiles with the source map.</summary>
+        Replace
+    }
+}

From f87e65caf5a71b3ab129c7a0cfd14d49f68dd9c1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 30 Oct 2021 21:23:28 -0400
Subject: [PATCH 356/856] update 'set_farm_type' console command for custom
 farm types

---
 .../Commands/Player/SetFarmTypeCommand.cs     | 186 +++++++++++++++---
 .../SMAPI.Mods.ConsoleCommands.csproj         |   1 +
 2 files changed, 159 insertions(+), 28 deletions(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
index 0bebd2b7..6b3b27cd 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
@@ -1,27 +1,23 @@
+using System;
+using System.Collections;
 using System.Collections.Generic;
 using System.Linq;
+using System.Reflection;
+using System.Text;
 using StardewValley;
+using StardewValley.GameData;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which changes the player's farm type.</summary>
     internal class SetFarmTypeCommand : ConsoleCommand
     {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The vanilla farm type IDs.</summary>
-        private static readonly ISet<int> VanillaFarmTypes = new HashSet<int>(
-            Enumerable.Range(0, Farm.layout_max + 1)
-        );
-
-
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
         public SetFarmTypeCommand()
-            : base("set_farm_type", $"Sets the current player's farm type.\n\nUsage: set_farm_type <farm type>\n- farm type: one of {string.Join(", ", SetFarmTypeCommand.VanillaFarmTypes.Select(id => $"{id} ({SetFarmTypeCommand.GetFarmLabel(id)})"))}.") { }
+            : base("set_farm_type", "Sets the current player's farm type.\n\nUsage: set_farm_type <farm type>\n- farm type: the farm type to set. Enter `set_farm_type list` for a list of available farm types.") { }
 
         /// <summary>Handle the command.</summary>
         /// <param name="monitor">Writes messages to the console and log file.</param>
@@ -29,47 +25,141 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         /// <param name="args">The command arguments.</param>
         public override void Handle(IMonitor monitor, string command, ArgumentParser args)
         {
-            // validation checks
+            // validate
             if (!Context.IsWorldReady)
             {
                 monitor.Log("You must load a save to use this command.", LogLevel.Error);
                 return;
             }
 
-            // parse argument
-            if (!args.TryGetInt(0, "farm type", out int farmType, min: 0, max: Farm.layout_max))
+            // parse arguments
+            if (!args.TryGet(0, "farm type", out string farmType))
                 return;
+            bool isVanillaId = int.TryParse(farmType, out int vanillaId) && vanillaId is (>= 0 and < Farm.layout_max);
 
-            // handle
-            if (Game1.whichFarm == farmType)
-            {
-                monitor.Log($"Your current farm is already set to {farmType} ({SetFarmTypeCommand.GetFarmLabel(farmType)}).", LogLevel.Info);
-                return;
-            }
-
-            this.SetFarmType(farmType);
-            monitor.Log($"Your current farm has been converted to {farmType} ({SetFarmTypeCommand.GetFarmLabel(farmType)}).", LogLevel.Warn);
-            monitor.Log("Saving and reloading is recommended to make sure everything is updated for the change.", LogLevel.Warn);
+            // handle argument
+            if (farmType == "list")
+                this.HandleList(monitor);
+            else if (isVanillaId)
+                this.HandleVanillaFarmType(vanillaId, monitor);
+            else
+                this.HandleCustomFarmType(farmType, monitor);
         }
 
 
         /*********
         ** Private methods
         *********/
-        /// <summary>Change the farm type to the given value.</summary>
-        /// <param name="type">The farm type ID.</param>
-        private void SetFarmType(int type)
+        /****
+        ** Handlers
+        ****/
+        /// <summary>Print a list of available farm types.</summary>
+        /// <param name="monitor">Writes messages to the console and log file.</param>
+        private void HandleList(IMonitor monitor)
         {
-            Game1.whichFarm = type;
+            StringBuilder result = new();
 
+            // list vanilla types
+            result.AppendLine("The farm type can be one of these vanilla types:");
+            foreach (var type in this.GetVanillaFarmTypes())
+                result.AppendLine($"   - {type.Key} ({type.Value})");
+            result.AppendLine();
+
+            // list custom types
+            {
+                var customTypes = this.GetCustomFarmTypes();
+                if (customTypes.Any())
+                {
+                    result.AppendLine("Or one of these custom farm types:");
+                    foreach (var type in customTypes.Values.OrderBy(p => p.ID))
+                        result.AppendLine($"   - {type.ID} ({this.GetCustomName(type)})");
+                }
+                else
+                    result.AppendLine("Or a custom farm type (though none is loaded currently).");
+            }
+
+            // print
+            monitor.Log(result.ToString(), LogLevel.Info);
+        }
+
+        /// <summary>Set a vanilla farm type.</summary>
+        /// <param name="type">The farm type.</param>
+        /// <param name="monitor">Writes messages to the console and log file.</param>
+        private void HandleVanillaFarmType(int type, IMonitor monitor)
+        {
+            if (Game1.whichFarm == type)
+            {
+                monitor.Log($"Your current farm is already set to {type} ({this.GetVanillaName(type)}).", LogLevel.Info);
+                return;
+            }
+
+            this.SetFarmType(type, null);
+            this.PrintSuccess(monitor, $"{type} ({this.GetVanillaName(type)}");
+        }
+
+        /// <summary>Set a custom farm type.</summary>
+        /// <param name="id">The farm type ID.</param>
+        /// <param name="monitor">Writes messages to the console and log file.</param>
+        private void HandleCustomFarmType(string id, IMonitor monitor)
+        {
+            if (Game1.whichModFarm?.ID == id)
+            {
+                monitor.Log($"Your current farm is already set to {id} ({this.GetCustomName(Game1.whichModFarm)}).", LogLevel.Info);
+                return;
+            }
+
+            if (!this.GetCustomFarmTypes().TryGetValue(id, out ModFarmType customFarmType))
+            {
+                monitor.Log($"Invalid farm type '{id}'. Enter `help set_farm_type` for more info.", LogLevel.Error);
+                return;
+            }
+
+            this.SetFarmType(Farm.mod_layout, customFarmType);
+            this.PrintSuccess(monitor, $"{id} ({this.GetCustomName(customFarmType)})");
+        }
+
+        /// <summary>Change the farm type.</summary>
+        /// <param name="type">The farm type ID.</param>
+        /// <param name="customFarmData">The custom farm type data, if applicable.</param>
+        private void SetFarmType(int type, ModFarmType customFarmData)
+        {
+            // set flags
+            Game1.whichFarm = type;
+            Game1.whichModFarm = customFarmData;
+
+            // update farm map
             Farm farm = Game1.getFarm();
             farm.mapPath.Value = $@"Maps\{Farm.getMapNameFromTypeInt(Game1.whichFarm)}";
             farm.reloadMap();
+
+            // clear spouse area cache to avoid errors
+            FieldInfo cacheField = farm.GetType().GetField("_baseSpouseAreaTiles", BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
+            if (cacheField == null)
+                throw new InvalidOperationException("Failed to access '_baseSpouseAreaTiles' field to clear spouse area cache.");
+            if (cacheField.GetValue(farm) is not IDictionary cache)
+                throw new InvalidOperationException($"The farm's '_baseSpouseAreaTiles' field didn't match the expected {nameof(IDictionary)} type.");
+            cache.Clear();
         }
 
+        private void PrintSuccess(IMonitor monitor, string label)
+        {
+            StringBuilder result = new();
+            result.AppendLine($"Your current farm has been converted to {label}. Saving and reloading is recommended to make sure everything is updated for the change.");
+            result.AppendLine();
+            result.AppendLine("This doesn't move items that are out of bounds on the new map. If you need to clean up, you can...");
+            result.AppendLine("   - temporarily switch back to the previous farm type;");
+            result.AppendLine("   - or use a mod like Noclip Mode: https://www.nexusmods.com/stardewvalley/mods/3900 ;");
+            result.AppendLine("   - or use the world_clear console command (enter `help world_clear` for details).");
+
+            monitor.Log(result.ToString(), LogLevel.Warn);
+        }
+
+        /****
+        ** Vanilla farm types
+        ****/
         /// <summary>Get the display name for a vanilla farm type.</summary>
         /// <param name="type">The farm type.</param>
-        private static string GetFarmLabel(int type)
+        private string GetVanillaName(int type)
         {
             string translationKey = type switch
             {
@@ -87,5 +177,45 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
                 ? Game1.content.LoadString(@$"Strings\UI:{translationKey}").Split('_')[0]
                 : type.ToString();
         }
+
+        /// <summary>Get the available vanilla farm types by ID.</summary>
+        private IDictionary<int, string> GetVanillaFarmTypes()
+        {
+            IDictionary<int, string> farmTypes = new Dictionary<int, string>();
+
+            foreach (int id in Enumerable.Range(0, Farm.layout_max))
+                farmTypes[id] = this.GetVanillaName(id);
+
+            return farmTypes;
+        }
+
+        /****
+        ** Custom farm types
+        ****/
+        /// <summary>Get the display name for a custom farm type.</summary>
+        /// <param name="farmType">The custom farm type.</param>
+        private string GetCustomName(ModFarmType farmType)
+        {
+            if (string.IsNullOrWhiteSpace(farmType?.TooltipStringPath))
+                return farmType?.ID;
+
+            return Game1.content.LoadString(farmType.TooltipStringPath)?.Split('_')[0] ?? farmType.ID;
+        }
+
+        /// <summary>Get the available custom farm types by ID.</summary>
+        private IDictionary<string, ModFarmType> GetCustomFarmTypes()
+        {
+            IDictionary<string, ModFarmType> farmTypes = new Dictionary<string, ModFarmType>(StringComparer.OrdinalIgnoreCase);
+
+            foreach (ModFarmType farmType in Game1.content.Load<List<ModFarmType>>("Data\\AdditionalFarms"))
+            {
+                if (string.IsNullOrWhiteSpace(farmType.ID))
+                    continue;
+
+                farmTypes[farmType.ID] = farmType;
+            }
+
+            return farmTypes;
+        }
     }
 }
diff --git a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
index 52439c41..e3db8b47 100644
--- a/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
+++ b/src/SMAPI.Mods.ConsoleCommands/SMAPI.Mods.ConsoleCommands.csproj
@@ -16,6 +16,7 @@
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
     <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
+    <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
 
   <ItemGroup>

From d1d09ae1df63826dd453aa0347d668f420754ed7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 25 Nov 2021 23:01:14 -0500
Subject: [PATCH 357/856] add support for loading BmFont files for custom
 languages

---
 docs/release-notes.md                                 |  1 +
 .../Framework/ContentManagers/ModContentManager.cs    | 11 ++++++++++-
 src/SMAPI/SMAPI.csproj                                |  1 +
 3 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 69eab3ec..d60156d5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,7 @@
 * For players:
   * Updated for Stardew Valley 1.5.5.
   * Updated compatibility list.
+  * Added support for loading BmFont `.fnt` files for [custom languages](https://stardewvalleywiki.com/Modding:Custom_languages) through the [content API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Content).
   * Added `set_farm_type` [console command](https://stardewvalleywiki.com/Modding:Console_commands#Console_commands) to change the current farm type.
   * Fixed installer window closing immediately if the installer crashed.
 
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index bf0b54b9..beb90a5d 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -2,6 +2,7 @@ using System;
 using System.Globalization;
 using System.IO;
 using System.Linq;
+using BmFont;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
@@ -129,6 +130,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         }
                         break;
 
+                    // unpacked Bitmap font
+                    case ".fnt":
+                        {
+                            string source = File.ReadAllText(file.FullName);
+                            asset = (T)(object)new XmlSource(source);
+                        }
+                        break;
+
                     // unpacked data
                     case ".json":
                         {
@@ -171,7 +180,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         break;
 
                     default:
-                        throw GetContentError($"unknown file extension '{file.Extension}'; must be one of '.json', '.png', '.tbin', or '.xnb'.");
+                        throw GetContentError($"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', or '.xnb'.");
                 }
             }
             catch (Exception ex) when (!(ex is SContentLoadException))
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 4f9aa9b1..b99028da 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -31,6 +31,7 @@
     <Reference Include="..\..\build\0Harmony.dll" Private="True" />
     <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="False" />
     <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="False" />
+    <Reference Include="BmFont" HintPath="$(GamePath)\BmFont.dll" Private="False" />
     <Reference Include="GalaxyCSharp" HintPath="$(GamePath)\GalaxyCSharp.dll" Private="False" />
     <Reference Include="Lidgren.Network" HintPath="$(GamePath)\Lidgren.Network.dll" Private="False" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />

From b294ac1203aa78575f8c72f0be1ee9d3edff15ab Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 30 Nov 2021 17:13:53 -0500
Subject: [PATCH 358/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 28 +++++++++++---------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 +--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 +--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 +--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 23 insertions(+), 21 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index a74002a6..9dd6f7a2 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.12.8</Version>
+    <Version>3.13.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index d60156d5..08cc832c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,31 +1,33 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.13.0
+Released 30 November 2021 for Stardew Valley 1.5.5 or later.
+
 * For players:
   * Updated for Stardew Valley 1.5.5.
-  * Updated compatibility list.
-  * Added support for loading BmFont `.fnt` files for [custom languages](https://stardewvalleywiki.com/Modding:Custom_languages) through the [content API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Content).
   * Added `set_farm_type` [console command](https://stardewvalleywiki.com/Modding:Console_commands#Console_commands) to change the current farm type.
   * Fixed installer window closing immediately if the installer crashed.
+  * Updated compatibility list.
 
 * For mod authors:
   * Migrated to 64-bit MonoGame and .NET 5 on all platforms (see [migration guide for mod authors](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5)).
   * Added support for [map overlays via `asset.AsMap().PatchMap`](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Content#Edit_a_map).
-
-**Update note for players with older systems:**  
-The game now has two branches: the _main branch_ which you'll get by default, and an optional
-_compatibility branch_ for [older systems](https://www.stardewvalley.net/compatibility/). The two
-branches have identical content, but use [different technologies](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5#Stardew_Valley_compatibility_branch).
-
-Unfortunately **SMAPI only supports the main branch of the game**. There are formidable difficulties
-across all mods in supporting all three variations, the [Steam hardware stats](https://store.steampowered.com/hwsurvey)
-show that 99.69% of players have 64-bit, and 32-bit imposes significant restrictions on what mods
-can do.
+  * Added support for loading BmFont `.fnt` files for [custom languages](https://stardewvalleywiki.com/Modding:Custom_languages) through the [content API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Content).
 
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.24.0.
 
+**Update note for players with older systems:**  
+The game now has two branches: the _main branch_ which you'll get by default, and an optional
+[_compatibility branch_ for older systems](https://www.stardewvalley.net/compatibility/). The two
+branches have identical content, but use [different technologies](https://stardewvalleywiki.com/Modding:Migrate_to_Stardew_Valley_1.5.5#Game_compatibility_branch).
+
+Unfortunately **SMAPI only supports the main branch of the game**. There are formidable difficulties
+across all mods in supporting all three variations, 32-bit imposes significant restrictions on what
+mods can do, and the [Steam hardware stats](https://store.steampowered.com/hwsurvey) show that 99.69%
+of players now have 64-bit.
+
 ## 3.12.8
 Released 18 October 2021 for Stardew Valley 1.5.4.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 9af3ce5d..85653a7d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.12.8",
+    "Version": "3.13.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.12.8"
+    "MinimumApiVersion": "3.13.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index cfbaa661..da8306d1 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.12.8",
+    "Version": "3.13.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.12.8"
+    "MinimumApiVersion": "3.13.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 1efd1d89..4c57bd49 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.12.8",
+    "Version": "3.13.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.12.8"
+    "MinimumApiVersion": "3.13.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 3ae8661a..cf4bb677 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -49,7 +49,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.12.8";
+        internal static string RawApiVersion = "3.13.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From f5a0dd15781f652a04a0d6620433e594128dfd01 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 30 Nov 2021 20:18:17 -0500
Subject: [PATCH 359/856] fix error running installer from folder paths
 containing parentheses

---
 docs/release-notes.md                          | 3 +++
 src/SMAPI.Installer/assets/windows-install.bat | 4 ++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 08cc832c..72b321c8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,9 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* Fixed installer failing on Windows when run from the game folder.
+
 ## 3.13.0
 Released 30 November 2021 for Stardew Valley 1.5.5 or later.
 
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index 2e0be906..f21679ae 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -1,6 +1,6 @@
 @echo off
 
-SET installerDir=%~dp0
+SET installerDir="%~dp0"
 
 REM make sure we're not running within a zip folder
 echo %installerDir% | findstr /C:"%TEMP%" 1>nul
@@ -28,7 +28,7 @@ if %ERRORLEVEL% NEQ 0 (
 )
 
 REM make sure an antivirus hasn't deleted the installer DLL
-if not exist "%installerDir%internal\windows\SMAPI.Installer.dll" (
+if not exist %installerDir%"internal\windows\SMAPI.Installer.dll" (
     echo Oops! SMAPI is missing one of its files. Your antivirus might have deleted it.
     echo Missing file: %installerDir%internal\windows\SMAPI.Installer.dll
     echo.

From 05b06e7a9faccfa0998bc3f7f9953817cd473bfb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 30 Nov 2021 21:53:09 -0500
Subject: [PATCH 360/856] improve installer's .NET 5 validation to explain how
 to fix it

---
 docs/release-notes.md                         |  1 +
 .../assets/windows-install.bat                | 31 ++++++++++++++-----
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 72b321c8..3f5172af 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 # Release notes
 ## Upcoming release
+* Improved .NET 5 validation in Windows installer to better explain how to get the right version.
 * Fixed installer failing on Windows when run from the game folder.
 
 ## 3.13.0
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/windows-install.bat
index f21679ae..e34b9554 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/windows-install.bat
@@ -1,4 +1,5 @@
 @echo off
+setlocal enabledelayedexpansion
 
 SET installerDir="%~dp0"
 
@@ -12,16 +13,30 @@ if %ERRORLEVEL% EQU 0 (
 )
 
 REM make sure .NET 5 is installed
+SET hasNet5=1
 WHERE dotnet /q
-if %ERRORLEVEL% NEQ 0 (
-    echo Oops! You must have .NET 5 ^(desktop x64^) installed to use SMAPI: https://dotnet.microsoft.com/download/dotnet/5.0/runtime
-    echo.
-    pause
-    exit
+if !ERRORLEVEL! NEQ 0 (
+    SET hasNet5=0
+) else (
+    dotnet --info | findstr /C:"Microsoft.WindowsDesktop.App 5." 1>nul
+    if !ERRORLEVEL! NEQ 0 (
+        SET hasNet5=0
+    )
 )
-dotnet --info | findstr /C:"Microsoft.WindowsDesktop.App 5." 1>nul
-if %ERRORLEVEL% NEQ 0 (
-    echo Oops! You must have .NET 5 ^(desktop x64^) installed to use SMAPI: https://dotnet.microsoft.com/download/dotnet/5.0/runtime
+if "%hasNet5%" == "0" (
+    echo Oops! You don't have the required .NET version installed.
+    echo.
+    echo To install it:
+    echo    1. Go to https://dotnet.microsoft.com/download/dotnet/5.0/runtime
+
+    if "%PROCESSOR_ARCHITECTURE%" == "ARM64" (
+        echo    2. Under "Run desktop apps", click "Download Arm64".
+    ) else (
+        echo    2. Under "Run desktop apps", click "Download x64".
+    )
+
+    echo    3. Run the downloaded installer.
+    echo    4. Restart your computer.
     echo.
     pause
     exit

From 25ebcc1ea7f104eca36d8085ef184e62dc4de465 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 30 Nov 2021 21:54:29 -0500
Subject: [PATCH 361/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 9dd6f7a2..578076a9 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.13.0</Version>
+    <Version>3.13.1</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3f5172af..d50a923d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,7 +1,9 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.13.1
+Released 30 November 2021 for Stardew Valley 1.5.5 or later.
+
 * Improved .NET 5 validation in Windows installer to better explain how to get the right version.
 * Fixed installer failing on Windows when run from the game folder.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 85653a7d..ac6ff6ea 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.13.0",
+    "Version": "3.13.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.13.0"
+    "MinimumApiVersion": "3.13.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index da8306d1..e19a6a7f 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.13.0",
+    "Version": "3.13.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.13.0"
+    "MinimumApiVersion": "3.13.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 4c57bd49..3e55ce42 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.13.0",
+    "Version": "3.13.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.13.0"
+    "MinimumApiVersion": "3.13.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index cf4bb677..c5ad215c 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -49,7 +49,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.13.0";
+        internal static string RawApiVersion = "3.13.1";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From c10685b03574e967c1bf48aafc814f60196812ec Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 1 Dec 2021 17:19:21 -0500
Subject: [PATCH 362/856] update mod build package release notes

---
 docs/technical/mod-package.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 93e0009d..41f808a5 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -412,7 +412,9 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
-## Upcoming release
+## 4.0.0
+Released 30 November 2021.
+
 * Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. (Older versions are no longer supported.)
 * Added `IgnoreModFilePaths` option to ignore literal paths.
 * Added `BundleExtraAssemblies` option to copy bundled DLLs into the mod zip/folder.

From bf5a9b87627b04523c7885b503e85ca2021c63a3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 2 Dec 2021 20:48:00 -0500
Subject: [PATCH 363/856] switch to scripted release package process

---
 build/common.targets                       |   3 +-
 build/prepare-install-package.sh           | 201 +++++++++++++++++++++
 build/prepare-install-package.targets      | 130 -------------
 docs/release-notes.md                      |   9 +-
 docs/technical/smapi.md                    |  58 +++---
 src/SMAPI.Installer/SMAPI.Installer.csproj |   1 -
 src/SMAPI.sln                              |   6 +-
 7 files changed, 238 insertions(+), 170 deletions(-)
 create mode 100755 build/prepare-install-package.sh
 delete mode 100644 build/prepare-install-package.targets

diff --git a/build/common.targets b/build/common.targets
index 578076a9..c9a54763 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -8,6 +8,7 @@
 
     <!--set platform-->
     <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
+    <CopyToGameFolder>true</CopyToGameFolder>
   </PropertyGroup>
 
   <!--find game folder-->
@@ -19,7 +20,7 @@
   </Target>
 
   <!-- copy files into game directory and enable debugging -->
-  <Target Name="CopySmapiFiles" AfterTargets="AfterBuild">
+  <Target Name="CopySmapiFiles" AfterTargets="AfterBuild" Condition="'$(CopyToGameFolder)' == 'true'">
     <CallTarget Targets="CopySMAPI;CopyDefaultMods" />
   </Target>
   <Target Name="CopySMAPI" Condition="'$(MSBuildProjectName)' == 'SMAPI'">
diff --git a/build/prepare-install-package.sh b/build/prepare-install-package.sh
new file mode 100755
index 00000000..c16fcd5f
--- /dev/null
+++ b/build/prepare-install-package.sh
@@ -0,0 +1,201 @@
+#!/bin/bash
+
+##########
+## Constants
+##########
+gamePath="/home/pathoschild/Stardew Valley"
+bundleModNames=("ConsoleCommands" "ErrorHandler" "SaveBackup")
+buildConfig="Release"
+folders=("unix" "windows")
+declare -A runtimes=(["unix"]="linux-x64" ["windows"]="win-x64")
+declare -A msBuildPlatformNames=(["unix"]="Unix" ["windows"]="Windows_NT")
+
+
+##########
+## Move to SMAPI root
+##########
+cd "`dirname "$0"`/.."
+
+
+##########
+## Clear old build files
+##########
+echo "Clearing old builds..."
+echo "-----------------------"
+for path in */**/bin */**/obj; do
+    rm -rf $path
+done
+rm -rf "bin"
+echo ""
+
+##########
+## Compile files
+##########
+for folder in ${folders[@]}; do
+    runtime=${runtimes[$folder]}
+    msbuildPlatformName=${msBuildPlatformNames[$folder]}
+
+    # SMAPI
+    echo "Compiling SMAPI for $folder..."
+    echo "------------------"
+    dotnet publish src/SMAPI --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false"
+    echo ""
+    echo ""
+
+    echo "Compiling installer for $folder..."
+    echo "----------------------"
+    dotnet publish src/SMAPI.Installer --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false"
+    echo ""
+    echo ""
+
+    for modName in ${bundleModNames[@]}; do
+        echo "Compiling $modName for $folder..."
+        echo "----------------------------------"
+        dotnet publish src/SMAPI.Mods.$modName --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false"
+        echo ""
+        echo ""
+    done
+done
+
+
+##########
+## Prepare install package
+##########
+echo "Preparing install package..."
+echo "----------------------------"
+
+# init paths
+installAssets="src/SMAPI.Installer/assets"
+packagePath="bin/SMAPI installer"
+packageDevPath="bin/SMAPI installer for developers"
+
+# init structure
+for folder in ${folders[@]}; do
+    mkdir "$packagePath/internal/$folder/bundle/smapi-internal" --parents
+done
+
+# copy base installer files
+cp "$installAssets/unix-install.sh"     "$packagePath/install on Linux.sh"
+cp "$installAssets/unix-install.sh"     "$packagePath/install on macOS.command"
+cp "$installAssets/windows-install.bat" "$packagePath/install on Windows.bat"
+cp "$installAssets/README.txt"          "$packagePath/README.txt"
+
+# copy per-platform files
+for folder in ${folders[@]}; do
+    runtime=${runtimes[$folder]}
+
+    # get paths
+    installBin="src/SMAPI.Installer/bin/$buildConfig/$runtime"
+    smapiBin="src/SMAPI/bin/$buildConfig/$runtime"
+    internalPath="$packagePath/internal/$folder"
+    bundlePath="$internalPath/bundle"
+
+    # runtime config for installer
+    cp "$installBin/SMAPI.Installer.runtimeconfig.json" "$internalPath/SMAPI.Installer.runtimeconfig.json"
+
+    # runtime config for SMAPI
+    cp "$installAssets/runtimeconfig.$folder.json" "$bundlePath/StardewModdingAPI.runtimeconfig.json"
+
+    # installer DLL
+    cp "$installBin/SMAPI.Installer.dll" "$internalPath/SMAPI.Installer.dll"
+    if [ $folder == "windows" ]; then
+        cp "$installAssets/windows-exe-config.xml" "$packagePath/internal/windows/install.exe.config"
+    fi
+
+    # bundle root files
+    for name in "StardewModdingAPI" "StardewModdingAPI.dll" "StardewModdingAPI.pdb" "StardewModdingAPI.xml" "steam_appid.txt"; do
+        if [ $name == "StardewModdingAPI" ] && [ $folder == "windows" ]; then
+            name="$name.exe"
+        fi
+
+        cp "$smapiBin/$name" "$bundlePath/$name"
+    done
+
+    # bundle i18n
+    cp -r "$smapiBin/i18n" "$bundlePath/smapi-internal"
+
+    # bundle smapi-internal
+    for name in "0Harmony.dll" "0Harmony.xml" "Mono.Cecil.dll" "Mono.Cecil.Mdb.dll" "Mono.Cecil.Pdb.dll" "MonoMod.Common.dll" "Newtonsoft.Json.dll" "TMXTile.dll" "SMAPI.Toolkit.dll" "SMAPI.Toolkit.pdb" "SMAPI.Toolkit.xml" "SMAPI.Toolkit.CoreInterfaces.dll" "SMAPI.Toolkit.CoreInterfaces.pdb" "SMAPI.Toolkit.CoreInterfaces.xml"; do
+        cp "$smapiBin/$name" "$bundlePath/smapi-internal/$name"
+    done
+
+    cp "$smapiBin/SMAPI.config.json" "$bundlePath/smapi-internal/config.json"
+    cp "$smapiBin/SMAPI.metadata.json" "$bundlePath/smapi-internal/metadata.json"
+    if [ $folder == "unix" ]; then
+        cp "$installAssets/unix-launcher.sh" "$bundlePath/unix-launcher.sh"
+        cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal/System.Runtime.Caching.dll"
+    else
+        cp "$installAssets/windows-exe-config.xml" "$bundlePath/StardewModdingAPI.exe.config"
+    fi
+
+    # copy .NET dependencies
+    cp "$smapiBin/System.Configuration.ConfigurationManager.dll" "$bundlePath/smapi-internal/System.Configuration.ConfigurationManager.dll"
+    cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal/System.Runtime.Caching.dll"
+    cp "$smapiBin/System.Security.Permissions.dll" "$bundlePath/smapi-internal/System.Security.Permissions.dll"
+    if [ $folder == "windows" ]; then
+        cp "$smapiBin/System.Management.dll" "$bundlePath/smapi-internal/System.Management.dll"
+    fi
+
+    # copy bundled mods
+    for modName in ${bundleModNames[@]}; do
+        fromPath="src/SMAPI.Mods.$modName/bin/$buildConfig/$runtime"
+        targetPath="$bundlePath/Mods/$modName"
+
+        mkdir "$targetPath" --parents
+
+        cp "$fromPath/$modName.dll" "$targetPath/$modName.dll"
+        cp "$fromPath/$modName.pdb" "$targetPath/$modName.pdb"
+        cp "$fromPath/manifest.json" "$targetPath/manifest.json"
+        if [ -d "$fromPath/i18n" ]; then
+            cp -r "$fromPath/i18n" "$targetPath"
+        fi
+    done
+done
+
+# mark scripts executable
+for path in "install on Linux.sh" "install on macOS.command" "bundle/unix-launcher.sh"; do
+    if [ -f "$packagePath/$path" ]; then
+        chmod 755 "$packagePath/$path"
+    fi
+done
+
+# split into main + for-dev folders
+cp -r "$packagePath" "$packageDevPath"
+for folder in ${folders[@]}; do
+    # disable developer mode in main package
+    sed --in-place --expression="s/\"DeveloperMode\": true/\"DeveloperMode\": false/" "$packagePath/internal/$folder/bundle/smapi-internal/config.json"
+
+    # convert bundle folder into final 'install.dat' files
+    for path in "$packagePath/internal/$folder" "$packageDevPath/internal/$folder"; do
+        pushd "$path/bundle" > /dev/null
+        zip "install.dat" * --recurse-paths --quiet
+        popd > /dev/null
+        mv "$path/bundle/install.dat" "$path/install.dat"
+        rm -rf "$path/bundle"
+    done
+done
+
+
+##########
+## Create release zips
+##########
+# get version number
+version="$1"
+if [ $# -eq 0 ]; then
+    echo "SMAPI release version (like '4.0.0'):"
+    read version
+fi
+
+# rename folders
+mv "$packagePath" "bin/SMAPI $version installer"
+mv "$packageDevPath" "bin/SMAPI $version installer for developers"
+
+
+# package files
+pushd bin > /dev/null
+zip -9 "SMAPI $version installer.zip" "SMAPI $version installer" --recurse-paths --quiet
+zip -9 "SMAPI $version installer for developers.zip" "SMAPI $version installer for developers" --recurse-paths --quiet
+popd > /dev/null
+
+echo ""
+echo "Done! Package created in $(pwd)/bin"
diff --git a/build/prepare-install-package.targets b/build/prepare-install-package.targets
deleted file mode 100644
index ef5624ad..00000000
--- a/build/prepare-install-package.targets
+++ /dev/null
@@ -1,130 +0,0 @@
-<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <!--
-
-  This build task is run from the installer project after all projects have been compiled, and
-  creates the build package in the bin\Packages folder.
-
-  -->
-  <Target Name="PrepareInstaller" AfterTargets="AfterBuild">
-    <PropertyGroup>
-      <PlatformName>windows</PlatformName>
-      <PlatformName Condition="$(OS) != 'Windows_NT'">unix</PlatformName>
-
-      <BuildRootPath>$(SolutionDir)</BuildRootPath>
-      <OutRootPath>$(SolutionDir)\..\bin</OutRootPath>
-
-      <SmapiBin>$(BuildRootPath)\SMAPI\bin\$(Configuration)</SmapiBin>
-      <ToolkitBin>$(BuildRootPath)\SMAPI.Toolkit\bin\$(Configuration)\net5.0</ToolkitBin>
-      <ConsoleCommandsBin>$(BuildRootPath)\SMAPI.Mods.ConsoleCommands\bin\$(Configuration)</ConsoleCommandsBin>
-      <ErrorHandlerBin>$(BuildRootPath)\SMAPI.Mods.ErrorHandler\bin\$(Configuration)</ErrorHandlerBin>
-      <SaveBackupBin>$(BuildRootPath)\SMAPI.Mods.SaveBackup\bin\$(Configuration)</SaveBackupBin>
-
-      <PackagePath>$(OutRootPath)\SMAPI installer</PackagePath>
-      <PackageDevPath>$(OutRootPath)\SMAPI installer for developers</PackageDevPath>
-    </PropertyGroup>
-    <ItemGroup>
-      <TranslationFiles Include="$(SmapiBin)\i18n\*.json" />
-      <ErrorHandlerTranslationFiles Include="$(ErrorHandlerBin)\i18n\*.json" />
-    </ItemGroup>
-
-    <!-- reset package directory -->
-    <RemoveDir Directories="$(PackagePath)" />
-    <RemoveDir Directories="$(PackageDevPath)" />
-
-    <!-- copy installer files -->
-    <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on Linux.sh" />
-    <Copy SourceFiles="$(TargetDir)\assets\unix-install.sh" DestinationFiles="$(PackagePath)\install on macOS.command" />
-    <Copy SourceFiles="$(TargetDir)\assets\windows-install.bat" DestinationFiles="$(PackagePath)\install on Windows.bat" />
-    <Copy SourceFiles="$(TargetDir)\assets\README.txt" DestinationFolder="$(PackagePath)" />
-    <Copy SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\internal\$(PlatformName)\install.exe.config" Condition="$(PlatformName) == 'windows'" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(PackagePath)\internal\$(PlatformName)" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).runtimeconfig.json" DestinationFolder="$(PackagePath)\internal\$(PlatformName)" />
-
-    <!--copy bundle files-->
-    <Copy SourceFiles="$(TargetDir)\assets\runtimeconfig.$(PlatformName).json" DestinationFiles="$(PackagePath)\bundle\StardewModdingAPI.runtimeconfig.json" />
-    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.dll" DestinationFolder="$(PackagePath)\bundle" />
-    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.exe" DestinationFolder="$(PackagePath)\bundle" Condition="$(PlatformName) == 'windows'" />
-    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI" DestinationFolder="$(PackagePath)\bundle" Condition="$(PlatformName) != 'windows'" />
-    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.pdb" DestinationFolder="$(PackagePath)\bundle" />
-    <Copy SourceFiles="$(SmapiBin)\StardewModdingAPI.xml" DestinationFolder="$(PackagePath)\bundle" />
-    <Copy SourceFiles="$(SmapiBin)\steam_appid.txt" DestinationFolder="$(PackagePath)\bundle" />
-    <Copy SourceFiles="$(SmapiBin)\0Harmony.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\0Harmony.xml" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\Mono.Cecil.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\Mono.Cecil.Mdb.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\Mono.Cecil.Pdb.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\MonoMod.Common.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\Newtonsoft.Json.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\TMXTile.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\SMAPI.config.json" DestinationFiles="$(PackagePath)\bundle\smapi-internal\config.json" />
-    <Copy SourceFiles="$(SmapiBin)\SMAPI.metadata.json" DestinationFiles="$(PackagePath)\bundle\smapi-internal\metadata.json" />
-    <Copy SourceFiles="$(ToolkitBin)\SMAPI.Toolkit.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(ToolkitBin)\SMAPI.Toolkit.pdb" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(ToolkitBin)\SMAPI.Toolkit.xml" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(ToolkitBin)\SMAPI.Toolkit.CoreInterfaces.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(ToolkitBin)\SMAPI.Toolkit.CoreInterfaces.pdb" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(ToolkitBin)\SMAPI.Toolkit.CoreInterfaces.xml" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(PackagePath)\bundle\smapi-internal\i18n" />
-    <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(TargetDir)\assets\unix-launcher.sh" DestinationFolder="$(PackagePath)\bundle" />
-    <Copy Condition="$(PlatformName) == 'unix'" SourceFiles="$(SmapiBin)\System.Runtime.Caching.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy Condition="$(PlatformName) == 'windows'" SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(PackagePath)\bundle\StardewModdingAPI.exe.config" />
-
-    <!-- copy .NET dependencies -->
-    <Copy SourceFiles="$(SmapiBin)\System.Configuration.ConfigurationManager.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\System.Management.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" Condition="$(PlatformName) == 'windows'" />
-    <Copy SourceFiles="$(SmapiBin)\System.Runtime.Caching.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-    <Copy SourceFiles="$(SmapiBin)\System.Security.Permissions.dll" DestinationFolder="$(PackagePath)\bundle\smapi-internal" />
-
-    <!--copy bundled mods-->
-    <Copy SourceFiles="$(ConsoleCommandsBin)\ConsoleCommands.dll" DestinationFolder="$(PackagePath)\bundle\Mods\ConsoleCommands" />
-    <Copy SourceFiles="$(ConsoleCommandsBin)\ConsoleCommands.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\ConsoleCommands" />
-    <Copy SourceFiles="$(ConsoleCommandsBin)\manifest.json" DestinationFolder="$(PackagePath)\bundle\Mods\ConsoleCommands" />
-    <Copy SourceFiles="$(ErrorHandlerBin)\ErrorHandler.dll" DestinationFolder="$(PackagePath)\bundle\Mods\ErrorHandler" />
-    <Copy SourceFiles="$(ErrorHandlerBin)\ErrorHandler.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\ErrorHandler" />
-    <Copy SourceFiles="$(ErrorHandlerBin)\manifest.json" DestinationFolder="$(PackagePath)\bundle\Mods\ErrorHandler" />
-    <Copy SourceFiles="@(ErrorHandlerTranslationFiles)" DestinationFolder="$(PackagePath)\bundle\Mods\ErrorHandler\i18n" />
-    <Copy SourceFiles="$(SaveBackupBin)\SaveBackup.dll" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
-    <Copy SourceFiles="$(SaveBackupBin)\SaveBackup.pdb" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
-    <Copy SourceFiles="$(SaveBackupBin)\manifest.json" DestinationFolder="$(PackagePath)\bundle\Mods\SaveBackup" />
-
-    <!-- fix Linux/macOS permissions -->
-    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)/install on Linux.sh&quot;" />
-    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)/install on macOS.command&quot;" />
-    <Exec Condition="$(PlatformName) == 'unix'" Command="chmod 755 &quot;$(PackagePath)/bundle/unix-launcher.sh&quot;" />
-
-    <!-- finalise 'for developers' installer -->
-    <ItemGroup>
-      <PackageFiles Include="$(PackagePath)\**\*.*" />
-    </ItemGroup>
-    <Copy SourceFiles="@(PackageFiles)" DestinationFolder="$(PackageDevPath)\%(RecursiveDir)" />
-    <ZipDirectory SourceDirectory="$(PackageDevPath)\bundle" DestinationFile="$(PackageDevPath)\internal\$(PlatformName)\install.dat" />
-    <RemoveDir Directories="$(PackageDevPath)\bundle" />
-
-    <!-- finalise normal installer -->
-    <ReplaceFileText FilePath="$(PackagePath)\bundle\smapi-internal\config.json" Search="&quot;DeveloperMode&quot;: true" Replace="&quot;DeveloperMode&quot;: false" />
-    <ZipDirectory SourceDirectory="$(PackagePath)\bundle" DestinationFile="$(PackagePath)\internal\$(PlatformName)\install.dat" />
-    <RemoveDir Directories="$(PackagePath)\bundle" />
-  </Target>
-
-  <!-- Replace text in a file based on a regex pattern. Derived from https://stackoverflow.com/a/22571621/262123. -->
-  <UsingTask TaskName="ReplaceFileText" TaskFactory="RoslynCodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
-    <ParameterGroup>
-      <FilePath ParameterType="System.String" Required="true" />
-      <Search ParameterType="System.String" Required="true" />
-      <Replace ParameterType="System.String" Required="true" />
-    </ParameterGroup>
-    <Task>
-      <Using Namespace="System" />
-      <Using Namespace="System.IO" />
-      <Using Namespace="System.Text.RegularExpressions" />
-      <Code Type="Fragment" Language="cs">
-        <![CDATA[
-            File.WriteAllText(
-                FilePath,
-                Regex.Replace(File.ReadAllText(FilePath), Search, Replace)
-            );
-          ]]>
-      </Code>
-    </Task>
-  </UsingTask>
-</Project>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index d50a923d..cb52f814 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,11 +1,16 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming version
+* For SMAPI maintainers:
+  * Added a new [scripted release package process](technical/smapi.md), which removes the need to compile SMAPI on multiple platforms and manually combine them.
+
 ## 3.13.1
 Released 30 November 2021 for Stardew Valley 1.5.5 or later.
 
-* Improved .NET 5 validation in Windows installer to better explain how to get the right version.
-* Fixed installer failing on Windows when run from the game folder.
+* For players:
+  * Improved .NET 5 validation in Windows installer to better explain how to get the right version.
+  * Fixed installer failing on Windows when run from the game folder.
 
 ## 3.13.0
 Released 30 November 2021 for Stardew Valley 1.5.5 or later.
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 29fa43a8..ce1220f1 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -75,22 +75,24 @@ the debugger attached, so you can intercept errors and step through the code bei
 doesn't work in MonoDevelop on Linux, unfortunately.
 
 ### Preparing a release
-To prepare a crossplatform SMAPI release, you'll need to compile it on two platforms: Windows and
-Linux. The instructions below assume you have Windows 11, but you can adapt them for
-a different setup if needed.
+To prepare a crossplatform SMAPI release, you'll need to run the build script on Linux or macOS.
 
 #### Initial setup
-First-time setup on Windows:
-1. [Install Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/install).
-2. Install the needed software in WSL:
-   1. Run `sudo apt update` to update the package list.
-   2. Install [the .NET 5 SDK](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu)
-      (for Stardew Valley 1.5.5+) or [`mono-complete`](https://www.mono-project.com/download/stable/)
-      (for earlier versions).
-      _You can run `lsb_release -a` to get the Ubuntu version number._
-   3. [Install Steam](https://linuxconfig.org/how-to-install-steam-on-ubuntu-20-04-focal-fossa-linux).
-   4. Launch `steam` and install the game like usual.
-   5. Download and install your preferred IDE. For the [latest standalone Rider
+First-time setup:
+
+1. On Windows only:
+
+   1. [Install Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/install).
+   2. Run `sudo apt update` in WSL to update the package list.
+   3. The rest of the instructions below should be run in WSL.
+
+2. Install the required software:
+
+   1. Install the [.NET 5 SDK](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu).  
+      _For Ubuntu-based systems, you can run `lsb_release -a` to get the Ubuntu version number._
+   2. [Install Steam](https://linuxconfig.org/how-to-install-steam-on-ubuntu-20-04-focal-fossa-linux).
+   3. Launch `steam` and install the game like usual.
+   4. Download and install your preferred IDE. For the [latest standalone Rider
       version](https://www.jetbrains.com/help/rider/Installation_guide.html#prerequisites):
       ```sh
       wget "<download url here>" -O rider-install.tar.gz
@@ -98,23 +100,20 @@ First-time setup on Windows:
       ln -s "/opt/JetBrains Rider-<version>/bin/rider.sh"
       ./rider.sh
       ```
-   3. Clone the SMAPI repo in WSL:
-      ```sh
-      git clone https://github.com/Pathoschild/SMAPI.git
-      ```
 
-To compile SMAPI in WSL:
-1. Run `./rider.sh` to open the Rider GUI.
-2. Use the GUI to compile the solution.
+3. Clone the SMAPI repo:
+   ```sh
+   git clone https://github.com/Pathoschild/SMAPI.git
+   ```
 
 To launch the game:
-1. Open a WSL terminal.
-2. Run these commands to start Steam:
+
+1. Run these commands to start Steam:
    ```sh
    export TERM=xterm
    steam
    ```
-3. Launch the game through the Steam UI.
+2. Launch the game through the Steam UI.
 
 #### Prepare the release
 1. Update the version numbers in `build/common.targets`, `Constants`, and the `manifest.json` for
@@ -125,15 +124,8 @@ To launch the game:
    dev build  | `<version>-alpha.<date>` | `3.0.0-alpha.20171230`
    prerelease | `<version>-beta.<date>`  | `3.0.0-beta.20171230`
    release    | `<version>`              | `3.0.0`
-2. In Windows:
-   1. Rebuild the solution with the _release_ solution configuration.
-   2. Copy the `bin/SMAPI installer` and `bin/SMAPI installer for developers` folders to Linux.
-4. In Linux:
-   1. Rebuild the solution with the _release_ solution configuration.
-   2. Add the `windows-install.*` files from Windows to the `bin/SMAPI installer` and
-      `bin/SMAPI installer for developers` folders compiled on Linux.
-   3. Rename the folders to `SMAPI <version> installer` and `SMAPI <version> installer for developers`.
-   4. Zip the two folders.
+2. Run the `build/prepare-install-package.sh` script. This will create the release package in the
+   root `bin` folder.
 
 ### Custom Harmony build
 SMAPI uses [a custom build of Harmony](https://github.com/Pathoschild/Harmony#readme), which is
diff --git a/src/SMAPI.Installer/SMAPI.Installer.csproj b/src/SMAPI.Installer/SMAPI.Installer.csproj
index e3e01467..928e5c18 100644
--- a/src/SMAPI.Installer/SMAPI.Installer.csproj
+++ b/src/SMAPI.Installer/SMAPI.Installer.csproj
@@ -17,5 +17,4 @@
 
   <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
   <Import Project="..\..\build\common.targets" />
-  <Import Project="..\..\build\prepare-install-package.targets" />
 </Project>
diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index 92c6cb24..9a42b9ff 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 16.0.28729.10
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31912.275
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".root", ".root", "{86C452BE-D2D8-45B4-B63F-E329EB06CEDA}"
 	ProjectSection(SolutionItems) = preProject
@@ -28,7 +28,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{09CF91E5
 	ProjectSection(SolutionItems) = preProject
 		..\build\common.targets = ..\build\common.targets
 		..\build\find-game-folder.targets = ..\build\find-game-folder.targets
-		..\build\prepare-install-package.targets = ..\build\prepare-install-package.targets
+		..\build\prepare-install-package.sh = ..\build\prepare-install-package.sh
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docs", "docs", "{EB35A917-67B9-4EFA-8DFC-4FB49B3949BB}"

From 181508084b5bb2bb7b8cd61ec3193a293300ba45 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 3 Dec 2021 00:26:46 -0500
Subject: [PATCH 364/856] make installer self-contained

This lets players run the installer without manually installing .NET 5, which was causing a lot of support requests.
---
 build/prepare-install-package.sh              | 41 +++++++++++--------
 docs/release-notes.md                         |  3 ++
 src/SMAPI.Installer/assets/README.txt         | 18 ++++----
 .../assets/install on Linux.sh                |  4 ++
 ...ows-install.bat => install on Windows.bat} | 39 ++++--------------
 .../assets/install on macOS.command           |  6 +++
 src/SMAPI.Installer/assets/unix-install.sh    | 14 -------
 7 files changed, 54 insertions(+), 71 deletions(-)
 create mode 100644 src/SMAPI.Installer/assets/install on Linux.sh
 rename src/SMAPI.Installer/assets/{windows-install.bat => install on Windows.bat} (54%)
 create mode 100644 src/SMAPI.Installer/assets/install on macOS.command
 delete mode 100644 src/SMAPI.Installer/assets/unix-install.sh

diff --git a/build/prepare-install-package.sh b/build/prepare-install-package.sh
index c16fcd5f..2d03ba82 100755
--- a/build/prepare-install-package.sh
+++ b/build/prepare-install-package.sh
@@ -3,12 +3,15 @@
 ##########
 ## Constants
 ##########
+# paths
 gamePath="/home/pathoschild/Stardew Valley"
 bundleModNames=("ConsoleCommands" "ErrorHandler" "SaveBackup")
+
+# build configuration
 buildConfig="Release"
-folders=("unix" "windows")
-declare -A runtimes=(["unix"]="linux-x64" ["windows"]="win-x64")
-declare -A msBuildPlatformNames=(["unix"]="Unix" ["windows"]="Windows_NT")
+folders=("linux" "macOS" "windows")
+declare -A runtimes=(["linux"]="linux-x64" ["macOS"]="osx-x64" ["windows"]="win-x64")
+declare -A msBuildPlatformNames=(["linux"]="Unix" ["macOS"]="OSX" ["windows"]="Windows_NT")
 
 
 ##########
@@ -44,7 +47,7 @@ for folder in ${folders[@]}; do
 
     echo "Compiling installer for $folder..."
     echo "----------------------"
-    dotnet publish src/SMAPI.Installer --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false"
+    dotnet publish src/SMAPI.Installer --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false" -p:PublishTrimmed=True -p:TrimMode=Link --self-contained true
     echo ""
     echo ""
 
@@ -75,29 +78,32 @@ for folder in ${folders[@]}; do
 done
 
 # copy base installer files
-cp "$installAssets/unix-install.sh"     "$packagePath/install on Linux.sh"
-cp "$installAssets/unix-install.sh"     "$packagePath/install on macOS.command"
-cp "$installAssets/windows-install.bat" "$packagePath/install on Windows.bat"
-cp "$installAssets/README.txt"          "$packagePath/README.txt"
+for name in "install on Linux.sh" "install on macOS.command" "install on Windows.bat" "README.txt"; do
+    cp "$installAssets/$name" "$packagePath/$name"
+done
 
 # copy per-platform files
 for folder in ${folders[@]}; do
     runtime=${runtimes[$folder]}
 
     # get paths
-    installBin="src/SMAPI.Installer/bin/$buildConfig/$runtime"
-    smapiBin="src/SMAPI/bin/$buildConfig/$runtime"
+    smapiBin="src/SMAPI/bin/$buildConfig/$runtime/publish"
     internalPath="$packagePath/internal/$folder"
     bundlePath="$internalPath/bundle"
 
-    # runtime config for installer
-    cp "$installBin/SMAPI.Installer.runtimeconfig.json" "$internalPath/SMAPI.Installer.runtimeconfig.json"
+    # installer files
+    cp -r "src/SMAPI.Installer/bin/$buildConfig/$runtime/publish"/* "$internalPath"
+    rm -rf "$internalPath/ref"
+    rm -rf "$internalPath/assets"
 
     # runtime config for SMAPI
-    cp "$installAssets/runtimeconfig.$folder.json" "$bundlePath/StardewModdingAPI.runtimeconfig.json"
+    if [ $folder == "linux" ] || [ $folder == "macOS" ]; then
+        cp "$installAssets/runtimeconfig.unix.json" "$bundlePath/StardewModdingAPI.runtimeconfig.json"
+    else
+        cp "$installAssets/runtimeconfig.$folder.json" "$bundlePath/StardewModdingAPI.runtimeconfig.json"
+    fi
 
-    # installer DLL
-    cp "$installBin/SMAPI.Installer.dll" "$internalPath/SMAPI.Installer.dll"
+    # installer DLL config
     if [ $folder == "windows" ]; then
         cp "$installAssets/windows-exe-config.xml" "$packagePath/internal/windows/install.exe.config"
     fi
@@ -121,7 +127,7 @@ for folder in ${folders[@]}; do
 
     cp "$smapiBin/SMAPI.config.json" "$bundlePath/smapi-internal/config.json"
     cp "$smapiBin/SMAPI.metadata.json" "$bundlePath/smapi-internal/metadata.json"
-    if [ $folder == "unix" ]; then
+    if [ $folder == "linux" ] || [ $folder == "macOS" ]; then
         cp "$installAssets/unix-launcher.sh" "$bundlePath/unix-launcher.sh"
         cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal/System.Runtime.Caching.dll"
     else
@@ -138,7 +144,7 @@ for folder in ${folders[@]}; do
 
     # copy bundled mods
     for modName in ${bundleModNames[@]}; do
-        fromPath="src/SMAPI.Mods.$modName/bin/$buildConfig/$runtime"
+        fromPath="src/SMAPI.Mods.$modName/bin/$buildConfig/$runtime/publish"
         targetPath="$bundlePath/Mods/$modName"
 
         mkdir "$targetPath" --parents
@@ -190,7 +196,6 @@ fi
 mv "$packagePath" "bin/SMAPI $version installer"
 mv "$packageDevPath" "bin/SMAPI $version installer for developers"
 
-
 # package files
 pushd bin > /dev/null
 zip -9 "SMAPI $version installer.zip" "SMAPI $version installer" --recurse-paths --quiet
diff --git a/docs/release-notes.md b/docs/release-notes.md
index cb52f814..09bbf832 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 # Release notes
 ## Upcoming version
+* For players:
+  * You no longer need .NET 5 to run the SMAPI installer.
+
 * For SMAPI maintainers:
   * Added a new [scripted release package process](technical/smapi.md), which removes the need to compile SMAPI on multiple platforms and manually combine them.
 
diff --git a/src/SMAPI.Installer/assets/README.txt b/src/SMAPI.Installer/assets/README.txt
index 5c20529a..08e99887 100644
--- a/src/SMAPI.Installer/assets/README.txt
+++ b/src/SMAPI.Installer/assets/README.txt
@@ -14,22 +14,27 @@
 SMAPI lets you run Stardew Valley with mods. Don't forget to download mods separately.
 
 
-Player's guide
+Automated install
 --------------------------------
 See https://stardewvalleywiki.com/Modding:Player_Guide for help installing SMAPI, adding mods, etc.
 
 
 Manual install
 --------------------------------
-THIS IS NOT RECOMMENDED FOR MOST PLAYERS. See instructions above instead.
+THIS IS NOT RECOMMENDED FOR MOST PLAYERS. See the instructions above instead.
 If you really want to install SMAPI manually, here's how.
 
-1. Unzip "internal/windows/install.dat" (on Windows) or "internal/unix/install.dat" (on
-   Linux/macOS). You can change '.dat' to '.zip', it's just a normal zip file renamed to prevent
+1. Unzip "internal/windows/install.dat" (on Windows) or "internal/unix/install.dat" (on Linux or
+   macOS). You can change '.dat' to '.zip', it's just a normal zip file renamed to prevent
    confusion.
+
 2. Copy the files from the folder you just unzipped into your game folder. The
    `StardewModdingAPI.exe` file should be right next to the game's executable.
-3.
+
+3. Copy `Stardew Valley.deps.json` in the game folder, and rename the copy to
+   `StardewModdingAPI.deps.json`.
+
+4.
   - Windows only: if you use Steam, see the install guide above to enable achievements and
     overlay. Otherwise, just run StardewModdingAPI.exe in your game folder to play with mods.
 
@@ -38,8 +43,5 @@ If you really want to install SMAPI manually, here's how.
     play with mods.
 
 When installing on Linux or macOS:
-- Make sure Mono is installed (normally the installer checks for you). While it's not required,
-  many mods won't work correctly without it. (Specifically, mods which load PNG images may crash or
-  freeze the game.)
 - To configure the color scheme, edit the `smapi-internal/config.json` file and see instructions
   there for the 'ColorScheme' setting.
diff --git a/src/SMAPI.Installer/assets/install on Linux.sh b/src/SMAPI.Installer/assets/install on Linux.sh
new file mode 100644
index 00000000..3b7eae9c
--- /dev/null
+++ b/src/SMAPI.Installer/assets/install on Linux.sh	
@@ -0,0 +1,4 @@
+#!/bin/bash
+
+cd "`dirname "$0"`"
+internal/linux/SMAPI.Installer
diff --git a/src/SMAPI.Installer/assets/windows-install.bat b/src/SMAPI.Installer/assets/install on Windows.bat
similarity index 54%
rename from src/SMAPI.Installer/assets/windows-install.bat
rename to src/SMAPI.Installer/assets/install on Windows.bat
index e34b9554..b0d9ae81 100644
--- a/src/SMAPI.Installer/assets/windows-install.bat
+++ b/src/SMAPI.Installer/assets/install on Windows.bat	
@@ -12,36 +12,6 @@ if %ERRORLEVEL% EQU 0 (
     exit
 )
 
-REM make sure .NET 5 is installed
-SET hasNet5=1
-WHERE dotnet /q
-if !ERRORLEVEL! NEQ 0 (
-    SET hasNet5=0
-) else (
-    dotnet --info | findstr /C:"Microsoft.WindowsDesktop.App 5." 1>nul
-    if !ERRORLEVEL! NEQ 0 (
-        SET hasNet5=0
-    )
-)
-if "%hasNet5%" == "0" (
-    echo Oops! You don't have the required .NET version installed.
-    echo.
-    echo To install it:
-    echo    1. Go to https://dotnet.microsoft.com/download/dotnet/5.0/runtime
-
-    if "%PROCESSOR_ARCHITECTURE%" == "ARM64" (
-        echo    2. Under "Run desktop apps", click "Download Arm64".
-    ) else (
-        echo    2. Under "Run desktop apps", click "Download x64".
-    )
-
-    echo    3. Run the downloaded installer.
-    echo    4. Restart your computer.
-    echo.
-    pause
-    exit
-)
-
 REM make sure an antivirus hasn't deleted the installer DLL
 if not exist %installerDir%"internal\windows\SMAPI.Installer.dll" (
     echo Oops! SMAPI is missing one of its files. Your antivirus might have deleted it.
@@ -50,9 +20,16 @@ if not exist %installerDir%"internal\windows\SMAPI.Installer.dll" (
     pause
     exit
 )
+if not exist %installerDir%"internal\windows\SMAPI.Installer.exe" (
+    echo Oops! SMAPI is missing one of its files. Your antivirus might have deleted it.
+    echo Missing file: %installerDir%internal\windows\SMAPI.Installer.exe
+    echo.
+    pause
+    exit
+)
 
 REM start installer
-dotnet internal\windows\SMAPI.Installer.dll
+internal\windows\SMAPI.Installer.exe
 
 REM keep window open if it failed
 if %ERRORLEVEL% NEQ 0 (
diff --git a/src/SMAPI.Installer/assets/install on macOS.command b/src/SMAPI.Installer/assets/install on macOS.command
new file mode 100644
index 00000000..abd21dc8
--- /dev/null
+++ b/src/SMAPI.Installer/assets/install on macOS.command	
@@ -0,0 +1,6 @@
+#!/bin/bash
+
+cd "`dirname "$0"`"
+
+xattr -r -d com.apple.quarantine internal
+internal/macOS/SMAPI.Installer
diff --git a/src/SMAPI.Installer/assets/unix-install.sh b/src/SMAPI.Installer/assets/unix-install.sh
deleted file mode 100644
index 07df4e6c..00000000
--- a/src/SMAPI.Installer/assets/unix-install.sh
+++ /dev/null
@@ -1,14 +0,0 @@
-#!/bin/bash
-
-# Move to script's directory
-cd "`dirname "$0"`"
-
-# make sure .NET 5 is installed
-if ! command -v dotnet >/dev/null 2>&1; then
-    echo "Oops! You must have .NET 5 installed to use SMAPI: https://dotnet.microsoft.com/download";
-    read
-    exit 1
-fi
-
-# run installer
-dotnet internal/unix/SMAPI.Installer.dll

From e4416925f9b4d1deac521c62918d008076ac6b05 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 3 Dec 2021 02:16:27 -0500
Subject: [PATCH 365/856] add build script to set the release version

---
 build/set-smapi-version.sh | 18 ++++++++++++++++++
 docs/technical/smapi.md    | 13 ++++++-------
 src/SMAPI.sln              |  1 +
 3 files changed, 25 insertions(+), 7 deletions(-)
 create mode 100755 build/set-smapi-version.sh

diff --git a/build/set-smapi-version.sh b/build/set-smapi-version.sh
new file mode 100755
index 00000000..42174cae
--- /dev/null
+++ b/build/set-smapi-version.sh
@@ -0,0 +1,18 @@
+#!/bin/bash
+
+# get version number
+version="$1"
+if [ $# -eq 0 ]; then
+    echo "SMAPI release version (like '4.0.0'):"
+    read version
+fi
+
+# move to SMAPI root
+cd "`dirname "$0"`/.."
+
+# apply changes
+sed "s/<Version>.+<\/Version>/<Version>$version<\/Version>/" "build/common.targets" --in-place --regexp-extended
+sed "s/RawApiVersion = \".+?\";/RawApiVersion = \"$version\";/" "src/SMAPI/Constants.cs" --in-place --regexp-extended
+for modName in "ConsoleCommands" "ErrorHandler" "SaveBackup"; do
+    sed "s/\"(Version|MinimumApiVersion)\": \".+?\"/\"\1\": \"$version\"/g" "src/SMAPI.Mods.$modName/manifest.json" --in-place --regexp-extended
+done
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index ce1220f1..f2e030d8 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -116,16 +116,15 @@ To launch the game:
 2. Launch the game through the Steam UI.
 
 #### Prepare the release
-1. Update the version numbers in `build/common.targets`, `Constants`, and the `manifest.json` for
-   bundled mods. Make sure you use a [semantic version](https://semver.org). Recommended format:
+1. Run `build/set-smapi-version.sh` to set the SMAPI version. Make sure you use a [semantic
+   version](https://semver.org). Recommended format:
 
    build type | format                   | example
    :--------- | :----------------------- | :------
-   dev build  | `<version>-alpha.<date>` | `3.0.0-alpha.20171230`
-   prerelease | `<version>-beta.<date>`  | `3.0.0-beta.20171230`
-   release    | `<version>`              | `3.0.0`
-2. Run the `build/prepare-install-package.sh` script. This will create the release package in the
-   root `bin` folder.
+   dev build  | `<version>-alpha.<date>` | `4.0.0-alpha.20251230`
+   prerelease | `<version>-beta.<date>`  | `4.0.0-beta.20251230`
+   release    | `<version>`              | `4.0.0`
+2. Run `build/prepare-install-package.sh` to create the release package in the root `bin` folder.
 
 ### Custom Harmony build
 SMAPI uses [a custom build of Harmony](https://github.com/Pathoschild/Harmony#readme), which is
diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index 9a42b9ff..961a5ff7 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -29,6 +29,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{09CF91E5
 		..\build\common.targets = ..\build\common.targets
 		..\build\find-game-folder.targets = ..\build\find-game-folder.targets
 		..\build\prepare-install-package.sh = ..\build\prepare-install-package.sh
+		..\build\set-smapi-version.sh = ..\build\set-smapi-version.sh
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docs", "docs", "{EB35A917-67B9-4EFA-8DFC-4FB49B3949BB}"

From 6df3b0b8148377fc01a6000043deb2960adcaead Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 3 Dec 2021 19:53:22 -0500
Subject: [PATCH 366/856] update for Stardew Valley 1.5.5 hotfix

---
 docs/release-notes.md        | 1 +
 src/SMAPI/Framework/SGame.cs | 8 ++++----
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 09bbf832..3f13b4e2 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming version
 * For players:
   * You no longer need .NET 5 to run the SMAPI installer.
+  * Updated for the Stardew Valley 1.5.5 hotfix on 2021-12-03.
 
 * For SMAPI maintainers:
   * Added a new [scripted release package process](technical/smapi.md), which removes the need to compile SMAPI on multiple platforms and manually combine them.
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 898ed1f5..104cf330 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -776,10 +776,10 @@ namespace StardewModdingAPI.Framework
                 }
                 if (!Game1.eventUp && Game1.farmEvent == null && Game1.currentBillboard == 0 && Game1.gameMode == 3 && !this.takingMapScreenshot && Game1.isOutdoorMapSmallerThanViewport())
                 {
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, -Math.Min(Game1.viewport.X, GameRunner.MaxTextureSize), Game1.graphics.GraphicsDevice.Viewport.Height), Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64, 0, Math.Min(GameRunner.MaxTextureSize, Game1.graphics.GraphicsDevice.Viewport.Width - (-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64)), Game1.graphics.GraphicsDevice.Viewport.Height), Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, Game1.graphics.GraphicsDevice.Viewport.Width, -Math.Min(Game1.viewport.Y, GameRunner.MaxTextureSize)), Color.Black);
-                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, -Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64, Game1.graphics.GraphicsDevice.Viewport.Width, Math.Min(GameRunner.MaxTextureSize, Game1.graphics.GraphicsDevice.Viewport.Height - (-Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64))), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, -Game1.viewport.X, Game1.graphics.GraphicsDevice.Viewport.Height), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64, 0, Game1.graphics.GraphicsDevice.Viewport.Width - (-Game1.viewport.X + Game1.currentLocation.map.Layers[0].LayerWidth * 64), Game1.graphics.GraphicsDevice.Viewport.Height), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, 0, Game1.graphics.GraphicsDevice.Viewport.Width, -Game1.viewport.Y), Color.Black);
+                    Game1.spriteBatch.Draw(Game1.fadeToBlackRect, new Microsoft.Xna.Framework.Rectangle(0, -Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64, Game1.graphics.GraphicsDevice.Viewport.Width, Game1.graphics.GraphicsDevice.Viewport.Height - (-Game1.viewport.Y + Game1.currentLocation.map.Layers[0].LayerHeight * 64)), Color.Black);
                 }
                 Game1.spriteBatch.End();
                 Game1.PushUIMode();

From 1d7340f598436df705cf01c00ad1b33f70c60c72 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 4 Dec 2021 15:43:01 -0500
Subject: [PATCH 367/856] fix code warnings

---
 src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs | 2 +-
 src/SMAPI/SButton.cs                                  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
index 1efc1616..e03c72de 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
@@ -315,7 +315,7 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
                 return false;
 
             // conversion to implemented interface is OK
-            if (fromType.AllInterfaces.Contains(toType))
+            if (fromType.AllInterfaces.Contains(toType, SymbolEqualityComparer.Default))
                 return false;
 
             // avoid any other conversions
diff --git a/src/SMAPI/SButton.cs b/src/SMAPI/SButton.cs
index cc412946..ae825696 100644
--- a/src/SMAPI/SButton.cs
+++ b/src/SMAPI/SButton.cs
@@ -6,7 +6,7 @@ using StardewValley;
 namespace StardewModdingAPI
 {
     /// <summary>A unified button constant which includes all controller, keyboard, and mouse buttons.</summary>
-    /// <remarks>Derived from <see cref="Keys"/>, <see cref="Buttons"/>, and <see cref="System.Windows.Forms.MouseButtons"/>.</remarks>
+    /// <remarks>Derived from <see cref="Keys"/>, <see cref="Buttons"/>, and <c>System.Windows.Forms.MouseButtons</c>.</remarks>
     public enum SButton
     {
         /// <summary>No valid key.</summary>

From 711e17a4f99af29177fb250b24868b6e655dacb7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 4 Dec 2021 15:55:16 -0500
Subject: [PATCH 368/856] suppress non-applicable code warnings

---
 build/common.targets                              | 15 +++++++++++++++
 .../RewriteFacades/AccessToolsFacade.cs           |  2 ++
 .../RewriteFacades/HarmonyInstanceFacade.cs       |  2 ++
 .../RewriteFacades/HarmonyMethodFacade.cs         |  2 ++
 .../RewriteFacades/SpriteBatchFacade.cs           |  3 +++
 src/SMAPI/Utilities/Keybind.cs                    |  2 ++
 6 files changed, 26 insertions(+)

diff --git a/build/common.targets b/build/common.targets
index c9a54763..ed860eee 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -9,6 +9,21 @@
     <!--set platform-->
     <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
     <CopyToGameFolder>true</CopyToGameFolder>
+
+    <!-- allow mods to be compiled as AnyCPU for compatibility with older platforms -->
+    <ResolveAssemblyWarnOrErrorOnTargetArchitectureMismatch>None</ResolveAssemblyWarnOrErrorOnTargetArchitectureMismatch>
+
+    <!--
+      suppress warnings that don't apply, so it's easier to spot actual issues.
+
+      warning | builds  | summary                                   | rationale
+      ┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
+      CS0436  | all     | local type conflicts with imported type   | SMAPI needs to use certain low-level code during very early compatibility checks, before it's safe to load any other DLLs.
+      CA1416  | all     | platform code available on all platforms  | Compiler doesn't recognize the #if constants used by SMAPI.
+      CS0809  | all     | obsolete overload for non-onsolete member | This is deliberate to signal to mods that certain APIs are only implemented for the game and shouldn't be called by mods.
+      NU1701  | all     | NuGet package targets older .NET version  | All such packages are carefully tested to make sure they do work.
+    -->
+    <NoWarn>$(NoWarn);CS0436;CA1416;CS0809;NU1701</NoWarn>
   </PropertyGroup>
 
   <!--find game folder-->
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
index 8e4320b3..be2a1c58 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
@@ -4,6 +4,8 @@ using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
 using HarmonyLib;
 
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member: This is internal code to support rewriters that shouldn't be called directly.
+
 namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
 {
     /// <summary>Maps Harmony 1.x <see cref="AccessTools"/> methods to Harmony 2.x to avoid breaking older mods.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
index 54b91679..135bd218 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
@@ -5,6 +5,8 @@ using System.Reflection;
 using System.Reflection.Emit;
 using HarmonyLib;
 
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member: This is internal code to support rewriters that shouldn't be called directly.
+
 namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
 {
     /// <summary>Maps Harmony 1.x <code>HarmonyInstance</code> methods to Harmony 2.x's <see cref="Harmony"/> to avoid breaking older mods.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
index 44c97401..5162dda4 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
@@ -3,6 +3,8 @@ using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
 using HarmonyLib;
 
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member: This is internal code to support rewriters that shouldn't be called directly.
+
 namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
 {
     /// <summary>Maps Harmony 1.x <see cref="HarmonyMethod"/> methods to Harmony 2.x to avoid breaking older mods.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
index a064f503..5f68f8d9 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
@@ -2,6 +2,9 @@ using System.Diagnostics.CodeAnalysis;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
 
+#pragma warning disable CS0109 // Member does not hide an inherited member, new keyword is not required: This is deliberate to support legacy XNA Framework platforms.
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member: This is internal code to support rewriters that shouldn't be called directly.
+
 namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
 {
     /// <summary>Provides <see cref="SpriteBatch"/> method signatures that can be injected into mod code for compatibility with mods written for XNA Framework before Stardew Valley 1.5.5.</summary>
diff --git a/src/SMAPI/Utilities/Keybind.cs b/src/SMAPI/Utilities/Keybind.cs
index dd8d2861..87b867a9 100644
--- a/src/SMAPI/Utilities/Keybind.cs
+++ b/src/SMAPI/Utilities/Keybind.cs
@@ -105,7 +105,9 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get the keybind state relative to the previous tick.</summary>
         public SButtonState GetState()
         {
+#pragma warning disable CS0618 // Type or member is obsolete: deliberate call to GetButtonState() for unit tests
             SButtonState[] states = this.Buttons.Select(this.GetButtonState).Distinct().ToArray();
+#pragma warning restore CS0618
 
             // single state
             if (states.Length == 1)

From c80d07fddfffe4fd3f8fa69bf6cab6374eec992d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 4 Dec 2021 15:55:29 -0500
Subject: [PATCH 369/856] migrate SMAPI to self-contained install

This removes the need to have .NET 5 installed to run SMAPI. Note that there's no need to actually bundle the .NET files, since they're already bundled into the game folder.
---
 build/prepare-install-package.sh              | 28 +++++++++----------
 docs/release-notes.md                         |  2 +-
 .../assets/runtimeconfig.unix.json            |  3 +-
 .../assets/runtimeconfig.windows.json         |  3 +-
 src/SMAPI.Installer/assets/unix-launcher.sh   |  9 +-----
 5 files changed, 20 insertions(+), 25 deletions(-)

diff --git a/build/prepare-install-package.sh b/build/prepare-install-package.sh
index 2d03ba82..07dae217 100755
--- a/build/prepare-install-package.sh
+++ b/build/prepare-install-package.sh
@@ -26,6 +26,7 @@ cd "`dirname "$0"`/.."
 echo "Clearing old builds..."
 echo "-----------------------"
 for path in */**/bin */**/obj; do
+    echo "$path"
     rm -rf $path
 done
 rm -rf "bin"
@@ -38,10 +39,9 @@ for folder in ${folders[@]}; do
     runtime=${runtimes[$folder]}
     msbuildPlatformName=${msBuildPlatformNames[$folder]}
 
-    # SMAPI
     echo "Compiling SMAPI for $folder..."
     echo "------------------"
-    dotnet publish src/SMAPI --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false"
+    dotnet publish src/SMAPI --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false" --self-contained true
     echo ""
     echo ""
 
@@ -79,7 +79,7 @@ done
 
 # copy base installer files
 for name in "install on Linux.sh" "install on macOS.command" "install on Windows.bat" "README.txt"; do
-    cp "$installAssets/$name" "$packagePath/$name"
+    cp "$installAssets/$name" "$packagePath"
 done
 
 # copy per-platform files
@@ -114,7 +114,7 @@ for folder in ${folders[@]}; do
             name="$name.exe"
         fi
 
-        cp "$smapiBin/$name" "$bundlePath/$name"
+        cp "$smapiBin/$name" "$bundlePath"
     done
 
     # bundle i18n
@@ -122,24 +122,24 @@ for folder in ${folders[@]}; do
 
     # bundle smapi-internal
     for name in "0Harmony.dll" "0Harmony.xml" "Mono.Cecil.dll" "Mono.Cecil.Mdb.dll" "Mono.Cecil.Pdb.dll" "MonoMod.Common.dll" "Newtonsoft.Json.dll" "TMXTile.dll" "SMAPI.Toolkit.dll" "SMAPI.Toolkit.pdb" "SMAPI.Toolkit.xml" "SMAPI.Toolkit.CoreInterfaces.dll" "SMAPI.Toolkit.CoreInterfaces.pdb" "SMAPI.Toolkit.CoreInterfaces.xml"; do
-        cp "$smapiBin/$name" "$bundlePath/smapi-internal/$name"
+        cp "$smapiBin/$name" "$bundlePath/smapi-internal"
     done
 
     cp "$smapiBin/SMAPI.config.json" "$bundlePath/smapi-internal/config.json"
     cp "$smapiBin/SMAPI.metadata.json" "$bundlePath/smapi-internal/metadata.json"
     if [ $folder == "linux" ] || [ $folder == "macOS" ]; then
-        cp "$installAssets/unix-launcher.sh" "$bundlePath/unix-launcher.sh"
-        cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal/System.Runtime.Caching.dll"
+        cp "$installAssets/unix-launcher.sh" "$bundlePath"
+        cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
     else
         cp "$installAssets/windows-exe-config.xml" "$bundlePath/StardewModdingAPI.exe.config"
     fi
 
     # copy .NET dependencies
-    cp "$smapiBin/System.Configuration.ConfigurationManager.dll" "$bundlePath/smapi-internal/System.Configuration.ConfigurationManager.dll"
-    cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal/System.Runtime.Caching.dll"
-    cp "$smapiBin/System.Security.Permissions.dll" "$bundlePath/smapi-internal/System.Security.Permissions.dll"
+    cp "$smapiBin/System.Configuration.ConfigurationManager.dll" "$bundlePath/smapi-internal"
+    cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
+    cp "$smapiBin/System.Security.Permissions.dll" "$bundlePath/smapi-internal"
     if [ $folder == "windows" ]; then
-        cp "$smapiBin/System.Management.dll" "$bundlePath/smapi-internal/System.Management.dll"
+        cp "$smapiBin/System.Management.dll" "$bundlePath/smapi-internal"
     fi
 
     # copy bundled mods
@@ -149,9 +149,9 @@ for folder in ${folders[@]}; do
 
         mkdir "$targetPath" --parents
 
-        cp "$fromPath/$modName.dll" "$targetPath/$modName.dll"
-        cp "$fromPath/$modName.pdb" "$targetPath/$modName.pdb"
-        cp "$fromPath/manifest.json" "$targetPath/manifest.json"
+        cp "$fromPath/$modName.dll" "$targetPath"
+        cp "$fromPath/$modName.pdb" "$targetPath"
+        cp "$fromPath/manifest.json" "$targetPath"
         if [ -d "$fromPath/i18n" ]; then
             cp -r "$fromPath/i18n" "$targetPath"
         fi
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3f13b4e2..4fc6a524 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,7 +3,7 @@
 # Release notes
 ## Upcoming version
 * For players:
-  * You no longer need .NET 5 to run the SMAPI installer.
+  * You no longer need .NET 5 installed to run SMAPI or the installer.
   * Updated for the Stardew Valley 1.5.5 hotfix on 2021-12-03.
 
 * For SMAPI maintainers:
diff --git a/src/SMAPI.Installer/assets/runtimeconfig.unix.json b/src/SMAPI.Installer/assets/runtimeconfig.unix.json
index 8a01ceb1..a1d060b5 100644
--- a/src/SMAPI.Installer/assets/runtimeconfig.unix.json
+++ b/src/SMAPI.Installer/assets/runtimeconfig.unix.json
@@ -4,7 +4,8 @@
         "includedFrameworks": [
             {
                 "name": "Microsoft.NETCore.App",
-                "version": "5.0.7"
+                "version": "5.0.0",
+                "rollForward": "major"
             }
         ],
         "configProperties": {
diff --git a/src/SMAPI.Installer/assets/runtimeconfig.windows.json b/src/SMAPI.Installer/assets/runtimeconfig.windows.json
index b693d809..d5f24bdb 100644
--- a/src/SMAPI.Installer/assets/runtimeconfig.windows.json
+++ b/src/SMAPI.Installer/assets/runtimeconfig.windows.json
@@ -3,7 +3,8 @@
         "tfm": "net5.0",
         "framework": {
             "name": "Microsoft.NETCore.App",
-            "version": "5.0.0"
+            "version": "5.0.0",
+            "rollForward": "major"
         },
         "configProperties": {
             "System.Runtime.TieredCompilation": false
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 58f7a5ae..e8b9ae62 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -49,20 +49,13 @@ if [ ! -f "Stardew Valley.dll" ]; then
     exit 1
 fi
 
-# .NET 5 must be installed
-if ! command -v dotnet >/dev/null 2>&1; then
-    echo "Oops! You must have .NET 5 installed to use SMAPI: https://dotnet.microsoft.com/download";
-    read
-    exit 1
-fi
-
 
 ##########
 ## Launch SMAPI
 ##########
 # macOS
 if [ "$(uname)" == "Darwin" ]; then
-    dotnet StardewModdingAPI.dll "$@"
+    ./StardewModdingAPI "$@"
 
 # Linux
 else

From cc35dbdb3d1fe0a82557857a72d842f1217812c2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 4 Dec 2021 20:25:53 -0500
Subject: [PATCH 370/856] fix self-contained install on Windows

---
 build/prepare-install-package.sh                    |  9 ++++-----
 .../{runtimeconfig.unix.json => runtimeconfig.json} |  5 +++--
 .../assets/runtimeconfig.windows.json               | 13 -------------
 src/SMAPI/SMAPI.csproj                              |  3 +++
 4 files changed, 10 insertions(+), 20 deletions(-)
 rename src/SMAPI.Installer/assets/{runtimeconfig.unix.json => runtimeconfig.json} (59%)
 delete mode 100644 src/SMAPI.Installer/assets/runtimeconfig.windows.json

diff --git a/build/prepare-install-package.sh b/build/prepare-install-package.sh
index 07dae217..39575c4c 100755
--- a/build/prepare-install-package.sh
+++ b/build/prepare-install-package.sh
@@ -97,11 +97,10 @@ for folder in ${folders[@]}; do
     rm -rf "$internalPath/assets"
 
     # runtime config for SMAPI
-    if [ $folder == "linux" ] || [ $folder == "macOS" ]; then
-        cp "$installAssets/runtimeconfig.unix.json" "$bundlePath/StardewModdingAPI.runtimeconfig.json"
-    else
-        cp "$installAssets/runtimeconfig.$folder.json" "$bundlePath/StardewModdingAPI.runtimeconfig.json"
-    fi
+    # This is identical to the one generated by the build, except that the min runtime version is
+    # set to 5.0.0 (instead of whatever version it was built with) and rollForward is set to latestMinor instead of
+    # minor.
+    cp "$installAssets/runtimeconfig.json" "$bundlePath/StardewModdingAPI.runtimeconfig.json"
 
     # installer DLL config
     if [ $folder == "windows" ]; then
diff --git a/src/SMAPI.Installer/assets/runtimeconfig.unix.json b/src/SMAPI.Installer/assets/runtimeconfig.json
similarity index 59%
rename from src/SMAPI.Installer/assets/runtimeconfig.unix.json
rename to src/SMAPI.Installer/assets/runtimeconfig.json
index a1d060b5..34018b8a 100644
--- a/src/SMAPI.Installer/assets/runtimeconfig.unix.json
+++ b/src/SMAPI.Installer/assets/runtimeconfig.json
@@ -5,11 +5,12 @@
             {
                 "name": "Microsoft.NETCore.App",
                 "version": "5.0.0",
-                "rollForward": "major"
+                "rollForward": "latestMinor"
             }
         ],
         "configProperties": {
-            "System.Runtime.TieredCompilation": false
+            "System.Runtime.TieredCompilation": false,
+            "System.Reflection.Metadata.MetadataUpdater.IsSupported": false
         }
     }
 }
diff --git a/src/SMAPI.Installer/assets/runtimeconfig.windows.json b/src/SMAPI.Installer/assets/runtimeconfig.windows.json
deleted file mode 100644
index d5f24bdb..00000000
--- a/src/SMAPI.Installer/assets/runtimeconfig.windows.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
-    "runtimeOptions": {
-        "tfm": "net5.0",
-        "framework": {
-            "name": "Microsoft.NETCore.App",
-            "version": "5.0.0",
-            "rollForward": "major"
-        },
-        "configProperties": {
-            "System.Runtime.TieredCompilation": false
-        }
-    }
-}
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index b99028da..f07ede87 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -13,6 +13,9 @@
 
     <!--copy dependency DLLs to bin folder so we can include them in installer bundle -->
     <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
+
+    <!-- tiered compilation breaks Harmony -->
+    <TieredCompilation>false</TieredCompilation>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />

From 0f37c0f92da5fb6fcf9e4317a1b4c8d3f4df8010 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 4 Dec 2021 22:41:59 -0500
Subject: [PATCH 371/856] update JSON validator for Content Patcher's new .fnt
 support

---
 docs/release-notes.md                              | 3 +++
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 6 +++---
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4fc6a524..0f6fba33 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,9 @@
 * For SMAPI maintainers:
   * Added a new [scripted release package process](technical/smapi.md), which removes the need to compile SMAPI on multiple platforms and manually combine them.
 
+* For the web UI:
+  * Updated the JSON validator/schema for `.fnt` support in Content Patcher 1.24.0.
+
 ## 3.13.1
 Released 30 November 2021 for Stardew Valley 1.5.5 or later.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index d39574ef..6b80f260 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -214,7 +214,7 @@
                     },
                     "FromFile": {
                         "title": "Source file",
-                        "description": "The relative file path in your content pack folder to load instead (like 'assets/dinosaur.png'), or multiple comma-delimited values. This can be a .json (data), .png (image), .tbin or .tmx (map), or .xnb file. This field supports tokens and capitalization doesn't matter.",
+                        "description": "The relative file path in your content pack folder to load instead (like 'assets/dinosaur.png'), or multiple comma-delimited values. This can be a .fnt (font), .json (data), .png (image), .tbin or .tmx (map), or .xnb file. This field supports tokens and capitalization doesn't matter.",
                         "type": "string",
                         "allOf": [
                             {
@@ -223,12 +223,12 @@
                                 }
                             },
                             {
-                                "pattern": "\\.(json|png|tbin|tmx|xnb) *$"
+                                "pattern": "\\.(fnt|json|png|tbin|tmx|xnb) *$"
                             }
                         ],
                         "@errorMessages": {
                             "allOf:indexes: 0": "Invalid value; must not contain directory climbing (like '../').",
-                            "allOf:indexes: 1": "Invalid value; must be a file path ending with .json, .png, .tbin, .tmx, or .xnb."
+                            "allOf:indexes: 1": "Invalid value; must be a file path ending with .fnt, .json, .png, .tbin, .tmx, or .xnb."
                         }
                     },
                     "FromArea": {

From cb9d6ae5ad9252c2a36174856b28f12344d026f3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 4 Dec 2021 23:47:27 -0500
Subject: [PATCH 372/856] improve error when installer is pointed at a SDV
 1.5.4 folder

---
 docs/release-notes.md                         |  3 ++-
 .../Framework/InstallerContext.cs             |  7 +++++
 src/SMAPI.Installer/InteractiveInstaller.cs   | 10 ++++++-
 .../Framework/GameScanning/GameScanner.cs     | 27 +++++++++++++++++++
 4 files changed, 45 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0f6fba33..aa9b488c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,7 +4,8 @@
 ## Upcoming version
 * For players:
   * You no longer need .NET 5 installed to run SMAPI or the installer.
-  * Updated for the Stardew Valley 1.5.5 hotfix on 2021-12-03.
+  * The installer now detects when the game folder contains an incompatible older game version.
+  * Updated for the latest Stardew Valley 1.5.5 hotfix.
 
 * For SMAPI maintainers:
   * Added a new [scripted release package process](technical/smapi.md), which removes the need to compile SMAPI on multiple platforms and manually combine them.
diff --git a/src/SMAPI.Installer/Framework/InstallerContext.cs b/src/SMAPI.Installer/Framework/InstallerContext.cs
index 95df32ca..68df2001 100644
--- a/src/SMAPI.Installer/Framework/InstallerContext.cs
+++ b/src/SMAPI.Installer/Framework/InstallerContext.cs
@@ -54,5 +54,12 @@ namespace StardewModdingAPI.Installer.Framework
         {
             return this.GameScanner.LooksLikeGameFolder(dir);
         }
+
+        /// <summary>Get whether a folder seems to contain Stardew Valley 1.5.4 or earlier.</summary>
+        /// <param name="dir">The folder to check.</param>
+        public bool LooksLikeStardewValley154(DirectoryInfo dir)
+        {
+            return this.GameScanner.LooksLikeStardewValley154(dir);
+        }
     }
 }
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index d8c27a2d..424fe42b 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -704,7 +704,15 @@ namespace StardewModdingApi.Installer
                 }
                 if (!context.LooksLikeGameFolder(directory))
                 {
-                    this.PrintWarning("That directory doesn't contain a Stardew Valley executable.");
+                    if (context.LooksLikeStardewValley154(directory))
+                    {
+                        this.PrintWarning("That directory seems to have Stardew Valley 1.5.4 or earlier.");
+                        this.PrintWarning("Please update your game to the latest version to use SMAPI.");
+                    }
+                    else
+                    {
+                        this.PrintWarning("That directory doesn't contain a Stardew Valley executable.");
+                    }
                     continue;
                 }
 
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 7553c07f..c7ebe6e0 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using System.Xml.Linq;
 using System.Xml.XPath;
 using StardewModdingAPI.Toolkit.Utilities;
+using System.Reflection;
 #if SMAPI_FOR_WINDOWS
 using Microsoft.Win32;
 #endif
@@ -59,6 +60,32 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                 && dir.EnumerateFiles("Stardew Valley.dll").Any();
         }
 
+        /// <summary>Get whether a folder seems to contain Stardew Valley 1.5.4 or earlier.</summary>
+        /// <param name="dir">The folder to check.</param>
+        public bool LooksLikeStardewValley154(DirectoryInfo dir)
+        {
+            if (!dir.Exists || this.LooksLikeGameFolder(dir))
+                return false;
+
+            // get legacy executable
+            FileInfo executable = new FileInfo(Path.Combine(dir.FullName, "Stardew Valley.exe"));
+            if (!executable.Exists)
+                executable = new FileInfo(Path.Combine(dir.FullName, "StardewValley.exe"));
+            if (!executable.Exists)
+                return false;
+
+            // check if it's a standard .NET assembly
+            // This will fail in Stardew Valley 1.5.5+, where it's a binary wrapper around Stardew Valley.dll.
+            try
+            {
+                Version version = AssemblyName.GetAssemblyName(executable.FullName).Version;
+                return true;
+            }
+            catch
+            {
+                return false;
+            }
+        }
 
         /*********
         ** Private methods

From 98d01d522d488192b5d5da50d70752a8c0739a94 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 5 Dec 2021 00:51:24 -0500
Subject: [PATCH 373/856] improve error when installer is pointed at a
 compatibility-branch game folder

---
 docs/release-notes.md                         |  2 +-
 .../Framework/InstallerContext.cs             |  6 +-
 src/SMAPI.Installer/InteractiveInstaller.cs   | 67 ++++++++++++++-----
 .../Framework/GameScanning/GameFolderType.cs  | 21 ++++++
 .../Framework/GameScanning/GameScanner.cs     | 58 +++++++++++-----
 5 files changed, 114 insertions(+), 40 deletions(-)
 create mode 100644 src/SMAPI.Toolkit/Framework/GameScanning/GameFolderType.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index aa9b488c..8c2b6a9e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,7 +4,7 @@
 ## Upcoming version
 * For players:
   * You no longer need .NET 5 installed to run SMAPI or the installer.
-  * The installer now detects when the game folder contains an incompatible older game version.
+  * The installer now detects when the game folder contains an incompatible legacy game version.
   * Updated for the latest Stardew Valley 1.5.5 hotfix.
 
 * For SMAPI maintainers:
diff --git a/src/SMAPI.Installer/Framework/InstallerContext.cs b/src/SMAPI.Installer/Framework/InstallerContext.cs
index 68df2001..bb973230 100644
--- a/src/SMAPI.Installer/Framework/InstallerContext.cs
+++ b/src/SMAPI.Installer/Framework/InstallerContext.cs
@@ -55,11 +55,11 @@ namespace StardewModdingAPI.Installer.Framework
             return this.GameScanner.LooksLikeGameFolder(dir);
         }
 
-        /// <summary>Get whether a folder seems to contain Stardew Valley 1.5.4 or earlier.</summary>
+        /// <summary>Get whether a folder seems to contain the game, and which version it contains if so.</summary>
         /// <param name="dir">The folder to check.</param>
-        public bool LooksLikeStardewValley154(DirectoryInfo dir)
+        public GameFolderType GetGameFolderType(DirectoryInfo dir)
         {
-            return this.GameScanner.LooksLikeStardewValley154(dir);
+            return this.GameScanner.GetGameFolderType(dir);
         }
     }
 }
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 424fe42b..6694c257 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -10,6 +10,7 @@ using StardewModdingAPI.Installer.Framework;
 using StardewModdingAPI.Internal.ConsoleWriting;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework;
+using StardewModdingAPI.Toolkit.Framework.GameScanning;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Utilities;
 
@@ -633,18 +634,39 @@ namespace StardewModdingApi.Installer
             // use specified path
             if (specifiedPath != null)
             {
+                string errorPrefix = $"You specified --game-path \"{specifiedPath}\", but";
+
                 var dir = new DirectoryInfo(specifiedPath);
                 if (!dir.Exists)
                 {
-                    this.PrintError($"You specified --game-path \"{specifiedPath}\", but that folder doesn't exist.");
+                    this.PrintError($"{errorPrefix} that folder doesn't exist.");
                     return null;
                 }
-                if (!context.LooksLikeGameFolder(dir))
+
+                switch (context.GetGameFolderType(dir))
                 {
-                    this.PrintError($"You specified --game-path \"{specifiedPath}\", but that folder doesn't contain the Stardew Valley executable.");
-                    return null;
+                    case GameFolderType.Valid:
+                        return dir;
+
+                    case GameFolderType.Legacy154OrEarlier:
+                        this.PrintWarning($"{errorPrefix} that directory seems to have Stardew Valley 1.5.4 or earlier.");
+                        this.PrintWarning("Please update your game to the latest version to use SMAPI.");
+                        return null;
+
+                    case GameFolderType.LegacyCompatibilityBranch:
+                        this.PrintWarning($"{errorPrefix} that directory seems to have the Stardew Valley legacy 'compatibility' branch.");
+                        this.PrintWarning("Unfortunately SMAPI is only compatible with the full main version of the game.");
+                        this.PrintWarning("Please update your game to the main branch to use SMAPI.");
+                        return null;
+
+                    case GameFolderType.NoGameFound:
+                        this.PrintWarning($"{errorPrefix} that directory doesn't contain a Stardew Valley executable.");
+                        return null;
+
+                    default:
+                        this.PrintWarning($"{errorPrefix} that directory doesn't seem to contain a valid game install.");
+                        return null;
                 }
-                return dir;
             }
 
             // let user choose detected path
@@ -702,23 +724,32 @@ namespace StardewModdingApi.Installer
                     this.PrintWarning("That directory doesn't seem to exist.");
                     continue;
                 }
-                if (!context.LooksLikeGameFolder(directory))
+
+                switch (context.GetGameFolderType(directory))
                 {
-                    if (context.LooksLikeStardewValley154(directory))
-                    {
+                    case GameFolderType.Valid:
+                        this.PrintInfo("   OK!");
+                        return directory;
+
+                    case GameFolderType.Legacy154OrEarlier:
                         this.PrintWarning("That directory seems to have Stardew Valley 1.5.4 or earlier.");
                         this.PrintWarning("Please update your game to the latest version to use SMAPI.");
-                    }
-                    else
-                    {
-                        this.PrintWarning("That directory doesn't contain a Stardew Valley executable.");
-                    }
-                    continue;
-                }
+                        continue;
 
-                // looks OK
-                this.PrintInfo("   OK!");
-                return directory;
+                    case GameFolderType.LegacyCompatibilityBranch:
+                        this.PrintWarning("That directory seems to have the Stardew Valley legacy 'compatibility' branch.");
+                        this.PrintWarning("Unfortunately SMAPI is only compatible with the full main version of the game.");
+                        this.PrintWarning("Please update your game to the main branch to use SMAPI.");
+                        continue;
+
+                    case GameFolderType.NoGameFound:
+                        this.PrintWarning("That directory doesn't contain a Stardew Valley executable.");
+                        continue;
+
+                    default:
+                        this.PrintWarning("That directory doesn't seem to contain a valid game install.");
+                        continue;
+                }
             }
         }
 
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameFolderType.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameFolderType.cs
new file mode 100644
index 00000000..d18af59b
--- /dev/null
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameFolderType.cs
@@ -0,0 +1,21 @@
+namespace StardewModdingAPI.Toolkit.Framework.GameScanning
+{
+    /// <summary>The detected validity for a Stardew Valley game folder based on file structure heuristics.</summary>
+    public enum GameFolderType
+    {
+        /// <summary>The folder seems to contain a valid Stardew Valley 1.5.5+ install.</summary>
+        Valid,
+
+        /// <summary>The folder doesn't contain Stardew Valley.</summary>
+        NoGameFound,
+
+        /// <summary>The folder contains Stardew Valley 1.5.4 or earlier. This version uses XNA Framework and 32-bit .NET Framework 4.5.2 on Windows and Mono on Linux/macOS, and isn't compatible with current versions of SMAPI.</summary>
+        Legacy154OrEarlier,
+
+        /// <summary>The folder contains Stardew Valley from the game's legacy compatibility branch, which backports newer changes to the <see cref="Legacy154OrEarlier"/> format.</summary>
+        LegacyCompatibilityBranch,
+
+        /// <summary>The folder seems to contain Stardew Valley files, but they failed to load for unknown reasons (e.g. corrupted executable).</summary>
+        InvalidUnknown
+    }
+}
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index c7ebe6e0..37e4f263 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -55,36 +55,58 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         /// <param name="dir">The folder to check.</param>
         public bool LooksLikeGameFolder(DirectoryInfo dir)
         {
-            return
-                dir.Exists
-                && dir.EnumerateFiles("Stardew Valley.dll").Any();
+            return this.GetGameFolderType(dir) == GameFolderType.Valid;
         }
 
-        /// <summary>Get whether a folder seems to contain Stardew Valley 1.5.4 or earlier.</summary>
+        /// <summary>Detect the validity of a game folder based on file structure heuristics.</summary>
         /// <param name="dir">The folder to check.</param>
-        public bool LooksLikeStardewValley154(DirectoryInfo dir)
+        public GameFolderType GetGameFolderType(DirectoryInfo dir)
         {
-            if (!dir.Exists || this.LooksLikeGameFolder(dir))
-                return false;
+            // no such folder
+            if (!dir.Exists)
+                return GameFolderType.NoGameFound;
 
-            // get legacy executable
-            FileInfo executable = new FileInfo(Path.Combine(dir.FullName, "Stardew Valley.exe"));
-            if (!executable.Exists)
-                executable = new FileInfo(Path.Combine(dir.FullName, "StardewValley.exe"));
-            if (!executable.Exists)
-                return false;
+            // apparently valid
+            if (dir.EnumerateFiles("Stardew Valley.dll").Any())
+                return GameFolderType.Valid;
 
-            // check if it's a standard .NET assembly
-            // This will fail in Stardew Valley 1.5.5+, where it's a binary wrapper around Stardew Valley.dll.
+            // doesn't contain any version of Stardew Valley
+            FileInfo executable = new(Path.Combine(dir.FullName, "Stardew Valley.exe"));
+            if (!executable.Exists)
+                executable = new(Path.Combine(dir.FullName, "StardewValley.exe")); // pre-1.5.5 Linux/macOS executable
+            if (!executable.Exists)
+                return GameFolderType.NoGameFound;
+
+            // get assembly version
+            Version version;
             try
             {
-                Version version = AssemblyName.GetAssemblyName(executable.FullName).Version;
-                return true;
+                version = AssemblyName.GetAssemblyName(executable.FullName).Version;
             }
             catch
             {
-                return false;
+                // The executable exists but it doesn't seem to be a valid assembly. This would
+                // happen with Stardew Valley 1.5.5+, but that should have been flagged as a valid
+                // folder before this point.
+                return GameFolderType.InvalidUnknown;
             }
+
+            // ignore Stardew Valley 1.5.5+ at this point
+            if (version.Major == 1 && version.Minor == 3 && version.Build == 37)
+                return GameFolderType.InvalidUnknown;
+
+            // incompatible version
+            if (version.Major == 1 && version.Minor < 4)
+            {
+                // Stardew Valley 1.5.4 and earlier have assembly versions <= 1.3.7853.31734
+                if (version.Minor < 3 || version.Build <= 7853)
+                    return GameFolderType.Legacy154OrEarlier;
+
+                // Stardew Valley 1.5.5+ legacy compatibility branch
+                return GameFolderType.LegacyCompatibilityBranch;
+            }
+
+            return GameFolderType.InvalidUnknown;
         }
 
         /*********

From 6a45640dd778cb28f885680c66d36fbcd76379a7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 5 Dec 2021 02:19:17 -0500
Subject: [PATCH 374/856] add known issue to release notes for missing
 pufferchick icon

---
 docs/release-notes.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8c2b6a9e..7bb38b9b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,13 +6,14 @@
   * You no longer need .NET 5 installed to run SMAPI or the installer.
   * The installer now detects when the game folder contains an incompatible legacy game version.
   * Updated for the latest Stardew Valley 1.5.5 hotfix.
+  * **Known issue:** SMAPI no longer has a pufferchick icon on Windows. That's [a known bug in .NET](https://github.com/dotnet/runtime/issues/3828) which affects the changes needed to run SMAPI without installing .NET manually.
+
+* For the web UI:
+  * Fixed the JSON validator marking `.fnt` files invalid in Content Patcher files.
 
 * For SMAPI maintainers:
   * Added a new [scripted release package process](technical/smapi.md), which removes the need to compile SMAPI on multiple platforms and manually combine them.
 
-* For the web UI:
-  * Updated the JSON validator/schema for `.fnt` support in Content Patcher 1.24.0.
-
 ## 3.13.1
 Released 30 November 2021 for Stardew Valley 1.5.5 or later.
 

From c05fdf65cfc8864d5f436e3a42e6e2df144c1db8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 5 Dec 2021 18:39:08 -0500
Subject: [PATCH 375/856] mark UI Info Suite incompatible

---
 docs/release-notes.md                     | 1 +
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7bb38b9b..4c734cb3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@
   * You no longer need .NET 5 installed to run SMAPI or the installer.
   * The installer now detects when the game folder contains an incompatible legacy game version.
   * Updated for the latest Stardew Valley 1.5.5 hotfix.
+  * Updated compatibility list.
   * **Known issue:** SMAPI no longer has a pufferchick icon on Windows. That's [a known bug in .NET](https://github.com/dotnet/runtime/issues/3828) which affects the changes needed to run SMAPI without installing .NET manually.
 
 * For the web UI:
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index bb166017..eb76b29a 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -215,6 +215,11 @@
             "~0.4.1 | Status": "AssumeBroken",
             "~0.4.1 | StatusReasonDetails": "causes freeze during game launch"
         },
+        "UI Info Suite": {
+            "ID": "Cdaragorn.UiInfoSuite",
+            "~2.0.0 | Status": "AssumeBroken",
+            "~2.0.0 | StatusReasonDetails": "causes lag, errors, or crashes in-game"
+        },
         "Video Player": {
             "ID": "aedenthorn.VideoPlayer",
             "~0.2.5 | Status": "AssumeBroken",

From f4ca7dd228390f030735195357e81e5170bcd474 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 5 Dec 2021 18:55:10 -0500
Subject: [PATCH 376/856] add Windows build process to fix application icon
 until .NET bug is fixed

---
 .editorconfig                               |   3 +
 .gitattributes                              |   5 +-
 build/{ => unix}/prepare-install-package.sh |  24 ++-
 build/{ => unix}/set-smapi-version.sh       |  10 +-
 build/windows/finalize-install-package.sh   |  67 ++++++
 build/windows/lib/in-place-regex.ps1        |  11 +
 build/windows/prepare-install-package.ps1   | 217 ++++++++++++++++++++
 build/windows/set-smapi-version.ps1         |  25 +++
 docs/release-notes.md                       |   1 -
 docs/technical/smapi.md                     | 101 ++++++---
 src/SMAPI.Mods.ErrorHandler/i18n/pl.json    |   8 +-
 src/SMAPI.sln                               |  23 ++-
 src/SMAPI/i18n/pl.json                      |  12 +-
 13 files changed, 449 insertions(+), 58 deletions(-)
 rename build/{ => unix}/prepare-install-package.sh (93%)
 mode change 100755 => 100644
 rename build/{ => unix}/set-smapi-version.sh (79%)
 mode change 100755 => 100644
 create mode 100755 build/windows/finalize-install-package.sh
 create mode 100644 build/windows/lib/in-place-regex.ps1
 create mode 100644 build/windows/prepare-install-package.ps1
 create mode 100644 build/windows/set-smapi-version.ps1

diff --git a/.editorconfig b/.editorconfig
index d600d602..2aeaeadd 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -22,6 +22,9 @@ insert_final_newline = false
 [README.txt]
 end_of_line=crlf
 
+[*.{command,sh}]
+end_of_line=lf
+
 ##########
 ## C# formatting
 ## documentation: https://docs.microsoft.com/en-us/visualstudio/ide/editorconfig-code-style-settings-reference
diff --git a/.gitattributes b/.gitattributes
index 1161a204..00ae145b 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,3 +1,6 @@
 # normalize line endings
 * text=auto
-README.txt text=crlf
+README.txt text eol=crlf
+
+*.command text eol=lf
+*.sh text eol=lf
diff --git a/build/prepare-install-package.sh b/build/unix/prepare-install-package.sh
old mode 100755
new mode 100644
similarity index 93%
rename from build/prepare-install-package.sh
rename to build/unix/prepare-install-package.sh
index 39575c4c..9a89f8d4
--- a/build/prepare-install-package.sh
+++ b/build/unix/prepare-install-package.sh
@@ -1,5 +1,13 @@
 #!/bin/bash
 
+#
+#
+# This is the Bash equivalent of ../windows/prepare-install-package.ps1.
+# When making changes, both scripts should be updated.
+#
+#
+
+
 ##########
 ## Constants
 ##########
@@ -17,19 +25,18 @@ declare -A msBuildPlatformNames=(["linux"]="Unix" ["macOS"]="OSX" ["windows"]="W
 ##########
 ## Move to SMAPI root
 ##########
-cd "`dirname "$0"`/.."
+cd "`dirname "$0"`/../.."
 
 
 ##########
 ## Clear old build files
 ##########
 echo "Clearing old builds..."
-echo "-----------------------"
-for path in */**/bin */**/obj; do
+echo "-------------------------------------------------"
+for path in bin */**/bin */**/obj; do
     echo "$path"
     rm -rf $path
 done
-rm -rf "bin"
 echo ""
 
 ##########
@@ -40,20 +47,20 @@ for folder in ${folders[@]}; do
     msbuildPlatformName=${msBuildPlatformNames[$folder]}
 
     echo "Compiling SMAPI for $folder..."
-    echo "------------------"
+    echo "-------------------------------------------------"
     dotnet publish src/SMAPI --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false" --self-contained true
     echo ""
     echo ""
 
     echo "Compiling installer for $folder..."
-    echo "----------------------"
+    echo "-------------------------------------------------"
     dotnet publish src/SMAPI.Installer --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false" -p:PublishTrimmed=True -p:TrimMode=Link --self-contained true
     echo ""
     echo ""
 
     for modName in ${bundleModNames[@]}; do
         echo "Compiling $modName for $folder..."
-        echo "----------------------------------"
+        echo "-------------------------------------------------"
         dotnet publish src/SMAPI.Mods.$modName --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false"
         echo ""
         echo ""
@@ -65,7 +72,7 @@ done
 ## Prepare install package
 ##########
 echo "Preparing install package..."
-echo "----------------------------"
+echo "-------------------------------------------------"
 
 # init paths
 installAssets="src/SMAPI.Installer/assets"
@@ -93,7 +100,6 @@ for folder in ${folders[@]}; do
 
     # installer files
     cp -r "src/SMAPI.Installer/bin/$buildConfig/$runtime/publish"/* "$internalPath"
-    rm -rf "$internalPath/ref"
     rm -rf "$internalPath/assets"
 
     # runtime config for SMAPI
diff --git a/build/set-smapi-version.sh b/build/unix/set-smapi-version.sh
old mode 100755
new mode 100644
similarity index 79%
rename from build/set-smapi-version.sh
rename to build/unix/set-smapi-version.sh
index 42174cae..0c0cbeb0
--- a/build/set-smapi-version.sh
+++ b/build/unix/set-smapi-version.sh
@@ -1,5 +1,13 @@
 #!/bin/bash
 
+#
+#
+# This is the Bash equivalent of ../windows/set-smapi-version.ps1.
+# When making changes, both scripts should be updated.
+#
+#
+
+
 # get version number
 version="$1"
 if [ $# -eq 0 ]; then
@@ -8,7 +16,7 @@ if [ $# -eq 0 ]; then
 fi
 
 # move to SMAPI root
-cd "`dirname "$0"`/.."
+cd "`dirname "$0"`/../.."
 
 # apply changes
 sed "s/<Version>.+<\/Version>/<Version>$version<\/Version>/" "build/common.targets" --in-place --regexp-extended
diff --git a/build/windows/finalize-install-package.sh b/build/windows/finalize-install-package.sh
new file mode 100755
index 00000000..0996e3ed
--- /dev/null
+++ b/build/windows/finalize-install-package.sh
@@ -0,0 +1,67 @@
+#!/bin/bash
+
+##########
+## Read config
+##########
+# get SMAPI version
+version="$1"
+if [ $# -eq 0 ]; then
+    echo "SMAPI release version (like '4.0.0'):"
+    read version
+fi
+
+# get Windows bin path
+windowsBinPath="$2"
+if [ $# -le 1 ]; then
+    echo "Windows compiled bin path:"
+    read windowsBinPath
+fi
+
+# installer internal folders
+buildFolders=("linux" "macOS" "windows")
+
+
+##########
+## Finalize release package
+##########
+for folderName in "SMAPI $version installer" "SMAPI $version installer for developers"; do
+    # move files to Linux filesystem
+    echo "Preparing $folderName.zip..."
+    echo "-------------------------------------------------"
+    echo "copying '$windowsBinPath/$folderName' to Linux filesystem..."
+    cp -r "$windowsBinPath/$folderName" .
+
+    # fix permissions
+    echo "fixing permissions..."
+    find "$folderName" -type d -exec chmod 755 {} \;
+    find "$folderName" -type f -exec chmod 644 {} \;
+    find "$folderName" -name "*.sh" -exec chmod 755 {} \;
+    find "$folderName" -name "*.command" -exec chmod 755 {} \;
+    find "$folderName" -name "SMAPI.Installer" -exec chmod 755 {} \;
+    find "$folderName" -name "StardewModdingAPI" -exec chmod 755 {} \;
+
+    # convert bundle folder into final 'install.dat' files
+    for build in ${buildFolders[@]}; do
+        echo "packaging $folderName/internal/$build/install.dat..."
+        pushd "$folderName/internal/$build/bundle" > /dev/null
+        zip "install.dat" * --recurse-paths --quiet
+        mv install.dat ../
+        popd > /dev/null
+
+        rm -rf "$folderName/internal/$build/bundle"
+    done
+
+    # zip installer
+    echo "packaging installer..."
+    zip -9 "$folderName.zip" "$folderName" --recurse-paths --quiet
+
+    # move zip back to Windows bin path
+    echo "moving release zip to $windowsBinPath/$folderName.zip..."
+    mv "$folderName.zip" "$windowsBinPath"
+    rm -rf "$folderName"
+
+    echo ""
+    echo ""
+done
+
+echo "Done!"
diff --git a/build/windows/lib/in-place-regex.ps1 b/build/windows/lib/in-place-regex.ps1
new file mode 100644
index 00000000..7b309342
--- /dev/null
+++ b/build/windows/lib/in-place-regex.ps1
@@ -0,0 +1,11 @@
+function In-Place-Regex {
+    param (
+        [Parameter(Mandatory)][string]$Path,
+        [Parameter(Mandatory)][string]$Search,
+        [Parameter(Mandatory)][string]$Replace
+    )
+
+    $content = (Get-Content "$Path" -Encoding UTF8)
+    $content = ($content -replace "$Search", "$Replace")
+    [System.IO.File]::WriteAllLines((Get-Item "$Path").FullName, $content)
+}
diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
new file mode 100644
index 00000000..db7fadcb
--- /dev/null
+++ b/build/windows/prepare-install-package.ps1
@@ -0,0 +1,217 @@
+#
+#
+# This is the PowerShell equivalent of ../unix/prepare-install-package.sh, *except* that it doesn't
+# set Linux permissions, create the install.dat files, or create the final zip. Due to limitations
+# in PowerShell, the final changes are handled by the windows/finalize-install-package.sh file in
+# WSL.
+#
+# When making changes, make sure to update ../unix/prepare-install-package.ps1 too.
+#
+#
+
+
+. "$PSScriptRoot\lib\in-place-regex.ps1"
+
+##########
+## Constants
+##########
+# paths
+$gamePath = "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley"
+$bundleModNames = "ConsoleCommands", "ErrorHandler", "SaveBackup"
+
+# build configuration
+$buildConfig = "Release"
+$folders = "linux", "macOS", "windows"
+$runtimes = @{ linux = "linux-x64"; macOS = "osx-x64"; windows = "win-x64" }
+$msBuildPlatformNames = @{ linux = "Unix"; macOS = "OSX"; windows = "Windows_NT" }
+
+
+##########
+## Move to SMAPI root
+##########
+cd "$PSScriptRoot/../.."
+
+
+##########
+## Clear old build files
+##########
+echo "Clearing old builds..."
+echo "-------------------------------------------------"
+
+foreach ($path in (dir -Recurse -Include ('bin', 'obj'))) {
+    echo "$path"
+    rm -Recurse -Force "$path"
+}
+echo ""
+
+
+##########
+## Compile files
+##########
+ForEach ($folder in $folders) {
+    $runtime = $runtimes[$folder]
+    $msbuildPlatformName = $msBuildPlatformNames[$folder]
+
+    echo "Compiling SMAPI for $folder..."
+    echo "-------------------------------------------------"
+    dotnet publish src/SMAPI --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false" --self-contained true
+    echo ""
+    echo ""
+
+    echo "Compiling installer for $folder..."
+    echo "-------------------------------------------------"
+    dotnet publish src/SMAPI.Installer --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false" -p:PublishTrimmed=True -p:TrimMode=Link --self-contained true
+    echo ""
+    echo ""
+
+    foreach ($modName in $bundleModNames) {
+        echo "Compiling $modName for $folder..."
+        echo "-------------------------------------------------"
+        dotnet publish src/SMAPI.Mods.$modName --configuration $buildConfig -v minimal --runtime "$runtime" -p:OS="$msbuildPlatformName" -p:GamePath="$gamePath" -p:CopyToGameFolder="false"
+        echo ""
+        echo ""
+    }
+}
+
+
+##########
+## Prepare install package
+##########
+echo "Preparing install package..."
+echo "----------------------------"
+
+# init paths
+$installAssets = "src/SMAPI.Installer/assets"
+$packagePath = "bin/SMAPI installer"
+$packageDevPath = "bin/SMAPI installer for developers"
+
+# init structure
+foreach ($folder in $folders) {
+    mkdir "$packagePath/internal/$folder/bundle/smapi-internal" > $null
+}
+
+# copy base installer files
+foreach ($name in @("install on Linux.sh", "install on macOS.command", "install on Windows.bat", "README.txt")) {
+    cp "$installAssets/$name" "$packagePath"
+}
+
+# copy per-platform files
+foreach ($folder in $folders) {
+    $runtime = $runtimes[$folder]
+
+    # get paths
+    $smapiBin = "src/SMAPI/bin/$buildConfig/$runtime/publish"
+    $internalPath = "$packagePath/internal/$folder"
+    $bundlePath = "$internalPath/bundle"
+
+    # installer files
+    cp "src/SMAPI.Installer/bin/$buildConfig/$runtime/publish/*" "$internalPath" -Recurse
+    rm -Recurse -Force "$internalPath/assets"
+
+    # runtime config for SMAPI
+    # This is identical to the one generated by the build, except that the min runtime version is
+    # set to 5.0.0 (instead of whatever version it was built with) and rollForward is set to latestMinor instead of
+    # minor.
+    cp "$installAssets/runtimeconfig.json" "$bundlePath/StardewModdingAPI.runtimeconfig.json"
+
+    # installer DLL config
+    if ($folder -eq "windows") {
+        cp "$installAssets/windows-exe-config.xml" "$packagePath/internal/windows/install.exe.config"
+    }
+
+    # bundle root files
+    foreach ($name in @("StardewModdingAPI", "StardewModdingAPI.dll", "StardewModdingAPI.pdb", "StardewModdingAPI.xml", "steam_appid.txt")) {
+        if ($name -eq "StardewModdingAPI" -and $folder -eq "windows") {
+            $name = "$name.exe"
+        }
+
+        cp "$smapiBin/$name" "$bundlePath"
+    }
+
+    # bundle i18n
+    cp -Recurse "$smapiBin/i18n" "$bundlePath/smapi-internal"
+
+    # bundle smapi-internal
+    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml")) {
+        cp "$smapiBin/$name" "$bundlePath/smapi-internal"
+    }
+
+    cp "$smapiBin/SMAPI.config.json" "$bundlePath/smapi-internal/config.json"
+    cp "$smapiBin/SMAPI.metadata.json" "$bundlePath/smapi-internal/metadata.json"
+    if ($folder -eq "linux" -or $folder -eq "macOS") {
+        cp "$installAssets/unix-launcher.sh" "$bundlePath"
+        cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
+    }
+    else {
+        cp "$installAssets/windows-exe-config.xml" "$bundlePath/StardewModdingAPI.exe.config"
+    }
+
+    # copy .NET dependencies
+    cp "$smapiBin/System.Configuration.ConfigurationManager.dll" "$bundlePath/smapi-internal"
+    cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
+    cp "$smapiBin/System.Security.Permissions.dll" "$bundlePath/smapi-internal"
+    if ($folder -eq "windows") {
+        cp "$smapiBin/System.Management.dll" "$bundlePath/smapi-internal"
+    }
+
+    # copy bundled mods
+    foreach ($modName in $bundleModNames) {
+        $fromPath = "src/SMAPI.Mods.$modName/bin/$buildConfig/$runtime/publish"
+        $targetPath = "$bundlePath/Mods/$modName"
+
+        mkdir "$targetPath" > $null
+
+        cp "$fromPath/$modName.dll" "$targetPath"
+        cp "$fromPath/$modName.pdb" "$targetPath"
+        cp "$fromPath/manifest.json" "$targetPath"
+        if (Test-Path "$fromPath/i18n" -PathType Container) {
+            cp -Recurse "$fromPath/i18n" "$targetPath"
+        }
+    }
+}
+
+# DISABLED: will be handled by Linux script
+# mark scripts executable
+#ForEach ($path in @("install on Linux.sh", "install on macOS.command", "bundle/unix-launcher.sh")) {
+#    if (Test-Path "$packagePath/$path" -PathType Leaf) {
+#        chmod 755 "$packagePath/$path"
+#    }
+#}
+
+# split into main + for-dev folders
+cp -Recurse "$packagePath" "$packageDevPath"
+foreach ($folder in $folders) {
+    # disable developer mode in main package
+    In-Place-Regex -Path "$packagePath/internal/$folder/bundle/smapi-internal/config.json" -Search "`"DeveloperMode`": true" -Replace "`"DeveloperMode`": false"
+
+    # DISABLED: will be handled by Linux script
+    # convert bundle folder into final 'install.dat' files
+    #foreach ($path in @("$packagePath/internal/$folder", "$packageDevPath/internal/$folder"))
+    #{
+    #    Compress-Archive -Path "$path/bundle/*" -CompressionLevel Optimal -DestinationPath "$path/install.zip"
+    #    mv "$path/install.zip" "$path/install.dat"
+    #    rm -Recurse -Force "$path/bundle"
+    #}
+}
+
+
+###########
+### Create release zips
+###########
+# get version number
+$version = $args[0]
+if (!$version) {
+    $version = Read-Host "SMAPI release version (like '4.0.0')"
+}
+
+# rename folders
+mv "$packagePath" "bin/SMAPI $version installer"
+mv "$packageDevPath" "bin/SMAPI $version installer for developers"
+
+# DISABLED: will be handled by Linux script
+## package files
+#Compress-Archive -Path "bin/SMAPI $version installer" -DestinationPath "bin/SMAPI $version installer.zip" -CompressionLevel Optimal
+#Compress-Archive -Path "bin/SMAPI $version installer for developers" -DestinationPath "bin/SMAPI $version installer for developers.zip" -CompressionLevel Optimal
+
+echo ""
+echo "Done! See docs/technical/smapi.md to create the release zips."
diff --git a/build/windows/set-smapi-version.ps1 b/build/windows/set-smapi-version.ps1
new file mode 100644
index 00000000..ff6b2096
--- /dev/null
+++ b/build/windows/set-smapi-version.ps1
@@ -0,0 +1,25 @@
+#
+#
+# This is the PowerShell equivalent of ../unix/set-smapi-version.sh.
+# When making changes, both scripts should be updated.
+#
+#
+
+
+. "$PSScriptRoot\lib\in-place-regex.ps1"
+
+# get version number
+$version=$args[0]
+if (!$version) {
+    $version = Read-Host "SMAPI release version (like '4.0.0')"
+}
+
+# move to SMAPI root
+cd "$PSScriptRoot/../.."
+
+# apply changes
+In-Place-Regex -Path "build/common.targets" -Search "<Version>.+</Version>" -Replace "<Version>$version</Version>"
+In-Place-Regex -Path "src/SMAPI/Constants.cs" -Search "RawApiVersion = `".+?`";" -Replace "RawApiVersion = `"$version`";"
+ForEach ($modName in "ConsoleCommands","ErrorHandler","SaveBackup") {
+    In-Place-Regex -Path "src/SMAPI.Mods.$modName/manifest.json" -Search "`"(Version|MinimumApiVersion)`": `".+?`"" -Replace "`"`$1`": `"$version`""
+}
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4c734cb3..8a26514d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,7 +7,6 @@
   * The installer now detects when the game folder contains an incompatible legacy game version.
   * Updated for the latest Stardew Valley 1.5.5 hotfix.
   * Updated compatibility list.
-  * **Known issue:** SMAPI no longer has a pufferchick icon on Windows. That's [a known bug in .NET](https://github.com/dotnet/runtime/issues/3828) which affects the changes needed to run SMAPI without installing .NET manually.
 
 * For the web UI:
   * Fixed the JSON validator marking `.fnt` files invalid in Content Patcher files.
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index f2e030d8..d9aad875 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -11,11 +11,12 @@ This document is about SMAPI itself; see also [mod build package](mod-package.md
   * [Configuration file](#configuration-file)
   * [Command-line arguments](#command-line-arguments)
   * [Compile flags](#compile-flags)
-* [For SMAPI developers](#for-smapi-developers)
-  * [Compiling from source](#compiling-from-source)
-  * [Debugging a local build](#debugging-a-local-build)
-  * [Preparing a release](#preparing-a-release)
-  * [Using a custom Harmony build](#using-a-custom-harmony-build)
+* [Compile from source code](#compile-from-source-code)
+  * [Main project](#main-project)
+  * [Custom Harmony build](#custom-harmony-build)
+* [Prepare a release](#prepare-a-release)
+  * [On any platform](#on-any-platform)
+  * [On Windows](#on-windows)
 * [Release notes](#release-notes)
 
 ## Customisation
@@ -58,36 +59,37 @@ flag | purpose
 ---- | -------
 `SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/macOS. Set automatically in `common.targets`.
 
-## For SMAPI developers
-### Compiling from source
+## Compile from source code
+### Main project
 Using an official SMAPI release is recommended for most users, but you can compile from source
-directly if needed. There are no special steps (just open the project and compile), but SMAPI often
-uses the latest C# syntax. You may need the latest version of your IDE to compile it.
+directly if needed. Just open the project in an IDE like [Visual
+Studio](https://visualstudio.microsoft.com/vs/community/) or [Rider](https://www.jetbrains.com/rider/),
+and build the `SMAPI` project. The project will automatically adjust the build settings for your
+current OS and Stardew Valley install path.
 
-SMAPI uses build configuration derived from the [crossplatform mod config](https://smapi.io/package/readme)
-to detect your current OS automatically and load the correct references. Compile output will be
-placed in a `bin` folder at the root of the Git repository.
-
-### Debugging a local build
 Rebuilding the solution in debug mode will copy the SMAPI files into your game folder. Starting
-the `SMAPI` project with debugging from Visual Studio (on macOS or Windows) will launch SMAPI with
-the debugger attached, so you can intercept errors and step through the code being executed. That
-doesn't work in MonoDevelop on Linux, unfortunately.
+the `SMAPI` project with debugging from Visual Studio or Rider should launch SMAPI with the
+debugger attached, so you can intercept errors and step through the code being executed.
 
-### Preparing a release
-To prepare a crossplatform SMAPI release, you'll need to run the build script on Linux or macOS.
+### Custom Harmony build
+SMAPI uses [a custom build of Harmony](https://github.com/Pathoschild/Harmony#readme), which is
+included in the `build` folder. To use a different build, just replace `0Harmony.dll` in that
+folder before compiling.
 
-#### Initial setup
-First-time setup:
+## Prepare a release
+### On any platform
+**⚠ Ideally we'd have one set of instructions for all platforms. The instructions in this section
+will produce a fully functional release for all supported platfrms, _except_ that the application
+icon for SMAPI on Windows will disappear due to [.NET runtime bug
+3828](https://github.com/dotnet/runtime/issues/3828). Until that's fixed, see the _[on
+Windows](#on-windows)_ section below to create a build that retains the icon.**
 
+#### First-time setup
 1. On Windows only:
-
    1. [Install Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/install).
    2. Run `sudo apt update` in WSL to update the package list.
    3. The rest of the instructions below should be run in WSL.
-
 2. Install the required software:
-
    1. Install the [.NET 5 SDK](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu).  
       _For Ubuntu-based systems, you can run `lsb_release -a` to get the Ubuntu version number._
    2. [Install Steam](https://linuxconfig.org/how-to-install-steam-on-ubuntu-20-04-focal-fossa-linux).
@@ -100,14 +102,12 @@ First-time setup:
       ln -s "/opt/JetBrains Rider-<version>/bin/rider.sh"
       ./rider.sh
       ```
-
 3. Clone the SMAPI repo:
    ```sh
    git clone https://github.com/Pathoschild/SMAPI.git
    ```
 
-To launch the game:
-
+### Launch the game
 1. Run these commands to start Steam:
    ```sh
    export TERM=xterm
@@ -115,8 +115,8 @@ To launch the game:
    ```
 2. Launch the game through the Steam UI.
 
-#### Prepare the release
-1. Run `build/set-smapi-version.sh` to set the SMAPI version. Make sure you use a [semantic
+### Prepare the release
+1. Run `build/unix/set-smapi-version.sh` to set the SMAPI version. Make sure you use a [semantic
    version](https://semver.org). Recommended format:
 
    build type | format                   | example
@@ -124,12 +124,45 @@ To launch the game:
    dev build  | `<version>-alpha.<date>` | `4.0.0-alpha.20251230`
    prerelease | `<version>-beta.<date>`  | `4.0.0-beta.20251230`
    release    | `<version>`              | `4.0.0`
-2. Run `build/prepare-install-package.sh` to create the release package in the root `bin` folder.
 
-### Custom Harmony build
-SMAPI uses [a custom build of Harmony](https://github.com/Pathoschild/Harmony#readme), which is
-included in the `build` folder. To use a different build, just replace `0Harmony.dll` in that
-folder before compiling.
+2. Run `build/unix/prepare-install-package.sh` to create the release package in the root `bin`
+   folder.
+
+### On Windows
+#### First-time setup
+1. Set up Windows Subsystem for Linux (WSL):
+   1. [Install WSL](https://docs.microsoft.com/en-us/windows/wsl/install).
+   2. Run `sudo apt update` in WSL to update the package list.
+   3. The rest of the instructions below should be run in WSL.
+2. Install the required software:
+   1. Install the [.NET 5 SDK](https://dotnet.microsoft.com/download/dotnet/5.0).
+   2. Install [Stardew Valley](https://www.stardewvalley.net/).
+3. Clone the SMAPI repo:
+   ```sh
+   git clone https://github.com/Pathoschild/SMAPI.git
+   ```
+
+### Prepare the release
+1. Run `build/windows/set-smapi-version.ps1` in PowerShell to set the SMAPI version. Make sure you
+   use a [semantic version](https://semver.org). Recommended format:
+
+   build type | format                   | example
+   :--------- | :----------------------- | :------
+   dev build  | `<version>-alpha.<date>` | `4.0.0-alpha.20251230`
+   prerelease | `<version>-beta.<date>`  | `4.0.0-beta.20251230`
+   release    | `<version>`              | `4.0.0`
+
+2. Run `build/windows/prepare-install-package.ps1` in PowerShell to create the release package
+   folders in the root `bin` folder.
+
+3. Launch WSL and run this script:
+   ```bash
+   # edit to match the build created in steps 1-2
+   # In WSL, `/mnt/c/example` accesses `C:\example` on the Windows filesystem.
+   version="4.0.0"
+   binFolder="/mnt/e/source/_Stardew/SMAPI/bin"
+   build/windows/finalize-install-package.sh "$version" "$binFolder"
+   ```
 
 ## Release notes
 See [release notes](../release-notes.md).
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/pl.json b/src/SMAPI.Mods.ErrorHandler/i18n/pl.json
index 05a9d411..f080bcd4 100644
--- a/src/SMAPI.Mods.ErrorHandler/i18n/pl.json
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/pl.json
@@ -1,4 +1,4 @@
-{
-    // warning messages
-    "warn.invalid-content-removed": "Nieprawidłowa zawartość została usunięta, aby zapobiec awarii (zobacz konsolę SMAPI po więcej informacji)."
-}
+{
+    // warning messages
+    "warn.invalid-content-removed": "Nieprawidłowa zawartość została usunięta, aby zapobiec awarii (zobacz konsolę SMAPI po więcej informacji)."
+}
diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index 961a5ff7..be5326f7 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -28,8 +28,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{09CF91E5
 	ProjectSection(SolutionItems) = preProject
 		..\build\common.targets = ..\build\common.targets
 		..\build\find-game-folder.targets = ..\build\find-game-folder.targets
-		..\build\prepare-install-package.sh = ..\build\prepare-install-package.sh
-		..\build\set-smapi-version.sh = ..\build\set-smapi-version.sh
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docs", "docs", "{EB35A917-67B9-4EFA-8DFC-4FB49B3949BB}"
@@ -85,6 +83,24 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Toolkit.CoreInterface
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Web", "SMAPI.Web\SMAPI.Web.csproj", "{80EFD92F-728F-41E0-8A5B-9F6F49A91899}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "windows", "windows", "{4D661178-38FB-43E4-AA5F-9B0406919344}"
+	ProjectSection(SolutionItems) = preProject
+		..\build\windows\finalize-install-package.sh = ..\build\windows\finalize-install-package.sh
+		..\build\windows\prepare-install-package.ps1 = ..\build\windows\prepare-install-package.ps1
+		..\build\windows\set-smapi-version.ps1 = ..\build\windows\set-smapi-version.ps1
+	EndProjectSection
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "unix", "unix", "{CAA1488E-842B-433D-994D-1D3D0B5DD125}"
+	ProjectSection(SolutionItems) = preProject
+		..\build\unix\prepare-install-package.sh = ..\build\unix\prepare-install-package.sh
+		..\build\unix\set-smapi-version.sh = ..\build\unix\set-smapi-version.sh
+	EndProjectSection
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "lib", "lib", "{3B5BF14D-F612-4C83-9EF6-E3EBFCD08766}"
+	ProjectSection(SolutionItems) = preProject
+		..\build\windows\lib\in-place-regex.ps1 = ..\build\windows\lib\in-place-regex.ps1
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SharedMSBuildProjectFiles) = preSolution
 		SMAPI.Internal\SMAPI.Internal.projitems*{0634ea4c-3b8f-42db-aea6-ca9e4ef6e92f}*SharedItemsImports = 5
@@ -168,6 +184,9 @@ Global
 		{0634EA4C-3B8F-42DB-AEA6-CA9E4EF6E92F} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
 		{491E775B-EAD0-44D4-B6CA-F1FC3E316D33} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
 		{CD53AD6F-97F4-4872-A212-50C2A0FD3601} = {AE9A4D46-E910-4293-8BC4-673F85FFF6A5}
+		{4D661178-38FB-43E4-AA5F-9B0406919344} = {09CF91E5-5BAB-4650-A200-E5EA9A633046}
+		{CAA1488E-842B-433D-994D-1D3D0B5DD125} = {09CF91E5-5BAB-4650-A200-E5EA9A633046}
+		{3B5BF14D-F612-4C83-9EF6-E3EBFCD08766} = {4D661178-38FB-43E4-AA5F-9B0406919344}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {70143042-A862-47A8-A677-7C819DDC90DC}
diff --git a/src/SMAPI/i18n/pl.json b/src/SMAPI/i18n/pl.json
index b9c788fc..fa4650a2 100644
--- a/src/SMAPI/i18n/pl.json
+++ b/src/SMAPI/i18n/pl.json
@@ -1,6 +1,6 @@
-{
-    // short date format for SDate
-    // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
-    "generic.date": "{{day}} {{seasonLowercase}}",
-    "generic.date-with-year": "{{day}} {{seasonLowercase}} w roku {{year}}"
-}
+{
+    // short date format for SDate
+    // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
+    "generic.date": "{{day}} {{seasonLowercase}}",
+    "generic.date-with-year": "{{day}} {{seasonLowercase}} w roku {{year}}"
+}

From 5b5dd47c22a1332a4c432d6a1cd414b5c83388d7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 5 Dec 2021 19:10:28 -0500
Subject: [PATCH 377/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 8 +++++---
 src/SMAPI.Installer/InteractiveInstaller.cs  | 4 ++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 7 files changed, 15 insertions(+), 13 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index ed860eee..1021c2a1 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.13.1</Version>
+    <Version>3.13.2</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8a26514d..499fa322 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,9 +1,11 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming version
+## 3.13.2
+Released 05 December 2021 for Stardew Valley 1.5.5 or later.
+
 * For players:
-  * You no longer need .NET 5 installed to run SMAPI or the installer.
+  * You no longer need .NET 5 to install or use SMAPI.
   * The installer now detects when the game folder contains an incompatible legacy game version.
   * Updated for the latest Stardew Valley 1.5.5 hotfix.
   * Updated compatibility list.
@@ -12,7 +14,7 @@
   * Fixed the JSON validator marking `.fnt` files invalid in Content Patcher files.
 
 * For SMAPI maintainers:
-  * Added a new [scripted release package process](technical/smapi.md), which removes the need to compile SMAPI on multiple platforms and manually combine them.
+  * Added [release package scripts](technical/smapi.md) to streamline preparing SMAPI releases.
 
 ## 3.13.1
 Released 30 November 2021 for Stardew Valley 1.5.5 or later.
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 6694c257..1257f12b 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -655,7 +655,7 @@ namespace StardewModdingApi.Installer
 
                     case GameFolderType.LegacyCompatibilityBranch:
                         this.PrintWarning($"{errorPrefix} that directory seems to have the Stardew Valley legacy 'compatibility' branch.");
-                        this.PrintWarning("Unfortunately SMAPI is only compatible with the full main version of the game.");
+                        this.PrintWarning("Unfortunately SMAPI is only compatible with the modern version of the game.");
                         this.PrintWarning("Please update your game to the main branch to use SMAPI.");
                         return null;
 
@@ -738,7 +738,7 @@ namespace StardewModdingApi.Installer
 
                     case GameFolderType.LegacyCompatibilityBranch:
                         this.PrintWarning("That directory seems to have the Stardew Valley legacy 'compatibility' branch.");
-                        this.PrintWarning("Unfortunately SMAPI is only compatible with the full main version of the game.");
+                        this.PrintWarning("Unfortunately SMAPI is only compatible with the modern version of the game.");
                         this.PrintWarning("Please update your game to the main branch to use SMAPI.");
                         continue;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index ac6ff6ea..216a4c32 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.13.1",
+    "Version": "3.13.2",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.13.1"
+    "MinimumApiVersion": "3.13.2"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index e19a6a7f..beb52020 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.13.1",
+    "Version": "3.13.2",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.13.1"
+    "MinimumApiVersion": "3.13.2"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 3e55ce42..2bd20a63 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.13.1",
+    "Version": "3.13.2",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.13.1"
+    "MinimumApiVersion": "3.13.2"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index c5ad215c..5de28f84 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -49,7 +49,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.13.1";
+        internal static string RawApiVersion = "3.13.2";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 4e17716fa26161016e5e59f12b52feef3fd0f8f9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 9 Dec 2021 19:56:46 -0500
Subject: [PATCH 378/856] fix log parser handling when multiple mods have the
 exact same name

---
 docs/release-notes.md                         |  4 +++
 .../Framework/LogParsing/LogParser.cs         | 35 ++++++++++++-------
 2 files changed, 26 insertions(+), 13 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 499fa322..421378e4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For the web UI:
+  * Fixed log parser not correctly handling multiple mods having the exact same name.
+
 ## 3.13.2
 Released 05 December 2021 for Stardew Valley 1.5.5 or later.
 
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 84013ccc..887d0105 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -79,7 +79,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 // parse log messages
                 LogModInfo smapiMod = new LogModInfo { Name = "SMAPI", Author = "Pathoschild", Description = "", Loaded = true };
                 LogModInfo gameMod = new LogModInfo { Name = "game", Author = "", Description = "", Loaded = true };
-                IDictionary<string, LogModInfo> mods = new Dictionary<string, LogModInfo>();
+                IDictionary<string, List<LogModInfo>> mods = new Dictionary<string, List<LogModInfo>>();
                 bool inModList = false;
                 bool inContentPackList = false;
                 bool inModUpdateList = false;
@@ -99,8 +99,11 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                                 break;
 
                             default:
-                                if (mods.ContainsKey(message.Mod))
-                                    mods[message.Mod].Errors++;
+                                if (mods.TryGetValue(message.Mod, out var entries))
+                                {
+                                    foreach (var entry in entries)
+                                        entry.Errors++;
+                                }
                                 break;
                         }
                     }
@@ -127,7 +130,10 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             string version = match.Groups["version"].Value;
                             string author = match.Groups["author"].Value;
                             string description = match.Groups["description"].Value;
-                            mods[name] = new LogModInfo { Name = name, Author = author, Version = version, Description = description, Loaded = true };
+
+                            if (!mods.TryGetValue(name, out List<LogModInfo> entries))
+                                mods[name] = entries = new List<LogModInfo>();
+                            entries.Add(new LogModInfo { Name = name, Author = author, Version = version, Description = description, Loaded = true });
 
                             message.Section = LogSection.ModsList;
                         }
@@ -147,7 +153,10 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             string author = match.Groups["author"].Value;
                             string description = match.Groups["description"].Value;
                             string forMod = match.Groups["for"].Value;
-                            mods[name] = new LogModInfo { Name = name, Author = author, Version = version, Description = description, ContentPackFor = forMod, Loaded = true };
+
+                            if (!mods.TryGetValue(name, out List<LogModInfo> entries))
+                                mods[name] = entries = new List<LogModInfo>();
+                            entries.Add(new LogModInfo { Name = name, Author = author, Version = version, Description = description, ContentPackFor = forMod, Loaded = true });
 
                             message.Section = LogSection.ContentPackList;
                         }
@@ -165,14 +174,14 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             string name = match.Groups["name"].Value;
                             string version = match.Groups["version"].Value;
                             string link = match.Groups["link"].Value;
-                            if (mods.ContainsKey(name))
+
+                            if (mods.TryGetValue(name, out var entries))
                             {
-                                mods[name].UpdateLink = link;
-                                mods[name].UpdateVersion = version;
-                            }
-                            else
-                            {
-                                mods[name] = new LogModInfo { Name = name, UpdateVersion = version, UpdateLink = link, Loaded = false };
+                                foreach (var entry in entries)
+                                {
+                                    entry.UpdateLink = link;
+                                    entry.UpdateVersion = version;
+                                }
                             }
 
                             message.Section = LogSection.ModUpdateList;
@@ -219,7 +228,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
 
                 // finalize log
                 gameMod.Version = log.GameVersion;
-                log.Mods = new[] { gameMod, smapiMod }.Concat(mods.Values.OrderBy(p => p.Name)).ToArray();
+                log.Mods = new[] { gameMod, smapiMod }.Concat(mods.Values.SelectMany(p => p).OrderBy(p => p.Name)).ToArray();
                 return log;
             }
             catch (LogParseException ex)

From aa5d1d4a20c30c9f8fbd30a4d7e8e38e234f17ca Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 9 Dec 2021 19:57:57 -0500
Subject: [PATCH 379/856] update compatibility list

---
 docs/release-notes.md                     | 3 +++
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 7 +++++++
 2 files changed, 10 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 421378e4..41c22085 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Updated compatibility list.
+
 * For the web UI:
   * Fixed log parser not correctly handling multiple mods having the exact same name.
 
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index eb76b29a..75a3f8c7 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -481,6 +481,13 @@
             "~1.2.2  | StatusReasonDetails": "references the deleted Content/Mine asset"
         },
 
+        "Critical Crow": {
+            "ID": "leonary.CRCROWS",
+            "Default | UpdateKey": "Nexus:2663",
+            "~1.2.2  | Status": "AssumeBroken",
+            "~1.2.2  | StatusReasonDetails": "removes newer content from the TileSheets/Craftables asset"
+        },
+
         "Green Pastures Farm": {
             "ID": "bugbuddy.GreenPasturesFarm",
             "Default | UpdateKey": "Nexus:2326",

From e0abac8dfb52fb28d296d6df7483094570f68708 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 18 Dec 2021 00:48:55 -0500
Subject: [PATCH 380/856] update compatibility list

---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 75a3f8c7..53c68636 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -283,6 +283,11 @@
         /*********
         ** Broke in SDV 1.5 (Content Patcher packs)
         *********/
+        "Empty Spouse Room": {
+            "ID": "Lerura.EmptySpouseRoom",
+            "~1.0.0 | Status": "AssumeBroken",
+            "~1.0.0 | StatusReasonDetails": "prevents loading married saves due to a missing tilesheet in the spouse room map"
+        },
         "mi.Mermaids": {
             "ID": "mi.Mermaids",
             "~1.0.0 | Status": "AssumeBroken",

From beb1acd4f823d64d125f5749b2edad06e5731407 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 18 Dec 2021 22:21:31 -0500
Subject: [PATCH 381/856] update Steam error message

---
 docs/release-notes.md                     | 1 +
 src/SMAPI/Framework/Logging/LogManager.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 41c22085..b54aeb15 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Fixed outdated instructions in Steam error message.
   * Updated compatibility list.
 
 * For the web UI:
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 5a291d0a..ef89c751 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -49,7 +49,7 @@ namespace StardewModdingAPI.Framework.Logging
                 search: new Regex(@"^System\.InvalidOperationException: Steamworks is not initialized\.[\s\S]+$", RegexOptions.Compiled | RegexOptions.CultureInvariant),
                 replacement:
 #if SMAPI_FOR_WINDOWS
-                    "Oops! Steam achievements won't work because Steam isn't loaded. See 'Launch SMAPI through Steam or GOG Galaxy' in the install guide for more info: https://smapi.io/install.",
+                    "Oops! Steam achievements won't work because Steam isn't loaded. See 'Configure your game client' in the install guide for more info: https://smapi.io/install.",
 #else
                     "Oops! Steam achievements won't work because Steam isn't loaded. You can launch the game through Steam to fix that.",
 #endif

From 95f658014ebd2aadce1bc72d1d7e763efd7782ba Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 18 Dec 2021 23:07:33 -0500
Subject: [PATCH 382/856] simplify running SMAPI without a terminal on
 Linux/macOS

---
 docs/release-notes.md                       |   1 +
 src/SMAPI.Installer/assets/unix-launcher.sh | 110 +++++++++++---------
 2 files changed, 61 insertions(+), 50 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b54aeb15..e0c6977d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For players:
   * Fixed outdated instructions in Steam error message.
+  * Simplified [running without a terminal on Linux/macOS](https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_recognize_controller_.28Steam_only.29) when needed.
   * Updated compatibility list.
 
 * For the web UI:
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index e8b9ae62..713597e2 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -6,6 +6,10 @@
 # move to script's directory
 cd "$(dirname "$0")" || exit $?
 
+# change to true to skip opening a terminal
+# This isn't recommended since you won't see errors, warnings, and update alerts.
+SKIP_TERMINAL=false
+
 
 ##########
 ## Open terminal if needed
@@ -16,7 +20,6 @@ cd "$(dirname "$0")" || exit $?
 if [ "$(uname)" == "Darwin" ]; then
     if [ ! -t 1 ]; then # https://stackoverflow.com/q/911168/262123
         # sanity check to make sure we don't have an infinite loop of opening windows
-        SKIP_TERMINAL=false
         for argument in "$@"; do
             if [ "$argument" == "--no-reopen-terminal" ]; then
                 SKIP_TERMINAL=true
@@ -63,64 +66,71 @@ else
     LAUNCH_FILE="./StardewModdingAPI"
     export LAUNCH_FILE
 
-    # select terminal (prefer xterm for best compatibility, then known supported terminals)
-    for terminal in xterm gnome-terminal kitty terminator xfce4-terminal konsole terminal termite alacritty mate-terminal x-terminal-emulator; do
-        if command -v "$terminal" 2>/dev/null; then
-            export TERMINAL_NAME=$terminal
-            break;
+    # run in terminal
+    if [ "$SKIP_TERMINAL" == "false" ]; then
+        # select terminal (prefer xterm for best compatibility, then known supported terminals)
+        for terminal in xterm gnome-terminal kitty terminator xfce4-terminal konsole terminal termite alacritty mate-terminal x-terminal-emulator; do
+            if command -v "$terminal" 2>/dev/null; then
+                export TERMINAL_NAME=$terminal
+                break;
+            fi
+        done
+
+        # find the true shell behind x-terminal-emulator
+        if [ "$TERMINAL_NAME" = "x-terminal-emulator" ]; then
+            export TERMINAL_NAME="$(basename "$(readlink -f $(command -v x-terminal-emulator))")"
         fi
-    done
 
-    # find the true shell behind x-terminal-emulator
-    if [ "$TERMINAL_NAME" = "x-terminal-emulator" ]; then
-        export TERMINAL_NAME="$(basename "$(readlink -f $(command -v x-terminal-emulator))")"
-    fi
+        # run in selected terminal and account for quirks
+        export TERMINAL_PATH="$(command -v $TERMINAL_NAME)"
+        if [ -x $TERMINAL_PATH ]; then
+            case $TERMINAL_NAME in
+                terminal|termite)
+                    # consumes only one argument after -e
+                    # options containing space characters are unsupported
+                    exec $TERMINAL_NAME -e "env TERM=xterm $LAUNCH_FILE $@"
+                    ;;
 
-    # run in selected terminal and account for quirks
-    export TERMINAL_PATH="$(command -v $TERMINAL_NAME)"
-    if [ -x $TERMINAL_PATH ]; then
-        case $TERMINAL_NAME in
-            terminal|termite)
-                # consumes only one argument after -e
-                # options containing space characters are unsupported
-                exec $TERMINAL_NAME -e "env TERM=xterm $LAUNCH_FILE $@"
-                ;;
+                xterm|konsole|alacritty)
+                    # consumes all arguments after -e
+                    exec $TERMINAL_NAME -e env TERM=xterm $LAUNCH_FILE "$@"
+                    ;;
 
-            xterm|konsole|alacritty)
-                # consumes all arguments after -e
-                exec $TERMINAL_NAME -e env TERM=xterm $LAUNCH_FILE "$@"
-                ;;
+                terminator|xfce4-terminal|mate-terminal)
+                    # consumes all arguments after -x
+                    exec $TERMINAL_NAME -x env TERM=xterm $LAUNCH_FILE "$@"
+                    ;;
 
-            terminator|xfce4-terminal|mate-terminal)
-                # consumes all arguments after -x
-                exec $TERMINAL_NAME -x env TERM=xterm $LAUNCH_FILE "$@"
-                ;;
+                gnome-terminal)
+                    # consumes all arguments after --
+                    exec $TERMINAL_NAME -- env TERM=xterm $LAUNCH_FILE "$@"
+                    ;;
 
-            gnome-terminal)
-                # consumes all arguments after --
-                exec $TERMINAL_NAME -- env TERM=xterm $LAUNCH_FILE "$@"
-                ;;
+                kitty)
+                    # consumes all trailing arguments
+                    exec $TERMINAL_NAME env TERM=xterm $LAUNCH_FILE "$@"
+                    ;;
 
-            kitty)
-                # consumes all trailing arguments
-                exec $TERMINAL_NAME env TERM=xterm $LAUNCH_FILE "$@"
-                ;;
+                *)
+                    # If we don't know the terminal, just try to run it in the current shell.
+                    # If THAT fails, launch with no output.
+                    env TERM=xterm $LAUNCH_FILE "$@"
+                    if [ $? -eq 127 ]; then
+                        exec $LAUNCH_FILE --no-terminal "$@"
+                    fi
+            esac
 
-            *)
-                # If we don't know the terminal, just try to run it in the current shell.
-                # If THAT fails, launch with no output.
-                env TERM=xterm $LAUNCH_FILE "$@"
-                if [ $? -eq 127 ]; then
-                    exec $LAUNCH_FILE --no-terminal "$@"
-                fi
-        esac
+        ## terminal isn't executable; fallback to current shell or no terminal
+        else
+            echo "The '$TERMINAL_NAME' terminal isn't executable. SMAPI might be running in a sandbox or the system might be misconfigured? Falling back to current shell."
+            env TERM=xterm $LAUNCH_FILE "$@"
+            if [ $? -eq 127 ]; then
+                exec $LAUNCH_FILE --no-terminal "$@"
+            fi
+        fi
 
-    ## terminal isn't executable; fallback to current shell or no terminal
+    # explicitly run without terminal
     else
-        echo "The '$TERMINAL_NAME' terminal isn't executable. SMAPI might be running in a sandbox or the system might be misconfigured? Falling back to current shell."
-        env TERM=xterm $LAUNCH_FILE "$@"
-        if [ $? -eq 127 ]; then
-            exec $LAUNCH_FILE --no-terminal "$@"
-        fi
+        exec $LAUNCH_FILE --no-terminal "$@"
     fi
 fi

From 0d7d4476004d33b395d6df81386e4159d8898027 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 20 Dec 2021 22:18:09 -0500
Subject: [PATCH 383/856] auto-fix maps broken due to missing vanilla tilesheet

---
 docs/release-notes.md                         |  1 +
 src/SMAPI.sln.DotSettings                     |  1 +
 .../Framework/Content/TilesheetReference.cs   | 15 ++++++-
 src/SMAPI/Framework/ContentCoordinator.cs     |  4 +-
 .../ContentManagers/GameContentManager.cs     | 39 +++++++------------
 5 files changed, 33 insertions(+), 27 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e0c6977d..caa5cc68 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * SMAPI now auto-fixes maps loaded without a required tilesheet to prevent errors.
   * Fixed outdated instructions in Steam error message.
   * Simplified [running without a terminal on Linux/macOS](https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_recognize_controller_.28Steam_only.29) when needed.
   * Updated compatibility list.
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index 9a6cad37..71cd7b82 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -70,6 +70,7 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=thumbstick/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=tilesheet/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=tilesheets/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=tilesheet_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=unloadable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=virally/@EntryIndexedValue">True</s:Boolean>
 </wpf:ResourceDictionary>
\ No newline at end of file
diff --git a/src/SMAPI/Framework/Content/TilesheetReference.cs b/src/SMAPI/Framework/Content/TilesheetReference.cs
index 2ea38430..0919bb44 100644
--- a/src/SMAPI/Framework/Content/TilesheetReference.cs
+++ b/src/SMAPI/Framework/Content/TilesheetReference.cs
@@ -1,3 +1,6 @@
+using System.Numerics;
+using xTile.Dimensions;
+
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>Basic metadata about a vanilla tilesheet.</summary>
@@ -15,6 +18,12 @@ namespace StardewModdingAPI.Framework.Content
         /// <summary>The asset path for the tilesheet texture.</summary>
         public readonly string ImageSource;
 
+        /// <summary>The number of tiles in the tilesheet.</summary>
+        public readonly Size SheetSize;
+
+        /// <summary>The size of each tile in pixels.</summary>
+        public readonly Size TileSize;
+
 
         /*********
         ** Public methods
@@ -23,11 +32,15 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="index">The tilesheet's index in the list.</param>
         /// <param name="id">The tilesheet's unique ID in the map.</param>
         /// <param name="imageSource">The asset path for the tilesheet texture.</param>
-        public TilesheetReference(int index, string id, string imageSource)
+        /// <param name="sheetSize">The number of tiles in the tilesheet.</param>
+        /// <param name="tileSize">The size of each tile in pixels.</param>
+        public TilesheetReference(int index, string id, string imageSource, Size sheetSize, Size tileSize)
         {
             this.Index = index;
             this.Id = id;
             this.ImageSource = imageSource;
+            this.SheetSize = sheetSize;
+            this.TileSize = tileSize;
         }
     }
 }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index b6f1669a..99091f3e 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -406,14 +406,14 @@ namespace StardewModdingAPI.Framework
             if (!this.VanillaTilesheets.TryGetValue(assetName, out TilesheetReference[] tilesheets))
             {
                 tilesheets = this.TryLoadVanillaAsset(assetName, out Map map)
-                    ? map.TileSheets.Select((sheet, index) => new TilesheetReference(index, sheet.Id, sheet.ImageSource)).ToArray()
+                    ? map.TileSheets.Select((sheet, index) => new TilesheetReference(index, sheet.Id, sheet.ImageSource, sheet.SheetSize, sheet.TileSize)).ToArray()
                     : null;
 
                 this.VanillaTilesheets[assetName] = tilesheets;
                 this.VanillaContentManager.Unload();
             }
 
-            return tilesheets ?? new TilesheetReference[0];
+            return tilesheets ?? Array.Empty<TilesheetReference>();
         }
 
         /// <summary>Get the language enum which corresponds to a locale code (e.g. <see cref="LocalizedContentManager.LanguageCode.fr"/> given <c>fr-FR</c>).</summary>
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 7a49dd36..ab198076 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -13,6 +13,7 @@ using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
 using StardewValley;
 using xTile;
+using xTile.Tiles;
 
 namespace StardewModdingAPI.Framework.ContentManagers
 {
@@ -308,7 +309,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // return matched asset
-            return this.TryValidateLoadedAsset(info, data, mod)
+            return this.TryFixAndValidateLoadedAsset(info, data, mod)
                 ? new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName)
                 : null;
         }
@@ -381,12 +382,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return asset;
         }
 
-        /// <summary>Validate that an asset loaded by a mod is valid and won't cause issues.</summary>
+        /// <summary>Validate that an asset loaded by a mod is valid and won't cause issues, and fix issues if possible.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
         /// <param name="data">The loaded asset data.</param>
         /// <param name="mod">The mod which loaded the asset.</param>
-        private bool TryValidateLoadedAsset<T>(IAssetInfo info, T data, IModMetadata mod)
+        /// <returns>Returns whether the asset passed validation checks (after any fixes were applied).</returns>
+        private bool TryFixAndValidateLoadedAsset<T>(IAssetInfo info, T data, IModMetadata mod)
         {
             // can't load a null asset
             if (data == null)
@@ -401,20 +403,23 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 TilesheetReference[] vanillaTilesheetRefs = this.Coordinator.GetVanillaTilesheetIds(info.AssetName);
                 foreach (TilesheetReference vanillaSheet in vanillaTilesheetRefs)
                 {
-                    // skip if match
-                    if (loadedMap.TileSheets.Count > vanillaSheet.Index && loadedMap.TileSheets[vanillaSheet.Index].Id == vanillaSheet.Id)
-                        continue;
+                    // add missing tilesheet
+                    if (loadedMap.GetTileSheet(vanillaSheet.Id) == null)
+                    {
+                        mod.Monitor.LogOnce("SMAPI fixed maps loaded by this mod to prevent errors. See the log file for details.", LogLevel.Warn);
+                        this.Monitor.Log($"Fixed broken map replacement: {mod.DisplayName} loaded '{info.AssetName}' without a required tilesheet (id: {vanillaSheet.Id}, source: {vanillaSheet.ImageSource}).");
+
+                        loadedMap.AddTileSheet(new TileSheet(vanillaSheet.Id, loadedMap, vanillaSheet.ImageSource, vanillaSheet.SheetSize, vanillaSheet.TileSize));
+                    }
 
                     // handle mismatch
+                    if (loadedMap.TileSheets.Count <= vanillaSheet.Index || loadedMap.TileSheets[vanillaSheet.Index].Id != vanillaSheet.Id)
                     {
                         // only show warning if not farm map
                         // This is temporary: mods shouldn't do this for any vanilla map, but these are the ones we know will crash. Showing a warning for others instead gives modders time to update their mods, while still simplifying troubleshooting.
                         bool isFarmMap = info.AssetNameEquals("Maps/Farm") || info.AssetNameEquals("Maps/Farm_Combat") || info.AssetNameEquals("Maps/Farm_Fishing") || info.AssetNameEquals("Maps/Farm_Foraging") || info.AssetNameEquals("Maps/Farm_FourCorners") || info.AssetNameEquals("Maps/Farm_Island") || info.AssetNameEquals("Maps/Farm_Mining");
 
-                        int loadedIndex = this.TryFindTilesheet(loadedMap, vanillaSheet.Id);
-                        string reason = loadedIndex != -1
-                            ? $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewvalleywiki.com/Modding:Maps#Tilesheet_order for help."
-                            : $"mod has no tilesheet with ID '{vanillaSheet.Id}'. Map replacements must keep the original tilesheets to avoid errors or crashes.";
+                        string reason = $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewvalleywiki.com/Modding:Maps#Tilesheet_order for help.";
 
                         SCore.DeprecationManager.PlaceholderWarn("3.8.2", DeprecationLevel.PendingRemoval);
                         if (isFarmMap)
@@ -429,19 +434,5 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             return true;
         }
-
-        /// <summary>Find a map tilesheet by ID.</summary>
-        /// <param name="map">The map whose tilesheets to search.</param>
-        /// <param name="id">The tilesheet ID to match.</param>
-        private int TryFindTilesheet(Map map, string id)
-        {
-            for (int i = 0; i < map.TileSheets.Count; i++)
-            {
-                if (map.TileSheets[i].Id == id)
-                    return i;
-            }
-
-            return -1;
-        }
     }
 }

From 52f4df3f301ecde85a76e10ea9ddd607ab7a1b79 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 21 Dec 2021 20:33:08 -0500
Subject: [PATCH 384/856] add new game build number to the SMAPI log

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Constants.cs                    | 11 +++++++++++
 src/SMAPI/Framework/Logging/LogManager.cs |  2 +-
 3 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index caa5cc68..a98cfd8e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For players:
   * SMAPI now auto-fixes maps loaded without a required tilesheet to prevent errors.
+  * Added the new game build number to the SMAPI console + log.
   * Fixed outdated instructions in Steam error message.
   * Simplified [running without a terminal on Linux/macOS](https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_recognize_controller_.28Steam_only.29) when needed.
   * Updated compatibility list.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 5de28f84..c86acd0a 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -340,5 +340,16 @@ namespace StardewModdingAPI
             // if save doesn't exist yet, return the default one we expect to be created
             return folder;
         }
+
+        /// <summary>Get a display label for the game's build number.</summary>
+        internal static string GetBuildVersionLabel()
+        {
+            string version = typeof(Game1).Assembly.GetName().Version?.ToString() ?? "unknown";
+
+            if (version.StartsWith($"{Game1.version}."))
+                version = version.Substring(Game1.version.Length + 1);
+
+            return version;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index ef89c751..90433c37 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -262,7 +262,7 @@ namespace StardewModdingAPI.Framework.Logging
         public void LogIntro(string modsPath, IDictionary<string, object> customSettings)
         {
             // log platform
-            this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
+            this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} (build {Constants.GetBuildVersionLabel()}) on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
 
             // log basic info
             this.Monitor.Log($"Mods go here: {modsPath}", LogLevel.Info);

From 571211687935ce3a12bf4905f056d9be1d6b147f Mon Sep 17 00:00:00 2001
From: bruce2409 <bruce@brucedev.com>
Date: Wed, 22 Dec 2021 17:41:11 +0000
Subject: [PATCH 385/856] Added shell shebang to MacOS Launcher code

---
 src/SMAPI.Installer/assets/unix-launcher.sh | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 713597e2..7cf39f0e 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -31,7 +31,8 @@ if [ "$(uname)" == "Darwin" ]; then
         # https://stackoverflow.com/a/29511052/262123
         if [ "$SKIP_TERMINAL" == "false" ]; then
             echo "Reopening in the Terminal app..."
-            echo "\"$0\" $@ --no-reopen-terminal" > /tmp/open-smapi-terminal.sh
+            echo '#!/bin/sh" > /tmp/open-smapi-terminal.sh
+            echo "\"$0\" $@ --no-reopen-terminal" >> /tmp/open-smapi-terminal.sh
             chmod +x /tmp/open-smapi-terminal.sh
             cat /tmp/open-smapi-terminal.sh
             open -W -a Terminal /tmp/open-smapi-terminal.sh

From 02831503ddae7d3cd977c21cdd056fc218594ad1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 23 Dec 2021 18:59:14 -0500
Subject: [PATCH 386/856] remove content pack from compatibility blacklist

It's no longer broken with the auto-fixes in the upcoming SMAPI update.
---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 53c68636..75a3f8c7 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -283,11 +283,6 @@
         /*********
         ** Broke in SDV 1.5 (Content Patcher packs)
         *********/
-        "Empty Spouse Room": {
-            "ID": "Lerura.EmptySpouseRoom",
-            "~1.0.0 | Status": "AssumeBroken",
-            "~1.0.0 | StatusReasonDetails": "prevents loading married saves due to a missing tilesheet in the spouse room map"
-        },
         "mi.Mermaids": {
             "ID": "mi.Mermaids",
             "~1.0.0 | Status": "AssumeBroken",

From aad77242f02c0a851b5d6ad11c258d9b74d90c5b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 23 Dec 2021 23:08:49 -0500
Subject: [PATCH 387/856] fix uninstaller not removing
 StardewModdingAPI.deps.json file

---
 docs/release-notes.md                       | 1 +
 src/SMAPI.Installer/InteractiveInstaller.cs | 1 +
 2 files changed, 2 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a98cfd8e..0be39c13 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@
   * SMAPI now auto-fixes maps loaded without a required tilesheet to prevent errors.
   * Added the new game build number to the SMAPI console + log.
   * Fixed outdated instructions in Steam error message.
+  * Fixed uninstaller not removing `StardewModdingAPI.deps.json` file.
   * Simplified [running without a terminal on Linux/macOS](https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_recognize_controller_.28Steam_only.29) when needed.
   * Updated compatibility list.
 
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 1257f12b..b3bba883 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -41,6 +41,7 @@ namespace StardewModdingApi.Installer
 
             // current files
             yield return GetInstallPath("StardewModdingAPI");          // Linux/macOS only
+            yield return GetInstallPath("StardewModdingAPI.deps.json");
             yield return GetInstallPath("StardewModdingAPI.dll");
             yield return GetInstallPath("StardewModdingAPI.exe");
             yield return GetInstallPath("StardewModdingAPI.exe.config");

From 92f35837ad771090d96a759feb0d5d6d8c273b0e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 Jan 2022 13:48:53 -0500
Subject: [PATCH 388/856] fix syntax, update release notes

---
 docs/release-notes.md                       | 1 +
 src/SMAPI.Installer/assets/unix-launcher.sh | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0be39c13..3eac227f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,7 @@
   * Added the new game build number to the SMAPI console + log.
   * Fixed outdated instructions in Steam error message.
   * Fixed uninstaller not removing `StardewModdingAPI.deps.json` file.
+  * Fixed launch issue on macOS when using some terminals (thanks to bruce2409!).
   * Simplified [running without a terminal on Linux/macOS](https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_recognize_controller_.28Steam_only.29) when needed.
   * Updated compatibility list.
 
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 7cf39f0e..47937f95 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -31,7 +31,7 @@ if [ "$(uname)" == "Darwin" ]; then
         # https://stackoverflow.com/a/29511052/262123
         if [ "$SKIP_TERMINAL" == "false" ]; then
             echo "Reopening in the Terminal app..."
-            echo '#!/bin/sh" > /tmp/open-smapi-terminal.sh
+            echo '#!/bin/sh' > /tmp/open-smapi-terminal.sh
             echo "\"$0\" $@ --no-reopen-terminal" >> /tmp/open-smapi-terminal.sh
             chmod +x /tmp/open-smapi-terminal.sh
             cat /tmp/open-smapi-terminal.sh

From 1fab386ab1ba6ae92ff934c3869f31a1660cf3b3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 Jan 2022 13:57:14 -0500
Subject: [PATCH 389/856] add Ukrainian translations (#823)

---
 docs/README.md                           | 38 +++++++++++++-----------
 docs/release-notes.md                    |  1 +
 src/SMAPI.Mods.ErrorHandler/i18n/uk.json |  4 +++
 src/SMAPI/i18n/uk.json                   |  6 ++++
 4 files changed, 31 insertions(+), 18 deletions(-)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/i18n/uk.json
 create mode 100644 src/SMAPI/i18n/uk.json

diff --git a/docs/README.md b/docs/README.md
index ecfa6f2b..d3aaae64 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -56,22 +56,24 @@ SMAPI rarely shows text in-game, so it only has a few translations. Contribution
 [Modding:Translations](https://stardewvalleywiki.com/Modding:Translations) on the wiki for help
 contributing translations.
 
-locale     | status
----------- | :----------------
-default    | ✓ [fully translated](../src/SMAPI/i18n/default.json)
-Chinese    | ✓ [fully translated](../src/SMAPI/i18n/zh.json)
-French     | ✓ [fully translated](../src/SMAPI/i18n/fr.json)
-German     | ✓ [fully translated](../src/SMAPI/i18n/de.json)
-Hungarian  | ✓ [fully translated](../src/SMAPI/i18n/hu.json)
-Italian    | ✓ [fully translated](../src/SMAPI/i18n/it.json)
-Japanese   | ✓ [fully translated](../src/SMAPI/i18n/ja.json)
-Korean     | ✓ [fully translated](../src/SMAPI/i18n/ko.json)
-Polish¹    | ✓ [fully translated](../src/SMAPI/i18n/pl.json)
-Portuguese | ✓ [fully translated](../src/SMAPI/i18n/pt.json)
-Russian    | ✓ [fully translated](../src/SMAPI/i18n/ru.json)
-Spanish    | ✓ [fully translated](../src/SMAPI/i18n/es.json)
-Thai¹      | ✓ [fully translated](../src/SMAPI/i18n/th.json)
-Turkish    | ✓ [fully translated](../src/SMAPI/i18n/tr.json)
+locale      | status
+----------- | :----------------
+default     | ✓ [fully translated](../src/SMAPI/i18n/default.json)
+Chinese     | ✓ [fully translated](../src/SMAPI/i18n/zh.json)
+French      | ✓ [fully translated](../src/SMAPI/i18n/fr.json)
+German      | ✓ [fully translated](../src/SMAPI/i18n/de.json)
+Hungarian   | ✓ [fully translated](../src/SMAPI/i18n/hu.json)
+Italian     | ✓ [fully translated](../src/SMAPI/i18n/it.json)
+Japanese    | ✓ [fully translated](../src/SMAPI/i18n/ja.json)
+Korean      | ✓ [fully translated](../src/SMAPI/i18n/ko.json)
+[Polish]    | ✓ [fully translated](../src/SMAPI/i18n/pl.json)
+Portuguese  | ✓ [fully translated](../src/SMAPI/i18n/pt.json)
+Russian     | ✓ [fully translated](../src/SMAPI/i18n/ru.json)
+Spanish     | ✓ [fully translated](../src/SMAPI/i18n/es.json)
+[Thai]      | ✓ [fully translated](../src/SMAPI/i18n/th.json)
+Turkish     | ✓ [fully translated](../src/SMAPI/i18n/tr.json)
+[Ukrainian] | ✓ [fully translated](../src/SMAPI/i18n/uk.json)
 
-¹ This is a custom language provided by a mod (see [Polish](https://www.nexusmods.com/stardewvalley/mods/3616)
-and [Thai](https://www.nexusmods.com/stardewvalley/mods/7052)).
+[Polish]: https://www.nexusmods.com/stardewvalley/mods/3616
+[Thai]: https://www.nexusmods.com/stardewvalley/mods/7052
+[Ukrainian]: https://www.nexusmods.com/stardewvalley/mods/8427
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3eac227f..8ca2e884 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
   * Fixed launch issue on macOS when using some terminals (thanks to bruce2409!).
   * Simplified [running without a terminal on Linux/macOS](https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_recognize_controller_.28Steam_only.29) when needed.
   * Updated compatibility list.
+  * Improved translations. Thanks to ChulkyBow (added Ukrainian)!
 
 * For the web UI:
   * Fixed log parser not correctly handling multiple mods having the exact same name.
diff --git a/src/SMAPI.Mods.ErrorHandler/i18n/uk.json b/src/SMAPI.Mods.ErrorHandler/i18n/uk.json
new file mode 100644
index 00000000..a58102ab
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/i18n/uk.json
@@ -0,0 +1,4 @@
+{
+    // warning messages
+    "warn.invalid-content-removed": "Недійсний вміст видалено, щоб запобігти аварійному завершенню роботи (Додаткову інформацію див. на консолі SMAPI)."
+}
diff --git a/src/SMAPI/i18n/uk.json b/src/SMAPI/i18n/uk.json
new file mode 100644
index 00000000..d84aabcf
--- /dev/null
+++ b/src/SMAPI/i18n/uk.json
@@ -0,0 +1,6 @@
+{
+    // short date format for SDate
+    // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
+    "generic.date": "{{season}} День {{day}}",
+    "generic.date-with-year": "{{season}} День {{day}}, Рік {{year}}"
+}

From e30e42762871af3900c47886b57e8c43287b290a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 2 Jan 2022 19:59:38 -0500
Subject: [PATCH 390/856] add download option to log view

---
 docs/release-notes.md                         |  1 +
 .../Controllers/LogParserController.cs        | 33 +++++++++++++++----
 src/SMAPI.Web/ViewModels/LogViewFormat.cs     | 15 +++++++++
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 17 ++++++++--
 4 files changed, 56 insertions(+), 10 deletions(-)
 create mode 100644 src/SMAPI.Web/ViewModels/LogViewFormat.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8ca2e884..1df0af0e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
   * Improved translations. Thanks to ChulkyBow (added Ukrainian)!
 
 * For the web UI:
+  * Added log download option.
   * Fixed log parser not correctly handling multiple mods having the exact same name.
 
 ## 3.13.2
diff --git a/src/SMAPI.Web/Controllers/LogParserController.cs b/src/SMAPI.Web/Controllers/LogParserController.cs
index 39de4b5d..db53d942 100644
--- a/src/SMAPI.Web/Controllers/LogParserController.cs
+++ b/src/SMAPI.Web/Controllers/LogParserController.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Linq;
+using System.Text;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.Mvc;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -39,24 +40,42 @@ namespace StardewModdingAPI.Web.Controllers
         ***/
         /// <summary>Render the log parser UI.</summary>
         /// <param name="id">The stored file ID.</param>
-        /// <param name="raw">Whether to display the raw unparsed log.</param>
+        /// <param name="format">How to render the log view.</param>
         /// <param name="renew">Whether to reset the log expiry.</param>
         [HttpGet]
         [Route("log")]
         [Route("log/{id}")]
-        public async Task<ViewResult> Index(string id = null, bool raw = false, bool renew = false)
+        public async Task<ActionResult> Index(string id = null, LogViewFormat format = LogViewFormat.Default, bool renew = false)
         {
             // fresh page
             if (string.IsNullOrWhiteSpace(id))
                 return this.View("Index", this.GetModel(id));
 
-            // log page
+            // fetch log
             StoredFileInfo file = await this.Storage.GetAsync(id, renew);
-            ParsedLog log = file.Success
-                ? new LogParser().Parse(file.Content)
-                : new ParsedLog { IsValid = false, Error = file.Error };
 
-            return this.View("Index", this.GetModel(id, uploadWarning: file.Warning, expiry: file.Expiry).SetResult(log, raw));
+            // render view
+            switch (format)
+            {
+                case LogViewFormat.Default:
+                case LogViewFormat.RawView:
+                    {
+                        ParsedLog log = file.Success
+                            ? new LogParser().Parse(file.Content)
+                            : new ParsedLog { IsValid = false, Error = file.Error };
+
+                        return this.View("Index", this.GetModel(id, uploadWarning: file.Warning, expiry: file.Expiry).SetResult(log, showRaw: format == LogViewFormat.RawView));
+                    }
+
+                case LogViewFormat.RawDownload:
+                    {
+                        string content = file.Error ?? file.Content;
+                        return this.File(Encoding.UTF8.GetBytes(content), "plain/text", $"SMAPI log ({id}).txt");
+                    }
+
+                default:
+                    throw new InvalidOperationException($"Unknown log view format '{format}'.");
+            }
         }
 
         /***
diff --git a/src/SMAPI.Web/ViewModels/LogViewFormat.cs b/src/SMAPI.Web/ViewModels/LogViewFormat.cs
new file mode 100644
index 00000000..7ef79319
--- /dev/null
+++ b/src/SMAPI.Web/ViewModels/LogViewFormat.cs
@@ -0,0 +1,15 @@
+namespace StardewModdingAPI.Web.ViewModels
+{
+    /// <summary>How a log file should be displayed.</summary>
+    public enum LogViewFormat
+    {
+        /// <summary>Render a parsed log and metadata.</summary>
+        Default,
+
+        /// <summary>Render a raw log with parsed metadata.</summary>
+        RawView,
+
+        /// <summary>Render directly as a text file.</summary>
+        RawDownload
+    }
+}
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 06d46c9e..eeff776c 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -2,6 +2,7 @@
 @using StardewModdingAPI.Toolkit.Utilities
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.Framework.LogParsing.Models
+@using StardewModdingAPI.Web.ViewModels
 @model StardewModdingAPI.Web.ViewModels.LogParserModel
 
 @{
@@ -338,14 +339,24 @@ else if (Model.ParsedLog?.IsValid == true)
                     }
                 }
             </table>
-
-            <small><a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, raw = true })">view raw log</a></small>
         }
         else
         {
             <pre v-pre>@Model.ParsedLog.RawText</pre>
-            <small><a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID })">view parsed log</a></small>
         }
+
+        <small>
+            @if (Model.ShowRaw)
+            {
+                <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID })">view parsed log</a>
+            }
+            else
+            {
+                <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, format = LogViewFormat.RawView })">view raw log</a>
+            }
+            
+            | <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, format = LogViewFormat.RawDownload })" download>download</a>
+        </small>
     </div>
 }
 else if (Model.ParsedLog?.IsValid == false)

From a8985e122e9ebd3cb1545971474b95d34058f896 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 15 Jan 2022 12:21:22 -0500
Subject: [PATCH 391/856] fix suppressed console output not suppressing
 newlines

---
 docs/release-notes.md                         |  1 +
 .../Logging/InterceptingTextWriter.cs         | 12 ++++++++++-
 src/SMAPI/Framework/Logging/LogManager.cs     | 20 +++++++++++++++----
 3 files changed, 28 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1df0af0e..735c7c12 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,7 @@
 * For players:
   * SMAPI now auto-fixes maps loaded without a required tilesheet to prevent errors.
   * Added the new game build number to the SMAPI console + log.
+  * Fixed extra newlines shown in the console in non-developer mode.
   * Fixed outdated instructions in Steam error message.
   * Fixed uninstaller not removing `StardewModdingAPI.deps.json` file.
   * Fixed launch issue on macOS when using some terminals (thanks to bruce2409!).
diff --git a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
index d99f1dd2..41a3abcb 100644
--- a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
+++ b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
@@ -26,6 +26,10 @@ namespace StardewModdingAPI.Framework.Logging
         /// <summary>The event raised when a message is written to the console directly.</summary>
         public event Action<string> OnMessageIntercepted;
 
+        /// <summary>Whether the text writer should ignore the next input if it's a newline.</summary>
+        /// <remarks>This is used when log output is suppressed from the console, since <c>Console.WriteLine</c> writes the trailing newline as a separate call.</remarks>
+        public bool IgnoreNextIfNewline { get; set; }
+
 
         /*********
         ** Public methods
@@ -42,12 +46,18 @@ namespace StardewModdingAPI.Framework.Logging
         /// <inheritdoc />
         public override void Write(char[] buffer, int index, int count)
         {
+            bool ignoreIfNewline = this.IgnoreNextIfNewline;
+            this.IgnoreNextIfNewline = false;
+
             if (buffer.Length == 0)
                 this.Out.Write(buffer, index, count);
             else if (buffer[0] == this.IgnoreChar)
                 this.Out.Write(buffer, index + 1, count - 1);
             else if (this.IsEmptyOrNewline(buffer))
-                this.Out.Write(buffer, index, count);
+            {
+                if (!ignoreIfNewline)
+                    this.Out.Write(buffer, index, count);
+            }
             else
                 this.OnMessageIntercepted?.Invoke(new string(buffer, index, count).TrimEnd('\r', '\n'));
         }
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index 90433c37..acd2c617 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -22,9 +22,15 @@ namespace StardewModdingAPI.Framework.Logging
         /*********
         ** Fields
         *********/
+        /// <summary>Whether to show trace messages in the console.</summary>
+        private readonly bool ShowTraceInConsole;
+
         /// <summary>The log file to which to write messages.</summary>
         private readonly LogFileManager LogFile;
 
+        /// <summary>The text writer which intercepts console output.</summary>
+        private readonly InterceptingTextWriter ConsoleInterceptor;
+
         /// <summary>Prefixing a low-level message with this character indicates that the console interceptor should write the string without intercepting it. (The character itself is not written.)</summary>
         private readonly char IgnoreChar = '\u200B';
 
@@ -91,10 +97,11 @@ namespace StardewModdingAPI.Framework.Logging
         public LogManager(string logPath, ColorSchemeConfig colorConfig, bool writeToConsole, bool isVerbose, bool isDeveloperMode, Func<int?> getScreenIdForLog)
         {
             // init construction logic
+            this.ShowTraceInConsole = isDeveloperMode;
             this.GetMonitorImpl = name => new Monitor(name, this.IgnoreChar, this.LogFile, colorConfig, isVerbose, getScreenIdForLog)
             {
                 WriteToConsole = writeToConsole,
-                ShowTraceInConsole = isDeveloperMode,
+                ShowTraceInConsole = this.ShowTraceInConsole,
                 ShowFullStampInConsole = isDeveloperMode
             };
 
@@ -104,10 +111,10 @@ namespace StardewModdingAPI.Framework.Logging
             this.MonitorForGame = this.GetMonitor("game");
 
             // redirect direct console output
-            var output = new InterceptingTextWriter(Console.Out, this.IgnoreChar);
+            this.ConsoleInterceptor = new InterceptingTextWriter(Console.Out, this.IgnoreChar);
             if (writeToConsole)
-                output.OnMessageIntercepted += message => this.HandleConsoleMessage(this.MonitorForGame, message);
-            Console.SetOut(output);
+                this.ConsoleInterceptor.OnMessageIntercepted += message => this.HandleConsoleMessage(this.MonitorForGame, message);
+            Console.SetOut(this.ConsoleInterceptor);
 
             // enable Unicode handling on Windows
             // (the terminal defaults to UTF-8 on Linux/macOS)
@@ -363,7 +370,10 @@ namespace StardewModdingAPI.Framework.Logging
 
             // ignore suppressed message
             if (level != LogLevel.Error && this.SuppressConsolePatterns.Any(p => p.IsMatch(message)))
+            {
+                this.ConsoleInterceptor.IgnoreNextIfNewline = true;
                 return;
+            }
 
             // show friendly error if applicable
             foreach (ReplaceLogPattern entry in this.ReplaceConsolePatterns)
@@ -383,6 +393,8 @@ namespace StardewModdingAPI.Framework.Logging
 
             // forward to monitor
             gameMonitor.Log(message, level);
+            if (level == LogLevel.Trace && !this.ShowTraceInConsole)
+                this.ConsoleInterceptor.IgnoreNextIfNewline = true;
         }
 
         /// <summary>Write a summary of mod warnings to the console and log.</summary>

From 8ebb9ce8d4c554b077e1e6286531c101d64c019d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 15 Jan 2022 13:27:23 -0500
Subject: [PATCH 392/856] fix backspaces ignored on Linux/macOS in SDV 1.5.5+

---
 docs/release-notes.md                                 | 5 +++--
 src/SMAPI/Framework/Logging/InterceptingTextWriter.cs | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 735c7c12..06d75b15 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,12 +3,13 @@
 # Release notes
 ## Upcoming release
 * For players:
-  * SMAPI now auto-fixes maps loaded without a required tilesheet to prevent errors.
+  * Added auto-fix for custom maps which don't have a required tilesheet.
   * Added the new game build number to the SMAPI console + log.
   * Fixed extra newlines shown in the console in non-developer mode.
+  * Fixed macOS launch issue when using some terminals (thanks to bruce2409!).
+  * Fixed Linux/macOS terminal ignoring backspace in Stardew Valley 1.5.5+.
   * Fixed outdated instructions in Steam error message.
   * Fixed uninstaller not removing `StardewModdingAPI.deps.json` file.
-  * Fixed launch issue on macOS when using some terminals (thanks to bruce2409!).
   * Simplified [running without a terminal on Linux/macOS](https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_recognize_controller_.28Steam_only.29) when needed.
   * Updated compatibility list.
   * Improved translations. Thanks to ChulkyBow (added Ukrainian)!
diff --git a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
index 41a3abcb..36f81d22 100644
--- a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
+++ b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
@@ -51,7 +51,7 @@ namespace StardewModdingAPI.Framework.Logging
 
             if (buffer.Length == 0)
                 this.Out.Write(buffer, index, count);
-            else if (buffer[0] == this.IgnoreChar)
+            else if (buffer[0] == this.IgnoreChar || char.IsControl(buffer[0])) // ignore control characters like backspace
                 this.Out.Write(buffer, index + 1, count - 1);
             else if (this.IsEmptyOrNewline(buffer))
             {

From 4cffd6c2c092b18940f2dd1041e418f60573a87e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 15 Jan 2022 17:21:11 -0500
Subject: [PATCH 393/856] add save recovery for missing custom farm type

---
 docs/release-notes.md                         |  3 +-
 .../Patches/SaveGamePatcher.cs                | 30 +++++++++++++++++--
 2 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 06d75b15..aea4dbab 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,7 +3,8 @@
 # Release notes
 ## Upcoming release
 * For players:
-  * Added auto-fix for custom maps which don't have a required tilesheet.
+  * Added automatic fix for custom maps which don't have a required tilesheet.
+  * Added automatic save recovery when the custom farm type isn't available anymore.
   * Added the new game build number to the SMAPI console + log.
   * Fixed extra newlines shown in the console in non-developer mode.
   * Fixed macOS launch issue when using some terminals (thanks to bruce2409!).
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index 2a43cb10..0a7ed212 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -4,11 +4,11 @@ using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using HarmonyLib;
 using Microsoft.Xna.Framework.Content;
+using StardewModdingAPI.Internal;
 using StardewModdingAPI.Internal.Patching;
 using StardewValley;
 using StardewValley.Buildings;
 using StardewValley.Locations;
-using SObject = StardewValley.Object;
 
 namespace StardewModdingAPI.Mods.ErrorHandler.Patches
 {
@@ -47,6 +47,11 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 original: this.RequireMethod<SaveGame>(nameof(SaveGame.loadDataToLocations)),
                 prefix: this.GetHarmonyMethod(nameof(SaveGamePatcher.Before_LoadDataToLocations))
             );
+
+            harmony.Patch(
+                original: this.RequireMethod<SaveGame>(nameof(SaveGame.LoadFarmType)),
+                finalizer: this.GetHarmonyMethod(nameof(SaveGamePatcher.Finalize_LoadFarmType))
+            );
         }
 
 
@@ -58,14 +63,35 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <returns>Returns whether to execute the original method.</returns>
         private static bool Before_LoadDataToLocations(List<GameLocation> gamelocations)
         {
+            // missing locations/NPCs
             IDictionary<string, string> npcs = Game1.content.Load<Dictionary<string, string>>("Data\\NPCDispositions");
-
             if (SaveGamePatcher.RemoveBrokenContent(gamelocations, npcs))
                 SaveGamePatcher.OnContentRemoved();
 
             return true;
         }
 
+        /// <summary>The method to call after <see cref="SaveGame.LoadFarmType"/> throws an exception.</summary>
+        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
+        /// <returns>Returns the exception to throw, if any.</returns>
+        private static Exception Finalize_LoadFarmType(Exception __exception)
+        {
+            // missing custom farm type
+            if (__exception?.Message?.Contains("not a valid farm type") == true && !int.TryParse(SaveGame.loaded.whichFarm, out _))
+            {
+                SaveGamePatcher.Monitor.Log(__exception.GetLogSummary(), LogLevel.Error);
+                SaveGamePatcher.Monitor.Log($"Removed invalid custom farm type '{SaveGame.loaded.whichFarm}' to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom farm type mod?)", LogLevel.Warn);
+
+                SaveGame.loaded.whichFarm = Farm.default_layout.ToString();
+                SaveGame.LoadFarmType();
+                SaveGamePatcher.OnContentRemoved();
+
+                __exception = null;
+            }
+
+            return __exception;
+        }
+
         /// <summary>Remove content which no longer exists in the game data.</summary>
         /// <param name="locations">The current game locations.</param>
         /// <param name="npcs">The NPC data.</param>

From d029dd652fcb7390d756d92803da2dbc91f8b0de Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 15 Jan 2022 18:04:33 -0500
Subject: [PATCH 394/856] fix JSON validator not recognizing manifest update
 subkeys

---
 docs/release-notes.md                       | 1 +
 src/SMAPI.Web/wwwroot/schemas/manifest.json | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index aea4dbab..3be90208 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,6 +18,7 @@
 * For the web UI:
   * Added log download option.
   * Fixed log parser not correctly handling multiple mods having the exact same name.
+  * Fixed JSON validator not recognizing manifest [update subkeys](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Update_checks#Update_subkeys).
 
 ## 3.13.2
 Released 05 December 2021 for Stardew Valley 1.5.5 or later.
diff --git a/src/SMAPI.Web/wwwroot/schemas/manifest.json b/src/SMAPI.Web/wwwroot/schemas/manifest.json
index 05698ba2..b6722347 100644
--- a/src/SMAPI.Web/wwwroot/schemas/manifest.json
+++ b/src/SMAPI.Web/wwwroot/schemas/manifest.json
@@ -103,7 +103,7 @@
             "type": "array",
             "items": {
                 "type": "string",
-                "pattern": "^(?i)(Chucklefish:\\d+|Nexus:\\d+|GitHub:[A-Za-z0-9_\\-]+/[A-Za-z0-9_\\-]+|ModDrop:\\d+)$",
+                "pattern": "^(?i)(Chucklefish:\\d+|Nexus:\\d+|GitHub:[A-Za-z0-9_\\-]+/[A-Za-z0-9_\\-]+|ModDrop:\\d+)(?: *@ *[a-zA-Z0-9_]+ *)$",
                 "@errorMessages": {
                     "pattern": "Invalid update key; see https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Manifest#Update_checks for more info."
                 }

From 6f05580191e27bdf876d75a967a3238947d5a091 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 15 Jan 2022 20:39:32 -0500
Subject: [PATCH 395/856] add detection for Xbox app game folders

---
 build/find-game-folder.targets                | 22 ++++++++++++++++---
 docs/release-notes.md                         |  1 +
 docs/technical/mod-package.md                 |  3 +++
 .../Framework/GameScanning/GameScanner.cs     | 11 +++++++++-
 4 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index 3164b071..ba7cb26c 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -28,15 +28,31 @@
         <_SteamLibraryPath>$([MSBuild]::GetRegistryValueFromView('HKEY_CURRENT_USER\SOFTWARE\Valve\Steam', 'SteamPath', null, RegistryView.Registry32))</_SteamLibraryPath>
         <GamePath Condition="!Exists('$(GamePath)') AND '$(_SteamLibraryPath)' != ''">$(_SteamLibraryPath)\steamapps\common\Stardew Valley</GamePath>
 
-        <!-- default paths -->
+        <!-- GOG paths -->
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\GalaxyClient\Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\GOG Galaxy\Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\GOG Games\Stardew Valley</GamePath>
-        <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\Steam\steamapps\common\Stardew Valley</GamePath>
-
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\GalaxyClient\Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\GOG Games\Stardew Valley</GamePath>
+
+        <!-- Xbox app paths -->
+        <!--
+        The Xbox app saves the install path to the registry, but we can't use it here since it
+        saves the internal readonly path (like C:\Program Files\WindowsApps\Mutable\<package ID>)
+        instead of the mods-enabled path (like C:\Program Files\ModifiableWindowsApps\Stardew Valley).
+        Fortunately we can cheat a bit: players can customize the install drive, but they can't
+        change the install path on the drive.
+        -->
+        <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\ModifiableWindowsApps\Stardew Valley</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">D:\Program Files\ModifiableWindowsApps\Stardew Valley</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">E:\Program Files\ModifiableWindowsApps\Stardew Valley</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">F:\Program Files\ModifiableWindowsApps\Stardew Valley</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">G:\Program Files\ModifiableWindowsApps\Stardew Valley</GamePath>
+        <GamePath Condition="!Exists('$(GamePath)')">H:\Program Files\ModifiableWindowsApps\Stardew Valley</GamePath>
+
+        <!-- Steam paths -->
+        <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files\Steam\steamapps\common\Stardew Valley</GamePath>
         <GamePath Condition="!Exists('$(GamePath)')">C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley</GamePath>
       </PropertyGroup>
     </When>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3be90208..f37b35f5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@
   * Added automatic fix for custom maps which don't have a required tilesheet.
   * Added automatic save recovery when the custom farm type isn't available anymore.
   * Added the new game build number to the SMAPI console + log.
+  * The installer now detects Xbox app game folders.
   * Fixed extra newlines shown in the console in non-developer mode.
   * Fixed macOS launch issue when using some terminals (thanks to bruce2409!).
   * Fixed Linux/macOS terminal ignoring backspace in Stardew Valley 1.5.5+.
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 41f808a5..5e408168 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -412,6 +412,9 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
+## Upcoming release
+* Added detection for Xbox app game folders.
+
 ## 4.0.0
 Released 30 November 2021.
 
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 37e4f263..8d4198de 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -157,7 +157,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                             yield return Path.Combine(steamPath.Replace('/', '\\'), @"steamapps\common\Stardew Valley");
 #endif
 
-                        // default paths
+                        // default GOG/Steam paths
                         foreach (string programFiles in new[] { @"C:\Program Files", @"C:\Program Files (x86)" })
                         {
                             yield return $@"{programFiles}\GalaxyClient\Games\Stardew Valley";
@@ -165,6 +165,15 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                             yield return $@"{programFiles}\GOG Games\Stardew Valley";
                             yield return $@"{programFiles}\Steam\steamapps\common\Stardew Valley";
                         }
+
+                        // default Xbox app paths
+                        // The Xbox app saves the install path to the registry, but we can't use it
+                        // here since it saves the internal readonly path (like C:\Program Files\WindowsApps\Mutable\<package ID>)
+                        // instead of the mods-enabled path(like C:\Program Files\ModifiableWindowsApps\Stardew Valley).
+                        // Fortunately we can cheat a bit: players can customize the install drive, but they can't
+                        // change the install path on the drive.
+                        for (char driveLetter = 'C'; driveLetter <= 'H'; driveLetter++)
+                            yield return $@"{driveLetter}:\Program Files\ModifiableWindowsApps\Stardew Valley";
                     }
                     break;
 

From 7e8d11ca3aff9a7e741127cd5fd35d073c381ec9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 15 Jan 2022 23:41:01 -0500
Subject: [PATCH 396/856] add Xbox app log instructions, redesign UI to fit

---
 docs/release-notes.md                         |   2 +
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 118 ++++++++++--------
 .../wwwroot/Content/css/log-parser.css        |  26 +++-
 .../wwwroot/Content/js/log-parser.js          |  11 --
 4 files changed, 91 insertions(+), 66 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f37b35f5..50eb416b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -17,7 +17,9 @@
   * Improved translations. Thanks to ChulkyBow (added Ukrainian)!
 
 * For the web UI:
+  * Added log instructions for Xbox app on Windows.
   * Added log download option.
+  * Redesigned log instruction UI.
   * Fixed log parser not correctly handling multiple mods having the exact same name.
   * Fixed JSON validator not recognizing manifest [update subkeys](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Update_checks#Update_subkeys).
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index eeff776c..91fc3535 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -23,13 +23,15 @@
     {
         <meta name="robots" content="noindex" />
     }
-    <link rel="stylesheet" href="~/Content/css/file-upload.css?r=202002" />
-    <link rel="stylesheet" href="~/Content/css/log-parser.css?r=202002" />
+    <link rel="stylesheet" href="~/Content/css/file-upload.css" />
+    <link rel="stylesheet" href="~/Content/css/log-parser.css" />
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3/dist/css/tabby-ui-vertical.min.css" />
 
+    <script src="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/vue@2.6.11" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
-    <script src="~/Content/js/file-upload.js?r=202002"></script>
-    <script src="~/Content/js/log-parser.js?r=202002"></script>
+    <script src="~/Content/js/file-upload.js"></script>
+    <script src="~/Content/js/log-parser.js"></script>
     <script>
         $(function() {
             smapi.logParser({
@@ -41,6 +43,8 @@
                 enableFilters: @this.ForJson(!Model.ShowRaw),
                 screenIds: @this.ForJson(screenIds)
             }, '@this.Url.PlainAction("Index", "LogParser", values: null)');
+
+            new Tabby('[data-tabs]');
         });
     </script>
 }
@@ -91,51 +95,65 @@ else if (Model.ParsedLog?.IsValid == true)
 @if (Model.ParsedLog == null)
 {
     <h2>Where do I find my SMAPI log?</h2>
-    <div>What system do you use?</div>
-    <ul id="os-list">
-        @foreach (Platform platform in new[] { Platform.Android, Platform.Linux, Platform.Mac, Platform.Windows })
-        {
-            <li>
-                <input type="radio" name="os" value="@platform" id="os-@platform" checked="@(Model.DetectedPlatform == platform)" />
-                <label for="os-@platform">@platform</label>
-            </li>
-        }
-    </ul>
-    <div data-os="@Platform.Android">
-        On Android:
-        <ol>
-            <li>Open a file app (like My Files or MT Manager).</li>
-            <li>Find the <code>StardewValley</code> folder on your internal storage.</li>
-            <li>Open the <code>ErrorLogs</code> subfolder.</li>
-            <li>The log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
-        </ol>
-    </div>
-    <div data-os="@Platform.Linux">
-        On Linux:
-        <ol>
-            <li>Open the Files app.</li>
-            <li>Click the options menu (might be labeled <em>Go</em> or <code>⋮</code>).</li>
-            <li>Choose <em>Enter Location</em>.</li>
-            <li>Enter this exact text: <pre>~/.config/StardewValley/ErrorLogs</pre></li>
-            <li>The log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
-        </ol>
-    </div>
-    <div data-os="@Platform.Mac">
-        On macOS:
-        <ol>
-            <li>Open the Finder app.</li>
-            <li>Click <em>Go</em> at the top, then <em>Go to Folder</em>.</li>
-            <li>Enter this exact text: <pre>~/.config/StardewValley/ErrorLogs</pre></li>
-            <li>The log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
-        </ol>
-    </div>
-    <div data-os="@Platform.Windows">
-        On Windows:
-        <ol>
-            <li>Press the <code>Windows</code> and <code>R</code> buttons at the same time.</li>
-            <li>In the 'run' box that appears, enter this exact text: <pre>%appdata%\StardewValley\ErrorLogs</pre></li>
-            <li>The log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
-        </ol>
+    <div id="os-instructions">
+        <div>
+            <ul data-tabs>
+                @foreach (Platform platform in new[] {Platform.Android, Platform.Linux, Platform.Mac, Platform.Windows})
+                {
+                    @if (platform == Platform.Windows)
+                    {
+                        <li><a data-tabby-default href="#@(platform)-steamgog">@platform (Steam or GOG)</a></li>
+                        <li><a href="#@(platform)-xbox">@platform (Xbox app)</a></li>
+                    }
+                    else
+                    {
+                        <li><a href="#@platform">@platform</a></li>
+                    }
+                }
+            </ul>
+        </div>
+        <div>
+            <div id="@Platform.Android">
+                <ol>
+                    <li>Open a file app (like My Files or MT Manager).</li>
+                    <li>Find the <code>StardewValley</code> folder on your internal storage.</li>
+                    <li>Open the <code>ErrorLogs</code> subfolder.</li>
+                    <li>The log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
+                </ol>
+            </div>
+            <div id="@Platform.Linux">
+                <ol>
+                    <li>Open the Files app.</li>
+                    <li>Click the options menu (might be labeled <em>Go</em> or <code>⋮</code>).</li>
+                    <li>Choose <em>Enter Location</em>.</li>
+                    <li>Enter this exact text: <pre>~/.config/StardewValley/ErrorLogs</pre></li>
+                    <li>The log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
+                </ol>
+            </div>
+            <div id="@Platform.Mac">
+                <ol>
+                    <li>Open the Finder app.</li>
+                    <li>Click <em>Go</em> at the top, then <em>Go to Folder</em>.</li>
+                    <li>Enter this exact text: <pre>~/.config/StardewValley/ErrorLogs</pre></li>
+                    <li>The log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
+                </ol>
+            </div>
+            <div id="@(Platform.Windows)-steamgog">
+                <ol>
+                    <li>Press the <kbd>Windows</kbd> and <kbd>R</kbd> buttons at the same time.</li>
+                    <li>In the 'run' box that appears, enter this exact text: <pre>%appdata%\StardewValley\ErrorLogs</pre></li>
+                    <li>The log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
+                </ol>
+            </div>
+            <div id="@(Platform.Windows)-xbox">
+                <ol>
+                    <li>Press the <kbd>Windows</kbd> and <kbd>R</kbd> buttons at the same time.</li>
+                    <li>In the 'run' box that appears, enter this exact text: <pre>%localappdata%\Packages\ConcernedApe.StardewValleyPC_0c8vynj4cqe4e\LocalCache\Roaming\StardewValley\ErrorLogs</pre></li>
+                    <li>If you get an error with the title "Location is not available", try the "with Steam or GOG" instructions above.</li>
+                    <li>Otherwise the log file is <code>SMAPI-crash.txt</code> if it exists, otherwise <code>SMAPI-latest.txt</code>.</li>
+                </ol>
+            </div>
+        </div>
     </div>
 
     <h2>How do I share my log?</h2>
@@ -354,7 +372,7 @@ else if (Model.ParsedLog?.IsValid == true)
             {
                 <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, format = LogViewFormat.RawView })">view raw log</a>
             }
-            
+
             | <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, format = LogViewFormat.RawDownload })" download>download</a>
         </small>
     </div>
diff --git a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
index bfbc8982..8c3acceb 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
@@ -291,13 +291,29 @@ table caption {
 
 
 /*********
-** Upload form
+** OS instructions
 *********/
-#os-list {
-    list-style: none;
+#os-instructions {
+    display: grid;
+    grid-template-columns: minmax(16em, auto) 30em;
 }
 
-div[data-os] {
-    display: none;
+#os-instructions [role="tablist"] {
+    border: 0;
 }
 
+#os-instructions [role="tab"] {
+    display: block;
+    border: 0;
+    position: relative;
+}
+
+#os-instructions [role="tab"][aria-selected="true"] {
+    font-weight: bold;
+    border-radius: 0 10px 10px 0;
+}
+
+[role="tab"][aria-selected="true"]::after {
+    content: "▶";
+    padding-left: 0.5em;
+}
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 6ae1707e..90715375 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -115,17 +115,6 @@ smapi.logParser = function (data, sectionUrl) {
     *********/
     var input = $("#input");
     if (input.length) {
-        // instructions per OS
-        var systemOptions = $("input[name='os']");
-        var systemInstructions = $("div[data-os]");
-
-        var chooseSystem = function () {
-            systemInstructions.hide();
-            systemInstructions.filter("[data-os='" + $("input[name='os']:checked").val() + "']").show();
-        };
-        systemOptions.on("click", chooseSystem);
-        chooseSystem();
-
         // file upload
         smapi.fileUpload({
             chooseFileLink: $("#choose-file-link"),

From 00bd9d19a183635813376bd194333ea2b97ecfb3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Jan 2022 00:15:03 -0500
Subject: [PATCH 397/856] bump min game version to 1.5.6

That avoids error reports on mods when pirated players have an older 1.5.5 build that break mods, and ensures that the new build number shown in the SMAPI log is available.
---
 docs/release-notes.md  | 1 +
 src/SMAPI/Constants.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 50eb416b..1a6f4078 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * **Increased minimum game version to Stardew Valley 1.5.6.**
   * Added automatic fix for custom maps which don't have a required tilesheet.
   * Added automatic save recovery when the custom farm type isn't available anymore.
   * Added the new game build number to the SMAPI console + log.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index c86acd0a..9e0ba79f 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -65,7 +65,7 @@ namespace StardewModdingAPI
         public static ISemanticVersion ApiVersion { get; } = new Toolkit.SemanticVersion(EarlyConstants.RawApiVersion);
 
         /// <summary>The minimum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.5");
+        public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.6");
 
         /// <summary>The maximum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MaximumGameVersion { get; } = null;

From 1ea8d752356b313d200810235463a322a47f9425 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Jan 2022 14:05:02 -0500
Subject: [PATCH 398/856] improve console interception logic

---
 .../Logging/InterceptingTextWriter.cs         | 30 ++++++++++--------
 src/SMAPI/Framework/Logging/LogManager.cs     | 31 ++++++++-----------
 src/SMAPI/Framework/Monitor.cs                |  2 +-
 3 files changed, 31 insertions(+), 32 deletions(-)

diff --git a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
index 36f81d22..bad69a2a 100644
--- a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
+++ b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
@@ -7,16 +7,12 @@ namespace StardewModdingAPI.Framework.Logging
     /// <summary>A text writer which allows intercepting output.</summary>
     internal class InterceptingTextWriter : TextWriter
     {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>Prefixing a message with this character indicates that the console interceptor should write the string without intercepting it. (The character itself is not written.)</summary>
-        private readonly char IgnoreChar;
-
-
         /*********
         ** Accessors
         *********/
+        /// <summary>Prefixing a message with this character indicates that the console interceptor should write the string without intercepting it. (The character itself is not written.)</summary>
+        public const char IgnoreChar = '\u200B';
+
         /// <summary>The underlying console output.</summary>
         public TextWriter Out { get; }
 
@@ -36,30 +32,38 @@ namespace StardewModdingAPI.Framework.Logging
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="output">The underlying output writer.</param>
-        /// <param name="ignoreChar">Prefixing a message with this character indicates that the console interceptor should write the string without intercepting it. (The character itself is not written.)</param>
-        public InterceptingTextWriter(TextWriter output, char ignoreChar)
+        public InterceptingTextWriter(TextWriter output)
         {
             this.Out = output;
-            this.IgnoreChar = ignoreChar;
         }
 
         /// <inheritdoc />
         public override void Write(char[] buffer, int index, int count)
         {
+            // track newline skip
             bool ignoreIfNewline = this.IgnoreNextIfNewline;
             this.IgnoreNextIfNewline = false;
 
-            if (buffer.Length == 0)
+            // get first character if valid
+            if (count == 0 || index < 0 || index >= buffer.Length)
+            {
                 this.Out.Write(buffer, index, count);
-            else if (buffer[0] == this.IgnoreChar || char.IsControl(buffer[0])) // ignore control characters like backspace
+                return;
+            }
+            char firstChar = buffer[index];
+
+            // handle output
+            if (firstChar == InterceptingTextWriter.IgnoreChar)
                 this.Out.Write(buffer, index + 1, count - 1);
+            else if (char.IsControl(firstChar) && firstChar is not ('\r' or '\n'))
+                this.Out.Write(buffer, index, count);
             else if (this.IsEmptyOrNewline(buffer))
             {
                 if (!ignoreIfNewline)
                     this.Out.Write(buffer, index, count);
             }
             else
-                this.OnMessageIntercepted?.Invoke(new string(buffer, index, count).TrimEnd('\r', '\n'));
+                this.OnMessageIntercepted?.Invoke(new string(buffer, index, count));
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index acd2c617..a8a8b6ee 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -22,9 +22,6 @@ namespace StardewModdingAPI.Framework.Logging
         /*********
         ** Fields
         *********/
-        /// <summary>Whether to show trace messages in the console.</summary>
-        private readonly bool ShowTraceInConsole;
-
         /// <summary>The log file to which to write messages.</summary>
         private readonly LogFileManager LogFile;
 
@@ -32,7 +29,7 @@ namespace StardewModdingAPI.Framework.Logging
         private readonly InterceptingTextWriter ConsoleInterceptor;
 
         /// <summary>Prefixing a low-level message with this character indicates that the console interceptor should write the string without intercepting it. (The character itself is not written.)</summary>
-        private readonly char IgnoreChar = '\u200B';
+        private const char IgnoreChar = InterceptingTextWriter.IgnoreChar;
 
         /// <summary>Get a named monitor instance.</summary>
         private readonly Func<string, Monitor> GetMonitorImpl;
@@ -40,18 +37,18 @@ namespace StardewModdingAPI.Framework.Logging
         /// <summary>Regex patterns which match console non-error messages to suppress from the console and log.</summary>
         private readonly Regex[] SuppressConsolePatterns =
         {
-            new Regex(@"^TextBox\.Selected is now '(?:True|False)'\.$", RegexOptions.Compiled | RegexOptions.CultureInvariant),
-            new Regex(@"^loadPreferences\(\); begin", RegexOptions.Compiled | RegexOptions.CultureInvariant),
-            new Regex(@"^savePreferences\(\); async=", RegexOptions.Compiled | RegexOptions.CultureInvariant),
-            new Regex(@"^DebugOutput:\s+(?:added cricket|dismount tile|Ping|playerPos)", RegexOptions.Compiled | RegexOptions.CultureInvariant),
-            new Regex(@"^Ignoring keys: ", RegexOptions.Compiled | RegexOptions.CultureInvariant)
+            new(@"^TextBox\.Selected is now '(?:True|False)'\.$", RegexOptions.Compiled | RegexOptions.CultureInvariant),
+            new(@"^loadPreferences\(\); begin", RegexOptions.Compiled | RegexOptions.CultureInvariant),
+            new(@"^savePreferences\(\); async=", RegexOptions.Compiled | RegexOptions.CultureInvariant),
+            new(@"^DebugOutput:\s+(?:added cricket|dismount tile|Ping|playerPos)", RegexOptions.Compiled | RegexOptions.CultureInvariant),
+            new(@"^Ignoring keys: ", RegexOptions.Compiled | RegexOptions.CultureInvariant)
         };
 
         /// <summary>Regex patterns which match console messages to show a more friendly error for.</summary>
         private readonly ReplaceLogPattern[] ReplaceConsolePatterns =
         {
             // Steam not loaded
-            new ReplaceLogPattern(
+            new(
                 search: new Regex(@"^System\.InvalidOperationException: Steamworks is not initialized\.[\s\S]+$", RegexOptions.Compiled | RegexOptions.CultureInvariant),
                 replacement:
 #if SMAPI_FOR_WINDOWS
@@ -63,7 +60,7 @@ namespace StardewModdingAPI.Framework.Logging
             ),
 
             // save file not found error
-            new ReplaceLogPattern(
+            new(
                 search: new Regex(@"^System\.IO\.FileNotFoundException: [^\n]+\n[^:]+: '[^\n]+[/\\]Saves[/\\]([^'\r\n]+)[/\\]([^'\r\n]+)'[\s\S]+LoadGameMenu\.FindSaveGames[\s\S]+$", RegexOptions.Compiled | RegexOptions.CultureInvariant),
                 replacement: "The game can't find the '$2' file for your '$1' save. See https://stardewvalleywiki.com/Saves#Troubleshooting for help.",
                 logLevel: LogLevel.Error
@@ -97,11 +94,10 @@ namespace StardewModdingAPI.Framework.Logging
         public LogManager(string logPath, ColorSchemeConfig colorConfig, bool writeToConsole, bool isVerbose, bool isDeveloperMode, Func<int?> getScreenIdForLog)
         {
             // init construction logic
-            this.ShowTraceInConsole = isDeveloperMode;
-            this.GetMonitorImpl = name => new Monitor(name, this.IgnoreChar, this.LogFile, colorConfig, isVerbose, getScreenIdForLog)
+            this.GetMonitorImpl = name => new Monitor(name, LogManager.IgnoreChar, this.LogFile, colorConfig, isVerbose, getScreenIdForLog)
             {
                 WriteToConsole = writeToConsole,
-                ShowTraceInConsole = this.ShowTraceInConsole,
+                ShowTraceInConsole = isDeveloperMode,
                 ShowFullStampInConsole = isDeveloperMode
             };
 
@@ -111,7 +107,7 @@ namespace StardewModdingAPI.Framework.Logging
             this.MonitorForGame = this.GetMonitor("game");
 
             // redirect direct console output
-            this.ConsoleInterceptor = new InterceptingTextWriter(Console.Out, this.IgnoreChar);
+            this.ConsoleInterceptor = new InterceptingTextWriter(Console.Out);
             if (writeToConsole)
                 this.ConsoleInterceptor.OnMessageIntercepted += message => this.HandleConsoleMessage(this.MonitorForGame, message);
             Console.SetOut(this.ConsoleInterceptor);
@@ -153,7 +149,7 @@ namespace StardewModdingAPI.Framework.Logging
                 .Add(new ReloadI18nCommand(reloadTranslations), this.Monitor);
 
             // start handling command line input
-            Thread inputThread = new Thread(() =>
+            Thread inputThread = new(() =>
             {
                 while (true)
                 {
@@ -393,8 +389,7 @@ namespace StardewModdingAPI.Framework.Logging
 
             // forward to monitor
             gameMonitor.Log(message, level);
-            if (level == LogLevel.Trace && !this.ShowTraceInConsole)
-                this.ConsoleInterceptor.IgnoreNextIfNewline = true;
+            this.ConsoleInterceptor.IgnoreNextIfNewline = true;
         }
 
         /// <summary>Write a summary of mod warnings to the console and log.</summary>
diff --git a/src/SMAPI/Framework/Monitor.cs b/src/SMAPI/Framework/Monitor.cs
index 04e67d68..ab76e7c0 100644
--- a/src/SMAPI/Framework/Monitor.cs
+++ b/src/SMAPI/Framework/Monitor.cs
@@ -28,7 +28,7 @@ namespace StardewModdingAPI.Framework
         private static readonly int MaxLevelLength = (from level in Enum.GetValues(typeof(LogLevel)).Cast<LogLevel>() select level.ToString().Length).Max();
 
         /// <summary>A cache of messages that should only be logged once.</summary>
-        private readonly HashSet<string> LogOnceCache = new HashSet<string>();
+        private readonly HashSet<string> LogOnceCache = new();
 
         /// <summary>Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</summary>
         private readonly Func<int?> GetScreenIdForLog;

From 230f1192056a5b49147bc45a8328b6132069f8c7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Jan 2022 17:08:08 -0500
Subject: [PATCH 399/856] merge field rewriters to reduce rewrite iterations

---
 docs/release-notes.md                         |  1 +
 .../ModLoading/Framework/RewriteHelper.cs     | 24 +-------
 .../Rewriters/FieldReplaceRewriter.cs         | 56 ++++++++++---------
 src/SMAPI/Metadata/InstructionMetadata.cs     |  9 +--
 4 files changed, 36 insertions(+), 54 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1a6f4078..56564953 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,7 @@
   * Added automatic save recovery when the custom farm type isn't available anymore.
   * Added the new game build number to the SMAPI console + log.
   * The installer now detects Xbox app game folders.
+  * Reduced mod loading time a bit.
   * Fixed extra newlines shown in the console in non-developer mode.
   * Fixed macOS launch issue when using some terminals (thanks to bruce2409!).
   * Fixed Linux/macOS terminal ignoring backspace in Stardew Valley 1.5.5+.
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
index 60bbd2c7..d7cb2471 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         ** Fields
         *********/
         /// <summary>The comparer which heuristically compares type definitions.</summary>
-        private static readonly TypeReferenceComparer TypeDefinitionComparer = new TypeReferenceComparer();
+        private static readonly TypeReferenceComparer TypeDefinitionComparer = new();
 
 
         /*********
@@ -28,28 +28,6 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
                 : null;
         }
 
-        /// <summary>Get whether the field is a reference to the expected type and field.</summary>
-        /// <param name="instruction">The IL instruction.</param>
-        /// <param name="fullTypeName">The full type name containing the expected field.</param>
-        /// <param name="fieldName">The name of the expected field.</param>
-        public static bool IsFieldReferenceTo(Instruction instruction, string fullTypeName, string fieldName)
-        {
-            FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
-            return RewriteHelper.IsFieldReferenceTo(fieldRef, fullTypeName, fieldName);
-        }
-
-        /// <summary>Get whether the field is a reference to the expected type and field.</summary>
-        /// <param name="fieldRef">The field reference to check.</param>
-        /// <param name="fullTypeName">The full type name containing the expected field.</param>
-        /// <param name="fieldName">The name of the expected field.</param>
-        public static bool IsFieldReferenceTo(FieldReference fieldRef, string fullTypeName, string fieldName)
-        {
-            return
-                fieldRef != null
-                && fieldRef.DeclaringType.FullName == fullTypeName
-                && fieldRef.Name == fieldName;
-        }
-
         /// <summary>Get the method reference from an instruction if it matches.</summary>
         /// <param name="instruction">The IL instruction.</param>
         public static MethodReference AsMethodReference(Instruction instruction)
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
index 0b679e9d..857a2230 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.Reflection;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -12,54 +13,55 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /*********
         ** Fields
         *********/
-        /// <summary>The type containing the field to which references should be rewritten.</summary>
-        private readonly Type Type;
-
-        /// <summary>The field name to which references should be rewritten.</summary>
-        private readonly string FromFieldName;
-
-        /// <summary>The new field to reference.</summary>
-        private readonly FieldInfo ToField;
+        /// <summary>The new fields to reference indexed by the old field/type names.</summary>
+        private readonly Dictionary<string, Dictionary<string, FieldInfo>> FieldMaps = new();
 
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        public FieldReplaceRewriter()
+            : base(defaultPhrase: "field replacement") { } // will be overridden when a field is replaced
+
+        /// <summary>Add a field to replace.</summary>
         /// <param name="fromType">The type whose field to rewrite.</param>
         /// <param name="fromFieldName">The field name to rewrite.</param>
         /// <param name="toType">The new type which will have the field.</param>
         /// <param name="toFieldName">The new field name to reference.</param>
-        public FieldReplaceRewriter(Type fromType, string fromFieldName, Type toType, string toFieldName)
-            : base(defaultPhrase: $"{fromType.FullName}.{fromFieldName} field")
+        public FieldReplaceRewriter AddField(Type fromType, string fromFieldName, Type toType, string toFieldName)
         {
-            this.Type = fromType;
-            this.FromFieldName = fromFieldName;
-            this.ToField = toType.GetField(toFieldName);
-            if (this.ToField == null)
-                throw new InvalidOperationException($"The {toType.FullName} class doesn't have a {toFieldName} field.");
-        }
+            // get full type name
+            string fromTypeName = fromType?.FullName;
+            if (fromTypeName == null)
+                throw new InvalidOperationException($"Can't replace field for invalid type reference {toType}.");
 
-        /// <summary>Construct an instance.</summary>
-        /// <param name="type">The type whose field to rewrite.</param>
-        /// <param name="fromFieldName">The field name to rewrite.</param>
-        /// <param name="toFieldName">The new field name to reference.</param>
-        public FieldReplaceRewriter(Type type, string fromFieldName, string toFieldName)
-            : this(type, fromFieldName, type, toFieldName)
-        {
+            // get target field
+            FieldInfo toField = toType.GetField(toFieldName);
+            if (toField == null)
+                throw new InvalidOperationException($"The {toType.FullName} class doesn't have a {toFieldName} field.");
+
+            // add mapping
+            if (!this.FieldMaps.TryGetValue(fromTypeName, out var fieldMap))
+                this.FieldMaps[fromTypeName] = fieldMap = new();
+            fieldMap[fromFieldName] = toField;
+
+            return this;
         }
 
         /// <inheritdoc />
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
-            // get field reference
             FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
-            if (!RewriteHelper.IsFieldReferenceTo(fieldRef, this.Type.FullName, this.FromFieldName))
+            string declaringType = fieldRef?.DeclaringType?.FullName;
+
+            // get mapped field
+            if (declaringType == null || !this.FieldMaps.TryGetValue(declaringType, out var fieldMap) || !fieldMap.TryGetValue(fieldRef.Name, out FieldInfo toField))
                 return false;
 
             // replace with new field
-            instruction.Operand = module.ImportReference(this.ToField);
-
+            this.Phrases.Add($"{fieldRef.DeclaringType.Name}.{fieldRef.Name} field");
+            instruction.Operand = module.ImportReference(toField);
             return this.MarkRewritten();
         }
     }
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 232e54ce..367372b2 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -37,9 +37,10 @@ namespace StardewModdingAPI.Metadata
             if (rewriteMods)
             {
                 // rewrite for Stardew Valley 1.5
-                yield return new FieldReplaceRewriter(typeof(DecoratableLocation), "furniture", typeof(GameLocation), nameof(GameLocation.furniture));
-                yield return new FieldReplaceRewriter(typeof(Farm), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
-                yield return new FieldReplaceRewriter(typeof(MineShaft), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
+                yield return new FieldReplaceRewriter()
+                    .AddField(typeof(DecoratableLocation), "furniture", typeof(GameLocation), nameof(GameLocation.furniture))
+                    .AddField(typeof(Farm), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps))
+                    .AddField(typeof(MineShaft), "resourceClumps", typeof(GameLocation), nameof(GameLocation.resourceClumps));
 
                 // heuristic rewrites
                 yield return new HeuristicFieldRewriter(this.ValidateReferencesToAssemblies);
@@ -87,7 +88,7 @@ namespace StardewModdingAPI.Metadata
                         typeof(System.IO.DirectoryInfo).FullName,
                         typeof(System.IO.DriveInfo).FullName,
                         typeof(System.IO.FileSystemWatcher).FullName
-                        },
+                    },
                     InstructionHandleResult.DetectedFilesystemAccess
                 );
 

From ad0e6b315dc7b4e616dcdf6c090cd54a2f3b7499 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Jan 2022 17:13:28 -0500
Subject: [PATCH 400/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 16 +++++++++-------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 1021c2a1..8eac9757 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.13.2</Version>
+    <Version>3.13.3</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 56564953..957d5199 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,17 +1,19 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.13.3
+Released 16 January 2021 for Stardew Valley 1.5.6 or later.
+
 * For players:
-  * **Increased minimum game version to Stardew Valley 1.5.6.**
-  * Added automatic fix for custom maps which don't have a required tilesheet.
-  * Added automatic save recovery when the custom farm type isn't available anymore.
-  * Added the new game build number to the SMAPI console + log.
+  * **SMAPI now needs Stardew Valley 1.5.6 or later.**
+  * Added automatic fix for custom maps which are missing a required tilesheet.
+  * Added automatic save recovery when a custom farm type isn't available anymore.
+  * Added the game's new build number to the SMAPI console + log.
   * The installer now detects Xbox app game folders.
   * Reduced mod loading time a bit.
-  * Fixed extra newlines shown in the console in non-developer mode.
   * Fixed macOS launch issue when using some terminals (thanks to bruce2409!).
-  * Fixed Linux/macOS terminal ignoring backspace in Stardew Valley 1.5.5+.
+  * Fixed Linux/macOS terminal ignoring backspaces in Stardew Valley 1.5.5+.
+  * Fixed extra newlines in the SMAPI console.
   * Fixed outdated instructions in Steam error message.
   * Fixed uninstaller not removing `StardewModdingAPI.deps.json` file.
   * Simplified [running without a terminal on Linux/macOS](https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_recognize_controller_.28Steam_only.29) when needed.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 216a4c32..97e1c243 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.13.2",
+    "Version": "3.13.3",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.13.2"
+    "MinimumApiVersion": "3.13.3"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index beb52020..c4246721 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.13.2",
+    "Version": "3.13.3",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.13.2"
+    "MinimumApiVersion": "3.13.3"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 2bd20a63..b1b946c8 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.13.2",
+    "Version": "3.13.3",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.13.2"
+    "MinimumApiVersion": "3.13.3"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 9e0ba79f..455cfd7e 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -49,7 +49,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.13.2";
+        internal static string RawApiVersion = "3.13.3";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 85f8631beefb5f97088fcecabb32bb8d2829a2fe Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Jan 2022 18:54:00 -0500
Subject: [PATCH 401/856] fix typo

---
 docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 957d5199..e555440a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,7 +2,7 @@
 
 # Release notes
 ## 3.13.3
-Released 16 January 2021 for Stardew Valley 1.5.6 or later.
+Released 16 January 2022 for Stardew Valley 1.5.6 or later.
 
 * For players:
   * **SMAPI now needs Stardew Valley 1.5.6 or later.**

From 95f4513727193d0048848d10ded465527a4969c9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Jan 2022 22:56:48 -0500
Subject: [PATCH 402/856] rewrite fallback assembly resolution

* SMAPI now also searches the root game folder for unresolved assemblies. This fixes an issue resolving the game DLL when the player's DLL version doesn't match the one used to compile SMAPI.
* The DLL search folders are now scanned once and cached to avoid repeated iterations on startup.
---
 docs/release-notes.md |  3 +++
 src/SMAPI/Program.cs  | 42 +++++++++++++++++++++++++++++++++---------
 2 files changed, 36 insertions(+), 9 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e555440a..684fb49d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,9 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* Fixed Linux/macOS launch error in 3.13.3.
+
 ## 3.13.3
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 67ff8322..0c90f2aa 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Reflection;
@@ -16,7 +17,10 @@ namespace StardewModdingAPI
         ** Fields
         *********/
         /// <summary>The absolute path to search for SMAPI's internal DLLs.</summary>
-        internal static readonly string DllSearchPath = EarlyConstants.InternalFilesPath;
+        private static readonly string DllSearchPath = EarlyConstants.InternalFilesPath;
+
+        /// <summary>The assembly paths in the search folders indexed by assembly name.</summary>
+        private static Dictionary<string, string> AssemblyPathsByName;
 
 
         /*********
@@ -57,16 +61,36 @@ namespace StardewModdingAPI
         /// <param name="e">The event arguments.</param>
         private static Assembly CurrentDomain_AssemblyResolve(object sender, ResolveEventArgs e)
         {
+            // cache assembly paths by name
+            if (Program.AssemblyPathsByName == null)
+            {
+                Program.AssemblyPathsByName = new(StringComparer.OrdinalIgnoreCase);
+
+                foreach (string searchPath in new[] { EarlyConstants.ExecutionPath, Program.DllSearchPath })
+                {
+                    foreach (string dllPath in Directory.EnumerateFiles(searchPath, "*.dll"))
+                    {
+                        try
+                        {
+                            string curName = AssemblyName.GetAssemblyName(dllPath).Name;
+                            if (curName != null)
+                                Program.AssemblyPathsByName[curName] = dllPath;
+                        }
+                        catch
+                        {
+                            continue;
+                        }
+                    }
+                }
+            }
+
+            // resolve
             try
             {
-                AssemblyName name = new AssemblyName(e.Name);
-                foreach (FileInfo dll in new DirectoryInfo(Program.DllSearchPath).EnumerateFiles("*.dll"))
-                {
-                    if (name.Name.Equals(AssemblyName.GetAssemblyName(dll.FullName).Name, StringComparison.OrdinalIgnoreCase))
-                        return Assembly.LoadFrom(dll.FullName);
-                }
-
-                return null;
+                string searchName = new AssemblyName(e.Name).Name;
+                return searchName != null && Program.AssemblyPathsByName.TryGetValue(searchName, out string assemblyPath)
+                    ? Assembly.LoadFrom(assemblyPath)
+                    : null;
             }
             catch (Exception ex)
             {

From dbed0289d7b7759145dea3e1c5d93df3d68ff116 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Jan 2022 22:57:40 -0500
Subject: [PATCH 403/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 7 +++++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 8eac9757..86624b62 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.13.3</Version>
+    <Version>3.13.4</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 684fb49d..05ab58a3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,8 +1,11 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
-* Fixed Linux/macOS launch error in 3.13.3.
+## 3.13.4
+Released 16 January 2022 for Stardew Valley 1.5.6 or later.
+
+* For players:
+  * Fixed Linux/macOS launch error in 3.13.3.
 
 ## 3.13.3
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 97e1c243..fa5f6d6f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.13.3",
+    "Version": "3.13.4",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.13.3"
+    "MinimumApiVersion": "3.13.4"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index c4246721..11bc0b42 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.13.3",
+    "Version": "3.13.4",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.13.3"
+    "MinimumApiVersion": "3.13.4"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index b1b946c8..c50cff14 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.13.3",
+    "Version": "3.13.4",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.13.3"
+    "MinimumApiVersion": "3.13.4"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 455cfd7e..667491d6 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -49,7 +49,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.13.3";
+        internal static string RawApiVersion = "3.13.4";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From d8bbf3c4412514e20abea6181adaa567a82db5a2 Mon Sep 17 00:00:00 2001
From: ChulkyBow <83290351+ChulkyBow@users.noreply.github.com>
Date: Tue, 18 Jan 2022 16:25:36 +0200
Subject: [PATCH 404/856] Update Ukrainian translation for SMAPI

---
 src/SMAPI/i18n/uk.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/i18n/uk.json b/src/SMAPI/i18n/uk.json
index d84aabcf..a4286363 100644
--- a/src/SMAPI/i18n/uk.json
+++ b/src/SMAPI/i18n/uk.json
@@ -1,6 +1,6 @@
 {
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
-    "generic.date": "{{season}} День {{day}}",
-    "generic.date-with-year": "{{season}} День {{day}}, Рік {{year}}"
+    "generic.date": "{{season}}, {{day}}-й день",
+    "generic.date-with-year": "{{season}}, {{day}}-й день, {{year}} рік"
 }

From 53ed5f4faaffad212a753b33db2106470f48b6b5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 24 Jan 2022 21:55:30 -0500
Subject: [PATCH 405/856] update release notes

---
 docs/release-notes.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 05ab58a3..f45df4bd 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,9 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
+
 ## 3.13.4
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
 

From bca9e599cc02edcc6e9bcfba2138d916ae6a3a79 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 29 Jan 2022 17:27:42 -0500
Subject: [PATCH 406/856] remove unneeded dictionary patch

The dictionary errors were improved in .NET 5, so they include the key automatically.
---
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  1 -
 .../Patches/DictionaryPatcher.cs              | 98 -------------------
 2 files changed, 99 deletions(-)
 delete mode 100644 src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs

diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index 067f6a8d..7286e316 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -30,7 +30,6 @@ namespace StardewModdingAPI.Mods.ErrorHandler
             // apply patches
             HarmonyPatcher.Apply(this.ModManifest.UniqueID, this.Monitor,
                 new DialoguePatcher(monitorForGame, this.Helper.Reflection),
-                new DictionaryPatcher(this.Helper.Reflection),
                 new EventPatcher(monitorForGame),
                 new GameLocationPatcher(monitorForGame),
                 new IClickableMenuPatcher(),
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
deleted file mode 100644
index 8ceafcc5..00000000
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DictionaryPatcher.cs
+++ /dev/null
@@ -1,98 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Diagnostics.CodeAnalysis;
-using HarmonyLib;
-using StardewModdingAPI.Internal.Patching;
-using StardewValley.GameData;
-using StardewValley.GameData.HomeRenovations;
-using StardewValley.GameData.Movies;
-
-namespace StardewModdingAPI.Mods.ErrorHandler.Patches
-{
-    /// <summary>Harmony patches for <see cref="Dictionary{TKey,TValue}"/> which add the accessed key to <see cref="KeyNotFoundException"/> exceptions.</summary>
-    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
-    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
-    internal class DictionaryPatcher : BasePatcher
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>Simplifies access to private code.</summary>
-        private static IReflectionHelper Reflection;
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="reflector">Simplifies access to private code.</param>
-        public DictionaryPatcher(IReflectionHelper reflector)
-        {
-            DictionaryPatcher.Reflection = reflector;
-        }
-
-        /// <inheritdoc />
-        public override void Apply(Harmony harmony, IMonitor monitor)
-        {
-            Type[] keyTypes = { typeof(int), typeof(string) };
-            Type[] valueTypes = { typeof(int), typeof(string), typeof(HomeRenovation), typeof(MovieData), typeof(SpecialOrderData) };
-
-            foreach (Type keyType in keyTypes)
-            {
-                foreach (Type valueType in valueTypes)
-                {
-                    Type dictionaryType = typeof(Dictionary<,>).MakeGenericType(keyType, valueType);
-
-                    harmony.Patch(
-                        original: AccessTools.Method(dictionaryType, "get_Item") ?? throw new InvalidOperationException($"Can't find method {PatchHelper.GetMethodString(dictionaryType, "get_Item")} to patch."),
-                        finalizer: this.GetHarmonyMethod(nameof(DictionaryPatcher.Finalize_GetItem))
-                    );
-
-                    harmony.Patch(
-                        original: AccessTools.Method(dictionaryType, "Add") ?? throw new InvalidOperationException($"Can't find method {PatchHelper.GetMethodString(dictionaryType, "Add")} to patch."),
-                        finalizer: this.GetHarmonyMethod(nameof(DictionaryPatcher.Finalize_Add))
-                    );
-                }
-            }
-        }
-
-
-        /*********
-        ** Private methods
-        *********/
-        /// <summary>The method to call after the dictionary indexer throws an exception.</summary>
-        /// <param name="key">The dictionary key being fetched.</param>
-        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
-        /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_GetItem(object key, Exception __exception)
-        {
-            if (__exception is KeyNotFoundException)
-                DictionaryPatcher.AddKey(__exception, key);
-
-            return __exception;
-        }
-
-        /// <summary>The method to call after a dictionary insert throws an exception.</summary>
-        /// <param name="key">The dictionary key being inserted.</param>
-        /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
-        /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_Add(object key, Exception __exception)
-        {
-            if (__exception is ArgumentException)
-                DictionaryPatcher.AddKey(__exception, key);
-
-            return __exception;
-        }
-
-        /// <summary>Add the dictionary key to an exception message.</summary>
-        /// <param name="exception">The exception whose message to edit.</param>
-        /// <param name="key">The dictionary key.</param>
-        private static void AddKey(Exception exception, object key)
-        {
-            DictionaryPatcher.Reflection
-                .GetField<string>(exception, "_message")
-                .SetValue($"{exception.Message}\nkey: '{key}'");
-        }
-    }
-}

From 6b9c9be2b6f08f46077f8d81ef05e9d249d72935 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 29 Jan 2022 17:33:12 -0500
Subject: [PATCH 407/856] move item repo secret note + flavored object logic
 into methods

---
 .../Framework/ItemRepository.cs               | 248 ++++++++++--------
 1 file changed, 133 insertions(+), 115 deletions(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 0357fe6b..4a57ba5a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -139,15 +139,8 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                         {
                             if (ShouldGet(ItemType.Object))
                             {
-                                foreach (int secretNoteId in this.TryLoad<int, string>("Data\\SecretNotes").Keys)
-                                {
-                                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset + secretNoteId, _ =>
-                                    {
-                                        SObject note = new SObject(79, 1);
-                                        note.name = $"{note.name} #{secretNoteId}";
-                                        return note;
-                                    });
-                                }
+                                foreach (SearchableItem secretNote in this.GetSecretNotes())
+                                    yield return secretNote;
                             }
                         }
 
@@ -176,112 +169,8 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                             // flavored items
                             if (includeVariants)
                             {
-                                switch (item.Category)
-                                {
-                                    // fruit products
-                                    case SObject.FruitsCategory:
-                                        // wine
-                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 2 + item.ParentSheetIndex, _ => new SObject(348, 1)
-                                        {
-                                            Name = $"{item.Name} Wine",
-                                            Price = item.Price * 3,
-                                            preserve = { SObject.PreserveType.Wine },
-                                            preservedParentSheetIndex = { item.ParentSheetIndex }
-                                        });
-
-                                        // jelly
-                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 3 + item.ParentSheetIndex, _ => new SObject(344, 1)
-                                        {
-                                            Name = $"{item.Name} Jelly",
-                                            Price = 50 + item.Price * 2,
-                                            preserve = { SObject.PreserveType.Jelly },
-                                            preservedParentSheetIndex = { item.ParentSheetIndex }
-                                        });
-                                        break;
-
-                                    // vegetable products
-                                    case SObject.VegetableCategory:
-                                        // juice
-                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 4 + item.ParentSheetIndex, _ => new SObject(350, 1)
-                                        {
-                                            Name = $"{item.Name} Juice",
-                                            Price = (int)(item.Price * 2.25d),
-                                            preserve = { SObject.PreserveType.Juice },
-                                            preservedParentSheetIndex = { item.ParentSheetIndex }
-                                        });
-
-                                        // pickled
-                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + item.ParentSheetIndex, _ => new SObject(342, 1)
-                                        {
-                                            Name = $"Pickled {item.Name}",
-                                            Price = 50 + item.Price * 2,
-                                            preserve = { SObject.PreserveType.Pickle },
-                                            preservedParentSheetIndex = { item.ParentSheetIndex }
-                                        });
-                                        break;
-
-                                    // flower honey
-                                    case SObject.flowersCategory:
-                                        yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + item.ParentSheetIndex, _ =>
-                                        {
-                                            SObject honey = new SObject(Vector2.Zero, 340, $"{item.Name} Honey", false, true, false, false)
-                                            {
-                                                Name = $"{item.Name} Honey",
-                                                preservedParentSheetIndex = { item.ParentSheetIndex }
-                                            };
-                                            honey.Price += item.Price * 2;
-                                            return honey;
-                                        });
-                                        break;
-
-                                    // roe and aged roe (derived from FishPond.GetFishProduce)
-                                    case SObject.sellAtFishShopCategory when item.ParentSheetIndex == 812:
-                                        {
-                                            this.GetRoeContextTagLookups(out HashSet<string> simpleTags, out List<List<string>> complexTags);
-
-                                            foreach (var pair in Game1.objectInformation)
-                                            {
-                                                // get input
-                                                SObject input = this.TryCreate(ItemType.Object, pair.Key, p => new SObject(p.ID, 1))?.Item as SObject;
-                                                var inputTags = input?.GetContextTags();
-                                                if (inputTags?.Any() != true)
-                                                    continue;
-
-                                                // check if roe-producing fish
-                                                if (!inputTags.Any(tag => simpleTags.Contains(tag)) && !complexTags.Any(set => set.All(tag => input.HasContextTag(tag))))
-                                                    continue;
-
-                                                // yield roe
-                                                SObject roe = null;
-                                                Color color = this.GetRoeColor(input);
-                                                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + item.ParentSheetIndex, _ =>
-                                                {
-                                                    roe = new ColoredObject(812, 1, color)
-                                                    {
-                                                        name = $"{input.Name} Roe",
-                                                        preserve = { Value = SObject.PreserveType.Roe },
-                                                        preservedParentSheetIndex = { Value = input.ParentSheetIndex }
-                                                    };
-                                                    roe.Price += input.Price / 2;
-                                                    return roe;
-                                                });
-
-                                                // aged roe
-                                                if (roe != null && pair.Key != 698) // aged sturgeon roe is caviar, which is a separate item
-                                                {
-                                                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + item.ParentSheetIndex, _ => new ColoredObject(447, 1, color)
-                                                    {
-                                                        name = $"Aged {input.Name} Roe",
-                                                        Category = -27,
-                                                        preserve = { Value = SObject.PreserveType.AgedRoe },
-                                                        preservedParentSheetIndex = { Value = input.ParentSheetIndex },
-                                                        Price = roe.Price * 2
-                                                    });
-                                                }
-                                            }
-                                        }
-                                        break;
-                                }
+                                foreach (SearchableItem variant in this.GetFlavoredObjectVariants(item))
+                                    yield return variant;
                             }
                         }
                     }
@@ -295,6 +184,135 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
         /*********
         ** Private methods
         *********/
+        /// <summary>Get the individual secret note items, if any.</summary>
+        /// <remarks>Derived from <see cref="GameLocation.tryToCreateUnseenSecretNote"/>.</remarks>
+        private IEnumerable<SearchableItem> GetSecretNotes()
+        {
+            foreach (int secretNoteId in this.TryLoad<int, string>("Data\\SecretNotes").Keys)
+            {
+                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset + secretNoteId, _ =>
+                {
+                    SObject note = new(79, 1);
+                    note.name = $"{note.name} #{secretNoteId}";
+                    return note;
+                });
+            }
+        }
+
+        /// <summary>Get flavored variants of a base item (like Blueberry Wine for Blueberry), if any.</summary>
+        /// <param name="item">A sample of the base item.</param>
+        private IEnumerable<SearchableItem> GetFlavoredObjectVariants(SObject item)
+        {
+            int id = item.ParentSheetIndex;
+
+            switch (item.Category)
+            {
+                // fruit products
+                case SObject.FruitsCategory:
+                    // wine
+                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 2 + id, _ => new SObject(348, 1)
+                    {
+                        Name = $"{item.Name} Wine",
+                        Price = item.Price * 3,
+                        preserve = { SObject.PreserveType.Wine },
+                        preservedParentSheetIndex = { id }
+                    });
+
+                    // jelly
+                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 3 + id, _ => new SObject(344, 1)
+                    {
+                        Name = $"{item.Name} Jelly",
+                        Price = 50 + item.Price * 2,
+                        preserve = { SObject.PreserveType.Jelly },
+                        preservedParentSheetIndex = { id }
+                    });
+                    break;
+
+                // vegetable products
+                case SObject.VegetableCategory:
+                    // juice
+                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 4 + id, _ => new SObject(350, 1)
+                    {
+                        Name = $"{item.Name} Juice",
+                        Price = (int)(item.Price * 2.25d),
+                        preserve = { SObject.PreserveType.Juice },
+                        preservedParentSheetIndex = { id }
+                    });
+
+                    // pickled
+                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + id, _ => new SObject(342, 1)
+                    {
+                        Name = $"Pickled {item.Name}",
+                        Price = 50 + item.Price * 2,
+                        preserve = { SObject.PreserveType.Pickle },
+                        preservedParentSheetIndex = { id }
+                    });
+                    break;
+
+                // flower honey
+                case SObject.flowersCategory:
+                    yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + id, _ =>
+                    {
+                        SObject honey = new SObject(Vector2.Zero, 340, $"{item.Name} Honey", false, true, false, false)
+                        {
+                            Name = $"{item.Name} Honey",
+                            preservedParentSheetIndex = { id }
+                        };
+                        honey.Price += item.Price * 2;
+                        return honey;
+                    });
+                    break;
+
+                // roe and aged roe (derived from FishPond.GetFishProduce)
+                case SObject.sellAtFishShopCategory when id == 812:
+                    {
+                        this.GetRoeContextTagLookups(out HashSet<string> simpleTags, out List<List<string>> complexTags);
+
+                        foreach (var pair in Game1.objectInformation)
+                        {
+                            // get input
+                            SObject input = this.TryCreate(ItemType.Object, pair.Key, p => new SObject(p.ID, 1))?.Item as SObject;
+                            var inputTags = input?.GetContextTags();
+                            if (inputTags?.Any() != true)
+                                continue;
+
+                            // check if roe-producing fish
+                            if (!inputTags.Any(tag => simpleTags.Contains(tag)) && !complexTags.Any(set => set.All(tag => input.HasContextTag(tag))))
+                                continue;
+
+                            // yield roe
+                            SObject roe = null;
+                            Color color = this.GetRoeColor(input);
+                            yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + id, _ =>
+                            {
+                                roe = new ColoredObject(812, 1, color)
+                                {
+                                    name = $"{input.Name} Roe",
+                                    preserve = { Value = SObject.PreserveType.Roe },
+                                    preservedParentSheetIndex = { Value = input.ParentSheetIndex }
+                                };
+                                roe.Price += input.Price / 2;
+                                return roe;
+                            });
+
+                            // aged roe
+                            if (roe != null && pair.Key != 698) // aged sturgeon roe is caviar, which is a separate item
+                            {
+                                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + id, _ => new ColoredObject(447, 1, color)
+                                {
+                                    name = $"Aged {input.Name} Roe",
+                                    Category = -27,
+                                    preserve = { Value = SObject.PreserveType.AgedRoe },
+                                    preservedParentSheetIndex = { Value = input.ParentSheetIndex },
+                                    Price = roe.Price * 2
+                                });
+                            }
+                        }
+                    }
+                    break;
+            }
+        }
+
         /// <summary>Get optimized lookups to match items which produce roe in a fish pond.</summary>
         /// <param name="simpleTags">A lookup of simple singular tags which match a roe-producing fish.</param>
         /// <param name="complexTags">A list of tag sets which match roe-producing fish.</param>

From 6dd4a8a12b25d349b18609132dade14da6ec3cf9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 29 Jan 2022 17:46:45 -0500
Subject: [PATCH 408/856] fix item repo's handling of Journal Scraps and Secret
 Notes

---
 docs/release-notes.md                         |  6 +-
 .../Framework/ItemRepository.cs               | 68 ++++++++++++++-----
 2 files changed, 55 insertions(+), 19 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f45df4bd..f1911716 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,7 +2,11 @@
 
 # Release notes
 ## Upcoming release
-* Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
+* For players:
+  * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
+
+* For console commands:
+  * Fixed `player_add` with Journal Scraps and Secret Notes.
 
 ## 3.13.4
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 4a57ba5a..8704a403 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -134,24 +134,34 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                     {
                         string[] fields = Game1.objectInformation[id]?.Split('/');
 
-                        // secret notes
-                        if (id == 79)
-                        {
-                            if (ShouldGet(ItemType.Object))
-                            {
-                                foreach (SearchableItem secretNote in this.GetSecretNotes())
-                                    yield return secretNote;
-                            }
-                        }
-
                         // ring
-                        else if (id != 801 && fields?.Length >= 4 && fields[3] == "Ring") // 801 = wedding ring, which isn't an equippable ring
+                        if (id != 801 && fields?.Length >= 4 && fields[3] == "Ring") // 801 = wedding ring, which isn't an equippable ring
                         {
                             if (ShouldGet(ItemType.Ring))
                                 yield return this.TryCreate(ItemType.Ring, id, p => new Ring(p.ID));
                         }
 
-                        // item
+                        // journal scrap
+                        else if (id == 842)
+                        {
+                            if (ShouldGet(ItemType.Object))
+                            {
+                                foreach (SearchableItem journalScrap in this.GetSecretNotes(isJournalScrap: true))
+                                    yield return journalScrap;
+                            }
+                        }
+
+                        // secret notes
+                        else if (id == 79)
+                        {
+                            if (ShouldGet(ItemType.Object))
+                            {
+                                foreach (SearchableItem secretNote in this.GetSecretNotes(isJournalScrap: false))
+                                    yield return secretNote;
+                            }
+                        }
+
+                        // object
                         else if (ShouldGet(ItemType.Object))
                         {
                             // spawn main item
@@ -184,16 +194,38 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
         /*********
         ** Private methods
         *********/
-        /// <summary>Get the individual secret note items, if any.</summary>
+        /// <summary>Get the individual secret note or journal scrap items.</summary>
+        /// <param name="isJournalScrap">Whether to get journal scraps.</param>
         /// <remarks>Derived from <see cref="GameLocation.tryToCreateUnseenSecretNote"/>.</remarks>
-        private IEnumerable<SearchableItem> GetSecretNotes()
+        private IEnumerable<SearchableItem> GetSecretNotes(bool isJournalScrap)
         {
-            foreach (int secretNoteId in this.TryLoad<int, string>("Data\\SecretNotes").Keys)
+            // get base item ID
+            int baseId = isJournalScrap ? 842 : 79;
+
+            // get secret note IDs
+            var ids = this
+                .TryLoad<int, string>("Data\\SecretNotes")
+                .Keys
+                .Where(isJournalScrap
+                    ? id => (id >= GameLocation.JOURNAL_INDEX)
+                    : id => (id < GameLocation.JOURNAL_INDEX)
+                )
+                .Select<int, int>(isJournalScrap
+                    ? id => (id - GameLocation.JOURNAL_INDEX)
+                    : id => id
+                );
+
+            // build items
+            foreach (int id in ids)
             {
-                yield return this.TryCreate(ItemType.Object, this.CustomIDOffset + secretNoteId, _ =>
+                int fakeId = this.CustomIDOffset * 8 + id;
+                if (isJournalScrap)
+                    fakeId += GameLocation.JOURNAL_INDEX;
+
+                yield return this.TryCreate(ItemType.Object, fakeId, _ =>
                 {
-                    SObject note = new(79, 1);
-                    note.name = $"{note.name} #{secretNoteId}";
+                    SObject note = new(baseId, 1);
+                    note.Name = $"{note.Name} #{id}";
                     return note;
                 });
             }

From 3431f486a2ef93e86d8923c1a4651644110df81b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 29 Jan 2022 18:15:42 -0500
Subject: [PATCH 409/856] normalize season names in SDate constructor

---
 docs/release-notes.md                   |  3 +++
 src/SMAPI.Tests/Utilities/SDateTests.cs | 10 ++++++----
 src/SMAPI/Utilities/SDate.cs            |  4 +++-
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f1911716..4ca11f01 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,9 @@
 * For players:
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
 
+* For mod authors:
+  * The `SDate` constructor is no longer case-sensitive for season names.
+
 * For console commands:
   * Fixed `player_add` with Journal Scraps and Secret Notes.
 
diff --git a/src/SMAPI.Tests/Utilities/SDateTests.cs b/src/SMAPI.Tests/Utilities/SDateTests.cs
index 0461952e..374f4921 100644
--- a/src/SMAPI.Tests/Utilities/SDateTests.cs
+++ b/src/SMAPI.Tests/Utilities/SDateTests.cs
@@ -16,9 +16,12 @@ namespace SMAPI.Tests.Utilities
         /*********
         ** Fields
         *********/
-        /// <summary>All valid seasons.</summary>
+        /// <summary>The valid seasons.</summary>
         private static readonly string[] ValidSeasons = { "spring", "summer", "fall", "winter" };
 
+        /// <summary>Sample user inputs for season names.</summary>
+        private static readonly string[] SampleSeasonValues = SDateTests.ValidSeasons.Concat(new[] { "  WIntEr  " }).ToArray();
+
         /// <summary>All valid days of a month.</summary>
         private static readonly int[] ValidDays = Enumerable.Range(1, 28).ToArray();
 
@@ -55,19 +58,18 @@ namespace SMAPI.Tests.Utilities
         ** Constructor
         ****/
         [Test(Description = "Assert that the constructor sets the expected values for all valid dates.")]
-        public void Constructor_SetsExpectedValues([ValueSource(nameof(SDateTests.ValidSeasons))] string season, [ValueSource(nameof(SDateTests.ValidDays))] int day, [Values(1, 2, 100)] int year)
+        public void Constructor_SetsExpectedValues([ValueSource(nameof(SDateTests.SampleSeasonValues))] string season, [ValueSource(nameof(SDateTests.ValidDays))] int day, [Values(1, 2, 100)] int year)
         {
             // act
             SDate date = new SDate(day, season, year);
 
             // assert
             Assert.AreEqual(day, date.Day);
-            Assert.AreEqual(season, date.Season);
+            Assert.AreEqual(season.Trim().ToLowerInvariant(), date.Season);
             Assert.AreEqual(year, date.Year);
         }
 
         [Test(Description = "Assert that the constructor throws an exception if the values are invalid.")]
-        [TestCase(01, "Spring", 1)] // seasons are case-sensitive
         [TestCase(01, "springs", 1)] // invalid season name
         [TestCase(-1, "spring", 1)] // day < 0
         [TestCase(0, "spring", 1)] // day zero
diff --git a/src/SMAPI/Utilities/SDate.cs b/src/SMAPI/Utilities/SDate.cs
index cd075dcc..e10a59f8 100644
--- a/src/SMAPI/Utilities/SDate.cs
+++ b/src/SMAPI/Utilities/SDate.cs
@@ -250,6 +250,8 @@ namespace StardewModdingAPI.Utilities
         /// <exception cref="ArgumentException">One of the arguments has an invalid value (like day 35).</exception>
         private SDate(int day, string season, int year, bool allowDayZero)
         {
+            season = season?.Trim().ToLowerInvariant();
+
             // validate
             if (season == null)
                 throw new ArgumentNullException(nameof(season));
@@ -277,7 +279,7 @@ namespace StardewModdingAPI.Utilities
         /// <param name="year">The year.</param>
         private bool IsDayZero(int day, string season, int year)
         {
-            return day == 0 && season == "spring" && year == 1;
+            return day == 0 && season?.Trim().ToLower() == "spring" && year == 1;
         }
 
         /// <summary>Get the day of week for a given date.</summary>

From 25a9f54ecfdaf6c4ad67dfb46c3f8c556d15d949 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 29 Jan 2022 20:43:45 -0500
Subject: [PATCH 410/856] fix manifest JSON schema's update key pattern

---
 docs/release-notes.md                       | 3 +++
 src/SMAPI.Web/wwwroot/schemas/manifest.json | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4ca11f01..585644ef 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,9 @@
 * For console commands:
   * Fixed `player_add` with Journal Scraps and Secret Notes.
 
+* For the web UI:
+  * Fixed JSON validator warning for update keys without a subkey.
+
 ## 3.13.4
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/manifest.json b/src/SMAPI.Web/wwwroot/schemas/manifest.json
index b6722347..7457b993 100644
--- a/src/SMAPI.Web/wwwroot/schemas/manifest.json
+++ b/src/SMAPI.Web/wwwroot/schemas/manifest.json
@@ -103,7 +103,7 @@
             "type": "array",
             "items": {
                 "type": "string",
-                "pattern": "^(?i)(Chucklefish:\\d+|Nexus:\\d+|GitHub:[A-Za-z0-9_\\-]+/[A-Za-z0-9_\\-]+|ModDrop:\\d+)(?: *@ *[a-zA-Z0-9_]+ *)$",
+                "pattern": "^(?i)(Chucklefish:\\d+|Nexus:\\d+|GitHub:[A-Za-z0-9_\\-]+/[A-Za-z0-9_\\-]+|ModDrop:\\d+)(?: *@ *[a-zA-Z0-9_]+ *)?$",
                 "@errorMessages": {
                     "pattern": "Invalid update key; see https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Manifest#Update_checks for more info."
                 }

From 0ff82c38e7a5b630256d2cd23a63ac1088d13e39 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Tue, 8 Feb 2022 20:02:13 +0100
Subject: [PATCH 411/856] allow default interface method implementations in API
 proxies

---
 .../Reflection/InterfaceProxyBuilder.cs       | 31 ++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 70ef81f8..164cac0b 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -55,10 +55,39 @@ namespace StardewModdingAPI.Framework.Reflection
                 il.Emit(OpCodes.Ret);
             }
 
+            var allTargetMethods = targetType.GetMethods().ToList();
+            foreach (Type targetInterface in targetType.GetInterfaces())
+            {
+                foreach (MethodInfo targetMethod in targetInterface.GetMethods())
+                {
+                    if (!targetMethod.IsAbstract)
+                        allTargetMethods.Add(targetMethod);
+                }
+            }
+
             // proxy methods
             foreach (MethodInfo proxyMethod in interfaceType.GetMethods())
             {
-                var targetMethod = targetType.GetMethod(proxyMethod.Name, proxyMethod.GetParameters().Select(a => a.ParameterType).ToArray());
+                var proxyMethodParameters = proxyMethod.GetParameters();
+                var targetMethod = allTargetMethods.Where(m =>
+                {
+                    if (m.Name != proxyMethod.Name)
+                        return false;
+                    if (m.ReturnType != proxyMethod.ReturnType)
+                        return false;
+
+                    var mParameters = m.GetParameters();
+                    if (m.GetParameters().Length != proxyMethodParameters.Length)
+                        return false;
+                    for (int i = 0; i < mParameters.Length; i++)
+                    {
+                        // TODO: decide if "assignable" checking is desired (instead of just 1:1 type equality)
+                        // TODO: test if this actually works
+                        if (!mParameters[i].ParameterType.IsAssignableFrom(proxyMethodParameters[i].ParameterType))
+                            return false;
+                    }
+                    return true;
+                }).FirstOrDefault();
                 if (targetMethod == null)
                     throw new InvalidOperationException($"The {interfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
 

From 3135925982b01d8f316adc171c7c1235ea41c1d3 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Tue, 8 Feb 2022 21:54:53 +0100
Subject: [PATCH 412/856] allow generic methods and any assignable types in API
 proxies

---
 .../Reflection/InterfaceProxyBuilder.cs       | 53 +++++++++++++++----
 1 file changed, 43 insertions(+), 10 deletions(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 164cac0b..35faa852 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -65,15 +65,30 @@ namespace StardewModdingAPI.Framework.Reflection
                 }
             }
 
+            bool AreTypesMatching(Type targetType, Type proxyType, MethodTypeMatchingPart part)
+            {
+                var typeA = part == MethodTypeMatchingPart.Parameter ? targetType : proxyType;
+                var typeB = part == MethodTypeMatchingPart.Parameter ? proxyType : targetType;
+
+                if (typeA.IsGenericMethodParameter != typeB.IsGenericMethodParameter)
+                    return false;
+                // TODO: decide if "assignable" checking is desired (instead of just 1:1 type equality)
+                return typeA.IsGenericMethodParameter ? typeA.GenericParameterPosition == typeB.GenericParameterPosition : typeA.IsAssignableFrom(typeB);
+            }
+
             // proxy methods
             foreach (MethodInfo proxyMethod in interfaceType.GetMethods())
             {
                 var proxyMethodParameters = proxyMethod.GetParameters();
+                var proxyMethodGenericArguments = proxyMethod.GetGenericArguments();
                 var targetMethod = allTargetMethods.Where(m =>
                 {
                     if (m.Name != proxyMethod.Name)
                         return false;
-                    if (m.ReturnType != proxyMethod.ReturnType)
+
+                    if (m.GetGenericArguments().Length != proxyMethodGenericArguments.Length)
+                        return false;
+                    if (!AreTypesMatching(m.ReturnType, proxyMethod.ReturnType, MethodTypeMatchingPart.ReturnType))
                         return false;
 
                     var mParameters = m.GetParameters();
@@ -81,9 +96,7 @@ namespace StardewModdingAPI.Framework.Reflection
                         return false;
                     for (int i = 0; i < mParameters.Length; i++)
                     {
-                        // TODO: decide if "assignable" checking is desired (instead of just 1:1 type equality)
-                        // TODO: test if this actually works
-                        if (!mParameters[i].ParameterType.IsAssignableFrom(proxyMethodParameters[i].ParameterType))
+                        if (!AreTypesMatching(mParameters[i].ParameterType, proxyMethodParameters[i].ParameterType, MethodTypeMatchingPart.Parameter))
                             return false;
                     }
                     return true;
@@ -91,7 +104,7 @@ namespace StardewModdingAPI.Framework.Reflection
                 if (targetMethod == null)
                     throw new InvalidOperationException($"The {interfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
 
-                this.ProxyMethod(proxyBuilder, targetMethod, targetField);
+                this.ProxyMethod(proxyBuilder, proxyMethod, targetMethod, targetField);
             }
 
             // save info
@@ -115,16 +128,30 @@ namespace StardewModdingAPI.Framework.Reflection
         *********/
         /// <summary>Define a method which proxies access to a method on the target.</summary>
         /// <param name="proxyBuilder">The proxy type being generated.</param>
+        /// <param name="proxy">The proxy method.</param>
         /// <param name="target">The target method.</param>
         /// <param name="instanceField">The proxy field containing the API instance.</param>
-        private void ProxyMethod(TypeBuilder proxyBuilder, MethodInfo target, FieldBuilder instanceField)
+        private void ProxyMethod(TypeBuilder proxyBuilder, MethodInfo proxy, MethodInfo target, FieldBuilder instanceField)
         {
-            Type[] argTypes = target.GetParameters().Select(a => a.ParameterType).ToArray();
-
-            // create method
             MethodBuilder methodBuilder = proxyBuilder.DefineMethod(target.Name, MethodAttributes.Public | MethodAttributes.Final | MethodAttributes.Virtual);
+
+            // set up generic arguments
+            Type[] proxyGenericArguments = proxy.GetGenericArguments();
+            string[] genericArgNames = proxyGenericArguments.Select(a => a.Name).ToArray();
+            GenericTypeParameterBuilder[] genericTypeParameterBuilders = proxyGenericArguments.Length == 0 ? null : methodBuilder.DefineGenericParameters(genericArgNames);
+            for (int i = 0; i < proxyGenericArguments.Length; i++)
+                genericTypeParameterBuilders[i].SetGenericParameterAttributes(proxyGenericArguments[i].GenericParameterAttributes);
+
+            // set up return type
+            // TODO: keep if it's decided to use isAssignableFrom
+            methodBuilder.SetReturnType(proxy.ReturnType.IsGenericMethodParameter ? genericTypeParameterBuilders[proxy.ReturnType.GenericParameterPosition] : proxy.ReturnType);
+
+            // set up parameters
+            Type[] argTypes = proxy.GetParameters()
+                .Select(a => a.ParameterType)
+                .Select(t => t.IsGenericMethodParameter ? genericTypeParameterBuilders[t.GenericParameterPosition] : t)
+                .ToArray();
             methodBuilder.SetParameters(argTypes);
-            methodBuilder.SetReturnType(target.ReturnType);
 
             // create method body
             {
@@ -143,5 +170,11 @@ namespace StardewModdingAPI.Framework.Reflection
                 il.Emit(OpCodes.Ret);
             }
         }
+
+        /// <summary>The part of a method that is being matched.</summary>
+        private enum MethodTypeMatchingPart
+        {
+            ReturnType, Parameter
+        }
     }
 }

From 5b5304403b79ce09bd06d1c4b52b67427069b772 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Tue, 8 Feb 2022 22:19:16 +0100
Subject: [PATCH 413/856] oops old code

---
 src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 35faa852..4c154679 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -143,7 +143,6 @@ namespace StardewModdingAPI.Framework.Reflection
                 genericTypeParameterBuilders[i].SetGenericParameterAttributes(proxyGenericArguments[i].GenericParameterAttributes);
 
             // set up return type
-            // TODO: keep if it's decided to use isAssignableFrom
             methodBuilder.SetReturnType(proxy.ReturnType.IsGenericMethodParameter ? genericTypeParameterBuilders[proxy.ReturnType.GenericParameterPosition] : proxy.ReturnType);
 
             // set up parameters

From 5a92b0cd357776eebb88e001384f9ca1ccdb7d5c Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Tue, 8 Feb 2022 22:36:34 +0100
Subject: [PATCH 414/856] uses `proxy.Name` instead of `target.Name` (which
 makes more sense in this context)

---
 src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 4c154679..5ae96dff 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -133,7 +133,7 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <param name="instanceField">The proxy field containing the API instance.</param>
         private void ProxyMethod(TypeBuilder proxyBuilder, MethodInfo proxy, MethodInfo target, FieldBuilder instanceField)
         {
-            MethodBuilder methodBuilder = proxyBuilder.DefineMethod(target.Name, MethodAttributes.Public | MethodAttributes.Final | MethodAttributes.Virtual);
+            MethodBuilder methodBuilder = proxyBuilder.DefineMethod(proxy.Name, MethodAttributes.Public | MethodAttributes.Final | MethodAttributes.Virtual);
 
             // set up generic arguments
             Type[] proxyGenericArguments = proxy.GetGenericArguments();

From 43ad219b75740ef71ad9bad496b00c076182619b Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Wed, 9 Feb 2022 20:07:01 +0100
Subject: [PATCH 415/856] support proxying return values in API proxies

---
 .../Reflection/InterfaceProxyBuilder.cs       | 183 ++++++++++++++----
 .../Reflection/InterfaceProxyFactory.cs       |  30 ++-
 .../Reflection/InterfaceProxyGlue.cs          |  18 ++
 3 files changed, 186 insertions(+), 45 deletions(-)
 create mode 100644 src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 5ae96dff..d8b066bd 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -1,13 +1,22 @@
 using System;
+using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
 using System.Reflection.Emit;
+using HarmonyLib;
 
 namespace StardewModdingAPI.Framework.Reflection
 {
     /// <summary>Generates a proxy class to access a mod API through an arbitrary interface.</summary>
     internal class InterfaceProxyBuilder
     {
+        /*********
+        ** Consts
+        *********/
+        private static readonly string TargetFieldName = "__Target";
+        private static readonly string GlueFieldName = "__Glue";
+        private static readonly MethodInfo CreateInstanceForProxyTypeNameMethod = typeof(InterfaceProxyGlue).GetMethod(nameof(InterfaceProxyGlue.CreateInstanceForProxyTypeName), new Type[] { typeof(string), typeof(object) });
+
         /*********
         ** Fields
         *********/
@@ -22,11 +31,14 @@ namespace StardewModdingAPI.Framework.Reflection
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
         /// <param name="name">The type name to generate.</param>
         /// <param name="moduleBuilder">The CLR module in which to create proxy classes.</param>
         /// <param name="interfaceType">The interface type to implement.</param>
         /// <param name="targetType">The target type.</param>
-        public InterfaceProxyBuilder(string name, ModuleBuilder moduleBuilder, Type interfaceType, Type targetType)
+        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
+        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
+        public InterfaceProxyBuilder(InterfaceProxyFactory factory, string name, ModuleBuilder moduleBuilder, Type interfaceType, Type targetType, string sourceModID, string targetModID)
         {
             // validate
             if (name == null)
@@ -38,12 +50,13 @@ namespace StardewModdingAPI.Framework.Reflection
             TypeBuilder proxyBuilder = moduleBuilder.DefineType(name, TypeAttributes.Public | TypeAttributes.Class);
             proxyBuilder.AddInterfaceImplementation(interfaceType);
 
-            // create field to store target instance
-            FieldBuilder targetField = proxyBuilder.DefineField("__Target", targetType, FieldAttributes.Private);
+            // create fields to store target instance and proxy factory
+            FieldBuilder targetField = proxyBuilder.DefineField(TargetFieldName, targetType, FieldAttributes.Private);
+            FieldBuilder glueField = proxyBuilder.DefineField(GlueFieldName, typeof(InterfaceProxyGlue), FieldAttributes.Private);
 
-            // create constructor which accepts target instance and sets field
+            // create constructor which accepts target instance + factory, and sets fields
             {
-                ConstructorBuilder constructor = proxyBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard | CallingConventions.HasThis, new[] { targetType });
+                ConstructorBuilder constructor = proxyBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard | CallingConventions.HasThis, new[] { targetType, typeof(InterfaceProxyGlue) });
                 ILGenerator il = constructor.GetILGenerator();
 
                 il.Emit(OpCodes.Ldarg_0); // this
@@ -52,6 +65,9 @@ namespace StardewModdingAPI.Framework.Reflection
                 il.Emit(OpCodes.Ldarg_0);      // this
                 il.Emit(OpCodes.Ldarg_1);      // load argument
                 il.Emit(OpCodes.Stfld, targetField); // set field to loaded argument
+                il.Emit(OpCodes.Ldarg_0);      // this
+                il.Emit(OpCodes.Ldarg_2);      // load argument
+                il.Emit(OpCodes.Stfld, glueField); // set field to loaded argument
                 il.Emit(OpCodes.Ret);
             }
 
@@ -65,15 +81,20 @@ namespace StardewModdingAPI.Framework.Reflection
                 }
             }
 
-            bool AreTypesMatching(Type targetType, Type proxyType, MethodTypeMatchingPart part)
+            MatchingTypesResult AreTypesMatching(Type targetType, Type proxyType, MethodTypeMatchingPart part)
             {
                 var typeA = part == MethodTypeMatchingPart.Parameter ? targetType : proxyType;
                 var typeB = part == MethodTypeMatchingPart.Parameter ? proxyType : targetType;
 
                 if (typeA.IsGenericMethodParameter != typeB.IsGenericMethodParameter)
-                    return false;
+                    return MatchingTypesResult.False;
                 // TODO: decide if "assignable" checking is desired (instead of just 1:1 type equality)
-                return typeA.IsGenericMethodParameter ? typeA.GenericParameterPosition == typeB.GenericParameterPosition : typeA.IsAssignableFrom(typeB);
+                if (typeA.IsGenericMethodParameter ? typeA.GenericParameterPosition == typeB.GenericParameterPosition : typeA.IsAssignableFrom(typeB))
+                    return MatchingTypesResult.True;
+
+                if (!proxyType.IsGenericMethodParameter && proxyType.IsInterface && proxyType.Assembly == interfaceType.Assembly)
+                    return MatchingTypesResult.IfProxied;
+                return MatchingTypesResult.False;
             }
 
             // proxy methods
@@ -81,30 +102,61 @@ namespace StardewModdingAPI.Framework.Reflection
             {
                 var proxyMethodParameters = proxyMethod.GetParameters();
                 var proxyMethodGenericArguments = proxyMethod.GetGenericArguments();
-                var targetMethod = allTargetMethods.Where(m =>
+
+                foreach (MethodInfo targetMethod in allTargetMethods)
                 {
-                    if (m.Name != proxyMethod.Name)
-                        return false;
+                    // checking if `targetMethod` matches `proxyMethod`
 
-                    if (m.GetGenericArguments().Length != proxyMethodGenericArguments.Length)
-                        return false;
-                    if (!AreTypesMatching(m.ReturnType, proxyMethod.ReturnType, MethodTypeMatchingPart.ReturnType))
-                        return false;
+                    if (targetMethod.Name != proxyMethod.Name)
+                        continue;
+                    if (targetMethod.GetGenericArguments().Length != proxyMethodGenericArguments.Length)
+                        continue;
+                    var positionsToProxy = new HashSet<int?>(); // null = return type; anything else = parameter position
 
-                    var mParameters = m.GetParameters();
-                    if (m.GetParameters().Length != proxyMethodParameters.Length)
-                        return false;
+                    switch (AreTypesMatching(targetMethod.ReturnType, proxyMethod.ReturnType, MethodTypeMatchingPart.ReturnType))
+                    {
+                        case MatchingTypesResult.False:
+                            continue;
+                        case MatchingTypesResult.True:
+                            break;
+                        case MatchingTypesResult.IfProxied:
+                            positionsToProxy.Add(null);
+                            break;
+                    }
+
+                    var mParameters = targetMethod.GetParameters();
+                    if (mParameters.Length != proxyMethodParameters.Length)
+                        continue;
                     for (int i = 0; i < mParameters.Length; i++)
                     {
-                        if (!AreTypesMatching(mParameters[i].ParameterType, proxyMethodParameters[i].ParameterType, MethodTypeMatchingPart.Parameter))
-                            return false;
+                        switch (AreTypesMatching(mParameters[i].ParameterType, proxyMethodParameters[i].ParameterType, MethodTypeMatchingPart.Parameter))
+                        {
+                            case MatchingTypesResult.False:
+                                goto targetMethodLoopContinue;
+                            case MatchingTypesResult.True:
+                                break;
+                            case MatchingTypesResult.IfProxied:
+                                if (proxyMethodParameters[i].IsOut)
+                                {
+                                    positionsToProxy.Add(i);
+                                    break;
+                                }
+                                else
+                                {
+                                    goto targetMethodLoopContinue;
+                                }
+                        }
                     }
-                    return true;
-                }).FirstOrDefault();
-                if (targetMethod == null)
-                    throw new InvalidOperationException($"The {interfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
 
-                this.ProxyMethod(proxyBuilder, proxyMethod, targetMethod, targetField);
+                    // method matched; proxying
+
+                    this.ProxyMethod(factory, proxyBuilder, proxyMethod, targetMethod, targetField, glueField, positionsToProxy, sourceModID, targetModID);
+                    goto proxyMethodLoopContinue;
+                    targetMethodLoopContinue:;
+                }
+
+                throw new InvalidOperationException($"The {interfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
+                proxyMethodLoopContinue:;
             }
 
             // save info
@@ -114,12 +166,13 @@ namespace StardewModdingAPI.Framework.Reflection
 
         /// <summary>Create an instance of the proxy for a target instance.</summary>
         /// <param name="targetInstance">The target instance.</param>
-        public object CreateInstance(object targetInstance)
+        /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
+        public object CreateInstance(object targetInstance, InterfaceProxyFactory factory)
         {
-            ConstructorInfo constructor = this.ProxyType.GetConstructor(new[] { this.TargetType });
+            ConstructorInfo constructor = this.ProxyType.GetConstructor(new[] { this.TargetType, typeof(InterfaceProxyGlue) });
             if (constructor == null)
                 throw new InvalidOperationException($"Couldn't find the constructor for generated proxy type '{this.ProxyType.Name}'."); // should never happen
-            return constructor.Invoke(new[] { targetInstance });
+            return constructor.Invoke(new[] { targetInstance, new InterfaceProxyGlue(factory) });
         }
 
 
@@ -127,11 +180,16 @@ namespace StardewModdingAPI.Framework.Reflection
         ** Private methods
         *********/
         /// <summary>Define a method which proxies access to a method on the target.</summary>
+        /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
         /// <param name="proxyBuilder">The proxy type being generated.</param>
         /// <param name="proxy">The proxy method.</param>
         /// <param name="target">The target method.</param>
         /// <param name="instanceField">The proxy field containing the API instance.</param>
-        private void ProxyMethod(TypeBuilder proxyBuilder, MethodInfo proxy, MethodInfo target, FieldBuilder instanceField)
+        /// <param name="glueField">The proxy field containing an <see cref="InterfaceProxyGlue"/>.</param>
+        /// <param name="positionsToProxy">Parameter type positions (or null for the return type) for which types should also be proxied.</param>
+        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
+        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
+        private void ProxyMethod(InterfaceProxyFactory factory, TypeBuilder proxyBuilder, MethodInfo proxy, MethodInfo target, FieldBuilder instanceField, FieldBuilder glueField, ISet<int?> positionsToProxy, string sourceModID, string targetModID)
         {
             MethodBuilder methodBuilder = proxyBuilder.DefineMethod(proxy.Name, MethodAttributes.Public | MethodAttributes.Final | MethodAttributes.Virtual);
 
@@ -143,7 +201,8 @@ namespace StardewModdingAPI.Framework.Reflection
                 genericTypeParameterBuilders[i].SetGenericParameterAttributes(proxyGenericArguments[i].GenericParameterAttributes);
 
             // set up return type
-            methodBuilder.SetReturnType(proxy.ReturnType.IsGenericMethodParameter ? genericTypeParameterBuilders[proxy.ReturnType.GenericParameterPosition] : proxy.ReturnType);
+            Type returnType = proxy.ReturnType.IsGenericMethodParameter ? genericTypeParameterBuilders[proxy.ReturnType.GenericParameterPosition] : proxy.ReturnType;
+            methodBuilder.SetReturnType(returnType);
 
             // set up parameters
             Type[] argTypes = proxy.GetParameters()
@@ -152,18 +211,62 @@ namespace StardewModdingAPI.Framework.Reflection
                 .ToArray();
             methodBuilder.SetParameters(argTypes);
 
+            // proxy additional types
+            string returnValueProxyTypeName = null;
+            string[] parameterProxyTypeNames = new string[argTypes.Length];
+            if (positionsToProxy.Count > 0)
+            {
+                var targetParameters = target.GetParameters();
+                foreach (int? position in positionsToProxy)
+                {
+                    // we don't check for generics here, because earlier code does and generic positions won't end up here
+                    if (position == null) // it's the return type
+                    {
+                        var builder = factory.ObtainBuilder(target.ReturnType, proxy.ReturnType, sourceModID, targetModID);
+                        returnType = proxy.ReturnType;
+                        returnValueProxyTypeName = builder.ProxyType.FullName;
+                    }
+                    else // it's one of the parameters
+                    {
+                        var builder = factory.ObtainBuilder(targetParameters[position.Value].ParameterType, argTypes[position.Value], sourceModID, targetModID);
+                        argTypes[position.Value] = proxy.ReturnType;
+                        parameterProxyTypeNames[position.Value] = builder.ProxyType.FullName;
+                    }
+                }
+
+                methodBuilder.SetReturnType(returnType);
+                methodBuilder.SetParameters(argTypes);
+            }
+
             // create method body
             {
                 ILGenerator il = methodBuilder.GetILGenerator();
 
-                // load target instance
-                il.Emit(OpCodes.Ldarg_0);
-                il.Emit(OpCodes.Ldfld, instanceField);
+                void EmitCallInstance()
+                {
+                    // load target instance
+                    il.Emit(OpCodes.Ldarg_0);
+                    il.Emit(OpCodes.Ldfld, instanceField);
 
-                // invoke target method on instance
-                for (int i = 0; i < argTypes.Length; i++)
-                    il.Emit(OpCodes.Ldarg, i + 1);
-                il.Emit(OpCodes.Call, target);
+                    // invoke target method on instance
+                    for (int i = 0; i < argTypes.Length; i++)
+                        il.Emit(OpCodes.Ldarg, i + 1);
+                    il.Emit(OpCodes.Callvirt, target);
+                }
+
+                if (returnValueProxyTypeName == null)
+                {
+                    EmitCallInstance();
+                }
+                else
+                {
+                    // this.Glue.CreateInstanceForProxyTypeName(proxyTypeName, this.Instance.Call(args))
+                    il.Emit(OpCodes.Ldarg_0);
+                    il.Emit(OpCodes.Ldfld, glueField);
+                    il.Emit(OpCodes.Ldstr, returnValueProxyTypeName);
+                    EmitCallInstance();
+                    il.Emit(OpCodes.Call, CreateInstanceForProxyTypeNameMethod);
+                }
 
                 // return result
                 il.Emit(OpCodes.Ret);
@@ -175,5 +278,11 @@ namespace StardewModdingAPI.Framework.Reflection
         {
             ReturnType, Parameter
         }
+
+        /// <summary>The result of matching a target and a proxy type.</summary>
+        private enum MatchingTypesResult
+        {
+            False, IfProxied, True
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index 5acba569..8ce187bf 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -35,26 +35,40 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <param name="targetModID">The unique ID of the mod providing the API.</param>
         public TInterface CreateProxy<TInterface>(object instance, string sourceModID, string targetModID)
             where TInterface : class
+        {
+            // validate
+            if (instance == null)
+                throw new InvalidOperationException("Can't proxy access to a null API.");
+
+            // create instance
+            InterfaceProxyBuilder builder = this.ObtainBuilder(instance.GetType(), typeof(TInterface), sourceModID, targetModID);
+            return (TInterface)builder.CreateInstance(instance, this);
+        }
+
+        internal InterfaceProxyBuilder ObtainBuilder(Type targetType, Type interfaceType, string sourceModID, string targetModID)
         {
             lock (this.Builders)
             {
                 // validate
-                if (instance == null)
-                    throw new InvalidOperationException("Can't proxy access to a null API.");
-                if (!typeof(TInterface).IsInterface)
+                if (!interfaceType.IsInterface)
                     throw new InvalidOperationException("The proxy type must be an interface, not a class.");
 
                 // get proxy type
-                Type targetType = instance.GetType();
-                string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{typeof(TInterface).FullName}>_To<{targetModID}_{targetType.FullName}>";
+                string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{interfaceType.FullName}>_To<{targetModID}_{targetType.FullName}>";
                 if (!this.Builders.TryGetValue(proxyTypeName, out InterfaceProxyBuilder builder))
                 {
-                    builder = new InterfaceProxyBuilder(proxyTypeName, this.ModuleBuilder, typeof(TInterface), targetType);
+                    builder = new InterfaceProxyBuilder(this, proxyTypeName, this.ModuleBuilder, interfaceType, targetType, sourceModID, targetModID);
                     this.Builders[proxyTypeName] = builder;
                 }
+                return builder;
+            }
+        }
 
-                // create instance
-                return (TInterface)builder.CreateInstance(instance);
+        internal InterfaceProxyBuilder GetBuilderByProxyTypeName(string proxyTypeName)
+        {
+            lock (this.Builders)
+            {
+                return this.Builders.TryGetValue(proxyTypeName, out InterfaceProxyBuilder builder) ? builder : null;
             }
         }
     }
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
new file mode 100644
index 00000000..4e027252
--- /dev/null
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
@@ -0,0 +1,18 @@
+namespace StardewModdingAPI.Framework.Reflection
+{
+    public sealed class InterfaceProxyGlue
+    {
+        private readonly InterfaceProxyFactory Factory;
+
+        internal InterfaceProxyGlue(InterfaceProxyFactory factory)
+        {
+            this.Factory = factory;
+        }
+
+        public object CreateInstanceForProxyTypeName(string proxyTypeName, object toProxy)
+        {
+            var builder = this.Factory.GetBuilderByProxyTypeName(proxyTypeName);
+            return builder.CreateInstance(toProxy, this.Factory);
+        }
+    }
+}

From ee78ab3c3710639ec7eecb3d2edc7f26ff998407 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Wed, 9 Feb 2022 20:38:14 +0100
Subject: [PATCH 416/856] fix stack overflow for proxied types referencing each
 other

---
 .../Reflection/InterfaceProxyBuilder.cs       | 45 ++++++++++---------
 .../Reflection/InterfaceProxyFactory.cs       | 11 ++++-
 2 files changed, 35 insertions(+), 21 deletions(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index d8b066bd..99aea75c 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -23,40 +23,46 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <summary>The target class type.</summary>
         private readonly Type TargetType;
 
+        /// <summary>The full name of the generated proxy type.</summary>
+        private readonly string ProxyTypeName;
+
         /// <summary>The generated proxy type.</summary>
-        private readonly Type ProxyType;
+        private Type ProxyType;
 
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
-        /// <param name="name">The type name to generate.</param>
-        /// <param name="moduleBuilder">The CLR module in which to create proxy classes.</param>
-        /// <param name="interfaceType">The interface type to implement.</param>
         /// <param name="targetType">The target type.</param>
-        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
-        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
-        public InterfaceProxyBuilder(InterfaceProxyFactory factory, string name, ModuleBuilder moduleBuilder, Type interfaceType, Type targetType, string sourceModID, string targetModID)
+        /// <param name="proxyTypeName">The type name to generate.</param>
+        public InterfaceProxyBuilder(Type targetType, string proxyTypeName)
         {
             // validate
-            if (name == null)
-                throw new ArgumentNullException(nameof(name));
-            if (targetType == null)
-                throw new ArgumentNullException(nameof(targetType));
+            this.TargetType = targetType ?? throw new ArgumentNullException(nameof(targetType));
+            this.ProxyTypeName = proxyTypeName ?? throw new ArgumentNullException(nameof(proxyTypeName));
+        }
 
+
+        /// <summary>Creates and sets up the proxy type.</summary>
+        /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
+        /// <param name="moduleBuilder">The CLR module in which to create proxy classes.</param>
+        /// <param name="interfaceType">The interface type to implement.</param>
+        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
+        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
+        public void SetupProxyType(InterfaceProxyFactory factory, ModuleBuilder moduleBuilder, Type interfaceType, string sourceModID, string targetModID)
+        {
             // define proxy type
-            TypeBuilder proxyBuilder = moduleBuilder.DefineType(name, TypeAttributes.Public | TypeAttributes.Class);
+            TypeBuilder proxyBuilder = moduleBuilder.DefineType(this.ProxyTypeName, TypeAttributes.Public | TypeAttributes.Class);
             proxyBuilder.AddInterfaceImplementation(interfaceType);
 
             // create fields to store target instance and proxy factory
-            FieldBuilder targetField = proxyBuilder.DefineField(TargetFieldName, targetType, FieldAttributes.Private);
+            FieldBuilder targetField = proxyBuilder.DefineField(TargetFieldName, this.TargetType, FieldAttributes.Private);
             FieldBuilder glueField = proxyBuilder.DefineField(GlueFieldName, typeof(InterfaceProxyGlue), FieldAttributes.Private);
 
             // create constructor which accepts target instance + factory, and sets fields
             {
-                ConstructorBuilder constructor = proxyBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard | CallingConventions.HasThis, new[] { targetType, typeof(InterfaceProxyGlue) });
+                ConstructorBuilder constructor = proxyBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard | CallingConventions.HasThis, new[] { this.TargetType, typeof(InterfaceProxyGlue) });
                 ILGenerator il = constructor.GetILGenerator();
 
                 il.Emit(OpCodes.Ldarg_0); // this
@@ -71,8 +77,8 @@ namespace StardewModdingAPI.Framework.Reflection
                 il.Emit(OpCodes.Ret);
             }
 
-            var allTargetMethods = targetType.GetMethods().ToList();
-            foreach (Type targetInterface in targetType.GetInterfaces())
+            var allTargetMethods = this.TargetType.GetMethods().ToList();
+            foreach (Type targetInterface in this.TargetType.GetInterfaces())
             {
                 foreach (MethodInfo targetMethod in targetInterface.GetMethods())
                 {
@@ -160,7 +166,6 @@ namespace StardewModdingAPI.Framework.Reflection
             }
 
             // save info
-            this.TargetType = targetType;
             this.ProxyType = proxyBuilder.CreateType();
         }
 
@@ -224,13 +229,13 @@ namespace StardewModdingAPI.Framework.Reflection
                     {
                         var builder = factory.ObtainBuilder(target.ReturnType, proxy.ReturnType, sourceModID, targetModID);
                         returnType = proxy.ReturnType;
-                        returnValueProxyTypeName = builder.ProxyType.FullName;
+                        returnValueProxyTypeName = builder.ProxyTypeName;
                     }
                     else // it's one of the parameters
                     {
                         var builder = factory.ObtainBuilder(targetParameters[position.Value].ParameterType, argTypes[position.Value], sourceModID, targetModID);
                         argTypes[position.Value] = proxy.ReturnType;
-                        parameterProxyTypeNames[position.Value] = builder.ProxyType.FullName;
+                        parameterProxyTypeNames[position.Value] = builder.ProxyTypeName;
                     }
                 }
 
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index 8ce187bf..72b4254c 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -57,8 +57,17 @@ namespace StardewModdingAPI.Framework.Reflection
                 string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{interfaceType.FullName}>_To<{targetModID}_{targetType.FullName}>";
                 if (!this.Builders.TryGetValue(proxyTypeName, out InterfaceProxyBuilder builder))
                 {
-                    builder = new InterfaceProxyBuilder(this, proxyTypeName, this.ModuleBuilder, interfaceType, targetType, sourceModID, targetModID);
+                    builder = new InterfaceProxyBuilder(targetType, proxyTypeName);
                     this.Builders[proxyTypeName] = builder;
+                    try
+                    {
+                        builder.SetupProxyType(this, this.ModuleBuilder, interfaceType, sourceModID, targetModID);
+                    }
+                    catch
+                    {
+                        this.Builders.Remove(proxyTypeName);
+                        throw;
+                    }
                 }
                 return builder;
             }

From 688fccc0246be6756a07933696a235dca8f1a395 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Wed, 9 Feb 2022 20:40:54 +0100
Subject: [PATCH 417/856] add missing documentation

---
 src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
index 4e027252..8d0d74a7 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
@@ -1,5 +1,6 @@
 namespace StardewModdingAPI.Framework.Reflection
 {
+    /// <summary>Provides an interface for proxied types to create other proxied types.</summary>
     public sealed class InterfaceProxyGlue
     {
         private readonly InterfaceProxyFactory Factory;
@@ -9,6 +10,9 @@ namespace StardewModdingAPI.Framework.Reflection
             this.Factory = factory;
         }
 
+        /// <summary>Creates a new proxied instance by its type name.</summary>
+        /// <param name="proxyTypeName">The full name of the proxy type.</param>
+        /// <param name="toProxy">The target instance to proxy.</param>
         public object CreateInstanceForProxyTypeName(string proxyTypeName, object toProxy)
         {
             var builder = this.Factory.GetBuilderByProxyTypeName(proxyTypeName);

From 354527bb810d06f69f2a8c45d1a23f294d228caf Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Wed, 9 Feb 2022 21:02:41 +0100
Subject: [PATCH 418/856] stop proxying nulls

---
 .../Reflection/InterfaceProxyBuilder.cs          | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 99aea75c..1b6bf1d6 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -265,12 +265,24 @@ namespace StardewModdingAPI.Framework.Reflection
                 }
                 else
                 {
-                    // this.Glue.CreateInstanceForProxyTypeName(proxyTypeName, this.Instance.Call(args))
+                    var resultLocal = il.DeclareLocal(typeof(object)); // we store both unmodified and modified in here
+                    EmitCallInstance();
+                    il.Emit(OpCodes.Stloc, resultLocal);
+
+                    // if (unmodifiedResultLocal == null) jump
+                    var isNullLabel = il.DefineLabel();
+                    il.Emit(OpCodes.Ldloc, resultLocal);
+                    il.Emit(OpCodes.Brfalse, isNullLabel);
+
                     il.Emit(OpCodes.Ldarg_0);
                     il.Emit(OpCodes.Ldfld, glueField);
                     il.Emit(OpCodes.Ldstr, returnValueProxyTypeName);
-                    EmitCallInstance();
+                    il.Emit(OpCodes.Ldloc, resultLocal);
                     il.Emit(OpCodes.Call, CreateInstanceForProxyTypeNameMethod);
+                    il.Emit(OpCodes.Stloc, resultLocal);
+
+                    il.MarkLabel(isNullLabel);
+                    il.Emit(OpCodes.Ldloc, resultLocal);
                 }
 
                 // return result

From d9599a3a0af500438fa71addb1a25d4608aefda5 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Wed, 9 Feb 2022 21:10:20 +0100
Subject: [PATCH 419/856] simplifies proxy method IL a bit

---
 .../Reflection/InterfaceProxyBuilder.cs       | 30 ++++++-------------
 1 file changed, 9 insertions(+), 21 deletions(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 1b6bf1d6..5e0dd838 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -247,28 +247,16 @@ namespace StardewModdingAPI.Framework.Reflection
             {
                 ILGenerator il = methodBuilder.GetILGenerator();
 
-                void EmitCallInstance()
-                {
-                    // load target instance
-                    il.Emit(OpCodes.Ldarg_0);
-                    il.Emit(OpCodes.Ldfld, instanceField);
+                var resultLocal = il.DeclareLocal(typeof(object)); // we store both unmodified and modified in here, hence `object`
+                il.Emit(OpCodes.Ldarg_0);
+                il.Emit(OpCodes.Ldfld, instanceField);
+                for (int i = 0; i < argTypes.Length; i++)
+                    il.Emit(OpCodes.Ldarg, i + 1);
+                il.Emit(OpCodes.Callvirt, target);
+                il.Emit(OpCodes.Stloc, resultLocal);
 
-                    // invoke target method on instance
-                    for (int i = 0; i < argTypes.Length; i++)
-                        il.Emit(OpCodes.Ldarg, i + 1);
-                    il.Emit(OpCodes.Callvirt, target);
-                }
-
-                if (returnValueProxyTypeName == null)
+                if (returnValueProxyTypeName != null)
                 {
-                    EmitCallInstance();
-                }
-                else
-                {
-                    var resultLocal = il.DeclareLocal(typeof(object)); // we store both unmodified and modified in here
-                    EmitCallInstance();
-                    il.Emit(OpCodes.Stloc, resultLocal);
-
                     // if (unmodifiedResultLocal == null) jump
                     var isNullLabel = il.DefineLabel();
                     il.Emit(OpCodes.Ldloc, resultLocal);
@@ -282,10 +270,10 @@ namespace StardewModdingAPI.Framework.Reflection
                     il.Emit(OpCodes.Stloc, resultLocal);
 
                     il.MarkLabel(isNullLabel);
-                    il.Emit(OpCodes.Ldloc, resultLocal);
                 }
 
                 // return result
+                il.Emit(OpCodes.Ldloc, resultLocal);
                 il.Emit(OpCodes.Ret);
             }
         }

From f920ed59d6234df9d33b0d72ea0398a3fa8e9b8b Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Wed, 9 Feb 2022 23:26:26 +0100
Subject: [PATCH 420/856] add WIP proxying of methods with `out` parameters

---
 .../Reflection/InterfaceProxyBuilder.cs       | 66 ++++++++++++++++---
 1 file changed, 56 insertions(+), 10 deletions(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 5e0dd838..b1b3c451 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -98,7 +98,7 @@ namespace StardewModdingAPI.Framework.Reflection
                 if (typeA.IsGenericMethodParameter ? typeA.GenericParameterPosition == typeB.GenericParameterPosition : typeA.IsAssignableFrom(typeB))
                     return MatchingTypesResult.True;
 
-                if (!proxyType.IsGenericMethodParameter && proxyType.IsInterface && proxyType.Assembly == interfaceType.Assembly)
+                if (!proxyType.IsGenericMethodParameter && proxyType.GetNonRefType().IsInterface && proxyType.Assembly == interfaceType.Assembly)
                     return MatchingTypesResult.IfProxied;
                 return MatchingTypesResult.False;
             }
@@ -233,8 +233,15 @@ namespace StardewModdingAPI.Framework.Reflection
                     }
                     else // it's one of the parameters
                     {
-                        var builder = factory.ObtainBuilder(targetParameters[position.Value].ParameterType, argTypes[position.Value], sourceModID, targetModID);
-                        argTypes[position.Value] = proxy.ReturnType;
+                        bool isByRef = argTypes[position.Value].IsByRef;
+                        var targetType = targetParameters[position.Value].ParameterType.GetNonRefType();
+                        var argType = argTypes[position.Value].GetNonRefType();
+
+                        var builder = factory.ObtainBuilder(targetType, argType, sourceModID, targetModID);
+                        if (isByRef)
+                            argType = argType.MakeByRefType();
+
+                        argTypes[position.Value] = argType;
                         parameterProxyTypeNames[position.Value] = builder.ProxyTypeName;
                     }
                 }
@@ -246,32 +253,63 @@ namespace StardewModdingAPI.Framework.Reflection
             // create method body
             {
                 ILGenerator il = methodBuilder.GetILGenerator();
+                LocalBuilder[] outLocals = new LocalBuilder[argTypes.Length];
 
+                // calling the proxied method
                 var resultLocal = il.DeclareLocal(typeof(object)); // we store both unmodified and modified in here, hence `object`
                 il.Emit(OpCodes.Ldarg_0);
                 il.Emit(OpCodes.Ldfld, instanceField);
                 for (int i = 0; i < argTypes.Length; i++)
-                    il.Emit(OpCodes.Ldarg, i + 1);
+                {
+                    if (parameterProxyTypeNames[i] == null)
+                    {
+                        il.Emit(OpCodes.Ldarg, i + 1);
+                    }
+                    else
+                    {
+                        // previous code already checks if the parameters are specifically `out`
+                        outLocals[i] = il.DeclareLocal(typeof(object)); // we store both unmodified and modified in here, hence `object`
+                        il.Emit(OpCodes.Ldloca_S, outLocals[i]);
+                    }
+                }
                 il.Emit(OpCodes.Callvirt, target);
                 il.Emit(OpCodes.Stloc, resultLocal);
 
-                if (returnValueProxyTypeName != null)
+                void ProxyNonNullIfNeeded(LocalBuilder local, string proxyTypeName)
                 {
-                    // if (unmodifiedResultLocal == null) jump
+                    if (proxyTypeName == null)
+                        return;
+
                     var isNullLabel = il.DefineLabel();
-                    il.Emit(OpCodes.Ldloc, resultLocal);
+                    il.Emit(OpCodes.Ldloc, local);
                     il.Emit(OpCodes.Brfalse, isNullLabel);
 
                     il.Emit(OpCodes.Ldarg_0);
                     il.Emit(OpCodes.Ldfld, glueField);
-                    il.Emit(OpCodes.Ldstr, returnValueProxyTypeName);
-                    il.Emit(OpCodes.Ldloc, resultLocal);
+                    il.Emit(OpCodes.Ldstr, proxyTypeName);
+                    il.Emit(OpCodes.Ldloc, local);
                     il.Emit(OpCodes.Call, CreateInstanceForProxyTypeNameMethod);
-                    il.Emit(OpCodes.Stloc, resultLocal);
+                    il.Emit(OpCodes.Stloc, local);
 
                     il.MarkLabel(isNullLabel);
                 }
 
+                // proxying `out` parameters
+                for (int i = 0; i < argTypes.Length; i++)
+                {
+                    if (parameterProxyTypeNames[i] == null)
+                        continue;
+                    // previous code already checks if the parameters are specifically `out`
+
+                    ProxyNonNullIfNeeded(outLocals[i], parameterProxyTypeNames[i]);
+                    il.Emit(OpCodes.Ldarg, i + 1);
+                    il.Emit(OpCodes.Ldloc, outLocals[i]);
+                    il.Emit(OpCodes.Stind_Ref);
+                }
+
+                // proxying return value
+                ProxyNonNullIfNeeded(resultLocal, returnValueProxyTypeName);
+
                 // return result
                 il.Emit(OpCodes.Ldloc, resultLocal);
                 il.Emit(OpCodes.Ret);
@@ -290,4 +328,12 @@ namespace StardewModdingAPI.Framework.Reflection
             False, IfProxied, True
         }
     }
+
+    internal static class TypeExtensions
+    {
+        internal static Type GetNonRefType(this Type type)
+        {
+            return type.IsByRef ? type.GetElementType() : type;
+        }
+    }
 }

From 51b7b9fe06d91d59461f9b9d6d3c1b1c736dc34d Mon Sep 17 00:00:00 2001
From: Ameisen <14104310+ameisen@users.noreply.github.com>
Date: Wed, 9 Feb 2022 18:00:15 -0600
Subject: [PATCH 421/856] Cleanup and performance/allocation improvement for
 AssetDataForImage.PatchImage

---
 .../Framework/Content/AssetDataForImage.cs    | 28 +++++++++----------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 529fb93a..c75514bc 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -41,39 +41,40 @@ namespace StardewModdingAPI.Framework.Content
             targetArea ??= new Rectangle(0, 0, Math.Min(sourceArea.Value.Width, target.Width), Math.Min(sourceArea.Value.Height, target.Height));
 
             // validate
-            if (sourceArea.Value.X < 0 || sourceArea.Value.Y < 0 || sourceArea.Value.Right > source.Width || sourceArea.Value.Bottom > source.Height)
+            if (!source.Bounds.Contains(sourceArea.Value))
                 throw new ArgumentOutOfRangeException(nameof(sourceArea), "The source area is outside the bounds of the source texture.");
-            if (targetArea.Value.X < 0 || targetArea.Value.Y < 0 || targetArea.Value.Right > target.Width || targetArea.Value.Bottom > target.Height)
+            if (!target.Bounds.Contains(targetArea.Value))
                 throw new ArgumentOutOfRangeException(nameof(targetArea), "The target area is outside the bounds of the target texture.");
-            if (sourceArea.Value.Width != targetArea.Value.Width || sourceArea.Value.Height != targetArea.Value.Height)
+            if (sourceArea.Value.Size != targetArea.Value.Size)
                 throw new InvalidOperationException("The source and target areas must be the same size.");
 
             // get source data
             int pixelCount = sourceArea.Value.Width * sourceArea.Value.Height;
-            Color[] sourceData = new Color[pixelCount];
+            Color[] sourceData = GC.AllocateUninitializedArray<Color>(pixelCount);
             source.GetData(0, sourceArea, sourceData, 0, pixelCount);
 
             // merge data in overlay mode
             if (patchMode == PatchMode.Overlay)
             {
                 // get target data
-                Color[] targetData = new Color[pixelCount];
+                Color[] targetData = GC.AllocateUninitializedArray<Color>(pixelCount);
                 target.GetData(0, targetArea, targetData, 0, pixelCount);
 
                 // merge pixels
-                Color[] newData = new Color[targetArea.Value.Width * targetArea.Value.Height];
-                target.GetData(0, targetArea, newData, 0, newData.Length);
                 for (int i = 0; i < sourceData.Length; i++)
                 {
                     Color above = sourceData[i];
                     Color below = targetData[i];
 
                     // shortcut transparency
-                    if (above.A < AssetDataForImage.MinOpacity)
-                        continue;
-                    if (below.A < AssetDataForImage.MinOpacity)
+                    if (above.A < MinOpacity)
                     {
-                        newData[i] = above;
+                        sourceData[i] = below;
+                        continue;
+                    }
+                    if (below.A < MinOpacity)
+                    {
+                        sourceData[i] = above;
                         continue;
                     }
 
@@ -84,14 +85,13 @@ namespace StardewModdingAPI.Framework.Content
                     // Note: don't use named arguments here since they're different between
                     // Linux/macOS and Windows.
                     float alphaBelow = 1 - (above.A / 255f);
-                    newData[i] = new Color(
+                    sourceData[i] = new Color(
                         (int)(above.R + (below.R * alphaBelow)), // r
                         (int)(above.G + (below.G * alphaBelow)), // g
                         (int)(above.B + (below.B * alphaBelow)), // b
                         Math.Max(above.A, below.A) // a
                     );
                 }
-                sourceData = newData;
             }
 
             // patch target texture
@@ -105,7 +105,7 @@ namespace StardewModdingAPI.Framework.Content
                 return false;
 
             Texture2D original = this.Data;
-            Texture2D texture = new Texture2D(Game1.graphics.GraphicsDevice, Math.Max(original.Width, minWidth), Math.Max(original.Height, minHeight));
+            Texture2D texture = new(Game1.graphics.GraphicsDevice, Math.Max(original.Width, minWidth), Math.Max(original.Height, minHeight));
             this.ReplaceWith(texture);
             this.PatchImage(original);
             return true;

From 55723f91d270fa2623c25c0ca1decfa7e566b636 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Thu, 10 Feb 2022 10:08:14 +0100
Subject: [PATCH 422/856] implement `out` parameter proxying

---
 .../Reflection/InterfaceProxyBuilder.cs       | 46 ++++++++++++-------
 1 file changed, 29 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index b1b3c451..3c6d7c61 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -3,7 +3,6 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
 using System.Reflection.Emit;
-using HarmonyLib;
 
 namespace StardewModdingAPI.Framework.Reflection
 {
@@ -210,18 +209,17 @@ namespace StardewModdingAPI.Framework.Reflection
             methodBuilder.SetReturnType(returnType);
 
             // set up parameters
+            var targetParameters = target.GetParameters();
             Type[] argTypes = proxy.GetParameters()
                 .Select(a => a.ParameterType)
                 .Select(t => t.IsGenericMethodParameter ? genericTypeParameterBuilders[t.GenericParameterPosition] : t)
                 .ToArray();
-            methodBuilder.SetParameters(argTypes);
 
             // proxy additional types
             string returnValueProxyTypeName = null;
             string[] parameterProxyTypeNames = new string[argTypes.Length];
             if (positionsToProxy.Count > 0)
             {
-                var targetParameters = target.GetParameters();
                 foreach (int? position in positionsToProxy)
                 {
                     // we don't check for generics here, because earlier code does and generic positions won't end up here
@@ -247,16 +245,21 @@ namespace StardewModdingAPI.Framework.Reflection
                 }
 
                 methodBuilder.SetReturnType(returnType);
-                methodBuilder.SetParameters(argTypes);
             }
 
+            methodBuilder.SetParameters(argTypes);
+            for (int i = 0; i < argTypes.Length; i++)
+                methodBuilder.DefineParameter(i, targetParameters[i].Attributes, targetParameters[i].Name);
+
             // create method body
             {
                 ILGenerator il = methodBuilder.GetILGenerator();
-                LocalBuilder[] outLocals = new LocalBuilder[argTypes.Length];
+                LocalBuilder[] outInputLocals = new LocalBuilder[argTypes.Length];
+                LocalBuilder[] outOutputLocals = new LocalBuilder[argTypes.Length];
 
                 // calling the proxied method
-                var resultLocal = il.DeclareLocal(typeof(object)); // we store both unmodified and modified in here, hence `object`
+                LocalBuilder resultInputLocal = target.ReturnType == typeof(void) ? null : il.DeclareLocal(target.ReturnType);
+                LocalBuilder resultOutputLocal = returnType == typeof(void) ? null : il.DeclareLocal(returnType);
                 il.Emit(OpCodes.Ldarg_0);
                 il.Emit(OpCodes.Ldfld, instanceField);
                 for (int i = 0; i < argTypes.Length; i++)
@@ -268,28 +271,35 @@ namespace StardewModdingAPI.Framework.Reflection
                     else
                     {
                         // previous code already checks if the parameters are specifically `out`
-                        outLocals[i] = il.DeclareLocal(typeof(object)); // we store both unmodified and modified in here, hence `object`
-                        il.Emit(OpCodes.Ldloca_S, outLocals[i]);
+                        outInputLocals[i] = il.DeclareLocal(targetParameters[i].ParameterType.GetNonRefType());
+                        outOutputLocals[i] = il.DeclareLocal(argTypes[i].GetNonRefType());
+                        il.Emit(OpCodes.Ldloca, outInputLocals[i]);
                     }
                 }
                 il.Emit(OpCodes.Callvirt, target);
-                il.Emit(OpCodes.Stloc, resultLocal);
+                if (target.ReturnType != typeof(void))
+                    il.Emit(OpCodes.Stloc, resultInputLocal);
 
-                void ProxyNonNullIfNeeded(LocalBuilder local, string proxyTypeName)
+                void ProxyIfNeededAndStore(LocalBuilder inputLocal, LocalBuilder outputLocal, string proxyTypeName)
                 {
                     if (proxyTypeName == null)
+                    {
+                        il.Emit(OpCodes.Ldloc, inputLocal);
+                        il.Emit(OpCodes.Stloc, outputLocal);
                         return;
+                    }
 
                     var isNullLabel = il.DefineLabel();
-                    il.Emit(OpCodes.Ldloc, local);
+                    il.Emit(OpCodes.Ldloc, inputLocal);
                     il.Emit(OpCodes.Brfalse, isNullLabel);
 
                     il.Emit(OpCodes.Ldarg_0);
                     il.Emit(OpCodes.Ldfld, glueField);
                     il.Emit(OpCodes.Ldstr, proxyTypeName);
-                    il.Emit(OpCodes.Ldloc, local);
+                    il.Emit(OpCodes.Ldloc, inputLocal);
                     il.Emit(OpCodes.Call, CreateInstanceForProxyTypeNameMethod);
-                    il.Emit(OpCodes.Stloc, local);
+                    il.Emit(OpCodes.Castclass, outputLocal.LocalType);
+                    il.Emit(OpCodes.Stloc, outputLocal);
 
                     il.MarkLabel(isNullLabel);
                 }
@@ -301,17 +311,19 @@ namespace StardewModdingAPI.Framework.Reflection
                         continue;
                     // previous code already checks if the parameters are specifically `out`
 
-                    ProxyNonNullIfNeeded(outLocals[i], parameterProxyTypeNames[i]);
+                    ProxyIfNeededAndStore(outInputLocals[i], outOutputLocals[i], parameterProxyTypeNames[i]);
                     il.Emit(OpCodes.Ldarg, i + 1);
-                    il.Emit(OpCodes.Ldloc, outLocals[i]);
+                    il.Emit(OpCodes.Ldloc, outOutputLocals[i]);
                     il.Emit(OpCodes.Stind_Ref);
                 }
 
                 // proxying return value
-                ProxyNonNullIfNeeded(resultLocal, returnValueProxyTypeName);
+                if (target.ReturnType != typeof(void))
+                    ProxyIfNeededAndStore(resultInputLocal, resultOutputLocal, returnValueProxyTypeName);
 
                 // return result
-                il.Emit(OpCodes.Ldloc, resultLocal);
+                if (target.ReturnType != typeof(void))
+                    il.Emit(OpCodes.Ldloc, resultOutputLocal);
                 il.Emit(OpCodes.Ret);
             }
         }

From 955790842518d68ca5df21efe1beccc6069a35fe Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Thu, 10 Feb 2022 10:18:31 +0100
Subject: [PATCH 423/856] fix code style warning

---
 src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 3c6d7c61..9573c791 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -66,7 +66,7 @@ namespace StardewModdingAPI.Framework.Reflection
 
                 il.Emit(OpCodes.Ldarg_0); // this
                 // ReSharper disable once AssignNullToNotNullAttribute -- never null
-                il.Emit(OpCodes.Call, typeof(object).GetConstructor(new Type[0])); // call base constructor
+                il.Emit(OpCodes.Call, typeof(object).GetConstructor(Array.Empty<Type>())); // call base constructor
                 il.Emit(OpCodes.Ldarg_0);      // this
                 il.Emit(OpCodes.Ldarg_1);      // load argument
                 il.Emit(OpCodes.Stfld, targetField); // set field to loaded argument

From 61415e41eb8f5f61e8b241255162257191c0a766 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Thu, 10 Feb 2022 11:21:41 +0100
Subject: [PATCH 424/856] use Call/Callvirt depending on target

---
 src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 9573c791..49cc6bca 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -276,7 +276,7 @@ namespace StardewModdingAPI.Framework.Reflection
                         il.Emit(OpCodes.Ldloca, outInputLocals[i]);
                     }
                 }
-                il.Emit(OpCodes.Callvirt, target);
+                il.Emit(target.IsVirtual ? OpCodes.Callvirt : OpCodes.Call, target);
                 if (target.ReturnType != typeof(void))
                     il.Emit(OpCodes.Stloc, resultInputLocal);
 

From 07259452170a253c44d5c2be68fc2342a88d2504 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Thu, 10 Feb 2022 11:43:35 +0100
Subject: [PATCH 425/856] add proxy instance caching

---
 .../Reflection/InterfaceProxyBuilder.cs        | 18 +++++++++++++-----
 .../Reflection/InterfaceProxyFactory.cs        |  2 +-
 .../Framework/Reflection/InterfaceProxyGlue.cs |  6 +++---
 3 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 49cc6bca..63a594fa 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
 using System.Reflection.Emit;
+using System.Runtime.CompilerServices;
 
 namespace StardewModdingAPI.Framework.Reflection
 {
@@ -14,7 +15,7 @@ namespace StardewModdingAPI.Framework.Reflection
         *********/
         private static readonly string TargetFieldName = "__Target";
         private static readonly string GlueFieldName = "__Glue";
-        private static readonly MethodInfo CreateInstanceForProxyTypeNameMethod = typeof(InterfaceProxyGlue).GetMethod(nameof(InterfaceProxyGlue.CreateInstanceForProxyTypeName), new Type[] { typeof(string), typeof(object) });
+        private static readonly MethodInfo ObtainInstanceForProxyTypeNameMethod = typeof(InterfaceProxyGlue).GetMethod(nameof(InterfaceProxyGlue.ObtainInstanceForProxyTypeName), new Type[] { typeof(string), typeof(object) });
 
         /*********
         ** Fields
@@ -28,6 +29,8 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <summary>The generated proxy type.</summary>
         private Type ProxyType;
 
+        /// <summary>A cache of all proxies generated by this builder.</summary>
+        private readonly ConditionalWeakTable<object, object> ProxyCache = new();
 
         /*********
         ** Public methods
@@ -168,15 +171,20 @@ namespace StardewModdingAPI.Framework.Reflection
             this.ProxyType = proxyBuilder.CreateType();
         }
 
-        /// <summary>Create an instance of the proxy for a target instance.</summary>
+        /// <summary>Get an existing or create a new instance of the proxy for a target instance.</summary>
         /// <param name="targetInstance">The target instance.</param>
         /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
-        public object CreateInstance(object targetInstance, InterfaceProxyFactory factory)
+        public object ObtainInstance(object targetInstance, InterfaceProxyFactory factory)
         {
+            if (this.ProxyCache.TryGetValue(targetInstance, out object proxyInstance))
+                return proxyInstance;
+
             ConstructorInfo constructor = this.ProxyType.GetConstructor(new[] { this.TargetType, typeof(InterfaceProxyGlue) });
             if (constructor == null)
                 throw new InvalidOperationException($"Couldn't find the constructor for generated proxy type '{this.ProxyType.Name}'."); // should never happen
-            return constructor.Invoke(new[] { targetInstance, new InterfaceProxyGlue(factory) });
+            proxyInstance = constructor.Invoke(new[] { targetInstance, new InterfaceProxyGlue(factory) });
+            this.ProxyCache.Add(targetInstance, proxyInstance);
+            return proxyInstance;
         }
 
 
@@ -297,7 +305,7 @@ namespace StardewModdingAPI.Framework.Reflection
                     il.Emit(OpCodes.Ldfld, glueField);
                     il.Emit(OpCodes.Ldstr, proxyTypeName);
                     il.Emit(OpCodes.Ldloc, inputLocal);
-                    il.Emit(OpCodes.Call, CreateInstanceForProxyTypeNameMethod);
+                    il.Emit(OpCodes.Call, ObtainInstanceForProxyTypeNameMethod);
                     il.Emit(OpCodes.Castclass, outputLocal.LocalType);
                     il.Emit(OpCodes.Stloc, outputLocal);
 
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index 72b4254c..daeac2ad 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -42,7 +42,7 @@ namespace StardewModdingAPI.Framework.Reflection
 
             // create instance
             InterfaceProxyBuilder builder = this.ObtainBuilder(instance.GetType(), typeof(TInterface), sourceModID, targetModID);
-            return (TInterface)builder.CreateInstance(instance, this);
+            return (TInterface)builder.ObtainInstance(instance, this);
         }
 
         internal InterfaceProxyBuilder ObtainBuilder(Type targetType, Type interfaceType, string sourceModID, string targetModID)
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
index 8d0d74a7..f98b54a2 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
@@ -10,13 +10,13 @@ namespace StardewModdingAPI.Framework.Reflection
             this.Factory = factory;
         }
 
-        /// <summary>Creates a new proxied instance by its type name.</summary>
+        /// <summary>Get an existing or create a new proxied instance by its type name.</summary>
         /// <param name="proxyTypeName">The full name of the proxy type.</param>
         /// <param name="toProxy">The target instance to proxy.</param>
-        public object CreateInstanceForProxyTypeName(string proxyTypeName, object toProxy)
+        public object ObtainInstanceForProxyTypeName(string proxyTypeName, object toProxy)
         {
             var builder = this.Factory.GetBuilderByProxyTypeName(proxyTypeName);
-            return builder.CreateInstance(toProxy, this.Factory);
+            return builder.ObtainInstance(toProxy, this.Factory);
         }
     }
 }

From 467375a7a37f5ed3012d1786d3149a0dddd28871 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Thu, 10 Feb 2022 14:15:06 +0100
Subject: [PATCH 426/856] add reverse API proxying (and unproxying)

---
 .../Reflection/InterfaceProxyBuilder.cs       | 166 +++++++++++-------
 .../Reflection/InterfaceProxyFactory.cs       |   4 +-
 .../Reflection/InterfaceProxyGlue.cs          |  12 ++
 3 files changed, 120 insertions(+), 62 deletions(-)

diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
index 63a594fa..81cfff50 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
@@ -16,6 +16,7 @@ namespace StardewModdingAPI.Framework.Reflection
         private static readonly string TargetFieldName = "__Target";
         private static readonly string GlueFieldName = "__Glue";
         private static readonly MethodInfo ObtainInstanceForProxyTypeNameMethod = typeof(InterfaceProxyGlue).GetMethod(nameof(InterfaceProxyGlue.ObtainInstanceForProxyTypeName), new Type[] { typeof(string), typeof(object) });
+        private static readonly MethodInfo UnproxyOrObtainInstanceForProxyTypeNameMethod = typeof(InterfaceProxyGlue).GetMethod(nameof(InterfaceProxyGlue.UnproxyOrObtainInstanceForProxyTypeName), new Type[] { typeof(string), typeof(string), typeof(object) });
 
         /*********
         ** Fields
@@ -23,6 +24,9 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <summary>The target class type.</summary>
         private readonly Type TargetType;
 
+        /// <summary>The interfce type.</summary>
+        private readonly Type InterfaceType;
+
         /// <summary>The full name of the generated proxy type.</summary>
         private readonly string ProxyTypeName;
 
@@ -37,26 +41,29 @@ namespace StardewModdingAPI.Framework.Reflection
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="targetType">The target type.</param>
+        /// <param name="interfaceType">The interface type to implement.</param>
         /// <param name="proxyTypeName">The type name to generate.</param>
-        public InterfaceProxyBuilder(Type targetType, string proxyTypeName)
+        public InterfaceProxyBuilder(Type targetType, Type interfaceType, string proxyTypeName)
         {
-            // validate
+            // validate and store
             this.TargetType = targetType ?? throw new ArgumentNullException(nameof(targetType));
+            this.InterfaceType = interfaceType ?? throw new ArgumentNullException(nameof(interfaceType));
             this.ProxyTypeName = proxyTypeName ?? throw new ArgumentNullException(nameof(proxyTypeName));
+            if (!interfaceType.IsInterface)
+                throw new ArgumentException($"{nameof(interfaceType)} is not an interface.");
         }
 
 
         /// <summary>Creates and sets up the proxy type.</summary>
         /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
         /// <param name="moduleBuilder">The CLR module in which to create proxy classes.</param>
-        /// <param name="interfaceType">The interface type to implement.</param>
         /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
         /// <param name="targetModID">The unique ID of the mod providing the API.</param>
-        public void SetupProxyType(InterfaceProxyFactory factory, ModuleBuilder moduleBuilder, Type interfaceType, string sourceModID, string targetModID)
+        public void SetupProxyType(InterfaceProxyFactory factory, ModuleBuilder moduleBuilder, string sourceModID, string targetModID)
         {
             // define proxy type
             TypeBuilder proxyBuilder = moduleBuilder.DefineType(this.ProxyTypeName, TypeAttributes.Public | TypeAttributes.Class);
-            proxyBuilder.AddInterfaceImplementation(interfaceType);
+            proxyBuilder.AddInterfaceImplementation(this.InterfaceType);
 
             // create fields to store target instance and proxy factory
             FieldBuilder targetField = proxyBuilder.DefineField(TargetFieldName, this.TargetType, FieldAttributes.Private);
@@ -100,13 +107,19 @@ namespace StardewModdingAPI.Framework.Reflection
                 if (typeA.IsGenericMethodParameter ? typeA.GenericParameterPosition == typeB.GenericParameterPosition : typeA.IsAssignableFrom(typeB))
                     return MatchingTypesResult.True;
 
-                if (!proxyType.IsGenericMethodParameter && proxyType.GetNonRefType().IsInterface && proxyType.Assembly == interfaceType.Assembly)
-                    return MatchingTypesResult.IfProxied;
+                if (!proxyType.IsGenericMethodParameter)
+                {
+                    if (proxyType.GetNonRefType().IsInterface)
+                        return MatchingTypesResult.IfProxied;
+                    if (targetType.GetNonRefType().IsInterface)
+                        return MatchingTypesResult.IfProxied;
+                }
+
                 return MatchingTypesResult.False;
             }
 
             // proxy methods
-            foreach (MethodInfo proxyMethod in interfaceType.GetMethods())
+            foreach (MethodInfo proxyMethod in this.InterfaceType.GetMethods())
             {
                 var proxyMethodParameters = proxyMethod.GetParameters();
                 var proxyMethodGenericArguments = proxyMethod.GetGenericArguments();
@@ -144,15 +157,8 @@ namespace StardewModdingAPI.Framework.Reflection
                             case MatchingTypesResult.True:
                                 break;
                             case MatchingTypesResult.IfProxied:
-                                if (proxyMethodParameters[i].IsOut)
-                                {
-                                    positionsToProxy.Add(i);
-                                    break;
-                                }
-                                else
-                                {
-                                    goto targetMethodLoopContinue;
-                                }
+                                positionsToProxy.Add(i);
+                                break;
                         }
                     }
 
@@ -163,7 +169,7 @@ namespace StardewModdingAPI.Framework.Reflection
                     targetMethodLoopContinue:;
                 }
 
-                throw new InvalidOperationException($"The {interfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
+                throw new InvalidOperationException($"The {this.InterfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
                 proxyMethodLoopContinue:;
             }
 
@@ -225,7 +231,8 @@ namespace StardewModdingAPI.Framework.Reflection
 
             // proxy additional types
             string returnValueProxyTypeName = null;
-            string[] parameterProxyTypeNames = new string[argTypes.Length];
+            string[] parameterTargetToArgProxyTypeNames = new string[argTypes.Length];
+            string[] parameterArgToTargetUnproxyTypeNames = new string[argTypes.Length];
             if (positionsToProxy.Count > 0)
             {
                 foreach (int? position in positionsToProxy)
@@ -240,15 +247,18 @@ namespace StardewModdingAPI.Framework.Reflection
                     else // it's one of the parameters
                     {
                         bool isByRef = argTypes[position.Value].IsByRef;
-                        var targetType = targetParameters[position.Value].ParameterType.GetNonRefType();
-                        var argType = argTypes[position.Value].GetNonRefType();
-
-                        var builder = factory.ObtainBuilder(targetType, argType, sourceModID, targetModID);
-                        if (isByRef)
-                            argType = argType.MakeByRefType();
+                        var targetType = targetParameters[position.Value].ParameterType;
+                        var argType = argTypes[position.Value];
 
+                        var builder = factory.ObtainBuilder(targetType.GetNonRefType(), argType.GetNonRefType(), sourceModID, targetModID);
                         argTypes[position.Value] = argType;
-                        parameterProxyTypeNames[position.Value] = builder.ProxyTypeName;
+                        parameterTargetToArgProxyTypeNames[position.Value] = builder.ProxyTypeName;
+
+                        if (!targetParameters[position.Value].IsOut)
+                        {
+                            var argToTargetBuilder = factory.ObtainBuilder(argType.GetNonRefType(), targetType.GetNonRefType(), sourceModID, targetModID);
+                            parameterArgToTargetUnproxyTypeNames[position.Value] = argToTargetBuilder.ProxyTypeName;
+                        }
                     }
                 }
 
@@ -262,33 +272,10 @@ namespace StardewModdingAPI.Framework.Reflection
             // create method body
             {
                 ILGenerator il = methodBuilder.GetILGenerator();
-                LocalBuilder[] outInputLocals = new LocalBuilder[argTypes.Length];
-                LocalBuilder[] outOutputLocals = new LocalBuilder[argTypes.Length];
+                LocalBuilder[] inputLocals = new LocalBuilder[argTypes.Length];
+                LocalBuilder[] outputLocals = new LocalBuilder[argTypes.Length];
 
-                // calling the proxied method
-                LocalBuilder resultInputLocal = target.ReturnType == typeof(void) ? null : il.DeclareLocal(target.ReturnType);
-                LocalBuilder resultOutputLocal = returnType == typeof(void) ? null : il.DeclareLocal(returnType);
-                il.Emit(OpCodes.Ldarg_0);
-                il.Emit(OpCodes.Ldfld, instanceField);
-                for (int i = 0; i < argTypes.Length; i++)
-                {
-                    if (parameterProxyTypeNames[i] == null)
-                    {
-                        il.Emit(OpCodes.Ldarg, i + 1);
-                    }
-                    else
-                    {
-                        // previous code already checks if the parameters are specifically `out`
-                        outInputLocals[i] = il.DeclareLocal(targetParameters[i].ParameterType.GetNonRefType());
-                        outOutputLocals[i] = il.DeclareLocal(argTypes[i].GetNonRefType());
-                        il.Emit(OpCodes.Ldloca, outInputLocals[i]);
-                    }
-                }
-                il.Emit(target.IsVirtual ? OpCodes.Callvirt : OpCodes.Call, target);
-                if (target.ReturnType != typeof(void))
-                    il.Emit(OpCodes.Stloc, resultInputLocal);
-
-                void ProxyIfNeededAndStore(LocalBuilder inputLocal, LocalBuilder outputLocal, string proxyTypeName)
+                void ProxyIfNeededAndStore(LocalBuilder inputLocal, LocalBuilder outputLocal, string proxyTypeName, string unproxyTypeName)
                 {
                     if (proxyTypeName == null)
                     {
@@ -303,31 +290,73 @@ namespace StardewModdingAPI.Framework.Reflection
 
                     il.Emit(OpCodes.Ldarg_0);
                     il.Emit(OpCodes.Ldfld, glueField);
-                    il.Emit(OpCodes.Ldstr, proxyTypeName);
-                    il.Emit(OpCodes.Ldloc, inputLocal);
-                    il.Emit(OpCodes.Call, ObtainInstanceForProxyTypeNameMethod);
+                    if (unproxyTypeName == null)
+                    {
+                        il.Emit(OpCodes.Ldstr, proxyTypeName);
+                        il.Emit(OpCodes.Ldloc, inputLocal);
+                        il.Emit(OpCodes.Call, ObtainInstanceForProxyTypeNameMethod);
+                    }
+                    else
+                    {
+                        il.Emit(OpCodes.Ldstr, proxyTypeName);
+                        il.Emit(OpCodes.Ldstr, unproxyTypeName);
+                        il.Emit(OpCodes.Ldloc, inputLocal);
+                        il.Emit(OpCodes.Call, UnproxyOrObtainInstanceForProxyTypeNameMethod);
+                    }
                     il.Emit(OpCodes.Castclass, outputLocal.LocalType);
                     il.Emit(OpCodes.Stloc, outputLocal);
 
                     il.MarkLabel(isNullLabel);
                 }
 
+                // calling the proxied method
+                LocalBuilder resultInputLocal = target.ReturnType == typeof(void) ? null : il.DeclareLocal(target.ReturnType);
+                LocalBuilder resultOutputLocal = returnType == typeof(void) ? null : il.DeclareLocal(returnType);
+                il.Emit(OpCodes.Ldarg_0);
+                il.Emit(OpCodes.Ldfld, instanceField);
+                for (int i = 0; i < argTypes.Length; i++)
+                {
+                    if (targetParameters[i].IsOut && parameterTargetToArgProxyTypeNames[i] != null) // out parameter, proxy on the way back
+                    {
+                        inputLocals[i] = il.DeclareLocal(targetParameters[i].ParameterType.GetNonRefType());
+                        outputLocals[i] = il.DeclareLocal(argTypes[i].GetNonRefType());
+                        il.Emit(OpCodes.Ldloca, inputLocals[i]);
+                    }
+                    else if (parameterArgToTargetUnproxyTypeNames[i] != null) // normal parameter, proxy on the way in
+                    {
+                        inputLocals[i] = il.DeclareLocal(argTypes[i].GetNonRefType());
+                        outputLocals[i] = il.DeclareLocal(targetParameters[i].ParameterType.GetNonRefType());
+                        il.Emit(OpCodes.Ldarg, i + 1);
+                        il.Emit(OpCodes.Stloc, inputLocals[i]);
+                        ProxyIfNeededAndStore(inputLocals[i], outputLocals[i], parameterArgToTargetUnproxyTypeNames[i], parameterTargetToArgProxyTypeNames[i]);
+                        il.Emit(OpCodes.Ldloc, outputLocals[i]);
+                    }
+                    else // normal parameter, no proxying
+                    {
+                        il.Emit(OpCodes.Ldarg, i + 1);
+                    }
+                }
+                il.Emit(target.IsVirtual ? OpCodes.Callvirt : OpCodes.Call, target);
+                if (target.ReturnType != typeof(void))
+                    il.Emit(OpCodes.Stloc, resultInputLocal);
+
                 // proxying `out` parameters
                 for (int i = 0; i < argTypes.Length; i++)
                 {
-                    if (parameterProxyTypeNames[i] == null)
+                    if (parameterTargetToArgProxyTypeNames[i] == null)
+                        continue;
+                    if (!targetParameters[i].IsOut)
                         continue;
-                    // previous code already checks if the parameters are specifically `out`
 
-                    ProxyIfNeededAndStore(outInputLocals[i], outOutputLocals[i], parameterProxyTypeNames[i]);
+                    ProxyIfNeededAndStore(inputLocals[i], outputLocals[i], parameterTargetToArgProxyTypeNames[i], null);
                     il.Emit(OpCodes.Ldarg, i + 1);
-                    il.Emit(OpCodes.Ldloc, outOutputLocals[i]);
+                    il.Emit(OpCodes.Ldloc, outputLocals[i]);
                     il.Emit(OpCodes.Stind_Ref);
                 }
 
                 // proxying return value
                 if (target.ReturnType != typeof(void))
-                    ProxyIfNeededAndStore(resultInputLocal, resultOutputLocal, returnValueProxyTypeName);
+                    ProxyIfNeededAndStore(resultInputLocal, resultOutputLocal, returnValueProxyTypeName, null);
 
                 // return result
                 if (target.ReturnType != typeof(void))
@@ -336,6 +365,23 @@ namespace StardewModdingAPI.Framework.Reflection
             }
         }
 
+        /// <summary>Try to get a target instance for a given proxy instance.</summary>
+        /// <param name="potentialProxyInstance">The proxy instance to look for.</param>
+        /// <param name="targetInstance">The reference to store the found target instance in.</param>
+        public bool TryUnproxy(object potentialProxyInstance, out object targetInstance)
+        {
+            foreach ((object cachedTargetInstance, object cachedProxyInstance) in this.ProxyCache)
+            {
+                if (object.ReferenceEquals(potentialProxyInstance, cachedProxyInstance))
+                {
+                    targetInstance = cachedTargetInstance;
+                    return true;
+                }
+            }
+            targetInstance = null;
+            return false;
+        }
+
         /// <summary>The part of a method that is being matched.</summary>
         private enum MethodTypeMatchingPart
         {
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index daeac2ad..a6f38c3a 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -57,11 +57,11 @@ namespace StardewModdingAPI.Framework.Reflection
                 string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{interfaceType.FullName}>_To<{targetModID}_{targetType.FullName}>";
                 if (!this.Builders.TryGetValue(proxyTypeName, out InterfaceProxyBuilder builder))
                 {
-                    builder = new InterfaceProxyBuilder(targetType, proxyTypeName);
+                    builder = new InterfaceProxyBuilder(targetType, interfaceType, proxyTypeName);
                     this.Builders[proxyTypeName] = builder;
                     try
                     {
-                        builder.SetupProxyType(this, this.ModuleBuilder, interfaceType, sourceModID, targetModID);
+                        builder.SetupProxyType(this, this.ModuleBuilder, sourceModID, targetModID);
                     }
                     catch
                     {
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
index f98b54a2..38569efa 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
@@ -18,5 +18,17 @@ namespace StardewModdingAPI.Framework.Reflection
             var builder = this.Factory.GetBuilderByProxyTypeName(proxyTypeName);
             return builder.ObtainInstance(toProxy, this.Factory);
         }
+
+        /// <summary>Try to unproxy, or get an existing, or create a new proxied instance by its type name.</summary>
+        /// <param name="proxyTypeName">The full name of the proxy type.</param>
+        /// <param name="unproxyTypeName">The full name of the reverse proxy type.</param>
+        /// <param name="toProxy">The target instance to proxy.</param>
+        public object UnproxyOrObtainInstanceForProxyTypeName(string proxyTypeName, string unproxyTypeName, object toProxy)
+        {
+            var unproxyBuilder = this.Factory.GetBuilderByProxyTypeName(unproxyTypeName);
+            if (unproxyBuilder.TryUnproxy(toProxy, out object targetInstance))
+                return targetInstance;
+            return this.ObtainInstanceForProxyTypeName(proxyTypeName, toProxy);
+        }
     }
 }

From a54d58d064df5654e845f9b2b4fc9db5b0189db0 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Thu, 10 Feb 2022 16:26:43 +0100
Subject: [PATCH 427/856] add TryProxy for any objects

---
 .../Framework/ModHelpers/ModRegistryHelper.cs | 26 +++++++++++++++++++
 src/SMAPI/IModRegistry.cs                     |  7 +++++
 2 files changed, 33 insertions(+)

diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index ef1ad30c..92c52b00 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -98,5 +98,31 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 return castApi;
             return this.ProxyFactory.CreateProxy<TInterface>(api, this.ModID, uniqueID);
         }
+
+        /// <inheritdoc />
+        public bool TryProxy<TInterface>(string uniqueID, object toProxy, out TInterface proxy) where TInterface : class
+        {
+            try
+            {
+                foreach (var toProxyInterface in toProxy.GetType().GetInterfaces())
+                {
+                    var unproxyBuilder = this.ProxyFactory.ObtainBuilder(typeof(TInterface), toProxyInterface, this.ModID, uniqueID);
+                    if (unproxyBuilder.TryUnproxy(toProxy, out object targetInstance))
+                    {
+                        proxy = (TInterface)targetInstance;
+                        return true;
+                    }
+                }
+
+                var proxyBuilder = this.ProxyFactory.ObtainBuilder(toProxy.GetType(), typeof(TInterface), this.ModID, uniqueID);
+                proxy = (TInterface)proxyBuilder.ObtainInstance(toProxy, this.ProxyFactory);
+                return true;
+            }
+            catch
+            {
+                proxy = null;
+                return false;
+            }
+        }
     }
 }
diff --git a/src/SMAPI/IModRegistry.cs b/src/SMAPI/IModRegistry.cs
index 10b3121e..9b99e459 100644
--- a/src/SMAPI/IModRegistry.cs
+++ b/src/SMAPI/IModRegistry.cs
@@ -25,5 +25,12 @@ namespace StardewModdingAPI
         /// <typeparam name="TInterface">The interface which matches the properties and methods you intend to access.</typeparam>
         /// <param name="uniqueID">The mod's unique ID.</param>
         TInterface GetApi<TInterface>(string uniqueID) where TInterface : class;
+
+        /// <summary>Try to proxy (or unproxy back) the given object to a given interface provided by a mod.</summary>
+        /// <typeparam name="TInterface">The interface type to proxy (or unproxy) to.</typeparam>
+        /// <param name="uniqueID">The mod's unique ID.</param>
+        /// <param name="toProxy">The object to try to proxy (or unproxy back).</param>
+        /// <param name="proxy">The reference to store the proxied (or unproxied) object back.</param>
+        bool TryProxy<TInterface>(string uniqueID, object toProxy, out TInterface proxy) where TInterface : class;
     }
 }

From 3064b58719060a145058ab295792d8c97128b433 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 10 Feb 2022 22:03:09 -0500
Subject: [PATCH 428/856] add basic unit tests for API interface proxying

---
 src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs |  46 +++
 .../Interfaces/ISimpleApi.cs                  |  79 ++++
 src/SMAPI.Tests.ModApiConsumer/README.md      |   3 +
 .../SMAPI.Tests.ModApiConsumer.csproj         |  11 +
 .../Framework/BaseApi.cs                      |  12 +
 .../Framework/SimpleApi.cs                    | 108 ++++++
 src/SMAPI.Tests.ModApiProvider/ProviderMod.cs |  38 ++
 src/SMAPI.Tests.ModApiProvider/README.md      |   3 +
 .../SMAPI.Tests.ModApiProvider.csproj         |   7 +
 src/SMAPI.Tests/Core/InterfaceProxyTests.cs   | 345 ++++++++++++++++++
 src/SMAPI.Tests/SMAPI.Tests.csproj            |   7 +-
 src/SMAPI.sln                                 |  14 +
 12 files changed, 669 insertions(+), 4 deletions(-)
 create mode 100644 src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
 create mode 100644 src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
 create mode 100644 src/SMAPI.Tests.ModApiConsumer/README.md
 create mode 100644 src/SMAPI.Tests.ModApiConsumer/SMAPI.Tests.ModApiConsumer.csproj
 create mode 100644 src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
 create mode 100644 src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
 create mode 100644 src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
 create mode 100644 src/SMAPI.Tests.ModApiProvider/README.md
 create mode 100644 src/SMAPI.Tests.ModApiProvider/SMAPI.Tests.ModApiProvider.csproj
 create mode 100644 src/SMAPI.Tests/Core/InterfaceProxyTests.cs

diff --git a/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs b/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
new file mode 100644
index 00000000..2c7f9952
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
@@ -0,0 +1,46 @@
+using System;
+using SMAPI.Tests.ModApiConsumer.Interfaces;
+
+namespace SMAPI.Tests.ModApiConsumer
+{
+    /// <summary>A simulated API consumer.</summary>
+    public class ApiConsumer
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Call the event field on the given API.</summary>
+        /// <param name="api">The API to call.</param>
+        /// <param name="getValues">Get the number of times the event was called and the last value received.</param>
+        public void UseEventField(ISimpleApi api, out Func<(int timesCalled, int actualValue)> getValues)
+        {
+            // act
+            int calls = 0;
+            int lastValue = -1;
+            api.OnEventRaised += (sender, value) =>
+            {
+                calls++;
+                lastValue = value;
+            };
+
+            getValues = () => (timesCalled: calls, actualValue: lastValue);
+        }
+
+        /// <summary>Call the event property on the given API.</summary>
+        /// <param name="api">The API to call.</param>
+        /// <param name="getValues">Get the number of times the event was called and the last value received.</param>
+        public void UseEventProperty(ISimpleApi api, out Func<(int timesCalled, int actualValue)> getValues)
+        {
+            // act
+            int calls = 0;
+            int lastValue = -1;
+            api.OnEventRaisedProperty += (sender, value) =>
+            {
+                calls++;
+                lastValue = value;
+            };
+
+            getValues = () => (timesCalled: calls, actualValue: lastValue);
+        }
+    }
+}
diff --git a/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs b/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
new file mode 100644
index 00000000..7f94e137
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
@@ -0,0 +1,79 @@
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+
+namespace SMAPI.Tests.ModApiConsumer.Interfaces
+{
+    /// <summary>A mod-provided API which provides basic events, properties, and methods.</summary>
+    public interface ISimpleApi
+    {
+        /*********
+        ** Test interface
+        *********/
+        /****
+        ** Events
+        ****/
+        /// <summary>A simple event field.</summary>
+        event EventHandler<int> OnEventRaised;
+
+        /// <summary>A simple event property with custom add/remove logic.</summary>
+        event EventHandler<int> OnEventRaisedProperty;
+
+
+        /****
+        ** Properties
+        ****/
+        /// <summary>A simple numeric property.</summary>
+        int NumberProperty { get; set; }
+
+        /// <summary>A simple object property.</summary>
+        object ObjectProperty { get; set; }
+
+        /// <summary>A simple list property.</summary>
+        List<string> ListProperty { get; set; }
+
+        /// <summary>A simple list property with an interface.</summary>
+        IList<string> ListPropertyWithInterface { get; set; }
+
+        /// <summary>A property with nested generics.</summary>
+        IDictionary<string, IList<string>> GenericsProperty { get; set; }
+
+        /// <summary>A property using an enum available to both mods.</summary>
+        BindingFlags EnumProperty { get; set; }
+
+        /// <summary>A read-only property.</summary>
+        int GetterProperty { get; }
+
+
+        /****
+        ** Methods
+        ****/
+        /// <summary>A simple method with no return value.</summary>
+        void GetNothing();
+
+        /// <summary>A simple method which returns a number.</summary>
+        int GetInt(int value);
+
+        /// <summary>A simple method which returns an object.</summary>
+        object GetObject(object value);
+
+        /// <summary>A simple method which returns a list.</summary>
+        List<string> GetList(string value);
+
+        /// <summary>A simple method which returns a list with an interface.</summary>
+        IList<string> GetListWithInterface(string value);
+
+        /// <summary>A simple method which returns nested generics.</summary>
+        IDictionary<string, IList<string>> GetGenerics(string key, string value);
+
+        /// <summary>A simple method which returns a lambda.</summary>
+        Func<string, string> GetLambda(Func<string, string> value);
+
+
+        /****
+        ** Inherited members
+        ****/
+        /// <summary>A property inherited from a base class.</summary>
+        public string InheritedProperty { get; set; }
+    }
+}
diff --git a/src/SMAPI.Tests.ModApiConsumer/README.md b/src/SMAPI.Tests.ModApiConsumer/README.md
new file mode 100644
index 00000000..ed0c6e3f
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiConsumer/README.md
@@ -0,0 +1,3 @@
+This project contains a simulated [mod-provided API] consumer used in the API proxying unit tests.
+
+[mod-provided API]: https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations
diff --git a/src/SMAPI.Tests.ModApiConsumer/SMAPI.Tests.ModApiConsumer.csproj b/src/SMAPI.Tests.ModApiConsumer/SMAPI.Tests.ModApiConsumer.csproj
new file mode 100644
index 00000000..7fef4ebd
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiConsumer/SMAPI.Tests.ModApiConsumer.csproj
@@ -0,0 +1,11 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net5.0</TargetFramework>
+  </PropertyGroup>
+
+  <Import Project="..\..\build\common.targets" />
+
+  <ItemGroup>
+    <ProjectReference Include="..\SMAPI\SMAPI.csproj" />
+  </ItemGroup>
+</Project>
diff --git a/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs b/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
new file mode 100644
index 00000000..8092e3e7
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
@@ -0,0 +1,12 @@
+namespace SMAPI.Tests.ModApiProvider.Framework
+{
+    /// <summary>The base class for <see cref="SimpleApi"/>.</summary>
+    public class BaseApi
+    {
+        /*********
+        ** Test interface
+        *********/
+        /// <summary>A property inherited from a base class.</summary>
+        public string InheritedProperty { get; set; }
+    }
+}
diff --git a/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs b/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
new file mode 100644
index 00000000..1100af36
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
@@ -0,0 +1,108 @@
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+
+namespace SMAPI.Tests.ModApiProvider.Framework
+{
+    /// <summary>A mod-provided API which provides basic events, properties, and methods.</summary>
+    public class SimpleApi : BaseApi
+    {
+        /*********
+        ** Test interface
+        *********/
+        /****
+        ** Events
+        ****/
+        /// <summary>A simple event field.</summary>
+        public event EventHandler<int> OnEventRaised;
+
+        /// <summary>A simple event property with custom add/remove logic.</summary>
+        public event EventHandler<int> OnEventRaisedProperty
+        {
+            add => this.OnEventRaised += value;
+            remove => this.OnEventRaised -= value;
+        }
+
+
+        /****
+        ** Properties
+        ****/
+        /// <summary>A simple numeric property.</summary>
+        public int NumberProperty { get; set; }
+
+        /// <summary>A simple object property.</summary>
+        public object ObjectProperty { get; set; }
+
+        /// <summary>A simple list property.</summary>
+        public List<string> ListProperty { get; set; }
+
+        /// <summary>A simple list property with an interface.</summary>
+        public IList<string> ListPropertyWithInterface { get; set; }
+
+        /// <summary>A property with nested generics.</summary>
+        public IDictionary<string, IList<string>> GenericsProperty { get; set; }
+
+        /// <summary>A property using an enum available to both mods.</summary>
+        public BindingFlags EnumProperty { get; set; }
+
+        /// <summary>A read-only property.</summary>
+        public int GetterProperty => 42;
+
+
+        /****
+        ** Methods
+        ****/
+        /// <summary>A simple method with no return value.</summary>
+        public void GetNothing() { }
+
+        /// <summary>A simple method which returns a number.</summary>
+        public int GetInt(int value)
+        {
+            return value;
+        }
+
+        /// <summary>A simple method which returns an object.</summary>
+        public object GetObject(object value)
+        {
+            return value;
+        }
+
+        /// <summary>A simple method which returns a list.</summary>
+        public List<string> GetList(string value)
+        {
+            return new() { value };
+        }
+
+        /// <summary>A simple method which returns a list with an interface.</summary>
+        public IList<string> GetListWithInterface(string value)
+        {
+            return new List<string> { value };
+        }
+
+        /// <summary>A simple method which returns nested generics.</summary>
+        public IDictionary<string, IList<string>> GetGenerics(string key, string value)
+        {
+            return new Dictionary<string, IList<string>>
+            {
+                [key] = new List<string> { value }
+            };
+        }
+
+        /// <summary>A simple method which returns a lambda.</summary>
+        public Func<string, string> GetLambda(Func<string, string> value)
+        {
+            return value;
+        }
+
+
+        /*********
+        ** Helper methods
+        *********/
+        /// <summary>Raise the <see cref="OnEventRaised"/> event.</summary>
+        /// <param name="value">The value to pass to the event.</param>
+        public void RaiseEventField(int value)
+        {
+            this.OnEventRaised?.Invoke(null, value);
+        }
+    }
+}
diff --git a/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs b/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
new file mode 100644
index 00000000..c36e1c6d
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
@@ -0,0 +1,38 @@
+using System.Collections.Generic;
+using System.Reflection;
+using SMAPI.Tests.ModApiProvider.Framework;
+
+namespace SMAPI.Tests.ModApiProvider
+{
+    /// <summary>A simulated mod instance.</summary>
+    public class ProviderMod
+    {
+        /// <summary>The underlying API instance.</summary>
+        private readonly SimpleApi Api = new();
+
+        /// <summary>Get the mod API instance.</summary>
+        public object GetModApi()
+        {
+            return this.Api;
+        }
+
+        /// <summary>Raise the <see cref="SimpleApi.OnEventRaised"/> event.</summary>
+        /// <param name="value">The value to send as an event argument.</param>
+        public void RaiseEvent(int value)
+        {
+            this.Api.RaiseEventField(value);
+        }
+
+        /// <summary>Set the values for the API property.</summary>
+        public void SetPropertyValues(int number, object obj, string listValue, string listWithInterfaceValue, string dictionaryKey, string dictionaryListValue, BindingFlags enumValue, string inheritedValue)
+        {
+            this.Api.NumberProperty = number;
+            this.Api.ObjectProperty = obj;
+            this.Api.ListProperty = new List<string> { listValue };
+            this.Api.ListPropertyWithInterface = new List<string> { listWithInterfaceValue };
+            this.Api.GenericsProperty = new Dictionary<string, IList<string>> { [dictionaryKey] = new List<string> { dictionaryListValue } };
+            this.Api.EnumProperty = enumValue;
+            this.Api.InheritedProperty = inheritedValue;
+        }
+    }
+}
diff --git a/src/SMAPI.Tests.ModApiProvider/README.md b/src/SMAPI.Tests.ModApiProvider/README.md
new file mode 100644
index 00000000..c79838e0
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiProvider/README.md
@@ -0,0 +1,3 @@
+This project contains simulated [mod-provided APIs] used in the API proxying unit tests.
+
+[mod-provided APIs]: https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations
diff --git a/src/SMAPI.Tests.ModApiProvider/SMAPI.Tests.ModApiProvider.csproj b/src/SMAPI.Tests.ModApiProvider/SMAPI.Tests.ModApiProvider.csproj
new file mode 100644
index 00000000..70d5a0ce
--- /dev/null
+++ b/src/SMAPI.Tests.ModApiProvider/SMAPI.Tests.ModApiProvider.csproj
@@ -0,0 +1,7 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net5.0</TargetFramework>
+  </PropertyGroup>
+
+  <Import Project="..\..\build\common.targets" />
+</Project>
diff --git a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
new file mode 100644
index 00000000..99c1298f
--- /dev/null
+++ b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
@@ -0,0 +1,345 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using System.Reflection;
+using FluentAssertions;
+using NUnit.Framework;
+using SMAPI.Tests.ModApiConsumer;
+using SMAPI.Tests.ModApiConsumer.Interfaces;
+using SMAPI.Tests.ModApiProvider;
+using StardewModdingAPI.Framework.Reflection;
+
+namespace SMAPI.Tests.Core
+{
+    /// <summary>Unit tests for <see cref="InterfaceProxyFactory"/>.</summary>
+    [TestFixture]
+    internal class InterfaceProxyTests
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The mod ID providing an API.</summary>
+        private readonly string FromModId = "From.ModId";
+
+        /// <summary>The mod ID consuming an API.</summary>
+        private readonly string ToModId = "From.ModId";
+
+        /// <summary>The random number generator with which to create sample values.</summary>
+        private readonly Random Random = new();
+
+
+        /*********
+        ** Unit tests
+        *********/
+        /****
+        ** Events
+        ****/
+        /// <summary>Assert that an event field can be proxied correctly.</summary>
+        [Test]
+        public void CanProxy_EventField()
+        {
+            // arrange
+            var providerMod = new ProviderMod();
+            object implementation = providerMod.GetModApi();
+            int expectedValue = this.Random.Next();
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            new ApiConsumer().UseEventField(proxy, out Func<(int timesCalled, int lastValue)> getValues);
+            providerMod.RaiseEvent(expectedValue);
+            (int timesCalled, int lastValue) = getValues();
+
+            // assert
+            timesCalled.Should().Be(1, "Expected the proxied event to be raised once.");
+            lastValue.Should().Be(expectedValue, "The proxy received a different event argument than the implementation raised.");
+        }
+
+        /// <summary>Assert that an event property can be proxied correctly.</summary>
+        [Test]
+        public void CanProxy_EventProperty()
+        {
+            // arrange
+            var providerMod = new ProviderMod();
+            object implementation = providerMod.GetModApi();
+            int expectedValue = this.Random.Next();
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            new ApiConsumer().UseEventProperty(proxy, out Func<(int timesCalled, int lastValue)> getValues);
+            providerMod.RaiseEvent(expectedValue);
+            (int timesCalled, int lastValue) = getValues();
+
+            // assert
+            timesCalled.Should().Be(1, "Expected the proxied event to be raised once.");
+            lastValue.Should().Be(expectedValue, "The proxy received a different event argument than the implementation raised.");
+        }
+
+        /****
+        ** Properties
+        ****/
+        /// <summary>Assert that properties can be proxied correctly.</summary>
+        /// <param name="setVia">Whether to set the properties through the <c>provider mod</c> or <c>proxy interface</c>.</param>
+        [TestCase("set via provider mod")]
+        [TestCase("set via proxy interface")]
+        public void CanProxy_Properties(string setVia)
+        {
+            // arrange
+            var providerMod = new ProviderMod();
+            object implementation = providerMod.GetModApi();
+            int expectedNumber = this.Random.Next();
+            int expectedObject = this.Random.Next();
+            string expectedListValue = this.GetRandomString();
+            string expectedListWithInterfaceValue = this.GetRandomString();
+            string expectedDictionaryKey = this.GetRandomString();
+            string expectedDictionaryListValue = this.GetRandomString();
+            string expectedInheritedString = this.GetRandomString();
+            BindingFlags expectedEnum = BindingFlags.Instance | BindingFlags.Public;
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            switch (setVia)
+            {
+                case "set via provider mod":
+                    providerMod.SetPropertyValues(
+                        number: expectedNumber,
+                        obj: expectedObject,
+                        listValue: expectedListValue,
+                        listWithInterfaceValue: expectedListWithInterfaceValue,
+                        dictionaryKey: expectedDictionaryKey,
+                        dictionaryListValue: expectedDictionaryListValue,
+                        enumValue: expectedEnum,
+                        inheritedValue: expectedInheritedString
+                    );
+                    break;
+
+                case "set via proxy interface":
+                    proxy.NumberProperty = expectedNumber;
+                    proxy.ObjectProperty = expectedObject;
+                    proxy.ListProperty = new() { expectedListValue };
+                    proxy.ListPropertyWithInterface = new List<string> { expectedListWithInterfaceValue };
+                    proxy.GenericsProperty = new Dictionary<string, IList<string>>
+                    {
+                        [expectedDictionaryKey] = new List<string> { expectedDictionaryListValue }
+                    };
+                    proxy.EnumProperty = expectedEnum;
+                    proxy.InheritedProperty = expectedInheritedString;
+                    break;
+
+                default:
+                    throw new InvalidOperationException($"Invalid 'set via' option '{setVia}.");
+            }
+
+            // assert number
+            this
+                .GetPropertyValue(implementation, nameof(proxy.NumberProperty))
+                .Should().Be(expectedNumber);
+            proxy.NumberProperty
+                .Should().Be(expectedNumber);
+
+            // assert object
+            this
+                .GetPropertyValue(implementation, nameof(proxy.ObjectProperty))
+                .Should().Be(expectedObject);
+            proxy.ObjectProperty
+                .Should().Be(expectedObject);
+
+            // assert list
+            (this.GetPropertyValue(implementation, nameof(proxy.ListProperty)) as IList<string>)
+                .Should().NotBeNull()
+                .And.HaveCount(1)
+                .And.BeEquivalentTo(expectedListValue);
+            proxy.ListProperty
+                .Should().NotBeNull()
+                .And.HaveCount(1)
+                .And.BeEquivalentTo(expectedListValue);
+
+            // assert list with interface
+            (this.GetPropertyValue(implementation, nameof(proxy.ListPropertyWithInterface)) as IList<string>)
+                .Should().NotBeNull()
+                .And.HaveCount(1)
+                .And.BeEquivalentTo(expectedListWithInterfaceValue);
+            proxy.ListPropertyWithInterface
+                .Should().NotBeNull()
+                .And.HaveCount(1)
+                .And.BeEquivalentTo(expectedListWithInterfaceValue);
+
+            // assert generics
+            (this.GetPropertyValue(implementation, nameof(proxy.GenericsProperty)) as IDictionary<string, IList<string>>)
+                .Should().NotBeNull()
+                .And.HaveCount(1)
+                .And.ContainKey(expectedDictionaryKey).WhoseValue.Should().BeEquivalentTo(expectedDictionaryListValue);
+            proxy.GenericsProperty
+                .Should().NotBeNull()
+                .And.HaveCount(1)
+                .And.ContainKey(expectedDictionaryKey).WhoseValue.Should().BeEquivalentTo(expectedDictionaryListValue);
+
+            // assert enum
+            this
+                .GetPropertyValue(implementation, nameof(proxy.EnumProperty))
+                .Should().Be(expectedEnum);
+            proxy.EnumProperty
+                .Should().Be(expectedEnum);
+
+            // assert getter
+            this
+                .GetPropertyValue(implementation, nameof(proxy.GetterProperty))
+                .Should().Be(42);
+            proxy.GetterProperty
+                .Should().Be(42);
+
+            // assert inherited methods
+            this
+                .GetPropertyValue(implementation, nameof(proxy.InheritedProperty))
+                .Should().Be(expectedInheritedString);
+            proxy.InheritedProperty
+                .Should().Be(expectedInheritedString);
+        }
+
+        /// <summary>Assert that a simple method with no return value can be proxied correctly.</summary>
+        [Test]
+        public void CanProxy_SimpleMethod_Void()
+        {
+            // arrange
+            object implementation = new ProviderMod().GetModApi();
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            proxy.GetNothing();
+        }
+
+        /// <summary>Assert that a simple int method can be proxied correctly.</summary>
+        [Test]
+        public void CanProxy_SimpleMethod_Int()
+        {
+            // arrange
+            object implementation = new ProviderMod().GetModApi();
+            int expectedValue = this.Random.Next();
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            int actualValue = proxy.GetInt(expectedValue);
+
+            // assert
+            actualValue.Should().Be(expectedValue);
+        }
+
+        /// <summary>Assert that a simple object method can be proxied correctly.</summary>
+        [Test]
+        public void CanProxy_SimpleMethod_Object()
+        {
+            // arrange
+            object implementation = new ProviderMod().GetModApi();
+            object expectedValue = new();
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            object actualValue = proxy.GetObject(expectedValue);
+
+            // assert
+            actualValue.Should().BeSameAs(expectedValue);
+        }
+
+        /// <summary>Assert that a simple list method can be proxied correctly.</summary>
+        [Test]
+        public void CanProxy_SimpleMethod_List()
+        {
+            // arrange
+            object implementation = new ProviderMod().GetModApi();
+            string expectedValue = this.GetRandomString();
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            IList<string> actualValue = proxy.GetList(expectedValue);
+
+            // assert
+            actualValue.Should().BeEquivalentTo(expectedValue);
+        }
+
+        /// <summary>Assert that a simple list with interface method can be proxied correctly.</summary>
+        [Test]
+        public void CanProxy_SimpleMethod_ListWithInterface()
+        {
+            // arrange
+            object implementation = new ProviderMod().GetModApi();
+            string expectedValue = this.GetRandomString();
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            IList<string> actualValue = proxy.GetListWithInterface(expectedValue);
+
+            // assert
+            actualValue.Should().BeEquivalentTo(expectedValue);
+        }
+
+        /// <summary>Assert that a simple method which returns generic types can be proxied correctly.</summary>
+        [Test]
+        public void CanProxy_SimpleMethod_GenericTypes()
+        {
+            // arrange
+            object implementation = new ProviderMod().GetModApi();
+            string expectedKey = this.GetRandomString();
+            string expectedValue = this.GetRandomString();
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            IDictionary<string, IList<string>> actualValue = proxy.GetGenerics(expectedKey, expectedValue);
+
+            // assert
+            actualValue
+                .Should().NotBeNull()
+                .And.HaveCount(1)
+                .And.ContainKey(expectedKey).WhoseValue.Should().BeEquivalentTo(expectedValue);
+        }
+
+        /// <summary>Assert that a simple lambda method can be proxied correctly.</summary>
+        [Test]
+        [SuppressMessage("ReSharper", "ConvertToLocalFunction")]
+        public void CanProxy_SimpleMethod_Lambda()
+        {
+            // arrange
+            object implementation = new ProviderMod().GetModApi();
+            Func<string, string> expectedValue = _ => "test";
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            object actualValue = proxy.GetObject(expectedValue);
+
+            // assert
+            actualValue.Should().BeSameAs(expectedValue);
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get a property value from an instance.</summary>
+        /// <param name="parent">The instance whose property to read.</param>
+        /// <param name="name">The property name.</param>
+        private object GetPropertyValue(object parent, string name)
+        {
+            if (parent is null)
+                throw new ArgumentNullException(nameof(parent));
+
+            Type type = parent.GetType();
+            PropertyInfo property = type.GetProperty(name);
+            if (property is null)
+                throw new InvalidOperationException($"The '{type.FullName}' type has no public property named '{name}'.");
+
+            return property.GetValue(parent);
+        }
+
+        /// <summary>Get a random test string.</summary>
+        private string GetRandomString()
+        {
+            return this.Random.Next().ToString();
+        }
+
+        /// <summary>Get a proxy API instance.</summary>
+        /// <param name="implementation">The underlying API instance.</param>
+        private ISimpleApi GetProxy(object implementation)
+        {
+            var proxyFactory = new InterfaceProxyFactory();
+            return proxyFactory.CreateProxy<ISimpleApi>(implementation, this.FromModId, this.ToModId);
+        }
+    }
+}
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 8329b2e1..67997b30 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -1,21 +1,20 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <AssemblyName>SMAPI.Tests</AssemblyName>
-    <RootNamespace>SMAPI.Tests</RootNamespace>
     <TargetFramework>net5.0</TargetFramework>
-    <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
-    <LangVersion>latest</LangVersion>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
 
   <ItemGroup>
+    <ProjectReference Include="..\SMAPI.Tests.ModApiConsumer\SMAPI.Tests.ModApiConsumer.csproj" />
+    <ProjectReference Include="..\SMAPI.Tests.ModApiProvider\SMAPI.Tests.ModApiProvider.csproj" />
     <ProjectReference Include="..\SMAPI.Toolkit.CoreInterfaces\SMAPI.Toolkit.CoreInterfaces.csproj" />
     <ProjectReference Include="..\SMAPI.Toolkit\SMAPI.Toolkit.csproj" />
     <ProjectReference Include="..\SMAPI\SMAPI.csproj" />
   </ItemGroup>
 
   <ItemGroup>
+    <PackageReference Include="FluentAssertions" Version="6.5.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.9.4" />
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index be5326f7..d9f60a5c 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -101,6 +101,10 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "lib", "lib", "{3B5BF14D-F61
 		..\build\windows\lib\in-place-regex.ps1 = ..\build\windows\lib\in-place-regex.ps1
 	EndProjectSection
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Tests.ModApiProvider", "SMAPI.Tests.ModApiProvider\SMAPI.Tests.ModApiProvider.csproj", "{239AEEAC-07D1-4A3F-AA99-8C74F5038F50}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SMAPI.Tests.ModApiConsumer", "SMAPI.Tests.ModApiConsumer\SMAPI.Tests.ModApiConsumer.csproj", "{2A4DF030-E8B1-4BBD-AA93-D4DE68CB9D85}"
+EndProject
 Global
 	GlobalSection(SharedMSBuildProjectFiles) = preSolution
 		SMAPI.Internal\SMAPI.Internal.projitems*{0634ea4c-3b8f-42db-aea6-ca9e4ef6e92f}*SharedItemsImports = 5
@@ -167,6 +171,14 @@ Global
 		{80EFD92F-728F-41E0-8A5B-9F6F49A91899}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{80EFD92F-728F-41E0-8A5B-9F6F49A91899}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{80EFD92F-728F-41E0-8A5B-9F6F49A91899}.Release|Any CPU.Build.0 = Release|Any CPU
+		{239AEEAC-07D1-4A3F-AA99-8C74F5038F50}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{239AEEAC-07D1-4A3F-AA99-8C74F5038F50}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{239AEEAC-07D1-4A3F-AA99-8C74F5038F50}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{239AEEAC-07D1-4A3F-AA99-8C74F5038F50}.Release|Any CPU.Build.0 = Release|Any CPU
+		{2A4DF030-E8B1-4BBD-AA93-D4DE68CB9D85}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{2A4DF030-E8B1-4BBD-AA93-D4DE68CB9D85}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{2A4DF030-E8B1-4BBD-AA93-D4DE68CB9D85}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{2A4DF030-E8B1-4BBD-AA93-D4DE68CB9D85}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -187,6 +199,8 @@ Global
 		{4D661178-38FB-43E4-AA5F-9B0406919344} = {09CF91E5-5BAB-4650-A200-E5EA9A633046}
 		{CAA1488E-842B-433D-994D-1D3D0B5DD125} = {09CF91E5-5BAB-4650-A200-E5EA9A633046}
 		{3B5BF14D-F612-4C83-9EF6-E3EBFCD08766} = {4D661178-38FB-43E4-AA5F-9B0406919344}
+		{239AEEAC-07D1-4A3F-AA99-8C74F5038F50} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
+		{2A4DF030-E8B1-4BBD-AA93-D4DE68CB9D85} = {82D22ED7-A0A7-4D64-8E92-4B6A5E74ED11}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {70143042-A862-47A8-A677-7C819DDC90DC}

From 4da9e954df3846d01aa0536f4e8143466a1d62f3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Feb 2022 00:49:49 -0500
Subject: [PATCH 429/856] use Array.Empty to avoid unneeded array allocations

---
 src/SMAPI.Internal/ExceptionHelper.cs            |  2 +-
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs          |  2 +-
 src/SMAPI.Tests/Core/ModResolverTests.cs         | 16 ++++++++--------
 .../Framework/Clients/WebApi/ModEntryModel.cs    |  4 +++-
 .../Clients/WebApi/ModExtendedMetadataModel.cs   |  3 ++-
 .../Clients/WebApi/ModSearchEntryModel.cs        |  4 +++-
 .../Framework/Clients/Wiki/ChangeDescriptor.cs   |  2 +-
 .../Framework/Clients/Wiki/WikiClient.cs         |  2 +-
 .../Clients/Wiki/WikiDataOverrideEntry.cs        |  4 +++-
 .../Framework/ModData/ModDatabase.cs             |  2 +-
 .../Serialization/Models/Manifest.cs             |  7 ++++---
 src/SMAPI.Web/Controllers/IndexController.cs     |  2 +-
 src/SMAPI.Web/Controllers/ModsApiController.cs   |  2 +-
 .../Caching/Wiki/WikiCacheMemoryRepository.cs    |  2 +-
 .../Framework/Clients/GenericModPage.cs          |  3 ++-
 .../Framework/LogParsing/Models/ParsedLog.cs     |  2 +-
 .../JsonValidator/JsonValidatorModel.cs          |  2 +-
 src/SMAPI.Web/Views/LogParser/Index.cshtml       |  2 +-
 src/SMAPI.Web/Views/Mods/Index.cshtml            |  2 +-
 src/SMAPI/Events/ButtonsChangedEventArgs.cs      |  2 +-
 src/SMAPI/Framework/Events/ManagedEvent.cs       |  2 +-
 src/SMAPI/Framework/Models/SConfig.cs            |  4 ++--
 src/SMAPI/Framework/SCore.cs                     |  6 +++---
 .../FieldWatchers/ImmutableCollectionWatcher.cs  |  5 +++--
 .../Framework/StateTracking/LocationTracker.cs   |  3 ++-
 .../StateTracking/Snapshots/PlayerSnapshot.cs    |  2 +-
 .../TemporaryHacks/MiniMonoModHotfix.cs          |  2 +-
 src/SMAPI/Metadata/CoreAssetPropagator.cs        |  2 +-
 src/SMAPI/Utilities/Keybind.cs                   |  4 ++--
 src/SMAPI/Utilities/KeybindList.cs               |  4 ++--
 30 files changed, 56 insertions(+), 45 deletions(-)

diff --git a/src/SMAPI.Internal/ExceptionHelper.cs b/src/SMAPI.Internal/ExceptionHelper.cs
index 05b96c2e..03d48911 100644
--- a/src/SMAPI.Internal/ExceptionHelper.cs
+++ b/src/SMAPI.Internal/ExceptionHelper.cs
@@ -25,7 +25,7 @@ namespace StardewModdingAPI.Internal
 
                     case ReflectionTypeLoadException ex:
                         string summary = ex.ToString();
-                        foreach (Exception childEx in ex.LoaderExceptions ?? new Exception[0])
+                        foreach (Exception childEx in ex.LoaderExceptions ?? Array.Empty<Exception>())
                             summary += $"\n\n{childEx?.GetLogSummary()}";
                         message = summary;
                         break;
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index 7286e316..2d6242cf 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -80,7 +80,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
             MethodInfo getMonitorForGame = coreType.GetMethod("GetMonitorForGame")
                 ?? throw new InvalidOperationException("Can't access the SMAPI's 'GetMonitorForGame' method. This mod may not work correctly.");
 
-            return (IMonitor)getMonitorForGame.Invoke(core, new object[0]) ?? this.Monitor;
+            return (IMonitor)getMonitorForGame.Invoke(core, Array.Empty<object>()) ?? this.Monitor;
         }
     }
 }
diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index da3446bb..1755f644 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -123,7 +123,7 @@ namespace SMAPI.Tests.Core
         [Test(Description = "Assert that validation doesn't fail if there are no mods installed.")]
         public void ValidateManifests_NoMods_DoesNothing()
         {
-            new ModResolver().ValidateManifests(new ModMetadata[0], apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
+            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
         }
 
         [Test(Description = "Assert that validation skips manifests that have already failed without calling any other properties.")]
@@ -144,7 +144,7 @@ namespace SMAPI.Tests.Core
         public void ValidateManifests_ModStatus_AssumeBroken_Fails()
         {
             // arrange
-            Mock<IModMetadata> mock = this.GetMetadata("Mod A", new string[0], allowStatusChange: true);
+            Mock<IModMetadata> mock = this.GetMetadata("Mod A", Array.Empty<string>(), allowStatusChange: true);
             this.SetupMetadataForValidation(mock, new ModDataRecordVersionedFields
             {
                 Status = ModStatus.AssumeBroken
@@ -161,7 +161,7 @@ namespace SMAPI.Tests.Core
         public void ValidateManifests_MinimumApiVersion_Fails()
         {
             // arrange
-            Mock<IModMetadata> mock = this.GetMetadata("Mod A", new string[0], allowStatusChange: true);
+            Mock<IModMetadata> mock = this.GetMetadata("Mod A", Array.Empty<string>(), allowStatusChange: true);
             mock.Setup(p => p.Manifest).Returns(this.GetManifest(minimumApiVersion: "1.1"));
             this.SetupMetadataForValidation(mock);
 
@@ -190,9 +190,9 @@ namespace SMAPI.Tests.Core
         public void ValidateManifests_DuplicateUniqueID_Fails()
         {
             // arrange
-            Mock<IModMetadata> modA = this.GetMetadata("Mod A", new string[0], allowStatusChange: true);
+            Mock<IModMetadata> modA = this.GetMetadata("Mod A", Array.Empty<string>(), allowStatusChange: true);
             Mock<IModMetadata> modB = this.GetMetadata(this.GetManifest(id: "Mod A", name: "Mod B", version: "1.0"), allowStatusChange: true);
-            Mock<IModMetadata> modC = this.GetMetadata("Mod C", new string[0], allowStatusChange: false);
+            Mock<IModMetadata> modC = this.GetMetadata("Mod C", Array.Empty<string>(), allowStatusChange: false);
             foreach (Mock<IModMetadata> mod in new[] { modA, modB, modC })
                 this.SetupMetadataForValidation(mod);
 
@@ -236,7 +236,7 @@ namespace SMAPI.Tests.Core
         public void ProcessDependencies_NoMods_DoesNothing()
         {
             // act
-            IModMetadata[] mods = new ModResolver().ProcessDependencies(new IModMetadata[0], new ModDatabase()).ToArray();
+            IModMetadata[] mods = new ModResolver().ProcessDependencies(Array.Empty<IModMetadata>(), new ModDatabase()).ToArray();
 
             // assert
             Assert.AreEqual(0, mods.Length, 0, "Expected to get an empty list of mods.");
@@ -490,8 +490,8 @@ namespace SMAPI.Tests.Core
                 EntryDll = entryDll ?? $"{Sample.String()}.dll",
                 ContentPackFor = contentPackForID != null ? new ManifestContentPackFor { UniqueID = contentPackForID } : null,
                 MinimumApiVersion = minimumApiVersion != null ? new SemanticVersion(minimumApiVersion) : null,
-                Dependencies = dependencies ?? new IManifestDependency[0],
-                UpdateKeys = new string[0]
+                Dependencies = dependencies ?? Array.Empty<IManifestDependency>(),
+                UpdateKeys = Array.Empty<string>()
             };
         }
 
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
index 2f58a3f1..0115fbf3 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
@@ -1,3 +1,5 @@
+using System;
+
 namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
 {
     /// <summary>Metadata about a mod.</summary>
@@ -16,6 +18,6 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         public ModExtendedMetadataModel Metadata { get; set; }
 
         /// <summary>The errors that occurred while fetching update data.</summary>
-        public string[] Errors { get; set; } = new string[0];
+        public string[] Errors { get; set; } = Array.Empty<string>();
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
index 5c2ce366..0fa4a74d 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
@@ -17,7 +18,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         ** Mod info
         ****/
         /// <summary>The mod's unique ID. A mod may have multiple current IDs in rare cases (e.g. due to parallel releases or unofficial updates).</summary>
-        public string[] ID { get; set; } = new string[0];
+        public string[] ID { get; set; } = Array.Empty<string>();
 
         /// <summary>The mod's display name.</summary>
         public string Name { get; set; }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
index bf81e102..404d4618 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
@@ -1,3 +1,5 @@
+using System;
+
 namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
 {
     /// <summary>Specifies the identifiers for a mod to match.</summary>
@@ -37,7 +39,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         {
             this.ID = id;
             this.InstalledVersion = installedVersion;
-            this.UpdateKeys = updateKeys ?? new string[0];
+            this.UpdateKeys = updateKeys ?? Array.Empty<string>();
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
index f1feb44b..2ed255c8 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
@@ -179,7 +179,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                 errors = rawErrors.ToArray();
             }
             else
-                errors = new string[0];
+                errors = Array.Empty<string>();
 
             // build model
             return new ChangeDescriptor(
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index f85e82e1..0f5a0ec3 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -239,7 +239,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             string raw = this.GetAttribute(element, name);
             return !string.IsNullOrWhiteSpace(raw)
                 ? raw.Split(new[] { ',' }, StringSplitOptions.RemoveEmptyEntries).Select(p => p.Trim()).ToArray()
-                : new string[0];
+                : Array.Empty<string>();
         }
 
         /// <summary>Get an attribute value and parse it as an enum value.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
index 0587e09d..03c0d214 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
@@ -1,3 +1,5 @@
+using System;
+
 #nullable enable
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
@@ -9,7 +11,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         ** Accessors
         *********/
         /// <summary>The unique mod IDs for the mods to override.</summary>
-        public string[] Ids { get; set; } = new string[0];
+        public string[] Ids { get; set; } = Array.Empty<string>();
 
         /// <summary>Maps local versions to a semantic version for update checks.</summary>
         public ChangeDescriptor? ChangeLocalVersions { get; set; }
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
index a9da884a..5b7e2a02 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         *********/
         /// <summary>Construct an empty instance.</summary>
         public ModDatabase()
-        : this(new ModDataRecord[0], key => null) { }
+        : this(Array.Empty<ModDataRecord>(), key => null) { }
 
         /// <summary>Construct an instance.</summary>
         /// <param name="records">The underlying mod data records indexed by default display name.</param>
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 46b654a5..4ad97b6d 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.Runtime.Serialization;
 using Newtonsoft.Json;
@@ -68,7 +69,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
             this.Description = description;
             this.Version = version;
             this.UniqueID = uniqueID;
-            this.UpdateKeys = new string[0];
+            this.UpdateKeys = Array.Empty<string>();
             this.ContentPackFor = new ManifestContentPackFor { UniqueID = contentPackFor };
         }
 
@@ -77,8 +78,8 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         [OnDeserialized]
         public void OnDeserialized(StreamingContext context)
         {
-            this.Dependencies ??= new IManifestDependency[0];
-            this.UpdateKeys ??= new string[0];
+            this.Dependencies ??= Array.Empty<IManifestDependency>();
+            this.UpdateKeys ??= Array.Empty<string>();
         }
     }
 }
diff --git a/src/SMAPI.Web/Controllers/IndexController.cs b/src/SMAPI.Web/Controllers/IndexController.cs
index f2f4c342..5097997c 100644
--- a/src/SMAPI.Web/Controllers/IndexController.cs
+++ b/src/SMAPI.Web/Controllers/IndexController.cs
@@ -96,7 +96,7 @@ namespace StardewModdingAPI.Web.Controllers
                 {
                     HtmlDocument doc = new HtmlDocument();
                     doc.LoadHtml(release.Body);
-                    foreach (HtmlNode node in doc.DocumentNode.SelectNodes("//*[@class='noinclude']")?.ToArray() ?? new HtmlNode[0])
+                    foreach (HtmlNode node in doc.DocumentNode.SelectNodes("//*[@class='noinclude']")?.ToArray() ?? Array.Empty<HtmlNode>())
                         node.Remove();
                     release.Body = doc.DocumentNode.InnerHtml.Trim();
                 }
diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index 37d763cc..dfe2504b 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -79,7 +79,7 @@ namespace StardewModdingAPI.Web.Controllers
         public async Task<IEnumerable<ModEntryModel>> PostAsync([FromBody] ModSearchModel model, [FromRoute] string version)
         {
             if (model?.Mods == null)
-                return new ModEntryModel[0];
+                return Array.Empty<ModEntryModel>();
 
             ModUpdateCheckConfig config = this.Config.Value;
 
diff --git a/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs b/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
index 064a7c3c..d037a123 100644
--- a/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
@@ -15,7 +15,7 @@ namespace StardewModdingAPI.Web.Framework.Caching.Wiki
         private Cached<WikiMetadata> Metadata;
 
         /// <summary>The cached wiki data.</summary>
-        private Cached<WikiModEntry>[] Mods = new Cached<WikiModEntry>[0];
+        private Cached<WikiModEntry>[] Mods = Array.Empty<Cached<WikiModEntry>>();
 
 
         /*********
diff --git a/src/SMAPI.Web/Framework/Clients/GenericModPage.cs b/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
index 622e6c56..a5f7c9b9 100644
--- a/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
+++ b/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
@@ -26,7 +27,7 @@ namespace StardewModdingAPI.Web.Framework.Clients
         public string Url { get; set; }
 
         /// <summary>The mod downloads.</summary>
-        public IModDownload[] Downloads { get; set; } = new IModDownload[0];
+        public IModDownload[] Downloads { get; set; } = Array.Empty<IModDownload>();
 
         /// <summary>The mod availability status on the remote site.</summary>
         public RemoteModStatus Status { get; set; } = RemoteModStatus.Ok;
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
index 87b20eb0..693a16ec 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
@@ -42,7 +42,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         public DateTimeOffset Timestamp { get; set; }
 
         /// <summary>Metadata about installed mods and content packs.</summary>
-        public LogModInfo[] Mods { get; set; } = new LogModInfo[0];
+        public LogModInfo[] Mods { get; set; } = Array.Empty<LogModInfo>();
 
         /// <summary>The log messages.</summary>
         public LogMessage[] Messages { get; set; }
diff --git a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
index 0ea69911..e659b389 100644
--- a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
+++ b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
@@ -26,7 +26,7 @@ namespace StardewModdingAPI.Web.ViewModels.JsonValidator
         public string Content { get; set; }
 
         /// <summary>The schema validation errors, if any.</summary>
-        public JsonValidatorErrorModel[] Errors { get; set; } = new JsonValidatorErrorModel[0];
+        public JsonValidatorErrorModel[] Errors { get; set; } = Array.Empty<JsonValidatorErrorModel>();
 
         /// <summary>A non-blocking warning while uploading the file.</summary>
         public string UploadWarning { get; set; }
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 91fc3535..993e7244 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -15,7 +15,7 @@
 
     string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true);
 
-    ISet<int> screenIds = new HashSet<int>(Model.ParsedLog?.Messages?.Select(p => p.ScreenId) ?? new int[0]);
+    ISet<int> screenIds = new HashSet<int>(Model.ParsedLog?.Messages?.Select(p => p.ScreenId) ?? Array.Empty<int>());
 }
 
 @section Head {
diff --git a/src/SMAPI.Web/Views/Mods/Index.cshtml b/src/SMAPI.Web/Views/Mods/Index.cshtml
index 8a764803..416468e4 100644
--- a/src/SMAPI.Web/Views/Mods/Index.cshtml
+++ b/src/SMAPI.Web/Views/Mods/Index.cshtml
@@ -19,7 +19,7 @@
     <script src="~/Content/js/mods.js?r=20210929"></script>
     <script>
         $(function() {
-            var data = @this.ForJson(Model.Mods ?? new ModModel[0]);
+            var data = @(this.ForJson(Model.Mods ?? Array.Empty<ModModel>()));
             var enableBeta = @this.ForJson(hasBeta);
             smapi.modList(data, enableBeta);
         });
diff --git a/src/SMAPI/Events/ButtonsChangedEventArgs.cs b/src/SMAPI/Events/ButtonsChangedEventArgs.cs
index dda41692..a5e87735 100644
--- a/src/SMAPI/Events/ButtonsChangedEventArgs.cs
+++ b/src/SMAPI/Events/ButtonsChangedEventArgs.cs
@@ -58,7 +58,7 @@ namespace StardewModdingAPI.Events
             foreach (var state in new[] { SButtonState.Pressed, SButtonState.Held, SButtonState.Released })
             {
                 if (!lookup.ContainsKey(state))
-                    lookup[state] = new SButton[0];
+                    lookup[state] = Array.Empty<SButton>();
             }
 
             return lookup;
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index fa20a079..f48c3aeb 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -21,7 +21,7 @@ namespace StardewModdingAPI.Framework.Events
         private readonly List<ManagedEventHandler<TEventArgs>> Handlers = new List<ManagedEventHandler<TEventArgs>>();
 
         /// <summary>A cached snapshot of <see cref="Handlers"/>, or <c>null</c> to rebuild it next raise.</summary>
-        private ManagedEventHandler<TEventArgs>[] CachedHandlers = new ManagedEventHandler<TEventArgs>[0];
+        private ManagedEventHandler<TEventArgs>[] CachedHandlers = Array.Empty<ManagedEventHandler<TEventArgs>>();
 
         /// <summary>The total number of event handlers registered for this events, regardless of whether they're still registered.</summary>
         private int RegistrationIndex;
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 10bf9f94..9174aea6 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -92,9 +92,9 @@ namespace StardewModdingAPI.Framework.Models
                     custom[pair.Key] = value;
             }
 
-            HashSet<string> curSuppressUpdateChecks = new HashSet<string>(this.SuppressUpdateChecks ?? new string[0], StringComparer.OrdinalIgnoreCase);
+            HashSet<string> curSuppressUpdateChecks = new HashSet<string>(this.SuppressUpdateChecks ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
             if (SConfig.DefaultSuppressUpdateChecks.Count != curSuppressUpdateChecks.Count || SConfig.DefaultSuppressUpdateChecks.Any(p => !curSuppressUpdateChecks.Contains(p)))
-                custom[nameof(this.SuppressUpdateChecks)] = "[" + string.Join(", ", this.SuppressUpdateChecks ?? new string[0]) + "]";
+                custom[nameof(this.SuppressUpdateChecks)] = "[" + string.Join(", ", this.SuppressUpdateChecks ?? Array.Empty<string>()) + "]";
 
             return custom;
         }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 55a7f083..ef1f12fd 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1244,7 +1244,7 @@ namespace StardewModdingAPI.Framework
                     {
                         using RegistryKey key = Registry.LocalMachine.OpenSubKey(registryKey);
                         if (key == null)
-                            return new string[0];
+                            return Array.Empty<string>();
 
                         return key
                             .GetSubKeyNames()
@@ -1567,13 +1567,13 @@ namespace StardewModdingAPI.Framework
         /// <param name="list">A list of interceptors to update for the change.</param>
         private void OnAssetInterceptorsChanged<T>(IModMetadata mod, IEnumerable<T> added, IEnumerable<T> removed, IList<ModLinked<T>> list)
         {
-            foreach (T interceptor in added ?? new T[0])
+            foreach (T interceptor in added ?? Array.Empty<T>())
             {
                 this.ReloadAssetInterceptorsQueue.Add(new AssetInterceptorChange(mod, interceptor, wasAdded: true));
                 list.Add(new ModLinked<T>(mod, interceptor));
             }
 
-            foreach (T interceptor in removed ?? new T[0])
+            foreach (T interceptor in removed ?? Array.Empty<T>())
             {
                 this.ReloadAssetInterceptorsQueue.Add(new AssetInterceptorChange(mod, interceptor, wasAdded: false));
                 foreach (ModLinked<T> entry in list.Where(p => p.Mod == mod && object.ReferenceEquals(p.Data, interceptor)).ToArray())
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
index 30e6274f..009e0282 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
@@ -16,10 +17,10 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         public bool IsChanged { get; } = false;
 
         /// <summary>The values added since the last reset.</summary>
-        public IEnumerable<TValue> Added { get; } = new TValue[0];
+        public IEnumerable<TValue> Added { get; } = Array.Empty<TValue>();
 
         /// <summary>The values removed since the last reset.</summary>
-        public IEnumerable<TValue> Removed { get; } = new TValue[0];
+        public IEnumerable<TValue> Removed { get; } = Array.Empty<TValue>();
 
 
         /*********
diff --git a/src/SMAPI/Framework/StateTracking/LocationTracker.cs b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
index 6d3a62bb..748e4ecc 100644
--- a/src/SMAPI/Framework/StateTracking/LocationTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using Microsoft.Xna.Framework;
@@ -84,7 +85,7 @@ namespace StardewModdingAPI.Framework.StateTracking
                 this.FurnitureWatcher
             });
 
-            this.UpdateChestWatcherList(added: location.Objects.Pairs, removed: new KeyValuePair<Vector2, SObject>[0]);
+            this.UpdateChestWatcherList(added: location.Objects.Pairs, removed: Array.Empty<KeyValuePair<Vector2, SObject>>());
         }
 
         /// <summary>Update the current value if needed.</summary>
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
index 0908b02a..72f45a87 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         ** Fields
         *********/
         /// <summary>An empty item list diff.</summary>
-        private readonly SnapshotItemListDiff EmptyItemListDiff = new SnapshotItemListDiff(new Item[0], new Item[0], new ItemStackSizeChange[0]);
+        private readonly SnapshotItemListDiff EmptyItemListDiff = new SnapshotItemListDiff(Array.Empty<Item>(), Array.Empty<Item>(), Array.Empty<ItemStackSizeChange>());
 
 
         /*********
diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
index 9d63ab2c..173438f1 100644
--- a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -24,7 +24,7 @@ namespace MonoMod.Utils
     {
         // .NET Framework can break member ordering if using Module.Resolve* on certain members.
 
-        private static object[] _NoArgs = new object[0];
+        private static object[] _NoArgs = Array.Empty<object>();
         private static object[] _CacheGetterArgs = { /* MemberListType.All */ 0, /* name apparently always null? */ null };
 
         private static Type t_RuntimeModule =
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 552bc000..73c212a4 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1275,7 +1275,7 @@ namespace StardewModdingAPI.Metadata
         {
             return path != null
                 ? PathUtilities.GetSegments(path)
-                : new string[0];
+                : Array.Empty<string>();
         }
 
         /// <summary>Count the number of segments in a path (e.g. 'a/b' is 2).</summary>
diff --git a/src/SMAPI/Utilities/Keybind.cs b/src/SMAPI/Utilities/Keybind.cs
index 87b867a9..403ecf4a 100644
--- a/src/SMAPI/Utilities/Keybind.cs
+++ b/src/SMAPI/Utilities/Keybind.cs
@@ -48,7 +48,7 @@ namespace StardewModdingAPI.Utilities
             if (string.IsNullOrWhiteSpace(input))
             {
                 parsed = new Keybind(SButton.None);
-                errors = new string[0];
+                errors = Array.Empty<string>();
                 return true;
             }
 
@@ -97,7 +97,7 @@ namespace StardewModdingAPI.Utilities
             else
             {
                 parsed = new Keybind(buttons);
-                errors = new string[0];
+                errors = Array.Empty<string>();
                 return true;
             }
         }
diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
index 28cae240..f8f569af 100644
--- a/src/SMAPI/Utilities/KeybindList.cs
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -55,7 +55,7 @@ namespace StardewModdingAPI.Utilities
             if (string.IsNullOrWhiteSpace(input))
             {
                 parsed = new KeybindList();
-                errors = new string[0];
+                errors = Array.Empty<string>();
                 return true;
             }
 
@@ -83,7 +83,7 @@ namespace StardewModdingAPI.Utilities
             else
             {
                 parsed = new KeybindList(keybinds.ToArray());
-                errors = new string[0];
+                errors = Array.Empty<string>();
                 return true;
             }
         }

From 4a1174cd5086ac615b9218384853a6ad2831b603 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Feb 2022 20:56:25 -0500
Subject: [PATCH 430/856] fix thumbstick input overrides

---
 docs/release-notes.md                            | 1 +
 src/SMAPI/Framework/Input/GamePadStateBuilder.cs | 8 ++++----
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 585644ef..18187e49 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,7 @@
 
 * For mod authors:
   * The `SDate` constructor is no longer case-sensitive for season names.
+  * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
 
 * For console commands:
   * Fixed `player_add` with Journal Scraps and Secret Notes.
diff --git a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
index b0bb7f80..3a99214f 100644
--- a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
@@ -104,10 +104,10 @@ namespace StardewModdingAPI.Framework.Input
                         this.LeftStickPos.Y = isDown ? 1 : 0;
                         break;
                     case SButton.LeftThumbstickDown:
-                        this.LeftStickPos.Y = isDown ? 1 : 0;
+                        this.LeftStickPos.Y = isDown ? -1 : 0;
                         break;
                     case SButton.LeftThumbstickLeft:
-                        this.LeftStickPos.X = isDown ? 1 : 0;
+                        this.LeftStickPos.X = isDown ? -1 : 0;
                         break;
                     case SButton.LeftThumbstickRight:
                         this.LeftStickPos.X = isDown ? 1 : 0;
@@ -118,10 +118,10 @@ namespace StardewModdingAPI.Framework.Input
                         this.RightStickPos.Y = isDown ? 1 : 0;
                         break;
                     case SButton.RightThumbstickDown:
-                        this.RightStickPos.Y = isDown ? 1 : 0;
+                        this.RightStickPos.Y = isDown ? -1 : 0;
                         break;
                     case SButton.RightThumbstickLeft:
-                        this.RightStickPos.X = isDown ? 1 : 0;
+                        this.RightStickPos.X = isDown ? -1 : 0;
                         break;
                     case SButton.RightThumbstickRight:
                         this.RightStickPos.X = isDown ? 1 : 0;

From b0cc403098161ad82b858008e2523e1d2496fc41 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 12 Feb 2022 12:07:13 -0500
Subject: [PATCH 431/856] add data-* attributes to log parser for external
 tools

---
 docs/release-notes.md                         |  1 +
 .../Framework/LogParsing/Models/LogModInfo.cs |  3 ++
 src/SMAPI.Web/ViewModels/LogParserModel.cs    |  2 +-
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 53 ++++++++++++-------
 4 files changed, 38 insertions(+), 21 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 18187e49..5e004227 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
   * Fixed `player_add` with Journal Scraps and Secret Notes.
 
 * For the web UI:
+  * Added `data-*` attributes to log parser page for external tools.
   * Fixed JSON validator warning for update keys without a subkey.
 
 ## 3.13.4
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
index 067e4df4..92bfe5c7 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
@@ -35,5 +35,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
 
         /// <summary>Whether the mod has an update available.</summary>
         public bool HasUpdate => this.UpdateVersion != null && this.Version != this.UpdateVersion;
+
+        /// <summary>Whether the mod is a content pack for another mod.</summary>
+        public bool IsContentPack => !string.IsNullOrWhiteSpace(this.ContentPackFor);
     }
 }
diff --git a/src/SMAPI.Web/ViewModels/LogParserModel.cs b/src/SMAPI.Web/ViewModels/LogParserModel.cs
index bea79eae..0b6d7722 100644
--- a/src/SMAPI.Web/ViewModels/LogParserModel.cs
+++ b/src/SMAPI.Web/ViewModels/LogParserModel.cs
@@ -83,7 +83,7 @@ namespace StardewModdingAPI.Web.ViewModels
 
             // group by mod
             return mods
-                .Where(mod => mod.ContentPackFor != null)
+                .Where(mod => mod.IsContentPack)
                 .GroupBy(mod => mod.ContentPackFor)
                 .ToDictionary(group => group.Key, group => group.ToArray());
         }
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 993e7244..b54867b1 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -7,6 +7,9 @@
 
 @{
     ViewData["Title"] = "SMAPI log parser";
+
+    ParsedLog log = Model!.ParsedLog;
+
     IDictionary<string, LogModInfo[]> contentPacks = Model.GetContentPacksByMod();
     IDictionary<string, bool> defaultFilters = Enum
         .GetValues(typeof(LogLevel))
@@ -15,7 +18,7 @@
 
     string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true);
 
-    ISet<int> screenIds = new HashSet<int>(Model.ParsedLog?.Messages?.Select(p => p.ScreenId) ?? Array.Empty<int>());
+    ISet<int> screenIds = new HashSet<int>(log?.Messages?.Select(p => p.ScreenId) ?? Array.Empty<int>());
 }
 
 @section Head {
@@ -35,9 +38,9 @@
     <script>
         $(function() {
             smapi.logParser({
-                logStarted: new Date(@this.ForJson(Model.ParsedLog?.Timestamp)),
-                showPopup: @this.ForJson(Model.ParsedLog == null),
-                showMods: @this.ForJson(Model.ParsedLog?.Mods?.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, slug => true)),
+                logStarted: new Date(@this.ForJson(log?.Timestamp)),
+                showPopup: @this.ForJson(log == null),
+                showMods: @this.ForJson(log?.Mods?.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, slug => true)),
                 showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, section => false)),
                 showLevels: @this.ForJson(defaultFilters),
                 enableFilters: @this.ForJson(!Model.ShowRaw),
@@ -67,7 +70,7 @@ else if (Model.ParseError != null)
         <small v-pre>Error details: @Model.ParseError</small>
     </div>
 }
-else if (Model.ParsedLog?.IsValid == true)
+else if (log?.IsValid == true)
 {
     <div class="banner success" v-pre>
         <strong>Share this link to let someone else see the log:</strong> <code>@curPageUrl</code><br />
@@ -92,7 +95,7 @@ else if (Model.ParsedLog?.IsValid == true)
 }
 
 @* upload new log *@
-@if (Model.ParsedLog == null)
+@if (log == null)
 {
     <h2>Where do I find my SMAPI log?</h2>
     <div id="os-instructions">
@@ -157,7 +160,7 @@ else if (Model.ParsedLog?.IsValid == true)
     </div>
 
     <h2>How do I share my log?</h2>
-    <form action="@this.Url.PlainAction("PostAsync", "LogParser")" method="post">
+    <form action="@this.Url.PlainAction("Post", "LogParser")" method="post">
         <input id="inputFile" type="file" />
         <ol>
             <li>
@@ -174,10 +177,10 @@ else if (Model.ParsedLog?.IsValid == true)
 }
 
 @* parsed log *@
-@if (Model.ParsedLog?.IsValid == true)
+@if (log?.IsValid == true)
 {
     <div id="output">
-        @if (Model.ParsedLog.Mods.Any(mod => mod.HasUpdate))
+        @if (log.Mods.Any(mod => mod.HasUpdate))
         {
             <h2>Suggested fixes</h2>
             <ul id="fix-list">
@@ -185,7 +188,7 @@ else if (Model.ParsedLog?.IsValid == true)
                     Consider updating these mods to fix problems:
 
                     <table id="updates" class="table">
-                        @foreach (LogModInfo mod in Model.ParsedLog.Mods.Where(mod => (mod.HasUpdate && mod.ContentPackFor == null) || (contentPacks != null && contentPacks.TryGetValue(mod.Name, out LogModInfo[] contentPackList) && contentPackList.Any(pack => pack.HasUpdate))))
+                        @foreach (LogModInfo mod in log.Mods.Where(mod => (mod.HasUpdate && !mod.IsContentPack) || (contentPacks.TryGetValue(mod.Name, out LogModInfo[] contentPackList) && contentPackList.Any(pack => pack.HasUpdate))))
                         {
                             <tr class="mod-entry">
                                 <td>
@@ -230,23 +233,33 @@ else if (Model.ParsedLog?.IsValid == true)
         }
 
         <h2>Log info</h2>
-        <table id="metadata" class="table">
+        <table
+            id="metadata"
+            class="table"
+            data-code-mods="@log.Mods.Count(p => !p.IsContentPack)"
+            data-content-packs="@log.Mods.Count(p => p.IsContentPack)"
+            data-os="@log.OperatingSystem"
+            data-game-version="@log.GameVersion"
+            data-game-path="@log.GamePath"
+            data-smapi-version="@log.ApiVersion"
+            data-log-started="@log.Timestamp.UtcDateTime.ToString("O")"
+        >
             <caption>Game info:</caption>
             <tr>
                 <th>Stardew Valley:</th>
-                <td v-pre>@Model.ParsedLog.GameVersion on @Model.ParsedLog.OperatingSystem</td>
+                <td v-pre>@log.GameVersion on @log.OperatingSystem</td>
             </tr>
             <tr>
                 <th>SMAPI:</th>
-                <td v-pre>@Model.ParsedLog.ApiVersion</td>
+                <td v-pre>@log.ApiVersion</td>
             </tr>
             <tr>
                 <th>Folder:</th>
-                <td v-pre>@Model.ParsedLog.GamePath</td>
+                <td v-pre>@log.GamePath</td>
             </tr>
             <tr>
                 <th>Log started:</th>
-                <td>@Model.ParsedLog.Timestamp.UtcDateTime.ToString("yyyy-MM-dd HH:mm") UTC ({{localTimeStarted}} your time)</td>
+                <td>@log.Timestamp.UtcDateTime.ToString("yyyy-MM-dd HH:mm") UTC ({{localTimeStarted}} your time)</td>
             </tr>
         </table>
         <br />
@@ -260,7 +273,7 @@ else if (Model.ParsedLog?.IsValid == true)
                     <span class="notice btn txt" v-on:click="hideAllMods" v-bind:class="{ invisible: !anyModsShown || !anyModsHidden }">hide all</span>
                 }
             </caption>
-            @foreach (var mod in Model.ParsedLog.Mods.Where(p => p.Loaded && p.ContentPackFor == null))
+            @foreach (var mod in log.Mods.Where(p => p.Loaded && !p.IsContentPack))
             {
                 <tr v-on:click="toggleMod('@Model.GetSlug(mod.Name)')" class="mod-entry" v-bind:class="{ hidden: !showMods['@Model.GetSlug(mod.Name)'] }">
                     <td><input type="checkbox" v-bind:checked="showMods['@Model.GetSlug(mod.Name)']" v-bind:class="{ invisible: !anyModsHidden }" /></td>
@@ -317,7 +330,7 @@ else if (Model.ParsedLog?.IsValid == true)
             </div>
 
             <table id="log">
-                @foreach (var message in Model.ParsedLog.Messages)
+                @foreach (var message in log.Messages)
                 {
                     string levelStr = message.Level.ToString().ToLower();
                     string sectionStartClass = message.IsStartOfSection ? "section-start" : null;
@@ -360,7 +373,7 @@ else if (Model.ParsedLog?.IsValid == true)
         }
         else
         {
-            <pre v-pre>@Model.ParsedLog.RawText</pre>
+            <pre v-pre>@log.RawText</pre>
         }
 
         <small>
@@ -377,8 +390,8 @@ else if (Model.ParsedLog?.IsValid == true)
         </small>
     </div>
 }
-else if (Model.ParsedLog?.IsValid == false)
+else if (log?.IsValid == false)
 {
     <h3>Raw log</h3>
-    <pre v-pre>@Model.ParsedLog.RawText</pre>
+    <pre v-pre>@log.RawText</pre>
 }

From f53ace623523ea1c304f59b187c478634481cbd2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 13 Feb 2022 00:41:44 -0500
Subject: [PATCH 432/856] simplify and standardize key comparison in asset
 propagator

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 37 ++++++++++++++---------
 1 file changed, 22 insertions(+), 15 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 73c212a4..9089a1e9 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -170,7 +170,7 @@ namespace StardewModdingAPI.Metadata
             {
                 foreach (TileSheet tilesheet in Game1.currentLocation.map.TileSheets)
                 {
-                    if (this.NormalizeAssetNameIgnoringEmpty(tilesheet.ImageSource) == key)
+                    if (this.IsSameAssetKey(tilesheet.ImageSource, key))
                         Game1.mapDisplayDevice.LoadTileSheet(tilesheet);
                 }
             }
@@ -188,7 +188,7 @@ namespace StardewModdingAPI.Metadata
                     {
                         GameLocation location = info.Location;
 
-                        if (!string.IsNullOrWhiteSpace(location.mapPath.Value) && this.NormalizeAssetNameIgnoringEmpty(location.mapPath.Value) == key)
+                        if (this.IsSameAssetKey(location.mapPath.Value, key))
                         {
                             static ISet<string> GetWarpSet(GameLocation location)
                             {
@@ -653,7 +653,7 @@ namespace StardewModdingAPI.Metadata
             // find matches
             TAnimal[] animals = this.GetCharacters()
                 .OfType<TAnimal>()
-                .Where(p => key == this.NormalizeAssetNameIgnoringEmpty(p.Sprite?.Texture?.Name))
+                .Where(p => this.IsSameAssetKey(p.Sprite?.Texture?.Name, key))
                 .ToArray();
             if (!animals.Any())
                 return false;
@@ -690,7 +690,7 @@ namespace StardewModdingAPI.Metadata
                 expectedKey = $"Animals\\{expectedKey}";
 
                 // reload asset
-                if (expectedKey == key)
+                if (this.IsSameAssetKey(expectedKey, key))
                     animal.Sprite.spriteTexture = texture.Value;
             }
             return texture.IsValueCreated;
@@ -747,9 +747,7 @@ namespace StardewModdingAPI.Metadata
                 {
                     foreach (MapSeat seat in location.mapSeats.Where(p => p != null))
                     {
-                        string curKey = this.NormalizeAssetNameIgnoringEmpty(seat._loadedTextureFile);
-
-                        if (curKey == null || key.Equals(curKey, StringComparison.OrdinalIgnoreCase))
+                        if (this.IsSameAssetKey(seat._loadedTextureFile, key))
                             seat.overlayTexture = MapSeat.mapChairTexture;
                     }
                 }
@@ -770,7 +768,7 @@ namespace StardewModdingAPI.Metadata
                     from location in this.GetLocations()
                     where location.critters != null
                     from Critter critter in location.critters
-                    where this.NormalizeAssetNameIgnoringEmpty(critter.sprite?.Texture?.Name) == key
+                    where this.IsSameAssetKey(critter.sprite?.Texture?.Name, key)
                     select critter
                 )
                 .ToArray();
@@ -804,11 +802,9 @@ namespace StardewModdingAPI.Metadata
                     if (door?.Sprite == null)
                         continue;
 
-                    string textureName = this.NormalizeAssetNameIgnoringEmpty(this.Reflection.GetField<string>(door.Sprite, "textureName").GetValue());
-                    if (textureName != key)
-                        continue;
-
-                    door.Sprite.texture = texture.Value;
+                    string curKey = this.Reflection.GetField<string>(door.Sprite, "textureName").GetValue();
+                    if (this.IsSameAssetKey(curKey, key))
+                        door.Sprite.texture = texture.Value;
                 }
             }
 
@@ -867,7 +863,7 @@ namespace StardewModdingAPI.Metadata
                 (
                     from location in this.GetLocations()
                     from grass in location.terrainFeatures.Values.OfType<Grass>()
-                    where this.NormalizeAssetNameIgnoringEmpty(grass.textureName()) == key
+                    where this.IsSameAssetKey(grass.textureName(), key)
                     select grass
                 )
                 .ToArray();
@@ -1024,7 +1020,7 @@ namespace StardewModdingAPI.Metadata
             Farmer[] players =
                 (
                     from player in Game1.getOnlineFarmers()
-                    where key == this.NormalizeAssetNameIgnoringEmpty(player.getTexture())
+                    where this.IsSameAssetKey(player.getTexture(), key)
                     select player
                 )
                 .ToArray();
@@ -1247,6 +1243,17 @@ namespace StardewModdingAPI.Metadata
             return this.AssertAndNormalizeAssetName(path);
         }
 
+        /// <summary>Get whether a given asset key is equivalent to a normalized asset key, ignoring unimportant differences like capitalization and formatting.</summary>
+        /// <param name="actualKey">The actual key to check.</param>
+        /// <param name="normalizedKey">The key to match, already normalized via <see cref="AssertAndNormalizeAssetName"/> or <see cref="NormalizeAssetNameIgnoringEmpty"/>.</param>
+        private bool IsSameAssetKey(string actualKey, string normalizedKey)
+        {
+            if (actualKey is null || normalizedKey is null)
+                return false;
+
+            return normalizedKey.Equals(PathUtilities.NormalizeAssetName(actualKey), StringComparison.OrdinalIgnoreCase);
+        }
+
         /// <summary>Get whether a key starts with a substring after the substring is normalized.</summary>
         /// <param name="key">The key to check.</param>
         /// <param name="rawSubstring">The substring to normalize and find.</param>

From 315926de25dc41c97a9a2351c92d5983a2e8df3e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 13 Feb 2022 00:43:35 -0500
Subject: [PATCH 433/856] flip slashes in asset propagator to match MonoGame

The game now uses MonoGame on all platforms.
---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 214 +++++++++++-----------
 1 file changed, 107 insertions(+), 107 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 9089a1e9..a6c4bb24 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -92,7 +92,7 @@ namespace StardewModdingAPI.Metadata
             // group into optimized lists
             var buckets = assets.GroupBy(p =>
             {
-                if (this.IsInFolder(p.Key, "Characters") || this.IsInFolder(p.Key, "Characters\\Monsters"))
+                if (this.IsInFolder(p.Key, "Characters") || this.IsInFolder(p.Key, "Characters/Monsters"))
                     return AssetBucket.Sprite;
 
                 if (this.IsInFolder(p.Key, "Portraits"))
@@ -214,22 +214,22 @@ namespace StardewModdingAPI.Metadata
             ** Propagate by key
             ****/
             Reflector reflection = this.Reflection;
-            switch (key.ToLower().Replace("/", "\\")) // normalized key so we can compare statically
+            switch (key.ToLower().Replace("\\", "/")) // normalized key so we can compare statically
             {
                 /****
                 ** Animals
                 ****/
-                case "animals\\horse":
+                case "animals/horse":
                     return !ignoreWorld && this.ReloadPetOrHorseSprites<Horse>(content, key);
 
                 /****
                 ** Buildings
                 ****/
-                case "buildings\\houses": // Farm
+                case "buildings/houses": // Farm
                     Farm.houseTextures = this.LoadAndDisposeIfNeeded(Farm.houseTextures, key);
                     return true;
 
-                case "buildings\\houses_paintmask": // Farm
+                case "buildings/houses_paintmask": // Farm
                     {
                         bool removedFromCache = this.RemoveFromPaintMaskCache(key);
 
@@ -242,149 +242,149 @@ namespace StardewModdingAPI.Metadata
                 /****
                 ** Content\Characters\Farmer
                 ****/
-                case "characters\\farmer\\accessories": // Game1.LoadContent
+                case "characters/farmer/accessories": // Game1.LoadContent
                     FarmerRenderer.accessoriesTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.accessoriesTexture, key);
                     return true;
 
-                case "characters\\farmer\\farmer_base": // Farmer
-                case "characters\\farmer\\farmer_base_bald":
-                case "characters\\farmer\\farmer_girl_base":
-                case "characters\\farmer\\farmer_girl_base_bald":
+                case "characters/farmer/farmer_base": // Farmer
+                case "characters/farmer/farmer_base_bald":
+                case "characters/farmer/farmer_girl_base":
+                case "characters/farmer/farmer_girl_base_bald":
                     return !ignoreWorld && this.ReloadPlayerSprites(key);
 
-                case "characters\\farmer\\hairstyles": // Game1.LoadContent
+                case "characters/farmer/hairstyles": // Game1.LoadContent
                     FarmerRenderer.hairStylesTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.hairStylesTexture, key);
                     return true;
 
-                case "characters\\farmer\\hats": // Game1.LoadContent
+                case "characters/farmer/hats": // Game1.LoadContent
                     FarmerRenderer.hatsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.hatsTexture, key);
                     return true;
 
-                case "characters\\farmer\\pants": // Game1.LoadContent
+                case "characters/farmer/pants": // Game1.LoadContent
                     FarmerRenderer.pantsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.pantsTexture, key);
                     return true;
 
-                case "characters\\farmer\\shirts": // Game1.LoadContent
+                case "characters/farmer/shirts": // Game1.LoadContent
                     FarmerRenderer.shirtsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.shirtsTexture, key);
                     return true;
 
                 /****
                 ** Content\Data
                 ****/
-                case "data\\achievements": // Game1.LoadContent
+                case "data/achievements": // Game1.LoadContent
                     Game1.achievements = content.Load<Dictionary<int, string>>(key);
                     return true;
 
-                case "data\\bigcraftablesinformation": // Game1.LoadContent
+                case "data/bigcraftablesinformation": // Game1.LoadContent
                     Game1.bigCraftablesInformation = content.Load<Dictionary<int, string>>(key);
                     return true;
 
-                case "data\\clothinginformation": // Game1.LoadContent
+                case "data/clothinginformation": // Game1.LoadContent
                     Game1.clothingInformation = content.Load<Dictionary<int, string>>(key);
                     return true;
 
-                case "data\\concessions": // MovieTheater.GetConcessions
+                case "data/concessions": // MovieTheater.GetConcessions
                     MovieTheater.ClearCachedLocalizedData();
                     return true;
 
-                case "data\\concessiontastes": // MovieTheater.GetConcessionTasteForCharacter
+                case "data/concessiontastes": // MovieTheater.GetConcessionTasteForCharacter
                     this.Reflection
                         .GetField<List<ConcessionTaste>>(typeof(MovieTheater), "_concessionTastes")
                         .SetValue(content.Load<List<ConcessionTaste>>(key));
                     return true;
 
-                case "data\\cookingrecipes": // CraftingRecipe.InitShared
+                case "data/cookingrecipes": // CraftingRecipe.InitShared
                     CraftingRecipe.cookingRecipes = content.Load<Dictionary<string, string>>(key);
                     return true;
 
-                case "data\\craftingrecipes": // CraftingRecipe.InitShared
+                case "data/craftingrecipes": // CraftingRecipe.InitShared
                     CraftingRecipe.craftingRecipes = content.Load<Dictionary<string, string>>(key);
                     return true;
 
-                case "data\\farmanimals": // FarmAnimal constructor
+                case "data/farmanimals": // FarmAnimal constructor
                     return !ignoreWorld && this.ReloadFarmAnimalData();
 
-                case "data\\hairdata": // Farmer.GetHairStyleMetadataFile
+                case "data/hairdata": // Farmer.GetHairStyleMetadataFile
                     return this.ReloadHairData();
 
-                case "data\\movies": // MovieTheater.GetMovieData
-                case "data\\moviesreactions": // MovieTheater.GetMovieReactions
+                case "data/movies": // MovieTheater.GetMovieData
+                case "data/moviesreactions": // MovieTheater.GetMovieReactions
                     MovieTheater.ClearCachedLocalizedData();
                     return true;
 
-                case "data\\npcdispositions": // NPC constructor
+                case "data/npcdispositions": // NPC constructor
                     return !ignoreWorld && this.ReloadNpcDispositions(content, key);
 
-                case "data\\npcgifttastes": // Game1.LoadContent
+                case "data/npcgifttastes": // Game1.LoadContent
                     Game1.NPCGiftTastes = content.Load<Dictionary<string, string>>(key);
                     return true;
 
-                case "data\\objectcontexttags": // Game1.LoadContent
+                case "data/objectcontexttags": // Game1.LoadContent
                     Game1.objectContextTags = content.Load<Dictionary<string, string>>(key);
                     return true;
 
-                case "data\\objectinformation": // Game1.LoadContent
+                case "data/objectinformation": // Game1.LoadContent
                     Game1.objectInformation = content.Load<Dictionary<int, string>>(key);
                     return true;
 
                 /****
                 ** Content\Fonts
                 ****/
-                case "fonts\\spritefont1": // Game1.LoadContent
+                case "fonts/spritefont1": // Game1.LoadContent
                     Game1.dialogueFont = content.Load<SpriteFont>(key);
                     return true;
 
-                case "fonts\\smallfont": // Game1.LoadContent
+                case "fonts/smallfont": // Game1.LoadContent
                     Game1.smallFont = content.Load<SpriteFont>(key);
                     return true;
 
-                case "fonts\\tinyfont": // Game1.LoadContent
+                case "fonts/tinyfont": // Game1.LoadContent
                     Game1.tinyFont = content.Load<SpriteFont>(key);
                     return true;
 
-                case "fonts\\tinyfontborder": // Game1.LoadContent
+                case "fonts/tinyfontborder": // Game1.LoadContent
                     Game1.tinyFontBorder = content.Load<SpriteFont>(key);
                     return true;
 
                 /****
                 ** Content\LooseSprites\Lighting
                 ****/
-                case "loosesprites\\lighting\\greenlight": // Game1.LoadContent
+                case "loosesprites/lighting/greenlight": // Game1.LoadContent
                     Game1.cauldronLight = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\lighting\\indoorwindowlight": // Game1.LoadContent
+                case "loosesprites/lighting/indoorwindowlight": // Game1.LoadContent
                     Game1.indoorWindowLight = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\lighting\\lantern": // Game1.LoadContent
+                case "loosesprites/lighting/lantern": // Game1.LoadContent
                     Game1.lantern = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\lighting\\sconcelight": // Game1.LoadContent
+                case "loosesprites/lighting/sconcelight": // Game1.LoadContent
                     Game1.sconceLight = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\lighting\\windowlight": // Game1.LoadContent
+                case "loosesprites/lighting/windowlight": // Game1.LoadContent
                     Game1.windowLight = content.Load<Texture2D>(key);
                     return true;
 
                 /****
                 ** Content\LooseSprites
                 ****/
-                case "loosesprites\\birds": // Game1.LoadContent
+                case "loosesprites/birds": // Game1.LoadContent
                     Game1.birdsSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\concessions": // Game1.LoadContent
+                case "loosesprites/concessions": // Game1.LoadContent
                     Game1.concessionsSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\controllermaps": // Game1.LoadContent
+                case "loosesprites/controllermaps": // Game1.LoadContent
                     Game1.controllerMaps = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\cursors": // Game1.LoadContent
+                case "loosesprites/cursors": // Game1.LoadContent
                     Game1.mouseCursors = content.Load<Texture2D>(key);
                     foreach (DayTimeMoneyBox menu in Game1.onScreenMenus.OfType<DayTimeMoneyBox>())
                     {
@@ -396,56 +396,56 @@ namespace StardewModdingAPI.Metadata
                         this.ReloadDoorSprites(content, key);
                     return true;
 
-                case "loosesprites\\cursors2": // Game1.LoadContent
+                case "loosesprites/cursors2": // Game1.LoadContent
                     Game1.mouseCursors2 = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\daybg": // Game1.LoadContent
+                case "loosesprites/daybg": // Game1.LoadContent
                     Game1.daybg = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\font_bold": // Game1.LoadContent
+                case "loosesprites/font_bold": // Game1.LoadContent
                     SpriteText.spriteTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\font_colored": // Game1.LoadContent
+                case "loosesprites/font_colored": // Game1.LoadContent
                     SpriteText.coloredTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\giftbox": // Game1.LoadContent
+                case "loosesprites/giftbox": // Game1.LoadContent
                     Game1.giftboxTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\nightbg": // Game1.LoadContent
+                case "loosesprites/nightbg": // Game1.LoadContent
                     Game1.nightbg = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\shadow": // Game1.LoadContent
+                case "loosesprites/shadow": // Game1.LoadContent
                     Game1.shadowTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "loosesprites\\suspensionbridge": // SuspensionBridge constructor
+                case "loosesprites/suspensionbridge": // SuspensionBridge constructor
                     return !ignoreWorld && this.ReloadSuspensionBridges(content, key);
 
                 /****
                 ** Content\Maps
                 ****/
-                case "maps\\menutiles": // Game1.LoadContent
+                case "maps/menutiles": // Game1.LoadContent
                     Game1.menuTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "maps\\menutilesuncolored": // Game1.LoadContent
+                case "maps/menutilesuncolored": // Game1.LoadContent
                     Game1.uncoloredMenuTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "maps\\springobjects": // Game1.LoadContent
+                case "maps/springobjects": // Game1.LoadContent
                     Game1.objectSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
                 /****
                 ** Content\Minigames
                 ****/
-                case "minigames\\clouds": // TitleMenu
+                case "minigames/clouds": // TitleMenu
                     {
                         if (Game1.activeClickableMenu is TitleMenu titleMenu)
                         {
@@ -455,127 +455,127 @@ namespace StardewModdingAPI.Metadata
                     }
                     return false;
 
-                case "minigames\\titlebuttons": // TitleMenu
+                case "minigames/titlebuttons": // TitleMenu
                     return this.ReloadTitleButtons(content, key);
 
                 /****
                 ** Content\Strings
                 ****/
-                case "strings\\stringsfromcsfiles":
+                case "strings/stringsfromcsfiles":
                     return this.ReloadStringsFromCsFiles(content);
 
                 /****
                 ** Content\TileSheets
                 ****/
-                case "tilesheets\\animations": // Game1.LoadContent
+                case "tilesheets/animations": // Game1.LoadContent
                     Game1.animations = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\buffsicons": // Game1.LoadContent
+                case "tilesheets/buffsicons": // Game1.LoadContent
                     Game1.buffsIcons = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\bushes": // new Bush()
+                case "tilesheets/bushes": // new Bush()
                     Bush.texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
                     return true;
 
-                case "tilesheets\\chairtiles": // Game1.LoadContent
+                case "tilesheets/chairtiles": // Game1.LoadContent
                     return this.ReloadChairTiles(content, key, ignoreWorld);
 
-                case "tilesheets\\craftables": // Game1.LoadContent
+                case "tilesheets/craftables": // Game1.LoadContent
                     Game1.bigCraftableSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\critters": // Critter constructor
+                case "tilesheets/critters": // Critter constructor
                     return !ignoreWorld && this.ReloadCritterTextures(content, key) > 0;
 
-                case "tilesheets\\crops": // Game1.LoadContent
+                case "tilesheets/crops": // Game1.LoadContent
                     Game1.cropSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\debris": // Game1.LoadContent
+                case "tilesheets/debris": // Game1.LoadContent
                     Game1.debrisSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\emotes": // Game1.LoadContent
+                case "tilesheets/emotes": // Game1.LoadContent
                     Game1.emoteSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\fruittrees": // FruitTree
+                case "tilesheets/fruittrees": // FruitTree
                     FruitTree.texture = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\furniture": // Game1.LoadContent
+                case "tilesheets/furniture": // Game1.LoadContent
                     Furniture.furnitureTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\furniturefront": // Game1.LoadContent
+                case "tilesheets/furniturefront": // Game1.LoadContent
                     Furniture.furnitureFrontTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\projectiles": // Game1.LoadContent
+                case "tilesheets/projectiles": // Game1.LoadContent
                     Projectile.projectileSheet = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\rain": // Game1.LoadContent
+                case "tilesheets/rain": // Game1.LoadContent
                     Game1.rainTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "tilesheets\\tools": // Game1.ResetToolSpriteSheet
+                case "tilesheets/tools": // Game1.ResetToolSpriteSheet
                     Game1.ResetToolSpriteSheet();
                     return true;
 
-                case "tilesheets\\weapons": // Game1.LoadContent
+                case "tilesheets/weapons": // Game1.LoadContent
                     Tool.weaponsTexture = content.Load<Texture2D>(key);
                     return true;
 
                 /****
                 ** Content\TerrainFeatures
                 ****/
-                case "terrainfeatures\\flooring": // from Flooring
+                case "terrainfeatures/flooring": // from Flooring
                     Flooring.floorsTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "terrainfeatures\\flooring_winter": // from Flooring
+                case "terrainfeatures/flooring_winter": // from Flooring
                     Flooring.floorsTextureWinter = content.Load<Texture2D>(key);
                     return true;
 
-                case "terrainfeatures\\grass": // from Grass
+                case "terrainfeatures/grass": // from Grass
                     return !ignoreWorld && this.ReloadGrassTextures(content, key);
 
-                case "terrainfeatures\\hoedirt": // from HoeDirt
+                case "terrainfeatures/hoedirt": // from HoeDirt
                     HoeDirt.lightTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "terrainfeatures\\hoedirtdark": // from HoeDirt
+                case "terrainfeatures/hoedirtdark": // from HoeDirt
                     HoeDirt.darkTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "terrainfeatures\\hoedirtsnow": // from HoeDirt
+                case "terrainfeatures/hoedirtsnow": // from HoeDirt
                     HoeDirt.snowTexture = content.Load<Texture2D>(key);
                     return true;
 
-                case "terrainfeatures\\mushroom_tree": // from Tree
+                case "terrainfeatures/mushroom_tree": // from Tree
                     return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.mushroomTree);
 
-                case "terrainfeatures\\tree_palm": // from Tree
+                case "terrainfeatures/tree_palm": // from Tree
                     return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.palmTree);
 
-                case "terrainfeatures\\tree1_fall": // from Tree
-                case "terrainfeatures\\tree1_spring": // from Tree
-                case "terrainfeatures\\tree1_summer": // from Tree
-                case "terrainfeatures\\tree1_winter": // from Tree
+                case "terrainfeatures/tree1_fall": // from Tree
+                case "terrainfeatures/tree1_spring": // from Tree
+                case "terrainfeatures/tree1_summer": // from Tree
+                case "terrainfeatures/tree1_winter": // from Tree
                     return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.bushyTree);
 
-                case "terrainfeatures\\tree2_fall": // from Tree
-                case "terrainfeatures\\tree2_spring": // from Tree
-                case "terrainfeatures\\tree2_summer": // from Tree
-                case "terrainfeatures\\tree2_winter": // from Tree
+                case "terrainfeatures/tree2_fall": // from Tree
+                case "terrainfeatures/tree2_spring": // from Tree
+                case "terrainfeatures/tree2_summer": // from Tree
+                case "terrainfeatures/tree2_winter": // from Tree
                     return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.leafyTree);
 
-                case "terrainfeatures\\tree3_fall": // from Tree
-                case "terrainfeatures\\tree3_spring": // from Tree
-                case "terrainfeatures\\tree3_winter": // from Tree
+                case "terrainfeatures/tree3_fall": // from Tree
+                case "terrainfeatures/tree3_spring": // from Tree
+                case "terrainfeatures/tree3_winter": // from Tree
                     return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.pineTree);
             }
 
@@ -585,9 +585,9 @@ namespace StardewModdingAPI.Metadata
             if (!ignoreWorld)
             {
                 // dynamic textures
-                if (this.KeyStartsWith(key, "animals\\cat"))
+                if (this.KeyStartsWith(key, "animals/cat"))
                     return this.ReloadPetOrHorseSprites<Cat>(content, key);
-                if (this.KeyStartsWith(key, "animals\\dog"))
+                if (this.KeyStartsWith(key, "animals/dog"))
                     return this.ReloadPetOrHorseSprites<Dog>(content, key);
                 if (this.IsInFolder(key, "Animals"))
                     return this.ReloadFarmAnimalSprites(content, key);
@@ -595,14 +595,14 @@ namespace StardewModdingAPI.Metadata
                 if (this.IsInFolder(key, "Buildings"))
                     return this.ReloadBuildings(key);
 
-                if (this.KeyStartsWith(key, "LooseSprites\\Fence"))
+                if (this.KeyStartsWith(key, "LooseSprites/Fence"))
                     return this.ReloadFenceTextures(key);
 
                 // dynamic data
-                if (this.IsInFolder(key, "Characters\\Dialogue"))
+                if (this.IsInFolder(key, "Characters/Dialogue"))
                     return this.ReloadNpcDialogue(key);
 
-                if (this.IsInFolder(key, "Characters\\schedules"))
+                if (this.IsInFolder(key, "Characters/schedules"))
                     return this.ReloadNpcSchedules(key);
             }
 
@@ -687,7 +687,7 @@ namespace StardewModdingAPI.Metadata
                     : animal.type.Value;
                 if (animal.showDifferentTextureWhenReadyForHarvest.Value && animal.currentProduce.Value <= 0)
                     expectedKey = $"Sheared{expectedKey}";
-                expectedKey = $"Animals\\{expectedKey}";
+                expectedKey = $"Animals/{expectedKey}";
 
                 // reload asset
                 if (this.IsSameAssetKey(expectedKey, key))
@@ -1153,17 +1153,17 @@ namespace StardewModdingAPI.Metadata
         /// <remarks>Derived from the <see cref="Game1.TranslateFields"/>.</remarks>
         private bool ReloadStringsFromCsFiles(LocalizedContentManager content)
         {
-            Game1.samBandName = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.2156");
-            Game1.elliottBookName = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.2157");
+            Game1.samBandName = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.2156");
+            Game1.elliottBookName = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.2157");
 
             string[] dayNames = this.Reflection.GetField<string[]>(typeof(Game1), "_shortDayDisplayName").GetValue();
-            dayNames[0] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3042");
-            dayNames[1] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3043");
-            dayNames[2] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3044");
-            dayNames[3] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3045");
-            dayNames[4] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3046");
-            dayNames[5] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3047");
-            dayNames[6] = content.LoadString("Strings\\StringsFromCSFiles:Game1.cs.3048");
+            dayNames[0] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3042");
+            dayNames[1] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3043");
+            dayNames[2] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3044");
+            dayNames[3] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3045");
+            dayNames[4] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3046");
+            dayNames[5] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3047");
+            dayNames[6] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3048");
 
             return true;
         }
@@ -1272,7 +1272,7 @@ namespace StardewModdingAPI.Metadata
         private bool IsInFolder(string key, string folder, bool allowSubfolders = false)
         {
             return
-                this.KeyStartsWith(key, $"{folder}\\")
+                this.KeyStartsWith(key, $"{folder}/")
                 && (allowSubfolders || this.CountSegments(key) == this.CountSegments(folder) + 1);
         }
 

From ba42bb97d1f1df07e87b02ee0e03eef0227ea5a7 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Wed, 16 Feb 2022 19:08:40 +0100
Subject: [PATCH 434/856] move proxying to a separate NuGet library

---
 build/common.targets                          |   1 +
 src/SMAPI.Tests/SMAPI.Tests.csproj            |   1 +
 .../Framework/ModHelpers/ModRegistryHelper.cs |  37 +-
 .../Reflection/InterfaceProxyBuilder.cs       | 405 ------------------
 .../Reflection/InterfaceProxyFactory.cs       |  84 ----
 .../Reflection/InterfaceProxyGlue.cs          |  34 --
 src/SMAPI/Framework/SCore.cs                  |  16 +-
 src/SMAPI/IModRegistry.cs                     |   7 -
 src/SMAPI/SMAPI.csproj                        |   1 +
 9 files changed, 20 insertions(+), 566 deletions(-)
 delete mode 100644 src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
 delete mode 100644 src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
 delete mode 100644 src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs

diff --git a/build/common.targets b/build/common.targets
index 86624b62..bcb0e9e1 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -53,6 +53,7 @@
     <Copy SourceFiles="$(TargetDir)\SMAPI.metadata.json" DestinationFiles="$(GamePath)\smapi-internal\metadata.json" />
     <Copy SourceFiles="$(TargetDir)\Newtonsoft.Json.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\TMXTile.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\Pintail.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\smapi-internal\i18n" />
 
     <!-- Harmony + dependencies -->
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 8329b2e1..e27dbecc 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -20,6 +20,7 @@
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="Pintail" Version="1.2.0" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 92c52b00..93ea6028 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using Nanoray.Pintail;
 using StardewModdingAPI.Framework.Reflection;
 
 namespace StardewModdingAPI.Framework.ModHelpers
@@ -19,7 +20,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         private readonly HashSet<string> AccessedModApis = new HashSet<string>();
 
         /// <summary>Generates proxy classes to access mod APIs through an arbitrary interface.</summary>
-        private readonly InterfaceProxyFactory ProxyFactory;
+        private readonly IProxyManager<string> ProxyManager;
 
 
         /*********
@@ -28,13 +29,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Construct an instance.</summary>
         /// <param name="modID">The unique ID of the relevant mod.</param>
         /// <param name="registry">The underlying mod registry.</param>
-        /// <param name="proxyFactory">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
+        /// <param name="proxyManager">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
         /// <param name="monitor">Encapsulates monitoring and logging for the mod.</param>
-        public ModRegistryHelper(string modID, ModRegistry registry, InterfaceProxyFactory proxyFactory, IMonitor monitor)
+        public ModRegistryHelper(string modID, ModRegistry registry, IProxyManager<string> proxyManager, IMonitor monitor)
             : base(modID)
         {
             this.Registry = registry;
-            this.ProxyFactory = proxyFactory;
+            this.ProxyManager = proxyManager;
             this.Monitor = monitor;
         }
 
@@ -96,33 +97,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             // get API of type
             if (api is TInterface castApi)
                 return castApi;
-            return this.ProxyFactory.CreateProxy<TInterface>(api, this.ModID, uniqueID);
-        }
-
-        /// <inheritdoc />
-        public bool TryProxy<TInterface>(string uniqueID, object toProxy, out TInterface proxy) where TInterface : class
-        {
-            try
-            {
-                foreach (var toProxyInterface in toProxy.GetType().GetInterfaces())
-                {
-                    var unproxyBuilder = this.ProxyFactory.ObtainBuilder(typeof(TInterface), toProxyInterface, this.ModID, uniqueID);
-                    if (unproxyBuilder.TryUnproxy(toProxy, out object targetInstance))
-                    {
-                        proxy = (TInterface)targetInstance;
-                        return true;
-                    }
-                }
-
-                var proxyBuilder = this.ProxyFactory.ObtainBuilder(toProxy.GetType(), typeof(TInterface), this.ModID, uniqueID);
-                proxy = (TInterface)proxyBuilder.ObtainInstance(toProxy, this.ProxyFactory);
-                return true;
-            }
-            catch
-            {
-                proxy = null;
-                return false;
-            }
+            return this.ProxyManager.ObtainProxy<string, TInterface>(api, this.ModID, uniqueID);
         }
     }
 }
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
deleted file mode 100644
index 81cfff50..00000000
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyBuilder.cs
+++ /dev/null
@@ -1,405 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Reflection;
-using System.Reflection.Emit;
-using System.Runtime.CompilerServices;
-
-namespace StardewModdingAPI.Framework.Reflection
-{
-    /// <summary>Generates a proxy class to access a mod API through an arbitrary interface.</summary>
-    internal class InterfaceProxyBuilder
-    {
-        /*********
-        ** Consts
-        *********/
-        private static readonly string TargetFieldName = "__Target";
-        private static readonly string GlueFieldName = "__Glue";
-        private static readonly MethodInfo ObtainInstanceForProxyTypeNameMethod = typeof(InterfaceProxyGlue).GetMethod(nameof(InterfaceProxyGlue.ObtainInstanceForProxyTypeName), new Type[] { typeof(string), typeof(object) });
-        private static readonly MethodInfo UnproxyOrObtainInstanceForProxyTypeNameMethod = typeof(InterfaceProxyGlue).GetMethod(nameof(InterfaceProxyGlue.UnproxyOrObtainInstanceForProxyTypeName), new Type[] { typeof(string), typeof(string), typeof(object) });
-
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The target class type.</summary>
-        private readonly Type TargetType;
-
-        /// <summary>The interfce type.</summary>
-        private readonly Type InterfaceType;
-
-        /// <summary>The full name of the generated proxy type.</summary>
-        private readonly string ProxyTypeName;
-
-        /// <summary>The generated proxy type.</summary>
-        private Type ProxyType;
-
-        /// <summary>A cache of all proxies generated by this builder.</summary>
-        private readonly ConditionalWeakTable<object, object> ProxyCache = new();
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="targetType">The target type.</param>
-        /// <param name="interfaceType">The interface type to implement.</param>
-        /// <param name="proxyTypeName">The type name to generate.</param>
-        public InterfaceProxyBuilder(Type targetType, Type interfaceType, string proxyTypeName)
-        {
-            // validate and store
-            this.TargetType = targetType ?? throw new ArgumentNullException(nameof(targetType));
-            this.InterfaceType = interfaceType ?? throw new ArgumentNullException(nameof(interfaceType));
-            this.ProxyTypeName = proxyTypeName ?? throw new ArgumentNullException(nameof(proxyTypeName));
-            if (!interfaceType.IsInterface)
-                throw new ArgumentException($"{nameof(interfaceType)} is not an interface.");
-        }
-
-
-        /// <summary>Creates and sets up the proxy type.</summary>
-        /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
-        /// <param name="moduleBuilder">The CLR module in which to create proxy classes.</param>
-        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
-        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
-        public void SetupProxyType(InterfaceProxyFactory factory, ModuleBuilder moduleBuilder, string sourceModID, string targetModID)
-        {
-            // define proxy type
-            TypeBuilder proxyBuilder = moduleBuilder.DefineType(this.ProxyTypeName, TypeAttributes.Public | TypeAttributes.Class);
-            proxyBuilder.AddInterfaceImplementation(this.InterfaceType);
-
-            // create fields to store target instance and proxy factory
-            FieldBuilder targetField = proxyBuilder.DefineField(TargetFieldName, this.TargetType, FieldAttributes.Private);
-            FieldBuilder glueField = proxyBuilder.DefineField(GlueFieldName, typeof(InterfaceProxyGlue), FieldAttributes.Private);
-
-            // create constructor which accepts target instance + factory, and sets fields
-            {
-                ConstructorBuilder constructor = proxyBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard | CallingConventions.HasThis, new[] { this.TargetType, typeof(InterfaceProxyGlue) });
-                ILGenerator il = constructor.GetILGenerator();
-
-                il.Emit(OpCodes.Ldarg_0); // this
-                // ReSharper disable once AssignNullToNotNullAttribute -- never null
-                il.Emit(OpCodes.Call, typeof(object).GetConstructor(Array.Empty<Type>())); // call base constructor
-                il.Emit(OpCodes.Ldarg_0);      // this
-                il.Emit(OpCodes.Ldarg_1);      // load argument
-                il.Emit(OpCodes.Stfld, targetField); // set field to loaded argument
-                il.Emit(OpCodes.Ldarg_0);      // this
-                il.Emit(OpCodes.Ldarg_2);      // load argument
-                il.Emit(OpCodes.Stfld, glueField); // set field to loaded argument
-                il.Emit(OpCodes.Ret);
-            }
-
-            var allTargetMethods = this.TargetType.GetMethods().ToList();
-            foreach (Type targetInterface in this.TargetType.GetInterfaces())
-            {
-                foreach (MethodInfo targetMethod in targetInterface.GetMethods())
-                {
-                    if (!targetMethod.IsAbstract)
-                        allTargetMethods.Add(targetMethod);
-                }
-            }
-
-            MatchingTypesResult AreTypesMatching(Type targetType, Type proxyType, MethodTypeMatchingPart part)
-            {
-                var typeA = part == MethodTypeMatchingPart.Parameter ? targetType : proxyType;
-                var typeB = part == MethodTypeMatchingPart.Parameter ? proxyType : targetType;
-
-                if (typeA.IsGenericMethodParameter != typeB.IsGenericMethodParameter)
-                    return MatchingTypesResult.False;
-                // TODO: decide if "assignable" checking is desired (instead of just 1:1 type equality)
-                if (typeA.IsGenericMethodParameter ? typeA.GenericParameterPosition == typeB.GenericParameterPosition : typeA.IsAssignableFrom(typeB))
-                    return MatchingTypesResult.True;
-
-                if (!proxyType.IsGenericMethodParameter)
-                {
-                    if (proxyType.GetNonRefType().IsInterface)
-                        return MatchingTypesResult.IfProxied;
-                    if (targetType.GetNonRefType().IsInterface)
-                        return MatchingTypesResult.IfProxied;
-                }
-
-                return MatchingTypesResult.False;
-            }
-
-            // proxy methods
-            foreach (MethodInfo proxyMethod in this.InterfaceType.GetMethods())
-            {
-                var proxyMethodParameters = proxyMethod.GetParameters();
-                var proxyMethodGenericArguments = proxyMethod.GetGenericArguments();
-
-                foreach (MethodInfo targetMethod in allTargetMethods)
-                {
-                    // checking if `targetMethod` matches `proxyMethod`
-
-                    if (targetMethod.Name != proxyMethod.Name)
-                        continue;
-                    if (targetMethod.GetGenericArguments().Length != proxyMethodGenericArguments.Length)
-                        continue;
-                    var positionsToProxy = new HashSet<int?>(); // null = return type; anything else = parameter position
-
-                    switch (AreTypesMatching(targetMethod.ReturnType, proxyMethod.ReturnType, MethodTypeMatchingPart.ReturnType))
-                    {
-                        case MatchingTypesResult.False:
-                            continue;
-                        case MatchingTypesResult.True:
-                            break;
-                        case MatchingTypesResult.IfProxied:
-                            positionsToProxy.Add(null);
-                            break;
-                    }
-
-                    var mParameters = targetMethod.GetParameters();
-                    if (mParameters.Length != proxyMethodParameters.Length)
-                        continue;
-                    for (int i = 0; i < mParameters.Length; i++)
-                    {
-                        switch (AreTypesMatching(mParameters[i].ParameterType, proxyMethodParameters[i].ParameterType, MethodTypeMatchingPart.Parameter))
-                        {
-                            case MatchingTypesResult.False:
-                                goto targetMethodLoopContinue;
-                            case MatchingTypesResult.True:
-                                break;
-                            case MatchingTypesResult.IfProxied:
-                                positionsToProxy.Add(i);
-                                break;
-                        }
-                    }
-
-                    // method matched; proxying
-
-                    this.ProxyMethod(factory, proxyBuilder, proxyMethod, targetMethod, targetField, glueField, positionsToProxy, sourceModID, targetModID);
-                    goto proxyMethodLoopContinue;
-                    targetMethodLoopContinue:;
-                }
-
-                throw new InvalidOperationException($"The {this.InterfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
-                proxyMethodLoopContinue:;
-            }
-
-            // save info
-            this.ProxyType = proxyBuilder.CreateType();
-        }
-
-        /// <summary>Get an existing or create a new instance of the proxy for a target instance.</summary>
-        /// <param name="targetInstance">The target instance.</param>
-        /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
-        public object ObtainInstance(object targetInstance, InterfaceProxyFactory factory)
-        {
-            if (this.ProxyCache.TryGetValue(targetInstance, out object proxyInstance))
-                return proxyInstance;
-
-            ConstructorInfo constructor = this.ProxyType.GetConstructor(new[] { this.TargetType, typeof(InterfaceProxyGlue) });
-            if (constructor == null)
-                throw new InvalidOperationException($"Couldn't find the constructor for generated proxy type '{this.ProxyType.Name}'."); // should never happen
-            proxyInstance = constructor.Invoke(new[] { targetInstance, new InterfaceProxyGlue(factory) });
-            this.ProxyCache.Add(targetInstance, proxyInstance);
-            return proxyInstance;
-        }
-
-
-        /*********
-        ** Private methods
-        *********/
-        /// <summary>Define a method which proxies access to a method on the target.</summary>
-        /// <param name="factory">The <see cref="InterfaceProxyFactory"/> that requested to build a proxy.</param>
-        /// <param name="proxyBuilder">The proxy type being generated.</param>
-        /// <param name="proxy">The proxy method.</param>
-        /// <param name="target">The target method.</param>
-        /// <param name="instanceField">The proxy field containing the API instance.</param>
-        /// <param name="glueField">The proxy field containing an <see cref="InterfaceProxyGlue"/>.</param>
-        /// <param name="positionsToProxy">Parameter type positions (or null for the return type) for which types should also be proxied.</param>
-        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
-        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
-        private void ProxyMethod(InterfaceProxyFactory factory, TypeBuilder proxyBuilder, MethodInfo proxy, MethodInfo target, FieldBuilder instanceField, FieldBuilder glueField, ISet<int?> positionsToProxy, string sourceModID, string targetModID)
-        {
-            MethodBuilder methodBuilder = proxyBuilder.DefineMethod(proxy.Name, MethodAttributes.Public | MethodAttributes.Final | MethodAttributes.Virtual);
-
-            // set up generic arguments
-            Type[] proxyGenericArguments = proxy.GetGenericArguments();
-            string[] genericArgNames = proxyGenericArguments.Select(a => a.Name).ToArray();
-            GenericTypeParameterBuilder[] genericTypeParameterBuilders = proxyGenericArguments.Length == 0 ? null : methodBuilder.DefineGenericParameters(genericArgNames);
-            for (int i = 0; i < proxyGenericArguments.Length; i++)
-                genericTypeParameterBuilders[i].SetGenericParameterAttributes(proxyGenericArguments[i].GenericParameterAttributes);
-
-            // set up return type
-            Type returnType = proxy.ReturnType.IsGenericMethodParameter ? genericTypeParameterBuilders[proxy.ReturnType.GenericParameterPosition] : proxy.ReturnType;
-            methodBuilder.SetReturnType(returnType);
-
-            // set up parameters
-            var targetParameters = target.GetParameters();
-            Type[] argTypes = proxy.GetParameters()
-                .Select(a => a.ParameterType)
-                .Select(t => t.IsGenericMethodParameter ? genericTypeParameterBuilders[t.GenericParameterPosition] : t)
-                .ToArray();
-
-            // proxy additional types
-            string returnValueProxyTypeName = null;
-            string[] parameterTargetToArgProxyTypeNames = new string[argTypes.Length];
-            string[] parameterArgToTargetUnproxyTypeNames = new string[argTypes.Length];
-            if (positionsToProxy.Count > 0)
-            {
-                foreach (int? position in positionsToProxy)
-                {
-                    // we don't check for generics here, because earlier code does and generic positions won't end up here
-                    if (position == null) // it's the return type
-                    {
-                        var builder = factory.ObtainBuilder(target.ReturnType, proxy.ReturnType, sourceModID, targetModID);
-                        returnType = proxy.ReturnType;
-                        returnValueProxyTypeName = builder.ProxyTypeName;
-                    }
-                    else // it's one of the parameters
-                    {
-                        bool isByRef = argTypes[position.Value].IsByRef;
-                        var targetType = targetParameters[position.Value].ParameterType;
-                        var argType = argTypes[position.Value];
-
-                        var builder = factory.ObtainBuilder(targetType.GetNonRefType(), argType.GetNonRefType(), sourceModID, targetModID);
-                        argTypes[position.Value] = argType;
-                        parameterTargetToArgProxyTypeNames[position.Value] = builder.ProxyTypeName;
-
-                        if (!targetParameters[position.Value].IsOut)
-                        {
-                            var argToTargetBuilder = factory.ObtainBuilder(argType.GetNonRefType(), targetType.GetNonRefType(), sourceModID, targetModID);
-                            parameterArgToTargetUnproxyTypeNames[position.Value] = argToTargetBuilder.ProxyTypeName;
-                        }
-                    }
-                }
-
-                methodBuilder.SetReturnType(returnType);
-            }
-
-            methodBuilder.SetParameters(argTypes);
-            for (int i = 0; i < argTypes.Length; i++)
-                methodBuilder.DefineParameter(i, targetParameters[i].Attributes, targetParameters[i].Name);
-
-            // create method body
-            {
-                ILGenerator il = methodBuilder.GetILGenerator();
-                LocalBuilder[] inputLocals = new LocalBuilder[argTypes.Length];
-                LocalBuilder[] outputLocals = new LocalBuilder[argTypes.Length];
-
-                void ProxyIfNeededAndStore(LocalBuilder inputLocal, LocalBuilder outputLocal, string proxyTypeName, string unproxyTypeName)
-                {
-                    if (proxyTypeName == null)
-                    {
-                        il.Emit(OpCodes.Ldloc, inputLocal);
-                        il.Emit(OpCodes.Stloc, outputLocal);
-                        return;
-                    }
-
-                    var isNullLabel = il.DefineLabel();
-                    il.Emit(OpCodes.Ldloc, inputLocal);
-                    il.Emit(OpCodes.Brfalse, isNullLabel);
-
-                    il.Emit(OpCodes.Ldarg_0);
-                    il.Emit(OpCodes.Ldfld, glueField);
-                    if (unproxyTypeName == null)
-                    {
-                        il.Emit(OpCodes.Ldstr, proxyTypeName);
-                        il.Emit(OpCodes.Ldloc, inputLocal);
-                        il.Emit(OpCodes.Call, ObtainInstanceForProxyTypeNameMethod);
-                    }
-                    else
-                    {
-                        il.Emit(OpCodes.Ldstr, proxyTypeName);
-                        il.Emit(OpCodes.Ldstr, unproxyTypeName);
-                        il.Emit(OpCodes.Ldloc, inputLocal);
-                        il.Emit(OpCodes.Call, UnproxyOrObtainInstanceForProxyTypeNameMethod);
-                    }
-                    il.Emit(OpCodes.Castclass, outputLocal.LocalType);
-                    il.Emit(OpCodes.Stloc, outputLocal);
-
-                    il.MarkLabel(isNullLabel);
-                }
-
-                // calling the proxied method
-                LocalBuilder resultInputLocal = target.ReturnType == typeof(void) ? null : il.DeclareLocal(target.ReturnType);
-                LocalBuilder resultOutputLocal = returnType == typeof(void) ? null : il.DeclareLocal(returnType);
-                il.Emit(OpCodes.Ldarg_0);
-                il.Emit(OpCodes.Ldfld, instanceField);
-                for (int i = 0; i < argTypes.Length; i++)
-                {
-                    if (targetParameters[i].IsOut && parameterTargetToArgProxyTypeNames[i] != null) // out parameter, proxy on the way back
-                    {
-                        inputLocals[i] = il.DeclareLocal(targetParameters[i].ParameterType.GetNonRefType());
-                        outputLocals[i] = il.DeclareLocal(argTypes[i].GetNonRefType());
-                        il.Emit(OpCodes.Ldloca, inputLocals[i]);
-                    }
-                    else if (parameterArgToTargetUnproxyTypeNames[i] != null) // normal parameter, proxy on the way in
-                    {
-                        inputLocals[i] = il.DeclareLocal(argTypes[i].GetNonRefType());
-                        outputLocals[i] = il.DeclareLocal(targetParameters[i].ParameterType.GetNonRefType());
-                        il.Emit(OpCodes.Ldarg, i + 1);
-                        il.Emit(OpCodes.Stloc, inputLocals[i]);
-                        ProxyIfNeededAndStore(inputLocals[i], outputLocals[i], parameterArgToTargetUnproxyTypeNames[i], parameterTargetToArgProxyTypeNames[i]);
-                        il.Emit(OpCodes.Ldloc, outputLocals[i]);
-                    }
-                    else // normal parameter, no proxying
-                    {
-                        il.Emit(OpCodes.Ldarg, i + 1);
-                    }
-                }
-                il.Emit(target.IsVirtual ? OpCodes.Callvirt : OpCodes.Call, target);
-                if (target.ReturnType != typeof(void))
-                    il.Emit(OpCodes.Stloc, resultInputLocal);
-
-                // proxying `out` parameters
-                for (int i = 0; i < argTypes.Length; i++)
-                {
-                    if (parameterTargetToArgProxyTypeNames[i] == null)
-                        continue;
-                    if (!targetParameters[i].IsOut)
-                        continue;
-
-                    ProxyIfNeededAndStore(inputLocals[i], outputLocals[i], parameterTargetToArgProxyTypeNames[i], null);
-                    il.Emit(OpCodes.Ldarg, i + 1);
-                    il.Emit(OpCodes.Ldloc, outputLocals[i]);
-                    il.Emit(OpCodes.Stind_Ref);
-                }
-
-                // proxying return value
-                if (target.ReturnType != typeof(void))
-                    ProxyIfNeededAndStore(resultInputLocal, resultOutputLocal, returnValueProxyTypeName, null);
-
-                // return result
-                if (target.ReturnType != typeof(void))
-                    il.Emit(OpCodes.Ldloc, resultOutputLocal);
-                il.Emit(OpCodes.Ret);
-            }
-        }
-
-        /// <summary>Try to get a target instance for a given proxy instance.</summary>
-        /// <param name="potentialProxyInstance">The proxy instance to look for.</param>
-        /// <param name="targetInstance">The reference to store the found target instance in.</param>
-        public bool TryUnproxy(object potentialProxyInstance, out object targetInstance)
-        {
-            foreach ((object cachedTargetInstance, object cachedProxyInstance) in this.ProxyCache)
-            {
-                if (object.ReferenceEquals(potentialProxyInstance, cachedProxyInstance))
-                {
-                    targetInstance = cachedTargetInstance;
-                    return true;
-                }
-            }
-            targetInstance = null;
-            return false;
-        }
-
-        /// <summary>The part of a method that is being matched.</summary>
-        private enum MethodTypeMatchingPart
-        {
-            ReturnType, Parameter
-        }
-
-        /// <summary>The result of matching a target and a proxy type.</summary>
-        private enum MatchingTypesResult
-        {
-            False, IfProxied, True
-        }
-    }
-
-    internal static class TypeExtensions
-    {
-        internal static Type GetNonRefType(this Type type)
-        {
-            return type.IsByRef ? type.GetElementType() : type;
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
deleted file mode 100644
index a6f38c3a..00000000
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ /dev/null
@@ -1,84 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Reflection;
-using System.Reflection.Emit;
-
-namespace StardewModdingAPI.Framework.Reflection
-{
-    /// <summary>Generates proxy classes to access mod APIs through an arbitrary interface.</summary>
-    internal class InterfaceProxyFactory
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The CLR module in which to create proxy classes.</summary>
-        private readonly ModuleBuilder ModuleBuilder;
-
-        /// <summary>The generated proxy types.</summary>
-        private readonly IDictionary<string, InterfaceProxyBuilder> Builders = new Dictionary<string, InterfaceProxyBuilder>();
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        public InterfaceProxyFactory()
-        {
-            AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
-            this.ModuleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
-        }
-
-        /// <summary>Create an API proxy.</summary>
-        /// <typeparam name="TInterface">The interface through which to access the API.</typeparam>
-        /// <param name="instance">The API instance to access.</param>
-        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
-        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
-        public TInterface CreateProxy<TInterface>(object instance, string sourceModID, string targetModID)
-            where TInterface : class
-        {
-            // validate
-            if (instance == null)
-                throw new InvalidOperationException("Can't proxy access to a null API.");
-
-            // create instance
-            InterfaceProxyBuilder builder = this.ObtainBuilder(instance.GetType(), typeof(TInterface), sourceModID, targetModID);
-            return (TInterface)builder.ObtainInstance(instance, this);
-        }
-
-        internal InterfaceProxyBuilder ObtainBuilder(Type targetType, Type interfaceType, string sourceModID, string targetModID)
-        {
-            lock (this.Builders)
-            {
-                // validate
-                if (!interfaceType.IsInterface)
-                    throw new InvalidOperationException("The proxy type must be an interface, not a class.");
-
-                // get proxy type
-                string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{interfaceType.FullName}>_To<{targetModID}_{targetType.FullName}>";
-                if (!this.Builders.TryGetValue(proxyTypeName, out InterfaceProxyBuilder builder))
-                {
-                    builder = new InterfaceProxyBuilder(targetType, interfaceType, proxyTypeName);
-                    this.Builders[proxyTypeName] = builder;
-                    try
-                    {
-                        builder.SetupProxyType(this, this.ModuleBuilder, sourceModID, targetModID);
-                    }
-                    catch
-                    {
-                        this.Builders.Remove(proxyTypeName);
-                        throw;
-                    }
-                }
-                return builder;
-            }
-        }
-
-        internal InterfaceProxyBuilder GetBuilderByProxyTypeName(string proxyTypeName)
-        {
-            lock (this.Builders)
-            {
-                return this.Builders.TryGetValue(proxyTypeName, out InterfaceProxyBuilder builder) ? builder : null;
-            }
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
deleted file mode 100644
index 38569efa..00000000
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyGlue.cs
+++ /dev/null
@@ -1,34 +0,0 @@
-namespace StardewModdingAPI.Framework.Reflection
-{
-    /// <summary>Provides an interface for proxied types to create other proxied types.</summary>
-    public sealed class InterfaceProxyGlue
-    {
-        private readonly InterfaceProxyFactory Factory;
-
-        internal InterfaceProxyGlue(InterfaceProxyFactory factory)
-        {
-            this.Factory = factory;
-        }
-
-        /// <summary>Get an existing or create a new proxied instance by its type name.</summary>
-        /// <param name="proxyTypeName">The full name of the proxy type.</param>
-        /// <param name="toProxy">The target instance to proxy.</param>
-        public object ObtainInstanceForProxyTypeName(string proxyTypeName, object toProxy)
-        {
-            var builder = this.Factory.GetBuilderByProxyTypeName(proxyTypeName);
-            return builder.ObtainInstance(toProxy, this.Factory);
-        }
-
-        /// <summary>Try to unproxy, or get an existing, or create a new proxied instance by its type name.</summary>
-        /// <param name="proxyTypeName">The full name of the proxy type.</param>
-        /// <param name="unproxyTypeName">The full name of the reverse proxy type.</param>
-        /// <param name="toProxy">The target instance to proxy.</param>
-        public object UnproxyOrObtainInstanceForProxyTypeName(string proxyTypeName, string unproxyTypeName, object toProxy)
-        {
-            var unproxyBuilder = this.Factory.GetBuilderByProxyTypeName(unproxyTypeName);
-            if (unproxyBuilder.TryUnproxy(toProxy, out object targetInstance))
-                return targetInstance;
-            return this.ObtainInstanceForProxyTypeName(proxyTypeName, toProxy);
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 55a7f083..67c13ad0 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -47,6 +47,8 @@ using xTile.Display;
 using MiniMonoModHotfix = MonoMod.Utils.MiniMonoModHotfix;
 using PathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 using SObject = StardewValley.Object;
+using Nanoray.Pintail;
+using System.Reflection.Emit;
 
 namespace StardewModdingAPI.Framework
 {
@@ -1477,12 +1479,16 @@ namespace StardewModdingAPI.Framework
             {
                 // init
                 HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
-                InterfaceProxyFactory proxyFactory = new InterfaceProxyFactory();
+                AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
+                ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
+                IProxyManager<string> proxyManager = new DefaultProxyManager<string>(moduleBuilder, new DefaultProxyManagerConfiguration<string>(
+                    proxyObjectInterfaceMarking: ProxyObjectInterfaceMarking.Disabled
+                ));
 
                 // load mods
                 foreach (IModMetadata mod in mods)
                 {
-                    if (!this.TryLoadMod(mod, mods, modAssemblyLoader, proxyFactory, jsonHelper, contentCore, modDatabase, suppressUpdateChecks, out ModFailReason? failReason, out string errorPhrase, out string errorDetails))
+                    if (!this.TryLoadMod(mod, mods, modAssemblyLoader, proxyManager, jsonHelper, contentCore, modDatabase, suppressUpdateChecks, out ModFailReason? failReason, out string errorPhrase, out string errorDetails))
                     {
                         failReason ??= ModFailReason.LoadFailed;
                         mod.SetStatus(ModMetadataStatus.Failed, failReason.Value, errorPhrase, errorDetails);
@@ -1585,7 +1591,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="mod">The mod to load.</param>
         /// <param name="mods">The mods being loaded.</param>
         /// <param name="assemblyLoader">Preprocesses and loads mod assemblies.</param>
-        /// <param name="proxyFactory">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
+        /// <param name="proxyManager">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
         /// <param name="jsonHelper">The JSON helper with which to read mods' JSON files.</param>
         /// <param name="contentCore">The content manager to use for mod content.</param>
         /// <param name="modDatabase">Handles access to SMAPI's internal mod metadata list.</param>
@@ -1594,7 +1600,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="errorReasonPhrase">The user-facing reason phrase explaining why the mod couldn't be loaded (if applicable).</param>
         /// <param name="errorDetails">More detailed details about the error intended for developers (if any).</param>
         /// <returns>Returns whether the mod was successfully loaded.</returns>
-        private bool TryLoadMod(IModMetadata mod, IModMetadata[] mods, AssemblyLoader assemblyLoader, InterfaceProxyFactory proxyFactory, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase, HashSet<string> suppressUpdateChecks, out ModFailReason? failReason, out string errorReasonPhrase, out string errorDetails)
+        private bool TryLoadMod(IModMetadata mod, IModMetadata[] mods, AssemblyLoader assemblyLoader, IProxyManager<string> proxyManager, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase, HashSet<string> suppressUpdateChecks, out ModFailReason? failReason, out string errorReasonPhrase, out string errorDetails)
         {
             errorDetails = null;
 
@@ -1737,7 +1743,7 @@ namespace StardewModdingAPI.Framework
                         IContentPackHelper contentPackHelper = new ContentPackHelper(manifest.UniqueID, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
                         IDataHelper dataHelper = new DataHelper(manifest.UniqueID, mod.DirectoryPath, jsonHelper);
                         IReflectionHelper reflectionHelper = new ReflectionHelper(manifest.UniqueID, mod.DisplayName, this.Reflection);
-                        IModRegistry modRegistryHelper = new ModRegistryHelper(manifest.UniqueID, this.ModRegistry, proxyFactory, monitor);
+                        IModRegistry modRegistryHelper = new ModRegistryHelper(manifest.UniqueID, this.ModRegistry, proxyManager, monitor);
                         IMultiplayerHelper multiplayerHelper = new MultiplayerHelper(manifest.UniqueID, this.Multiplayer);
 
                         modHelper = new ModHelper(manifest.UniqueID, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events, contentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
diff --git a/src/SMAPI/IModRegistry.cs b/src/SMAPI/IModRegistry.cs
index 9b99e459..10b3121e 100644
--- a/src/SMAPI/IModRegistry.cs
+++ b/src/SMAPI/IModRegistry.cs
@@ -25,12 +25,5 @@ namespace StardewModdingAPI
         /// <typeparam name="TInterface">The interface which matches the properties and methods you intend to access.</typeparam>
         /// <param name="uniqueID">The mod's unique ID.</param>
         TInterface GetApi<TInterface>(string uniqueID) where TInterface : class;
-
-        /// <summary>Try to proxy (or unproxy back) the given object to a given interface provided by a mod.</summary>
-        /// <typeparam name="TInterface">The interface type to proxy (or unproxy) to.</typeparam>
-        /// <param name="uniqueID">The mod's unique ID.</param>
-        /// <param name="toProxy">The object to try to proxy (or unproxy back).</param>
-        /// <param name="proxy">The reference to store the proxied (or unproxied) object back.</param>
-        bool TryProxy<TInterface>(string uniqueID, object toProxy, out TInterface proxy) where TInterface : class;
     }
 }
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index f07ede87..1ea5ea78 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -28,6 +28,7 @@
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />
+    <PackageReference Include="Pintail" Version="1.2.0" />
   </ItemGroup>
 
   <ItemGroup>

From 8ecca56816f03c76e3cf669ca1a552932b01253e Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Wed, 16 Feb 2022 21:10:23 +0100
Subject: [PATCH 435/856] update Pintail

---
 src/SMAPI.Tests/SMAPI.Tests.csproj | 1 -
 src/SMAPI/SMAPI.csproj             | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index e27dbecc..8329b2e1 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -20,7 +20,6 @@
     <PackageReference Include="Moq" Version="4.16.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="Pintail" Version="1.2.0" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 1ea5ea78..90cbf9b3 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,10 +25,10 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
+    <PackageReference Include="Pintail" Version="1.2.1" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />
-    <PackageReference Include="Pintail" Version="1.2.0" />
   </ItemGroup>
 
   <ItemGroup>

From e41dbd49cacc69e87ed11bbea0d67a3b33af5d25 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Thu, 17 Feb 2022 19:59:36 +0100
Subject: [PATCH 436/856] update Pintail

---
 src/SMAPI/SMAPI.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 90cbf9b3..b5e538be 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Pintail" Version="1.2.1" />
+    <PackageReference Include="Pintail" Version="1.3.1" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />

From 5706d91dd9a919ad33e889f14287e77c33ff528e Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Fri, 18 Feb 2022 12:16:02 +0100
Subject: [PATCH 437/856] update Pintail

---
 src/SMAPI/SMAPI.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index b5e538be..e4a4e6b6 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Pintail" Version="1.3.1" />
+    <PackageReference Include="Pintail" Version="1.4.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />

From 28d737288056f28838811ee564ec9e219b61269e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 18 Feb 2022 12:13:53 -0500
Subject: [PATCH 438/856] tweak types in content coordinator

---
 src/SMAPI/Framework/ContentCoordinator.cs | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 99091f3e..49578046 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -46,7 +46,7 @@ namespace StardewModdingAPI.Framework
         private readonly Action OnLoadingFirstAsset;
 
         /// <summary>The loaded content managers (including the <see cref="MainContentManager"/>).</summary>
-        private readonly IList<IContentManager> ContentManagers = new List<IContentManager>();
+        private readonly List<IContentManager> ContentManagers = new();
 
         /// <summary>The language code for language-agnostic mod assets.</summary>
         private readonly LocalizedContentManager.LanguageCode DefaultLanguage = Constants.DefaultLanguage;
@@ -56,16 +56,16 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>A lock used to prevent asynchronous changes to the content manager list.</summary>
         /// <remarks>The game may add content managers in asynchronous threads (e.g. when populating the load screen).</remarks>
-        private readonly ReaderWriterLockSlim ContentManagerLock = new ReaderWriterLockSlim();
+        private readonly ReaderWriterLockSlim ContentManagerLock = new();
 
         /// <summary>A cache of ordered tilesheet IDs used by vanilla maps.</summary>
-        private readonly IDictionary<string, TilesheetReference[]> VanillaTilesheets = new Dictionary<string, TilesheetReference[]>(StringComparer.OrdinalIgnoreCase);
+        private readonly Dictionary<string, TilesheetReference[]> VanillaTilesheets = new(StringComparer.OrdinalIgnoreCase);
 
         /// <summary>An unmodified content manager which doesn't intercept assets, used to compare asset data.</summary>
         private readonly LocalizedContentManager VanillaContentManager;
 
         /// <summary>The language enum values indexed by locale code.</summary>
-        private Lazy<IDictionary<string, LocalizedContentManager.LanguageCode>> LocaleCodes;
+        private Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>> LocaleCodes;
 
 
         /*********
@@ -136,7 +136,7 @@ namespace StardewModdingAPI.Framework
             this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
             this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations);
-            this.LocaleCodes = new Lazy<IDictionary<string, LocalizedContentManager.LanguageCode>>(this.GetLocaleCodes);
+            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(this.GetLocaleCodes);
         }
 
         /// <summary>Get a new content manager which handles reading files from the game content folder with support for interception.</summary>
@@ -145,7 +145,7 @@ namespace StardewModdingAPI.Framework
         {
             return this.ContentManagerLock.InWriteLock(() =>
             {
-                GameContentManager manager = new GameContentManager(
+                GameContentManager manager = new(
                     name: name,
                     serviceProvider: this.MainContentManager.ServiceProvider,
                     rootDirectory: this.MainContentManager.RootDirectory,
@@ -171,7 +171,7 @@ namespace StardewModdingAPI.Framework
         {
             return this.ContentManagerLock.InWriteLock(() =>
             {
-                ModContentManager manager = new ModContentManager(
+                ModContentManager manager = new(
                     name: name,
                     gameContentManager: gameContentManager,
                     serviceProvider: this.MainContentManager.ServiceProvider,
@@ -200,7 +200,7 @@ namespace StardewModdingAPI.Framework
         public void OnLocaleChanged()
         {
             // rebuild locale cache (which may change due to custom mod languages)
-            this.LocaleCodes = new Lazy<IDictionary<string, LocalizedContentManager.LanguageCode>>(this.GetLocaleCodes);
+            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(this.GetLocaleCodes);
 
             // reload affected content
             this.ContentManagerLock.InReadLock(() =>
@@ -359,7 +359,7 @@ namespace StardewModdingAPI.Framework
                 );
 
                 // log summary
-                StringBuilder report = new StringBuilder();
+                StringBuilder report = new();
                 {
                     string[] invalidatedKeys = removedAssets.Keys.ToArray();
                     string[] propagatedKeys = propagated.Where(p => p.Value).Select(p => p.Key).ToArray();
@@ -486,9 +486,9 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Get the language enums (like <see cref="LocalizedContentManager.LanguageCode.ja"/>) indexed by locale code (like <c>ja-JP</c>).</summary>
-        private IDictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes()
+        private Dictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes()
         {
-            IDictionary<string, LocalizedContentManager.LanguageCode> map = new Dictionary<string, LocalizedContentManager.LanguageCode>();
+            var map = new Dictionary<string, LocalizedContentManager.LanguageCode>();
             foreach (LocalizedContentManager.LanguageCode code in Enum.GetValues(typeof(LocalizedContentManager.LanguageCode)))
             {
                 string locale = this.GetLocaleCode(code);

From 065859408f4e88ea1154b1fc76f7df5288e51b53 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 18 Feb 2022 12:31:14 -0500
Subject: [PATCH 439/856] Fix support for custom locale codes in asset names
 (#766)

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Framework/ContentCoordinator.cs | 33 ++++++++++++++++++-----
 src/SMAPI/Framework/SCore.cs              | 11 ++++++++
 3 files changed, 38 insertions(+), 7 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5e004227..d549b99c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,7 @@
 * For mod authors:
   * The `SDate` constructor is no longer case-sensitive for season names.
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
+  * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
 
 * For console commands:
   * Fixed `player_add` with Journal Scraps and Secret Notes.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 49578046..61cefd12 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -14,6 +14,7 @@ using StardewModdingAPI.Metadata;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
+using StardewValley.GameData;
 using xTile;
 
 namespace StardewModdingAPI.Framework
@@ -136,7 +137,7 @@ namespace StardewModdingAPI.Framework
             this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
             this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations);
-            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(this.GetLocaleCodes);
+            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(includeCustomLanguages: false));
         }
 
         /// <summary>Get a new content manager which handles reading files from the game content folder with support for interception.</summary>
@@ -196,12 +197,17 @@ namespace StardewModdingAPI.Framework
             return this.MainContentManager.GetLocale(LocalizedContentManager.CurrentLanguageCode);
         }
 
-        /// <summary>Perform any cleanup needed when the locale changes.</summary>
+        /// <summary>Perform any updates needed when the game loads custom languages from <c>Data/AdditionalLanguages</c>.</summary>
+        public void OnAdditionalLanguagesInitialized()
+        {
+            // update locale cache for custom languages, and load it now (since languages added later won't work)
+            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(includeCustomLanguages: true));
+            _ = this.LocaleCodes.Value;
+        }
+
+        /// <summary>Perform any updates needed when the locale changes.</summary>
         public void OnLocaleChanged()
         {
-            // rebuild locale cache (which may change due to custom mod languages)
-            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(this.GetLocaleCodes);
-
             // reload affected content
             this.ContentManagerLock.InReadLock(() =>
             {
@@ -486,9 +492,22 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Get the language enums (like <see cref="LocalizedContentManager.LanguageCode.ja"/>) indexed by locale code (like <c>ja-JP</c>).</summary>
-        private Dictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes()
+        /// <param name="includeCustomLanguages">Whether to read custom languages from <c>Data/AdditionalLanguages</c>.</param>
+        private Dictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes(bool includeCustomLanguages)
         {
-            var map = new Dictionary<string, LocalizedContentManager.LanguageCode>();
+            var map = new Dictionary<string, LocalizedContentManager.LanguageCode>(StringComparer.OrdinalIgnoreCase);
+
+            // custom languages
+            if (includeCustomLanguages)
+            {
+                foreach (ModLanguage language in Game1.content.Load<List<ModLanguage>>("Data/AdditionalLanguages"))
+                {
+                    if (!string.IsNullOrWhiteSpace(language?.LanguageCode))
+                        map[language.LanguageCode] = LocalizedContentManager.LanguageCode.mod;
+                }
+            }
+
+            // vanilla languages (override custom language if they conflict)
             foreach (LocalizedContentManager.LanguageCode code in Enum.GetValues(typeof(LocalizedContentManager.LanguageCode)))
             {
                 string locale = this.GetLocaleCode(code);
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index ef1f12fd..bfbd64ca 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -43,6 +43,7 @@ using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewModdingAPI.Utilities;
 using StardewValley;
+using StardewValley.Menus;
 using xTile.Display;
 using MiniMonoModHotfix = MonoMod.Utils.MiniMonoModHotfix;
 using PathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
@@ -121,6 +122,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>Whether post-game-startup initialization has been performed.</summary>
         private bool IsInitialized;
 
+        /// <summary>Whether the game has initialized for any custom languages from <c>Data/AdditionalLanguages</c>.</summary>
+        private bool AreCustomLanguagesInitialized;
+
         /// <summary>Whether the player just returned to the title screen.</summary>
         public bool JustReturnedToTitle { get; set; }
 
@@ -986,6 +990,13 @@ namespace StardewModdingAPI.Framework
                     // preloaded
                     if (Context.IsSaveLoaded && Context.LoadStage != LoadStage.Loaded && Context.LoadStage != LoadStage.Ready && Game1.dayOfMonth != 0)
                         this.OnLoadStageChanged(LoadStage.Loaded);
+
+                    // additional languages initialized
+                    if (!this.AreCustomLanguagesInitialized && TitleMenu.ticksUntilLanguageLoad < 0)
+                    {
+                        this.AreCustomLanguagesInitialized = true;
+                        this.ContentCore.OnAdditionalLanguagesInitialized();
+                    }
                 }
 
                 /*********

From a2190df08cc3f1b4a8dcb394056d65921d10702e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 18 Feb 2022 15:39:49 -0500
Subject: [PATCH 440/856] add AssetName to encapsulate asset name handling
 (#766)

---
 docs/release-notes.md                         |   2 +
 src/SMAPI.Tests/Core/AssetNameTests.cs        | 295 ++++++++++++++++++
 src/SMAPI/Framework/Content/AssetData.cs      |   4 +-
 .../Content/AssetDataForDictionary.cs         |   4 +-
 .../Framework/Content/AssetDataForImage.cs    |   4 +-
 .../Framework/Content/AssetDataForMap.cs      |   4 +-
 .../Framework/Content/AssetDataForObject.cs   |  12 +-
 src/SMAPI/Framework/Content/AssetInfo.cs      |  16 +-
 .../Content/AssetInterceptorChange.cs         |   4 +-
 src/SMAPI/Framework/Content/AssetName.cs      | 173 ++++++++++
 src/SMAPI/Framework/ContentCoordinator.cs     |  45 +--
 .../ContentManagers/BaseContentManager.cs     |  51 +--
 .../ContentManagers/GameContentManager.cs     |  94 +++---
 .../ContentManagers/IContentManager.cs        |   3 -
 .../ContentManagers/ModContentManager.cs      |  26 +-
 .../Framework/ModHelpers/ContentHelper.cs     |   5 +-
 src/SMAPI/IAssetInfo.cs                       |   5 +
 src/SMAPI/IAssetName.cs                       |  44 +++
 src/SMAPI/Metadata/CoreAssetPropagator.cs     | 261 +++++++---------
 19 files changed, 736 insertions(+), 316 deletions(-)
 create mode 100644 src/SMAPI.Tests/Core/AssetNameTests.cs
 create mode 100644 src/SMAPI/Framework/Content/AssetName.cs
 create mode 100644 src/SMAPI/IAssetName.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d549b99c..b84f8a06 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,8 @@
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
 
 * For mod authors:
+  * Added `IAssetName` field to the asset info received by `IAssetEditor` and `IAssetLoader` methods.  
+    _This provides utility methods for working with asset names, parsed locales, etc. The `asset.AssetNameEquals` method is now deprecated in favor of `asset.Name.IsEquivalentTo`_.
   * The `SDate` constructor is no longer case-sensitive for season names.
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
new file mode 100644
index 00000000..8785aab8
--- /dev/null
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -0,0 +1,295 @@
+using System;
+using System.Collections.Generic;
+using FluentAssertions;
+using NUnit.Framework;
+using StardewModdingAPI;
+using StardewModdingAPI.Framework.Content;
+using StardewModdingAPI.Toolkit.Utilities;
+using StardewValley;
+
+namespace SMAPI.Tests.Core
+{
+    /// <summary>Unit tests for <see cref="AssetName"/>.</summary>
+    [TestFixture]
+    internal class AssetNameTests
+    {
+        /*********
+        ** Unit tests
+        *********/
+        /****
+        ** Constructor
+        ****/
+        [Test(Description = $"Assert that the {nameof(AssetName)} constructor creates an instance with the expected values.")]
+        [TestCase("SimpleName", "SimpleName", null, null)]
+        [TestCase("Data/Achievements", "Data/Achievements", null, null)]
+        [TestCase("Characters/Dialogue/Abigail", "Characters/Dialogue/Abigail", null, null)]
+        [TestCase("Characters/Dialogue/Abigail.fr-FR", "Characters/Dialogue/Abigail", "fr-FR", LocalizedContentManager.LanguageCode.fr)]
+        [TestCase("Characters/Dialogue\\Abigail.fr-FR", "Characters/Dialogue/Abigail.fr-FR", null, null)]
+        [TestCase("Characters/Dialogue/Abigail.fr-FR", "Characters/Dialogue/Abigail", "fr-FR", LocalizedContentManager.LanguageCode.fr)]
+        public void Constructor_Valid(string name, string expectedBaseName, string expectedLocale, LocalizedContentManager.LanguageCode? expectedLanguageCode)
+        {
+            // arrange
+            name = PathUtilities.NormalizeAssetName(name);
+
+            // act
+            string calledWithLocale = null;
+            IAssetName assetName = AssetName.Parse(name, parseLocale: locale => expectedLanguageCode);
+
+            // assert
+            assetName.Name.Should()
+                .NotBeNull()
+                .And.Be(name.Replace("\\", "/"));
+            assetName.BaseName.Should()
+                .NotBeNull()
+                .And.Be(expectedBaseName);
+            assetName.LocaleCode.Should()
+                .Be(expectedLocale);
+            assetName.LanguageCode.Should()
+                .Be(expectedLanguageCode);
+        }
+
+        [Test(Description = $"Assert that the {nameof(AssetName)} constructor throws an exception if the value is invalid.")]
+        [TestCase(null)]
+        [TestCase("")]
+        [TestCase(" ")]
+        [TestCase("\t")]
+        [TestCase("  \t   ")]
+        public void Constructor_NullOrWhitespace(string name)
+        {
+            // act
+            ArgumentException exception = Assert.Throws<ArgumentException>(() => _ = AssetName.Parse(name, null));
+
+            // assert
+            exception!.ParamName.Should().Be("rawName");
+            exception.Message.Should().Be("The asset name can't be null or empty. (Parameter 'rawName')");
+        }
+
+
+        /****
+        ** IsEquivalentTo
+        ****/
+        [Test(Description = $"Assert that {nameof(AssetName.IsEquivalentTo)} compares names as expected when the locale is included.")]
+
+        // exact match (ignore case)
+        [TestCase("Data/Achievements", "Data/Achievements", ExpectedResult = true)]
+        [TestCase("DATA/achievements", "data/ACHIEVEMENTS", ExpectedResult = true)]
+
+        // exact match (ignore formatting)
+        [TestCase("Data/Achievements", "Data\\Achievements", ExpectedResult = true)]
+        [TestCase("DATA\\achievements", "data/ACHIEVEMENTS", ExpectedResult = true)]
+        [TestCase("DATA\\\\achievements", "data////ACHIEVEMENTS", ExpectedResult = true)]
+
+        // whitespace-sensitive
+        [TestCase("Data/Achievements", " Data/Achievements ", ExpectedResult = false)]
+        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = false)]
+
+        // other is null or whitespace
+        [TestCase("Data/Achievements", null, ExpectedResult = false)]
+        [TestCase("Data/Achievements", "", ExpectedResult = false)]
+        [TestCase("Data/Achievements", "   ", ExpectedResult = false)]
+
+        // with locale codes
+        [TestCase("Data/Achievements", "Data/Achievements.fr-FR", ExpectedResult = false)]
+        [TestCase("Data/Achievements.fr-FR", "Data/Achievements", ExpectedResult = false)]
+        [TestCase("Data/Achievements.fr-FR", "Data/Achievements.fr-FR", ExpectedResult = true)]
+        public bool IsEquivalentTo_Name(string mainAssetName, string otherAssetName)
+        {
+            // arrange
+            mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
+
+            // act
+            AssetName name = AssetName.Parse(mainAssetName, _ => LocalizedContentManager.LanguageCode.fr);
+
+            // assert
+            return name.IsEquivalentTo(otherAssetName);
+        }
+
+        [Test(Description = $"Assert that {nameof(AssetName.IsEquivalentTo)} compares names as expected when the locale is excluded.")]
+
+        // a few samples from previous test to make sure
+        [TestCase("Data/Achievements", "Data/Achievements", ExpectedResult = true)]
+        [TestCase("DATA/achievements", "data/ACHIEVEMENTS", ExpectedResult = true)]
+        [TestCase("DATA\\\\achievements", "data////ACHIEVEMENTS", ExpectedResult = true)]
+        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = false)]
+        [TestCase("Data/Achievements", "   ", ExpectedResult = false)]
+
+        // with locale codes
+        [TestCase("Data/Achievements", "Data/Achievements.fr-FR", ExpectedResult = false)]
+        [TestCase("Data/Achievements.fr-FR", "Data/Achievements", ExpectedResult = true)]
+        [TestCase("Data/Achievements.fr-FR", "Data/Achievements.fr-FR", ExpectedResult = false)]
+        public bool IsEquivalentTo_BaseName(string mainAssetName, string otherAssetName)
+        {
+            // arrange
+            mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
+
+            // act
+            AssetName name = AssetName.Parse(mainAssetName, _ => LocalizedContentManager.LanguageCode.fr);
+
+            // assert
+            return name.IsEquivalentTo(otherAssetName, useBaseName: true);
+        }
+
+
+        /****
+        ** StartsWith
+        ****/
+        [Test(Description = $"Assert that {nameof(AssetName.StartsWith)} compares names as expected for inputs that aren't affected by the input options.")]
+
+        // exact match (ignore case and formatting)
+        [TestCase("Data/Achievements", "Data/Achievements", ExpectedResult = true)]
+        [TestCase("DATA/achievements", "data/ACHIEVEMENTS", ExpectedResult = true)]
+        [TestCase("Data/Achievements", "Data\\Achievements", ExpectedResult = true)]
+        [TestCase("DATA\\achievements", "data/ACHIEVEMENTS", ExpectedResult = true)]
+        [TestCase("DATA\\\\achievements", "data////ACHIEVEMENTS", ExpectedResult = true)]
+
+        // leading-whitespace-sensitive
+        [TestCase("Data/Achievements", " Data/Achievements", ExpectedResult = false)]
+        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = false)]
+
+        // invalid prefixes
+        [TestCase("Data/Achievements", null, ExpectedResult = false)]
+        [TestCase("Data/Achievements", "   ", ExpectedResult = false)]
+
+        // with locale codes
+        [TestCase("Data/Achievements.fr-FR", "Data/Achievements", ExpectedResult = true)]
+        public bool StartsWith_SimpleCases(string mainAssetName, string prefix)
+        {
+            // arrange
+            mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
+
+            // act
+            AssetName name = AssetName.Parse(mainAssetName, _ => null);
+
+            // assert value is the same for any combination of options
+            bool result = name.StartsWith(prefix, true, true);
+            foreach (bool allowPartialWord in new[] { true, false })
+            {
+                foreach (bool allowSubfolder in new[] { true, true })
+                {
+                    if (allowPartialWord && allowSubfolder)
+                        continue;
+
+                    name.StartsWith(prefix, allowPartialWord, allowSubfolder)
+                        .Should().Be(result, $"the value returned for options ({nameof(allowPartialWord)}: {allowPartialWord}, {nameof(allowSubfolder)}: {allowSubfolder}) should match the base case");
+                }
+            }
+
+            // assert value
+            return result;
+        }
+
+        [Test(Description = $"Assert that {nameof(AssetName.StartsWith)} compares names as expected for the 'allowPartialWord' option.")]
+        [TestCase("Data/AchievementsToIgnore", "Data/Achievements", true, ExpectedResult = true)]
+        [TestCase("Data/AchievementsToIgnore", "Data/Achievements", false, ExpectedResult = false)]
+        [TestCase("Data/Achievements X", "Data/Achievements", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements X", "Data/Achievements", false, ExpectedResult = true)]
+        [TestCase("Data/Achievements.X", "Data/Achievements", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements.X", "Data/Achievements", false, ExpectedResult = true)]
+
+        // with locale codes
+        [TestCase("Data/Achievements.fr-FR", "Data/Achievements", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements.fr-FR", "Data/Achievements", false, ExpectedResult = true)]
+        public bool StartsWith_PartialWord(string mainAssetName, string prefix, bool allowPartialWord)
+        {
+            // arrange
+            mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
+
+            // act
+            AssetName name = AssetName.Parse(mainAssetName, _ => null);
+
+            // assert value is the same for any combination of options
+            bool result = name.StartsWith(prefix, allowPartialWord: allowPartialWord, allowSubfolder: true);
+            name.StartsWith(prefix, allowPartialWord, allowSubfolder: false)
+                .Should().Be(result, "specifying allowSubfolder should have no effect for these inputs");
+
+            // assert value
+            return result;
+        }
+
+        [Test(Description = $"Assert that {nameof(AssetName.StartsWith)} compares names as expected for the 'allowSubfolder' option.")]
+
+        // simple cases
+        [TestCase("Data/Achievements/Path", "Data/Achievements", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements/Path", "Data/Achievements", false, ExpectedResult = false)]
+        [TestCase("Data/Achievements/Path", "Data\\Achievements", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements/Path", "Data\\Achievements", false, ExpectedResult = false)]
+
+        // trailing slash
+        [TestCase("Data/Achievements/Path", "Data/", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements/Path", "Data/", false, ExpectedResult = false)]
+
+        // normalize slash style
+        [TestCase("Data/Achievements/Path", "Data\\", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements/Path", "Data\\", false, ExpectedResult = false)]
+        [TestCase("Data/Achievements/Path", "Data/\\/", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements/Path", "Data/\\/", false, ExpectedResult = false)]
+
+        // with locale code
+        [TestCase("Data/Achievements/Path.fr-FR", "Data/Achievements", true, ExpectedResult = true)]
+        [TestCase("Data/Achievements/Path.fr-FR", "Data/Achievements", false, ExpectedResult = false)]
+        public bool StartsWith_Subfolder(string mainAssetName, string otherAssetName, bool allowSubfolder)
+        {
+            // arrange
+            mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
+
+            // act
+            AssetName name = AssetName.Parse(mainAssetName, _ => null);
+
+            // assert value is the same for any combination of options
+            bool result = name.StartsWith(otherAssetName, allowPartialWord: true, allowSubfolder: allowSubfolder);
+            name.StartsWith(otherAssetName, allowPartialWord: false, allowSubfolder: allowSubfolder)
+                .Should().Be(result, "specifying allowPartialWord should have no effect for these inputs");
+
+            // assert value
+            return result;
+        }
+
+
+        /****
+        ** GetHashCode
+        ****/
+        [Test(Description = $"Assert that {nameof(AssetName.GetHashCode)} generates the same hash code for two asset names which differ only by capitalization.")]
+        public void GetHashCode_IsCaseInsensitive()
+        {
+            // arrange
+            string left = "data/ACHIEVEMENTS";
+            string right = "DATA/achievements";
+
+            // act
+            int leftHash = AssetName.Parse(left, _ => null).GetHashCode();
+            int rightHash = AssetName.Parse(right, _ => null).GetHashCode();
+
+            // assert
+            leftHash.Should().Be(rightHash, "two asset names which differ only by capitalization should produce the same hash code");
+        }
+
+        [Test(Description = $"Assert that {nameof(AssetName.GetHashCode)} generates few hash code collisions for an arbitrary set of asset names.")]
+        public void GetHashCode_HasFewCollisions()
+        {
+            // generate list of names
+            List<string> names = new();
+            {
+                Random random = new();
+                string characters = "abcdefghijklmnopqrstuvwxyz1234567890/";
+
+                while (names.Count < 1000)
+                {
+                    char[] name = new char[random.Next(5, 20)];
+                    for (int i = 0; i < name.Length; i++)
+                        name[i] = characters[random.Next(0, characters.Length)];
+
+                    names.Add(new string(name));
+                }
+            }
+
+            // get distinct hash codes
+            HashSet<int> hashCodes = new();
+            foreach (string name in names)
+                hashCodes.Add(AssetName.Parse(name, _ => null).GetHashCode());
+
+            // assert a collision frequency under 0.1%
+            float collisionFrequency = 1 - (hashCodes.Count / (names.Count * 1f));
+            collisionFrequency.Should().BeLessOrEqualTo(0.001f, "hash codes should be relatively distinct with a collision rate under 0.1% for a small sample set");
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/Content/AssetData.cs b/src/SMAPI/Framework/Content/AssetData.cs
index 5c90d83b..05be8a3b 100644
--- a/src/SMAPI/Framework/Content/AssetData.cs
+++ b/src/SMAPI/Framework/Content/AssetData.cs
@@ -25,11 +25,11 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="locale">The content's locale code, if the content is localized.</param>
-        /// <param name="assetName">The normalized asset name being read.</param>
+        /// <param name="assetName">The asset name being read.</param>
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
-        public AssetData(string locale, string assetName, TValue data, Func<string, string> getNormalizedPath, Action<TValue> onDataReplaced)
+        public AssetData(string locale, IAssetName assetName, TValue data, Func<string, string> getNormalizedPath, Action<TValue> onDataReplaced)
             : base(locale, assetName, data.GetType(), getNormalizedPath)
         {
             this.Data = data;
diff --git a/src/SMAPI/Framework/Content/AssetDataForDictionary.cs b/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
index 26cbff5a..735b651c 100644
--- a/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
@@ -11,11 +11,11 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="locale">The content's locale code, if the content is localized.</param>
-        /// <param name="assetName">The normalized asset name being read.</param>
+        /// <param name="assetName">The asset name being read.</param>
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
-        public AssetDataForDictionary(string locale, string assetName, IDictionary<TKey, TValue> data, Func<string, string> getNormalizedPath, Action<IDictionary<TKey, TValue>> onDataReplaced)
+        public AssetDataForDictionary(string locale, IAssetName assetName, IDictionary<TKey, TValue> data, Func<string, string> getNormalizedPath, Action<IDictionary<TKey, TValue>> onDataReplaced)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced) { }
     }
 }
diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index c75514bc..b0f1b5c7 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -21,11 +21,11 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="locale">The content's locale code, if the content is localized.</param>
-        /// <param name="assetName">The normalized asset name being read.</param>
+        /// <param name="assetName">The asset name being read.</param>
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
-        public AssetDataForImage(string locale, string assetName, Texture2D data, Func<string, string> getNormalizedPath, Action<Texture2D> onDataReplaced)
+        public AssetDataForImage(string locale, IAssetName assetName, Texture2D data, Func<string, string> getNormalizedPath, Action<Texture2D> onDataReplaced)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced) { }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 0a5fa7e7..26e4986e 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -18,11 +18,11 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="locale">The content's locale code, if the content is localized.</param>
-        /// <param name="assetName">The normalized asset name being read.</param>
+        /// <param name="assetName">The asset name being read.</param>
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
-        public AssetDataForMap(string locale, string assetName, Map data, Func<string, string> getNormalizedPath, Action<Map> onDataReplaced)
+        public AssetDataForMap(string locale, IAssetName assetName, Map data, Func<string, string> getNormalizedPath, Action<Map> onDataReplaced)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced) { }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/Content/AssetDataForObject.cs b/src/SMAPI/Framework/Content/AssetDataForObject.cs
index b7e8dfeb..d91873ae 100644
--- a/src/SMAPI/Framework/Content/AssetDataForObject.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForObject.cs
@@ -13,10 +13,10 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="locale">The content's locale code, if the content is localized.</param>
-        /// <param name="assetName">The normalized asset name being read.</param>
+        /// <param name="assetName">The asset name being read.</param>
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
-        public AssetDataForObject(string locale, string assetName, object data, Func<string, string> getNormalizedPath)
+        public AssetDataForObject(string locale, IAssetName assetName, object data, Func<string, string> getNormalizedPath)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced: null) { }
 
         /// <summary>Construct an instance.</summary>
@@ -24,24 +24,24 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         public AssetDataForObject(IAssetInfo info, object data, Func<string, string> getNormalizedPath)
-            : this(info.Locale, info.AssetName, data, getNormalizedPath) { }
+            : this(info.Locale, info.Name, data, getNormalizedPath) { }
 
         /// <inheritdoc />
         public IAssetDataForDictionary<TKey, TValue> AsDictionary<TKey, TValue>()
         {
-            return new AssetDataForDictionary<TKey, TValue>(this.Locale, this.AssetName, this.GetData<IDictionary<TKey, TValue>>(), this.GetNormalizedPath, this.ReplaceWith);
+            return new AssetDataForDictionary<TKey, TValue>(this.Locale, this.Name, this.GetData<IDictionary<TKey, TValue>>(), this.GetNormalizedPath, this.ReplaceWith);
         }
 
         /// <inheritdoc />
         public IAssetDataForImage AsImage()
         {
-            return new AssetDataForImage(this.Locale, this.AssetName, this.GetData<Texture2D>(), this.GetNormalizedPath, this.ReplaceWith);
+            return new AssetDataForImage(this.Locale, this.Name, this.GetData<Texture2D>(), this.GetNormalizedPath, this.ReplaceWith);
         }
 
         /// <inheritdoc />
         public IAssetDataForMap AsMap()
         {
-            return new AssetDataForMap(this.Locale, this.AssetName, this.GetData<Map>(), this.GetNormalizedPath, this.ReplaceWith);
+            return new AssetDataForMap(this.Locale, this.Name, this.GetData<Map>(), this.GetNormalizedPath, this.ReplaceWith);
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index d8106439..6a5b4f31 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -20,7 +20,11 @@ namespace StardewModdingAPI.Framework.Content
         public string Locale { get; }
 
         /// <inheritdoc />
-        public string AssetName { get; }
+        public IAssetName Name { get; }
+
+        /// <inheritdoc />
+        [Obsolete($"Use {nameof(Name)} instead.")]
+        public string AssetName => this.Name.Name;
 
         /// <inheritdoc />
         public Type DataType { get; }
@@ -31,22 +35,22 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="locale">The content's locale code, if the content is localized.</param>
-        /// <param name="assetName">The normalized asset name being read.</param>
+        /// <param name="assetName">The asset name being read.</param>
         /// <param name="type">The content type being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
-        public AssetInfo(string locale, string assetName, Type type, Func<string, string> getNormalizedPath)
+        public AssetInfo(string locale, IAssetName assetName, Type type, Func<string, string> getNormalizedPath)
         {
             this.Locale = locale;
-            this.AssetName = assetName;
+            this.Name = assetName;
             this.DataType = type;
             this.GetNormalizedPath = getNormalizedPath;
         }
 
         /// <inheritdoc />
+        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
         public bool AssetNameEquals(string path)
         {
-            path = this.GetNormalizedPath(path);
-            return this.AssetName.Equals(path, StringComparison.OrdinalIgnoreCase);
+            return this.Name.IsEquivalentTo(path);
         }
 
 
diff --git a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
index 10488b84..981eed40 100644
--- a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
+++ b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
@@ -70,7 +70,7 @@ namespace StardewModdingAPI.Framework.Content
                 }
                 catch (Exception ex)
                 {
-                    this.Mod.LogAsMod($"Mod failed when checking whether it could edit asset '{asset.AssetName}'. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    this.Mod.LogAsMod($"Mod failed when checking whether it could edit asset '{asset.Name}'. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 }
             }
 
@@ -84,7 +84,7 @@ namespace StardewModdingAPI.Framework.Content
                 }
                 catch (Exception ex)
                 {
-                    this.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{asset.AssetName}'. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    this.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{asset.Name}'. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 }
             }
 
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
new file mode 100644
index 00000000..992647f8
--- /dev/null
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -0,0 +1,173 @@
+using System;
+using StardewModdingAPI.Toolkit.Utilities;
+using StardewValley;
+
+namespace StardewModdingAPI.Framework.Content
+{
+    /// <summary>An asset name that can be loaded through the content pipeline.</summary>
+    internal class AssetName : IAssetName
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>A lowercase version of <see cref="Name"/> used for consistent hash codes and equality checks.</summary>
+        private readonly string ComparableName;
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
+        /// <inheritdoc />
+        public string BaseName { get; }
+
+        /// <inheritdoc />
+        public string LocaleCode { get; }
+
+        /// <inheritdoc />
+        public LocalizedContentManager.LanguageCode? LanguageCode { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="baseName">The base asset name without the locale code.</param>
+        /// <param name="localeCode">The locale code specified in the <see cref="Name"/>, if it's a valid code recognized by the game content.</param>
+        /// <param name="languageCode">The language code matching the <see cref="LocaleCode"/>, if applicable.</param>
+        public AssetName(string baseName, string localeCode, LocalizedContentManager.LanguageCode? languageCode)
+        {
+            // validate
+            if (string.IsNullOrWhiteSpace(baseName))
+                throw new ArgumentException("The asset name can't be null or empty.", nameof(baseName));
+            if (string.IsNullOrWhiteSpace(localeCode))
+                localeCode = null;
+
+            // set base values
+            this.BaseName = PathUtilities.NormalizeAssetName(baseName);
+            this.LocaleCode = localeCode;
+            this.LanguageCode = languageCode;
+
+            // set derived values
+            this.Name = localeCode != null
+                ? string.Concat(this.BaseName, '.', this.LocaleCode)
+                : this.BaseName;
+            this.ComparableName = this.Name.ToLowerInvariant();
+        }
+
+        /// <summary>Parse a raw asset name into an instance.</summary>
+        /// <param name="rawName">The raw asset name to parse.</param>
+        /// <param name="parseLocale">Get the language code for a given locale, if it's valid.</param>
+        /// <exception cref="ArgumentException">The <paramref name="rawName"/> is null or empty.</exception>
+        public static AssetName Parse(string rawName, Func<string, LocalizedContentManager.LanguageCode?> parseLocale)
+        {
+            if (string.IsNullOrWhiteSpace(rawName))
+                throw new ArgumentException("The asset name can't be null or empty.", nameof(rawName));
+
+            string baseName = rawName;
+            string localeCode = null;
+            LocalizedContentManager.LanguageCode? languageCode = null;
+
+            int lastPeriodIndex = rawName.LastIndexOf('.');
+            if (lastPeriodIndex > 0 && rawName.Length > lastPeriodIndex + 1)
+            {
+                string possibleLocaleCode = rawName[(lastPeriodIndex + 1)..];
+                LocalizedContentManager.LanguageCode? possibleLanguageCode = parseLocale(possibleLocaleCode);
+
+                if (possibleLanguageCode != null)
+                {
+                    baseName = rawName[..lastPeriodIndex];
+                    localeCode = possibleLocaleCode;
+                    languageCode = possibleLanguageCode;
+                }
+            }
+
+            return new AssetName(baseName, localeCode, languageCode);
+        }
+
+        /// <inheritdoc />
+        public bool IsEquivalentTo(string assetName, bool useBaseName = false)
+        {
+            // empty asset key is never equivalent
+            if (string.IsNullOrWhiteSpace(assetName))
+                return false;
+
+            assetName = PathUtilities.NormalizeAssetName(assetName);
+
+            string compareTo = useBaseName ? this.BaseName : this.Name;
+            return compareTo.Equals(assetName, StringComparison.OrdinalIgnoreCase);
+        }
+
+        /// <inheritdoc />
+        public bool StartsWith(string prefix, bool allowPartialWord = true, bool allowSubfolder = true)
+        {
+            // asset keys never start with null
+            if (prefix is null)
+                return false;
+
+            // asset keys can't have a leading slash, but NormalizeAssetName will trim them
+            {
+                string trimmed = prefix.TrimStart();
+                if (trimmed.StartsWith('/') || trimmed.StartsWith('\\'))
+                    return false;
+            }
+
+            // normalize prefix
+            {
+                string normalized = PathUtilities.NormalizeAssetName(prefix);
+
+                string trimmed = prefix.TrimEnd();
+                if (trimmed.EndsWith('/') || trimmed.EndsWith('\\'))
+                    normalized += PathUtilities.PreferredAssetSeparator;
+
+                prefix = normalized;
+            }
+
+            // compare
+            return
+                this.Name.StartsWith(prefix, StringComparison.OrdinalIgnoreCase)
+                && (
+                    allowPartialWord
+                    || this.Name.Length == prefix.Length
+                    || !char.IsLetterOrDigit(prefix[^1]) // last character in suffix is word separator
+                    || !char.IsLetterOrDigit(this.Name[prefix.Length]) // or first character after it is
+                )
+                && (
+                    allowSubfolder
+                    || this.Name.Length == prefix.Length
+                    || !this.Name[prefix.Length..].Contains(PathUtilities.PreferredAssetSeparator)
+                );
+        }
+
+
+        public bool IsDirectlyUnderPath(string assetFolder)
+        {
+            return this.StartsWith(assetFolder + "/", allowPartialWord: false, allowSubfolder: false);
+        }
+
+        /// <inheritdoc />
+        public bool Equals(IAssetName other)
+        {
+            return other switch
+            {
+                null => false,
+                AssetName otherImpl => this.ComparableName == otherImpl.ComparableName,
+                _ => StringComparer.OrdinalIgnoreCase.Equals(this.Name, other.Name)
+            };
+        }
+
+        /// <inheritdoc />
+        public override int GetHashCode()
+        {
+            return this.ComparableName.GetHashCode();
+        }
+
+        /// <inheritdoc />
+        public override string ToString()
+        {
+            return this.Name;
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 61cefd12..97a37b3f 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -248,6 +248,16 @@ namespace StardewModdingAPI.Framework
                 this.InvalidateCache((contentManager, key, type) => contentManager is GameContentManager);
         }
 
+        /// <summary>Parse a raw asset name.</summary>
+        /// <param name="rawName">The raw asset name to parse.</param>
+        /// <exception cref="ArgumentException">The <paramref name="rawName"/> is null or empty.</exception>
+        public AssetName ParseAssetName(string rawName)
+        {
+            return !string.IsNullOrWhiteSpace(rawName)
+                ? AssetName.Parse(rawName, parseLocale: locale => this.LocaleCodes.Value.TryGetValue(locale, out LocalizedContentManager.LanguageCode langCode) ? langCode : null)
+                : throw new ArgumentException("The asset name can't be null or empty.", nameof(rawName));
+        }
+
         /// <summary>Get whether this asset is mapped to a mod folder.</summary>
         /// <param name="key">The asset key.</param>
         public bool IsManagedAssetKey(string key)
@@ -306,11 +316,12 @@ namespace StardewModdingAPI.Framework
         /// <param name="predicate">Matches the asset keys to invalidate.</param>
         /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
         /// <returns>Returns the invalidated asset keys.</returns>
-        public IEnumerable<string> InvalidateCache(Func<IAssetInfo, bool> predicate, bool dispose = false)
+        public IEnumerable<IAssetName> InvalidateCache(Func<IAssetInfo, bool> predicate, bool dispose = false)
         {
             string locale = this.GetLocale();
-            return this.InvalidateCache((contentManager, assetName, type) =>
+            return this.InvalidateCache((contentManager, rawName, type) =>
             {
+                IAssetName assetName = this.ParseAssetName(rawName);
                 IAssetInfo info = new AssetInfo(locale, assetName, type, this.MainContentManager.AssertAndNormalizeAssetName);
                 return predicate(info);
             }, dispose);
@@ -320,10 +331,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="predicate">Matches the asset keys to invalidate.</param>
         /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
         /// <returns>Returns the invalidated asset names.</returns>
-        public IEnumerable<string> InvalidateCache(Func<IContentManager, string, Type, bool> predicate, bool dispose = false)
+        public IEnumerable<IAssetName> InvalidateCache(Func<IContentManager, string, Type, bool> predicate, bool dispose = false)
         {
             // invalidate cache & track removed assets
-            IDictionary<string, Type> removedAssets = new Dictionary<string, Type>(StringComparer.OrdinalIgnoreCase);
+            IDictionary<IAssetName, Type> removedAssets = new Dictionary<IAssetName, Type>();
             this.ContentManagerLock.InReadLock(() =>
             {
                 // cached assets
@@ -331,8 +342,9 @@ namespace StardewModdingAPI.Framework
                 {
                     foreach (var entry in contentManager.InvalidateCache((key, type) => predicate(contentManager, key, type), dispose))
                     {
-                        if (!removedAssets.ContainsKey(entry.Key))
-                            removedAssets[entry.Key] = entry.Value.GetType();
+                        AssetName assetName = this.ParseAssetName(entry.Key);
+                        if (!removedAssets.ContainsKey(assetName))
+                            removedAssets[assetName] = entry.Value.GetType();
                     }
                 }
 
@@ -346,8 +358,8 @@ namespace StardewModdingAPI.Framework
                             continue;
 
                         // get map path
-                        string mapPath = this.MainContentManager.AssertAndNormalizeAssetName(location.mapPath.Value);
-                        if (!removedAssets.ContainsKey(mapPath) && predicate(this.MainContentManager, mapPath, typeof(Map)))
+                        AssetName mapPath = this.ParseAssetName(this.MainContentManager.AssertAndNormalizeAssetName(location.mapPath.Value));
+                        if (!removedAssets.ContainsKey(mapPath) && predicate(this.MainContentManager, mapPath.Name, typeof(Map)))
                             removedAssets[mapPath] = typeof(Map);
                     }
                 }
@@ -360,17 +372,17 @@ namespace StardewModdingAPI.Framework
                 this.CoreAssets.Propagate(
                     assets: removedAssets.ToDictionary(p => p.Key, p => p.Value),
                     ignoreWorld: Context.IsWorldFullyUnloaded,
-                    out IDictionary<string, bool> propagated,
+                    out IDictionary<IAssetName, bool> propagated,
                     out bool updatedNpcWarps
                 );
 
                 // log summary
                 StringBuilder report = new();
                 {
-                    string[] invalidatedKeys = removedAssets.Keys.ToArray();
-                    string[] propagatedKeys = propagated.Where(p => p.Value).Select(p => p.Key).ToArray();
+                    IAssetName[] invalidatedKeys = removedAssets.Keys.ToArray();
+                    IAssetName[] propagatedKeys = propagated.Where(p => p.Value).Select(p => p.Key).ToArray();
 
-                    string FormatKeyList(IEnumerable<string> keys) => string.Join(", ", keys.OrderBy(p => p, StringComparer.OrdinalIgnoreCase));
+                    string FormatKeyList(IEnumerable<IAssetName> keys) => string.Join(", ", keys.Select(p => p.Name).OrderBy(p => p, StringComparer.OrdinalIgnoreCase));
 
                     report.AppendLine($"Invalidated {invalidatedKeys.Length} asset names ({FormatKeyList(invalidatedKeys)}).");
                     report.AppendLine(propagated.Count > 0
@@ -422,15 +434,6 @@ namespace StardewModdingAPI.Framework
             return tilesheets ?? Array.Empty<TilesheetReference>();
         }
 
-        /// <summary>Get the language enum which corresponds to a locale code (e.g. <see cref="LocalizedContentManager.LanguageCode.fr"/> given <c>fr-FR</c>).</summary>
-        /// <param name="locale">The locale code to search. This must exactly match the language; no fallback is performed.</param>
-        /// <param name="language">The matched language enum, if any.</param>
-        /// <returns>Returns whether a valid language was found.</returns>
-        public bool TryGetLanguageEnum(string locale, out LocalizedContentManager.LanguageCode language)
-        {
-            return this.LocaleCodes.Value.TryGetValue(locale, out language);
-        }
-
         /// <summary>Get the locale code which corresponds to a language enum (e.g. <c>fr-FR</c> given <see cref="LocalizedContentManager.LanguageCode.fr"/>).</summary>
         /// <param name="language">The language enum to search.</param>
         public string GetLocaleCode(LocalizedContentManager.LanguageCode language)
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 5645c0fa..be892b33 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -160,14 +160,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return this.IsNormalizedKeyLoaded(assetName, language);
         }
 
-        /// <inheritdoc />
-        public IEnumerable<string> GetAssetKeys()
-        {
-            return this.Cache.Keys
-                .Select(this.GetAssetName)
-                .Distinct();
-        }
-
         /****
         ** Cache invalidation
         ****/
@@ -177,13 +169,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
             IDictionary<string, object> removeAssets = new Dictionary<string, object>(StringComparer.OrdinalIgnoreCase);
             this.Cache.Remove((key, asset) =>
             {
-                this.ParseCacheKey(key, out string assetName, out _);
+                string baseAssetName = this.Coordinator.ParseAssetName(key).BaseName;
 
                 // check if asset should be removed
-                bool remove = removeAssets.ContainsKey(assetName);
-                if (!remove && predicate(assetName, asset.GetType()))
+                bool remove = removeAssets.ContainsKey(baseAssetName);
+                if (!remove && predicate(baseAssetName, asset.GetType()))
                 {
-                    removeAssets[assetName] = asset;
+                    removeAssets[baseAssetName] = asset;
                     remove = true;
                 }
 
@@ -275,44 +267,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.BaseDisposableReferences.Clear();
         }
 
-        /// <summary>Parse a cache key into its component parts.</summary>
-        /// <param name="cacheKey">The input cache key.</param>
-        /// <param name="assetName">The original asset name.</param>
-        /// <param name="localeCode">The asset locale code (or <c>null</c> if not localized).</param>
-        protected void ParseCacheKey(string cacheKey, out string assetName, out string localeCode)
-        {
-            // handle localized key
-            if (!string.IsNullOrWhiteSpace(cacheKey))
-            {
-                int lastSepIndex = cacheKey.LastIndexOf(".", StringComparison.Ordinal);
-                if (lastSepIndex >= 0)
-                {
-                    string suffix = cacheKey.Substring(lastSepIndex + 1, cacheKey.Length - lastSepIndex - 1);
-                    if (this.Coordinator.TryGetLanguageEnum(suffix, out _))
-                    {
-                        assetName = cacheKey.Substring(0, lastSepIndex);
-                        localeCode = cacheKey.Substring(lastSepIndex + 1, cacheKey.Length - lastSepIndex - 1);
-                        return;
-                    }
-                }
-            }
-
-            // handle simple key
-            assetName = cacheKey;
-            localeCode = null;
-        }
-
         /// <summary>Get whether an asset has already been loaded.</summary>
         /// <param name="normalizedAssetName">The normalized asset name.</param>
         /// <param name="language">The language to check.</param>
         protected abstract bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language);
-
-        /// <summary>Get the asset name from a cache key.</summary>
-        /// <param name="cacheKey">The input cache key.</param>
-        private string GetAssetName(string cacheKey)
-        {
-            this.ParseCacheKey(cacheKey, out string assetName, out string _);
-            return assetName;
-        }
     }
 }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index ab198076..0ca9e277 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -73,46 +73,46 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // normalize asset name
-            assetName = this.AssertAndNormalizeAssetName(assetName);
-            if (this.TryParseExplicitLanguageAssetKey(assetName, out string newAssetName, out LanguageCode newLanguage))
-                return this.Load<T>(newAssetName, newLanguage, useCache);
+            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
+            if (parsedName.LanguageCode.HasValue)
+                return this.Load<T>(parsedName.BaseName, parsedName.LanguageCode.Value, useCache);
 
             // get from cache
-            if (useCache && this.IsLoaded(assetName, language))
-                return this.RawLoad<T>(assetName, language, useCache: true);
+            if (useCache && this.IsLoaded(parsedName.Name, language))
+                return this.RawLoad<T>(parsedName.Name, language, useCache: true);
 
             // get managed asset
-            if (this.Coordinator.TryParseManagedAssetKey(assetName, out string contentManagerID, out string relativePath))
+            if (this.Coordinator.TryParseManagedAssetKey(parsedName.Name, out string contentManagerID, out string relativePath))
             {
                 T managedAsset = this.Coordinator.LoadManagedAsset<T>(contentManagerID, relativePath);
-                this.TrackAsset(assetName, managedAsset, language, useCache);
+                this.TrackAsset(parsedName.Name, managedAsset, language, useCache);
                 return managedAsset;
             }
 
             // load asset
             T data;
-            if (this.AssetsBeingLoaded.Contains(assetName))
+            if (this.AssetsBeingLoaded.Contains(parsedName.Name))
             {
-                this.Monitor.Log($"Broke loop while loading asset '{assetName}'.", LogLevel.Warn);
+                this.Monitor.Log($"Broke loop while loading asset '{parsedName.Name}'.", LogLevel.Warn);
                 this.Monitor.Log($"Bypassing mod loaders for this asset. Stack trace:\n{Environment.StackTrace}");
-                data = this.RawLoad<T>(assetName, language, useCache);
+                data = this.RawLoad<T>(parsedName.Name, language, useCache);
             }
             else
             {
-                data = this.AssetsBeingLoaded.Track(assetName, () =>
+                data = this.AssetsBeingLoaded.Track(parsedName.Name, () =>
                 {
                     string locale = this.GetLocale(language);
-                    IAssetInfo info = new AssetInfo(locale, assetName, typeof(T), this.AssertAndNormalizeAssetName);
+                    IAssetInfo info = new AssetInfo(locale, parsedName, typeof(T), this.AssertAndNormalizeAssetName);
                     IAssetData asset =
                         this.ApplyLoader<T>(info)
-                        ?? new AssetDataForObject(info, this.RawLoad<T>(assetName, language, useCache), this.AssertAndNormalizeAssetName);
+                        ?? new AssetDataForObject(info, this.RawLoad<T>(parsedName.Name, language, useCache), this.AssertAndNormalizeAssetName);
                     asset = this.ApplyEditors<T>(info, asset);
                     return (T)asset.Data;
                 });
             }
 
             // update cache & return data
-            this.TrackAsset(assetName, data, language, useCache);
+            this.TrackAsset(parsedName.Name, data, language, useCache);
             return data;
         }
 
@@ -124,13 +124,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // find assets for which a translatable version was loaded
             HashSet<string> removeAssetNames = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
             foreach (string key in this.LocalizedAssetNames.Where(p => p.Key != p.Value).Select(p => p.Key))
-                removeAssetNames.Add(this.TryParseExplicitLanguageAssetKey(key, out string assetName, out _) ? assetName : key);
+            {
+                IAssetName assetName = this.Coordinator.ParseAssetName(key);
+                removeAssetNames.Add(assetName.BaseName);
+            }
 
             // invalidate translatable assets
             string[] invalidated = this
                 .InvalidateCache((key, type) =>
                     removeAssetNames.Contains(key)
-                    || (this.TryParseExplicitLanguageAssetKey(key, out string assetName, out _) && removeAssetNames.Contains(assetName))
+                    || removeAssetNames.Contains(this.Coordinator.ParseAssetName(key).BaseName)
                 )
                 .Select(p => p.Key)
                 .OrderBy(p => p, StringComparer.OrdinalIgnoreCase)
@@ -168,9 +171,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // handle explicit language in asset name
             {
-                if (this.TryParseExplicitLanguageAssetKey(assetName, out string newAssetName, out LanguageCode newLanguage))
+                IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
+                if (parsedName.LanguageCode.HasValue)
                 {
-                    this.TrackAsset(newAssetName, value, newLanguage, useCache);
+                    this.TrackAsset(parsedName.BaseName, value, parsedName.LanguageCode.Value, useCache);
                     return;
                 }
             }
@@ -238,30 +242,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
         }
 
-        /// <summary>Parse an asset key that contains an explicit language into its asset name and language, if applicable.</summary>
-        /// <param name="rawAsset">The asset key to parse.</param>
-        /// <param name="assetName">The asset name without the language code.</param>
-        /// <param name="language">The language code removed from the asset name.</param>
-        /// <returns>Returns whether the asset key contains an explicit language and was successfully parsed.</returns>
-        private bool TryParseExplicitLanguageAssetKey(string rawAsset, out string assetName, out LanguageCode language)
-        {
-            if (string.IsNullOrWhiteSpace(rawAsset))
-                throw new SContentLoadException("The asset key is empty.");
-
-            // extract language code
-            int splitIndex = rawAsset.LastIndexOf('.');
-            if (splitIndex != -1 && this.Coordinator.TryGetLanguageEnum(rawAsset.Substring(splitIndex + 1), out language))
-            {
-                assetName = rawAsset.Substring(0, splitIndex);
-                return true;
-            }
-
-            // no explicit language code found
-            assetName = rawAsset;
-            language = this.Language;
-            return false;
-        }
-
         /// <summary>Load the initial asset from the registered <see cref="Loaders"/>.</summary>
         /// <param name="info">The basic asset metadata.</param>
         /// <returns>Returns the loaded asset metadata, or <c>null</c> if no loader matched.</returns>
@@ -277,7 +257,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     }
                     catch (Exception ex)
                     {
-                        entry.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.AssetName}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                        entry.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                         return false;
                     }
                 })
@@ -289,7 +269,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             if (loaders.Length > 1)
             {
                 string[] loaderNames = loaders.Select(p => p.Mod.DisplayName).ToArray();
-                this.Monitor.Log($"Multiple mods want to provide the '{info.AssetName}' asset ({string.Join(", ", loaderNames)}), but an asset can't be loaded multiple times. SMAPI will use the default asset instead; uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)", LogLevel.Warn);
+                this.Monitor.Log($"Multiple mods want to provide the '{info.Name}' asset ({string.Join(", ", loaderNames)}), but an asset can't be loaded multiple times. SMAPI will use the default asset instead; uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)", LogLevel.Warn);
                 return null;
             }
 
@@ -300,11 +280,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
             try
             {
                 data = loader.Load<T>(info);
-                this.Monitor.Log($"{mod.DisplayName} loaded asset '{info.AssetName}'.", LogLevel.Trace);
+                this.Monitor.Log($"{mod.DisplayName} loaded asset '{info.Name}'.", LogLevel.Trace);
             }
             catch (Exception ex)
             {
-                mod.LogAsMod($"Mod crashed when loading asset '{info.AssetName}'. SMAPI will use the default asset instead. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                mod.LogAsMod($"Mod crashed when loading asset '{info.Name}'. SMAPI will use the default asset instead. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 return null;
             }
 
@@ -349,7 +329,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 }
                 catch (Exception ex)
                 {
-                    mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{info.AssetName}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                     continue;
                 }
 
@@ -358,22 +338,22 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 try
                 {
                     editor.Edit<T>(asset);
-                    this.Monitor.Log($"{mod.DisplayName} edited {info.AssetName}.");
+                    this.Monitor.Log($"{mod.DisplayName} edited {info.Name}.");
                 }
                 catch (Exception ex)
                 {
-                    mod.LogAsMod($"Mod crashed when editing asset '{info.AssetName}', which may cause errors in-game. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    mod.LogAsMod($"Mod crashed when editing asset '{info.Name}', which may cause errors in-game. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 }
 
                 // validate edit
                 if (asset.Data == null)
                 {
-                    mod.LogAsMod($"Mod incorrectly set asset '{info.AssetName}' to a null value; ignoring override.", LogLevel.Warn);
+                    mod.LogAsMod($"Mod incorrectly set asset '{info.Name}' to a null value; ignoring override.", LogLevel.Warn);
                     asset = GetNewData(prevAsset);
                 }
                 else if (!(asset.Data is T))
                 {
-                    mod.LogAsMod($"Mod incorrectly set asset '{asset.AssetName}' to incompatible type '{asset.Data.GetType()}', expected '{typeof(T)}'; ignoring override.", LogLevel.Warn);
+                    mod.LogAsMod($"Mod incorrectly set asset '{asset.Name}' to incompatible type '{asset.Data.GetType()}', expected '{typeof(T)}'; ignoring override.", LogLevel.Warn);
                     asset = GetNewData(prevAsset);
                 }
             }
@@ -393,21 +373,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // can't load a null asset
             if (data == null)
             {
-                mod.LogAsMod($"SMAPI blocked asset replacement for '{info.AssetName}': mod incorrectly set asset to a null value.", LogLevel.Error);
+                mod.LogAsMod($"SMAPI blocked asset replacement for '{info.Name}': mod incorrectly set asset to a null value.", LogLevel.Error);
                 return false;
             }
 
             // when replacing a map, the vanilla tilesheets must have the same order and IDs
             if (data is Map loadedMap)
             {
-                TilesheetReference[] vanillaTilesheetRefs = this.Coordinator.GetVanillaTilesheetIds(info.AssetName);
+                TilesheetReference[] vanillaTilesheetRefs = this.Coordinator.GetVanillaTilesheetIds(info.Name.Name);
                 foreach (TilesheetReference vanillaSheet in vanillaTilesheetRefs)
                 {
                     // add missing tilesheet
                     if (loadedMap.GetTileSheet(vanillaSheet.Id) == null)
                     {
                         mod.Monitor.LogOnce("SMAPI fixed maps loaded by this mod to prevent errors. See the log file for details.", LogLevel.Warn);
-                        this.Monitor.Log($"Fixed broken map replacement: {mod.DisplayName} loaded '{info.AssetName}' without a required tilesheet (id: {vanillaSheet.Id}, source: {vanillaSheet.ImageSource}).");
+                        this.Monitor.Log($"Fixed broken map replacement: {mod.DisplayName} loaded '{info.Name}' without a required tilesheet (id: {vanillaSheet.Id}, source: {vanillaSheet.ImageSource}).");
 
                         loadedMap.AddTileSheet(new TileSheet(vanillaSheet.Id, loadedMap, vanillaSheet.ImageSource, vanillaSheet.SheetSize, vanillaSheet.TileSize));
                     }
@@ -417,17 +397,17 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     {
                         // only show warning if not farm map
                         // This is temporary: mods shouldn't do this for any vanilla map, but these are the ones we know will crash. Showing a warning for others instead gives modders time to update their mods, while still simplifying troubleshooting.
-                        bool isFarmMap = info.AssetNameEquals("Maps/Farm") || info.AssetNameEquals("Maps/Farm_Combat") || info.AssetNameEquals("Maps/Farm_Fishing") || info.AssetNameEquals("Maps/Farm_Foraging") || info.AssetNameEquals("Maps/Farm_FourCorners") || info.AssetNameEquals("Maps/Farm_Island") || info.AssetNameEquals("Maps/Farm_Mining");
+                        bool isFarmMap = info.Name.IsEquivalentTo("Maps/Farm") || info.Name.IsEquivalentTo("Maps/Farm_Combat") || info.Name.IsEquivalentTo("Maps/Farm_Fishing") || info.Name.IsEquivalentTo("Maps/Farm_Foraging") || info.Name.IsEquivalentTo("Maps/Farm_FourCorners") || info.Name.IsEquivalentTo("Maps/Farm_Island") || info.Name.IsEquivalentTo("Maps/Farm_Mining");
 
                         string reason = $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewvalleywiki.com/Modding:Maps#Tilesheet_order for help.";
 
                         SCore.DeprecationManager.PlaceholderWarn("3.8.2", DeprecationLevel.PendingRemoval);
                         if (isFarmMap)
                         {
-                            mod.LogAsMod($"SMAPI blocked '{info.AssetName}' map load: {reason}", LogLevel.Error);
+                            mod.LogAsMod($"SMAPI blocked '{info.Name}' map load: {reason}", LogLevel.Error);
                             return false;
                         }
-                        mod.LogAsMod($"SMAPI found an issue with '{info.AssetName}' map load: {reason}", LogLevel.Warn);
+                        mod.LogAsMod($"SMAPI found an issue with '{info.Name}' map load: {reason}", LogLevel.Warn);
                     }
                 }
             }
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index d7963305..ba7dbc06 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -58,9 +58,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="language">The language.</param>
         bool IsLoaded(string assetName, LocalizedContentManager.LanguageCode language);
 
-        /// <summary>Get the cached asset keys.</summary>
-        IEnumerable<string> GetAssetKeys();
-
         /// <summary>Purge matched assets from the cache.</summary>
         /// <param name="predicate">Matches the asset keys to invalidate.</param>
         /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index beb90a5d..21f88d47 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -80,7 +80,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // normalize key
             bool isXnbFile = Path.GetExtension(assetName).ToLower() == ".xnb";
-            assetName = this.AssertAndNormalizeAssetName(assetName);
+            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
 
             // disable caching
             // This is necessary to avoid assets being shared between content managers, which can
@@ -97,21 +97,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // resolve managed asset key
             {
-                if (this.Coordinator.TryParseManagedAssetKey(assetName, out string contentManagerID, out string relativePath))
+                if (this.Coordinator.TryParseManagedAssetKey(parsedName.Name, out string contentManagerID, out string relativePath))
                 {
                     if (contentManagerID != this.Name)
-                        throw new SContentLoadException($"Can't load managed asset key '{assetName}' through content manager '{this.Name}' for a different mod.");
-                    assetName = relativePath;
+                        throw new SContentLoadException($"Can't load managed asset key '{parsedName}' through content manager '{this.Name}' for a different mod.");
+                    parsedName = this.Coordinator.ParseAssetName(relativePath);
                 }
             }
 
             // get local asset
-            SContentLoadException GetContentError(string reasonPhrase) => new SContentLoadException($"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}");
+            SContentLoadException GetContentError(string reasonPhrase) => new SContentLoadException($"Failed loading asset '{parsedName}' from {this.Name}: {reasonPhrase}");
             T asset;
             try
             {
                 // get file
-                FileInfo file = this.GetModFile(isXnbFile ? $"{assetName}.xnb" : assetName); // .xnb extension is stripped from asset names passed to the content manager
+                FileInfo file = this.GetModFile(isXnbFile ? $"{parsedName}.xnb" : parsedName.Name); // .xnb extension is stripped from asset names passed to the content manager
                 if (!file.Exists)
                     throw GetContentError("the specified path doesn't exist.");
 
@@ -121,11 +121,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     // XNB file
                     case ".xnb":
                         {
-                            asset = this.RawLoad<T>(assetName, useCache: false);
+                            asset = this.RawLoad<T>(parsedName.Name, useCache: false);
                             if (asset is Map map)
                             {
-                                map.assetPath = assetName;
-                                this.FixTilesheetPaths(map, relativeMapPath: assetName, fixEagerPathPrefixes: true);
+                                map.assetPath = parsedName.Name;
+                                this.FixTilesheetPaths(map, relativeMapPath: parsedName.Name, fixEagerPathPrefixes: true);
                             }
                         }
                         break;
@@ -173,8 +173,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
                             // fetch & cache
                             FormatManager formatManager = FormatManager.Instance;
                             Map map = formatManager.LoadMap(file.FullName);
-                            map.assetPath = assetName;
-                            this.FixTilesheetPaths(map, relativeMapPath: assetName, fixEagerPathPrefixes: false);
+                            map.assetPath = parsedName.Name;
+                            this.FixTilesheetPaths(map, relativeMapPath: parsedName.Name, fixEagerPathPrefixes: false);
                             asset = (T)(object)map;
                         }
                         break;
@@ -185,11 +185,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
             catch (Exception ex) when (!(ex is SContentLoadException))
             {
-                throw new SContentLoadException($"The content manager failed loading content asset '{assetName}' from {this.Name}.", ex);
+                throw new SContentLoadException($"The content manager failed loading content asset '{parsedName}' from {this.Name}.", ex);
             }
 
             // track & return asset
-            this.TrackAsset(assetName, asset, language, useCache);
+            this.TrackAsset(parsedName.Name, asset, language, useCache);
             return asset;
         }
 
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index bfca2264..a01248a8 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -129,7 +129,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             string actualKey = this.GetActualAssetKey(key, ContentSource.GameContent);
             this.Monitor.Log($"Requested cache invalidation for '{actualKey}'.", LogLevel.Trace);
-            return this.ContentCore.InvalidateCache(asset => asset.AssetNameEquals(actualKey)).Any();
+            return this.ContentCore.InvalidateCache(asset => asset.Name.IsEquivalentTo(actualKey)).Any();
         }
 
         /// <inheritdoc />
@@ -153,7 +153,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
 
             assetName ??= $"temp/{Guid.NewGuid():N}";
-            return new AssetDataForObject(this.CurrentLocale, assetName, data, this.NormalizeAssetName);
+
+            return new AssetDataForObject(this.CurrentLocale, this.ContentCore.ParseAssetName(assetName), data, this.NormalizeAssetName);
         }
 
 
diff --git a/src/SMAPI/IAssetInfo.cs b/src/SMAPI/IAssetInfo.cs
index 6cdf01ee..6ac8358d 100644
--- a/src/SMAPI/IAssetInfo.cs
+++ b/src/SMAPI/IAssetInfo.cs
@@ -11,7 +11,11 @@ namespace StardewModdingAPI
         /// <summary>The content's locale code, if the content is localized.</summary>
         string Locale { get; }
 
+        /// <summary>The asset name being read.</summary>
+        public IAssetName Name { get; }
+
         /// <summary>The normalized asset name being read. The format may change between platforms; see <see cref="AssetNameEquals"/> to compare with a known path.</summary>
+        [Obsolete($"Use {nameof(Name)} instead.")]
         string AssetName { get; }
 
         /// <summary>The content data type.</summary>
@@ -23,6 +27,7 @@ namespace StardewModdingAPI
         *********/
         /// <summary>Get whether the asset name being loaded matches a given name after normalization.</summary>
         /// <param name="path">The expected asset path, relative to the game's content folder and without the .xnb extension or locale suffix (like 'Data\ObjectInformation').</param>
+        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
         bool AssetNameEquals(string path);
     }
 }
diff --git a/src/SMAPI/IAssetName.cs b/src/SMAPI/IAssetName.cs
new file mode 100644
index 00000000..a5bfea93
--- /dev/null
+++ b/src/SMAPI/IAssetName.cs
@@ -0,0 +1,44 @@
+using System;
+using StardewValley;
+
+namespace StardewModdingAPI
+{
+    /// <summary>The name for an asset loaded through the content pipeline.</summary>
+    public interface IAssetName : IEquatable<IAssetName>
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The full normalized asset name, including the locale if applicable (like <c>Data/Achievements.fr-FR</c>).</summary>
+        string Name { get; }
+
+        /// <summary>The base asset name without the locale code.</summary>
+        string BaseName { get; }
+
+        /// <summary>The locale code specified in the <see cref="Name"/>, if it's a valid code recognized by the game content.</summary>
+        string LocaleCode { get; }
+
+        /// <summary>The language code matching the <see cref="LocaleCode"/>, if applicable.</summary>
+        LocalizedContentManager.LanguageCode? LanguageCode { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get whether the given asset name is equivalent, ignoring capitalization and formatting.</summary>
+        /// <param name="assetName">The asset name to compare this instance to.</param>
+        /// <param name="useBaseName">Whether to compare the given name with the <see cref="BaseName"/> (if true) or <see cref="Name"/> (if false). This has no effect on any locale included in the given <paramref name="assetName"/>.</param>
+        bool IsEquivalentTo(string assetName, bool useBaseName = false);
+
+        /// <summary>Get whether the asset name starts with the given value, ignoring capitalization and formatting. This can be used with a trailing slash to test for an asset folder, like <c>Data/</c>.</summary>
+        /// <param name="prefix">The prefix to match.</param>
+        /// <param name="allowPartialWord">Whether to match if the prefix occurs mid-word, so <c>Data/AchievementsToIgnore</c> matches prefix <c>Data/Achievements</c>. If this is false, the prefix only matches if the asset name starts with the prefix followed by a non-alphanumeric character (including <c>.</c>, <c>/</c>, or <c>\\</c>) or the end of string.</param>
+        /// <param name="allowSubfolder">Whether to match the prefix if there's a subfolder path after it, so <c>Data/Achievements/Example</c> matches prefix <c>Data/Achievements</c>. If this is false, the prefix only matches if the asset name has no <c>/</c> or <c>\\</c> characters after the prefix.</param>
+        bool StartsWith(string prefix, bool allowPartialWord = true, bool allowSubfolder = true);
+
+        /// <summary>Get whether the asset is directly within the given asset path.</summary>
+        /// <remarks>For example, <c>Characters/Dialogue/Abigail</c> is directly under <c>Characters/Dialogue</c> but not <c>Characters</c> or <c>Characters/Dialogue/Ab</c>. To allow sub-paths, use <see cref="StartsWith"/> instead.</remarks>
+        /// <param name="assetFolder">The asset path to check. This doesn't need a trailing slash.</param>
+        bool IsDirectlyUnderPath(string assetFolder);
+    }
+}
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index a6c4bb24..e7fac578 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -87,22 +87,22 @@ namespace StardewModdingAPI.Metadata
         /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
         /// <param name="propagatedAssets">A lookup of asset names to whether they've been propagated.</param>
         /// <param name="updatedNpcWarps">Whether the NPC pathfinding cache was reloaded.</param>
-        public void Propagate(IDictionary<string, Type> assets, bool ignoreWorld, out IDictionary<string, bool> propagatedAssets, out bool updatedNpcWarps)
+        public void Propagate(IDictionary<IAssetName, Type> assets, bool ignoreWorld, out IDictionary<IAssetName, bool> propagatedAssets, out bool updatedNpcWarps)
         {
             // group into optimized lists
             var buckets = assets.GroupBy(p =>
             {
-                if (this.IsInFolder(p.Key, "Characters") || this.IsInFolder(p.Key, "Characters/Monsters"))
+                if (p.Key.IsDirectlyUnderPath("Characters") || p.Key.IsDirectlyUnderPath("Characters/Monsters"))
                     return AssetBucket.Sprite;
 
-                if (this.IsInFolder(p.Key, "Portraits"))
+                if (p.Key.IsDirectlyUnderPath("Portraits"))
                     return AssetBucket.Portrait;
 
                 return AssetBucket.Other;
             });
 
             // reload assets
-            propagatedAssets = assets.ToDictionary(p => p.Key, _ => false, StringComparer.OrdinalIgnoreCase);
+            propagatedAssets = assets.ToDictionary(p => p.Key, _ => false);
             updatedNpcWarps = false;
             foreach (var bucket in buckets)
             {
@@ -149,16 +149,16 @@ namespace StardewModdingAPI.Metadata
         ** Private methods
         *********/
         /// <summary>Reload one of the game's core assets (if applicable).</summary>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <param name="type">The asset type to reload.</param>
         /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
         /// <param name="changedWarps">Whether any map warps were changed as part of this propagation.</param>
         /// <returns>Returns whether an asset was loaded. The return value may be true or false, or a non-null value for true.</returns>
         [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These deliberately match the asset names.")]
-        private bool PropagateOther(string key, Type type, bool ignoreWorld, out bool changedWarps)
+        private bool PropagateOther(IAssetName assetName, Type type, bool ignoreWorld, out bool changedWarps)
         {
             var content = this.MainContentManager;
-            key = this.AssertAndNormalizeAssetName(key);
+            string key = assetName.Name;
             changedWarps = false;
 
             /****
@@ -170,7 +170,7 @@ namespace StardewModdingAPI.Metadata
             {
                 foreach (TileSheet tilesheet in Game1.currentLocation.map.TileSheets)
                 {
-                    if (this.IsSameAssetKey(tilesheet.ImageSource, key))
+                    if (assetName.IsEquivalentTo(tilesheet.ImageSource))
                         Game1.mapDisplayDevice.LoadTileSheet(tilesheet);
                 }
             }
@@ -188,7 +188,7 @@ namespace StardewModdingAPI.Metadata
                     {
                         GameLocation location = info.Location;
 
-                        if (this.IsSameAssetKey(location.mapPath.Value, key))
+                        if (assetName.IsEquivalentTo(location.mapPath.Value))
                         {
                             static ISet<string> GetWarpSet(GameLocation location)
                             {
@@ -213,14 +213,13 @@ namespace StardewModdingAPI.Metadata
             /****
             ** Propagate by key
             ****/
-            Reflector reflection = this.Reflection;
-            switch (key.ToLower().Replace("\\", "/")) // normalized key so we can compare statically
+            switch (assetName.Name.ToLower().Replace("\\", "/")) // normalized key so we can compare statically
             {
                 /****
                 ** Animals
                 ****/
                 case "animals/horse":
-                    return !ignoreWorld && this.ReloadPetOrHorseSprites<Horse>(content, key);
+                    return !ignoreWorld && this.ReloadPetOrHorseSprites<Horse>(content, assetName);
 
                 /****
                 ** Buildings
@@ -231,7 +230,7 @@ namespace StardewModdingAPI.Metadata
 
                 case "buildings/houses_paintmask": // Farm
                     {
-                        bool removedFromCache = this.RemoveFromPaintMaskCache(key);
+                        bool removedFromCache = this.RemoveFromPaintMaskCache(assetName);
 
                         Farm farm = Game1.getFarm();
                         farm?.ApplyHousePaint();
@@ -250,7 +249,7 @@ namespace StardewModdingAPI.Metadata
                 case "characters/farmer/farmer_base_bald":
                 case "characters/farmer/farmer_girl_base":
                 case "characters/farmer/farmer_girl_base_bald":
-                    return !ignoreWorld && this.ReloadPlayerSprites(key);
+                    return !ignoreWorld && this.ReloadPlayerSprites(assetName);
 
                 case "characters/farmer/hairstyles": // Game1.LoadContent
                     FarmerRenderer.hairStylesTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.hairStylesTexture, key);
@@ -313,7 +312,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "data/npcdispositions": // NPC constructor
-                    return !ignoreWorld && this.ReloadNpcDispositions(content, key);
+                    return !ignoreWorld && this.ReloadNpcDispositions(content, assetName);
 
                 case "data/npcgifttastes": // Game1.LoadContent
                     Game1.NPCGiftTastes = content.Load<Dictionary<string, string>>(key);
@@ -393,7 +392,7 @@ namespace StardewModdingAPI.Metadata
                     }
 
                     if (!ignoreWorld)
-                        this.ReloadDoorSprites(content, key);
+                        this.ReloadDoorSprites(content, assetName);
                     return true;
 
                 case "loosesprites/cursors2": // Game1.LoadContent
@@ -425,7 +424,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "loosesprites/suspensionbridge": // SuspensionBridge constructor
-                    return !ignoreWorld && this.ReloadSuspensionBridges(content, key);
+                    return !ignoreWorld && this.ReloadSuspensionBridges(content, assetName);
 
                 /****
                 ** Content\Maps
@@ -456,7 +455,7 @@ namespace StardewModdingAPI.Metadata
                     return false;
 
                 case "minigames/titlebuttons": // TitleMenu
-                    return this.ReloadTitleButtons(content, key);
+                    return this.ReloadTitleButtons(content, assetName);
 
                 /****
                 ** Content\Strings
@@ -480,14 +479,14 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "tilesheets/chairtiles": // Game1.LoadContent
-                    return this.ReloadChairTiles(content, key, ignoreWorld);
+                    return this.ReloadChairTiles(content, assetName, ignoreWorld);
 
                 case "tilesheets/craftables": // Game1.LoadContent
                     Game1.bigCraftableSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
                 case "tilesheets/critters": // Critter constructor
-                    return !ignoreWorld && this.ReloadCritterTextures(content, key) > 0;
+                    return !ignoreWorld && this.ReloadCritterTextures(content, assetName) > 0;
 
                 case "tilesheets/crops": // Game1.LoadContent
                     Game1.cropSpriteSheet = content.Load<Texture2D>(key);
@@ -541,7 +540,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures/grass": // from Grass
-                    return !ignoreWorld && this.ReloadGrassTextures(content, key);
+                    return !ignoreWorld && this.ReloadGrassTextures(content, assetName);
 
                 case "terrainfeatures/hoedirt": // from HoeDirt
                     HoeDirt.lightTexture = content.Load<Texture2D>(key);
@@ -556,27 +555,27 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures/mushroom_tree": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.mushroomTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.mushroomTree);
 
                 case "terrainfeatures/tree_palm": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.palmTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.palmTree);
 
                 case "terrainfeatures/tree1_fall": // from Tree
                 case "terrainfeatures/tree1_spring": // from Tree
                 case "terrainfeatures/tree1_summer": // from Tree
                 case "terrainfeatures/tree1_winter": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.bushyTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.bushyTree);
 
                 case "terrainfeatures/tree2_fall": // from Tree
                 case "terrainfeatures/tree2_spring": // from Tree
                 case "terrainfeatures/tree2_summer": // from Tree
                 case "terrainfeatures/tree2_winter": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.leafyTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.leafyTree);
 
                 case "terrainfeatures/tree3_fall": // from Tree
                 case "terrainfeatures/tree3_spring": // from Tree
                 case "terrainfeatures/tree3_winter": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, key, Tree.pineTree);
+                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.pineTree);
             }
 
             /****
@@ -585,25 +584,25 @@ namespace StardewModdingAPI.Metadata
             if (!ignoreWorld)
             {
                 // dynamic textures
-                if (this.KeyStartsWith(key, "animals/cat"))
-                    return this.ReloadPetOrHorseSprites<Cat>(content, key);
-                if (this.KeyStartsWith(key, "animals/dog"))
-                    return this.ReloadPetOrHorseSprites<Dog>(content, key);
-                if (this.IsInFolder(key, "Animals"))
-                    return this.ReloadFarmAnimalSprites(content, key);
+                if (assetName.StartsWith("animals/cat"))
+                    return this.ReloadPetOrHorseSprites<Cat>(content, assetName);
+                if (assetName.StartsWith("animals/dog"))
+                    return this.ReloadPetOrHorseSprites<Dog>(content, assetName);
+                if (assetName.IsDirectlyUnderPath("Animals"))
+                    return this.ReloadFarmAnimalSprites(content, assetName);
 
-                if (this.IsInFolder(key, "Buildings"))
-                    return this.ReloadBuildings(key);
+                if (assetName.IsDirectlyUnderPath("Buildings"))
+                    return this.ReloadBuildings(assetName);
 
-                if (this.KeyStartsWith(key, "LooseSprites/Fence"))
-                    return this.ReloadFenceTextures(key);
+                if (assetName.StartsWith("LooseSprites/Fence"))
+                    return this.ReloadFenceTextures(assetName);
 
                 // dynamic data
-                if (this.IsInFolder(key, "Characters/Dialogue"))
-                    return this.ReloadNpcDialogue(key);
+                if (assetName.IsDirectlyUnderPath("Characters/Dialogue"))
+                    return this.ReloadNpcDialogue(assetName);
 
-                if (this.IsInFolder(key, "Characters/schedules"))
-                    return this.ReloadNpcSchedules(key);
+                if (assetName.IsDirectlyUnderPath("Characters/schedules"))
+                    return this.ReloadNpcSchedules(assetName);
             }
 
             return false;
@@ -618,14 +617,14 @@ namespace StardewModdingAPI.Metadata
         ****/
         /// <summary>Reload buttons on the title screen.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
         /// <remarks>Derived from the <see cref="TitleMenu"/> constructor and <see cref="TitleMenu.setUpIcons"/>.</remarks>
-        private bool ReloadTitleButtons(LocalizedContentManager content, string key)
+        private bool ReloadTitleButtons(LocalizedContentManager content, IAssetName assetName)
         {
             if (Game1.activeClickableMenu is TitleMenu titleMenu)
             {
-                Texture2D texture = content.Load<Texture2D>(key);
+                Texture2D texture = content.Load<Texture2D>(assetName.Name);
 
                 titleMenu.titleButtonsTexture = texture;
                 titleMenu.backButton.texture = texture;
@@ -645,21 +644,21 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Reload the sprites for matching pets or horses.</summary>
         /// <typeparam name="TAnimal">The animal type.</typeparam>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadPetOrHorseSprites<TAnimal>(LocalizedContentManager content, string key)
+        private bool ReloadPetOrHorseSprites<TAnimal>(LocalizedContentManager content, IAssetName assetName)
             where TAnimal : NPC
         {
             // find matches
             TAnimal[] animals = this.GetCharacters()
                 .OfType<TAnimal>()
-                .Where(p => this.IsSameAssetKey(p.Sprite?.Texture?.Name, key))
+                .Where(p => assetName.IsEquivalentTo(p.Sprite?.Texture?.Name))
                 .ToArray();
             if (!animals.Any())
                 return false;
 
             // update sprites
-            Texture2D texture = content.Load<Texture2D>(key);
+            Texture2D texture = content.Load<Texture2D>(assetName.Name);
             foreach (TAnimal animal in animals)
                 animal.Sprite.spriteTexture = texture;
             return true;
@@ -667,10 +666,10 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload the sprites for matching farm animals.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
         /// <remarks>Derived from <see cref="FarmAnimal.reload"/>.</remarks>
-        private bool ReloadFarmAnimalSprites(LocalizedContentManager content, string key)
+        private bool ReloadFarmAnimalSprites(LocalizedContentManager content, IAssetName assetName)
         {
             // find matches
             FarmAnimal[] animals = this.GetFarmAnimals().ToArray();
@@ -678,7 +677,7 @@ namespace StardewModdingAPI.Metadata
                 return false;
 
             // update sprites
-            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
+            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
             foreach (FarmAnimal animal in animals)
             {
                 // get expected key
@@ -690,23 +689,23 @@ namespace StardewModdingAPI.Metadata
                 expectedKey = $"Animals/{expectedKey}";
 
                 // reload asset
-                if (this.IsSameAssetKey(expectedKey, key))
+                if (assetName.IsEquivalentTo(expectedKey))
                     animal.Sprite.spriteTexture = texture.Value;
             }
             return texture.IsValueCreated;
         }
 
         /// <summary>Reload building textures.</summary>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadBuildings(string key)
+        private bool ReloadBuildings(IAssetName assetName)
         {
             // get paint mask info
             const string paintMaskSuffix = "_PaintMask";
-            bool isPaintMask = key.EndsWith(paintMaskSuffix, StringComparison.OrdinalIgnoreCase);
+            bool isPaintMask = assetName.BaseName.EndsWith(paintMaskSuffix, StringComparison.OrdinalIgnoreCase);
 
             // get building type
-            string type = Path.GetFileName(key);
+            string type = Path.GetFileName(assetName.Name)!;
             if (isPaintMask)
                 type = type.Substring(0, type.Length - paintMaskSuffix.Length);
 
@@ -718,7 +717,7 @@ namespace StardewModdingAPI.Metadata
                 .ToArray();
 
             // remove from paint mask cache
-            bool removedFromCache = this.RemoveFromPaintMaskCache(key);
+            bool removedFromCache = this.RemoveFromPaintMaskCache(assetName);
 
             // reload textures
             if (buildings.Any())
@@ -734,12 +733,12 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload map seat textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadChairTiles(LocalizedContentManager content, string key, bool ignoreWorld)
+        private bool ReloadChairTiles(LocalizedContentManager content, IAssetName assetName, bool ignoreWorld)
         {
-            MapSeat.mapChairTexture = content.Load<Texture2D>(key);
+            MapSeat.mapChairTexture = content.Load<Texture2D>(assetName.Name);
 
             if (!ignoreWorld)
             {
@@ -747,7 +746,7 @@ namespace StardewModdingAPI.Metadata
                 {
                     foreach (MapSeat seat in location.mapSeats.Where(p => p != null))
                     {
-                        if (this.IsSameAssetKey(seat._loadedTextureFile, key))
+                        if (assetName.IsEquivalentTo(seat._loadedTextureFile))
                             seat.overlayTexture = MapSeat.mapChairTexture;
                     }
                 }
@@ -758,9 +757,9 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload critter textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns the number of reloaded assets.</returns>
-        private int ReloadCritterTextures(LocalizedContentManager content, string key)
+        private int ReloadCritterTextures(LocalizedContentManager content, IAssetName assetName)
         {
             // get critters
             Critter[] critters =
@@ -768,7 +767,7 @@ namespace StardewModdingAPI.Metadata
                     from location in this.GetLocations()
                     where location.critters != null
                     from Critter critter in location.critters
-                    where this.IsSameAssetKey(critter.sprite?.Texture?.Name, key)
+                    where assetName.IsEquivalentTo(critter.sprite?.Texture?.Name)
                     select critter
                 )
                 .ToArray();
@@ -776,7 +775,7 @@ namespace StardewModdingAPI.Metadata
                 return 0;
 
             // update sprites
-            Texture2D texture = content.Load<Texture2D>(key);
+            Texture2D texture = content.Load<Texture2D>(assetName.Name);
             foreach (var entry in critters)
                 entry.sprite.spriteTexture = texture;
 
@@ -785,11 +784,11 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload the sprites for interior doors.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any doors were affected.</returns>
-        private bool ReloadDoorSprites(LocalizedContentManager content, string key)
+        private bool ReloadDoorSprites(LocalizedContentManager content, IAssetName assetName)
         {
-            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
+            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
 
             foreach (GameLocation location in this.GetLocations())
             {
@@ -803,7 +802,7 @@ namespace StardewModdingAPI.Metadata
                         continue;
 
                     string curKey = this.Reflection.GetField<string>(door.Sprite, "textureName").GetValue();
-                    if (this.IsSameAssetKey(curKey, key))
+                    if (assetName.IsEquivalentTo(curKey))
                         door.Sprite.texture = texture.Value;
                 }
             }
@@ -827,12 +826,12 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Reload the sprites for a fence type.</summary>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadFenceTextures(string key)
+        private bool ReloadFenceTextures(IAssetName assetName)
         {
-            // get fence type
-            if (!int.TryParse(this.GetSegments(key)[1].Substring("Fence".Length), out int fenceType))
+            // get fence type (e.g. LooseSprites/Fence3 => 3)
+            if (!int.TryParse(this.GetSegments(assetName.BaseName)[1].Substring("Fence".Length), out int fenceType))
                 return false;
 
             // get fences
@@ -855,22 +854,22 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload tree textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadGrassTextures(LocalizedContentManager content, string key)
+        private bool ReloadGrassTextures(LocalizedContentManager content, IAssetName assetName)
         {
             Grass[] grasses =
                 (
                     from location in this.GetLocations()
                     from grass in location.terrainFeatures.Values.OfType<Grass>()
-                    where this.IsSameAssetKey(grass.textureName(), key)
+                    where assetName.IsEquivalentTo(grass.textureName())
                     select grass
                 )
                 .ToArray();
 
             if (grasses.Any())
             {
-                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
+                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
                 foreach (Grass grass in grasses)
                     grass.texture = texture;
                 return true;
@@ -932,11 +931,11 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload the disposition data for matching NPCs.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any NPCs were affected.</returns>
-        private bool ReloadNpcDispositions(LocalizedContentManager content, string key)
+        private bool ReloadNpcDispositions(LocalizedContentManager content, IAssetName assetName)
         {
-            IDictionary<string, string> data = content.Load<Dictionary<string, string>>(key);
+            IDictionary<string, string> data = content.Load<Dictionary<string, string>>(assetName.Name);
             bool changed = false;
             foreach (NPC npc in this.GetCharacters())
             {
@@ -953,16 +952,16 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Reload the sprites for matching NPCs.</summary>
         /// <param name="keys">The asset keys to reload.</param>
         /// <param name="propagated">The asset keys which have been propagated.</param>
-        private void ReloadNpcSprites(IEnumerable<string> keys, IDictionary<string, bool> propagated)
+        private void ReloadNpcSprites(IEnumerable<IAssetName> keys, IDictionary<IAssetName, bool> propagated)
         {
             // get NPCs
-            HashSet<string> lookup = new HashSet<string>(keys, StringComparer.OrdinalIgnoreCase);
+            IDictionary<string, IAssetName> lookup = keys.ToDictionary(p => p.Name, StringComparer.OrdinalIgnoreCase);
             var characters =
                 (
                     from npc in this.GetCharacters()
                     let key = this.NormalizeAssetNameIgnoringEmpty(npc.Sprite?.Texture?.Name)
-                    where key != null && lookup.Contains(key)
-                    select new { Npc = npc, Key = key }
+                    where key != null && lookup.ContainsKey(key)
+                    select new { Npc = npc, AssetName = lookup[key] }
                 )
                 .ToArray();
             if (!characters.Any())
@@ -971,56 +970,56 @@ namespace StardewModdingAPI.Metadata
             // update sprite
             foreach (var target in characters)
             {
-                target.Npc.Sprite.spriteTexture = this.LoadAndDisposeIfNeeded(target.Npc.Sprite.spriteTexture, target.Key);
-                propagated[target.Key] = true;
+                target.Npc.Sprite.spriteTexture = this.LoadAndDisposeIfNeeded(target.Npc.Sprite.spriteTexture, target.AssetName.Name);
+                propagated[target.AssetName] = true;
             }
         }
 
         /// <summary>Reload the portraits for matching NPCs.</summary>
         /// <param name="keys">The asset key to reload.</param>
         /// <param name="propagated">The asset keys which have been propagated.</param>
-        private void ReloadNpcPortraits(IEnumerable<string> keys, IDictionary<string, bool> propagated)
+        private void ReloadNpcPortraits(IEnumerable<IAssetName> keys, IDictionary<IAssetName, bool> propagated)
         {
             // get NPCs
-            HashSet<string> lookup = new HashSet<string>(keys, StringComparer.OrdinalIgnoreCase);
+            IDictionary<string, IAssetName> lookup = keys.ToDictionary(p => p.Name, StringComparer.OrdinalIgnoreCase);
             var characters =
                 (
                     from npc in this.GetCharacters()
                     where npc.isVillager()
 
                     let key = this.NormalizeAssetNameIgnoringEmpty(npc.Portrait?.Name)
-                    where key != null && lookup.Contains(key)
-                    select new { Npc = npc, Key = key }
+                    where key != null && lookup.ContainsKey(key)
+                    select new { Npc = npc, AssetName = lookup[key] }
                 )
                 .ToList();
 
             // special case: Gil is a private NPC field on the AdventureGuild class (only used for the portrait)
             {
                 string gilKey = this.NormalizeAssetNameIgnoringEmpty("Portraits/Gil");
-                if (lookup.Contains(gilKey))
+                if (lookup.TryGetValue(gilKey, out IAssetName assetName))
                 {
                     GameLocation adventureGuild = Game1.getLocationFromName("AdventureGuild");
                     if (adventureGuild != null)
-                        characters.Add(new { Npc = this.Reflection.GetField<NPC>(adventureGuild, "Gil").GetValue(), Key = gilKey });
+                        characters.Add(new { Npc = this.Reflection.GetField<NPC>(adventureGuild, "Gil").GetValue(), AssetName = assetName });
                 }
             }
 
             // update portrait
             foreach (var target in characters)
             {
-                target.Npc.Portrait = this.LoadAndDisposeIfNeeded(target.Npc.Portrait, target.Key);
-                propagated[target.Key] = true;
+                target.Npc.Portrait = this.LoadAndDisposeIfNeeded(target.Npc.Portrait, target.AssetName.Name);
+                propagated[target.AssetName] = true;
             }
         }
 
         /// <summary>Reload the sprites for matching players.</summary>
-        /// <param name="key">The asset key to reload.</param>
-        private bool ReloadPlayerSprites(string key)
+        /// <param name="assetName">The asset name to reload.</param>
+        private bool ReloadPlayerSprites(IAssetName assetName)
         {
             Farmer[] players =
                 (
                     from player in Game1.getOnlineFarmers()
-                    where this.IsSameAssetKey(player.getTexture(), key)
+                    where assetName.IsEquivalentTo(player.getTexture())
                     select player
                 )
                 .ToArray();
@@ -1036,11 +1035,11 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload suspension bridge textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadSuspensionBridges(LocalizedContentManager content, string key)
+        private bool ReloadSuspensionBridges(LocalizedContentManager content, IAssetName assetName)
         {
-            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
+            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
 
             foreach (GameLocation location in this.GetLocations(buildingInteriors: false))
             {
@@ -1059,10 +1058,10 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Reload tree textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <param name="type">The type to reload.</param>
         /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadTreeTextures(LocalizedContentManager content, string key, int type)
+        private bool ReloadTreeTextures(LocalizedContentManager content, IAssetName assetName, int type)
         {
             Tree[] trees = this.GetLocations()
                 .SelectMany(p => p.terrainFeatures.Values.OfType<Tree>())
@@ -1071,7 +1070,7 @@ namespace StardewModdingAPI.Metadata
 
             if (trees.Any())
             {
-                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(key));
+                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
                 foreach (Tree tree in trees)
                     tree.texture = texture;
                 return true;
@@ -1084,12 +1083,12 @@ namespace StardewModdingAPI.Metadata
         ** Reload data methods
         ****/
         /// <summary>Reload the dialogue data for matching NPCs.</summary>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any assets were reloaded.</returns>
-        private bool ReloadNpcDialogue(string key)
+        private bool ReloadNpcDialogue(IAssetName assetName)
         {
             // get NPCs
-            string name = Path.GetFileName(key);
+            string name = Path.GetFileName(assetName.Name);
             NPC[] villagers = this.GetCharacters().Where(npc => npc.Name == name && npc.isVillager()).ToArray();
             if (!villagers.Any())
                 return false;
@@ -1114,12 +1113,12 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Reload the schedules for matching NPCs.</summary>
-        /// <param name="key">The asset key to reload.</param>
+        /// <param name="assetName">The asset name to reload.</param>
         /// <returns>Returns whether any assets were reloaded.</returns>
-        private bool ReloadNpcSchedules(string key)
+        private bool ReloadNpcSchedules(IAssetName assetName)
         {
             // get NPCs
-            string name = Path.GetFileName(key);
+            string name = Path.GetFileName(assetName.Name);
             NPC[] villagers = this.GetCharacters().Where(npc => npc.Name == name && npc.isVillager()).ToArray();
             if (!villagers.Any())
                 return false;
@@ -1243,39 +1242,6 @@ namespace StardewModdingAPI.Metadata
             return this.AssertAndNormalizeAssetName(path);
         }
 
-        /// <summary>Get whether a given asset key is equivalent to a normalized asset key, ignoring unimportant differences like capitalization and formatting.</summary>
-        /// <param name="actualKey">The actual key to check.</param>
-        /// <param name="normalizedKey">The key to match, already normalized via <see cref="AssertAndNormalizeAssetName"/> or <see cref="NormalizeAssetNameIgnoringEmpty"/>.</param>
-        private bool IsSameAssetKey(string actualKey, string normalizedKey)
-        {
-            if (actualKey is null || normalizedKey is null)
-                return false;
-
-            return normalizedKey.Equals(PathUtilities.NormalizeAssetName(actualKey), StringComparison.OrdinalIgnoreCase);
-        }
-
-        /// <summary>Get whether a key starts with a substring after the substring is normalized.</summary>
-        /// <param name="key">The key to check.</param>
-        /// <param name="rawSubstring">The substring to normalize and find.</param>
-        private bool KeyStartsWith(string key, string rawSubstring)
-        {
-            if (string.IsNullOrWhiteSpace(key) || string.IsNullOrWhiteSpace(rawSubstring))
-                return false;
-
-            return key.StartsWith(this.NormalizeAssetNameIgnoringEmpty(rawSubstring), StringComparison.OrdinalIgnoreCase);
-        }
-
-        /// <summary>Get whether a normalized asset key is in the given folder.</summary>
-        /// <param name="key">The normalized asset key (like <c>Animals/cat</c>).</param>
-        /// <param name="folder">The key folder (like <c>Animals</c>); doesn't need to be normalized.</param>
-        /// <param name="allowSubfolders">Whether to return true if the key is inside a subfolder of the <paramref name="folder"/>.</param>
-        private bool IsInFolder(string key, string folder, bool allowSubfolders = false)
-        {
-            return
-                this.KeyStartsWith(key, $"{folder}/")
-                && (allowSubfolders || this.CountSegments(key) == this.CountSegments(folder) + 1);
-        }
-
         /// <summary>Get the segments in a path (e.g. 'a/b' is 'a' and 'b').</summary>
         /// <param name="path">The path to check.</param>
         private string[] GetSegments(string path)
@@ -1285,13 +1251,6 @@ namespace StardewModdingAPI.Metadata
                 : Array.Empty<string>();
         }
 
-        /// <summary>Count the number of segments in a path (e.g. 'a/b' is 2).</summary>
-        /// <param name="path">The path to check.</param>
-        private int CountSegments(string path)
-        {
-            return this.GetSegments(path).Length;
-        }
-
         /// <summary>Load a texture, and dispose the old one if <see cref="AggressiveMemoryOptimizations"/> is enabled and it's different from the new instance.</summary>
         /// <param name="oldTexture">The previous texture to dispose.</param>
         /// <param name="key">The asset key to load.</param>
@@ -1315,8 +1274,8 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Remove a case-insensitive key from the paint mask cache.</summary>
-        /// <param name="key">The paint mask asset key.</param>
-        private bool RemoveFromPaintMaskCache(string key)
+        /// <param name="assetName">The paint mask asset name.</param>
+        private bool RemoveFromPaintMaskCache(IAssetName assetName)
         {
             // make cache case-insensitive
             // This is needed for cache invalidation since mods may specify keys with a different capitalization
@@ -1324,7 +1283,7 @@ namespace StardewModdingAPI.Metadata
                 BuildingPainter.paintMaskLookup = new Dictionary<string, List<List<int>>>(BuildingPainter.paintMaskLookup, StringComparer.OrdinalIgnoreCase);
 
             // remove key from cache
-            return BuildingPainter.paintMaskLookup.Remove(key);
+            return BuildingPainter.paintMaskLookup.Remove(assetName.Name);
         }
 
         /// <summary>Metadata about a location used in asset propagation.</summary>

From 2d52681b1034d314d8d56c561a5aa72e54e34576 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 19 Feb 2022 11:07:26 -0500
Subject: [PATCH 441/856] add Constants.GamePath & deprecate
 Constants.ExecutionPath

---
 docs/release-notes.md                         | 21 ++++++++++++-------
 .../Commands/Other/ShowGameFilesCommand.cs    |  6 +++---
 src/SMAPI.Mods.SaveBackup/ModEntry.cs         |  2 +-
 src/SMAPI/Constants.cs                        | 14 ++++++++-----
 src/SMAPI/Framework/ContentCoordinator.cs     |  2 +-
 .../ContentManagers/BaseContentManager.cs     |  2 +-
 src/SMAPI/Program.cs                          | 10 ++++-----
 7 files changed, 34 insertions(+), 23 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b84f8a06..4cbd1ad9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,20 +4,27 @@
 ## Upcoming release
 * For players:
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
+  * Fixed `player_add` console command's handling of Journal Scraps and Secret Notes.
 
 * For mod authors:
-  * Added `IAssetName` field to the asset info received by `IAssetEditor` and `IAssetLoader` methods.  
-    _This provides utility methods for working with asset names, parsed locales, etc. The `asset.AssetNameEquals` method is now deprecated in favor of `asset.Name.IsEquivalentTo`_.
-  * The `SDate` constructor is no longer case-sensitive for season names.
-  * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
+  * Added `IAssetName Name` field to the info received by `IAssetEditor` and `IAssetLoader` methods.  
+    _This adds methods for working with asset names, parsed locales, etc._
+  * Fixed the `SDate` constructor being case-sensitive.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
+  * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
 
-* For console commands:
-  * Fixed `player_add` with Journal Scraps and Secret Notes.
+* **Deprecation warning for mod authors:**   
+  These APIs are now deprecated and will be removed in the upcoming SMAPI 4.0.0.
+
+  API | how to update code
+  :-- | :-----------------
+  `Constants.ExecutionPath` | Use `Constants.GamePath` instead.
+  `IAssetInfo.AssetName`<br />`IAssetData.AssetName` | Use `Name` instead, which changes the type from `string` to the new `AssetName`.
+  `IAssetInfo.AssetNameEquals`<br />`IAssetData.AssetNameEquals` | Use `Name.IsEquivalentTo` instead.
 
 * For the web UI:
   * Added `data-*` attributes to log parser page for external tools.
-  * Fixed JSON validator warning for update keys without a subkey.
+  * Fixed JSON validator warning shown for update keys without a subkey.
 
 ## 3.13.4
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
index 71093184..b97cb3e6 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
@@ -1,4 +1,4 @@
-using System.Diagnostics;
+using System.Diagnostics;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
@@ -18,8 +18,8 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
         /// <param name="args">The command arguments.</param>
         public override void Handle(IMonitor monitor, string command, ArgumentParser args)
         {
-            Process.Start(Constants.ExecutionPath);
-            monitor.Log($"OK, opening {Constants.ExecutionPath}.", LogLevel.Info);
+            Process.Start(Constants.GamePath);
+            monitor.Log($"OK, opening {Constants.GamePath}.", LogLevel.Info);
         }
     }
 }
diff --git a/src/SMAPI.Mods.SaveBackup/ModEntry.cs b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
index d6414e9c..b89bb9c3 100644
--- a/src/SMAPI.Mods.SaveBackup/ModEntry.cs
+++ b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
@@ -19,7 +19,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
         private readonly int BackupsToKeep = 10;
 
         /// <summary>The absolute path to the folder in which to store save backups.</summary>
-        private readonly string BackupFolder = Path.Combine(Constants.ExecutionPath, "save-backups");
+        private readonly string BackupFolder = Path.Combine(Constants.GamePath, "save-backups");
 
         /// <summary>A unique label for the save backup to create.</summary>
         private readonly string BackupLabel = $"{DateTime.UtcNow:yyyy-MM-dd} - SMAPI {Constants.ApiVersion} with Stardew Valley {Game1.version}";
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 667491d6..810dfe48 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -31,10 +31,10 @@ namespace StardewModdingAPI
         ** Accessors
         *********/
         /// <summary>The path to the game folder.</summary>
-        public static string ExecutionPath { get; } = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
+        public static string GamePath { get; } = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
 
         /// <summary>The absolute path to the folder containing SMAPI's internal files.</summary>
-        public static readonly string InternalFilesPath = Path.Combine(EarlyConstants.ExecutionPath, "smapi-internal");
+        public static readonly string InternalFilesPath = Path.Combine(EarlyConstants.GamePath, "smapi-internal");
 
         /// <summary>The target game platform.</summary>
         internal static GamePlatform Platform { get; } = (GamePlatform)Enum.Parse(typeof(GamePlatform), LowLevelEnvironmentUtility.DetectPlatform());
@@ -77,7 +77,11 @@ namespace StardewModdingAPI
         public static GameFramework GameFramework { get; } = EarlyConstants.GameFramework;
 
         /// <summary>The path to the game folder.</summary>
-        public static string ExecutionPath { get; } = EarlyConstants.ExecutionPath;
+        [Obsolete($"Use {nameof(GamePath)} instead.")]
+        public static string ExecutionPath => Constants.GamePath;
+
+        /// <summary>The path to the game folder.</summary>
+        public static string GamePath { get; } = EarlyConstants.GamePath;
 
         /// <summary>The directory path containing Stardew Valley's app data.</summary>
         public static string DataPath { get; } = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "StardewValley");
@@ -139,7 +143,7 @@ namespace StardewModdingAPI
         internal static string UpdateMarker => Path.Combine(Constants.InternalFilesPath, "StardewModdingAPI.update.marker");
 
         /// <summary>The default full path to search for mods.</summary>
-        internal static string DefaultModsPath { get; } = Path.Combine(Constants.ExecutionPath, "Mods");
+        internal static string DefaultModsPath { get; } = Path.Combine(Constants.GamePath, "Mods");
 
         /// <summary>The actual full path to search for mods.</summary>
         internal static string ModsPath { get; set; }
@@ -222,7 +226,7 @@ namespace StardewModdingAPI
         internal static void ConfigureAssemblyResolver(AssemblyDefinitionResolver resolver)
         {
             // add search paths
-            resolver.AddSearchDirectory(Constants.ExecutionPath);
+            resolver.AddSearchDirectory(Constants.GamePath);
             resolver.AddSearchDirectory(Constants.InternalFilesPath);
 
             // add SMAPI explicitly
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 97a37b3f..00f9439c 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -107,7 +107,7 @@ namespace StardewModdingAPI.Framework
             this.Reflection = reflection;
             this.JsonHelper = jsonHelper;
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
-            this.FullRootDirectory = Path.Combine(Constants.ExecutionPath, rootDirectory);
+            this.FullRootDirectory = Path.Combine(Constants.GamePath, rootDirectory);
             this.ContentManagers.Add(
                 this.MainContentManager = new GameContentManager(
                     name: "Game1.content",
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index be892b33..26f0921d 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -56,7 +56,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         public LanguageCode Language => this.GetCurrentLanguage();
 
         /// <inheritdoc />
-        public string FullRootDirectory => Path.Combine(Constants.ExecutionPath, this.RootDirectory);
+        public string FullRootDirectory => Path.Combine(Constants.GamePath, this.RootDirectory);
 
         /// <inheritdoc />
         public bool IsNamespaced { get; }
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 0c90f2aa..f2f65287 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -66,7 +66,7 @@ namespace StardewModdingAPI
             {
                 Program.AssemblyPathsByName = new(StringComparer.OrdinalIgnoreCase);
 
-                foreach (string searchPath in new[] { EarlyConstants.ExecutionPath, Program.DllSearchPath })
+                foreach (string searchPath in new[] { EarlyConstants.GamePath, Program.DllSearchPath })
                 {
                     foreach (string dllPath in Directory.EnumerateFiles(searchPath, "*.dll"))
                     {
@@ -110,7 +110,7 @@ namespace StardewModdingAPI
             catch (Exception ex)
             {
                 // file doesn't exist
-                if (!File.Exists(Path.Combine(EarlyConstants.ExecutionPath, $"{EarlyConstants.GameAssemblyName}.exe")))
+                if (!File.Exists(Path.Combine(EarlyConstants.GamePath, $"{EarlyConstants.GameAssemblyName}.exe")))
                     Program.PrintErrorAndExit("Oops! SMAPI can't find the game. Make sure you're running StardewModdingAPI.exe in your game folder.");
 
                 // can't load file
@@ -160,8 +160,8 @@ namespace StardewModdingAPI
         /// <remarks>This is needed to resolve native DLLs like libSkiaSharp.</remarks>
         private static void AssertDepsJson()
         {
-            string sourcePath = Path.Combine(Constants.ExecutionPath, "Stardew Valley.deps.json");
-            string targetPath = Path.Combine(Constants.ExecutionPath, "StardewModdingAPI.deps.json");
+            string sourcePath = Path.Combine(Constants.GamePath, "Stardew Valley.deps.json");
+            string targetPath = Path.Combine(Constants.GamePath, "StardewModdingAPI.deps.json");
 
             if (!File.Exists(targetPath) || FileUtilities.GetFileHash(sourcePath) != FileUtilities.GetFileHash(targetPath))
             {
@@ -194,7 +194,7 @@ namespace StardewModdingAPI
 
                 // normalise
                 modsPath = !string.IsNullOrWhiteSpace(rawModsPath)
-                    ? Path.Combine(Constants.ExecutionPath, rawModsPath)
+                    ? Path.Combine(Constants.GamePath, rawModsPath)
                     : Constants.DefaultModsPath;
             }
 

From 3c29ae6a1e77ba098b4d9421cacb0fc37510227c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 19 Feb 2022 11:26:24 -0500
Subject: [PATCH 442/856] add Constants.ContentPath

---
 docs/release-notes.md  |  1 +
 src/SMAPI/Constants.cs | 44 +++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 44 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4cbd1ad9..2448995e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,7 @@
   * Fixed `player_add` console command's handling of Journal Scraps and Secret Notes.
 
 * For mod authors:
+  * Added `Constants.ContentPath`.
   * Added `IAssetName Name` field to the info received by `IAssetEditor` and `IAssetLoader` methods.  
     _This adds methods for working with asset names, parsed locales, etc._
   * Fixed the `SDate` constructor being case-sensitive.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 810dfe48..b736ca59 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -83,6 +83,9 @@ namespace StardewModdingAPI
         /// <summary>The path to the game folder.</summary>
         public static string GamePath { get; } = EarlyConstants.GamePath;
 
+        /// <summary>The path to the game's <c>Content</c> folder.</summary>
+        public static string ContentPath { get; } = Constants.GetContentFolderPath();
+
         /// <summary>The directory path containing Stardew Valley's app data.</summary>
         public static string DataPath { get; } = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "StardewValley");
 
@@ -297,13 +300,52 @@ namespace StardewModdingAPI
         /*********
         ** Private methods
         *********/
+        /// <summary>Get the absolute path to the game's <c>Content</c> folder.</summary>
+        private static string GetContentFolderPath()
+        {
+            //
+            // We can't use Path.Combine(Constants.GamePath, Game1.content.RootDirectory) here,
+            // since Game1.content isn't initialized until later in the game startup.
+            //
+
+            string gamePath = EarlyConstants.GamePath;
+
+            // most platforms
+            if (EarlyConstants.Platform != GamePlatform.Mac)
+                return Path.Combine(gamePath, "Content");
+
+            // macOS
+            string[] paths = new[]
+                {
+                    // GOG
+                    // - game:    Stardew Valley.app/Contents/MacOS
+                    // - content: Stardew Valley.app/Resources/Content
+                    "../../Resources/Content",
+
+                    // Steam
+                    // - game:    StardewValley/Contents/MacOS
+                    // - content: StardewValley/Contents/Resources/Content
+                    "../Resources/Content"
+                }
+                .Select(path => Path.GetFullPath(Path.Combine(gamePath, path)))
+                .ToArray();
+
+            foreach (string path in paths)
+            {
+                if (Directory.Exists(path))
+                    return path;
+            }
+
+            return paths.Last();
+        }
+
         /// <summary>Get the name of the save folder, if any.</summary>
         private static string GetSaveFolderName()
         {
             return Constants.GetSaveFolder()?.Name;
         }
 
-        /// <summary>Get the path to the current save folder, if any.</summary>
+        /// <summary>Get the absolute path to the current save folder, if any.</summary>
         private static string GetSaveFolderPathIfExists()
         {
             DirectoryInfo saveFolder = Constants.GetSaveFolder();

From e24c0db7b1291137296363aa745ce5de6316ae59 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Sat, 19 Feb 2022 21:27:13 +0100
Subject: [PATCH 443/856] update Pintail

---
 src/SMAPI/SMAPI.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index e4a4e6b6..2204ad70 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Pintail" Version="1.4.0" />
+    <PackageReference Include="Pintail" Version="1.5.1" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />

From e9321ba6f90d30bb7132478df40786414b0f1304 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Sat, 19 Feb 2022 22:08:05 +0100
Subject: [PATCH 444/856] change proxy prepare behavior

---
 src/SMAPI/Framework/SCore.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 67c13ad0..81e56247 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1482,6 +1482,7 @@ namespace StardewModdingAPI.Framework
                 AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
                 ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
                 IProxyManager<string> proxyManager = new DefaultProxyManager<string>(moduleBuilder, new DefaultProxyManagerConfiguration<string>(
+                    proxyPrepareBehavior: DefaultProxyManagerProxyPrepareBehavior.Eager,
                     proxyObjectInterfaceMarking: ProxyObjectInterfaceMarking.Disabled
                 ));
 

From 28f78d1a2942a4bf2d528d3c8f15c2188e0c9cb6 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Sun, 20 Feb 2022 00:38:42 +0100
Subject: [PATCH 445/856] update Pintail

---
 src/SMAPI/SMAPI.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 2204ad70..3fc76299 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Pintail" Version="1.5.1" />
+    <PackageReference Include="Pintail" Version="1.6.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />

From 6fc3be52bc2faaa85bea2febe6953fb5b51dac3a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 22 Feb 2022 17:38:59 -0500
Subject: [PATCH 446/856] avoid SetData when premultiplying texture with no
 semi-transparency

---
 .../Framework/ContentManagers/ModContentManager.cs     | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 21f88d47..50ea6e61 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -252,16 +252,20 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // premultiply pixels
             Color[] data = new Color[texture.Width * texture.Height];
             texture.GetData(data);
+            bool changed = false;
             for (int i = 0; i < data.Length; i++)
             {
-                var pixel = data[i];
-                if (pixel.A == byte.MinValue || pixel.A == byte.MaxValue)
+                Color pixel = data[i];
+                if (pixel.A is (byte.MinValue or byte.MaxValue))
                     continue; // no need to change fully transparent/opaque pixels
 
                 data[i] = new Color(pixel.R * pixel.A / byte.MaxValue, pixel.G * pixel.A / byte.MaxValue, pixel.B * pixel.A / byte.MaxValue, pixel.A); // slower version: Color.FromNonPremultiplied(data[i].ToVector4())
+                changed = true;
             }
 
-            texture.SetData(data);
+            if (changed)
+                texture.SetData(data);
+
             return texture;
         }
 

From 5e3237d000aba8a4d3c7e40d5791a476fb5d6a65 Mon Sep 17 00:00:00 2001
From: Shockah <me@shockah.pl>
Date: Thu, 24 Feb 2022 12:58:16 +0100
Subject: [PATCH 447/856] update Pintail

---
 src/SMAPI/Framework/SCore.cs | 4 ++--
 src/SMAPI/SMAPI.csproj       | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 81e56247..58537031 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1481,8 +1481,8 @@ namespace StardewModdingAPI.Framework
                 HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
                 AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
                 ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
-                IProxyManager<string> proxyManager = new DefaultProxyManager<string>(moduleBuilder, new DefaultProxyManagerConfiguration<string>(
-                    proxyPrepareBehavior: DefaultProxyManagerProxyPrepareBehavior.Eager,
+                IProxyManager<string> proxyManager = new ProxyManager<string>(moduleBuilder, new ProxyManagerConfiguration<string>(
+                    proxyPrepareBehavior: ProxyManagerProxyPrepareBehavior.Eager,
                     proxyObjectInterfaceMarking: ProxyObjectInterfaceMarking.Disabled
                 ));
 
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 3fc76299..1540ee42 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Pintail" Version="1.6.0" />
+    <PackageReference Include="Pintail" Version="2.0.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />

From 0f987c0578b69d57c01502bc44b43b4e9619e658 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Feb 2022 23:40:52 -0500
Subject: [PATCH 448/856] restore InterfaceProxyFactory to encapsulate Pintail
 (#830)

---
 .../Framework/ModHelpers/ModRegistryHelper.cs | 17 ++++----
 .../Reflection/InterfaceProxyFactory.cs       | 42 +++++++++++++++++++
 src/SMAPI/Framework/SCore.cs                  | 17 +++-----
 3 files changed, 55 insertions(+), 21 deletions(-)
 create mode 100644 src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs

diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 93ea6028..95eb03f3 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -1,5 +1,4 @@
 using System.Collections.Generic;
-using Nanoray.Pintail;
 using StardewModdingAPI.Framework.Reflection;
 
 namespace StardewModdingAPI.Framework.ModHelpers
@@ -17,10 +16,10 @@ namespace StardewModdingAPI.Framework.ModHelpers
         private readonly IMonitor Monitor;
 
         /// <summary>The mod IDs for APIs accessed by this instanced.</summary>
-        private readonly HashSet<string> AccessedModApis = new HashSet<string>();
+        private readonly HashSet<string> AccessedModApis = new();
 
         /// <summary>Generates proxy classes to access mod APIs through an arbitrary interface.</summary>
-        private readonly IProxyManager<string> ProxyManager;
+        private readonly InterfaceProxyFactory ProxyFactory;
 
 
         /*********
@@ -29,13 +28,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Construct an instance.</summary>
         /// <param name="modID">The unique ID of the relevant mod.</param>
         /// <param name="registry">The underlying mod registry.</param>
-        /// <param name="proxyManager">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
+        /// <param name="proxyFactory">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
         /// <param name="monitor">Encapsulates monitoring and logging for the mod.</param>
-        public ModRegistryHelper(string modID, ModRegistry registry, IProxyManager<string> proxyManager, IMonitor monitor)
+        public ModRegistryHelper(string modID, ModRegistry registry, InterfaceProxyFactory proxyFactory, IMonitor monitor)
             : base(modID)
         {
             this.Registry = registry;
-            this.ProxyManager = proxyManager;
+            this.ProxyFactory = proxyFactory;
             this.Monitor = monitor;
         }
 
@@ -95,9 +94,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
             }
 
             // get API of type
-            if (api is TInterface castApi)
-                return castApi;
-            return this.ProxyManager.ObtainProxy<string, TInterface>(api, this.ModID, uniqueID);
+            return api is TInterface castApi
+                ? castApi
+                : this.ProxyFactory.CreateProxy<TInterface>(api, sourceModID: this.ModID, targetModID: uniqueID);
         }
     }
 }
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
new file mode 100644
index 00000000..40adde8e
--- /dev/null
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -0,0 +1,42 @@
+using System.Reflection;
+using System.Reflection.Emit;
+using Nanoray.Pintail;
+
+namespace StardewModdingAPI.Framework.Reflection
+{
+    /// <summary>Generates proxy classes to access mod APIs through an arbitrary interface.</summary>
+    internal class InterfaceProxyFactory
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The underlying proxy type builder.</summary>
+        private readonly IProxyManager<string> ProxyManager;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public InterfaceProxyFactory()
+        {
+            AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
+            ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
+            this.ProxyManager = new ProxyManager<string>(moduleBuilder, new ProxyManagerConfiguration<string>(
+                proxyPrepareBehavior: ProxyManagerProxyPrepareBehavior.Eager,
+                proxyObjectInterfaceMarking: ProxyObjectInterfaceMarking.Disabled
+            ));
+        }
+
+        /// <summary>Create an API proxy.</summary>
+        /// <typeparam name="TInterface">The interface through which to access the API.</typeparam>
+        /// <param name="instance">The API instance to access.</param>
+        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
+        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
+        public TInterface CreateProxy<TInterface>(object instance, string sourceModID, string targetModID)
+            where TInterface : class
+        {
+            return this.ProxyManager.ObtainProxy<string, TInterface>(instance, targetContext: targetModID, proxyContext: sourceModID);
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 8f810644..342d6415 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -48,8 +48,6 @@ using xTile.Display;
 using MiniMonoModHotfix = MonoMod.Utils.MiniMonoModHotfix;
 using PathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 using SObject = StardewValley.Object;
-using Nanoray.Pintail;
-using System.Reflection.Emit;
 
 namespace StardewModdingAPI.Framework
 {
@@ -1490,17 +1488,12 @@ namespace StardewModdingAPI.Framework
             {
                 // init
                 HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
-                AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
-                ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
-                IProxyManager<string> proxyManager = new ProxyManager<string>(moduleBuilder, new ProxyManagerConfiguration<string>(
-                    proxyPrepareBehavior: ProxyManagerProxyPrepareBehavior.Eager,
-                    proxyObjectInterfaceMarking: ProxyObjectInterfaceMarking.Disabled
-                ));
+                InterfaceProxyFactory proxyFactory = new();
 
                 // load mods
                 foreach (IModMetadata mod in mods)
                 {
-                    if (!this.TryLoadMod(mod, mods, modAssemblyLoader, proxyManager, jsonHelper, contentCore, modDatabase, suppressUpdateChecks, out ModFailReason? failReason, out string errorPhrase, out string errorDetails))
+                    if (!this.TryLoadMod(mod, mods, modAssemblyLoader, proxyFactory, jsonHelper, contentCore, modDatabase, suppressUpdateChecks, out ModFailReason? failReason, out string errorPhrase, out string errorDetails))
                     {
                         failReason ??= ModFailReason.LoadFailed;
                         mod.SetStatus(ModMetadataStatus.Failed, failReason.Value, errorPhrase, errorDetails);
@@ -1603,7 +1596,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="mod">The mod to load.</param>
         /// <param name="mods">The mods being loaded.</param>
         /// <param name="assemblyLoader">Preprocesses and loads mod assemblies.</param>
-        /// <param name="proxyManager">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
+        /// <param name="proxyFactory">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
         /// <param name="jsonHelper">The JSON helper with which to read mods' JSON files.</param>
         /// <param name="contentCore">The content manager to use for mod content.</param>
         /// <param name="modDatabase">Handles access to SMAPI's internal mod metadata list.</param>
@@ -1612,7 +1605,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="errorReasonPhrase">The user-facing reason phrase explaining why the mod couldn't be loaded (if applicable).</param>
         /// <param name="errorDetails">More detailed details about the error intended for developers (if any).</param>
         /// <returns>Returns whether the mod was successfully loaded.</returns>
-        private bool TryLoadMod(IModMetadata mod, IModMetadata[] mods, AssemblyLoader assemblyLoader, IProxyManager<string> proxyManager, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase, HashSet<string> suppressUpdateChecks, out ModFailReason? failReason, out string errorReasonPhrase, out string errorDetails)
+        private bool TryLoadMod(IModMetadata mod, IModMetadata[] mods, AssemblyLoader assemblyLoader, InterfaceProxyFactory proxyFactory, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase, HashSet<string> suppressUpdateChecks, out ModFailReason? failReason, out string errorReasonPhrase, out string errorDetails)
         {
             errorDetails = null;
 
@@ -1755,7 +1748,7 @@ namespace StardewModdingAPI.Framework
                         IContentPackHelper contentPackHelper = new ContentPackHelper(manifest.UniqueID, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
                         IDataHelper dataHelper = new DataHelper(manifest.UniqueID, mod.DirectoryPath, jsonHelper);
                         IReflectionHelper reflectionHelper = new ReflectionHelper(manifest.UniqueID, mod.DisplayName, this.Reflection);
-                        IModRegistry modRegistryHelper = new ModRegistryHelper(manifest.UniqueID, this.ModRegistry, proxyManager, monitor);
+                        IModRegistry modRegistryHelper = new ModRegistryHelper(manifest.UniqueID, this.ModRegistry, proxyFactory, monitor);
                         IMultiplayerHelper multiplayerHelper = new MultiplayerHelper(manifest.UniqueID, this.Multiplayer);
 
                         modHelper = new ModHelper(manifest.UniqueID, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events, contentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);

From f36b4e06ef81f8d48280287058dbea999cd50166 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Feb 2022 23:50:52 -0500
Subject: [PATCH 449/856] update release notes

---
 docs/release-notes.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2448995e..29aa24c9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,8 @@
   * Fixed `player_add` console command's handling of Journal Scraps and Secret Notes.
 
 * For mod authors:
+  * Overhauled [mod-provided APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) (thanks to Shockah!).  
+    _This adds support for many previously-unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more._
   * Added `Constants.ContentPath`.
   * Added `IAssetName Name` field to the info received by `IAssetEditor` and `IAssetLoader` methods.  
     _This adds methods for working with asset names, parsed locales, etc._

From 8429485e696cd4eb9f1f1a6ab50fe2629a1836a0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 27 Feb 2022 20:40:49 -0500
Subject: [PATCH 450/856] update schema for Content Patcher 1.25.0

---
 docs/release-notes.md                         |  1 +
 .../wwwroot/schemas/content-patcher.json      | 42 +++++++++----------
 2 files changed, 20 insertions(+), 23 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 29aa24c9..d92ef63d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -26,6 +26,7 @@
   `IAssetInfo.AssetNameEquals`<br />`IAssetData.AssetNameEquals` | Use `Name.IsEquivalentTo` instead.
 
 * For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.25.0.
   * Added `data-*` attributes to log parser page for external tools.
   * Fixed JSON validator warning shown for update keys without a subkey.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index 6b80f260..4975a973 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -14,9 +14,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features, avoid obsolete behavior, and reduce load times.",
             "type": "string",
-            "const": "1.24.0",
+            "const": "1.25.0",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. You should always use the latest format version (currently 1.24.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
+                "const": "Incorrect value '@value'. You should always use the latest format version (currently 1.25.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
             }
         },
         "ConfigSchema": {
@@ -159,6 +159,14 @@
                 "additionalProperties": false
             }
         },
+        "AliasTokenNames": {
+            "title": "Alias token names",
+            "description": "Defines optional alternate name for existing tokens. This only affects your content pack, and you can use both the alias name and the original token name. This is mostly useful for custom tokens provided by other mods, which often have longer names. Each entry key is the alias name, and the value is the original token name.",
+            "type": "object",
+            "additionalProperties": {
+                "type": "string"
+            }
+        },
         "Changes": {
             "title": "Changes",
             "description": "The changes you want to make. Each entry is called a patch, and describes a specific action to perform: replace this file, copy this image into the file, etc. You can list any number of patches.",
@@ -187,22 +195,6 @@
                         "description": "A name for this patch shown in log messages. This is very useful for understanding errors; if not specified, will default to a name like 'entry #14 (EditImage Animals/Dinosaurs)'.",
                         "type": "string"
                     },
-                    "Enabled": {
-                        "title": "Enabled",
-                        "description": "Whether to apply this patch. Default true. This field does not allow tokens.",
-                        "anyOf": [
-                            {
-                                "type": "boolean"
-                            },
-                            {
-                                "type": "string",
-                                "enum": [ "true", "false" ]
-                            }
-                        ],
-                        "@errorMessages": {
-                            "anyOf": "Invalid value; must be true, false, or a single token which evaluates to true or false."
-                        }
-                    },
                     "Update": {
                         "title": "Update",
                         "description": "When the patch should update if it changed. The possible values are 'OnDayStart', 'OnLocationChange', or 'OnTimeChange' (defaults to OnDayStart).",
@@ -241,6 +233,14 @@
                         "description": "The part of the target image to replace. Defaults to the FromArea size starting from the top-left corner.",
                         "$ref": "#/definitions/Rectangle"
                     },
+                    "TargetField": {
+                        "title": "Target field",
+                        "description": "The path to the field within the value to set as the root scope. See 'target field' in the EditData documentation for more info. This field supports tokens.",
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
                     "Fields": {
                         "title": "Fields",
                         "description": "The individual fields you want to change for existing entries. This field supports tokens in field keys and values. The key for each field is the field index (starting at zero) for a slash-delimited string, or the field name for an object.",
@@ -408,7 +408,6 @@
                             "propertyNames": {
                                 "enum": [
                                     "Action",
-                                    "Enabled",
                                     "FromFile",
                                     "LogName",
                                     "Target",
@@ -438,7 +437,6 @@
                             "propertyNames": {
                                 "enum": [
                                     "Action",
-                                    "Enabled",
                                     "FromFile",
                                     "LogName",
                                     "Target",
@@ -462,12 +460,12 @@
                             "propertyNames": {
                                 "enum": [
                                     "Action",
-                                    "Enabled",
                                     "LogName",
                                     "Target",
                                     "Update",
                                     "When",
 
+                                    "TargetField",
                                     "Entries",
                                     "Fields",
                                     "MoveEntries",
@@ -504,7 +502,6 @@
                             "propertyNames": {
                                 "enum": [
                                     "Action",
-                                    "Enabled",
                                     "FromFile",
                                     "LogName",
                                     "Target",
@@ -533,7 +530,6 @@
                             "propertyNames": {
                                 "enum": [
                                     "Action",
-                                    "Enabled",
                                     "FromFile",
                                     "LogName",
                                     "Update",

From 30d63f0a1170ca9b3690f010fcf72e7c1e73f9d1 Mon Sep 17 00:00:00 2001
From: Ryhon <ryhon0@gmail.com>
Date: Fri, 4 Mar 2022 19:20:39 +0100
Subject: [PATCH 451/856] Make SKIP_TERMINAL default to false if not set

---
 src/SMAPI.Installer/assets/unix-launcher.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 47937f95..6ab61df6 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -8,7 +8,7 @@ cd "$(dirname "$0")" || exit $?
 
 # change to true to skip opening a terminal
 # This isn't recommended since you won't see errors, warnings, and update alerts.
-SKIP_TERMINAL=false
+SKIP_TERMINAL=${SKIP_TERMINAL:=false}
 
 
 ##########

From bb31f09977dfd687d0817f7e6bc57ad54a630df8 Mon Sep 17 00:00:00 2001
From: Ryhon <ryhon0@gmail.com>
Date: Sat, 5 Mar 2022 20:40:01 +0100
Subject: [PATCH 452/856] Command line options

---
 src/SMAPI.Installer/assets/unix-launcher.sh | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 6ab61df6..6e8d4df3 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -8,7 +8,17 @@ cd "$(dirname "$0")" || exit $?
 
 # change to true to skip opening a terminal
 # This isn't recommended since you won't see errors, warnings, and update alerts.
-SKIP_TERMINAL=${SKIP_TERMINAL:=false}
+OPTS=`getopt -o St --long skip-terminal,terminal -n 'parse-options' -- "$@"`
+while true; do
+  case "$1" in
+    -S | --skip-terminal ) SKIP_TERMINAL=true; shift ;;
+    -t | --terminal ) SKIP_TERMINAL=false; shift ;;
+    -- ) shift; break ;;
+    * ) break ;;
+  esac
+done
+
+${SKIP_TERMINAL:=false}
 
 
 ##########

From c2086216fa0df15cb7e8035465996d6fcfdf6448 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 4 Mar 2022 20:27:17 -0500
Subject: [PATCH 453/856] add Pintail to install package (#830)

---
 build/unix/prepare-install-package.sh     | 2 +-
 build/windows/prepare-install-package.ps1 | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/build/unix/prepare-install-package.sh b/build/unix/prepare-install-package.sh
index 9a89f8d4..9dd24b82 100644
--- a/build/unix/prepare-install-package.sh
+++ b/build/unix/prepare-install-package.sh
@@ -126,7 +126,7 @@ for folder in ${folders[@]}; do
     cp -r "$smapiBin/i18n" "$bundlePath/smapi-internal"
 
     # bundle smapi-internal
-    for name in "0Harmony.dll" "0Harmony.xml" "Mono.Cecil.dll" "Mono.Cecil.Mdb.dll" "Mono.Cecil.Pdb.dll" "MonoMod.Common.dll" "Newtonsoft.Json.dll" "TMXTile.dll" "SMAPI.Toolkit.dll" "SMAPI.Toolkit.pdb" "SMAPI.Toolkit.xml" "SMAPI.Toolkit.CoreInterfaces.dll" "SMAPI.Toolkit.CoreInterfaces.pdb" "SMAPI.Toolkit.CoreInterfaces.xml"; do
+    for name in "0Harmony.dll" "0Harmony.xml" "Mono.Cecil.dll" "Mono.Cecil.Mdb.dll" "Mono.Cecil.Pdb.dll" "MonoMod.Common.dll" "Newtonsoft.Json.dll" "Pintail.dll" "TMXTile.dll" "SMAPI.Toolkit.dll" "SMAPI.Toolkit.pdb" "SMAPI.Toolkit.xml" "SMAPI.Toolkit.CoreInterfaces.dll" "SMAPI.Toolkit.CoreInterfaces.pdb" "SMAPI.Toolkit.CoreInterfaces.xml"; do
         cp "$smapiBin/$name" "$bundlePath/smapi-internal"
     done
 
diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index db7fadcb..9922cbc6 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -132,7 +132,7 @@ foreach ($folder in $folders) {
     cp -Recurse "$smapiBin/i18n" "$bundlePath/smapi-internal"
 
     # bundle smapi-internal
-    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml")) {
+    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "Pintail.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml")) {
         cp "$smapiBin/$name" "$bundlePath/smapi-internal"
     }
 

From 2f279708b3529020ac0630fe96b8dd456e9cb509 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 4 Mar 2022 20:21:14 -0500
Subject: [PATCH 454/856] fix regression with mod XNB files in the content
 pipeline (#766)

---
 .../Framework/ContentManagers/ModContentManager.cs | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 50ea6e61..2c47f14c 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -79,7 +79,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         public override T Load<T>(string assetName, LanguageCode language, bool useCache)
         {
             // normalize key
-            bool isXnbFile = Path.GetExtension(assetName).ToLower() == ".xnb";
             IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
 
             // disable caching
@@ -111,7 +110,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             try
             {
                 // get file
-                FileInfo file = this.GetModFile(isXnbFile ? $"{parsedName}.xnb" : parsedName.Name); // .xnb extension is stripped from asset names passed to the content manager
+                FileInfo file = this.GetModFile(parsedName.Name);
                 if (!file.Exists)
                     throw GetContentError("the specified path doesn't exist.");
 
@@ -121,11 +120,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     // XNB file
                     case ".xnb":
                         {
-                            asset = this.RawLoad<T>(parsedName.Name, useCache: false);
+                            // the underlying content manager adds a .xnb extension implicitly, so
+                            // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
+                            string loadName = parsedName.Name[..^".xnb".Length];
+
+                            // load asset
+                            asset = this.RawLoad<T>(loadName, useCache: false);
                             if (asset is Map map)
                             {
-                                map.assetPath = parsedName.Name;
-                                this.FixTilesheetPaths(map, relativeMapPath: parsedName.Name, fixEagerPathPrefixes: true);
+                                map.assetPath = loadName;
+                                this.FixTilesheetPaths(map, relativeMapPath: loadName, fixEagerPathPrefixes: true);
                             }
                         }
                         break;

From e82406a8458b6b7d1a032f5b2120f8d84a2abf66 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 5 Mar 2022 15:30:51 -0500
Subject: [PATCH 455/856] fix error loading locale code cache when a mod adds
 custom languages (#766)

---
 src/SMAPI/Framework/ContentCoordinator.cs | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 00f9439c..0cdc0736 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -137,7 +137,7 @@ namespace StardewModdingAPI.Framework
             this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
             this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations);
-            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(includeCustomLanguages: false));
+            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(customLanguages: Enumerable.Empty<ModLanguage>()));
         }
 
         /// <summary>Get a new content manager which handles reading files from the game content folder with support for interception.</summary>
@@ -201,7 +201,8 @@ namespace StardewModdingAPI.Framework
         public void OnAdditionalLanguagesInitialized()
         {
             // update locale cache for custom languages, and load it now (since languages added later won't work)
-            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(includeCustomLanguages: true));
+            var customLanguages = this.MainContentManager.Load<List<ModLanguage>>("Data/AdditionalLanguages");
+            this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(customLanguages));
             _ = this.LocaleCodes.Value;
         }
 
@@ -441,7 +442,7 @@ namespace StardewModdingAPI.Framework
             if (language == LocalizedContentManager.LanguageCode.mod && LocalizedContentManager.CurrentModLanguage == null)
                 return null;
 
-            return Game1.content.LanguageCodeString(language);
+            return this.MainContentManager.LanguageCodeString(language);
         }
 
         /// <summary>Dispose held resources.</summary>
@@ -495,19 +496,16 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Get the language enums (like <see cref="LocalizedContentManager.LanguageCode.ja"/>) indexed by locale code (like <c>ja-JP</c>).</summary>
-        /// <param name="includeCustomLanguages">Whether to read custom languages from <c>Data/AdditionalLanguages</c>.</param>
-        private Dictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes(bool includeCustomLanguages)
+        /// <param name="customLanguages">The custom languages to add to the lookup.</param>
+        private Dictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes(IEnumerable<ModLanguage> customLanguages)
         {
             var map = new Dictionary<string, LocalizedContentManager.LanguageCode>(StringComparer.OrdinalIgnoreCase);
 
             // custom languages
-            if (includeCustomLanguages)
+            foreach (ModLanguage language in customLanguages)
             {
-                foreach (ModLanguage language in Game1.content.Load<List<ModLanguage>>("Data/AdditionalLanguages"))
-                {
-                    if (!string.IsNullOrWhiteSpace(language?.LanguageCode))
-                        map[language.LanguageCode] = LocalizedContentManager.LanguageCode.mod;
-                }
+                if (!string.IsNullOrWhiteSpace(language?.LanguageCode))
+                    map[language.LanguageCode] = LocalizedContentManager.LanguageCode.mod;
             }
 
             // vanilla languages (override custom language if they conflict)

From b0d8b23c2c53ea3aafd60b0597a7562ac1708a42 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 5 Mar 2022 15:31:06 -0500
Subject: [PATCH 456/856] migrate more internal code to IAssetName (#766)

---
 src/SMAPI/Framework/ContentCoordinator.cs     | 18 ++--
 .../ContentManagers/BaseContentManager.cs     | 56 +++++-------
 .../ContentManagers/GameContentManager.cs     | 88 +++++++++----------
 .../GameContentManagerForAssetPropagation.cs  |  2 +-
 .../ContentManagers/IContentManager.cs        | 12 +--
 .../ContentManagers/ModContentManager.cs      | 64 +++++++-------
 .../Framework/ModHelpers/ContentHelper.cs     |  8 +-
 src/SMAPI/Metadata/CoreAssetPropagator.cs     | 34 ++++---
 8 files changed, 132 insertions(+), 150 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 0cdc0736..b255dae1 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -136,7 +136,7 @@ namespace StardewModdingAPI.Framework
             );
             this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
-            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations);
+            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations, this.ParseAssetName);
             this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(customLanguages: Enumerable.Empty<ModLanguage>()));
         }
 
@@ -260,8 +260,8 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Get whether this asset is mapped to a mod folder.</summary>
-        /// <param name="key">The asset key.</param>
-        public bool IsManagedAssetKey(string key)
+        /// <param name="key">The asset name.</param>
+        public bool IsManagedAssetKey(IAssetName key)
         {
             return key.StartsWith(this.ManagedPrefix);
         }
@@ -269,9 +269,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>Parse a managed SMAPI asset key which maps to a mod folder.</summary>
         /// <param name="key">The asset key.</param>
         /// <param name="contentManagerID">The unique name for the content manager which should load this asset.</param>
-        /// <param name="relativePath">The relative path within the mod folder.</param>
+        /// <param name="relativePath">The asset name within the mod folder.</param>
         /// <returns>Returns whether the asset was parsed successfully.</returns>
-        public bool TryParseManagedAssetKey(string key, out string contentManagerID, out string relativePath)
+        public bool TryParseManagedAssetKey(string key, out string contentManagerID, out IAssetName relativePath)
         {
             contentManagerID = null;
             relativePath = null;
@@ -285,7 +285,7 @@ namespace StardewModdingAPI.Framework
             if (parts.Length != 3) // managed key prefix, mod id, relative path
                 return false;
             contentManagerID = Path.Combine(parts[0], parts[1]);
-            relativePath = parts[2];
+            relativePath = this.ParseAssetName(parts[2]);
             return true;
         }
 
@@ -299,8 +299,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get a copy of an asset from a mod folder.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="contentManagerID">The unique name for the content manager which should load this asset.</param>
-        /// <param name="relativePath">The internal SMAPI asset key.</param>
-        public T LoadManagedAsset<T>(string contentManagerID, string relativePath)
+        /// <param name="relativePath">The asset name within the mod folder.</param>
+        public T LoadManagedAsset<T>(string contentManagerID, IAssetName relativePath)
         {
             // get content manager
             IContentManager contentManager = this.ContentManagerLock.InReadLock(() =>
@@ -404,7 +404,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get all loaded instances of an asset name.</summary>
         /// <param name="assetName">The asset name.</param>
         [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "This method is provided for Content Patcher.")]
-        public IEnumerable<object> GetLoadedValues(string assetName)
+        public IEnumerable<object> GetLoadedValues(IAssetName assetName)
         {
             return this.ContentManagerLock.InReadLock(() =>
             {
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 26f0921d..3efc33bb 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -92,38 +92,32 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.BaseDisposableReferences = reflection.GetField<List<IDisposable>>(this, "disposableAssets").GetValue();
         }
 
+        /// <inheritdoc />
+        [Obsolete("This method is implemented for the base game and should not be used directly. To load an asset from the underlying content manager directly, use " + nameof(BaseContentManager.RawLoad) + " instead.")]
+        public override T LoadBase<T>(string assetName)
+        {
+            return this.Load<T>(assetName, LanguageCode.en);
+        }
+
         /// <inheritdoc />
         public override T Load<T>(string assetName)
         {
-            return this.Load<T>(assetName, this.Language, useCache: true);
+            return this.Load<T>(assetName, this.Language);
         }
 
         /// <inheritdoc />
         public override T Load<T>(string assetName, LanguageCode language)
         {
-            return this.Load<T>(assetName, language, useCache: true);
+            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
+            return this.Load<T>(parsedName, language, useCache: true);
         }
 
         /// <inheritdoc />
-        public abstract T Load<T>(string assetName, LocalizedContentManager.LanguageCode language, bool useCache);
-
-        /// <inheritdoc />
-        [Obsolete("This method is implemented for the base game and should not be used directly. To load an asset from the underlying content manager directly, use " + nameof(BaseContentManager.RawLoad) + " instead.")]
-        public override T LoadBase<T>(string assetName)
-        {
-            return this.Load<T>(assetName, LanguageCode.en, useCache: true);
-        }
+        public abstract T Load<T>(IAssetName assetName, LanguageCode language, bool useCache);
 
         /// <inheritdoc />
         public virtual void OnLocaleChanged() { }
 
-        /// <inheritdoc />
-        [Pure]
-        public string NormalizePathSeparators(string path)
-        {
-            return this.Cache.NormalizePathSeparators(path);
-        }
-
         /// <inheritdoc />
         [SuppressMessage("ReSharper", "ParameterOnlyUsedForPreconditionCheck.Local", Justification = "Parameter is only used for assertion checks by design.")]
         public string AssertAndNormalizeAssetName(string assetName)
@@ -154,11 +148,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public bool IsLoaded(string assetName, LanguageCode language)
-        {
-            assetName = this.Cache.NormalizeKey(assetName);
-            return this.IsNormalizedKeyLoaded(assetName, language);
-        }
+        public abstract bool IsLoaded(IAssetName assetName, LanguageCode language);
 
         /****
         ** Cache invalidation
@@ -233,6 +223,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
+        /// <summary>Normalize path separators in a file path. For asset keys, see <see cref="AssertAndNormalizeAssetName"/> instead.</summary>
+        /// <param name="path">The file path to normalize.</param>
+        [Pure]
+        protected string NormalizePathSeparators(string path)
+        {
+            return this.Cache.NormalizePathSeparators(path);
+        }
+
         /// <summary>Load an asset file directly from the underlying content manager.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The normalized asset key.</param>
@@ -250,26 +248,18 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="value">The asset value.</param>
         /// <param name="language">The language code for which to inject the asset.</param>
         /// <param name="useCache">Whether to save the asset to the asset cache.</param>
-        protected virtual void TrackAsset<T>(string assetName, T value, LanguageCode language, bool useCache)
+        protected virtual void TrackAsset<T>(IAssetName assetName, T value, LanguageCode language, bool useCache)
         {
             // track asset key
             if (value is Texture2D texture)
-                texture.Name = assetName;
+                texture.Name = assetName.Name;
 
             // cache asset
             if (useCache)
-            {
-                assetName = this.AssertAndNormalizeAssetName(assetName);
-                this.Cache[assetName] = value;
-            }
+                this.Cache[assetName.Name] = value;
 
             // avoid hard disposable references; see remarks on the field
             this.BaseDisposableReferences.Clear();
         }
-
-        /// <summary>Get whether an asset has already been loaded.</summary>
-        /// <param name="normalizedAssetName">The normalized asset name.</param>
-        /// <param name="language">The language to check.</param>
-        protected abstract bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language);
     }
 }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 0ca9e277..9f686f97 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -63,7 +63,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public override T Load<T>(string assetName, LocalizedContentManager.LanguageCode language, bool useCache)
+        public override T Load<T>(IAssetName assetName, LanguageCode language, bool useCache)
         {
             // raise first-load callback
             if (GameContentManager.IsFirstLoad)
@@ -73,49 +73,62 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // normalize asset name
-            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
-            if (parsedName.LanguageCode.HasValue)
-                return this.Load<T>(parsedName.BaseName, parsedName.LanguageCode.Value, useCache);
+            if (assetName.LanguageCode.HasValue)
+                return this.Load<T>(this.Coordinator.ParseAssetName(assetName.BaseName), assetName.LanguageCode.Value, useCache);
 
             // get from cache
-            if (useCache && this.IsLoaded(parsedName.Name, language))
-                return this.RawLoad<T>(parsedName.Name, language, useCache: true);
+            if (useCache && this.IsLoaded(assetName, language))
+                return this.RawLoad<T>(assetName, language, useCache: true);
 
             // get managed asset
-            if (this.Coordinator.TryParseManagedAssetKey(parsedName.Name, out string contentManagerID, out string relativePath))
+            if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
             {
                 T managedAsset = this.Coordinator.LoadManagedAsset<T>(contentManagerID, relativePath);
-                this.TrackAsset(parsedName.Name, managedAsset, language, useCache);
+                this.TrackAsset(assetName, managedAsset, language, useCache);
                 return managedAsset;
             }
 
             // load asset
             T data;
-            if (this.AssetsBeingLoaded.Contains(parsedName.Name))
+            if (this.AssetsBeingLoaded.Contains(assetName.Name))
             {
-                this.Monitor.Log($"Broke loop while loading asset '{parsedName.Name}'.", LogLevel.Warn);
+                this.Monitor.Log($"Broke loop while loading asset '{assetName}'.", LogLevel.Warn);
                 this.Monitor.Log($"Bypassing mod loaders for this asset. Stack trace:\n{Environment.StackTrace}");
-                data = this.RawLoad<T>(parsedName.Name, language, useCache);
+                data = this.RawLoad<T>(assetName, language, useCache);
             }
             else
             {
-                data = this.AssetsBeingLoaded.Track(parsedName.Name, () =>
+                data = this.AssetsBeingLoaded.Track(assetName.Name, () =>
                 {
                     string locale = this.GetLocale(language);
-                    IAssetInfo info = new AssetInfo(locale, parsedName, typeof(T), this.AssertAndNormalizeAssetName);
+                    IAssetInfo info = new AssetInfo(locale, assetName, typeof(T), this.AssertAndNormalizeAssetName);
                     IAssetData asset =
                         this.ApplyLoader<T>(info)
-                        ?? new AssetDataForObject(info, this.RawLoad<T>(parsedName.Name, language, useCache), this.AssertAndNormalizeAssetName);
+                        ?? new AssetDataForObject(info, this.RawLoad<T>(assetName, language, useCache), this.AssertAndNormalizeAssetName);
                     asset = this.ApplyEditors<T>(info, asset);
                     return (T)asset.Data;
                 });
             }
 
             // update cache & return data
-            this.TrackAsset(parsedName.Name, data, language, useCache);
+            this.TrackAsset(assetName, data, language, useCache);
             return data;
         }
 
+        /// <inheritdoc />
+        public override bool IsLoaded(IAssetName assetName, LanguageCode language)
+        {
+            string cachedKey = null;
+            bool localized =
+                language != LanguageCode.en
+                && !this.Coordinator.IsManagedAssetKey(assetName)
+                && this.LocalizedAssetNames.TryGetValue(assetName.Name, out cachedKey);
+
+            return localized
+                ? this.Cache.ContainsKey(cachedKey)
+                : this.Cache.ContainsKey(assetName.Name);
+        }
+
         /// <inheritdoc />
         public override void OnLocaleChanged()
         {
@@ -153,28 +166,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
         ** Private methods
         *********/
         /// <inheritdoc />
-        protected override bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language)
-        {
-            string cachedKey = null;
-            bool localized =
-                language != LocalizedContentManager.LanguageCode.en
-                && !this.Coordinator.IsManagedAssetKey(normalizedAssetName)
-                && this.LocalizedAssetNames.TryGetValue(normalizedAssetName, out cachedKey);
-
-            return localized
-                ? this.Cache.ContainsKey(cachedKey)
-                : this.Cache.ContainsKey(normalizedAssetName);
-        }
-
-        /// <inheritdoc />
-        protected override void TrackAsset<T>(string assetName, T value, LanguageCode language, bool useCache)
+        protected override void TrackAsset<T>(IAssetName assetName, T value, LanguageCode language, bool useCache)
         {
             // handle explicit language in asset name
             {
-                IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
-                if (parsedName.LanguageCode.HasValue)
+                if (assetName.LanguageCode.HasValue)
                 {
-                    this.TrackAsset(parsedName.BaseName, value, parsedName.LanguageCode.Value, useCache);
+                    this.TrackAsset(this.Coordinator.ParseAssetName(assetName.BaseName), value, assetName.LanguageCode.Value, useCache);
                     return;
                 }
             }
@@ -188,16 +186,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
             //      doesn't change the instance stored in the cache, e.g. using `asset.ReplaceWith`.
             if (useCache)
             {
-                string translatedKey = $"{assetName}.{this.GetLocale(language)}";
+                IAssetName translatedKey = new AssetName(assetName.Name, this.GetLocale(language), language);
                 base.TrackAsset(assetName, value, language, useCache: true);
-                if (this.Cache.ContainsKey(translatedKey))
+                if (this.Cache.ContainsKey(translatedKey.Name))
                     base.TrackAsset(translatedKey, value, language, useCache: true);
 
                 // track whether the injected asset is translatable for is-loaded lookups
-                if (this.Cache.ContainsKey(translatedKey))
-                    this.LocalizedAssetNames[assetName] = translatedKey;
-                else if (this.Cache.ContainsKey(assetName))
-                    this.LocalizedAssetNames[assetName] = assetName;
+                if (this.Cache.ContainsKey(translatedKey.Name))
+                    this.LocalizedAssetNames[assetName.Name] = translatedKey.Name;
+                else if (this.Cache.ContainsKey(assetName.Name))
+                    this.LocalizedAssetNames[assetName.Name] = assetName.Name;
                 else
                     this.Monitor.Log($"Asset '{assetName}' could not be found in the cache immediately after injection.", LogLevel.Error);
             }
@@ -209,32 +207,32 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="language">The language code for which to load content.</param>
         /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
         /// <remarks>Derived from <see cref="LocalizedContentManager.Load{T}(string, LocalizedContentManager.LanguageCode)"/>.</remarks>
-        private T RawLoad<T>(string assetName, LanguageCode language, bool useCache)
+        private T RawLoad<T>(IAssetName assetName, LanguageCode language, bool useCache)
         {
             try
             {
                 // use cached key
-                if (language == this.Language && this.LocalizedAssetNames.TryGetValue(assetName, out string cachedKey))
+                if (language == this.Language && this.LocalizedAssetNames.TryGetValue(assetName.Name, out string cachedKey))
                     return base.RawLoad<T>(cachedKey, useCache);
 
                 // try translated key
-                if (language != LocalizedContentManager.LanguageCode.en)
+                if (language != LanguageCode.en)
                 {
                     string translatedKey = $"{assetName}.{this.GetLocale(language)}";
                     try
                     {
                         T obj = base.RawLoad<T>(translatedKey, useCache);
-                        this.LocalizedAssetNames[assetName] = translatedKey;
+                        this.LocalizedAssetNames[assetName.Name] = translatedKey;
                         return obj;
                     }
                     catch (ContentLoadException)
                     {
-                        this.LocalizedAssetNames[assetName] = assetName;
+                        this.LocalizedAssetNames[assetName.Name] = assetName.Name;
                     }
                 }
 
                 // try base asset
-                return base.RawLoad<T>(assetName, useCache);
+                return base.RawLoad<T>(assetName.Name, useCache);
             }
             catch (ContentLoadException ex) when (ex.InnerException is FileNotFoundException innerEx && innerEx.InnerException == null)
             {
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
index 61683ce6..206ece30 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
@@ -25,7 +25,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, onLoadingFirstAsset, aggressiveMemoryOptimizations) { }
 
         /// <inheritdoc />
-        public override T Load<T>(string assetName, LanguageCode language, bool useCache)
+        public override T Load<T>(IAssetName assetName, LanguageCode language, bool useCache)
         {
             T data = base.Load<T>(assetName, language, useCache);
 
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index ba7dbc06..fe0519b6 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -1,6 +1,5 @@
 using System;
 using System.Collections.Generic;
-using System.Diagnostics.Contracts;
 using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewValley;
@@ -31,15 +30,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         *********/
         /// <summary>Load an asset that has been processed by the content pipeline.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
         /// <param name="language">The language code for which to load content.</param>
         /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
-        T Load<T>(string assetName, LocalizedContentManager.LanguageCode language, bool useCache);
-
-        /// <summary>Normalize path separators in a file path. For asset keys, see <see cref="AssertAndNormalizeAssetName"/> instead.</summary>
-        /// <param name="path">The file path to normalize.</param>
-        [Pure]
-        string NormalizePathSeparators(string path);
+        T Load<T>(IAssetName assetName, LocalizedContentManager.LanguageCode language, bool useCache);
 
         /// <summary>Assert that the given key has a valid format and return a normalized form consistent with the underlying cache.</summary>
         /// <param name="assetName">The asset key to check.</param>
@@ -56,7 +50,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Get whether the content manager has already loaded and cached the given asset.</summary>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
         /// <param name="language">The language.</param>
-        bool IsLoaded(string assetName, LocalizedContentManager.LanguageCode language);
+        bool IsLoaded(IAssetName assetName, LocalizedContentManager.LanguageCode language);
 
         /// <summary>Purge matched assets from the cache.</summary>
         /// <param name="predicate">Matches the asset keys to invalidate.</param>
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 2c47f14c..267146ad 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -66,21 +66,19 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <inheritdoc />
         public override T Load<T>(string assetName)
         {
-            return this.Load<T>(assetName, this.DefaultLanguage, useCache: false);
+            return this.Load<T>(assetName, this.DefaultLanguage);
         }
 
         /// <inheritdoc />
         public override T Load<T>(string assetName, LanguageCode language)
         {
-            return this.Load<T>(assetName, language, useCache: false);
+            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
+            return this.Load<T>(parsedName, language, useCache: false);
         }
 
         /// <inheritdoc />
-        public override T Load<T>(string assetName, LanguageCode language, bool useCache)
+        public override T Load<T>(IAssetName assetName, LanguageCode language, bool useCache)
         {
-            // normalize key
-            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
-
             // disable caching
             // This is necessary to avoid assets being shared between content managers, which can
             // cause changes to an asset through one content manager affecting the same asset in
@@ -96,21 +94,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // resolve managed asset key
             {
-                if (this.Coordinator.TryParseManagedAssetKey(parsedName.Name, out string contentManagerID, out string relativePath))
+                if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
                 {
                     if (contentManagerID != this.Name)
-                        throw new SContentLoadException($"Can't load managed asset key '{parsedName}' through content manager '{this.Name}' for a different mod.");
-                    parsedName = this.Coordinator.ParseAssetName(relativePath);
+                        throw new SContentLoadException($"Can't load managed asset key '{assetName}' through content manager '{this.Name}' for a different mod.");
+                    assetName = relativePath;
                 }
             }
 
             // get local asset
-            SContentLoadException GetContentError(string reasonPhrase) => new SContentLoadException($"Failed loading asset '{parsedName}' from {this.Name}: {reasonPhrase}");
+            SContentLoadException GetContentError(string reasonPhrase) => new($"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}");
             T asset;
             try
             {
                 // get file
-                FileInfo file = this.GetModFile(parsedName.Name);
+                FileInfo file = this.GetModFile(assetName.Name);
                 if (!file.Exists)
                     throw GetContentError("the specified path doesn't exist.");
 
@@ -122,7 +120,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         {
                             // the underlying content manager adds a .xnb extension implicitly, so
                             // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
-                            string loadName = parsedName.Name[..^".xnb".Length];
+                            string loadName = assetName.Name[..^".xnb".Length];
 
                             // load asset
                             asset = this.RawLoad<T>(loadName, useCache: false);
@@ -177,8 +175,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
                             // fetch & cache
                             FormatManager formatManager = FormatManager.Instance;
                             Map map = formatManager.LoadMap(file.FullName);
-                            map.assetPath = parsedName.Name;
-                            this.FixTilesheetPaths(map, relativeMapPath: parsedName.Name, fixEagerPathPrefixes: false);
+                            map.assetPath = assetName.Name;
+                            this.FixTilesheetPaths(map, relativeMapPath: assetName.Name, fixEagerPathPrefixes: false);
                             asset = (T)(object)map;
                         }
                         break;
@@ -189,14 +187,20 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
             catch (Exception ex) when (!(ex is SContentLoadException))
             {
-                throw new SContentLoadException($"The content manager failed loading content asset '{parsedName}' from {this.Name}.", ex);
+                throw new SContentLoadException($"The content manager failed loading content asset '{assetName}' from {this.Name}.", ex);
             }
 
             // track & return asset
-            this.TrackAsset(parsedName.Name, asset, language, useCache);
+            this.TrackAsset(assetName, asset, language, useCache);
             return asset;
         }
 
+        /// <inheritdoc />
+        public override bool IsLoaded(IAssetName assetName, LanguageCode language)
+        {
+            return this.Cache.ContainsKey(assetName.Name);
+        }
+
         /// <inheritdoc />
         public override LocalizedContentManager CreateTemporary()
         {
@@ -206,23 +210,19 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Get the underlying key in the game's content cache for an asset. This does not validate whether the asset exists.</summary>
         /// <param name="key">The local path to a content file relative to the mod folder.</param>
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
-        public string GetInternalAssetKey(string key)
+        public IAssetName GetInternalAssetKey(string key)
         {
             FileInfo file = this.GetModFile(key);
             string relativePath = PathUtilities.GetRelativePath(this.RootDirectory, file.FullName);
-            return Path.Combine(this.Name, relativePath);
+            string internalKey = Path.Combine(this.Name, relativePath);
+
+            return this.Coordinator.ParseAssetName(internalKey);
         }
 
 
         /*********
         ** Private methods
         *********/
-        /// <inheritdoc />
-        protected override bool IsNormalizedKeyLoaded(string normalizedAssetName, LanguageCode language)
-        {
-            return this.Cache.ContainsKey(normalizedAssetName);
-        }
-
         /// <summary>Get a file from the mod folder.</summary>
         /// <param name="path">The asset path relative to the content folder.</param>
         private FileInfo GetModFile(string path)
@@ -304,15 +304,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // load best match
                 try
                 {
-                    if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out string assetName, out string error))
+                    if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out IAssetName assetName, out string error))
                         throw new SContentLoadException($"{errorPrefix} {error}");
 
-                    if (assetName != tilesheet.ImageSource)
+                    if (!assetName.IsEquivalentTo(tilesheet.ImageSource))
                         this.Monitor.VerboseLog($"   Mapped tilesheet '{tilesheet.ImageSource}' to '{assetName}'.");
 
-                    tilesheet.ImageSource = assetName;
+                    tilesheet.ImageSource = assetName.Name;
                 }
-                catch (Exception ex) when (!(ex is SContentLoadException))
+                catch (Exception ex) when (ex is not SContentLoadException)
                 {
                     throw new SContentLoadException($"{errorPrefix} The tilesheet couldn't be loaded.", ex);
                 }
@@ -326,7 +326,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="error">A message indicating why the file couldn't be loaded.</param>
         /// <returns>Returns whether the asset name was found.</returns>
         /// <remarks>See remarks on <see cref="FixTilesheetPaths"/>.</remarks>
-        private bool TryGetTilesheetAssetName(string modRelativeMapFolder, string relativePath, out string assetName, out string error)
+        private bool TryGetTilesheetAssetName(string modRelativeMapFolder, string relativePath, out IAssetName assetName, out string error)
         {
             assetName = null;
             error = null;
@@ -334,7 +334,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // nothing to do
             if (string.IsNullOrWhiteSpace(relativePath))
             {
-                assetName = relativePath;
+                assetName = null;
                 return true;
             }
 
@@ -358,7 +358,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // get from game assets
-            string contentKey = this.GetContentKeyForTilesheetImageSource(relativePath);
+            IAssetName contentKey = this.Coordinator.ParseAssetName(this.GetContentKeyForTilesheetImageSource(relativePath));
             try
             {
                 this.GameContentManager.Load<Texture2D>(contentKey, this.Language, useCache: true); // no need to bypass cache here, since we're not storing the asset
@@ -374,7 +374,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // if the content file doesn't exist, that doesn't mean the error here is a
                 // content-not-found error. Unfortunately XNA doesn't provide a good way to
                 // detect the error type.
-                if (this.GetContentFolderFileExists(contentKey))
+                if (this.GetContentFolderFileExists(contentKey.Name))
                     throw;
             }
 
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index a01248a8..4e522c8d 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -80,16 +80,18 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <inheritdoc />
         public T Load<T>(string key, ContentSource source = ContentSource.ModFolder)
         {
+            IAssetName assetName = this.ContentCore.ParseAssetName(key);
+
             try
             {
                 this.AssertAndNormalizeAssetName(key);
                 switch (source)
                 {
                     case ContentSource.GameContent:
-                        return this.GameContentManager.Load<T>(key, this.CurrentLocaleConstant, useCache: false);
+                        return this.GameContentManager.Load<T>(assetName, this.CurrentLocaleConstant, useCache: false);
 
                     case ContentSource.ModFolder:
-                        return this.ModContentManager.Load<T>(key, Constants.DefaultLanguage, useCache: false);
+                        return this.ModContentManager.Load<T>(assetName, Constants.DefaultLanguage, useCache: false);
 
                     default:
                         throw new SContentLoadException($"{this.ModName} failed loading content asset '{key}' from {source}: unknown content source '{source}'.");
@@ -117,7 +119,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                     return this.GameContentManager.AssertAndNormalizeAssetName(key);
 
                 case ContentSource.ModFolder:
-                    return this.ModContentManager.GetInternalAssetKey(key);
+                    return this.ModContentManager.GetInternalAssetKey(key).Name;
 
                 default:
                     throw new NotSupportedException($"Unknown content source '{source}'.");
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index e7fac578..f645470e 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -45,8 +45,8 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Whether to enable more aggressive memory optimizations.</summary>
         private readonly bool AggressiveMemoryOptimizations;
 
-        /// <summary>Normalizes an asset key to match the cache key and assert that it's valid.</summary>
-        private readonly Func<string, string> AssertAndNormalizeAssetName;
+        /// <summary>Parse a raw asset name.</summary>
+        private readonly Func<string, IAssetName> ParseAssetName;
 
         /// <summary>Optimized bucket categories for batch reloading assets.</summary>
         private enum AssetBucket
@@ -71,15 +71,15 @@ namespace StardewModdingAPI.Metadata
         /// <param name="monitor">Writes messages to the console.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, IMonitor monitor, Reflector reflection, bool aggressiveMemoryOptimizations)
+        /// <param name="parseAssetName">Parse a raw asset name.</param>
+        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, IMonitor monitor, Reflector reflection, bool aggressiveMemoryOptimizations, Func<string, IAssetName> parseAssetName)
         {
             this.MainContentManager = mainContent;
             this.DisposableContentManager = disposableContent;
             this.Monitor = monitor;
             this.Reflection = reflection;
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
-
-            this.AssertAndNormalizeAssetName = disposableContent.AssertAndNormalizeAssetName;
+            this.ParseAssetName = parseAssetName;
         }
 
         /// <summary>Reload one of the game's core assets (if applicable).</summary>
@@ -955,13 +955,12 @@ namespace StardewModdingAPI.Metadata
         private void ReloadNpcSprites(IEnumerable<IAssetName> keys, IDictionary<IAssetName, bool> propagated)
         {
             // get NPCs
-            IDictionary<string, IAssetName> lookup = keys.ToDictionary(p => p.Name, StringComparer.OrdinalIgnoreCase);
             var characters =
                 (
                     from npc in this.GetCharacters()
-                    let key = this.NormalizeAssetNameIgnoringEmpty(npc.Sprite?.Texture?.Name)
-                    where key != null && lookup.ContainsKey(key)
-                    select new { Npc = npc, AssetName = lookup[key] }
+                    let key = this.ParseAssetNameOrNull(npc.Sprite?.Texture?.Name)
+                    where key != null && propagated.ContainsKey(key)
+                    select new { Npc = npc, AssetName = key }
                 )
                 .ToArray();
             if (!characters.Any())
@@ -981,26 +980,25 @@ namespace StardewModdingAPI.Metadata
         private void ReloadNpcPortraits(IEnumerable<IAssetName> keys, IDictionary<IAssetName, bool> propagated)
         {
             // get NPCs
-            IDictionary<string, IAssetName> lookup = keys.ToDictionary(p => p.Name, StringComparer.OrdinalIgnoreCase);
             var characters =
                 (
                     from npc in this.GetCharacters()
                     where npc.isVillager()
 
-                    let key = this.NormalizeAssetNameIgnoringEmpty(npc.Portrait?.Name)
-                    where key != null && lookup.ContainsKey(key)
-                    select new { Npc = npc, AssetName = lookup[key] }
+                    let key = this.ParseAssetNameOrNull(npc.Portrait?.Name)
+                    where key != null && propagated.ContainsKey(key)
+                    select new { Npc = npc, AssetName = key }
                 )
                 .ToList();
 
             // special case: Gil is a private NPC field on the AdventureGuild class (only used for the portrait)
             {
-                string gilKey = this.NormalizeAssetNameIgnoringEmpty("Portraits/Gil");
-                if (lookup.TryGetValue(gilKey, out IAssetName assetName))
+                IAssetName gilKey = this.ParseAssetName("Portraits/Gil");
+                if (propagated.ContainsKey(gilKey))
                 {
                     GameLocation adventureGuild = Game1.getLocationFromName("AdventureGuild");
                     if (adventureGuild != null)
-                        characters.Add(new { Npc = this.Reflection.GetField<NPC>(adventureGuild, "Gil").GetValue(), AssetName = assetName });
+                        characters.Add(new { Npc = this.Reflection.GetField<NPC>(adventureGuild, "Gil").GetValue(), AssetName = gilKey });
                 }
             }
 
@@ -1234,12 +1232,12 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Normalize an asset key to match the cache key and assert that it's valid, but don't raise an error for null or empty values.</summary>
         /// <param name="path">The asset key to normalize.</param>
-        private string NormalizeAssetNameIgnoringEmpty(string path)
+        private IAssetName ParseAssetNameOrNull(string path)
         {
             if (string.IsNullOrWhiteSpace(path))
                 return null;
 
-            return this.AssertAndNormalizeAssetName(path);
+            return this.ParseAssetName(path);
         }
 
         /// <summary>Get the segments in a path (e.g. 'a/b' is 'a' and 'b').</summary>

From b68b301b712a0047a7d6f24aa2fb776e19f8086d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 5 Mar 2022 15:38:05 -0500
Subject: [PATCH 457/856] add DoesAssetExist to support the upcoming Stardew
 Valley 1.6 (#766)

---
 src/SMAPI/Framework/ContentCoordinator.cs     | 16 +++++
 .../ContentManagers/BaseContentManager.cs     |  6 ++
 .../ContentManagers/GameContentManager.cs     | 58 ++++++++++++++-----
 .../ContentManagers/IContentManager.cs        |  4 ++
 .../ContentManagers/ModContentManager.cs      | 10 ++++
 5 files changed, 80 insertions(+), 14 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index b255dae1..fbbbe2d2 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -296,6 +296,22 @@ namespace StardewModdingAPI.Framework
             return Path.Combine(this.ManagedPrefix, modID.ToLower());
         }
 
+        /// <summary>Get whether an asset from a mod folder exists.</summary>
+        /// <param name="contentManagerID">The unique name for the content manager which should load this asset.</param>
+        /// <param name="assetName">The asset name within the mod folder.</param>
+        public bool DoesManagedAssetExist(string contentManagerID, IAssetName assetName)
+        {
+            // get content manager
+            IContentManager contentManager = this.ContentManagerLock.InReadLock(() =>
+                this.ContentManagers.FirstOrDefault(p => p.IsNamespaced && p.Name == contentManagerID)
+            );
+            if (contentManager == null)
+                throw new InvalidOperationException($"The '{contentManagerID}' prefix isn't handled by any mod.");
+
+            // get whether the asset exists
+            return contentManager.DoesAssetExist(assetName);
+        }
+
         /// <summary>Get a copy of an asset from a mod folder.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="contentManagerID">The unique name for the content manager which should load this asset.</param>
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 3efc33bb..030c60a7 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -92,6 +92,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.BaseDisposableReferences = reflection.GetField<List<IDisposable>>(this, "disposableAssets").GetValue();
         }
 
+        /// <inheritdoc />
+        public virtual bool DoesAssetExist(IAssetName assetName)
+        {
+            return this.Cache.ContainsKey(assetName.Name);
+        }
+
         /// <inheritdoc />
         [Obsolete("This method is implemented for the base game and should not be used directly. To load an asset from the underlying content manager directly, use " + nameof(BaseContentManager.RawLoad) + " instead.")]
         public override T LoadBase<T>(string assetName)
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 9f686f97..e7fb0c5f 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -62,6 +62,29 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
         }
 
+        /// <inheritdoc />
+        public override bool DoesAssetExist(IAssetName assetName)
+        {
+            if (base.DoesAssetExist(assetName))
+                return true;
+
+            // managed asset
+            if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
+                return this.Coordinator.DoesManagedAssetExist(contentManagerID, relativePath);
+
+            // else check for loaders
+            string locale = this.GetLocale();
+            IAssetInfo info = new AssetInfo(locale, assetName, typeof(object), this.AssertAndNormalizeAssetName);
+            ModLinked<IAssetLoader>[] loaders = this.GetLoaders<object>(info).ToArray();
+            if (loaders.Length > 1)
+            {
+                string[] loaderNames = loaders.Select(p => p.Mod.DisplayName).ToArray();
+                this.Monitor.Log($"Multiple mods want to provide the '{info.Name}' asset ({string.Join(", ", loaderNames)}), but an asset can't be loaded multiple times. SMAPI will use the default asset instead; uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)", LogLevel.Warn);
+            }
+
+            return loaders.Length == 1;
+        }
+
         /// <inheritdoc />
         public override T Load<T>(IAssetName assetName, LanguageCode language, bool useCache)
         {
@@ -246,20 +269,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private IAssetData ApplyLoader<T>(IAssetInfo info)
         {
             // find matching loaders
-            var loaders = this.Loaders
-                .Where(entry =>
-                {
-                    try
-                    {
-                        return entry.Data.CanLoad<T>(info);
-                    }
-                    catch (Exception ex)
-                    {
-                        entry.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
-                        return false;
-                    }
-                })
-                .ToArray();
+            var loaders = this.GetLoaders<T>(info).ToArray();
 
             // validate loaders
             if (!loaders.Any())
@@ -360,6 +370,26 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return asset;
         }
 
+        /// <summary>Get the asset loaders which handle the asset.</summary>
+        /// <typeparam name="T">The asset type.</typeparam>
+        /// <param name="info">The basic asset metadata.</param>
+        private IEnumerable<ModLinked<IAssetLoader>> GetLoaders<T>(IAssetInfo info)
+        {
+            return this.Loaders
+                .Where(entry =>
+                {
+                    try
+                    {
+                        return entry.Data.CanLoad<T>(info);
+                    }
+                    catch (Exception ex)
+                    {
+                        entry.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                        return false;
+                    }
+                });
+        }
+
         /// <summary>Validate that an asset loaded by a mod is valid and won't cause issues, and fix issues if possible.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index fe0519b6..6d71472f 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -28,6 +28,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Methods
         *********/
+        /// <summary>Get whether an asset exists and can be loaded.</summary>
+        /// <param name="assetName">The normalized asset name.</param>
+        bool DoesAssetExist(IAssetName assetName);
+
         /// <summary>Load an asset that has been processed by the content pipeline.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 267146ad..90836fcf 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -63,6 +63,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.ModName = modName;
         }
 
+        /// <inheritdoc />
+        public override bool DoesAssetExist(IAssetName assetName)
+        {
+            if (base.DoesAssetExist(assetName))
+                return true;
+
+            FileInfo file = this.GetModFile(assetName.Name);
+            return file.Exists;
+        }
+
         /// <inheritdoc />
         public override T Load<T>(string assetName)
         {

From debe17724129c947dddf029c725af5224940cd0e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 5 Mar 2022 18:12:00 -0500
Subject: [PATCH 458/856] handle vanilla assets in DoesAssetExist (#766)

---
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index e7fb0c5f..9b8125ad 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -68,11 +68,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
             if (base.DoesAssetExist(assetName))
                 return true;
 
+            // vanilla asset
+            if (File.Exists(Path.Combine(this.RootDirectory, $"{assetName.Name}.xnb")))
+                return true;
+
             // managed asset
             if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
                 return this.Coordinator.DoesManagedAssetExist(contentManagerID, relativePath);
 
-            // else check for loaders
+            // custom asset from a loader
             string locale = this.GetLocale();
             IAssetInfo info = new AssetInfo(locale, assetName, typeof(object), this.AssertAndNormalizeAssetName);
             ModLinked<IAssetLoader>[] loaders = this.GetLoaders<object>(info).ToArray();

From 2216e37726874af6ab164dbbaef454eb0f2218d0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 6 Mar 2022 19:55:32 -0500
Subject: [PATCH 459/856] rework launch script argument parsing (#832)

This commit...

* replaces the internal `--no-reopen-terminal` arg with a documented `--use-current-shell` arg that works on Linux too;
* replaces the new SKIP_TERMINAL environment variable with the existing SMAPI_NO_TERMINAL one;
* moves argument parsing out of the 'initial setup' section (so it's easier for players to edit if needed);
* simplfies argument parsing (no need to support short opt names or add arguments for the default behavior);
* fixes arguments not parsed after the first unrecognized argument, so `--unknown --no-terminal` would still open a terminal.
---
 docs/release-notes.md                       |  3 +
 docs/technical/smapi.md                     | 10 ++--
 src/SMAPI.Installer/assets/unix-launcher.sh | 61 +++++++++++++--------
 3 files changed, 47 insertions(+), 27 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d92ef63d..3030cc5d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,9 @@
 * For players:
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
   * Fixed `player_add` console command's handling of Journal Scraps and Secret Notes.
+  * Improved [command-line arguments](technical/smapi.md#command-line-arguments) on Linux/macOS:
+    * Added `--use-current-shell` to avoid opening a separate terminal window.
+    * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
 
 * For mod authors:
   * Overhauled [mod-provided APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) (thanks to Shockah!).  
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index d9aad875..7da1e0f1 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -38,18 +38,20 @@ or testing and may change without warning. On Linux/macOS, see _environment vari
 
 argument | purpose
 -------- | -------
-`--no-terminal` | SMAPI won't write anything to the console window. (Messages will still be written to the log file.)
+`--no-terminal` | The SMAPI launcher won't try to open a terminal window, and SMAPI won't log anything to the console. (Messages will still be written to the log file.)
+`--use-current-shell` | The SMAPI launcher won't try to open a terminal window, but SMAPI will still log to the console. (Messages will still be written to the log file.)
 `--mods-path` | The path to search for mods, if not the standard `Mods` folder. This can be a path relative to the game folder (like `--mods-path "Mods (test)"`) or an absolute path.
 
 ### Environment variables
-The above SMAPI arguments don't work on Linux/macOS due to the way the game launcher works. You can
-set temporary environment variables instead. For example:
+The above SMAPI arguments may not work on Linux/macOS due to the way the game launcher works. You
+can set temporary environment variables instead. For example:
 > SMAPI_MODS_PATH="Mods (multiplayer)" /path/to/StardewValley
 
 environment variable | purpose
 -------------------- | -------
-`SMAPI_NO_TERMINAL` | Equivalent to `--no-terminal` above.
 `SMAPI_MODS_PATH` | Equivalent to `--mods-path` above.
+`SMAPI_NO_TERMINAL` | Equivalent to `--no-terminal` above.
+`SMAPI_USE_CURRENT_SHELL` | Equivalent to `--use-current-shell` above.
 
 ### Compile flags
 SMAPI uses a small number of conditional compilation constants, which you can set by editing the
diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 6e8d4df3..ae9624e7 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -6,19 +6,40 @@
 # move to script's directory
 cd "$(dirname "$0")" || exit $?
 
-# change to true to skip opening a terminal
+# Whether to avoid opening a separate terminal window, and avoid logging anything to the console.
 # This isn't recommended since you won't see errors, warnings, and update alerts.
-OPTS=`getopt -o St --long skip-terminal,terminal -n 'parse-options' -- "$@"`
-while true; do
-  case "$1" in
-    -S | --skip-terminal ) SKIP_TERMINAL=true; shift ;;
-    -t | --terminal ) SKIP_TERMINAL=false; shift ;;
-    -- ) shift; break ;;
-    * ) break ;;
-  esac
+SKIP_TERMINAL=false
+
+# Whether to avoid opening a separate terminal, but still send the usual log output to the console.
+USE_CURRENT_SHELL=false
+
+
+##########
+## Read environment variables
+##########
+if [ "$SMAPI_NO_TERMINAL" == "true" ]; then
+    SKIP_TERMINAL=true
+fi
+if [ "$SMAPI_USE_CURRENT_SHELL" == "true" ]; then
+    USE_CURRENT_SHELL=true
+fi
+
+
+##########
+## Read command-line arguments
+##########
+while [ "$#" -gt 0 ]; do
+    case "$1" in
+        --skip-terminal ) SKIP_TERMINAL=true; shift ;;
+        --use-current-shell ) USE_CURRENT_SHELL=true; shift ;;
+        -- ) shift; break ;;
+        * ) shift ;;
+    esac
 done
 
-${SKIP_TERMINAL:=false}
+if [ "$SKIP_TERMINAL" == "true" ]; then
+    USE_CURRENT_SHELL=true
+fi
 
 
 ##########
@@ -28,21 +49,13 @@ ${SKIP_TERMINAL:=false}
 # Besides letting the player see errors/warnings/alerts in the console, this is also needed because
 # Steam messes with the PATH.
 if [ "$(uname)" == "Darwin" ]; then
-    if [ ! -t 1 ]; then # https://stackoverflow.com/q/911168/262123
-        # sanity check to make sure we don't have an infinite loop of opening windows
-        for argument in "$@"; do
-            if [ "$argument" == "--no-reopen-terminal" ]; then
-                SKIP_TERMINAL=true
-                break
-            fi
-        done
-
+    if [ ! -t 1 ]; then # not open in Terminal (https://stackoverflow.com/q/911168/262123)
         # reopen in Terminal if needed
         # https://stackoverflow.com/a/29511052/262123
-        if [ "$SKIP_TERMINAL" == "false" ]; then
+        if [ "$USE_CURRENT_SHELL" == "false" ]; then
             echo "Reopening in the Terminal app..."
             echo '#!/bin/sh' > /tmp/open-smapi-terminal.sh
-            echo "\"$0\" $@ --no-reopen-terminal" >> /tmp/open-smapi-terminal.sh
+            echo "\"$0\" $@ --use-current-shell" >> /tmp/open-smapi-terminal.sh
             chmod +x /tmp/open-smapi-terminal.sh
             cat /tmp/open-smapi-terminal.sh
             open -W -a Terminal /tmp/open-smapi-terminal.sh
@@ -78,7 +91,7 @@ else
     export LAUNCH_FILE
 
     # run in terminal
-    if [ "$SKIP_TERMINAL" == "false" ]; then
+    if [ "$USE_CURRENT_SHELL" == "false" ]; then
         # select terminal (prefer xterm for best compatibility, then known supported terminals)
         for terminal in xterm gnome-terminal kitty terminator xfce4-terminal konsole terminal termite alacritty mate-terminal x-terminal-emulator; do
             if command -v "$terminal" 2>/dev/null; then
@@ -141,7 +154,9 @@ else
         fi
 
     # explicitly run without terminal
-    else
+    elif [ "$SKIP_TERMINAL" == "true" ]; then
         exec $LAUNCH_FILE --no-terminal "$@"
+    else
+        exec $LAUNCH_FILE "$@"
     fi
 fi

From d96cec88e461806c4676c9280455da19f5c7af24 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 10 Mar 2022 23:24:01 -0500
Subject: [PATCH 460/856] fix set_farm_type not updating warps

---
 docs/release-notes.md                                            | 1 +
 .../Framework/Commands/Player/SetFarmTypeCommand.cs              | 1 +
 2 files changed, 2 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3030cc5d..2598dad5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,7 @@
 * For players:
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
   * Fixed `player_add` console command's handling of Journal Scraps and Secret Notes.
+  * Fixed `set_farm_type` console command not updating warps if they moved.
   * Improved [command-line arguments](technical/smapi.md#command-line-arguments) on Linux/macOS:
     * Added `--use-current-shell` to avoid opening a separate terminal window.
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
index 6b3b27cd..6fb399ae 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
@@ -131,6 +131,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
             Farm farm = Game1.getFarm();
             farm.mapPath.Value = $@"Maps\{Farm.getMapNameFromTypeInt(Game1.whichFarm)}";
             farm.reloadMap();
+            farm.updateWarps();
 
             // clear spouse area cache to avoid errors
             FieldInfo cacheField = farm.GetType().GetField("_baseSpouseAreaTiles", BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);

From a42926868ae5878ed59d6406ca085b587299ba07 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 20 Mar 2022 12:53:27 -0400
Subject: [PATCH 461/856] encapsulate editor/loader operations (#766)

These will be used by the new content API, and allow handling the old one the same way.
---
 .../Framework/Content/AssetEditOperation.cs   |  30 +++++
 .../Framework/Content/AssetLoadOperation.cs   |  30 +++++
 .../ContentManagers/GameContentManager.cs     | 127 ++++++++++++------
 3 files changed, 143 insertions(+), 44 deletions(-)
 create mode 100644 src/SMAPI/Framework/Content/AssetEditOperation.cs
 create mode 100644 src/SMAPI/Framework/Content/AssetLoadOperation.cs

diff --git a/src/SMAPI/Framework/Content/AssetEditOperation.cs b/src/SMAPI/Framework/Content/AssetEditOperation.cs
new file mode 100644
index 00000000..fa189d44
--- /dev/null
+++ b/src/SMAPI/Framework/Content/AssetEditOperation.cs
@@ -0,0 +1,30 @@
+using System;
+
+namespace StardewModdingAPI.Framework.Content
+{
+    /// <summary>An edit to apply to an asset when it's requested from the content pipeline.</summary>
+    internal class AssetEditOperation
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The mod applying the edit.</summary>
+        public IModMetadata Mod { get; }
+
+        /// <summary>Apply the edit to an asset.</summary>
+        public Action<IAssetData> ApplyEdit { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="mod">The mod applying the edit.</param>
+        /// <param name="applyEdit">Apply the edit to an asset.</param>
+        public AssetEditOperation(IModMetadata mod, Action<IAssetData> applyEdit)
+        {
+            this.Mod = mod;
+            this.ApplyEdit = applyEdit;
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
new file mode 100644
index 00000000..d773cadd
--- /dev/null
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -0,0 +1,30 @@
+using System;
+
+namespace StardewModdingAPI.Framework.Content
+{
+    /// <summary>An operation which provides the initial instance of an asset when it's requested from the content pipeline.</summary>
+    internal class AssetLoadOperation
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The mod applying the edit.</summary>
+        public IModMetadata Mod { get; }
+
+        /// <summary>Load the initial value for an asset.</summary>
+        public Func<IAssetInfo, object> GetData { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="mod">The mod applying the edit.</param>
+        /// <param name="getData">Load the initial value for an asset.</param>
+        public AssetLoadOperation(IModMetadata mod, Func<IAssetInfo, object> getData)
+        {
+            this.Mod = mod;
+            this.GetData = getData;
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 9b8125ad..7ed1fcda 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -24,7 +24,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         ** Fields
         *********/
         /// <summary>The assets currently being intercepted by <see cref="IAssetLoader"/> instances. This is used to prevent infinite loops when a loader loads a new asset.</summary>
-        private readonly ContextHash<string> AssetsBeingLoaded = new ContextHash<string>();
+        private readonly ContextHash<string> AssetsBeingLoaded = new();
 
         /// <summary>Interceptors which provide the initial versions of matching assets.</summary>
         private IList<ModLinked<IAssetLoader>> Loaders => this.Coordinator.Loaders;
@@ -79,12 +79,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // custom asset from a loader
             string locale = this.GetLocale();
             IAssetInfo info = new AssetInfo(locale, assetName, typeof(object), this.AssertAndNormalizeAssetName);
-            ModLinked<IAssetLoader>[] loaders = this.GetLoaders<object>(info).ToArray();
-            if (loaders.Length > 1)
-            {
-                string[] loaderNames = loaders.Select(p => p.Mod.DisplayName).ToArray();
-                this.Monitor.Log($"Multiple mods want to provide the '{info.Name}' asset ({string.Join(", ", loaderNames)}), but an asset can't be loaded multiple times. SMAPI will use the default asset instead; uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)", LogLevel.Warn);
-            }
+            AssetLoadOperation[] loaders = this.GetLoaders<object>(info).ToArray();
+
+            if (!this.AssertMaxOneLoader(info, loaders, out string error))
+                this.Monitor.Log(error, LogLevel.Warn);
 
             return loaders.Length == 1;
         }
@@ -261,7 +259,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // try base asset
                 return base.RawLoad<T>(assetName.Name, useCache);
             }
-            catch (ContentLoadException ex) when (ex.InnerException is FileNotFoundException innerEx && innerEx.InnerException == null)
+            catch (ContentLoadException ex) when (ex.InnerException is FileNotFoundException { InnerException: null })
             {
                 throw new SContentLoadException($"Error loading \"{assetName}\": it isn't in the Content folder and no mod provided it.");
             }
@@ -272,27 +270,31 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <returns>Returns the loaded asset metadata, or <c>null</c> if no loader matched.</returns>
         private IAssetData ApplyLoader<T>(IAssetInfo info)
         {
-            // find matching loaders
-            var loaders = this.GetLoaders<T>(info).ToArray();
-
-            // validate loaders
-            if (!loaders.Any())
-                return null;
-            if (loaders.Length > 1)
+            // find matching loader
+            AssetLoadOperation loader;
             {
-                string[] loaderNames = loaders.Select(p => p.Mod.DisplayName).ToArray();
-                this.Monitor.Log($"Multiple mods want to provide the '{info.Name}' asset ({string.Join(", ", loaderNames)}), but an asset can't be loaded multiple times. SMAPI will use the default asset instead; uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)", LogLevel.Warn);
-                return null;
+                AssetLoadOperation[] loaders = this.GetLoaders<T>(info).ToArray();
+
+                if (!this.AssertMaxOneLoader(info, loaders, out string error))
+                {
+                    this.Monitor.Log(error, LogLevel.Warn);
+                    return null;
+                }
+
+                loader = loaders.FirstOrDefault();
             }
 
+            // no loader found
+            if (loader == null)
+                return null;
+
             // fetch asset from loader
-            IModMetadata mod = loaders[0].Mod;
-            IAssetLoader loader = loaders[0].Data;
+            IModMetadata mod = loader.Mod;
             T data;
             try
             {
-                data = loader.Load<T>(info);
-                this.Monitor.Log($"{mod.DisplayName} loaded asset '{info.Name}'.", LogLevel.Trace);
+                data = (T)loader.GetData(info);
+                this.Monitor.Log($"{mod.DisplayName} loaded asset '{info.Name}'.");
             }
             catch (Exception ex)
             {
@@ -322,34 +324,23 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (typeof(T) != actualType && (actualOpenType == typeof(Dictionary<,>) || actualOpenType == typeof(List<>) || actualType == typeof(Texture2D) || actualType == typeof(Map)))
                 {
                     return (IAssetData)this.GetType()
-                        .GetMethod(nameof(this.ApplyEditors), BindingFlags.NonPublic | BindingFlags.Instance)
+                        .GetMethod(nameof(this.ApplyEditors), BindingFlags.NonPublic | BindingFlags.Instance)!
                         .MakeGenericMethod(actualType)
                         .Invoke(this, new object[] { info, asset });
                 }
             }
 
             // edit asset
-            foreach (var entry in this.Editors)
+            AssetEditOperation[] editors = this.GetEditors<T>(info).ToArray();
+            foreach (AssetEditOperation editor in editors)
             {
-                // check for match
-                IModMetadata mod = entry.Mod;
-                IAssetEditor editor = entry.Data;
-                try
-                {
-                    if (!editor.CanEdit<T>(info))
-                        continue;
-                }
-                catch (Exception ex)
-                {
-                    mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
-                    continue;
-                }
+                IModMetadata mod = editor.Mod;
 
                 // try edit
                 object prevAsset = asset.Data;
                 try
                 {
-                    editor.Edit<T>(asset);
+                    editor.ApplyEdit(asset);
                     this.Monitor.Log($"{mod.DisplayName} edited {info.Name}.");
                 }
                 catch (Exception ex)
@@ -374,24 +365,72 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return asset;
         }
 
-        /// <summary>Get the asset loaders which handle the asset.</summary>
+        /// <summary>Get the asset loaders which handle an asset.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
-        private IEnumerable<ModLinked<IAssetLoader>> GetLoaders<T>(IAssetInfo info)
+        private IEnumerable<AssetLoadOperation> GetLoaders<T>(IAssetInfo info)
         {
             return this.Loaders
-                .Where(entry =>
+                .Where(loader =>
                 {
                     try
                     {
-                        return entry.Data.CanLoad<T>(info);
+                        return loader.Data.CanLoad<T>(info);
                     }
                     catch (Exception ex)
                     {
-                        entry.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                        loader.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                         return false;
                     }
-                });
+                })
+                .Select(
+                    loader => new AssetLoadOperation(loader.Mod, assetInfo => loader.Data.Load<T>(assetInfo))
+                );
+        }
+
+        /// <summary>Get the asset editors to apply to an asset.</summary>
+        /// <typeparam name="T">The asset type.</typeparam>
+        /// <param name="info">The basic asset metadata.</param>
+        private IEnumerable<AssetEditOperation> GetEditors<T>(IAssetInfo info)
+        {
+            return this.Editors
+                .Where(editor =>
+                {
+                    try
+                    {
+                        return editor.Data.CanEdit<T>(info);
+                    }
+                    catch (Exception ex)
+                    {
+                        editor.Mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                        return false;
+                    }
+                })
+                .Select(
+                    editor => new AssetEditOperation(editor.Mod, assetData => editor.Data.Edit<T>(assetData))
+                );
+        }
+
+        /// <summary>Assert that at most one loader will be applied to an asset.</summary>
+        /// <param name="info">The basic asset metadata.</param>
+        /// <param name="loaders">The asset loaders to apply.</param>
+        /// <param name="error">The error message to show to the user, if the method returns false.</param>
+        /// <returns>Returns true if only one loader will apply, else false.</returns>
+        private bool AssertMaxOneLoader(IAssetInfo info, AssetLoadOperation[] loaders, out string error)
+        {
+            if (loaders.Length <= 1)
+            {
+                error = null;
+                return true;
+            }
+
+            string[] loaderNames = loaders.Select(p => p.Mod.DisplayName).ToArray();
+            string errorPhrase = loaderNames.Length > 1
+                ? $"Multiple mods want to provide '{info.Name}' asset ({string.Join(", ", loaderNames)})"
+                : $"The '{loaderNames[0]}' mod wants to provide the '{info.Name}' asset multiple times";
+
+            error = $"{errorPhrase}, but an asset can't be loaded multiple times. SMAPI will use the default asset instead; uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)";
+            return false;
         }
 
         /// <summary>Validate that an asset loaded by a mod is valid and won't cause issues, and fix issues if possible.</summary>

From d3fbdf484a4d90365a55fb5058d75a8623f17d0f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 22 Mar 2022 20:46:21 -0400
Subject: [PATCH 462/856] reduce duplicated doc blocks

---
 src/SMAPI/Framework/Events/EventManager.cs    | 105 ++++++++----------
 src/SMAPI/Framework/Events/ManagedEvent.cs    |   4 +-
 .../Framework/Events/ManagedEventHandler.cs   |   4 +-
 .../Framework/Events/ModDisplayEvents.cs      |  23 ++--
 src/SMAPI/Framework/Events/ModEvents.cs       |  16 +--
 .../Framework/Events/ModGameLoopEvents.cs     |  30 ++---
 src/SMAPI/Framework/Events/ModInputEvents.cs  |  12 +-
 .../Framework/Events/ModMultiplayerEvents.cs  |  10 +-
 src/SMAPI/Framework/Events/ModPlayerEvents.cs |   8 +-
 .../Framework/Events/ModSpecialisedEvents.cs  |   8 +-
 src/SMAPI/Framework/Events/ModWorldEvents.cs  |  20 ++--
 .../Framework/Input/GamePadStateBuilder.cs    |   7 +-
 .../Framework/Input/KeyboardStateBuilder.cs   |   7 +-
 .../Framework/Input/MouseStateBuilder.cs      |   7 +-
 src/SMAPI/Mod.cs                              |  16 +--
 15 files changed, 132 insertions(+), 145 deletions(-)

diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index dfc289ed..fa4d564d 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -1,6 +1,4 @@
-using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
-using System.Reflection;
 using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
@@ -15,166 +13,166 @@ namespace StardewModdingAPI.Framework.Events
         /****
         ** Display
         ****/
-        /// <summary>Raised after a game menu is opened, closed, or replaced.</summary>
+        /// <inheritdoc cref="IDisplayEvents.MenuChanged" />
         public readonly ManagedEvent<MenuChangedEventArgs> MenuChanged;
 
-        /// <summary>Raised before the game draws anything to the screen in a draw tick, as soon as the sprite batch is opened. The sprite batch may be closed and reopened multiple times after this event is called, but it's only raised once per draw tick. This event isn't useful for drawing to the screen, since the game will draw over it.</summary>
+        /// <inheritdoc cref="IDisplayEvents.Rendering" />
         public readonly ManagedEvent<RenderingEventArgs> Rendering;
 
-        /// <summary>Raised after the game draws to the sprite patch in a draw tick, just before the final sprite batch is rendered to the screen. Since the game may open/close the sprite batch multiple times in a draw tick, the sprite batch may not contain everything being drawn and some things may already be rendered to the screen. Content drawn to the sprite batch at this point will be drawn over all vanilla content (including menus, HUD, and cursor).</summary>
+        /// <inheritdoc cref="IDisplayEvents.Rendered" />
         public readonly ManagedEvent<RenderedEventArgs> Rendered;
 
-        /// <summary>Raised before the game world is drawn to the screen.</summary>
+        /// <inheritdoc cref="IDisplayEvents.RenderingWorld" />
         public readonly ManagedEvent<RenderingWorldEventArgs> RenderingWorld;
 
-        /// <summary>Raised after the game world is drawn to the sprite patch, before it's rendered to the screen.</summary>
+        /// <inheritdoc cref="IDisplayEvents.RenderedWorld" />
         public readonly ManagedEvent<RenderedWorldEventArgs> RenderedWorld;
 
-        /// <summary>When a menu is open (<see cref="StardewValley.Game1.activeClickableMenu"/> isn't null), raised before that menu is drawn to the screen.</summary>
+        /// <inheritdoc cref="IDisplayEvents.RenderingActiveMenu" />
         public readonly ManagedEvent<RenderingActiveMenuEventArgs> RenderingActiveMenu;
 
-        /// <summary>When a menu is open (<see cref="StardewValley.Game1.activeClickableMenu"/> isn't null), raised after that menu is drawn to the sprite batch but before it's rendered to the screen.</summary>
+        /// <inheritdoc cref="IDisplayEvents.RenderedActiveMenu" />
         public readonly ManagedEvent<RenderedActiveMenuEventArgs> RenderedActiveMenu;
 
-        /// <summary>Raised before drawing the HUD (item toolbar, clock, etc) to the screen.</summary>
+        /// <inheritdoc cref="IDisplayEvents.RenderingHud" />
         public readonly ManagedEvent<RenderingHudEventArgs> RenderingHud;
 
-        /// <summary>Raised after drawing the HUD (item toolbar, clock, etc) to the sprite batch, but before it's rendered to the screen.</summary>
+        /// <inheritdoc cref="IDisplayEvents.RenderedHud" />
         public readonly ManagedEvent<RenderedHudEventArgs> RenderedHud;
 
-        /// <summary>Raised after the game window is resized.</summary>
+        /// <inheritdoc cref="IDisplayEvents.WindowResized" />
         public readonly ManagedEvent<WindowResizedEventArgs> WindowResized;
 
         /****
         ** Game loop
         ****/
-        /// <summary>Raised after the game is launched, right before the first update tick.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.GameLaunched" />
         public readonly ManagedEvent<GameLaunchedEventArgs> GameLaunched;
 
-        /// <summary>Raised before the game performs its overall update tick (≈60 times per second).</summary>
+        /// <inheritdoc cref="IGameLoopEvents.UpdateTicking" />
         public readonly ManagedEvent<UpdateTickingEventArgs> UpdateTicking;
 
-        /// <summary>Raised after the game performs its overall update tick (≈60 times per second).</summary>
+        /// <inheritdoc cref="IGameLoopEvents.UpdateTicked" />
         public readonly ManagedEvent<UpdateTickedEventArgs> UpdateTicked;
 
-        /// <summary>Raised once per second before the game performs its overall update tick.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.OneSecondUpdateTicking" />
         public readonly ManagedEvent<OneSecondUpdateTickingEventArgs> OneSecondUpdateTicking;
 
-        /// <summary>Raised once per second after the game performs its overall update tick.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.OneSecondUpdateTicked" />
         public readonly ManagedEvent<OneSecondUpdateTickedEventArgs> OneSecondUpdateTicked;
 
-        /// <summary>Raised before the game creates the save file.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.SaveCreating" />
         public readonly ManagedEvent<SaveCreatingEventArgs> SaveCreating;
 
-        /// <summary>Raised after the game finishes creating the save file.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.SaveCreated" />
         public readonly ManagedEvent<SaveCreatedEventArgs> SaveCreated;
 
-        /// <summary>Raised before the game begins writes data to the save file (except the initial save creation).</summary>
+        /// <inheritdoc cref="IGameLoopEvents.Saving" />
         public readonly ManagedEvent<SavingEventArgs> Saving;
 
-        /// <summary>Raised after the game finishes writing data to the save file (except the initial save creation).</summary>
+        /// <inheritdoc cref="IGameLoopEvents.Saved" />
         public readonly ManagedEvent<SavedEventArgs> Saved;
 
-        /// <summary>Raised after the player loads a save slot and the world is initialized.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.SaveLoaded" />
         public readonly ManagedEvent<SaveLoadedEventArgs> SaveLoaded;
 
-        /// <summary>Raised after the game begins a new day, including when loading a save.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.DayStarted" />
         public readonly ManagedEvent<DayStartedEventArgs> DayStarted;
 
-        /// <summary>Raised before the game ends the current day. This happens before it starts setting up the next day and before <see cref="Saving"/>.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.DayEnding" />
         public readonly ManagedEvent<DayEndingEventArgs> DayEnding;
 
-        /// <summary>Raised after the in-game clock time changes.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.TimeChanged" />
         public readonly ManagedEvent<TimeChangedEventArgs> TimeChanged;
 
-        /// <summary>Raised after the game returns to the title screen.</summary>
+        /// <inheritdoc cref="IGameLoopEvents.ReturnedToTitle" />
         public readonly ManagedEvent<ReturnedToTitleEventArgs> ReturnedToTitle;
 
         /****
         ** Input
         ****/
-        /// <summary>Raised after the player presses or releases any buttons on the keyboard, controller, or mouse.</summary>
+        /// <inheritdoc cref="IInputEvents.ButtonsChanged" />
         public readonly ManagedEvent<ButtonsChangedEventArgs> ButtonsChanged;
 
-        /// <summary>Raised after the player presses a button on the keyboard, controller, or mouse.</summary>
+        /// <inheritdoc cref="IInputEvents.ButtonPressed" />
         public readonly ManagedEvent<ButtonPressedEventArgs> ButtonPressed;
 
-        /// <summary>Raised after the player released a button on the keyboard, controller, or mouse.</summary>
+        /// <inheritdoc cref="IInputEvents.ButtonReleased" />
         public readonly ManagedEvent<ButtonReleasedEventArgs> ButtonReleased;
 
-        /// <summary>Raised after the player moves the in-game cursor.</summary>
+        /// <inheritdoc cref="IInputEvents.CursorMoved" />
         public readonly ManagedEvent<CursorMovedEventArgs> CursorMoved;
 
-        /// <summary>Raised after the player scrolls the mouse wheel.</summary>
+        /// <inheritdoc cref="IInputEvents.MouseWheelScrolled" />
         public readonly ManagedEvent<MouseWheelScrolledEventArgs> MouseWheelScrolled;
 
         /****
         ** Multiplayer
         ****/
-        /// <summary>Raised after the mod context for a peer is received. This happens before the game approves the connection (<see cref="IMultiplayerEvents.PeerConnected"/>), so the player doesn't yet exist in the game. This is the earliest point where messages can be sent to the peer via SMAPI.</summary>
+        /// <inheritdoc cref="IMultiplayerEvents.PeerContextReceived" />
         public readonly ManagedEvent<PeerContextReceivedEventArgs> PeerContextReceived;
 
-        /// <summary>Raised after a peer connection is approved by the game.</summary>
+        /// <inheritdoc cref="IMultiplayerEvents.PeerConnected" />
         public readonly ManagedEvent<PeerConnectedEventArgs> PeerConnected;
 
-        /// <summary>Raised after a mod message is received over the network.</summary>
+        /// <inheritdoc cref="IMultiplayerEvents.ModMessageReceived" />
         public readonly ManagedEvent<ModMessageReceivedEventArgs> ModMessageReceived;
 
-        /// <summary>Raised after the connection with a peer is severed.</summary>
+        /// <inheritdoc cref="IMultiplayerEvents.PeerDisconnected" />
         public readonly ManagedEvent<PeerDisconnectedEventArgs> PeerDisconnected;
 
         /****
         ** Player
         ****/
-        /// <summary>Raised after items are added or removed to a player's inventory.</summary>
+        /// <inheritdoc cref="IPlayerEvents.InventoryChanged" />
         public readonly ManagedEvent<InventoryChangedEventArgs> InventoryChanged;
 
-        /// <summary>Raised after a player skill level changes. This happens as soon as they level up, not when the game notifies the player after their character goes to bed.</summary>
+        /// <inheritdoc cref="IPlayerEvents.LevelChanged" />
         public readonly ManagedEvent<LevelChangedEventArgs> LevelChanged;
 
-        /// <summary>Raised after a player warps to a new location.</summary>
+        /// <inheritdoc cref="IPlayerEvents.Warped" />
         public readonly ManagedEvent<WarpedEventArgs> Warped;
 
         /****
         ** World
         ****/
-        /// <summary>Raised after a game location is added or removed.</summary>
+        /// <inheritdoc cref="IWorldEvents.LocationListChanged" />
         public readonly ManagedEvent<LocationListChangedEventArgs> LocationListChanged;
 
-        /// <summary>Raised after buildings are added or removed in a location.</summary>
+        /// <inheritdoc cref="IWorldEvents.BuildingListChanged" />
         public readonly ManagedEvent<BuildingListChangedEventArgs> BuildingListChanged;
 
-        /// <summary>Raised after debris are added or removed in a location.</summary>
+        /// <inheritdoc cref="IWorldEvents.DebrisListChanged" />
         public readonly ManagedEvent<DebrisListChangedEventArgs> DebrisListChanged;
 
-        /// <summary>Raised after large terrain features (like bushes) are added or removed in a location.</summary>
+        /// <inheritdoc cref="IWorldEvents.LargeTerrainFeatureListChanged" />
         public readonly ManagedEvent<LargeTerrainFeatureListChangedEventArgs> LargeTerrainFeatureListChanged;
 
-        /// <summary>Raised after NPCs are added or removed in a location.</summary>
+        /// <inheritdoc cref="IWorldEvents.NpcListChanged" />
         public readonly ManagedEvent<NpcListChangedEventArgs> NpcListChanged;
 
-        /// <summary>Raised after objects are added or removed in a location.</summary>
+        /// <inheritdoc cref="IWorldEvents.ObjectListChanged" />
         public readonly ManagedEvent<ObjectListChangedEventArgs> ObjectListChanged;
 
-        /// <summary>Raised after items are added or removed from a chest.</summary>
+        /// <inheritdoc cref="IWorldEvents.ChestInventoryChanged" />
         public readonly ManagedEvent<ChestInventoryChangedEventArgs> ChestInventoryChanged;
 
-        /// <summary>Raised after terrain features (like floors and trees) are added or removed in a location.</summary>
+        /// <inheritdoc cref="IWorldEvents.TerrainFeatureListChanged" />
         public readonly ManagedEvent<TerrainFeatureListChangedEventArgs> TerrainFeatureListChanged;
 
-        /// <summary>Raised after furniture are added or removed in a location.</summary>
+        /// <inheritdoc cref="IWorldEvents.FurnitureListChanged" />
         public readonly ManagedEvent<FurnitureListChangedEventArgs> FurnitureListChanged;
 
         /****
         ** Specialized
         ****/
-        /// <summary>Raised when the low-level stage in the game's loading process has changed. See notes on <see cref="ISpecializedEvents.LoadStageChanged"/>.</summary>
+        /// <inheritdoc cref="ISpecializedEvents.LoadStageChanged" />
         public readonly ManagedEvent<LoadStageChangedEventArgs> LoadStageChanged;
 
-        /// <summary>Raised before the game performs its overall update tick (≈60 times per second). See notes on <see cref="ISpecializedEvents.UnvalidatedUpdateTicking"/>.</summary>
+        /// <inheritdoc cref="ISpecializedEvents.UnvalidatedUpdateTicking" />
         public readonly ManagedEvent<UnvalidatedUpdateTickingEventArgs> UnvalidatedUpdateTicking;
 
-        /// <summary>Raised after the game performs its overall update tick (≈60 times per second). See notes on <see cref="ISpecializedEvents.UnvalidatedUpdateTicked"/>.</summary>
+        /// <inheritdoc cref="ISpecializedEvents.UnvalidatedUpdateTicked" />
         public readonly ManagedEvent<UnvalidatedUpdateTickedEventArgs> UnvalidatedUpdateTicked;
 
 
@@ -247,12 +245,5 @@ namespace StardewModdingAPI.Framework.Events
             this.UnvalidatedUpdateTicking = ManageEventOf<UnvalidatedUpdateTickingEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.UnvalidatedUpdateTicking), isPerformanceCritical: true);
             this.UnvalidatedUpdateTicked = ManageEventOf<UnvalidatedUpdateTickedEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.UnvalidatedUpdateTicked), isPerformanceCritical: true);
         }
-
-        /// <summary>Get all managed events.</summary>
-        public IEnumerable<IManagedEvent> GetAllEvents()
-        {
-            foreach (FieldInfo field in this.GetType().GetFields())
-                yield return (IManagedEvent)field.GetValue(this);
-        }
     }
 }
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index f48c3aeb..a200393d 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -33,10 +33,10 @@ namespace StardewModdingAPI.Framework.Events
         /*********
         ** Accessors
         *********/
-        /// <summary>A human-readable name for the event.</summary>
+        /// <inheritdoc />
         public string EventName { get; }
 
-        /// <summary>Whether the event is typically called at least once per second.</summary>
+        /// <inheritdoc />
         public bool IsPerformanceCritical { get; }
 
 
diff --git a/src/SMAPI/Framework/Events/ManagedEventHandler.cs b/src/SMAPI/Framework/Events/ManagedEventHandler.cs
index b32a2a22..28e88be0 100644
--- a/src/SMAPI/Framework/Events/ManagedEventHandler.cs
+++ b/src/SMAPI/Framework/Events/ManagedEventHandler.cs
@@ -39,9 +39,7 @@ namespace StardewModdingAPI.Framework.Events
             this.SourceMod = sourceMod;
         }
 
-        /// <summary>Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object.</summary>
-        /// <param name="obj">An object to compare with this instance.</param>
-        /// <exception cref="T:System.ArgumentException"><paramref name="obj" /> is not the same type as this instance.</exception>
+        /// <inheritdoc />
         public int CompareTo(object obj)
         {
             if (!(obj is ManagedEventHandler<TEventArgs> other))
diff --git a/src/SMAPI/Framework/Events/ModDisplayEvents.cs b/src/SMAPI/Framework/Events/ModDisplayEvents.cs
index 54d40dee..48f55324 100644
--- a/src/SMAPI/Framework/Events/ModDisplayEvents.cs
+++ b/src/SMAPI/Framework/Events/ModDisplayEvents.cs
@@ -1,79 +1,78 @@
 using System;
 using StardewModdingAPI.Events;
-using StardewValley;
 
 namespace StardewModdingAPI.Framework.Events
 {
-    /// <summary>Events related to UI and drawing to the screen.</summary>
+    /// <inheritdoc cref="IDisplayEvents" />
     internal class ModDisplayEvents : ModEventsBase, IDisplayEvents
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>Raised after a game menu is opened, closed, or replaced.</summary>
+        /// <inheritdoc />
         public event EventHandler<MenuChangedEventArgs> MenuChanged
         {
             add => this.EventManager.MenuChanged.Add(value, this.Mod);
             remove => this.EventManager.MenuChanged.Remove(value);
         }
 
-        /// <summary>Raised before the game draws anything to the screen in a draw tick, as soon as the sprite batch is opened. The sprite batch may be closed and reopened multiple times after this event is called, but it's only raised once per draw tick. This event isn't useful for drawing to the screen, since the game will draw over it.</summary>
+        /// <inheritdoc />
         public event EventHandler<RenderingEventArgs> Rendering
         {
             add => this.EventManager.Rendering.Add(value, this.Mod);
             remove => this.EventManager.Rendering.Remove(value);
         }
 
-        /// <summary>Raised after the game draws to the sprite patch in a draw tick, just before the final sprite batch is rendered to the screen. Since the game may open/close the sprite batch multiple times in a draw tick, the sprite batch may not contain everything being drawn and some things may already be rendered to the screen. Content drawn to the sprite batch at this point will be drawn over all vanilla content (including menus, HUD, and cursor).</summary>
+        /// <inheritdoc />
         public event EventHandler<RenderedEventArgs> Rendered
         {
             add => this.EventManager.Rendered.Add(value, this.Mod);
             remove => this.EventManager.Rendered.Remove(value);
         }
 
-        /// <summary>Raised before the game world is drawn to the screen. This event isn't useful for drawing to the screen, since the game will draw over it.</summary>
+        /// <inheritdoc />
         public event EventHandler<RenderingWorldEventArgs> RenderingWorld
         {
             add => this.EventManager.RenderingWorld.Add(value, this.Mod);
             remove => this.EventManager.RenderingWorld.Remove(value);
         }
 
-        /// <summary>Raised after the game world is drawn to the sprite patch, before it's rendered to the screen. Content drawn to the sprite batch at this point will be drawn over the world, but under any active menu, HUD elements, or cursor.</summary>
+        /// <inheritdoc />
         public event EventHandler<RenderedWorldEventArgs> RenderedWorld
         {
             add => this.EventManager.RenderedWorld.Add(value, this.Mod);
             remove => this.EventManager.RenderedWorld.Remove(value);
         }
 
-        /// <summary>When a menu is open (<see cref="Game1.activeClickableMenu"/> isn't null), raised before that menu is drawn to the screen. This includes the game's internal menus like the title screen. Content drawn to the sprite batch at this point will appear under the menu.</summary>
+        /// <inheritdoc />
         public event EventHandler<RenderingActiveMenuEventArgs> RenderingActiveMenu
         {
             add => this.EventManager.RenderingActiveMenu.Add(value, this.Mod);
             remove => this.EventManager.RenderingActiveMenu.Remove(value);
         }
 
-        /// <summary>When a menu is open (<see cref="Game1.activeClickableMenu"/> isn't null), raised after that menu is drawn to the sprite batch but before it's rendered to the screen. Content drawn to the sprite batch at this point will appear over the menu and menu cursor.</summary>
+        /// <inheritdoc />
         public event EventHandler<RenderedActiveMenuEventArgs> RenderedActiveMenu
         {
             add => this.EventManager.RenderedActiveMenu.Add(value, this.Mod);
             remove => this.EventManager.RenderedActiveMenu.Remove(value);
         }
 
-        /// <summary>Raised before drawing the HUD (item toolbar, clock, etc) to the screen. The vanilla HUD may be hidden at this point (e.g. because a menu is open). Content drawn to the sprite batch at this point will appear under the HUD.</summary>
+        /// <inheritdoc />
         public event EventHandler<RenderingHudEventArgs> RenderingHud
         {
             add => this.EventManager.RenderingHud.Add(value, this.Mod);
             remove => this.EventManager.RenderingHud.Remove(value);
         }
 
-        /// <summary>Raised after drawing the HUD (item toolbar, clock, etc) to the sprite batch, but before it's rendered to the screen. The vanilla HUD may be hidden at this point (e.g. because a menu is open). Content drawn to the sprite batch at this point will appear over the HUD.</summary>
+        /// <inheritdoc />
         public event EventHandler<RenderedHudEventArgs> RenderedHud
         {
             add => this.EventManager.RenderedHud.Add(value, this.Mod);
             remove => this.EventManager.RenderedHud.Remove(value);
         }
 
-        /// <summary>Raised after the game window is resized.</summary>
+        /// <inheritdoc />
         public event EventHandler<WindowResizedEventArgs> WindowResized
         {
             add => this.EventManager.WindowResized.Add(value, this.Mod);
diff --git a/src/SMAPI/Framework/Events/ModEvents.cs b/src/SMAPI/Framework/Events/ModEvents.cs
index 1d1c92c6..0c365d42 100644
--- a/src/SMAPI/Framework/Events/ModEvents.cs
+++ b/src/SMAPI/Framework/Events/ModEvents.cs
@@ -2,31 +2,31 @@ using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
 {
-    /// <summary>Manages access to events raised by SMAPI.</summary>
+    /// <inheritdoc />
     internal class ModEvents : IModEvents
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>Events related to UI and drawing to the screen.</summary>
+        /// <inheritdoc />
         public IDisplayEvents Display { get; }
 
-        /// <summary>Events linked to the game's update loop. The update loop runs roughly ≈60 times/second to run game logic like state changes, action handling, etc. These can be useful, but you should consider more semantic events like <see cref="IModEvents.Input"/> if possible.</summary>
+        /// <inheritdoc />
         public IGameLoopEvents GameLoop { get; }
 
-        /// <summary>Events raised when the player provides input using a controller, keyboard, or mouse.</summary>
+        /// <inheritdoc />
         public IInputEvents Input { get; }
 
-        /// <summary>Events raised for multiplayer messages and connections.</summary>
+        /// <inheritdoc />
         public IMultiplayerEvents Multiplayer { get; }
 
-        /// <summary>Events raised when the player data changes.</summary>
+        /// <inheritdoc />
         public IPlayerEvents Player { get; }
 
-        /// <summary>Events raised when something changes in the world.</summary>
+        /// <inheritdoc />
         public IWorldEvents World { get; }
 
-        /// <summary>Events serving specialized edge cases that shouldn't be used by most mods.</summary>
+        /// <inheritdoc />
         public ISpecializedEvents Specialized { get; }
 
 
diff --git a/src/SMAPI/Framework/Events/ModGameLoopEvents.cs b/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
index 1150d641..5f0db369 100644
--- a/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
+++ b/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
@@ -3,104 +3,104 @@ using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
 {
-    /// <summary>Events linked to the game's update loop. The update loop runs roughly ≈60 times/second to run game logic like state changes, action handling, etc. These can be useful, but you should consider more semantic events like <see cref="IInputEvents"/> if possible.</summary>
+    /// <inheritdoc cref="IGameLoopEvents" />
     internal class ModGameLoopEvents : ModEventsBase, IGameLoopEvents
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>Raised after the game is launched, right before the first update tick.</summary>
+        /// <inheritdoc />
         public event EventHandler<GameLaunchedEventArgs> GameLaunched
         {
             add => this.EventManager.GameLaunched.Add(value, this.Mod);
             remove => this.EventManager.GameLaunched.Remove(value);
         }
 
-        /// <summary>Raised before the game performs its overall update tick (≈60 times per second).</summary>
+        /// <inheritdoc />
         public event EventHandler<UpdateTickingEventArgs> UpdateTicking
         {
             add => this.EventManager.UpdateTicking.Add(value, this.Mod);
             remove => this.EventManager.UpdateTicking.Remove(value);
         }
 
-        /// <summary>Raised after the game performs its overall update tick (≈60 times per second).</summary>
+        /// <inheritdoc />
         public event EventHandler<UpdateTickedEventArgs> UpdateTicked
         {
             add => this.EventManager.UpdateTicked.Add(value, this.Mod);
             remove => this.EventManager.UpdateTicked.Remove(value);
         }
 
-        /// <summary>Raised once per second before the game state is updated.</summary>
+        /// <inheritdoc />
         public event EventHandler<OneSecondUpdateTickingEventArgs> OneSecondUpdateTicking
         {
             add => this.EventManager.OneSecondUpdateTicking.Add(value, this.Mod);
             remove => this.EventManager.OneSecondUpdateTicking.Remove(value);
         }
 
-        /// <summary>Raised once per second after the game state is updated.</summary>
+        /// <inheritdoc />
         public event EventHandler<OneSecondUpdateTickedEventArgs> OneSecondUpdateTicked
         {
             add => this.EventManager.OneSecondUpdateTicked.Add(value, this.Mod);
             remove => this.EventManager.OneSecondUpdateTicked.Remove(value);
         }
 
-        /// <summary>Raised before the game creates a new save file.</summary>
+        /// <inheritdoc />
         public event EventHandler<SaveCreatingEventArgs> SaveCreating
         {
             add => this.EventManager.SaveCreating.Add(value, this.Mod);
             remove => this.EventManager.SaveCreating.Remove(value);
         }
 
-        /// <summary>Raised after the game finishes creating the save file.</summary>
+        /// <inheritdoc />
         public event EventHandler<SaveCreatedEventArgs> SaveCreated
         {
             add => this.EventManager.SaveCreated.Add(value, this.Mod);
             remove => this.EventManager.SaveCreated.Remove(value);
         }
 
-        /// <summary>Raised before the game begins writes data to the save file.</summary>
+        /// <inheritdoc />
         public event EventHandler<SavingEventArgs> Saving
         {
             add => this.EventManager.Saving.Add(value, this.Mod);
             remove => this.EventManager.Saving.Remove(value);
         }
 
-        /// <summary>Raised after the game finishes writing data to the save file.</summary>
+        /// <inheritdoc />
         public event EventHandler<SavedEventArgs> Saved
         {
             add => this.EventManager.Saved.Add(value, this.Mod);
             remove => this.EventManager.Saved.Remove(value);
         }
 
-        /// <summary>Raised after the player loads a save slot and the world is initialized.</summary>
+        /// <inheritdoc />
         public event EventHandler<SaveLoadedEventArgs> SaveLoaded
         {
             add => this.EventManager.SaveLoaded.Add(value, this.Mod);
             remove => this.EventManager.SaveLoaded.Remove(value);
         }
 
-        /// <summary>Raised after the game begins a new day (including when the player loads a save).</summary>
+        /// <inheritdoc />
         public event EventHandler<DayStartedEventArgs> DayStarted
         {
             add => this.EventManager.DayStarted.Add(value, this.Mod);
             remove => this.EventManager.DayStarted.Remove(value);
         }
 
-        /// <summary>Raised before the game ends the current day. This happens before it starts setting up the next day and before <see cref="IGameLoopEvents.Saving"/>.</summary>
+        /// <inheritdoc />
         public event EventHandler<DayEndingEventArgs> DayEnding
         {
             add => this.EventManager.DayEnding.Add(value, this.Mod);
             remove => this.EventManager.DayEnding.Remove(value);
         }
 
-        /// <summary>Raised after the in-game clock time changes.</summary>
+        /// <inheritdoc />
         public event EventHandler<TimeChangedEventArgs> TimeChanged
         {
             add => this.EventManager.TimeChanged.Add(value, this.Mod);
             remove => this.EventManager.TimeChanged.Remove(value);
         }
 
-        /// <summary>Raised after the game returns to the title screen.</summary>
+        /// <inheritdoc />
         public event EventHandler<ReturnedToTitleEventArgs> ReturnedToTitle
         {
             add => this.EventManager.ReturnedToTitle.Add(value, this.Mod);
diff --git a/src/SMAPI/Framework/Events/ModInputEvents.cs b/src/SMAPI/Framework/Events/ModInputEvents.cs
index 6f423e5d..40edf806 100644
--- a/src/SMAPI/Framework/Events/ModInputEvents.cs
+++ b/src/SMAPI/Framework/Events/ModInputEvents.cs
@@ -3,41 +3,41 @@ using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
 {
-    /// <summary>Events raised when the player provides input using a controller, keyboard, or mouse.</summary>
+    /// <inheritdoc cref="IInputEvents" />
     internal class ModInputEvents : ModEventsBase, IInputEvents
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>Raised after the player presses or releases any buttons on the keyboard, controller, or mouse.</summary>
+        /// <inheritdoc />
         public event EventHandler<ButtonsChangedEventArgs> ButtonsChanged
         {
             add => this.EventManager.ButtonsChanged.Add(value, this.Mod);
             remove => this.EventManager.ButtonsChanged.Remove(value);
         }
 
-        /// <summary>Raised after the player presses a button on the keyboard, controller, or mouse.</summary>
+        /// <inheritdoc />
         public event EventHandler<ButtonPressedEventArgs> ButtonPressed
         {
             add => this.EventManager.ButtonPressed.Add(value, this.Mod);
             remove => this.EventManager.ButtonPressed.Remove(value);
         }
 
-        /// <summary>Raised after the player releases a button on the keyboard, controller, or mouse.</summary>
+        /// <inheritdoc />
         public event EventHandler<ButtonReleasedEventArgs> ButtonReleased
         {
             add => this.EventManager.ButtonReleased.Add(value, this.Mod);
             remove => this.EventManager.ButtonReleased.Remove(value);
         }
 
-        /// <summary>Raised after the player moves the in-game cursor.</summary>
+        /// <inheritdoc />
         public event EventHandler<CursorMovedEventArgs> CursorMoved
         {
             add => this.EventManager.CursorMoved.Add(value, this.Mod);
             remove => this.EventManager.CursorMoved.Remove(value);
         }
 
-        /// <summary>Raised after the player scrolls the mouse wheel.</summary>
+        /// <inheritdoc />
         public event EventHandler<MouseWheelScrolledEventArgs> MouseWheelScrolled
         {
             add => this.EventManager.MouseWheelScrolled.Add(value, this.Mod);
diff --git a/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs b/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
index 2f9b9482..b90f64fa 100644
--- a/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
+++ b/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
@@ -3,34 +3,34 @@ using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
 {
-    /// <summary>Events raised for multiplayer messages and connections.</summary>
+    /// <inheritdoc cref="IMultiplayerEvents" />
     internal class ModMultiplayerEvents : ModEventsBase, IMultiplayerEvents
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>Raised after the mod context for a peer is received. This happens before the game approves the connection (<see cref="IMultiplayerEvents.PeerConnected"/>), so the player doesn't yet exist in the game. This is the earliest point where messages can be sent to the peer via SMAPI.</summary>
+        /// <inheritdoc />
         public event EventHandler<PeerContextReceivedEventArgs> PeerContextReceived
         {
             add => this.EventManager.PeerContextReceived.Add(value, this.Mod);
             remove => this.EventManager.PeerContextReceived.Remove(value);
         }
 
-        /// <summary>Raised after a peer connection is approved by the game.</summary>
+        /// <inheritdoc />
         public event EventHandler<PeerConnectedEventArgs> PeerConnected
         {
             add => this.EventManager.PeerConnected.Add(value, this.Mod);
             remove => this.EventManager.PeerConnected.Remove(value);
         }
 
-        /// <summary>Raised after a mod message is received over the network.</summary>
+        /// <inheritdoc />
         public event EventHandler<ModMessageReceivedEventArgs> ModMessageReceived
         {
             add => this.EventManager.ModMessageReceived.Add(value, this.Mod);
             remove => this.EventManager.ModMessageReceived.Remove(value);
         }
 
-        /// <summary>Raised after the connection with a peer is severed.</summary>
+        /// <inheritdoc />
         public event EventHandler<PeerDisconnectedEventArgs> PeerDisconnected
         {
             add => this.EventManager.PeerDisconnected.Add(value, this.Mod);
diff --git a/src/SMAPI/Framework/Events/ModPlayerEvents.cs b/src/SMAPI/Framework/Events/ModPlayerEvents.cs
index 240beb8d..b2d89e9a 100644
--- a/src/SMAPI/Framework/Events/ModPlayerEvents.cs
+++ b/src/SMAPI/Framework/Events/ModPlayerEvents.cs
@@ -3,27 +3,27 @@ using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
 {
-    /// <summary>Events raised when the player data changes.</summary>
+    /// <inheritdoc cref="IPlayerEvents" />
     internal class ModPlayerEvents : ModEventsBase, IPlayerEvents
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>Raised after items are added or removed to a player's inventory. NOTE: this event is currently only raised for the local player.</summary>
+        /// <inheritdoc />
         public event EventHandler<InventoryChangedEventArgs> InventoryChanged
         {
             add => this.EventManager.InventoryChanged.Add(value, this.Mod);
             remove => this.EventManager.InventoryChanged.Remove(value);
         }
 
-        /// <summary>Raised after a player skill level changes. This happens as soon as they level up, not when the game notifies the player after their character goes to bed.  NOTE: this event is currently only raised for the local player.</summary>
+        /// <inheritdoc />
         public event EventHandler<LevelChangedEventArgs> LevelChanged
         {
             add => this.EventManager.LevelChanged.Add(value, this.Mod);
             remove => this.EventManager.LevelChanged.Remove(value);
         }
 
-        /// <summary>Raised after a player warps to a new location. NOTE: this event is currently only raised for the local player.</summary>
+        /// <inheritdoc />
         public event EventHandler<WarpedEventArgs> Warped
         {
             add => this.EventManager.Warped.Add(value, this.Mod);
diff --git a/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs b/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
index 1d6788e1..7980208b 100644
--- a/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
+++ b/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
@@ -3,27 +3,27 @@ using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
 {
-    /// <summary>Events serving specialized edge cases that shouldn't be used by most mods.</summary>
+    /// <inheritdoc cref="ISpecializedEvents" />
     internal class ModSpecializedEvents : ModEventsBase, ISpecializedEvents
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>Raised when the low-level stage in the game's loading process has changed. This is an advanced event for mods which need to run code at specific points in the loading process. The available stages or when they happen might change without warning in future versions (e.g. due to changes in the game's load process), so mods using this event are more likely to break or have bugs. Most mods should use <see cref="IGameLoopEvents"/> instead.</summary>
+        /// <inheritdoc />
         public event EventHandler<LoadStageChangedEventArgs> LoadStageChanged
         {
             add => this.EventManager.LoadStageChanged.Add(value, this.Mod);
             remove => this.EventManager.LoadStageChanged.Remove(value);
         }
 
-        /// <summary>Raised before the game state is updated (≈60 times per second), regardless of normal SMAPI validation. This event is not thread-safe and may be invoked while game logic is running asynchronously. Changes to game state in this method may crash the game or corrupt an in-progress save. Do not use this event unless you're fully aware of the context in which your code will be run. Mods using this event will trigger a stability warning in the SMAPI console.</summary>
+        /// <inheritdoc />
         public event EventHandler<UnvalidatedUpdateTickingEventArgs> UnvalidatedUpdateTicking
         {
             add => this.EventManager.UnvalidatedUpdateTicking.Add(value, this.Mod);
             remove => this.EventManager.UnvalidatedUpdateTicking.Remove(value);
         }
 
-        /// <summary>Raised after the game state is updated (≈60 times per second), regardless of normal SMAPI validation. This event is not thread-safe and may be invoked while game logic is running asynchronously. Changes to game state in this method may crash the game or corrupt an in-progress save. Do not use this event unless you're fully aware of the context in which your code will be run. Mods using this event will trigger a stability warning in the SMAPI console.</summary>
+        /// <inheritdoc />
         public event EventHandler<UnvalidatedUpdateTickedEventArgs> UnvalidatedUpdateTicked
         {
             add => this.EventManager.UnvalidatedUpdateTicked.Add(value, this.Mod);
diff --git a/src/SMAPI/Framework/Events/ModWorldEvents.cs b/src/SMAPI/Framework/Events/ModWorldEvents.cs
index f4c40abc..a7b7d799 100644
--- a/src/SMAPI/Framework/Events/ModWorldEvents.cs
+++ b/src/SMAPI/Framework/Events/ModWorldEvents.cs
@@ -3,69 +3,69 @@ using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
 {
-    /// <summary>Events raised when something changes in the world.</summary>
+    /// <inheritdoc cref="IWorldEvents" />
     internal class ModWorldEvents : ModEventsBase, IWorldEvents
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>Raised after a game location is added or removed.</summary>
+        /// <inheritdoc />
         public event EventHandler<LocationListChangedEventArgs> LocationListChanged
         {
             add => this.EventManager.LocationListChanged.Add(value, this.Mod);
             remove => this.EventManager.LocationListChanged.Remove(value);
         }
 
-        /// <summary>Raised after buildings are added or removed in a location.</summary>
+        /// <inheritdoc />
         public event EventHandler<BuildingListChangedEventArgs> BuildingListChanged
         {
             add => this.EventManager.BuildingListChanged.Add(value, this.Mod);
             remove => this.EventManager.BuildingListChanged.Remove(value);
         }
 
-        /// <summary>Raised after debris are added or removed in a location.</summary>
+        /// <inheritdoc />
         public event EventHandler<DebrisListChangedEventArgs> DebrisListChanged
         {
             add => this.EventManager.DebrisListChanged.Add(value, this.Mod);
             remove => this.EventManager.DebrisListChanged.Remove(value);
         }
 
-        /// <summary>Raised after large terrain features (like bushes) are added or removed in a location.</summary>
+        /// <inheritdoc />
         public event EventHandler<LargeTerrainFeatureListChangedEventArgs> LargeTerrainFeatureListChanged
         {
             add => this.EventManager.LargeTerrainFeatureListChanged.Add(value, this.Mod);
             remove => this.EventManager.LargeTerrainFeatureListChanged.Remove(value);
         }
 
-        /// <summary>Raised after NPCs are added or removed in a location.</summary>
+        /// <inheritdoc />
         public event EventHandler<NpcListChangedEventArgs> NpcListChanged
         {
             add => this.EventManager.NpcListChanged.Add(value, this.Mod);
             remove => this.EventManager.NpcListChanged.Remove(value);
         }
 
-        /// <summary>Raised after objects are added or removed in a location.</summary>
+        /// <inheritdoc />
         public event EventHandler<ObjectListChangedEventArgs> ObjectListChanged
         {
             add => this.EventManager.ObjectListChanged.Add(value, this.Mod);
             remove => this.EventManager.ObjectListChanged.Remove(value);
         }
 
-        /// <summary>Raised after items are added or removed from a chest.</summary>
+        /// <inheritdoc />
         public event EventHandler<ChestInventoryChangedEventArgs> ChestInventoryChanged
         {
             add => this.EventManager.ChestInventoryChanged.Add(value, this.Mod);
             remove => this.EventManager.ChestInventoryChanged.Remove(value);
         }
 
-        /// <summary>Raised after terrain features (like floors and trees) are added or removed in a location.</summary>
+        /// <inheritdoc />
         public event EventHandler<TerrainFeatureListChangedEventArgs> TerrainFeatureListChanged
         {
             add => this.EventManager.TerrainFeatureListChanged.Add(value, this.Mod);
             remove => this.EventManager.TerrainFeatureListChanged.Remove(value);
         }
 
-        /// <summary>Raised after furniture are added or removed in a location.</summary>
+        /// <inheritdoc />
         public event EventHandler<FurnitureListChangedEventArgs> FurnitureListChanged
         {
             add => this.EventManager.FurnitureListChanged.Add(value, this.Mod);
diff --git a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
index 3a99214f..ad254828 100644
--- a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
@@ -85,8 +85,7 @@ namespace StardewModdingAPI.Framework.Input
             this.RightStickPos = sticks.Right;
         }
 
-        /// <summary>Override the states for a set of buttons.</summary>
-        /// <param name="overrides">The button state overrides.</param>
+        /// <inheritdoc />
         public GamePadStateBuilder OverrideButtons(IDictionary<SButton, SButtonState> overrides)
         {
             if (!this.IsConnected)
@@ -151,7 +150,7 @@ namespace StardewModdingAPI.Framework.Input
             return this;
         }
 
-        /// <summary>Get the currently pressed buttons.</summary>
+        /// <inheritdoc />
         public IEnumerable<SButton> GetPressedButtons()
         {
             if (!this.IsConnected)
@@ -191,7 +190,7 @@ namespace StardewModdingAPI.Framework.Input
             }
         }
 
-        /// <summary>Get the equivalent state.</summary>
+        /// <inheritdoc />
         public GamePadState GetState()
         {
             this.State ??= new GamePadState(
diff --git a/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs b/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
index 620ad442..eadb7a8a 100644
--- a/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
@@ -31,8 +31,7 @@ namespace StardewModdingAPI.Framework.Input
                 this.PressedButtons.Add(button);
         }
 
-        /// <summary>Override the states for a set of buttons.</summary>
-        /// <param name="overrides">The button state overrides.</param>
+        /// <inheritdoc />
         public KeyboardStateBuilder OverrideButtons(IDictionary<SButton, SButtonState> overrides)
         {
             foreach (var pair in overrides)
@@ -51,14 +50,14 @@ namespace StardewModdingAPI.Framework.Input
             return this;
         }
 
-        /// <summary>Get the currently pressed buttons.</summary>
+        /// <inheritdoc />
         public IEnumerable<SButton> GetPressedButtons()
         {
             foreach (Keys key in this.PressedButtons)
                 yield return key.ToSButton();
         }
 
-        /// <summary>Get the equivalent state.</summary>
+        /// <inheritdoc />
         public KeyboardState GetState()
         {
             return
diff --git a/src/SMAPI/Framework/Input/MouseStateBuilder.cs b/src/SMAPI/Framework/Input/MouseStateBuilder.cs
index a1ac5492..c2a0891b 100644
--- a/src/SMAPI/Framework/Input/MouseStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/MouseStateBuilder.cs
@@ -51,8 +51,7 @@ namespace StardewModdingAPI.Framework.Input
             this.ScrollWheelValue = state.ScrollWheelValue;
         }
 
-        /// <summary>Override the states for a set of buttons.</summary>
-        /// <param name="overrides">The button state overrides.</param>
+        /// <inheritdoc />
         public MouseStateBuilder OverrideButtons(IDictionary<SButton, SButtonState> overrides)
         {
             foreach (var pair in overrides)
@@ -67,7 +66,7 @@ namespace StardewModdingAPI.Framework.Input
             return this;
         }
 
-        /// <summary>Get the currently pressed buttons.</summary>
+        /// <inheritdoc />
         public IEnumerable<SButton> GetPressedButtons()
         {
             foreach (var pair in this.ButtonStates)
@@ -77,7 +76,7 @@ namespace StardewModdingAPI.Framework.Input
             }
         }
 
-        /// <summary>Get the equivalent state.</summary>
+        /// <inheritdoc />
         public MouseState GetState()
         {
             this.State ??= new MouseState(
diff --git a/src/SMAPI/Mod.cs b/src/SMAPI/Mod.cs
index 0e5be1c1..9af55cd4 100644
--- a/src/SMAPI/Mod.cs
+++ b/src/SMAPI/Mod.cs
@@ -8,25 +8,27 @@ namespace StardewModdingAPI
         /*********
         ** Accessors
         *********/
-        /// <summary>Provides simplified APIs for writing mods.</summary>
+        /// <inheritdoc />
         public IModHelper Helper { get; internal set; }
 
-        /// <summary>Writes messages to the console and log file.</summary>
+        /// <inheritdoc />
         public IMonitor Monitor { get; internal set; }
 
-        /// <summary>The mod's manifest.</summary>
+        /// <inheritdoc />
         public IManifest ModManifest { get; internal set; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>The mod entry point, called after the mod is first loaded.</summary>
-        /// <param name="helper">Provides simplified APIs for writing mods.</param>
+        /// <inheritdoc />
         public abstract void Entry(IModHelper helper);
 
-        /// <summary>Get an API that other mods can access. This is always called after <see cref="Entry"/>.</summary>
-        public virtual object GetApi() => null;
+        /// <inheritdoc />
+        public virtual object GetApi()
+        {
+            return null;
+        }
 
         /// <summary>Release or reset unmanaged resources.</summary>
         public void Dispose()

From b07d2340a9a6da22ee0fd95f2c6ccca3939cb7ab Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 22 Mar 2022 23:00:18 -0400
Subject: [PATCH 463/856] encapsulate & cache asset operation groups (#766)

This is needed for the upcoming Stardew Valley 1.6 to avoid duplicate checks between DoesAssetExist and Load calls, and to make sure the answer doesn't change between them.
---
 docs/release-notes.md                         |   1 +
 .../Framework/Content/AssetOperationGroup.cs  |  33 ++++++
 src/SMAPI/Framework/ContentCoordinator.cs     | 100 ++++++++++++++++--
 .../ContentManagers/GameContentManager.cs     |  44 ++------
 .../Utilities/TickCacheDictionary.cs          |  51 +++++++++
 5 files changed, 180 insertions(+), 49 deletions(-)
 create mode 100644 src/SMAPI/Framework/Content/AssetOperationGroup.cs
 create mode 100644 src/SMAPI/Framework/Utilities/TickCacheDictionary.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2598dad5..b9385e3f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,6 +16,7 @@
   * Added `Constants.ContentPath`.
   * Added `IAssetName Name` field to the info received by `IAssetEditor` and `IAssetLoader` methods.  
     _This adds methods for working with asset names, parsed locales, etc._
+  * If an asset is loaded multiple times in the same tick, `IAssetLoader.CanLoad` and `IAssetEditor.CanEdit` are now cached unless invalidated via `helper.Content.InvalidateCache`.
   * Fixed the `SDate` constructor being case-sensitive.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
diff --git a/src/SMAPI/Framework/Content/AssetOperationGroup.cs b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
new file mode 100644
index 00000000..a2fcb722
--- /dev/null
+++ b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
@@ -0,0 +1,33 @@
+namespace StardewModdingAPI.Framework.Content
+{
+    /// <summary>A set of operations to apply to an asset for a given <see cref="IAssetEditor"/> or <see cref="IAssetLoader"/> implementation.</summary>
+    internal class AssetOperationGroup
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The mod applying the changes.</summary>
+        public IModMetadata Mod { get; }
+
+        /// <summary>The load operations to apply.</summary>
+        public AssetLoadOperation[] LoadOperations { get; }
+
+        /// <summary>The edit operations to apply.</summary>
+        public AssetEditOperation[] EditOperations { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="mod">The mod applying the changes.</param>
+        /// <param name="loadOperations">The load operations to apply.</param>
+        /// <param name="editOperations">The edit operations to apply.</param>
+        public AssetOperationGroup(IModMetadata mod, AssetLoadOperation[] loadOperations, AssetEditOperation[] editOperations)
+        {
+            this.Mod = mod;
+            this.LoadOperations = loadOperations;
+            this.EditOperations = editOperations;
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index fbbbe2d2..bf944e23 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -10,6 +10,8 @@ using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Framework.Utilities;
+using StardewModdingAPI.Internal;
 using StardewModdingAPI.Metadata;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -68,6 +70,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>The language enum values indexed by locale code.</summary>
         private Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>> LocaleCodes;
 
+        /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
+        private readonly TickCacheDictionary<IAssetName, AssetOperationGroup[]> AssetOperationsByKey = new();
+
 
         /*********
         ** Accessors
@@ -351,17 +356,17 @@ namespace StardewModdingAPI.Framework
         public IEnumerable<IAssetName> InvalidateCache(Func<IContentManager, string, Type, bool> predicate, bool dispose = false)
         {
             // invalidate cache & track removed assets
-            IDictionary<IAssetName, Type> removedAssets = new Dictionary<IAssetName, Type>();
+            IDictionary<IAssetName, Type> invalidatedAssets = new Dictionary<IAssetName, Type>();
             this.ContentManagerLock.InReadLock(() =>
             {
                 // cached assets
                 foreach (IContentManager contentManager in this.ContentManagers)
                 {
-                    foreach (var entry in contentManager.InvalidateCache((key, type) => predicate(contentManager, key, type), dispose))
+                    foreach ((string key, object asset) in contentManager.InvalidateCache((key, type) => predicate(contentManager, key, type), dispose))
                     {
-                        AssetName assetName = this.ParseAssetName(entry.Key);
-                        if (!removedAssets.ContainsKey(assetName))
-                            removedAssets[assetName] = entry.Value.GetType();
+                        AssetName assetName = this.ParseAssetName(key);
+                        if (!invalidatedAssets.ContainsKey(assetName))
+                            invalidatedAssets[assetName] = asset.GetType();
                     }
                 }
 
@@ -376,18 +381,22 @@ namespace StardewModdingAPI.Framework
 
                         // get map path
                         AssetName mapPath = this.ParseAssetName(this.MainContentManager.AssertAndNormalizeAssetName(location.mapPath.Value));
-                        if (!removedAssets.ContainsKey(mapPath) && predicate(this.MainContentManager, mapPath.Name, typeof(Map)))
-                            removedAssets[mapPath] = typeof(Map);
+                        if (!invalidatedAssets.ContainsKey(mapPath) && predicate(this.MainContentManager, mapPath.Name, typeof(Map)))
+                            invalidatedAssets[mapPath] = typeof(Map);
                     }
                 }
             });
 
+            // clear cached editor checks
+            foreach (IAssetName name in invalidatedAssets.Keys)
+                this.AssetOperationsByKey.Remove(name);
+
             // reload core game assets
-            if (removedAssets.Any())
+            if (invalidatedAssets.Any())
             {
                 // propagate changes to the game
                 this.CoreAssets.Propagate(
-                    assets: removedAssets.ToDictionary(p => p.Key, p => p.Value),
+                    assets: invalidatedAssets.ToDictionary(p => p.Key, p => p.Value),
                     ignoreWorld: Context.IsWorldFullyUnloaded,
                     out IDictionary<IAssetName, bool> propagated,
                     out bool updatedNpcWarps
@@ -396,7 +405,7 @@ namespace StardewModdingAPI.Framework
                 // log summary
                 StringBuilder report = new();
                 {
-                    IAssetName[] invalidatedKeys = removedAssets.Keys.ToArray();
+                    IAssetName[] invalidatedKeys = invalidatedAssets.Keys.ToArray();
                     IAssetName[] propagatedKeys = propagated.Where(p => p.Value).Select(p => p.Key).ToArray();
 
                     string FormatKeyList(IEnumerable<IAssetName> keys) => string.Join(", ", keys.Select(p => p.Name).OrderBy(p => p, StringComparer.OrdinalIgnoreCase));
@@ -414,7 +423,18 @@ namespace StardewModdingAPI.Framework
             else
                 this.Monitor.Log("Invalidated 0 cache entries.");
 
-            return removedAssets.Keys;
+            return invalidatedAssets.Keys;
+        }
+
+        /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now.</summary>
+        /// <typeparam name="T">The asset type.</typeparam>
+        /// <param name="info">The asset info to load or edit.</param>
+        public IEnumerable<AssetOperationGroup> GetAssetOperations<T>(IAssetInfo info)
+        {
+            return this.AssetOperationsByKey.GetOrSet(
+                info.Name,
+                () => this.GetAssetOperationsWithoutCache<T>(info).ToArray()
+            );
         }
 
         /// <summary>Get all loaded instances of an asset name.</summary>
@@ -534,5 +554,63 @@ namespace StardewModdingAPI.Framework
 
             return map;
         }
+
+        /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now, ignoring the <see cref="AssetOperationsByKey"/> cache.</summary>
+        /// <typeparam name="T">The asset type.</typeparam>
+        /// <param name="info">The asset info to load or edit.</param>
+        private IEnumerable<AssetOperationGroup> GetAssetOperationsWithoutCache<T>(IAssetInfo info)
+        {
+            // legacy load operations
+            foreach (ModLinked<IAssetLoader> loader in this.Loaders)
+            {
+                // check if loader applies
+                try
+                {
+                    if (!loader.Data.CanLoad<T>(info))
+                        continue;
+                }
+                catch (Exception ex)
+                {
+                    loader.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    continue;
+                }
+
+                // add operation
+                yield return new AssetOperationGroup(
+                    mod: loader.Mod,
+                    loadOperations: new[]
+                    {
+                        new AssetLoadOperation(loader.Mod, assetInfo => loader.Data.Load<T>(assetInfo))
+                    },
+                    editOperations: Array.Empty<AssetEditOperation>()
+                );
+            }
+
+            // legacy edit operations
+            foreach (var editor in this.Editors)
+            {
+                // check if editor applies
+                try
+                {
+                    if (!editor.Data.CanEdit<T>(info))
+                        continue;
+                }
+                catch (Exception ex)
+                {
+                    editor.Mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    continue;
+                }
+
+                // add operation
+                yield return new AssetOperationGroup(
+                    mod: editor.Mod,
+                    loadOperations: Array.Empty<AssetLoadOperation>(),
+                    editOperations: new[]
+                    {
+                        new AssetEditOperation(editor.Mod, assetData => editor.Data.Edit<T>(assetData))
+                    }
+                );
+            }
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 7ed1fcda..642e526c 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -26,12 +26,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>The assets currently being intercepted by <see cref="IAssetLoader"/> instances. This is used to prevent infinite loops when a loader loads a new asset.</summary>
         private readonly ContextHash<string> AssetsBeingLoaded = new();
 
-        /// <summary>Interceptors which provide the initial versions of matching assets.</summary>
-        private IList<ModLinked<IAssetLoader>> Loaders => this.Coordinator.Loaders;
-
-        /// <summary>Interceptors which edit matching assets after they're loaded.</summary>
-        private IList<ModLinked<IAssetEditor>> Editors => this.Coordinator.Editors;
-
         /// <summary>Maps asset names to their localized form, like <c>LooseSprites\Billboard => LooseSprites\Billboard.fr-FR</c> (localized) or <c>Maps\AnimalShop => Maps\AnimalShop</c> (not localized).</summary>
         private IDictionary<string, string> LocalizedAssetNames => LocalizedContentManager.localizedAssetNames;
 
@@ -370,22 +364,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="info">The basic asset metadata.</param>
         private IEnumerable<AssetLoadOperation> GetLoaders<T>(IAssetInfo info)
         {
-            return this.Loaders
-                .Where(loader =>
-                {
-                    try
-                    {
-                        return loader.Data.CanLoad<T>(info);
-                    }
-                    catch (Exception ex)
-                    {
-                        loader.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
-                        return false;
-                    }
-                })
-                .Select(
-                    loader => new AssetLoadOperation(loader.Mod, assetInfo => loader.Data.Load<T>(assetInfo))
-                );
+            return this.Coordinator
+                .GetAssetOperations<T>(info)
+                .SelectMany(p => p.LoadOperations);
         }
 
         /// <summary>Get the asset editors to apply to an asset.</summary>
@@ -393,22 +374,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="info">The basic asset metadata.</param>
         private IEnumerable<AssetEditOperation> GetEditors<T>(IAssetInfo info)
         {
-            return this.Editors
-                .Where(editor =>
-                {
-                    try
-                    {
-                        return editor.Data.CanEdit<T>(info);
-                    }
-                    catch (Exception ex)
-                    {
-                        editor.Mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
-                        return false;
-                    }
-                })
-                .Select(
-                    editor => new AssetEditOperation(editor.Mod, assetData => editor.Data.Edit<T>(assetData))
-                );
+            return this.Coordinator
+                .GetAssetOperations<T>(info)
+                .SelectMany(p => p.EditOperations);
         }
 
         /// <summary>Assert that at most one loader will be applied to an asset.</summary>
diff --git a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
new file mode 100644
index 00000000..1613a480
--- /dev/null
+++ b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
@@ -0,0 +1,51 @@
+using System;
+using System.Collections.Generic;
+using StardewValley;
+
+namespace StardewModdingAPI.Framework.Utilities
+{
+    /// <summary>An in-memory dictionary cache that stores data for the duration of a game update tick.</summary>
+    /// <typeparam name="TKey">The dictionary key type.</typeparam>
+    /// <typeparam name="TValue">The dictionary value type.</typeparam>
+    internal class TickCacheDictionary<TKey, TValue>
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The last game tick for which data was cached.</summary>
+        private int LastGameTick = -1;
+
+        /// <summary>The underlying cached data.</summary>
+        private readonly Dictionary<TKey, TValue> Cache = new();
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get a value from the cache, fetching it first if it's not cached yet.</summary>
+        /// <param name="cacheKey">The unique key for the cached value.</param>
+        /// <param name="get">Get the latest data if it's not in the cache yet.</param>
+        public TValue GetOrSet(TKey cacheKey, Func<TValue> get)
+        {
+            // clear cache on new tick
+            if (Game1.ticks != this.LastGameTick)
+            {
+                this.Cache.Clear();
+                this.LastGameTick = Game1.ticks;
+            }
+
+            // fetch value
+            if (!this.Cache.TryGetValue(cacheKey, out TValue cached))
+                this.Cache[cacheKey] = cached = get();
+            return cached;
+        }
+
+        /// <summary>Remove an entry from the cache.</summary>
+        /// <param name="cacheKey">The unique key for the cached value.</param>
+        /// <returns>Returns whether the key was present in the dictionary.</returns>
+        public bool Remove(TKey cacheKey)
+        {
+            return this.Cache.Remove(cacheKey);
+        }
+    }
+}

From 584725bb8e554e314843315facca1fd15868bee4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 23 Mar 2022 01:06:11 -0400
Subject: [PATCH 464/856] add initial AssetRequested content event (#766)

---
 docs/release-notes.md                         |  1 +
 src/SMAPI/Events/AssetRequestedEventArgs.cs   | 94 +++++++++++++++++++
 src/SMAPI/Events/IContentEvents.cs            | 17 ++++
 src/SMAPI/Events/IModEvents.cs                |  3 +
 src/SMAPI/Framework/ContentCoordinator.cs     | 12 ++-
 src/SMAPI/Framework/Events/EventManager.cs    | 11 ++-
 src/SMAPI/Framework/Events/ManagedEvent.cs    | 10 +-
 .../Framework/Events/ModContentEvents.cs      | 29 ++++++
 src/SMAPI/Framework/Events/ModEvents.cs       |  4 +
 src/SMAPI/Framework/SCore.cs                  | 41 +++++++-
 src/SMAPI/IContentHelper.cs                   |  2 +-
 11 files changed, 219 insertions(+), 5 deletions(-)
 create mode 100644 src/SMAPI/Events/AssetRequestedEventArgs.cs
 create mode 100644 src/SMAPI/Events/IContentEvents.cs
 create mode 100644 src/SMAPI/Framework/Events/ModContentEvents.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b9385e3f..2d1cdf44 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,7 @@
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
 
 * For mod authors:
+  * Added [`AssetRequested` content event](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will eventually replace `IAssetEditor` and `IAssetLoader`.
   * Overhauled [mod-provided APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) (thanks to Shockah!).  
     _This adds support for many previously-unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more._
   * Added `Constants.ContentPath`.
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
new file mode 100644
index 00000000..b17250b0
--- /dev/null
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -0,0 +1,94 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework;
+using StardewModdingAPI.Framework.Content;
+using xTile;
+
+namespace StardewModdingAPI.Events
+{
+    /// <summary>Event arguments for an <see cref="IContentEvents.AssetRequested"/> event.</summary>
+    public class AssetRequestedEventArgs : EventArgs
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The mod handling the event.</summary>
+        private readonly IModMetadata Mod;
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The name of the asset being requested.</summary>
+        public IAssetName Name { get; }
+
+        /// <summary>The load operations requested by the event handler.</summary>
+        internal IList<AssetLoadOperation> LoadOperations { get; } = new List<AssetLoadOperation>();
+
+        /// <summary>The edit operations requested by the event handler.</summary>
+        internal IList<AssetEditOperation> EditOperations { get; } = new List<AssetEditOperation>();
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="mod">The mod handling the event.</param>
+        /// <param name="name">The name of the asset being requested.</param>
+        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name)
+        {
+            this.Mod = mod;
+            this.Name = name;
+        }
+
+        /// <summary>Provide the initial instance for the asset, instead of trying to load it from the game's <c>Content</c> folder.</summary>
+        /// <param name="load">Get the initial instance of an asset.</param>
+        /// <remarks>
+        /// Usage notes:
+        /// <list type="bullet">
+        ///   <item>The asset doesn't need to exist in the game's <c>Content</c> folder. If any mod loads the asset, the game will see it as an existing asset as if it was in that folder.</item>
+        ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will raise an error and ignore all of them. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
+        /// </list>
+        /// </remarks>
+        public void LoadFrom(Func<object> load)
+        {
+            this.LoadOperations.Add(
+                new AssetLoadOperation(this.Mod, _ => load())
+            );
+        }
+
+        /// <summary>Provide the initial instance for the asset from a file in your mod folder, instead of trying to load it from the game's <c>Content</c> folder.</summary>
+        /// <typeparam name="TAsset">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
+        /// <param name="relativePath">The relative path to the file in your mod folder.</param>
+        /// <remarks>
+        /// Usage notes:
+        /// <list type="bullet">
+        ///   <item>The asset doesn't need to exist in the game's <c>Content</c> folder. If any mod loads the asset, the game will see it as an existing asset as if it was in that folder.</item>
+        ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will raise an error and ignore all of them. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
+        /// </list>
+        /// </remarks>
+        public void LoadFromModFile<TAsset>(string relativePath)
+        {
+            this.LoadOperations.Add(
+                new AssetLoadOperation(this.Mod, _ => this.Mod.Mod.Helper.Content.Load<TAsset>(relativePath))
+            );
+        }
+
+        /// <summary>Edit the asset after it's loaded.</summary>
+        /// <param name="apply">Apply changes to the asset.</param>
+        /// <remarks>
+        /// Usage notes:
+        /// <list type="bullet">
+        ///   <item>Editing an asset which doesn't exist has no effect. This is applied after the asset is loaded from the game's <c>Content</c> folder, or from any mod's <see cref="LoadFrom"/> or <see cref="LoadFromModFile{TAsset}"/>.</item>
+        ///   <item>You can apply any number of edits to the asset. Each edit will be applied on top of the previous one (i.e. it'll see the merged asset from all previous edits as its input).</item>
+        /// </list>
+        /// </remarks>
+        public void Edit(Action<IAssetData> apply)
+        {
+            this.EditOperations.Add(
+                new AssetEditOperation(this.Mod, apply)
+            );
+        }
+    }
+}
diff --git a/src/SMAPI/Events/IContentEvents.cs b/src/SMAPI/Events/IContentEvents.cs
new file mode 100644
index 00000000..feaf9c0a
--- /dev/null
+++ b/src/SMAPI/Events/IContentEvents.cs
@@ -0,0 +1,17 @@
+using System;
+using StardewValley;
+
+namespace StardewModdingAPI.Events
+{
+    /// <summary>Events related to assets loaded from the content pipeline (including data, maps, and textures).</summary>
+    public interface IContentEvents
+    {
+        /// <summary>Raised when an asset is being requested from the content pipeline.</summary>
+        /// <remarks>
+        /// The asset isn't necessarily being loaded yet (e.g. the game may be checking if it exists). Mods can register the changes they want to apply using methods on the <paramref name="e"/> parameter. These will be applied when the asset is actually loaded.
+        ///
+        /// If the asset is requested multiple times in the same tick (e.g. once to check if it exists and once to load it), SMAPI might only raise the event once and reuse the cached result.
+        /// </remarks>
+        event EventHandler<AssetRequestedEventArgs> AssetRequested;
+    }
+}
diff --git a/src/SMAPI/Events/IModEvents.cs b/src/SMAPI/Events/IModEvents.cs
index 1f892b31..2603961b 100644
--- a/src/SMAPI/Events/IModEvents.cs
+++ b/src/SMAPI/Events/IModEvents.cs
@@ -3,6 +3,9 @@ namespace StardewModdingAPI.Events
     /// <summary>Manages access to events raised by SMAPI.</summary>
     public interface IModEvents
     {
+        /// <summary>Events related to assets loaded from the content pipeline (including data, maps, and textures).</summary>
+        IContentEvents Content { get; }
+
         /// <summary>Events related to UI and drawing to the screen.</summary>
         IDisplayEvents Display { get; }
 
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index bf944e23..22ae0a18 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using System.Text;
 using System.Threading;
 using Microsoft.Xna.Framework.Content;
+using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
@@ -70,6 +71,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>The language enum values indexed by locale code.</summary>
         private Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>> LocaleCodes;
 
+        /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
+        private readonly Func<IAssetInfo, IList<AssetOperationGroup>> RequestAssetOperations;
+
         /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
         private readonly TickCacheDictionary<IAssetName, AssetOperationGroup[]> AssetOperationsByKey = new();
 
@@ -105,13 +109,15 @@ namespace StardewModdingAPI.Framework
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations)
+        /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
         {
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.Reflection = reflection;
             this.JsonHelper = jsonHelper;
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
+            this.RequestAssetOperations = requestAssetOperations;
             this.FullRootDirectory = Path.Combine(Constants.GamePath, rootDirectory);
             this.ContentManagers.Add(
                 this.MainContentManager = new GameContentManager(
@@ -560,6 +566,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="info">The asset info to load or edit.</param>
         private IEnumerable<AssetOperationGroup> GetAssetOperationsWithoutCache<T>(IAssetInfo info)
         {
+            // new content API
+            foreach (AssetOperationGroup group in this.RequestAssetOperations(info))
+                yield return group;
+
             // legacy load operations
             foreach (ModLinked<IAssetLoader> loader in this.Loaders)
             {
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index fa4d564d..8142f00e 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -10,6 +10,13 @@ namespace StardewModdingAPI.Framework.Events
         /*********
         ** Events
         *********/
+        /****
+        ** Content
+        ****/
+        /// <inheritdoc cref="IContentEvents.AssetRequested" />
+        public readonly ManagedEvent<AssetRequestedEventArgs> AssetRequested;
+
+
         /****
         ** Display
         ****/
@@ -189,7 +196,9 @@ namespace StardewModdingAPI.Framework.Events
                 return new ManagedEvent<TEventArgs>($"{typeName}.{eventName}", modRegistry, isPerformanceCritical);
             }
 
-            // init events (new)
+            // init events
+            this.AssetRequested = ManageEventOf<AssetRequestedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetRequested));
+
             this.MenuChanged = ManageEventOf<MenuChangedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.MenuChanged));
             this.Rendering = ManageEventOf<RenderingEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendering), isPerformanceCritical: true);
             this.Rendered = ManageEventOf<RenderedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendered), isPerformanceCritical: true);
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index a200393d..154ef659 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -99,6 +99,14 @@ namespace StardewModdingAPI.Framework.Events
         /// <param name="args">The event arguments to pass.</param>
         /// <param name="match">A lambda which returns true if the event should be raised for the given mod.</param>
         public void Raise(TEventArgs args, Func<IModMetadata, bool> match = null)
+        {
+            this.Raise((_, invoke) => invoke(args), match);
+        }
+
+        /// <summary>Raise the event and notify all handlers.</summary>
+        /// <param name="invoke">Invoke an event handler. This receives the mod which registered the handler, and should invoke the callback with the event arguments to pass it.</param>
+        /// <param name="match">A lambda which returns true if the event should be raised for the given mod.</param>
+        public void Raise(Action<IModMetadata, Action<TEventArgs>> invoke, Func<IModMetadata, bool> match = null)
         {
             // skip if no handlers
             if (this.Handlers.Count == 0)
@@ -128,7 +136,7 @@ namespace StardewModdingAPI.Framework.Events
 
                 try
                 {
-                    handler.Handler.Invoke(null, args);
+                    invoke(handler.SourceMod, args => handler.Handler.Invoke(null, args));
                 }
                 catch (Exception ex)
                 {
diff --git a/src/SMAPI/Framework/Events/ModContentEvents.cs b/src/SMAPI/Framework/Events/ModContentEvents.cs
new file mode 100644
index 00000000..b4d4279c
--- /dev/null
+++ b/src/SMAPI/Framework/Events/ModContentEvents.cs
@@ -0,0 +1,29 @@
+using System;
+using StardewModdingAPI.Events;
+
+namespace StardewModdingAPI.Framework.Events
+{
+    /// <inheritdoc cref="IContentEvents" />
+    internal class ModContentEvents : ModEventsBase, IContentEvents
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <inheritdoc />
+        public event EventHandler<AssetRequestedEventArgs> AssetRequested
+        {
+            add => this.EventManager.AssetRequested.Add(value, this.Mod);
+            remove => this.EventManager.AssetRequested.Remove(value);
+        }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="mod">The mod which uses this instance.</param>
+        /// <param name="eventManager">The underlying event manager.</param>
+        internal ModContentEvents(IModMetadata mod, EventManager eventManager)
+            : base(mod, eventManager) { }
+    }
+}
diff --git a/src/SMAPI/Framework/Events/ModEvents.cs b/src/SMAPI/Framework/Events/ModEvents.cs
index 0c365d42..1fb3482c 100644
--- a/src/SMAPI/Framework/Events/ModEvents.cs
+++ b/src/SMAPI/Framework/Events/ModEvents.cs
@@ -8,6 +8,9 @@ namespace StardewModdingAPI.Framework.Events
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public IContentEvents Content { get; }
+
         /// <inheritdoc />
         public IDisplayEvents Display { get; }
 
@@ -38,6 +41,7 @@ namespace StardewModdingAPI.Framework.Events
         /// <param name="eventManager">The underlying event manager.</param>
         public ModEvents(IModMetadata mod, EventManager eventManager)
         {
+            this.Content = new ModContentEvents(mod, eventManager);
             this.Display = new ModDisplayEvents(mod, eventManager);
             this.GameLoop = new ModGameLoopEvents(mod, eventManager);
             this.Input = new ModInputEvents(mod, eventManager);
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 342d6415..f0340cf5 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1106,6 +1106,35 @@ namespace StardewModdingAPI.Framework
             this.EventManager.DayEnding.RaiseEmpty();
         }
 
+        /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
+        /// <param name="asset">The asset info being requested.</param>
+        private IList<AssetOperationGroup> RequestAssetOperations(IAssetInfo asset)
+        {
+            List<AssetOperationGroup> operations = new();
+
+            this.EventManager.AssetRequested.Raise(
+                invoke: (mod, invoke) =>
+                {
+                    AssetRequestedEventArgs args = new(mod, asset.Name);
+
+                    invoke(args);
+
+                    if (args.LoadOperations.Any() || args.EditOperations.Any())
+                    {
+                        operations.Add(
+                            new AssetOperationGroup(
+                                mod,
+                                args.LoadOperations.Select(p => new AssetLoadOperation(mod, assetInfo => p.GetData(assetInfo))).ToArray(),
+                                args.EditOperations.Select(p => new AssetEditOperation(mod, assetInfo => p.ApplyEdit(assetInfo))).ToArray()
+                            )
+                        );
+                    }
+                }
+            );
+
+            return operations;
+        }
+
         /// <summary>Raised immediately before the player returns to the title screen.</summary>
         private void OnReturningToTitle()
         {
@@ -1142,7 +1171,17 @@ namespace StardewModdingAPI.Framework
             // Game1._temporaryContent initializing from SGame constructor
             if (this.ContentCore == null)
             {
-                this.ContentCore = new ContentCoordinator(serviceProvider, rootDirectory, Thread.CurrentThread.CurrentUICulture, this.Monitor, this.Reflection, this.Toolkit.JsonHelper, this.InitializeBeforeFirstAssetLoaded, this.Settings.AggressiveMemoryOptimizations);
+                this.ContentCore = new ContentCoordinator(
+                    serviceProvider: serviceProvider,
+                    rootDirectory: rootDirectory,
+                    currentCulture: Thread.CurrentThread.CurrentUICulture,
+                    monitor: this.Monitor,
+                    reflection: this.Reflection,
+                    jsonHelper: this.Toolkit.JsonHelper,
+                    onLoadingFirstAsset: this.InitializeBeforeFirstAssetLoaded,
+                    aggressiveMemoryOptimizations: this.Settings.AggressiveMemoryOptimizations,
+                    requestAssetOperations: this.RequestAssetOperations
+                );
                 if (this.ContentCore.Language != this.Translator.LocaleEnum)
                     this.Translator.SetLocale(this.ContentCore.GetLocale(), this.ContentCore.Language);
 
diff --git a/src/SMAPI/IContentHelper.cs b/src/SMAPI/IContentHelper.cs
index 2936ecfb..207b4a33 100644
--- a/src/SMAPI/IContentHelper.cs
+++ b/src/SMAPI/IContentHelper.cs
@@ -31,7 +31,7 @@ namespace StardewModdingAPI
         ** Public methods
         *********/
         /// <summary>Load content from the game folder or mod folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
-        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, and dictionaries; other types may be supported by the game's content pipeline.</typeparam>
+        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="key">The asset key to fetch (if the <paramref name="source"/> is <see cref="ContentSource.GameContent"/>), or the local path to a content file relative to the mod folder.</param>
         /// <param name="source">Where to search for a matching content asset.</param>
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>

From 6a43e6dfad0f4d3a17ea20ef391fe760135f1c24 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 23 Mar 2022 01:16:42 -0400
Subject: [PATCH 465/856] fix unneeded cloning (#766)

---
 src/SMAPI/Framework/SCore.cs | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index f0340cf5..f9f84206 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1122,11 +1122,7 @@ namespace StardewModdingAPI.Framework
                     if (args.LoadOperations.Any() || args.EditOperations.Any())
                     {
                         operations.Add(
-                            new AssetOperationGroup(
-                                mod,
-                                args.LoadOperations.Select(p => new AssetLoadOperation(mod, assetInfo => p.GetData(assetInfo))).ToArray(),
-                                args.EditOperations.Select(p => new AssetEditOperation(mod, assetInfo => p.ApplyEdit(assetInfo))).ToArray()
-                            )
+                            new AssetOperationGroup(mod, args.LoadOperations.ToArray(), args.EditOperations.ToArray())
                         );
                     }
                 }

From 2b0ce2bb4d6690b7d00da0a243855db9bffffbf0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 24 Mar 2022 22:55:55 -0400
Subject: [PATCH 466/856] add AssetInvalidated content event (#766)

---
 docs/release-notes.md                         |  2 +-
 .../Events/AssetsInvalidatedEventArgs.cs      | 27 +++++++++++++++++
 src/SMAPI/Events/IContentEvents.cs            |  3 ++
 src/SMAPI/Framework/ContentCoordinator.cs     | 30 ++++++++++++-------
 src/SMAPI/Framework/Events/EventManager.cs    |  4 +++
 .../Framework/Events/ModContentEvents.cs      |  7 +++++
 src/SMAPI/Framework/SCore.cs                  |  9 ++++++
 7 files changed, 70 insertions(+), 12 deletions(-)
 create mode 100644 src/SMAPI/Events/AssetsInvalidatedEventArgs.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2d1cdf44..8bf451a5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,7 +11,7 @@
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
 
 * For mod authors:
-  * Added [`AssetRequested` content event](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will eventually replace `IAssetEditor` and `IAssetLoader`.
+  * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.
   * Overhauled [mod-provided APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) (thanks to Shockah!).  
     _This adds support for many previously-unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more._
   * Added `Constants.ContentPath`.
diff --git a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
new file mode 100644
index 00000000..0127f83a
--- /dev/null
+++ b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace StardewModdingAPI.Events
+{
+    /// <summary>Event arguments for an <see cref="IContentEvents.AssetsInvalidated"/> event.</summary>
+    public class AssetsInvalidatedEventArgs : EventArgs
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The asset names that were invalidated.</summary>
+        public IEnumerable<IAssetName> Names { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="names">The asset names that were invalidated.</param>
+        internal AssetsInvalidatedEventArgs(IEnumerable<IAssetName> names)
+        {
+            this.Names = names.ToArray();
+        }
+    }
+}
diff --git a/src/SMAPI/Events/IContentEvents.cs b/src/SMAPI/Events/IContentEvents.cs
index feaf9c0a..ede9ea23 100644
--- a/src/SMAPI/Events/IContentEvents.cs
+++ b/src/SMAPI/Events/IContentEvents.cs
@@ -13,5 +13,8 @@ namespace StardewModdingAPI.Events
         /// If the asset is requested multiple times in the same tick (e.g. once to check if it exists and once to load it), SMAPI might only raise the event once and reuse the cached result.
         /// </remarks>
         event EventHandler<AssetRequestedEventArgs> AssetRequested;
+
+        /// <summary>Raised after one or more assets were invalidated from the content cache by a mod, so they'll be reloaded next time they're requested. If the assets will be reloaded or propagated automatically, this event is raised before that happens.</summary>
+        event EventHandler<AssetsInvalidatedEventArgs> AssetsInvalidated;
     }
 }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 22ae0a18..4f696928 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -49,6 +49,12 @@ namespace StardewModdingAPI.Framework
         /// <summary>A callback to invoke the first time *any* game content manager loads an asset.</summary>
         private readonly Action OnLoadingFirstAsset;
 
+        /// <summary>A callback to invoke when any asset names have been invalidated from the cache.</summary>
+        private readonly Action<IEnumerable<IAssetName>> OnAssetsInvalidated;
+
+        /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
+        private readonly Func<IAssetInfo, IList<AssetOperationGroup>> RequestAssetOperations;
+
         /// <summary>The loaded content managers (including the <see cref="MainContentManager"/>).</summary>
         private readonly List<IContentManager> ContentManagers = new();
 
@@ -71,9 +77,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>The language enum values indexed by locale code.</summary>
         private Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>> LocaleCodes;
 
-        /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
-        private readonly Func<IAssetInfo, IList<AssetOperationGroup>> RequestAssetOperations;
-
         /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
         private readonly TickCacheDictionary<IAssetName, AssetOperationGroup[]> AssetOperationsByKey = new();
 
@@ -109,14 +112,16 @@ namespace StardewModdingAPI.Framework
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations, Action<IEnumerable<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
         {
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.Reflection = reflection;
             this.JsonHelper = jsonHelper;
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
+            this.OnAssetsInvalidated = onAssetsInvalidated;
             this.RequestAssetOperations = requestAssetOperations;
             this.FullRootDirectory = Path.Combine(Constants.GamePath, rootDirectory);
             this.ContentManagers.Add(
@@ -257,7 +262,7 @@ namespace StardewModdingAPI.Framework
             // Note that we *must* propagate changes here, otherwise when mods invalidate the cache later to reapply
             // their changes, the assets won't be found in the cache so no changes will be propagated.
             if (LocalizedContentManager.CurrentLanguageCode != LocalizedContentManager.LanguageCode.en)
-                this.InvalidateCache((contentManager, key, type) => contentManager is GameContentManager);
+                this.InvalidateCache((contentManager, _, _) => contentManager is GameContentManager);
         }
 
         /// <summary>Parse a raw asset name.</summary>
@@ -347,7 +352,7 @@ namespace StardewModdingAPI.Framework
         public IEnumerable<IAssetName> InvalidateCache(Func<IAssetInfo, bool> predicate, bool dispose = false)
         {
             string locale = this.GetLocale();
-            return this.InvalidateCache((contentManager, rawName, type) =>
+            return this.InvalidateCache((_, rawName, type) =>
             {
                 IAssetName assetName = this.ParseAssetName(rawName);
                 IAssetInfo info = new AssetInfo(locale, assetName, type, this.MainContentManager.AssertAndNormalizeAssetName);
@@ -393,13 +398,16 @@ namespace StardewModdingAPI.Framework
                 }
             });
 
-            // clear cached editor checks
-            foreach (IAssetName name in invalidatedAssets.Keys)
-                this.AssetOperationsByKey.Remove(name);
-
-            // reload core game assets
+            // handle invalidation
             if (invalidatedAssets.Any())
             {
+                // clear cached editor checks
+                foreach (IAssetName name in invalidatedAssets.Keys)
+                    this.AssetOperationsByKey.Remove(name);
+
+                // raise event
+                this.OnAssetsInvalidated(invalidatedAssets.Keys);
+
                 // propagate changes to the game
                 this.CoreAssets.Propagate(
                     assets: invalidatedAssets.ToDictionary(p => p.Key, p => p.Value),
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index 8142f00e..96582380 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -16,6 +16,9 @@ namespace StardewModdingAPI.Framework.Events
         /// <inheritdoc cref="IContentEvents.AssetRequested" />
         public readonly ManagedEvent<AssetRequestedEventArgs> AssetRequested;
 
+        /// <inheritdoc cref="IContentEvents.AssetsInvalidated" />
+        public readonly ManagedEvent<AssetsInvalidatedEventArgs> AssetsInvalidated;
+
 
         /****
         ** Display
@@ -198,6 +201,7 @@ namespace StardewModdingAPI.Framework.Events
 
             // init events
             this.AssetRequested = ManageEventOf<AssetRequestedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetRequested));
+            this.AssetsInvalidated = ManageEventOf<AssetsInvalidatedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetsInvalidated));
 
             this.MenuChanged = ManageEventOf<MenuChangedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.MenuChanged));
             this.Rendering = ManageEventOf<RenderingEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendering), isPerformanceCritical: true);
diff --git a/src/SMAPI/Framework/Events/ModContentEvents.cs b/src/SMAPI/Framework/Events/ModContentEvents.cs
index b4d4279c..4d0cfb97 100644
--- a/src/SMAPI/Framework/Events/ModContentEvents.cs
+++ b/src/SMAPI/Framework/Events/ModContentEvents.cs
@@ -16,6 +16,13 @@ namespace StardewModdingAPI.Framework.Events
             remove => this.EventManager.AssetRequested.Remove(value);
         }
 
+        /// <inheritdoc />
+        public event EventHandler<AssetsInvalidatedEventArgs> AssetsInvalidated
+        {
+            add => this.EventManager.AssetsInvalidated.Add(value, this.Mod);
+            remove => this.EventManager.AssetsInvalidated.Remove(value);
+        }
+
 
         /*********
         ** Public methods
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index f9f84206..e9bc9a2b 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1106,6 +1106,14 @@ namespace StardewModdingAPI.Framework
             this.EventManager.DayEnding.RaiseEmpty();
         }
 
+        /// <summary>A callback invoked after assets have been invalidated from the content cache.</summary>
+        /// <param name="assetNames">The invalidated asset names.</param>
+        private void OnAssetsInvalidated(IEnumerable<IAssetName> assetNames)
+        {
+            if (this.EventManager.AssetsInvalidated.HasListeners())
+                this.EventManager.AssetsInvalidated.Raise(new AssetsInvalidatedEventArgs(assetNames));
+        }
+
         /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
         /// <param name="asset">The asset info being requested.</param>
         private IList<AssetOperationGroup> RequestAssetOperations(IAssetInfo asset)
@@ -1175,6 +1183,7 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     jsonHelper: this.Toolkit.JsonHelper,
                     onLoadingFirstAsset: this.InitializeBeforeFirstAssetLoaded,
+                    onAssetsInvalidated: this.OnAssetsInvalidated,
                     aggressiveMemoryOptimizations: this.Settings.AggressiveMemoryOptimizations,
                     requestAssetOperations: this.RequestAssetOperations
                 );

From b77eab6e0a09099998aa806302694e82216e79f8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Mar 2022 00:35:31 -0400
Subject: [PATCH 467/856] add AssetReady content event (#766)

---
 src/SMAPI/Events/AssetReadyEventArgs.cs       | 25 +++++++++++++++++++
 src/SMAPI/Events/IContentEvents.cs            |  7 ++++--
 src/SMAPI/Framework/ContentCoordinator.cs     | 10 +++++++-
 .../ContentManagers/GameContentManager.cs     | 12 +++++++--
 .../GameContentManagerForAssetPropagation.cs  |  4 +--
 src/SMAPI/Framework/Events/EventManager.cs    |  6 +++--
 .../Framework/Events/ModContentEvents.cs      |  7 ++++++
 src/SMAPI/Framework/SCore.cs                  | 11 ++++++++
 8 files changed, 73 insertions(+), 9 deletions(-)
 create mode 100644 src/SMAPI/Events/AssetReadyEventArgs.cs

diff --git a/src/SMAPI/Events/AssetReadyEventArgs.cs b/src/SMAPI/Events/AssetReadyEventArgs.cs
new file mode 100644
index 00000000..946c9173
--- /dev/null
+++ b/src/SMAPI/Events/AssetReadyEventArgs.cs
@@ -0,0 +1,25 @@
+using System;
+
+namespace StardewModdingAPI.Events
+{
+    /// <summary>Event arguments for an <see cref="IContentEvents.AssetReady"/> event.</summary>
+    public class AssetReadyEventArgs : EventArgs
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The name of the asset being requested.</summary>
+        public IAssetName Name { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="name">The name of the asset being requested.</param>
+        internal AssetReadyEventArgs(IAssetName name)
+        {
+            this.Name = name;
+        }
+    }
+}
diff --git a/src/SMAPI/Events/IContentEvents.cs b/src/SMAPI/Events/IContentEvents.cs
index ede9ea23..abbaaf33 100644
--- a/src/SMAPI/Events/IContentEvents.cs
+++ b/src/SMAPI/Events/IContentEvents.cs
@@ -1,5 +1,4 @@
 using System;
-using StardewValley;
 
 namespace StardewModdingAPI.Events
 {
@@ -8,7 +7,7 @@ namespace StardewModdingAPI.Events
     {
         /// <summary>Raised when an asset is being requested from the content pipeline.</summary>
         /// <remarks>
-        /// The asset isn't necessarily being loaded yet (e.g. the game may be checking if it exists). Mods can register the changes they want to apply using methods on the <paramref name="e"/> parameter. These will be applied when the asset is actually loaded.
+        /// The asset isn't necessarily being loaded yet (e.g. the game may be checking if it exists). Mods can register the changes they want to apply using methods on the event arguments. These will be applied when the asset is actually loaded.
         ///
         /// If the asset is requested multiple times in the same tick (e.g. once to check if it exists and once to load it), SMAPI might only raise the event once and reuse the cached result.
         /// </remarks>
@@ -16,5 +15,9 @@ namespace StardewModdingAPI.Events
 
         /// <summary>Raised after one or more assets were invalidated from the content cache by a mod, so they'll be reloaded next time they're requested. If the assets will be reloaded or propagated automatically, this event is raised before that happens.</summary>
         event EventHandler<AssetsInvalidatedEventArgs> AssetsInvalidated;
+
+        /// <summary>Raised after an asset is loaded by the content pipeline, after all mod edits specified via <see cref="AssetRequested"/> have been applied.</summary>
+        /// <remarks>This event is only raised if something requested the asset from the content pipeline. Invalidating an asset from the content cache won't necessarily reload it automatically.</remarks>
+        event EventHandler<AssetReadyEventArgs> AssetReady;
     }
 }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 4f696928..4dbbae15 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -49,6 +49,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>A callback to invoke the first time *any* game content manager loads an asset.</summary>
         private readonly Action OnLoadingFirstAsset;
 
+        /// <summary>A callback to invoke when an asset is fully loaded.</summary>
+        private readonly Action<BaseContentManager, IAssetName> OnAssetLoaded;
+
         /// <summary>A callback to invoke when any asset names have been invalidated from the cache.</summary>
         private readonly Action<IEnumerable<IAssetName>> OnAssetsInvalidated;
 
@@ -111,16 +114,18 @@ namespace StardewModdingAPI.Framework
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
+        /// <param name="onAssetLoaded">A callback to invoke when an asset is fully loaded.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations, Action<IEnumerable<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations, Action<IEnumerable<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
         {
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.Reflection = reflection;
             this.JsonHelper = jsonHelper;
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
+            this.OnAssetLoaded = onAssetLoaded;
             this.OnAssetsInvalidated = onAssetsInvalidated;
             this.RequestAssetOperations = requestAssetOperations;
             this.FullRootDirectory = Path.Combine(Constants.GamePath, rootDirectory);
@@ -135,6 +140,7 @@ namespace StardewModdingAPI.Framework
                     reflection: reflection,
                     onDisposing: this.OnDisposing,
                     onLoadingFirstAsset: onLoadingFirstAsset,
+                    onAssetLoaded: onAssetLoaded,
                     aggressiveMemoryOptimizations: aggressiveMemoryOptimizations
                 )
             );
@@ -148,6 +154,7 @@ namespace StardewModdingAPI.Framework
                 reflection: reflection,
                 onDisposing: this.OnDisposing,
                 onLoadingFirstAsset: onLoadingFirstAsset,
+                onAssetLoaded: onAssetLoaded,
                 aggressiveMemoryOptimizations: aggressiveMemoryOptimizations
             );
             this.ContentManagers.Add(contentManagerForAssetPropagation);
@@ -172,6 +179,7 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     onDisposing: this.OnDisposing,
                     onLoadingFirstAsset: this.OnLoadingFirstAsset,
+                    onAssetLoaded: this.OnAssetLoaded,
                     aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations
                 );
                 this.ContentManagers.Add(manager);
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 642e526c..12ed5506 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -35,6 +35,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>A callback to invoke the first time *any* game content manager loads an asset.</summary>
         private readonly Action OnLoadingFirstAsset;
 
+        /// <summary>A callback to invoke when an asset is fully loaded.</summary>
+        private readonly Action<BaseContentManager, IAssetName> OnAssetLoaded;
+
 
         /*********
         ** Public methods
@@ -49,11 +52,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
+        /// <param name="onAssetLoaded">A callback to invoke when an asset is fully loaded.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        public GameContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations)
+        public GameContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: false, aggressiveMemoryOptimizations: aggressiveMemoryOptimizations)
         {
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
+            this.OnAssetLoaded = onAssetLoaded;
         }
 
         /// <inheritdoc />
@@ -129,8 +134,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 });
             }
 
-            // update cache & return data
+            // update cache
             this.TrackAsset(assetName, data, language, useCache);
+
+            // raise event & return data
+            this.OnAssetLoaded(this, assetName);
             return data;
         }
 
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
index 206ece30..847e2ce1 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
@@ -21,8 +21,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         ** Public methods
         *********/
         /// <inheritdoc />
-        public GameContentManagerForAssetPropagation(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, bool aggressiveMemoryOptimizations)
-            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, onLoadingFirstAsset, aggressiveMemoryOptimizations) { }
+        public GameContentManagerForAssetPropagation(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations)
+            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, onLoadingFirstAsset, onAssetLoaded, aggressiveMemoryOptimizations) { }
 
         /// <inheritdoc />
         public override T Load<T>(IAssetName assetName, LanguageCode language, bool useCache)
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index 96582380..bcfd7dd7 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -1,10 +1,8 @@
-using System.Diagnostics.CodeAnalysis;
 using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
 {
     /// <summary>Manages SMAPI events.</summary>
-    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Private fields are deliberately named to simplify organisation.")]
     internal class EventManager
     {
         /*********
@@ -19,6 +17,9 @@ namespace StardewModdingAPI.Framework.Events
         /// <inheritdoc cref="IContentEvents.AssetsInvalidated" />
         public readonly ManagedEvent<AssetsInvalidatedEventArgs> AssetsInvalidated;
 
+        /// <inheritdoc cref="IContentEvents.AssetReady" />
+        public readonly ManagedEvent<AssetReadyEventArgs> AssetReady;
+
 
         /****
         ** Display
@@ -202,6 +203,7 @@ namespace StardewModdingAPI.Framework.Events
             // init events
             this.AssetRequested = ManageEventOf<AssetRequestedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetRequested));
             this.AssetsInvalidated = ManageEventOf<AssetsInvalidatedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetsInvalidated));
+            this.AssetReady = ManageEventOf<AssetReadyEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetReady));
 
             this.MenuChanged = ManageEventOf<MenuChangedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.MenuChanged));
             this.Rendering = ManageEventOf<RenderingEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendering), isPerformanceCritical: true);
diff --git a/src/SMAPI/Framework/Events/ModContentEvents.cs b/src/SMAPI/Framework/Events/ModContentEvents.cs
index 4d0cfb97..cb242e99 100644
--- a/src/SMAPI/Framework/Events/ModContentEvents.cs
+++ b/src/SMAPI/Framework/Events/ModContentEvents.cs
@@ -23,6 +23,13 @@ namespace StardewModdingAPI.Framework.Events
             remove => this.EventManager.AssetsInvalidated.Remove(value);
         }
 
+        /// <inheritdoc />
+        public event EventHandler<AssetReadyEventArgs> AssetReady
+        {
+            add => this.EventManager.AssetReady.Add(value, this.Mod);
+            remove => this.EventManager.AssetReady.Remove(value);
+        }
+
 
         /*********
         ** Public methods
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index e9bc9a2b..9d97ec7d 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -19,6 +19,7 @@ using Newtonsoft.Json;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Content;
+using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Events;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Input;
@@ -1106,6 +1107,15 @@ namespace StardewModdingAPI.Framework
             this.EventManager.DayEnding.RaiseEmpty();
         }
 
+        /// <summary>A callback invoked after an asset is fully loaded through a content manager.</summary>
+        /// <param name="contentManager">The content manager through which the asset was loaded.</param>
+        /// <param name="assetName">The asset name that was loaded.</param>
+        private void OnAssetLoaded(IContentManager contentManager, IAssetName assetName)
+        {
+            if (this.EventManager.AssetReady.HasListeners())
+                this.EventManager.AssetReady.Raise(new AssetReadyEventArgs(assetName));
+        }
+
         /// <summary>A callback invoked after assets have been invalidated from the content cache.</summary>
         /// <param name="assetNames">The invalidated asset names.</param>
         private void OnAssetsInvalidated(IEnumerable<IAssetName> assetNames)
@@ -1183,6 +1193,7 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     jsonHelper: this.Toolkit.JsonHelper,
                     onLoadingFirstAsset: this.InitializeBeforeFirstAssetLoaded,
+                    onAssetLoaded: this.OnAssetLoaded,
                     onAssetsInvalidated: this.OnAssetsInvalidated,
                     aggressiveMemoryOptimizations: this.Settings.AggressiveMemoryOptimizations,
                     requestAssetOperations: this.RequestAssetOperations

From e88666f5b2aa0bc8c222712835f081a243341a8f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Mar 2022 01:01:57 -0400
Subject: [PATCH 468/856] mark build scripts executable

---
 build/unix/prepare-install-package.sh | 0
 build/unix/set-smapi-version.sh       | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 mode change 100644 => 100755 build/unix/prepare-install-package.sh
 mode change 100644 => 100755 build/unix/set-smapi-version.sh

diff --git a/build/unix/prepare-install-package.sh b/build/unix/prepare-install-package.sh
old mode 100644
new mode 100755
diff --git a/build/unix/set-smapi-version.sh b/build/unix/set-smapi-version.sh
old mode 100644
new mode 100755

From b0011bf65c6ea7ba8d66a219501ac181cbd64c90 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Mar 2022 01:02:26 -0400
Subject: [PATCH 469/856] use immutable set for invalidated asset names (#766)

---
 src/SMAPI/Events/AssetsInvalidatedEventArgs.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
index 0127f83a..f3d83dd6 100644
--- a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
+++ b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Collections.Immutable;
 using System.Linq;
 
 namespace StardewModdingAPI.Events
@@ -11,7 +12,7 @@ namespace StardewModdingAPI.Events
         ** Accessors
         *********/
         /// <summary>The asset names that were invalidated.</summary>
-        public IEnumerable<IAssetName> Names { get; }
+        public IReadOnlySet<IAssetName> Names { get; }
 
 
         /*********
@@ -21,7 +22,7 @@ namespace StardewModdingAPI.Events
         /// <param name="names">The asset names that were invalidated.</param>
         internal AssetsInvalidatedEventArgs(IEnumerable<IAssetName> names)
         {
-            this.Names = names.ToArray();
+            this.Names = names.ToImmutableHashSet();
         }
     }
 }

From e1fc566e0afeb6eb92418bb039365611abd33829 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Mar 2022 21:46:37 -0400
Subject: [PATCH 470/856] add content pack labels (#766)

---
 docs/release-notes.md                         |  2 +-
 src/SMAPI/Events/AssetRequestedEventArgs.cs   | 30 +++++++++++++----
 .../Framework/Content/AssetEditOperation.cs   |  7 +++-
 .../Framework/Content/AssetLoadOperation.cs   |  9 ++++--
 src/SMAPI/Framework/ContentCoordinator.cs     | 12 +++++--
 .../ContentManagers/GameContentManager.cs     | 26 ++++++++++-----
 src/SMAPI/Framework/InternalExtensions.cs     |  9 ++++++
 src/SMAPI/Framework/SCore.cs                  | 32 ++++++++++++++++++-
 8 files changed, 106 insertions(+), 21 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8bf451a5..2a8d142f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,7 +11,7 @@
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
 
 * For mod authors:
-  * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.
+  * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0. These include new features not supported by the old API like content pack labels.
   * Overhauled [mod-provided APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) (thanks to Shockah!).  
     _This adds support for many previously-unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more._
   * Added `Constants.ContentPath`.
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index b17250b0..774ab808 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -16,6 +16,9 @@ namespace StardewModdingAPI.Events
         /// <summary>The mod handling the event.</summary>
         private readonly IModMetadata Mod;
 
+        /// <summary>Get the mod metadata for a content pack, if it's a valid content pack for the mod.</summary>
+        private readonly Func<IModMetadata, string, string, IModMetadata> GetOnBehalfOf;
+
 
         /*********
         ** Accessors
@@ -36,14 +39,17 @@ namespace StardewModdingAPI.Events
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod handling the event.</param>
         /// <param name="name">The name of the asset being requested.</param>
-        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name)
+        /// <param name="getOnBehalfOf">Get the mod metadata for a content pack, if it's a valid content pack for the mod.</param>
+        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name, Func<IModMetadata, string, string, IModMetadata> getOnBehalfOf)
         {
             this.Mod = mod;
             this.Name = name;
+            this.GetOnBehalfOf = getOnBehalfOf;
         }
 
         /// <summary>Provide the initial instance for the asset, instead of trying to load it from the game's <c>Content</c> folder.</summary>
         /// <param name="load">Get the initial instance of an asset.</param>
+        /// <param name="onBehalfOf">The content pack ID on whose behalf you're applying the change. This is only valid for content packs for your mod.</param>
         /// <remarks>
         /// Usage notes:
         /// <list type="bullet">
@@ -51,10 +57,14 @@ namespace StardewModdingAPI.Events
         ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will raise an error and ignore all of them. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
         /// </list>
         /// </remarks>
-        public void LoadFrom(Func<object> load)
+        public void LoadFrom(Func<object> load, string onBehalfOf = null)
         {
             this.LoadOperations.Add(
-                new AssetLoadOperation(this.Mod, _ => load())
+                new AssetLoadOperation(
+                    mod: this.Mod,
+                    onBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "load assets"),
+                    getData: _ => load()
+                )
             );
         }
 
@@ -71,12 +81,16 @@ namespace StardewModdingAPI.Events
         public void LoadFromModFile<TAsset>(string relativePath)
         {
             this.LoadOperations.Add(
-                new AssetLoadOperation(this.Mod, _ => this.Mod.Mod.Helper.Content.Load<TAsset>(relativePath))
+                new AssetLoadOperation(
+                    mod: this.Mod,
+                    onBehalfOf: null,
+                    _ => this.Mod.Mod.Helper.Content.Load<TAsset>(relativePath))
             );
         }
 
         /// <summary>Edit the asset after it's loaded.</summary>
         /// <param name="apply">Apply changes to the asset.</param>
+        /// <param name="onBehalfOf">The content pack ID on whose behalf you're applying the change. This is only valid for content packs for your mod.</param>
         /// <remarks>
         /// Usage notes:
         /// <list type="bullet">
@@ -84,10 +98,14 @@ namespace StardewModdingAPI.Events
         ///   <item>You can apply any number of edits to the asset. Each edit will be applied on top of the previous one (i.e. it'll see the merged asset from all previous edits as its input).</item>
         /// </list>
         /// </remarks>
-        public void Edit(Action<IAssetData> apply)
+        public void Edit(Action<IAssetData> apply, string onBehalfOf = null)
         {
             this.EditOperations.Add(
-                new AssetEditOperation(this.Mod, apply)
+                new AssetEditOperation(
+                    mod: this.Mod,
+                    onBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "edit assets"),
+                    apply
+                )
             );
         }
     }
diff --git a/src/SMAPI/Framework/Content/AssetEditOperation.cs b/src/SMAPI/Framework/Content/AssetEditOperation.cs
index fa189d44..14db231c 100644
--- a/src/SMAPI/Framework/Content/AssetEditOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetEditOperation.cs
@@ -11,6 +11,9 @@ namespace StardewModdingAPI.Framework.Content
         /// <summary>The mod applying the edit.</summary>
         public IModMetadata Mod { get; }
 
+        /// <summary>The content pack on whose behalf the edit is being applied, if any.</summary>
+        public IModMetadata OnBehalfOf { get; }
+
         /// <summary>Apply the edit to an asset.</summary>
         public Action<IAssetData> ApplyEdit { get; }
 
@@ -20,10 +23,12 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod applying the edit.</param>
+        /// <param name="onBehalfOf">The content pack on whose behalf the edit is being applied, if any.</param>
         /// <param name="applyEdit">Apply the edit to an asset.</param>
-        public AssetEditOperation(IModMetadata mod, Action<IAssetData> applyEdit)
+        public AssetEditOperation(IModMetadata mod, IModMetadata onBehalfOf, Action<IAssetData> applyEdit)
         {
             this.Mod = mod;
+            this.OnBehalfOf = onBehalfOf;
             this.ApplyEdit = applyEdit;
         }
     }
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
index d773cadd..29bf1518 100644
--- a/src/SMAPI/Framework/Content/AssetLoadOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -8,9 +8,12 @@ namespace StardewModdingAPI.Framework.Content
         /*********
         ** Accessors
         *********/
-        /// <summary>The mod applying the edit.</summary>
+        /// <summary>The mod loading the asset.</summary>
         public IModMetadata Mod { get; }
 
+        /// <summary>The content pack on whose behalf the asset is being loaded, if any.</summary>
+        public IModMetadata OnBehalfOf { get; }
+
         /// <summary>Load the initial value for an asset.</summary>
         public Func<IAssetInfo, object> GetData { get; }
 
@@ -20,10 +23,12 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod applying the edit.</param>
+        /// <param name="onBehalfOf">The content pack on whose behalf the asset is being loaded, if any.</param>
         /// <param name="getData">Load the initial value for an asset.</param>
-        public AssetLoadOperation(IModMetadata mod, Func<IAssetInfo, object> getData)
+        public AssetLoadOperation(IModMetadata mod, IModMetadata onBehalfOf, Func<IAssetInfo, object> getData)
         {
             this.Mod = mod;
+            this.OnBehalfOf = onBehalfOf;
             this.GetData = getData;
         }
     }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 4dbbae15..3b304f0d 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -606,7 +606,11 @@ namespace StardewModdingAPI.Framework
                     mod: loader.Mod,
                     loadOperations: new[]
                     {
-                        new AssetLoadOperation(loader.Mod, assetInfo => loader.Data.Load<T>(assetInfo))
+                        new AssetLoadOperation(
+                            mod: loader.Mod,
+                            onBehalfOf: null,
+                            getData: assetInfo => loader.Data.Load<T>(assetInfo)
+                        )
                     },
                     editOperations: Array.Empty<AssetEditOperation>()
                 );
@@ -633,7 +637,11 @@ namespace StardewModdingAPI.Framework
                     loadOperations: Array.Empty<AssetLoadOperation>(),
                     editOperations: new[]
                     {
-                        new AssetEditOperation(editor.Mod, assetData => editor.Data.Edit<T>(assetData))
+                        new AssetEditOperation(
+                            mod: editor.Mod,
+                            onBehalfOf: null,
+                            applyEdit: assetData => editor.Data.Edit<T>(assetData)
+                        )
                     }
                 );
             }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 12ed5506..58e36128 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -267,7 +267,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
         }
 
-        /// <summary>Load the initial asset from the registered <see cref="Loaders"/>.</summary>
+        /// <summary>Load the initial asset from the registered loaders.</summary>
         /// <param name="info">The basic asset metadata.</param>
         /// <returns>Returns the loaded asset metadata, or <c>null</c> if no loader matched.</returns>
         private IAssetData ApplyLoader<T>(IAssetInfo info)
@@ -296,11 +296,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
             try
             {
                 data = (T)loader.GetData(info);
-                this.Monitor.Log($"{mod.DisplayName} loaded asset '{info.Name}'.");
+                this.Monitor.Log($"{mod.DisplayName} loaded asset '{info.Name}'{this.GetOnBehalfOfLabel(loader.OnBehalfOf)}.");
             }
             catch (Exception ex)
             {
-                mod.LogAsMod($"Mod crashed when loading asset '{info.Name}'. SMAPI will use the default asset instead. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                mod.LogAsMod($"Mod crashed when loading asset '{info.Name}'{this.GetOnBehalfOfLabel(loader.OnBehalfOf)}. SMAPI will use the default asset instead. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 return null;
             }
 
@@ -310,7 +310,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 : null;
         }
 
-        /// <summary>Apply any <see cref="Editors"/> to a loaded asset.</summary>
+        /// <summary>Apply any editors to a loaded asset.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
         /// <param name="asset">The loaded asset.</param>
@@ -343,22 +343,22 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 try
                 {
                     editor.ApplyEdit(asset);
-                    this.Monitor.Log($"{mod.DisplayName} edited {info.Name}.");
+                    this.Monitor.Log($"{mod.DisplayName} edited {info.Name}{this.GetOnBehalfOfLabel(editor.OnBehalfOf)}.");
                 }
                 catch (Exception ex)
                 {
-                    mod.LogAsMod($"Mod crashed when editing asset '{info.Name}', which may cause errors in-game. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    mod.LogAsMod($"Mod crashed when editing asset '{info.Name}'{this.GetOnBehalfOfLabel(editor.OnBehalfOf)}, which may cause errors in-game. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 }
 
                 // validate edit
                 if (asset.Data == null)
                 {
-                    mod.LogAsMod($"Mod incorrectly set asset '{info.Name}' to a null value; ignoring override.", LogLevel.Warn);
+                    mod.LogAsMod($"Mod incorrectly set asset '{info.Name}'{this.GetOnBehalfOfLabel(editor.OnBehalfOf)} to a null value; ignoring override.", LogLevel.Warn);
                     asset = GetNewData(prevAsset);
                 }
                 else if (!(asset.Data is T))
                 {
-                    mod.LogAsMod($"Mod incorrectly set asset '{asset.Name}' to incompatible type '{asset.Data.GetType()}', expected '{typeof(T)}'; ignoring override.", LogLevel.Warn);
+                    mod.LogAsMod($"Mod incorrectly set asset '{asset.Name}'{this.GetOnBehalfOfLabel(editor.OnBehalfOf)} to incompatible type '{asset.Data.GetType()}', expected '{typeof(T)}'; ignoring override.", LogLevel.Warn);
                     asset = GetNewData(prevAsset);
                 }
             }
@@ -409,6 +409,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return false;
         }
 
+        /// <summary>Get a parenthetical label for log messages for the content pack on whose behalf the action is being performed, if any.</summary>
+        /// <param name="onBehalfOf">The content pack on whose behalf the action is being performed.</param>
+        private string GetOnBehalfOfLabel(IModMetadata onBehalfOf)
+        {
+            if (onBehalfOf == null)
+                return string.Empty;
+
+            return $" (for the '{onBehalfOf.Manifest.Name}' content pack)";
+        }
+
         /// <summary>Validate that an asset loaded by a mod is valid and won't cause issues, and fix issues if possible.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index 4cb77a45..fe10b045 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -45,6 +45,15 @@ namespace StardewModdingAPI.Framework
             metadata.Monitor.Log(message, level);
         }
 
+        /// <summary>Log a message using the mod's monitor, but only if it hasn't already been logged since the last game launch.</summary>
+        /// <param name="metadata">The mod whose monitor to use.</param>
+        /// <param name="message">The message to log.</param>
+        /// <param name="level">The log severity level.</param>
+        public static void LogAsModOnce(this IModMetadata metadata, string message, LogLevel level = LogLevel.Trace)
+        {
+            metadata.Monitor.LogOnce(message, level);
+        }
+
         /****
         ** ManagedEvent
         ****/
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 9d97ec7d..dd682e40 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1133,7 +1133,7 @@ namespace StardewModdingAPI.Framework
             this.EventManager.AssetRequested.Raise(
                 invoke: (mod, invoke) =>
                 {
-                    AssetRequestedEventArgs args = new(mod, asset.Name);
+                    AssetRequestedEventArgs args = new(mod, asset.Name, this.GetOnBehalfOfContentPack);
 
                     invoke(args);
 
@@ -1149,6 +1149,36 @@ namespace StardewModdingAPI.Framework
             return operations;
         }
 
+        /// <summary>Get the mod metadata for a content pack whose ID matches <paramref name="id"/>, if it's a valid content pack for the given <paramref name="mod"/>.</summary>
+        /// <param name="mod">The mod requesting to act on the content pack's behalf.</param>
+        /// <param name="id">The content pack ID.</param>
+        /// <param name="verb">The verb phrase indicating what action will be performed, like 'load assets' or 'edit assets'.</param>
+        /// <returns>Returns the content pack metadata if valid, else <c>null</c>.</returns>
+        private IModMetadata GetOnBehalfOfContentPack(IModMetadata mod, string id, string verb)
+        {
+            if (id == null)
+                return null;
+
+            string errorPrefix = $"Can't {verb} on behalf of content pack ID '{id}'";
+
+            // get target mod
+            IModMetadata onBehalfOf = this.ModRegistry.Get(id);
+            if (onBehalfOf == null)
+            {
+                mod.LogAsModOnce($"{errorPrefix}: there's no content pack installed with that ID.", LogLevel.Warn);
+                return null;
+            }
+
+            // make sure it's a content pack for the requesting mod
+            if (!onBehalfOf.IsContentPack || !string.Equals(onBehalfOf.Manifest?.ContentPackFor?.UniqueID, mod.Manifest.UniqueID))
+            {
+                mod.LogAsModOnce($"{errorPrefix}: that isn't a content pack for this mod.", LogLevel.Warn);
+                return null;
+            }
+
+            return onBehalfOf;
+        }
+
         /// <summary>Raised immediately before the player returns to the title screen.</summary>
         private void OnReturningToTitle()
         {

From 9025b0dcc5c537cbde37aef2482ccd942eb9769f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Mar 2022 22:16:49 -0400
Subject: [PATCH 471/856] fix asset load conflict always showing multiple-mod
 form

---
 docs/release-notes.md                                     | 1 +
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs | 5 ++++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2a8d142f..7cdd093a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
   * Improved [command-line arguments](technical/smapi.md#command-line-arguments) on Linux/macOS:
     * Added `--use-current-shell` to avoid opening a separate terminal window.
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
+  * Fixed warning text when a mod causes an asset load conflict with itself.
 
 * For mod authors:
   * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0. These include new features not supported by the old API like content pack labels.
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 58e36128..8bdb39d0 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -400,7 +400,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return true;
             }
 
-            string[] loaderNames = loaders.Select(p => p.Mod.DisplayName).ToArray();
+            string[] loaderNames = loaders
+                .Select(p => p.Mod.DisplayName)
+                .Distinct()
+                .ToArray();
             string errorPhrase = loaderNames.Length > 1
                 ? $"Multiple mods want to provide '{info.Name}' asset ({string.Join(", ", loaderNames)})"
                 : $"The '{loaderNames[0]}' mod wants to provide the '{info.Name}' asset multiple times";

From 0e0c1356041915a4668b76da9eacc986953392d2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Mar 2022 22:42:22 -0400
Subject: [PATCH 472/856] add content pack label to more logs (#766)

---
 .../ContentManagers/GameContentManager.cs     | 32 +++++++++++--------
 1 file changed, 19 insertions(+), 13 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 8bdb39d0..1d9c8b4c 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -305,7 +305,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // return matched asset
-            return this.TryFixAndValidateLoadedAsset(info, data, mod)
+            return this.TryFixAndValidateLoadedAsset(info, data, loader)
                 ? new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName)
                 : null;
         }
@@ -401,39 +401,45 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             string[] loaderNames = loaders
-                .Select(p => p.Mod.DisplayName)
+                .Select(p => p.Mod.DisplayName + this.GetOnBehalfOfLabel(p.OnBehalfOf))
                 .Distinct()
                 .ToArray();
             string errorPhrase = loaderNames.Length > 1
-                ? $"Multiple mods want to provide '{info.Name}' asset ({string.Join(", ", loaderNames)})"
+                ? $"Multiple mods want to provide '{info.Name}' asset: {string.Join(", ", loaderNames)}"
                 : $"The '{loaderNames[0]}' mod wants to provide the '{info.Name}' asset multiple times";
 
-            error = $"{errorPhrase}, but an asset can't be loaded multiple times. SMAPI will use the default asset instead; uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)";
+            error = $"{errorPhrase}. An asset can't be loaded multiple times, so SMAPI will use the default asset instead. Uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)";
             return false;
         }
 
         /// <summary>Get a parenthetical label for log messages for the content pack on whose behalf the action is being performed, if any.</summary>
         /// <param name="onBehalfOf">The content pack on whose behalf the action is being performed.</param>
-        private string GetOnBehalfOfLabel(IModMetadata onBehalfOf)
+        /// <param name="parenthetical">whether to format the label as a parenthetical shown after the mod name like <c> (for the 'X' content pack)</c>, instead of a standalone label like <c>the 'X' content pack</c>.</param>
+        /// <returns>Returns the on-behalf-of label if applicable, else <c>null</c>.</returns>
+        private string GetOnBehalfOfLabel(IModMetadata onBehalfOf, bool parenthetical = true)
         {
             if (onBehalfOf == null)
-                return string.Empty;
+                return null;
 
-            return $" (for the '{onBehalfOf.Manifest.Name}' content pack)";
+            return parenthetical
+                ? $" (for the '{onBehalfOf.Manifest.Name}' content pack)"
+                : $"the '{onBehalfOf.Manifest.Name}' content pack";
         }
 
         /// <summary>Validate that an asset loaded by a mod is valid and won't cause issues, and fix issues if possible.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
         /// <param name="data">The loaded asset data.</param>
-        /// <param name="mod">The mod which loaded the asset.</param>
+        /// <param name="loader">The loader which loaded the asset.</param>
         /// <returns>Returns whether the asset passed validation checks (after any fixes were applied).</returns>
-        private bool TryFixAndValidateLoadedAsset<T>(IAssetInfo info, T data, IModMetadata mod)
+        private bool TryFixAndValidateLoadedAsset<T>(IAssetInfo info, T data, AssetLoadOperation loader)
         {
+            IModMetadata mod = loader.Mod;
+
             // can't load a null asset
             if (data == null)
             {
-                mod.LogAsMod($"SMAPI blocked asset replacement for '{info.Name}': mod incorrectly set asset to a null value.", LogLevel.Error);
+                mod.LogAsMod($"SMAPI blocked asset replacement for '{info.Name}': {this.GetOnBehalfOfLabel(loader.OnBehalfOf, parenthetical: false) ?? "mod"} incorrectly set asset to a null value.", LogLevel.Error);
                 return false;
             }
 
@@ -459,15 +465,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         // This is temporary: mods shouldn't do this for any vanilla map, but these are the ones we know will crash. Showing a warning for others instead gives modders time to update their mods, while still simplifying troubleshooting.
                         bool isFarmMap = info.Name.IsEquivalentTo("Maps/Farm") || info.Name.IsEquivalentTo("Maps/Farm_Combat") || info.Name.IsEquivalentTo("Maps/Farm_Fishing") || info.Name.IsEquivalentTo("Maps/Farm_Foraging") || info.Name.IsEquivalentTo("Maps/Farm_FourCorners") || info.Name.IsEquivalentTo("Maps/Farm_Island") || info.Name.IsEquivalentTo("Maps/Farm_Mining");
 
-                        string reason = $"mod reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewvalleywiki.com/Modding:Maps#Tilesheet_order for help.";
+                        string reason = $"{this.GetOnBehalfOfLabel(loader.OnBehalfOf, parenthetical: false) ?? "mod"} reordered the original tilesheets, which {(isFarmMap ? "would cause a crash" : "often causes crashes")}.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewvalleywiki.com/Modding:Maps#Tilesheet_order for help.";
 
                         SCore.DeprecationManager.PlaceholderWarn("3.8.2", DeprecationLevel.PendingRemoval);
                         if (isFarmMap)
                         {
-                            mod.LogAsMod($"SMAPI blocked '{info.Name}' map load: {reason}", LogLevel.Error);
+                            mod.LogAsMod($"SMAPI blocked a '{info.Name}' map load: {reason}", LogLevel.Error);
                             return false;
                         }
-                        mod.LogAsMod($"SMAPI found an issue with '{info.Name}' map load: {reason}", LogLevel.Warn);
+                        mod.LogAsMod($"SMAPI found an issue with a '{info.Name}' map load: {reason}", LogLevel.Warn);
                     }
                 }
             }

From 021891ff0ceb6b327bc196c336aa56ddfaf99b0e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Mar 2022 22:49:14 -0400
Subject: [PATCH 473/856] add load conflict resolution option (#766)

---
 docs/release-notes.md                           |  3 ++-
 src/SMAPI/Events/AssetRequestedEventArgs.cs     | 10 +++++++---
 .../Framework/Content/AssetLoadOperation.cs     |  7 ++++++-
 src/SMAPI/Framework/ContentCoordinator.cs       |  1 +
 .../ContentManagers/GameContentManager.cs       | 17 ++++++++++-------
 5 files changed, 26 insertions(+), 12 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7cdd093a..c8c87db3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,7 +12,8 @@
   * Fixed warning text when a mod causes an asset load conflict with itself.
 
 * For mod authors:
-  * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0. These include new features not supported by the old API like content pack labels.
+  * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
+    _These include new features not supported by the old API, like load conflict resolution and content pack labels. They also support new cases like easily detecting when an asset has been changed._
   * Overhauled [mod-provided APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) (thanks to Shockah!).  
     _This adds support for many previously-unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more._
   * Added `Constants.ContentPath`.
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index 774ab808..9942079b 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -50,18 +50,20 @@ namespace StardewModdingAPI.Events
         /// <summary>Provide the initial instance for the asset, instead of trying to load it from the game's <c>Content</c> folder.</summary>
         /// <param name="load">Get the initial instance of an asset.</param>
         /// <param name="onBehalfOf">The content pack ID on whose behalf you're applying the change. This is only valid for content packs for your mod.</param>
+        /// <param name="allowSkipOnConflict">When there are multiple loads that apply to the same asset, this indicates whether this one can be skipped to resolve the conflict. If all loads allow skipping, the first one that was registered will be applied. If this is false, SMAPI will raise an error and apply none of them.</param>
         /// <remarks>
         /// Usage notes:
         /// <list type="bullet">
         ///   <item>The asset doesn't need to exist in the game's <c>Content</c> folder. If any mod loads the asset, the game will see it as an existing asset as if it was in that folder.</item>
-        ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will raise an error and ignore all of them. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
+        ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will use the <paramref name="allowSkipOnConflict"/> parameter to decide what happens. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
         /// </list>
         /// </remarks>
-        public void LoadFrom(Func<object> load, string onBehalfOf = null)
+        public void LoadFrom(Func<object> load, string onBehalfOf = null, bool allowSkipOnConflict = false)
         {
             this.LoadOperations.Add(
                 new AssetLoadOperation(
                     mod: this.Mod,
+                    allowSkipOnConflict: allowSkipOnConflict,
                     onBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "load assets"),
                     getData: _ => load()
                 )
@@ -71,6 +73,7 @@ namespace StardewModdingAPI.Events
         /// <summary>Provide the initial instance for the asset from a file in your mod folder, instead of trying to load it from the game's <c>Content</c> folder.</summary>
         /// <typeparam name="TAsset">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="relativePath">The relative path to the file in your mod folder.</param>
+        /// <param name="allowSkipOnConflict">When there are multiple loads that apply to the same asset, this indicates whether this one can be skipped to resolve the conflict. If all loads allow skipping, the first one that was registered will be applied. If this is false, SMAPI will raise an error and apply none of them.</param>
         /// <remarks>
         /// Usage notes:
         /// <list type="bullet">
@@ -78,11 +81,12 @@ namespace StardewModdingAPI.Events
         ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will raise an error and ignore all of them. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
         /// </list>
         /// </remarks>
-        public void LoadFromModFile<TAsset>(string relativePath)
+        public void LoadFromModFile<TAsset>(string relativePath, bool allowSkipOnConflict = false)
         {
             this.LoadOperations.Add(
                 new AssetLoadOperation(
                     mod: this.Mod,
+                    allowSkipOnConflict: allowSkipOnConflict,
                     onBehalfOf: null,
                     _ => this.Mod.Mod.Helper.Content.Load<TAsset>(relativePath))
             );
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
index 29bf1518..36baf1aa 100644
--- a/src/SMAPI/Framework/Content/AssetLoadOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -14,6 +14,9 @@ namespace StardewModdingAPI.Framework.Content
         /// <summary>The content pack on whose behalf the asset is being loaded, if any.</summary>
         public IModMetadata OnBehalfOf { get; }
 
+        /// <summary>Whether to allow skipping this operation to resolve a load conflict.</summary>
+        public bool AllowSkipOnConflict { get; }
+
         /// <summary>Load the initial value for an asset.</summary>
         public Func<IAssetInfo, object> GetData { get; }
 
@@ -23,11 +26,13 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod applying the edit.</param>
+        /// <param name="allowSkipOnConflict">Whether to allow skipping this operation to resolve a load conflict.</param>
         /// <param name="onBehalfOf">The content pack on whose behalf the asset is being loaded, if any.</param>
         /// <param name="getData">Load the initial value for an asset.</param>
-        public AssetLoadOperation(IModMetadata mod, IModMetadata onBehalfOf, Func<IAssetInfo, object> getData)
+        public AssetLoadOperation(IModMetadata mod, bool allowSkipOnConflict, IModMetadata onBehalfOf, Func<IAssetInfo, object> getData)
         {
             this.Mod = mod;
+            this.AllowSkipOnConflict = allowSkipOnConflict;
             this.OnBehalfOf = onBehalfOf;
             this.GetData = getData;
         }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 3b304f0d..43cebcbe 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -608,6 +608,7 @@ namespace StardewModdingAPI.Framework
                     {
                         new AssetLoadOperation(
                             mod: loader.Mod,
+                            allowSkipOnConflict: false,
                             onBehalfOf: null,
                             getData: assetInfo => loader.Data.Load<T>(assetInfo)
                         )
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 1d9c8b4c..b3e98648 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -80,7 +80,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             IAssetInfo info = new AssetInfo(locale, assetName, typeof(object), this.AssertAndNormalizeAssetName);
             AssetLoadOperation[] loaders = this.GetLoaders<object>(info).ToArray();
 
-            if (!this.AssertMaxOneLoader(info, loaders, out string error))
+            if (!this.AssertMaxOneRequiredLoader(info, loaders, out string error))
                 this.Monitor.Log(error, LogLevel.Warn);
 
             return loaders.Length == 1;
@@ -277,13 +277,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 AssetLoadOperation[] loaders = this.GetLoaders<T>(info).ToArray();
 
-                if (!this.AssertMaxOneLoader(info, loaders, out string error))
+                if (!this.AssertMaxOneRequiredLoader(info, loaders, out string error))
                 {
                     this.Monitor.Log(error, LogLevel.Warn);
                     return null;
                 }
 
-                loader = loaders.FirstOrDefault();
+                loader =
+                    loaders.FirstOrDefault(p => !p.AllowSkipOnConflict)
+                    ?? loaders.FirstOrDefault();
             }
 
             // no loader found
@@ -392,20 +394,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="loaders">The asset loaders to apply.</param>
         /// <param name="error">The error message to show to the user, if the method returns false.</param>
         /// <returns>Returns true if only one loader will apply, else false.</returns>
-        private bool AssertMaxOneLoader(IAssetInfo info, AssetLoadOperation[] loaders, out string error)
+        private bool AssertMaxOneRequiredLoader(IAssetInfo info, AssetLoadOperation[] loaders, out string error)
         {
-            if (loaders.Length <= 1)
+            AssetLoadOperation[] required = loaders.Where(p => !p.AllowSkipOnConflict).ToArray();
+            if (required.Length <= 1)
             {
                 error = null;
                 return true;
             }
 
-            string[] loaderNames = loaders
+            string[] loaderNames = required
                 .Select(p => p.Mod.DisplayName + this.GetOnBehalfOfLabel(p.OnBehalfOf))
                 .Distinct()
                 .ToArray();
             string errorPhrase = loaderNames.Length > 1
-                ? $"Multiple mods want to provide '{info.Name}' asset: {string.Join(", ", loaderNames)}"
+                ? $"Multiple mods want to provide the '{info.Name}' asset: {string.Join(", ", loaderNames)}"
                 : $"The '{loaderNames[0]}' mod wants to provide the '{info.Name}' asset multiple times";
 
             error = $"{errorPhrase}. An asset can't be loaded multiple times, so SMAPI will use the default asset instead. Uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)";

From 3707f481a567df5149aea00ffb14cddb7b14fccb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 25 Mar 2022 23:53:30 -0400
Subject: [PATCH 474/856] extend load conflict resolution into load priority
 (#766)

---
 src/SMAPI/Events/AssetLoadPriority.cs         | 19 +++++++++++++++++++
 src/SMAPI/Events/AssetRequestedEventArgs.cs   | 14 +++++++-------
 .../Framework/Content/AssetLoadOperation.cs   | 11 ++++++-----
 src/SMAPI/Framework/ContentCoordinator.cs     |  2 +-
 .../ContentManagers/GameContentManager.cs     | 10 +++++-----
 5 files changed, 38 insertions(+), 18 deletions(-)
 create mode 100644 src/SMAPI/Events/AssetLoadPriority.cs

diff --git a/src/SMAPI/Events/AssetLoadPriority.cs b/src/SMAPI/Events/AssetLoadPriority.cs
new file mode 100644
index 00000000..e07b5a40
--- /dev/null
+++ b/src/SMAPI/Events/AssetLoadPriority.cs
@@ -0,0 +1,19 @@
+namespace StardewModdingAPI.Events
+{
+    /// <summary>The priority for an asset load when multiple apply for the same asset.</summary>
+    /// <remarks>If multiple non-<see cref="Exclusive"/> loads have the same priority, the one registered first will be selected. You can also specify arbitrary intermediate values, like <c>AssetLoadPriority.Low + 5</c>.</remarks>
+    public enum AssetLoadPriority
+    {
+        /// <summary>This load is optional and can safely be skipped if there are higher-priority loads.</summary>
+        Low = -1000,
+
+        /// <summary>The load is optional and can safely be skipped if there are higher-priority loads, but it should still be preferred over any <see cref="Low"/>-priority loads.</summary>
+        Medium = 0,
+
+        /// <summary>The load is optional and can safely be skipped if there are higher-priority loads, but it should still be preferred over any <see cref="Low"/>- or <see cref="Medium"/>-priority loads.</summary>
+        High = 1000,
+
+        /// <summary>The load is not optional. If more than one loader has <see cref="Exclusive"/> priority, SMAPI will log an error and ignore all of them.</summary>
+        Exclusive = int.MaxValue
+    }
+}
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index 9942079b..d022a4de 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -49,21 +49,21 @@ namespace StardewModdingAPI.Events
 
         /// <summary>Provide the initial instance for the asset, instead of trying to load it from the game's <c>Content</c> folder.</summary>
         /// <param name="load">Get the initial instance of an asset.</param>
+        /// <param name="priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
         /// <param name="onBehalfOf">The content pack ID on whose behalf you're applying the change. This is only valid for content packs for your mod.</param>
-        /// <param name="allowSkipOnConflict">When there are multiple loads that apply to the same asset, this indicates whether this one can be skipped to resolve the conflict. If all loads allow skipping, the first one that was registered will be applied. If this is false, SMAPI will raise an error and apply none of them.</param>
         /// <remarks>
         /// Usage notes:
         /// <list type="bullet">
         ///   <item>The asset doesn't need to exist in the game's <c>Content</c> folder. If any mod loads the asset, the game will see it as an existing asset as if it was in that folder.</item>
-        ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will use the <paramref name="allowSkipOnConflict"/> parameter to decide what happens. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
+        ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will use the <paramref name="priority"/> parameter to decide what happens. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
         /// </list>
         /// </remarks>
-        public void LoadFrom(Func<object> load, string onBehalfOf = null, bool allowSkipOnConflict = false)
+        public void LoadFrom(Func<object> load, AssetLoadPriority priority, string onBehalfOf = null)
         {
             this.LoadOperations.Add(
                 new AssetLoadOperation(
                     mod: this.Mod,
-                    allowSkipOnConflict: allowSkipOnConflict,
+                    priority: priority,
                     onBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "load assets"),
                     getData: _ => load()
                 )
@@ -73,7 +73,7 @@ namespace StardewModdingAPI.Events
         /// <summary>Provide the initial instance for the asset from a file in your mod folder, instead of trying to load it from the game's <c>Content</c> folder.</summary>
         /// <typeparam name="TAsset">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="relativePath">The relative path to the file in your mod folder.</param>
-        /// <param name="allowSkipOnConflict">When there are multiple loads that apply to the same asset, this indicates whether this one can be skipped to resolve the conflict. If all loads allow skipping, the first one that was registered will be applied. If this is false, SMAPI will raise an error and apply none of them.</param>
+        /// <param name="priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
         /// <remarks>
         /// Usage notes:
         /// <list type="bullet">
@@ -81,12 +81,12 @@ namespace StardewModdingAPI.Events
         ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will raise an error and ignore all of them. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
         /// </list>
         /// </remarks>
-        public void LoadFromModFile<TAsset>(string relativePath, bool allowSkipOnConflict = false)
+        public void LoadFromModFile<TAsset>(string relativePath, AssetLoadPriority priority)
         {
             this.LoadOperations.Add(
                 new AssetLoadOperation(
                     mod: this.Mod,
-                    allowSkipOnConflict: allowSkipOnConflict,
+                    priority: priority,
                     onBehalfOf: null,
                     _ => this.Mod.Mod.Helper.Content.Load<TAsset>(relativePath))
             );
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
index 36baf1aa..b12958d6 100644
--- a/src/SMAPI/Framework/Content/AssetLoadOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -1,4 +1,5 @@
 using System;
+using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Content
 {
@@ -14,8 +15,8 @@ namespace StardewModdingAPI.Framework.Content
         /// <summary>The content pack on whose behalf the asset is being loaded, if any.</summary>
         public IModMetadata OnBehalfOf { get; }
 
-        /// <summary>Whether to allow skipping this operation to resolve a load conflict.</summary>
-        public bool AllowSkipOnConflict { get; }
+        /// <summary>If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</summary>
+        public AssetLoadPriority Priority { get; }
 
         /// <summary>Load the initial value for an asset.</summary>
         public Func<IAssetInfo, object> GetData { get; }
@@ -26,13 +27,13 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod applying the edit.</param>
-        /// <param name="allowSkipOnConflict">Whether to allow skipping this operation to resolve a load conflict.</param>
+        /// <param name="priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
         /// <param name="onBehalfOf">The content pack on whose behalf the asset is being loaded, if any.</param>
         /// <param name="getData">Load the initial value for an asset.</param>
-        public AssetLoadOperation(IModMetadata mod, bool allowSkipOnConflict, IModMetadata onBehalfOf, Func<IAssetInfo, object> getData)
+        public AssetLoadOperation(IModMetadata mod, AssetLoadPriority priority, IModMetadata onBehalfOf, Func<IAssetInfo, object> getData)
         {
             this.Mod = mod;
-            this.AllowSkipOnConflict = allowSkipOnConflict;
+            this.Priority = priority;
             this.OnBehalfOf = onBehalfOf;
             this.GetData = getData;
         }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 43cebcbe..144832b2 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -608,7 +608,7 @@ namespace StardewModdingAPI.Framework
                     {
                         new AssetLoadOperation(
                             mod: loader.Mod,
-                            allowSkipOnConflict: false,
+                            priority: AssetLoadPriority.Exclusive,
                             onBehalfOf: null,
                             getData: assetInfo => loader.Data.Load<T>(assetInfo)
                         )
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index b3e98648..16eddb00 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -6,6 +6,7 @@ using System.Linq;
 using System.Reflection;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
@@ -275,7 +276,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // find matching loader
             AssetLoadOperation loader;
             {
-                AssetLoadOperation[] loaders = this.GetLoaders<T>(info).ToArray();
+                AssetLoadOperation[] loaders = this.GetLoaders<T>(info).OrderByDescending(p => p.Priority).ToArray();
 
                 if (!this.AssertMaxOneRequiredLoader(info, loaders, out string error))
                 {
@@ -283,9 +284,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     return null;
                 }
 
-                loader =
-                    loaders.FirstOrDefault(p => !p.AllowSkipOnConflict)
-                    ?? loaders.FirstOrDefault();
+                loader = loaders.FirstOrDefault();
             }
 
             // no loader found
@@ -396,7 +395,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <returns>Returns true if only one loader will apply, else false.</returns>
         private bool AssertMaxOneRequiredLoader(IAssetInfo info, AssetLoadOperation[] loaders, out string error)
         {
-            AssetLoadOperation[] required = loaders.Where(p => !p.AllowSkipOnConflict).ToArray();
+            AssetLoadOperation[] required = loaders.Where(p => p.Priority == AssetLoadPriority.Exclusive).ToArray();
             if (required.Length <= 1)
             {
                 error = null;
@@ -405,6 +404,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             string[] loaderNames = required
                 .Select(p => p.Mod.DisplayName + this.GetOnBehalfOfLabel(p.OnBehalfOf))
+                .OrderBy(p => p)
                 .Distinct()
                 .ToArray();
             string errorPhrase = loaderNames.Length > 1

From 4da38e1317f6ebd6485b04482eb3d2ffd0507530 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 00:52:04 -0400
Subject: [PATCH 475/856] add missing [Obsolete] tag

---
 src/SMAPI/ICommandHelper.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/SMAPI/ICommandHelper.cs b/src/SMAPI/ICommandHelper.cs
index 196e1051..b92e5162 100644
--- a/src/SMAPI/ICommandHelper.cs
+++ b/src/SMAPI/ICommandHelper.cs
@@ -21,6 +21,7 @@ namespace StardewModdingAPI
         /// <param name="name">The command name.</param>
         /// <param name="arguments">The command arguments.</param>
         /// <returns>Returns whether a matching command was triggered.</returns>
+        [Obsolete("Manually triggering console commands will no longer be supported in SMAPI 4.0.0.")]
         bool Trigger(string name, string[] arguments);
     }
 }

From e40907ab8b97bd8a557adf683a406413646b1fc5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 01:19:44 -0400
Subject: [PATCH 476/856] add NameWithoutLocale fields (#766)

---
 src/SMAPI/Events/AssetReadyEventArgs.cs        |  8 +++++++-
 src/SMAPI/Events/AssetRequestedEventArgs.cs    |  8 +++++++-
 src/SMAPI/Events/AssetsInvalidatedEventArgs.cs |  9 +++++++--
 src/SMAPI/Framework/Content/AssetInfo.cs       | 12 ++++++++----
 src/SMAPI/Framework/Content/AssetName.cs       |  9 +++++++++
 src/SMAPI/Framework/ContentCoordinator.cs      |  6 +++---
 src/SMAPI/Framework/SCore.cs                   |  8 ++++----
 src/SMAPI/IAssetInfo.cs                        |  8 ++++++--
 src/SMAPI/IAssetName.cs                        |  3 +++
 9 files changed, 54 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI/Events/AssetReadyEventArgs.cs b/src/SMAPI/Events/AssetReadyEventArgs.cs
index 946c9173..2c308f18 100644
--- a/src/SMAPI/Events/AssetReadyEventArgs.cs
+++ b/src/SMAPI/Events/AssetReadyEventArgs.cs
@@ -11,15 +11,21 @@ namespace StardewModdingAPI.Events
         /// <summary>The name of the asset being requested.</summary>
         public IAssetName Name { get; }
 
+        /// <summary>The <see cref="Name"/> with any locale codes stripped.</summary>
+        /// <remarks>For example, if <see cref="Name"/> contains a locale like <c>Data/Bundles.fr-FR</c>, this will be the name without locale like <c>Data/Bundles</c>. If the name has no locale, this field is equivalent.</remarks>
+        public IAssetName NameWithoutLocale { get; }
+
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="name">The name of the asset being requested.</param>
-        internal AssetReadyEventArgs(IAssetName name)
+        /// <param name="nameWithoutLocale">The <paramref name="name"/> with any locale codes stripped.</param>
+        internal AssetReadyEventArgs(IAssetName name, IAssetName nameWithoutLocale)
         {
             this.Name = name;
+            this.NameWithoutLocale = nameWithoutLocale;
         }
     }
 }
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index d022a4de..9e2cde7f 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -26,6 +26,10 @@ namespace StardewModdingAPI.Events
         /// <summary>The name of the asset being requested.</summary>
         public IAssetName Name { get; }
 
+        /// <summary>The <see cref="Name"/> with any locale codes stripped.</summary>
+        /// <remarks>For example, if <see cref="Name"/> contains a locale like <c>Data/Bundles.fr-FR</c>, this will be the name without locale like <c>Data/Bundles</c>. If the name has no locale, this field is equivalent.</remarks>
+        public IAssetName NameWithoutLocale { get; }
+
         /// <summary>The load operations requested by the event handler.</summary>
         internal IList<AssetLoadOperation> LoadOperations { get; } = new List<AssetLoadOperation>();
 
@@ -39,11 +43,13 @@ namespace StardewModdingAPI.Events
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod handling the event.</param>
         /// <param name="name">The name of the asset being requested.</param>
+        /// <param name="nameWithoutLocale">The <paramref name="name"/> with any locale codes stripped.</param>
         /// <param name="getOnBehalfOf">Get the mod metadata for a content pack, if it's a valid content pack for the mod.</param>
-        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name, Func<IModMetadata, string, string, IModMetadata> getOnBehalfOf)
+        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name, IAssetName nameWithoutLocale, Func<IModMetadata, string, string, IModMetadata> getOnBehalfOf)
         {
             this.Mod = mod;
             this.Name = name;
+            this.NameWithoutLocale = nameWithoutLocale;
             this.GetOnBehalfOf = getOnBehalfOf;
         }
 
diff --git a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
index f3d83dd6..614cdf49 100644
--- a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
+++ b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
-using System.Linq;
 
 namespace StardewModdingAPI.Events
 {
@@ -14,15 +13,21 @@ namespace StardewModdingAPI.Events
         /// <summary>The asset names that were invalidated.</summary>
         public IReadOnlySet<IAssetName> Names { get; }
 
+        /// <summary>The <see cref="Names"/> with any locale codes stripped.</summary>
+        /// <remarks>For example, if <see cref="Names"/> contains a locale like <c>Data/Bundles.fr-FR</c>, this will have the name without locale like <c>Data/Bundles</c>. If the name has no locale, this field is equivalent.</remarks>
+        public IReadOnlySet<IAssetName> NamesWithoutLocale { get; }
+
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="names">The asset names that were invalidated.</param>
-        internal AssetsInvalidatedEventArgs(IEnumerable<IAssetName> names)
+        /// <param name="namesWithoutLocale">The <paramref name="names"/> with any locale codes stripped.</param>
+        internal AssetsInvalidatedEventArgs(IEnumerable<IAssetName> names, IEnumerable<IAssetName> namesWithoutLocale)
         {
             this.Names = names.ToImmutableHashSet();
+            this.NamesWithoutLocale = namesWithoutLocale.ToImmutableHashSet();
         }
     }
 }
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 6a5b4f31..556f1c2a 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -23,8 +23,11 @@ namespace StardewModdingAPI.Framework.Content
         public IAssetName Name { get; }
 
         /// <inheritdoc />
-        [Obsolete($"Use {nameof(Name)} instead.")]
-        public string AssetName => this.Name.Name;
+        public IAssetName NameWithoutLocale { get; }
+
+        /// <inheritdoc />
+        [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead.")]
+        public string AssetName => this.NameWithoutLocale.Name;
 
         /// <inheritdoc />
         public Type DataType { get; }
@@ -42,15 +45,16 @@ namespace StardewModdingAPI.Framework.Content
         {
             this.Locale = locale;
             this.Name = assetName;
+            this.NameWithoutLocale = assetName.GetBaseAssetName();
             this.DataType = type;
             this.GetNormalizedPath = getNormalizedPath;
         }
 
         /// <inheritdoc />
-        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
+        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
         public bool AssetNameEquals(string path)
         {
-            return this.Name.IsEquivalentTo(path);
+            return this.NameWithoutLocale.IsEquivalentTo(path);
         }
 
 
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 992647f8..7ce0f8ee 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -142,11 +142,20 @@ namespace StardewModdingAPI.Framework.Content
         }
 
 
+        /// <inheritdoc />
         public bool IsDirectlyUnderPath(string assetFolder)
         {
             return this.StartsWith(assetFolder + "/", allowPartialWord: false, allowSubfolder: false);
         }
 
+        /// <inheritdoc />
+        IAssetName IAssetName.GetBaseAssetName()
+        {
+            return this.LocaleCode == null
+                ? this
+                : new AssetName(this.BaseName, null, null);
+        }
+
         /// <inheritdoc />
         public bool Equals(IAssetName other)
         {
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 144832b2..fc137e50 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -53,7 +53,7 @@ namespace StardewModdingAPI.Framework
         private readonly Action<BaseContentManager, IAssetName> OnAssetLoaded;
 
         /// <summary>A callback to invoke when any asset names have been invalidated from the cache.</summary>
-        private readonly Action<IEnumerable<IAssetName>> OnAssetsInvalidated;
+        private readonly Action<IList<IAssetName>> OnAssetsInvalidated;
 
         /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
         private readonly Func<IAssetInfo, IList<AssetOperationGroup>> RequestAssetOperations;
@@ -118,7 +118,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations, Action<IEnumerable<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
         {
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
@@ -414,7 +414,7 @@ namespace StardewModdingAPI.Framework
                     this.AssetOperationsByKey.Remove(name);
 
                 // raise event
-                this.OnAssetsInvalidated(invalidatedAssets.Keys);
+                this.OnAssetsInvalidated(invalidatedAssets.Keys.ToArray());
 
                 // propagate changes to the game
                 this.CoreAssets.Propagate(
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index dd682e40..dd952dee 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1113,15 +1113,15 @@ namespace StardewModdingAPI.Framework
         private void OnAssetLoaded(IContentManager contentManager, IAssetName assetName)
         {
             if (this.EventManager.AssetReady.HasListeners())
-                this.EventManager.AssetReady.Raise(new AssetReadyEventArgs(assetName));
+                this.EventManager.AssetReady.Raise(new AssetReadyEventArgs(assetName, assetName.GetBaseAssetName()));
         }
 
         /// <summary>A callback invoked after assets have been invalidated from the content cache.</summary>
         /// <param name="assetNames">The invalidated asset names.</param>
-        private void OnAssetsInvalidated(IEnumerable<IAssetName> assetNames)
+        private void OnAssetsInvalidated(IList<IAssetName> assetNames)
         {
             if (this.EventManager.AssetsInvalidated.HasListeners())
-                this.EventManager.AssetsInvalidated.Raise(new AssetsInvalidatedEventArgs(assetNames));
+                this.EventManager.AssetsInvalidated.Raise(new AssetsInvalidatedEventArgs(assetNames, assetNames.Select(p => p.GetBaseAssetName())));
         }
 
         /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
@@ -1133,7 +1133,7 @@ namespace StardewModdingAPI.Framework
             this.EventManager.AssetRequested.Raise(
                 invoke: (mod, invoke) =>
                 {
-                    AssetRequestedEventArgs args = new(mod, asset.Name, this.GetOnBehalfOfContentPack);
+                    AssetRequestedEventArgs args = new(mod, asset.Name, asset.NameWithoutLocale, this.GetOnBehalfOfContentPack);
 
                     invoke(args);
 
diff --git a/src/SMAPI/IAssetInfo.cs b/src/SMAPI/IAssetInfo.cs
index 6ac8358d..c7b2ab62 100644
--- a/src/SMAPI/IAssetInfo.cs
+++ b/src/SMAPI/IAssetInfo.cs
@@ -14,8 +14,12 @@ namespace StardewModdingAPI
         /// <summary>The asset name being read.</summary>
         public IAssetName Name { get; }
 
+        /// <summary>The <see cref="Name"/> with any locale codes stripped.</summary>
+        /// <remarks>For example, if <see cref="Name"/> contains a locale like <c>Data/Bundles.fr-FR</c>, this will be the name without locale like <c>Data/Bundles</c>. If the name has no locale, this field is equivalent.</remarks>
+        public IAssetName NameWithoutLocale { get; }
+
         /// <summary>The normalized asset name being read. The format may change between platforms; see <see cref="AssetNameEquals"/> to compare with a known path.</summary>
-        [Obsolete($"Use {nameof(Name)} instead.")]
+        [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead.")]
         string AssetName { get; }
 
         /// <summary>The content data type.</summary>
@@ -27,7 +31,7 @@ namespace StardewModdingAPI
         *********/
         /// <summary>Get whether the asset name being loaded matches a given name after normalization.</summary>
         /// <param name="path">The expected asset path, relative to the game's content folder and without the .xnb extension or locale suffix (like 'Data\ObjectInformation').</param>
-        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
+        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
         bool AssetNameEquals(string path);
     }
 }
diff --git a/src/SMAPI/IAssetName.cs b/src/SMAPI/IAssetName.cs
index a5bfea93..89f02adf 100644
--- a/src/SMAPI/IAssetName.cs
+++ b/src/SMAPI/IAssetName.cs
@@ -40,5 +40,8 @@ namespace StardewModdingAPI
         /// <remarks>For example, <c>Characters/Dialogue/Abigail</c> is directly under <c>Characters/Dialogue</c> but not <c>Characters</c> or <c>Characters/Dialogue/Ab</c>. To allow sub-paths, use <see cref="StartsWith"/> instead.</remarks>
         /// <param name="assetFolder">The asset path to check. This doesn't need a trailing slash.</param>
         bool IsDirectlyUnderPath(string assetFolder);
+
+        /// <summary>Get an asset name representing the <see cref="BaseName"/> without locale.</summary>
+        internal IAssetName GetBaseAssetName();
     }
 }

From ad8912047beaf84ce34f4918703d55841be13ff0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 01:43:40 -0400
Subject: [PATCH 477/856] add asset edit priority (#766)

---
 docs/release-notes.md                            |  2 +-
 src/SMAPI/Events/AssetEditPriority.cs            | 16 ++++++++++++++++
 src/SMAPI/Events/AssetRequestedEventArgs.cs      |  4 +++-
 .../Framework/Content/AssetEditOperation.cs      |  8 +++++++-
 src/SMAPI/Framework/ContentCoordinator.cs        |  1 +
 .../ContentManagers/GameContentManager.cs        |  7 +++++--
 6 files changed, 33 insertions(+), 5 deletions(-)
 create mode 100644 src/SMAPI/Events/AssetEditPriority.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c8c87db3..a8f8ccfd 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,7 +13,7 @@
 
 * For mod authors:
   * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
-    _These include new features not supported by the old API, like load conflict resolution and content pack labels. They also support new cases like easily detecting when an asset has been changed._
+    _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has been changed._
   * Overhauled [mod-provided APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) (thanks to Shockah!).  
     _This adds support for many previously-unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more._
   * Added `Constants.ContentPath`.
diff --git a/src/SMAPI/Events/AssetEditPriority.cs b/src/SMAPI/Events/AssetEditPriority.cs
new file mode 100644
index 00000000..d41dfd7d
--- /dev/null
+++ b/src/SMAPI/Events/AssetEditPriority.cs
@@ -0,0 +1,16 @@
+namespace StardewModdingAPI.Events
+{
+    /// <summary>The priority for an asset edit when multiple apply for the same asset.</summary>
+    /// <remarks>You can also specify arbitrary intermediate values, like <c>AssetLoadPriority.Low + 5</c>.</remarks>
+    public enum AssetEditPriority
+    {
+        /// <summary>This edit should be applied before (i.e. 'under') <see cref="Default"/> edits.</summary>
+        Early = -1000,
+
+        /// <summary>The default priority.</summary>
+        Default = 0,
+
+        /// <summary>This edit should be applied after (i.e. 'on top of') <see cref="Default"/> edits.</summary>
+        Late = 1000
+    }
+}
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index 9e2cde7f..4d9ee236 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -100,6 +100,7 @@ namespace StardewModdingAPI.Events
 
         /// <summary>Edit the asset after it's loaded.</summary>
         /// <param name="apply">Apply changes to the asset.</param>
+        /// <param name="priority">If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</param>
         /// <param name="onBehalfOf">The content pack ID on whose behalf you're applying the change. This is only valid for content packs for your mod.</param>
         /// <remarks>
         /// Usage notes:
@@ -108,11 +109,12 @@ namespace StardewModdingAPI.Events
         ///   <item>You can apply any number of edits to the asset. Each edit will be applied on top of the previous one (i.e. it'll see the merged asset from all previous edits as its input).</item>
         /// </list>
         /// </remarks>
-        public void Edit(Action<IAssetData> apply, string onBehalfOf = null)
+        public void Edit(Action<IAssetData> apply, AssetEditPriority priority = AssetEditPriority.Default, string onBehalfOf = null)
         {
             this.EditOperations.Add(
                 new AssetEditOperation(
                     mod: this.Mod,
+                    priority: priority,
                     onBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "edit assets"),
                     apply
                 )
diff --git a/src/SMAPI/Framework/Content/AssetEditOperation.cs b/src/SMAPI/Framework/Content/AssetEditOperation.cs
index 14db231c..818209fa 100644
--- a/src/SMAPI/Framework/Content/AssetEditOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetEditOperation.cs
@@ -1,4 +1,5 @@
 using System;
+using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Content
 {
@@ -11,6 +12,9 @@ namespace StardewModdingAPI.Framework.Content
         /// <summary>The mod applying the edit.</summary>
         public IModMetadata Mod { get; }
 
+        /// <summary>If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</summary>
+        public AssetEditPriority Priority { get; }
+
         /// <summary>The content pack on whose behalf the edit is being applied, if any.</summary>
         public IModMetadata OnBehalfOf { get; }
 
@@ -23,11 +27,13 @@ namespace StardewModdingAPI.Framework.Content
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod applying the edit.</param>
+        /// <param name="priority">If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</param>
         /// <param name="onBehalfOf">The content pack on whose behalf the edit is being applied, if any.</param>
         /// <param name="applyEdit">Apply the edit to an asset.</param>
-        public AssetEditOperation(IModMetadata mod, IModMetadata onBehalfOf, Action<IAssetData> applyEdit)
+        public AssetEditOperation(IModMetadata mod, AssetEditPriority priority, IModMetadata onBehalfOf, Action<IAssetData> applyEdit)
         {
             this.Mod = mod;
+            this.Priority = priority;
             this.OnBehalfOf = onBehalfOf;
             this.ApplyEdit = applyEdit;
         }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index fc137e50..8e7465de 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -640,6 +640,7 @@ namespace StardewModdingAPI.Framework
                     {
                         new AssetEditOperation(
                             mod: editor.Mod,
+                            priority: AssetEditPriority.Default,
                             onBehalfOf: null,
                             applyEdit: assetData => editor.Data.Edit<T>(assetData)
                         )
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 16eddb00..a121f4c0 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -82,9 +82,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
             AssetLoadOperation[] loaders = this.GetLoaders<object>(info).ToArray();
 
             if (!this.AssertMaxOneRequiredLoader(info, loaders, out string error))
+            {
                 this.Monitor.Log(error, LogLevel.Warn);
+                return false;
+            }
 
-            return loaders.Length == 1;
+            return loaders.Any();
         }
 
         /// <inheritdoc />
@@ -334,7 +337,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // edit asset
-            AssetEditOperation[] editors = this.GetEditors<T>(info).ToArray();
+            AssetEditOperation[] editors = this.GetEditors<T>(info).OrderBy(p => p.Priority).ToArray();
             foreach (AssetEditOperation editor in editors)
             {
                 IModMetadata mod = editor.Mod;

From 4c64f9f644c2349d2ca2407ce3aff736ba3fc354 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 14:07:16 -0400
Subject: [PATCH 478/856] rewrite content loading to allow handling locale
 variants (#766, #786, #812)

The game's content pipeline automatically loads localized variants if present. For example, it will try to load "Maps/cave.fr-FR", then "Maps/cave_international", then "Maps/cave". The old content API obfuscates this logic and treats them as interchangeable, which causes edge cases like bundle corruption (#812). This commit rewrites the loading logic to match the game logic when using the new content events, while maintaining the legacy behavior for the old IAssetLoader/IAssetEditor interfaces that'll be removed in SMAPI 4.0.0.
---
 docs/release-notes.md                         |   1 +
 src/SMAPI/Framework/ContentCoordinator.cs     |  89 ++++++++++++--
 .../ContentManagers/BaseContentManager.cs     |  71 +++++++++--
 .../ContentManagers/GameContentManager.cs     | 114 ++----------------
 .../GameContentManagerForAssetPropagation.cs  |   4 +-
 .../ContentManagers/IContentManager.cs        |  14 ++-
 .../ContentManagers/ModContentManager.cs      |  32 ++---
 .../Framework/ModHelpers/ContentHelper.cs     |   4 +-
 8 files changed, 169 insertions(+), 160 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a8f8ccfd..98392c17 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
     * Added `--use-current-shell` to avoid opening a separate terminal window.
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
   * Fixed warning text when a mod causes an asset load conflict with itself.
+  * Fixed support for `_international` content assets (used in the movie theater).
 
 * For mod authors:
   * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 8e7465de..a4d29068 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -61,9 +61,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>The loaded content managers (including the <see cref="MainContentManager"/>).</summary>
         private readonly List<IContentManager> ContentManagers = new();
 
-        /// <summary>The language code for language-agnostic mod assets.</summary>
-        private readonly LocalizedContentManager.LanguageCode DefaultLanguage = Constants.DefaultLanguage;
-
         /// <summary>Whether the content coordinator has been disposed.</summary>
         private bool IsDisposed;
 
@@ -350,7 +347,7 @@ namespace StardewModdingAPI.Framework
                 throw new InvalidOperationException($"The '{contentManagerID}' prefix isn't handled by any mod.");
 
             // get fresh asset
-            return contentManager.Load<T>(relativePath, this.DefaultLanguage, useCache: false);
+            return contentManager.LoadExact<T>(relativePath, useCache: false);
         }
 
         /// <summary>Purge matched assets from the cache.</summary>
@@ -467,9 +464,9 @@ namespace StardewModdingAPI.Framework
             return this.ContentManagerLock.InReadLock(() =>
             {
                 List<object> values = new List<object>();
-                foreach (IContentManager content in this.ContentManagers.Where(p => !p.IsNamespaced && p.IsLoaded(assetName, p.Language)))
+                foreach (IContentManager content in this.ContentManagers.Where(p => !p.IsNamespaced && p.IsLoaded(assetName)))
                 {
-                    object value = content.Load<object>(assetName, this.Language, useCache: true);
+                    object value = content.LoadExact<object>(assetName, useCache: true);
                     values.Add(value);
                 }
                 return values;
@@ -582,6 +579,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="info">The asset info to load or edit.</param>
         private IEnumerable<AssetOperationGroup> GetAssetOperationsWithoutCache<T>(IAssetInfo info)
         {
+            IAssetInfo legacyInfo = this.GetLegacyAssetInfo(info);
+
             // new content API
             foreach (AssetOperationGroup group in this.RequestAssetOperations(info))
                 yield return group;
@@ -592,12 +591,12 @@ namespace StardewModdingAPI.Framework
                 // check if loader applies
                 try
                 {
-                    if (!loader.Data.CanLoad<T>(info))
+                    if (!loader.Data.CanLoad<T>(legacyInfo))
                         continue;
                 }
                 catch (Exception ex)
                 {
-                    loader.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    loader.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{legacyInfo.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                     continue;
                 }
 
@@ -610,7 +609,9 @@ namespace StardewModdingAPI.Framework
                             mod: loader.Mod,
                             priority: AssetLoadPriority.Exclusive,
                             onBehalfOf: null,
-                            getData: assetInfo => loader.Data.Load<T>(assetInfo)
+                            getData: assetInfo => loader.Data.Load<T>(
+                                this.GetLegacyAssetInfo(assetInfo)
+                            )
                         )
                     },
                     editOperations: Array.Empty<AssetEditOperation>()
@@ -623,12 +624,12 @@ namespace StardewModdingAPI.Framework
                 // check if editor applies
                 try
                 {
-                    if (!editor.Data.CanEdit<T>(info))
+                    if (!editor.Data.CanEdit<T>(legacyInfo))
                         continue;
                 }
                 catch (Exception ex)
                 {
-                    editor.Mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{info.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                    editor.Mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{legacyInfo.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                     continue;
                 }
 
@@ -642,11 +643,75 @@ namespace StardewModdingAPI.Framework
                             mod: editor.Mod,
                             priority: AssetEditPriority.Default,
                             onBehalfOf: null,
-                            applyEdit: assetData => editor.Data.Edit<T>(assetData)
+                            applyEdit: assetData => editor.Data.Edit<T>(
+                                this.GetLegacyAssetData(assetData)
+                            )
                         )
                     }
                 );
             }
         }
+
+        /// <summary>Get an asset info compatible with legacy <see cref="IAssetLoader"/> and <see cref="IAssetEditor"/> instances, which always expect the base name.</summary>
+        /// <param name="asset">The asset info.</param>
+        private IAssetInfo GetLegacyAssetInfo(IAssetInfo asset)
+        {
+            if (!this.TryGetLegacyAssetName(asset.Name, out IAssetName legacyName))
+                return asset;
+
+            return new AssetInfo(
+                locale: null,
+                assetName: legacyName,
+                type: asset.DataType,
+                getNormalizedPath: this.MainContentManager.AssertAndNormalizeAssetName
+            );
+        }
+
+        /// <summary>Get an asset data compatible with legacy <see cref="IAssetLoader"/> and <see cref="IAssetEditor"/> instances, which always expect the base name.</summary>
+        /// <param name="asset">The asset data.</param>
+        private IAssetData GetLegacyAssetData(IAssetData asset)
+        {
+            if (!this.TryGetLegacyAssetName(asset.Name, out IAssetName legacyName))
+                return asset;
+
+            return asset.Name.LocaleCode == null
+                ? asset
+                : new AssetDataForObject(
+                    locale: null,
+                    assetName: legacyName,
+                    data: asset.Data,
+                    getNormalizedPath: this.MainContentManager.AssertAndNormalizeAssetName
+                );
+        }
+
+        /// <summary>Get an asset name compatible with legacy <see cref="IAssetLoader"/> and <see cref="IAssetEditor"/> instances, which always expect the base name.</summary>
+        /// <param name="asset">The asset name to map.</param>
+        /// <param name="newAsset">The legacy asset name (or the <paramref name="asset"/> if no change is needed).</param>
+        /// <returns>Returns whether any change is needed for legacy compatibility.</returns>
+        private bool TryGetLegacyAssetName(IAssetName asset, out IAssetName newAsset)
+        {
+            // strip _international suffix
+            const string internationalSuffix = "_international";
+            if (asset.Name.EndsWith(internationalSuffix))
+            {
+                newAsset = new AssetName(
+                    baseName: asset.Name[..^internationalSuffix.Length],
+                    localeCode: null,
+                    languageCode: null
+                );
+                return true;
+            }
+
+            // else strip locale
+            if (asset.LocaleCode != null)
+            {
+                newAsset = new AssetName(asset.BaseName, null, null);
+                return true;
+            }
+
+            // else no change needed
+            newAsset = asset;
+            return false;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 030c60a7..b1ace259 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -5,6 +5,7 @@ using System.Diagnostics.Contracts;
 using System.Globalization;
 using System.IO;
 using System.Linq;
+using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
@@ -32,6 +33,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Whether to enable more aggressive memory optimizations.</summary>
         protected readonly bool AggressiveMemoryOptimizations;
 
+        /// <summary>Whether to automatically try resolving keys to a localized form if available.</summary>
+        protected bool TryLocalizeKeys = true;
+
         /// <summary>Whether the content coordinator has been disposed.</summary>
         private bool IsDisposed;
 
@@ -39,7 +43,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private readonly Action<BaseContentManager> OnDisposing;
 
         /// <summary>A list of disposable assets.</summary>
-        private readonly List<WeakReference<IDisposable>> Disposables = new List<WeakReference<IDisposable>>();
+        private readonly List<WeakReference<IDisposable>> Disposables = new();
 
         /// <summary>The disposable assets tracked by the base content manager.</summary>
         /// <remarks>This should be kept empty to avoid keeping disposable assets referenced forever, which prevents garbage collection when they're unused. Disposable assets are tracked by <see cref="Disposables"/> instead, which avoids a hard reference.</remarks>
@@ -115,11 +119,51 @@ namespace StardewModdingAPI.Framework.ContentManagers
         public override T Load<T>(string assetName, LanguageCode language)
         {
             IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
-            return this.Load<T>(parsedName, language, useCache: true);
+            return this.LoadLocalized<T>(parsedName, language, useCache: true);
         }
 
         /// <inheritdoc />
-        public abstract T Load<T>(IAssetName assetName, LanguageCode language, bool useCache);
+        public T LoadLocalized<T>(IAssetName assetName, LanguageCode language, bool useCache)
+        {
+            // ignore locale in English (or if disabled)
+            if (!this.TryLocalizeKeys || language == LocalizedContentManager.LanguageCode.en)
+                return this.LoadExact<T>(assetName, useCache: useCache);
+
+            // check for localized asset
+            if (!LocalizedContentManager.localizedAssetNames.TryGetValue(assetName.Name, out _))
+            {
+                string localeCode = this.LanguageCodeString(language);
+                IAssetName localizedName = new AssetName(baseName: assetName.BaseName, localeCode: localeCode, languageCode: language);
+
+                try
+                {
+                    this.LoadExact<T>(localizedName, useCache: useCache);
+                    LocalizedContentManager.localizedAssetNames[assetName.Name] = localizedName.Name;
+                }
+                catch (ContentLoadException)
+                {
+                    localizedName = new AssetName(assetName.BaseName + "_international", null, null);
+                    try
+                    {
+                        this.LoadExact<T>(localizedName, useCache: useCache);
+                        LocalizedContentManager.localizedAssetNames[assetName.Name] = localizedName.Name;
+                    }
+                    catch (ContentLoadException)
+                    {
+                        LocalizedContentManager.localizedAssetNames[assetName.Name] = assetName.Name;
+                    }
+                }
+            }
+
+            // use cached key
+            string rawName = LocalizedContentManager.localizedAssetNames[assetName.Name];
+            if (assetName.Name != rawName)
+                assetName = this.Coordinator.ParseAssetName(assetName.Name);
+            return this.LoadExact<T>(assetName, useCache: useCache);
+        }
+
+        /// <inheritdoc />
+        public abstract T LoadExact<T>(IAssetName assetName, bool useCache);
 
         /// <inheritdoc />
         public virtual void OnLocaleChanged() { }
@@ -154,7 +198,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public abstract bool IsLoaded(IAssetName assetName, LanguageCode language);
+        public bool IsLoaded(IAssetName assetName)
+        {
+            return this.Cache.ContainsKey(assetName.Name);
+        }
+
 
         /****
         ** Cache invalidation
@@ -241,26 +289,29 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The normalized asset key.</param>
         /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
-        protected virtual T RawLoad<T>(string assetName, bool useCache)
+        protected virtual T RawLoad<T>(IAssetName assetName, bool useCache)
         {
             return useCache
-                ? base.LoadBase<T>(assetName)
-                : base.ReadAsset<T>(assetName, disposable => this.Disposables.Add(new WeakReference<IDisposable>(disposable)));
+                ? base.LoadBase<T>(assetName.Name)
+                : base.ReadAsset<T>(assetName.Name, disposable => this.Disposables.Add(new WeakReference<IDisposable>(disposable)));
         }
 
         /// <summary>Add tracking data to an asset and add it to the cache.</summary>
         /// <typeparam name="T">The type of asset to inject.</typeparam>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
         /// <param name="value">The asset value.</param>
-        /// <param name="language">The language code for which to inject the asset.</param>
         /// <param name="useCache">Whether to save the asset to the asset cache.</param>
-        protected virtual void TrackAsset<T>(IAssetName assetName, T value, LanguageCode language, bool useCache)
+        protected virtual void TrackAsset<T>(IAssetName assetName, T value, bool useCache)
         {
             // track asset key
             if (value is Texture2D texture)
                 texture.Name = assetName.Name;
 
-            // cache asset
+            // save to cache
+            // Note: even if the asset was loaded and cached right before this method was called,
+            // we need to fully re-inject it because a mod editor may have changed the asset in a
+            // way that doesn't change the instance stored in the cache, e.g. using
+            // `asset.ReplaceWith`.
             if (useCache)
                 this.Cache[assetName.Name] = value;
 
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index a121f4c0..500c0191 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -4,11 +4,9 @@ using System.Globalization;
 using System.IO;
 using System.Linq;
 using System.Reflection;
-using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Content;
-using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
@@ -91,7 +89,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public override T Load<T>(IAssetName assetName, LanguageCode language, bool useCache)
+        public override T LoadExact<T>(IAssetName assetName, bool useCache)
         {
             // raise first-load callback
             if (GameContentManager.IsFirstLoad)
@@ -100,19 +98,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 this.OnLoadingFirstAsset();
             }
 
-            // normalize asset name
-            if (assetName.LanguageCode.HasValue)
-                return this.Load<T>(this.Coordinator.ParseAssetName(assetName.BaseName), assetName.LanguageCode.Value, useCache);
-
             // get from cache
-            if (useCache && this.IsLoaded(assetName, language))
-                return this.RawLoad<T>(assetName, language, useCache: true);
+            if (useCache && this.IsLoaded(assetName))
+                return this.RawLoad<T>(assetName, useCache: true);
 
             // get managed asset
             if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
             {
                 T managedAsset = this.Coordinator.LoadManagedAsset<T>(contentManagerID, relativePath);
-                this.TrackAsset(assetName, managedAsset, language, useCache);
+                this.TrackAsset(assetName, managedAsset, useCache);
                 return managedAsset;
             }
 
@@ -122,44 +116,29 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 this.Monitor.Log($"Broke loop while loading asset '{assetName}'.", LogLevel.Warn);
                 this.Monitor.Log($"Bypassing mod loaders for this asset. Stack trace:\n{Environment.StackTrace}");
-                data = this.RawLoad<T>(assetName, language, useCache);
+                data = this.RawLoad<T>(assetName, useCache);
             }
             else
             {
                 data = this.AssetsBeingLoaded.Track(assetName.Name, () =>
                 {
-                    string locale = this.GetLocale(language);
-                    IAssetInfo info = new AssetInfo(locale, assetName, typeof(T), this.AssertAndNormalizeAssetName);
+                    IAssetInfo info = new AssetInfo(assetName.LocaleCode, assetName, typeof(T), this.AssertAndNormalizeAssetName);
                     IAssetData asset =
                         this.ApplyLoader<T>(info)
-                        ?? new AssetDataForObject(info, this.RawLoad<T>(assetName, language, useCache), this.AssertAndNormalizeAssetName);
+                        ?? new AssetDataForObject(info, this.RawLoad<T>(assetName, useCache), this.AssertAndNormalizeAssetName);
                     asset = this.ApplyEditors<T>(info, asset);
                     return (T)asset.Data;
                 });
             }
 
             // update cache
-            this.TrackAsset(assetName, data, language, useCache);
+            this.TrackAsset(assetName, data, useCache);
 
             // raise event & return data
             this.OnAssetLoaded(this, assetName);
             return data;
         }
 
-        /// <inheritdoc />
-        public override bool IsLoaded(IAssetName assetName, LanguageCode language)
-        {
-            string cachedKey = null;
-            bool localized =
-                language != LanguageCode.en
-                && !this.Coordinator.IsManagedAssetKey(assetName)
-                && this.LocalizedAssetNames.TryGetValue(assetName.Name, out cachedKey);
-
-            return localized
-                ? this.Cache.ContainsKey(cachedKey)
-                : this.Cache.ContainsKey(assetName.Name);
-        }
-
         /// <inheritdoc />
         public override void OnLocaleChanged()
         {
@@ -175,7 +154,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // invalidate translatable assets
             string[] invalidated = this
-                .InvalidateCache((key, type) =>
+                .InvalidateCache((key, _) =>
                     removeAssetNames.Contains(key)
                     || removeAssetNames.Contains(this.Coordinator.ParseAssetName(key).BaseName)
                 )
@@ -196,81 +175,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
-        /// <inheritdoc />
-        protected override void TrackAsset<T>(IAssetName assetName, T value, LanguageCode language, bool useCache)
-        {
-            // handle explicit language in asset name
-            {
-                if (assetName.LanguageCode.HasValue)
-                {
-                    this.TrackAsset(this.Coordinator.ParseAssetName(assetName.BaseName), value, assetName.LanguageCode.Value, useCache);
-                    return;
-                }
-            }
-
-            // save to cache
-            // Note: even if the asset was loaded and cached right before this method was called,
-            // we need to fully re-inject it here for two reasons:
-            //   1. So we can look up an asset by its base or localized key (the game/XNA logic
-            //      only caches by the most specific key).
-            //   2. Because a mod asset loader/editor may have changed the asset in a way that
-            //      doesn't change the instance stored in the cache, e.g. using `asset.ReplaceWith`.
-            if (useCache)
-            {
-                IAssetName translatedKey = new AssetName(assetName.Name, this.GetLocale(language), language);
-                base.TrackAsset(assetName, value, language, useCache: true);
-                if (this.Cache.ContainsKey(translatedKey.Name))
-                    base.TrackAsset(translatedKey, value, language, useCache: true);
-
-                // track whether the injected asset is translatable for is-loaded lookups
-                if (this.Cache.ContainsKey(translatedKey.Name))
-                    this.LocalizedAssetNames[assetName.Name] = translatedKey.Name;
-                else if (this.Cache.ContainsKey(assetName.Name))
-                    this.LocalizedAssetNames[assetName.Name] = assetName.Name;
-                else
-                    this.Monitor.Log($"Asset '{assetName}' could not be found in the cache immediately after injection.", LogLevel.Error);
-            }
-        }
-
-        /// <summary>Load an asset file directly from the underlying content manager.</summary>
-        /// <typeparam name="T">The type of asset to load.</typeparam>
-        /// <param name="assetName">The normalized asset key.</param>
-        /// <param name="language">The language code for which to load content.</param>
-        /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
-        /// <remarks>Derived from <see cref="LocalizedContentManager.Load{T}(string, LocalizedContentManager.LanguageCode)"/>.</remarks>
-        private T RawLoad<T>(IAssetName assetName, LanguageCode language, bool useCache)
-        {
-            try
-            {
-                // use cached key
-                if (language == this.Language && this.LocalizedAssetNames.TryGetValue(assetName.Name, out string cachedKey))
-                    return base.RawLoad<T>(cachedKey, useCache);
-
-                // try translated key
-                if (language != LanguageCode.en)
-                {
-                    string translatedKey = $"{assetName}.{this.GetLocale(language)}";
-                    try
-                    {
-                        T obj = base.RawLoad<T>(translatedKey, useCache);
-                        this.LocalizedAssetNames[assetName.Name] = translatedKey;
-                        return obj;
-                    }
-                    catch (ContentLoadException)
-                    {
-                        this.LocalizedAssetNames[assetName.Name] = assetName.Name;
-                    }
-                }
-
-                // try base asset
-                return base.RawLoad<T>(assetName.Name, useCache);
-            }
-            catch (ContentLoadException ex) when (ex.InnerException is FileNotFoundException { InnerException: null })
-            {
-                throw new SContentLoadException($"Error loading \"{assetName}\": it isn't in the Content folder and no mod provided it.");
-            }
-        }
-
         /// <summary>Load the initial asset from the registered loaders.</summary>
         /// <param name="info">The basic asset metadata.</param>
         /// <returns>Returns the loaded asset metadata, or <c>null</c> if no loader matched.</returns>
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
index 847e2ce1..3f7188da 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
@@ -25,9 +25,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, onLoadingFirstAsset, onAssetLoaded, aggressiveMemoryOptimizations) { }
 
         /// <inheritdoc />
-        public override T Load<T>(IAssetName assetName, LanguageCode language, bool useCache)
+        public override T LoadExact<T>(IAssetName assetName, bool useCache)
         {
-            T data = base.Load<T>(assetName, language, useCache);
+            T data = base.LoadExact<T>(assetName, useCache);
 
             if (data is Texture2D texture)
                 texture.Tag = this.Tag;
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index 6d71472f..4de9a8c3 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -32,12 +32,17 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="assetName">The normalized asset name.</param>
         bool DoesAssetExist(IAssetName assetName);
 
-        /// <summary>Load an asset that has been processed by the content pipeline.</summary>
+        /// <summary>Load an asset through the content pipeline, using a localized variant of the <paramref name="assetName"/> if available.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
-        /// <param name="language">The language code for which to load content.</param>
         /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
-        T Load<T>(IAssetName assetName, LocalizedContentManager.LanguageCode language, bool useCache);
+        T LoadLocalized<T>(IAssetName assetName, LocalizedContentManager.LanguageCode language, bool useCache);
+
+        /// <summary>Load an asset through the content pipeline, using the exact asset name without checking for localized variants.</summary>
+        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
+        T LoadExact<T>(IAssetName assetName, bool useCache);
 
         /// <summary>Assert that the given key has a valid format and return a normalized form consistent with the underlying cache.</summary>
         /// <param name="assetName">The asset key to check.</param>
@@ -53,8 +58,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Get whether the content manager has already loaded and cached the given asset.</summary>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
-        /// <param name="language">The language.</param>
-        bool IsLoaded(IAssetName assetName, LocalizedContentManager.LanguageCode language);
+        bool IsLoaded(IAssetName assetName);
 
         /// <summary>Purge matched assets from the cache.</summary>
         /// <param name="predicate">Matches the asset keys to invalidate.</param>
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 90836fcf..375b5e0e 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -61,6 +61,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.GameContentManager = gameContentManager;
             this.JsonHelper = jsonHelper;
             this.ModName = modName;
+
+            this.TryLocalizeKeys = false;
         }
 
         /// <inheritdoc />
@@ -80,14 +82,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public override T Load<T>(string assetName, LanguageCode language)
-        {
-            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
-            return this.Load<T>(parsedName, language, useCache: false);
-        }
-
-        /// <inheritdoc />
-        public override T Load<T>(IAssetName assetName, LanguageCode language, bool useCache)
+        public override T LoadExact<T>(IAssetName assetName, bool useCache)
         {
             // disable caching
             // This is necessary to avoid assets being shared between content managers, which can
@@ -97,11 +92,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
             if (useCache)
                 throw new InvalidOperationException("Mod content managers don't support asset caching.");
 
-            // disable language handling
-            // Mod files don't support automatic translation logic, so this should never happen.
-            if (language != this.DefaultLanguage)
-                throw new InvalidOperationException("Localized assets aren't supported by the mod content manager.");
-
             // resolve managed asset key
             {
                 if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
@@ -130,14 +120,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         {
                             // the underlying content manager adds a .xnb extension implicitly, so
                             // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
-                            string loadName = assetName.Name[..^".xnb".Length];
+                            IAssetName loadName = this.Coordinator.ParseAssetName(assetName.Name[..^".xnb".Length]);
 
                             // load asset
                             asset = this.RawLoad<T>(loadName, useCache: false);
                             if (asset is Map map)
                             {
-                                map.assetPath = loadName;
-                                this.FixTilesheetPaths(map, relativeMapPath: loadName, fixEagerPathPrefixes: true);
+                                map.assetPath = loadName.Name;
+                                this.FixTilesheetPaths(map, relativeMapPath: loadName.Name, fixEagerPathPrefixes: true);
                             }
                         }
                         break;
@@ -201,16 +191,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // track & return asset
-            this.TrackAsset(assetName, asset, language, useCache);
+            this.TrackAsset(assetName, asset, useCache);
             return asset;
         }
 
-        /// <inheritdoc />
-        public override bool IsLoaded(IAssetName assetName, LanguageCode language)
-        {
-            return this.Cache.ContainsKey(assetName.Name);
-        }
-
         /// <inheritdoc />
         public override LocalizedContentManager CreateTemporary()
         {
@@ -371,7 +355,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             IAssetName contentKey = this.Coordinator.ParseAssetName(this.GetContentKeyForTilesheetImageSource(relativePath));
             try
             {
-                this.GameContentManager.Load<Texture2D>(contentKey, this.Language, useCache: true); // no need to bypass cache here, since we're not storing the asset
+                this.GameContentManager.LoadLocalized<Texture2D>(contentKey, this.GameContentManager.Language, useCache: true); // no need to bypass cache here, since we're not storing the asset
                 assetName = contentKey;
                 return true;
             }
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 4e522c8d..3416c286 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -88,10 +88,10 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 switch (source)
                 {
                     case ContentSource.GameContent:
-                        return this.GameContentManager.Load<T>(assetName, this.CurrentLocaleConstant, useCache: false);
+                        return this.GameContentManager.LoadLocalized<T>(assetName, this.CurrentLocaleConstant, useCache: false);
 
                     case ContentSource.ModFolder:
-                        return this.ModContentManager.Load<T>(assetName, Constants.DefaultLanguage, useCache: false);
+                        return this.ModContentManager.LoadExact<T>(assetName, useCache: false);
 
                     default:
                         throw new SContentLoadException($"{this.ModName} failed loading content asset '{key}' from {source}: unknown content source '{source}'.");

From 8d704153762fa73416a3ccb44ee71032952802eb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 15:02:11 -0400
Subject: [PATCH 479/856] add deprecation notices for SMAPI 4.0.0 (#766)

---
 docs/release-notes.md                         | 37 ++++++++-----------
 src/SMAPI/Constants.cs                        | 17 ++++++++-
 src/SMAPI/Framework/Content/AssetInfo.cs      | 23 +++++++++++-
 .../Framework/ModHelpers/ContentHelper.cs     | 34 +++++++++++++++--
 src/SMAPI/Framework/SCore.cs                  | 19 ++++++++++
 src/SMAPI/IAssetInfo.cs                       |  1 +
 6 files changed, 103 insertions(+), 28 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 98392c17..464049b9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,37 +3,32 @@
 # Release notes
 ## Upcoming release
 * For players:
-  * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
-  * Fixed `player_add` console command's handling of Journal Scraps and Secret Notes.
-  * Fixed `set_farm_type` console command not updating warps if they moved.
-  * Improved [command-line arguments](technical/smapi.md#command-line-arguments) on Linux/macOS:
+  * Fixed support for `_international` content assets (used in the movie theater).
+  * Fixed the warning text when a mod causes an asset load conflict with itself.
+  * Improved Linux/macOS [command-line arguments](technical/smapi.md#command-line-arguments):
     * Added `--use-current-shell` to avoid opening a separate terminal window.
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
-  * Fixed warning text when a mod causes an asset load conflict with itself.
-  * Fixed support for `_international` content assets (used in the movie theater).
+  * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
+
+* For the Console Commands mod:
+  * Fixed `player_add` not handling journal scraps and secret notes correctly.
+  * Fixed `set_farm_type` not updating warps.
 
 * For mod authors:
-  * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
-    _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has been changed._
-  * Overhauled [mod-provided APIs](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) (thanks to Shockah!).  
-    _This adds support for many previously-unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more._
+  * **Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.**  
+    _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
+  * **Overhauled [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying** (thanks to Shockah!).  
+    _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
+  * **Deprecation warning:** The upcoming SMAPI 4.0 will remove deprecated APIs and break mods which haven't updated yet.  
+    _See [_Migrate to SMAPI 4.0_](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0) for help updating your mod code. You can update your mod code now, there's no need to wait for the 4.0.0 release (which will happen in at least three months, and possibly later if needed to update open-source mods)._
   * Added `Constants.ContentPath`.
-  * Added `IAssetName Name` field to the info received by `IAssetEditor` and `IAssetLoader` methods.  
+  * Added `IAssetName` fields to the info received by `IAssetEditor` and `IAssetLoader` methods.  
     _This adds methods for working with asset names, parsed locales, etc._
-  * If an asset is loaded multiple times in the same tick, `IAssetLoader.CanLoad` and `IAssetEditor.CanEdit` are now cached unless invalidated via `helper.Content.InvalidateCache`.
+  * If an asset is loaded multiple times in the same tick, `IAssetLoader.CanLoad` and `IAssetEditor.CanEdit` are now cached unless invalidated by `helper.Content.InvalidateCache`.
   * Fixed the `SDate` constructor being case-sensitive.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
 
-* **Deprecation warning for mod authors:**   
-  These APIs are now deprecated and will be removed in the upcoming SMAPI 4.0.0.
-
-  API | how to update code
-  :-- | :-----------------
-  `Constants.ExecutionPath` | Use `Constants.GamePath` instead.
-  `IAssetInfo.AssetName`<br />`IAssetData.AssetName` | Use `Name` instead, which changes the type from `string` to the new `AssetName`.
-  `IAssetInfo.AssetNameEquals`<br />`IAssetData.AssetNameEquals` | Use `Name.IsEquivalentTo` instead.
-
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.25.0.
   * Added `data-*` attributes to log parser page for external tools.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index b736ca59..3351e5c4 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -77,8 +77,21 @@ namespace StardewModdingAPI
         public static GameFramework GameFramework { get; } = EarlyConstants.GameFramework;
 
         /// <summary>The path to the game folder.</summary>
-        [Obsolete($"Use {nameof(GamePath)} instead.")]
-        public static string ExecutionPath => Constants.GamePath;
+        [Obsolete($"Use {nameof(Constants)}.{nameof(GamePath)} instead.")]
+        public static string ExecutionPath
+        {
+            get
+            {
+                SCore.DeprecationManager.Warn(
+                    source: SCore.DeprecationManager.GetSourceNameFromStack(),
+                    nounPhrase: $"{nameof(Constants)}.{nameof(Constants.ExecutionPath)}",
+                    version: "3.14.0",
+                    severity: DeprecationLevel.Notice
+                );
+
+                return Constants.GamePath;
+            }
+        }
 
         /// <summary>The path to the game folder.</summary>
         public static string GamePath { get; } = EarlyConstants.GamePath;
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 556f1c2a..6e93c33c 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -27,7 +27,20 @@ namespace StardewModdingAPI.Framework.Content
 
         /// <inheritdoc />
         [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead.")]
-        public string AssetName => this.NameWithoutLocale.Name;
+        public string AssetName
+        {
+            get
+            {
+                SCore.DeprecationManager.Warn(
+                    source: SCore.DeprecationManager.GetSourceNameFromStack(),
+                    nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetName)}",
+                    version: "3.14.0",
+                    severity: DeprecationLevel.Notice
+                );
+
+                return this.NameWithoutLocale.Name;
+            }
+        }
 
         /// <inheritdoc />
         public Type DataType { get; }
@@ -54,6 +67,14 @@ namespace StardewModdingAPI.Framework.Content
         [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
         public bool AssetNameEquals(string path)
         {
+            SCore.DeprecationManager.Warn(
+                source: SCore.DeprecationManager.GetSourceNameFromStack(),
+                nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetNameEquals)}",
+                version: "3.14.0",
+                severity: DeprecationLevel.Notice
+            );
+
+
             return this.NameWithoutLocale.IsEquivalentTo(path);
         }
 
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 3416c286..3727b909 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -44,16 +44,42 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public LocalizedContentManager.LanguageCode CurrentLocaleConstant => this.GameContentManager.Language;
 
         /// <summary>The observable implementation of <see cref="AssetEditors"/>.</summary>
-        internal ObservableCollection<IAssetEditor> ObservableAssetEditors { get; } = new ObservableCollection<IAssetEditor>();
+        internal ObservableCollection<IAssetEditor> ObservableAssetEditors { get; } = new();
 
         /// <summary>The observable implementation of <see cref="AssetLoaders"/>.</summary>
-        internal ObservableCollection<IAssetLoader> ObservableAssetLoaders { get; } = new ObservableCollection<IAssetLoader>();
+        internal ObservableCollection<IAssetLoader> ObservableAssetLoaders { get; } = new();
 
         /// <inheritdoc />
-        public IList<IAssetLoader> AssetLoaders => this.ObservableAssetLoaders;
+        public IList<IAssetLoader> AssetLoaders
+        {
+            get
+            {
+                SCore.DeprecationManager.Warn(
+                    source: this.ModName,
+                    nounPhrase: $"{nameof(IContentHelper)}.{nameof(IContentHelper.AssetLoaders)}",
+                    version: "3.14.0",
+                    severity: DeprecationLevel.Notice
+                );
+
+                return this.ObservableAssetLoaders;
+            }
+        }
 
         /// <inheritdoc />
-        public IList<IAssetEditor> AssetEditors => this.ObservableAssetEditors;
+        public IList<IAssetEditor> AssetEditors
+        {
+            get
+            {
+                SCore.DeprecationManager.Warn(
+                    source: this.ModName,
+                    nounPhrase: $"{nameof(IContentHelper)}.{nameof(IContentHelper.AssetEditors)}",
+                    version: "3.14.0",
+                    severity: DeprecationLevel.Notice
+                );
+
+                return this.ObservableAssetEditors;
+            }
+        }
 
 
         /*********
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index dd952dee..eab977ac 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1609,9 +1609,28 @@ namespace StardewModdingAPI.Framework
                 {
                     // ReSharper disable SuspiciousTypeConversion.Global
                     if (metadata.Mod is IAssetEditor editor)
+                    {
+                        SCore.DeprecationManager.Warn(
+                            source: metadata.DisplayName,
+                            nounPhrase: $"{nameof(IAssetEditor)}",
+                            version: "3.14.0",
+                            severity: DeprecationLevel.Notice
+                        );
+
                         this.ContentCore.Editors.Add(new ModLinked<IAssetEditor>(metadata, editor));
+                    }
+
                     if (metadata.Mod is IAssetLoader loader)
+                    {
+                        SCore.DeprecationManager.Warn(
+                            source: metadata.DisplayName,
+                            nounPhrase: $"{nameof(IAssetLoader)}",
+                            version: "3.14.0",
+                            severity: DeprecationLevel.Notice
+                        );
+
                         this.ContentCore.Loaders.Add(new ModLinked<IAssetLoader>(metadata, loader));
+                    }
                     // ReSharper restore SuspiciousTypeConversion.Global
 
                     helper.ObservableAssetEditors.CollectionChanged += (sender, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetEditor>(), e.OldItems?.Cast<IAssetEditor>(), this.ContentCore.Editors);
diff --git a/src/SMAPI/IAssetInfo.cs b/src/SMAPI/IAssetInfo.cs
index c7b2ab62..c3753b97 100644
--- a/src/SMAPI/IAssetInfo.cs
+++ b/src/SMAPI/IAssetInfo.cs
@@ -12,6 +12,7 @@ namespace StardewModdingAPI
         string Locale { get; }
 
         /// <summary>The asset name being read.</summary>
+        /// <remarks>NOTE: when reading this field from an <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> implementation, it's always equivalent to <see cref="NameWithoutLocale"/> for backwards compatibility.</remarks>
         public IAssetName Name { get; }
 
         /// <summary>The <see cref="Name"/> with any locale codes stripped.</summary>

From 3a9ea66a20136400d3268ea2e314eacd40d06231 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 17:37:01 -0400
Subject: [PATCH 480/856] update asset propagation for new content API (#766)

---
 src/SMAPI/Framework/ContentCoordinator.cs     |  5 +-
 .../ContentManagers/BaseContentManager.cs     | 11 +--
 .../ContentManagers/GameContentManager.cs     | 29 ------
 .../ContentManagers/IContentManager.cs        |  3 -
 src/SMAPI/Metadata/CoreAssetPropagator.cs     | 98 ++++++++++++-------
 5 files changed, 66 insertions(+), 80 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index a4d29068..ee8b6893 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -230,12 +230,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>Perform any updates needed when the locale changes.</summary>
         public void OnLocaleChanged()
         {
-            // reload affected content
+            // reset baseline cache
             this.ContentManagerLock.InReadLock(() =>
             {
-                foreach (IContentManager contentManager in this.ContentManagers)
-                    contentManager.OnLocaleChanged();
-
                 this.VanillaContentManager.Unload();
             });
         }
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index b1ace259..1ca84792 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -137,16 +137,18 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
                 try
                 {
-                    this.LoadExact<T>(localizedName, useCache: useCache);
+                    T data = this.LoadExact<T>(localizedName, useCache: useCache);
                     LocalizedContentManager.localizedAssetNames[assetName.Name] = localizedName.Name;
+                    return data;
                 }
                 catch (ContentLoadException)
                 {
                     localizedName = new AssetName(assetName.BaseName + "_international", null, null);
                     try
                     {
-                        this.LoadExact<T>(localizedName, useCache: useCache);
+                        T data = this.LoadExact<T>(localizedName, useCache: useCache);
                         LocalizedContentManager.localizedAssetNames[assetName.Name] = localizedName.Name;
+                        return data;
                     }
                     catch (ContentLoadException)
                     {
@@ -158,16 +160,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // use cached key
             string rawName = LocalizedContentManager.localizedAssetNames[assetName.Name];
             if (assetName.Name != rawName)
-                assetName = this.Coordinator.ParseAssetName(assetName.Name);
+                assetName = this.Coordinator.ParseAssetName(rawName);
             return this.LoadExact<T>(assetName, useCache: useCache);
         }
 
         /// <inheritdoc />
         public abstract T LoadExact<T>(IAssetName assetName, bool useCache);
 
-        /// <inheritdoc />
-        public virtual void OnLocaleChanged() { }
-
         /// <inheritdoc />
         [SuppressMessage("ReSharper", "ParameterOnlyUsedForPreconditionCheck.Local", Justification = "Parameter is only used for assertion checks by design.")]
         public string AssertAndNormalizeAssetName(string assetName)
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 500c0191..0fcad30a 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -25,9 +25,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>The assets currently being intercepted by <see cref="IAssetLoader"/> instances. This is used to prevent infinite loops when a loader loads a new asset.</summary>
         private readonly ContextHash<string> AssetsBeingLoaded = new();
 
-        /// <summary>Maps asset names to their localized form, like <c>LooseSprites\Billboard => LooseSprites\Billboard.fr-FR</c> (localized) or <c>Maps\AnimalShop => Maps\AnimalShop</c> (not localized).</summary>
-        private IDictionary<string, string> LocalizedAssetNames => LocalizedContentManager.localizedAssetNames;
-
         /// <summary>Whether the next load is the first for any game content manager.</summary>
         private static bool IsFirstLoad = true;
 
@@ -139,32 +136,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return data;
         }
 
-        /// <inheritdoc />
-        public override void OnLocaleChanged()
-        {
-            base.OnLocaleChanged();
-
-            // find assets for which a translatable version was loaded
-            HashSet<string> removeAssetNames = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
-            foreach (string key in this.LocalizedAssetNames.Where(p => p.Key != p.Value).Select(p => p.Key))
-            {
-                IAssetName assetName = this.Coordinator.ParseAssetName(key);
-                removeAssetNames.Add(assetName.BaseName);
-            }
-
-            // invalidate translatable assets
-            string[] invalidated = this
-                .InvalidateCache((key, _) =>
-                    removeAssetNames.Contains(key)
-                    || removeAssetNames.Contains(this.Coordinator.ParseAssetName(key).BaseName)
-                )
-                .Select(p => p.Key)
-                .OrderBy(p => p, StringComparer.OrdinalIgnoreCase)
-                .ToArray();
-            if (invalidated.Any())
-                this.Monitor.Log($"Invalidated {invalidated.Length} asset names: {string.Join(", ", invalidated)} for locale change.");
-        }
-
         /// <inheritdoc />
         public override LocalizedContentManager CreateTemporary()
         {
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index 4de9a8c3..774b20d9 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -65,8 +65,5 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
         /// <returns>Returns the invalidated asset names and instances.</returns>
         IDictionary<string, object> InvalidateCache(Func<string, Type, bool> predicate, bool dispose = false);
-
-        /// <summary>Perform any cleanup needed when the locale changes.</summary>
-        void OnLocaleChanged();
     }
 }
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index f645470e..832148aa 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -89,6 +89,14 @@ namespace StardewModdingAPI.Metadata
         /// <param name="updatedNpcWarps">Whether the NPC pathfinding cache was reloaded.</param>
         public void Propagate(IDictionary<IAssetName, Type> assets, bool ignoreWorld, out IDictionary<IAssetName, bool> propagatedAssets, out bool updatedNpcWarps)
         {
+            // get base name lookup
+            propagatedAssets = assets
+                .Select(asset => asset.Key.GetBaseAssetName())
+                .Distinct()
+                .ToDictionary(name => name, _ => false);
+
+            this.Monitor.Log($"Propagating: {propagatedAssets.Keys.OrderBy(p => p.Name, StringComparer.OrdinalIgnoreCase)}", LogLevel.Alert);
+
             // group into optimized lists
             var buckets = assets.GroupBy(p =>
             {
@@ -102,7 +110,6 @@ namespace StardewModdingAPI.Metadata
             });
 
             // reload assets
-            propagatedAssets = assets.ToDictionary(p => p.Key, _ => false);
             updatedNpcWarps = false;
             foreach (var bucket in buckets)
             {
@@ -110,12 +117,12 @@ namespace StardewModdingAPI.Metadata
                 {
                     case AssetBucket.Sprite:
                         if (!ignoreWorld)
-                            this.ReloadNpcSprites(bucket.Select(p => p.Key), propagatedAssets);
+                            this.ReloadNpcSprites(propagatedAssets);
                         break;
 
                     case AssetBucket.Portrait:
                         if (!ignoreWorld)
-                            this.ReloadNpcPortraits(bucket.Select(p => p.Key), propagatedAssets);
+                            this.ReloadNpcPortraits(propagatedAssets);
                         break;
 
                     default:
@@ -158,7 +165,7 @@ namespace StardewModdingAPI.Metadata
         private bool PropagateOther(IAssetName assetName, Type type, bool ignoreWorld, out bool changedWarps)
         {
             var content = this.MainContentManager;
-            string key = assetName.Name;
+            string key = assetName.BaseName;
             changedWarps = false;
 
             /****
@@ -170,7 +177,7 @@ namespace StardewModdingAPI.Metadata
             {
                 foreach (TileSheet tilesheet in Game1.currentLocation.map.TileSheets)
                 {
-                    if (assetName.IsEquivalentTo(tilesheet.ImageSource))
+                    if (this.IsSameBaseName(assetName, tilesheet.ImageSource))
                         Game1.mapDisplayDevice.LoadTileSheet(tilesheet);
                 }
             }
@@ -188,7 +195,7 @@ namespace StardewModdingAPI.Metadata
                     {
                         GameLocation location = info.Location;
 
-                        if (assetName.IsEquivalentTo(location.mapPath.Value))
+                        if (this.IsSameBaseName(assetName, location.mapPath.Value))
                         {
                             static ISet<string> GetWarpSet(GameLocation location)
                             {
@@ -213,7 +220,7 @@ namespace StardewModdingAPI.Metadata
             /****
             ** Propagate by key
             ****/
-            switch (assetName.Name.ToLower().Replace("\\", "/")) // normalized key so we can compare statically
+            switch (assetName.BaseName.ToLower().Replace("\\", "/")) // normalized key so we can compare statically
             {
                 /****
                 ** Animals
@@ -624,7 +631,7 @@ namespace StardewModdingAPI.Metadata
         {
             if (Game1.activeClickableMenu is TitleMenu titleMenu)
             {
-                Texture2D texture = content.Load<Texture2D>(assetName.Name);
+                Texture2D texture = content.Load<Texture2D>(assetName.BaseName);
 
                 titleMenu.titleButtonsTexture = texture;
                 titleMenu.backButton.texture = texture;
@@ -652,13 +659,13 @@ namespace StardewModdingAPI.Metadata
             // find matches
             TAnimal[] animals = this.GetCharacters()
                 .OfType<TAnimal>()
-                .Where(p => assetName.IsEquivalentTo(p.Sprite?.Texture?.Name))
+                .Where(p => this.IsSameBaseName(assetName, p.Sprite?.Texture?.Name))
                 .ToArray();
             if (!animals.Any())
                 return false;
 
             // update sprites
-            Texture2D texture = content.Load<Texture2D>(assetName.Name);
+            Texture2D texture = content.Load<Texture2D>(assetName.BaseName);
             foreach (TAnimal animal in animals)
                 animal.Sprite.spriteTexture = texture;
             return true;
@@ -677,7 +684,7 @@ namespace StardewModdingAPI.Metadata
                 return false;
 
             // update sprites
-            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
+            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
             foreach (FarmAnimal animal in animals)
             {
                 // get expected key
@@ -689,7 +696,7 @@ namespace StardewModdingAPI.Metadata
                 expectedKey = $"Animals/{expectedKey}";
 
                 // reload asset
-                if (assetName.IsEquivalentTo(expectedKey))
+                if (this.IsSameBaseName(assetName, expectedKey))
                     animal.Sprite.spriteTexture = texture.Value;
             }
             return texture.IsValueCreated;
@@ -705,7 +712,7 @@ namespace StardewModdingAPI.Metadata
             bool isPaintMask = assetName.BaseName.EndsWith(paintMaskSuffix, StringComparison.OrdinalIgnoreCase);
 
             // get building type
-            string type = Path.GetFileName(assetName.Name)!;
+            string type = Path.GetFileName(assetName.BaseName)!;
             if (isPaintMask)
                 type = type.Substring(0, type.Length - paintMaskSuffix.Length);
 
@@ -738,7 +745,7 @@ namespace StardewModdingAPI.Metadata
         /// <returns>Returns whether any textures were reloaded.</returns>
         private bool ReloadChairTiles(LocalizedContentManager content, IAssetName assetName, bool ignoreWorld)
         {
-            MapSeat.mapChairTexture = content.Load<Texture2D>(assetName.Name);
+            MapSeat.mapChairTexture = content.Load<Texture2D>(assetName.BaseName);
 
             if (!ignoreWorld)
             {
@@ -746,7 +753,7 @@ namespace StardewModdingAPI.Metadata
                 {
                     foreach (MapSeat seat in location.mapSeats.Where(p => p != null))
                     {
-                        if (assetName.IsEquivalentTo(seat._loadedTextureFile))
+                        if (this.IsSameBaseName(assetName, seat._loadedTextureFile))
                             seat.overlayTexture = MapSeat.mapChairTexture;
                     }
                 }
@@ -767,7 +774,7 @@ namespace StardewModdingAPI.Metadata
                     from location in this.GetLocations()
                     where location.critters != null
                     from Critter critter in location.critters
-                    where assetName.IsEquivalentTo(critter.sprite?.Texture?.Name)
+                    where this.IsSameBaseName(assetName, critter.sprite?.Texture?.Name)
                     select critter
                 )
                 .ToArray();
@@ -775,7 +782,7 @@ namespace StardewModdingAPI.Metadata
                 return 0;
 
             // update sprites
-            Texture2D texture = content.Load<Texture2D>(assetName.Name);
+            Texture2D texture = content.Load<Texture2D>(assetName.BaseName);
             foreach (var entry in critters)
                 entry.sprite.spriteTexture = texture;
 
@@ -788,7 +795,7 @@ namespace StardewModdingAPI.Metadata
         /// <returns>Returns whether any doors were affected.</returns>
         private bool ReloadDoorSprites(LocalizedContentManager content, IAssetName assetName)
         {
-            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
+            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
 
             foreach (GameLocation location in this.GetLocations())
             {
@@ -802,7 +809,7 @@ namespace StardewModdingAPI.Metadata
                         continue;
 
                     string curKey = this.Reflection.GetField<string>(door.Sprite, "textureName").GetValue();
-                    if (assetName.IsEquivalentTo(curKey))
+                    if (this.IsSameBaseName(assetName, curKey))
                         door.Sprite.texture = texture.Value;
                 }
             }
@@ -862,14 +869,14 @@ namespace StardewModdingAPI.Metadata
                 (
                     from location in this.GetLocations()
                     from grass in location.terrainFeatures.Values.OfType<Grass>()
-                    where assetName.IsEquivalentTo(grass.textureName())
+                    where this.IsSameBaseName(assetName, grass.textureName())
                     select grass
                 )
                 .ToArray();
 
             if (grasses.Any())
             {
-                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
+                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
                 foreach (Grass grass in grasses)
                     grass.texture = texture;
                 return true;
@@ -935,7 +942,7 @@ namespace StardewModdingAPI.Metadata
         /// <returns>Returns whether any NPCs were affected.</returns>
         private bool ReloadNpcDispositions(LocalizedContentManager content, IAssetName assetName)
         {
-            IDictionary<string, string> data = content.Load<Dictionary<string, string>>(assetName.Name);
+            IDictionary<string, string> data = content.Load<Dictionary<string, string>>(assetName.BaseName);
             bool changed = false;
             foreach (NPC npc in this.GetCharacters())
             {
@@ -950,15 +957,14 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Reload the sprites for matching NPCs.</summary>
-        /// <param name="keys">The asset keys to reload.</param>
-        /// <param name="propagated">The asset keys which have been propagated.</param>
-        private void ReloadNpcSprites(IEnumerable<IAssetName> keys, IDictionary<IAssetName, bool> propagated)
+        /// <param name="propagated">The asset keys which are being propagated.</param>
+        private void ReloadNpcSprites(IDictionary<IAssetName, bool> propagated)
         {
             // get NPCs
             var characters =
                 (
                     from npc in this.GetCharacters()
-                    let key = this.ParseAssetNameOrNull(npc.Sprite?.Texture?.Name)
+                    let key = this.ParseAssetNameOrNull(npc.Sprite?.Texture?.Name)?.GetBaseAssetName()
                     where key != null && propagated.ContainsKey(key)
                     select new { Npc = npc, AssetName = key }
                 )
@@ -969,15 +975,14 @@ namespace StardewModdingAPI.Metadata
             // update sprite
             foreach (var target in characters)
             {
-                target.Npc.Sprite.spriteTexture = this.LoadAndDisposeIfNeeded(target.Npc.Sprite.spriteTexture, target.AssetName.Name);
+                target.Npc.Sprite.spriteTexture = this.LoadAndDisposeIfNeeded(target.Npc.Sprite.spriteTexture, target.AssetName.BaseName);
                 propagated[target.AssetName] = true;
             }
         }
 
         /// <summary>Reload the portraits for matching NPCs.</summary>
-        /// <param name="keys">The asset key to reload.</param>
-        /// <param name="propagated">The asset keys which have been propagated.</param>
-        private void ReloadNpcPortraits(IEnumerable<IAssetName> keys, IDictionary<IAssetName, bool> propagated)
+        /// <param name="propagated">The asset keys which are being propagated.</param>
+        private void ReloadNpcPortraits(IDictionary<IAssetName, bool> propagated)
         {
             // get NPCs
             var characters =
@@ -985,7 +990,7 @@ namespace StardewModdingAPI.Metadata
                     from npc in this.GetCharacters()
                     where npc.isVillager()
 
-                    let key = this.ParseAssetNameOrNull(npc.Portrait?.Name)
+                    let key = this.ParseAssetNameOrNull(npc.Portrait?.Name)?.GetBaseAssetName()
                     where key != null && propagated.ContainsKey(key)
                     select new { Npc = npc, AssetName = key }
                 )
@@ -1005,7 +1010,7 @@ namespace StardewModdingAPI.Metadata
             // update portrait
             foreach (var target in characters)
             {
-                target.Npc.Portrait = this.LoadAndDisposeIfNeeded(target.Npc.Portrait, target.AssetName.Name);
+                target.Npc.Portrait = this.LoadAndDisposeIfNeeded(target.Npc.Portrait, target.AssetName.BaseName);
                 propagated[target.AssetName] = true;
             }
         }
@@ -1017,7 +1022,7 @@ namespace StardewModdingAPI.Metadata
             Farmer[] players =
                 (
                     from player in Game1.getOnlineFarmers()
-                    where assetName.IsEquivalentTo(player.getTexture())
+                    where this.IsSameBaseName(assetName, player.getTexture())
                     select player
                 )
                 .ToArray();
@@ -1037,7 +1042,7 @@ namespace StardewModdingAPI.Metadata
         /// <returns>Returns whether any textures were reloaded.</returns>
         private bool ReloadSuspensionBridges(LocalizedContentManager content, IAssetName assetName)
         {
-            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
+            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
 
             foreach (GameLocation location in this.GetLocations(buildingInteriors: false))
             {
@@ -1068,7 +1073,7 @@ namespace StardewModdingAPI.Metadata
 
             if (trees.Any())
             {
-                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.Name));
+                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
                 foreach (Tree tree in trees)
                     tree.texture = texture;
                 return true;
@@ -1086,7 +1091,7 @@ namespace StardewModdingAPI.Metadata
         private bool ReloadNpcDialogue(IAssetName assetName)
         {
             // get NPCs
-            string name = Path.GetFileName(assetName.Name);
+            string name = Path.GetFileName(assetName.BaseName);
             NPC[] villagers = this.GetCharacters().Where(npc => npc.Name == name && npc.isVillager()).ToArray();
             if (!villagers.Any())
                 return false;
@@ -1116,7 +1121,7 @@ namespace StardewModdingAPI.Metadata
         private bool ReloadNpcSchedules(IAssetName assetName)
         {
             // get NPCs
-            string name = Path.GetFileName(assetName.Name);
+            string name = Path.GetFileName(assetName.BaseName);
             NPC[] villagers = this.GetCharacters().Where(npc => npc.Name == name && npc.isVillager()).ToArray();
             if (!villagers.Any())
                 return false;
@@ -1230,6 +1235,23 @@ namespace StardewModdingAPI.Metadata
             }
         }
 
+        /// <summary>Get whether two asset names are equivalent if you ignore the locale code.</summary>
+        /// <param name="left">The first value to compare.</param>
+        /// <param name="right">The second value to compare.</param>
+        private bool IsSameBaseName(IAssetName left, string right)
+        {
+            IAssetName parsedB = this.ParseAssetNameOrNull(right);
+            return this.IsSameBaseName(left, parsedB);
+        }
+
+        /// <summary>Get whether two asset names are equivalent if you ignore the locale code.</summary>
+        /// <param name="left">The first value to compare.</param>
+        /// <param name="right">The second value to compare.</param>
+        private bool IsSameBaseName(IAssetName left, IAssetName right)
+        {
+            return left.IsEquivalentTo(right.BaseName, useBaseName: true);
+        }
+
         /// <summary>Normalize an asset key to match the cache key and assert that it's valid, but don't raise an error for null or empty values.</summary>
         /// <param name="path">The asset key to normalize.</param>
         private IAssetName ParseAssetNameOrNull(string path)
@@ -1281,7 +1303,7 @@ namespace StardewModdingAPI.Metadata
                 BuildingPainter.paintMaskLookup = new Dictionary<string, List<List<int>>>(BuildingPainter.paintMaskLookup, StringComparer.OrdinalIgnoreCase);
 
             // remove key from cache
-            return BuildingPainter.paintMaskLookup.Remove(assetName.Name);
+            return BuildingPainter.paintMaskLookup.Remove(assetName.BaseName);
         }
 
         /// <summary>Metadata about a location used in asset propagation.</summary>

From bacb851d7b186946ba1ead1caeab72e7604cfe6b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 17:44:48 -0400
Subject: [PATCH 481/856] add IContentHelper.ParseAssetName (#766)

---
 docs/release-notes.md                           | 1 +
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs | 6 ++++++
 src/SMAPI/IContentHelper.cs                     | 6 ++++++
 3 files changed, 13 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 464049b9..99ac86df 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -24,6 +24,7 @@
   * Added `Constants.ContentPath`.
   * Added `IAssetName` fields to the info received by `IAssetEditor` and `IAssetLoader` methods.  
     _This adds methods for working with asset names, parsed locales, etc._
+  * Added `helper.Content.ParseAssetName` to get an `IAssetName` for an arbitrary asset key.
   * If an asset is loaded multiple times in the same tick, `IAssetLoader.CanLoad` and `IAssetEditor.CanEdit` are now cached unless invalidated by `helper.Content.InvalidateCache`.
   * Fixed the `SDate` constructor being case-sensitive.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 3727b909..5d58ee26 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -103,6 +103,12 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.Monitor = monitor;
         }
 
+        /// <inheritdoc />
+        public IAssetName ParseAssetName(string rawName)
+        {
+            return this.ContentCore.ParseAssetName(rawName);
+        }
+
         /// <inheritdoc />
         public T Load<T>(string key, ContentSource source = ContentSource.ModFolder)
         {
diff --git a/src/SMAPI/IContentHelper.cs b/src/SMAPI/IContentHelper.cs
index 207b4a33..6fcd18cd 100644
--- a/src/SMAPI/IContentHelper.cs
+++ b/src/SMAPI/IContentHelper.cs
@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Diagnostics.Contracts;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework.Content;
 using StardewValley;
 using xTile;
 
@@ -30,6 +31,11 @@ namespace StardewModdingAPI
         /*********
         ** Public methods
         *********/
+        /// <summary>Parse a raw asset name.</summary>
+        /// <param name="rawName">The raw asset name to parse.</param>
+        /// <exception cref="ArgumentException">The <paramref name="rawName"/> is null or empty.</exception>
+        IAssetName ParseAssetName(string rawName);
+
         /// <summary>Load content from the game folder or mod folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
         /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="key">The asset key to fetch (if the <paramref name="source"/> is <see cref="ContentSource.GameContent"/>), or the local path to a content file relative to the mod folder.</param>

From 5683bc9c7d91d2f47b9145dbb79d78d075c03307 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 17:46:10 -0400
Subject: [PATCH 482/856] give Content Patcher internals access

This makes some of its low-level logic safer by avoiding unvalidated reflection.
---
 src/SMAPI/Properties/AssemblyInfo.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/SMAPI/Properties/AssemblyInfo.cs b/src/SMAPI/Properties/AssemblyInfo.cs
index ee8a1674..daa58943 100644
--- a/src/SMAPI/Properties/AssemblyInfo.cs
+++ b/src/SMAPI/Properties/AssemblyInfo.cs
@@ -2,3 +2,4 @@ using System.Runtime.CompilerServices;
 
 [assembly: InternalsVisibleTo("SMAPI.Tests")]
 [assembly: InternalsVisibleTo("DynamicProxyGenAssembly2")] // Moq for unit testing
+[assembly: InternalsVisibleTo("ContentPatcher")]

From eebd8d54dc068cff2b5127a4b8f03d0b54b89542 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 18:34:49 -0400
Subject: [PATCH 483/856] expand obsolete attributes (#766)

---
 src/SMAPI/Constants.cs                   | 2 +-
 src/SMAPI/Framework/Content/AssetInfo.cs | 4 ++--
 src/SMAPI/GameFramework.cs               | 2 +-
 src/SMAPI/IAssetEditor.cs                | 6 +++++-
 src/SMAPI/IAssetInfo.cs                  | 4 ++--
 src/SMAPI/IAssetLoader.cs                | 6 +++++-
 src/SMAPI/ICommandHelper.cs              | 2 +-
 7 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 3351e5c4..76f4ef87 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -77,7 +77,7 @@ namespace StardewModdingAPI
         public static GameFramework GameFramework { get; } = EarlyConstants.GameFramework;
 
         /// <summary>The path to the game folder.</summary>
-        [Obsolete($"Use {nameof(Constants)}.{nameof(GamePath)} instead.")]
+        [Obsolete($"Use {nameof(Constants)}.{nameof(GamePath)} instead. This property will be removed in SMAPI 4.0.0.")]
         public static string ExecutionPath
         {
             get
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 6e93c33c..f5da5d69 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -26,7 +26,7 @@ namespace StardewModdingAPI.Framework.Content
         public IAssetName NameWithoutLocale { get; }
 
         /// <inheritdoc />
-        [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead.")]
+        [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead. This property will be removed in SMAPI 4.0.0.")]
         public string AssetName
         {
             get
@@ -64,7 +64,7 @@ namespace StardewModdingAPI.Framework.Content
         }
 
         /// <inheritdoc />
-        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
+        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead. This method will be removed in SMAPI 4.0.0.")]
         public bool AssetNameEquals(string path)
         {
             SCore.DeprecationManager.Warn(
diff --git a/src/SMAPI/GameFramework.cs b/src/SMAPI/GameFramework.cs
index a0154329..60fbe56e 100644
--- a/src/SMAPI/GameFramework.cs
+++ b/src/SMAPI/GameFramework.cs
@@ -6,7 +6,7 @@ namespace StardewModdingAPI
     public enum GameFramework
     {
         /// <summary>The XNA Framework, previously used on Windows.</summary>
-        [Obsolete("Stardew Valley no longer uses XNA Framework on any supported platform.")]
+        [Obsolete("Stardew Valley no longer uses XNA Framework on any supported platform.  This value will be removed in SMAPI 4.0.0.")]
         Xna,
 
         /// <summary>The MonoGame framework.</summary>
diff --git a/src/SMAPI/IAssetEditor.cs b/src/SMAPI/IAssetEditor.cs
index d2c6f295..9f22ed83 100644
--- a/src/SMAPI/IAssetEditor.cs
+++ b/src/SMAPI/IAssetEditor.cs
@@ -1,6 +1,10 @@
-namespace StardewModdingAPI
+using System;
+using StardewModdingAPI.Events;
+
+namespace StardewModdingAPI
 {
     /// <summary>Edits matching content assets.</summary>
+    [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.Events)}.{nameof(IModEvents.Content)} instead. This interface will be removed in SMAPI 4.0.0.")]
     public interface IAssetEditor
     {
         /*********
diff --git a/src/SMAPI/IAssetInfo.cs b/src/SMAPI/IAssetInfo.cs
index c3753b97..64d10b35 100644
--- a/src/SMAPI/IAssetInfo.cs
+++ b/src/SMAPI/IAssetInfo.cs
@@ -20,7 +20,7 @@ namespace StardewModdingAPI
         public IAssetName NameWithoutLocale { get; }
 
         /// <summary>The normalized asset name being read. The format may change between platforms; see <see cref="AssetNameEquals"/> to compare with a known path.</summary>
-        [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead.")]
+        [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead. This property will be removed in SMAPI 4.0.0.")]
         string AssetName { get; }
 
         /// <summary>The content data type.</summary>
@@ -32,7 +32,7 @@ namespace StardewModdingAPI
         *********/
         /// <summary>Get whether the asset name being loaded matches a given name after normalization.</summary>
         /// <param name="path">The expected asset path, relative to the game's content folder and without the .xnb extension or locale suffix (like 'Data\ObjectInformation').</param>
-        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead.")]
+        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead. This method will be removed in SMAPI 4.0.0.")]
         bool AssetNameEquals(string path);
     }
 }
diff --git a/src/SMAPI/IAssetLoader.cs b/src/SMAPI/IAssetLoader.cs
index ad97b941..96b98793 100644
--- a/src/SMAPI/IAssetLoader.cs
+++ b/src/SMAPI/IAssetLoader.cs
@@ -1,6 +1,10 @@
-namespace StardewModdingAPI
+using System;
+using StardewModdingAPI.Events;
+
+namespace StardewModdingAPI
 {
     /// <summary>Provides the initial version for matching assets loaded by the game. SMAPI will raise an error if two mods try to load the same asset; in most cases you should use <see cref="IAssetEditor"/> instead.</summary>
+    [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.Events)}.{nameof(IModEvents.Content)} instead. This interface will be removed in SMAPI 4.0.0.")]
     public interface IAssetLoader
     {
         /*********
diff --git a/src/SMAPI/ICommandHelper.cs b/src/SMAPI/ICommandHelper.cs
index b92e5162..9f1c345c 100644
--- a/src/SMAPI/ICommandHelper.cs
+++ b/src/SMAPI/ICommandHelper.cs
@@ -21,7 +21,7 @@ namespace StardewModdingAPI
         /// <param name="name">The command name.</param>
         /// <param name="arguments">The command arguments.</param>
         /// <returns>Returns whether a matching command was triggered.</returns>
-        [Obsolete("Manually triggering console commands will no longer be supported in SMAPI 4.0.0.")]
+        [Obsolete("Use mod-provided APIs to integrate with mods instead. This method will be removed in SMAPI 4.0.0.")]
         bool Trigger(string name, string[] arguments);
     }
 }

From 03efea26676464933513383eb1c841f1ca5db34d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 26 Mar 2022 19:08:25 -0400
Subject: [PATCH 484/856] add LocaleChanged content event (#766)

---
 src/SMAPI/Events/IContentEvents.cs            |  4 ++
 src/SMAPI/Events/LocaleChangedEventArgs.cs    | 45 ++++++++++++++
 src/SMAPI/Framework/Events/EventManager.cs    |  4 ++
 .../Framework/Events/ModContentEvents.cs      |  7 +++
 src/SMAPI/Framework/SCore.cs                  | 62 ++++++++++++-------
 5 files changed, 100 insertions(+), 22 deletions(-)
 create mode 100644 src/SMAPI/Events/LocaleChangedEventArgs.cs

diff --git a/src/SMAPI/Events/IContentEvents.cs b/src/SMAPI/Events/IContentEvents.cs
index abbaaf33..d537db70 100644
--- a/src/SMAPI/Events/IContentEvents.cs
+++ b/src/SMAPI/Events/IContentEvents.cs
@@ -19,5 +19,9 @@ namespace StardewModdingAPI.Events
         /// <summary>Raised after an asset is loaded by the content pipeline, after all mod edits specified via <see cref="AssetRequested"/> have been applied.</summary>
         /// <remarks>This event is only raised if something requested the asset from the content pipeline. Invalidating an asset from the content cache won't necessarily reload it automatically.</remarks>
         event EventHandler<AssetReadyEventArgs> AssetReady;
+
+        /// <summary>Raised after the game language changes.</summary>
+        /// <remarks>For non-English players, this may be raised during startup when the game switches to the previously selected language.</remarks>
+        event EventHandler<LocaleChangedEventArgs> LocaleChanged;
     }
 }
diff --git a/src/SMAPI/Events/LocaleChangedEventArgs.cs b/src/SMAPI/Events/LocaleChangedEventArgs.cs
new file mode 100644
index 00000000..09d3f6e5
--- /dev/null
+++ b/src/SMAPI/Events/LocaleChangedEventArgs.cs
@@ -0,0 +1,45 @@
+using System;
+using LanguageCode = StardewValley.LocalizedContentManager.LanguageCode;
+
+namespace StardewModdingAPI.Events
+{
+    /// <summary>Event arguments for an <see cref="IContentEvents.LocaleChanged"/> event.</summary>
+    public class LocaleChangedEventArgs : EventArgs
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The previous language enum value.</summary>
+        /// <remarks>For a custom language, this is always <see cref="LanguageCode.mod"/>.</remarks>
+        public LanguageCode OldLanguage { get; }
+
+        /// <summary>The previous locale code.</summary>
+        /// <remarks>This is the locale code as it appears in asset names, like <c>fr-FR</c> in <c>Maps/springobjects.fr-FR</c>. The locale code for English is an empty string.</remarks>
+        public string OldLocale { get; }
+
+        /// <summary>The new language enum value.</summary>
+        /// <remarks><inheritdoc cref="OldLanguage" select="remarks" /></remarks>
+        public LanguageCode NewLanguage { get; }
+
+        /// <summary>The new locale code.</summary>
+        /// <remarks><inheritdoc cref="OldLocale" select="remarks" /></remarks>
+        public string NewLocale { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="oldLanguage">The previous language enum value.</param>
+        /// <param name="oldLocale">The previous locale code.</param>
+        /// <param name="newLanguage">The new language enum value.</param>
+        /// <param name="newLocale">The new locale code.</param>
+        internal LocaleChangedEventArgs(LanguageCode oldLanguage, string oldLocale, LanguageCode newLanguage, string newLocale)
+        {
+            this.OldLanguage = oldLanguage;
+            this.OldLocale = oldLocale;
+            this.NewLanguage = newLanguage;
+            this.NewLocale = newLocale;
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index bcfd7dd7..41540047 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -20,6 +20,9 @@ namespace StardewModdingAPI.Framework.Events
         /// <inheritdoc cref="IContentEvents.AssetReady" />
         public readonly ManagedEvent<AssetReadyEventArgs> AssetReady;
 
+        /// <inheritdoc cref="IContentEvents.LocaleChanged" />
+        public readonly ManagedEvent<LocaleChangedEventArgs> LocaleChanged;
+
 
         /****
         ** Display
@@ -204,6 +207,7 @@ namespace StardewModdingAPI.Framework.Events
             this.AssetRequested = ManageEventOf<AssetRequestedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetRequested));
             this.AssetsInvalidated = ManageEventOf<AssetsInvalidatedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetsInvalidated));
             this.AssetReady = ManageEventOf<AssetReadyEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.AssetReady));
+            this.LocaleChanged = ManageEventOf<LocaleChangedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.LocaleChanged));
 
             this.MenuChanged = ManageEventOf<MenuChangedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.MenuChanged));
             this.Rendering = ManageEventOf<RenderingEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendering), isPerformanceCritical: true);
diff --git a/src/SMAPI/Framework/Events/ModContentEvents.cs b/src/SMAPI/Framework/Events/ModContentEvents.cs
index cb242e99..beb96031 100644
--- a/src/SMAPI/Framework/Events/ModContentEvents.cs
+++ b/src/SMAPI/Framework/Events/ModContentEvents.cs
@@ -30,6 +30,13 @@ namespace StardewModdingAPI.Framework.Events
             remove => this.EventManager.AssetReady.Remove(value);
         }
 
+        /// <inheritdoc />
+        public event EventHandler<LocaleChangedEventArgs> LocaleChanged
+        {
+            add => this.EventManager.LocaleChanged.Add(value, this.Mod);
+            remove => this.EventManager.LocaleChanged.Remove(value);
+        }
+
 
         /*********
         ** Public methods
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index eab977ac..5deb177c 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -46,6 +46,7 @@ using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.Menus;
 using xTile.Display;
+using LanguageCode = StardewValley.LocalizedContentManager.LanguageCode;
 using MiniMonoModHotfix = MonoMod.Utils.MiniMonoModHotfix;
 using PathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 using SObject = StardewValley.Object;
@@ -62,7 +63,7 @@ namespace StardewModdingAPI.Framework
         ** Low-level components
         ****/
         /// <summary>Tracks whether the game should exit immediately and any pending initialization should be cancelled.</summary>
-        private readonly CancellationTokenSource CancellationToken = new CancellationTokenSource();
+        private readonly CancellationTokenSource CancellationToken = new();
 
         /// <summary>Manages the SMAPI console window and log file.</summary>
         private readonly LogManager LogManager;
@@ -71,16 +72,16 @@ namespace StardewModdingAPI.Framework
         private Monitor Monitor => this.LogManager.Monitor;
 
         /// <summary>Simplifies access to private game code.</summary>
-        private readonly Reflector Reflection = new Reflector();
+        private readonly Reflector Reflection = new();
 
         /// <summary>Encapsulates access to SMAPI core translations.</summary>
-        private readonly Translator Translator = new Translator();
+        private readonly Translator Translator = new();
 
         /// <summary>The SMAPI configuration settings.</summary>
         private readonly SConfig Settings;
 
         /// <summary>The mod toolkit used for generic mod interactions.</summary>
-        private readonly ModToolkit Toolkit = new ModToolkit();
+        private readonly ModToolkit Toolkit = new();
 
         /****
         ** Higher-level components
@@ -99,7 +100,7 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Tracks the installed mods.</summary>
         /// <remarks>This is initialized after the game starts.</remarks>
-        private readonly ModRegistry ModRegistry = new ModRegistry();
+        private readonly ModRegistry ModRegistry = new();
 
         /// <summary>Manages SMAPI events for mods.</summary>
         private readonly EventManager EventManager;
@@ -129,18 +130,21 @@ namespace StardewModdingAPI.Framework
         /// <summary>Whether the player just returned to the title screen.</summary>
         public bool JustReturnedToTitle { get; set; }
 
+        /// <summary>The last language set by the game.</summary>
+        private (string Locale, LanguageCode Code) LastLanguage { get; set; } = ("", LanguageCode.en);
+
         /// <summary>The maximum number of consecutive attempts SMAPI should make to recover from an update error.</summary>
-        private readonly Countdown UpdateCrashTimer = new Countdown(60); // 60 ticks = roughly one second
+        private readonly Countdown UpdateCrashTimer = new(60); // 60 ticks = roughly one second
 
         /// <summary>Asset interceptors added or removed since the last tick.</summary>
-        private readonly List<AssetInterceptorChange> ReloadAssetInterceptorsQueue = new List<AssetInterceptorChange>();
+        private readonly List<AssetInterceptorChange> ReloadAssetInterceptorsQueue = new();
 
         /// <summary>A list of queued commands to parse and execute.</summary>
         /// <remarks>This property must be thread-safe, since it's accessed from a separate console input thread.</remarks>
-        private readonly ConcurrentQueue<string> RawCommandQueue = new ConcurrentQueue<string>();
+        private readonly ConcurrentQueue<string> RawCommandQueue = new();
 
         /// <summary>A list of commands to execute on each screen.</summary>
-        private readonly PerScreen<List<Tuple<Command, string, string[]>>> ScreenCommandQueue = new PerScreen<List<Tuple<Command, string, string[]>>>(() => new List<Tuple<Command, string, string[]>>());
+        private readonly PerScreen<List<Tuple<Command, string, string[]>>> ScreenCommandQueue = new(() => new List<Tuple<Command, string, string[]>>());
 
 
         /*********
@@ -369,13 +373,13 @@ namespace StardewModdingAPI.Framework
             xTile.Format.FormatManager.Instance.RegisterMapFormat(new TMXTile.TMXFormat(Game1.tileSize / Game1.pixelZoom, Game1.tileSize / Game1.pixelZoom, Game1.pixelZoom, Game1.pixelZoom));
 
             // load mod data
-            ModToolkit toolkit = new ModToolkit();
+            ModToolkit toolkit = new();
             ModDatabase modDatabase = toolkit.GetModDatabase(Constants.ApiMetadataPath);
 
             // load mods
             {
                 this.Monitor.Log("Loading mod metadata...", LogLevel.Debug);
-                ModResolver resolver = new ModResolver();
+                ModResolver resolver = new();
 
                 // log loose files
                 {
@@ -1048,7 +1052,7 @@ namespace StardewModdingAPI.Framework
 
             // get locale
             string locale = this.ContentCore.GetLocale();
-            LocalizedContentManager.LanguageCode languageCode = this.ContentCore.Language;
+            LanguageCode languageCode = this.ContentCore.Language;
 
             // update core translations
             this.Translator.SetLocale(locale, languageCode);
@@ -1061,6 +1065,20 @@ namespace StardewModdingAPI.Framework
                 foreach (ContentPack contentPack in mod.GetFakeContentPacks())
                     contentPack.TranslationImpl.SetLocale(locale, languageCode);
             }
+
+            // raise event
+            if (this.EventManager.LocaleChanged.HasListeners())
+            {
+                this.EventManager.LocaleChanged.Raise(
+                    new LocaleChangedEventArgs(
+                        oldLanguage: this.LastLanguage.Code,
+                        oldLocale: this.LastLanguage.Locale,
+                        newLanguage: languageCode,
+                        newLocale: locale
+                    )
+                );
+            }
+            this.LastLanguage = (locale, languageCode);
         }
 
         /// <summary>Raised when the low-level stage while loading a save changes.</summary>
@@ -1385,7 +1403,7 @@ namespace StardewModdingAPI.Framework
             {
                 // create client
                 string url = this.Settings.WebApiBaseUrl;
-                WebApiClient client = new WebApiClient(url, Constants.ApiVersion);
+                WebApiClient client = new(url, Constants.ApiVersion);
                 this.Monitor.Log("Checking for updates...");
 
                 // check SMAPI version
@@ -1569,7 +1587,7 @@ namespace StardewModdingAPI.Framework
 
             // load mods
             IList<IModMetadata> skippedMods = new List<IModMetadata>();
-            using (AssemblyLoader modAssemblyLoader = new AssemblyLoader(Constants.Platform, this.Monitor, this.Settings.ParanoidWarnings, this.Settings.RewriteMods))
+            using (AssemblyLoader modAssemblyLoader = new(Constants.Platform, this.Monitor, this.Settings.ParanoidWarnings, this.Settings.RewriteMods))
             {
                 // init
                 HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
@@ -1758,7 +1776,7 @@ namespace StardewModdingAPI.Framework
                 IManifest manifest = mod.Manifest;
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
                 IContentHelper contentHelper = new ContentHelper(this.ContentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor);
-                TranslationHelper translationHelper = new TranslationHelper(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
+                TranslationHelper translationHelper = new(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
                 IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, contentHelper, translationHelper, jsonHelper);
                 mod.SetMod(contentPack, monitor, translationHelper);
                 this.ModRegistry.Add(mod);
@@ -1831,16 +1849,16 @@ namespace StardewModdingAPI.Framework
 
                     // init mod helpers
                     IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
-                    TranslationHelper translationHelper = new TranslationHelper(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
+                    TranslationHelper translationHelper = new(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
                     IModHelper modHelper;
                     {
                         IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest)
                         {
                             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
                             IContentHelper packContentHelper = new ContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, packMonitor);
-                            TranslationHelper packTranslationHelper = new TranslationHelper(packManifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
+                            TranslationHelper packTranslationHelper = new(packManifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
 
-                            ContentPack contentPack = new ContentPack(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper);
+                            ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper);
                             this.ReloadTranslationsForTemporaryContentPack(mod, contentPack);
                             mod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
                             return contentPack;
@@ -1982,7 +2000,7 @@ namespace StardewModdingAPI.Framework
             // read translation files
             var translations = new Dictionary<string, IDictionary<string, string>>();
             errors = new List<string>();
-            DirectoryInfo translationsDir = new DirectoryInfo(folderPath);
+            DirectoryInfo translationsDir = new(folderPath);
             if (translationsDir.Exists)
             {
                 foreach (FileInfo file in translationsDir.EnumerateFiles("*.json"))
@@ -2038,7 +2056,7 @@ namespace StardewModdingAPI.Framework
         {
             // default path
             {
-                FileInfo defaultFile = new FileInfo(Path.Combine(Constants.LogDir, $"{Constants.LogFilename}.{Constants.LogExtension}"));
+                FileInfo defaultFile = new(Path.Combine(Constants.LogDir, $"{Constants.LogFilename}.{Constants.LogExtension}"));
                 if (!defaultFile.Exists)
                     return defaultFile.FullName;
             }
@@ -2046,7 +2064,7 @@ namespace StardewModdingAPI.Framework
             // get first disambiguated path
             for (int i = 2; i < int.MaxValue; i++)
             {
-                FileInfo file = new FileInfo(Path.Combine(Constants.LogDir, $"{Constants.LogFilename}.player-{i}.{Constants.LogExtension}"));
+                FileInfo file = new(Path.Combine(Constants.LogDir, $"{Constants.LogFilename}.player-{i}.{Constants.LogExtension}"));
                 if (!file.Exists)
                     return file.FullName;
             }
@@ -2058,7 +2076,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Delete normal (non-crash) log files created by SMAPI.</summary>
         private void PurgeNormalLogs()
         {
-            DirectoryInfo logsDir = new DirectoryInfo(Constants.LogDir);
+            DirectoryInfo logsDir = new(Constants.LogDir);
             if (!logsDir.Exists)
                 return;
 

From d864f2ed775dfd5843b9e1cdd1da96ade5dd1068 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 27 Mar 2022 12:16:28 -0400
Subject: [PATCH 485/856] add asset type to AssetRequested event (#766)

---
 src/SMAPI/Events/AssetRequestedEventArgs.cs               | 7 ++++++-
 src/SMAPI/Framework/ContentCoordinator.cs                 | 5 +++--
 src/SMAPI/Framework/ContentManagers/BaseContentManager.cs | 2 +-
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs | 8 ++++----
 src/SMAPI/Framework/ContentManagers/IContentManager.cs    | 3 ++-
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs  | 4 ++--
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs           | 2 ++
 src/SMAPI/Framework/SCore.cs                              | 2 +-
 src/SMAPI/IContentHelper.cs                               | 4 +++-
 9 files changed, 24 insertions(+), 13 deletions(-)

diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index 4d9ee236..c0cbd8fb 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -30,6 +30,9 @@ namespace StardewModdingAPI.Events
         /// <remarks>For example, if <see cref="Name"/> contains a locale like <c>Data/Bundles.fr-FR</c>, this will be the name without locale like <c>Data/Bundles</c>. If the name has no locale, this field is equivalent.</remarks>
         public IAssetName NameWithoutLocale { get; }
 
+        /// <summary>The requested data type.</summary>
+        public Type DataType { get; }
+
         /// <summary>The load operations requested by the event handler.</summary>
         internal IList<AssetLoadOperation> LoadOperations { get; } = new List<AssetLoadOperation>();
 
@@ -43,13 +46,15 @@ namespace StardewModdingAPI.Events
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod handling the event.</param>
         /// <param name="name">The name of the asset being requested.</param>
+        /// <param name="dataType">The requested data type.</param>
         /// <param name="nameWithoutLocale">The <paramref name="name"/> with any locale codes stripped.</param>
         /// <param name="getOnBehalfOf">Get the mod metadata for a content pack, if it's a valid content pack for the mod.</param>
-        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name, IAssetName nameWithoutLocale, Func<IModMetadata, string, string, IModMetadata> getOnBehalfOf)
+        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name, IAssetName nameWithoutLocale, Type dataType, Func<IModMetadata, string, string, IModMetadata> getOnBehalfOf)
         {
             this.Mod = mod;
             this.Name = name;
             this.NameWithoutLocale = nameWithoutLocale;
+            this.DataType = dataType;
             this.GetOnBehalfOf = getOnBehalfOf;
         }
 
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index ee8b6893..108257bf 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -315,9 +315,10 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Get whether an asset from a mod folder exists.</summary>
+        /// <typeparam name="T">The expected asset type.</typeparam>
         /// <param name="contentManagerID">The unique name for the content manager which should load this asset.</param>
         /// <param name="assetName">The asset name within the mod folder.</param>
-        public bool DoesManagedAssetExist(string contentManagerID, IAssetName assetName)
+        public bool DoesManagedAssetExist<T>(string contentManagerID, IAssetName assetName)
         {
             // get content manager
             IContentManager contentManager = this.ContentManagerLock.InReadLock(() =>
@@ -327,7 +328,7 @@ namespace StardewModdingAPI.Framework
                 throw new InvalidOperationException($"The '{contentManagerID}' prefix isn't handled by any mod.");
 
             // get whether the asset exists
-            return contentManager.DoesAssetExist(assetName);
+            return contentManager.DoesAssetExist<T>(assetName);
         }
 
         /// <summary>Get a copy of an asset from a mod folder.</summary>
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 1ca84792..f41a9354 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -97,7 +97,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public virtual bool DoesAssetExist(IAssetName assetName)
+        public virtual bool DoesAssetExist<T>(IAssetName assetName)
         {
             return this.Cache.ContainsKey(assetName.Name);
         }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 0fcad30a..3d37e32a 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -58,9 +58,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public override bool DoesAssetExist(IAssetName assetName)
+        public override bool DoesAssetExist<T>(IAssetName assetName)
         {
-            if (base.DoesAssetExist(assetName))
+            if (base.DoesAssetExist<T>(assetName))
                 return true;
 
             // vanilla asset
@@ -69,11 +69,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // managed asset
             if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
-                return this.Coordinator.DoesManagedAssetExist(contentManagerID, relativePath);
+                return this.Coordinator.DoesManagedAssetExist<T>(contentManagerID, relativePath);
 
             // custom asset from a loader
             string locale = this.GetLocale();
-            IAssetInfo info = new AssetInfo(locale, assetName, typeof(object), this.AssertAndNormalizeAssetName);
+            IAssetInfo info = new AssetInfo(locale, assetName, typeof(T), this.AssertAndNormalizeAssetName);
             AssetLoadOperation[] loaders = this.GetLoaders<object>(info).ToArray();
 
             if (!this.AssertMaxOneRequiredLoader(info, loaders, out string error))
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index 774b20d9..90095492 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -29,8 +29,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         ** Methods
         *********/
         /// <summary>Get whether an asset exists and can be loaded.</summary>
+        /// <typeparam name="T">The expected asset type.</typeparam>
         /// <param name="assetName">The normalized asset name.</param>
-        bool DoesAssetExist(IAssetName assetName);
+        bool DoesAssetExist<T>(IAssetName assetName);
 
         /// <summary>Load an asset through the content pipeline, using a localized variant of the <paramref name="assetName"/> if available.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 375b5e0e..2a5a3f16 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -66,9 +66,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public override bool DoesAssetExist(IAssetName assetName)
+        public override bool DoesAssetExist<T>(IAssetName assetName)
         {
-            if (base.DoesAssetExist(assetName))
+            if (base.DoesAssetExist<T>(assetName))
                 return true;
 
             FileInfo file = this.GetModFile(assetName.Name);
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 5d58ee26..3a5c8938 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -44,9 +44,11 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public LocalizedContentManager.LanguageCode CurrentLocaleConstant => this.GameContentManager.Language;
 
         /// <summary>The observable implementation of <see cref="AssetEditors"/>.</summary>
+        [Obsolete]
         internal ObservableCollection<IAssetEditor> ObservableAssetEditors { get; } = new();
 
         /// <summary>The observable implementation of <see cref="AssetLoaders"/>.</summary>
+        [Obsolete]
         internal ObservableCollection<IAssetLoader> ObservableAssetLoaders { get; } = new();
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 5deb177c..efdfabe7 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1151,7 +1151,7 @@ namespace StardewModdingAPI.Framework
             this.EventManager.AssetRequested.Raise(
                 invoke: (mod, invoke) =>
                 {
-                    AssetRequestedEventArgs args = new(mod, asset.Name, asset.NameWithoutLocale, this.GetOnBehalfOfContentPack);
+                    AssetRequestedEventArgs args = new(mod, asset.Name, asset.NameWithoutLocale, asset.DataType, this.GetOnBehalfOfContentPack);
 
                     invoke(args);
 
diff --git a/src/SMAPI/IContentHelper.cs b/src/SMAPI/IContentHelper.cs
index 6fcd18cd..1d36abff 100644
--- a/src/SMAPI/IContentHelper.cs
+++ b/src/SMAPI/IContentHelper.cs
@@ -3,7 +3,7 @@ using System.Collections.Generic;
 using System.Diagnostics.Contracts;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
-using StardewModdingAPI.Framework.Content;
+using StardewModdingAPI.Events;
 using StardewValley;
 using xTile;
 
@@ -16,9 +16,11 @@ namespace StardewModdingAPI
         ** Accessors
         *********/
         /// <summary>Interceptors which provide the initial versions of matching content assets.</summary>
+        [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.Events)}.{nameof(IModEvents.Content)} instead. This interface will be removed in SMAPI 4.0.0.")]
         IList<IAssetLoader> AssetLoaders { get; }
 
         /// <summary>Interceptors which edit matching content assets after they're loaded.</summary>
+        [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.Events)}.{nameof(IModEvents.Content)} instead. This interface will be removed in SMAPI 4.0.0.")]
         IList<IAssetEditor> AssetEditors { get; }
 
         /// <summary>The game's current locale code (like <c>pt-BR</c>).</summary>

From 1d3c99cc25f6c0d504fd5e43ea71ef327b6e9066 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 27 Mar 2022 13:42:14 -0400
Subject: [PATCH 486/856] split helper.Content API into game/mod content APIs

---
 docs/release-notes.md                         |   2 +
 src/SMAPI/Framework/Content/AssetName.cs      |  12 ++
 src/SMAPI/Framework/ContentPack.cs            |  24 ++--
 .../Framework/ModHelpers/ContentHelper.cs     |   9 +-
 .../Framework/ModHelpers/GameContentHelper.cs | 129 ++++++++++++++++++
 .../Framework/ModHelpers/ModContentHelper.cs  |  75 ++++++++++
 src/SMAPI/Framework/ModHelpers/ModHelper.cs   |  38 +++++-
 src/SMAPI/Framework/SCore.cs                  |  12 +-
 src/SMAPI/IAssetName.cs                       |   5 +
 src/SMAPI/IContentHelper.cs                   |  10 +-
 src/SMAPI/IContentPack.cs                     |   5 +
 src/SMAPI/IGameContentHelper.cs               |  73 ++++++++++
 src/SMAPI/IModContentHelper.cs                |  32 +++++
 src/SMAPI/IModHelper.cs                       |  10 ++
 14 files changed, 400 insertions(+), 36 deletions(-)
 create mode 100644 src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
 create mode 100644 src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
 create mode 100644 src/SMAPI/IGameContentHelper.cs
 create mode 100644 src/SMAPI/IModContentHelper.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 99ac86df..2e09240c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -17,10 +17,12 @@
 * For mod authors:
   * **Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.**  
     _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
+  * **Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.**
   * **Overhauled [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying** (thanks to Shockah!).  
     _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
   * **Deprecation warning:** The upcoming SMAPI 4.0 will remove deprecated APIs and break mods which haven't updated yet.  
     _See [_Migrate to SMAPI 4.0_](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0) for help updating your mod code. You can update your mod code now, there's no need to wait for the 4.0.0 release (which will happen in at least three months, and possibly later if needed to update open-source mods)._
+  * Added `IContentPack.ModContent` property.
   * Added `Constants.ContentPath`.
   * Added `IAssetName` fields to the info received by `IAssetEditor` and `IAssetLoader` methods.  
     _This adds methods for working with asset names, parsed locales, etc._
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 7ce0f8ee..a1d37b0b 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -100,6 +100,18 @@ namespace StardewModdingAPI.Framework.Content
             return compareTo.Equals(assetName, StringComparison.OrdinalIgnoreCase);
         }
 
+        /// <inheritdoc />
+        public bool IsEquivalentTo(IAssetName assetName, bool useBaseName = false)
+        {
+            if (useBaseName)
+                return this.BaseName.Equals(assetName?.BaseName, StringComparison.OrdinalIgnoreCase);
+
+            if (assetName is AssetName impl)
+                return this.ComparableName == impl?.ComparableName;
+
+            return this.Name.Equals(assetName?.Name, StringComparison.OrdinalIgnoreCase);
+        }
+
         /// <inheritdoc />
         public bool StartsWith(string prefix, bool allowPartialWord = true, bool allowSubfolder = true)
         {
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index b6add7b5..3920354e 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -13,9 +13,6 @@ namespace StardewModdingAPI.Framework
         /*********
         ** Fields
         *********/
-        /// <summary>Provides an API for loading content assets.</summary>
-        private readonly IContentHelper Content;
-
         /// <summary>Encapsulates SMAPI's JSON file parsing.</summary>
         private readonly JsonHelper JsonHelper;
 
@@ -35,6 +32,9 @@ namespace StardewModdingAPI.Framework
         /// <inheritdoc />
         public ITranslationHelper Translation => this.TranslationImpl;
 
+        /// <inheritdoc />
+        public IModContentHelper ModContent { get; }
+
         /// <summary>The underlying translation helper.</summary>
         internal TranslationHelper TranslationImpl { get; set; }
 
@@ -45,14 +45,14 @@ namespace StardewModdingAPI.Framework
         /// <summary>Construct an instance.</summary>
         /// <param name="directoryPath">The full path to the content pack's folder.</param>
         /// <param name="manifest">The content pack's manifest.</param>
-        /// <param name="content">Provides an API for loading content assets.</param>
+        /// <param name="content">Provides an API for loading content assets from the content pack's folder.</param>
         /// <param name="translation">Provides translations stored in the content pack's <c>i18n</c> folder.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
-        public ContentPack(string directoryPath, IManifest manifest, IContentHelper content, TranslationHelper translation, JsonHelper jsonHelper)
+        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper)
         {
             this.DirectoryPath = directoryPath;
             this.Manifest = manifest;
-            this.Content = content;
+            this.ModContent = content;
             this.TranslationImpl = translation;
             this.JsonHelper = jsonHelper;
 
@@ -95,21 +95,17 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <inheritdoc />
+        [Obsolete]
         public T LoadAsset<T>(string key)
         {
-            key = PathUtilities.NormalizePath(key);
-
-            key = this.GetCaseInsensitiveRelativePath(key);
-            return this.Content.Load<T>(key, ContentSource.ModFolder);
+            return this.ModContent.Load<T>(key);
         }
 
         /// <inheritdoc />
+        [Obsolete]
         public string GetActualAssetKey(string key)
         {
-            key = PathUtilities.NormalizePath(key);
-
-            key = this.GetCaseInsensitiveRelativePath(key);
-            return this.Content.GetActualAssetKey(key, ContentSource.ModFolder);
+            return this.ModContent.GetInternalAssetName(key)?.Name;
         }
 
 
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 3a5c8938..b0064532 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -13,6 +13,7 @@ using StardewValley;
 namespace StardewModdingAPI.Framework.ModHelpers
 {
     /// <summary>Provides an API for loading content assets.</summary>
+    [Obsolete]
     internal class ContentHelper : BaseHelper, IContentHelper
     {
         /*********
@@ -44,11 +45,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public LocalizedContentManager.LanguageCode CurrentLocaleConstant => this.GameContentManager.Language;
 
         /// <summary>The observable implementation of <see cref="AssetEditors"/>.</summary>
-        [Obsolete]
         internal ObservableCollection<IAssetEditor> ObservableAssetEditors { get; } = new();
 
         /// <summary>The observable implementation of <see cref="AssetLoaders"/>.</summary>
-        [Obsolete]
         internal ObservableCollection<IAssetLoader> ObservableAssetLoaders { get; } = new();
 
         /// <inheritdoc />
@@ -105,12 +104,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.Monitor = monitor;
         }
 
-        /// <inheritdoc />
-        public IAssetName ParseAssetName(string rawName)
-        {
-            return this.ContentCore.ParseAssetName(rawName);
-        }
-
         /// <inheritdoc />
         public T Load<T>(string key, ContentSource source = ContentSource.ModFolder)
         {
diff --git a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
new file mode 100644
index 00000000..42a4de20
--- /dev/null
+++ b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
@@ -0,0 +1,129 @@
+using System;
+using System.Linq;
+using StardewModdingAPI.Framework.Content;
+using StardewModdingAPI.Framework.ContentManagers;
+using StardewModdingAPI.Framework.Exceptions;
+using StardewValley;
+
+namespace StardewModdingAPI.Framework.ModHelpers
+{
+    /// <inheritdoc cref="IGameContentHelper"/>
+    internal class GameContentHelper : BaseHelper, IGameContentHelper
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>SMAPI's core content logic.</summary>
+        private readonly ContentCoordinator ContentCore;
+
+        /// <summary>The underlying game content manager.</summary>
+        private readonly IContentManager GameContentManager;
+
+        /// <summary>The friendly mod name for use in errors.</summary>
+        private readonly string ModName;
+
+        /// <summary>Encapsulates monitoring and logging.</summary>
+        private readonly IMonitor Monitor;
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <inheritdoc />
+        public string CurrentLocale => this.GameContentManager.GetLocale();
+
+        /// <inheritdoc />
+        public LocalizedContentManager.LanguageCode CurrentLocaleConstant => this.GameContentManager.Language;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="contentCore">SMAPI's core content logic.</param>
+        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="modName">The friendly mod name for use in errors.</param>
+        /// <param name="monitor">Encapsulates monitoring and logging.</param>
+        public GameContentHelper(ContentCoordinator contentCore, string modID, string modName, IMonitor monitor)
+            : base(modID)
+        {
+            string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
+
+            this.ContentCore = contentCore;
+            this.GameContentManager = contentCore.CreateGameContentManager(managedAssetPrefix + ".content");
+            this.ModName = modName;
+            this.Monitor = monitor;
+        }
+
+        /// <inheritdoc />
+        public IAssetName ParseAssetName(string rawName)
+        {
+            return this.ContentCore.ParseAssetName(rawName);
+        }
+
+        /// <inheritdoc />
+        public T Load<T>(string key)
+        {
+            IAssetName assetName = this.ContentCore.ParseAssetName(key);
+            return this.Load<T>(assetName);
+        }
+
+        /// <inheritdoc />
+        public T Load<T>(IAssetName assetName)
+        {
+            try
+            {
+                return this.GameContentManager.LoadLocalized<T>(assetName, this.CurrentLocaleConstant, useCache: false);
+            }
+            catch (Exception ex) when (ex is not SContentLoadException)
+            {
+                throw new SContentLoadException($"{this.ModName} failed loading content asset '{assetName}' from the game content.", ex);
+            }
+        }
+
+        /// <inheritdoc />
+        public bool InvalidateCache(string key)
+        {
+            IAssetName assetName = this.ParseAssetName(key);
+            return this.InvalidateCache(assetName);
+        }
+
+        /// <inheritdoc />
+        public bool InvalidateCache(IAssetName assetName)
+        {
+            this.Monitor.Log($"Requested cache invalidation for '{assetName}'.");
+            return this.ContentCore.InvalidateCache(asset => asset.Name.IsEquivalentTo(assetName)).Any();
+        }
+
+        /// <inheritdoc />
+        public bool InvalidateCache<T>()
+        {
+            this.Monitor.Log($"Requested cache invalidation for all assets of type {typeof(T)}. This is an expensive operation and should be avoided if possible.");
+            return this.ContentCore.InvalidateCache((_, _, type) => typeof(T).IsAssignableFrom(type)).Any();
+        }
+
+        /// <inheritdoc />
+        public bool InvalidateCache(Func<IAssetInfo, bool> predicate)
+        {
+            this.Monitor.Log("Requested cache invalidation for all assets matching a predicate.");
+            return this.ContentCore.InvalidateCache(predicate).Any();
+        }
+
+        /// <inheritdoc />
+        public IAssetData GetPatchHelper<T>(T data, string assetName = null)
+        {
+            if (data == null)
+                throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
+
+            assetName ??= $"temp/{Guid.NewGuid():N}";
+
+            return new AssetDataForObject(this.CurrentLocale, this.ContentCore.ParseAssetName(assetName), data, key => this.ParseAssetName(key).Name);
+        }
+
+        /// <summary>Get the underlying game content manager.</summary>
+        internal IContentManager GetUnderlyingContentManager()
+        {
+            return this.GameContentManager;
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
new file mode 100644
index 00000000..45899dd7
--- /dev/null
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -0,0 +1,75 @@
+using System;
+using StardewModdingAPI.Framework.Content;
+using StardewModdingAPI.Framework.ContentManagers;
+using StardewModdingAPI.Framework.Exceptions;
+
+namespace StardewModdingAPI.Framework.ModHelpers
+{
+    /// <inheritdoc cref="IModContentHelper"/>
+    internal class ModContentHelper : BaseHelper, IModContentHelper
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>SMAPI's core content logic.</summary>
+        private readonly ContentCoordinator ContentCore;
+
+        /// <summary>A content manager for this mod which manages files from the mod's folder.</summary>
+        private readonly ModContentManager ModContentManager;
+
+        /// <summary>The friendly mod name for use in errors.</summary>
+        private readonly string ModName;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="contentCore">SMAPI's core content logic.</param>
+        /// <param name="modFolderPath">The absolute path to the mod folder.</param>
+        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="modName">The friendly mod name for use in errors.</param>
+        /// <param name="gameContentManager">The game content manager used for map tilesheets not provided by the mod.</param>
+        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IContentManager gameContentManager)
+            : base(modID)
+        {
+            string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
+
+            this.ContentCore = contentCore;
+            this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, modName, modFolderPath, gameContentManager);
+            this.ModName = modName;
+        }
+
+        /// <inheritdoc />
+        public T Load<T>(string relativePath)
+        {
+            IAssetName assetName = this.ContentCore.ParseAssetName(relativePath);
+
+            try
+            {
+                return this.ModContentManager.LoadExact<T>(assetName, useCache: false);
+            }
+            catch (Exception ex) when (ex is not SContentLoadException)
+            {
+                throw new SContentLoadException($"{this.ModName} failed loading content asset '{relativePath}' from its mod folder.", ex);
+            }
+        }
+
+        /// <inheritdoc />
+        public IAssetName GetInternalAssetName(string relativePath)
+        {
+            return this.ModContentManager.GetInternalAssetKey(relativePath);
+        }
+
+        /// <inheritdoc />
+        public IAssetData GetPatchHelper<T>(T data, string relativePath = null)
+        {
+            if (data == null)
+                throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
+
+            relativePath ??= $"temp/{Guid.NewGuid():N}";
+
+            return new AssetDataForObject(this.ContentCore.GetLocale(), this.ContentCore.ParseAssetName(relativePath), data, key => this.ContentCore.ParseAssetName(key).Name);
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 058bff83..d28faacc 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -8,6 +8,14 @@ namespace StardewModdingAPI.Framework.ModHelpers
     /// <summary>Provides simplified APIs for writing mods.</summary>
     internal class ModHelper : BaseHelper, IModHelper, IDisposable
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The backing field for <see cref="Content"/>.</summary>
+        [Obsolete]
+        private readonly IContentHelper ContentImpl;
+
+
         /*********
         ** Accessors
         *********/
@@ -18,7 +26,27 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public IModEvents Events { get; }
 
         /// <inheritdoc />
-        public IContentHelper Content { get; }
+        [Obsolete]
+        public IContentHelper Content
+        {
+            get
+            {
+                SCore.DeprecationManager.Warn(
+                    source: SCore.DeprecationManager.GetSourceName(this.ModID),
+                    nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.Content)}",
+                    version: "3.14.0",
+                    severity: DeprecationLevel.Notice
+                );
+
+                return this.ContentImpl;
+            }
+        }
+
+        /// <inheritdoc />
+        public IGameContentHelper GameContent { get; }
+
+        /// <inheritdoc />
+        public IModContentHelper ModContent { get; }
 
         /// <inheritdoc />
         public IContentPackHelper ContentPacks { get; }
@@ -54,6 +82,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="currentInputState">Manages the game's input state for the current player instance. That may not be the main player in split-screen mode.</param>
         /// <param name="events">Manages access to events raised by SMAPI.</param>
         /// <param name="contentHelper">An API for loading content assets.</param>
+        /// <param name="gameContentHelper">An API for loading content assets from the game's <c>Content</c> folder or via <see cref="IModEvents.Content"/>.</param>
+        /// <param name="modContentHelper">An API for loading content assets from your mod's files.</param>
         /// <param name="contentPackHelper">An API for managing content packs.</param>
         /// <param name="commandHelper">An API for managing console commands.</param>
         /// <param name="dataHelper">An API for reading and writing persistent mod data.</param>
@@ -63,7 +93,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="translationHelper">An API for reading translations stored in the mod's <c>i18n</c> folder.</param>
         /// <exception cref="ArgumentNullException">An argument is null or empty.</exception>
         /// <exception cref="InvalidOperationException">The <paramref name="modDirectory"/> path does not exist on disk.</exception>
-        public ModHelper(string modID, string modDirectory, Func<SInputState> currentInputState, IModEvents events, IContentHelper contentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper)
+        public ModHelper(string modID, string modDirectory, Func<SInputState> currentInputState, IModEvents events, IContentHelper contentHelper, IGameContentHelper gameContentHelper, IModContentHelper modContentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper)
             : base(modID)
         {
             // validate directory
@@ -74,7 +104,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             // initialize
             this.DirectoryPath = modDirectory;
-            this.Content = contentHelper ?? throw new ArgumentNullException(nameof(contentHelper));
+            this.ContentImpl = contentHelper ?? throw new ArgumentNullException(nameof(contentHelper));
+            this.GameContent = gameContentHelper ?? throw new ArgumentNullException(nameof(gameContentHelper));
+            this.ModContent = modContentHelper ?? throw new ArgumentNullException(nameof(modContentHelper));
             this.ContentPacks = contentPackHelper ?? throw new ArgumentNullException(nameof(contentPackHelper));
             this.Data = dataHelper ?? throw new ArgumentNullException(nameof(dataHelper));
             this.Input = new InputHelper(modID, currentInputState);
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index efdfabe7..b4aa3595 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1775,9 +1775,10 @@ namespace StardewModdingAPI.Framework
             {
                 IManifest manifest = mod.Manifest;
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
-                IContentHelper contentHelper = new ContentHelper(this.ContentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor);
+                GameContentHelper gameContentHelper = new(this.ContentCore, manifest.UniqueID, mod.DisplayName, monitor);
+                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager());
                 TranslationHelper translationHelper = new(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
-                IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, contentHelper, translationHelper, jsonHelper);
+                IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, modContentHelper, translationHelper, jsonHelper);
                 mod.SetMod(contentPack, monitor, translationHelper);
                 this.ModRegistry.Add(mod);
 
@@ -1855,7 +1856,8 @@ namespace StardewModdingAPI.Framework
                         IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest)
                         {
                             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
-                            IContentHelper packContentHelper = new ContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, packMonitor);
+                            GameContentHelper gameContentHelper = new(contentCore, packManifest.UniqueID, packManifest.Name, packMonitor);
+                            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, gameContentHelper.GetUnderlyingContentManager());
                             TranslationHelper packTranslationHelper = new(packManifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
 
                             ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper);
@@ -1867,13 +1869,15 @@ namespace StardewModdingAPI.Framework
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
                         IContentHelper contentHelper = new ContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor);
+                        GameContentHelper gameContentHelper = new(contentCore, manifest.UniqueID, mod.DisplayName, monitor);
+                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager());
                         IContentPackHelper contentPackHelper = new ContentPackHelper(manifest.UniqueID, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
                         IDataHelper dataHelper = new DataHelper(manifest.UniqueID, mod.DirectoryPath, jsonHelper);
                         IReflectionHelper reflectionHelper = new ReflectionHelper(manifest.UniqueID, mod.DisplayName, this.Reflection);
                         IModRegistry modRegistryHelper = new ModRegistryHelper(manifest.UniqueID, this.ModRegistry, proxyFactory, monitor);
                         IMultiplayerHelper multiplayerHelper = new MultiplayerHelper(manifest.UniqueID, this.Multiplayer);
 
-                        modHelper = new ModHelper(manifest.UniqueID, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events, contentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
+                        modHelper = new ModHelper(manifest.UniqueID, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events, contentHelper, gameContentHelper, modContentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
                     }
 
                     // init mod
diff --git a/src/SMAPI/IAssetName.cs b/src/SMAPI/IAssetName.cs
index 89f02adf..c91da266 100644
--- a/src/SMAPI/IAssetName.cs
+++ b/src/SMAPI/IAssetName.cs
@@ -30,6 +30,11 @@ namespace StardewModdingAPI
         /// <param name="useBaseName">Whether to compare the given name with the <see cref="BaseName"/> (if true) or <see cref="Name"/> (if false). This has no effect on any locale included in the given <paramref name="assetName"/>.</param>
         bool IsEquivalentTo(string assetName, bool useBaseName = false);
 
+        /// <summary>Get whether the given asset name is equivalent, ignoring capitalization and formatting.</summary>
+        /// <param name="assetName">The asset name to compare this instance to.</param>
+        /// <param name="useBaseName">Whether to compare the given name with the <see cref="BaseName"/> (if true) or <see cref="Name"/> (if false).</param>
+        bool IsEquivalentTo(IAssetName assetName, bool useBaseName = false);
+
         /// <summary>Get whether the asset name starts with the given value, ignoring capitalization and formatting. This can be used with a trailing slash to test for an asset folder, like <c>Data/</c>.</summary>
         /// <param name="prefix">The prefix to match.</param>
         /// <param name="allowPartialWord">Whether to match if the prefix occurs mid-word, so <c>Data/AchievementsToIgnore</c> matches prefix <c>Data/Achievements</c>. If this is false, the prefix only matches if the asset name starts with the prefix followed by a non-alphanumeric character (including <c>.</c>, <c>/</c>, or <c>\\</c>) or the end of string.</param>
diff --git a/src/SMAPI/IContentHelper.cs b/src/SMAPI/IContentHelper.cs
index 1d36abff..48f6bfd8 100644
--- a/src/SMAPI/IContentHelper.cs
+++ b/src/SMAPI/IContentHelper.cs
@@ -10,17 +10,18 @@ using xTile;
 namespace StardewModdingAPI
 {
     /// <summary>Provides an API for loading content assets.</summary>
+    [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.GameContent)} or {nameof(IMod.Helper)}.{nameof(IModHelper.ModContent)} instead. This interface will be removed in SMAPI 4.0.0.")]
     public interface IContentHelper : IModLinked
     {
         /*********
         ** Accessors
         *********/
         /// <summary>Interceptors which provide the initial versions of matching content assets.</summary>
-        [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.Events)}.{nameof(IModEvents.Content)} instead. This interface will be removed in SMAPI 4.0.0.")]
+        [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.Events)}.{nameof(IModEvents.Content)} instead. This property will be removed in SMAPI 4.0.0.")]
         IList<IAssetLoader> AssetLoaders { get; }
 
         /// <summary>Interceptors which edit matching content assets after they're loaded.</summary>
-        [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.Events)}.{nameof(IModEvents.Content)} instead. This interface will be removed in SMAPI 4.0.0.")]
+        [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.Events)}.{nameof(IModEvents.Content)} instead. This property will be removed in SMAPI 4.0.0.")]
         IList<IAssetEditor> AssetEditors { get; }
 
         /// <summary>The game's current locale code (like <c>pt-BR</c>).</summary>
@@ -33,11 +34,6 @@ namespace StardewModdingAPI
         /*********
         ** Public methods
         *********/
-        /// <summary>Parse a raw asset name.</summary>
-        /// <param name="rawName">The raw asset name to parse.</param>
-        /// <exception cref="ArgumentException">The <paramref name="rawName"/> is null or empty.</exception>
-        IAssetName ParseAssetName(string rawName);
-
         /// <summary>Load content from the game folder or mod folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
         /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="key">The asset key to fetch (if the <paramref name="source"/> is <see cref="ContentSource.GameContent"/>), or the local path to a content file relative to the mod folder.</param>
diff --git a/src/SMAPI/IContentPack.cs b/src/SMAPI/IContentPack.cs
index 9cc64dcd..3c66faff 100644
--- a/src/SMAPI/IContentPack.cs
+++ b/src/SMAPI/IContentPack.cs
@@ -20,6 +20,9 @@ namespace StardewModdingAPI
         /// <summary>Provides translations stored in the content pack's <c>i18n</c> folder. See <see cref="IModHelper.Translation"/> for more info.</summary>
         ITranslationHelper Translation { get; }
 
+        /// <summary>An API for loading content assets from the content pack's files.</summary>
+        IModContentHelper ModContent { get; }
+
 
         /*********
         ** Public methods
@@ -47,11 +50,13 @@ namespace StardewModdingAPI
         /// <param name="key">The relative file path within the content pack (case-insensitive).</param>
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
         /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
+        [Obsolete($"Use {nameof(IContentPack.ModContent)}.{nameof(IModContentHelper.Load)} instead. This method will be removed in SMAPI 4.0.0.")]
         T LoadAsset<T>(string key);
 
         /// <summary>Get the underlying key in the game's content cache for an asset. This can be used to load custom map tilesheets, but should be avoided when you can use the content API instead. This does not validate whether the asset exists.</summary>
         /// <param name="key">The relative file path within the content pack (case-insensitive).</param>
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
+        [Obsolete($"Use {nameof(IContentPack.ModContent)}.{nameof(IModContentHelper.GetInternalAssetName)} instead. This method will be removed in SMAPI 4.0.0.")]
         string GetActualAssetKey(string key);
     }
 }
diff --git a/src/SMAPI/IGameContentHelper.cs b/src/SMAPI/IGameContentHelper.cs
new file mode 100644
index 00000000..86bc3e0e
--- /dev/null
+++ b/src/SMAPI/IGameContentHelper.cs
@@ -0,0 +1,73 @@
+using System;
+using Microsoft.Xna.Framework.Content;
+using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Events;
+using StardewValley;
+using xTile;
+
+namespace StardewModdingAPI
+{
+    /// <summary>Provides an API for loading content assets from the game's <c>Content</c> folder or via <see cref="IModEvents.Content"/>.</summary>
+    public interface IGameContentHelper : IModLinked
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The game's current locale code (like <c>pt-BR</c>).</summary>
+        string CurrentLocale { get; }
+
+        /// <summary>The game's current locale as an enum value.</summary>
+        LocalizedContentManager.LanguageCode CurrentLocaleConstant { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Parse a raw asset name.</summary>
+        /// <param name="rawName">The raw asset name to parse.</param>
+        /// <exception cref="ArgumentException">The <paramref name="rawName"/> is null or empty.</exception>
+        IAssetName ParseAssetName(string rawName);
+
+        /// <summary>Load content from the game folder or mod folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
+        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
+        /// <param name="assetName">The asset name to load.</param>
+        /// <exception cref="ArgumentException">The <paramref name="assetName"/> is empty or contains invalid characters.</exception>
+        /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
+        T Load<T>(string assetName);
+
+        /// <summary>Load content from the game folder or mod folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
+        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
+        /// <param name="assetName">The asset name to load.</param>
+        /// <exception cref="ArgumentException">The <paramref name="assetName"/> is empty or contains invalid characters.</exception>
+        /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
+        T Load<T>(IAssetName assetName);
+
+        /// <summary>Remove an asset from the content cache so it's reloaded on the next request. This will reload core game assets if needed, but references to the former asset will still show the previous content.</summary>
+        /// <param name="assetName">The asset key to invalidate in the content folder.</param>
+        /// <exception cref="ArgumentException">The <paramref name="assetName"/> is empty or contains invalid characters.</exception>
+        /// <returns>Returns whether the given asset key was cached.</returns>
+        bool InvalidateCache(string assetName);
+
+        /// <summary>Remove an asset from the content cache so it's reloaded on the next request. This will reload core game assets if needed, but references to the former asset will still show the previous content.</summary>
+        /// <param name="assetName">The asset key to invalidate in the content folder.</param>
+        /// <exception cref="ArgumentException">The <paramref name="assetName"/> is empty or contains invalid characters.</exception>
+        /// <returns>Returns whether the given asset key was cached.</returns>
+        bool InvalidateCache(IAssetName assetName);
+
+        /// <summary>Remove all assets of the given type from the cache so they're reloaded on the next request. <b>This can be a very expensive operation and should only be used in very specific cases.</b> This will reload core game assets if needed, but references to the former assets will still show the previous content.</summary>
+        /// <typeparam name="T">The asset type to remove from the cache.</typeparam>
+        /// <returns>Returns whether any assets were invalidated.</returns>
+        bool InvalidateCache<T>();
+
+        /// <summary>Remove matching assets from the content cache so they're reloaded on the next request. This will reload core game assets if needed, but references to the former asset will still show the previous content.</summary>
+        /// <param name="predicate">A predicate matching the assets to invalidate.</param>
+        /// <returns>Returns whether any cache entries were invalidated.</returns>
+        bool InvalidateCache(Func<IAssetInfo, bool> predicate);
+
+        /// <summary>Get a patch helper for arbitrary data.</summary>
+        /// <typeparam name="T">The data type.</typeparam>
+        /// <param name="data">The asset data.</param>
+        /// <param name="assetName">The asset name. This is only used for tracking purposes and has no effect on the patch helper.</param>
+        IAssetData GetPatchHelper<T>(T data, string assetName = null);
+    }
+}
diff --git a/src/SMAPI/IModContentHelper.cs b/src/SMAPI/IModContentHelper.cs
new file mode 100644
index 00000000..e3431365
--- /dev/null
+++ b/src/SMAPI/IModContentHelper.cs
@@ -0,0 +1,32 @@
+using System;
+using Microsoft.Xna.Framework.Content;
+using Microsoft.Xna.Framework.Graphics;
+using xTile;
+
+namespace StardewModdingAPI
+{
+    /// <summary>Provides an API for loading content assets from the current mod's folder.</summary>
+    public interface IModContentHelper : IModLinked
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Load content from the mod folder and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
+        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
+        /// <param name="relativePath">The local path to a content file relative to the mod folder.</param>
+        /// <exception cref="ArgumentException">The <paramref name="relativePath"/> is empty or contains invalid characters.</exception>
+        /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
+        T Load<T>(string relativePath);
+
+        /// <summary>Get the internal asset name which allows loading a mod file through any of the game's content managers. This can be used when passing asset names directly to the game (e.g. for map tilesheets), but should be avoided if you can use <see cref="Load{T}"/> instead. This does not validate whether the asset exists.</summary>
+        /// <param name="relativePath">The local path to a content file relative to the mod folder.</param>
+        /// <exception cref="ArgumentException">The <paramref name="relativePath"/> is empty or contains invalid characters.</exception>
+        IAssetName GetInternalAssetName(string relativePath);
+
+        /// <summary>Get a patch helper for arbitrary data.</summary>
+        /// <typeparam name="T">The data type.</typeparam>
+        /// <param name="data">The asset data.</param>
+        /// <param name="relativePath">The local path to the content file being edited relative to the mod folder. This is only used for tracking purposes and has no effect on the patch helper.</param>
+        IAssetData GetPatchHelper<T>(T data, string relativePath = null);
+    }
+}
diff --git a/src/SMAPI/IModHelper.cs b/src/SMAPI/IModHelper.cs
index cd746e06..15e4ed8d 100644
--- a/src/SMAPI/IModHelper.cs
+++ b/src/SMAPI/IModHelper.cs
@@ -1,3 +1,4 @@
+using System;
 using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI
@@ -17,13 +18,22 @@ namespace StardewModdingAPI
         /// <summary>An API for managing console commands.</summary>
         ICommandHelper ConsoleCommands { get; }
 
+        /// <summary>An API for loading content assets from the game's <c>Content</c> folder or using the <see cref="IModEvents.Content"/> events.</summary>
+        IGameContentHelper GameContent { get; }
+
+        /// <summary>An API for loading content assets from your mod's files.</summary>
+        /// <remarks>This API is intended for reading content assets from the mod files (like game data, images, etc); see also <see cref="Data"/> which is intended for persisting internal mod data.</remarks>
+        IModContentHelper ModContent { get; }
+
         /// <summary>An API for loading content assets.</summary>
+        [Obsolete($"Use {nameof(IGameContentHelper)} or {nameof(IModContentHelper)} instead.")]
         IContentHelper Content { get; }
 
         /// <summary>An API for managing content packs.</summary>
         IContentPackHelper ContentPacks { get; }
 
         /// <summary>An API for reading and writing persistent mod data.</summary>
+        /// <remarks>This API is intended for persisting internal mod data; see also <see cref="ModContent"/> which is intended for reading content assets (like game data, images, etc).</remarks>
         IDataHelper Data { get; }
 
         /// <summary>An API for checking and changing input state.</summary>

From 6ad8ca932eb697a76dd9df43d6ae93c7ca4b2af5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 1 Apr 2022 00:33:35 -0400
Subject: [PATCH 487/856] keep old XNB file extension behavior for backwards
 compatibility (#766)

---
 src/SMAPI.sln.DotSettings                     |  1 +
 .../ContentManagers/BaseContentManager.cs     | 22 ++++++++++++++++---
 .../ContentManagers/ModContentManager.cs      | 15 +++----------
 src/SMAPI/Metadata/CoreAssetPropagator.cs     |  2 --
 4 files changed, 23 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index 71cd7b82..b85185d5 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -53,6 +53,7 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pathoschild/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=premultiplied/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=premultiply/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Prenormalize/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=prerelease/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=pufferchick/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rewriter/@EntryIndexedValue">True</s:Boolean>
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index f41a9354..2d921cc3 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -104,20 +104,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <inheritdoc />
         [Obsolete("This method is implemented for the base game and should not be used directly. To load an asset from the underlying content manager directly, use " + nameof(BaseContentManager.RawLoad) + " instead.")]
-        public override T LoadBase<T>(string assetName)
+        public sealed override T LoadBase<T>(string assetName)
         {
             return this.Load<T>(assetName, LanguageCode.en);
         }
 
         /// <inheritdoc />
-        public override T Load<T>(string assetName)
+        public sealed override T Load<T>(string assetName)
         {
             return this.Load<T>(assetName, this.Language);
         }
 
         /// <inheritdoc />
-        public override T Load<T>(string assetName, LanguageCode language)
+        public sealed override T Load<T>(string assetName, LanguageCode language)
         {
+            assetName = this.PrenormalizeRawAssetName(assetName);
             IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
             return this.LoadLocalized<T>(parsedName, language, useCache: true);
         }
@@ -276,6 +277,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
+        /// <summary>Apply initial normalization to a raw asset name before it's parsed.</summary>
+        /// <param name="assetName">The asset name to normalize.</param>
+        private string PrenormalizeRawAssetName(string assetName)
+        {
+            // trim
+            assetName = assetName?.Trim();
+
+            // For legacy reasons, mods can pass .xnb file extensions to the content pipeline which
+            // are then stripped. This will be re-added as needed when reading from raw files.
+            if (assetName?.EndsWith(".xnb") == true)
+                assetName = assetName[..^".xnb".Length];
+
+            return assetName;
+        }
+
         /// <summary>Normalize path separators in a file path. For asset keys, see <see cref="AssertAndNormalizeAssetName"/> instead.</summary>
         /// <param name="path">The file path to normalize.</param>
         [Pure]
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 2a5a3f16..63b40d66 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -32,9 +32,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>The game content manager used for map tilesheets not provided by the mod.</summary>
         private readonly IContentManager GameContentManager;
 
-        /// <summary>The language code for language-agnostic mod assets.</summary>
-        private readonly LanguageCode DefaultLanguage = Constants.DefaultLanguage;
-
         /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
         private readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
 
@@ -75,12 +72,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return file.Exists;
         }
 
-        /// <inheritdoc />
-        public override T Load<T>(string assetName)
-        {
-            return this.Load<T>(assetName, this.DefaultLanguage);
-        }
-
         /// <inheritdoc />
         public override T LoadExact<T>(IAssetName assetName, bool useCache)
         {
@@ -222,14 +213,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private FileInfo GetModFile(string path)
         {
             // try exact match
-            FileInfo file = new FileInfo(Path.Combine(this.FullRootDirectory, path));
+            FileInfo file = new(Path.Combine(this.FullRootDirectory, path));
 
             // try with default extension
-            if (!file.Exists && file.Extension == string.Empty)
+            if (!file.Exists)
             {
                 foreach (string extension in this.LocalTilesheetExtensions)
                 {
-                    FileInfo result = new FileInfo(file.FullName + extension);
+                    FileInfo result = new(file.FullName + extension);
                     if (result.Exists)
                     {
                         file = result;
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 832148aa..424abc18 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -95,8 +95,6 @@ namespace StardewModdingAPI.Metadata
                 .Distinct()
                 .ToDictionary(name => name, _ => false);
 
-            this.Monitor.Log($"Propagating: {propagatedAssets.Keys.OrderBy(p => p.Name, StringComparer.OrdinalIgnoreCase)}", LogLevel.Alert);
-
             // group into optimized lists
             var buckets = assets.GroupBy(p =>
             {

From 61d857c41fc2b90cd495c4923251cb1ed472e5ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Patrick=20M=C3=BCssig?= <patrick.muessig@gmx.de>
Date: Sat, 2 Apr 2022 03:47:52 +0200
Subject: [PATCH 488/856] Added support for `--developer-mode true|false`

Minimal changes required to enable/disable developer mode  via command
line argument. This commit does not include any error handling for
invalid values how ever they will be ignored and not crash the game.
---
 src/SMAPI/Framework/SCore.cs | 10 +++++++++-
 src/SMAPI/Program.cs         | 19 +++++++++++++++++--
 2 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index b4aa3595..801a7237 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -168,7 +168,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>Construct an instance.</summary>
         /// <param name="modsPath">The path to search for mods.</param>
         /// <param name="writeToConsole">Whether to output log messages to the console.</param>
-        public SCore(string modsPath, bool writeToConsole)
+        /// <param name="developerModeValue">null if not modified else whether to use developer mode</param>
+        public SCore(string modsPath, bool writeToConsole, bool? developerModeValue)
         {
             SCore.Instance = this;
 
@@ -183,6 +184,13 @@ namespace StardewModdingAPI.Framework
 
             // init basics
             this.Settings = JsonConvert.DeserializeObject<SConfig>(File.ReadAllText(Constants.ApiConfigPath));
+
+            // temporary overwrite DeveloperMode Setting
+            if (developerModeValue.HasValue)
+            {
+                this.Settings.DeveloperMode = developerModeValue.Value;
+            }
+
             if (File.Exists(Constants.ApiUserConfigPath))
                 JsonConvert.PopulateObject(File.ReadAllText(Constants.ApiUserConfigPath), this.Settings);
 
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index f2f65287..32bf0bdd 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -179,15 +179,30 @@ namespace StardewModdingAPI
             bool writeToConsole = !args.Contains("--no-terminal") && Environment.GetEnvironmentVariable("SMAPI_NO_TERMINAL") == null;
 
             // get mods path
+            bool? developerModeValue = null;
             string modsPath;
             {
                 string rawModsPath = null;
 
-                // get from command line args
+                // get mods path from command line args
                 int pathIndex = Array.LastIndexOf(args, "--mods-path") + 1;
                 if (pathIndex >= 1 && args.Length >= pathIndex)
                     rawModsPath = args[pathIndex];
 
+                // get developer mode from command line args
+                int developerModeValueIndex = Array.LastIndexOf(args, "--developer-mode") + 1;
+                if (developerModeValueIndex >= 1 && args.Length >= developerModeValueIndex)
+                {
+                    if (args[developerModeValueIndex].ToLower().Equals("true"))
+                    {
+                        developerModeValue = true;
+                    }
+                    else if (args[developerModeValueIndex].ToLower().Equals("false"))
+                    {
+                        developerModeValue = false;
+                    }
+                }
+
                 // get from environment variables
                 if (string.IsNullOrWhiteSpace(rawModsPath))
                     rawModsPath = Environment.GetEnvironmentVariable("SMAPI_MODS_PATH");
@@ -199,7 +214,7 @@ namespace StardewModdingAPI
             }
 
             // load SMAPI
-            using SCore core = new SCore(modsPath, writeToConsole);
+            using SCore core = new SCore(modsPath, writeToConsole, developerModeValue);
             core.RunInteractively();
         }
 

From bac1f34f65412419656eea15ea81081f8a29867e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 1 Apr 2022 22:59:50 -0400
Subject: [PATCH 489/856] fix local file path asset name parsing locale codes
 in rare cases (#766)

Mod file paths can't be localized through the content pipeline. Normally the locale would be ignored anyway due to the file extension, but it'd be incorrectly parsed if the file name ended with a locale and no file extension (like "assets/example.fr-FR").
---
 src/SMAPI/Framework/ContentCoordinator.cs     | 20 ++++++++++++-------
 .../ContentManagers/BaseContentManager.cs     |  6 +++---
 .../ContentManagers/ModContentManager.cs      |  6 +++---
 .../Framework/ModHelpers/ContentHelper.cs     | 12 +++++------
 .../Framework/ModHelpers/GameContentHelper.cs |  6 +++---
 .../Framework/ModHelpers/ModContentHelper.cs  |  4 ++--
 6 files changed, 30 insertions(+), 24 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 108257bf..8483d45d 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -156,7 +156,7 @@ namespace StardewModdingAPI.Framework
             );
             this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
-            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations, this.ParseAssetName);
+            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations, name => this.ParseAssetName(name, allowLocales: true));
             this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(customLanguages: Enumerable.Empty<ModLanguage>()));
         }
 
@@ -269,11 +269,17 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Parse a raw asset name.</summary>
         /// <param name="rawName">The raw asset name to parse.</param>
+        /// <param name="allowLocales">Whether to parse locales in the <paramref name="rawName"/>. If this is false, any locale codes in the name are treated as if they were part of the base name (e.g. for mod files).</param>
         /// <exception cref="ArgumentException">The <paramref name="rawName"/> is null or empty.</exception>
-        public AssetName ParseAssetName(string rawName)
+        public AssetName ParseAssetName(string rawName, bool allowLocales)
         {
             return !string.IsNullOrWhiteSpace(rawName)
-                ? AssetName.Parse(rawName, parseLocale: locale => this.LocaleCodes.Value.TryGetValue(locale, out LocalizedContentManager.LanguageCode langCode) ? langCode : null)
+                ? AssetName.Parse(
+                    rawName: rawName,
+                    parseLocale: allowLocales
+                        ? locale => this.LocaleCodes.Value.TryGetValue(locale, out LocalizedContentManager.LanguageCode langCode) ? langCode : null
+                        : _ => null
+                )
                 : throw new ArgumentException("The asset name can't be null or empty.", nameof(rawName));
         }
 
@@ -303,7 +309,7 @@ namespace StardewModdingAPI.Framework
             if (parts.Length != 3) // managed key prefix, mod id, relative path
                 return false;
             contentManagerID = Path.Combine(parts[0], parts[1]);
-            relativePath = this.ParseAssetName(parts[2]);
+            relativePath = this.ParseAssetName(parts[2], allowLocales: false);
             return true;
         }
 
@@ -357,7 +363,7 @@ namespace StardewModdingAPI.Framework
             string locale = this.GetLocale();
             return this.InvalidateCache((_, rawName, type) =>
             {
-                IAssetName assetName = this.ParseAssetName(rawName);
+                IAssetName assetName = this.ParseAssetName(rawName, allowLocales: true);
                 IAssetInfo info = new AssetInfo(locale, assetName, type, this.MainContentManager.AssertAndNormalizeAssetName);
                 return predicate(info);
             }, dispose);
@@ -378,7 +384,7 @@ namespace StardewModdingAPI.Framework
                 {
                     foreach ((string key, object asset) in contentManager.InvalidateCache((key, type) => predicate(contentManager, key, type), dispose))
                     {
-                        AssetName assetName = this.ParseAssetName(key);
+                        AssetName assetName = this.ParseAssetName(key, allowLocales: true);
                         if (!invalidatedAssets.ContainsKey(assetName))
                             invalidatedAssets[assetName] = asset.GetType();
                     }
@@ -394,7 +400,7 @@ namespace StardewModdingAPI.Framework
                             continue;
 
                         // get map path
-                        AssetName mapPath = this.ParseAssetName(this.MainContentManager.AssertAndNormalizeAssetName(location.mapPath.Value));
+                        AssetName mapPath = this.ParseAssetName(this.MainContentManager.AssertAndNormalizeAssetName(location.mapPath.Value), allowLocales: true);
                         if (!invalidatedAssets.ContainsKey(mapPath) && predicate(this.MainContentManager, mapPath.Name, typeof(Map)))
                             invalidatedAssets[mapPath] = typeof(Map);
                     }
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 2d921cc3..31199b3a 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -119,7 +119,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         public sealed override T Load<T>(string assetName, LanguageCode language)
         {
             assetName = this.PrenormalizeRawAssetName(assetName);
-            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName);
+            IAssetName parsedName = this.Coordinator.ParseAssetName(assetName, allowLocales: this.TryLocalizeKeys);
             return this.LoadLocalized<T>(parsedName, language, useCache: true);
         }
 
@@ -161,7 +161,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // use cached key
             string rawName = LocalizedContentManager.localizedAssetNames[assetName.Name];
             if (assetName.Name != rawName)
-                assetName = this.Coordinator.ParseAssetName(rawName);
+                assetName = this.Coordinator.ParseAssetName(rawName, allowLocales: this.TryLocalizeKeys);
             return this.LoadExact<T>(assetName, useCache: useCache);
         }
 
@@ -213,7 +213,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             IDictionary<string, object> removeAssets = new Dictionary<string, object>(StringComparer.OrdinalIgnoreCase);
             this.Cache.Remove((key, asset) =>
             {
-                string baseAssetName = this.Coordinator.ParseAssetName(key).BaseName;
+                string baseAssetName = this.Coordinator.ParseAssetName(key, allowLocales: this.TryLocalizeKeys).BaseName;
 
                 // check if asset should be removed
                 bool remove = removeAssets.ContainsKey(baseAssetName);
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 63b40d66..9ed989da 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -111,7 +111,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         {
                             // the underlying content manager adds a .xnb extension implicitly, so
                             // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
-                            IAssetName loadName = this.Coordinator.ParseAssetName(assetName.Name[..^".xnb".Length]);
+                            IAssetName loadName = this.Coordinator.ParseAssetName(assetName.Name[..^".xnb".Length], allowLocales: false);
 
                             // load asset
                             asset = this.RawLoad<T>(loadName, useCache: false);
@@ -201,7 +201,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             string relativePath = PathUtilities.GetRelativePath(this.RootDirectory, file.FullName);
             string internalKey = Path.Combine(this.Name, relativePath);
 
-            return this.Coordinator.ParseAssetName(internalKey);
+            return this.Coordinator.ParseAssetName(internalKey, allowLocales: false);
         }
 
 
@@ -343,7 +343,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // get from game assets
-            IAssetName contentKey = this.Coordinator.ParseAssetName(this.GetContentKeyForTilesheetImageSource(relativePath));
+            IAssetName contentKey = this.Coordinator.ParseAssetName(this.GetContentKeyForTilesheetImageSource(relativePath), allowLocales: false);
             try
             {
                 this.GameContentManager.LoadLocalized<Texture2D>(contentKey, this.GameContentManager.Language, useCache: true); // no need to bypass cache here, since we're not storing the asset
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index b0064532..ae914c46 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -107,7 +107,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <inheritdoc />
         public T Load<T>(string key, ContentSource source = ContentSource.ModFolder)
         {
-            IAssetName assetName = this.ContentCore.ParseAssetName(key);
+            IAssetName assetName = this.ContentCore.ParseAssetName(key, allowLocales: source == ContentSource.GameContent);
 
             try
             {
@@ -157,21 +157,21 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public bool InvalidateCache(string key)
         {
             string actualKey = this.GetActualAssetKey(key, ContentSource.GameContent);
-            this.Monitor.Log($"Requested cache invalidation for '{actualKey}'.", LogLevel.Trace);
+            this.Monitor.Log($"Requested cache invalidation for '{actualKey}'.");
             return this.ContentCore.InvalidateCache(asset => asset.Name.IsEquivalentTo(actualKey)).Any();
         }
 
         /// <inheritdoc />
         public bool InvalidateCache<T>()
         {
-            this.Monitor.Log($"Requested cache invalidation for all assets of type {typeof(T)}. This is an expensive operation and should be avoided if possible.", LogLevel.Trace);
-            return this.ContentCore.InvalidateCache((contentManager, key, type) => typeof(T).IsAssignableFrom(type)).Any();
+            this.Monitor.Log($"Requested cache invalidation for all assets of type {typeof(T)}. This is an expensive operation and should be avoided if possible.");
+            return this.ContentCore.InvalidateCache((_, _, type) => typeof(T).IsAssignableFrom(type)).Any();
         }
 
         /// <inheritdoc />
         public bool InvalidateCache(Func<IAssetInfo, bool> predicate)
         {
-            this.Monitor.Log("Requested cache invalidation for all assets matching a predicate.", LogLevel.Trace);
+            this.Monitor.Log("Requested cache invalidation for all assets matching a predicate.");
             return this.ContentCore.InvalidateCache(predicate).Any();
         }
 
@@ -183,7 +183,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             assetName ??= $"temp/{Guid.NewGuid():N}";
 
-            return new AssetDataForObject(this.CurrentLocale, this.ContentCore.ParseAssetName(assetName), data, this.NormalizeAssetName);
+            return new AssetDataForObject(this.CurrentLocale, this.ContentCore.ParseAssetName(assetName, allowLocales: true/* no way to know if it's a game or mod asset here*/), data, this.NormalizeAssetName);
         }
 
 
diff --git a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
index 42a4de20..0eb385d4 100644
--- a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
@@ -58,13 +58,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <inheritdoc />
         public IAssetName ParseAssetName(string rawName)
         {
-            return this.ContentCore.ParseAssetName(rawName);
+            return this.ContentCore.ParseAssetName(rawName, allowLocales: true);
         }
 
         /// <inheritdoc />
         public T Load<T>(string key)
         {
-            IAssetName assetName = this.ContentCore.ParseAssetName(key);
+            IAssetName assetName = this.ContentCore.ParseAssetName(key, allowLocales: true);
             return this.Load<T>(assetName);
         }
 
@@ -117,7 +117,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             assetName ??= $"temp/{Guid.NewGuid():N}";
 
-            return new AssetDataForObject(this.CurrentLocale, this.ContentCore.ParseAssetName(assetName), data, key => this.ParseAssetName(key).Name);
+            return new AssetDataForObject(this.CurrentLocale, this.ContentCore.ParseAssetName(assetName, allowLocales: true), data, key => this.ParseAssetName(key).Name);
         }
 
         /// <summary>Get the underlying game content manager.</summary>
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index 45899dd7..2379583c 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -43,7 +43,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <inheritdoc />
         public T Load<T>(string relativePath)
         {
-            IAssetName assetName = this.ContentCore.ParseAssetName(relativePath);
+            IAssetName assetName = this.ContentCore.ParseAssetName(relativePath, allowLocales: false);
 
             try
             {
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             relativePath ??= $"temp/{Guid.NewGuid():N}";
 
-            return new AssetDataForObject(this.ContentCore.GetLocale(), this.ContentCore.ParseAssetName(relativePath), data, key => this.ContentCore.ParseAssetName(key).Name);
+            return new AssetDataForObject(this.ContentCore.GetLocale(), this.ContentCore.ParseAssetName(relativePath, allowLocales: false), data, key => this.ContentCore.ParseAssetName(key, allowLocales: false).Name);
         }
     }
 }

From 4e2d7f2550b05e410735f51beac76ed040178cf4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 1 Apr 2022 23:42:37 -0400
Subject: [PATCH 490/856] make mod file paths case-insensitive in all SMAPI
 APIs

---
 docs/release-notes.md                         |  15 ++-
 src/SMAPI/Framework/ContentCoordinator.cs     |  22 +++-
 .../ContentManagers/ModContentManager.cs      |  14 +-
 src/SMAPI/Framework/ContentPack.cs            |  38 ++----
 .../Framework/ModHelpers/ModContentHelper.cs  |  16 ++-
 src/SMAPI/Framework/SCore.cs                  |  15 ++-
 .../Utilities/CaseInsensitivePathCache.cs     | 124 ++++++++++++++++++
 7 files changed, 200 insertions(+), 44 deletions(-)
 create mode 100644 src/SMAPI/Utilities/CaseInsensitivePathCache.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2e09240c..6d505d40 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,7 @@
   * Improved Linux/macOS [command-line arguments](technical/smapi.md#command-line-arguments):
     * Added `--use-current-shell` to avoid opening a separate terminal window.
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
+  * SMAPI now fixes many case-sensitive mod file path issues automatically.
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
 
 * For the Console Commands mod:
@@ -15,12 +16,14 @@
   * Fixed `set_farm_type` not updating warps.
 
 * For mod authors:
-  * **Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.**  
-    _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
-  * **Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.**
-  * **Overhauled [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying** (thanks to Shockah!).  
-    _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
-  * **Deprecation warning:** The upcoming SMAPI 4.0 will remove deprecated APIs and break mods which haven't updated yet.  
+  * **Major changes as part of the upcoming SMAPI 4.0.0:**
+    * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
+      _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
+    * Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.
+    * Overhauled [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
+      _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
+    * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
+    * **Deprecation warning:** The upcoming SMAPI 4.0 will remove deprecated APIs and break mods which haven't updated yet.  
     _See [_Migrate to SMAPI 4.0_](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0) for help updating your mod code. You can update your mod code now, there's no need to wait for the 4.0.0 release (which will happen in at least three months, and possibly later if needed to update open-source mods)._
   * Added `IContentPack.ModContent` property.
   * Added `Constants.ContentPath`.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 8483d45d..cd1de4a8 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -15,7 +15,7 @@ using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
 using StardewModdingAPI.Metadata;
 using StardewModdingAPI.Toolkit.Serialization;
-using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.GameData;
 using xTile;
@@ -80,6 +80,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
         private readonly TickCacheDictionary<IAssetName, AssetOperationGroup[]> AssetOperationsByKey = new();
 
+        /// <summary>The previously created case-insensitive path caches by root path.</summary>
+        private readonly Dictionary<string, CaseInsensitivePathCache> CaseInsensitivePathCaches = new(StringComparer.OrdinalIgnoreCase);
+
 
         /*********
         ** Accessors
@@ -91,9 +94,11 @@ namespace StardewModdingAPI.Framework
         public LocalizedContentManager.LanguageCode Language => this.MainContentManager.Language;
 
         /// <summary>Interceptors which provide the initial versions of matching assets.</summary>
+        [Obsolete]
         public IList<ModLinked<IAssetLoader>> Loaders { get; } = new List<ModLinked<IAssetLoader>>();
 
         /// <summary>Interceptors which edit matching assets after they're loaded.</summary>
+        [Obsolete]
         public IList<ModLinked<IAssetEditor>> Editors { get; } = new List<ModLinked<IAssetEditor>>();
 
         /// <summary>The absolute path to the <see cref="ContentManager.RootDirectory"/>.</summary>
@@ -205,7 +210,8 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
-                    aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations
+                    aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations,
+                    relativePathCache: this.GetCaseInsensitivePathCache(rootDirectory)
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
@@ -477,6 +483,18 @@ namespace StardewModdingAPI.Framework
             });
         }
 
+        /// <summary>Get a dictionary of relative paths within a root path, for case-insensitive file lookups.</summary>
+        /// <param name="rootPath">The root path to scan.</param>
+        public CaseInsensitivePathCache GetCaseInsensitivePathCache(string rootPath)
+        {
+            rootPath = PathUtilities.NormalizePath(rootPath);
+
+            if (!this.CaseInsensitivePathCaches.TryGetValue(rootPath, out CaseInsensitivePathCache cache))
+                this.CaseInsensitivePathCaches[rootPath] = cache = new CaseInsensitivePathCache(rootPath);
+
+            return cache;
+        }
+
         /// <summary>Get the tilesheet ID order used by the unmodified version of a map asset.</summary>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
         public TilesheetReference[] GetVanillaTilesheetIds(string assetName)
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 9ed989da..a451fd7c 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -9,7 +9,7 @@ using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Serialization;
-using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Utilities;
 using StardewValley;
 using xTile;
 using xTile.Format;
@@ -32,6 +32,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>The game content manager used for map tilesheets not provided by the mod.</summary>
         private readonly IContentManager GameContentManager;
 
+        /// <summary>A case-insensitive lookup of relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
+        private readonly CaseInsensitivePathCache RelativePathCache;
+
         /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
         private readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
 
@@ -52,10 +55,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, bool aggressiveMemoryOptimizations)
+        /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="rootDirectory"/>.</param>
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, bool aggressiveMemoryOptimizations, CaseInsensitivePathCache relativePathCache)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true, aggressiveMemoryOptimizations: aggressiveMemoryOptimizations)
         {
             this.GameContentManager = gameContentManager;
+            this.RelativePathCache = relativePathCache;
             this.JsonHelper = jsonHelper;
             this.ModName = modName;
 
@@ -198,7 +203,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         public IAssetName GetInternalAssetKey(string key)
         {
             FileInfo file = this.GetModFile(key);
-            string relativePath = PathUtilities.GetRelativePath(this.RootDirectory, file.FullName);
+            string relativePath = Path.GetRelativePath(this.RootDirectory, file.FullName);
             string internalKey = Path.Combine(this.Name, relativePath);
 
             return this.Coordinator.ParseAssetName(internalKey, allowLocales: false);
@@ -212,6 +217,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="path">The asset path relative to the content folder.</param>
         private FileInfo GetModFile(string path)
         {
+            // map to case-insensitive path if needed
+            path = this.RelativePathCache.GetFilePath(path);
+
             // try exact match
             FileInfo file = new(Path.Combine(this.FullRootDirectory, path));
 
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index 3920354e..e02ef88b 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -1,9 +1,8 @@
 using System;
-using System.Collections.Generic;
 using System.IO;
 using StardewModdingAPI.Framework.ModHelpers;
 using StardewModdingAPI.Toolkit.Serialization;
-using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Utilities;
 
 namespace StardewModdingAPI.Framework
 {
@@ -16,8 +15,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>Encapsulates SMAPI's JSON file parsing.</summary>
         private readonly JsonHelper JsonHelper;
 
-        /// <summary>A cache of case-insensitive => exact relative paths within the content pack, for case-insensitive file lookups on Linux/macOS.</summary>
-        private readonly IDictionary<string, string> RelativePaths = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
+        /// <summary>A case-insensitive lookup of relative paths within the <see cref="DirectoryPath"/>.</summary>
+        private readonly CaseInsensitivePathCache RelativePathCache;
 
 
         /*********
@@ -48,19 +47,15 @@ namespace StardewModdingAPI.Framework
         /// <param name="content">Provides an API for loading content assets from the content pack's folder.</param>
         /// <param name="translation">Provides translations stored in the content pack's <c>i18n</c> folder.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
-        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper)
+        /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="directoryPath"/>.</param>
+        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper, CaseInsensitivePathCache relativePathCache)
         {
             this.DirectoryPath = directoryPath;
             this.Manifest = manifest;
             this.ModContent = content;
             this.TranslationImpl = translation;
             this.JsonHelper = jsonHelper;
-
-            foreach (string path in Directory.EnumerateFiles(this.DirectoryPath, "*", SearchOption.AllDirectories))
-            {
-                string relativePath = path.Substring(this.DirectoryPath.Length + 1);
-                this.RelativePaths[relativePath] = relativePath;
-            }
+            this.RelativePathCache = relativePathCache;
         }
 
         /// <inheritdoc />
@@ -90,8 +85,7 @@ namespace StardewModdingAPI.Framework
             FileInfo file = this.GetFile(path, out path);
             this.JsonHelper.WriteJsonFile(file.FullName, data);
 
-            if (!this.RelativePaths.ContainsKey(path))
-                this.RelativePaths[path] = path;
+            this.RelativePathCache.Add(path);
         }
 
         /// <inheritdoc />
@@ -112,18 +106,6 @@ namespace StardewModdingAPI.Framework
         /*********
         ** Private methods
         *********/
-        /// <summary>Get the real relative path from a case-insensitive path.</summary>
-        /// <param name="relativePath">The normalized relative path.</param>
-        private string GetCaseInsensitiveRelativePath(string relativePath)
-        {
-            if (!PathUtilities.IsSafeRelativePath(relativePath))
-                throw new InvalidOperationException($"You must call {nameof(IContentPack)} methods with a relative path.");
-
-            return !string.IsNullOrWhiteSpace(relativePath) && this.RelativePaths.TryGetValue(relativePath, out string caseInsensitivePath)
-                ? caseInsensitivePath
-                : relativePath;
-        }
-
         /// <summary>Get the underlying file info.</summary>
         /// <param name="relativePath">The normalized file path relative to the content pack directory.</param>
         private FileInfo GetFile(string relativePath)
@@ -136,7 +118,11 @@ namespace StardewModdingAPI.Framework
         /// <param name="actualRelativePath">The relative path after case-insensitive matching.</param>
         private FileInfo GetFile(string relativePath, out string actualRelativePath)
         {
-            actualRelativePath = this.GetCaseInsensitiveRelativePath(relativePath);
+            if (!PathUtilities.IsSafeRelativePath(relativePath))
+                throw new InvalidOperationException($"You must call {nameof(IContentPack)} methods with a relative path.");
+
+            actualRelativePath = this.RelativePathCache.GetFilePath(relativePath);
+
             return new FileInfo(Path.Combine(this.DirectoryPath, actualRelativePath));
         }
     }
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index 2379583c..7468cda1 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -1,7 +1,9 @@
 using System;
+using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Exceptions;
+using StardewModdingAPI.Utilities;
 
 namespace StardewModdingAPI.Framework.ModHelpers
 {
@@ -20,6 +22,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>The friendly mod name for use in errors.</summary>
         private readonly string ModName;
 
+        /// <summary>A case-insensitive lookup of relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
+        private readonly CaseInsensitivePathCache RelativePathCache;
+
 
         /*********
         ** Public methods
@@ -30,7 +35,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="modID">The unique ID of the relevant mod.</param>
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="gameContentManager">The game content manager used for map tilesheets not provided by the mod.</param>
-        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IContentManager gameContentManager)
+        /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="relativePathCache"/>.</param>
+        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IContentManager gameContentManager, CaseInsensitivePathCache relativePathCache)
             : base(modID)
         {
             string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
@@ -38,11 +44,14 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.ContentCore = contentCore;
             this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, modName, modFolderPath, gameContentManager);
             this.ModName = modName;
+            this.RelativePathCache = relativePathCache;
         }
 
         /// <inheritdoc />
         public T Load<T>(string relativePath)
         {
+            relativePath = this.RelativePathCache.GetAssetName(relativePath);
+
             IAssetName assetName = this.ContentCore.ParseAssetName(relativePath, allowLocales: false);
 
             try
@@ -58,6 +67,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <inheritdoc />
         public IAssetName GetInternalAssetName(string relativePath)
         {
+            relativePath = this.RelativePathCache.GetAssetName(relativePath);
             return this.ModContentManager.GetInternalAssetKey(relativePath);
         }
 
@@ -67,7 +77,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
             if (data == null)
                 throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
 
-            relativePath ??= $"temp/{Guid.NewGuid():N}";
+            relativePath = relativePath != null
+                ? this.RelativePathCache.GetAssetName(relativePath)
+                : $"temp/{Guid.NewGuid():N}";
 
             return new AssetDataForObject(this.ContentCore.GetLocale(), this.ContentCore.ParseAssetName(relativePath, allowLocales: false), data, key => this.ContentCore.ParseAssetName(key, allowLocales: false).Name);
         }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index b4aa3595..7fd5bcd3 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1775,10 +1775,11 @@ namespace StardewModdingAPI.Framework
             {
                 IManifest manifest = mod.Manifest;
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
+                CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
                 GameContentHelper gameContentHelper = new(this.ContentCore, manifest.UniqueID, mod.DisplayName, monitor);
-                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager());
+                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache);
                 TranslationHelper translationHelper = new(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
-                IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, modContentHelper, translationHelper, jsonHelper);
+                IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, modContentHelper, translationHelper, jsonHelper, relativePathCache);
                 mod.SetMod(contentPack, monitor, translationHelper);
                 this.ModRegistry.Add(mod);
 
@@ -1856,11 +1857,14 @@ namespace StardewModdingAPI.Framework
                         IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest)
                         {
                             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
+
+                            CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(packDirPath);
+
                             GameContentHelper gameContentHelper = new(contentCore, packManifest.UniqueID, packManifest.Name, packMonitor);
-                            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, gameContentHelper.GetUnderlyingContentManager());
+                            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache);
                             TranslationHelper packTranslationHelper = new(packManifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
 
-                            ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper);
+                            ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, relativePathCache);
                             this.ReloadTranslationsForTemporaryContentPack(mod, contentPack);
                             mod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
                             return contentPack;
@@ -1868,9 +1872,10 @@ namespace StardewModdingAPI.Framework
 
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
+                        CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
                         IContentHelper contentHelper = new ContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor);
                         GameContentHelper gameContentHelper = new(contentCore, manifest.UniqueID, mod.DisplayName, monitor);
-                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager());
+                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache);
                         IContentPackHelper contentPackHelper = new ContentPackHelper(manifest.UniqueID, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
                         IDataHelper dataHelper = new DataHelper(manifest.UniqueID, mod.DirectoryPath, jsonHelper);
                         IReflectionHelper reflectionHelper = new ReflectionHelper(manifest.UniqueID, mod.DisplayName, this.Reflection);
diff --git a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs b/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
new file mode 100644
index 00000000..1d947b53
--- /dev/null
+++ b/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
@@ -0,0 +1,124 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+
+namespace StardewModdingAPI.Utilities
+{
+    /// <summary>Provides an API for case-insensitive relative path lookups within a root directory.</summary>
+    internal class CaseInsensitivePathCache
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The root directory path for relative paths.</summary>
+        private readonly string RootPath;
+
+        /// <summary>A case-insensitive lookup of file paths within the <see cref="RootPath"/>. Each path is listed in both file path and asset name format, so it's usable in both contexts without needing to re-parse paths.</summary>
+        private readonly Lazy<Dictionary<string, string>> RelativePathCache;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="rootPath">The root directory path for relative paths.</param>
+        public CaseInsensitivePathCache(string rootPath)
+        {
+            this.RootPath = rootPath;
+            this.RelativePathCache = new(this.GetRelativePathCache);
+        }
+
+        /// <summary>Get the exact capitalization for a given relative file path.</summary>
+        /// <param name="relativePath">The relative path.</param>
+        /// <remarks>Returns the resolved path in file path format, else the normalized <paramref name="relativePath"/>.</remarks>
+        public string GetFilePath(string relativePath)
+        {
+            return this.GetImpl(PathUtilities.NormalizePath(relativePath));
+        }
+
+        /// <summary>Get the exact capitalization for a given asset name.</summary>
+        /// <param name="relativePath">The relative path.</param>
+        /// <remarks>Returns the resolved path in asset name format, else the normalized <paramref name="relativePath"/>.</remarks>
+        public string GetAssetName(string relativePath)
+        {
+            return this.GetImpl(PathUtilities.NormalizeAssetName(relativePath));
+        }
+
+        /// <summary>Add a relative path that was just created by a SMAPI API.</summary>
+        /// <param name="relativePath">The relative path. This must already be normalized in asset name or file path format.</param>
+        public void Add(string relativePath)
+        {
+            // skip if cache isn't created yet (no need to add files manually in that case)
+            if (!this.RelativePathCache.IsValueCreated)
+                return;
+
+            // skip if already cached
+            if (this.RelativePathCache.Value.ContainsKey(relativePath))
+                return;
+
+            // make sure path exists
+            relativePath = PathUtilities.NormalizePath(relativePath);
+            if (!File.Exists(Path.Combine(this.RootPath, relativePath)))
+                throw new InvalidOperationException($"Can't add relative path '{relativePath}' to the case-insensitive cache for '{this.RootPath}' because that file doesn't exist.");
+
+            // cache path
+            this.CacheRawPath(this.RelativePathCache.Value, relativePath);
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get the exact capitalization for a given relative path.</summary>
+        /// <param name="relativePath">The relative path. This must already be normalized into asset name or file path format (i.e. using <see cref="PathUtilities.NormalizeAssetName"/> or <see cref="PathUtilities.NormalizePath"/> respectively).</param>
+        /// <remarks>Returns the resolved path in the same format if found, else returns the path as-is.</remarks>
+        private string GetImpl(string relativePath)
+        {
+            // invalid path
+            if (string.IsNullOrWhiteSpace(relativePath))
+                return relativePath;
+
+            // already cached
+            if (this.RelativePathCache.Value.TryGetValue(relativePath, out string resolved))
+                return resolved;
+
+            // file exists but isn't cached for some reason
+            // cache it now so any later references to it are case-insensitive
+            if (File.Exists(Path.Combine(this.RootPath, relativePath)))
+            {
+                this.CacheRawPath(this.RelativePathCache.Value, relativePath);
+                return relativePath;
+            }
+
+            // no such file, keep capitalization as-is
+            return relativePath;
+        }
+
+        /// <summary>Get a case-insensitive lookup of file paths (see <see cref="RelativePathCache"/>).</summary>
+        private Dictionary<string, string> GetRelativePathCache()
+        {
+            Dictionary<string, string> cache = new(StringComparer.OrdinalIgnoreCase);
+
+            foreach (string path in Directory.EnumerateFiles(this.RootPath, "*", SearchOption.AllDirectories))
+            {
+                string relativePath = path.Substring(this.RootPath.Length + 1);
+
+                this.CacheRawPath(cache, relativePath);
+            }
+
+            return cache;
+        }
+
+        /// <summary>Add a raw relative path to the cache.</summary>
+        /// <param name="cache">The cache to update.</param>
+        /// <param name="relativePath">The relative path to cache, with its exact filesystem capitalization.</param>
+        private void CacheRawPath(IDictionary<string, string> cache, string relativePath)
+        {
+            string filePath = PathUtilities.NormalizePath(relativePath);
+            string assetName = PathUtilities.NormalizeAssetName(relativePath);
+
+            cache[filePath] = filePath;
+            cache[assetName] = assetName;
+        }
+    }
+}

From 6292b21f220d1936f8d2a5e1c883c9664be4973d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Apr 2022 14:59:09 -0400
Subject: [PATCH 491/856] fix tick cache using game ticks instead of SMAPI
 ticks

The game ticks aren't incremented consistently in some cases (e.g. while loading a save), which leads to the cache values being kept too long.
---
 src/SMAPI/Framework/Utilities/TickCacheDictionary.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
index 1613a480..5921e089 100644
--- a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
+++ b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.Utilities
         ** Fields
         *********/
         /// <summary>The last game tick for which data was cached.</summary>
-        private int LastGameTick = -1;
+        private uint? LastGameTick;
 
         /// <summary>The underlying cached data.</summary>
         private readonly Dictionary<TKey, TValue> Cache = new();
@@ -28,10 +28,10 @@ namespace StardewModdingAPI.Framework.Utilities
         public TValue GetOrSet(TKey cacheKey, Func<TValue> get)
         {
             // clear cache on new tick
-            if (Game1.ticks != this.LastGameTick)
+            if (SCore.TicksElapsed != this.LastGameTick)
             {
                 this.Cache.Clear();
-                this.LastGameTick = Game1.ticks;
+                this.LastGameTick = SCore.TicksElapsed;
             }
 
             // fetch value

From f58cdde981f7dfabb5783c80b29f4996d76cec30 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Apr 2022 15:12:05 -0400
Subject: [PATCH 492/856] fix errors due to null asset names in asset
 propagation

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 424abc18..159e19fd 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1238,6 +1238,9 @@ namespace StardewModdingAPI.Metadata
         /// <param name="right">The second value to compare.</param>
         private bool IsSameBaseName(IAssetName left, string right)
         {
+            if (left is null || right is null)
+                return false;
+
             IAssetName parsedB = this.ParseAssetNameOrNull(right);
             return this.IsSameBaseName(left, parsedB);
         }
@@ -1247,6 +1250,9 @@ namespace StardewModdingAPI.Metadata
         /// <param name="right">The second value to compare.</param>
         private bool IsSameBaseName(IAssetName left, IAssetName right)
         {
+            if (left is null || right is null)
+                return false;
+
             return left.IsEquivalentTo(right.BaseName, useBaseName: true);
         }
 

From 546b58778c9e1e983f1682f1b89cbc353939d9ea Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Apr 2022 19:13:27 -0400
Subject: [PATCH 493/856] switch to 'processing tick' for tick caching

This is incremented on each low-level tick (whether it's a game update, synchronized async operation, etc). That mainly avoids the cache persisting across the entire save loading process while it's being synchronized.
---
 src/SMAPI/Framework/SCore.cs                         | 8 +++++++-
 src/SMAPI/Framework/Utilities/TickCacheDictionary.cs | 5 ++---
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 7fd5bcd3..d0f5ffb4 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -158,9 +158,12 @@ namespace StardewModdingAPI.Framework
         /// <remarks>This is only intended for use by external code like the Error Handler mod.</remarks>
         internal static SCore Instance { get; private set; }
 
-        /// <summary>The number of update ticks which have already executed. This is similar to <see cref="Game1.ticks"/>, but incremented more consistently for every tick.</summary>
+        /// <summary>The number of game update ticks which have already executed. This is similar to <see cref="Game1.ticks"/>, but incremented more consistently for every tick.</summary>
         internal static uint TicksElapsed { get; private set; }
 
+        /// <summary>A specialized form of <see cref="TicksElapsed"/> which is incremented each time SMAPI performs a processing tick (whether that's a game update, one wait cycle while synchronizing code, etc).</summary>
+        internal static uint ProcessTicksElapsed { get; private set; }
+
 
         /*********
         ** Public methods
@@ -558,6 +561,7 @@ namespace StardewModdingAPI.Framework
             finally
             {
                 SCore.TicksElapsed++;
+                SCore.ProcessTicksElapsed++;
             }
         }
 
@@ -631,6 +635,8 @@ namespace StardewModdingAPI.Framework
                     this.Reflection.GetMethod(Game1.game1, "UpdateTitleScreen").Invoke(Game1.currentGameTime); // run game logic to change music on load, etc
                     while (Game1.currentLoader?.MoveNext() == true)
                     {
+                        SCore.ProcessTicksElapsed++;
+
                         // raise load stage changed
                         switch (Game1.currentLoader.Current)
                         {
diff --git a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
index 5921e089..d0f276d2 100644
--- a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
+++ b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
@@ -1,6 +1,5 @@
 using System;
 using System.Collections.Generic;
-using StardewValley;
 
 namespace StardewModdingAPI.Framework.Utilities
 {
@@ -28,10 +27,10 @@ namespace StardewModdingAPI.Framework.Utilities
         public TValue GetOrSet(TKey cacheKey, Func<TValue> get)
         {
             // clear cache on new tick
-            if (SCore.TicksElapsed != this.LastGameTick)
+            if (SCore.ProcessTicksElapsed != this.LastGameTick)
             {
                 this.Cache.Clear();
-                this.LastGameTick = SCore.TicksElapsed;
+                this.LastGameTick = SCore.ProcessTicksElapsed;
             }
 
             // fetch value

From 627472c506944ca103dbb9a011e827a31d02dead Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 2 Apr 2022 21:43:56 -0400
Subject: [PATCH 494/856] add temporary hack to fix compatibility between old &
 new APIs for some mods

---
 src/SMAPI/Framework/ContentCoordinator.cs | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index cd1de4a8..88ed96da 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -655,6 +655,27 @@ namespace StardewModdingAPI.Framework
                     continue;
                 }
 
+                // HACK
+                //
+                // If two editors have the same priority, they're applied in registration order (so
+                // whichever was registered first is applied first). Mods often depend on this
+                // behavior, like Json Assets registering its interceptors before Content Patcher.
+                //
+                // Unfortunately the old & new content APIs have separate lists, so new-API
+                // interceptors always ran before old-API interceptors with the same priority,
+                // regardless of the registration order *between* APIs. Since the new API works in
+                // a fundamentally different way (i.e. loads/edits are defined on asset request
+                // instead of by registering a global 'editor' or 'loader' class), there's no way
+                // to track registration order between them.
+                //
+                // Until we drop the old content API in SMAPI 4.0.0, this sets the priority for
+                // specific legacy editors to maintain compatibility.
+                AssetEditPriority priority = editor.Data.GetType().FullName switch
+                {
+                    "JsonAssets.Framework.ContentInjector1" => AssetEditPriority.Default - 1, // must be applied before Content Patcher
+                    _ => AssetEditPriority.Default
+                };
+
                 // add operation
                 yield return new AssetOperationGroup(
                     mod: editor.Mod,
@@ -663,7 +684,7 @@ namespace StardewModdingAPI.Framework
                     {
                         new AssetEditOperation(
                             mod: editor.Mod,
-                            priority: AssetEditPriority.Default,
+                            priority: priority,
                             onBehalfOf: null,
                             applyEdit: assetData => editor.Data.Edit<T>(
                                 this.GetLegacyAssetData(assetData)

From c9af1c452aeab89aa39e6e1521154a7fcc648f5a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 3 Apr 2022 15:44:26 -0400
Subject: [PATCH 495/856] fix incorrect deprecation warnings for helper.Content

---
 src/SMAPI/Framework/ModHelpers/ModHelper.cs | 11 +++++++++--
 src/SMAPI/Framework/SCore.cs                |  9 +++++----
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index d28faacc..5b567ee0 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         *********/
         /// <summary>The backing field for <see cref="Content"/>.</summary>
         [Obsolete]
-        private readonly IContentHelper ContentImpl;
+        private readonly ContentHelper ContentImpl;
 
 
         /*********
@@ -93,7 +93,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="translationHelper">An API for reading translations stored in the mod's <c>i18n</c> folder.</param>
         /// <exception cref="ArgumentNullException">An argument is null or empty.</exception>
         /// <exception cref="InvalidOperationException">The <paramref name="modDirectory"/> path does not exist on disk.</exception>
-        public ModHelper(string modID, string modDirectory, Func<SInputState> currentInputState, IModEvents events, IContentHelper contentHelper, IGameContentHelper gameContentHelper, IModContentHelper modContentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper)
+        public ModHelper(string modID, string modDirectory, Func<SInputState> currentInputState, IModEvents events, ContentHelper contentHelper, IGameContentHelper gameContentHelper, IModContentHelper modContentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper)
             : base(modID)
         {
             // validate directory
@@ -118,6 +118,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.Events = events;
         }
 
+        /// <summary>Get the underlying instance for <see cref="IContentHelper"/>.</summary>
+        [Obsolete]
+        public ContentHelper GetLegacyContentHelper()
+        {
+            return this.ContentImpl;
+        }
+
         /****
         ** Mod config file
         ****/
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index d0f5ffb4..1cc6a5b8 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1629,7 +1629,7 @@ namespace StardewModdingAPI.Framework
             foreach (IModMetadata metadata in loadedMods)
             {
                 // add interceptors
-                if (metadata.Mod.Helper.Content is ContentHelper helper)
+                if (metadata.Mod.Helper is ModHelper helper)
                 {
                     // ReSharper disable SuspiciousTypeConversion.Global
                     if (metadata.Mod is IAssetEditor editor)
@@ -1657,8 +1657,9 @@ namespace StardewModdingAPI.Framework
                     }
                     // ReSharper restore SuspiciousTypeConversion.Global
 
-                    helper.ObservableAssetEditors.CollectionChanged += (sender, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetEditor>(), e.OldItems?.Cast<IAssetEditor>(), this.ContentCore.Editors);
-                    helper.ObservableAssetLoaders.CollectionChanged += (sender, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetLoader>(), e.OldItems?.Cast<IAssetLoader>(), this.ContentCore.Loaders);
+                    ContentHelper content = helper.GetLegacyContentHelper();
+                    content.ObservableAssetEditors.CollectionChanged += (sender, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetEditor>(), e.OldItems?.Cast<IAssetEditor>(), this.ContentCore.Editors);
+                    content.ObservableAssetLoaders.CollectionChanged += (sender, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetLoader>(), e.OldItems?.Cast<IAssetLoader>(), this.ContentCore.Loaders);
                 }
 
                 // call entry method
@@ -1879,7 +1880,7 @@ namespace StardewModdingAPI.Framework
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
                         CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
-                        IContentHelper contentHelper = new ContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor);
+                        ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor);
                         GameContentHelper gameContentHelper = new(contentCore, manifest.UniqueID, mod.DisplayName, monitor);
                         IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache);
                         IContentPackHelper contentPackHelper = new ContentPackHelper(manifest.UniqueID, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);

From a20413664bcf073f88bb37bc225e6f0bf7756495 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 3 Apr 2022 21:17:40 -0400
Subject: [PATCH 496/856] split mod content load method, make error-handling
 more consistent

---
 .../ContentManagers/ModContentManager.cs      | 187 +++++++++++-------
 1 file changed, 112 insertions(+), 75 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index a451fd7c..b3de273a 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -93,97 +93,34 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
                 {
                     if (contentManagerID != this.Name)
-                        throw new SContentLoadException($"Can't load managed asset key '{assetName}' through content manager '{this.Name}' for a different mod.");
+                        throw this.GetLoadError(assetName, "can't load a different mod's managed asset key through this mod content manager.");
                     assetName = relativePath;
                 }
             }
 
             // get local asset
-            SContentLoadException GetContentError(string reasonPhrase) => new($"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}");
             T asset;
             try
             {
                 // get file
                 FileInfo file = this.GetModFile(assetName.Name);
                 if (!file.Exists)
-                    throw GetContentError("the specified path doesn't exist.");
+                    throw this.GetLoadError(assetName, "the specified path doesn't exist.");
 
                 // load content
-                switch (file.Extension.ToLower())
+                asset = file.Extension.ToLower() switch
                 {
-                    // XNB file
-                    case ".xnb":
-                        {
-                            // the underlying content manager adds a .xnb extension implicitly, so
-                            // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
-                            IAssetName loadName = this.Coordinator.ParseAssetName(assetName.Name[..^".xnb".Length], allowLocales: false);
-
-                            // load asset
-                            asset = this.RawLoad<T>(loadName, useCache: false);
-                            if (asset is Map map)
-                            {
-                                map.assetPath = loadName.Name;
-                                this.FixTilesheetPaths(map, relativeMapPath: loadName.Name, fixEagerPathPrefixes: true);
-                            }
-                        }
-                        break;
-
-                    // unpacked Bitmap font
-                    case ".fnt":
-                        {
-                            string source = File.ReadAllText(file.FullName);
-                            asset = (T)(object)new XmlSource(source);
-                        }
-                        break;
-
-                    // unpacked data
-                    case ".json":
-                        {
-                            if (!this.JsonHelper.ReadJsonFileIfExists(file.FullName, out asset))
-                                throw GetContentError("the JSON file is invalid."); // should never happen since we check for file existence above
-                        }
-                        break;
-
-                    // unpacked image
-                    case ".png":
-                        {
-                            // validate
-                            if (typeof(T) != typeof(Texture2D))
-                                throw GetContentError($"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Texture2D)}'.");
-
-                            // fetch & cache
-                            using FileStream stream = File.OpenRead(file.FullName);
-
-                            Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream);
-                            texture = this.PremultiplyTransparency(texture);
-                            asset = (T)(object)texture;
-                        }
-                        break;
-
-                    // unpacked map
-                    case ".tbin":
-                    case ".tmx":
-                        {
-                            // validate
-                            if (typeof(T) != typeof(Map))
-                                throw GetContentError($"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Map)}'.");
-
-                            // fetch & cache
-                            FormatManager formatManager = FormatManager.Instance;
-                            Map map = formatManager.LoadMap(file.FullName);
-                            map.assetPath = assetName.Name;
-                            this.FixTilesheetPaths(map, relativeMapPath: assetName.Name, fixEagerPathPrefixes: false);
-                            asset = (T)(object)map;
-                        }
-                        break;
-
-                    default:
-                        throw GetContentError($"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', or '.xnb'.");
-                }
+                    ".fnt" => this.LoadFont<T>(assetName, file),
+                    ".json" => this.LoadDataFile<T>(assetName, file),
+                    ".png" => this.LoadImageFile<T>(assetName, file),
+                    ".tbin" or ".tmx" => this.LoadMapFile<T>(assetName, file),
+                    ".xnb" => this.LoadXnbFile<T>(assetName),
+                    _ => this.HandleUnknownFileType<T>(assetName, file)
+                };
             }
-            catch (Exception ex) when (!(ex is SContentLoadException))
+            catch (Exception ex) when (ex is not SContentLoadException)
             {
-                throw new SContentLoadException($"The content manager failed loading content asset '{assetName}' from {this.Name}.", ex);
+                throw this.GetLoadError(assetName, "an unexpected occurred.", ex);
             }
 
             // track & return asset
@@ -213,6 +150,106 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
+        /// <summary>Load an unpacked font file (<c>.fnt</c>).</summary>
+        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file to load.</param>
+        private T LoadFont<T>(IAssetName assetName, FileInfo file)
+        {
+            // validate
+            if (!typeof(T).IsAssignableFrom(typeof(XmlSource)))
+                throw this.GetLoadError(assetName, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(XmlSource)}'.");
+
+            // load
+            string source = File.ReadAllText(file.FullName);
+            return (T)(object)new XmlSource(source);
+        }
+
+        /// <summary>Load an unpacked data file (<c>.json</c>).</summary>
+        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file to load.</param>
+        private T LoadDataFile<T>(IAssetName assetName, FileInfo file)
+        {
+            if (!this.JsonHelper.ReadJsonFileIfExists(file.FullName, out T asset))
+                throw this.GetLoadError(assetName, "the JSON file is invalid."); // should never happen since we check for file existence before calling this method
+
+            return asset;
+        }
+
+        /// <summary>Load an unpacked image file (<c>.json</c>).</summary>
+        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file to load.</param>
+        private T LoadImageFile<T>(IAssetName assetName, FileInfo file)
+        {
+            // validate
+            if (typeof(T) != typeof(Texture2D))
+                throw this.GetLoadError(assetName, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Texture2D)}'.");
+
+            // load
+            using FileStream stream = File.OpenRead(file.FullName);
+            Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream);
+            texture = this.PremultiplyTransparency(texture);
+            return (T)(object)texture;
+        }
+
+        /// <summary>Load an unpacked image file (<c>.tbin</c> or <c>.tmx</c>).</summary>
+        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file to load.</param>
+        private T LoadMapFile<T>(IAssetName assetName, FileInfo file)
+        {
+            // validate
+            if (typeof(T) != typeof(Map))
+                throw this.GetLoadError(assetName, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Map)}'.");
+
+            // load
+            FormatManager formatManager = FormatManager.Instance;
+            Map map = formatManager.LoadMap(file.FullName);
+            map.assetPath = assetName.Name;
+            this.FixTilesheetPaths(map, relativeMapPath: assetName.Name, fixEagerPathPrefixes: false);
+            return (T)(object)map;
+        }
+
+        /// <summary>Load a packed file (<c>.xnb</c>).</summary>
+        /// <typeparam name="T">The type of asset to load.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        private T LoadXnbFile<T>(IAssetName assetName)
+        {
+            // the underlying content manager adds a .xnb extension implicitly, so
+            // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
+            IAssetName loadName = this.Coordinator.ParseAssetName(assetName.Name[..^".xnb".Length], allowLocales: false);
+
+            // load asset
+            T asset = this.RawLoad<T>(loadName, useCache: false);
+            if (asset is Map map)
+            {
+                map.assetPath = loadName.Name;
+                this.FixTilesheetPaths(map, relativeMapPath: loadName.Name, fixEagerPathPrefixes: true);
+            }
+
+            return asset;
+        }
+
+        /// <summary>Handle a request to load a file type that isn't supported by SMAPI.</summary>
+        /// <typeparam name="T">The expected file type.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file to load.</param>
+        private T HandleUnknownFileType<T>(IAssetName assetName, FileInfo file)
+        {
+            throw this.GetLoadError(assetName, $"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'.");
+        }
+
+        /// <summary>Get an error which indicates that an asset couldn't be loaded.</summary>
+        /// <param name="assetName">The asset name that failed to load.</param>
+        /// <param name="reasonPhrase">The reason the file couldn't be loaded.</param>
+        /// <param name="exception">The underlying exception, if applicable.</param>
+        private SContentLoadException GetLoadError(IAssetName assetName, string reasonPhrase, Exception exception = null)
+        {
+            return new($"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);
+        }
+
         /// <summary>Get a file from the mod folder.</summary>
         /// <param name="path">The asset path relative to the content folder.</param>
         private FileInfo GetModFile(string path)

From 29f909a8d5dbb83d6df1a54d2680e6f9898f3b19 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 00:37:10 -0400
Subject: [PATCH 497/856] fix asset name truncation when loading XNB mod file
 without file extension

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index b3de273a..63070d85 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -219,7 +219,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // the underlying content manager adds a .xnb extension implicitly, so
             // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
-            IAssetName loadName = this.Coordinator.ParseAssetName(assetName.Name[..^".xnb".Length], allowLocales: false);
+            IAssetName loadName = assetName.Name.EndsWith(".xnb", StringComparison.OrdinalIgnoreCase)
+                ? this.Coordinator.ParseAssetName(assetName.Name[..^".xnb".Length], allowLocales: false)
+                : assetName;
 
             // load asset
             T asset = this.RawLoad<T>(loadName, useCache: false);

From a593eda30f82af474887d91458b0e9158f66fefc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 18:24:59 -0400
Subject: [PATCH 498/856] use target-typed new

---
 .../Framework/InstallerContext.cs             |  2 +-
 src/SMAPI.Installer/InteractiveInstaller.cs   | 18 +++++------
 src/SMAPI.Installer/Program.cs                |  6 ++--
 src/SMAPI.Internal.Patching/HarmonyPatcher.cs |  2 +-
 src/SMAPI.Internal.Patching/PatchHelper.cs    |  2 +-
 .../Mock/StardewValley/Item.cs                | 16 +++++-----
 .../Mock/StardewValley/Object.cs              |  2 +-
 .../NetFieldAnalyzerTests.cs                  |  4 +--
 .../ObsoleteFieldAnalyzerTests.cs             |  2 +-
 .../NetFieldAnalyzer.cs                       |  4 +--
 .../ObsoleteFieldAnalyzer.cs                  |  2 +-
 src/SMAPI.ModBuildConfig/DeployModTask.cs     |  4 +--
 .../Framework/ModFileManager.cs               |  8 ++---
 .../Framework/Commands/Player/AddCommand.cs   |  2 +-
 .../Commands/Player/ListItemTypesCommand.cs   |  2 +-
 .../Commands/Player/ListItemsCommand.cs       |  2 +-
 .../Framework/ItemRepository.cs               |  2 +-
 src/SMAPI.Mods.ConsoleCommands/ModEntry.cs    |  2 +-
 .../Patches/SaveGamePatcher.cs                |  2 +-
 src/SMAPI.Mods.SaveBackup/ModEntry.cs         | 12 +++----
 src/SMAPI.Tests/Core/TranslationTests.cs      |  6 ++--
 src/SMAPI.Tests/Sample.cs                     |  2 +-
 .../Utilities/PathUtilitiesTests.cs           | 22 ++++++-------
 src/SMAPI.Tests/Utilities/SDateTests.cs       |  4 +--
 .../Utilities/SemanticVersionTests.cs         |  2 +-
 .../Framework/Clients/WebApi/WebApiClient.cs  |  4 +--
 .../Framework/Clients/Wiki/WikiClient.cs      |  2 +-
 .../Framework/GameScanning/GameScanner.cs     |  4 +--
 .../Framework/LowLevelEnvironmentUtility.cs   |  2 +-
 .../Framework/ModData/ModDataRecord.cs        |  2 +-
 .../Framework/ModScanning/ModScanner.cs       | 12 +++----
 src/SMAPI.Toolkit/ModToolkit.cs               |  2 +-
 src/SMAPI.Toolkit/SemanticVersionComparer.cs  |  2 +-
 src/SMAPI.Toolkit/Serialization/JsonHelper.cs |  2 +-
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs  |  4 +--
 src/SMAPI.Web/Controllers/IndexController.cs  |  2 +-
 .../Controllers/JsonValidatorController.cs    |  2 +-
 .../Controllers/ModsApiController.cs          |  2 +-
 .../Clients/Chucklefish/ChucklefishClient.cs  |  2 +-
 .../Clients/CurseForge/CurseForgeClient.cs    |  2 +-
 .../Framework/Clients/Nexus/NexusClient.cs    |  2 +-
 .../Framework/Compression/GzipHelper.cs       |  8 ++---
 src/SMAPI.Web/Framework/Extensions.cs         |  4 +--
 .../JobDashboardAuthorizationFilter.cs        |  2 +-
 .../Framework/LogParsing/LogMessageBuilder.cs |  2 +-
 .../Framework/LogParsing/LogParser.cs         | 32 +++++++++----------
 .../Framework/Storage/StorageProvider.cs      |  4 +--
 src/SMAPI.Web/ViewModels/LogParserModel.cs    |  2 +-
 src/SMAPI/Context.cs                          |  4 +--
 src/SMAPI/Framework/CommandManager.cs         |  2 +-
 .../Commands/HarmonySummaryCommand.cs         |  2 +-
 .../Framework/Content/AssetDataForMap.cs      |  4 +--
 src/SMAPI/Framework/DeprecationManager.cs     |  2 +-
 src/SMAPI/Framework/Events/ManagedEvent.cs    |  2 +-
 .../Framework/Input/KeyboardStateBuilder.cs   |  2 +-
 src/SMAPI/Framework/Input/SInputState.cs      | 10 +++---
 .../Framework/ModLoading/AssemblyLoader.cs    | 16 +++++-----
 src/SMAPI/Framework/ModLoading/ModResolver.cs |  2 +-
 .../Symbols/SymbolReaderProvider.cs           |  2 +-
 src/SMAPI/Framework/ModRegistry.cs            |  4 +--
 src/SMAPI/Framework/Models/SConfig.cs         |  2 +-
 .../Framework/Networking/SGalaxyNetServer.cs  |  6 ++--
 .../Framework/Networking/SLidgrenServer.cs    |  4 +--
 src/SMAPI/Framework/Reflection/Reflector.cs   |  4 +--
 src/SMAPI/Framework/SGame.cs                  |  8 ++---
 src/SMAPI/Framework/SGameRunner.cs            |  2 +-
 src/SMAPI/Framework/SMultiplayer.cs           | 18 +++++------
 src/SMAPI/Framework/Singleton.cs              |  2 +-
 src/SMAPI/Framework/SnapshotListDiff.cs       |  4 +--
 .../Framework/StateTracking/ChestTracker.cs   |  4 +--
 .../FieldWatchers/ComparableListWatcher.cs    |  4 +--
 .../ImmutableCollectionWatcher.cs             |  2 +-
 .../FieldWatchers/NetCollectionWatcher.cs     |  4 +--
 .../ObservableCollectionWatcher.cs            |  6 ++--
 .../StateTracking/LocationTracker.cs          |  2 +-
 .../Framework/StateTracking/PlayerTracker.cs  |  2 +-
 .../Snapshots/LocationSnapshot.cs             | 14 ++++----
 .../StateTracking/Snapshots/PlayerSnapshot.cs |  4 +--
 .../Snapshots/WatcherSnapshot.cs              | 16 +++++-----
 .../Snapshots/WorldLocationsSnapshot.cs       |  4 +--
 .../TemporaryHacks/MiniMonoModHotfix.cs       |  4 +--
 src/SMAPI/Framework/WatcherCore.cs            |  2 +-
 src/SMAPI/Program.cs                          |  2 +-
 83 files changed, 203 insertions(+), 203 deletions(-)

diff --git a/src/SMAPI.Installer/Framework/InstallerContext.cs b/src/SMAPI.Installer/Framework/InstallerContext.cs
index bb973230..abc7adde 100644
--- a/src/SMAPI.Installer/Framework/InstallerContext.cs
+++ b/src/SMAPI.Installer/Framework/InstallerContext.cs
@@ -12,7 +12,7 @@ namespace StardewModdingAPI.Installer.Framework
         ** Fields
         *********/
         /// <summary>The underlying toolkit game scanner.</summary>
-        private readonly GameScanner GameScanner = new GameScanner();
+        private readonly GameScanner GameScanner = new();
 
 
         /*********
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index b3bba883..a126c3b8 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -126,7 +126,7 @@ namespace StardewModdingApi.Installer
             /****
             ** Get basic info & set window title
             ****/
-            ModToolkit toolkit = new ModToolkit();
+            ModToolkit toolkit = new();
             var context = new InstallerContext();
             Console.Title = $"SMAPI {context.GetInstallerVersion()} installer on {context.Platform} {context.PlatformName}";
             Console.WriteLine();
@@ -246,7 +246,7 @@ namespace StardewModdingApi.Installer
                 }
 
                 // get folders
-                DirectoryInfo bundleDir = new DirectoryInfo(this.BundlePath);
+                DirectoryInfo bundleDir = new(this.BundlePath);
                 paths = new InstallerPaths(bundleDir, installDir);
             }
 
@@ -354,8 +354,8 @@ namespace StardewModdingApi.Installer
                 // move global save data folder (changed in 3.2)
                 {
                     string dataPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "StardewValley");
-                    DirectoryInfo oldDir = new DirectoryInfo(Path.Combine(dataPath, "Saves", ".smapi"));
-                    DirectoryInfo newDir = new DirectoryInfo(Path.Combine(dataPath, ".smapi"));
+                    DirectoryInfo oldDir = new(Path.Combine(dataPath, "Saves", ".smapi"));
+                    DirectoryInfo newDir = new(Path.Combine(dataPath, ".smapi"));
 
                     if (oldDir.Exists)
                     {
@@ -428,7 +428,7 @@ namespace StardewModdingApi.Installer
                     }
 
                     // add or replace bundled mods
-                    DirectoryInfo bundledModsDir = new DirectoryInfo(Path.Combine(paths.BundlePath, "Mods"));
+                    DirectoryInfo bundledModsDir = new(Path.Combine(paths.BundlePath, "Mods"));
                     if (bundledModsDir.Exists && bundledModsDir.EnumerateDirectories().Any())
                     {
                         this.PrintDebug("Adding bundled mods...");
@@ -450,7 +450,7 @@ namespace StardewModdingApi.Installer
 
                             // find target folder
                             ModFolder targetMod = targetMods.FirstOrDefault(p => p.Manifest?.UniqueID?.Equals(sourceMod.Manifest.UniqueID, StringComparison.OrdinalIgnoreCase) == true);
-                            DirectoryInfo defaultTargetFolder = new DirectoryInfo(Path.Combine(paths.ModsPath, sourceMod.Directory.Name));
+                            DirectoryInfo defaultTargetFolder = new(Path.Combine(paths.ModsPath, sourceMod.Directory.Name));
                             DirectoryInfo targetFolder = targetMod?.Directory ?? defaultTargetFolder;
                             this.PrintDebug(targetFolder.FullName == defaultTargetFolder.FullName
                                 ? $"   adding {sourceMod.Manifest.Name}..."
@@ -593,7 +593,7 @@ namespace StardewModdingApi.Installer
                     break;
 
                 case DirectoryInfo sourceDir:
-                    DirectoryInfo targetSubfolder = new DirectoryInfo(Path.Combine(targetFolder.FullName, sourceDir.Name));
+                    DirectoryInfo targetSubfolder = new(Path.Combine(targetFolder.FullName, sourceDir.Name));
                     foreach (var entry in sourceDir.EnumerateFileSystemInfos())
                         this.RecursiveCopy(entry, targetSubfolder, filter);
                     break;
@@ -717,7 +717,7 @@ namespace StardewModdingApi.Installer
                 // get directory
                 if (File.Exists(path))
                     path = Path.GetDirectoryName(path);
-                DirectoryInfo directory = new DirectoryInfo(path);
+                DirectoryInfo directory = new(path);
 
                 // validate path
                 if (!directory.Exists)
@@ -795,7 +795,7 @@ namespace StardewModdingApi.Installer
 
             // get path
             string appDataPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "StardewValley");
-            DirectoryInfo modDir = new DirectoryInfo(Path.Combine(appDataPath, "Mods"));
+            DirectoryInfo modDir = new(Path.Combine(appDataPath, "Mods"));
 
             // check if migration needed
             if (!modDir.Exists)
diff --git a/src/SMAPI.Installer/Program.cs b/src/SMAPI.Installer/Program.cs
index 45cfea75..2c9b2c0a 100644
--- a/src/SMAPI.Installer/Program.cs
+++ b/src/SMAPI.Installer/Program.cs
@@ -31,7 +31,7 @@ namespace StardewModdingApi.Installer
         public static void Main(string[] args)
         {
             // find install bundle
-            FileInfo zipFile = new FileInfo(Path.Combine(Program.InstallerPath, "install.dat"));
+            FileInfo zipFile = new(Path.Combine(Program.InstallerPath, "install.dat"));
             if (!zipFile.Exists)
             {
                 Console.WriteLine($"Oops! Some of the installer files are missing; try re-downloading the installer. (Missing file: {zipFile.FullName})");
@@ -40,7 +40,7 @@ namespace StardewModdingApi.Installer
             }
 
             // unzip bundle into temp folder
-            DirectoryInfo bundleDir = new DirectoryInfo(Program.ExtractedBundlePath);
+            DirectoryInfo bundleDir = new(Program.ExtractedBundlePath);
             Console.WriteLine("Extracting install files...");
             ZipFile.ExtractToDirectory(zipFile.FullName, bundleDir.FullName);
 
@@ -70,7 +70,7 @@ namespace StardewModdingApi.Installer
         {
             try
             {
-                AssemblyName name = new AssemblyName(e.Name);
+                AssemblyName name = new(e.Name);
                 foreach (FileInfo dll in new DirectoryInfo(Program.InternalFilesPath).EnumerateFiles("*.dll"))
                 {
                     if (name.Name.Equals(AssemblyName.GetAssemblyName(dll.FullName).Name, StringComparison.OrdinalIgnoreCase))
diff --git a/src/SMAPI.Internal.Patching/HarmonyPatcher.cs b/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
index c07e3b41..6f30c241 100644
--- a/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
+++ b/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
@@ -15,7 +15,7 @@ namespace StardewModdingAPI.Internal.Patching
         /// <param name="patchers">The patchers to apply.</param>
         public static Harmony Apply(string id, IMonitor monitor, params IPatcher[] patchers)
         {
-            Harmony harmony = new Harmony(id);
+            Harmony harmony = new(id);
 
             foreach (IPatcher patcher in patchers)
             {
diff --git a/src/SMAPI.Internal.Patching/PatchHelper.cs b/src/SMAPI.Internal.Patching/PatchHelper.cs
index fc79ddf2..c9758616 100644
--- a/src/SMAPI.Internal.Patching/PatchHelper.cs
+++ b/src/SMAPI.Internal.Patching/PatchHelper.cs
@@ -43,7 +43,7 @@ namespace StardewModdingAPI.Internal.Patching
         /// <param name="generics">The method generic types, or <c>null</c> if it's not generic.</param>
         public static string GetMethodString(Type type, string name, Type[] parameters = null, Type[] generics = null)
         {
-            StringBuilder str = new StringBuilder();
+            StringBuilder str = new();
 
             // type
             str.Append(type.FullName);
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
index 1b6317c1..e8da92fa 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
@@ -7,27 +7,27 @@ namespace StardewValley
     public class Item
     {
         /// <summary>A net int field with an equivalent non-net <c>Category</c> property.</summary>
-        public readonly NetInt category = new NetInt { Value = 42 };
+        public readonly NetInt category = new() { Value = 42 };
 
         /// <summary>A generic net int field with no equivalent non-net property.</summary>
-        public readonly NetInt netIntField = new NetInt { Value = 42 };
+        public readonly NetInt netIntField = new() { Value = 42 };
 
         /// <summary>A generic net ref field with no equivalent non-net property.</summary>
-        public readonly NetRef<object> netRefField = new NetRef<object>();
+        public readonly NetRef<object> netRefField = new();
 
         /// <summary>A generic net int property with no equivalent non-net property.</summary>
-        public NetInt netIntProperty = new NetInt { Value = 42 };
+        public NetInt netIntProperty = new() { Value = 42 };
 
         /// <summary>A generic net ref property with no equivalent non-net property.</summary>
-        public NetRef<object> netRefProperty { get; } = new NetRef<object>();
+        public NetRef<object> netRefProperty { get; } = new();
 
         /// <summary>A sample net list.</summary>
-        public readonly NetList<int> netList = new NetList<int>();
+        public readonly NetList<int> netList = new();
 
         /// <summary>A sample net object list.</summary>
-        public readonly NetObjectList<int> netObjectList = new NetObjectList<int>();
+        public readonly NetObjectList<int> netObjectList = new();
 
         /// <summary>A sample net collection.</summary>
-        public readonly NetCollection<int> netCollection = new NetCollection<int>();
+        public readonly NetCollection<int> netCollection = new();
     }
 }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
index 3dd66a6d..151010a7 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
@@ -7,6 +7,6 @@ namespace StardewValley
     public class Object : Item
     {
         /// <summary>A net int field with an equivalent non-net property.</summary>
-        public NetInt type = new NetInt { Value = 42 };
+        public NetInt type = new() { Value = 42 };
     }
 }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
index 89bd1be5..f11a59d3 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
@@ -93,7 +93,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests
         {
             // arrange
             string code = NetFieldAnalyzerTests.SampleProgram.Replace("{{test-code}}", codeText);
-            DiagnosticResult expected = new DiagnosticResult
+            DiagnosticResult expected = new()
             {
                 Id = "AvoidImplicitNetFieldCast",
                 Message = $"This implicitly converts '{expression}' from {fromType} to {toType}, but {fromType} has unintuitive implicit conversion rules. Consider comparing against the actual value instead to avoid bugs. See https://smapi.io/package/avoid-implicit-net-field-cast for details.",
@@ -135,7 +135,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests
         {
             // arrange
             string code = NetFieldAnalyzerTests.SampleProgram.Replace("{{test-code}}", codeText);
-            DiagnosticResult expected = new DiagnosticResult
+            DiagnosticResult expected = new()
             {
                 Id = "AvoidNetField",
                 Message = $"'{expression}' is a {netType} field; consider using the {suggestedProperty} property instead. See https://smapi.io/package/avoid-net-field for details.",
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
index 12641e1a..76607b8e 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
@@ -64,7 +64,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests
         {
             // arrange
             string code = ObsoleteFieldAnalyzerTests.SampleProgram.Replace("{{test-code}}", codeText);
-            DiagnosticResult expected = new DiagnosticResult
+            DiagnosticResult expected = new()
             {
                 Id = "AvoidObsoleteField",
                 Message = $"The '{oldName}' field is obsolete and should be replaced with '{newName}'. See https://smapi.io/package/avoid-obsolete-field for details.",
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
index e03c72de..8478dc54 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
@@ -132,7 +132,7 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
         };
 
         /// <summary>The diagnostic info for an implicit net field cast.</summary>
-        private readonly DiagnosticDescriptor AvoidImplicitNetFieldCastRule = new DiagnosticDescriptor(
+        private readonly DiagnosticDescriptor AvoidImplicitNetFieldCastRule = new(
             id: "AvoidImplicitNetFieldCast",
             title: "Netcode types shouldn't be implicitly converted",
             messageFormat: "This implicitly converts '{0}' from {1} to {2}, but {1} has unintuitive implicit conversion rules. Consider comparing against the actual value instead to avoid bugs. See https://smapi.io/package/avoid-implicit-net-field-cast for details.",
@@ -143,7 +143,7 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
         );
 
         /// <summary>The diagnostic info for an avoidable net field access.</summary>
-        private readonly DiagnosticDescriptor AvoidNetFieldRule = new DiagnosticDescriptor(
+        private readonly DiagnosticDescriptor AvoidNetFieldRule = new(
             id: "AvoidNetField",
             title: "Avoid Netcode types when possible",
             messageFormat: "'{0}' is a {1} field; consider using the {2} property instead. See https://smapi.io/package/avoid-net-field for details.",
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
index 722d5227..3184147a 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
@@ -24,7 +24,7 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
         /// <summary>Describes the diagnostic rule covered by the analyzer.</summary>
         private readonly IDictionary<string, DiagnosticDescriptor> Rules = new Dictionary<string, DiagnosticDescriptor>
         {
-            ["AvoidObsoleteField"] = new DiagnosticDescriptor(
+            ["AvoidObsoleteField"] = new(
                 id: "AvoidObsoleteField",
                 title: "Reference to obsolete field",
                 messageFormat: "The '{0}' field is obsolete and should be replaced with '{1}'. See https://smapi.io/package/avoid-obsolete-field for details.",
diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index 140933bd..c7026ee1 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -88,7 +88,7 @@ namespace StardewModdingAPI.ModBuildConfig
                 Regex[] ignoreFilePatterns = this.GetCustomIgnorePatterns().ToArray();
 
                 // get mod info
-                ModFileManager package = new ModFileManager(this.ProjectDir, this.TargetDir, ignoreFilePaths, ignoreFilePatterns, bundleAssemblyTypes, this.ModDllName, validateRequiredModFiles: this.EnableModDeploy || this.EnableModZip);
+                ModFileManager package = new(this.ProjectDir, this.TargetDir, ignoreFilePaths, ignoreFilePatterns, bundleAssemblyTypes, this.ModDllName, validateRequiredModFiles: this.EnableModDeploy || this.EnableModZip);
 
                 // deploy mod files
                 if (this.EnableModDeploy)
@@ -246,7 +246,7 @@ namespace StardewModdingAPI.ModBuildConfig
             // create zip file
             Directory.CreateDirectory(Path.GetDirectoryName(zipPath)!);
             using Stream zipStream = new FileStream(zipPath, FileMode.Create, FileAccess.Write);
-            using ZipArchive archive = new ZipArchive(zipStream, ZipArchiveMode.Create);
+            using ZipArchive archive = new(zipStream, ZipArchiveMode.Create);
 
             foreach (var fileEntry in files)
             {
diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index ad4ffdf9..80955f67 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -136,7 +136,7 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
             // project manifest
             bool hasProjectManifest = false;
             {
-                FileInfo manifest = new FileInfo(Path.Combine(projectDir, this.ManifestFileName));
+                FileInfo manifest = new(Path.Combine(projectDir, this.ManifestFileName));
                 if (manifest.Exists)
                 {
                     yield return Tuple.Create(this.ManifestFileName, manifest);
@@ -146,7 +146,7 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
 
             // project i18n files
             bool hasProjectTranslations = false;
-            DirectoryInfo translationsFolder = new DirectoryInfo(Path.Combine(projectDir, "i18n"));
+            DirectoryInfo translationsFolder = new(Path.Combine(projectDir, "i18n"));
             if (translationsFolder.Exists)
             {
                 foreach (FileInfo file in translationsFolder.EnumerateFiles())
@@ -156,7 +156,7 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
 
             // project assets folder
             bool hasAssetsFolder = false;
-            DirectoryInfo assetsFolder = new DirectoryInfo(Path.Combine(projectDir, "assets"));
+            DirectoryInfo assetsFolder = new(Path.Combine(projectDir, "assets"));
             if (assetsFolder.Exists)
             {
                 foreach (FileInfo file in assetsFolder.EnumerateFiles("*", SearchOption.AllDirectories))
@@ -168,7 +168,7 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
             }
 
             // build output
-            DirectoryInfo buildFolder = new DirectoryInfo(targetDir);
+            DirectoryInfo buildFolder = new(targetDir);
             foreach (FileInfo file in buildFolder.EnumerateFiles("*", SearchOption.AllDirectories))
             {
                 // get path info
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
index 0e8f7517..fae31c23 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         ** Fields
         *********/
         /// <summary>Provides methods for searching and constructing items.</summary>
-        private readonly ItemRepository Items = new ItemRepository();
+        private readonly ItemRepository Items = new();
 
         /// <summary>The type names recognized by this command.</summary>
         private readonly string[] ValidTypes = Enum.GetNames(typeof(ItemType)).Concat(new[] { "Name" }).ToArray();
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
index 1f12e5f9..af362bcd 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
@@ -10,7 +10,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         ** Fields
         *********/
         /// <summary>Provides methods for searching and constructing items.</summary>
-        private readonly ItemRepository Items = new ItemRepository();
+        private readonly ItemRepository Items = new();
 
 
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
index 67569298..46fc1d9d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
@@ -12,7 +12,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         ** Fields
         *********/
         /// <summary>Provides methods for searching and constructing items.</summary>
-        private readonly ItemRepository Items = new ItemRepository();
+        private readonly ItemRepository Items = new();
 
 
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 8704a403..9b48fa99 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -285,7 +285,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                 case SObject.flowersCategory:
                     yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 5 + id, _ =>
                     {
-                        SObject honey = new SObject(Vector2.Zero, 340, $"{item.Name} Honey", false, true, false, false)
+                        SObject honey = new(Vector2.Zero, 340, $"{item.Name} Honey", false, true, false, false)
                         {
                             Name = $"{item.Name} Honey",
                             preservedParentSheetIndex = { id }
diff --git a/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs b/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
index 91437fd3..5e594984 100644
--- a/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
@@ -71,7 +71,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         /// <param name="args">The command arguments.</param>
         private void HandleCommand(IConsoleCommand command, string commandName, string[] args)
         {
-            ArgumentParser argParser = new ArgumentParser(commandName, args, this.Monitor);
+            ArgumentParser argParser = new(commandName, args, this.Monitor);
             command.Handle(this.Monitor, commandName, argParser);
         }
 
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index 0a7ed212..5f6dbcb3 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -121,7 +121,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
                 {
                     try
                     {
-                        BluePrint _ = new BluePrint(building.buildingType.Value);
+                        BluePrint _ = new(building.buildingType.Value);
                     }
                     catch (ContentLoadException)
                     {
diff --git a/src/SMAPI.Mods.SaveBackup/ModEntry.cs b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
index b89bb9c3..f6925707 100644
--- a/src/SMAPI.Mods.SaveBackup/ModEntry.cs
+++ b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
@@ -38,7 +38,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
             try
             {
                 // init backup folder
-                DirectoryInfo backupFolder = new DirectoryInfo(this.BackupFolder);
+                DirectoryInfo backupFolder = new(this.BackupFolder);
                 backupFolder.Create();
 
                 // back up & prune saves
@@ -63,8 +63,8 @@ namespace StardewModdingAPI.Mods.SaveBackup
             try
             {
                 // get target path
-                FileInfo targetFile = new FileInfo(Path.Combine(backupFolder.FullName, this.FileName));
-                DirectoryInfo fallbackDir = new DirectoryInfo(Path.Combine(backupFolder.FullName, this.BackupLabel));
+                FileInfo targetFile = new(Path.Combine(backupFolder.FullName, this.FileName));
+                DirectoryInfo fallbackDir = new(Path.Combine(backupFolder.FullName, this.BackupLabel));
                 if (targetFile.Exists || fallbackDir.Exists)
                 {
                     this.Monitor.Log("Already backed up today.");
@@ -72,7 +72,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
                 }
 
                 // copy saves to fallback directory (ignore non-save files/folders)
-                DirectoryInfo savesDir = new DirectoryInfo(Constants.SavesPath);
+                DirectoryInfo savesDir = new(Constants.SavesPath);
                 if (!this.RecursiveCopy(savesDir, fallbackDir, entry => this.MatchSaveFolders(savesDir, entry), copyRoot: false))
                 {
                     this.Monitor.Log("No saves found.");
@@ -190,8 +190,8 @@ namespace StardewModdingAPI.Mods.SaveBackup
         /// <param name="destination">The destination file to create.</param>
         private void CompressUsingMacProcess(string sourcePath, FileInfo destination)
         {
-            DirectoryInfo saveFolder = new DirectoryInfo(sourcePath);
-            ProcessStartInfo startInfo = new ProcessStartInfo
+            DirectoryInfo saveFolder = new(sourcePath);
+            ProcessStartInfo startInfo = new()
             {
                 FileName = "zip",
                 Arguments = $"-rq \"{destination.FullName}\" \"{saveFolder.Name}\" -x \"*.DS_Store\" -x \"__MACOSX\"",
diff --git a/src/SMAPI.Tests/Core/TranslationTests.cs b/src/SMAPI.Tests/Core/TranslationTests.cs
index 457f9fad..58bc59b1 100644
--- a/src/SMAPI.Tests/Core/TranslationTests.cs
+++ b/src/SMAPI.Tests/Core/TranslationTests.cs
@@ -116,7 +116,7 @@ namespace SMAPI.Tests.Core
         public void Translation_ToString([ValueSource(nameof(TranslationTests.Samples))] string text)
         {
             // act
-            Translation translation = new Translation("pt-BR", "key", text);
+            Translation translation = new("pt-BR", "key", text);
 
             // assert
             if (translation.HasValue())
@@ -129,7 +129,7 @@ namespace SMAPI.Tests.Core
         public void Translation_ImplicitStringConversion([ValueSource(nameof(TranslationTests.Samples))] string text)
         {
             // act
-            Translation translation = new Translation("pt-BR", "key", text);
+            Translation translation = new("pt-BR", "key", text);
 
             // assert
             if (translation.HasValue())
@@ -182,7 +182,7 @@ namespace SMAPI.Tests.Core
             string expected = $"{start} tokens are properly replaced (including {middle} {middle}) {end}";
 
             // act
-            Translation translation = new Translation("pt-BR", "key", input);
+            Translation translation = new("pt-BR", "key", input);
             switch (structure)
             {
                 case "anonymous object":
diff --git a/src/SMAPI.Tests/Sample.cs b/src/SMAPI.Tests/Sample.cs
index f4f0d88e..9587a100 100644
--- a/src/SMAPI.Tests/Sample.cs
+++ b/src/SMAPI.Tests/Sample.cs
@@ -9,7 +9,7 @@ namespace SMAPI.Tests
         ** Fields
         *********/
         /// <summary>A random number generator.</summary>
-        private static readonly Random Random = new Random();
+        private static readonly Random Random = new();
 
 
         /*********
diff --git a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
index ab4c2618..94819c2e 100644
--- a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
+++ b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
@@ -14,7 +14,7 @@ namespace SMAPI.Tests.Utilities
         /// <summary>Sample paths used in unit tests.</summary>
         public static readonly SamplePath[] SamplePaths = {
             // Windows absolute path
-            new SamplePath
+            new()
             {
                 OriginalPath = @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley",
 
@@ -26,7 +26,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Windows absolute path (with trailing slash)
-            new SamplePath
+            new()
             {
                 OriginalPath = @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\",
 
@@ -38,7 +38,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Windows relative path
-            new SamplePath
+            new()
             {
                 OriginalPath = @"Content\Characters\Dialogue\Abigail",
 
@@ -50,7 +50,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Windows relative path (with directory climbing)
-            new SamplePath
+            new()
             {
                 OriginalPath = @"..\..\Content",
 
@@ -62,7 +62,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Windows UNC path
-            new SamplePath
+            new()
             {
                 OriginalPath = @"\\unc\path",
 
@@ -74,7 +74,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Linux absolute path
-            new SamplePath
+            new()
             {
                 OriginalPath = @"/home/.steam/steam/steamapps/common/Stardew Valley",
 
@@ -86,7 +86,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Linux absolute path (with trailing slash)
-            new SamplePath
+            new()
             {
                 OriginalPath = @"/home/.steam/steam/steamapps/common/Stardew Valley/",
 
@@ -98,7 +98,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Linux absolute path (with ~)
-            new SamplePath
+            new()
             {
                 OriginalPath = @"~/.steam/steam/steamapps/common/Stardew Valley",
 
@@ -110,7 +110,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Linux relative path
-            new SamplePath
+            new()
             {
                 OriginalPath = @"Content/Characters/Dialogue/Abigail",
 
@@ -122,7 +122,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Linux relative path (with directory climbing)
-            new SamplePath
+            new()
             {
                 OriginalPath = @"../../Content",
 
@@ -134,7 +134,7 @@ namespace SMAPI.Tests.Utilities
             },
 
             // Mixed directory separators
-            new SamplePath
+            new()
             {
                 OriginalPath = @"C:\some/mixed\path/separators",
 
diff --git a/src/SMAPI.Tests/Utilities/SDateTests.cs b/src/SMAPI.Tests/Utilities/SDateTests.cs
index 374f4921..886f25cd 100644
--- a/src/SMAPI.Tests/Utilities/SDateTests.cs
+++ b/src/SMAPI.Tests/Utilities/SDateTests.cs
@@ -61,7 +61,7 @@ namespace SMAPI.Tests.Utilities
         public void Constructor_SetsExpectedValues([ValueSource(nameof(SDateTests.SampleSeasonValues))] string season, [ValueSource(nameof(SDateTests.ValidDays))] int day, [Values(1, 2, 100)] int year)
         {
             // act
-            SDate date = new SDate(day, season, year);
+            SDate date = new(day, season, year);
 
             // assert
             Assert.AreEqual(day, date.Day);
@@ -254,7 +254,7 @@ namespace SMAPI.Tests.Utilities
                 {
                     foreach (int day in SDateTests.ValidDays)
                     {
-                        SDate date = new SDate(day, season, year);
+                        SDate date = new(day, season, year);
                         int hash = date.GetHashCode();
                         if (hashes.TryGetValue(hash, out SDate otherDate))
                             Assert.Fail($"Received identical hash code {hash} for dates {otherDate} and {date}.");
diff --git a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
index ac4ef39b..c8270373 100644
--- a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
+++ b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
@@ -395,7 +395,7 @@ namespace SMAPI.Tests.Utilities
         public void GameVersion(string versionStr)
         {
             // act
-            GameVersion version = new GameVersion(versionStr);
+            GameVersion version = new(versionStr);
 
             // assert
             Assert.AreEqual(versionStr, version.ToString(), "The game version did not round-trip to the same value.");
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
index c2d906a0..f7d26d21 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
@@ -62,9 +62,9 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         private TResult Post<TBody, TResult>(string url, TBody content)
         {
             // note: avoid HttpClient for macOS compatibility
-            using WebClient client = new WebClient();
+            using WebClient client = new();
 
-            Uri fullUrl = new Uri(this.BaseUrl, url);
+            Uri fullUrl = new(this.BaseUrl, url);
             string data = JsonConvert.SerializeObject(content);
 
             client.Headers["Content-Type"] = "application/json";
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index 0f5a0ec3..abbcdc81 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -127,7 +127,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                 string pullRequestUrl = this.GetAttribute(node, "data-pr");
 
                 // parse stable compatibility
-                WikiCompatibilityInfo compatibility = new WikiCompatibilityInfo
+                WikiCompatibilityInfo compatibility = new()
                 {
                     Status = this.GetAttributeAsEnum<WikiCompatibilityStatus>(node, "data-status") ?? WikiCompatibilityStatus.Ok,
                     BrokeIn = this.GetAttribute(node, "data-broke-in"),
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 8d4198de..768beba1 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -45,7 +45,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
             // yield valid folders
             foreach (string path in paths)
             {
-                DirectoryInfo folder = new DirectoryInfo(path);
+                DirectoryInfo folder = new(path);
                 if (this.LooksLikeGameFolder(folder))
                     yield return folder;
             }
@@ -191,7 +191,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                 yield break;
 
             // get targets file
-            FileInfo file = new FileInfo(Path.Combine(homePath, "stardewvalley.targets"));
+            FileInfo file = new(Path.Combine(homePath, "stardewvalley.targets"));
             if (!file.Exists)
                 yield break;
 
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index 8b6eb5fb..c0332331 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -98,7 +98,7 @@ namespace StardewModdingAPI.Toolkit.Framework
         /// </remarks>
         private static bool IsRunningAndroid()
         {
-            using Process process = new Process
+            using Process process = new()
             {
                 StartInfo =
                 {
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
index 5dd32acf..7e07ffde 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
@@ -82,7 +82,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <param name="manifest">The manifest to match.</param>
         public ModDataRecordVersionedFields GetVersionedFields(IManifest manifest)
         {
-            ModDataRecordVersionedFields parsed = new ModDataRecordVersionedFields { DisplayName = this.DisplayName, DataRecord = this };
+            ModDataRecordVersionedFields parsed = new() { DisplayName = this.DisplayName, DataRecord = this };
             foreach (ModDataField field in this.Fields.Where(field => field.IsMatch(manifest)))
             {
                 switch (field.Key)
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index e6105f9c..d21ccec0 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -18,7 +18,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         private readonly JsonHelper JsonHelper;
 
         /// <summary>A list of filesystem entry names to ignore when checking whether a folder should be treated as a mod.</summary>
-        private readonly HashSet<Regex> IgnoreFilesystemNames = new HashSet<Regex>
+        private readonly HashSet<Regex> IgnoreFilesystemNames = new()
         {
             new Regex(@"^__folder_managed_by_vortex$", RegexOptions.Compiled | RegexOptions.IgnoreCase), // Vortex mod manager
             new Regex(@"(?:^\._|^\.DS_Store$|^__MACOSX$|^mcs$)", RegexOptions.Compiled | RegexOptions.IgnoreCase), // macOS
@@ -26,7 +26,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         };
 
         /// <summary>A list of file extensions to ignore when searching for mod files.</summary>
-        private readonly HashSet<string> IgnoreFileExtensions = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
+        private readonly HashSet<string> IgnoreFileExtensions = new(StringComparer.OrdinalIgnoreCase)
         {
             // text
             ".doc",
@@ -60,7 +60,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         };
 
         /// <summary>The extensions for packed content files.</summary>
-        private readonly HashSet<string> StrictXnbModExtensions = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
+        private readonly HashSet<string> StrictXnbModExtensions = new(StringComparer.OrdinalIgnoreCase)
         {
             ".xgs",
             ".xnb",
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         };
 
         /// <summary>The extensions for files which an XNB mod may contain, in addition to <see cref="StrictXnbModExtensions"/>.</summary>
-        private readonly HashSet<string> PotentialXnbModExtensions = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
+        private readonly HashSet<string> PotentialXnbModExtensions = new(StringComparer.OrdinalIgnoreCase)
         {
             ".json",
             ".yaml"
@@ -96,7 +96,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         /// <param name="rootPath">The root folder containing mods.</param>
         public IEnumerable<ModFolder> GetModFolders(string rootPath)
         {
-            DirectoryInfo root = new DirectoryInfo(rootPath);
+            DirectoryInfo root = new(rootPath);
             return this.GetModFolders(root, root);
         }
 
@@ -260,7 +260,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             while (true)
             {
                 // check for manifest in current folder
-                FileInfo file = new FileInfo(Path.Combine(folder.FullName, "manifest.json"));
+                FileInfo file = new(Path.Combine(folder.FullName, "manifest.json"));
                 if (file.Exists)
                     return file;
 
diff --git a/src/SMAPI.Toolkit/ModToolkit.cs b/src/SMAPI.Toolkit/ModToolkit.cs
index 38a67ae5..80008df7 100644
--- a/src/SMAPI.Toolkit/ModToolkit.cs
+++ b/src/SMAPI.Toolkit/ModToolkit.cs
@@ -34,7 +34,7 @@ namespace StardewModdingAPI.Toolkit
         ** Accessors
         *********/
         /// <summary>Encapsulates SMAPI's JSON parsing.</summary>
-        public JsonHelper JsonHelper { get; } = new JsonHelper();
+        public JsonHelper JsonHelper { get; } = new();
 
 
         /*********
diff --git a/src/SMAPI.Toolkit/SemanticVersionComparer.cs b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
index 9f6b57a2..8eba2c9f 100644
--- a/src/SMAPI.Toolkit/SemanticVersionComparer.cs
+++ b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
@@ -9,7 +9,7 @@ namespace StardewModdingAPI.Toolkit
         ** Accessors
         *********/
         /// <summary>A singleton instance of the comparer.</summary>
-        public static SemanticVersionComparer Instance { get; } = new SemanticVersionComparer();
+        public static SemanticVersionComparer Instance { get; } = new();
 
 
         /*********
diff --git a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
index 00db9903..5c465f3c 100644
--- a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
+++ b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Toolkit.Serialization
         ** Accessors
         *********/
         /// <summary>The JSON settings to use when serializing and deserializing files.</summary>
-        public JsonSerializerSettings JsonSettings { get; } = new JsonSerializerSettings
+        public JsonSerializerSettings JsonSettings { get; } = new()
         {
             Formatting = Formatting.Indented,
             ObjectCreationHandling = ObjectCreationHandling.Replace, // avoid issue where default ICollection<T> values are duplicated each time the config is loaded
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index 2e9e5eac..85e12bfa 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -100,8 +100,8 @@ namespace StardewModdingAPI.Toolkit.Utilities
             // though, this is only for compatibility with the mod build package.
 
             // convert to URIs
-            Uri from = new Uri(sourceDir.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
-            Uri to = new Uri(targetPath.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
+            Uri from = new(sourceDir.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
+            Uri to = new(targetPath.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
             if (from.Scheme != to.Scheme)
                 throw new InvalidOperationException($"Can't get path for '{targetPath}' relative to '{sourceDir}'.");
 
diff --git a/src/SMAPI.Web/Controllers/IndexController.cs b/src/SMAPI.Web/Controllers/IndexController.cs
index 5097997c..69b54f47 100644
--- a/src/SMAPI.Web/Controllers/IndexController.cs
+++ b/src/SMAPI.Web/Controllers/IndexController.cs
@@ -94,7 +94,7 @@ namespace StardewModdingAPI.Web.Controllers
                 // strip 'noinclude' blocks from release description
                 if (release != null)
                 {
-                    HtmlDocument doc = new HtmlDocument();
+                    HtmlDocument doc = new();
                     doc.LoadHtml(release.Body);
                     foreach (HtmlNode node in doc.DocumentNode.SelectNodes("//*[@class='noinclude']")?.ToArray() ?? Array.Empty<HtmlNode>())
                         node.Remove();
diff --git a/src/SMAPI.Web/Controllers/JsonValidatorController.cs b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
index e06c1236..bcd4097a 100644
--- a/src/SMAPI.Web/Controllers/JsonValidatorController.cs
+++ b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
@@ -197,7 +197,7 @@ namespace StardewModdingAPI.Web.Controllers
                 return null;
 
             // get matching file
-            DirectoryInfo schemaDir = new DirectoryInfo(Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "schemas"));
+            DirectoryInfo schemaDir = new(Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "schemas"));
             foreach (FileInfo file in schemaDir.EnumerateFiles("*.json"))
             {
                 if (file.Name.Equals($"{id}.json"))
diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index dfe2504b..5329df99 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -135,7 +135,7 @@ namespace StardewModdingAPI.Web.Controllers
             bool isSmapiBeta = apiVersion.IsPrerelease() && apiVersion.PrereleaseTag.StartsWith("beta");
 
             // get latest versions
-            ModEntryModel result = new ModEntryModel { ID = search.ID };
+            ModEntryModel result = new() { ID = search.ID };
             IList<string> errors = new List<string>();
             ModEntryVersionModel main = null;
             ModEntryVersionModel optional = null;
diff --git a/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs b/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
index b8b05878..9689807c 100644
--- a/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
@@ -90,7 +90,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Chucklefish
         /// <param name="id">The mod ID.</param>
         private string GetModUrl(uint id)
         {
-            UriBuilder builder = new UriBuilder(this.Client.BaseClient.BaseAddress);
+            UriBuilder builder = new(this.Client.BaseClient.BaseAddress);
             builder.Path += string.Format(this.ModPageUrlFormat, id);
             return builder.Uri.ToString();
         }
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
index d8008721..50a3336d 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
@@ -17,7 +17,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.CurseForge
         private readonly IClient Client;
 
         /// <summary>A regex pattern which matches a version number in a CurseForge mod file name.</summary>
-        private readonly Regex VersionInNamePattern = new Regex(@"^(?:.+? | *)v?(\d+\.\d+(?:\.\d+)?(?:-.+?)?) *(?:\.(?:zip|rar|7z))?$", RegexOptions.Compiled);
+        private readonly Regex VersionInNamePattern = new(@"^(?:.+? | *)v?(\d+\.\d+(?:\.\d+)?(?:-.+?)?) *(?:\.(?:zip|rar|7z))?$", RegexOptions.Compiled);
 
 
         /*********
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
index 4ba94f81..571f06bc 100644
--- a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
@@ -195,7 +195,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
         /// <param name="id">The mod ID.</param>
         private string GetModUrl(uint id)
         {
-            UriBuilder builder = new UriBuilder(this.WebClient.BaseClient.BaseAddress);
+            UriBuilder builder = new(this.WebClient.BaseClient.BaseAddress);
             builder.Path += string.Format(this.WebModUrlFormat, id);
             return builder.Uri.ToString();
         }
diff --git a/src/SMAPI.Web/Framework/Compression/GzipHelper.cs b/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
index 676d660d..93cde9d3 100644
--- a/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
+++ b/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
@@ -29,9 +29,9 @@ namespace StardewModdingAPI.Web.Framework.Compression
 
             // compressed
             byte[] compressedData;
-            using (MemoryStream stream = new MemoryStream())
+            using (MemoryStream stream = new())
             {
-                using (GZipStream zipStream = new GZipStream(stream, CompressionLevel.Optimal, leaveOpen: true))
+                using (GZipStream zipStream = new(stream, CompressionLevel.Optimal, leaveOpen: true))
                     zipStream.Write(buffer, 0, buffer.Length);
 
                 stream.Position = 0;
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Web.Framework.Compression
                 return rawText;
 
             // decompress
-            using MemoryStream memoryStream = new MemoryStream();
+            using MemoryStream memoryStream = new();
             {
                 // read length prefix
                 int dataLength = BitConverter.ToInt32(zipBuffer, 0);
@@ -78,7 +78,7 @@ namespace StardewModdingAPI.Web.Framework.Compression
                 // read data
                 byte[] buffer = new byte[dataLength];
                 memoryStream.Position = 0;
-                using (GZipStream gZipStream = new GZipStream(memoryStream, CompressionMode.Decompress))
+                using (GZipStream gZipStream = new(memoryStream, CompressionMode.Decompress))
                     gZipStream.Read(buffer, 0, buffer.Length);
 
                 // return original string
diff --git a/src/SMAPI.Web/Framework/Extensions.cs b/src/SMAPI.Web/Framework/Extensions.cs
index 5305b142..2e767b3d 100644
--- a/src/SMAPI.Web/Framework/Extensions.cs
+++ b/src/SMAPI.Web/Framework/Extensions.cs
@@ -29,7 +29,7 @@ namespace StardewModdingAPI.Web.Framework
         public static string PlainAction(this IUrlHelper helper, [AspMvcAction] string action, [AspMvcController] string controller, object values = null, bool absoluteUrl = false)
         {
             // get route values
-            RouteValueDictionary valuesDict = new RouteValueDictionary(values);
+            RouteValueDictionary valuesDict = new(values);
             foreach (var value in helper.ActionContext.RouteData.Values)
             {
                 if (!valuesDict.ContainsKey(value.Key))
@@ -45,7 +45,7 @@ namespace StardewModdingAPI.Web.Framework
             if (absoluteUrl)
             {
                 HttpRequest request = helper.ActionContext.HttpContext.Request;
-                Uri baseUri = new Uri($"{request.Scheme}://{request.Host}");
+                Uri baseUri = new($"{request.Scheme}://{request.Host}");
                 url = new Uri(baseUri, url).ToString();
             }
 
diff --git a/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs b/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
index 385c0c91..3c1405eb 100644
--- a/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
+++ b/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
@@ -9,7 +9,7 @@ namespace StardewModdingAPI.Web.Framework
         ** Fields
         *********/
         /// <summary>An authorization filter that allows local requests.</summary>
-        private static readonly LocalRequestsOnlyAuthorizationFilter LocalRequestsOnlyFilter = new LocalRequestsOnlyAuthorizationFilter();
+        private static readonly LocalRequestsOnlyAuthorizationFilter LocalRequestsOnlyFilter = new();
 
 
         /*********
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs b/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
index 992876ef..9da27d61 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
@@ -23,7 +23,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         public string Mod { get; set; }
 
         /// <summary>The text for the next log message.</summary>
-        private readonly StringBuilder Text = new StringBuilder();
+        private readonly StringBuilder Text = new();
 
 
         /*********
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 887d0105..6a3ea222 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -14,38 +14,38 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         ** Fields
         *********/
         /// <summary>A regex pattern matching the start of a SMAPI message.</summary>
-        private readonly Regex MessageHeaderPattern = new Regex(@"^\[(?<time>\d\d[:\.]\d\d[:\.]\d\d) (?<level>[a-z]+)(?: +screen_(?<screen>\d+))? +(?<modName>[^\]]+)\] ", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex MessageHeaderPattern = new(@"^\[(?<time>\d\d[:\.]\d\d[:\.]\d\d) (?<level>[a-z]+)(?: +screen_(?<screen>\d+))? +(?<modName>[^\]]+)\] ", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching SMAPI's initial platform info message.</summary>
-        private readonly Regex InfoLinePattern = new Regex(@"^SMAPI (?<apiVersion>.+) with Stardew Valley (?<gameVersion>.+) on (?<os>.+)", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex InfoLinePattern = new(@"^SMAPI (?<apiVersion>.+) with Stardew Valley (?<gameVersion>.+) on (?<os>.+)", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching SMAPI's mod folder path line.</summary>
-        private readonly Regex ModPathPattern = new Regex(@"^Mods go here: (?<path>.+)", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ModPathPattern = new(@"^Mods go here: (?<path>.+)", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching SMAPI's log timestamp line.</summary>
-        private readonly Regex LogStartedAtPattern = new Regex(@"^Log started at (?<timestamp>.+) UTC", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex LogStartedAtPattern = new(@"^Log started at (?<timestamp>.+) UTC", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching the start of SMAPI's mod list.</summary>
-        private readonly Regex ModListStartPattern = new Regex(@"^Loaded \d+ mods:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ModListStartPattern = new(@"^Loaded \d+ mods:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching an entry in SMAPI's mod list.</summary>
         /// <remarks>The author name and description are optional.</remarks>
-        private readonly Regex ModListEntryPattern = new Regex(@"^   (?<name>.+?) (?<version>[^\s]+)(?: by (?<author>[^\|]+))?(?: \| (?<description>.+))?$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ModListEntryPattern = new(@"^   (?<name>.+?) (?<version>[^\s]+)(?: by (?<author>[^\|]+))?(?: \| (?<description>.+))?$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching the start of SMAPI's content pack list.</summary>
-        private readonly Regex ContentPackListStartPattern = new Regex(@"^Loaded \d+ content packs:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ContentPackListStartPattern = new(@"^Loaded \d+ content packs:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching an entry in SMAPI's content pack list.</summary>
-        private readonly Regex ContentPackListEntryPattern = new Regex(@"^   (?<name>.+?) (?<version>[^\s]+)(?: by (?<author>[^\|]+))? \| for (?<for>[^\|]+)(?: \| (?<description>.+))?$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ContentPackListEntryPattern = new(@"^   (?<name>.+?) (?<version>[^\s]+)(?: by (?<author>[^\|]+))? \| for (?<for>[^\|]+)(?: \| (?<description>.+))?$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching the start of SMAPI's mod update list.</summary>
-        private readonly Regex ModUpdateListStartPattern = new Regex(@"^You can update \d+ mods?:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ModUpdateListStartPattern = new(@"^You can update \d+ mods?:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching an entry in SMAPI's mod update list.</summary>
-        private readonly Regex ModUpdateListEntryPattern = new Regex(@"^   (?<name>.+) (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ModUpdateListEntryPattern = new(@"^   (?<name>.+) (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching SMAPI's update line.</summary>
-        private readonly Regex SmapiUpdatePattern = new Regex(@"^You can update SMAPI to (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex SmapiUpdatePattern = new(@"^You can update SMAPI to (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
 
         /*********
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 }
 
                 // init log
-                ParsedLog log = new ParsedLog
+                ParsedLog log = new()
                 {
                     IsValid = true,
                     RawText = logText,
@@ -77,8 +77,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 };
 
                 // parse log messages
-                LogModInfo smapiMod = new LogModInfo { Name = "SMAPI", Author = "Pathoschild", Description = "", Loaded = true };
-                LogModInfo gameMod = new LogModInfo { Name = "game", Author = "", Description = "", Loaded = true };
+                LogModInfo smapiMod = new() { Name = "SMAPI", Author = "Pathoschild", Description = "", Loaded = true };
+                LogModInfo gameMod = new() { Name = "game", Author = "", Description = "", Loaded = true };
                 IDictionary<string, List<LogModInfo>> mods = new Dictionary<string, List<LogModInfo>>();
                 bool inModList = false;
                 bool inContentPackList = false;
@@ -288,8 +288,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         /// <exception cref="LogParseException">The log text can't be parsed successfully.</exception>
         private IEnumerable<LogMessage> GetMessages(string logText)
         {
-            LogMessageBuilder builder = new LogMessageBuilder();
-            using StringReader reader = new StringReader(logText);
+            LogMessageBuilder builder = new();
+            using StringReader reader = new(logText);
             while (true)
             {
                 // read line
diff --git a/src/SMAPI.Web/Framework/Storage/StorageProvider.cs b/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
index c6f8bac1..1104df89 100644
--- a/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
+++ b/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
@@ -103,7 +103,7 @@ namespace StardewModdingAPI.Web.Framework.Storage
                         // fetch file
                         Response<BlobDownloadInfo> response = await blob.DownloadAsync();
                         using BlobDownloadInfo result = response.Value;
-                        using StreamReader reader = new StreamReader(result.Content);
+                        using StreamReader reader = new(result.Content);
                         DateTimeOffset expiry = result.Details.LastModified + TimeSpan.FromDays(this.ExpiryDays);
                         string content = this.GzipHelper.DecompressString(reader.ReadToEnd());
 
@@ -130,7 +130,7 @@ namespace StardewModdingAPI.Web.Framework.Storage
                 else
                 {
                     // get file
-                    FileInfo file = new FileInfo(this.GetDevFilePath(id));
+                    FileInfo file = new(this.GetDevFilePath(id));
                     if (file.Exists && file.LastWriteTimeUtc.AddDays(this.ExpiryDays) < DateTime.UtcNow) // expired
                         file.Delete();
                     if (!file.Exists)
diff --git a/src/SMAPI.Web/ViewModels/LogParserModel.cs b/src/SMAPI.Web/ViewModels/LogParserModel.cs
index 0b6d7722..5aa2fd92 100644
--- a/src/SMAPI.Web/ViewModels/LogParserModel.cs
+++ b/src/SMAPI.Web/ViewModels/LogParserModel.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Web.ViewModels
         ** Fields
         *********/
         /// <summary>A regex pattern matching characters to remove from a mod name to create the slug ID.</summary>
-        private readonly Regex SlugInvalidCharPattern = new Regex("[^a-z0-9]", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex SlugInvalidCharPattern = new("[^a-z0-9]", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
 
         /*********
diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index a745592c..4fbc9c42 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -14,10 +14,10 @@ namespace StardewModdingAPI
         ** Fields
         *********/
         /// <summary>Whether the player has loaded a save and the world has finished initializing.</summary>
-        private static readonly PerScreen<bool> IsWorldReadyForScreen = new PerScreen<bool>();
+        private static readonly PerScreen<bool> IsWorldReadyForScreen = new();
 
         /// <summary>The current stage in the game's loading process.</summary>
-        private static readonly PerScreen<LoadStage> LoadStageForScreen = new PerScreen<LoadStage>();
+        private static readonly PerScreen<LoadStage> LoadStageForScreen = new();
 
         /// <summary>Whether a player save has been loaded.</summary>
         internal static bool IsSaveLoaded => Game1.hasLoadedGame && !(Game1.activeClickableMenu is TitleMenu);
diff --git a/src/SMAPI/Framework/CommandManager.cs b/src/SMAPI/Framework/CommandManager.cs
index ff540ad8..a7b64cb7 100644
--- a/src/SMAPI/Framework/CommandManager.cs
+++ b/src/SMAPI/Framework/CommandManager.cs
@@ -166,7 +166,7 @@ namespace StardewModdingAPI.Framework
         {
             bool inQuotes = false;
             IList<string> args = new List<string>();
-            StringBuilder currentArg = new StringBuilder();
+            StringBuilder currentArg = new();
             foreach (char ch in input)
             {
                 if (ch == '"')
diff --git a/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs b/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
index 45b34556..643267ce 100644
--- a/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
+++ b/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
@@ -30,7 +30,7 @@ namespace StardewModdingAPI.Framework.Commands
         {
             SearchResult[] matches = this.FilterPatches(args).OrderBy(p => p.MethodName).ToArray();
 
-            StringBuilder result = new StringBuilder();
+            StringBuilder result = new();
 
             if (!matches.Any())
                 result.AppendLine("No current patches match your search.");
diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 26e4986e..0458f80a 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -96,8 +96,8 @@ namespace StardewModdingAPI.Framework.Content
                 for (int y = 0; y < sourceArea.Value.Height; y++)
                 {
                     // calculate tile positions
-                    Point sourcePos = new Point(sourceArea.Value.X + x, sourceArea.Value.Y + y);
-                    Point targetPos = new Point(targetArea.Value.X + x, targetArea.Value.Y + y);
+                    Point sourcePos = new(sourceArea.Value.X + x, sourceArea.Value.Y + y);
+                    Point targetPos = new(targetArea.Value.X + x, targetArea.Value.Y + y);
 
                     // replace tiles on target-only layers
                     if (replaceAll)
diff --git a/src/SMAPI/Framework/DeprecationManager.cs b/src/SMAPI/Framework/DeprecationManager.cs
index fc1b434b..ad6a3677 100644
--- a/src/SMAPI/Framework/DeprecationManager.cs
+++ b/src/SMAPI/Framework/DeprecationManager.cs
@@ -11,7 +11,7 @@ namespace StardewModdingAPI.Framework
         ** Fields
         *********/
         /// <summary>The deprecations which have already been logged (as 'mod name::noun phrase::version').</summary>
-        private readonly HashSet<string> LoggedDeprecations = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+        private readonly HashSet<string> LoggedDeprecations = new(StringComparer.OrdinalIgnoreCase);
 
         /// <summary>Encapsulates monitoring and logging for a given module.</summary>
         private readonly IMonitor Monitor;
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index 154ef659..1c8b9d04 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -18,7 +18,7 @@ namespace StardewModdingAPI.Framework.Events
         protected readonly ModRegistry ModRegistry;
 
         /// <summary>The underlying event handlers.</summary>
-        private readonly List<ManagedEventHandler<TEventArgs>> Handlers = new List<ManagedEventHandler<TEventArgs>>();
+        private readonly List<ManagedEventHandler<TEventArgs>> Handlers = new();
 
         /// <summary>A cached snapshot of <see cref="Handlers"/>, or <c>null</c> to rebuild it next raise.</summary>
         private ManagedEventHandler<TEventArgs>[] CachedHandlers = Array.Empty<ManagedEventHandler<TEventArgs>>();
diff --git a/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs b/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
index eadb7a8a..09bc48b6 100644
--- a/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Framework.Input
         private KeyboardState? State;
 
         /// <summary>The pressed buttons.</summary>
-        private readonly HashSet<Keys> PressedButtons = new HashSet<Keys>();
+        private readonly HashSet<Keys> PressedButtons = new();
 
 
         /*********
diff --git a/src/SMAPI/Framework/Input/SInputState.cs b/src/SMAPI/Framework/Input/SInputState.cs
index a8d1f371..5ff7432b 100644
--- a/src/SMAPI/Framework/Input/SInputState.cs
+++ b/src/SMAPI/Framework/Input/SInputState.cs
@@ -21,10 +21,10 @@ namespace StardewModdingAPI.Framework.Input
         private Vector2? LastPlayerTile;
 
         /// <summary>The buttons to press until the game next handles input.</summary>
-        private readonly HashSet<SButton> CustomPressedKeys = new HashSet<SButton>();
+        private readonly HashSet<SButton> CustomPressedKeys = new();
 
         /// <summary>The buttons to consider released until the actual button is released.</summary>
-        private readonly HashSet<SButton> CustomReleasedKeys = new HashSet<SButton>();
+        private readonly HashSet<SButton> CustomReleasedKeys = new();
 
         /// <summary>Whether there are new overrides in <see cref="CustomPressedKeys"/> or <see cref="CustomReleasedKeys"/> that haven't been applied to the previous state.</summary>
         private bool HasNewOverrides;
@@ -72,7 +72,7 @@ namespace StardewModdingAPI.Framework.Input
                 var controller = new GamePadStateBuilder(base.GetGamePadState());
                 var keyboard = new KeyboardStateBuilder(base.GetKeyboardState());
                 var mouse = new MouseStateBuilder(base.GetMouseState());
-                Vector2 cursorAbsolutePos = new Vector2((mouse.X * zoomMultiplier) + Game1.viewport.X, (mouse.Y * zoomMultiplier) + Game1.viewport.Y);
+                Vector2 cursorAbsolutePos = new((mouse.X * zoomMultiplier) + Game1.viewport.X, (mouse.Y * zoomMultiplier) + Game1.viewport.Y);
                 Vector2? playerTilePos = Context.IsPlayerFree ? Game1.player.getTileLocation() : (Vector2?)null;
                 HashSet<SButton> reallyDown = new HashSet<SButton>(this.GetPressedButtons(keyboard, mouse, controller));
 
@@ -203,8 +203,8 @@ namespace StardewModdingAPI.Framework.Input
         /// <param name="zoomMultiplier">The multiplier applied to pixel coordinates to adjust them for pixel zoom.</param>
         private CursorPosition GetCursorPosition(MouseState mouseState, Vector2 absolutePixels, float zoomMultiplier)
         {
-            Vector2 screenPixels = new Vector2(mouseState.X * zoomMultiplier, mouseState.Y * zoomMultiplier);
-            Vector2 tile = new Vector2((int)((Game1.viewport.X + screenPixels.X) / Game1.tileSize), (int)((Game1.viewport.Y + screenPixels.Y) / Game1.tileSize));
+            Vector2 screenPixels = new(mouseState.X * zoomMultiplier, mouseState.Y * zoomMultiplier);
+            Vector2 tile = new((int)((Game1.viewport.X + screenPixels.X) / Game1.tileSize), (int)((Game1.viewport.Y + screenPixels.Y) / Game1.tileSize));
             Vector2 grabTile = (Game1.mouseCursorTransparency > 0 && Utility.tileWithinRadiusOfPlayer((int)tile.X, (int)tile.Y, 1, Game1.player)) // derived from Game1.pressActionButton
                 ? tile
                 : Game1.player.GetGrabTile();
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index cb5fa2ae..4480f4e8 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -36,13 +36,13 @@ namespace StardewModdingAPI.Framework.ModLoading
         private readonly AssemblyDefinitionResolver AssemblyDefinitionResolver;
 
         /// <summary>Provides assembly symbol readers for Mono.Cecil.</summary>
-        private readonly SymbolReaderProvider SymbolReaderProvider = new SymbolReaderProvider();
+        private readonly SymbolReaderProvider SymbolReaderProvider = new();
 
         /// <summary>Provides assembly symbol writers for Mono.Cecil.</summary>
-        private readonly SymbolWriterProvider SymbolWriterProvider = new SymbolWriterProvider();
+        private readonly SymbolWriterProvider SymbolWriterProvider = new();
 
         /// <summary>The objects to dispose as part of this instance.</summary>
-        private readonly HashSet<IDisposable> Disposables = new HashSet<IDisposable>();
+        private readonly HashSet<IDisposable> Disposables = new();
 
         /// <summary>Whether to rewrite mods for compatibility.</summary>
         private readonly bool RewriteMods;
@@ -141,8 +141,8 @@ namespace StardewModdingAPI.Framework.ModLoading
                         this.Monitor.Log($"      Loading {assembly.File.Name} (rewritten)...", LogLevel.Trace);
 
                     // load assembly
-                    using MemoryStream outAssemblyStream = new MemoryStream();
-                    using MemoryStream outSymbolStream = new MemoryStream();
+                    using MemoryStream outAssemblyStream = new();
+                    using MemoryStream outSymbolStream = new();
                     assembly.Definition.Write(outAssemblyStream, new WriterParameters { WriteSymbols = true, SymbolStream = outSymbolStream, SymbolWriterProvider = this.SymbolWriterProvider });
                     byte[] bytes = outAssemblyStream.ToArray();
                     lastAssembly = Assembly.Load(bytes, outSymbolStream.ToArray());
@@ -241,7 +241,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 try
                 {
                     // read assembly with symbols
-                    FileInfo symbolsFile = new FileInfo(Path.Combine(Path.GetDirectoryName(file.FullName)!, Path.GetFileNameWithoutExtension(file.FullName)) + ".pdb");
+                    FileInfo symbolsFile = new(Path.Combine(Path.GetDirectoryName(file.FullName)!, Path.GetFileNameWithoutExtension(file.FullName)) + ".pdb");
                     if (symbolsFile.Exists)
                         this.SymbolReaderProvider.TryAddSymbolData(file.Name, () => this.TrackForDisposal(symbolsFile.OpenRead()));
                     assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true, ReadSymbols = true, SymbolReaderProvider = this.SymbolReaderProvider }));
@@ -266,7 +266,7 @@ namespace StardewModdingAPI.Framework.ModLoading
             // yield referenced assemblies
             foreach (AssemblyNameReference dependency in assembly.MainModule.AssemblyReferences)
             {
-                FileInfo dependencyFile = new FileInfo(Path.Combine(file.Directory.FullName, $"{dependency.Name}.dll"));
+                FileInfo dependencyFile = new(Path.Combine(file.Directory.FullName, $"{dependency.Name}.dll"));
                 foreach (AssemblyParseResult result in this.GetReferencedLocalAssemblies(dependencyFile, visitedAssemblyNames, assemblyResolver))
                     yield return result;
             }
@@ -333,7 +333,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
             // find or rewrite code
             IInstructionHandler[] handlers = new InstructionMetadata().GetHandlers(this.ParanoidMode, platformChanged, this.RewriteMods).ToArray();
-            RecursiveRewriter rewriter = new RecursiveRewriter(
+            RecursiveRewriter rewriter = new(
                 module: module,
                 rewriteModule: curModule =>
                 {
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 4b05d1e5..e3386f75 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -401,7 +401,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         {
             foreach (string modRootPath in Directory.GetDirectories(rootPath))
             {
-                DirectoryInfo directory = new DirectoryInfo(modRootPath);
+                DirectoryInfo directory = new(modRootPath);
 
                 // if a folder only contains another folder, check the inner folder instead
                 while (!directory.GetFiles().Any() && directory.GetDirectories().Length == 1)
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
index 44074337..d28c4a22 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
@@ -16,7 +16,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Symbols
         private readonly ISymbolReaderProvider BaseProvider = new DefaultSymbolReaderProvider(throwIfNoSymbol: false);
 
         /// <summary>The symbol data loaded by absolute assembly path.</summary>
-        private readonly Dictionary<string, Stream> SymbolsByAssemblyPath = new Dictionary<string, Stream>(StringComparer.OrdinalIgnoreCase);
+        private readonly Dictionary<string, Stream> SymbolsByAssemblyPath = new(StringComparer.OrdinalIgnoreCase);
 
 
         /*********
diff --git a/src/SMAPI/Framework/ModRegistry.cs b/src/SMAPI/Framework/ModRegistry.cs
index ef389337..99548cf8 100644
--- a/src/SMAPI/Framework/ModRegistry.cs
+++ b/src/SMAPI/Framework/ModRegistry.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework
         ** Fields
         *********/
         /// <summary>The registered mod data.</summary>
-        private readonly List<IModMetadata> Mods = new List<IModMetadata>();
+        private readonly List<IModMetadata> Mods = new();
 
         /// <summary>An assembly full name => mod lookup.</summary>
         private readonly IDictionary<string, IModMetadata> ModNamesByAssembly = new Dictionary<string, IModMetadata>();
@@ -94,7 +94,7 @@ namespace StardewModdingAPI.Framework
         public IModMetadata GetFromStack()
         {
             // get stack frames
-            StackTrace stack = new StackTrace();
+            StackTrace stack = new();
             StackFrame[] frames = stack.GetFrames();
             if (frames == null)
                 return null;
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 9174aea6..35180df2 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -26,7 +26,7 @@ namespace StardewModdingAPI.Framework.Models
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
-        private static readonly HashSet<string> DefaultSuppressUpdateChecks = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
+        private static readonly HashSet<string> DefaultSuppressUpdateChecks = new(StringComparer.OrdinalIgnoreCase)
         {
             "SMAPI.ConsoleCommands",
             "SMAPI.ErrorHandler",
diff --git a/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs b/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
index ac9cf313..71e11576 100644
--- a/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
+++ b/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
@@ -45,8 +45,8 @@ namespace StardewModdingAPI.Framework.Networking
         [SuppressMessage("ReSharper", "AccessToDisposedClosure", Justification = "The callback is invoked synchronously.")]
         protected override void onReceiveMessage(GalaxyID peer, Stream messageStream)
         {
-            using IncomingMessage message = new IncomingMessage();
-            using BinaryReader reader = new BinaryReader(messageStream);
+            using IncomingMessage message = new();
+            using BinaryReader reader = new(messageStream);
 
             message.Read(reader);
             ulong peerID = peer.ToUint64(); // note: GalaxyID instances get reused, so need to store the underlying ID instead
@@ -57,7 +57,7 @@ namespace StardewModdingAPI.Framework.Networking
                 else if (message.MessageType == StardewValley.Multiplayer.playerIntroduction)
                 {
                     NetFarmerRoot farmer = this.Multiplayer.readFarmer(message.Reader);
-                    GalaxyID capturedPeer = new GalaxyID(peerID);
+                    GalaxyID capturedPeer = new(peerID);
                     this.gameServer.checkFarmhandRequest(Convert.ToString(peerID), this.getConnectionId(peer), farmer, msg => this.sendMessage(capturedPeer, msg), () => this.peers[farmer.Value.UniqueMultiplayerID] = capturedPeer.ToUint64());
                 }
             });
diff --git a/src/SMAPI/Framework/Networking/SLidgrenServer.cs b/src/SMAPI/Framework/Networking/SLidgrenServer.cs
index 05c8b872..ff871e64 100644
--- a/src/SMAPI/Framework/Networking/SLidgrenServer.cs
+++ b/src/SMAPI/Framework/Networking/SLidgrenServer.cs
@@ -44,9 +44,9 @@ namespace StardewModdingAPI.Framework.Networking
         {
             // add hook to call multiplayer core
             NetConnection peer = rawMessage.SenderConnection;
-            using IncomingMessage message = new IncomingMessage();
+            using IncomingMessage message = new();
             using Stream readStream = new NetBufferReadStream(rawMessage);
-            using BinaryReader reader = new BinaryReader(readStream);
+            using BinaryReader reader = new(readStream);
 
             while (rawMessage.LengthBits - rawMessage.Position >= 8)
             {
diff --git a/src/SMAPI/Framework/Reflection/Reflector.cs b/src/SMAPI/Framework/Reflection/Reflector.cs
index 889c7ed6..3a93ab5d 100644
--- a/src/SMAPI/Framework/Reflection/Reflector.cs
+++ b/src/SMAPI/Framework/Reflection/Reflector.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.Reflection
         ** Fields
         *********/
         /// <summary>The cached fields and methods found via reflection.</summary>
-        private readonly MemoryCache Cache = new MemoryCache(typeof(Reflector).FullName);
+        private readonly MemoryCache Cache = new(typeof(Reflector).FullName);
 
         /// <summary>The sliding cache expiration time.</summary>
         private readonly TimeSpan SlidingCacheExpiry = TimeSpan.FromMinutes(5);
@@ -268,7 +268,7 @@ namespace StardewModdingAPI.Framework.Reflection
 
             // fetch & cache new value
             TMemberInfo result = fetch();
-            CacheEntry cacheEntry = new CacheEntry(result != null, result);
+            CacheEntry cacheEntry = new(result != null, result);
             this.Cache.Add(key, cacheEntry, new CacheItemPolicy { SlidingExpiration = this.SlidingCacheExpiry });
             return result;
         }
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 104cf330..989b59d8 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -37,7 +37,7 @@ namespace StardewModdingAPI.Framework
         private readonly EventManager Events;
 
         /// <summary>The maximum number of consecutive attempts SMAPI should make to recover from a draw error.</summary>
-        private readonly Countdown DrawCrashTimer = new Countdown(60); // 60 ticks = roughly one second
+        private readonly Countdown DrawCrashTimer = new(60); // 60 ticks = roughly one second
 
         /// <summary>Simplifies access to private game code.</summary>
         private readonly Reflector Reflection;
@@ -71,14 +71,14 @@ namespace StardewModdingAPI.Framework
         public WatcherCore Watchers { get; private set; }
 
         /// <summary>A snapshot of the current <see cref="Watchers"/> state.</summary>
-        public WatcherSnapshot WatcherSnapshot { get; } = new WatcherSnapshot();
+        public WatcherSnapshot WatcherSnapshot { get; } = new();
 
         /// <summary>Whether the current update tick is the first one for this instance.</summary>
         public bool IsFirstTick = true;
 
         /// <summary>The number of ticks until SMAPI should notify mods that the game has loaded.</summary>
         /// <remarks>Skipping a few frames ensures the game finishes initializing the world before mods try to change it.</remarks>
-        public Countdown AfterLoadTimer { get; } = new Countdown(5);
+        public Countdown AfterLoadTimer { get; } = new(5);
 
         /// <summary>Whether the game is saving and SMAPI has already raised <see cref="IGameLoopEvents.Saving"/>.</summary>
         public bool IsBetweenSaveEvents { get; set; }
@@ -624,7 +624,7 @@ namespace StardewModdingAPI.Framework
                     if (tile != null)
                     {
                         Vector2 vector_draw_position = Game1.GlobalToLocal(Game1.viewport, tile_position * 64f);
-                        Location draw_location = new Location((int)vector_draw_position.X, (int)vector_draw_position.Y);
+                        Location draw_location = new((int)vector_draw_position.X, (int)vector_draw_position.Y);
                         Game1.mapDisplayDevice.DrawTile(tile, draw_location, (tile_position.Y * 64f - 1f) / 10000f);
                     }
                 }
diff --git a/src/SMAPI/Framework/SGameRunner.cs b/src/SMAPI/Framework/SGameRunner.cs
index b816bb7c..81cac145 100644
--- a/src/SMAPI/Framework/SGameRunner.cs
+++ b/src/SMAPI/Framework/SGameRunner.cs
@@ -93,7 +93,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="instanceIndex">The instance index.</param>
         public override Game1 CreateGameInstance(PlayerIndex playerIndex = PlayerIndex.One, int instanceIndex = 0)
         {
-            SInputState inputState = new SInputState();
+            SInputState inputState = new();
             return new SGame(playerIndex, instanceIndex, this.Monitor, this.Reflection, this.Events, inputState, this.ModHooks, this.Multiplayer, this.ExitGameImmediately, this.OnPlayerInstanceUpdating, this.OnGameContentLoaded);
         }
 
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index 5956b63f..3981e4e5 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -56,10 +56,10 @@ namespace StardewModdingAPI.Framework
         private readonly bool LogNetworkTraffic;
 
         /// <summary>The backing field for <see cref="Peers"/>.</summary>
-        private readonly PerScreen<IDictionary<long, MultiplayerPeer>> PeersImpl = new PerScreen<IDictionary<long, MultiplayerPeer>>(() => new Dictionary<long, MultiplayerPeer>());
+        private readonly PerScreen<IDictionary<long, MultiplayerPeer>> PeersImpl = new(() => new Dictionary<long, MultiplayerPeer>());
 
         /// <summary>The backing field for <see cref="HostPeer"/>.</summary>
-        private readonly PerScreen<MultiplayerPeer> HostPeerImpl = new PerScreen<MultiplayerPeer>();
+        private readonly PerScreen<MultiplayerPeer> HostPeerImpl = new();
 
 
         /*********
@@ -196,7 +196,7 @@ namespace StardewModdingAPI.Framework
                         this.Monitor.Log($"Received context for farmhand {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.", LogLevel.Trace);
 
                         // store peer
-                        MultiplayerPeer newPeer = new MultiplayerPeer(
+                        MultiplayerPeer newPeer = new(
                             playerID: message.FarmerID,
                             screenID: this.GetScreenId(message.FarmerID),
                             model: model,
@@ -244,7 +244,7 @@ namespace StardewModdingAPI.Framework
                     if (!this.Peers.ContainsKey(message.FarmerID))
                     {
                         this.Monitor.Log($"Received connection for vanilla player {message.FarmerID}.", LogLevel.Trace);
-                        MultiplayerPeer peer = new MultiplayerPeer(
+                        MultiplayerPeer peer = new(
                             playerID: message.FarmerID,
                             screenID: this.GetScreenId(message.FarmerID),
                             model: null,
@@ -292,7 +292,7 @@ namespace StardewModdingAPI.Framework
                         this.Monitor.Log($"Received context for {(model?.IsHost == true ? "host" : "farmhand")} {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.", LogLevel.Trace);
 
                         // store peer
-                        MultiplayerPeer peer = new MultiplayerPeer(
+                        MultiplayerPeer peer = new(
                             playerID: message.FarmerID,
                             screenID: this.GetScreenId(message.FarmerID),
                             model: model,
@@ -420,7 +420,7 @@ namespace StardewModdingAPI.Framework
             }
 
             // get data to send
-            ModMessageModel model = new ModMessageModel(
+            ModMessageModel model = new(
                 fromPlayerID: Game1.player.UniqueMultiplayerID,
                 fromModID: fromModID,
                 toModIDs: toModIDs,
@@ -513,7 +513,7 @@ namespace StardewModdingAPI.Framework
             // forward to other players
             if (Context.IsMainPlayer && playerIDs.Any(p => p != Game1.player.UniqueMultiplayerID))
             {
-                ModMessageModel newModel = new ModMessageModel(model);
+                ModMessageModel newModel = new(model);
                 foreach (long playerID in playerIDs)
                 {
                     if (playerID != Game1.player.UniqueMultiplayerID && playerID != model.FromPlayerID && this.Peers.TryGetValue(playerID, out MultiplayerPeer peer))
@@ -544,7 +544,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get the fields to include in a context sync message sent to other players.</summary>
         private object[] GetContextSyncMessageFields()
         {
-            RemoteContextModel model = new RemoteContextModel
+            RemoteContextModel model = new()
             {
                 IsHost = Context.IsWorldReady && Context.IsMainPlayer,
                 Platform = Constants.TargetPlatform,
@@ -571,7 +571,7 @@ namespace StardewModdingAPI.Framework
             if (!peer.HasSmapi)
                 return new object[] { "{}" };
 
-            RemoteContextModel model = new RemoteContextModel
+            RemoteContextModel model = new()
             {
                 IsHost = peer.IsHost,
                 Platform = peer.Platform.Value,
diff --git a/src/SMAPI/Framework/Singleton.cs b/src/SMAPI/Framework/Singleton.cs
index 399a8bf0..1bf318c4 100644
--- a/src/SMAPI/Framework/Singleton.cs
+++ b/src/SMAPI/Framework/Singleton.cs
@@ -5,6 +5,6 @@ namespace StardewModdingAPI.Framework
     internal static class Singleton<T> where T : new()
     {
         /// <summary>The singleton instance.</summary>
-        public static T Instance { get; } = new T();
+        public static T Instance { get; } = new();
     }
 }
diff --git a/src/SMAPI/Framework/SnapshotListDiff.cs b/src/SMAPI/Framework/SnapshotListDiff.cs
index 2d0efa0d..1c3ebfba 100644
--- a/src/SMAPI/Framework/SnapshotListDiff.cs
+++ b/src/SMAPI/Framework/SnapshotListDiff.cs
@@ -11,10 +11,10 @@ namespace StardewModdingAPI.Framework
         ** Fields
         *********/
         /// <summary>The removed values.</summary>
-        private readonly List<T> RemovedImpl = new List<T>();
+        private readonly List<T> RemovedImpl = new();
 
         /// <summary>The added values.</summary>
-        private readonly List<T> AddedImpl = new List<T>();
+        private readonly List<T> AddedImpl = new();
 
 
         /*********
diff --git a/src/SMAPI/Framework/StateTracking/ChestTracker.cs b/src/SMAPI/Framework/StateTracking/ChestTracker.cs
index 65f58ee7..56aeeb3c 100644
--- a/src/SMAPI/Framework/StateTracking/ChestTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/ChestTracker.cs
@@ -18,10 +18,10 @@ namespace StardewModdingAPI.Framework.StateTracking
         private readonly IDictionary<Item, int> StackSizes;
 
         /// <summary>Items added since the last update.</summary>
-        private readonly HashSet<Item> Added = new HashSet<Item>(new ObjectReferenceComparer<Item>());
+        private readonly HashSet<Item> Added = new(new ObjectReferenceComparer<Item>());
 
         /// <summary>Items removed since the last update.</summary>
-        private readonly HashSet<Item> Removed = new HashSet<Item>(new ObjectReferenceComparer<Item>());
+        private readonly HashSet<Item> Removed = new(new ObjectReferenceComparer<Item>());
 
         /// <summary>The underlying inventory watcher.</summary>
         private readonly ICollectionWatcher<Item> InventoryWatcher;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
index 32ec8c7e..256370ce 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
@@ -17,10 +17,10 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         private HashSet<TValue> LastValues;
 
         /// <summary>The pairs added since the last reset.</summary>
-        private readonly List<TValue> AddedImpl = new List<TValue>();
+        private readonly List<TValue> AddedImpl = new();
 
         /// <summary>The pairs removed since the last reset.</summary>
-        private readonly List<TValue> RemovedImpl = new List<TValue>();
+        private readonly List<TValue> RemovedImpl = new();
 
 
         /*********
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
index 009e0282..84340fbf 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
@@ -11,7 +11,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ** Accessors
         *********/
         /// <summary>A singleton collection watcher instance.</summary>
-        public static ImmutableCollectionWatcher<TValue> Instance { get; } = new ImmutableCollectionWatcher<TValue>();
+        public static ImmutableCollectionWatcher<TValue> Instance { get; } = new();
 
         /// <summary>Whether the collection changed since the last reset.</summary>
         public bool IsChanged { get; } = false;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
index 21e84c47..676c9fb4 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
@@ -15,10 +15,10 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         private readonly NetCollection<TValue> Field;
 
         /// <summary>The pairs added since the last reset.</summary>
-        private readonly List<TValue> AddedImpl = new List<TValue>();
+        private readonly List<TValue> AddedImpl = new();
 
         /// <summary>The pairs removed since the last reset.</summary>
-        private readonly List<TValue> RemovedImpl = new List<TValue>();
+        private readonly List<TValue> RemovedImpl = new();
 
 
         /*********
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
index c29d2783..3e9fa8b1 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
@@ -16,13 +16,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         private readonly ObservableCollection<TValue> Field;
 
         /// <summary>The pairs added since the last reset.</summary>
-        private readonly List<TValue> AddedImpl = new List<TValue>();
+        private readonly List<TValue> AddedImpl = new();
 
         /// <summary>The pairs removed since the last reset.</summary>
-        private readonly List<TValue> RemovedImpl = new List<TValue>();
+        private readonly List<TValue> RemovedImpl = new();
 
         /// <summary>The previous values as of the last update.</summary>
-        private readonly List<TValue> PreviousValues = new List<TValue>();
+        private readonly List<TValue> PreviousValues = new();
 
 
         /*********
diff --git a/src/SMAPI/Framework/StateTracking/LocationTracker.cs b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
index 748e4ecc..f86f86ee 100644
--- a/src/SMAPI/Framework/StateTracking/LocationTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
@@ -19,7 +19,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         ** Fields
         *********/
         /// <summary>The underlying watchers.</summary>
-        private readonly List<IWatcher> Watchers = new List<IWatcher>();
+        private readonly List<IWatcher> Watchers = new();
 
 
         /*********
diff --git a/src/SMAPI/Framework/StateTracking/PlayerTracker.cs b/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
index cf49a7c1..3d470b5c 100644
--- a/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
@@ -24,7 +24,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         private GameLocation LastValidLocation;
 
         /// <summary>The underlying watchers.</summary>
-        private readonly List<IWatcher> Watchers = new List<IWatcher>();
+        private readonly List<IWatcher> Watchers = new();
 
 
         /*********
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
index 6c9cc4f5..2563d10c 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
@@ -17,25 +17,25 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         public GameLocation Location { get; }
 
         /// <summary>Tracks added or removed buildings.</summary>
-        public SnapshotListDiff<Building> Buildings { get; } = new SnapshotListDiff<Building>();
+        public SnapshotListDiff<Building> Buildings { get; } = new();
 
         /// <summary>Tracks added or removed debris.</summary>
-        public SnapshotListDiff<Debris> Debris { get; } = new SnapshotListDiff<Debris>();
+        public SnapshotListDiff<Debris> Debris { get; } = new();
 
         /// <summary>Tracks added or removed large terrain features.</summary>
-        public SnapshotListDiff<LargeTerrainFeature> LargeTerrainFeatures { get; } = new SnapshotListDiff<LargeTerrainFeature>();
+        public SnapshotListDiff<LargeTerrainFeature> LargeTerrainFeatures { get; } = new();
 
         /// <summary>Tracks added or removed NPCs.</summary>
-        public SnapshotListDiff<NPC> Npcs { get; } = new SnapshotListDiff<NPC>();
+        public SnapshotListDiff<NPC> Npcs { get; } = new();
 
         /// <summary>Tracks added or removed objects.</summary>
-        public SnapshotListDiff<KeyValuePair<Vector2, Object>> Objects { get; } = new SnapshotListDiff<KeyValuePair<Vector2, Object>>();
+        public SnapshotListDiff<KeyValuePair<Vector2, Object>> Objects { get; } = new();
 
         /// <summary>Tracks added or removed terrain features.</summary>
-        public SnapshotListDiff<KeyValuePair<Vector2, TerrainFeature>> TerrainFeatures { get; } = new SnapshotListDiff<KeyValuePair<Vector2, TerrainFeature>>();
+        public SnapshotListDiff<KeyValuePair<Vector2, TerrainFeature>> TerrainFeatures { get; } = new();
 
         /// <summary>Tracks added or removed furniture.</summary>
-        public SnapshotListDiff<Furniture> Furniture { get; } = new SnapshotListDiff<Furniture>();
+        public SnapshotListDiff<Furniture> Furniture { get; } = new();
 
         /// <summary>Tracks changed chest inventories.</summary>
         public IDictionary<Chest, SnapshotItemListDiff> ChestItems { get; } = new Dictionary<Chest, SnapshotItemListDiff>();
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
index 72f45a87..f3e42948 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         ** Fields
         *********/
         /// <summary>An empty item list diff.</summary>
-        private readonly SnapshotItemListDiff EmptyItemListDiff = new SnapshotItemListDiff(Array.Empty<Item>(), Array.Empty<Item>(), Array.Empty<ItemStackSizeChange>());
+        private readonly SnapshotItemListDiff EmptyItemListDiff = new(Array.Empty<Item>(), Array.Empty<Item>(), Array.Empty<ItemStackSizeChange>());
 
 
         /*********
@@ -24,7 +24,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         public Farmer Player { get; }
 
         /// <summary>The player's current location.</summary>
-        public SnapshotDiff<GameLocation> Location { get; } = new SnapshotDiff<GameLocation>();
+        public SnapshotDiff<GameLocation> Location { get; } = new();
 
         /// <summary>Tracks changes to the player's skill levels.</summary>
         public IDictionary<SkillType, SnapshotDiff<int>> Skills { get; } =
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
index cf51e040..afea7fb4 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
@@ -11,31 +11,31 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         ** Accessors
         *********/
         /// <summary>Tracks changes to the window size.</summary>
-        public SnapshotDiff<Point> WindowSize { get; } = new SnapshotDiff<Point>();
+        public SnapshotDiff<Point> WindowSize { get; } = new();
 
         /// <summary>Tracks changes to the current player.</summary>
         public PlayerSnapshot CurrentPlayer { get; private set; }
 
         /// <summary>Tracks changes to the time of day (in 24-hour military format).</summary>
-        public SnapshotDiff<int> Time { get; } = new SnapshotDiff<int>();
+        public SnapshotDiff<int> Time { get; } = new();
 
         /// <summary>Tracks changes to the save ID.</summary>
-        public SnapshotDiff<ulong> SaveID { get; } = new SnapshotDiff<ulong>();
+        public SnapshotDiff<ulong> SaveID { get; } = new();
 
         /// <summary>Tracks changes to the game's locations.</summary>
-        public WorldLocationsSnapshot Locations { get; } = new WorldLocationsSnapshot();
+        public WorldLocationsSnapshot Locations { get; } = new();
 
         /// <summary>Tracks changes to <see cref="Game1.activeClickableMenu"/>.</summary>
-        public SnapshotDiff<IClickableMenu> ActiveMenu { get; } = new SnapshotDiff<IClickableMenu>();
+        public SnapshotDiff<IClickableMenu> ActiveMenu { get; } = new();
 
         /// <summary>Tracks changes to the cursor position.</summary>
-        public SnapshotDiff<ICursorPosition> Cursor { get; } = new SnapshotDiff<ICursorPosition>();
+        public SnapshotDiff<ICursorPosition> Cursor { get; } = new();
 
         /// <summary>Tracks changes to the mouse wheel scroll.</summary>
-        public SnapshotDiff<int> MouseWheelScroll { get; } = new SnapshotDiff<int>();
+        public SnapshotDiff<int> MouseWheelScroll { get; } = new();
 
         /// <summary>Tracks changes to the content locale.</summary>
-        public SnapshotDiff<LocalizedContentManager.LanguageCode> Locale { get; } = new SnapshotDiff<LocalizedContentManager.LanguageCode>();
+        public SnapshotDiff<LocalizedContentManager.LanguageCode> Locale { get; } = new();
 
 
         /*********
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
index 73ed2d8f..7dee09ca 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
@@ -12,14 +12,14 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         ** Fields
         *********/
         /// <summary>A map of tracked locations.</summary>
-        private readonly Dictionary<GameLocation, LocationSnapshot> LocationsDict = new Dictionary<GameLocation, LocationSnapshot>(new ObjectReferenceComparer<GameLocation>());
+        private readonly Dictionary<GameLocation, LocationSnapshot> LocationsDict = new(new ObjectReferenceComparer<GameLocation>());
 
 
         /*********
         ** Accessors
         *********/
         /// <summary>Tracks changes to the location list.</summary>
-        public SnapshotListDiff<GameLocation> LocationList { get; } = new SnapshotListDiff<GameLocation>();
+        public SnapshotListDiff<GameLocation> LocationList { get; } = new();
 
         /// <summary>The tracked locations.</summary>
         public IEnumerable<LocationSnapshot> Locations => this.LocationsDict.Values;
diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
index 173438f1..cab1a94c 100644
--- a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -55,7 +55,7 @@ namespace MonoMod.Utils
             .GetType("System.RuntimeType+RuntimeTypeCache")
             ?.GetMethod("GetPropertyList", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
 
-        private static readonly ConditionalWeakTable<Type, CacheFixEntry> _CacheFixed = new ConditionalWeakTable<Type, CacheFixEntry>();
+        private static readonly ConditionalWeakTable<Type, CacheFixEntry> _CacheFixed = new();
 
         public static void Apply()
         {
@@ -144,7 +144,7 @@ namespace MonoMod.Utils
                     continue;
 
                 CacheFixEntry entry = _CacheFixed.GetValue(type, rt => {
-                    CacheFixEntry entryNew = new CacheFixEntry();
+                    CacheFixEntry entryNew = new();
                     object cache;
                     Array properties, fields;
 
diff --git a/src/SMAPI/Framework/WatcherCore.cs b/src/SMAPI/Framework/WatcherCore.cs
index 62a0c3b8..a1612e75 100644
--- a/src/SMAPI/Framework/WatcherCore.cs
+++ b/src/SMAPI/Framework/WatcherCore.cs
@@ -17,7 +17,7 @@ namespace StardewModdingAPI.Framework
         ** Fields
         *********/
         /// <summary>The underlying watchers for convenience. These are accessible individually as separate properties.</summary>
-        private readonly List<IWatcher> Watchers = new List<IWatcher>();
+        private readonly List<IWatcher> Watchers = new();
 
 
         /*********
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index f2f65287..29f4be1b 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -199,7 +199,7 @@ namespace StardewModdingAPI
             }
 
             // load SMAPI
-            using SCore core = new SCore(modsPath, writeToConsole);
+            using SCore core = new(modsPath, writeToConsole);
             core.RunInteractively();
         }
 

From b6c8cfc28b2c94e6dc3cb07d3058371dd6775e70 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 18:24:59 -0400
Subject: [PATCH 499/856] simplify 'is not' patterns

---
 src/SMAPI.Installer/InteractiveInstaller.cs                   | 2 +-
 .../Framework/Commands/World/ClearCommand.cs                  | 4 ++--
 src/SMAPI.Tests/Utilities/SemanticVersionTests.cs             | 2 +-
 src/SMAPI/Context.cs                                          | 4 ++--
 src/SMAPI/Framework/Content/AssetDataForObject.cs             | 2 +-
 src/SMAPI/Framework/Content/AssetInterceptorChange.cs         | 2 +-
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs     | 2 +-
 src/SMAPI/Framework/Events/ManagedEventHandler.cs             | 2 +-
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs               | 2 +-
 src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs   | 2 +-
 src/SMAPI/Framework/SCore.cs                                  | 2 +-
 11 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index a126c3b8..49ca80a5 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -808,7 +808,7 @@ namespace StardewModdingApi.Installer
             {
                 // get type
                 bool isDir = entry is DirectoryInfo;
-                if (!isDir && !(entry is FileInfo))
+                if (!isDir && entry is not FileInfo)
                     continue; // should never happen
 
                 // delete packaged mods (newer version bundled into SMAPI)
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index ceaeb278..d388f4b0 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -92,7 +92,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 
                         removed +=
                             this.RemoveObjects(location, obj =>
-                                !(obj is Chest)
+                                obj is not Chest
                                 && (
                                     obj.Name == "Weeds"
                                     || obj.Name == "Stone"
@@ -141,7 +141,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                             this.RemoveFurniture(location, p => true)
                             + this.RemoveObjects(location, p => true)
                             + this.RemoveTerrainFeatures(location, p => true)
-                            + this.RemoveLargeTerrainFeatures(location, p => everything || !(p is Bush bush) || bush.isDestroyable(location, p.currentTileLocation))
+                            + this.RemoveLargeTerrainFeatures(location, p => everything || p is not Bush bush || bush.isDestroyable(location, p.currentTileLocation))
                             + this.RemoveResourceClumps(location, p => true);
                         monitor.Log($"Done! Removed {removed} entities from {location.Name}.", LogLevel.Info);
                         break;
diff --git a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
index c8270373..142c9814 100644
--- a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
+++ b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
@@ -455,7 +455,7 @@ namespace SMAPI.Tests.Utilities
                 TestContext.WriteLine($"Exception thrown:\n{ex}");
                 return;
             }
-            catch (Exception ex) when (!(ex is AssertionException))
+            catch (Exception ex) when (ex is not AssertionException)
             {
                 TestContext.WriteLine($"Exception thrown:\n{ex}");
                 Assert.Fail(message ?? $"Didn't throw the expected exception; expected {typeof(T).FullName}, got {ex.GetType().FullName}.");
diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index 4fbc9c42..98d60b78 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -20,7 +20,7 @@ namespace StardewModdingAPI
         private static readonly PerScreen<LoadStage> LoadStageForScreen = new();
 
         /// <summary>Whether a player save has been loaded.</summary>
-        internal static bool IsSaveLoaded => Game1.hasLoadedGame && !(Game1.activeClickableMenu is TitleMenu);
+        internal static bool IsSaveLoaded => Game1.hasLoadedGame && Game1.activeClickableMenu is not TitleMenu;
 
         /// <summary>Whether the game is currently writing to the save file.</summary>
         internal static bool IsSaving => Game1.activeClickableMenu is SaveGameMenu || Game1.activeClickableMenu is ShippingMenu; // saving is performed by SaveGameMenu, but it's wrapped by ShippingMenu on days when the player shipping something
@@ -86,7 +86,7 @@ namespace StardewModdingAPI
         public static bool HasRemotePlayers => Context.IsMultiplayer && !Game1.hasLocalClientsOnly;
 
         /// <summary>Whether the current player is the main player. This is always true in single-player, and true when hosting in multiplayer.</summary>
-        public static bool IsMainPlayer => Game1.IsMasterGame && Context.ScreenId == 0 && !(TitleMenu.subMenu is FarmhandMenu);
+        public static bool IsMainPlayer => Game1.IsMasterGame && Context.ScreenId == 0 && TitleMenu.subMenu is not FarmhandMenu;
 
 
         /*********
diff --git a/src/SMAPI/Framework/Content/AssetDataForObject.cs b/src/SMAPI/Framework/Content/AssetDataForObject.cs
index d91873ae..40f49190 100644
--- a/src/SMAPI/Framework/Content/AssetDataForObject.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForObject.cs
@@ -47,7 +47,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <inheritdoc />
         public TData GetData<TData>()
         {
-            if (!(this.Data is TData))
+            if (this.Data is not TData)
                 throw new InvalidCastException($"The content data of type {this.Data.GetType().FullName} can't be converted to the requested {typeof(TData).FullName}.");
             return (TData)this.Data;
         }
diff --git a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
index 981eed40..03d6da5a 100644
--- a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
+++ b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
@@ -36,7 +36,7 @@ namespace StardewModdingAPI.Framework.Content
             this.Instance = instance ?? throw new ArgumentNullException(nameof(instance));
             this.WasAdded = wasAdded;
 
-            if (!(instance is IAssetEditor) && !(instance is IAssetLoader))
+            if (instance is not (IAssetEditor or IAssetLoader))
                 throw new InvalidCastException($"The provided {nameof(instance)} value must be an {nameof(IAssetEditor)} or {nameof(IAssetLoader)} instance.");
         }
 
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 3d37e32a..cad5f6db 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -235,7 +235,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     mod.LogAsMod($"Mod incorrectly set asset '{info.Name}'{this.GetOnBehalfOfLabel(editor.OnBehalfOf)} to a null value; ignoring override.", LogLevel.Warn);
                     asset = GetNewData(prevAsset);
                 }
-                else if (!(asset.Data is T))
+                else if (asset.Data is not T)
                 {
                     mod.LogAsMod($"Mod incorrectly set asset '{asset.Name}'{this.GetOnBehalfOfLabel(editor.OnBehalfOf)} to incompatible type '{asset.Data.GetType()}', expected '{typeof(T)}'; ignoring override.", LogLevel.Warn);
                     asset = GetNewData(prevAsset);
diff --git a/src/SMAPI/Framework/Events/ManagedEventHandler.cs b/src/SMAPI/Framework/Events/ManagedEventHandler.cs
index 28e88be0..97040f76 100644
--- a/src/SMAPI/Framework/Events/ManagedEventHandler.cs
+++ b/src/SMAPI/Framework/Events/ManagedEventHandler.cs
@@ -42,7 +42,7 @@ namespace StardewModdingAPI.Framework.Events
         /// <inheritdoc />
         public int CompareTo(object obj)
         {
-            if (!(obj is ManagedEventHandler<TEventArgs> other))
+            if (obj is not ManagedEventHandler<TEventArgs> other)
                 throw new ArgumentException("Can't compare to an unrelated object type.");
 
             int priorityCompare = -this.Priority.CompareTo(other.Priority); // higher value = sort first
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index ae914c46..14aa74c2 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -124,7 +124,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                         throw new SContentLoadException($"{this.ModName} failed loading content asset '{key}' from {source}: unknown content source '{source}'.");
                 }
             }
-            catch (Exception ex) when (!(ex is SContentLoadException))
+            catch (Exception ex) when (ex is not SContentLoadException)
             {
                 throw new SContentLoadException($"{this.ModName} failed loading content asset '{key}' from {source}.", ex);
             }
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
index 922d4bc4..f715fb6b 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
@@ -34,7 +34,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         public override bool Handle(ModuleDefinition module, TypeReference type, Action<TypeReference> replaceWith)
         {
             // detect Harmony
-            if (!(type.Scope is AssemblyNameReference scope) || scope.Name != "0Harmony")
+            if (type.Scope is not AssemblyNameReference scope || scope.Name != "0Harmony")
                 return false;
 
             // rewrite Harmony 1.x type to Harmony 2.0 type
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 1cc6a5b8..c8e0842e 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -580,7 +580,7 @@ namespace StardewModdingAPI.Framework
                 *********/
                 if (this.JustReturnedToTitle)
                 {
-                    if (!(Game1.mapDisplayDevice is SDisplayDevice))
+                    if (Game1.mapDisplayDevice is not SDisplayDevice)
                         Game1.mapDisplayDevice = this.GetMapDisplayDevice();
 
                     this.JustReturnedToTitle = false;

From 0539bb8f3705e5c50d0e5790e2af97f39aed04b8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 18:25:00 -0400
Subject: [PATCH 500/856] simplify with newer pattern features

---
 src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs     | 2 +-
 .../Framework/Commands/World/ClearCommand.cs               | 5 ++---
 src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs | 2 +-
 src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs      | 2 +-
 src/SMAPI.Toolkit/Serialization/JsonHelper.cs              | 2 +-
 .../Framework/Clients/Chucklefish/ChucklefishClient.cs     | 2 +-
 src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs       | 2 +-
 src/SMAPI/Context.cs                                       | 4 ++--
 src/SMAPI/Framework/Content/AssetDataForObject.cs          | 4 ++--
 src/SMAPI/Framework/Input/SInputState.cs                   | 2 +-
 src/SMAPI/Framework/ModLoading/ModResolver.cs              | 7 ++-----
 .../ModLoading/Rewriters/HeuristicFieldRewriter.cs         | 2 +-
 src/SMAPI/SButton.cs                                       | 2 +-
 src/SMAPI/SButtonState.cs                                  | 2 +-
 src/SMAPI/Utilities/Keybind.cs                             | 4 ++--
 src/SMAPI/Utilities/KeybindList.cs                         | 2 +-
 16 files changed, 21 insertions(+), 25 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs b/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
index 68b5001e..a1ad8aa4 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
@@ -64,7 +64,7 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
             }
 
             // conditional access
-            if (node is ConditionalAccessExpressionSyntax conditionalAccess && conditionalAccess.WhenNotNull is MemberBindingExpressionSyntax conditionalBinding)
+            if (node is ConditionalAccessExpressionSyntax { WhenNotNull: MemberBindingExpressionSyntax conditionalBinding } conditionalAccess)
             {
                 declaringType = semanticModel.GetTypeInfo(conditionalAccess.Expression).Type;
                 memberType = semanticModel.GetTypeInfo(node);
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index d388f4b0..7935b05f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -94,9 +94,8 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                             this.RemoveObjects(location, obj =>
                                 obj is not Chest
                                 && (
-                                    obj.Name == "Weeds"
-                                    || obj.Name == "Stone"
-                                    || (obj.ParentSheetIndex == 294 || obj.ParentSheetIndex == 295)
+                                    obj.Name is "Weeds" or "Stone"
+                                    || obj.ParentSheetIndex is 294 or 295
                                 )
                             )
                             + this.RemoveResourceClumps(location, clump => this.DebrisClumps.Contains(clump.parentSheetIndex.Value));
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 9b48fa99..ca313f41 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -106,7 +106,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                 {
                     foreach (int id in this.TryLoad<int, string>("Data\\weapons").Keys)
                     {
-                        yield return this.TryCreate(ItemType.Weapon, id, p => (p.ID >= 32 && p.ID <= 34)
+                        yield return this.TryCreate(ItemType.Weapon, id, p => p.ID is >= 32 and <= 34
                             ? (Item)new Slingshot(p.ID)
                             : new MeleeWeapon(p.ID)
                         );
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index d21ccec0..e16af3a8 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -137,7 +137,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
                     return new ModFolder(root, searchFolder, ModType.Xnb, null, ModParseError.XnbMod, "it's not a SMAPI mod (see https://smapi.io/xnb for info).");
 
                 // SMAPI installer
-                if (relevantFiles.Any(p => p.Name == "install on Linux.sh" || p.Name == "install on macOS.command" || p.Name == "install on Windows.bat"))
+                if (relevantFiles.Any(p => p.Name is "install on Linux.sh" or "install on macOS.command" or "install on Windows.bat"))
                     return new ModFolder(root, searchFolder, ModType.Invalid, null, ModParseError.ManifestMissing, "the SMAPI installer isn't a mod (you can delete this folder after running the installer file).");
 
                 // not a mod?
diff --git a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
index 5c465f3c..91c2e9d3 100644
--- a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
+++ b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
@@ -48,7 +48,7 @@ namespace StardewModdingAPI.Toolkit.Serialization
             {
                 json = File.ReadAllText(fullPath);
             }
-            catch (Exception ex) when (ex is DirectoryNotFoundException || ex is FileNotFoundException)
+            catch (Exception ex) when (ex is DirectoryNotFoundException or FileNotFoundException)
             {
                 result = default(TModel);
                 return false;
diff --git a/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs b/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
index 9689807c..269a04d4 100644
--- a/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
@@ -58,7 +58,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Chucklefish
                     .GetAsync(string.Format(this.ModPageUrlFormat, parsedId))
                     .AsString();
             }
-            catch (ApiException ex) when (ex.Status == HttpStatusCode.NotFound || ex.Status == HttpStatusCode.Forbidden)
+            catch (ApiException ex) when (ex.Status is HttpStatusCode.NotFound or HttpStatusCode.Forbidden)
             {
                 return page.SetError(RemoteModStatus.DoesNotExist, "Found no Chucklefish mod with this ID.");
             }
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
index 571f06bc..a6da0c1c 100644
--- a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
@@ -75,7 +75,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
                 mod = await this.GetModFromApiAsync(parsedId);
 
             // page doesn't exist
-            if (mod == null || mod.Status == NexusModStatus.Hidden || mod.Status == NexusModStatus.NotPublished)
+            if (mod == null || mod.Status is NexusModStatus.Hidden or NexusModStatus.NotPublished)
                 return page.SetError(RemoteModStatus.DoesNotExist, "Found no Nexus mod with this ID.");
 
             // return info
diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index 98d60b78..aa4ecf35 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -23,7 +23,7 @@ namespace StardewModdingAPI
         internal static bool IsSaveLoaded => Game1.hasLoadedGame && Game1.activeClickableMenu is not TitleMenu;
 
         /// <summary>Whether the game is currently writing to the save file.</summary>
-        internal static bool IsSaving => Game1.activeClickableMenu is SaveGameMenu || Game1.activeClickableMenu is ShippingMenu; // saving is performed by SaveGameMenu, but it's wrapped by ShippingMenu on days when the player shipping something
+        internal static bool IsSaving => Game1.activeClickableMenu is SaveGameMenu or ShippingMenu; // saving is performed by SaveGameMenu, but it's wrapped by ShippingMenu on days when the player shipping something
 
         /// <summary>The active split-screen instance IDs.</summary>
         internal static readonly ISet<int> ActiveScreenIds = new HashSet<int>();
@@ -39,7 +39,7 @@ namespace StardewModdingAPI
         }
 
         /// <summary>Whether the in-game world is completely unloaded and not in the process of being loaded. The world may still exist in memory at this point, but should be ignored.</summary>
-        internal static bool IsWorldFullyUnloaded => Context.LoadStage == LoadStage.ReturningToTitle || Context.LoadStage == LoadStage.None;
+        internal static bool IsWorldFullyUnloaded => Context.LoadStage is LoadStage.ReturningToTitle or LoadStage.None;
 
 
         /*********
diff --git a/src/SMAPI/Framework/Content/AssetDataForObject.cs b/src/SMAPI/Framework/Content/AssetDataForObject.cs
index 40f49190..bafd8941 100644
--- a/src/SMAPI/Framework/Content/AssetDataForObject.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForObject.cs
@@ -47,9 +47,9 @@ namespace StardewModdingAPI.Framework.Content
         /// <inheritdoc />
         public TData GetData<TData>()
         {
-            if (this.Data is not TData)
+            if (this.Data is not TData data)
                 throw new InvalidCastException($"The content data of type {this.Data.GetType().FullName} can't be converted to the requested {typeof(TData).FullName}.");
-            return (TData)this.Data;
+            return data;
         }
     }
 }
diff --git a/src/SMAPI/Framework/Input/SInputState.cs b/src/SMAPI/Framework/Input/SInputState.cs
index 5ff7432b..d5feaf94 100644
--- a/src/SMAPI/Framework/Input/SInputState.cs
+++ b/src/SMAPI/Framework/Input/SInputState.cs
@@ -234,7 +234,7 @@ namespace StardewModdingAPI.Framework.Input
                     isDown: pressed.Contains(button)
                 );
 
-                if (button == SButton.MouseLeft || button == SButton.MouseMiddle || button == SButton.MouseRight || button == SButton.MouseX1 || button == SButton.MouseX2)
+                if (button is SButton.MouseLeft or SButton.MouseMiddle or SButton.MouseRight or SButton.MouseX1 or SButton.MouseX2)
                     mouseOverrides[button] = newState;
                 else if (button.TryGetKeyboard(out Keys _))
                     keyboardOverrides[button] = newState;
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index e3386f75..21366bb4 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -32,11 +32,8 @@ namespace StardewModdingAPI.Framework.ModLoading
                 ModDataRecordVersionedFields dataRecord = modDatabase.Get(manifest?.UniqueID)?.GetVersionedFields(manifest);
 
                 // apply defaults
-                if (manifest != null && dataRecord != null)
-                {
-                    if (dataRecord.UpdateKey != null)
-                        manifest.UpdateKeys = new[] { dataRecord.UpdateKey };
-                }
+                if (manifest != null && dataRecord?.UpdateKey is not null)
+                    manifest.UpdateKeys = new[] { dataRecord.UpdateKey };
 
                 // build metadata
                 bool shouldIgnore = folder.Type == ModType.Ignored;
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
index 57f1dd17..2eee8ff9 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
@@ -37,7 +37,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
 
             // skip if not broken
             FieldDefinition fieldDefinition = fieldRef.Resolve();
-            if (fieldDefinition != null && !fieldDefinition.HasConstant)
+            if (fieldDefinition?.HasConstant == false)
                 return false;
 
             // rewrite if possible
diff --git a/src/SMAPI/SButton.cs b/src/SMAPI/SButton.cs
index ae825696..133ea901 100644
--- a/src/SMAPI/SButton.cs
+++ b/src/SMAPI/SButton.cs
@@ -674,7 +674,7 @@ namespace StardewModdingAPI
             }
 
             // mouse
-            if (input == SButton.MouseLeft || input == SButton.MouseRight)
+            if (input is SButton.MouseLeft or SButton.MouseRight)
             {
                 button = new InputButton(mouseLeft: input == SButton.MouseLeft);
                 return true;
diff --git a/src/SMAPI/SButtonState.cs b/src/SMAPI/SButtonState.cs
index 5f3e8d3c..ca2dd83d 100644
--- a/src/SMAPI/SButtonState.cs
+++ b/src/SMAPI/SButtonState.cs
@@ -23,7 +23,7 @@ namespace StardewModdingAPI
         /// <param name="state">The button state.</param>
         public static bool IsDown(this SButtonState state)
         {
-            return state == SButtonState.Held || state == SButtonState.Pressed;
+            return state is SButtonState.Held or SButtonState.Pressed;
         }
     }
 }
diff --git a/src/SMAPI/Utilities/Keybind.cs b/src/SMAPI/Utilities/Keybind.cs
index 403ecf4a..7aefe686 100644
--- a/src/SMAPI/Utilities/Keybind.cs
+++ b/src/SMAPI/Utilities/Keybind.cs
@@ -118,11 +118,11 @@ namespace StardewModdingAPI.Utilities
                 return SButtonState.None;
 
             // mix of held + pressed => pressed
-            if (states.All(p => p == SButtonState.Pressed || p == SButtonState.Held))
+            if (states.All(p => p is SButtonState.Pressed or SButtonState.Held))
                 return SButtonState.Pressed;
 
             // mix of held + released => released
-            if (states.All(p => p == SButtonState.Held || p == SButtonState.Released))
+            if (states.All(p => p is SButtonState.Held or SButtonState.Released))
                 return SButtonState.Released;
 
             // not down last tick or now
diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
index f8f569af..f24976f7 100644
--- a/src/SMAPI/Utilities/KeybindList.cs
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -139,7 +139,7 @@ namespace StardewModdingAPI.Utilities
         public bool IsDown()
         {
             SButtonState state = this.GetState();
-            return state == SButtonState.Pressed || state == SButtonState.Held;
+            return state is SButtonState.Pressed or SButtonState.Held;
         }
 
         /// <summary>Get whether the input binding was just pressed this tick.</summary>

From 077d8e4f401ad1806c6af0540f432366314a2300 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 18:25:00 -0400
Subject: [PATCH 501/856] remove some unused/redundant code

---
 src/SMAPI.Installer/InteractiveInstaller.cs   |  2 +-
 src/SMAPI.Internal/ExceptionHelper.cs         | 11 +-----
 .../Framework/DiagnosticVerifier.cs           |  2 +-
 .../NetFieldAnalyzer.cs                       |  3 --
 .../ObsoleteFieldAnalyzer.cs                  |  2 +-
 .../Framework/Commands/ConsoleCommand.cs      |  2 +-
 .../Commands/Other/ApplySaveFixCommand.cs     |  2 +
 .../Framework/Commands/Other/DebugCommand.cs  |  4 +-
 .../Commands/Other/RegenerateBundles.cs       |  2 +
 .../Commands/Other/ShowDataFilesCommand.cs    |  4 +-
 .../Commands/Other/ShowGameFilesCommand.cs    |  2 +
 .../Commands/Other/TestInputCommand.cs        |  6 +--
 .../Commands/Player/ListItemTypesCommand.cs   |  4 +-
 .../Commands/Player/ListItemsCommand.cs       |  2 +
 .../Commands/Player/SetColorCommand.cs        |  2 +
 .../Commands/Player/SetFarmTypeCommand.cs     |  2 +
 .../Commands/Player/SetHealthCommand.cs       |  2 +
 .../Commands/Player/SetImmunityCommand.cs     |  4 +-
 .../Commands/Player/SetMaxHealthCommand.cs    |  4 +-
 .../Commands/Player/SetMaxStaminaCommand.cs   |  4 +-
 .../Commands/Player/SetMoneyCommand.cs        |  2 +
 .../Commands/Player/SetNameCommand.cs         |  2 +
 .../Commands/Player/SetStaminaCommand.cs      |  2 +
 .../Commands/Player/SetStyleCommand.cs        |  2 +
 .../Framework/Commands/World/ClearCommand.cs  | 12 +++---
 .../Commands/World/DownMineLevelCommand.cs    |  2 +
 .../Commands/World/HurryAllCommand.cs         |  2 +
 .../Framework/Commands/World/SetDayCommand.cs |  4 +-
 .../Commands/World/SetMineLevelCommand.cs     |  2 +
 .../Commands/World/SetSeasonCommand.cs        |  2 +
 .../Commands/World/SetTimeCommand.cs          |  2 +
 .../Commands/World/SetYearCommand.cs          |  4 +-
 .../Framework/ItemData/SearchableItem.cs      | 10 -----
 .../Framework/ItemRepository.cs               |  2 +-
 .../Patches/SaveGamePatcher.cs                |  2 +-
 src/SMAPI.Mods.SaveBackup/ModEntry.cs         |  6 +--
 src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs |  4 +-
 src/SMAPI.Tests/Core/AssetNameTests.cs        |  4 +-
 src/SMAPI.Tests/Core/ModResolverTests.cs      | 14 +++----
 .../WikiClient/ChangeDescriptorTests.cs       |  1 -
 .../Framework/Clients/Wiki/WikiClient.cs      |  2 +-
 .../Framework/ModData/ModDatabase.cs          |  2 +-
 .../Controllers/JsonValidatorController.cs    | 11 ++----
 .../Caching/Mods/IModCacheRepository.cs       |  1 -
 .../Caching/Mods/ModCacheMemoryRepository.cs  |  1 -
 .../Framework/LogParsing/LogParser.cs         |  2 +-
 src/SMAPI.Web/Framework/ModInfoModel.cs       |  2 -
 .../RedirectRules/RedirectHostsToUrlsRule.cs  |  2 -
 .../RedirectRules/RedirectToHttpsRule.cs      |  2 +-
 src/SMAPI.Web/Startup.cs                      |  2 +-
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  6 +--
 .../wwwroot/Content/css/file-upload.css       |  2 +-
 src/SMAPI/Constants.cs                        |  3 --
 src/SMAPI/Framework/CommandManager.cs         |  2 +-
 .../Framework/Content/AssetDataForMap.cs      |  2 +-
 src/SMAPI/Framework/Content/AssetName.cs      |  2 +-
 .../Framework/Content/TilesheetReference.cs   |  1 -
 .../ContentManagers/BaseContentManager.cs     |  2 +-
 .../ContentManagers/ModContentManager.cs      |  2 +-
 src/SMAPI/Framework/Input/SInputState.cs      |  2 +-
 src/SMAPI/Framework/InternalExtensions.cs     |  1 -
 .../Framework/ModHelpers/ModRegistryHelper.cs |  2 +-
 .../Framework/ModLoading/AssemblyLoader.cs    |  4 +-
 src/SMAPI/Framework/ModLoading/ModResolver.cs |  2 +-
 src/SMAPI/Framework/ModRegistry.cs            |  2 -
 src/SMAPI/Framework/Monitor.cs                |  2 +-
 src/SMAPI/Framework/SCore.cs                  | 16 ++++----
 src/SMAPI/Framework/SMultiplayer.cs           | 38 +++++++++----------
 .../Serialization/KeybindConverter.cs         |  2 +-
 .../StateTracking/Snapshots/PlayerSnapshot.cs |  2 +-
 .../TemporaryHacks/MiniMonoModHotfix.cs       |  2 +-
 src/SMAPI/Program.cs                          |  2 +-
 src/SMAPI/Translation.cs                      |  2 +-
 src/SMAPI/Utilities/PerScreen.cs              |  2 +-
 74 files changed, 143 insertions(+), 134 deletions(-)

diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 49ca80a5..09183b5d 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -562,7 +562,7 @@ namespace StardewModdingApi.Installer
             {
                 try
                 {
-                    FileUtilities.ForceDelete(Directory.Exists(path) ? new DirectoryInfo(path) : (FileSystemInfo)new FileInfo(path));
+                    FileUtilities.ForceDelete(Directory.Exists(path) ? new DirectoryInfo(path) : new FileInfo(path));
                     break;
                 }
                 catch (Exception ex)
diff --git a/src/SMAPI.Internal/ExceptionHelper.cs b/src/SMAPI.Internal/ExceptionHelper.cs
index 03d48911..6bd1d579 100644
--- a/src/SMAPI.Internal/ExceptionHelper.cs
+++ b/src/SMAPI.Internal/ExceptionHelper.cs
@@ -25,7 +25,7 @@ namespace StardewModdingAPI.Internal
 
                     case ReflectionTypeLoadException ex:
                         string summary = ex.ToString();
-                        foreach (Exception childEx in ex.LoaderExceptions ?? Array.Empty<Exception>())
+                        foreach (Exception childEx in ex.LoaderExceptions)
                             summary += $"\n\n{childEx?.GetLogSummary()}";
                         message = summary;
                         break;
@@ -43,15 +43,6 @@ namespace StardewModdingAPI.Internal
             }
         }
 
-        /// <summary>Get the lowest exception in an exception stack.</summary>
-        /// <param name="exception">The exception from which to search.</param>
-        public static Exception GetInnermostException(this Exception exception)
-        {
-            while (exception.InnerException != null)
-                exception = exception.InnerException;
-            return exception;
-        }
-
         /// <summary>Simplify common patterns in exception log messages that don't convey useful info.</summary>
         /// <param name="message">The log message to simplify.</param>
         public static string SimplifyExtensionMessage(string message)
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
index edaaabd4..49697dfa 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
@@ -201,7 +201,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
             var builder = new StringBuilder();
             for (int i = 0; i < diagnostics.Length; ++i)
             {
-                builder.AppendLine("// " + diagnostics[i].ToString());
+                builder.AppendLine("// " + diagnostics[i]);
 
                 var analyzerType = analyzer.GetType();
                 var rules = analyzer.SupportedDiagnostics;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
index 8478dc54..553aae99 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
@@ -227,10 +227,7 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
 
                 // warn: implicit conversion
                 if (this.IsInvalidConversion(memberType.Type, memberType.ConvertedType))
-                {
                     context.ReportDiagnostic(Diagnostic.Create(this.AvoidImplicitNetFieldCastRule, context.Node.GetLocation(), context.Node, memberType.Type.Name, memberType.ConvertedType));
-                    return;
-                }
             });
         }
 
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
index 3184147a..ba089513 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
@@ -77,7 +77,7 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
             try
             {
                 // get reference info
-                if (!AnalyzerUtilities.TryGetMemberInfo(context.Node, context.SemanticModel, out ITypeSymbol declaringType, out TypeInfo memberType, out string memberName))
+                if (!AnalyzerUtilities.TryGetMemberInfo(context.Node, context.SemanticModel, out ITypeSymbol declaringType, out _, out string memberName))
                     return;
 
                 // suggest replacement
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
index 01cab92e..44b7824e 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
@@ -100,7 +100,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
             List<string[]> lines = new List<string[]>(rows.Length + 2)
             {
                 header,
-                header.Select((value, i) => "".PadRight(widths[i], '-')).ToArray()
+                header.Select((_, i) => "".PadRight(widths[i], '-')).ToArray()
             };
             lines.AddRange(rows);
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
index 957b0e75..b02ba4b1 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
@@ -1,10 +1,12 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which runs one of the game's save migrations.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class ApplySaveFixCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
index 1955c14e..cf1dcbce 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
@@ -1,8 +1,10 @@
-using StardewValley;
+using System.Diagnostics.CodeAnalysis;
+using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which sends a debug command to the game.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class DebugCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
index 9beedb96..159d7c4a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Reflection;
 using Netcode;
@@ -9,6 +10,7 @@ using StardewValley.Network;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which regenerates the game's bundles.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class RegenerateBundlesCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
index 27f6ce53..a233d588 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
@@ -1,8 +1,10 @@
-using System.Diagnostics;
+using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which shows the data files.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class ShowDataFilesCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
index b97cb3e6..745b821b 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
@@ -1,8 +1,10 @@
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which shows the game files.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class ShowGameFilesCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
index 46583dc3..8bf9f5db 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
@@ -1,8 +1,10 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
 {
     /// <summary>A command which logs the keys being pressed for 30 seconds once enabled.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class TestInputCommand : ConsoleCommand
     {
         /*********
@@ -37,9 +39,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
         public override void OnUpdated(IMonitor monitor)
         {
             // handle expiry
-            if (this.ExpiryTicks == null)
-                return;
-            if (this.ExpiryTicks <= DateTime.UtcNow.Ticks)
+            if (this.ExpiryTicks != null && this.ExpiryTicks <= DateTime.UtcNow.Ticks)
             {
                 monitor.Log("No longer logging input.", LogLevel.Info);
                 this.ExpiryTicks = null;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
index af362bcd..ef35ad19 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
@@ -1,9 +1,11 @@
-using System.Linq;
+using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which list item types.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class ListItemTypesCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
index 46fc1d9d..5cc464fe 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
@@ -1,11 +1,13 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which list items available to spawn.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class ListItemsCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
index 7b7cbf83..af7f2d18 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
@@ -1,9 +1,11 @@
+using System.Diagnostics.CodeAnalysis;
 using Microsoft.Xna.Framework;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the color of a player feature.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetColorCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
index 6fb399ae..2809df9c 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Reflection;
 using System.Text;
@@ -10,6 +11,7 @@ using StardewValley.GameData;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which changes the player's farm type.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetFarmTypeCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
index f27b336f..f169159f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
@@ -1,9 +1,11 @@
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's current health.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetHealthCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
index df90adf2..1065bd21 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
@@ -1,9 +1,11 @@
-using System.Linq;
+using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's current immunity.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetImmunityCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
index a5f7f444..c2c4931d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
@@ -1,9 +1,11 @@
-using System.Linq;
+using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's maximum health.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetMaxHealthCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
index e3c2f011..8c794e75 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
@@ -1,9 +1,11 @@
-using System.Linq;
+using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's maximum stamina.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetMaxStaminaCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
index 787ce920..3afcc62b 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
@@ -1,9 +1,11 @@
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's current money.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetMoneyCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
index 4911ad1c..12d6b6e8 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
@@ -1,8 +1,10 @@
+using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's name.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetNameCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
index c78378ef..24718ace 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
@@ -1,9 +1,11 @@
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits the player's current stamina.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetStaminaCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
index 98f6c330..558c327d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
@@ -1,8 +1,10 @@
+using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
 {
     /// <summary>A command which edits a player style.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetStyleCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index 7935b05f..eeb95553 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
 using StardewValley.Locations;
@@ -9,6 +10,7 @@ using SObject = StardewValley.Object;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which clears in-game objects.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class ClearCommand : ConsoleCommand
     {
         /*********
@@ -113,7 +115,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 
                 case "furniture":
                     {
-                        int removed = this.RemoveFurniture(location, furniture => true);
+                        int removed = this.RemoveFurniture(location, _ => true);
                         monitor.Log($"Done! Removed {removed} entities from {location.Name}.", LogLevel.Info);
                         break;
                     }
@@ -137,11 +139,11 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
                     {
                         bool everything = type == "everything";
                         int removed =
-                            this.RemoveFurniture(location, p => true)
-                            + this.RemoveObjects(location, p => true)
-                            + this.RemoveTerrainFeatures(location, p => true)
+                            this.RemoveFurniture(location, _ => true)
+                            + this.RemoveObjects(location, _ => true)
+                            + this.RemoveTerrainFeatures(location, _ => true)
                             + this.RemoveLargeTerrainFeatures(location, p => everything || p is not Bush bush || bush.isDestroyable(location, p.currentTileLocation))
-                            + this.RemoveResourceClumps(location, p => true);
+                            + this.RemoveResourceClumps(location, _ => true);
                         monitor.Log($"Done! Removed {removed} entities from {location.Name}.", LogLevel.Info);
                         break;
                     }
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
index 0aa9c9c3..5b1a4a13 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
@@ -1,9 +1,11 @@
+using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 using StardewValley.Locations;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which moves the player to the next mine level.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class DownMineLevelCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
index 2deac5f8..09531720 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
@@ -1,9 +1,11 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which immediately warps all NPCs to their scheduled positions. To hurry a single NPC, see <c>debug hurry npc-name</c> instead.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class HurryAllCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
index 4028b3dc..399fd934 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
@@ -1,10 +1,12 @@
-using System.Linq;
+using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using StardewModdingAPI.Utilities;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which sets the current day.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetDayCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
index 40f4b19f..f977fce3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
@@ -1,9 +1,11 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which moves the player to the given mine level.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetMineLevelCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
index a4cb35bb..d839c037 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
@@ -1,3 +1,4 @@
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Utilities;
 using StardewValley;
@@ -5,6 +6,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which sets the current season.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetSeasonCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
index 2d4b4565..8c4458dd 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
@@ -1,3 +1,4 @@
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Microsoft.Xna.Framework;
 using StardewValley;
@@ -5,6 +6,7 @@ using StardewValley;
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which sets the current time.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetTimeCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
index 95401962..a666a634 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
@@ -1,10 +1,12 @@
-using System.Linq;
+using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using StardewModdingAPI.Utilities;
 using StardewValley;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
 {
     /// <summary>A command which sets the current year.</summary>
+    [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Loaded using reflection")]
     internal class SetYearCommand : ConsoleCommand
     {
         /*********
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
index 72d01eb7..3675a963 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
@@ -43,16 +43,6 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData
             this.Item = createItem(this);
         }
 
-        /// <summary>Construct an instance.</summary>
-        /// <param name="item">The item metadata to copy.</param>
-        public SearchableItem(SearchableItem item)
-        {
-            this.Type = item.Type;
-            this.ID = item.ID;
-            this.CreateItem = item.CreateItem;
-            this.Item = item.Item;
-        }
-
         /// <summary>Get whether the item name contains a case-insensitive substring.</summary>
         /// <param name="substring">The substring to find.</param>
         public bool NameContains(string substring)
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index ca313f41..3915db9a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -107,7 +107,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                     foreach (int id in this.TryLoad<int, string>("Data\\weapons").Keys)
                     {
                         yield return this.TryCreate(ItemType.Weapon, id, p => p.ID is >= 32 and <= 34
-                            ? (Item)new Slingshot(p.ID)
+                            ? new Slingshot(p.ID)
                             : new MeleeWeapon(p.ID)
                         );
                     }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index 5f6dbcb3..01bfb888 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -77,7 +77,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         private static Exception Finalize_LoadFarmType(Exception __exception)
         {
             // missing custom farm type
-            if (__exception?.Message?.Contains("not a valid farm type") == true && !int.TryParse(SaveGame.loaded.whichFarm, out _))
+            if (__exception?.Message.Contains("not a valid farm type") == true && !int.TryParse(SaveGame.loaded.whichFarm, out _))
             {
                 SaveGamePatcher.Monitor.Log(__exception.GetLogSummary(), LogLevel.Error);
                 SaveGamePatcher.Monitor.Log($"Removed invalid custom farm type '{SaveGame.loaded.whichFarm}' to avoid a crash when loading save '{Constants.SaveFolderName}'. (Did you remove a custom farm type mod?)", LogLevel.Warn);
diff --git a/src/SMAPI.Mods.SaveBackup/ModEntry.cs b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
index f6925707..273b1434 100644
--- a/src/SMAPI.Mods.SaveBackup/ModEntry.cs
+++ b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
@@ -44,7 +44,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
                 // back up & prune saves
                 Task
                     .Run(() => this.CreateBackup(backupFolder))
-                    .ContinueWith(backupTask => this.PruneBackups(backupFolder, this.BackupsToKeep));
+                    .ContinueWith(_ => this.PruneBackups(backupFolder, this.BackupsToKeep));
             }
             catch (Exception ex)
             {
@@ -170,8 +170,8 @@ namespace StardewModdingAPI.Mods.SaveBackup
             try
             {
                 // create compressed backup
-                Assembly coreAssembly = Assembly.Load("System.IO.Compression, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089") ?? throw new InvalidOperationException("Can't load System.IO.Compression assembly.");
-                Assembly fsAssembly = Assembly.Load("System.IO.Compression.FileSystem, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089") ?? throw new InvalidOperationException("Can't load System.IO.Compression assembly.");
+                Assembly coreAssembly = Assembly.Load("System.IO.Compression, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089");
+                Assembly fsAssembly = Assembly.Load("System.IO.Compression.FileSystem, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089");
                 Type compressionLevelType = coreAssembly.GetType("System.IO.Compression.CompressionLevel") ?? throw new InvalidOperationException("Can't load CompressionLevel type.");
                 Type zipFileType = fsAssembly.GetType("System.IO.Compression.ZipFile") ?? throw new InvalidOperationException("Can't load ZipFile type.");
                 createFromDirectory = zipFileType.GetMethod("CreateFromDirectory", new[] { typeof(string), typeof(string), compressionLevelType, typeof(bool) }) ?? throw new InvalidOperationException("Can't load ZipFile.CreateFromDirectory method.");
diff --git a/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs b/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
index 2c7f9952..ac7bd338 100644
--- a/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
+++ b/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
@@ -17,7 +17,7 @@ namespace SMAPI.Tests.ModApiConsumer
             // act
             int calls = 0;
             int lastValue = -1;
-            api.OnEventRaised += (sender, value) =>
+            api.OnEventRaised += (_, value) =>
             {
                 calls++;
                 lastValue = value;
@@ -34,7 +34,7 @@ namespace SMAPI.Tests.ModApiConsumer
             // act
             int calls = 0;
             int lastValue = -1;
-            api.OnEventRaisedProperty += (sender, value) =>
+            api.OnEventRaisedProperty += (_, value) =>
             {
                 calls++;
                 lastValue = value;
diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index 8785aab8..7b817d13 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -33,7 +33,7 @@ namespace SMAPI.Tests.Core
 
             // act
             string calledWithLocale = null;
-            IAssetName assetName = AssetName.Parse(name, parseLocale: locale => expectedLanguageCode);
+            IAssetName assetName = AssetName.Parse(name, parseLocale: _ => expectedLanguageCode);
 
             // assert
             assetName.Name.Should()
@@ -161,7 +161,7 @@ namespace SMAPI.Tests.Core
             AssetName name = AssetName.Parse(mainAssetName, _ => null);
 
             // assert value is the same for any combination of options
-            bool result = name.StartsWith(prefix, true, true);
+            bool result = name.StartsWith(prefix);
             foreach (bool allowPartialWord in new[] { true, false })
             {
                 foreach (bool allowSubfolder in new[] { true, true })
diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index 1755f644..86c50606 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -123,7 +123,7 @@ namespace SMAPI.Tests.Core
         [Test(Description = "Assert that validation doesn't fail if there are no mods installed.")]
         public void ValidateManifests_NoMods_DoesNothing()
         {
-            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
+            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
         }
 
         [Test(Description = "Assert that validation skips manifests that have already failed without calling any other properties.")]
@@ -134,7 +134,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.Status).Returns(ModMetadataStatus.Failed);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
 
             // assert
             mock.VerifyGet(p => p.Status, Times.Once, "The validation did not check the manifest status.");
@@ -151,7 +151,7 @@ namespace SMAPI.Tests.Core
             });
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -166,7 +166,7 @@ namespace SMAPI.Tests.Core
             this.SetupMetadataForValidation(mock);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -180,7 +180,7 @@ namespace SMAPI.Tests.Core
             this.SetupMetadataForValidation(mock);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -197,7 +197,7 @@ namespace SMAPI.Tests.Core
                 this.SetupMetadataForValidation(mod);
 
             // act
-            new ModResolver().ValidateManifests(new[] { modA.Object, modB.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
+            new ModResolver().ValidateManifests(new[] { modA.Object, modB.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
 
             // assert
             modA.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the first mod with a unique ID.");
@@ -223,7 +223,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.DirectoryPath).Returns(modFolder);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: key => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
 
             // assert
             // if Moq doesn't throw a method-not-setup exception, the validation didn't override the status.
diff --git a/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs b/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
index b896b09c..84cae8df 100644
--- a/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
+++ b/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
@@ -1,5 +1,4 @@
 using System.Collections.Generic;
-using System.Linq;
 using NUnit.Framework;
 using StardewModdingAPI;
 using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index abbcdc81..c936bb3e 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -65,7 +65,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 
                 foreach (var entry in this.ParseOverrideEntries(modNodes))
                 {
-                    if (entry.Ids?.Any() != true || !entry.HasChanges)
+                    if (entry.Ids.Any() != true || !entry.HasChanges)
                         continue;
 
                     foreach (string id in entry.Ids)
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
index 5b7e2a02..9bb3f558 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         *********/
         /// <summary>Construct an empty instance.</summary>
         public ModDatabase()
-        : this(Array.Empty<ModDataRecord>(), key => null) { }
+        : this(Array.Empty<ModDataRecord>(), _ => null) { }
 
         /// <summary>Construct an instance.</summary>
         /// <param name="records">The underlying mod data records indexed by default display name.</param>
diff --git a/src/SMAPI.Web/Controllers/JsonValidatorController.cs b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
index bcd4097a..985f91ae 100644
--- a/src/SMAPI.Web/Controllers/JsonValidatorController.cs
+++ b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
@@ -161,7 +161,7 @@ namespace StardewModdingAPI.Web.Controllers
                 return this.View("Index", this.GetModel(result.ID, schemaName, isEditView: true).SetContent(input, null).SetUploadError(result.UploadError));
 
             // redirect to view
-            return this.Redirect(this.Url.PlainAction("Index", "JsonValidator", new { schemaName = schemaName, id = result.ID }));
+            return this.Redirect(this.Url.PlainAction("Index", "JsonValidator", new { schemaName, id = result.ID }));
         }
 
 
@@ -317,13 +317,10 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="key">The case-insensitive field key.</param>
         private T GetExtensionField<T>(JSchema schema, string key)
         {
-            if (schema.ExtensionData != null)
+            foreach ((string curKey, JToken value) in schema.ExtensionData)
             {
-                foreach ((string curKey, JToken value) in schema.ExtensionData)
-                {
-                    if (curKey.Equals(key, StringComparison.OrdinalIgnoreCase))
-                        return value.ToObject<T>();
-                }
+                if (curKey.Equals(key, StringComparison.OrdinalIgnoreCase))
+                    return value.ToObject<T>();
             }
 
             return default;
diff --git a/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs b/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
index 0d912c7b..a16e6b73 100644
--- a/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
@@ -1,6 +1,5 @@
 using System;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
-using StardewModdingAPI.Web.Framework.Clients;
 
 namespace StardewModdingAPI.Web.Framework.Caching.Mods
 {
diff --git a/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs b/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
index 9769793c..f871a9da 100644
--- a/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
@@ -2,7 +2,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
-using StardewModdingAPI.Web.Framework.Clients;
 
 namespace StardewModdingAPI.Web.Framework.Caching.Mods
 {
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 6a3ea222..864caef1 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -211,7 +211,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                         {
                             Match match = this.ModPathPattern.Match(message.Text);
                             log.ModPath = match.Groups["path"].Value;
-                            int lastDelimiterPos = log.ModPath.LastIndexOfAny(new char[] { '/', '\\' });
+                            int lastDelimiterPos = log.ModPath.LastIndexOfAny(new[] { '/', '\\' });
                             log.GamePath = lastDelimiterPos >= 0
                                 ? log.ModPath.Substring(0, lastDelimiterPos)
                                 : log.ModPath;
diff --git a/src/SMAPI.Web/Framework/ModInfoModel.cs b/src/SMAPI.Web/Framework/ModInfoModel.cs
index 7845b8c5..86f70788 100644
--- a/src/SMAPI.Web/Framework/ModInfoModel.cs
+++ b/src/SMAPI.Web/Framework/ModInfoModel.cs
@@ -1,5 +1,3 @@
-using StardewModdingAPI.Web.Framework.Clients;
-
 namespace StardewModdingAPI.Web.Framework
 {
     /// <summary>Generic metadata about a mod.</summary>
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
index d75ee791..d67b5156 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
@@ -37,8 +37,6 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         {
             // get requested host
             string host = context.HttpContext.Request.Host.Host;
-            if (host == null)
-                return null;
 
             // get new host
             host = this.Map(host);
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
index 2a503ae3..265a605f 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         /// <param name="except">Matches requests which should be ignored.</param>
         public RedirectToHttpsRule(Func<HttpRequest, bool> except = null)
         {
-            this.Except = except ?? (req => false);
+            this.Except = except ?? (_ => false);
             this.StatusCode = HttpStatusCode.RedirectKeepVerb;
         }
 
diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index d8561172..6d9591ee 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -81,7 +81,7 @@ namespace StardewModdingAPI.Web
 
             // init Hangfire
             services
-                .AddHangfire((serv, config) =>
+                .AddHangfire((_, config) =>
                 {
                     config
                         .SetDataCompatibilityLevel(CompatibilityLevel.Version_170)
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index b54867b1..3ddc6303 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -40,8 +40,8 @@
             smapi.logParser({
                 logStarted: new Date(@this.ForJson(log?.Timestamp)),
                 showPopup: @this.ForJson(log == null),
-                showMods: @this.ForJson(log?.Mods?.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, slug => true)),
-                showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, section => false)),
+                showMods: @this.ForJson(log?.Mods?.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
+                showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, _ => false)),
                 showLevels: @this.ForJson(defaultFilters),
                 enableFilters: @this.ForJson(!Model.ShowRaw),
                 screenIds: @this.ForJson(screenIds)
@@ -207,7 +207,7 @@ else if (log?.IsValid == true)
                                     @if (mod.HasUpdate)
                                     {
                                         <a href="@mod.UpdateLink" target="_blank">
-                                            @(mod.Version == null ? @mod.UpdateVersion : $"{mod.Version} → {mod.UpdateVersion}")
+                                            @(mod.Version == null ? mod.UpdateVersion : $"{mod.Version} → {mod.UpdateVersion}")
                                         </a>
                                     }
                                     else
diff --git a/src/SMAPI.Web/wwwroot/Content/css/file-upload.css b/src/SMAPI.Web/wwwroot/Content/css/file-upload.css
index ff170691..f29d46aa 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/file-upload.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/file-upload.css
@@ -11,7 +11,7 @@
     border-radius: 5px;
     border: 1px solid #000088;
     outline: none;
-    box-shadow: inset 0px 0px 1px 1px rgba(0, 0, 192, .2);
+    box-shadow: inset 0 0 1px 1px rgba(0, 0, 192, .2);
 }
 
 #submit {
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 76f4ef87..6b9e9b05 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -170,9 +170,6 @@ namespace StardewModdingAPI
         /// <summary>The target game platform as a SMAPI toolkit constant.</summary>
         internal static Platform Platform { get; } = (Platform)Constants.TargetPlatform;
 
-        /// <summary>The language code for non-translated mod assets.</summary>
-        internal static LocalizedContentManager.LanguageCode DefaultLanguage { get; } = LocalizedContentManager.LanguageCode.en;
-
 
         /*********
         ** Internal methods
diff --git a/src/SMAPI/Framework/CommandManager.cs b/src/SMAPI/Framework/CommandManager.cs
index a7b64cb7..0c0f6685 100644
--- a/src/SMAPI/Framework/CommandManager.cs
+++ b/src/SMAPI/Framework/CommandManager.cs
@@ -65,7 +65,7 @@ namespace StardewModdingAPI.Framework
         /// <exception cref="ArgumentException">There's already a command with that name.</exception>
         public CommandManager Add(IInternalCommand command, IMonitor monitor)
         {
-            return this.Add(null, command.Name, command.Description, (name, args) => command.HandleCommand(args, monitor));
+            return this.Add(null, command.Name, command.Description, (_, args) => command.HandleCommand(args, monitor));
         }
 
         /// <summary>Get a command by its unique name.</summary>
diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 0458f80a..5986e797 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -147,7 +147,7 @@ namespace StardewModdingAPI.Framework.Content
         {
             switch (sourceTile)
             {
-                case StaticTile _:
+                case StaticTile:
                     return new StaticTile(targetLayer, targetSheet, sourceTile.BlendMode, sourceTile.TileIndex);
 
                 case AnimatedTile animatedTile:
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index a1d37b0b..4973b444 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -107,7 +107,7 @@ namespace StardewModdingAPI.Framework.Content
                 return this.BaseName.Equals(assetName?.BaseName, StringComparison.OrdinalIgnoreCase);
 
             if (assetName is AssetName impl)
-                return this.ComparableName == impl?.ComparableName;
+                return this.ComparableName == impl.ComparableName;
 
             return this.Name.Equals(assetName?.Name, StringComparison.OrdinalIgnoreCase);
         }
diff --git a/src/SMAPI/Framework/Content/TilesheetReference.cs b/src/SMAPI/Framework/Content/TilesheetReference.cs
index 0919bb44..0339b802 100644
--- a/src/SMAPI/Framework/Content/TilesheetReference.cs
+++ b/src/SMAPI/Framework/Content/TilesheetReference.cs
@@ -1,4 +1,3 @@
-using System.Numerics;
 using xTile.Dimensions;
 
 namespace StardewModdingAPI.Framework.Content
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 31199b3a..c803905a 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -308,7 +308,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             return useCache
                 ? base.LoadBase<T>(assetName.Name)
-                : base.ReadAsset<T>(assetName.Name, disposable => this.Disposables.Add(new WeakReference<IDisposable>(disposable)));
+                : this.ReadAsset<T>(assetName.Name, disposable => this.Disposables.Add(new WeakReference<IDisposable>(disposable)));
         }
 
         /// <summary>Add tracking data to an asset and add it to the cache.</summary>
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 63070d85..e0c85265 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -124,7 +124,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // track & return asset
-            this.TrackAsset(assetName, asset, useCache);
+            this.TrackAsset(assetName, asset, useCache: false);
             return asset;
         }
 
diff --git a/src/SMAPI/Framework/Input/SInputState.cs b/src/SMAPI/Framework/Input/SInputState.cs
index d5feaf94..72adca02 100644
--- a/src/SMAPI/Framework/Input/SInputState.cs
+++ b/src/SMAPI/Framework/Input/SInputState.cs
@@ -73,7 +73,7 @@ namespace StardewModdingAPI.Framework.Input
                 var keyboard = new KeyboardStateBuilder(base.GetKeyboardState());
                 var mouse = new MouseStateBuilder(base.GetMouseState());
                 Vector2 cursorAbsolutePos = new((mouse.X * zoomMultiplier) + Game1.viewport.X, (mouse.Y * zoomMultiplier) + Game1.viewport.Y);
-                Vector2? playerTilePos = Context.IsPlayerFree ? Game1.player.getTileLocation() : (Vector2?)null;
+                Vector2? playerTilePos = Context.IsPlayerFree ? Game1.player.getTileLocation() : null;
                 HashSet<SButton> reallyDown = new HashSet<SButton>(this.GetPressedButtons(keyboard, mouse, controller));
 
                 // apply overrides
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index fe10b045..54aeffd7 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Reflection;
 using System.Threading;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Events;
diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 95eb03f3..09a392a6 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             // get raw API
             IModMetadata mod = this.Registry.Get(uniqueID);
             if (mod?.Api != null && this.AccessedModApis.Add(mod.Manifest.UniqueID))
-                this.Monitor.Log($"Accessed mod-provided API for {mod.DisplayName}.", LogLevel.Trace);
+                this.Monitor.Log($"Accessed mod-provided API for {mod.DisplayName}.");
             return mod?.Api;
         }
 
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 4480f4e8..24214c96 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -138,7 +138,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 if (changed)
                 {
                     if (!oneAssembly)
-                        this.Monitor.Log($"      Loading {assembly.File.Name} (rewritten)...", LogLevel.Trace);
+                        this.Monitor.Log($"      Loading {assembly.File.Name} (rewritten)...");
 
                     // load assembly
                     using MemoryStream outAssemblyStream = new();
@@ -150,7 +150,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 else
                 {
                     if (!oneAssembly)
-                        this.Monitor.Log($"      Loading {assembly.File.Name}...", LogLevel.Trace);
+                        this.Monitor.Log($"      Loading {assembly.File.Name}...");
                     lastAssembly = Assembly.UnsafeLoadFrom(assembly.File.FullName);
                 }
 
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 21366bb4..d52cdbb4 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -237,7 +237,7 @@ namespace StardewModdingAPI.Framework.ModLoading
             // initialize metadata
             mods = mods.ToArray();
             var sortedMods = new Stack<IModMetadata>();
-            var states = mods.ToDictionary(mod => mod, mod => ModDependencyStatus.Queued);
+            var states = mods.ToDictionary(mod => mod, _ => ModDependencyStatus.Queued);
 
             // handle failed mods
             foreach (IModMetadata mod in mods.Where(m => m.Status == ModMetadataStatus.Failed))
diff --git a/src/SMAPI/Framework/ModRegistry.cs b/src/SMAPI/Framework/ModRegistry.cs
index 99548cf8..c0f8d537 100644
--- a/src/SMAPI/Framework/ModRegistry.cs
+++ b/src/SMAPI/Framework/ModRegistry.cs
@@ -96,8 +96,6 @@ namespace StardewModdingAPI.Framework
             // get stack frames
             StackTrace stack = new();
             StackFrame[] frames = stack.GetFrames();
-            if (frames == null)
-                return null;
 
             // search stack for a source assembly
             foreach (StackFrame frame in frames)
diff --git a/src/SMAPI/Framework/Monitor.cs b/src/SMAPI/Framework/Monitor.cs
index ab76e7c0..6b53daff 100644
--- a/src/SMAPI/Framework/Monitor.cs
+++ b/src/SMAPI/Framework/Monitor.cs
@@ -92,7 +92,7 @@ namespace StardewModdingAPI.Framework
         public void VerboseLog(string message)
         {
             if (this.IsVerbose)
-                this.Log(message, LogLevel.Trace);
+                this.Log(message);
         }
 
         /// <summary>Write a newline to the console and log file.</summary>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c8e0842e..cc531de9 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -232,13 +232,13 @@ namespace StardewModdingAPI.Framework
                     this.Toolkit.JsonHelper.JsonSettings.Converters.Add(converter);
 
                 // add error handlers
-                AppDomain.CurrentDomain.UnhandledException += (sender, e) => this.Monitor.Log($"Critical app domain exception: {e.ExceptionObject}", LogLevel.Error);
+                AppDomain.CurrentDomain.UnhandledException += (_, e) => this.Monitor.Log($"Critical app domain exception: {e.ExceptionObject}", LogLevel.Error);
 
                 // add more lenient assembly resolver
-                AppDomain.CurrentDomain.AssemblyResolve += (sender, e) => AssemblyLoader.ResolveAssembly(e.Name);
+                AppDomain.CurrentDomain.AssemblyResolve += (_, e) => AssemblyLoader.ResolveAssembly(e.Name);
 
                 // hook locale event
-                LocalizedContentManager.OnLanguageChange += locale => this.OnLocaleChanged();
+                LocalizedContentManager.OnLanguageChange += _ => this.OnLocaleChanged();
 
                 // override game
                 this.Multiplayer = new SMultiplayer(this.Monitor, this.EventManager, this.Toolkit.JsonHelper, this.ModRegistry, this.Reflection, this.OnModMessageReceived, this.Settings.LogNetworkTraffic);
@@ -1453,14 +1453,12 @@ namespace StardewModdingAPI.Framework
                 // check Stardew64Installer version
                 if (Constants.IsPatchedByStardew64Installer(out ISemanticVersion patchedByVersion))
                 {
-                    ISemanticVersion updateFound = null;
-                    string updateUrl = null;
                     try
                     {
                         // fetch update check
                         ModEntryModel response = client.GetModInfo(new[] { new ModSearchEntryModel("Steviegt6.Stardew64Installer", patchedByVersion, new[] { $"GitHub:{this.Settings.Stardew64InstallerGitHubProjectName}" }) }, apiVersion: Constants.ApiVersion, gameVersion: Constants.GameVersion, platform: Constants.Platform).Single().Value;
-                        updateFound = response.SuggestedUpdate?.Version;
-                        updateUrl = response.SuggestedUpdate?.Url ?? Constants.HomePageUrl;
+                        ISemanticVersion updateFound = response.SuggestedUpdate?.Version;
+                        string updateUrl = response.SuggestedUpdate?.Url ?? Constants.HomePageUrl;
 
                         // log message
                         if (updateFound != null)
@@ -1658,8 +1656,8 @@ namespace StardewModdingAPI.Framework
                     // ReSharper restore SuspiciousTypeConversion.Global
 
                     ContentHelper content = helper.GetLegacyContentHelper();
-                    content.ObservableAssetEditors.CollectionChanged += (sender, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetEditor>(), e.OldItems?.Cast<IAssetEditor>(), this.ContentCore.Editors);
-                    content.ObservableAssetLoaders.CollectionChanged += (sender, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetLoader>(), e.OldItems?.Cast<IAssetLoader>(), this.ContentCore.Loaders);
+                    content.ObservableAssetEditors.CollectionChanged += (_, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetEditor>(), e.OldItems?.Cast<IAssetEditor>(), this.ContentCore.Editors);
+                    content.ObservableAssetLoaders.CollectionChanged += (_, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetLoader>(), e.OldItems?.Cast<IAssetLoader>(), this.ContentCore.Loaders);
                 }
 
                 // call entry method
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index 3981e4e5..bcf97006 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -111,20 +111,20 @@ namespace StardewModdingAPI.Framework
         {
             switch (client)
             {
-                case LidgrenClient _:
+                case LidgrenClient:
                     {
                         string address = this.Reflection.GetField<string>(client, "address").GetValue();
                         return new SLidgrenClient(address, this.OnClientProcessingMessage, this.OnClientSendingMessage);
                     }
 
-                case GalaxyNetClient _:
+                case GalaxyNetClient:
                     {
                         GalaxyID address = this.Reflection.GetField<GalaxyID>(client, "lobbyId").GetValue();
                         return new SGalaxyNetClient(address, this.OnClientProcessingMessage, this.OnClientSendingMessage);
                     }
 
                 default:
-                    this.Monitor.Log($"Unknown multiplayer client type: {client.GetType().AssemblyQualifiedName}", LogLevel.Trace);
+                    this.Monitor.Log($"Unknown multiplayer client type: {client.GetType().AssemblyQualifiedName}");
                     return client;
             }
         }
@@ -135,20 +135,20 @@ namespace StardewModdingAPI.Framework
         {
             switch (server)
             {
-                case LidgrenServer _:
+                case LidgrenServer:
                     {
                         IGameServer gameServer = this.Reflection.GetField<IGameServer>(server, "gameServer").GetValue();
                         return new SLidgrenServer(gameServer, this, this.OnServerProcessingMessage);
                     }
 
-                case GalaxyNetServer _:
+                case GalaxyNetServer:
                     {
                         IGameServer gameServer = this.Reflection.GetField<IGameServer>(server, "gameServer").GetValue();
                         return new SGalaxyNetServer(gameServer, this, this.OnServerProcessingMessage);
                     }
 
                 default:
-                    this.Monitor.Log($"Unknown multiplayer server type: {server.GetType().AssemblyQualifiedName}", LogLevel.Trace);
+                    this.Monitor.Log($"Unknown multiplayer server type: {server.GetType().AssemblyQualifiedName}");
                     return server;
             }
         }
@@ -160,7 +160,7 @@ namespace StardewModdingAPI.Framework
         protected void OnClientSendingMessage(OutgoingMessage message, Action<OutgoingMessage> sendMessage, Action resume)
         {
             if (this.LogNetworkTraffic)
-                this.Monitor.Log($"CLIENT SEND {(MessageType)message.MessageType} {message.FarmerID}", LogLevel.Trace);
+                this.Monitor.Log($"CLIENT SEND {(MessageType)message.MessageType} {message.FarmerID}");
 
             switch (message.MessageType)
             {
@@ -184,7 +184,7 @@ namespace StardewModdingAPI.Framework
         public void OnServerProcessingMessage(IncomingMessage message, Action<OutgoingMessage> sendMessage, Action resume)
         {
             if (this.LogNetworkTraffic)
-                this.Monitor.Log($"SERVER RECV {(MessageType)message.MessageType} {message.FarmerID}", LogLevel.Trace);
+                this.Monitor.Log($"SERVER RECV {(MessageType)message.MessageType} {message.FarmerID}");
 
             switch (message.MessageType)
             {
@@ -193,7 +193,7 @@ namespace StardewModdingAPI.Framework
                     {
                         // parse message
                         RemoteContextModel model = this.ReadContext(message.Reader);
-                        this.Monitor.Log($"Received context for farmhand {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.", LogLevel.Trace);
+                        this.Monitor.Log($"Received context for farmhand {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.");
 
                         // store peer
                         MultiplayerPeer newPeer = new(
@@ -243,7 +243,7 @@ namespace StardewModdingAPI.Framework
                     // store peer if new
                     if (!this.Peers.ContainsKey(message.FarmerID))
                     {
-                        this.Monitor.Log($"Received connection for vanilla player {message.FarmerID}.", LogLevel.Trace);
+                        this.Monitor.Log($"Received connection for vanilla player {message.FarmerID}.");
                         MultiplayerPeer peer = new(
                             playerID: message.FarmerID,
                             screenID: this.GetScreenId(message.FarmerID),
@@ -280,7 +280,7 @@ namespace StardewModdingAPI.Framework
         public void OnClientProcessingMessage(IncomingMessage message, Action<OutgoingMessage> sendMessage, Action resume)
         {
             if (this.LogNetworkTraffic)
-                this.Monitor.Log($"CLIENT RECV {(MessageType)message.MessageType} {message.FarmerID}", LogLevel.Trace);
+                this.Monitor.Log($"CLIENT RECV {(MessageType)message.MessageType} {message.FarmerID}");
 
             switch (message.MessageType)
             {
@@ -289,7 +289,7 @@ namespace StardewModdingAPI.Framework
                     {
                         // parse message
                         RemoteContextModel model = this.ReadContext(message.Reader);
-                        this.Monitor.Log($"Received context for {(model?.IsHost == true ? "host" : "farmhand")} {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.", LogLevel.Trace);
+                        this.Monitor.Log($"Received context for {(model?.IsHost == true ? "host" : "farmhand")} {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.");
 
                         // store peer
                         MultiplayerPeer peer = new(
@@ -314,7 +314,7 @@ namespace StardewModdingAPI.Framework
                         // store peer
                         if (!this.Peers.ContainsKey(message.FarmerID) && this.HostPeer == null)
                         {
-                            this.Monitor.Log($"Received connection for vanilla host {message.FarmerID}.", LogLevel.Trace);
+                            this.Monitor.Log($"Received connection for vanilla host {message.FarmerID}.");
                             var peer = new MultiplayerPeer(
                                 playerID: message.FarmerID,
                                 screenID: this.GetScreenId(message.FarmerID),
@@ -341,7 +341,7 @@ namespace StardewModdingAPI.Framework
                                 sendMessage: sendMessage,
                                 isHost: this.HostPeer == null
                             );
-                            this.Monitor.Log($"Received connection for vanilla {(peer.IsHost ? "host" : "farmhand")} {message.FarmerID}.", LogLevel.Trace);
+                            this.Monitor.Log($"Received connection for vanilla {(peer.IsHost ? "host" : "farmhand")} {message.FarmerID}.");
                             this.AddPeer(peer, canBeHost: true);
                         }
 
@@ -367,7 +367,7 @@ namespace StardewModdingAPI.Framework
             {
                 if (this.Peers.TryGetValue(playerID, out MultiplayerPeer peer))
                 {
-                    this.Monitor.Log($"Player quit: {playerID}", LogLevel.Trace);
+                    this.Monitor.Log($"Player quit: {playerID}");
                     this.Peers.Remove(playerID);
                     this.EventManager.PeerDisconnected.Raise(new PeerDisconnectedEventArgs(peer));
                 }
@@ -434,7 +434,7 @@ namespace StardewModdingAPI.Framework
             if (sendToSelf)
             {
                 if (this.LogNetworkTraffic)
-                    this.Monitor.Log($"Broadcasting '{messageType}' message to self: {data}.", LogLevel.Trace);
+                    this.Monitor.Log($"Broadcasting '{messageType}' message to self: {data}.");
 
                 this.OnModMessageReceived(model);
             }
@@ -447,7 +447,7 @@ namespace StardewModdingAPI.Framework
                     foreach (MultiplayerPeer peer in sendToPeers)
                     {
                         if (this.LogNetworkTraffic)
-                            this.Monitor.Log($"Broadcasting '{messageType}' message to farmhand {peer.PlayerID}: {data}.", LogLevel.Trace);
+                            this.Monitor.Log($"Broadcasting '{messageType}' message to farmhand {peer.PlayerID}: {data}.");
 
                         peer.SendMessage(new OutgoingMessage((byte)MessageType.ModMessage, peer.PlayerID, data));
                     }
@@ -455,7 +455,7 @@ namespace StardewModdingAPI.Framework
                 else if (this.HostPeer?.HasSmapi == true)
                 {
                     if (this.LogNetworkTraffic)
-                        this.Monitor.Log($"Broadcasting '{messageType}' message to host {this.HostPeer.PlayerID}: {data}.", LogLevel.Trace);
+                        this.Monitor.Log($"Broadcasting '{messageType}' message to host {this.HostPeer.PlayerID}: {data}.");
 
                     this.HostPeer.SendMessage(new OutgoingMessage((byte)MessageType.ModMessage, this.HostPeer.PlayerID, data));
                 }
@@ -504,7 +504,7 @@ namespace StardewModdingAPI.Framework
             ModMessageModel model = this.JsonHelper.Deserialize<ModMessageModel>(json);
             HashSet<long> playerIDs = new HashSet<long>(model.ToPlayerIDs ?? this.GetKnownPlayerIDs());
             if (this.LogNetworkTraffic)
-                this.Monitor.Log($"Received message: {json}.", LogLevel.Trace);
+                this.Monitor.Log($"Received message: {json}.");
 
             // notify local mods
             if (playerIDs.Contains(Game1.player.UniqueMultiplayerID))
diff --git a/src/SMAPI/Framework/Serialization/KeybindConverter.cs b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
index 93a274a8..7c5db3ad 100644
--- a/src/SMAPI/Framework/Serialization/KeybindConverter.cs
+++ b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
@@ -44,7 +44,7 @@ namespace StardewModdingAPI.Framework.Serialization
             {
                 case JsonToken.Null:
                     return objectType == typeof(Keybind)
-                        ? (object)new Keybind()
+                        ? new Keybind()
                         : new KeybindList();
 
                 case JsonToken.String:
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
index f3e42948..e113d27c 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
@@ -31,7 +31,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
             Enum
                 .GetValues(typeof(SkillType))
                 .Cast<SkillType>()
-                .ToDictionary(skill => skill, skill => new SnapshotDiff<int>());
+                .ToDictionary(skill => skill, _ => new SnapshotDiff<int>());
 
         /// <summary>Get a list of inventory changes.</summary>
         public SnapshotItemListDiff Inventory { get; private set; }
diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
index cab1a94c..c0f119f1 100644
--- a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -126,7 +126,7 @@ namespace MonoMod.Utils
         }
 
         public static Type GetRealDeclaringType(this MemberInfo member)
-            => member.DeclaringType ?? member.Module?.GetModuleType();
+            => member.DeclaringType ?? member.Module.GetModuleType();
 
         public static void FixReflectionCache(this Type type)
         {
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 29f4be1b..1039cc9a 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -78,7 +78,7 @@ namespace StardewModdingAPI
                         }
                         catch
                         {
-                            continue;
+                            // ignore invalid DLL
                         }
                     }
                 }
diff --git a/src/SMAPI/Translation.cs b/src/SMAPI/Translation.cs
index 149f6728..5ab432f0 100644
--- a/src/SMAPI/Translation.cs
+++ b/src/SMAPI/Translation.cs
@@ -74,7 +74,7 @@ namespace StardewModdingAPI
                 {
                     foreach (DictionaryEntry entry in inputLookup)
                     {
-                        string key = entry.Key?.ToString().Trim();
+                        string key = entry.Key.ToString()?.Trim();
                         if (key != null)
                             tokenLookup[key] = entry.Value?.ToString();
                     }
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 20b8fbce..6b7153ac 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -76,7 +76,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Remove all active values.</summary>
         public void ResetAllScreens()
         {
-            this.RemoveScreens(p => true);
+            this.RemoveScreens(_ => true);
         }
 
 

From 215a863945396d6b733654f1ba60bf04dc4db85a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 18:34:58 -0400
Subject: [PATCH 502/856] drop update checks for Stardew64Installer

---
 docs/release-notes.md                 |  1 +
 src/SMAPI/Constants.cs                | 15 ------------
 src/SMAPI/Framework/Models/SConfig.cs |  3 ---
 src/SMAPI/Framework/SCore.cs          | 33 ---------------------------
 src/SMAPI/SMAPI.config.json           |  5 ----
 5 files changed, 1 insertion(+), 56 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6d505d40..732cd530 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
     * Added `--use-current-shell` to avoid opening a separate terminal window.
     * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
   * SMAPI now fixes many case-sensitive mod file path issues automatically.
+  * Dropped update checks for the unofficial 64-bit patcher (obsolete since SMAPI 3.12.6).
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
 
 * For the Console Commands mod:
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 6b9e9b05..2fac8c94 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -291,21 +291,6 @@ namespace StardewModdingAPI
             return new PlatformAssemblyMap(targetPlatform, removeAssemblyReferences.ToArray(), targetAssemblies.ToArray());
         }
 
-        /// <summary>Get whether the game assembly was patched by Stardew64Installer.</summary>
-        /// <param name="version">The version of Stardew64Installer which was applied to the game assembly, if any.</param>
-        internal static bool IsPatchedByStardew64Installer(out ISemanticVersion version)
-        {
-            PropertyInfo property = typeof(Game1).GetProperty("Stardew64InstallerVersion");
-            if (property == null)
-            {
-                version = null;
-                return false;
-            }
-
-            version = new SemanticVersion((string)property.GetValue(null));
-            return true;
-        }
-
 
         /*********
         ** Private methods
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 35180df2..1e78f316 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -52,9 +52,6 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>SMAPI's GitHub project name, used to perform update checks.</summary>
         public string GitHubProjectName { get; set; }
 
-        /// <summary>Stardew64Installer's GitHub project name, used to perform update checks.</summary>
-        public string Stardew64InstallerGitHubProjectName { get; set; }
-
         /// <summary>The base URL for SMAPI's web API, used to perform update checks.</summary>
         public string WebApiBaseUrl { get; set; }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index cc531de9..b471c383 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1450,39 +1450,6 @@ namespace StardewModdingAPI.Framework
                         this.LogManager.WriteUpdateMarker(updateFound.ToString(), updateUrl);
                 }
 
-                // check Stardew64Installer version
-                if (Constants.IsPatchedByStardew64Installer(out ISemanticVersion patchedByVersion))
-                {
-                    try
-                    {
-                        // fetch update check
-                        ModEntryModel response = client.GetModInfo(new[] { new ModSearchEntryModel("Steviegt6.Stardew64Installer", patchedByVersion, new[] { $"GitHub:{this.Settings.Stardew64InstallerGitHubProjectName}" }) }, apiVersion: Constants.ApiVersion, gameVersion: Constants.GameVersion, platform: Constants.Platform).Single().Value;
-                        ISemanticVersion updateFound = response.SuggestedUpdate?.Version;
-                        string updateUrl = response.SuggestedUpdate?.Url ?? Constants.HomePageUrl;
-
-                        // log message
-                        if (updateFound != null)
-                            this.Monitor.Log($"You can update Stardew64Installer to {updateFound}: {updateUrl}", LogLevel.Alert);
-                        else
-                            this.Monitor.Log("   Stardew64Installer okay.");
-
-                        // show errors
-                        if (response.Errors.Any())
-                        {
-                            this.Monitor.Log("Couldn't check for a new version of Stardew64Installer. This won't affect your game, but you may not be notified of new versions if this keeps happening.", LogLevel.Warn);
-                            this.Monitor.Log($"Error: {string.Join("\n", response.Errors)}");
-                        }
-                    }
-                    catch (Exception ex)
-                    {
-                        this.Monitor.Log("Couldn't check for a new version of Stardew64Installer. This won't affect your game, but you won't be notified of new versions if this keeps happening.", LogLevel.Warn);
-                        this.Monitor.Log(ex is WebException && ex.InnerException == null
-                            ? $"Error: {ex.Message}"
-                            : $"Error: {ex.GetLogSummary()}"
-                        );
-                    }
-                }
-
                 // check mod versions
                 if (mods.Any())
                 {
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index e62c8880..49056e83 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -69,11 +69,6 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "GitHubProjectName": "Pathoschild/SMAPI",
 
-    /**
-     * Stardew64Installer's GitHub project name, used to perform update checks.
-     */
-    "Stardew64InstallerGitHubProjectName": "Steviegt6/Stardew64Installer",
-
     /**
      * The base URL for SMAPI's web API, used to perform update checks.
      */

From 2e7c233f6c9bf6430672b39f970a3324deba79dd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 21:48:55 -0400
Subject: [PATCH 503/856] enable nullable annotations by default (#837)

This adds `#nullable disable` to all existing code (except where null is impossible like enum files), so it can be migrated incrementally.
---
 build/common.targets                                        | 1 +
 src/SMAPI.Installer/Framework/InstallerContext.cs           | 2 ++
 src/SMAPI.Installer/Framework/InstallerPaths.cs             | 2 ++
 src/SMAPI.Installer/InteractiveInstaller.cs                 | 2 ++
 src/SMAPI.Installer/Program.cs                              | 2 ++
 src/SMAPI.Internal.Patching/BasePatcher.cs                  | 2 ++
 src/SMAPI.Internal.Patching/HarmonyPatcher.cs               | 2 ++
 src/SMAPI.Internal.Patching/IPatcher.cs                     | 2 ++
 src/SMAPI.Internal.Patching/PatchHelper.cs                  | 2 ++
 src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs      | 2 ++
 src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs  | 2 ++
 src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs         | 2 ++
 src/SMAPI.Internal/ExceptionHelper.cs                       | 2 ++
 .../Framework/DiagnosticResult.cs                           | 2 ++
 .../Framework/DiagnosticVerifier.Helper.cs                  | 2 ++
 .../Framework/DiagnosticVerifier.cs                         | 2 ++
 .../Mock/Netcode/NetCollection.cs                           | 2 ++
 .../Mock/Netcode/NetFieldBase.cs                            | 2 ++
 .../Mock/Netcode/NetInt.cs                                  | 2 ++
 .../Mock/Netcode/NetList.cs                                 | 2 ++
 .../Mock/Netcode/NetObjectList.cs                           | 2 ++
 .../Mock/StardewValley/Farmer.cs                            | 2 ++
 .../Mock/StardewValley/Item.cs                              | 2 ++
 .../Mock/StardewValley/Object.cs                            | 2 ++
 .../NetFieldAnalyzerTests.cs                                | 2 ++
 .../ObsoleteFieldAnalyzerTests.cs                           | 2 ++
 src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs      | 2 ++
 src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs       | 2 ++
 src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs  | 2 ++
 src/SMAPI.ModBuildConfig/DeployModTask.cs                   | 2 ++
 src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs        | 2 ++
 src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs    | 2 ++
 .../Framework/Commands/ArgumentParser.cs                    | 2 ++
 .../Framework/Commands/ConsoleCommand.cs                    | 2 ++
 .../Framework/Commands/IConsoleCommand.cs                   | 2 ++
 .../Framework/Commands/Other/ApplySaveFixCommand.cs         | 2 ++
 .../Framework/Commands/Other/DebugCommand.cs                | 2 ++
 .../Framework/Commands/Other/RegenerateBundles.cs           | 2 ++
 .../Framework/Commands/Other/ShowDataFilesCommand.cs        | 2 ++
 .../Framework/Commands/Other/ShowGameFilesCommand.cs        | 2 ++
 .../Framework/Commands/Other/TestInputCommand.cs            | 2 ++
 .../Framework/Commands/Player/AddCommand.cs                 | 2 ++
 .../Framework/Commands/Player/ListItemTypesCommand.cs       | 2 ++
 .../Framework/Commands/Player/ListItemsCommand.cs           | 2 ++
 .../Framework/Commands/Player/SetColorCommand.cs            | 2 ++
 .../Framework/Commands/Player/SetFarmTypeCommand.cs         | 2 ++
 .../Framework/Commands/Player/SetHealthCommand.cs           | 2 ++
 .../Framework/Commands/Player/SetImmunityCommand.cs         | 2 ++
 .../Framework/Commands/Player/SetMaxHealthCommand.cs        | 2 ++
 .../Framework/Commands/Player/SetMaxStaminaCommand.cs       | 2 ++
 .../Framework/Commands/Player/SetMoneyCommand.cs            | 2 ++
 .../Framework/Commands/Player/SetNameCommand.cs             | 2 ++
 .../Framework/Commands/Player/SetStaminaCommand.cs          | 2 ++
 .../Framework/Commands/Player/SetStyleCommand.cs            | 2 ++
 .../Framework/Commands/World/ClearCommand.cs                | 2 ++
 .../Framework/Commands/World/DownMineLevelCommand.cs        | 2 ++
 .../Framework/Commands/World/FreezeTimeCommand.cs           | 2 ++
 .../Framework/Commands/World/HurryAllCommand.cs             | 2 ++
 .../Framework/Commands/World/SetDayCommand.cs               | 2 ++
 .../Framework/Commands/World/SetMineLevelCommand.cs         | 2 ++
 .../Framework/Commands/World/SetSeasonCommand.cs            | 2 ++
 .../Framework/Commands/World/SetTimeCommand.cs              | 2 ++
 .../Framework/Commands/World/SetYearCommand.cs              | 2 ++
 .../Framework/ItemData/SearchableItem.cs                    | 2 ++
 src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs  | 2 ++
 src/SMAPI.Mods.ConsoleCommands/ModEntry.cs                  | 2 ++
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs                     | 2 ++
 src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs      | 2 ++
 src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs         | 2 ++
 src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs  | 2 ++
 .../Patches/IClickableMenuPatcher.cs                        | 2 ++
 src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs           | 2 ++
 src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs        | 2 ++
 src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs      | 2 ++
 src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs   | 2 ++
 src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs       | 2 ++
 src/SMAPI.Mods.SaveBackup/ModEntry.cs                       | 2 ++
 src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs               | 2 ++
 src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs     | 2 ++
 src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs         | 2 ++
 src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs       | 2 ++
 src/SMAPI.Tests.ModApiProvider/ProviderMod.cs               | 2 ++
 src/SMAPI.Tests/Core/AssetNameTests.cs                      | 2 ++
 src/SMAPI.Tests/Core/InterfaceProxyTests.cs                 | 2 ++
 src/SMAPI.Tests/Core/ModResolverTests.cs                    | 2 ++
 src/SMAPI.Tests/Core/TranslationTests.cs                    | 2 ++
 src/SMAPI.Tests/Sample.cs                                   | 2 ++
 src/SMAPI.Tests/Utilities/KeybindListTests.cs               | 2 ++
 src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs             | 2 ++
 src/SMAPI.Tests/Utilities/SDateTests.cs                     | 2 ++
 src/SMAPI.Tests/Utilities/SemanticVersionTests.cs           | 2 ++
 src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs         | 2 ++
 src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs               | 2 ++
 src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs | 2 ++
 src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs     | 2 ++
 src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs        | 2 ++
 src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs | 2 ++
 .../Framework/Clients/WebApi/ModEntryVersionModel.cs        | 2 ++
 .../Framework/Clients/WebApi/ModExtendedMetadataModel.cs    | 2 ++
 .../Framework/Clients/WebApi/ModSearchEntryModel.cs         | 2 ++
 .../Framework/Clients/WebApi/ModSearchModel.cs              | 2 ++
 src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs  | 2 ++
 .../Framework/Clients/Wiki/ChangeDescriptor.cs              | 2 ++
 src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs      | 2 ++
 .../Framework/Clients/Wiki/WikiCompatibilityInfo.cs         | 2 ++
 .../Framework/Clients/Wiki/WikiCompatibilityStatus.cs       | 2 ++
 .../Framework/Clients/Wiki/WikiDataOverrideEntry.cs         | 2 --
 src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs    | 2 ++
 src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs     | 2 ++
 src/SMAPI.Toolkit/Framework/Constants.cs                    | 2 ++
 src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs     | 2 ++
 src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs   | 2 ++
 src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs        | 2 ++
 src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs         | 2 ++
 src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs         | 2 ++
 src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs        | 2 ++
 .../Framework/ModData/ModDataRecordVersionedFields.cs       | 2 ++
 src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs          | 2 ++
 src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs        | 2 ++
 src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs       | 2 ++
 src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs        | 2 ++
 src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs         | 2 ++
 src/SMAPI.Toolkit/ModToolkit.cs                             | 2 ++
 src/SMAPI.Toolkit/SemanticVersion.cs                        | 2 ++
 src/SMAPI.Toolkit/SemanticVersionComparer.cs                | 2 ++
 .../Converters/ManifestContentPackForConverter.cs           | 2 ++
 .../Converters/ManifestDependencyArrayConverter.cs          | 2 ++
 .../Serialization/Converters/SemanticVersionConverter.cs    | 2 ++
 .../Serialization/Converters/SimpleReadOnlyConverter.cs     | 2 ++
 src/SMAPI.Toolkit/Serialization/InternalExtensions.cs       | 2 ++
 src/SMAPI.Toolkit/Serialization/JsonHelper.cs               | 2 ++
 src/SMAPI.Toolkit/Serialization/Models/Manifest.cs          | 2 ++
 .../Serialization/Models/ManifestContentPackFor.cs          | 2 ++
 .../Serialization/Models/ManifestDependency.cs              | 2 ++
 src/SMAPI.Toolkit/Serialization/SParseException.cs          | 2 ++
 src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs           | 2 ++
 src/SMAPI.Toolkit/Utilities/FileUtilities.cs                | 2 ++
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs                | 2 ++
 src/SMAPI.Web/BackgroundService.cs                          | 2 ++
 src/SMAPI.Web/Controllers/IndexController.cs                | 2 ++
 src/SMAPI.Web/Controllers/JsonValidatorController.cs        | 2 ++
 src/SMAPI.Web/Controllers/LogParserController.cs            | 2 ++
 src/SMAPI.Web/Controllers/ModsApiController.cs              | 2 ++
 src/SMAPI.Web/Controllers/ModsController.cs                 | 2 ++
 src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs         | 2 ++
 src/SMAPI.Web/Framework/Caching/Cached.cs                   | 2 ++
 src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs | 2 ++
 .../Framework/Caching/Mods/ModCacheMemoryRepository.cs      | 2 ++
 .../Framework/Caching/Wiki/IWikiCacheRepository.cs          | 2 ++
 .../Framework/Caching/Wiki/WikiCacheMemoryRepository.cs     | 2 ++
 src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs        | 2 ++
 .../Framework/Clients/Chucklefish/ChucklefishClient.cs      | 2 ++
 .../Framework/Clients/CurseForge/CurseForgeClient.cs        | 2 ++
 .../Clients/CurseForge/ResponseModels/ModFileModel.cs       | 2 ++
 .../Framework/Clients/CurseForge/ResponseModels/ModModel.cs | 2 ++
 src/SMAPI.Web/Framework/Clients/GenericModDownload.cs       | 2 ++
 src/SMAPI.Web/Framework/Clients/GenericModPage.cs           | 2 ++
 src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs          | 2 ++
 src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs      | 2 ++
 src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs        | 2 ++
 src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs        | 2 ++
 src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs           | 2 ++
 src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs     | 2 ++
 src/SMAPI.Web/Framework/Clients/IModSiteClient.cs           | 2 ++
 src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs    | 2 ++
 .../Clients/ModDrop/ResponseModels/FileDataModel.cs         | 2 ++
 .../Clients/ModDrop/ResponseModels/ModDataModel.cs          | 2 ++
 .../Clients/ModDrop/ResponseModels/ModListModel.cs          | 2 ++
 .../Framework/Clients/ModDrop/ResponseModels/ModModel.cs    | 2 ++
 src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs        | 2 ++
 .../Framework/Clients/Nexus/ResponseModels/NexusMod.cs      | 2 ++
 src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs | 2 ++
 src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs       | 2 ++
 src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs  | 2 ++
 src/SMAPI.Web/Framework/Compression/GzipHelper.cs           | 2 ++
 src/SMAPI.Web/Framework/Compression/IGzipHelper.cs          | 2 ++
 src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs    | 2 ++
 src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs   | 2 ++
 .../Framework/ConfigModels/ModUpdateCheckConfig.cs          | 2 ++
 src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs          | 2 ++
 src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs     | 2 ++
 src/SMAPI.Web/Framework/Extensions.cs                       | 2 ++
 src/SMAPI.Web/Framework/IModDownload.cs                     | 2 ++
 src/SMAPI.Web/Framework/IModPage.cs                         | 2 ++
 .../Framework/InternalControllerFeatureProvider.cs          | 2 ++
 src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs  | 2 ++
 src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs     | 2 ++
 src/SMAPI.Web/Framework/LogParsing/LogParseException.cs     | 5 ++++-
 src/SMAPI.Web/Framework/LogParsing/LogParser.cs             | 2 ++
 src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs     | 2 ++
 src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs     | 2 ++
 src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs      | 2 ++
 src/SMAPI.Web/Framework/ModInfoModel.cs                     | 2 ++
 src/SMAPI.Web/Framework/ModSiteManager.cs                   | 2 ++
 .../Framework/RedirectRules/RedirectHostsToUrlsRule.cs      | 2 ++
 src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs  | 2 ++
 .../Framework/RedirectRules/RedirectPathsToUrlsRule.cs      | 2 ++
 .../Framework/RedirectRules/RedirectToHttpsRule.cs          | 2 ++
 src/SMAPI.Web/Framework/Storage/IStorageProvider.cs         | 2 ++
 src/SMAPI.Web/Framework/Storage/StorageProvider.cs          | 2 ++
 src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs           | 2 ++
 src/SMAPI.Web/Framework/Storage/UploadResult.cs             | 2 ++
 src/SMAPI.Web/Framework/VersionConstraint.cs                | 2 ++
 src/SMAPI.Web/Program.cs                                    | 2 ++
 src/SMAPI.Web/Startup.cs                                    | 2 ++
 src/SMAPI.Web/ViewModels/IndexModel.cs                      | 2 ++
 src/SMAPI.Web/ViewModels/IndexVersionModel.cs               | 2 ++
 .../ViewModels/JsonValidator/JsonValidatorErrorModel.cs     | 2 ++
 .../ViewModels/JsonValidator/JsonValidatorModel.cs          | 2 ++
 .../ViewModels/JsonValidator/JsonValidatorRequestModel.cs   | 2 ++
 src/SMAPI.Web/ViewModels/LogParserModel.cs                  | 2 ++
 src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs           | 2 ++
 src/SMAPI.Web/ViewModels/ModLinkModel.cs                    | 2 ++
 src/SMAPI.Web/ViewModels/ModListModel.cs                    | 2 ++
 src/SMAPI.Web/ViewModels/ModModel.cs                        | 2 ++
 src/SMAPI.Web/Views/Index/Index.cshtml                      | 4 ++++
 src/SMAPI.Web/Views/Index/Privacy.cshtml                    | 4 ++++
 src/SMAPI.Web/Views/JsonValidator/Index.cshtml              | 4 ++++
 src/SMAPI.Web/Views/LogParser/Index.cshtml                  | 4 ++++
 src/SMAPI.Web/Views/Mods/Index.cshtml                       | 4 ++++
 src/SMAPI.Web/Views/Shared/_Layout.cshtml                   | 4 ++++
 src/SMAPI.Web/Views/_ViewStart.cshtml                       | 6 +++++-
 src/SMAPI/Constants.cs                                      | 2 ++
 src/SMAPI/Context.cs                                        | 2 ++
 src/SMAPI/Events/AssetReadyEventArgs.cs                     | 2 ++
 src/SMAPI/Events/AssetRequestedEventArgs.cs                 | 2 ++
 src/SMAPI/Events/AssetsInvalidatedEventArgs.cs              | 2 ++
 src/SMAPI/Events/BuildingListChangedEventArgs.cs            | 2 ++
 src/SMAPI/Events/ButtonPressedEventArgs.cs                  | 2 ++
 src/SMAPI/Events/ButtonReleasedEventArgs.cs                 | 2 ++
 src/SMAPI/Events/ButtonsChangedEventArgs.cs                 | 2 ++
 src/SMAPI/Events/ChestInventoryChangedEventArgs.cs          | 2 ++
 src/SMAPI/Events/CursorMovedEventArgs.cs                    | 2 ++
 src/SMAPI/Events/DebrisListChangedEventArgs.cs              | 2 ++
 src/SMAPI/Events/FurnitureListChangedEventArgs.cs           | 2 ++
 src/SMAPI/Events/IContentEvents.cs                          | 2 ++
 src/SMAPI/Events/IDisplayEvents.cs                          | 2 ++
 src/SMAPI/Events/IGameLoopEvents.cs                         | 2 ++
 src/SMAPI/Events/IInputEvents.cs                            | 2 ++
 src/SMAPI/Events/IModEvents.cs                              | 2 ++
 src/SMAPI/Events/IMultiplayerEvents.cs                      | 2 ++
 src/SMAPI/Events/IPlayerEvents.cs                           | 2 ++
 src/SMAPI/Events/ISpecialisedEvents.cs                      | 2 ++
 src/SMAPI/Events/IWorldEvents.cs                            | 2 ++
 src/SMAPI/Events/InventoryChangedEventArgs.cs               | 2 ++
 src/SMAPI/Events/ItemStackSizeChange.cs                     | 2 ++
 src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs | 2 ++
 src/SMAPI/Events/LevelChangedEventArgs.cs                   | 2 ++
 src/SMAPI/Events/LocaleChangedEventArgs.cs                  | 2 ++
 src/SMAPI/Events/LocationListChangedEventArgs.cs            | 2 ++
 src/SMAPI/Events/MenuChangedEventArgs.cs                    | 2 ++
 src/SMAPI/Events/ModMessageReceivedEventArgs.cs             | 2 ++
 src/SMAPI/Events/NpcListChangedEventArgs.cs                 | 2 ++
 src/SMAPI/Events/ObjectListChangedEventArgs.cs              | 2 ++
 src/SMAPI/Events/PeerConnectedEventArgs.cs                  | 2 ++
 src/SMAPI/Events/PeerContextReceivedEventArgs.cs            | 2 ++
 src/SMAPI/Events/PeerDisconnectedEventArgs.cs               | 2 ++
 src/SMAPI/Events/RenderedActiveMenuEventArgs.cs             | 2 ++
 src/SMAPI/Events/RenderedEventArgs.cs                       | 2 ++
 src/SMAPI/Events/RenderedHudEventArgs.cs                    | 2 ++
 src/SMAPI/Events/RenderedWorldEventArgs.cs                  | 2 ++
 src/SMAPI/Events/RenderingActiveMenuEventArgs.cs            | 2 ++
 src/SMAPI/Events/RenderingEventArgs.cs                      | 2 ++
 src/SMAPI/Events/RenderingHudEventArgs.cs                   | 2 ++
 src/SMAPI/Events/RenderingWorldEventArgs.cs                 | 2 ++
 src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs      | 2 ++
 src/SMAPI/Events/WarpedEventArgs.cs                         | 2 ++
 src/SMAPI/Framework/Command.cs                              | 2 ++
 src/SMAPI/Framework/CommandManager.cs                       | 2 ++
 src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs       | 2 ++
 src/SMAPI/Framework/Commands/HelpCommand.cs                 | 2 ++
 src/SMAPI/Framework/Commands/IInternalCommand.cs            | 2 ++
 src/SMAPI/Framework/Commands/ReloadI18nCommand.cs           | 2 ++
 src/SMAPI/Framework/Content/AssetData.cs                    | 2 ++
 src/SMAPI/Framework/Content/AssetDataForDictionary.cs       | 2 ++
 src/SMAPI/Framework/Content/AssetDataForImage.cs            | 2 ++
 src/SMAPI/Framework/Content/AssetDataForMap.cs              | 2 ++
 src/SMAPI/Framework/Content/AssetDataForObject.cs           | 2 ++
 src/SMAPI/Framework/Content/AssetEditOperation.cs           | 2 ++
 src/SMAPI/Framework/Content/AssetInfo.cs                    | 2 ++
 src/SMAPI/Framework/Content/AssetInterceptorChange.cs       | 2 ++
 src/SMAPI/Framework/Content/AssetLoadOperation.cs           | 2 ++
 src/SMAPI/Framework/Content/AssetName.cs                    | 2 ++
 src/SMAPI/Framework/Content/AssetOperationGroup.cs          | 2 ++
 src/SMAPI/Framework/Content/ContentCache.cs                 | 2 ++
 src/SMAPI/Framework/Content/TilesheetReference.cs           | 2 ++
 src/SMAPI/Framework/ContentCoordinator.cs                   | 2 ++
 src/SMAPI/Framework/ContentManagers/BaseContentManager.cs   | 2 ++
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs   | 2 ++
 .../GameContentManagerForAssetPropagation.cs                | 2 ++
 src/SMAPI/Framework/ContentManagers/IContentManager.cs      | 2 ++
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs    | 2 ++
 src/SMAPI/Framework/ContentPack.cs                          | 2 ++
 src/SMAPI/Framework/CursorPosition.cs                       | 2 ++
 src/SMAPI/Framework/DeprecationManager.cs                   | 2 ++
 src/SMAPI/Framework/DeprecationWarning.cs                   | 2 ++
 src/SMAPI/Framework/Events/EventManager.cs                  | 2 ++
 src/SMAPI/Framework/Events/IManagedEvent.cs                 | 2 ++
 src/SMAPI/Framework/Events/ManagedEvent.cs                  | 2 ++
 src/SMAPI/Framework/Events/ManagedEventHandler.cs           | 2 ++
 src/SMAPI/Framework/Events/ModContentEvents.cs              | 2 ++
 src/SMAPI/Framework/Events/ModDisplayEvents.cs              | 2 ++
 src/SMAPI/Framework/Events/ModEvents.cs                     | 2 ++
 src/SMAPI/Framework/Events/ModEventsBase.cs                 | 2 ++
 src/SMAPI/Framework/Events/ModGameLoopEvents.cs             | 2 ++
 src/SMAPI/Framework/Events/ModInputEvents.cs                | 2 ++
 src/SMAPI/Framework/Events/ModMultiplayerEvents.cs          | 2 ++
 src/SMAPI/Framework/Events/ModPlayerEvents.cs               | 2 ++
 src/SMAPI/Framework/Events/ModSpecialisedEvents.cs          | 2 ++
 src/SMAPI/Framework/Events/ModWorldEvents.cs                | 2 ++
 .../Framework/Exceptions/SAssemblyLoadFailedException.cs    | 2 ++
 src/SMAPI/Framework/Exceptions/SContentLoadException.cs     | 4 +++-
 src/SMAPI/Framework/GameVersion.cs                          | 2 ++
 src/SMAPI/Framework/IModMetadata.cs                         | 2 ++
 src/SMAPI/Framework/Input/GamePadStateBuilder.cs            | 2 ++
 src/SMAPI/Framework/Input/IInputStateBuilder.cs             | 2 ++
 src/SMAPI/Framework/Input/KeyboardStateBuilder.cs           | 2 ++
 src/SMAPI/Framework/Input/MouseStateBuilder.cs              | 2 ++
 src/SMAPI/Framework/Input/SInputState.cs                    | 2 ++
 src/SMAPI/Framework/InternalExtensions.cs                   | 2 ++
 src/SMAPI/Framework/Logging/InterceptingTextWriter.cs       | 2 ++
 src/SMAPI/Framework/Logging/LogFileManager.cs               | 2 ++
 src/SMAPI/Framework/Logging/LogManager.cs                   | 2 ++
 src/SMAPI/Framework/ModHelpers/BaseHelper.cs                | 2 ++
 src/SMAPI/Framework/ModHelpers/CommandHelper.cs             | 2 ++
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs             | 2 ++
 src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs         | 2 ++
 src/SMAPI/Framework/ModHelpers/DataHelper.cs                | 2 ++
 src/SMAPI/Framework/ModHelpers/GameContentHelper.cs         | 2 ++
 src/SMAPI/Framework/ModHelpers/InputHelper.cs               | 2 ++
 src/SMAPI/Framework/ModHelpers/ModContentHelper.cs          | 2 ++
 src/SMAPI/Framework/ModHelpers/ModHelper.cs                 | 2 ++
 src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs         | 2 ++
 src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs         | 2 ++
 src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs          | 2 ++
 src/SMAPI/Framework/ModHelpers/TranslationHelper.cs         | 2 ++
 src/SMAPI/Framework/ModLinked.cs                            | 2 ++
 .../Framework/ModLoading/AssemblyDefinitionResolver.cs      | 2 ++
 src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs        | 2 ++
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs            | 2 ++
 src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs       | 2 ++
 src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs       | 2 ++
 src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs       | 2 ++
 src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs      | 2 ++
 src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs    | 2 ++
 .../Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs    | 2 ++
 .../ModLoading/Finders/ReferenceToMissingMemberFinder.cs    | 2 ++
 .../Framework/ModLoading/Finders/TypeAssemblyFinder.cs      | 2 ++
 src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs        | 2 ++
 .../ModLoading/Framework/BaseInstructionHandler.cs          | 2 ++
 .../Framework/ModLoading/Framework/RecursiveRewriter.cs     | 2 ++
 src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs   | 2 ++
 src/SMAPI/Framework/ModLoading/IInstructionHandler.cs       | 2 ++
 .../ModLoading/IncompatibleInstructionException.cs          | 2 ++
 src/SMAPI/Framework/ModLoading/InvalidModStateException.cs  | 2 ++
 src/SMAPI/Framework/ModLoading/ModMetadata.cs               | 2 ++
 src/SMAPI/Framework/ModLoading/ModResolver.cs               | 2 ++
 src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs       | 2 ++
 .../ModLoading/RewriteFacades/AccessToolsFacade.cs          | 2 ++
 .../ModLoading/RewriteFacades/HarmonyInstanceFacade.cs      | 2 ++
 .../ModLoading/RewriteFacades/HarmonyMethodFacade.cs        | 2 ++
 .../ModLoading/RewriteFacades/SpriteBatchFacade.cs          | 2 ++
 .../ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs    | 2 ++
 .../Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs  | 2 ++
 src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs | 2 ++
 .../ModLoading/Rewriters/HeuristicFieldRewriter.cs          | 2 ++
 .../ModLoading/Rewriters/HeuristicMethodRewriter.cs         | 2 ++
 .../Framework/ModLoading/Rewriters/MethodParentRewriter.cs  | 2 ++
 .../Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs | 2 ++
 src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs      | 2 ++
 .../Framework/ModLoading/Symbols/SymbolReaderProvider.cs    | 2 ++
 .../Framework/ModLoading/Symbols/SymbolWriterProvider.cs    | 2 ++
 src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs     | 2 ++
 src/SMAPI/Framework/ModRegistry.cs                          | 2 ++
 src/SMAPI/Framework/Models/SConfig.cs                       | 2 ++
 src/SMAPI/Framework/Monitor.cs                              | 2 ++
 src/SMAPI/Framework/Networking/ModMessageModel.cs           | 2 ++
 src/SMAPI/Framework/Networking/MultiplayerPeer.cs           | 2 ++
 src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs        | 2 ++
 src/SMAPI/Framework/Networking/RemoteContextModModel.cs     | 2 ++
 src/SMAPI/Framework/Networking/RemoteContextModel.cs        | 2 ++
 src/SMAPI/Framework/Networking/SGalaxyNetClient.cs          | 2 ++
 src/SMAPI/Framework/Networking/SGalaxyNetServer.cs          | 2 ++
 src/SMAPI/Framework/Networking/SLidgrenClient.cs            | 2 ++
 src/SMAPI/Framework/Networking/SLidgrenServer.cs            | 2 ++
 src/SMAPI/Framework/Reflection/CacheEntry.cs                | 2 ++
 src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs     | 2 ++
 src/SMAPI/Framework/Reflection/ReflectedField.cs            | 2 ++
 src/SMAPI/Framework/Reflection/ReflectedMethod.cs           | 2 ++
 src/SMAPI/Framework/Reflection/ReflectedProperty.cs         | 2 ++
 src/SMAPI/Framework/Reflection/Reflector.cs                 | 2 ++
 src/SMAPI/Framework/Rendering/SDisplayDevice.cs             | 2 ++
 src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs          | 2 ++
 src/SMAPI/Framework/RequestExitDelegate.cs                  | 2 ++
 src/SMAPI/Framework/SChatBox.cs                             | 2 ++
 src/SMAPI/Framework/SCore.cs                                | 2 ++
 src/SMAPI/Framework/SGame.cs                                | 2 ++
 src/SMAPI/Framework/SGameRunner.cs                          | 2 ++
 src/SMAPI/Framework/SModHooks.cs                            | 2 ++
 src/SMAPI/Framework/SMultiplayer.cs                         | 2 ++
 src/SMAPI/Framework/Serialization/ColorConverter.cs         | 2 ++
 src/SMAPI/Framework/Serialization/KeybindConverter.cs       | 2 ++
 src/SMAPI/Framework/Serialization/PointConverter.cs         | 2 ++
 src/SMAPI/Framework/Serialization/RectangleConverter.cs     | 2 ++
 src/SMAPI/Framework/Serialization/Vector2Converter.cs       | 2 ++
 src/SMAPI/Framework/Singleton.cs                            | 2 ++
 src/SMAPI/Framework/SnapshotDiff.cs                         | 2 ++
 src/SMAPI/Framework/SnapshotItemListDiff.cs                 | 2 ++
 src/SMAPI/Framework/SnapshotListDiff.cs                     | 2 ++
 src/SMAPI/Framework/StateTracking/ChestTracker.cs           | 2 ++
 .../Framework/StateTracking/Comparers/EquatableComparer.cs  | 2 ++
 .../StateTracking/Comparers/GenericEqualsComparer.cs        | 2 ++
 .../StateTracking/Comparers/ObjectReferenceComparer.cs      | 2 ++
 .../StateTracking/FieldWatchers/BaseDisposableWatcher.cs    | 2 ++
 .../StateTracking/FieldWatchers/ComparableListWatcher.cs    | 2 ++
 .../StateTracking/FieldWatchers/ComparableWatcher.cs        | 2 ++
 .../FieldWatchers/ImmutableCollectionWatcher.cs             | 2 ++
 .../StateTracking/FieldWatchers/NetCollectionWatcher.cs     | 2 ++
 .../StateTracking/FieldWatchers/NetDictionaryWatcher.cs     | 2 ++
 .../Framework/StateTracking/FieldWatchers/NetListWatcher.cs | 2 ++
 .../StateTracking/FieldWatchers/NetValueWatcher.cs          | 2 ++
 .../FieldWatchers/ObservableCollectionWatcher.cs            | 2 ++
 .../Framework/StateTracking/FieldWatchers/WatcherFactory.cs | 2 ++
 src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs     | 2 ++
 src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs     | 2 ++
 src/SMAPI/Framework/StateTracking/IValueWatcher.cs          | 2 ++
 src/SMAPI/Framework/StateTracking/IWatcher.cs               | 2 ++
 src/SMAPI/Framework/StateTracking/LocationTracker.cs        | 2 ++
 src/SMAPI/Framework/StateTracking/PlayerTracker.cs          | 2 ++
 .../Framework/StateTracking/Snapshots/LocationSnapshot.cs   | 2 ++
 .../Framework/StateTracking/Snapshots/PlayerSnapshot.cs     | 2 ++
 .../Framework/StateTracking/Snapshots/WatcherSnapshot.cs    | 2 ++
 .../StateTracking/Snapshots/WorldLocationsSnapshot.cs       | 2 ++
 src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs  | 2 ++
 src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs     | 2 ++
 src/SMAPI/Framework/Translator.cs                           | 2 ++
 src/SMAPI/Framework/Utilities/ContextHash.cs                | 2 ++
 src/SMAPI/Framework/Utilities/Countdown.cs                  | 2 +-
 src/SMAPI/Framework/Utilities/TickCacheDictionary.cs        | 2 ++
 src/SMAPI/Framework/WatcherCore.cs                          | 2 ++
 src/SMAPI/GamePlatform.cs                                   | 2 ++
 src/SMAPI/IAssetData.cs                                     | 2 ++
 src/SMAPI/IAssetDataForDictionary.cs                        | 2 ++
 src/SMAPI/IAssetDataForImage.cs                             | 2 ++
 src/SMAPI/IAssetDataForMap.cs                               | 2 ++
 src/SMAPI/IAssetEditor.cs                                   | 2 ++
 src/SMAPI/IAssetInfo.cs                                     | 2 ++
 src/SMAPI/IAssetLoader.cs                                   | 2 ++
 src/SMAPI/IAssetName.cs                                     | 2 ++
 src/SMAPI/ICommandHelper.cs                                 | 2 ++
 src/SMAPI/IContentHelper.cs                                 | 2 ++
 src/SMAPI/IContentPack.cs                                   | 2 ++
 src/SMAPI/IContentPackHelper.cs                             | 2 ++
 src/SMAPI/ICursorPosition.cs                                | 2 ++
 src/SMAPI/IDataHelper.cs                                    | 2 ++
 src/SMAPI/IGameContentHelper.cs                             | 2 ++
 src/SMAPI/IInputHelper.cs                                   | 2 ++
 src/SMAPI/IMod.cs                                           | 2 ++
 src/SMAPI/IModContentHelper.cs                              | 2 ++
 src/SMAPI/IModHelper.cs                                     | 2 ++
 src/SMAPI/IModInfo.cs                                       | 2 ++
 src/SMAPI/IModLinked.cs                                     | 2 ++
 src/SMAPI/IModRegistry.cs                                   | 2 ++
 src/SMAPI/IMonitor.cs                                       | 2 ++
 src/SMAPI/IMultiplayerHelper.cs                             | 2 ++
 src/SMAPI/IMultiplayerPeer.cs                               | 2 ++
 src/SMAPI/IMultiplayerPeerMod.cs                            | 2 ++
 src/SMAPI/IReflectedField.cs                                | 4 +++-
 src/SMAPI/IReflectedMethod.cs                               | 4 +++-
 src/SMAPI/IReflectedProperty.cs                             | 2 ++
 src/SMAPI/IReflectionHelper.cs                              | 2 ++
 src/SMAPI/ITranslationHelper.cs                             | 2 ++
 src/SMAPI/Metadata/CoreAssetPropagator.cs                   | 2 ++
 src/SMAPI/Metadata/InstructionMetadata.cs                   | 2 ++
 src/SMAPI/Mod.cs                                            | 2 ++
 src/SMAPI/Patches/Game1Patcher.cs                           | 2 ++
 src/SMAPI/Patches/TitleMenuPatcher.cs                       | 2 ++
 src/SMAPI/Program.cs                                        | 2 ++
 src/SMAPI/SemanticVersion.cs                                | 2 ++
 src/SMAPI/Translation.cs                                    | 2 ++
 src/SMAPI/Utilities/CaseInsensitivePathCache.cs             | 2 ++
 src/SMAPI/Utilities/Keybind.cs                              | 2 ++
 src/SMAPI/Utilities/KeybindList.cs                          | 2 ++
 src/SMAPI/Utilities/PathUtilities.cs                        | 2 ++
 src/SMAPI/Utilities/PerScreen.cs                            | 2 ++
 src/SMAPI/Utilities/SDate.cs                                | 2 ++
 486 files changed, 988 insertions(+), 8 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index bcb0e9e1..258b48f2 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -5,6 +5,7 @@
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
+    <Nullable>enable</Nullable>
 
     <!--set platform-->
     <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
diff --git a/src/SMAPI.Installer/Framework/InstallerContext.cs b/src/SMAPI.Installer/Framework/InstallerContext.cs
index abc7adde..23d5b17c 100644
--- a/src/SMAPI.Installer/Framework/InstallerContext.cs
+++ b/src/SMAPI.Installer/Framework/InstallerContext.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.IO;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.GameScanning;
diff --git a/src/SMAPI.Installer/Framework/InstallerPaths.cs b/src/SMAPI.Installer/Framework/InstallerPaths.cs
index 0976eceb..fd9d1be6 100644
--- a/src/SMAPI.Installer/Framework/InstallerPaths.cs
+++ b/src/SMAPI.Installer/Framework/InstallerPaths.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.IO;
 using StardewModdingAPI.Toolkit.Framework;
 
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 09183b5d..b07c0461 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/src/SMAPI.Installer/Program.cs b/src/SMAPI.Installer/Program.cs
index 2c9b2c0a..5139513f 100644
--- a/src/SMAPI.Installer/Program.cs
+++ b/src/SMAPI.Installer/Program.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
diff --git a/src/SMAPI.Internal.Patching/BasePatcher.cs b/src/SMAPI.Internal.Patching/BasePatcher.cs
index 87155d7f..6d019b52 100644
--- a/src/SMAPI.Internal.Patching/BasePatcher.cs
+++ b/src/SMAPI.Internal.Patching/BasePatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 using HarmonyLib;
diff --git a/src/SMAPI.Internal.Patching/HarmonyPatcher.cs b/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
index 6f30c241..fc239fd2 100644
--- a/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
+++ b/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using HarmonyLib;
 
diff --git a/src/SMAPI.Internal.Patching/IPatcher.cs b/src/SMAPI.Internal.Patching/IPatcher.cs
index a732d64f..5b373117 100644
--- a/src/SMAPI.Internal.Patching/IPatcher.cs
+++ b/src/SMAPI.Internal.Patching/IPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using HarmonyLib;
 
 namespace StardewModdingAPI.Internal.Patching
diff --git a/src/SMAPI.Internal.Patching/PatchHelper.cs b/src/SMAPI.Internal.Patching/PatchHelper.cs
index c9758616..52b15fd1 100644
--- a/src/SMAPI.Internal.Patching/PatchHelper.cs
+++ b/src/SMAPI.Internal.Patching/PatchHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Reflection;
diff --git a/src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs b/src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs
index 001840bf..b22aa231 100644
--- a/src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs
+++ b/src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs b/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
index bfe155e0..19a31c7b 100644
--- a/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
+++ b/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using StardewModdingAPI.Toolkit.Utilities;
diff --git a/src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs b/src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs
index fbcf161c..84e17207 100644
--- a/src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs
+++ b/src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Internal.ConsoleWriting
 {
     /// <summary>Writes text to the console.</summary>
diff --git a/src/SMAPI.Internal/ExceptionHelper.cs b/src/SMAPI.Internal/ExceptionHelper.cs
index 6bd1d579..a856cf71 100644
--- a/src/SMAPI.Internal/ExceptionHelper.cs
+++ b/src/SMAPI.Internal/ExceptionHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 using System.Text.RegularExpressions;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticResult.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticResult.cs
index 896c2cb8..8c24eda9 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticResult.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticResult.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // <generated />
 using Microsoft.CodeAnalysis;
 using System;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
index 0247288e..8d72fea1 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // <generated />
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.CSharp;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
index 49697dfa..09d3a3f8 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // <generated />
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs
index d160610e..54aa1c6c 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
 using System.Collections;
 using System.Collections.Generic;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetFieldBase.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetFieldBase.cs
index 140c6f59..1c349a0b 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetFieldBase.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetFieldBase.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
 namespace Netcode
 {
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs
index b3abc467..e8e1dc63 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
 namespace Netcode
 {
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs
index 1699f71c..f7fb9617 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
 using System.Collections;
 using System.Collections.Generic;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs
index 7814e7d6..74c17843 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
 namespace Netcode
 {
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Farmer.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Farmer.cs
index 13fab069..bdbf9b45 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Farmer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Farmer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // ReSharper disable CheckNamespace, InconsistentNaming -- matches Stardew Valley's code
 #pragma warning disable 649 // (never assigned) -- only used to test type conversions
 using System.Collections.Generic;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
index e8da92fa..d1f0afc4 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // ReSharper disable CheckNamespace, InconsistentNaming -- matches Stardew Valley's code
 using Netcode;
 
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
index 151010a7..f54b22fe 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // ReSharper disable CheckNamespace, InconsistentNaming -- matches Stardew Valley's code
 using Netcode;
 
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
index f11a59d3..29f3b956 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.Diagnostics;
 using NUnit.Framework;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
index 76607b8e..1cf7369f 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.Diagnostics;
 using NUnit.Framework;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs b/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
index a1ad8aa4..1cc37b38 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.CSharp;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
index 553aae99..cb2856da 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
index ba089513..158d7243 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index c7026ee1..43fac9d5 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index 80955f67..ad2c0de3 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs b/src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs
index 64e31c29..588118ef 100644
--- a/src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.ModBuildConfig.Framework
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
index 7e157c38..8fcbf711 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections;
 using System.Collections.Generic;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
index 44b7824e..a8dd41f5 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
index 9c82bbd3..4c6df538 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
 {
     /// <summary>A console command to register.</summary>
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
index b02ba4b1..f31457ed 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
index cf1dcbce..f289c669 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
index 159d7c4a..81a8c570 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
index a233d588..d762d8bf 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
index 745b821b..b5733eb9 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
index 8bf9f5db..5484fc7c 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
index fae31c23..0d8db870 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
index ef35ad19..e57d4065 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
index 5cc464fe..5a21b459 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
index af7f2d18..e8605163 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using Microsoft.Xna.Framework;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
index 2809df9c..02670911 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections;
 using System.Collections.Generic;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
index f169159f..1a1a9eab 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
index 1065bd21..d1dede1f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
index c2c4931d..2b3b140c 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
index 8c794e75..f9ed6c58 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
index 3afcc62b..56447a65 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
index 12d6b6e8..4ce7e1f8 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
index 24718ace..ea8d74c2 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
index 558c327d..84625a34 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index eeb95553..92c73e08 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
index 5b1a4a13..0f18c760 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 using StardewValley.Locations;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
index 16faa2fe..8808fe35 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Linq;
 using StardewValley;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
index 09531720..f9810dc3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
index 399fd934..8aa27d93 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Utilities;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
index f977fce3..ad6ac777 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
index d839c037..ebe58913 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Utilities;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
index 8c4458dd..1e6bab96 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Microsoft.Xna.Framework;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
index a666a634..995f222e 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Utilities;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
index 3675a963..ab0b2e05 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewValley;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 3915db9a..7d2a1662 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs b/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
index 5e594984..e3ca1a39 100644
--- a/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index 2d6242cf..fa171012 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 using StardewModdingAPI.Events;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
index 7a3af39c..b05c8cca 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
index 1b706147..63674d09 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
index 7df6b0a2..98aa4a38 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
index b65a695a..85ce8ac4 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
 using StardewModdingAPI.Internal.Patching;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
index 275bb5bf..5354f724 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
index fd4ea35c..499718b0 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index 01bfb888..1941d2a8 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
index f243c6d1..b4c03bb9 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
index ce85d0c2..108ed585 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
diff --git a/src/SMAPI.Mods.SaveBackup/ModEntry.cs b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
index 273b1434..b2b41ca6 100644
--- a/src/SMAPI.Mods.SaveBackup/ModEntry.cs
+++ b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.IO;
diff --git a/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs b/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
index ac7bd338..285dd259 100644
--- a/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
+++ b/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using SMAPI.Tests.ModApiConsumer.Interfaces;
 
diff --git a/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs b/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
index 7f94e137..23491fd1 100644
--- a/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
+++ b/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Reflection;
diff --git a/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs b/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
index 8092e3e7..b5870baa 100644
--- a/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
+++ b/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace SMAPI.Tests.ModApiProvider.Framework
 {
     /// <summary>The base class for <see cref="SimpleApi"/>.</summary>
diff --git a/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs b/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
index 1100af36..82e902f5 100644
--- a/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
+++ b/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Reflection;
diff --git a/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs b/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
index c36e1c6d..3fc8d749 100644
--- a/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
+++ b/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Reflection;
 using SMAPI.Tests.ModApiProvider.Framework;
diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index 7b817d13..b7e34191 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using FluentAssertions;
diff --git a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
index 99c1298f..1bf2ed68 100644
--- a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
+++ b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index 86c50606..2ce1c74e 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.Tests/Core/TranslationTests.cs b/src/SMAPI.Tests/Core/TranslationTests.cs
index 58bc59b1..f8f0e315 100644
--- a/src/SMAPI.Tests/Core/TranslationTests.cs
+++ b/src/SMAPI.Tests/Core/TranslationTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Tests/Sample.cs b/src/SMAPI.Tests/Sample.cs
index 9587a100..6d4339ca 100644
--- a/src/SMAPI.Tests/Sample.cs
+++ b/src/SMAPI.Tests/Sample.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace SMAPI.Tests
diff --git a/src/SMAPI.Tests/Utilities/KeybindListTests.cs b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
index 0bd6ec17..f5c156c4 100644
--- a/src/SMAPI.Tests/Utilities/KeybindListTests.cs
+++ b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
diff --git a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
index 94819c2e..ae2cc6ce 100644
--- a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
+++ b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.IO;
 using NUnit.Framework;
 using StardewModdingAPI.Toolkit.Utilities;
diff --git a/src/SMAPI.Tests/Utilities/SDateTests.cs b/src/SMAPI.Tests/Utilities/SDateTests.cs
index 886f25cd..a4a36828 100644
--- a/src/SMAPI.Tests/Utilities/SDateTests.cs
+++ b/src/SMAPI.Tests/Utilities/SDateTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
index 142c9814..66181ea6 100644
--- a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
+++ b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using Newtonsoft.Json;
diff --git a/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs b/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
index 84cae8df..7695fbf8 100644
--- a/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
+++ b/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using NUnit.Framework;
 using StardewModdingAPI;
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs b/src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs
index 7375f005..a9251446 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs b/src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs
index f05a3873..d898b716 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI
 {
     /// <summary>Indicates which mod can read the content pack represented by the containing manifest.</summary>
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs b/src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs
index e86cd1f4..49b7aed6 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI
 {
     /// <summary>A mod dependency listed in a mod manifest.</summary>
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs b/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
index b228b2d1..52cec52e 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
index 0115fbf3..d5ca2034 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryVersionModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryVersionModel.cs
index 188db31d..9aac7fd3 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryVersionModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryVersionModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Converters;
 
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
index 0fa4a74d..eb54ec78 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
index 404d4618..8fe8fa2a 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
index 73698173..393391f7 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Linq;
 using StardewModdingAPI.Toolkit.Utilities;
 
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
index f7d26d21..56acb768 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
index 2ed255c8..910bf793 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index c936bb3e..86c3bd75 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityInfo.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityInfo.cs
index 204acd2b..30e76d04 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityInfo.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityInfo.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>Compatibility info for a mod.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityStatus.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityStatus.cs
index 5cdf489f..2c222b71 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityStatus.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityStatus.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>The compatibility status for a mod.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
index 03c0d214..a6f5a88f 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiDataOverrideEntry.cs
@@ -1,7 +1,5 @@
 using System;
 
-#nullable enable
-
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>The data overrides to apply to matching mods.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
index 4e0104da..91943ff9 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>A mod entry in the wiki list.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs
index 0d614f28..1787197a 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>Metadata from the wiki's mod compatibility list.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/Constants.cs b/src/SMAPI.Toolkit/Framework/Constants.cs
index 55f26582..c3a787c7 100644
--- a/src/SMAPI.Toolkit/Framework/Constants.cs
+++ b/src/SMAPI.Toolkit/Framework/Constants.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Framework
 {
     /// <summary>Contains the SMAPI installer's constants and assumptions.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 768beba1..ac6fe411 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index c0332331..9998edec 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs b/src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs
index ef6d4dd9..3fa70615 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Toolkit.Framework.ModData
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
index b02be3e4..46cb81e1 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Linq;
 
 namespace StardewModdingAPI.Toolkit.Framework.ModData
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs
index 2167d3e5..4d96a555 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
index 7e07ffde..4c09e1ba 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
index 5aaabd51..b599b343 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Framework.ModData
 {
     /// <summary>The versioned fields from a <see cref="ModDataRecord"/> for a specific manifest.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
index 9bb3f558..a5237334 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
index 825b98e5..81d72c0b 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index e16af3a8..4deaf19b 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs b/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
index 489e1c4d..57eea2f7 100644
--- a/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
+++ b/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Framework
 {
     /// <summary>Reads strings into a semantic version.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
index 077c0361..ec94ed51 100644
--- a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
+++ b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Toolkit.Framework.UpdateData
diff --git a/src/SMAPI.Toolkit/ModToolkit.cs b/src/SMAPI.Toolkit/ModToolkit.cs
index 80008df7..9ae8cd1c 100644
--- a/src/SMAPI.Toolkit/ModToolkit.cs
+++ b/src/SMAPI.Toolkit/ModToolkit.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index 2f3e282b..97b92555 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Text.RegularExpressions;
 using StardewModdingAPI.Toolkit.Framework;
diff --git a/src/SMAPI.Toolkit/SemanticVersionComparer.cs b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
index 8eba2c9f..a0472f62 100644
--- a/src/SMAPI.Toolkit/SemanticVersionComparer.cs
+++ b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Toolkit
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/ManifestContentPackForConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/ManifestContentPackForConverter.cs
index 5cabe9d8..d2dc0d22 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/ManifestContentPackForConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/ManifestContentPackForConverter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Models;
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/ManifestDependencyArrayConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/ManifestDependencyArrayConverter.cs
index 7b88d6b7..2c3c2ee7 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/ManifestDependencyArrayConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/ManifestDependencyArrayConverter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
index cf69104d..9205cebe 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
index ccc5158b..c923350c 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI.Toolkit/Serialization/InternalExtensions.cs b/src/SMAPI.Toolkit/Serialization/InternalExtensions.cs
index 10f88dde..1fce5f9d 100644
--- a/src/SMAPI.Toolkit/Serialization/InternalExtensions.cs
+++ b/src/SMAPI.Toolkit/Serialization/InternalExtensions.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Newtonsoft.Json.Linq;
 
diff --git a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
index 91c2e9d3..9700e712 100644
--- a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
+++ b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 4ad97b6d..a5dbf604 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Runtime.Serialization;
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
index 1eb80889..ea5f0e6c 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Serialization.Models
 {
     /// <summary>Indicates which mod can read the content pack represented by the containing manifest.</summary>
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
index 00f168f4..f52dd5ee 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Toolkit.Serialization.Models
 {
     /// <summary>A mod dependency listed in a mod manifest.</summary>
diff --git a/src/SMAPI.Toolkit/Serialization/SParseException.cs b/src/SMAPI.Toolkit/Serialization/SParseException.cs
index 5f58b5b8..1581e027 100644
--- a/src/SMAPI.Toolkit/Serialization/SParseException.cs
+++ b/src/SMAPI.Toolkit/Serialization/SParseException.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Toolkit.Serialization
diff --git a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
index 7536337a..f14678be 100644
--- a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using StardewModdingAPI.Toolkit.Framework;
diff --git a/src/SMAPI.Toolkit/Utilities/FileUtilities.cs b/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
index a6bf5929..ba2d0f47 100644
--- a/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.IO;
 using System.Security.Cryptography;
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index 85e12bfa..9a0e2ea7 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.Contracts;
 using System.IO;
diff --git a/src/SMAPI.Web/BackgroundService.cs b/src/SMAPI.Web/BackgroundService.cs
index 64bd5ca5..7706b276 100644
--- a/src/SMAPI.Web/BackgroundService.cs
+++ b/src/SMAPI.Web/BackgroundService.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Threading;
diff --git a/src/SMAPI.Web/Controllers/IndexController.cs b/src/SMAPI.Web/Controllers/IndexController.cs
index 69b54f47..f7834b9c 100644
--- a/src/SMAPI.Web/Controllers/IndexController.cs
+++ b/src/SMAPI.Web/Controllers/IndexController.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/Controllers/JsonValidatorController.cs b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
index 985f91ae..5791d834 100644
--- a/src/SMAPI.Web/Controllers/JsonValidatorController.cs
+++ b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.Web/Controllers/LogParserController.cs b/src/SMAPI.Web/Controllers/LogParserController.cs
index db53d942..524cfbcc 100644
--- a/src/SMAPI.Web/Controllers/LogParserController.cs
+++ b/src/SMAPI.Web/Controllers/LogParserController.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Text;
diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index 5329df99..3dc1e366 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.Web/Controllers/ModsController.cs b/src/SMAPI.Web/Controllers/ModsController.cs
index c62ed605..5292e1ce 100644
--- a/src/SMAPI.Web/Controllers/ModsController.cs
+++ b/src/SMAPI.Web/Controllers/ModsController.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Linq;
 using System.Text.RegularExpressions;
 using Microsoft.AspNetCore.Mvc;
diff --git a/src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs b/src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs
index 864aa215..108ceff7 100644
--- a/src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs
+++ b/src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.AspNetCore.Http.Features;
 using Microsoft.AspNetCore.Mvc.Filters;
diff --git a/src/SMAPI.Web/Framework/Caching/Cached.cs b/src/SMAPI.Web/Framework/Caching/Cached.cs
index 52041a16..aabbf146 100644
--- a/src/SMAPI.Web/Framework/Caching/Cached.cs
+++ b/src/SMAPI.Web/Framework/Caching/Cached.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Web.Framework.Caching
diff --git a/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs b/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
index a16e6b73..2020d747 100644
--- a/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
diff --git a/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs b/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
index f871a9da..338562d8 100644
--- a/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/Framework/Caching/Wiki/IWikiCacheRepository.cs b/src/SMAPI.Web/Framework/Caching/Wiki/IWikiCacheRepository.cs
index 2ab7ea5a..6edafddc 100644
--- a/src/SMAPI.Web/Framework/Caching/Wiki/IWikiCacheRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Wiki/IWikiCacheRepository.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
diff --git a/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs b/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
index d037a123..d1ccb9c7 100644
--- a/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs b/src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs
index c04de4a5..6ae42488 100644
--- a/src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs
+++ b/src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Caching.Wiki
 {
     /// <summary>The model for cached wiki metadata.</summary>
diff --git a/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs b/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
index 269a04d4..4d041c1b 100644
--- a/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Net;
 using System.Threading.Tasks;
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
index 50a3336d..5ef369d5 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Text.RegularExpressions;
 using System.Threading.Tasks;
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModFileModel.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModFileModel.cs
index 9de74847..eabef9f0 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModFileModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModFileModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Clients.CurseForge.ResponseModels
 {
     /// <summary>Metadata from the CurseForge API about a mod file.</summary>
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
index 48cd185b..a95df7f1 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Clients.CurseForge.ResponseModels
 {
     /// <summary>An mod from the CurseForge API.</summary>
diff --git a/src/SMAPI.Web/Framework/Clients/GenericModDownload.cs b/src/SMAPI.Web/Framework/Clients/GenericModDownload.cs
index f08b471c..919072b0 100644
--- a/src/SMAPI.Web/Framework/Clients/GenericModDownload.cs
+++ b/src/SMAPI.Web/Framework/Clients/GenericModDownload.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Clients
 {
     /// <summary>Generic metadata about a file download on a mod page.</summary>
diff --git a/src/SMAPI.Web/Framework/Clients/GenericModPage.cs b/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
index a5f7c9b9..4788aa2a 100644
--- a/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
+++ b/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs
index 73ce4025..39ebf94e 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.GitHub
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs
index 671f077c..0e68e2c2 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Net;
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs
index 736efbe6..275c775a 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.GitHub
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs
index d0db5297..383775d2 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.GitHub
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs
index 7d80576e..5b5ce6a6 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.GitHub
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs b/src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs
index 0d6f4643..e1961416 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Threading.Tasks;
 
diff --git a/src/SMAPI.Web/Framework/Clients/IModSiteClient.cs b/src/SMAPI.Web/Framework/Clients/IModSiteClient.cs
index 33277711..2cd1f635 100644
--- a/src/SMAPI.Web/Framework/Clients/IModSiteClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/IModSiteClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Threading.Tasks;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
index 3a1c5b9d..1a11a606 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Threading.Tasks;
 using Pathoschild.Http.Client;
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/FileDataModel.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/FileDataModel.cs
index b01196f4..dd6a95e0 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/FileDataModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/FileDataModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModDataModel.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModDataModel.cs
index cfdd6a4e..6cae16d9 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModDataModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModDataModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
 {
     /// <summary>Metadata about a mod from the ModDrop API.</summary>
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModListModel.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModListModel.cs
index 7f692ca1..445e25cb 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModListModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModListModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModModel.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModModel.cs
index 9f4b2c6f..8869193e 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
 {
     /// <summary>An entry in a mod list from the ModDrop API.</summary>
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
index a6da0c1c..dd0bb94f 100644
--- a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/ResponseModels/NexusMod.cs b/src/SMAPI.Web/Framework/Clients/Nexus/ResponseModels/NexusMod.cs
index aef90ede..358c4633 100644
--- a/src/SMAPI.Web/Framework/Clients/Nexus/ResponseModels/NexusMod.cs
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/ResponseModels/NexusMod.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.Nexus.ResponseModels
diff --git a/src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs b/src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs
index 431fed7b..03c78e01 100644
--- a/src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Threading.Tasks;
 
diff --git a/src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs b/src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs
index 813ea115..2d48a7ae 100644
--- a/src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs
+++ b/src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Clients.Pastebin
 {
     /// <summary>The response for a get-paste request.</summary>
diff --git a/src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs b/src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs
index 1be00be7..d0cdf374 100644
--- a/src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Net;
 using System.Threading.Tasks;
diff --git a/src/SMAPI.Web/Framework/Compression/GzipHelper.cs b/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
index 93cde9d3..843b7735 100644
--- a/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
+++ b/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.IO;
 using System.IO.Compression;
diff --git a/src/SMAPI.Web/Framework/Compression/IGzipHelper.cs b/src/SMAPI.Web/Framework/Compression/IGzipHelper.cs
index a000865e..e1ec9b67 100644
--- a/src/SMAPI.Web/Framework/Compression/IGzipHelper.cs
+++ b/src/SMAPI.Web/Framework/Compression/IGzipHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Compression
 {
     /// <summary>Handles GZip compression logic.</summary>
diff --git a/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
index 878130bf..3730a9db 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
     /// <summary>The config settings for the API clients.</summary>
diff --git a/src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs
index f382d7b5..682c97e6 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
     /// <summary>Override update-check metadata for a mod.</summary>
diff --git a/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
index aea695b8..e525e09a 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
     /// <summary>The config settings for mod update checks.</summary>
diff --git a/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
index 664dbef3..ef6c2659 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
     /// <summary>The site config settings.</summary>
diff --git a/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs
index d69fabb3..dbf58817 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
     /// <summary>The update-check config for SMAPI's own update checks.</summary>
diff --git a/src/SMAPI.Web/Framework/Extensions.cs b/src/SMAPI.Web/Framework/Extensions.cs
index 2e767b3d..a72c12c1 100644
--- a/src/SMAPI.Web/Framework/Extensions.cs
+++ b/src/SMAPI.Web/Framework/Extensions.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using JetBrains.Annotations;
 using Microsoft.AspNetCore.Html;
diff --git a/src/SMAPI.Web/Framework/IModDownload.cs b/src/SMAPI.Web/Framework/IModDownload.cs
index dc058bcb..b8d1f62c 100644
--- a/src/SMAPI.Web/Framework/IModDownload.cs
+++ b/src/SMAPI.Web/Framework/IModDownload.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework
 {
     /// <summary>Generic metadata about a file download on a mod page.</summary>
diff --git a/src/SMAPI.Web/Framework/IModPage.cs b/src/SMAPI.Web/Framework/IModPage.cs
index e66d401f..68220b49 100644
--- a/src/SMAPI.Web/Framework/IModPage.cs
+++ b/src/SMAPI.Web/Framework/IModPage.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
diff --git a/src/SMAPI.Web/Framework/InternalControllerFeatureProvider.cs b/src/SMAPI.Web/Framework/InternalControllerFeatureProvider.cs
index 2c24c610..98738a82 100644
--- a/src/SMAPI.Web/Framework/InternalControllerFeatureProvider.cs
+++ b/src/SMAPI.Web/Framework/InternalControllerFeatureProvider.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 using Microsoft.AspNetCore.Mvc;
diff --git a/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs b/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
index 3c1405eb..8db43dca 100644
--- a/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
+++ b/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Hangfire.Dashboard;
 
 namespace StardewModdingAPI.Web.Framework
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs b/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
index 9da27d61..1b692e63 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Text;
 using StardewModdingAPI.Web.Framework.LogParsing.Models;
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParseException.cs b/src/SMAPI.Web/Framework/LogParsing/LogParseException.cs
index 5d4c8c08..4ee58433 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParseException.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParseException.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Web.Framework.LogParsing
@@ -10,6 +12,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="message">The user-friendly error message.</param>
-        public LogParseException(string message) : base(message) { }
+        public LogParseException(string message)
+            : base(message) { }
     }
 }
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 864caef1..4e61ac95 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
index 1e08be78..57d28755 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.LogParsing.Models
 {
     /// <summary>A parsed log message.</summary>
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
index 92bfe5c7..349312df 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.LogParsing.Models
 {
     /// <summary>Metadata about a mod or content pack in the log.</summary>
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
index 693a16ec..dae91d84 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Web.Framework.LogParsing.Models
diff --git a/src/SMAPI.Web/Framework/ModInfoModel.cs b/src/SMAPI.Web/Framework/ModInfoModel.cs
index 86f70788..021d14fb 100644
--- a/src/SMAPI.Web/Framework/ModInfoModel.cs
+++ b/src/SMAPI.Web/Framework/ModInfoModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework
 {
     /// <summary>Generic metadata about a mod.</summary>
diff --git a/src/SMAPI.Web/Framework/ModSiteManager.cs b/src/SMAPI.Web/Framework/ModSiteManager.cs
index a2b92aa4..2d6755d8 100644
--- a/src/SMAPI.Web/Framework/ModSiteManager.cs
+++ b/src/SMAPI.Web/Framework/ModSiteManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
index d67b5156..fe601524 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Net;
 using Microsoft.AspNetCore.Rewrite;
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs
index 6e81c4ca..81a265c9 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Net;
 using Microsoft.AspNetCore.Http;
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectPathsToUrlsRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectPathsToUrlsRule.cs
index d9d44641..cb3e53ef 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectPathsToUrlsRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectPathsToUrlsRule.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Net;
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
index 265a605f..dd7c836f 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Net;
 using Microsoft.AspNetCore.Http;
diff --git a/src/SMAPI.Web/Framework/Storage/IStorageProvider.cs b/src/SMAPI.Web/Framework/Storage/IStorageProvider.cs
index dfc1fb47..2eca4845 100644
--- a/src/SMAPI.Web/Framework/Storage/IStorageProvider.cs
+++ b/src/SMAPI.Web/Framework/Storage/IStorageProvider.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Threading.Tasks;
 
 namespace StardewModdingAPI.Web.Framework.Storage
diff --git a/src/SMAPI.Web/Framework/Storage/StorageProvider.cs b/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
index 1104df89..0177e602 100644
--- a/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
+++ b/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs b/src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs
index 30676c88..cd941c94 100644
--- a/src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs
+++ b/src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Web.Framework.Storage
diff --git a/src/SMAPI.Web/Framework/Storage/UploadResult.cs b/src/SMAPI.Web/Framework/Storage/UploadResult.cs
index 483c1769..b1eedd59 100644
--- a/src/SMAPI.Web/Framework/Storage/UploadResult.cs
+++ b/src/SMAPI.Web/Framework/Storage/UploadResult.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.Framework.Storage
 {
     /// <summary>The result of an attempt to upload a file.</summary>
diff --git a/src/SMAPI.Web/Framework/VersionConstraint.cs b/src/SMAPI.Web/Framework/VersionConstraint.cs
index f0c57c41..f230a95b 100644
--- a/src/SMAPI.Web/Framework/VersionConstraint.cs
+++ b/src/SMAPI.Web/Framework/VersionConstraint.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Routing;
diff --git a/src/SMAPI.Web/Program.cs b/src/SMAPI.Web/Program.cs
index 1fdd3185..5134791a 100644
--- a/src/SMAPI.Web/Program.cs
+++ b/src/SMAPI.Web/Program.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.Extensions.Hosting;
 
diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index 6d9591ee..0199938d 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Net;
 using Hangfire;
diff --git a/src/SMAPI.Web/ViewModels/IndexModel.cs b/src/SMAPI.Web/ViewModels/IndexModel.cs
index d8d2d27f..2283acd9 100644
--- a/src/SMAPI.Web/ViewModels/IndexModel.cs
+++ b/src/SMAPI.Web/ViewModels/IndexModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.ViewModels
 {
     /// <summary>The view model for the index page.</summary>
diff --git a/src/SMAPI.Web/ViewModels/IndexVersionModel.cs b/src/SMAPI.Web/ViewModels/IndexVersionModel.cs
index 4f63b979..1f5d4ec0 100644
--- a/src/SMAPI.Web/ViewModels/IndexVersionModel.cs
+++ b/src/SMAPI.Web/ViewModels/IndexVersionModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.ViewModels
 {
     /// <summary>The fields for a SMAPI version.</summary>
diff --git a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorErrorModel.cs b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorErrorModel.cs
index 62b95501..3c63b730 100644
--- a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorErrorModel.cs
+++ b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorErrorModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Newtonsoft.Json.Schema;
 
 namespace StardewModdingAPI.Web.ViewModels.JsonValidator
diff --git a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
index e659b389..2543807f 100644
--- a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
+++ b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
index c8e851bf..43114d94 100644
--- a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
+++ b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.ViewModels.JsonValidator
 {
     /// <summary>The view model for a JSON validation request.</summary>
diff --git a/src/SMAPI.Web/ViewModels/LogParserModel.cs b/src/SMAPI.Web/ViewModels/LogParserModel.cs
index 5aa2fd92..c768a08c 100644
--- a/src/SMAPI.Web/ViewModels/LogParserModel.cs
+++ b/src/SMAPI.Web/ViewModels/LogParserModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs b/src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs
index 85bf1e46..2af30cc3 100644
--- a/src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs
+++ b/src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
 
 namespace StardewModdingAPI.Web.ViewModels
diff --git a/src/SMAPI.Web/ViewModels/ModLinkModel.cs b/src/SMAPI.Web/ViewModels/ModLinkModel.cs
index 97dd215c..3039702e 100644
--- a/src/SMAPI.Web/ViewModels/ModLinkModel.cs
+++ b/src/SMAPI.Web/ViewModels/ModLinkModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Web.ViewModels
 {
     /// <summary>Metadata about a link.</summary>
diff --git a/src/SMAPI.Web/ViewModels/ModListModel.cs b/src/SMAPI.Web/ViewModels/ModListModel.cs
index 6b8279c1..f0cf0c3a 100644
--- a/src/SMAPI.Web/ViewModels/ModListModel.cs
+++ b/src/SMAPI.Web/ViewModels/ModListModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Web/ViewModels/ModModel.cs b/src/SMAPI.Web/ViewModels/ModModel.cs
index 575d596a..d0d7373b 100644
--- a/src/SMAPI.Web/ViewModels/ModModel.cs
+++ b/src/SMAPI.Web/ViewModels/ModModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
diff --git a/src/SMAPI.Web/Views/Index/Index.cshtml b/src/SMAPI.Web/Views/Index/Index.cshtml
index 669cfd99..9841ca42 100644
--- a/src/SMAPI.Web/Views/Index/Index.cshtml
+++ b/src/SMAPI.Web/Views/Index/Index.cshtml
@@ -1,3 +1,7 @@
+@{
+    #nullable disable
+}
+
 @using Microsoft.Extensions.Options
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.Framework.ConfigModels
diff --git a/src/SMAPI.Web/Views/Index/Privacy.cshtml b/src/SMAPI.Web/Views/Index/Privacy.cshtml
index fd78f908..1dc327d7 100644
--- a/src/SMAPI.Web/Views/Index/Privacy.cshtml
+++ b/src/SMAPI.Web/Views/Index/Privacy.cshtml
@@ -1,3 +1,7 @@
+@{
+    #nullable disable
+}
+
 @using Microsoft.Extensions.Options
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.Framework.ConfigModels
diff --git a/src/SMAPI.Web/Views/JsonValidator/Index.cshtml b/src/SMAPI.Web/Views/JsonValidator/Index.cshtml
index 1db79857..5e38e4dc 100644
--- a/src/SMAPI.Web/Views/JsonValidator/Index.cshtml
+++ b/src/SMAPI.Web/Views/JsonValidator/Index.cshtml
@@ -1,3 +1,7 @@
+@{
+    #nullable disable
+}
+
 @using Humanizer
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.ViewModels.JsonValidator
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 3ddc6303..c26ec230 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -1,3 +1,7 @@
+@{
+    #nullable disable
+}
+
 @using Humanizer
 @using StardewModdingAPI.Toolkit.Utilities
 @using StardewModdingAPI.Web.Framework
diff --git a/src/SMAPI.Web/Views/Mods/Index.cshtml b/src/SMAPI.Web/Views/Mods/Index.cshtml
index 416468e4..4b6400ad 100644
--- a/src/SMAPI.Web/Views/Mods/Index.cshtml
+++ b/src/SMAPI.Web/Views/Mods/Index.cshtml
@@ -1,3 +1,7 @@
+@{
+    #nullable disable
+}
+
 @using Humanizer
 @using Humanizer.Localisation
 @using StardewModdingAPI.Web.Framework
diff --git a/src/SMAPI.Web/Views/Shared/_Layout.cshtml b/src/SMAPI.Web/Views/Shared/_Layout.cshtml
index 67dcd3b3..7c86a68c 100644
--- a/src/SMAPI.Web/Views/Shared/_Layout.cshtml
+++ b/src/SMAPI.Web/Views/Shared/_Layout.cshtml
@@ -1,3 +1,7 @@
+@{
+    #nullable disable
+}
+
 @using Microsoft.Extensions.Options
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.Framework.ConfigModels
diff --git a/src/SMAPI.Web/Views/_ViewStart.cshtml b/src/SMAPI.Web/Views/_ViewStart.cshtml
index a5f10045..0dbac246 100644
--- a/src/SMAPI.Web/Views/_ViewStart.cshtml
+++ b/src/SMAPI.Web/Views/_ViewStart.cshtml
@@ -1,3 +1,7 @@
-@{
+@{
+    #nullable disable
+}
+
+@{
     Layout = "_Layout";
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 2fac8c94..2d9ab666 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index aa4ecf35..e906375b 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Events;
diff --git a/src/SMAPI/Events/AssetReadyEventArgs.cs b/src/SMAPI/Events/AssetReadyEventArgs.cs
index 2c308f18..19e5a9df 100644
--- a/src/SMAPI/Events/AssetReadyEventArgs.cs
+++ b/src/SMAPI/Events/AssetReadyEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index c0cbd8fb..82b59290 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
index 614cdf49..bd0df598 100644
--- a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
+++ b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
diff --git a/src/SMAPI/Events/BuildingListChangedEventArgs.cs b/src/SMAPI/Events/BuildingListChangedEventArgs.cs
index 74f37710..ba9574cc 100644
--- a/src/SMAPI/Events/BuildingListChangedEventArgs.cs
+++ b/src/SMAPI/Events/BuildingListChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/ButtonPressedEventArgs.cs b/src/SMAPI/Events/ButtonPressedEventArgs.cs
index 1b30fd23..94684513 100644
--- a/src/SMAPI/Events/ButtonPressedEventArgs.cs
+++ b/src/SMAPI/Events/ButtonPressedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Framework.Input;
 
diff --git a/src/SMAPI/Events/ButtonReleasedEventArgs.cs b/src/SMAPI/Events/ButtonReleasedEventArgs.cs
index 40ec1cc1..6ff3727d 100644
--- a/src/SMAPI/Events/ButtonReleasedEventArgs.cs
+++ b/src/SMAPI/Events/ButtonReleasedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Framework.Input;
 
diff --git a/src/SMAPI/Events/ButtonsChangedEventArgs.cs b/src/SMAPI/Events/ButtonsChangedEventArgs.cs
index a5e87735..c63d34e6 100644
--- a/src/SMAPI/Events/ButtonsChangedEventArgs.cs
+++ b/src/SMAPI/Events/ButtonsChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/ChestInventoryChangedEventArgs.cs b/src/SMAPI/Events/ChestInventoryChangedEventArgs.cs
index 4b4c4210..bc8ac0c0 100644
--- a/src/SMAPI/Events/ChestInventoryChangedEventArgs.cs
+++ b/src/SMAPI/Events/ChestInventoryChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using StardewValley;
diff --git a/src/SMAPI/Events/CursorMovedEventArgs.cs b/src/SMAPI/Events/CursorMovedEventArgs.cs
index 43ff90ce..f3e7513b 100644
--- a/src/SMAPI/Events/CursorMovedEventArgs.cs
+++ b/src/SMAPI/Events/CursorMovedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/DebrisListChangedEventArgs.cs b/src/SMAPI/Events/DebrisListChangedEventArgs.cs
index 61b7590a..56b1f30a 100644
--- a/src/SMAPI/Events/DebrisListChangedEventArgs.cs
+++ b/src/SMAPI/Events/DebrisListChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/FurnitureListChangedEventArgs.cs b/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
index 683f4620..cda1b6cc 100644
--- a/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
+++ b/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/IContentEvents.cs b/src/SMAPI/Events/IContentEvents.cs
index d537db70..109f9753 100644
--- a/src/SMAPI/Events/IContentEvents.cs
+++ b/src/SMAPI/Events/IContentEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IDisplayEvents.cs b/src/SMAPI/Events/IDisplayEvents.cs
index dbf8d90f..b8b89120 100644
--- a/src/SMAPI/Events/IDisplayEvents.cs
+++ b/src/SMAPI/Events/IDisplayEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewValley;
 
diff --git a/src/SMAPI/Events/IGameLoopEvents.cs b/src/SMAPI/Events/IGameLoopEvents.cs
index 6855737b..52bac3f8 100644
--- a/src/SMAPI/Events/IGameLoopEvents.cs
+++ b/src/SMAPI/Events/IGameLoopEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IInputEvents.cs b/src/SMAPI/Events/IInputEvents.cs
index 081c40c0..01ceb224 100644
--- a/src/SMAPI/Events/IInputEvents.cs
+++ b/src/SMAPI/Events/IInputEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IModEvents.cs b/src/SMAPI/Events/IModEvents.cs
index 2603961b..a1aacbce 100644
--- a/src/SMAPI/Events/IModEvents.cs
+++ b/src/SMAPI/Events/IModEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Events
 {
     /// <summary>Manages access to events raised by SMAPI.</summary>
diff --git a/src/SMAPI/Events/IMultiplayerEvents.cs b/src/SMAPI/Events/IMultiplayerEvents.cs
index af9b5f17..c50eaf04 100644
--- a/src/SMAPI/Events/IMultiplayerEvents.cs
+++ b/src/SMAPI/Events/IMultiplayerEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IPlayerEvents.cs b/src/SMAPI/Events/IPlayerEvents.cs
index 81e17b1a..9d18bfad 100644
--- a/src/SMAPI/Events/IPlayerEvents.cs
+++ b/src/SMAPI/Events/IPlayerEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/ISpecialisedEvents.cs b/src/SMAPI/Events/ISpecialisedEvents.cs
index bf70956d..0ec5bf54 100644
--- a/src/SMAPI/Events/ISpecialisedEvents.cs
+++ b/src/SMAPI/Events/ISpecialisedEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IWorldEvents.cs b/src/SMAPI/Events/IWorldEvents.cs
index c023e1f0..785dfa8f 100644
--- a/src/SMAPI/Events/IWorldEvents.cs
+++ b/src/SMAPI/Events/IWorldEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/InventoryChangedEventArgs.cs b/src/SMAPI/Events/InventoryChangedEventArgs.cs
index 40cd4128..58c0ff8f 100644
--- a/src/SMAPI/Events/InventoryChangedEventArgs.cs
+++ b/src/SMAPI/Events/InventoryChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using StardewValley;
diff --git a/src/SMAPI/Events/ItemStackSizeChange.cs b/src/SMAPI/Events/ItemStackSizeChange.cs
index 35369be2..5d0986aa 100644
--- a/src/SMAPI/Events/ItemStackSizeChange.cs
+++ b/src/SMAPI/Events/ItemStackSizeChange.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using StardewValley;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs b/src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs
index 59d79f0f..aedb0e46 100644
--- a/src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs
+++ b/src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/LevelChangedEventArgs.cs b/src/SMAPI/Events/LevelChangedEventArgs.cs
index c7303603..3beb9fd5 100644
--- a/src/SMAPI/Events/LevelChangedEventArgs.cs
+++ b/src/SMAPI/Events/LevelChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Enums;
 using StardewValley;
diff --git a/src/SMAPI/Events/LocaleChangedEventArgs.cs b/src/SMAPI/Events/LocaleChangedEventArgs.cs
index 09d3f6e5..015e7ec8 100644
--- a/src/SMAPI/Events/LocaleChangedEventArgs.cs
+++ b/src/SMAPI/Events/LocaleChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using LanguageCode = StardewValley.LocalizedContentManager.LanguageCode;
 
diff --git a/src/SMAPI/Events/LocationListChangedEventArgs.cs b/src/SMAPI/Events/LocationListChangedEventArgs.cs
index 1ebb3e2d..055463dd 100644
--- a/src/SMAPI/Events/LocationListChangedEventArgs.cs
+++ b/src/SMAPI/Events/LocationListChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/MenuChangedEventArgs.cs b/src/SMAPI/Events/MenuChangedEventArgs.cs
index 977ba38b..362accec 100644
--- a/src/SMAPI/Events/MenuChangedEventArgs.cs
+++ b/src/SMAPI/Events/MenuChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewValley.Menus;
 
diff --git a/src/SMAPI/Events/ModMessageReceivedEventArgs.cs b/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
index d75a7540..671bdf38 100644
--- a/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
+++ b/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Framework.Networking;
 using StardewModdingAPI.Toolkit.Serialization;
diff --git a/src/SMAPI/Events/NpcListChangedEventArgs.cs b/src/SMAPI/Events/NpcListChangedEventArgs.cs
index 3a37f1e7..fb6dc1c5 100644
--- a/src/SMAPI/Events/NpcListChangedEventArgs.cs
+++ b/src/SMAPI/Events/NpcListChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/ObjectListChangedEventArgs.cs b/src/SMAPI/Events/ObjectListChangedEventArgs.cs
index b21d2867..b1a636aa 100644
--- a/src/SMAPI/Events/ObjectListChangedEventArgs.cs
+++ b/src/SMAPI/Events/ObjectListChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/PeerConnectedEventArgs.cs b/src/SMAPI/Events/PeerConnectedEventArgs.cs
index bfaa2bd3..3d11a3b5 100644
--- a/src/SMAPI/Events/PeerConnectedEventArgs.cs
+++ b/src/SMAPI/Events/PeerConnectedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/PeerContextReceivedEventArgs.cs b/src/SMAPI/Events/PeerContextReceivedEventArgs.cs
index 151a295c..35a4b20d 100644
--- a/src/SMAPI/Events/PeerContextReceivedEventArgs.cs
+++ b/src/SMAPI/Events/PeerContextReceivedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/PeerDisconnectedEventArgs.cs b/src/SMAPI/Events/PeerDisconnectedEventArgs.cs
index 8517988a..0675b8fe 100644
--- a/src/SMAPI/Events/PeerDisconnectedEventArgs.cs
+++ b/src/SMAPI/Events/PeerDisconnectedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/RenderedActiveMenuEventArgs.cs b/src/SMAPI/Events/RenderedActiveMenuEventArgs.cs
index efd4163b..3da0b4b4 100644
--- a/src/SMAPI/Events/RenderedActiveMenuEventArgs.cs
+++ b/src/SMAPI/Events/RenderedActiveMenuEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderedEventArgs.cs b/src/SMAPI/Events/RenderedEventArgs.cs
index d6341b19..e8beaaac 100644
--- a/src/SMAPI/Events/RenderedEventArgs.cs
+++ b/src/SMAPI/Events/RenderedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderedHudEventArgs.cs b/src/SMAPI/Events/RenderedHudEventArgs.cs
index 46e89013..b25ecd4c 100644
--- a/src/SMAPI/Events/RenderedHudEventArgs.cs
+++ b/src/SMAPI/Events/RenderedHudEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderedWorldEventArgs.cs b/src/SMAPI/Events/RenderedWorldEventArgs.cs
index 56145381..a99d6ab3 100644
--- a/src/SMAPI/Events/RenderedWorldEventArgs.cs
+++ b/src/SMAPI/Events/RenderedWorldEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderingActiveMenuEventArgs.cs b/src/SMAPI/Events/RenderingActiveMenuEventArgs.cs
index 103f56df..3e3f3258 100644
--- a/src/SMAPI/Events/RenderingActiveMenuEventArgs.cs
+++ b/src/SMAPI/Events/RenderingActiveMenuEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderingEventArgs.cs b/src/SMAPI/Events/RenderingEventArgs.cs
index 5acbef09..8f6b3557 100644
--- a/src/SMAPI/Events/RenderingEventArgs.cs
+++ b/src/SMAPI/Events/RenderingEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderingHudEventArgs.cs b/src/SMAPI/Events/RenderingHudEventArgs.cs
index 84c96ecd..87269b90 100644
--- a/src/SMAPI/Events/RenderingHudEventArgs.cs
+++ b/src/SMAPI/Events/RenderingHudEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderingWorldEventArgs.cs b/src/SMAPI/Events/RenderingWorldEventArgs.cs
index d0d44789..2fc9964f 100644
--- a/src/SMAPI/Events/RenderingWorldEventArgs.cs
+++ b/src/SMAPI/Events/RenderingWorldEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs b/src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs
index cdf1e6dc..77a73102 100644
--- a/src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs
+++ b/src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/WarpedEventArgs.cs b/src/SMAPI/Events/WarpedEventArgs.cs
index 9afe4a4e..92a8ea77 100644
--- a/src/SMAPI/Events/WarpedEventArgs.cs
+++ b/src/SMAPI/Events/WarpedEventArgs.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewValley;
 
diff --git a/src/SMAPI/Framework/Command.cs b/src/SMAPI/Framework/Command.cs
index 8c9df47d..776ba238 100644
--- a/src/SMAPI/Framework/Command.cs
+++ b/src/SMAPI/Framework/Command.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework
diff --git a/src/SMAPI/Framework/CommandManager.cs b/src/SMAPI/Framework/CommandManager.cs
index 0c0f6685..df798b0c 100644
--- a/src/SMAPI/Framework/CommandManager.cs
+++ b/src/SMAPI/Framework/CommandManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs b/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
index 643267ce..fcfa928e 100644
--- a/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
+++ b/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Commands/HelpCommand.cs b/src/SMAPI/Framework/Commands/HelpCommand.cs
index baf3116e..eb6c74f5 100644
--- a/src/SMAPI/Framework/Commands/HelpCommand.cs
+++ b/src/SMAPI/Framework/Commands/HelpCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Linq;
 
 namespace StardewModdingAPI.Framework.Commands
diff --git a/src/SMAPI/Framework/Commands/IInternalCommand.cs b/src/SMAPI/Framework/Commands/IInternalCommand.cs
index abf105b6..32e3e9f1 100644
--- a/src/SMAPI/Framework/Commands/IInternalCommand.cs
+++ b/src/SMAPI/Framework/Commands/IInternalCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.Commands
 {
     /// <summary>A core SMAPI console command.</summary>
diff --git a/src/SMAPI/Framework/Commands/ReloadI18nCommand.cs b/src/SMAPI/Framework/Commands/ReloadI18nCommand.cs
index 12328bb6..2043b35e 100644
--- a/src/SMAPI/Framework/Commands/ReloadI18nCommand.cs
+++ b/src/SMAPI/Framework/Commands/ReloadI18nCommand.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework.Commands
diff --git a/src/SMAPI/Framework/Content/AssetData.cs b/src/SMAPI/Framework/Content/AssetData.cs
index 05be8a3b..be4a7ce6 100644
--- a/src/SMAPI/Framework/Content/AssetData.cs
+++ b/src/SMAPI/Framework/Content/AssetData.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework.Content
diff --git a/src/SMAPI/Framework/Content/AssetDataForDictionary.cs b/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
index 735b651c..06dbe259 100644
--- a/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index b0f1b5c7..8e59cd27 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 5986e797..0425e195 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Content/AssetDataForObject.cs b/src/SMAPI/Framework/Content/AssetDataForObject.cs
index bafd8941..4a6df64b 100644
--- a/src/SMAPI/Framework/Content/AssetDataForObject.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForObject.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/Framework/Content/AssetEditOperation.cs b/src/SMAPI/Framework/Content/AssetEditOperation.cs
index 818209fa..1b7d0c93 100644
--- a/src/SMAPI/Framework/Content/AssetEditOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetEditOperation.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index f5da5d69..51dcc61f 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
index 03d6da5a..7f53db9b 100644
--- a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
+++ b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 using StardewModdingAPI.Internal;
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
index b12958d6..73e60e24 100644
--- a/src/SMAPI/Framework/Content/AssetLoadOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 4973b444..4d583d82 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
diff --git a/src/SMAPI/Framework/Content/AssetOperationGroup.cs b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
index a2fcb722..e3c3f92c 100644
--- a/src/SMAPI/Framework/Content/AssetOperationGroup.cs
+++ b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>A set of operations to apply to an asset for a given <see cref="IAssetEditor"/> or <see cref="IAssetLoader"/> implementation.</summary>
diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index 8e0c6228..4e620d28 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.Contracts;
diff --git a/src/SMAPI/Framework/Content/TilesheetReference.cs b/src/SMAPI/Framework/Content/TilesheetReference.cs
index 0339b802..cdc4bc62 100644
--- a/src/SMAPI/Framework/Content/TilesheetReference.cs
+++ b/src/SMAPI/Framework/Content/TilesheetReference.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using xTile.Dimensions;
 
 namespace StardewModdingAPI.Framework.Content
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 88ed96da..bfde649a 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index c803905a..4594d235 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index cad5f6db..f4e1bda4 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Globalization;
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
index 3f7188da..46d5d24e 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Globalization;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index 90095492..c4625761 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Content;
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index e0c85265..8051c296 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Globalization;
 using System.IO;
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index e02ef88b..2d33a22e 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.IO;
 using StardewModdingAPI.Framework.ModHelpers;
diff --git a/src/SMAPI/Framework/CursorPosition.cs b/src/SMAPI/Framework/CursorPosition.cs
index 107481e7..8f36a554 100644
--- a/src/SMAPI/Framework/CursorPosition.cs
+++ b/src/SMAPI/Framework/CursorPosition.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Microsoft.Xna.Framework;
 using StardewValley;
 
diff --git a/src/SMAPI/Framework/DeprecationManager.cs b/src/SMAPI/Framework/DeprecationManager.cs
index ad6a3677..fe1b623f 100644
--- a/src/SMAPI/Framework/DeprecationManager.cs
+++ b/src/SMAPI/Framework/DeprecationManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/DeprecationWarning.cs b/src/SMAPI/Framework/DeprecationWarning.cs
index 5201b06c..f155358b 100644
--- a/src/SMAPI/Framework/DeprecationWarning.cs
+++ b/src/SMAPI/Framework/DeprecationWarning.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework
 {
     /// <summary>A deprecation warning for a mod.</summary>
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index 41540047..c977e73d 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
diff --git a/src/SMAPI/Framework/Events/IManagedEvent.cs b/src/SMAPI/Framework/Events/IManagedEvent.cs
index e4e3ca08..57277576 100644
--- a/src/SMAPI/Framework/Events/IManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/IManagedEvent.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.Events
 {
     /// <summary>Metadata for an event raised by SMAPI.</summary>
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index 1c8b9d04..8fa31165 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Events/ManagedEventHandler.cs b/src/SMAPI/Framework/Events/ManagedEventHandler.cs
index 97040f76..f31bc04d 100644
--- a/src/SMAPI/Framework/Events/ManagedEventHandler.cs
+++ b/src/SMAPI/Framework/Events/ManagedEventHandler.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModContentEvents.cs b/src/SMAPI/Framework/Events/ModContentEvents.cs
index beb96031..f198b793 100644
--- a/src/SMAPI/Framework/Events/ModContentEvents.cs
+++ b/src/SMAPI/Framework/Events/ModContentEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModDisplayEvents.cs b/src/SMAPI/Framework/Events/ModDisplayEvents.cs
index 48f55324..b2110cce 100644
--- a/src/SMAPI/Framework/Events/ModDisplayEvents.cs
+++ b/src/SMAPI/Framework/Events/ModDisplayEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModEvents.cs b/src/SMAPI/Framework/Events/ModEvents.cs
index 1fb3482c..e8f8885d 100644
--- a/src/SMAPI/Framework/Events/ModEvents.cs
+++ b/src/SMAPI/Framework/Events/ModEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
diff --git a/src/SMAPI/Framework/Events/ModEventsBase.cs b/src/SMAPI/Framework/Events/ModEventsBase.cs
index 77708fc1..295caa0d 100644
--- a/src/SMAPI/Framework/Events/ModEventsBase.cs
+++ b/src/SMAPI/Framework/Events/ModEventsBase.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.Events
 {
     /// <summary>An internal base class for event API classes.</summary>
diff --git a/src/SMAPI/Framework/Events/ModGameLoopEvents.cs b/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
index 5f0db369..51803daf 100644
--- a/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
+++ b/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModInputEvents.cs b/src/SMAPI/Framework/Events/ModInputEvents.cs
index 40edf806..6af79c59 100644
--- a/src/SMAPI/Framework/Events/ModInputEvents.cs
+++ b/src/SMAPI/Framework/Events/ModInputEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs b/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
index b90f64fa..7d3ce510 100644
--- a/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
+++ b/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModPlayerEvents.cs b/src/SMAPI/Framework/Events/ModPlayerEvents.cs
index b2d89e9a..dac8f05b 100644
--- a/src/SMAPI/Framework/Events/ModPlayerEvents.cs
+++ b/src/SMAPI/Framework/Events/ModPlayerEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs b/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
index 7980208b..4b438034 100644
--- a/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
+++ b/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModWorldEvents.cs b/src/SMAPI/Framework/Events/ModWorldEvents.cs
index a7b7d799..614945c7 100644
--- a/src/SMAPI/Framework/Events/ModWorldEvents.cs
+++ b/src/SMAPI/Framework/Events/ModWorldEvents.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Exceptions/SAssemblyLoadFailedException.cs b/src/SMAPI/Framework/Exceptions/SAssemblyLoadFailedException.cs
index ec9279f1..4e03a687 100644
--- a/src/SMAPI/Framework/Exceptions/SAssemblyLoadFailedException.cs
+++ b/src/SMAPI/Framework/Exceptions/SAssemblyLoadFailedException.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework.Exceptions
diff --git a/src/SMAPI/Framework/Exceptions/SContentLoadException.cs b/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
index 85d85e3d..c21a6b0e 100644
--- a/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
+++ b/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
@@ -1,4 +1,6 @@
-using System;
+#nullable disable
+
+using System;
 using Microsoft.Xna.Framework.Content;
 
 namespace StardewModdingAPI.Framework.Exceptions
diff --git a/src/SMAPI/Framework/GameVersion.cs b/src/SMAPI/Framework/GameVersion.cs
index b69c6757..aa91d8f3 100644
--- a/src/SMAPI/Framework/GameVersion.cs
+++ b/src/SMAPI/Framework/GameVersion.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI/Framework/IModMetadata.cs b/src/SMAPI/Framework/IModMetadata.cs
index cb876ee4..800b198a 100644
--- a/src/SMAPI/Framework/IModMetadata.cs
+++ b/src/SMAPI/Framework/IModMetadata.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.ModHelpers;
diff --git a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
index ad254828..21168b7a 100644
--- a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Microsoft.Xna.Framework;
diff --git a/src/SMAPI/Framework/Input/IInputStateBuilder.cs b/src/SMAPI/Framework/Input/IInputStateBuilder.cs
index 28d62439..3fb62686 100644
--- a/src/SMAPI/Framework/Input/IInputStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/IInputStateBuilder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.Input
diff --git a/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs b/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
index 09bc48b6..81ca0ebb 100644
--- a/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Microsoft.Xna.Framework.Input;
diff --git a/src/SMAPI/Framework/Input/MouseStateBuilder.cs b/src/SMAPI/Framework/Input/MouseStateBuilder.cs
index c2a0891b..85b38d32 100644
--- a/src/SMAPI/Framework/Input/MouseStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/MouseStateBuilder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Input;
 
diff --git a/src/SMAPI/Framework/Input/SInputState.cs b/src/SMAPI/Framework/Input/SInputState.cs
index 72adca02..37b3c8ef 100644
--- a/src/SMAPI/Framework/Input/SInputState.cs
+++ b/src/SMAPI/Framework/Input/SInputState.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index 54aeffd7..a1d87487 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
index bad69a2a..a0957b90 100644
--- a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
+++ b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.IO;
 using System.Text;
diff --git a/src/SMAPI/Framework/Logging/LogFileManager.cs b/src/SMAPI/Framework/Logging/LogFileManager.cs
index 6ab2bdfb..0b6f9ad2 100644
--- a/src/SMAPI/Framework/Logging/LogFileManager.cs
+++ b/src/SMAPI/Framework/Logging/LogFileManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.IO;
 
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index a8a8b6ee..dab7f554 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI/Framework/ModHelpers/BaseHelper.cs b/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
index 5a3d4bed..1cd1a6b3 100644
--- a/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.ModHelpers
 {
     /// <summary>The common base class for mod helpers.</summary>
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index 69382009..c2b5092e 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework.ModHelpers
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 14aa74c2..e72e397e 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
diff --git a/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
index d39abc7d..336214e2 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Framework/ModHelpers/DataHelper.cs b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
index 4cbfd73f..86a34ee8 100644
--- a/src/SMAPI/Framework/ModHelpers/DataHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
index 0eb385d4..ed0c46d5 100644
--- a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using StardewModdingAPI.Framework.Content;
diff --git a/src/SMAPI/Framework/ModHelpers/InputHelper.cs b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
index 88caf4c3..29f80d87 100644
--- a/src/SMAPI/Framework/ModHelpers/InputHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Framework.Input;
 using StardewModdingAPI.Utilities;
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index 7468cda1..90064354 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Content;
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 5b567ee0..2a8aeb3a 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.IO;
 using StardewModdingAPI.Events;
diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 09a392a6..e277e6fa 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.Reflection;
 
diff --git a/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs b/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
index a7ce8692..96b074e2 100644
--- a/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.Networking;
 using StardewValley;
diff --git a/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs b/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
index 5a4ea742..24cbd01c 100644
--- a/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 using StardewModdingAPI.Framework.Reflection;
diff --git a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
index 869664fe..37345a76 100644
--- a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using StardewValley;
 
diff --git a/src/SMAPI/Framework/ModLinked.cs b/src/SMAPI/Framework/ModLinked.cs
index 8cfe6f5f..5a3e38ca 100644
--- a/src/SMAPI/Framework/ModLinked.cs
+++ b/src/SMAPI/Framework/ModLinked.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework
 {
     /// <summary>A generic tuple which links something to a mod.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
index 8e2f5ef3..1d4ddf72 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Mono.Cecil;
 
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs
index 11be19fc..d2d5d83b 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.ModLoading
 {
     /// <summary>Indicates the result of an assembly load.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 24214c96..070ee803 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs b/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
index b56a776c..56bd5a8b 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.IO;
 using Mono.Cecil;
 
diff --git a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
index 124951a5..7c94beb7 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
index 68415123..96b4098a 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
index d2340f01..7d3c1fd7 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
index 99344848..b2f2e193 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
index 8c1cae2b..81f90498 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
index d305daf4..001d1986 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
index 24ab2eca..4c589ed8 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
index 260a8df8..04a5b970 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
index d5d1b38e..bea786cd 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
index 4f14a579..09ff78f7 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
index d7cb2471..8f47fbdd 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Reflection;
diff --git a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
index d41732f8..126504e3 100644
--- a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/IncompatibleInstructionException.cs b/src/SMAPI/Framework/ModLoading/IncompatibleInstructionException.cs
index 1f9add30..29406f2a 100644
--- a/src/SMAPI/Framework/ModLoading/IncompatibleInstructionException.cs
+++ b/src/SMAPI/Framework/ModLoading/IncompatibleInstructionException.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework.ModLoading
diff --git a/src/SMAPI/Framework/ModLoading/InvalidModStateException.cs b/src/SMAPI/Framework/ModLoading/InvalidModStateException.cs
index 075e237a..9dca9bc4 100644
--- a/src/SMAPI/Framework/ModLoading/InvalidModStateException.cs
+++ b/src/SMAPI/Framework/ModLoading/InvalidModStateException.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework.ModLoading
diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index 9e6bc61f..0e698bfd 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index d52cdbb4..51463048 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs b/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
index d4366294..0898f095 100644
--- a/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
+++ b/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
index be2a1c58..c05005b8 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
index 135bd218..fea8c100 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
index 5162dda4..93124591 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
index 5f68f8d9..20a30f8f 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.CodeAnalysis;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
index cc830216..4985d72a 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
index 857a2230..806fca62 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Reflection;
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
index f715fb6b..92397c58 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using HarmonyLib;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
index 2eee8ff9..fc06e779 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
index 89de437e..4860072c 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
index 9933e2ca..00daf337 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
index ad5cb96f..bdc4c4f3 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
index 2171895d..55b7e0c8 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.IO;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
index d28c4a22..4af7c1e7 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
index 8f7e05d1..c2ac4cd6 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.IO;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
diff --git a/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs b/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
index a4ac54e2..248c29fc 100644
--- a/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
+++ b/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/ModRegistry.cs b/src/SMAPI/Framework/ModRegistry.cs
index c0f8d537..cae38637 100644
--- a/src/SMAPI/Framework/ModRegistry.cs
+++ b/src/SMAPI/Framework/ModRegistry.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 1e78f316..e74d73b5 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Monitor.cs b/src/SMAPI/Framework/Monitor.cs
index 6b53daff..de145d1d 100644
--- a/src/SMAPI/Framework/Monitor.cs
+++ b/src/SMAPI/Framework/Monitor.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Networking/ModMessageModel.cs b/src/SMAPI/Framework/Networking/ModMessageModel.cs
index 4f694f9c..4e7d01eb 100644
--- a/src/SMAPI/Framework/Networking/ModMessageModel.cs
+++ b/src/SMAPI/Framework/Networking/ModMessageModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Linq;
 using Newtonsoft.Json.Linq;
 
diff --git a/src/SMAPI/Framework/Networking/MultiplayerPeer.cs b/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
index 3923700f..8ee5c309 100644
--- a/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
+++ b/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs b/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
index 8087dc7e..6fdb9e54 100644
--- a/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
+++ b/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.Networking
 {
     internal class MultiplayerPeerMod : IMultiplayerPeerMod
diff --git a/src/SMAPI/Framework/Networking/RemoteContextModModel.cs b/src/SMAPI/Framework/Networking/RemoteContextModModel.cs
index 9795d971..0383576c 100644
--- a/src/SMAPI/Framework/Networking/RemoteContextModModel.cs
+++ b/src/SMAPI/Framework/Networking/RemoteContextModModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.Networking
 {
     /// <summary>Metadata about an installed mod exchanged with connected computers.</summary>
diff --git a/src/SMAPI/Framework/Networking/RemoteContextModel.cs b/src/SMAPI/Framework/Networking/RemoteContextModel.cs
index 7befb151..37fafa67 100644
--- a/src/SMAPI/Framework/Networking/RemoteContextModel.cs
+++ b/src/SMAPI/Framework/Networking/RemoteContextModel.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.Networking
 {
     /// <summary>Metadata about the game, SMAPI, and installed mods exchanged with connected computers.</summary>
diff --git a/src/SMAPI/Framework/Networking/SGalaxyNetClient.cs b/src/SMAPI/Framework/Networking/SGalaxyNetClient.cs
index 01095c66..8e19b4a7 100644
--- a/src/SMAPI/Framework/Networking/SGalaxyNetClient.cs
+++ b/src/SMAPI/Framework/Networking/SGalaxyNetClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Galaxy.Api;
 using StardewValley.Network;
diff --git a/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs b/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
index 71e11576..07a004a2 100644
--- a/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
+++ b/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
diff --git a/src/SMAPI/Framework/Networking/SLidgrenClient.cs b/src/SMAPI/Framework/Networking/SLidgrenClient.cs
index 39876744..ecf18cbd 100644
--- a/src/SMAPI/Framework/Networking/SLidgrenClient.cs
+++ b/src/SMAPI/Framework/Networking/SLidgrenClient.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewValley.Network;
 
diff --git a/src/SMAPI/Framework/Networking/SLidgrenServer.cs b/src/SMAPI/Framework/Networking/SLidgrenServer.cs
index ff871e64..c0b247c8 100644
--- a/src/SMAPI/Framework/Networking/SLidgrenServer.cs
+++ b/src/SMAPI/Framework/Networking/SLidgrenServer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
diff --git a/src/SMAPI/Framework/Reflection/CacheEntry.cs b/src/SMAPI/Framework/Reflection/CacheEntry.cs
index 912662e3..6b18d204 100644
--- a/src/SMAPI/Framework/Reflection/CacheEntry.cs
+++ b/src/SMAPI/Framework/Reflection/CacheEntry.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Reflection;
 
 namespace StardewModdingAPI.Framework.Reflection
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index 40adde8e..4c49e219 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Reflection;
 using System.Reflection.Emit;
 using Nanoray.Pintail;
diff --git a/src/SMAPI/Framework/Reflection/ReflectedField.cs b/src/SMAPI/Framework/Reflection/ReflectedField.cs
index 3c4da4fc..921876b9 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedField.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedField.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 
diff --git a/src/SMAPI/Framework/Reflection/ReflectedMethod.cs b/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
index 26112806..50f89b40 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 
diff --git a/src/SMAPI/Framework/Reflection/ReflectedProperty.cs b/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
index 42d7bb59..a6d8c75c 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Reflection;
 
diff --git a/src/SMAPI/Framework/Reflection/Reflector.cs b/src/SMAPI/Framework/Reflection/Reflector.cs
index 3a93ab5d..d5938c3f 100644
--- a/src/SMAPI/Framework/Reflection/Reflector.cs
+++ b/src/SMAPI/Framework/Reflection/Reflector.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using System.Reflection;
diff --git a/src/SMAPI/Framework/Rendering/SDisplayDevice.cs b/src/SMAPI/Framework/Rendering/SDisplayDevice.cs
index 85e69ae6..8718bcb1 100644
--- a/src/SMAPI/Framework/Rendering/SDisplayDevice.cs
+++ b/src/SMAPI/Framework/Rendering/SDisplayDevice.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Content;
diff --git a/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs b/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
index cb499c6b..21edaedd 100644
--- a/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
+++ b/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI/Framework/RequestExitDelegate.cs b/src/SMAPI/Framework/RequestExitDelegate.cs
index 810c399b..93ef1cf9 100644
--- a/src/SMAPI/Framework/RequestExitDelegate.cs
+++ b/src/SMAPI/Framework/RequestExitDelegate.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework
 {
     /// <summary>A delegate which requests that SMAPI immediately exit the game. This should only be invoked when an irrecoverable fatal error happens that risks save corruption or game-breaking bugs.</summary>
diff --git a/src/SMAPI/Framework/SChatBox.cs b/src/SMAPI/Framework/SChatBox.cs
index e000d1cd..d6286c12 100644
--- a/src/SMAPI/Framework/SChatBox.cs
+++ b/src/SMAPI/Framework/SChatBox.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using StardewValley;
 using StardewValley.Menus;
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index b471c383..8a5c10f6 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 989b59d8..7ca89eec 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.ObjectModel;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI/Framework/SGameRunner.cs b/src/SMAPI/Framework/SGameRunner.cs
index 81cac145..dae314af 100644
--- a/src/SMAPI/Framework/SGameRunner.cs
+++ b/src/SMAPI/Framework/SGameRunner.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/SModHooks.cs b/src/SMAPI/Framework/SModHooks.cs
index 101e022a..7941e102 100644
--- a/src/SMAPI/Framework/SModHooks.cs
+++ b/src/SMAPI/Framework/SModHooks.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Threading.Tasks;
 using StardewValley;
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index bcf97006..de3c25a5 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Framework/Serialization/ColorConverter.cs b/src/SMAPI/Framework/Serialization/ColorConverter.cs
index 3b3720b5..8fb6cd9c 100644
--- a/src/SMAPI/Framework/Serialization/ColorConverter.cs
+++ b/src/SMAPI/Framework/Serialization/ColorConverter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI/Framework/Serialization/KeybindConverter.cs b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
index 7c5db3ad..9cf52228 100644
--- a/src/SMAPI/Framework/Serialization/KeybindConverter.cs
+++ b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI/Framework/Serialization/PointConverter.cs b/src/SMAPI/Framework/Serialization/PointConverter.cs
index 21d1f845..b48d757a 100644
--- a/src/SMAPI/Framework/Serialization/PointConverter.cs
+++ b/src/SMAPI/Framework/Serialization/PointConverter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI/Framework/Serialization/RectangleConverter.cs b/src/SMAPI/Framework/Serialization/RectangleConverter.cs
index 31f3ad77..7f060e3a 100644
--- a/src/SMAPI/Framework/Serialization/RectangleConverter.cs
+++ b/src/SMAPI/Framework/Serialization/RectangleConverter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Text.RegularExpressions;
 using Microsoft.Xna.Framework;
diff --git a/src/SMAPI/Framework/Serialization/Vector2Converter.cs b/src/SMAPI/Framework/Serialization/Vector2Converter.cs
index 589febf8..bcd483d3 100644
--- a/src/SMAPI/Framework/Serialization/Vector2Converter.cs
+++ b/src/SMAPI/Framework/Serialization/Vector2Converter.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI/Framework/Singleton.cs b/src/SMAPI/Framework/Singleton.cs
index 1bf318c4..da16c48e 100644
--- a/src/SMAPI/Framework/Singleton.cs
+++ b/src/SMAPI/Framework/Singleton.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework
 {
     /// <summary>Provides singleton instances of a given type.</summary>
diff --git a/src/SMAPI/Framework/SnapshotDiff.cs b/src/SMAPI/Framework/SnapshotDiff.cs
index 5b6288ff..eb2aebe1 100644
--- a/src/SMAPI/Framework/SnapshotDiff.cs
+++ b/src/SMAPI/Framework/SnapshotDiff.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using StardewModdingAPI.Framework.StateTracking;
 
 namespace StardewModdingAPI.Framework
diff --git a/src/SMAPI/Framework/SnapshotItemListDiff.cs b/src/SMAPI/Framework/SnapshotItemListDiff.cs
index e8ab1b1e..97942783 100644
--- a/src/SMAPI/Framework/SnapshotItemListDiff.cs
+++ b/src/SMAPI/Framework/SnapshotItemListDiff.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using StardewModdingAPI.Events;
diff --git a/src/SMAPI/Framework/SnapshotListDiff.cs b/src/SMAPI/Framework/SnapshotListDiff.cs
index 1c3ebfba..1d585c15 100644
--- a/src/SMAPI/Framework/SnapshotListDiff.cs
+++ b/src/SMAPI/Framework/SnapshotListDiff.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.StateTracking;
 
diff --git a/src/SMAPI/Framework/StateTracking/ChestTracker.cs b/src/SMAPI/Framework/StateTracking/ChestTracker.cs
index 56aeeb3c..28335200 100644
--- a/src/SMAPI/Framework/StateTracking/ChestTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/ChestTracker.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/StateTracking/Comparers/EquatableComparer.cs b/src/SMAPI/Framework/StateTracking/Comparers/EquatableComparer.cs
index a96ffdb6..987e1820 100644
--- a/src/SMAPI/Framework/StateTracking/Comparers/EquatableComparer.cs
+++ b/src/SMAPI/Framework/StateTracking/Comparers/EquatableComparer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Runtime.CompilerServices;
diff --git a/src/SMAPI/Framework/StateTracking/Comparers/GenericEqualsComparer.cs b/src/SMAPI/Framework/StateTracking/Comparers/GenericEqualsComparer.cs
index cc1d6553..f6b04583 100644
--- a/src/SMAPI/Framework/StateTracking/Comparers/GenericEqualsComparer.cs
+++ b/src/SMAPI/Framework/StateTracking/Comparers/GenericEqualsComparer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Runtime.CompilerServices;
 
diff --git a/src/SMAPI/Framework/StateTracking/Comparers/ObjectReferenceComparer.cs b/src/SMAPI/Framework/StateTracking/Comparers/ObjectReferenceComparer.cs
index ef9adafb..8d3a7eb9 100644
--- a/src/SMAPI/Framework/StateTracking/Comparers/ObjectReferenceComparer.cs
+++ b/src/SMAPI/Framework/StateTracking/Comparers/ObjectReferenceComparer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Runtime.CompilerServices;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/BaseDisposableWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/BaseDisposableWatcher.cs
index 60006c51..03bf84d9 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/BaseDisposableWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/BaseDisposableWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
index 256370ce..52e1dbad 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
index 5ca4b9f4..4f94294c 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
index 84340fbf..94ce0c8e 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
index 676c9fb4..e662c433 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Netcode;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
index e6882f7e..0d7f2ad2 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Netcode;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
index 0b4d3030..a97e754c 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Netcode;
 using StardewModdingAPI.Framework.StateTracking.Comparers;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
index 48d5d681..26641750 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Netcode;
 
 namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
index 3e9fa8b1..82e5387e 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using System.Collections.Specialized;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
index bde43486..0b99914c 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
diff --git a/src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs
index 7a7759e3..74c9313b 100644
--- a/src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.StateTracking
diff --git a/src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs b/src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs
index 691ed377..81fb7460 100644
--- a/src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.StateTracking
diff --git a/src/SMAPI/Framework/StateTracking/IValueWatcher.cs b/src/SMAPI/Framework/StateTracking/IValueWatcher.cs
index 4afca972..7d46053c 100644
--- a/src/SMAPI/Framework/StateTracking/IValueWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/IValueWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI.Framework.StateTracking
 {
     /// <summary>A watcher which tracks changes to a value.</summary>
diff --git a/src/SMAPI/Framework/StateTracking/IWatcher.cs b/src/SMAPI/Framework/StateTracking/IWatcher.cs
index 8c7fa51c..3603b6f8 100644
--- a/src/SMAPI/Framework/StateTracking/IWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/IWatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI.Framework.StateTracking
diff --git a/src/SMAPI/Framework/StateTracking/LocationTracker.cs b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
index f86f86ee..9c2ff7f0 100644
--- a/src/SMAPI/Framework/StateTracking/LocationTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/StateTracking/PlayerTracker.cs b/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
index 3d470b5c..367eafea 100644
--- a/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
index 2563d10c..3d13f92b 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Microsoft.Xna.Framework;
 using StardewValley;
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
index e113d27c..bf81a35e 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
index afea7fb4..1d43ef26 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Microsoft.Xna.Framework;
 using StardewValley;
 using StardewValley.Menus;
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
index 7dee09ca..88aac0df 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Linq;
 using StardewModdingAPI.Framework.StateTracking.Comparers;
diff --git a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
index e968d79c..ab02d7d5 100644
--- a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using System.Linq;
diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
index c0f119f1..5f0ecfa0 100644
--- a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 // This temporary utility fixes an esoteric issue in XNA Framework where deserialization depends on
 // the order of fields returned by Type.GetFields, but that order changes after Harmony/MonoMod use
 // reflection to access the fields due to an issue in .NET Framework.
diff --git a/src/SMAPI/Framework/Translator.cs b/src/SMAPI/Framework/Translator.cs
index 4492b17f..144b043c 100644
--- a/src/SMAPI/Framework/Translator.cs
+++ b/src/SMAPI/Framework/Translator.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Utilities/ContextHash.cs b/src/SMAPI/Framework/Utilities/ContextHash.cs
index 6c0fdc90..46b9099e 100644
--- a/src/SMAPI/Framework/Utilities/ContextHash.cs
+++ b/src/SMAPI/Framework/Utilities/ContextHash.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI/Framework/Utilities/Countdown.cs b/src/SMAPI/Framework/Utilities/Countdown.cs
index 342b4258..94c69e73 100644
--- a/src/SMAPI/Framework/Utilities/Countdown.cs
+++ b/src/SMAPI/Framework/Utilities/Countdown.cs
@@ -1,4 +1,4 @@
-namespace StardewModdingAPI.Framework.Utilities
+namespace StardewModdingAPI.Framework.Utilities
 {
     /// <summary>Counts down from a baseline value.</summary>
     internal class Countdown
diff --git a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
index d0f276d2..94ce0069 100644
--- a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
+++ b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI/Framework/WatcherCore.cs b/src/SMAPI/Framework/WatcherCore.cs
index a1612e75..bd8d3367 100644
--- a/src/SMAPI/Framework/WatcherCore.cs
+++ b/src/SMAPI/Framework/WatcherCore.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using Microsoft.Xna.Framework;
diff --git a/src/SMAPI/GamePlatform.cs b/src/SMAPI/GamePlatform.cs
index cce5ed8d..8013faa9 100644
--- a/src/SMAPI/GamePlatform.cs
+++ b/src/SMAPI/GamePlatform.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IAssetData.cs b/src/SMAPI/IAssetData.cs
index 8df59e53..f07340e4 100644
--- a/src/SMAPI/IAssetData.cs
+++ b/src/SMAPI/IAssetData.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IAssetDataForDictionary.cs b/src/SMAPI/IAssetDataForDictionary.cs
index 1136316f..82ba25cb 100644
--- a/src/SMAPI/IAssetDataForDictionary.cs
+++ b/src/SMAPI/IAssetDataForDictionary.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IAssetDataForImage.cs b/src/SMAPI/IAssetDataForImage.cs
index 27ed9267..388caa68 100644
--- a/src/SMAPI/IAssetDataForImage.cs
+++ b/src/SMAPI/IAssetDataForImage.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/IAssetDataForMap.cs b/src/SMAPI/IAssetDataForMap.cs
index 47a33de8..89ee28f2 100644
--- a/src/SMAPI/IAssetDataForMap.cs
+++ b/src/SMAPI/IAssetDataForMap.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using Microsoft.Xna.Framework;
 using xTile;
 
diff --git a/src/SMAPI/IAssetEditor.cs b/src/SMAPI/IAssetEditor.cs
index 9f22ed83..f3d91bd0 100644
--- a/src/SMAPI/IAssetEditor.cs
+++ b/src/SMAPI/IAssetEditor.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/IAssetInfo.cs b/src/SMAPI/IAssetInfo.cs
index 64d10b35..5b4ac479 100644
--- a/src/SMAPI/IAssetInfo.cs
+++ b/src/SMAPI/IAssetInfo.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IAssetLoader.cs b/src/SMAPI/IAssetLoader.cs
index 96b98793..0d52a481 100644
--- a/src/SMAPI/IAssetLoader.cs
+++ b/src/SMAPI/IAssetLoader.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/IAssetName.cs b/src/SMAPI/IAssetName.cs
index c91da266..22f5c6b7 100644
--- a/src/SMAPI/IAssetName.cs
+++ b/src/SMAPI/IAssetName.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewValley;
 
diff --git a/src/SMAPI/ICommandHelper.cs b/src/SMAPI/ICommandHelper.cs
index 9f1c345c..a0c524d6 100644
--- a/src/SMAPI/ICommandHelper.cs
+++ b/src/SMAPI/ICommandHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IContentHelper.cs b/src/SMAPI/IContentHelper.cs
index 48f6bfd8..0ad209ab 100644
--- a/src/SMAPI/IContentHelper.cs
+++ b/src/SMAPI/IContentHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.Contracts;
diff --git a/src/SMAPI/IContentPack.cs b/src/SMAPI/IContentPack.cs
index 3c66faff..f853e2b4 100644
--- a/src/SMAPI/IContentPack.cs
+++ b/src/SMAPI/IContentPack.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/IContentPackHelper.cs b/src/SMAPI/IContentPackHelper.cs
index c48a4f86..5464df22 100644
--- a/src/SMAPI/IContentPackHelper.cs
+++ b/src/SMAPI/IContentPackHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/ICursorPosition.cs b/src/SMAPI/ICursorPosition.cs
index 99c1b84d..da6cbb62 100644
--- a/src/SMAPI/ICursorPosition.cs
+++ b/src/SMAPI/ICursorPosition.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework;
 using StardewValley;
diff --git a/src/SMAPI/IDataHelper.cs b/src/SMAPI/IDataHelper.cs
index 901266d7..4c96367b 100644
--- a/src/SMAPI/IDataHelper.cs
+++ b/src/SMAPI/IDataHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IGameContentHelper.cs b/src/SMAPI/IGameContentHelper.cs
index 86bc3e0e..4b967993 100644
--- a/src/SMAPI/IGameContentHelper.cs
+++ b/src/SMAPI/IGameContentHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/IInputHelper.cs b/src/SMAPI/IInputHelper.cs
index 2b907b0d..b7ed0838 100644
--- a/src/SMAPI/IInputHelper.cs
+++ b/src/SMAPI/IInputHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using StardewModdingAPI.Utilities;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IMod.cs b/src/SMAPI/IMod.cs
index 44ef32c9..0de4961e 100644
--- a/src/SMAPI/IMod.cs
+++ b/src/SMAPI/IMod.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI
 {
     /// <summary>The implementation for a Stardew Valley mod.</summary>
diff --git a/src/SMAPI/IModContentHelper.cs b/src/SMAPI/IModContentHelper.cs
index e3431365..815d6848 100644
--- a/src/SMAPI/IModContentHelper.cs
+++ b/src/SMAPI/IModContentHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/IModHelper.cs b/src/SMAPI/IModHelper.cs
index 15e4ed8d..5e4246aa 100644
--- a/src/SMAPI/IModHelper.cs
+++ b/src/SMAPI/IModHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/IModInfo.cs b/src/SMAPI/IModInfo.cs
index 3c85d454..2788e4fc 100644
--- a/src/SMAPI/IModInfo.cs
+++ b/src/SMAPI/IModInfo.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI
 {
     /// <summary>Metadata for a loaded mod.</summary>
diff --git a/src/SMAPI/IModLinked.cs b/src/SMAPI/IModLinked.cs
index 172ee30c..cf08c9c5 100644
--- a/src/SMAPI/IModLinked.cs
+++ b/src/SMAPI/IModLinked.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI
 {
     /// <summary>An instance linked to a mod.</summary>
diff --git a/src/SMAPI/IModRegistry.cs b/src/SMAPI/IModRegistry.cs
index 10b3121e..9cab08a1 100644
--- a/src/SMAPI/IModRegistry.cs
+++ b/src/SMAPI/IModRegistry.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IMonitor.cs b/src/SMAPI/IMonitor.cs
index c400a211..535f56e3 100644
--- a/src/SMAPI/IMonitor.cs
+++ b/src/SMAPI/IMonitor.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI
 {
     /// <summary>Encapsulates monitoring and logging for a given module.</summary>
diff --git a/src/SMAPI/IMultiplayerHelper.cs b/src/SMAPI/IMultiplayerHelper.cs
index 4067a676..77a0f3f4 100644
--- a/src/SMAPI/IMultiplayerHelper.cs
+++ b/src/SMAPI/IMultiplayerHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using StardewValley;
diff --git a/src/SMAPI/IMultiplayerPeer.cs b/src/SMAPI/IMultiplayerPeer.cs
index 47084174..e487f100 100644
--- a/src/SMAPI/IMultiplayerPeer.cs
+++ b/src/SMAPI/IMultiplayerPeer.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IMultiplayerPeerMod.cs b/src/SMAPI/IMultiplayerPeerMod.cs
index 005408b1..81978bef 100644
--- a/src/SMAPI/IMultiplayerPeerMod.cs
+++ b/src/SMAPI/IMultiplayerPeerMod.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 namespace StardewModdingAPI
 {
     /// <summary>Metadata about a mod installed by a connected player.</summary>
diff --git a/src/SMAPI/IReflectedField.cs b/src/SMAPI/IReflectedField.cs
index 7ff61f29..94dbe6a3 100644
--- a/src/SMAPI/IReflectedField.cs
+++ b/src/SMAPI/IReflectedField.cs
@@ -1,4 +1,6 @@
-using System.Reflection;
+#nullable disable
+
+using System.Reflection;
 
 namespace StardewModdingAPI
 {
diff --git a/src/SMAPI/IReflectedMethod.cs b/src/SMAPI/IReflectedMethod.cs
index 646e7301..78e66cb1 100644
--- a/src/SMAPI/IReflectedMethod.cs
+++ b/src/SMAPI/IReflectedMethod.cs
@@ -1,4 +1,6 @@
-using System.Reflection;
+#nullable disable
+
+using System.Reflection;
 
 namespace StardewModdingAPI
 {
diff --git a/src/SMAPI/IReflectedProperty.cs b/src/SMAPI/IReflectedProperty.cs
index 73ad9f30..edbf0b21 100644
--- a/src/SMAPI/IReflectedProperty.cs
+++ b/src/SMAPI/IReflectedProperty.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Reflection;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IReflectionHelper.cs b/src/SMAPI/IReflectionHelper.cs
index a2b9eb32..bf7270cf 100644
--- a/src/SMAPI/IReflectionHelper.cs
+++ b/src/SMAPI/IReflectionHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/ITranslationHelper.cs b/src/SMAPI/ITranslationHelper.cs
index b30d9b14..3c297731 100644
--- a/src/SMAPI/ITranslationHelper.cs
+++ b/src/SMAPI/ITranslationHelper.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using StardewValley;
 
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 159e19fd..b7cec72c 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 367372b2..5617fd13 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Events;
diff --git a/src/SMAPI/Mod.cs b/src/SMAPI/Mod.cs
index 9af55cd4..2b3750d5 100644
--- a/src/SMAPI/Mod.cs
+++ b/src/SMAPI/Mod.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/Patches/Game1Patcher.cs b/src/SMAPI/Patches/Game1Patcher.cs
index 173a2055..c5d98e9e 100644
--- a/src/SMAPI/Patches/Game1Patcher.cs
+++ b/src/SMAPI/Patches/Game1Patcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
diff --git a/src/SMAPI/Patches/TitleMenuPatcher.cs b/src/SMAPI/Patches/TitleMenuPatcher.cs
index b4320ce0..56e5597c 100644
--- a/src/SMAPI/Patches/TitleMenuPatcher.cs
+++ b/src/SMAPI/Patches/TitleMenuPatcher.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 1039cc9a..a8664160 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/SemanticVersion.cs b/src/SMAPI/SemanticVersion.cs
index ae616419..4e484633 100644
--- a/src/SMAPI/SemanticVersion.cs
+++ b/src/SMAPI/SemanticVersion.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using Newtonsoft.Json;
 
diff --git a/src/SMAPI/Translation.cs b/src/SMAPI/Translation.cs
index 5ab432f0..ef98a00f 100644
--- a/src/SMAPI/Translation.cs
+++ b/src/SMAPI/Translation.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections;
 using System.Collections.Generic;
diff --git a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs b/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
index 1d947b53..4596fdce 100644
--- a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
+++ b/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Utilities/Keybind.cs b/src/SMAPI/Utilities/Keybind.cs
index 7aefe686..7b1acf1d 100644
--- a/src/SMAPI/Utilities/Keybind.cs
+++ b/src/SMAPI/Utilities/Keybind.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
index f24976f7..7b2c396b 100644
--- a/src/SMAPI/Utilities/KeybindList.cs
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Utilities/PathUtilities.cs b/src/SMAPI/Utilities/PathUtilities.cs
index 541b163c..e8ab9645 100644
--- a/src/SMAPI/Utilities/PathUtilities.cs
+++ b/src/SMAPI/Utilities/PathUtilities.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System.Diagnostics.Contracts;
 using ToolkitPathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 6b7153ac..afe3ba91 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Utilities/SDate.cs b/src/SMAPI/Utilities/SDate.cs
index e10a59f8..b10bc3da 100644
--- a/src/SMAPI/Utilities/SDate.cs
+++ b/src/SMAPI/Utilities/SDate.cs
@@ -1,3 +1,5 @@
+#nullable disable
+
 using System;
 using System.Linq;
 using Newtonsoft.Json;

From b4e979cc991a0c2a45ad986210108edd2d43e43d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 22:46:19 -0400
Subject: [PATCH 504/856] fix all warnings to simplify migration to nullable
 annotations (#837)

---
 docs/technical/mod-package.md                 |  1 +
 .../Framework/DiagnosticVerifier.Helper.cs    | 24 +++++++--------
 .../Framework/DiagnosticVerifier.cs           | 30 +++++++++----------
 .../AnalyzerReleases.Shipped.md               |  7 +++++
 .../SMAPI.ModBuildConfig.Analyzer.csproj      |  4 +++
 .../SMAPI.ModBuildConfig.csproj               |  1 +
 src/SMAPI.Tests/Core/AssetNameTests.cs        |  1 -
 src/SMAPI/Framework/ContentCoordinator.cs     |  2 ++
 .../ContentManagers/IContentManager.cs        |  1 +
 src/SMAPI/Framework/ModHelpers/ModHelper.cs   | 10 ++++++-
 src/SMAPI/Framework/SCore.cs                  |  4 +++
 11 files changed, 56 insertions(+), 29 deletions(-)
 create mode 100644 src/SMAPI.ModBuildConfig.Analyzer/AnalyzerReleases.Shipped.md

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 5e408168..4c31f69b 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -414,6 +414,7 @@ when you compile it.
 ## Release notes
 ## Upcoming release
 * Added detection for Xbox app game folders.
+* Internal refactoring.
 
 ## 4.0.0
 Released 30 November 2021.
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
index 8d72fea1..68a892a9 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
@@ -53,17 +53,17 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
         protected static Diagnostic[] GetSortedDiagnosticsFromDocuments(DiagnosticAnalyzer analyzer, Document[] documents)
         {
             var projects = new HashSet<Project>();
-            foreach (var document in documents)
+            foreach (Document document in documents)
             {
                 projects.Add(document.Project);
             }
 
             var diagnostics = new List<Diagnostic>();
-            foreach (var project in projects)
+            foreach (Project project in projects)
             {
-                var compilationWithAnalyzers = project.GetCompilationAsync().Result.WithAnalyzers(ImmutableArray.Create(analyzer));
+                CompilationWithAnalyzers compilationWithAnalyzers = project.GetCompilationAsync().Result.WithAnalyzers(ImmutableArray.Create(analyzer));
                 var diags = compilationWithAnalyzers.GetAnalyzerDiagnosticsAsync().Result;
-                foreach (var diag in diags)
+                foreach (Diagnostic diag in diags)
                 {
                     if (diag.Location == Location.None || diag.Location.IsInMetadata)
                     {
@@ -73,8 +73,8 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                     {
                         for (int i = 0; i < documents.Length; i++)
                         {
-                            var document = documents[i];
-                            var tree = document.GetSyntaxTreeAsync().Result;
+                            Document document = documents[i];
+                            SyntaxTree tree = document.GetSyntaxTreeAsync().Result;
                             if (tree == diag.Location.SourceTree)
                             {
                                 diagnostics.Add(diag);
@@ -115,7 +115,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                 throw new ArgumentException("Unsupported Language");
             }
 
-            var project = CreateProject(sources, language);
+            Project project = CreateProject(sources, language);
             var documents = project.Documents.ToArray();
 
             if (sources.Length != documents.Length)
@@ -148,9 +148,9 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
             string fileNamePrefix = DefaultFilePathPrefix;
             string fileExt = language == LanguageNames.CSharp ? CSharpDefaultFileExt : VisualBasicDefaultExt;
 
-            var projectId = ProjectId.CreateNewId(debugName: TestProjectName);
+            ProjectId projectId = ProjectId.CreateNewId(debugName: TestProjectName);
 
-            var solution = new AdhocWorkspace()
+            Solution solution = new AdhocWorkspace()
                 .CurrentSolution
                 .AddProject(projectId, TestProjectName, TestProjectName, language)
                 .AddMetadataReference(projectId, DiagnosticVerifier.SelfReference)
@@ -160,10 +160,10 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                 .AddMetadataReference(projectId, CodeAnalysisReference);
 
             int count = 0;
-            foreach (var source in sources)
+            foreach (string source in sources)
             {
-                var newFileName = fileNamePrefix + count + "." + fileExt;
-                var documentId = DocumentId.CreateNewId(projectId, debugName: newFileName);
+                string newFileName = fileNamePrefix + count + "." + fileExt;
+                DocumentId documentId = DocumentId.CreateNewId(projectId, debugName: newFileName);
                 solution = solution.AddDocument(documentId, newFileName, SourceText.From(source));
                 count++;
             }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
index 09d3a3f8..4170042d 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
@@ -43,7 +43,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
         /// <param name="expected"> DiagnosticResults that should appear after the analyzer is run on the source</param>
         protected void VerifyCSharpDiagnostic(string source, params DiagnosticResult[] expected)
         {
-            VerifyDiagnostics(new[] { source }, LanguageNames.CSharp, GetCSharpDiagnosticAnalyzer(), expected);
+            this.VerifyDiagnostics(new[] { source }, LanguageNames.CSharp, this.GetCSharpDiagnosticAnalyzer(), expected);
         }
 
         /// <summary>
@@ -54,7 +54,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
         /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources</param>
         protected void VerifyCSharpDiagnostic(string[] sources, params DiagnosticResult[] expected)
         {
-            VerifyDiagnostics(sources, LanguageNames.CSharp, GetCSharpDiagnosticAnalyzer(), expected);
+            this.VerifyDiagnostics(sources, LanguageNames.CSharp, this.GetCSharpDiagnosticAnalyzer(), expected);
         }
 
         /// <summary>
@@ -67,8 +67,8 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
         /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources</param>
         private void VerifyDiagnostics(string[] sources, string language, DiagnosticAnalyzer analyzer, params DiagnosticResult[] expected)
         {
-            var diagnostics = GetSortedDiagnostics(sources, language, analyzer);
-            VerifyDiagnosticResults(diagnostics, analyzer, expected);
+            var diagnostics = DiagnosticVerifier.GetSortedDiagnostics(sources, language, analyzer);
+            DiagnosticVerifier.VerifyDiagnosticResults(diagnostics, analyzer, expected);
         }
 
         #endregion
@@ -88,7 +88,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
 
             if (expectedCount != actualCount)
             {
-                string diagnosticsOutput = actualResults.Any() ? FormatDiagnostics(analyzer, actualResults.ToArray()) : "    NONE.";
+                string diagnosticsOutput = actualResults.Any() ? DiagnosticVerifier.FormatDiagnostics(analyzer, actualResults.ToArray()) : "    NONE.";
 
                 Assert.IsTrue(false,
                     string.Format("Mismatch between number of diagnostics returned, expected \"{0}\" actual \"{1}\"\r\n\r\nDiagnostics:\r\n{2}\r\n", expectedCount, actualCount, diagnosticsOutput));
@@ -105,12 +105,12 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                     {
                         Assert.IsTrue(false,
                             string.Format("Expected:\nA project diagnostic with No location\nActual:\n{0}",
-                            FormatDiagnostics(analyzer, actual)));
+                            DiagnosticVerifier.FormatDiagnostics(analyzer, actual)));
                     }
                 }
                 else
                 {
-                    VerifyDiagnosticLocation(analyzer, actual, actual.Location, expected.Locations.First());
+                    DiagnosticVerifier.VerifyDiagnosticLocation(analyzer, actual, actual.Location, expected.Locations.First());
                     var additionalLocations = actual.AdditionalLocations.ToArray();
 
                     if (additionalLocations.Length != expected.Locations.Length - 1)
@@ -118,12 +118,12 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                         Assert.IsTrue(false,
                             string.Format("Expected {0} additional locations but got {1} for Diagnostic:\r\n    {2}\r\n",
                                 expected.Locations.Length - 1, additionalLocations.Length,
-                                FormatDiagnostics(analyzer, actual)));
+                                DiagnosticVerifier.FormatDiagnostics(analyzer, actual)));
                     }
 
                     for (int j = 0; j < additionalLocations.Length; ++j)
                     {
-                        VerifyDiagnosticLocation(analyzer, actual, additionalLocations[j], expected.Locations[j + 1]);
+                        DiagnosticVerifier.VerifyDiagnosticLocation(analyzer, actual, additionalLocations[j], expected.Locations[j + 1]);
                     }
                 }
 
@@ -131,21 +131,21 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                 {
                     Assert.IsTrue(false,
                         string.Format("Expected diagnostic id to be \"{0}\" was \"{1}\"\r\n\r\nDiagnostic:\r\n    {2}\r\n",
-                            expected.Id, actual.Id, FormatDiagnostics(analyzer, actual)));
+                            expected.Id, actual.Id, DiagnosticVerifier.FormatDiagnostics(analyzer, actual)));
                 }
 
                 if (actual.Severity != expected.Severity)
                 {
                     Assert.IsTrue(false,
                         string.Format("Expected diagnostic severity to be \"{0}\" was \"{1}\"\r\n\r\nDiagnostic:\r\n    {2}\r\n",
-                            expected.Severity, actual.Severity, FormatDiagnostics(analyzer, actual)));
+                            expected.Severity, actual.Severity, DiagnosticVerifier.FormatDiagnostics(analyzer, actual)));
                 }
 
                 if (actual.GetMessage() != expected.Message)
                 {
                     Assert.IsTrue(false,
                         string.Format("Expected diagnostic message to be \"{0}\" was \"{1}\"\r\n\r\nDiagnostic:\r\n    {2}\r\n",
-                            expected.Message, actual.GetMessage(), FormatDiagnostics(analyzer, actual)));
+                            expected.Message, actual.GetMessage(), DiagnosticVerifier.FormatDiagnostics(analyzer, actual)));
                 }
             }
         }
@@ -163,7 +163,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
 
             Assert.IsTrue(actualSpan.Path == expected.Path || (actualSpan.Path != null && actualSpan.Path.Contains("Test0.") && expected.Path.Contains("Test.")),
                 string.Format("Expected diagnostic to be in file \"{0}\" was actually in file \"{1}\"\r\n\r\nDiagnostic:\r\n    {2}\r\n",
-                    expected.Path, actualSpan.Path, FormatDiagnostics(analyzer, diagnostic)));
+                    expected.Path, actualSpan.Path, DiagnosticVerifier.FormatDiagnostics(analyzer, diagnostic)));
 
             var actualLinePosition = actualSpan.StartLinePosition;
 
@@ -174,7 +174,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                 {
                     Assert.IsTrue(false,
                         string.Format("Expected diagnostic to be on line \"{0}\" was actually on line \"{1}\"\r\n\r\nDiagnostic:\r\n    {2}\r\n",
-                            expected.Line, actualLinePosition.Line + 1, FormatDiagnostics(analyzer, diagnostic)));
+                            expected.Line, actualLinePosition.Line + 1, DiagnosticVerifier.FormatDiagnostics(analyzer, diagnostic)));
                 }
             }
 
@@ -185,7 +185,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                 {
                     Assert.IsTrue(false,
                         string.Format("Expected diagnostic to start at column \"{0}\" was actually at column \"{1}\"\r\n\r\nDiagnostic:\r\n    {2}\r\n",
-                            expected.Column, actualLinePosition.Character + 1, FormatDiagnostics(analyzer, diagnostic)));
+                            expected.Column, actualLinePosition.Character + 1, DiagnosticVerifier.FormatDiagnostics(analyzer, diagnostic)));
                 }
             }
         }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerReleases.Shipped.md b/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerReleases.Shipped.md
new file mode 100644
index 00000000..9a46676d
--- /dev/null
+++ b/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerReleases.Shipped.md
@@ -0,0 +1,7 @@
+## Release 2.1.0
+### New Rules
+Rule ID                   | Category           | Severity | Notes
+------------------------- | ------------------ | -------- | ------------------------------------------------------------
+AvoidImplicitNetFieldCast | SMAPI.CommonErrors | Warning  | See [documentation](https://smapi.io/package/code-warnings).
+AvoidNetField             | SMAPI.CommonErrors | Warning  | See [documentation](https://smapi.io/package/code-warnings).
+AvoidObsoleteField        | SMAPI.CommonErrors | Warning  | See [documentation](https://smapi.io/package/code-warnings).
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj b/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
index 3fadc37a..7ac3277e 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
@@ -12,6 +12,10 @@
     <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="3.10.0" />
   </ItemGroup>
 
+  <ItemGroup>
+    <AdditionalFiles Include="AnalyzerReleases.Shipped.md" />
+  </ItemGroup>
+
   <ItemGroup>
     <None Include="$(OutputPath)\$(AssemblyName).dll" Pack="true" PackagePath="analyzers/dotnet/cs" Visible="false" />
   </ItemGroup>
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 0bc8c45e..82eac7f6 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -5,6 +5,7 @@
     <TargetFramework>netstandard2.0</TargetFramework>
     <LangVersion>latest</LangVersion>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
+    <SuppressDependenciesWhenPacking>true</SuppressDependenciesWhenPacking>
 
     <!--NuGet package-->
     <PackageId>Pathoschild.Stardew.ModBuildConfig</PackageId>
diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index b7e34191..ef8a08ef 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -34,7 +34,6 @@ namespace SMAPI.Tests.Core
             name = PathUtilities.NormalizeAssetName(name);
 
             // act
-            string calledWithLocale = null;
             IAssetName assetName = AssetName.Parse(name, parseLocale: _ => expectedLanguageCode);
 
             // assert
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index bfde649a..81820b05 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -610,6 +610,7 @@ namespace StardewModdingAPI.Framework
                 yield return group;
 
             // legacy load operations
+#pragma warning disable CS0612, CS0618 // deprecated code
             foreach (ModLinked<IAssetLoader> loader in this.Loaders)
             {
                 // check if loader applies
@@ -695,6 +696,7 @@ namespace StardewModdingAPI.Framework
                     }
                 );
             }
+#pragma warning restore CS0612, CS0618
         }
 
         /// <summary>Get an asset info compatible with legacy <see cref="IAssetLoader"/> and <see cref="IAssetEditor"/> instances, which always expect the base name.</summary>
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index c4625761..c8b2ae64 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -38,6 +38,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Load an asset through the content pipeline, using a localized variant of the <paramref name="assetName"/> if available.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="language">The language for which to load the asset.</param>
         /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
         T LoadLocalized<T>(IAssetName assetName, LocalizedContentManager.LanguageCode language, bool useCache);
 
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 2a8aeb3a..3cfe52bf 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -95,7 +95,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="translationHelper">An API for reading translations stored in the mod's <c>i18n</c> folder.</param>
         /// <exception cref="ArgumentNullException">An argument is null or empty.</exception>
         /// <exception cref="InvalidOperationException">The <paramref name="modDirectory"/> path does not exist on disk.</exception>
-        public ModHelper(string modID, string modDirectory, Func<SInputState> currentInputState, IModEvents events, ContentHelper contentHelper, IGameContentHelper gameContentHelper, IModContentHelper modContentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper)
+        public ModHelper(
+            string modID, string modDirectory, Func<SInputState> currentInputState, IModEvents events,
+#pragma warning disable CS0612 // deprecated code
+            ContentHelper contentHelper,
+#pragma warning restore CS0612
+            IGameContentHelper gameContentHelper, IModContentHelper modContentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper
+        )
             : base(modID)
         {
             // validate directory
@@ -106,7 +112,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             // initialize
             this.DirectoryPath = modDirectory;
+#pragma warning disable CS0612 // deprecated code
             this.ContentImpl = contentHelper ?? throw new ArgumentNullException(nameof(contentHelper));
+#pragma warning restore CS0612
             this.GameContent = gameContentHelper ?? throw new ArgumentNullException(nameof(gameContentHelper));
             this.ModContent = modContentHelper ?? throw new ArgumentNullException(nameof(modContentHelper));
             this.ContentPacks = contentPackHelper ?? throw new ArgumentNullException(nameof(contentPackHelper));
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 8a5c10f6..6ca463a2 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1593,6 +1593,7 @@ namespace StardewModdingAPI.Framework
 
             // initialize loaded non-content-pack mods
             this.Monitor.Log("Launching mods...", LogLevel.Debug);
+#pragma warning disable CS0612, CS0618 // deprecated code
             foreach (IModMetadata metadata in loadedMods)
             {
                 // add interceptors
@@ -1628,6 +1629,7 @@ namespace StardewModdingAPI.Framework
                     content.ObservableAssetEditors.CollectionChanged += (_, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetEditor>(), e.OldItems?.Cast<IAssetEditor>(), this.ContentCore.Editors);
                     content.ObservableAssetLoaders.CollectionChanged += (_, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetLoader>(), e.OldItems?.Cast<IAssetLoader>(), this.ContentCore.Loaders);
                 }
+#pragma warning restore CS0612, CS0618
 
                 // call entry method
                 try
@@ -1847,7 +1849,9 @@ namespace StardewModdingAPI.Framework
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
                         CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
+#pragma warning disable CS0612 // deprecated code
                         ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor);
+#pragma warning restore CS0612
                         GameContentHelper gameContentHelper = new(contentCore, manifest.UniqueID, mod.DisplayName, monitor);
                         IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache);
                         IContentPackHelper contentPackHelper = new ContentPackHelper(manifest.UniqueID, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);

From d1a7194bf604ac9f960c45de0c82e6eaddd5ff5a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Apr 2022 23:47:12 -0400
Subject: [PATCH 505/856] allow null values in ISemanticVersion compare methods
 (#837)

---
 docs/release-notes.md                         |  1 +
 .../Utilities/SemanticVersionTests.cs         | 39 ++++++++++++++-----
 src/SMAPI.Toolkit/SemanticVersion.cs          | 27 ++++++++++---
 3 files changed, 52 insertions(+), 15 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 732cd530..96a236ad 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -32,6 +32,7 @@
     _This adds methods for working with asset names, parsed locales, etc._
   * Added `helper.Content.ParseAssetName` to get an `IAssetName` for an arbitrary asset key.
   * If an asset is loaded multiple times in the same tick, `IAssetLoader.CanLoad` and `IAssetEditor.CanEdit` are now cached unless invalidated by `helper.Content.InvalidateCache`.
+  * The `ISemanticVersion` comparison methods (`CompareTo`, `IsBetween`, `IsNewerThan`, and `IsOlderThan`) now allow null values. A null version is always considered smaller than any non-null version per [best practices](https://docs.microsoft.com/en-us/dotnet/api/system.icomparable-1.compareto#remarks).
   * Fixed the `SDate` constructor being case-sensitive.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
diff --git a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
index 66181ea6..599ac839 100644
--- a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
+++ b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
@@ -219,11 +219,16 @@ namespace SMAPI.Tests.Utilities
         [TestCase("1.0-beta.2", "1.0-beta.1", ExpectedResult = 1)]
         [TestCase("1.0-beta.10", "1.0-beta.2", ExpectedResult = 1)]
         [TestCase("1.0-beta-10", "1.0-beta-2", ExpectedResult = 1)]
+
+        // null
+        [TestCase("1.0.0", null, ExpectedResult = 1)] // null is always less than any value per CompareTo remarks
         public int CompareTo(string versionStrA, string versionStrB)
         {
             // arrange
             ISemanticVersion versionA = new SemanticVersion(versionStrA);
-            ISemanticVersion versionB = new SemanticVersion(versionStrB);
+            ISemanticVersion versionB = versionStrB != null
+                ? new SemanticVersion(versionStrB)
+                : null;
 
             // assert
             return versionA.CompareTo(versionB);
@@ -262,14 +267,19 @@ namespace SMAPI.Tests.Utilities
         [TestCase("1.0-beta.2", "1.0-beta.1", ExpectedResult = false)]
         [TestCase("1.0-beta.10", "1.0-beta.2", ExpectedResult = false)]
         [TestCase("1.0-beta-10", "1.0-beta-2", ExpectedResult = false)]
+
+        // null
+        [TestCase("1.0.0", null, ExpectedResult = false)] // null is always less than any value per CompareTo remarks
         public bool IsOlderThan(string versionStrA, string versionStrB)
         {
             // arrange
             ISemanticVersion versionA = new SemanticVersion(versionStrA);
-            ISemanticVersion versionB = new SemanticVersion(versionStrB);
+            ISemanticVersion versionB = versionStrB != null
+                ? new SemanticVersion(versionStrB)
+                : null;
 
             // assert
-            Assert.AreEqual(versionA.IsOlderThan(versionB), versionA.IsOlderThan(versionB.ToString()), "The two signatures returned different results.");
+            Assert.AreEqual(versionA.IsOlderThan(versionB), versionA.IsOlderThan(versionB?.ToString()), "The two signatures returned different results.");
             return versionA.IsOlderThan(versionB);
         }
 
@@ -306,14 +316,19 @@ namespace SMAPI.Tests.Utilities
         [TestCase("1.0-beta.2", "1.0-beta.1", ExpectedResult = true)]
         [TestCase("1.0-beta.10", "1.0-beta.2", ExpectedResult = true)]
         [TestCase("1.0-beta-10", "1.0-beta-2", ExpectedResult = true)]
+
+        // null
+        [TestCase("1.0.0", null, ExpectedResult = true)] // null is always less than any value per CompareTo remarks
         public bool IsNewerThan(string versionStrA, string versionStrB)
         {
             // arrange
             ISemanticVersion versionA = new SemanticVersion(versionStrA);
-            ISemanticVersion versionB = new SemanticVersion(versionStrB);
+            ISemanticVersion versionB = versionStrB != null
+                ? new SemanticVersion(versionStrB)
+                : null;
 
             // assert
-            Assert.AreEqual(versionA.IsNewerThan(versionB), versionA.IsNewerThan(versionB.ToString()), "The two signatures returned different results.");
+            Assert.AreEqual(versionA.IsNewerThan(versionB), versionA.IsNewerThan(versionB?.ToString()), "The two signatures returned different results.");
             return versionA.IsNewerThan(versionB);
         }
 
@@ -324,7 +339,7 @@ namespace SMAPI.Tests.Utilities
         /// <param name="versionStr">The main version.</param>
         /// <param name="lowerStr">The lower version number.</param>
         /// <param name="upperStr">The upper version number.</param>
-        [Test(Description = "Assert that version.IsNewerThan returns the expected value.")]
+        [Test(Description = "Assert that version.IsBetween returns the expected value.")]
         // is between
         [TestCase("0.5.7-beta.3", "0.5.7-beta.3", "0.5.7-beta.3", ExpectedResult = true)]
         [TestCase("1.0", "1.0", "1.1", ExpectedResult = true)]
@@ -332,6 +347,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase("1.0", "0.5", "1.1", ExpectedResult = true)]
         [TestCase("1.0-beta.2", "1.0-beta.1", "1.0-beta.3", ExpectedResult = true)]
         [TestCase("1.0-beta-2", "1.0-beta-1", "1.0-beta-3", ExpectedResult = true)]
+        [TestCase("1.0.0", null, "1.0.0", ExpectedResult = true)] // null is always less than any value per CompareTo remarks
 
         // is not between
         [TestCase("1.0-beta", "1.0", "1.1", ExpectedResult = false)]
@@ -339,15 +355,20 @@ namespace SMAPI.Tests.Utilities
         [TestCase("1.0-beta.2", "1.1", "1.0", ExpectedResult = false)]
         [TestCase("1.0-beta.2", "1.0-beta.10", "1.0-beta.3", ExpectedResult = false)]
         [TestCase("1.0-beta-2", "1.0-beta-10", "1.0-beta-3", ExpectedResult = false)]
+        [TestCase("1.0.0", "1.0.0", null, ExpectedResult = false)] // null is always less than any value per CompareTo remarks
         public bool IsBetween(string versionStr, string lowerStr, string upperStr)
         {
             // arrange
-            ISemanticVersion lower = new SemanticVersion(lowerStr);
-            ISemanticVersion upper = new SemanticVersion(upperStr);
+            ISemanticVersion lower = lowerStr != null
+                ? new SemanticVersion(lowerStr)
+                : null;
+            ISemanticVersion upper = upperStr != null
+                ? new SemanticVersion(upperStr)
+                : null;
             ISemanticVersion version = new SemanticVersion(versionStr);
 
             // assert
-            Assert.AreEqual(version.IsBetween(lower, upper), version.IsBetween(lower.ToString(), upper.ToString()), "The two signatures returned different results.");
+            Assert.AreEqual(version.IsBetween(lower, upper), version.IsBetween(lower?.ToString(), upper?.ToString()), "The two signatures returned different results.");
             return version.IsBetween(lower, upper);
         }
 
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index 97b92555..41ae12eb 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -108,9 +108,9 @@ namespace StardewModdingAPI.Toolkit
         /// <inheritdoc />
         public int CompareTo(ISemanticVersion other)
         {
-            if (other == null)
-                throw new ArgumentNullException(nameof(other));
-            return this.CompareTo(other.MajorVersion, other.MinorVersion, other.PatchVersion, (other as SemanticVersion)?.PlatformRelease ?? 0, other.PrereleaseTag);
+            return other == null
+                ? 1
+                : this.CompareTo(other.MajorVersion, other.MinorVersion, other.PatchVersion, (other as SemanticVersion)?.PlatformRelease ?? 0, other.PrereleaseTag);
         }
 
         /// <inheritdoc />
@@ -134,7 +134,11 @@ namespace StardewModdingAPI.Toolkit
         /// <inheritdoc />
         public bool IsOlderThan(string other)
         {
-            return this.IsOlderThan(new SemanticVersion(other, allowNonStandard: true));
+            ISemanticVersion otherVersion = other != null
+                ? new SemanticVersion(other, allowNonStandard: true)
+                : null;
+
+            return this.IsOlderThan(otherVersion);
         }
 
         /// <inheritdoc />
@@ -146,7 +150,11 @@ namespace StardewModdingAPI.Toolkit
         /// <inheritdoc />
         public bool IsNewerThan(string other)
         {
-            return this.IsNewerThan(new SemanticVersion(other, allowNonStandard: true));
+            ISemanticVersion otherVersion = other != null
+                ? new SemanticVersion(other, allowNonStandard: true)
+                : null;
+
+            return this.IsNewerThan(otherVersion);
         }
 
         /// <inheritdoc />
@@ -158,7 +166,14 @@ namespace StardewModdingAPI.Toolkit
         /// <inheritdoc />
         public bool IsBetween(string min, string max)
         {
-            return this.IsBetween(new SemanticVersion(min, allowNonStandard: true), new SemanticVersion(max, allowNonStandard: true));
+            ISemanticVersion minVersion = min != null
+                ? new SemanticVersion(min, allowNonStandard: true)
+                : null;
+            ISemanticVersion maxVersion = max != null
+                ? new SemanticVersion(max, allowNonStandard: true)
+                : null;
+
+            return this.IsBetween(minVersion, maxVersion);
         }
 
         /// <inheritdoc cref="ISemanticVersion.ToString" />

From 3f9b412beda2d9c9168473089f201149cb27f755 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Apr 2022 00:26:28 -0400
Subject: [PATCH 506/856] expand & reorganize 3.14.0 release notes

---
 docs/release-notes.md | 62 +++++++++++++++++++++++++------------------
 1 file changed, 36 insertions(+), 26 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 96a236ad..bb30f31a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,46 +2,56 @@
 
 # Release notes
 ## Upcoming release
-* For players:
-  * Fixed support for `_international` content assets (used in the movie theater).
-  * Fixed the warning text when a mod causes an asset load conflict with itself.
-  * Improved Linux/macOS [command-line arguments](technical/smapi.md#command-line-arguments):
-    * Added `--use-current-shell` to avoid opening a separate terminal window.
-    * Fixed `--no-terminal` still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
-  * SMAPI now fixes many case-sensitive mod file path issues automatically.
+### For players
+* Changes:
+  * On Linux, SMAPI now fixes many issues with case-sensitive mod paths automatically.
+  * On Linux/macOS, added `--use-current-shell` [command-line argument](technical/smapi.md#command-line-arguments) to avoid opening a separate terminal window.
   * Dropped update checks for the unofficial 64-bit patcher (obsolete since SMAPI 3.12.6).
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
+* Fixes:
+  * Fixed some movie theater textures not translated when loaded through SMAPI (specifically assets with the `_international` suffix).
+  * Fixed the warning text when a mod causes an asset load conflict with itself.
+  * Fixed `--no-terminal` [command-line argument](technical/smapi.md#command-line-arguments) on Linux/macOS still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
+  * Fixed `player_add` console command not handling journal scraps and secret notes correctly.
+  * Fixed `set_farm_type` console command not updating warps.
 
-* For the Console Commands mod:
-  * Fixed `player_add` not handling journal scraps and secret notes correctly.
-  * Fixed `set_farm_type` not updating warps.
+### For the web UI
+* Updated the JSON validator/schema for Content Patcher 1.25.0.
+* Added `data-*` attributes to the log parser page for external tools.
+* Fixed JSON validator showing incorrect error for update keys without a subkey.
 
-* For mod authors:
-  * **Major changes as part of the upcoming SMAPI 4.0.0:**
-    * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
-      _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
-    * Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.
-    * Overhauled [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
-      _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
-    * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
-    * **Deprecation warning:** The upcoming SMAPI 4.0 will remove deprecated APIs and break mods which haven't updated yet.  
-    _See [_Migrate to SMAPI 4.0_](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0) for help updating your mod code. You can update your mod code now, there's no need to wait for the 4.0.0 release (which will happen in at least three months, and possibly later if needed to update open-source mods)._
+
+### For mod authors
+This is a big release that includes the new APIs planned for SMAPI 4.0.0, alongside the old ones.
+
+For C# mod authors: SMAPI 4.0.0 will release _no sooner_ than August 2022 (and later if needed to
+update open-source mods). At that point it will **remove all deprecated APIs and break C# mods
+which haven't updated yet**. See [_Migrate to SMAPI 4.0_](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0)
+for help updating your mod code. (You can update now, there's no need to wait for 4.0.0.)
+
+For content pack authors: SMAPI 4.0.0 won't affect content packs. They should work fine as long as
+the C# mod that loads them is updated.
+
+* Major changes:
+  * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
+    _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
+  * Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.
+  * Overhauled [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
+    _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
+  * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
+* Other improvements:
   * Added `IContentPack.ModContent` property.
   * Added `Constants.ContentPath`.
   * Added `IAssetName` fields to the info received by `IAssetEditor` and `IAssetLoader` methods.  
     _This adds methods for working with asset names, parsed locales, etc._
   * Added `helper.Content.ParseAssetName` to get an `IAssetName` for an arbitrary asset key.
   * If an asset is loaded multiple times in the same tick, `IAssetLoader.CanLoad` and `IAssetEditor.CanEdit` are now cached unless invalidated by `helper.Content.InvalidateCache`.
-  * The `ISemanticVersion` comparison methods (`CompareTo`, `IsBetween`, `IsNewerThan`, and `IsOlderThan`) now allow null values. A null version is always considered smaller than any non-null version per [best practices](https://docs.microsoft.com/en-us/dotnet/api/system.icomparable-1.compareto#remarks).
+  * The `ISemanticVersion` comparison methods (`CompareTo`, `IsBetween`, `IsNewerThan`, and `IsOlderThan`) now allow null values. A null version is always considered older than any non-null version per [best practices](https://docs.microsoft.com/en-us/dotnet/api/system.icomparable-1.compareto#remarks).
+* Fixes:
   * Fixed the `SDate` constructor being case-sensitive.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
 
-* For the web UI:
-  * Updated the JSON validator/schema for Content Patcher 1.25.0.
-  * Added `data-*` attributes to log parser page for external tools.
-  * Fixed JSON validator warning shown for update keys without a subkey.
-
 ## 3.13.4
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
 

From ab6cf45b03073f324c46f9e93a98e3342a1bdff7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Apr 2022 00:56:00 -0400
Subject: [PATCH 507/856] enable nullable annotations for semantic versions
 (#837)

---
 .../Utilities/SemanticVersionTests.cs         | 35 +++++------
 .../ISemanticVersion.cs                       | 38 ++++++------
 src/SMAPI.Toolkit/SemanticVersion.cs          | 61 ++++++++++++-------
 src/SMAPI.sln.DotSettings                     |  1 +
 src/SMAPI/SemanticVersion.cs                  | 31 +++++-----
 5 files changed, 91 insertions(+), 75 deletions(-)

diff --git a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
index 599ac839..fedadba6 100644
--- a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
+++ b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using Newtonsoft.Json;
@@ -63,10 +61,10 @@ namespace SMAPI.Tests.Utilities
         [TestCase("apple")]
         [TestCase("-apple")]
         [TestCase("-5")]
-        public void Constructor_FromString_WithInvalidValues(string input)
+        public void Constructor_FromString_WithInvalidValues(string? input)
         {
             if (input == null)
-                this.AssertAndLogException<ArgumentNullException>(() => new SemanticVersion(input));
+                this.AssertAndLogException<ArgumentNullException>(() => new SemanticVersion(input!));
             else
                 this.AssertAndLogException<FormatException>(() => new SemanticVersion(input));
         }
@@ -93,7 +91,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase("1.2.3.4-some-tag.4      ")]
         public void Constructor_FromString_Standard_DisallowsNonStandardVersion(string input)
         {
-            Assert.Throws<FormatException>(() => new SemanticVersion(input));
+            Assert.Throws<FormatException>(() => _ = new SemanticVersion(input));
         }
 
         /// <summary>Assert the parsed version when constructed from standard parts.</summary>
@@ -112,7 +110,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(1, 2, 3, "some-tag.4   ", null, ExpectedResult = "1.2.3-some-tag.4")]
         [TestCase(1, 2, 3, "some-tag.4   ", "build.004", ExpectedResult = "1.2.3-some-tag.4+build.004")]
         [TestCase(1, 2, 0, null, "3.4.5-build.004", ExpectedResult = "1.2.0+3.4.5-build.004")]
-        public string Constructor_FromParts(int major, int minor, int patch, string prerelease, string build)
+        public string Constructor_FromParts(int major, int minor, int patch, string? prerelease, string? build)
         {
             // act
             ISemanticVersion version = new SemanticVersion(major, minor, patch, prerelease, build);
@@ -222,11 +220,11 @@ namespace SMAPI.Tests.Utilities
 
         // null
         [TestCase("1.0.0", null, ExpectedResult = 1)] // null is always less than any value per CompareTo remarks
-        public int CompareTo(string versionStrA, string versionStrB)
+        public int CompareTo(string versionStrA, string? versionStrB)
         {
             // arrange
             ISemanticVersion versionA = new SemanticVersion(versionStrA);
-            ISemanticVersion versionB = versionStrB != null
+            ISemanticVersion? versionB = versionStrB != null
                 ? new SemanticVersion(versionStrB)
                 : null;
 
@@ -270,11 +268,11 @@ namespace SMAPI.Tests.Utilities
 
         // null
         [TestCase("1.0.0", null, ExpectedResult = false)] // null is always less than any value per CompareTo remarks
-        public bool IsOlderThan(string versionStrA, string versionStrB)
+        public bool IsOlderThan(string versionStrA, string? versionStrB)
         {
             // arrange
             ISemanticVersion versionA = new SemanticVersion(versionStrA);
-            ISemanticVersion versionB = versionStrB != null
+            ISemanticVersion? versionB = versionStrB != null
                 ? new SemanticVersion(versionStrB)
                 : null;
 
@@ -319,11 +317,11 @@ namespace SMAPI.Tests.Utilities
 
         // null
         [TestCase("1.0.0", null, ExpectedResult = true)] // null is always less than any value per CompareTo remarks
-        public bool IsNewerThan(string versionStrA, string versionStrB)
+        public bool IsNewerThan(string versionStrA, string? versionStrB)
         {
             // arrange
             ISemanticVersion versionA = new SemanticVersion(versionStrA);
-            ISemanticVersion versionB = versionStrB != null
+            ISemanticVersion? versionB = versionStrB != null
                 ? new SemanticVersion(versionStrB)
                 : null;
 
@@ -356,13 +354,13 @@ namespace SMAPI.Tests.Utilities
         [TestCase("1.0-beta.2", "1.0-beta.10", "1.0-beta.3", ExpectedResult = false)]
         [TestCase("1.0-beta-2", "1.0-beta-10", "1.0-beta-3", ExpectedResult = false)]
         [TestCase("1.0.0", "1.0.0", null, ExpectedResult = false)] // null is always less than any value per CompareTo remarks
-        public bool IsBetween(string versionStr, string lowerStr, string upperStr)
+        public bool IsBetween(string versionStr, string? lowerStr, string? upperStr)
         {
             // arrange
-            ISemanticVersion lower = lowerStr != null
+            ISemanticVersion? lower = lowerStr != null
                 ? new SemanticVersion(lowerStr)
                 : null;
-            ISemanticVersion upper = upperStr != null
+            ISemanticVersion? upper = upperStr != null
                 ? new SemanticVersion(upperStr)
                 : null;
             ISemanticVersion version = new SemanticVersion(versionStr);
@@ -436,7 +434,7 @@ namespace SMAPI.Tests.Utilities
         /// <param name="prerelease">The prerelease tag.</param>
         /// <param name="build">The build metadata.</param>
         /// <param name="nonStandard">Whether the version should be marked as non-standard.</param>
-        private void AssertParts(ISemanticVersion version, int major, int minor, int patch, string prerelease, string build, bool nonStandard)
+        private void AssertParts(ISemanticVersion version, int major, int minor, int patch, string? prerelease, string? build, bool nonStandard)
         {
             Assert.AreEqual(major, version.MajorVersion, "The major version doesn't match.");
             Assert.AreEqual(minor, version.MinorVersion, "The minor version doesn't match.");
@@ -449,9 +447,8 @@ namespace SMAPI.Tests.Utilities
         /// <summary>Assert that the expected exception type is thrown, and log the action output and thrown exception.</summary>
         /// <typeparam name="T">The expected exception type.</typeparam>
         /// <param name="action">The action which may throw the exception.</param>
-        /// <param name="message">The message to log if the expected exception isn't thrown.</param>
         [SuppressMessage("ReSharper", "UnusedParameter.Local", Justification = "The message argument is deliberately only used in precondition checks since this is an assertion method.")]
-        private void AssertAndLogException<T>(Func<object> action, string message = null)
+        private void AssertAndLogException<T>(Func<object> action)
             where T : Exception
         {
             this.AssertAndLogException<T>(() =>
@@ -466,7 +463,7 @@ namespace SMAPI.Tests.Utilities
         /// <param name="action">The action which may throw the exception.</param>
         /// <param name="message">The message to log if the expected exception isn't thrown.</param>
         [SuppressMessage("ReSharper", "UnusedParameter.Local", Justification = "The message argument is deliberately only used in precondition checks since this is an assertion method.")]
-        private void AssertAndLogException<T>(Action action, string message = null)
+        private void AssertAndLogException<T>(Action action, string? message = null)
             where T : Exception
         {
             try
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs b/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
index 52cec52e..7998272f 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI
@@ -20,10 +18,10 @@ namespace StardewModdingAPI
         int PatchVersion { get; }
 
         /// <summary>An optional prerelease tag.</summary>
-        string PrereleaseTag { get; }
+        string? PrereleaseTag { get; }
 
         /// <summary>Optional build metadata. This is ignored when determining version precedence.</summary>
-        string BuildMetadata { get; }
+        string? BuildMetadata { get; }
 
 
         /*********
@@ -34,32 +32,38 @@ namespace StardewModdingAPI
 
         /// <summary>Get whether this version is older than the specified version.</summary>
         /// <param name="other">The version to compare with this instance.</param>
-        bool IsOlderThan(ISemanticVersion other);
+        /// <remarks>Although the <paramref name="other"/> parameter is nullable, it isn't optional. A <c>null</c> version is considered earlier than every possible valid version, so passing <c>null</c> to <paramref name="other"/> will always return false.</remarks>
+        bool IsOlderThan(ISemanticVersion? other);
 
         /// <summary>Get whether this version is older than the specified version.</summary>
-        /// <param name="other">The version to compare with this instance.</param>
+        /// <param name="other">The version to compare with this instance.  A null value is never older.</param>
         /// <exception cref="FormatException">The specified version is not a valid semantic version.</exception>
-        bool IsOlderThan(string other);
+        /// <remarks>Although the <paramref name="other"/> parameter is nullable, it isn't optional. A <c>null</c> version is considered earlier than every possible valid version, so passing <c>null</c> to <paramref name="other"/> will always return false.</remarks>
+        bool IsOlderThan(string? other);
 
         /// <summary>Get whether this version is newer than the specified version.</summary>
-        /// <param name="other">The version to compare with this instance.</param>
-        bool IsNewerThan(ISemanticVersion other);
+        /// <param name="other">The version to compare with this instance. A null value is always older.</param>
+        /// <remarks>Although the <paramref name="other"/> parameter is nullable, it isn't optional. A <c>null</c> version is considered earlier than every possible valid version, so passing <c>null</c> to <paramref name="other"/> will always return true.</remarks>
+        bool IsNewerThan(ISemanticVersion? other);
 
         /// <summary>Get whether this version is newer than the specified version.</summary>
-        /// <param name="other">The version to compare with this instance.</param>
+        /// <param name="other">The version to compare with this instance. A null value is always older.</param>
         /// <exception cref="FormatException">The specified version is not a valid semantic version.</exception>
-        bool IsNewerThan(string other);
+        /// <remarks>Although the <paramref name="other"/> parameter is nullable, it isn't optional. A <c>null</c> version is considered earlier than every possible valid version, so passing <c>null</c> to <paramref name="other"/> will always return true.</remarks>
+        bool IsNewerThan(string? other);
 
         /// <summary>Get whether this version is between two specified versions (inclusively).</summary>
-        /// <param name="min">The minimum version.</param>
-        /// <param name="max">The maximum version.</param>
-        bool IsBetween(ISemanticVersion min, ISemanticVersion max);
+        /// <param name="min">The minimum version. A null value is always older.</param>
+        /// <param name="max">The maximum version. A null value is never newer.</param>
+        /// <remarks>Although the <paramref name="min"/> and <paramref name="max"/> parameters are nullable, they are not optional. A <c>null</c> version is considered earlier than every possible valid version. For example, passing <c>null</c> to <paramref name="max"/> will always return false, since no valid version can be earlier than <c>null</c>.</remarks>
+        bool IsBetween(ISemanticVersion? min, ISemanticVersion? max);
 
         /// <summary>Get whether this version is between two specified versions (inclusively).</summary>
-        /// <param name="min">The minimum version.</param>
-        /// <param name="max">The maximum version.</param>
+        /// <param name="min">The minimum version. A null value is always older.</param>
+        /// <param name="max">The maximum version. A null value is never newer.</param>
         /// <exception cref="FormatException">One of the specified versions is not a valid semantic version.</exception>
-        bool IsBetween(string min, string max);
+        /// <remarks>Although the <paramref name="min"/> and <paramref name="max"/> parameters are nullable, they are not optional. A <c>null</c> version is considered earlier than every possible valid version. For example, passing <c>null</c> to <paramref name="max"/> will always return false, since no valid version can be earlier than <c>null</c>.</remarks>
+        bool IsBetween(string? min, string? max);
 
         /// <summary>Get a string representation of the version.</summary>
         string ToString();
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index 41ae12eb..cea8c447 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Text.RegularExpressions;
 using StardewModdingAPI.Toolkit.Framework;
 
@@ -40,10 +39,10 @@ namespace StardewModdingAPI.Toolkit
         public int PlatformRelease { get; }
 
         /// <inheritdoc />
-        public string PrereleaseTag { get; }
+        public string? PrereleaseTag { get; }
 
         /// <inheritdoc />
-        public string BuildMetadata { get; }
+        public string? BuildMetadata { get; }
 
 
         /*********
@@ -56,7 +55,7 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="platformRelease">The platform-specific version (if applicable).</param>
         /// <param name="prereleaseTag">An optional prerelease tag.</param>
         /// <param name="buildMetadata">Optional build metadata. This is ignored when determining version precedence.</param>
-        public SemanticVersion(int major, int minor, int patch, int platformRelease = 0, string prereleaseTag = null, string buildMetadata = null)
+        public SemanticVersion(int major, int minor, int patch, int platformRelease = 0, string? prereleaseTag = null, string? buildMetadata = null)
         {
             this.MajorVersion = major;
             this.MinorVersion = minor;
@@ -106,7 +105,7 @@ namespace StardewModdingAPI.Toolkit
         }
 
         /// <inheritdoc />
-        public int CompareTo(ISemanticVersion other)
+        public int CompareTo(ISemanticVersion? other)
         {
             return other == null
                 ? 1
@@ -114,7 +113,7 @@ namespace StardewModdingAPI.Toolkit
         }
 
         /// <inheritdoc />
-        public bool Equals(ISemanticVersion other)
+        public bool Equals(ISemanticVersion? other)
         {
             return other != null && this.CompareTo(other) == 0;
         }
@@ -126,15 +125,15 @@ namespace StardewModdingAPI.Toolkit
         }
 
         /// <inheritdoc />
-        public bool IsOlderThan(ISemanticVersion other)
+        public bool IsOlderThan(ISemanticVersion? other)
         {
             return this.CompareTo(other) < 0;
         }
 
         /// <inheritdoc />
-        public bool IsOlderThan(string other)
+        public bool IsOlderThan(string? other)
         {
-            ISemanticVersion otherVersion = other != null
+            ISemanticVersion? otherVersion = other != null
                 ? new SemanticVersion(other, allowNonStandard: true)
                 : null;
 
@@ -142,15 +141,15 @@ namespace StardewModdingAPI.Toolkit
         }
 
         /// <inheritdoc />
-        public bool IsNewerThan(ISemanticVersion other)
+        public bool IsNewerThan(ISemanticVersion? other)
         {
             return this.CompareTo(other) > 0;
         }
 
         /// <inheritdoc />
-        public bool IsNewerThan(string other)
+        public bool IsNewerThan(string? other)
         {
-            ISemanticVersion otherVersion = other != null
+            ISemanticVersion? otherVersion = other != null
                 ? new SemanticVersion(other, allowNonStandard: true)
                 : null;
 
@@ -158,18 +157,18 @@ namespace StardewModdingAPI.Toolkit
         }
 
         /// <inheritdoc />
-        public bool IsBetween(ISemanticVersion min, ISemanticVersion max)
+        public bool IsBetween(ISemanticVersion? min, ISemanticVersion? max)
         {
             return this.CompareTo(min) >= 0 && this.CompareTo(max) <= 0;
         }
 
         /// <inheritdoc />
-        public bool IsBetween(string min, string max)
+        public bool IsBetween(string? min, string? max)
         {
-            ISemanticVersion minVersion = min != null
+            ISemanticVersion? minVersion = min != null
                 ? new SemanticVersion(min, allowNonStandard: true)
                 : null;
-            ISemanticVersion maxVersion = max != null
+            ISemanticVersion? maxVersion = max != null
                 ? new SemanticVersion(max, allowNonStandard: true)
                 : null;
 
@@ -199,7 +198,12 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="version">The version string.</param>
         /// <param name="parsed">The parsed representation.</param>
         /// <returns>Returns whether parsing the version succeeded.</returns>
-        public static bool TryParse(string version, out ISemanticVersion parsed)
+        public static bool TryParse(string? version,
+#if NET5_0_OR_GREATER
+            [NotNullWhen(true)]
+#endif
+            out ISemanticVersion? parsed
+        )
         {
             return SemanticVersion.TryParse(version, allowNonStandard: false, out parsed);
         }
@@ -209,8 +213,19 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="allowNonStandard">Whether to allow non-standard extensions to semantic versioning.</param>
         /// <param name="parsed">The parsed representation.</param>
         /// <returns>Returns whether parsing the version succeeded.</returns>
-        public static bool TryParse(string version, bool allowNonStandard, out ISemanticVersion parsed)
+        public static bool TryParse(string? version, bool allowNonStandard,
+#if NET5_0_OR_GREATER
+            [NotNullWhen(true)]
+#endif
+            out ISemanticVersion? parsed
+        )
         {
+            if (version == null)
+            {
+                parsed = null;
+                return false;
+            }
+
             try
             {
                 parsed = new SemanticVersion(version, allowNonStandard);
@@ -229,7 +244,7 @@ namespace StardewModdingAPI.Toolkit
         *********/
         /// <summary>Get a normalized prerelease or build tag.</summary>
         /// <param name="tag">The tag to normalize.</param>
-        private string GetNormalizedTag(string tag)
+        private string? GetNormalizedTag(string? tag)
         {
             tag = tag?.Trim();
             return !string.IsNullOrWhiteSpace(tag) ? tag : null;
@@ -241,7 +256,7 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="otherPatch">The patch version to compare with this instance.</param>
         /// <param name="otherPlatformRelease">The non-standard platform release to compare with this instance.</param>
         /// <param name="otherTag">The prerelease tag to compare with this instance.</param>
-        private int CompareTo(int otherMajor, int otherMinor, int otherPatch, int otherPlatformRelease, string otherTag)
+        private int CompareTo(int otherMajor, int otherMinor, int otherPatch, int otherPlatformRelease, string? otherTag)
         {
             const int same = 0;
             const int curNewer = 1;
@@ -270,8 +285,8 @@ namespace StardewModdingAPI.Toolkit
                     return curOlder;
 
                 // compare two prerelease tag values
-                string[] curParts = this.PrereleaseTag.Split('.', '-');
-                string[] otherParts = otherTag.Split('.', '-');
+                string[] curParts = this.PrereleaseTag?.Split('.', '-') ?? Array.Empty<string>();
+                string[] otherParts = otherTag?.Split('.', '-') ?? Array.Empty<string>();
                 int length = Math.Max(curParts.Length, otherParts.Length);
                 for (int i = 0; i < length; i++)
                 {
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index b85185d5..5b35c615 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -73,5 +73,6 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=tilesheets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=tilesheet_0027s/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=unloadable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=versioning/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=virally/@EntryIndexedValue">True</s:Boolean>
 </wpf:ResourceDictionary>
\ No newline at end of file
diff --git a/src/SMAPI/SemanticVersion.cs b/src/SMAPI/SemanticVersion.cs
index 4e484633..7a6cdcdd 100644
--- a/src/SMAPI/SemanticVersion.cs
+++ b/src/SMAPI/SemanticVersion.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI
@@ -28,10 +27,10 @@ namespace StardewModdingAPI
         public int PatchVersion => this.Version.PatchVersion;
 
         /// <inheritdoc />
-        public string PrereleaseTag => this.Version.PrereleaseTag;
+        public string? PrereleaseTag => this.Version.PrereleaseTag;
 
         /// <inheritdoc />
-        public string BuildMetadata => this.Version.BuildMetadata;
+        public string? BuildMetadata => this.Version.BuildMetadata;
 
 
         /*********
@@ -43,7 +42,7 @@ namespace StardewModdingAPI
         /// <param name="patchVersion">The patch version for backwards-compatible bug fixes.</param>
         /// <param name="prereleaseTag">An optional prerelease tag.</param>
         /// <param name="buildMetadata">Optional build metadata. This is ignored when determining version precedence.</param>
-        public SemanticVersion(int majorVersion, int minorVersion, int patchVersion, string prereleaseTag = null, string buildMetadata = null)
+        public SemanticVersion(int majorVersion, int minorVersion, int patchVersion, string? prereleaseTag = null, string? buildMetadata = null)
             : this(majorVersion, minorVersion, patchVersion, 0, prereleaseTag, buildMetadata) { }
 
         /// <summary>Construct an instance.</summary>
@@ -54,7 +53,7 @@ namespace StardewModdingAPI
         /// <param name="platformRelease">The platform-specific version (if applicable).</param>
         /// <param name="buildMetadata">Optional build metadata. This is ignored when determining version precedence.</param>
         [JsonConstructor]
-        internal SemanticVersion(int majorVersion, int minorVersion, int patchVersion, int platformRelease, string prereleaseTag = null, string buildMetadata = null)
+        internal SemanticVersion(int majorVersion, int minorVersion, int patchVersion, int platformRelease, string? prereleaseTag = null, string? buildMetadata = null)
             : this(new Toolkit.SemanticVersion(majorVersion, minorVersion, patchVersion, platformRelease, prereleaseTag, buildMetadata)) { }
 
         /// <summary>Construct an instance.</summary>
@@ -93,49 +92,49 @@ namespace StardewModdingAPI
 
         /// <inheritdoc />
         /// <remarks>The implementation is defined by Semantic Version 2.0 (https://semver.org/).</remarks>
-        public int CompareTo(ISemanticVersion other)
+        public int CompareTo(ISemanticVersion? other)
         {
             return this.Version.CompareTo(other);
         }
 
         /// <inheritdoc />
-        public bool IsOlderThan(ISemanticVersion other)
+        public bool IsOlderThan(ISemanticVersion? other)
         {
             return this.Version.IsOlderThan(other);
         }
 
         /// <inheritdoc />
-        public bool IsOlderThan(string other)
+        public bool IsOlderThan(string? other)
         {
             return this.Version.IsOlderThan(other);
         }
 
         /// <inheritdoc />
-        public bool IsNewerThan(ISemanticVersion other)
+        public bool IsNewerThan(ISemanticVersion? other)
         {
             return this.Version.IsNewerThan(other);
         }
 
         /// <inheritdoc />
-        public bool IsNewerThan(string other)
+        public bool IsNewerThan(string? other)
         {
             return this.Version.IsNewerThan(other);
         }
 
         /// <inheritdoc />
-        public bool IsBetween(ISemanticVersion min, ISemanticVersion max)
+        public bool IsBetween(ISemanticVersion? min, ISemanticVersion? max)
         {
             return this.Version.IsBetween(min, max);
         }
 
         /// <inheritdoc />
-        public bool IsBetween(string min, string max)
+        public bool IsBetween(string? min, string? max)
         {
             return this.Version.IsBetween(min, max);
         }
 
         /// <inheritdoc />
-        public bool Equals(ISemanticVersion other)
+        public bool Equals(ISemanticVersion? other)
         {
             return other != null && this.CompareTo(other) == 0;
         }
@@ -156,9 +155,9 @@ namespace StardewModdingAPI
         /// <param name="version">The version string.</param>
         /// <param name="parsed">The parsed representation.</param>
         /// <returns>Returns whether parsing the version succeeded.</returns>
-        public static bool TryParse(string version, out ISemanticVersion parsed)
+        public static bool TryParse(string version, [NotNullWhen(true)] out ISemanticVersion? parsed)
         {
-            if (Toolkit.SemanticVersion.TryParse(version, out ISemanticVersion versionImpl))
+            if (Toolkit.SemanticVersion.TryParse(version, out ISemanticVersion? versionImpl))
             {
                 parsed = new SemanticVersion(versionImpl);
                 return true;

From e58e8a22836081ec4baffa5a9b4b093a329f3d88 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Apr 2022 01:38:02 -0400
Subject: [PATCH 508/856] enable nullable annotations for manifests (#837)

---
 src/SMAPI.Tests/Core/ModResolverTests.cs      |  43 ++++----
 src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs |   8 +-
 .../IManifestContentPackFor.cs                |   4 +-
 .../IManifestDependency.cs                    |   4 +-
 .../Framework/ModScanning/ModScanner.cs       |  15 ---
 .../Serialization/Models/Manifest.cs          | 102 ++++++++++++------
 .../Models/ManifestContentPackFor.cs          |  33 +++++-
 .../Models/ManifestDependency.cs              |  44 ++++++--
 src/SMAPI/Framework/ModLoading/ModResolver.cs |   2 +-
 9 files changed, 164 insertions(+), 91 deletions(-)

diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index 2ce1c74e..e1b56559 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -52,11 +50,11 @@ namespace SMAPI.Tests.Core
 
             // act
             IModMetadata[] mods = new ModResolver().ReadManifests(new ModToolkit(), rootFolder, new ModDatabase()).ToArray();
-            IModMetadata mod = mods.FirstOrDefault();
+            IModMetadata? mod = mods.FirstOrDefault();
 
             // assert
             Assert.AreEqual(1, mods.Length, 0, $"Expected to find one manifest, found {mods.Length} instead.");
-            Assert.AreEqual(ModMetadataStatus.Failed, mod.Status, "The mod metadata was not marked failed.");
+            Assert.AreEqual(ModMetadataStatus.Failed, mod!.Status, "The mod metadata was not marked failed.");
             Assert.IsNotNull(mod.Error, "The mod metadata did not have an error message set.");
         }
 
@@ -91,12 +89,12 @@ namespace SMAPI.Tests.Core
 
             // act
             IModMetadata[] mods = new ModResolver().ReadManifests(new ModToolkit(), rootFolder, new ModDatabase()).ToArray();
-            IModMetadata mod = mods.FirstOrDefault();
+            IModMetadata? mod = mods.FirstOrDefault();
 
             // assert
             Assert.AreEqual(1, mods.Length, 0, "Expected to find one manifest.");
             Assert.IsNotNull(mod, "The loaded manifest shouldn't be null.");
-            Assert.AreEqual(null, mod.DataRecord, "The data record should be null since we didn't provide one.");
+            Assert.AreEqual(null, mod!.DataRecord, "The data record should be null since we didn't provide one.");
             Assert.AreEqual(modFolder, mod.DirectoryPath, "The directory path doesn't match.");
             Assert.AreEqual(null, mod.Error, "The error should be null since parsing should have succeeded.");
             Assert.AreEqual(ModMetadataStatus.Found, mod.Status, "The status doesn't match.");
@@ -215,7 +213,7 @@ namespace SMAPI.Tests.Core
             // create DLL
             string modFolder = Path.Combine(this.GetTempFolderPath(), Guid.NewGuid().ToString("N"));
             Directory.CreateDirectory(modFolder);
-            File.WriteAllText(Path.Combine(modFolder, manifest.EntryDll), "");
+            File.WriteAllText(Path.Combine(modFolder, manifest.EntryDll!), "");
 
             // arrange
             Mock<IModMetadata> mock = new Mock<IModMetadata>(MockBehavior.Strict);
@@ -480,21 +478,20 @@ namespace SMAPI.Tests.Core
         /// <param name="contentPackForID">The <see cref="IManifest.ContentPackFor"/> value.</param>
         /// <param name="minimumApiVersion">The <see cref="IManifest.MinimumApiVersion"/> value.</param>
         /// <param name="dependencies">The <see cref="IManifest.Dependencies"/> value.</param>
-        private Manifest GetManifest(string id = null, string name = null, string version = null, string entryDll = null, string contentPackForID = null, string minimumApiVersion = null, IManifestDependency[] dependencies = null)
+        private Manifest GetManifest(string? id = null, string? name = null, string? version = null, string? entryDll = null, string? contentPackForID = null, string? minimumApiVersion = null, IManifestDependency[]? dependencies = null)
         {
-            return new Manifest
-            {
-                UniqueID = id ?? $"{Sample.String()}.{Sample.String()}",
-                Name = name ?? id ?? Sample.String(),
-                Author = Sample.String(),
-                Description = Sample.String(),
-                Version = version != null ? new SemanticVersion(version) : new SemanticVersion(Sample.Int(), Sample.Int(), Sample.Int(), Sample.String()),
-                EntryDll = entryDll ?? $"{Sample.String()}.dll",
-                ContentPackFor = contentPackForID != null ? new ManifestContentPackFor { UniqueID = contentPackForID } : null,
-                MinimumApiVersion = minimumApiVersion != null ? new SemanticVersion(minimumApiVersion) : null,
-                Dependencies = dependencies ?? Array.Empty<IManifestDependency>(),
-                UpdateKeys = Array.Empty<string>()
-            };
+            return new Manifest(
+                uniqueId: id ?? $"{Sample.String()}.{Sample.String()}",
+                name: name ?? id ?? Sample.String(),
+                author: Sample.String(),
+                description: Sample.String(),
+                version: version != null ? new SemanticVersion(version) : new SemanticVersion(Sample.Int(), Sample.Int(), Sample.Int(), Sample.String()),
+                entryDll: entryDll ?? $"{Sample.String()}.dll",
+                contentPackFor: contentPackForID != null ? new ManifestContentPackFor(contentPackForID, null) : null,
+                minimumApiVersion: minimumApiVersion != null ? new SemanticVersion(minimumApiVersion) : null,
+                dependencies: dependencies ?? Array.Empty<IManifestDependency>(),
+                updateKeys: Array.Empty<string>()
+            );
         }
 
         /// <summary>Get a randomized basic manifest.</summary>
@@ -510,7 +507,7 @@ namespace SMAPI.Tests.Core
         /// <param name="allowStatusChange">Whether the code being tested is allowed to change the mod status.</param>
         private Mock<IModMetadata> GetMetadata(string uniqueID, string[] dependencies, bool allowStatusChange = false)
         {
-            IManifest manifest = this.GetManifest(id: uniqueID, version: "1.0", dependencies: dependencies?.Select(dependencyID => (IManifestDependency)new ManifestDependency(dependencyID, null)).ToArray());
+            IManifest manifest = this.GetManifest(id: uniqueID, version: "1.0", dependencies: dependencies?.Select(dependencyID => (IManifestDependency)new ManifestDependency(dependencyID, null as ISemanticVersion)).ToArray());
             return this.GetMetadata(manifest, allowStatusChange);
         }
 
@@ -538,7 +535,7 @@ namespace SMAPI.Tests.Core
         /// <summary>Set up a mock mod metadata for <see cref="ModResolver.ValidateManifests"/>.</summary>
         /// <param name="mod">The mock mod metadata.</param>
         /// <param name="modRecord">The extra metadata about the mod from SMAPI's internal data (if any).</param>
-        private void SetupMetadataForValidation(Mock<IModMetadata> mod, ModDataRecordVersionedFields modRecord = null)
+        private void SetupMetadataForValidation(Mock<IModMetadata> mod, ModDataRecordVersionedFields? modRecord = null)
         {
             mod.Setup(p => p.Status).Returns(ModMetadataStatus.Found);
             mod.Setup(p => p.DataRecord).Returns(() => null);
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs b/src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs
index a9251446..ee6cc0b6 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/IManifest.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
@@ -23,16 +21,16 @@ namespace StardewModdingAPI
         ISemanticVersion Version { get; }
 
         /// <summary>The minimum SMAPI version required by this mod, if any.</summary>
-        ISemanticVersion MinimumApiVersion { get; }
+        ISemanticVersion? MinimumApiVersion { get; }
 
         /// <summary>The unique mod ID.</summary>
         string UniqueID { get; }
 
         /// <summary>The name of the DLL in the directory that has the <c>Entry</c> method. Mutually exclusive with <see cref="ContentPackFor"/>.</summary>
-        string EntryDll { get; }
+        string? EntryDll { get; }
 
         /// <summary>The mod which will read this as a content pack. Mutually exclusive with <see cref="EntryDll"/>.</summary>
-        IManifestContentPackFor ContentPackFor { get; }
+        IManifestContentPackFor? ContentPackFor { get; }
 
         /// <summary>The other mods that must be loaded before this mod.</summary>
         IManifestDependency[] Dependencies { get; }
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs b/src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs
index d898b716..52ac8f1c 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/IManifestContentPackFor.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI
 {
     /// <summary>Indicates which mod can read the content pack represented by the containing manifest.</summary>
@@ -9,6 +7,6 @@ namespace StardewModdingAPI
         string UniqueID { get; }
 
         /// <summary>The minimum required version (if any).</summary>
-        ISemanticVersion MinimumVersion { get; }
+        ISemanticVersion? MinimumVersion { get; }
     }
 }
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs b/src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs
index 49b7aed6..58425eb2 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/IManifestDependency.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI
 {
     /// <summary>A mod dependency listed in a mod manifest.</summary>
@@ -12,7 +10,7 @@ namespace StardewModdingAPI
         string UniqueID { get; }
 
         /// <summary>The minimum required version (if any).</summary>
-        ISemanticVersion MinimumVersion { get; }
+        ISemanticVersion? MinimumVersion { get; }
 
         /// <summary>Whether the dependency must be installed to use the mod.</summary>
         bool IsRequired { get; }
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 4deaf19b..621f1e28 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -171,14 +171,6 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
                 }
             }
 
-            // normalize display fields
-            if (manifest != null)
-            {
-                manifest.Name = this.StripNewlines(manifest.Name);
-                manifest.Description = this.StripNewlines(manifest.Description);
-                manifest.Author = this.StripNewlines(manifest.Author);
-            }
-
             // get mod type
             ModType type;
             {
@@ -365,12 +357,5 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 
             return hasVortexMarker;
         }
-
-        /// <summary>Strip newlines from a string.</summary>
-        /// <param name="input">The input to strip.</param>
-        private string StripNewlines(string input)
-        {
-            return input?.Replace("\r", "").Replace("\n", "");
-        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index a5dbf604..01010602 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -1,8 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
-using System.Runtime.Serialization;
+using System.Diagnostics.CodeAnalysis;
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Converters;
 
@@ -15,48 +13,45 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         ** Accessors
         *********/
         /// <summary>The mod name.</summary>
-        public string Name { get; set; }
+        public string Name { get; }
 
         /// <summary>A brief description of the mod.</summary>
-        public string Description { get; set; }
+        public string Description { get; }
 
         /// <summary>The mod author's name.</summary>
-        public string Author { get; set; }
+        public string Author { get; }
 
         /// <summary>The mod version.</summary>
-        public ISemanticVersion Version { get; set; }
+        public ISemanticVersion Version { get; }
 
         /// <summary>The minimum SMAPI version required by this mod, if any.</summary>
-        public ISemanticVersion MinimumApiVersion { get; set; }
+        public ISemanticVersion? MinimumApiVersion { get; }
 
         /// <summary>The name of the DLL in the directory that has the <c>Entry</c> method. Mutually exclusive with <see cref="ContentPackFor"/>.</summary>
-        public string EntryDll { get; set; }
+        public string? EntryDll { get; }
 
         /// <summary>The mod which will read this as a content pack. Mutually exclusive with <see cref="Manifest.EntryDll"/>.</summary>
         [JsonConverter(typeof(ManifestContentPackForConverter))]
-        public IManifestContentPackFor ContentPackFor { get; set; }
+        public IManifestContentPackFor? ContentPackFor { get; }
 
         /// <summary>The other mods that must be loaded before this mod.</summary>
         [JsonConverter(typeof(ManifestDependencyArrayConverter))]
-        public IManifestDependency[] Dependencies { get; set; }
+        public IManifestDependency[] Dependencies { get; }
 
         /// <summary>The namespaced mod IDs to query for updates (like <c>Nexus:541</c>).</summary>
-        public string[] UpdateKeys { get; set; }
+        public string[] UpdateKeys { get; private set; }
 
         /// <summary>The unique mod ID.</summary>
-        public string UniqueID { get; set; }
+        public string UniqueID { get; }
 
         /// <summary>Any manifest fields which didn't match a valid field.</summary>
         [JsonExtensionData]
-        public IDictionary<string, object> ExtraFields { get; set; }
+        public IDictionary<string, object> ExtraFields { get; set; } = new Dictionary<string, object>();
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public Manifest() { }
-
         /// <summary>Construct an instance for a transitional content pack.</summary>
         /// <param name="uniqueID">The unique mod ID.</param>
         /// <param name="name">The mod name.</param>
@@ -64,24 +59,71 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         /// <param name="description">A brief description of the mod.</param>
         /// <param name="version">The mod version.</param>
         /// <param name="contentPackFor">The modID which will read this as a content pack.</param>
-        public Manifest(string uniqueID, string name, string author, string description, ISemanticVersion version, string contentPackFor = null)
+        public Manifest(string uniqueID, string name, string author, string description, ISemanticVersion version, string? contentPackFor = null)
+            : this(
+                uniqueId: uniqueID,
+                name: name,
+                author: author,
+                description: description,
+                version: version,
+                minimumApiVersion: null,
+                entryDll: null,
+                contentPackFor: contentPackFor != null
+                    ? new ManifestContentPackFor(contentPackFor, null)
+                    : null,
+                dependencies: null,
+                updateKeys: null
+            )
+        { }
+
+        /// <summary>Construct an instance for a transitional content pack.</summary>
+        /// <param name="uniqueId">The unique mod ID.</param>
+        /// <param name="name">The mod name.</param>
+        /// <param name="author">The mod author's name.</param>
+        /// <param name="description">A brief description of the mod.</param>
+        /// <param name="version">The mod version.</param>
+        /// <param name="minimumApiVersion">The minimum SMAPI version required by this mod, if any.</param>
+        /// <param name="entryDll">The name of the DLL in the directory that has the <c>Entry</c> method. Mutually exclusive with <see cref="ContentPackFor"/>.</param>
+        /// <param name="contentPackFor">The modID which will read this as a content pack.</param>
+        /// <param name="dependencies">The other mods that must be loaded before this mod.</param>
+        /// <param name="updateKeys">The namespaced mod IDs to query for updates (like <c>Nexus:541</c>).</param>
+        [JsonConstructor]
+        public Manifest(string uniqueId, string name, string author, string description, ISemanticVersion version, ISemanticVersion? minimumApiVersion, string? entryDll, IManifestContentPackFor? contentPackFor, IManifestDependency[]? dependencies, string[]? updateKeys)
         {
-            this.Name = name;
-            this.Author = author;
-            this.Description = description;
+            this.UniqueID = this.NormalizeWhitespace(uniqueId);
+            this.Name = this.NormalizeWhitespace(name);
+            this.Author = this.NormalizeWhitespace(author);
+            this.Description = this.NormalizeWhitespace(description);
             this.Version = version;
-            this.UniqueID = uniqueID;
-            this.UpdateKeys = Array.Empty<string>();
-            this.ContentPackFor = new ManifestContentPackFor { UniqueID = contentPackFor };
+            this.MinimumApiVersion = minimumApiVersion;
+            this.EntryDll = this.NormalizeWhitespace(entryDll);
+            this.ContentPackFor = contentPackFor;
+            this.Dependencies = dependencies ?? Array.Empty<IManifestDependency>();
+            this.UpdateKeys = updateKeys ?? Array.Empty<string>();
         }
 
-        /// <summary>Normalize the model after it's deserialized.</summary>
-        /// <param name="context">The deserialization context.</param>
-        [OnDeserialized]
-        public void OnDeserialized(StreamingContext context)
+        /// <summary>Override the update keys loaded from the mod info.</summary>
+        /// <param name="updateKeys">The new update keys to set.</param>
+        internal void OverrideUpdateKeys(params string[] updateKeys)
         {
-            this.Dependencies ??= Array.Empty<IManifestDependency>();
-            this.UpdateKeys ??= Array.Empty<string>();
+            this.UpdateKeys = updateKeys;
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Normalize whitespace in a raw string.</summary>
+        /// <param name="input">The input to strip.</param>
+#if NET5_0_OR_GREATER
+        [return: NotNullIfNotNull("input")]
+#endif
+        private string? NormalizeWhitespace(string? input)
+        {
+            return input
+                ?.Trim()
+                .Replace("\r", "")
+                .Replace("\n", "");
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
index ea5f0e6c..f7dc8aa8 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Toolkit.Serialization.Models
 {
@@ -9,9 +9,36 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         ** Accessors
         *********/
         /// <summary>The unique ID of the mod which can read this content pack.</summary>
-        public string UniqueID { get; set; }
+        public string UniqueID { get; }
 
         /// <summary>The minimum required version (if any).</summary>
-        public ISemanticVersion MinimumVersion { get; set; }
+        public ISemanticVersion? MinimumVersion { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="uniqueId">The unique ID of the mod which can read this content pack.</param>
+        /// <param name="minimumVersion">The minimum required version (if any).</param>
+        public ManifestContentPackFor(string uniqueId, ISemanticVersion? minimumVersion)
+        {
+            this.UniqueID = this.NormalizeWhitespace(uniqueId);
+            this.MinimumVersion = minimumVersion;
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Normalize whitespace in a raw string.</summary>
+        /// <param name="input">The input to strip.</param>
+#if NET5_0_OR_GREATER
+        [return: NotNullIfNotNull("input")]
+#endif
+        private string? NormalizeWhitespace(string? input)
+        {
+            return input?.Trim();
+        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
index f52dd5ee..e7acf71d 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
@@ -1,4 +1,5 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
+using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Toolkit.Serialization.Models
 {
@@ -9,13 +10,13 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         ** Accessors
         *********/
         /// <summary>The unique mod ID to require.</summary>
-        public string UniqueID { get; set; }
+        public string UniqueID { get; }
 
         /// <summary>The minimum required version (if any).</summary>
-        public ISemanticVersion MinimumVersion { get; set; }
+        public ISemanticVersion? MinimumVersion { get; }
 
         /// <summary>Whether the dependency must be installed to use the mod.</summary>
-        public bool IsRequired { get; set; }
+        public bool IsRequired { get; }
 
 
         /*********
@@ -26,12 +27,39 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         /// <param name="minimumVersion">The minimum required version (if any).</param>
         /// <param name="required">Whether the dependency must be installed to use the mod.</param>
         public ManifestDependency(string uniqueID, string minimumVersion, bool required = true)
+            : this(
+                uniqueID: uniqueID,
+                minimumVersion: !string.IsNullOrWhiteSpace(minimumVersion)
+                    ? new SemanticVersion(minimumVersion)
+                    : null,
+                required: required
+            )
+        { }
+
+        /// <summary>Construct an instance.</summary>
+        /// <param name="uniqueID">The unique mod ID to require.</param>
+        /// <param name="minimumVersion">The minimum required version (if any).</param>
+        /// <param name="required">Whether the dependency must be installed to use the mod.</param>
+        [JsonConstructor]
+        public ManifestDependency(string uniqueID, ISemanticVersion? minimumVersion, bool required = true)
         {
-            this.UniqueID = uniqueID;
-            this.MinimumVersion = !string.IsNullOrWhiteSpace(minimumVersion)
-                ? new SemanticVersion(minimumVersion)
-                : null;
+            this.UniqueID = this.NormalizeWhitespace(uniqueID);
+            this.MinimumVersion = minimumVersion;
             this.IsRequired = required;
         }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Normalize whitespace in a raw string.</summary>
+        /// <param name="input">The input to strip.</param>
+#if NET5_0_OR_GREATER
+        [return: NotNullIfNotNull("input")]
+#endif
+        private string? NormalizeWhitespace(string? input)
+        {
+            return input?.Trim();
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 51463048..2842c11a 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -35,7 +35,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
                 // apply defaults
                 if (manifest != null && dataRecord?.UpdateKey is not null)
-                    manifest.UpdateKeys = new[] { dataRecord.UpdateKey };
+                    manifest.OverrideUpdateKeys(dataRecord.UpdateKey);
 
                 // build metadata
                 bool shouldIgnore = folder.Type == ModType.Ignored;

From 6b05296e71c32abd158f354eeeaf1e135e72e6e2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Apr 2022 01:51:50 -0400
Subject: [PATCH 509/856] migrate mod build package to .NET 5 to allow full
 nullable annotations (#837)

---
 docs/technical/mod-package.md                 | 10 ++++++
 .../SMAPI.ModBuildConfig.Analyzer.csproj      |  2 +-
 .../SMAPI.ModBuildConfig.csproj               |  2 +-
 .../SMAPI.Toolkit.CoreInterfaces.csproj       |  2 +-
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj        |  2 +-
 src/SMAPI.Toolkit/SemanticVersion.cs          | 14 ++------
 .../Serialization/Models/Manifest.cs          |  2 --
 .../Models/ManifestContentPackFor.cs          |  2 --
 .../Models/ManifestDependency.cs              |  2 --
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs  | 36 -------------------
 10 files changed, 16 insertions(+), 58 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 4c31f69b..6123b28f 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -413,9 +413,19 @@ when you compile it.
 
 ## Release notes
 ## Upcoming release
+* Migrated from .NET Standard 2.0 to .NET 5.0.  
 * Added detection for Xbox app game folders.
 * Internal refactoring.
 
+**Troubleshooting:**  
+Due to the framework change, you might see build errors like _task failed unexpectedly_ that mentions `System.Runtime Version=5.0.0`. If so:
+
+1. Make sure you have Visual Studio 2022 or later.
+2. Exit all instances of Visual Studio.
+3. Delete the hidden `.vs` folder in your solution folder.
+4. Delete the `bin` and `obj` folders in each project folder.
+5. Reopen the solution and rebuild, and now it should work fine.
+
 ## 4.0.0
 Released 30 November 2021.
 
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj b/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
index 7ac3277e..69fd3dbd 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI.ModBuildConfig.Analyzer</RootNamespace>
     <Version>3.0.0</Version>
-    <TargetFramework>netstandard2.0</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <IncludeBuildOutput>false</IncludeBuildOutput>
     <OutputPath>bin</OutputPath>
     <LangVersion>latest</LangVersion>
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 82eac7f6..8e70293e 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <!--build-->
     <RootNamespace>StardewModdingAPI.ModBuildConfig</RootNamespace>
-    <TargetFramework>netstandard2.0</TargetFramework>
+    <TargetFramework>net5.0</TargetFramework>
     <LangVersion>latest</LangVersion>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <SuppressDependenciesWhenPacking>true</SuppressDependenciesWhenPacking>
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
index 4c92b4db..d69d53d5 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
+++ b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI</RootNamespace>
     <Description>Provides toolkit interfaces which are available to SMAPI mods.</Description>
-    <TargetFrameworks>net5.0; netstandard2.0</TargetFrameworks>
+    <TargetFrameworks>net5.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index ec27bf79..6a8c4c43 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI.Toolkit</RootNamespace>
     <Description>A library which encapsulates mod-handling logic for mod managers and tools. Not intended for use by mods.</Description>
-    <TargetFrameworks>net5.0; netstandard2.0</TargetFrameworks>
+    <TargetFrameworks>net5.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index cea8c447..ca9d15f5 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -198,12 +198,7 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="version">The version string.</param>
         /// <param name="parsed">The parsed representation.</param>
         /// <returns>Returns whether parsing the version succeeded.</returns>
-        public static bool TryParse(string? version,
-#if NET5_0_OR_GREATER
-            [NotNullWhen(true)]
-#endif
-            out ISemanticVersion? parsed
-        )
+        public static bool TryParse(string? version, [NotNullWhen(true)] out ISemanticVersion? parsed)
         {
             return SemanticVersion.TryParse(version, allowNonStandard: false, out parsed);
         }
@@ -213,12 +208,7 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="allowNonStandard">Whether to allow non-standard extensions to semantic versioning.</param>
         /// <param name="parsed">The parsed representation.</param>
         /// <returns>Returns whether parsing the version succeeded.</returns>
-        public static bool TryParse(string? version, bool allowNonStandard,
-#if NET5_0_OR_GREATER
-            [NotNullWhen(true)]
-#endif
-            out ISemanticVersion? parsed
-        )
+        public static bool TryParse(string? version, bool allowNonStandard, [NotNullWhen(true)] out ISemanticVersion? parsed)
         {
             if (version == null)
             {
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 01010602..3ab5edfb 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -115,9 +115,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         *********/
         /// <summary>Normalize whitespace in a raw string.</summary>
         /// <param name="input">The input to strip.</param>
-#if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("input")]
-#endif
         private string? NormalizeWhitespace(string? input)
         {
             return input
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
index f7dc8aa8..dcdbcf74 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
@@ -33,9 +33,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         *********/
         /// <summary>Normalize whitespace in a raw string.</summary>
         /// <param name="input">The input to strip.</param>
-#if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("input")]
-#endif
         private string? NormalizeWhitespace(string? input)
         {
             return input?.Trim();
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
index e7acf71d..64725818 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
@@ -54,9 +54,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         *********/
         /// <summary>Normalize whitespace in a raw string.</summary>
         /// <param name="input">The input to strip.</param>
-#if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("input")]
-#endif
         private string? NormalizeWhitespace(string? input)
         {
             return input?.Trim();
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index 9a0e2ea7..d035d4cd 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -92,43 +92,7 @@ namespace StardewModdingAPI.Toolkit.Utilities
         [Pure]
         public static string GetRelativePath(string sourceDir, string targetPath)
         {
-#if NET5_0
             return Path.GetRelativePath(sourceDir, targetPath);
-#else
-            // NOTE:
-            // this is a heuristic implementation that works in the cases SMAPI needs it for, but it
-            // doesn't handle all edge cases (e.g. case-sensitivity on Linux, or traversing between
-            // UNC paths on Windows). SMAPI and mods will use the more robust .NET 5 version anyway
-            // though, this is only for compatibility with the mod build package.
-
-            // convert to URIs
-            Uri from = new(sourceDir.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
-            Uri to = new(targetPath.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
-            if (from.Scheme != to.Scheme)
-                throw new InvalidOperationException($"Can't get path for '{targetPath}' relative to '{sourceDir}'.");
-
-            // get relative path
-            string rawUrl = Uri.UnescapeDataString(from.MakeRelativeUri(to).ToString());
-            if (rawUrl.StartsWith("file://"))
-                rawUrl = PathUtilities.WindowsUncRoot + rawUrl.Substring("file://".Length);
-            string relative = PathUtilities.NormalizePath(rawUrl);
-
-            // normalize
-            if (relative == "")
-                relative = ".";
-            else
-            {
-                // trim trailing slash from URL
-                if (relative.EndsWith(PathUtilities.PreferredPathSeparator.ToString()))
-                    relative = relative.Substring(0, relative.Length - 1);
-
-                // fix root
-                if (relative.StartsWith("file:") && !targetPath.Contains("file:"))
-                    relative = relative.Substring("file:".Length);
-            }
-
-            return relative;
-#endif
         }
 
         /// <summary>Get whether a path is relative and doesn't try to climb out of its containing folder (e.g. doesn't contain <c>../</c>).</summary>

From d706a25053cdc5d9f1ccc2c09dc3913f835c3f78 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Apr 2022 02:33:23 -0400
Subject: [PATCH 510/856] enable nullable annotations for most of the SMAPI
 toolkit (#837)

---
 src/SMAPI.Toolkit/Framework/Constants.cs      |  2 --
 .../Framework/GameScanning/GameScanner.cs     | 32 +++++++++----------
 .../Framework/LowLevelEnvironmentUtility.cs   |  8 ++---
 .../Framework/ModScanning/ModFolder.cs        | 14 ++++----
 .../Framework/ModScanning/ModScanner.cs       | 14 ++++----
 .../Framework/SemanticVersionReader.cs        |  6 ++--
 .../Framework/UpdateData/UpdateKey.cs         | 32 +++++++++----------
 src/SMAPI.Toolkit/ModToolkit.cs               | 12 +++----
 src/SMAPI.Toolkit/SemanticVersion.cs          |  2 +-
 src/SMAPI.Toolkit/SemanticVersionComparer.cs  |  4 +--
 .../ManifestContentPackForConverter.cs        |  6 ++--
 .../ManifestDependencyArrayConverter.cs       | 10 +++---
 .../Converters/SemanticVersionConverter.cs    | 14 ++++----
 .../Converters/SimpleReadOnlyConverter.cs     | 22 ++++++-------
 .../Serialization/InternalExtensions.cs       |  8 ++---
 src/SMAPI.Toolkit/Serialization/JsonHelper.cs | 17 +++++-----
 .../Models/ManifestDependency.cs              |  2 +-
 .../Serialization/SParseException.cs          |  4 +--
 .../Utilities/EnvironmentUtility.cs           |  4 ---
 src/SMAPI.Toolkit/Utilities/FileUtilities.cs  |  2 --
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs  | 29 +++++++++++------
 .../Framework/Serialization/ColorConverter.cs |  2 --
 .../Serialization/KeybindConverter.cs         |  6 ++--
 .../Framework/Serialization/PointConverter.cs |  2 --
 .../Serialization/RectangleConverter.cs       |  2 --
 .../Serialization/Vector2Converter.cs         |  2 --
 src/SMAPI/Utilities/PathUtilities.cs          | 16 ++++++----
 27 files changed, 126 insertions(+), 148 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/Constants.cs b/src/SMAPI.Toolkit/Framework/Constants.cs
index c3a787c7..55f26582 100644
--- a/src/SMAPI.Toolkit/Framework/Constants.cs
+++ b/src/SMAPI.Toolkit/Framework/Constants.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Toolkit.Framework
 {
     /// <summary>Contains the SMAPI installer's constants and assumptions.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index ac6fe411..4f872f1c 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -41,7 +39,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
             IEnumerable<string> paths = this
                 .GetCustomInstallPaths()
                 .Concat(this.GetDefaultInstallPaths())
-                .Select(PathUtilities.NormalizePath)
+                .Select(path => PathUtilities.NormalizePath(path))
                 .Distinct(StringComparer.OrdinalIgnoreCase);
 
             // yield valid folders
@@ -80,10 +78,12 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                 return GameFolderType.NoGameFound;
 
             // get assembly version
-            Version version;
+            Version? version;
             try
             {
                 version = AssemblyName.GetAssemblyName(executable.FullName).Version;
+                if (version == null)
+                    return GameFolderType.InvalidUnknown;
             }
             catch
             {
@@ -123,7 +123,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                 case Platform.Linux:
                 case Platform.Mac:
                     {
-                        string home = Environment.GetEnvironmentVariable("HOME");
+                        string home = Environment.GetEnvironmentVariable("HOME")!;
 
                         // Linux
                         yield return $"{home}/GOG Games/Stardew Valley/game";
@@ -148,13 +148,13 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                         };
                         foreach (var pair in registryKeys)
                         {
-                            string path = this.GetLocalMachineRegistryValue(pair.Key, pair.Value);
+                            string? path = this.GetLocalMachineRegistryValue(pair.Key, pair.Value);
                             if (!string.IsNullOrWhiteSpace(path))
                                 yield return path;
                         }
 
                         // via Steam library path
-                        string steamPath = this.GetCurrentUserRegistryValue(@"Software\Valve\Steam", "SteamPath");
+                        string? steamPath = this.GetCurrentUserRegistryValue(@"Software\Valve\Steam", "SteamPath");
                         if (steamPath != null)
                             yield return Path.Combine(steamPath.Replace('/', '\\'), @"steamapps\common\Stardew Valley");
 #endif
@@ -188,7 +188,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         private IEnumerable<string> GetCustomInstallPaths()
         {
             // get home path
-            string homePath = Environment.GetEnvironmentVariable(this.Platform == Platform.Windows ? "USERPROFILE" : "HOME");
+            string homePath = Environment.GetEnvironmentVariable(this.Platform == Platform.Windows ? "USERPROFILE" : "HOME")!;
             if (string.IsNullOrWhiteSpace(homePath))
                 yield break;
 
@@ -210,7 +210,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
             }
 
             // get install path
-            XElement element = root.XPathSelectElement("//*[local-name() = 'GamePath']"); // can't use '//GamePath' due to the default namespace
+            XElement? element = root.XPathSelectElement("//*[local-name() = 'GamePath']"); // can't use '//GamePath' due to the default namespace
             if (!string.IsNullOrWhiteSpace(element?.Value))
                 yield return element.Value.Trim();
         }
@@ -219,27 +219,27 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         /// <summary>Get the value of a key in the Windows HKLM registry.</summary>
         /// <param name="key">The full path of the registry key relative to HKLM.</param>
         /// <param name="name">The name of the value.</param>
-        private string GetLocalMachineRegistryValue(string key, string name)
+        private string? GetLocalMachineRegistryValue(string key, string name)
         {
             RegistryKey localMachine = Environment.Is64BitOperatingSystem ? RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry64) : Registry.LocalMachine;
-            RegistryKey openKey = localMachine.OpenSubKey(key);
+            RegistryKey? openKey = localMachine.OpenSubKey(key);
             if (openKey == null)
                 return null;
             using (openKey)
-                return (string)openKey.GetValue(name);
+                return (string?)openKey.GetValue(name);
         }
 
         /// <summary>Get the value of a key in the Windows HKCU registry.</summary>
         /// <param name="key">The full path of the registry key relative to HKCU.</param>
         /// <param name="name">The name of the value.</param>
-        private string GetCurrentUserRegistryValue(string key, string name)
+        private string? GetCurrentUserRegistryValue(string key, string name)
         {
-            RegistryKey currentuser = Environment.Is64BitOperatingSystem ? RegistryKey.OpenBaseKey(RegistryHive.CurrentUser, RegistryView.Registry64) : Registry.CurrentUser;
-            RegistryKey openKey = currentuser.OpenSubKey(key);
+            RegistryKey currentUser = Environment.Is64BitOperatingSystem ? RegistryKey.OpenBaseKey(RegistryHive.CurrentUser, RegistryView.Registry64) : Registry.CurrentUser;
+            RegistryKey? openKey = currentUser.OpenSubKey(key);
             if (openKey == null)
                 return null;
             using (openKey)
-                return (string)openKey.GetValue(name);
+                return (string?)openKey.GetValue(name);
         }
 #endif
     }
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index 9998edec..6978567e 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
@@ -59,11 +57,13 @@ namespace StardewModdingAPI.Toolkit.Framework
 #if SMAPI_FOR_WINDOWS
             try
             {
-                return new ManagementObjectSearcher("SELECT Caption FROM Win32_OperatingSystem")
+                string? result = new ManagementObjectSearcher("SELECT Caption FROM Win32_OperatingSystem")
                     .Get()
                     .Cast<ManagementObject>()
                     .Select(entry => entry.GetPropertyValue("Caption").ToString())
                     .FirstOrDefault();
+
+                return result ?? "Windows";
             }
             catch { }
 #endif
@@ -137,7 +137,7 @@ namespace StardewModdingAPI.Toolkit.Framework
                 buffer = Marshal.AllocHGlobal(8192);
                 if (LowLevelEnvironmentUtility.uname(buffer) == 0)
                 {
-                    string os = Marshal.PtrToStringAnsi(buffer);
+                    string? os = Marshal.PtrToStringAnsi(buffer);
                     return os == "Darwin";
                 }
                 return false;
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
index 81d72c0b..da2a3c85 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModFolder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -24,13 +22,13 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         public ModType Type { get; }
 
         /// <summary>The mod manifest.</summary>
-        public Manifest Manifest { get; }
+        public Manifest? Manifest { get; }
 
         /// <summary>The error which occurred parsing the manifest, if any.</summary>
         public ModParseError ManifestParseError { get; set; }
 
         /// <summary>A human-readable message for the <see cref="ManifestParseError"/>, if any.</summary>
-        public string ManifestParseErrorText { get; set; }
+        public string? ManifestParseErrorText { get; set; }
 
 
         /*********
@@ -51,7 +49,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         /// <param name="manifest">The mod manifest.</param>
         /// <param name="manifestParseError">The error which occurred parsing the manifest, if any.</param>
         /// <param name="manifestParseErrorText">A human-readable message for the <paramref name="manifestParseError"/>, if any.</param>
-        public ModFolder(DirectoryInfo root, DirectoryInfo directory, ModType type, Manifest manifest, ModParseError manifestParseError, string manifestParseErrorText)
+        public ModFolder(DirectoryInfo root, DirectoryInfo directory, ModType type, Manifest? manifest, ModParseError manifestParseError, string? manifestParseErrorText)
         {
             // save info
             this.Directory = directory;
@@ -61,9 +59,9 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             this.ManifestParseErrorText = manifestParseErrorText;
 
             // set display name
-            this.DisplayName = manifest?.Name;
-            if (string.IsNullOrWhiteSpace(this.DisplayName))
-                this.DisplayName = PathUtilities.GetRelativePath(root.FullName, directory.FullName);
+            this.DisplayName = !string.IsNullOrWhiteSpace(manifest?.Name)
+                ? manifest.Name
+                : PathUtilities.GetRelativePath(root.FullName, directory.FullName);
         }
 
         /// <summary>Get the update keys for a mod.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 621f1e28..2af30092 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -117,7 +115,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         public ModFolder ReadFolder(DirectoryInfo root, DirectoryInfo searchFolder)
         {
             // find manifest.json
-            FileInfo manifestFile = this.FindManifest(searchFolder);
+            FileInfo? manifestFile = this.FindManifest(searchFolder);
 
             // set appropriate invalid-mod error
             if (manifestFile == null)
@@ -147,13 +145,13 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             }
 
             // read mod info
-            Manifest manifest = null;
+            Manifest? manifest = null;
             ModParseError error = ModParseError.None;
-            string errorText = null;
+            string? errorText = null;
             {
                 try
                 {
-                    if (!this.JsonHelper.ReadJsonFileIfExists<Manifest>(manifestFile.FullName, out manifest) || manifest == null)
+                    if (!this.JsonHelper.ReadJsonFileIfExists<Manifest>(manifestFile.FullName, out manifest))
                     {
                         error = ModParseError.ManifestInvalid;
                         errorText = "its manifest is invalid.";
@@ -186,7 +184,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             }
 
             // build result
-            return new ModFolder(root, manifestFile.Directory, type, manifest, error, errorText);
+            return new ModFolder(root, manifestFile.Directory!, type, manifest, error, errorText);
         }
 
 
@@ -249,7 +247,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 
         /// <summary>Find the manifest for a mod folder.</summary>
         /// <param name="folder">The folder to search.</param>
-        private FileInfo FindManifest(DirectoryInfo folder)
+        private FileInfo? FindManifest(DirectoryInfo folder)
         {
             while (true)
             {
diff --git a/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs b/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
index 57eea2f7..836b1134 100644
--- a/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
+++ b/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Toolkit.Framework
 {
@@ -18,7 +18,7 @@ namespace StardewModdingAPI.Toolkit.Framework
         /// <param name="prereleaseTag">An optional prerelease tag.</param>
         /// <param name="buildMetadata">Optional build metadata. This is ignored when determining version precedence.</param>
         /// <returns>Returns whether the version was successfully parsed.</returns>
-        public static bool TryParse(string versionStr, bool allowNonStandard, out int major, out int minor, out int patch, out int platformRelease, out string prereleaseTag, out string buildMetadata)
+        public static bool TryParse(string? versionStr, bool allowNonStandard, out int major, out int minor, out int patch, out int platformRelease, out string? prereleaseTag, out string? buildMetadata)
         {
             // init
             major = 0;
@@ -105,7 +105,7 @@ namespace StardewModdingAPI.Toolkit.Framework
         /// <param name="raw">The raw characters to parse.</param>
         /// <param name="index">The index of the next character to read.</param>
         /// <param name="tag">The parsed tag.</param>
-        private static bool TryParseTag(char[] raw, ref int index, out string tag)
+        private static bool TryParseTag(char[] raw, ref int index, [NotNullWhen(true)] out string? tag)
         {
             // read tag length
             int length = 0;
diff --git a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
index ec94ed51..d40d8f2b 100644
--- a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
+++ b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Toolkit.Framework.UpdateData
 {
@@ -17,10 +16,11 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
         public ModSiteKey Site { get; }
 
         /// <summary>The mod ID within the repository.</summary>
-        public string ID { get; }
+        [MemberNotNullWhen(true, nameof(LooksValid))]
+        public string? ID { get; }
 
         /// <summary>If specified, a substring in download names/descriptions to match.</summary>
-        public string Subkey { get; }
+        public string? Subkey { get; }
 
         /// <summary>Whether the update key seems to be valid.</summary>
         public bool LooksValid { get; }
@@ -34,9 +34,9 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
         /// <param name="site">The mod site containing the mod.</param>
         /// <param name="id">The mod ID within the site.</param>
         /// <param name="subkey">If specified, a substring in download names/descriptions to match.</param>
-        public UpdateKey(string rawText, ModSiteKey site, string id, string subkey)
+        public UpdateKey(string? rawText, ModSiteKey site, string? id, string? subkey)
         {
-            this.RawText = rawText?.Trim();
+            this.RawText = rawText?.Trim() ?? string.Empty;
             this.Site = site;
             this.ID = id?.Trim();
             this.Subkey = subkey?.Trim();
@@ -49,19 +49,19 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
         /// <param name="site">The mod site containing the mod.</param>
         /// <param name="id">The mod ID within the site.</param>
         /// <param name="subkey">If specified, a substring in download names/descriptions to match.</param>
-        public UpdateKey(ModSiteKey site, string id, string subkey)
+        public UpdateKey(ModSiteKey site, string? id, string? subkey)
             : this(UpdateKey.GetString(site, id, subkey), site, id, subkey) { }
 
         /// <summary>Parse a raw update key.</summary>
         /// <param name="raw">The raw update key to parse.</param>
-        public static UpdateKey Parse(string raw)
+        public static UpdateKey Parse(string? raw)
         {
             // extract site + ID
-            string rawSite;
-            string id;
+            string? rawSite;
+            string? id;
             {
-                string[] parts = raw?.Trim().Split(':');
-                if (parts == null || parts.Length != 2)
+                string[]? parts = raw?.Trim().Split(':');
+                if (parts?.Length != 2)
                     return new UpdateKey(raw, ModSiteKey.Unknown, null, null);
 
                 rawSite = parts[0].Trim();
@@ -71,7 +71,7 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
                 id = null;
 
             // extract subkey
-            string subkey = null;
+            string? subkey = null;
             if (id != null)
             {
                 string[] parts = id.Split('@');
@@ -111,7 +111,7 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
 
         /// <summary>Indicates whether the current object is equal to another object of the same type.</summary>
         /// <param name="other">An object to compare with this object.</param>
-        public bool Equals(UpdateKey other)
+        public bool Equals(UpdateKey? other)
         {
             if (!this.LooksValid)
             {
@@ -129,7 +129,7 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
 
         /// <summary>Determines whether the specified object is equal to the current object.</summary>
         /// <param name="obj">The object to compare with the current object.</param>
-        public override bool Equals(object obj)
+        public override bool Equals(object? obj)
         {
             return obj is UpdateKey other && this.Equals(other);
         }
@@ -145,7 +145,7 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
         /// <param name="site">The mod site containing the mod.</param>
         /// <param name="id">The mod ID within the repository.</param>
         /// <param name="subkey">If specified, a substring in download names/descriptions to match.</param>
-        public static string GetString(ModSiteKey site, string id, string subkey = null)
+        public static string GetString(ModSiteKey site, string? id, string? subkey = null)
         {
             return $"{site}:{id}{subkey}".Trim();
         }
diff --git a/src/SMAPI.Toolkit/ModToolkit.cs b/src/SMAPI.Toolkit/ModToolkit.cs
index 9ae8cd1c..51f6fa24 100644
--- a/src/SMAPI.Toolkit/ModToolkit.cs
+++ b/src/SMAPI.Toolkit/ModToolkit.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -24,7 +22,7 @@ namespace StardewModdingAPI.Toolkit
         private readonly string UserAgent;
 
         /// <summary>Maps vendor keys (like <c>Nexus</c>) to their mod URL template (where <c>{0}</c> is the mod ID). This doesn't affect update checks, which defer to the remote web API.</summary>
-        private readonly IDictionary<ModSiteKey, string> VendorModUrls = new Dictionary<ModSiteKey, string>()
+        private readonly Dictionary<ModSiteKey, string> VendorModUrls = new()
         {
             [ModSiteKey.Chucklefish] = "https://community.playstarbound.com/resources/{0}",
             [ModSiteKey.GitHub] = "https://github.com/{0}/releases",
@@ -45,7 +43,7 @@ namespace StardewModdingAPI.Toolkit
         /// <summary>Construct an instance.</summary>
         public ModToolkit()
         {
-            ISemanticVersion version = new SemanticVersion(this.GetType().Assembly.GetName().Version);
+            ISemanticVersion version = new SemanticVersion(this.GetType().Assembly.GetName().Version!);
             this.UserAgent = $"SMAPI Mod Handler Toolkit/{version}";
         }
 
@@ -59,7 +57,7 @@ namespace StardewModdingAPI.Toolkit
         /// <summary>Extract mod metadata from the wiki compatibility list.</summary>
         public async Task<WikiModList> GetWikiCompatibilityListAsync()
         {
-            var client = new WikiClient(this.UserAgent);
+            WikiClient client = new(this.UserAgent);
             return await client.FetchModsAsync();
         }
 
@@ -89,13 +87,13 @@ namespace StardewModdingAPI.Toolkit
 
         /// <summary>Get an update URL for an update key (if valid).</summary>
         /// <param name="updateKey">The update key.</param>
-        public string GetUpdateUrl(string updateKey)
+        public string? GetUpdateUrl(string updateKey)
         {
             UpdateKey parsed = UpdateKey.Parse(updateKey);
             if (!parsed.LooksValid)
                 return null;
 
-            if (this.VendorModUrls.TryGetValue(parsed.Site, out string urlTemplate))
+            if (this.VendorModUrls.TryGetValue(parsed.Site, out string? urlTemplate))
                 return string.Format(urlTemplate, parsed.ID);
 
             return null;
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index ca9d15f5..cbdd7a85 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -91,7 +91,7 @@ namespace StardewModdingAPI.Toolkit
         {
             if (version == null)
                 throw new ArgumentNullException(nameof(version), "The input version string can't be null.");
-            if (!SemanticVersionReader.TryParse(version, allowNonStandard, out int major, out int minor, out int patch, out int platformRelease, out string prereleaseTag, out string buildMetadata) || (!allowNonStandard && platformRelease != 0))
+            if (!SemanticVersionReader.TryParse(version, allowNonStandard, out int major, out int minor, out int patch, out int platformRelease, out string? prereleaseTag, out string? buildMetadata) || (!allowNonStandard && platformRelease != 0))
                 throw new FormatException($"The input '{version}' isn't a valid semantic version.");
 
             this.MajorVersion = major;
diff --git a/src/SMAPI.Toolkit/SemanticVersionComparer.cs b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
index a0472f62..85c974bd 100644
--- a/src/SMAPI.Toolkit/SemanticVersionComparer.cs
+++ b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Toolkit
@@ -18,7 +16,7 @@ namespace StardewModdingAPI.Toolkit
         ** Public methods
         *********/
         /// <inheritdoc />
-        public int Compare(ISemanticVersion x, ISemanticVersion y)
+        public int Compare(ISemanticVersion? x, ISemanticVersion? y)
         {
             if (object.ReferenceEquals(x, y))
                 return 0;
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/ManifestContentPackForConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/ManifestContentPackForConverter.cs
index d2dc0d22..faaeedea 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/ManifestContentPackForConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/ManifestContentPackForConverter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Models;
@@ -35,7 +33,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         /// <param name="objectType">The object type.</param>
         /// <param name="existingValue">The object being read.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
+        public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer)
         {
             return serializer.Deserialize<ManifestContentPackFor>(reader);
         }
@@ -44,7 +42,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         /// <param name="writer">The JSON writer.</param>
         /// <param name="value">The value.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
+        public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             throw new InvalidOperationException("This converter does not write JSON.");
         }
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/ManifestDependencyArrayConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/ManifestDependencyArrayConverter.cs
index 2c3c2ee7..c499a2c6 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/ManifestDependencyArrayConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/ManifestDependencyArrayConverter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using Newtonsoft.Json;
@@ -37,13 +35,13 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         /// <param name="objectType">The object type.</param>
         /// <param name="existingValue">The object being read.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
+        public override object ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer)
         {
             List<ManifestDependency> result = new List<ManifestDependency>();
             foreach (JObject obj in JArray.Load(reader).Children<JObject>())
             {
-                string uniqueID = obj.ValueIgnoreCase<string>(nameof(ManifestDependency.UniqueID));
-                string minVersion = obj.ValueIgnoreCase<string>(nameof(ManifestDependency.MinimumVersion));
+                string uniqueID = obj.ValueIgnoreCase<string>(nameof(ManifestDependency.UniqueID))!; // will be validated separately if null
+                string? minVersion = obj.ValueIgnoreCase<string>(nameof(ManifestDependency.MinimumVersion));
                 bool required = obj.ValueIgnoreCase<bool?>(nameof(ManifestDependency.IsRequired)) ?? true;
                 result.Add(new ManifestDependency(uniqueID, minVersion, required));
             }
@@ -54,7 +52,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         /// <param name="writer">The JSON writer.</param>
         /// <param name="value">The value.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
+        public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             throw new InvalidOperationException("This converter does not write JSON.");
         }
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
index 9205cebe..c32c3185 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
@@ -41,15 +39,17 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         /// <param name="objectType">The object type.</param>
         /// <param name="existingValue">The object being read.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
+        public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer)
         {
             string path = reader.Path;
             switch (reader.TokenType)
             {
                 case JsonToken.StartObject:
                     return this.ReadObject(JObject.Load(reader));
+
                 case JsonToken.String:
                     return this.ReadString(JToken.Load(reader).Value<string>(), path);
+
                 default:
                     throw new SParseException($"Can't parse {nameof(ISemanticVersion)} from {reader.TokenType} node (path: {reader.Path}).");
             }
@@ -59,7 +59,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         /// <param name="writer">The JSON writer.</param>
         /// <param name="value">The value.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
+        public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             writer.WriteValue(value?.ToString());
         }
@@ -75,7 +75,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
             int major = obj.ValueIgnoreCase<int>(nameof(ISemanticVersion.MajorVersion));
             int minor = obj.ValueIgnoreCase<int>(nameof(ISemanticVersion.MinorVersion));
             int patch = obj.ValueIgnoreCase<int>(nameof(ISemanticVersion.PatchVersion));
-            string prereleaseTag = obj.ValueIgnoreCase<string>(nameof(ISemanticVersion.PrereleaseTag));
+            string? prereleaseTag = obj.ValueIgnoreCase<string>(nameof(ISemanticVersion.PrereleaseTag));
 
             return new SemanticVersion(major, minor, patch, prereleaseTag: prereleaseTag);
         }
@@ -83,11 +83,11 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
         /// <summary>Read a JSON string.</summary>
         /// <param name="str">The JSON string value.</param>
         /// <param name="path">The path to the current JSON node.</param>
-        private ISemanticVersion ReadString(string str, string path)
+        private ISemanticVersion? ReadString(string str, string path)
         {
             if (string.IsNullOrWhiteSpace(str))
                 return null;
-            if (!SemanticVersion.TryParse(str, allowNonStandard: this.AllowNonStandard, out ISemanticVersion version))
+            if (!SemanticVersion.TryParse(str, allowNonStandard: this.AllowNonStandard, out ISemanticVersion? version))
                 throw new SParseException($"Can't parse semantic version from invalid value '{str}', should be formatted like 1.2, 1.2.30, or 1.2.30-beta (path: {path}).");
             return version;
         }
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
index c923350c..1c59f5e7 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
@@ -27,21 +25,12 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
             return objectType == typeof(T) || Nullable.GetUnderlyingType(objectType) == typeof(T);
         }
 
-        /// <summary>Writes the JSON representation of the object.</summary>
-        /// <param name="writer">The JSON writer.</param>
-        /// <param name="value">The value.</param>
-        /// <param name="serializer">The calling serializer.</param>
-        public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
-        {
-            throw new InvalidOperationException("This converter does not write JSON.");
-        }
-
         /// <summary>Reads the JSON representation of the object.</summary>
         /// <param name="reader">The JSON reader.</param>
         /// <param name="objectType">The object type.</param>
         /// <param name="existingValue">The object being read.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
+        public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer)
         {
             string path = reader.Path;
             switch (reader.TokenType)
@@ -60,6 +49,15 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
             }
         }
 
+        /// <summary>Writes the JSON representation of the object.</summary>
+        /// <param name="writer">The JSON writer.</param>
+        /// <param name="value">The value.</param>
+        /// <param name="serializer">The calling serializer.</param>
+        public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
+        {
+            throw new InvalidOperationException("This converter does not write JSON.");
+        }
+
 
         /*********
         ** Protected methods
diff --git a/src/SMAPI.Toolkit/Serialization/InternalExtensions.cs b/src/SMAPI.Toolkit/Serialization/InternalExtensions.cs
index 1fce5f9d..78297035 100644
--- a/src/SMAPI.Toolkit/Serialization/InternalExtensions.cs
+++ b/src/SMAPI.Toolkit/Serialization/InternalExtensions.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Newtonsoft.Json.Linq;
 
@@ -12,12 +10,12 @@ namespace StardewModdingAPI.Toolkit.Serialization
         /// <typeparam name="T">The value type.</typeparam>
         /// <param name="obj">The JSON object to search.</param>
         /// <param name="fieldName">The field name.</param>
-        public static T ValueIgnoreCase<T>(this JObject obj, string fieldName)
+        public static T? ValueIgnoreCase<T>(this JObject obj, string fieldName)
         {
-            JToken token = obj.GetValue(fieldName, StringComparison.OrdinalIgnoreCase);
+            JToken? token = obj.GetValue(fieldName, StringComparison.OrdinalIgnoreCase);
             return token != null
                 ? token.Value<T>()
-                : default(T);
+                : default;
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
index 9700e712..7d1804e5 100644
--- a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
+++ b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
@@ -38,7 +37,7 @@ namespace StardewModdingAPI.Toolkit.Serialization
         /// <returns>Returns false if the file doesn't exist, else true.</returns>
         /// <exception cref="ArgumentException">The given <paramref name="fullPath"/> is empty or invalid.</exception>
         /// <exception cref="JsonReaderException">The file contains invalid JSON.</exception>
-        public bool ReadJsonFileIfExists<TModel>(string fullPath, out TModel result)
+        public bool ReadJsonFileIfExists<TModel>(string fullPath, [NotNullWhen(true)] out TModel? result)
         {
             // validate
             if (string.IsNullOrWhiteSpace(fullPath))
@@ -52,7 +51,7 @@ namespace StardewModdingAPI.Toolkit.Serialization
             }
             catch (Exception ex) when (ex is DirectoryNotFoundException or FileNotFoundException)
             {
-                result = default(TModel);
+                result = default;
                 return false;
             }
 
@@ -60,7 +59,7 @@ namespace StardewModdingAPI.Toolkit.Serialization
             try
             {
                 result = this.Deserialize<TModel>(json);
-                return true;
+                return result != null;
             }
             catch (Exception ex)
             {
@@ -90,7 +89,7 @@ namespace StardewModdingAPI.Toolkit.Serialization
                 throw new ArgumentException("The file path is empty or invalid.", nameof(fullPath));
 
             // create directory if needed
-            string dir = Path.GetDirectoryName(fullPath);
+            string dir = Path.GetDirectoryName(fullPath)!;
             if (dir == null)
                 throw new ArgumentException("The file path is invalid.", nameof(fullPath));
             if (!Directory.Exists(dir))
@@ -108,7 +107,8 @@ namespace StardewModdingAPI.Toolkit.Serialization
         {
             try
             {
-                return JsonConvert.DeserializeObject<TModel>(json, this.JsonSettings);
+                return JsonConvert.DeserializeObject<TModel>(json, this.JsonSettings)
+                    ?? throw new InvalidOperationException($"Couldn't deserialize model type '{typeof(TModel)}' from empty or null JSON.");
             }
             catch (JsonReaderException)
             {
@@ -117,7 +117,8 @@ namespace StardewModdingAPI.Toolkit.Serialization
                 {
                     try
                     {
-                        return JsonConvert.DeserializeObject<TModel>(json.Replace('“', '"').Replace('”', '"'), this.JsonSettings);
+                        return JsonConvert.DeserializeObject<TModel>(json.Replace('“', '"').Replace('”', '"'), this.JsonSettings)
+                            ?? throw new InvalidOperationException($"Couldn't deserialize model type '{typeof(TModel)}' from empty or null JSON.");
                     }
                     catch { /* rethrow original error */ }
                 }
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
index 64725818..5d1b73b1 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
@@ -26,7 +26,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         /// <param name="uniqueID">The unique mod ID to require.</param>
         /// <param name="minimumVersion">The minimum required version (if any).</param>
         /// <param name="required">Whether the dependency must be installed to use the mod.</param>
-        public ManifestDependency(string uniqueID, string minimumVersion, bool required = true)
+        public ManifestDependency(string uniqueID, string? minimumVersion, bool required = true)
             : this(
                 uniqueID: uniqueID,
                 minimumVersion: !string.IsNullOrWhiteSpace(minimumVersion)
diff --git a/src/SMAPI.Toolkit/Serialization/SParseException.cs b/src/SMAPI.Toolkit/Serialization/SParseException.cs
index 1581e027..c2b3f68e 100644
--- a/src/SMAPI.Toolkit/Serialization/SParseException.cs
+++ b/src/SMAPI.Toolkit/Serialization/SParseException.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Toolkit.Serialization
@@ -13,7 +11,7 @@ namespace StardewModdingAPI.Toolkit.Serialization
         /// <summary>Construct an instance.</summary>
         /// <param name="message">The error message.</param>
         /// <param name="ex">The underlying exception, if any.</param>
-        public SParseException(string message, Exception ex = null)
+        public SParseException(string message, Exception? ex = null)
             : base(message, ex) { }
     }
 }
diff --git a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
index f14678be..1791c5b3 100644
--- a/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Utilities/EnvironmentUtility.cs
@@ -1,7 +1,4 @@
-#nullable disable
-
 using System;
-using System.Diagnostics.CodeAnalysis;
 using StardewModdingAPI.Toolkit.Framework;
 
 namespace StardewModdingAPI.Toolkit.Utilities
@@ -36,7 +33,6 @@ namespace StardewModdingAPI.Toolkit.Utilities
 
         /// <summary>Get the human-readable OS name and version.</summary>
         /// <param name="platform">The current platform.</param>
-        [SuppressMessage("ReSharper", "EmptyGeneralCatchClause", Justification = "Error suppressed deliberately to fallback to default behaviour.")]
         public static string GetFriendlyPlatformName(Platform platform)
         {
             return LowLevelEnvironmentUtility.GetFriendlyPlatformName(platform.ToString());
diff --git a/src/SMAPI.Toolkit/Utilities/FileUtilities.cs b/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
index ba2d0f47..a6bf5929 100644
--- a/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/FileUtilities.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.IO;
 using System.Security.Cryptography;
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index d035d4cd..9b7a78a0 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Diagnostics.Contracts;
 using System.IO;
 using System.Linq;
@@ -38,8 +37,11 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <param name="path">The path to split.</param>
         /// <param name="limit">The number of segments to match. Any additional segments will be merged into the last returned part.</param>
         [Pure]
-        public static string[] GetSegments(string path, int? limit = null)
+        public static string[] GetSegments(string? path, int? limit = null)
         {
+            if (path == null)
+                return Array.Empty<string>();
+
             return limit.HasValue
                 ? path.Split(PathUtilities.PossiblePathSeparators, limit.Value, StringSplitOptions.RemoveEmptyEntries)
                 : path.Split(PathUtilities.PossiblePathSeparators, StringSplitOptions.RemoveEmptyEntries);
@@ -47,8 +49,14 @@ namespace StardewModdingAPI.Toolkit.Utilities
 
         /// <summary>Normalize an asset name to match how MonoGame's content APIs would normalize and cache it.</summary>
         /// <param name="assetName">The asset name to normalize.</param>
-        public static string NormalizeAssetName(string assetName)
+        [Pure]
+        [return: NotNullIfNotNull("assetName")]
+        public static string? NormalizeAssetName(string? assetName)
         {
+            assetName = assetName?.Trim();
+            if (string.IsNullOrEmpty(assetName))
+                return assetName;
+
             return string.Join(PathUtilities.PreferredAssetSeparator.ToString(), PathUtilities.GetSegments(assetName)); // based on MonoGame's ContentManager.Load<T> logic
         }
 
@@ -56,7 +64,8 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <param name="path">The file path to normalize.</param>
         /// <remarks>This should only be used for file paths. For asset names, use <see cref="NormalizeAssetName"/> instead.</remarks>
         [Pure]
-        public static string NormalizePath(string path)
+        [return: NotNullIfNotNull("path")]
+        public static string? NormalizePath(string? path)
         {
             path = path?.Trim();
             if (string.IsNullOrEmpty(path))
@@ -80,7 +89,7 @@ namespace StardewModdingAPI.Toolkit.Utilities
             }
 
             // keep trailing separator
-            if ((!hasRoot || segments.Any()) && PathUtilities.PossiblePathSeparators.Contains(path[path.Length - 1]))
+            if ((!hasRoot || segments.Any()) && PathUtilities.PossiblePathSeparators.Contains(path[^1]))
                 newPath += PathUtilities.PreferredPathSeparator;
 
             return newPath;
@@ -98,7 +107,7 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <summary>Get whether a path is relative and doesn't try to climb out of its containing folder (e.g. doesn't contain <c>../</c>).</summary>
         /// <param name="path">The path to check.</param>
         [Pure]
-        public static bool IsSafeRelativePath(string path)
+        public static bool IsSafeRelativePath(string? path)
         {
             if (string.IsNullOrWhiteSpace(path))
                 return true;
@@ -111,9 +120,11 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <summary>Get whether a string is a valid 'slug', containing only basic characters that are safe in all contexts (e.g. filenames, URLs, etc).</summary>
         /// <param name="str">The string to check.</param>
         [Pure]
-        public static bool IsSlug(string str)
+        public static bool IsSlug(string? str)
         {
-            return !Regex.IsMatch(str, "[^a-z0-9_.-]", RegexOptions.IgnoreCase);
+            return
+                string.IsNullOrWhiteSpace(str)
+                || !Regex.IsMatch(str, "[^a-z0-9_.-]", RegexOptions.IgnoreCase);
         }
     }
 }
diff --git a/src/SMAPI/Framework/Serialization/ColorConverter.cs b/src/SMAPI/Framework/Serialization/ColorConverter.cs
index 8fb6cd9c..3b3720b5 100644
--- a/src/SMAPI/Framework/Serialization/ColorConverter.cs
+++ b/src/SMAPI/Framework/Serialization/ColorConverter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI/Framework/Serialization/KeybindConverter.cs b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
index 9cf52228..f3bab20d 100644
--- a/src/SMAPI/Framework/Serialization/KeybindConverter.cs
+++ b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
@@ -38,7 +36,7 @@ namespace StardewModdingAPI.Framework.Serialization
         /// <param name="objectType">The object type.</param>
         /// <param name="existingValue">The object being read.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
+        public override object ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer)
         {
             string path = reader.Path;
 
@@ -76,7 +74,7 @@ namespace StardewModdingAPI.Framework.Serialization
         /// <param name="writer">The JSON writer.</param>
         /// <param name="value">The value.</param>
         /// <param name="serializer">The calling serializer.</param>
-        public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
+        public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             writer.WriteValue(value?.ToString());
         }
diff --git a/src/SMAPI/Framework/Serialization/PointConverter.cs b/src/SMAPI/Framework/Serialization/PointConverter.cs
index b48d757a..21d1f845 100644
--- a/src/SMAPI/Framework/Serialization/PointConverter.cs
+++ b/src/SMAPI/Framework/Serialization/PointConverter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI/Framework/Serialization/RectangleConverter.cs b/src/SMAPI/Framework/Serialization/RectangleConverter.cs
index 7f060e3a..31f3ad77 100644
--- a/src/SMAPI/Framework/Serialization/RectangleConverter.cs
+++ b/src/SMAPI/Framework/Serialization/RectangleConverter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Text.RegularExpressions;
 using Microsoft.Xna.Framework;
diff --git a/src/SMAPI/Framework/Serialization/Vector2Converter.cs b/src/SMAPI/Framework/Serialization/Vector2Converter.cs
index bcd483d3..589febf8 100644
--- a/src/SMAPI/Framework/Serialization/Vector2Converter.cs
+++ b/src/SMAPI/Framework/Serialization/Vector2Converter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework;
 using Newtonsoft.Json.Linq;
diff --git a/src/SMAPI/Utilities/PathUtilities.cs b/src/SMAPI/Utilities/PathUtilities.cs
index e8ab9645..4350f441 100644
--- a/src/SMAPI/Utilities/PathUtilities.cs
+++ b/src/SMAPI/Utilities/PathUtilities.cs
@@ -1,5 +1,4 @@
-#nullable disable
-
+using System.Diagnostics.CodeAnalysis;
 using System.Diagnostics.Contracts;
 using ToolkitPathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 
@@ -22,14 +21,16 @@ namespace StardewModdingAPI.Utilities
         /// <param name="path">The path to split.</param>
         /// <param name="limit">The number of segments to match. Any additional segments will be merged into the last returned part.</param>
         [Pure]
-        public static string[] GetSegments(string path, int? limit = null)
+        public static string[] GetSegments(string? path, int? limit = null)
         {
             return ToolkitPathUtilities.GetSegments(path, limit);
         }
 
         /// <summary>Normalize an asset name to match how MonoGame's content APIs would normalize and cache it.</summary>
         /// <param name="assetName">The asset name to normalize.</param>
-        public static string NormalizeAssetName(string assetName)
+        [Pure]
+        [return: NotNullIfNotNull("assetName")]
+        public static string? NormalizeAssetName(string? assetName)
         {
             return ToolkitPathUtilities.NormalizeAssetName(assetName);
         }
@@ -38,7 +39,8 @@ namespace StardewModdingAPI.Utilities
         /// <param name="path">The file path to normalize.</param>
         /// <remarks>This should only be used for file paths. For asset names, use <see cref="NormalizeAssetName"/> instead.</remarks>
         [Pure]
-        public static string NormalizePath(string path)
+        [return: NotNullIfNotNull("path")]
+        public static string? NormalizePath(string? path)
         {
             return ToolkitPathUtilities.NormalizePath(path);
         }
@@ -46,7 +48,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get whether a path is relative and doesn't try to climb out of its containing folder (e.g. doesn't contain <c>../</c>).</summary>
         /// <param name="path">The path to check.</param>
         [Pure]
-        public static bool IsSafeRelativePath(string path)
+        public static bool IsSafeRelativePath(string? path)
         {
             return ToolkitPathUtilities.IsSafeRelativePath(path);
         }
@@ -54,7 +56,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get whether a string is a valid 'slug', containing only basic characters that are safe in all contexts (e.g. filenames, URLs, etc).</summary>
         /// <param name="str">The string to check.</param>
         [Pure]
-        public static bool IsSlug(string str)
+        public static bool IsSlug(string? str)
         {
             return ToolkitPathUtilities.IsSlug(str);
         }

From df955c0d3e0110be0893082de0c82187de63d9d2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Apr 2022 18:46:29 -0400
Subject: [PATCH 511/856] enable asset caching for GameContentHelper

---
 src/SMAPI/Framework/ModHelpers/GameContentHelper.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
index ed0c46d5..956bac7f 100644
--- a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
@@ -75,7 +75,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             try
             {
-                return this.GameContentManager.LoadLocalized<T>(assetName, this.CurrentLocaleConstant, useCache: false);
+                return this.GameContentManager.LoadLocalized<T>(assetName, this.CurrentLocaleConstant, useCache: true);
             }
             catch (Exception ex) when (ex is not SContentLoadException)
             {

From 238045ba9c5937f684cad3c55a8f9b9c2733e45f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 7 Apr 2022 22:19:48 -0400
Subject: [PATCH 512/856] reverse mod build package migration to .NET 5 (#837)

The migrated package didn't work consistently in VIsual Studio, so this suppresses nullable annotations in .NET Standard instead.
---
 build/common.targets                          |  5 ++-
 docs/technical/mod-package.md                 | 10 -----
 .../SMAPI.ModBuildConfig.Analyzer.csproj      |  2 +-
 .../SMAPI.ModBuildConfig.csproj               |  2 +-
 .../SMAPI.Toolkit.CoreInterfaces.csproj       |  2 +-
 .../Framework/SemanticVersionReader.cs        |  7 +++-
 .../Framework/UpdateData/UpdateKey.cs         |  2 +
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj        |  2 +-
 src/SMAPI.Toolkit/SemanticVersion.cs          | 14 ++++++-
 src/SMAPI.Toolkit/Serialization/JsonHelper.cs |  7 +++-
 .../Serialization/Models/Manifest.cs          |  2 +
 .../Models/ManifestContentPackFor.cs          |  2 +
 .../Models/ManifestDependency.cs              |  2 +
 src/SMAPI.Toolkit/Utilities/PathUtilities.cs  | 42 ++++++++++++++++++-
 14 files changed, 81 insertions(+), 20 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 258b48f2..c227190a 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -5,7 +5,10 @@
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
-    <Nullable>enable</Nullable>
+
+    <!--enable nullable annotations, except in .NET Standard 2.0 where they aren't supported-->
+    <Nullable Condition="'$(TargetFramework)' == 'net5.0'">enable</Nullable>
+    <NoWarn Condition="'$(TargetFramework)' != 'net5.0'">$(NoWarn);CS8632</NoWarn>
 
     <!--set platform-->
     <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 6123b28f..4c31f69b 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -413,19 +413,9 @@ when you compile it.
 
 ## Release notes
 ## Upcoming release
-* Migrated from .NET Standard 2.0 to .NET 5.0.  
 * Added detection for Xbox app game folders.
 * Internal refactoring.
 
-**Troubleshooting:**  
-Due to the framework change, you might see build errors like _task failed unexpectedly_ that mentions `System.Runtime Version=5.0.0`. If so:
-
-1. Make sure you have Visual Studio 2022 or later.
-2. Exit all instances of Visual Studio.
-3. Delete the hidden `.vs` folder in your solution folder.
-4. Delete the `bin` and `obj` folders in each project folder.
-5. Reopen the solution and rebuild, and now it should work fine.
-
 ## 4.0.0
 Released 30 November 2021.
 
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj b/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
index 69fd3dbd..7ac3277e 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer/SMAPI.ModBuildConfig.Analyzer.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI.ModBuildConfig.Analyzer</RootNamespace>
     <Version>3.0.0</Version>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>netstandard2.0</TargetFramework>
     <IncludeBuildOutput>false</IncludeBuildOutput>
     <OutputPath>bin</OutputPath>
     <LangVersion>latest</LangVersion>
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 8e70293e..82eac7f6 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <!--build-->
     <RootNamespace>StardewModdingAPI.ModBuildConfig</RootNamespace>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>netstandard2.0</TargetFramework>
     <LangVersion>latest</LangVersion>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <SuppressDependenciesWhenPacking>true</SuppressDependenciesWhenPacking>
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
index d69d53d5..4c92b4db 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
+++ b/src/SMAPI.Toolkit.CoreInterfaces/SMAPI.Toolkit.CoreInterfaces.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI</RootNamespace>
     <Description>Provides toolkit interfaces which are available to SMAPI mods.</Description>
-    <TargetFrameworks>net5.0</TargetFrameworks>
+    <TargetFrameworks>net5.0; netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs b/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
index 836b1134..939be771 100644
--- a/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
+++ b/src/SMAPI.Toolkit/Framework/SemanticVersionReader.cs
@@ -105,7 +105,12 @@ namespace StardewModdingAPI.Toolkit.Framework
         /// <param name="raw">The raw characters to parse.</param>
         /// <param name="index">The index of the next character to read.</param>
         /// <param name="tag">The parsed tag.</param>
-        private static bool TryParseTag(char[] raw, ref int index, [NotNullWhen(true)] out string? tag)
+        private static bool TryParseTag(char[] raw, ref int index,
+#if NET5_0_OR_GREATER
+            [NotNullWhen(true)]
+#endif
+            out string? tag
+        )
         {
             // read tag length
             int length = 0;
diff --git a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
index d40d8f2b..4c9ca2ff 100644
--- a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
+++ b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
@@ -16,7 +16,9 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
         public ModSiteKey Site { get; }
 
         /// <summary>The mod ID within the repository.</summary>
+#if NET5_0_OR_GREATER
         [MemberNotNullWhen(true, nameof(LooksValid))]
+#endif
         public string? ID { get; }
 
         /// <summary>If specified, a substring in download names/descriptions to match.</summary>
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 6a8c4c43..ec27bf79 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <RootNamespace>StardewModdingAPI.Toolkit</RootNamespace>
     <Description>A library which encapsulates mod-handling logic for mod managers and tools. Not intended for use by mods.</Description>
-    <TargetFrameworks>net5.0</TargetFrameworks>
+    <TargetFrameworks>net5.0; netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index cbdd7a85..2cb27e11 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -198,7 +198,12 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="version">The version string.</param>
         /// <param name="parsed">The parsed representation.</param>
         /// <returns>Returns whether parsing the version succeeded.</returns>
-        public static bool TryParse(string? version, [NotNullWhen(true)] out ISemanticVersion? parsed)
+        public static bool TryParse(string? version,
+#if NET5_0_OR_GREATER
+            [NotNullWhen(true)]
+#endif
+            out ISemanticVersion? parsed
+        )
         {
             return SemanticVersion.TryParse(version, allowNonStandard: false, out parsed);
         }
@@ -208,7 +213,12 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="allowNonStandard">Whether to allow non-standard extensions to semantic versioning.</param>
         /// <param name="parsed">The parsed representation.</param>
         /// <returns>Returns whether parsing the version succeeded.</returns>
-        public static bool TryParse(string? version, bool allowNonStandard, [NotNullWhen(true)] out ISemanticVersion? parsed)
+        public static bool TryParse(string? version, bool allowNonStandard,
+#if NET5_0_OR_GREATER
+            [NotNullWhen(true)]
+#endif
+            out ISemanticVersion? parsed
+        )
         {
             if (version == null)
             {
diff --git a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
index 7d1804e5..3c9308f2 100644
--- a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
+++ b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
@@ -37,7 +37,12 @@ namespace StardewModdingAPI.Toolkit.Serialization
         /// <returns>Returns false if the file doesn't exist, else true.</returns>
         /// <exception cref="ArgumentException">The given <paramref name="fullPath"/> is empty or invalid.</exception>
         /// <exception cref="JsonReaderException">The file contains invalid JSON.</exception>
-        public bool ReadJsonFileIfExists<TModel>(string fullPath, [NotNullWhen(true)] out TModel? result)
+        public bool ReadJsonFileIfExists<TModel>(string fullPath,
+#if NET5_0_OR_GREATER
+            [NotNullWhen(true)]
+#endif
+            out TModel? result
+        )
         {
             // validate
             if (string.IsNullOrWhiteSpace(fullPath))
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 3ab5edfb..01010602 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -115,7 +115,9 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         *********/
         /// <summary>Normalize whitespace in a raw string.</summary>
         /// <param name="input">The input to strip.</param>
+#if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("input")]
+#endif
         private string? NormalizeWhitespace(string? input)
         {
             return input
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
index dcdbcf74..f7dc8aa8 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestContentPackFor.cs
@@ -33,7 +33,9 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         *********/
         /// <summary>Normalize whitespace in a raw string.</summary>
         /// <param name="input">The input to strip.</param>
+#if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("input")]
+#endif
         private string? NormalizeWhitespace(string? input)
         {
             return input?.Trim();
diff --git a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
index 5d1b73b1..fa254ea7 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/ManifestDependency.cs
@@ -54,7 +54,9 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         *********/
         /// <summary>Normalize whitespace in a raw string.</summary>
         /// <param name="input">The input to strip.</param>
+#if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("input")]
+#endif
         private string? NormalizeWhitespace(string? input)
         {
             return input?.Trim();
diff --git a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
index 9b7a78a0..136279f2 100644
--- a/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathUtilities.cs
@@ -50,7 +50,9 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <summary>Normalize an asset name to match how MonoGame's content APIs would normalize and cache it.</summary>
         /// <param name="assetName">The asset name to normalize.</param>
         [Pure]
+#if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("assetName")]
+#endif
         public static string? NormalizeAssetName(string? assetName)
         {
             assetName = assetName?.Trim();
@@ -64,7 +66,9 @@ namespace StardewModdingAPI.Toolkit.Utilities
         /// <param name="path">The file path to normalize.</param>
         /// <remarks>This should only be used for file paths. For asset names, use <see cref="NormalizeAssetName"/> instead.</remarks>
         [Pure]
+#if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("path")]
+#endif
         public static string? NormalizePath(string? path)
         {
             path = path?.Trim();
@@ -89,7 +93,7 @@ namespace StardewModdingAPI.Toolkit.Utilities
             }
 
             // keep trailing separator
-            if ((!hasRoot || segments.Any()) && PathUtilities.PossiblePathSeparators.Contains(path[^1]))
+            if ((!hasRoot || segments.Any()) && PathUtilities.PossiblePathSeparators.Contains(path[path.Length - 1]))
                 newPath += PathUtilities.PreferredPathSeparator;
 
             return newPath;
@@ -101,7 +105,43 @@ namespace StardewModdingAPI.Toolkit.Utilities
         [Pure]
         public static string GetRelativePath(string sourceDir, string targetPath)
         {
+#if NET5_0
             return Path.GetRelativePath(sourceDir, targetPath);
+#else
+            // NOTE:
+            // this is a heuristic implementation that works in the cases SMAPI needs it for, but it
+            // doesn't handle all edge cases (e.g. case-sensitivity on Linux, or traversing between
+            // UNC paths on Windows). SMAPI and mods will use the more robust .NET 5 version anyway
+            // though, this is only for compatibility with the mod build package.
+
+            // convert to URIs
+            Uri from = new(sourceDir.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
+            Uri to = new(targetPath.TrimEnd(PathUtilities.PossiblePathSeparators) + "/");
+            if (from.Scheme != to.Scheme)
+                throw new InvalidOperationException($"Can't get path for '{targetPath}' relative to '{sourceDir}'.");
+
+            // get relative path
+            string rawUrl = Uri.UnescapeDataString(from.MakeRelativeUri(to).ToString());
+            if (rawUrl.StartsWith("file://"))
+                rawUrl = PathUtilities.WindowsUncRoot + rawUrl.Substring("file://".Length);
+            string relative = PathUtilities.NormalizePath(rawUrl);
+
+            // normalize
+            if (relative == "")
+                relative = ".";
+            else
+            {
+                // trim trailing slash from URL
+                if (relative.EndsWith(PathUtilities.PreferredPathSeparator.ToString()))
+                    relative = relative.Substring(0, relative.Length - 1);
+
+                // fix root
+                if (relative.StartsWith("file:") && !targetPath.Contains("file:"))
+                    relative = relative.Substring("file:".Length);
+            }
+
+            return relative;
+#endif
         }
 
         /// <summary>Get whether a path is relative and doesn't try to climb out of its containing folder (e.g. doesn't contain <c>../</c>).</summary>

From 0beff189d19416dfcbb64bce800af41de37ccd08 Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Fri, 8 Apr 2022 14:59:52 -0400
Subject: [PATCH 513/856] Implement client-side log rendering, better
 filtering, and pagination to improve performance and enhance the user
 experience with using the log parser.

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 143 ++--
 .../wwwroot/Content/css/log-parser.css        | 109 ++-
 .../wwwroot/Content/js/log-parser.js          | 632 +++++++++++++++++-
 3 files changed, 827 insertions(+), 57 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index c26ec230..39a2da0f 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -20,6 +20,16 @@
         .Cast<LogLevel>()
         .ToDictionary(level => level.ToString().ToLower(), level => level != LogLevel.Trace);
 
+    IDictionary<int, string> logLevels = Enum
+        .GetValues(typeof(LogLevel))
+        .Cast<LogLevel>()
+        .ToDictionary(level => (int)level, level => level.ToString().ToLower());
+
+    IDictionary<int, string> logSections = Enum
+        .GetValues(typeof(LogSection))
+        .Cast<LogSection>()
+        .ToDictionary(section => (int)section, section => section.ToString());
+
     string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true);
 
     ISet<int> screenIds = new HashSet<int>(log?.Messages?.Select(p => p.ScreenId) ?? Array.Empty<int>());
@@ -34,8 +44,15 @@
     <link rel="stylesheet" href="~/Content/css/log-parser.css" />
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3/dist/css/tabby-ui-vertical.min.css" />
 
+    @if (!Model.ShowRaw)
+    {
+    <script id="logSections" type="application/json">@this.ForJson(logSections)</script>
+    <script id="logLevels" type="application/json">@this.ForJson(logLevels)</script>
+    <script id="parsedMessages" type="application/json">@this.ForJson(log?.Messages)</script>
+    <script id="modSlugs" type="application/json">@this.ForJson(log?.Mods?.DistinctBy(m => m.Name).ToDictionary(m => m.Name, m => Model.GetSlug(m.Name)))</script>
+    }
     <script src="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3" crossorigin="anonymous"></script>
-    <script src="https://cdn.jsdelivr.net/npm/vue@2.6.11" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/vue@2.6.14" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
     <script src="~/Content/js/file-upload.js"></script>
     <script src="~/Content/js/log-parser.js"></script>
@@ -275,29 +292,35 @@ else if (log?.IsValid == true)
                     <span class="notice txt"><i>click any mod to filter</i></span>
                     <span class="notice btn txt" v-on:click="showAllMods" v-bind:class="{ invisible: !anyModsHidden }">show all</span>
                     <span class="notice btn txt" v-on:click="hideAllMods" v-bind:class="{ invisible: !anyModsShown || !anyModsHidden }">hide all</span>
+                    <span class="notice btn txt" v-on:click="toggleContentPacks">toggle content packs</span>
                 }
             </caption>
             @foreach (var mod in log.Mods.Where(p => p.Loaded && !p.IsContentPack))
             {
+                LogModInfo[]? contentPackList;
+                if (contentPacks == null || !contentPacks.TryGetValue(mod.Name, out contentPackList))
+                    contentPackList = null;
+
                 <tr v-on:click="toggleMod('@Model.GetSlug(mod.Name)')" class="mod-entry" v-bind:class="{ hidden: !showMods['@Model.GetSlug(mod.Name)'] }">
                     <td><input type="checkbox" v-bind:checked="showMods['@Model.GetSlug(mod.Name)']" v-bind:class="{ invisible: !anyModsHidden }" /></td>
-                    <td v-pre>
-                        <strong>@mod.Name</strong> @mod.Version
-                        @if (contentPacks != null && contentPacks.TryGetValue(mod.Name, out LogModInfo[] contentPackList))
+                    <td>
+                        <strong v-pre>@mod.Name</strong> @mod.Version
+                        @if (contentPackList != null)
                         {
-                            <div class="content-packs">
+                            <div v-if="!hideContentPacks" class="content-packs">
                                 @foreach (var contentPack in contentPackList)
                                 {
                                     <text>+ @contentPack.Name @contentPack.Version</text><br />
                                 }
                             </div>
+                            <span v-else class="content-packs--short"> (+ @contentPackList.Length Content Packs)</span>
                         }
                     </td>
-                    <td v-pre>
+                    <td>
                         @mod.Author
-                        @if (contentPacks != null && contentPacks.TryGetValue(mod.Name, out contentPackList))
+                        @if (contentPackList != null)
                         {
-                            <div class="content-packs">
+                            <div v-if="!hideContentPacks" class="content-packs">
                                 @foreach (var contentPack in contentPackList)
                                 {
                                     <text>+ @contentPack.Author</text><br />
@@ -323,57 +346,67 @@ else if (log?.IsValid == true)
 
         @if (!Model.ShowRaw)
         {
+            <div id="filterHolder"></div>
             <div id="filters">
-                Filter messages:
-                <span v-bind:class="{ active: showLevels['trace'] }" v-on:click="toggleLevel('trace')">TRACE</span> |
-                <span v-bind:class="{ active: showLevels['debug'] }" v-on:click="toggleLevel('debug')">DEBUG</span> |
-                <span v-bind:class="{ active: showLevels['info'] }" v-on:click="toggleLevel('info')">INFO</span> |
-                <span v-bind:class="{ active: showLevels['alert'] }" v-on:click="toggleLevel('alert')">ALERT</span> |
-                <span v-bind:class="{ active: showLevels['warn'] }" v-on:click="toggleLevel('warn')">WARN</span> |
-                <span v-bind:class="{ active: showLevels['error'] }" v-on:click="toggleLevel('error')">ERROR</span>
+                <div class="toggles">
+                    <div>
+                        Filter messages:
+                    </div>
+                    <div>
+                        <span role="button" v-bind:class="{ active: showLevels['trace'] }" v-on:click="toggleLevel('trace')">TRACE</span> |
+                        <span role="button" v-bind:class="{ active: showLevels['debug'] }" v-on:click="toggleLevel('debug')">DEBUG</span> |
+                        <span role="button" v-bind:class="{ active: showLevels['info'] }" v-on:click="toggleLevel('info')">INFO</span> |
+                        <span role="button" v-bind:class="{ active: showLevels['alert'] }" v-on:click="toggleLevel('alert')">ALERT</span> |
+                        <span role="button" v-bind:class="{ active: showLevels['warn'] }" v-on:click="toggleLevel('warn')">WARN</span> |
+                        <span role="button" v-bind:class="{ active: showLevels['error'] }" v-on:click="toggleLevel('error')">ERROR</span>
+                        <div class="filter-text">
+                            <input
+                                type="text"
+                                v-bind:class="{ active: filterText && filterText != '' }"
+                                v-on:input="updateFilterText"
+                                placeholder="filter..."
+                            />
+                            <span role="button" v-bind:class="{ active: filterUseRegex }" v-on:click="toggleFilterUseRegex" title="Use Regular Expression">.*</span>
+                            <span role="button" v-bind:class="{ active: !filterInsensitive }" v-on:click="toggleFilterInsensitive" title="Match Case">aA</span>
+                            <span role="button" v-bind:class="{ active: filterUseWord, 'whole-word': true }" v-on:click="toggleFilterWord" title="Match Whole Word"><i>Ab</i></span>
+                            <span role="button" v-bind:class="{ active: shouldHighlight }" v-on:click="toggleHighlight" title="Highlight Matches">HL</span>
+                        </div>
+                        <filter-stats
+                            v-bind:start="start"
+                            v-bind:end="end"
+                            v-bind:pages="totalPages"
+                            v-bind:filtered="filteredMessages.length"
+                            v-bind:total="totalMessages"
+                        />
+                    </div>
+                </div>
+                <pager
+                    v-bind:page="page"
+                    v-bind:pages="totalPages"
+                    v-bind:prevPage="prevPage"
+                    v-bind:nextPage="nextPage"
+                />
             </div>
 
-            <table id="log">
-                @foreach (var message in log.Messages)
-                {
-                    string levelStr = message.Level.ToString().ToLower();
-                    string sectionStartClass = message.IsStartOfSection ? "section-start" : null;
-                    string sectionFilter = message.Section != null && !message.IsStartOfSection ? $"&& sectionsAllow('{message.Section}')" : null; // filter the message by section if applicable
+            <noscript>
+                <div>
+                    This website uses JavaScript to display a filterable table. To view this log, please either
+                    <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, format = LogViewFormat.RawView })">view the raw log</a>
+                    or enable JavaScript.
+                </div>
+                <br/>
+            </noscript>
 
-                    <tr class="mod @levelStr @sectionStartClass"
-                        @if (message.IsStartOfSection) { <text> v-on:click="toggleSection('@message.Section')" </text> }
-                        v-show="filtersAllow('@Model.GetSlug(message.Mod)', '@levelStr') @sectionFilter">
-                        <td v-pre>@message.Time</td>
-                        @if (screenIds.Count > 1)
-                        {
-                            <td v-pre>screen_@message.ScreenId</td>
-                        }
-                        <td v-pre>@message.Level.ToString().ToUpper()</td>
-                        <td v-pre data-title="@message.Mod">@message.Mod</td>
-                        <td>
-                            <span v-pre class="log-message-text">@message.Text</span>
-                            @if (message.IsStartOfSection)
-                            {
-                                <span class="section-toggle-message">
-                                    <template v-if="sectionsAllow('@message.Section')">
-                                        This section is shown. Click here to hide it.
-                                    </template>
-                                    <template v-else>
-                                        This section is hidden. Click here to show it.
-                                    </template>
-                                </span>
-                            }
-                        </td>
-                    </tr>
-                    if (message.Repeated > 0)
-                    {
-                        <tr class="@levelStr mod mod-repeat" v-show="filtersAllow('@Model.GetSlug(message.Mod)', '@levelStr') @sectionFilter">
-                            <td colspan="4"></td>
-                            <td v-pre><i>repeats [@message.Repeated] times.</i></td>
-                        </tr>
-                    }
-                }
-            </table>
+            <log-table>
+                <log-line
+                    v-for="msg in visibleMessages"
+                    v-bind:key="msg.id"
+                    v-bind:showScreenId="showScreenId"
+                    v-bind:message="msg"
+                    v-bind:highlight="shouldHighlight"
+                    v-bind:sectionExpanded="msg.SectionName && visibleSections.includes(msg.SectionName)"
+                />
+            </log-table>
         }
         else
         {
diff --git a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
index 8c3acceb..94bc049b 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
@@ -148,6 +148,10 @@ table caption {
     font-style: italic;
 }
 
+.content-packs--short {
+    opacity: 0.75;
+}
+
 #metadata td:first-child {
     padding-right: 5px;
 }
@@ -158,8 +162,58 @@ table caption {
 
 #filters {
     margin: 1em 0 0 0;
-    padding: 0;
+    padding: 0 0 0.5em;
+    display: flex;
+    justify-content: space-between;
+    width: calc(100vw - 16em);
+}
+
+#filters > div {
+    align-self: center;
+}
+
+#filters .toggles {
+    display: flex;
+}
+
+#filters .toggles > div:first-child {
     font-weight: bold;
+    padding: 0.2em 1em 0 0;
+}
+
+#filters .filter-text {
+    margin-top: 0.5em;
+}
+
+#filters .stats {
+    margin-top: 0.5em;
+    font-size: 0.75em;
+}
+
+#filters.sticky {
+    position: fixed;
+    top: 0;
+    left: 0em;
+    background: #fff;
+    margin: 0;
+    padding: 0.5em;
+    width: calc(100% - 1em);
+}
+
+@media (min-width: 1020px) and (max-width: 1199px) {
+    #filters:not(.sticky) {
+        width: calc(100vw - 13em);
+    }
+}
+
+@media (max-width: 1019px) {
+    #filters:not(.sticky) {
+        width: calc(100vw - 3em);
+    }
+
+    #filters {
+        display: block;
+    }
 }
 
 #filters span {
@@ -173,6 +227,17 @@ table caption {
     color: #000;
     border-color: #880000;
     background-color: #fcc;
+
+    user-select: none;
+}
+
+#filters .filter-text span {
+    padding: 3px 0.5em;
+}
+
+#filters .whole-word i {
+    padding: 0 1px;
+    border: 1px dashed;
 }
 
 #filters span:hover {
@@ -188,11 +253,48 @@ table caption {
     background: #efe;
 }
 
+#filters .pager {
+    margin-top: 0.5em;
+    text-align: right;
+}
+
+#filters .pager div {
+    margin-top: 0.5em;
+}
+
+#filters .pager div span {
+    padding: 0 0.5em;
+    margin: 0 1px;
+}
+
+#filters .pager span {
+    background-color: #eee;
+    border-color: #888;
+}
+
+#filters .pager span.active {
+    font-weight: bold;
+    border-color: transparent;
+    background: transparent;
+    cursor: unset;
+}
+
+#filters .pager span.disabled {
+    opacity: 0.3;
+    cursor: unset;
+}
+
+#filters .pager span:not(.disabled):hover {
+    background-color: #fff;
+}
+
+
 /*********
 ** Log
 *********/
 #log .mod-repeat {
     font-size: 0.85em;
+    font-style: italic;
 }
 
 #log .trace {
@@ -237,6 +339,11 @@ table caption {
     white-space: pre-wrap;
 }
 
+#log .log-message-text strong {
+    background-color: yellow;
+    font-weight: normal;
+}
+
 #log {
     border-spacing: 0;
 }
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 90715375..c16b237a 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -2,12 +2,98 @@
 
 var smapi = smapi || {};
 var app;
+var messages;
+
+
+// Necessary helper method for updating our text filter in a performant way.
+// Wouldn't want to update it for every individually typed character.
+function debounce(fn, delay) {
+    var timeoutID = null
+    return function () {
+        clearTimeout(timeoutID)
+        var args = arguments
+        var that = this
+        timeoutID = setTimeout(function () {
+            fn.apply(that, args)
+        }, delay)
+    }
+}
+
+// Case insensitive text searching and match word searching is best done in
+// regex, so if the user isn't trying to use regex, escape their input.
+function escapeRegex(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+// Use a scroll event to apply a sticky effect to the filters / pagination
+// bar. We can't just use "position: sticky" due to how the page is structured
+// but this works well enough.
+$(function () {
+    let sticking = false;
+
+    document.addEventListener('scroll', function (event) {
+        const filters = document.getElementById('filters');
+        const holder = document.getElementById('filterHolder');
+        if (!filters || !holder)
+            return;
+
+        const offset = holder.offsetTop;
+        const should_stick = window.pageYOffset > offset;
+        if (should_stick === sticking)
+            return;
+
+        sticking = should_stick;
+        if (sticking) {
+            holder.style.marginBottom = `calc(1em + ${filters.offsetHeight}px)`;
+            filters.classList.add('sticky');
+        } else {
+            filters.classList.remove('sticky');
+            holder.style.marginBottom = '';
+        }
+    });
+});
+
+// This method is called when we click a log line to toggle the visibility
+// of a section. Binding methods is problematic with functional components
+// so we just use the `data-section` parameter and our global reference
+// to the app.
+smapi.clickLogLine = function (event) {
+    app.toggleSection(event.currentTarget.dataset.section);
+    event.preventDefault();
+    return false;
+}
+
+// And these methods are called when doing pagination. Just makes things
+// easier, so may as well use helpers.
+smapi.prevPage = function () {
+    app.prevPage();
+}
+
+smapi.nextPage = function () {
+    app.nextPage();
+}
+
+smapi.changePage = function (event) {
+    if (typeof event === 'number')
+        app.changePage(event);
+    else if (event) {
+        const page = parseInt(event.currentTarget.dataset.page);
+        if (!isNaN(page) && isFinite(page))
+            app.changePage(page);
+    }
+}
+
+
 smapi.logParser = function (data, sectionUrl) {
+    if (!data)
+        data = {};
+
     // internal filter counts
     var stats = data.stats = {
         modsShown: 0,
         modsHidden: 0
     };
+
     function updateModFilters() {
         // counts
         stats.modsShown = 0;
@@ -22,10 +108,357 @@ smapi.logParser = function (data, sectionUrl) {
         }
     }
 
+    // load our data
+
+    // Rather than pre-rendering the list elements into the document, we read
+    // a lot of JSON and use Vue to build the list. This is a lot more
+    // performant and easier on memory.Our JSON is stored in special script
+    // tags, that we later remove to let the browser clean up even more memory.
+    let nodeParsedMessages = document.querySelector('script#parsedMessages');
+    if (nodeParsedMessages) {
+        messages = JSON.parse(nodeParsedMessages.textContent) || [];
+        const logLevels = JSON.parse(document.querySelector('script#logLevels').textContent) || {};
+        const logSections = JSON.parse(document.querySelector('script#logSections').textContent) || {};
+        const modSlugs = JSON.parse(document.querySelector('script#modSlugs').textContent) || {};
+
+        // Remove all references to the script tags and remove them from the
+        // DOM so that the browser can clean them up.
+        nodeParsedMessages.remove();
+        document.querySelector('script#logLevels').remove();
+        document.querySelector('script#logSections').remove();
+        document.querySelector('script#modSlugs').remove();
+        nodeParsedMessages = null;
+
+        // Pre-process the messages since they aren't quite serialized in
+        // the format we want. We also want to freeze every last message
+        // so that Vue won't install its change listening behavior.
+        for (let i = 0, length = messages.length; i < length; i++) {
+            const msg = messages[i];
+            msg.id = i;
+            msg.LevelName = logLevels && logLevels[msg.Level];
+            msg.SectionName = logSections && logSections[msg.Section];
+            msg.ModSlug = modSlugs && modSlugs[msg.Mod] || msg.Mod;
+
+            // For repeated messages, since our <log-line /> component
+            // can't return two rows, just insert a second message
+            // which will display as the message repeated notice.
+            if (msg.Repeated > 0 && ! msg.isRepeated) {
+                const second = {
+                    id: i + 1,
+                    Level: msg.Level,
+                    Section: msg.Section,
+                    Mod: msg.Mod,
+                    Repeated: msg.Repeated,
+                    isRepeated: true,
+                };
+
+                messages.splice(i + 1, 0, second);
+                length++;
+            }
+
+            Object.freeze(msg);
+        }
+
+        Object.freeze(messages);
+
+    } else
+        messages = [];
+
     // set local time started
-    if (data)
+    if (data.logStarted)
         data.localTimeStarted = ("0" + data.logStarted.getHours()).slice(-2) + ":" + ("0" + data.logStarted.getMinutes()).slice(-2);
 
+    // Add some properties to the data we're passing to Vue.
+    data.totalMessages = messages.length;
+
+    data.filterText = '';
+    data.filterRegex = '';
+
+    data.showContentPacks = true;
+    data.useHighlight = true;
+    data.useRegex = false;
+    data.useInsensitive = true;
+    data.useWord = false;
+
+    data.perPage = 1000;
+    data.page = 1;
+
+    // Now load these values.
+    if (localStorage.settings) {
+        try {
+            const saved = JSON.parse(localStorage.settings);
+            if (saved.hasOwnProperty('showContentPacks'))
+                data.showContentPacks = saved.showContentPacks;
+            if (saved.hasOwnProperty('useHighlight'))
+                dat.useHighlight = saved.useHighlight;
+            if (saved.hasOwnProperty('useRegex'))
+                data.useRegex = saved.useRegex;
+            if (saved.hasOwnProperty('useInsensitive'))
+                data.useInsensitive = saved.useInsensitive;
+            if (saved.hasOwnProperty('useWord'))
+                data.useWord = saved.useWord;
+        } catch { /* ignore errors */ }
+    }
+
+    // This would be easier if we could just use JSX but this project doesn't
+    // have a proper JavaScript build environment and I really don't feel
+    // like setting one up.
+
+    // Add a number formatter so that our numbers look nicer.
+    const fmt = window.Intl && Intl.NumberFormat && new Intl.NumberFormat();
+    function formatNumber(value) {
+        if (!fmt || !fmt.format) return `${value}`;
+        return fmt.format(value);
+    }
+    Vue.filter('number', formatNumber);
+
+    // Strictly speaking, we don't need this. However, due to the way our
+    // Vue template is living in-page the browser is "helpful" and moves
+    // our <log-line />s outside of a basic <table> since obviously they
+    // aren't table rows and don't belong inside a table. By using another
+    // Vue component, we avoid that.
+    Vue.component('log-table', {
+        functional: true,
+        render: function (createElement, context) {
+            return createElement('table', {
+                attrs: {
+                    id: 'log'
+                }
+            }, context.children);
+        }
+    });
+
+    // The <filter-stats /> component draws a nice message under the filters
+    // telling a user how many messages match their filters, and also expands
+    // on how many of them they're seeing because of pagination.
+    Vue.component('filter-stats', {
+        functional: true,
+        render: function (createElement, context) {
+            const props = context.props;
+            if (props.pages > 1)
+                return createElement('div', {
+                    class: 'stats'
+                }, [
+                    'showing ',
+                    createElement('strong', formatNumber(props.start + 1)),
+                    ' to ',
+                    createElement('strong', formatNumber(props.end)),
+                    ' of ',
+                    createElement('strong', formatNumber(props.filtered)),
+                    ' (total: ',
+                    createElement('strong', formatNumber(props.total)),
+                    ')'
+                ]);
+
+            return createElement('div', {
+                class: 'stats'
+            }, [
+                'showing ',
+                createElement('strong', formatNumber(props.filtered)),
+                ' out of ',
+                createElement('strong', formatNumber(props.total))
+            ]);
+        }
+    });
+
+    // Next up we have <pager /> which renders the pagination list. This has a
+    // helper method to make building the list of links easier.
+    function addPageLink(page, links, visited, createElement, currentPage) {
+        if (visited.has(page))
+            return;
+
+        if (page > 1 && !visited.has(page - 1))
+            links.push(' … ');
+
+        visited.add(page);
+        links.push(createElement('span', {
+            class: page == currentPage ? 'active' : null,
+            attrs: {
+                'data-page': page
+            },
+            on: {
+                click: smapi.changePage
+            }
+        }, formatNumber(page)));
+    }
+
+    Vue.component('pager', {
+        functional: true,
+        render: function (createElement, context) {
+            const props = context.props;
+            if (props.pages <= 1)
+                return null;
+
+            const visited = new Set;
+            const pageLinks = [];
+
+            for (let i = 1; i <= 2; i++)
+                addPageLink(i, pageLinks, visited, createElement, props.page);
+
+            for (let i = props.page - 2; i <= props.page + 2; i++) {
+                if (i < 1 || i > props.pages)
+                    continue;
+
+                addPageLink(i, pageLinks, visited, createElement, props.page);
+            }
+
+            for (let i = props.pages - 2; i <= props.pages; i++) {
+                if (i < 1)
+                    continue;
+
+                addPageLink(i, pageLinks, visited, createElement, props.page);
+            }
+
+            return createElement('div', {
+                class: 'pager'
+            }, [
+                createElement('span', {
+                    class: props.page <= 1 ? 'disabled' : null,
+                    on: {
+                        click: smapi.prevPage
+                    }
+                }, 'Prev'),
+                ' ',
+                'Page ',
+                formatNumber(props.page),
+                ' of ',
+                formatNumber(props.pages),
+                ' ',
+                createElement('span', {
+                    class: props.page >= props.pages ? 'disabled' : null,
+                    on: {
+                        click: smapi.nextPage
+                    }
+                }, 'Next'),
+                createElement('div', {}, pageLinks)
+            ]);
+        }
+    });
+
+    // Our <log-line /> functional component draws each log line.
+    Vue.component('log-line', {
+        functional: true,
+        props: {
+            showScreenId: {
+                type: Boolean,
+                required: true
+            },
+            message: {
+                type: Object,
+                required: true
+            },
+            sectionExpanded: {
+                type: Boolean,
+                required: false
+            },
+            highlight: {
+                type: Boolean,
+                required: false
+            }
+        },
+        render: function (createElement, context) {
+            const msg = context.props.message;
+            const level = msg.LevelName;
+
+            if (msg.isRepeated)
+                return createElement('tr', {
+                    class: [
+                        "mod",
+                        level,
+                        "mod-repeat"
+                    ]
+                }, [
+                    createElement('td', {
+                        attrs: {
+                            colspan: context.props.showScreenId ? 4 : 3
+                        }
+                    }, ''),
+                    createElement('td', `repeats ${msg.Repeated} times`)
+                ]);
+
+            const events = {};
+            let toggleMessage;
+            if (msg.IsStartOfSection) {
+                const visible = context.props.sectionExpanded;
+                events.click = smapi.clickLogLine;
+                toggleMessage = visible ?
+                    'This section is shown. Click here to hide it.' :
+                    'This section is hidden. Click here to show it.';
+            }
+
+            let text = msg.Text;
+            const filter = window.app && app.filterRegex;
+            if (text && filter && context.props.highlight) {
+                text = [];
+                let match, consumed = 0, idx = 0;
+                filter.lastIndex = -1;
+
+                // Our logic to highlight the text is a bit funky because we
+                // want to group consecutive matches to avoid a situation
+                // where a ton of single characters are in their own elements
+                // if the user gives us bad input.
+
+                while (match = filter.exec(msg.Text)) {
+                    // Do we have an area of non-matching text? This
+                    // happens if the new match's index is further
+                    // along than the last index.
+                    if (match.index > idx) {
+                        // Alright, do we have a previous match? If
+                        // we do, we need to consume some text.
+                        if (consumed < idx)
+                            text.push(createElement('strong', {}, msg.Text.slice(consumed, idx)));
+
+                        text.push(msg.Text.slice(idx, match.index));
+                        consumed = match.index;
+                    }
+
+                    idx = match.index + match[0].length;
+                }
+
+                // Add any trailing text after the last match was found.
+                if (consumed < msg.Text.length) {
+                    if (consumed < idx)
+                        text.push(createElement('strong', {}, msg.Text.slice(consumed, idx)));
+
+                    if (idx < msg.Text.length)
+                        text.push(msg.Text.slice(idx));
+                }
+            }
+
+            return createElement('tr', {
+                class: [
+                    "mod",
+                    level,
+                    msg.IsStartOfSection ? "section-start" : null
+                ],
+                attrs: {
+                    'data-section': msg.SectionName
+                },
+                on: events
+            }, [
+                createElement('td', msg.Time),
+                context.props.showScreenId ? createElement('td', msg.ScreenId) : null,
+                createElement('td', level.toUpperCase()),
+                createElement('td', {
+                    attrs: {
+                        'data-title': msg.Mod
+                    }
+                }, msg.Mod),
+                createElement('td', [
+                    createElement('span', {
+                        class: 'log-message-text'
+                    }, text),
+                    msg.IsStartOfSection ? createElement('span', {
+                        class: 'section-toggle-message'
+                    }, [
+                        ' ',
+                        toggleMessage
+                    ]) : null
+                ])
+            ]);
+        }
+    });
+
     // init app
     app = new Vue({
         el: '#output',
@@ -36,9 +469,114 @@ smapi.logParser = function (data, sectionUrl) {
             },
             anyModsShown: function () {
                 return stats.modsShown > 0;
+            },
+            showScreenId: function () {
+                return this.screenIds.length > 1;
+            },
+
+            // Maybe not strictly necessary, but the Vue template is being
+            // weird about accessing data entries on the app rather than
+            // computed properties.
+            visibleSections: function () {
+                const ret = [];
+                for (const [k, v] of Object.entries(this.showSections))
+                    if (v !== false)
+                        ret.push(k);
+                return ret;
+            },
+            hideContentPacks: function () {
+                return !data.showContentPacks;
+            },
+
+            // Filter messages for visibility.
+            filterUseRegex: function () { return data.useRegex; },
+            filterInsensitive: function () { return data.useInsensitive; },
+            filterUseWord: function () { return data.useWord; },
+            shouldHighlight: function () { return data.useHighlight; },
+
+            filteredMessages: function () {
+                if (!messages)
+                    return [];
+
+                const start = performance.now();
+                const ret = [];
+
+                // This is slightly faster than messages.filter(), which is
+                // important when working with absolutely huge logs.
+                for (let i = 0, length = messages.length; i < length; i++) {
+                    const msg = messages[i];
+                    if (msg.SectionName && !msg.IsStartOfSection && !this.sectionsAllow(msg.SectionName))
+                        continue;
+
+                    if (!this.filtersAllow(msg.ModSlug, msg.LevelName))
+                        continue;
+
+                    let text = msg.Text || (i > 0 ? messages[i - 1].Text : null);
+
+                    if (this.filterRegex) {
+                        this.filterRegex.lastIndex = -1;
+                        if (!text || !this.filterRegex.test(text))
+                            continue;
+                    } else if (this.filterText && (!text || text.indexOf(this.filterText) == -1))
+                        continue;
+
+                    ret.push(msg);
+                }
+
+                const end = performance.now();
+                console.log(`filter took ${end - start}ms`);
+
+                return ret;
+            },
+
+            // And the rest are about pagination.
+            start: function () {
+                return (this.page - 1) * data.perPage;
+            },
+            end: function () {
+                return this.start + this.visibleMessages.length;
+            },
+            totalPages: function () {
+                return Math.ceil(this.filteredMessages.length / data.perPage);
+            },
+            // 
+            visibleMessages: function () {
+                if (this.totalPages <= 1)
+                    return this.filteredMessages;
+
+                const start = this.start;
+                const end = start + data.perPage;
+
+                return this.filteredMessages.slice(start, end);
             }
         },
+        created: function () {
+            this.loadFromUrl = this.loadFromUrl.bind(this);
+            window.addEventListener('popstate', this.loadFromUrl);
+            this.loadFromUrl();
+        },
         methods: {
+            // Mostly I wanted people to know they can override the PerPage
+            // message count with a URL parameter, but we can read Page too.
+            // In the future maybe we should read *all* filter state so a
+            // user can link to their exact page state for someone else?
+            loadFromUrl: function () {
+                const params = new URL(location).searchParams;
+                if (params.has('PerPage'))
+                    try {
+                        const perPage = parseInt(params.get('PerPage'));
+                        if (!isNaN(perPage) && isFinite(perPage) && perPage > 0)
+                            data.perPage = perPage;
+                    } catch { /* ignore errors */ }
+
+                if (params.has('Page'))
+                    try {
+                        const page = parseInt(params.get('Page'));
+                        if (!isNaN(page) && isFinite(page) && page > 0)
+                            this.page = page;
+                    } catch { /* ignore errors */ }
+            },
+
             toggleLevel: function (id) {
                 if (!data.enableFilters)
                     return;
@@ -46,6 +584,98 @@ smapi.logParser = function (data, sectionUrl) {
                 this.showLevels[id] = !this.showLevels[id];
             },
 
+            toggleContentPacks: function () {
+                data.showContentPacks = !data.showContentPacks;
+                this.saveSettings();
+            },
+
+            toggleFilterUseRegex: function () {
+                data.useRegex = !data.useRegex;
+                this.saveSettings();
+                this.updateFilterText();
+            },
+
+            toggleFilterInsensitive: function () {
+                data.useInsensitive = !data.useInsensitive;
+                this.saveSettings();
+                this.updateFilterText();
+            },
+
+            toggleFilterWord: function () {
+                data.useWord = !data.useWord;
+                this.saveSettings();
+                this.updateFilterText();
+            },
+
+            toggleHighlight: function () {
+                data.useHighlight = !data.useHighlight;
+                this.saveSettings();
+            },
+
+            prevPage: function () {
+                if (this.page <= 1)
+                    return;
+                this.page--;
+                this.updateUrl();
+            },
+
+            nextPage: function () {
+                if (this.page >= this.totalPages)
+                    return;
+                this.page++;
+                this.updateUrl();
+            },
+
+            changePage: function (page) {
+                if (page < 1 || page > this.totalPages)
+                    return;
+                this.page = page;
+                this.updateUrl();
+            },
+
+            // Persist settings into localStorage for use the next time
+            // the user opens a log.
+            saveSettings: function () {
+                localStorage.settings = JSON.stringify({
+                    showContentPacks: data.showContentPacks,
+                    useRegex: data.useRegex,
+                    useInsensitive: data.useInsensitive,
+                    useWord: data.useWord,
+                    useHighlight: data.useHighlight
+                });
+            },
+
+            // Whenever the page is changed, replace the current page URL. Using
+            // replaceState rather than pushState to avoid filling the tab history
+            // with tons of useless history steps the user probably doesn't
+            // really care about.
+            updateUrl: function () {
+                const url = new URL(location);
+                url.searchParams.set('Page', data.page);
+                url.searchParams.set('PerPage', data.perPage);
+
+                window.history.replaceState(null, document.title, url.toString());
+            },
+
+            // We don't want to update the filter text often, so use a debounce with
+            // a quarter second delay. We basically always build a regular expression
+            // since we use it for highlighting, and it also make case insensitivity
+            // much easier.
+            updateFilterText: debounce(function () {
+                let text = this.filterText = document.querySelector('input[type=text]').value;
+                if (!text || !text.length) {
+                    this.filterText = '';
+                    this.filterRegex = null;
+                } else {
+                    if (!data.useRegex)
+                        text = escapeRegex(text);
+                    this.filterRegex = new RegExp(
+                        data.useWord ? `\\b${text}\\b` : text,
+                        data.useInsensitive ? 'ig' : 'g'
+                    );
+                }
+            }, 250),
+
             toggleMod: function (id) {
                 if (!data.enableFilters)
                     return;

From 631d0375c3868cb68d1487662955db4ea1b7dd77 Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Fri, 8 Apr 2022 15:26:35 -0400
Subject: [PATCH 514/856] Simplify visible section checking by abusing Vue
 behavior, since the proper way is being buggy.

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml     |  1 -
 src/SMAPI.Web/wwwroot/Content/js/log-parser.js | 13 +------------
 2 files changed, 1 insertion(+), 13 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 39a2da0f..8f44b4a2 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -404,7 +404,6 @@ else if (log?.IsValid == true)
                     v-bind:showScreenId="showScreenId"
                     v-bind:message="msg"
                     v-bind:highlight="shouldHighlight"
-                    v-bind:sectionExpanded="msg.SectionName && visibleSections.includes(msg.SectionName)"
                 />
             </log-table>
         }
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index c16b237a..1984d58f 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -347,10 +347,6 @@ smapi.logParser = function (data, sectionUrl) {
                 type: Object,
                 required: true
             },
-            sectionExpanded: {
-                type: Boolean,
-                required: false
-            },
             highlight: {
                 type: Boolean,
                 required: false
@@ -379,7 +375,7 @@ smapi.logParser = function (data, sectionUrl) {
             const events = {};
             let toggleMessage;
             if (msg.IsStartOfSection) {
-                const visible = context.props.sectionExpanded;
+                const visible = msg.SectionName && window.app && app.sectionsAllow(msg.SectionName);
                 events.click = smapi.clickLogLine;
                 toggleMessage = visible ?
                     'This section is shown. Click here to hide it.' :
@@ -477,13 +473,6 @@ smapi.logParser = function (data, sectionUrl) {
             // Maybe not strictly necessary, but the Vue template is being
             // weird about accessing data entries on the app rather than
             // computed properties.
-            visibleSections: function () {
-                const ret = [];
-                for (const [k, v] of Object.entries(this.showSections))
-                    if (v !== false)
-                        ret.push(k);
-                return ret;
-            },
             hideContentPacks: function () {
                 return !data.showContentPacks;
             },

From 5ae87fbc01a8829a1a23f90efc25a5dbaada6e68 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 11:42:49 -0400
Subject: [PATCH 515/856] fix deprecation warning when a mod uses
 LoadFromModFile

---
 src/SMAPI/Events/AssetRequestedEventArgs.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index 82b59290..3c51c95d 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -101,7 +101,7 @@ namespace StardewModdingAPI.Events
                     mod: this.Mod,
                     priority: priority,
                     onBehalfOf: null,
-                    _ => this.Mod.Mod.Helper.Content.Load<TAsset>(relativePath))
+                    _ => this.Mod.Mod.Helper.ModContent.Load<TAsset>(relativePath))
             );
         }
 

From 092f0aa4eaa23c169c1ca5e8b213915f563f5053 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 11:52:20 -0400
Subject: [PATCH 516/856] simplify format for new CLI arguments

---
 src/SMAPI/Framework/SCore.cs | 11 +++--------
 src/SMAPI/Program.cs         | 22 +++++++---------------
 2 files changed, 10 insertions(+), 23 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 801a7237..4746c2ce 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -168,8 +168,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>Construct an instance.</summary>
         /// <param name="modsPath">The path to search for mods.</param>
         /// <param name="writeToConsole">Whether to output log messages to the console.</param>
-        /// <param name="developerModeValue">null if not modified else whether to use developer mode</param>
-        public SCore(string modsPath, bool writeToConsole, bool? developerModeValue)
+        /// <param name="developerMode">Whether to enable development features, or <c>null</c> to use the value from the settings file.</param>
+        public SCore(string modsPath, bool writeToConsole, bool? developerMode)
         {
             SCore.Instance = this;
 
@@ -184,12 +184,7 @@ namespace StardewModdingAPI.Framework
 
             // init basics
             this.Settings = JsonConvert.DeserializeObject<SConfig>(File.ReadAllText(Constants.ApiConfigPath));
-
-            // temporary overwrite DeveloperMode Setting
-            if (developerModeValue.HasValue)
-            {
-                this.Settings.DeveloperMode = developerModeValue.Value;
-            }
+            this.Settings.DeveloperMode = developerMode ?? this.Settings.DeveloperMode;
 
             if (File.Exists(Constants.ApiUserConfigPath))
                 JsonConvert.PopulateObject(File.ReadAllText(Constants.ApiUserConfigPath), this.Settings);
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 32bf0bdd..1e3b2000 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -179,7 +179,7 @@ namespace StardewModdingAPI
             bool writeToConsole = !args.Contains("--no-terminal") && Environment.GetEnvironmentVariable("SMAPI_NO_TERMINAL") == null;
 
             // get mods path
-            bool? developerModeValue = null;
+            bool? developerMode = null;
             string modsPath;
             {
                 string rawModsPath = null;
@@ -190,31 +190,23 @@ namespace StardewModdingAPI
                     rawModsPath = args[pathIndex];
 
                 // get developer mode from command line args
-                int developerModeValueIndex = Array.LastIndexOf(args, "--developer-mode") + 1;
-                if (developerModeValueIndex >= 1 && args.Length >= developerModeValueIndex)
-                {
-                    if (args[developerModeValueIndex].ToLower().Equals("true"))
-                    {
-                        developerModeValue = true;
-                    }
-                    else if (args[developerModeValueIndex].ToLower().Equals("false"))
-                    {
-                        developerModeValue = false;
-                    }
-                }
+                if (args.Contains("--developer-mode"))
+                    developerMode = true;
+                if (args.Contains("--developer-mode-off"))
+                    developerMode = false;
 
                 // get from environment variables
                 if (string.IsNullOrWhiteSpace(rawModsPath))
                     rawModsPath = Environment.GetEnvironmentVariable("SMAPI_MODS_PATH");
 
-                // normalise
+                // normalize
                 modsPath = !string.IsNullOrWhiteSpace(rawModsPath)
                     ? Path.Combine(Constants.GamePath, rawModsPath)
                     : Constants.DefaultModsPath;
             }
 
             // load SMAPI
-            using SCore core = new SCore(modsPath, writeToConsole, developerModeValue);
+            using SCore core = new SCore(modsPath, writeToConsole, developerMode);
             core.RunInteractively();
         }
 

From 6161cc91297dd215a35bfd4d8862d27a0d937898 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 11:54:23 -0400
Subject: [PATCH 517/856] fix config.user.json overriding new CLI arguments

---
 src/SMAPI/Framework/SCore.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 4746c2ce..44f46179 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -184,10 +184,9 @@ namespace StardewModdingAPI.Framework
 
             // init basics
             this.Settings = JsonConvert.DeserializeObject<SConfig>(File.ReadAllText(Constants.ApiConfigPath));
-            this.Settings.DeveloperMode = developerMode ?? this.Settings.DeveloperMode;
-
             if (File.Exists(Constants.ApiUserConfigPath))
                 JsonConvert.PopulateObject(File.ReadAllText(Constants.ApiUserConfigPath), this.Settings);
+            this.Settings.DeveloperMode = developerMode ?? this.Settings.DeveloperMode;
 
             this.LogManager = new LogManager(logPath: logPath, colorConfig: this.Settings.ConsoleColors, writeToConsole: writeToConsole, isVerbose: this.Settings.VerboseLogging, isDeveloperMode: this.Settings.DeveloperMode, getScreenIdForLog: this.GetScreenIdForLog);
             this.CommandManager = new CommandManager(this.Monitor);

From 288ef5dc0715339a3a0bf89975a6db7ab7408e2b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 12:03:30 -0400
Subject: [PATCH 518/856] add environment variable form of new CLI args, update
 docs

---
 docs/release-notes.md   | 2 +-
 docs/technical/smapi.md | 4 +++-
 src/SMAPI/Program.cs    | 6 ++++++
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index bb30f31a..9fc0d432 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -20,7 +20,6 @@
 * Added `data-*` attributes to the log parser page for external tools.
 * Fixed JSON validator showing incorrect error for update keys without a subkey.
 
-
 ### For mod authors
 This is a big release that includes the new APIs planned for SMAPI 4.0.0, alongside the old ones.
 
@@ -40,6 +39,7 @@ the C# mod that loads them is updated.
     _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
   * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
 * Other improvements:
+  * Added [command-line arguments](technical/smapi.md#command-line-arguments) to toggle developer mode (thanks to Tondorian!).
   * Added `IContentPack.ModContent` property.
   * Added `Constants.ContentPath`.
   * Added `IAssetName` fields to the info received by `IAssetEditor` and `IAssetLoader` methods.  
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 7da1e0f1..e117db2f 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -33,11 +33,12 @@ argument | purpose
 `--uninstall` | Preselects the uninstall action, skipping the prompt asking what the user wants to do.
 `--game-path "path"` | Specifies the full path to the folder containing the Stardew Valley executable, skipping automatic detection and any prompt to choose a path. If the path is not valid, the installer displays an error.
 
-SMAPI itself recognises two arguments **on Windows only**, but these are intended for internal use
+SMAPI itself recognises five arguments **on Windows only**, but these are intended for internal use
 or testing and may change without warning. On Linux/macOS, see _environment variables_ below.
 
 argument | purpose
 -------- | -------
+`--developer-mode`<br />`--developer-mode-off` | Enable or disable features intended for mod developers. Currently this only makes `TRACE`-level messages appear in the console.
 `--no-terminal` | The SMAPI launcher won't try to open a terminal window, and SMAPI won't log anything to the console. (Messages will still be written to the log file.)
 `--use-current-shell` | The SMAPI launcher won't try to open a terminal window, but SMAPI will still log to the console. (Messages will still be written to the log file.)
 `--mods-path` | The path to search for mods, if not the standard `Mods` folder. This can be a path relative to the game folder (like `--mods-path "Mods (test)"`) or an absolute path.
@@ -49,6 +50,7 @@ can set temporary environment variables instead. For example:
 
 environment variable | purpose
 -------------------- | -------
+`SMAPI_DEVELOPER_MODE` | Equivalent to `--developer-mode` and `--developer-mode-off` above. The value must be `true` or `false`.
 `SMAPI_MODS_PATH` | Equivalent to `--mods-path` above.
 `SMAPI_NO_TERMINAL` | Equivalent to `--no-terminal` above.
 `SMAPI_USE_CURRENT_SHELL` | Equivalent to `--use-current-shell` above.
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index 0c9c2d87..b2e213fe 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -200,6 +200,12 @@ namespace StardewModdingAPI
                 // get from environment variables
                 if (string.IsNullOrWhiteSpace(rawModsPath))
                     rawModsPath = Environment.GetEnvironmentVariable("SMAPI_MODS_PATH");
+                if (developerMode is null)
+                {
+                    string rawDeveloperMode = Environment.GetEnvironmentVariable("SMAPI_DEVELOPER_MODE");
+                    if (rawDeveloperMode != null)
+                        developerMode = bool.Parse(rawDeveloperMode);
+                }
 
                 // normalize
                 modsPath = !string.IsNullOrWhiteSpace(rawModsPath)

From b3519f3cc161f460e56cfc0a0662ec3b5bfb841b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 12:59:21 -0400
Subject: [PATCH 519/856] rename 'data' to 'state' for upcoming changes

---
 .../wwwroot/Content/js/log-parser.js          | 106 +++++++++---------
 1 file changed, 53 insertions(+), 53 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 1984d58f..51d6b53e 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -84,12 +84,12 @@ smapi.changePage = function (event) {
 }
 
 
-smapi.logParser = function (data, sectionUrl) {
-    if (!data)
-        data = {};
+smapi.logParser = function (state, sectionUrl) {
+    if (!state)
+        state = {};
 
     // internal filter counts
-    var stats = data.stats = {
+    var stats = state.stats = {
         modsShown: 0,
         modsHidden: 0
     };
@@ -98,9 +98,9 @@ smapi.logParser = function (data, sectionUrl) {
         // counts
         stats.modsShown = 0;
         stats.modsHidden = 0;
-        for (var key in data.showMods) {
-            if (data.showMods.hasOwnProperty(key)) {
-                if (data.showMods[key])
+        for (var key in state.showMods) {
+            if (state.showMods.hasOwnProperty(key)) {
+                if (state.showMods[key])
                     stats.modsShown++;
                 else
                     stats.modsHidden++;
@@ -165,38 +165,38 @@ smapi.logParser = function (data, sectionUrl) {
         messages = [];
 
     // set local time started
-    if (data.logStarted)
-        data.localTimeStarted = ("0" + data.logStarted.getHours()).slice(-2) + ":" + ("0" + data.logStarted.getMinutes()).slice(-2);
+    if (state.logStarted)
+        state.localTimeStarted = ("0" + state.logStarted.getHours()).slice(-2) + ":" + ("0" + state.logStarted.getMinutes()).slice(-2);
 
     // Add some properties to the data we're passing to Vue.
-    data.totalMessages = messages.length;
+    state.totalMessages = messages.length;
 
-    data.filterText = '';
-    data.filterRegex = '';
+    state.filterText = '';
+    state.filterRegex = '';
 
-    data.showContentPacks = true;
-    data.useHighlight = true;
-    data.useRegex = false;
-    data.useInsensitive = true;
-    data.useWord = false;
+    state.showContentPacks = true;
+    state.useHighlight = true;
+    state.useRegex = false;
+    state.useInsensitive = true;
+    state.useWord = false;
 
-    data.perPage = 1000;
-    data.page = 1;
+    state.perPage = 1000;
+    state.page = 1;
 
     // Now load these values.
     if (localStorage.settings) {
         try {
             const saved = JSON.parse(localStorage.settings);
             if (saved.hasOwnProperty('showContentPacks'))
-                data.showContentPacks = saved.showContentPacks;
+                state.showContentPacks = saved.showContentPacks;
             if (saved.hasOwnProperty('useHighlight'))
                 dat.useHighlight = saved.useHighlight;
             if (saved.hasOwnProperty('useRegex'))
-                data.useRegex = saved.useRegex;
+                state.useRegex = saved.useRegex;
             if (saved.hasOwnProperty('useInsensitive'))
-                data.useInsensitive = saved.useInsensitive;
+                state.useInsensitive = saved.useInsensitive;
             if (saved.hasOwnProperty('useWord'))
-                data.useWord = saved.useWord;
+                state.useWord = saved.useWord;
         } catch { /* ignore errors */ }
     }
 
@@ -458,7 +458,7 @@ smapi.logParser = function (data, sectionUrl) {
     // init app
     app = new Vue({
         el: '#output',
-        data: data,
+        data: state,
         computed: {
             anyModsHidden: function () {
                 return stats.modsHidden > 0;
@@ -474,14 +474,14 @@ smapi.logParser = function (data, sectionUrl) {
             // weird about accessing data entries on the app rather than
             // computed properties.
             hideContentPacks: function () {
-                return !data.showContentPacks;
+                return !state.showContentPacks;
             },
 
             // Filter messages for visibility.
-            filterUseRegex: function () { return data.useRegex; },
-            filterInsensitive: function () { return data.useInsensitive; },
-            filterUseWord: function () { return data.useWord; },
-            shouldHighlight: function () { return data.useHighlight; },
+            filterUseRegex: function () { return state.useRegex; },
+            filterInsensitive: function () { return state.useInsensitive; },
+            filterUseWord: function () { return state.useWord; },
+            shouldHighlight: function () { return state.useHighlight; },
 
             filteredMessages: function () {
                 if (!messages)
@@ -520,13 +520,13 @@ smapi.logParser = function (data, sectionUrl) {
 
             // And the rest are about pagination.
             start: function () {
-                return (this.page - 1) * data.perPage;
+                return (this.page - 1) * state.perPage;
             },
             end: function () {
                 return this.start + this.visibleMessages.length;
             },
             totalPages: function () {
-                return Math.ceil(this.filteredMessages.length / data.perPage);
+                return Math.ceil(this.filteredMessages.length / state.perPage);
             },
             // 
             visibleMessages: function () {
@@ -534,7 +534,7 @@ smapi.logParser = function (data, sectionUrl) {
                     return this.filteredMessages;
 
                 const start = this.start;
-                const end = start + data.perPage;
+                const end = start + state.perPage;
 
                 return this.filteredMessages.slice(start, end);
             }
@@ -555,7 +555,7 @@ smapi.logParser = function (data, sectionUrl) {
                     try {
                         const perPage = parseInt(params.get('PerPage'));
                         if (!isNaN(perPage) && isFinite(perPage) && perPage > 0)
-                            data.perPage = perPage;
+                            state.perPage = perPage;
                     } catch { /* ignore errors */ }
 
                 if (params.has('Page'))
@@ -567,37 +567,37 @@ smapi.logParser = function (data, sectionUrl) {
             },
 
             toggleLevel: function (id) {
-                if (!data.enableFilters)
+                if (!state.enableFilters)
                     return;
 
                 this.showLevels[id] = !this.showLevels[id];
             },
 
             toggleContentPacks: function () {
-                data.showContentPacks = !data.showContentPacks;
+                state.showContentPacks = !state.showContentPacks;
                 this.saveSettings();
             },
 
             toggleFilterUseRegex: function () {
-                data.useRegex = !data.useRegex;
+                state.useRegex = !state.useRegex;
                 this.saveSettings();
                 this.updateFilterText();
             },
 
             toggleFilterInsensitive: function () {
-                data.useInsensitive = !data.useInsensitive;
+                state.useInsensitive = !state.useInsensitive;
                 this.saveSettings();
                 this.updateFilterText();
             },
 
             toggleFilterWord: function () {
-                data.useWord = !data.useWord;
+                state.useWord = !state.useWord;
                 this.saveSettings();
                 this.updateFilterText();
             },
 
             toggleHighlight: function () {
-                data.useHighlight = !data.useHighlight;
+                state.useHighlight = !state.useHighlight;
                 this.saveSettings();
             },
 
@@ -626,11 +626,11 @@ smapi.logParser = function (data, sectionUrl) {
             // the user opens a log.
             saveSettings: function () {
                 localStorage.settings = JSON.stringify({
-                    showContentPacks: data.showContentPacks,
-                    useRegex: data.useRegex,
-                    useInsensitive: data.useInsensitive,
-                    useWord: data.useWord,
-                    useHighlight: data.useHighlight
+                    showContentPacks: state.showContentPacks,
+                    useRegex: state.useRegex,
+                    useInsensitive: state.useInsensitive,
+                    useWord: state.useWord,
+                    useHighlight: state.useHighlight
                 });
             },
 
@@ -640,8 +640,8 @@ smapi.logParser = function (data, sectionUrl) {
             // really care about.
             updateUrl: function () {
                 const url = new URL(location);
-                url.searchParams.set('Page', data.page);
-                url.searchParams.set('PerPage', data.perPage);
+                url.searchParams.set('Page', state.page);
+                url.searchParams.set('PerPage', state.perPage);
 
                 window.history.replaceState(null, document.title, url.toString());
             },
@@ -656,17 +656,17 @@ smapi.logParser = function (data, sectionUrl) {
                     this.filterText = '';
                     this.filterRegex = null;
                 } else {
-                    if (!data.useRegex)
+                    if (!state.useRegex)
                         text = escapeRegex(text);
                     this.filterRegex = new RegExp(
-                        data.useWord ? `\\b${text}\\b` : text,
-                        data.useInsensitive ? 'ig' : 'g'
+                        state.useWord ? `\\b${text}\\b` : text,
+                        state.useInsensitive ? 'ig' : 'g'
                     );
                 }
             }, 250),
 
             toggleMod: function (id) {
-                if (!data.enableFilters)
+                if (!state.enableFilters)
                     return;
 
                 var curShown = this.showMods[id];
@@ -689,14 +689,14 @@ smapi.logParser = function (data, sectionUrl) {
             },
 
             toggleSection: function (name) {
-                if (!data.enableFilters)
+                if (!state.enableFilters)
                     return;
 
                 this.showSections[name] = !this.showSections[name];
             },
 
             showAllMods: function () {
-                if (!data.enableFilters)
+                if (!state.enableFilters)
                     return;
 
                 for (var key in this.showMods) {
@@ -708,7 +708,7 @@ smapi.logParser = function (data, sectionUrl) {
             },
 
             hideAllMods: function () {
-                if (!data.enableFilters)
+                if (!state.enableFilters)
                     return;
 
                 for (var key in this.showMods) {

From 260dbbf205bfa86c76a999ccd00e01941e9ce469 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 13:02:25 -0400
Subject: [PATCH 520/856] standardize quote style

---
 .../wwwroot/Content/js/log-parser.js          | 192 +++++++++---------
 1 file changed, 96 insertions(+), 96 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 51d6b53e..9684834c 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -22,7 +22,7 @@ function debounce(fn, delay) {
 // Case insensitive text searching and match word searching is best done in
 // regex, so if the user isn't trying to use regex, escape their input.
 function escapeRegex(text) {
-    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
 // Use a scroll event to apply a sticky effect to the filters / pagination
@@ -31,9 +31,9 @@ function escapeRegex(text) {
 $(function () {
     let sticking = false;
 
-    document.addEventListener('scroll', function (event) {
-        const filters = document.getElementById('filters');
-        const holder = document.getElementById('filterHolder');
+    document.addEventListener("scroll", function (event) {
+        const filters = document.getElementById("filters");
+        const holder = document.getElementById("filterHolder");
         if (!filters || !holder)
             return;
 
@@ -45,10 +45,10 @@ $(function () {
         sticking = should_stick;
         if (sticking) {
             holder.style.marginBottom = `calc(1em + ${filters.offsetHeight}px)`;
-            filters.classList.add('sticky');
+            filters.classList.add("sticky");
         } else {
-            filters.classList.remove('sticky');
-            holder.style.marginBottom = '';
+            filters.classList.remove("sticky");
+            holder.style.marginBottom = "";
         }
     });
 });
@@ -74,7 +74,7 @@ smapi.nextPage = function () {
 }
 
 smapi.changePage = function (event) {
-    if (typeof event === 'number')
+    if (typeof event === "number")
         app.changePage(event);
     else if (event) {
         const page = parseInt(event.currentTarget.dataset.page);
@@ -114,19 +114,19 @@ smapi.logParser = function (state, sectionUrl) {
     // a lot of JSON and use Vue to build the list. This is a lot more
     // performant and easier on memory.Our JSON is stored in special script
     // tags, that we later remove to let the browser clean up even more memory.
-    let nodeParsedMessages = document.querySelector('script#parsedMessages');
+    let nodeParsedMessages = document.querySelector("script#parsedMessages");
     if (nodeParsedMessages) {
         messages = JSON.parse(nodeParsedMessages.textContent) || [];
-        const logLevels = JSON.parse(document.querySelector('script#logLevels').textContent) || {};
-        const logSections = JSON.parse(document.querySelector('script#logSections').textContent) || {};
-        const modSlugs = JSON.parse(document.querySelector('script#modSlugs').textContent) || {};
+        const logLevels = JSON.parse(document.querySelector("script#logLevels").textContent) || {};
+        const logSections = JSON.parse(document.querySelector("script#logSections").textContent) || {};
+        const modSlugs = JSON.parse(document.querySelector("script#modSlugs").textContent) || {};
 
         // Remove all references to the script tags and remove them from the
         // DOM so that the browser can clean them up.
         nodeParsedMessages.remove();
-        document.querySelector('script#logLevels').remove();
-        document.querySelector('script#logSections').remove();
-        document.querySelector('script#modSlugs').remove();
+        document.querySelector("script#logLevels").remove();
+        document.querySelector("script#logSections").remove();
+        document.querySelector("script#modSlugs").remove();
         nodeParsedMessages = null;
 
         // Pre-process the messages since they aren't quite serialized in
@@ -171,8 +171,8 @@ smapi.logParser = function (state, sectionUrl) {
     // Add some properties to the data we're passing to Vue.
     state.totalMessages = messages.length;
 
-    state.filterText = '';
-    state.filterRegex = '';
+    state.filterText = "";
+    state.filterRegex = "";
 
     state.showContentPacks = true;
     state.useHighlight = true;
@@ -187,15 +187,15 @@ smapi.logParser = function (state, sectionUrl) {
     if (localStorage.settings) {
         try {
             const saved = JSON.parse(localStorage.settings);
-            if (saved.hasOwnProperty('showContentPacks'))
+            if (saved.hasOwnProperty("showContentPacks"))
                 state.showContentPacks = saved.showContentPacks;
-            if (saved.hasOwnProperty('useHighlight'))
+            if (saved.hasOwnProperty("useHighlight"))
                 dat.useHighlight = saved.useHighlight;
-            if (saved.hasOwnProperty('useRegex'))
+            if (saved.hasOwnProperty("useRegex"))
                 state.useRegex = saved.useRegex;
-            if (saved.hasOwnProperty('useInsensitive'))
+            if (saved.hasOwnProperty("useInsensitive"))
                 state.useInsensitive = saved.useInsensitive;
-            if (saved.hasOwnProperty('useWord'))
+            if (saved.hasOwnProperty("useWord"))
                 state.useWord = saved.useWord;
         } catch { /* ignore errors */ }
     }
@@ -210,19 +210,19 @@ smapi.logParser = function (state, sectionUrl) {
         if (!fmt || !fmt.format) return `${value}`;
         return fmt.format(value);
     }
-    Vue.filter('number', formatNumber);
+    Vue.filter("number", formatNumber);
 
     // Strictly speaking, we don't need this. However, due to the way our
     // Vue template is living in-page the browser is "helpful" and moves
     // our <log-line />s outside of a basic <table> since obviously they
     // aren't table rows and don't belong inside a table. By using another
     // Vue component, we avoid that.
-    Vue.component('log-table', {
+    Vue.component("log-table", {
         functional: true,
         render: function (createElement, context) {
-            return createElement('table', {
+            return createElement("table", {
                 attrs: {
-                    id: 'log'
+                    id: "log"
                 }
             }, context.children);
         }
@@ -231,32 +231,32 @@ smapi.logParser = function (state, sectionUrl) {
     // The <filter-stats /> component draws a nice message under the filters
     // telling a user how many messages match their filters, and also expands
     // on how many of them they're seeing because of pagination.
-    Vue.component('filter-stats', {
+    Vue.component("filter-stats", {
         functional: true,
         render: function (createElement, context) {
             const props = context.props;
             if (props.pages > 1)
-                return createElement('div', {
-                    class: 'stats'
+                return createElement("div", {
+                    class: "stats"
                 }, [
-                    'showing ',
-                    createElement('strong', formatNumber(props.start + 1)),
-                    ' to ',
-                    createElement('strong', formatNumber(props.end)),
-                    ' of ',
-                    createElement('strong', formatNumber(props.filtered)),
-                    ' (total: ',
-                    createElement('strong', formatNumber(props.total)),
-                    ')'
+                    "showing ",
+                    createElement("strong", formatNumber(props.start + 1)),
+                    " to ",
+                    createElement("strong", formatNumber(props.end)),
+                    " of ",
+                    createElement("strong", formatNumber(props.filtered)),
+                    " (total: ",
+                    createElement("strong", formatNumber(props.total)),
+                    ")"
                 ]);
 
-            return createElement('div', {
-                class: 'stats'
+            return createElement("div", {
+                class: "stats"
             }, [
-                'showing ',
-                createElement('strong', formatNumber(props.filtered)),
-                ' out of ',
-                createElement('strong', formatNumber(props.total))
+                "showing ",
+                createElement("strong", formatNumber(props.filtered)),
+                " out of ",
+                createElement("strong", formatNumber(props.total))
             ]);
         }
     });
@@ -268,13 +268,13 @@ smapi.logParser = function (state, sectionUrl) {
             return;
 
         if (page > 1 && !visited.has(page - 1))
-            links.push(' … ');
+            links.push(" … ");
 
         visited.add(page);
-        links.push(createElement('span', {
-            class: page == currentPage ? 'active' : null,
+        links.push(createElement("span", {
+            class: page == currentPage ? "active" : null,
             attrs: {
-                'data-page': page
+                "data-page": page
             },
             on: {
                 click: smapi.changePage
@@ -282,7 +282,7 @@ smapi.logParser = function (state, sectionUrl) {
         }, formatNumber(page)));
     }
 
-    Vue.component('pager', {
+    Vue.component("pager", {
         functional: true,
         render: function (createElement, context) {
             const props = context.props;
@@ -309,34 +309,34 @@ smapi.logParser = function (state, sectionUrl) {
                 addPageLink(i, pageLinks, visited, createElement, props.page);
             }
 
-            return createElement('div', {
-                class: 'pager'
+            return createElement("div", {
+                class: "pager"
             }, [
-                createElement('span', {
-                    class: props.page <= 1 ? 'disabled' : null,
+                createElement("span", {
+                    class: props.page <= 1 ? "disabled" : null,
                     on: {
                         click: smapi.prevPage
                     }
-                }, 'Prev'),
-                ' ',
-                'Page ',
+                }, "Prev"),
+                " ",
+                "Page ",
                 formatNumber(props.page),
-                ' of ',
+                " of ",
                 formatNumber(props.pages),
-                ' ',
-                createElement('span', {
-                    class: props.page >= props.pages ? 'disabled' : null,
+                " ",
+                createElement("span", {
+                    class: props.page >= props.pages ? "disabled" : null,
                     on: {
                         click: smapi.nextPage
                     }
-                }, 'Next'),
-                createElement('div', {}, pageLinks)
+                }, "Next"),
+                createElement("div", {}, pageLinks)
             ]);
         }
     });
 
     // Our <log-line /> functional component draws each log line.
-    Vue.component('log-line', {
+    Vue.component("log-line", {
         functional: true,
         props: {
             showScreenId: {
@@ -357,19 +357,19 @@ smapi.logParser = function (state, sectionUrl) {
             const level = msg.LevelName;
 
             if (msg.isRepeated)
-                return createElement('tr', {
+                return createElement("tr", {
                     class: [
                         "mod",
                         level,
                         "mod-repeat"
                     ]
                 }, [
-                    createElement('td', {
+                    createElement("td", {
                         attrs: {
                             colspan: context.props.showScreenId ? 4 : 3
                         }
-                    }, ''),
-                    createElement('td', `repeats ${msg.Repeated} times`)
+                    }, ""),
+                    createElement("td", `repeats ${msg.Repeated} times`)
                 ]);
 
             const events = {};
@@ -377,9 +377,9 @@ smapi.logParser = function (state, sectionUrl) {
             if (msg.IsStartOfSection) {
                 const visible = msg.SectionName && window.app && app.sectionsAllow(msg.SectionName);
                 events.click = smapi.clickLogLine;
-                toggleMessage = visible ?
-                    'This section is shown. Click here to hide it.' :
-                    'This section is hidden. Click here to show it.';
+                toggleMessage = visible
+                    ? "This section is shown. Click here to hide it."
+                    : "This section is hidden. Click here to show it.";
             }
 
             let text = msg.Text;
@@ -402,7 +402,7 @@ smapi.logParser = function (state, sectionUrl) {
                         // Alright, do we have a previous match? If
                         // we do, we need to consume some text.
                         if (consumed < idx)
-                            text.push(createElement('strong', {}, msg.Text.slice(consumed, idx)));
+                            text.push(createElement("strong", {}, msg.Text.slice(consumed, idx)));
 
                         text.push(msg.Text.slice(idx, match.index));
                         consumed = match.index;
@@ -414,40 +414,40 @@ smapi.logParser = function (state, sectionUrl) {
                 // Add any trailing text after the last match was found.
                 if (consumed < msg.Text.length) {
                     if (consumed < idx)
-                        text.push(createElement('strong', {}, msg.Text.slice(consumed, idx)));
+                        text.push(createElement("strong", {}, msg.Text.slice(consumed, idx)));
 
                     if (idx < msg.Text.length)
                         text.push(msg.Text.slice(idx));
                 }
             }
 
-            return createElement('tr', {
+            return createElement("tr", {
                 class: [
                     "mod",
                     level,
                     msg.IsStartOfSection ? "section-start" : null
                 ],
                 attrs: {
-                    'data-section': msg.SectionName
+                    "data-section": msg.SectionName
                 },
                 on: events
             }, [
-                createElement('td', msg.Time),
-                context.props.showScreenId ? createElement('td', msg.ScreenId) : null,
-                createElement('td', level.toUpperCase()),
-                createElement('td', {
+                createElement("td", msg.Time),
+                context.props.showScreenId ? createElement("td", msg.ScreenId) : null,
+                createElement("td", level.toUpperCase()),
+                createElement("td", {
                     attrs: {
-                        'data-title': msg.Mod
+                        "data-title": msg.Mod
                     }
                 }, msg.Mod),
-                createElement('td', [
-                    createElement('span', {
-                        class: 'log-message-text'
+                createElement("td", [
+                    createElement("span", {
+                        class: "log-message-text"
                     }, text),
-                    msg.IsStartOfSection ? createElement('span', {
-                        class: 'section-toggle-message'
+                    msg.IsStartOfSection ? createElement("span", {
+                        class: "section-toggle-message"
                     }, [
-                        ' ',
+                        " ",
                         toggleMessage
                     ]) : null
                 ])
@@ -457,7 +457,7 @@ smapi.logParser = function (state, sectionUrl) {
 
     // init app
     app = new Vue({
-        el: '#output',
+        el: "#output",
         data: state,
         computed: {
             anyModsHidden: function () {
@@ -541,7 +541,7 @@ smapi.logParser = function (state, sectionUrl) {
         },
         created: function () {
             this.loadFromUrl = this.loadFromUrl.bind(this);
-            window.addEventListener('popstate', this.loadFromUrl);
+            window.addEventListener("popstate", this.loadFromUrl);
             this.loadFromUrl();
         },
         methods: {
@@ -551,16 +551,16 @@ smapi.logParser = function (state, sectionUrl) {
             // user can link to their exact page state for someone else?
             loadFromUrl: function () {
                 const params = new URL(location).searchParams;
-                if (params.has('PerPage'))
+                if (params.has("PerPage"))
                     try {
-                        const perPage = parseInt(params.get('PerPage'));
+                        const perPage = parseInt(params.get("PerPage"));
                         if (!isNaN(perPage) && isFinite(perPage) && perPage > 0)
                             state.perPage = perPage;
                     } catch { /* ignore errors */ }
 
-                if (params.has('Page'))
+                if (params.has("Page"))
                     try {
-                        const page = parseInt(params.get('Page'));
+                        const page = parseInt(params.get("Page"));
                         if (!isNaN(page) && isFinite(page) && page > 0)
                             this.page = page;
                     } catch { /* ignore errors */ }
@@ -640,8 +640,8 @@ smapi.logParser = function (state, sectionUrl) {
             // really care about.
             updateUrl: function () {
                 const url = new URL(location);
-                url.searchParams.set('Page', state.page);
-                url.searchParams.set('PerPage', state.perPage);
+                url.searchParams.set("Page", state.page);
+                url.searchParams.set("PerPage", state.perPage);
 
                 window.history.replaceState(null, document.title, url.toString());
             },
@@ -651,16 +651,16 @@ smapi.logParser = function (state, sectionUrl) {
             // since we use it for highlighting, and it also make case insensitivity
             // much easier.
             updateFilterText: debounce(function () {
-                let text = this.filterText = document.querySelector('input[type=text]').value;
+                let text = this.filterText = document.querySelector("input[type=text]").value;
                 if (!text || !text.length) {
-                    this.filterText = '';
+                    this.filterText = "";
                     this.filterRegex = null;
                 } else {
                     if (!state.useRegex)
                         text = escapeRegex(text);
                     this.filterRegex = new RegExp(
                         state.useWord ? `\\b${text}\\b` : text,
-                        state.useInsensitive ? 'ig' : 'g'
+                        state.useInsensitive ? "ig" : "g"
                     );
                 }
             }, 250),

From ccf760452d64e1965c92c5cf8af399a5e80d5a3a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 13:08:38 -0400
Subject: [PATCH 521/856] pass data directly to script instead of serializing &
 deserializing it

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  43 ++++---
 .../wwwroot/Content/js/log-parser.js          | 111 ++++++++----------
 2 files changed, 75 insertions(+), 79 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 8f44b4a2..ff8aa003 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -44,13 +44,6 @@
     <link rel="stylesheet" href="~/Content/css/log-parser.css" />
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3/dist/css/tabby-ui-vertical.min.css" />
 
-    @if (!Model.ShowRaw)
-    {
-    <script id="logSections" type="application/json">@this.ForJson(logSections)</script>
-    <script id="logLevels" type="application/json">@this.ForJson(logLevels)</script>
-    <script id="parsedMessages" type="application/json">@this.ForJson(log?.Messages)</script>
-    <script id="modSlugs" type="application/json">@this.ForJson(log?.Mods?.DistinctBy(m => m.Name).ToDictionary(m => m.Name, m => Model.GetSlug(m.Name)))</script>
-    }
     <script src="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/vue@2.6.14" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
@@ -58,15 +51,33 @@
     <script src="~/Content/js/log-parser.js"></script>
     <script>
         $(function() {
-            smapi.logParser({
-                logStarted: new Date(@this.ForJson(log?.Timestamp)),
-                showPopup: @this.ForJson(log == null),
-                showMods: @this.ForJson(log?.Mods?.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
-                showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, _ => false)),
-                showLevels: @this.ForJson(defaultFilters),
-                enableFilters: @this.ForJson(!Model.ShowRaw),
-                screenIds: @this.ForJson(screenIds)
-            }, '@this.Url.PlainAction("Index", "LogParser", values: null)');
+            smapi.logParser(
+                {
+                    logStarted: new Date(@this.ForJson(log?.Timestamp)),
+                    @if (!Model.ShowRaw)
+                    {
+                        <text>
+                            data: {
+                                messages: @this.ForJson(log?.Messages),
+                                sections: @this.ForJson(logSections),
+                                logLevels: @this.ForJson(logLevels),
+                                modSlugs: @this.ForJson(log?.Mods?.DistinctBy(p => p.Name).Select(p => new { p.Name, Slug = Model.GetSlug(p.Name) }).Where(p => p.Name != p.Slug).ToDictionary(p => p.Name, p => p.Slug)),
+                                screenIds: @this.ForJson(screenIds)
+                            },
+                        </text>
+                    }
+                    else
+                    {
+                        <text>data: null,</text>
+                    }
+                    showPopup: @this.ForJson(log == null),
+                    showMods: @this.ForJson(log?.Mods?.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
+                    showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, _ => false)),
+                    showLevels: @this.ForJson(defaultFilters),
+                    enableFilters: @this.ForJson(!Model.ShowRaw)
+                },
+                "@this.Url.PlainAction("Index", "LogParser", values: null)"
+            );
 
             new Tabby('[data-tabs]');
         });
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 9684834c..af7ceb1e 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -108,61 +108,46 @@ smapi.logParser = function (state, sectionUrl) {
         }
     }
 
-    // load our data
+    // preprocess data for display
+    messages = state.data?.messages || [];
+    if (messages.length) {
+        const levels = state.data.logLevels;
+        const sections = state.data.sections;
+        const modSlugs = state.data.modSlugs;
 
-    // Rather than pre-rendering the list elements into the document, we read
-    // a lot of JSON and use Vue to build the list. This is a lot more
-    // performant and easier on memory.Our JSON is stored in special script
-    // tags, that we later remove to let the browser clean up even more memory.
-    let nodeParsedMessages = document.querySelector("script#parsedMessages");
-    if (nodeParsedMessages) {
-        messages = JSON.parse(nodeParsedMessages.textContent) || [];
-        const logLevels = JSON.parse(document.querySelector("script#logLevels").textContent) || {};
-        const logSections = JSON.parse(document.querySelector("script#logSections").textContent) || {};
-        const modSlugs = JSON.parse(document.querySelector("script#modSlugs").textContent) || {};
-
-        // Remove all references to the script tags and remove them from the
-        // DOM so that the browser can clean them up.
-        nodeParsedMessages.remove();
-        document.querySelector("script#logLevels").remove();
-        document.querySelector("script#logSections").remove();
-        document.querySelector("script#modSlugs").remove();
-        nodeParsedMessages = null;
-
-        // Pre-process the messages since they aren't quite serialized in
-        // the format we want. We also want to freeze every last message
-        // so that Vue won't install its change listening behavior.
         for (let i = 0, length = messages.length; i < length; i++) {
-            const msg = messages[i];
-            msg.id = i;
-            msg.LevelName = logLevels && logLevels[msg.Level];
-            msg.SectionName = logSections && logSections[msg.Section];
-            msg.ModSlug = modSlugs && modSlugs[msg.Mod] || msg.Mod;
+            const message = messages[i];
+
+            // add unique ID
+            message.id = i;
+
+            // add display values
+            message.LevelName = levels[message.Level];
+            message.SectionName = sections[message.Section];
+            message.ModSlug = modSlugs[message.Mod] || message.Mod;
 
             // For repeated messages, since our <log-line /> component
             // can't return two rows, just insert a second message
             // which will display as the message repeated notice.
-            if (msg.Repeated > 0 && ! msg.isRepeated) {
-                const second = {
+            if (message.Repeated > 0 && !message.isRepeated) {
+                const repeatNote = {
                     id: i + 1,
-                    Level: msg.Level,
-                    Section: msg.Section,
-                    Mod: msg.Mod,
-                    Repeated: msg.Repeated,
+                    Level: message.Level,
+                    Section: message.Section,
+                    Mod: message.Mod,
+                    Repeated: message.Repeated,
                     isRepeated: true,
                 };
 
-                messages.splice(i + 1, 0, second);
+                messages.splice(i + 1, 0, repeatNote);
                 length++;
             }
 
-            Object.freeze(msg);
+            // let Vue know the message won't change, so it doesn't need to monitor it
+            Object.freeze(message);
         }
-
-        Object.freeze(messages);
-
-    } else
-        messages = [];
+    }
+    Object.freeze(messages);
 
     // set local time started
     if (state.logStarted)
@@ -353,10 +338,10 @@ smapi.logParser = function (state, sectionUrl) {
             }
         },
         render: function (createElement, context) {
-            const msg = context.props.message;
-            const level = msg.LevelName;
+            const message = context.props.message;
+            const level = message.LevelName;
 
-            if (msg.isRepeated)
+            if (message.isRepeated)
                 return createElement("tr", {
                     class: [
                         "mod",
@@ -369,20 +354,20 @@ smapi.logParser = function (state, sectionUrl) {
                             colspan: context.props.showScreenId ? 4 : 3
                         }
                     }, ""),
-                    createElement("td", `repeats ${msg.Repeated} times`)
+                    createElement("td", `repeats ${message.Repeated} times`)
                 ]);
 
             const events = {};
             let toggleMessage;
-            if (msg.IsStartOfSection) {
-                const visible = msg.SectionName && window.app && app.sectionsAllow(msg.SectionName);
+            if (message.IsStartOfSection) {
+                const visible = message.SectionName && window.app && app.sectionsAllow(message.SectionName);
                 events.click = smapi.clickLogLine;
                 toggleMessage = visible
                     ? "This section is shown. Click here to hide it."
                     : "This section is hidden. Click here to show it.";
             }
 
-            let text = msg.Text;
+            let text = message.Text;
             const filter = window.app && app.filterRegex;
             if (text && filter && context.props.highlight) {
                 text = [];
@@ -394,7 +379,7 @@ smapi.logParser = function (state, sectionUrl) {
                 // where a ton of single characters are in their own elements
                 // if the user gives us bad input.
 
-                while (match = filter.exec(msg.Text)) {
+                while (match = filter.exec(message.Text)) {
                     // Do we have an area of non-matching text? This
                     // happens if the new match's index is further
                     // along than the last index.
@@ -402,9 +387,9 @@ smapi.logParser = function (state, sectionUrl) {
                         // Alright, do we have a previous match? If
                         // we do, we need to consume some text.
                         if (consumed < idx)
-                            text.push(createElement("strong", {}, msg.Text.slice(consumed, idx)));
+                            text.push(createElement("strong", {}, message.Text.slice(consumed, idx)));
 
-                        text.push(msg.Text.slice(idx, match.index));
+                        text.push(message.Text.slice(idx, match.index));
                         consumed = match.index;
                     }
 
@@ -412,12 +397,12 @@ smapi.logParser = function (state, sectionUrl) {
                 }
 
                 // Add any trailing text after the last match was found.
-                if (consumed < msg.Text.length) {
+                if (consumed < message.Text.length) {
                     if (consumed < idx)
-                        text.push(createElement("strong", {}, msg.Text.slice(consumed, idx)));
+                        text.push(createElement("strong", {}, message.Text.slice(consumed, idx)));
 
-                    if (idx < msg.Text.length)
-                        text.push(msg.Text.slice(idx));
+                    if (idx < message.Text.length)
+                        text.push(message.Text.slice(idx));
                 }
             }
 
@@ -425,26 +410,26 @@ smapi.logParser = function (state, sectionUrl) {
                 class: [
                     "mod",
                     level,
-                    msg.IsStartOfSection ? "section-start" : null
+                    message.IsStartOfSection ? "section-start" : null
                 ],
                 attrs: {
-                    "data-section": msg.SectionName
+                    "data-section": message.SectionName
                 },
                 on: events
             }, [
-                createElement("td", msg.Time),
-                context.props.showScreenId ? createElement("td", msg.ScreenId) : null,
+                createElement("td", message.Time),
+                context.props.showScreenId ? createElement("td", message.ScreenId) : null,
                 createElement("td", level.toUpperCase()),
                 createElement("td", {
                     attrs: {
-                        "data-title": msg.Mod
+                        "data-title": message.Mod
                     }
-                }, msg.Mod),
+                }, message.Mod),
                 createElement("td", [
                     createElement("span", {
                         class: "log-message-text"
                     }, text),
-                    msg.IsStartOfSection ? createElement("span", {
+                    message.IsStartOfSection ? createElement("span", {
                         class: "section-toggle-message"
                     }, [
                         " ",
@@ -467,7 +452,7 @@ smapi.logParser = function (state, sectionUrl) {
                 return stats.modsShown > 0;
             },
             showScreenId: function () {
-                return this.screenIds.length > 1;
+                return this.data.screenIds.length > 1;
             },
 
             // Maybe not strictly necessary, but the Vue template is being

From ad4d065fe748b4f3f32a8bf03e9a96132e1a0c79 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 13:10:54 -0400
Subject: [PATCH 522/856] simplify code with generic Enum.GetValues

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index ff8aa003..cf7e0a5c 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -16,18 +16,15 @@
 
     IDictionary<string, LogModInfo[]> contentPacks = Model.GetContentPacksByMod();
     IDictionary<string, bool> defaultFilters = Enum
-        .GetValues(typeof(LogLevel))
-        .Cast<LogLevel>()
+        .GetValues<LogLevel>()
         .ToDictionary(level => level.ToString().ToLower(), level => level != LogLevel.Trace);
 
     IDictionary<int, string> logLevels = Enum
-        .GetValues(typeof(LogLevel))
-        .Cast<LogLevel>()
+        .GetValues<LogLevel>()
         .ToDictionary(level => (int)level, level => level.ToString().ToLower());
 
     IDictionary<int, string> logSections = Enum
-        .GetValues(typeof(LogSection))
-        .Cast<LogSection>()
+        .GetValues<LogSection>()
         .ToDictionary(section => (int)section, section => section.ToString());
 
     string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true);

From 650af7ef1ac1957919ab19ec3d06af97792c54f8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 13:59:56 -0400
Subject: [PATCH 523/856] enable nullable annotations in log parser (#837)

---
 .../Controllers/LogParserController.cs        |  8 +--
 .../Framework/LogParsing/LogMessageBuilder.cs | 25 ++++---
 .../Framework/LogParsing/LogParseException.cs |  2 -
 .../Framework/LogParsing/LogParser.cs         | 54 +++++++-------
 .../Framework/LogParsing/Models/LogMessage.cs | 38 ++++++++--
 .../Framework/LogParsing/Models/LogModInfo.cs | 71 +++++++++++++++----
 .../Framework/LogParsing/Models/ParsedLog.cs  | 20 +++---
 src/SMAPI.Web/ViewModels/LogParserModel.cs    | 51 +++++++++----
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 21 +++---
 9 files changed, 185 insertions(+), 105 deletions(-)

diff --git a/src/SMAPI.Web/Controllers/LogParserController.cs b/src/SMAPI.Web/Controllers/LogParserController.cs
index 524cfbcc..93f2613e 100644
--- a/src/SMAPI.Web/Controllers/LogParserController.cs
+++ b/src/SMAPI.Web/Controllers/LogParserController.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Linq;
 using System.Text;
@@ -47,7 +45,7 @@ namespace StardewModdingAPI.Web.Controllers
         [HttpGet]
         [Route("log")]
         [Route("log/{id}")]
-        public async Task<ActionResult> Index(string id = null, LogViewFormat format = LogViewFormat.Default, bool renew = false)
+        public async Task<ActionResult> Index(string? id = null, LogViewFormat format = LogViewFormat.Default, bool renew = false)
         {
             // fresh page
             if (string.IsNullOrWhiteSpace(id))
@@ -89,7 +87,7 @@ namespace StardewModdingAPI.Web.Controllers
         public async Task<ActionResult> PostAsync()
         {
             // get raw log text
-            string input = this.Request.Form["input"].FirstOrDefault();
+            string? input = this.Request.Form["input"].FirstOrDefault();
             if (string.IsNullOrWhiteSpace(input))
                 return this.View("Index", this.GetModel(null, uploadError: "The log file seems to be empty."));
 
@@ -111,7 +109,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="expiry">When the uploaded file will no longer be available.</param>
         /// <param name="uploadWarning">A non-blocking warning while uploading the log.</param>
         /// <param name="uploadError">An error which occurred while uploading the log.</param>
-        private LogParserModel GetModel(string pasteID, DateTime? expiry = null, string uploadWarning = null, string uploadError = null)
+        private LogParserModel GetModel(string? pasteID, DateTime? expiry = null, string? uploadWarning = null, string? uploadError = null)
         {
             Platform? platform = this.DetectClientPlatform();
 
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs b/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
index 1b692e63..a1384b8f 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogMessageBuilder.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Text;
 using StardewModdingAPI.Web.Framework.LogParsing.Models;
 
@@ -13,7 +12,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         ** Fields
         *********/
         /// <summary>The local time when the next log was posted.</summary>
-        public string Time { get; set; }
+        public string? Time { get; set; }
 
         /// <summary>The log level for the next log message.</summary>
         public LogLevel Level { get; set; }
@@ -22,7 +21,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         public int ScreenId { get; set; }
 
         /// <summary>The mod name for the next log message.</summary>
-        public string Mod { get; set; }
+        public string? Mod { get; set; }
 
         /// <summary>The text for the next log message.</summary>
         private readonly StringBuilder Text = new();
@@ -32,6 +31,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         ** Accessors
         *********/
         /// <summary>Whether the next log message has been started.</summary>
+        [MemberNotNullWhen(true, nameof(LogMessageBuilder.Time), nameof(LogMessageBuilder.Mod))]
         public bool Started { get; private set; }
 
 
@@ -72,19 +72,18 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         }
 
         /// <summary>Get a log message for the accumulated values.</summary>
-        public LogMessage Build()
+        public LogMessage? Build()
         {
             if (!this.Started)
                 return null;
 
-            return new LogMessage
-            {
-                Time = this.Time,
-                Level = this.Level,
-                ScreenId = this.ScreenId,
-                Mod = this.Mod,
-                Text = this.Text.ToString()
-            };
+            return new LogMessage(
+                time: this.Time,
+                level: this.Level,
+                screenId: this.ScreenId,
+                mod: this.Mod,
+                text: this.Text.ToString()
+            );
         }
 
         /// <summary>Reset to start a new log message.</summary>
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParseException.cs b/src/SMAPI.Web/Framework/LogParsing/LogParseException.cs
index 4ee58433..3f815e3e 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParseException.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParseException.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Web.Framework.LogParsing
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 4e61ac95..55272b23 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -55,7 +53,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         *********/
         /// <summary>Parse SMAPI log text.</summary>
         /// <param name="logText">The SMAPI log text.</param>
-        public ParsedLog Parse(string logText)
+        public ParsedLog Parse(string? logText)
         {
             try
             {
@@ -79,8 +77,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 };
 
                 // parse log messages
-                LogModInfo smapiMod = new() { Name = "SMAPI", Author = "Pathoschild", Description = "", Loaded = true };
-                LogModInfo gameMod = new() { Name = "game", Author = "", Description = "", Loaded = true };
+                LogModInfo smapiMod = new(name: "SMAPI", author: "Pathoschild", version: "", description: "", loaded: true);
+                LogModInfo gameMod = new(name: "game", author: "", version: "", description: "", loaded: true);
                 IDictionary<string, List<LogModInfo>> mods = new Dictionary<string, List<LogModInfo>>();
                 bool inModList = false;
                 bool inContentPackList = false;
@@ -103,7 +101,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             default:
                                 if (mods.TryGetValue(message.Mod, out var entries))
                                 {
-                                    foreach (var entry in entries)
+                                    foreach (LogModInfo entry in entries)
                                         entry.Errors++;
                                 }
                                 break;
@@ -133,9 +131,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             string author = match.Groups["author"].Value;
                             string description = match.Groups["description"].Value;
 
-                            if (!mods.TryGetValue(name, out List<LogModInfo> entries))
+                            if (!mods.TryGetValue(name, out List<LogModInfo>? entries))
                                 mods[name] = entries = new List<LogModInfo>();
-                            entries.Add(new LogModInfo { Name = name, Author = author, Version = version, Description = description, Loaded = true });
+                            entries.Add(new LogModInfo(name: name, author: author, version: version, description: description, loaded: true));
 
                             message.Section = LogSection.ModsList;
                         }
@@ -156,9 +154,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             string description = match.Groups["description"].Value;
                             string forMod = match.Groups["for"].Value;
 
-                            if (!mods.TryGetValue(name, out List<LogModInfo> entries))
+                            if (!mods.TryGetValue(name, out List<LogModInfo>? entries))
                                 mods[name] = entries = new List<LogModInfo>();
-                            entries.Add(new LogModInfo { Name = name, Author = author, Version = version, Description = description, ContentPackFor = forMod, Loaded = true });
+                            entries.Add(new LogModInfo(name: name, author: author, version: version, description: description, contentPackFor: forMod, loaded: true));
 
                             message.Section = LogSection.ContentPackList;
                         }
@@ -179,23 +177,19 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
 
                             if (mods.TryGetValue(name, out var entries))
                             {
-                                foreach (var entry in entries)
-                                {
-                                    entry.UpdateLink = link;
-                                    entry.UpdateVersion = version;
-                                }
+                                foreach (LogModInfo entry in entries)
+                                    entry.SetUpdate(version, link);
                             }
 
                             message.Section = LogSection.ModUpdateList;
                         }
-
                         else if (message.Level == LogLevel.Alert && this.SmapiUpdatePattern.IsMatch(message.Text))
                         {
                             Match match = this.SmapiUpdatePattern.Match(message.Text);
                             string version = match.Groups["version"].Value;
                             string link = match.Groups["link"].Value;
-                            smapiMod.UpdateVersion = version;
-                            smapiMod.UpdateLink = link;
+
+                            smapiMod.SetUpdate(version, link);
                         }
 
                         // platform info line
@@ -205,7 +199,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             log.ApiVersion = match.Groups["apiVersion"].Value;
                             log.GameVersion = match.Groups["gameVersion"].Value;
                             log.OperatingSystem = match.Groups["os"].Value;
-                            smapiMod.Version = log.ApiVersion;
+                            smapiMod.OverrideVersion(log.ApiVersion);
                         }
 
                         // mod path line
@@ -215,7 +209,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             log.ModPath = match.Groups["path"].Value;
                             int lastDelimiterPos = log.ModPath.LastIndexOfAny(new[] { '/', '\\' });
                             log.GamePath = lastDelimiterPos >= 0
-                                ? log.ModPath.Substring(0, lastDelimiterPos)
+                                ? log.ModPath[..lastDelimiterPos]
                                 : log.ModPath;
                         }
 
@@ -229,7 +223,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 }
 
                 // finalize log
-                gameMod.Version = log.GameVersion;
+                if (log.GameVersion != null)
+                    gameMod.OverrideVersion(log.GameVersion);
                 log.Mods = new[] { gameMod, smapiMod }.Concat(mods.Values.SelectMany(p => p).OrderBy(p => p.Name)).ToArray();
                 return log;
             }
@@ -261,7 +256,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         /// <param name="messages">The messages to filter.</param>
         private IEnumerable<LogMessage> CollapseRepeats(IEnumerable<LogMessage> messages)
         {
-            LogMessage next = null;
+            LogMessage? next = null;
+
             foreach (LogMessage message in messages)
             {
                 // new message
@@ -282,7 +278,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 yield return next;
                 next = message;
             }
-            yield return next;
+
+            if (next != null)
+                yield return next;
         }
 
         /// <summary>Split a SMAPI log into individual log messages.</summary>
@@ -295,7 +293,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
             while (true)
             {
                 // read line
-                string line = reader.ReadLine();
+                string? line = reader.ReadLine();
                 if (line == null)
                     break;
 
@@ -308,17 +306,17 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 {
                     if (builder.Started)
                     {
-                        yield return builder.Build();
+                        yield return builder.Build()!;
                         builder.Clear();
                     }
 
-                    var screenGroup = header.Groups["screen"];
+                    Group screenGroup = header.Groups["screen"];
                     builder.Start(
                         time: header.Groups["time"].Value,
                         level: Enum.Parse<LogLevel>(header.Groups["level"].Value, ignoreCase: true),
                         screenId: screenGroup.Success ? int.Parse(screenGroup.Value) : 0, // main player is always screen ID 0
                         mod: header.Groups["modName"].Value,
-                        text: line.Substring(header.Length)
+                        text: line[header.Length..]
                     );
                 }
                 else
@@ -332,7 +330,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
 
             // end last message
             if (builder.Started)
-                yield return builder.Build();
+                yield return builder.Build()!;
         }
     }
 }
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
index 57d28755..7a5f32e0 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogMessage.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Web.Framework.LogParsing.Models
 {
@@ -9,19 +9,19 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         ** Accessors
         *********/
         /// <summary>The local time when the log was posted.</summary>
-        public string Time { get; set; }
+        public string Time { get; }
 
         /// <summary>The log level.</summary>
-        public LogLevel Level { get; set; }
+        public LogLevel Level { get; }
 
         /// <summary>The screen ID in split-screen mode.</summary>
-        public int ScreenId { get; set; }
+        public int ScreenId { get; }
 
         /// <summary>The mod name.</summary>
-        public string Mod { get; set; }
+        public string Mod { get; }
 
         /// <summary>The log text.</summary>
-        public string Text { get; set; }
+        public string Text { get; }
 
         /// <summary>The number of times this message was repeated consecutively.</summary>
         public int Repeated { get; set; }
@@ -30,6 +30,32 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         public LogSection? Section { get; set; }
 
         /// <summary>Whether this message is the first one of its section.</summary>
+        [MemberNotNullWhen(true, nameof(LogMessage.Section))]
         public bool IsStartOfSection { get; set; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance/</summary>
+        /// <param name="time">The local time when the log was posted.</param>
+        /// <param name="level">The log level.</param>
+        /// <param name="screenId">The screen ID in split-screen mode.</param>
+        /// <param name="mod">The mod name.</param>
+        /// <param name="text">The log text.</param>
+        /// <param name="repeated">The number of times this message was repeated consecutively.</param>
+        /// <param name="section">The section that this log message belongs to.</param>
+        /// <param name="isStartOfSection">Whether this message is the first one of its section.</param>
+        public LogMessage(string time, LogLevel level, int screenId, string mod, string text, int repeated = 0, LogSection? section = null, bool isStartOfSection = false)
+        {
+            this.Time = time;
+            this.Level = level;
+            this.ScreenId = screenId;
+            this.Mod = mod;
+            this.Text = text;
+            this.Repeated = repeated;
+            this.Section = section;
+            this.IsStartOfSection = isStartOfSection;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
index 349312df..a6b9165c 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Web.Framework.LogParsing.Models
 {
@@ -9,36 +9,81 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         ** Accessors
         *********/
         /// <summary>The mod name.</summary>
-        public string Name { get; set; }
+        public string Name { get; }
 
         /// <summary>The mod author.</summary>
-        public string Author { get; set; }
-
-        /// <summary>The update version.</summary>
-        public string UpdateVersion { get; set; }
-
-        /// <summary>The update link.</summary>
-        public string UpdateLink { get; set; }
+        public string Author { get; }
 
         /// <summary>The mod version.</summary>
-        public string Version { get; set; }
+        public string Version { get; private set; }
 
         /// <summary>The mod description.</summary>
-        public string Description { get; set; }
+        public string Description { get; }
+
+        /// <summary>The update version.</summary>
+        public string? UpdateVersion { get; private set; }
+
+        /// <summary>The update link.</summary>
+        public string? UpdateLink { get; private set; }
 
         /// <summary>The name of the mod for which this is a content pack (if applicable).</summary>
-        public string ContentPackFor { get; set; }
+        public string? ContentPackFor { get; }
 
         /// <summary>The number of errors logged by this mod.</summary>
         public int Errors { get; set; }
 
         /// <summary>Whether the mod was loaded into the game.</summary>
-        public bool Loaded { get; set; }
+        public bool Loaded { get; }
 
         /// <summary>Whether the mod has an update available.</summary>
+        [MemberNotNullWhen(true, nameof(LogModInfo.UpdateVersion), nameof(LogModInfo.UpdateLink))]
         public bool HasUpdate => this.UpdateVersion != null && this.Version != this.UpdateVersion;
 
         /// <summary>Whether the mod is a content pack for another mod.</summary>
+        [MemberNotNullWhen(true, nameof(LogModInfo.ContentPackFor))]
         public bool IsContentPack => !string.IsNullOrWhiteSpace(this.ContentPackFor);
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="name">The mod name.</param>
+        /// <param name="author">The mod author.</param>
+        /// <param name="version">The mod version.</param>
+        /// <param name="description">The mod description.</param>
+        /// <param name="updateVersion">The update version.</param>
+        /// <param name="updateLink">The update link.</param>
+        /// <param name="contentPackFor">The name of the mod for which this is a content pack (if applicable).</param>
+        /// <param name="errors">The number of errors logged by this mod.</param>
+        /// <param name="loaded">Whether the mod was loaded into the game.</param>
+        public LogModInfo(string name, string author, string version, string description, string? updateVersion = null, string? updateLink = null, string? contentPackFor = null, int errors = 0, bool loaded = true)
+        {
+            this.Name = name;
+            this.Author = author;
+            this.Version = version;
+            this.Description = description;
+            this.UpdateVersion = updateVersion;
+            this.UpdateLink = updateLink;
+            this.ContentPackFor = contentPackFor;
+            this.Errors = errors;
+            this.Loaded = loaded;
+        }
+
+        /// <summary>Add an update alert for this mod.</summary>
+        /// <param name="updateVersion">The update version.</param>
+        /// <param name="updateLink">The update link.</param>
+        public void SetUpdate(string updateVersion, string updateLink)
+        {
+            this.UpdateVersion = updateVersion;
+            this.UpdateLink = updateLink;
+        }
+
+        /// <summary>Override the version number, for cases like SMAPI itself where the version is only known later during parsing.</summary>
+        /// <param name="version">The new mod version.</param>
+        public void OverrideVersion(string version)
+        {
+            this.Version = version;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
index dae91d84..6951e434 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Web.Framework.LogParsing.Models
 {
@@ -14,31 +13,32 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         ** Metadata
         ****/
         /// <summary>Whether the log file was successfully parsed.</summary>
+        [MemberNotNullWhen(true, nameof(ParsedLog.RawText))]
         public bool IsValid { get; set; }
 
         /// <summary>An error message indicating why the log file is invalid.</summary>
-        public string Error { get; set; }
+        public string? Error { get; set; }
 
         /// <summary>The raw log text.</summary>
-        public string RawText { get; set; }
+        public string? RawText { get; set; }
 
         /****
         ** Log data
         ****/
         /// <summary>The SMAPI version.</summary>
-        public string ApiVersion { get; set; }
+        public string? ApiVersion { get; set; }
 
         /// <summary>The game version.</summary>
-        public string GameVersion { get; set; }
+        public string? GameVersion { get; set; }
 
         /// <summary>The player's operating system.</summary>
-        public string OperatingSystem { get; set; }
+        public string? OperatingSystem { get; set; }
 
         /// <summary>The game install path.</summary>
-        public string GamePath { get; set; }
+        public string? GamePath { get; set; }
 
         /// <summary>The mod folder path.</summary>
-        public string ModPath { get; set; }
+        public string? ModPath { get; set; }
 
         /// <summary>The ISO 8601 timestamp when the log was started.</summary>
         public DateTimeOffset Timestamp { get; set; }
@@ -47,6 +47,6 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         public LogModInfo[] Mods { get; set; } = Array.Empty<LogModInfo>();
 
         /// <summary>The log messages.</summary>
-        public LogMessage[] Messages { get; set; }
+        public LogMessage[] Messages { get; set; } = Array.Empty<LogMessage>();
     }
 }
diff --git a/src/SMAPI.Web/ViewModels/LogParserModel.cs b/src/SMAPI.Web/ViewModels/LogParserModel.cs
index c768a08c..d7e4d810 100644
--- a/src/SMAPI.Web/ViewModels/LogParserModel.cs
+++ b/src/SMAPI.Web/ViewModels/LogParserModel.cs
@@ -1,9 +1,9 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Text.RegularExpressions;
+using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewModdingAPI.Web.Framework.LogParsing.Models;
 
@@ -23,40 +23,41 @@ namespace StardewModdingAPI.Web.ViewModels
         ** Accessors
         *********/
         /// <summary>The paste ID.</summary>
-        public string PasteID { get; set; }
+        public string? PasteID { get; }
 
         /// <summary>The viewer's detected OS, if known.</summary>
-        public Platform? DetectedPlatform { get; set; }
+        public Platform? DetectedPlatform { get; }
 
         /// <summary>The parsed log info.</summary>
-        public ParsedLog ParsedLog { get; set; }
+        public ParsedLog? ParsedLog { get; private set; }
 
         /// <summary>Whether to show the raw unparsed log.</summary>
-        public bool ShowRaw { get; set; }
+        public bool ShowRaw { get; private set; }
 
         /// <summary>A non-blocking warning while uploading the log.</summary>
-        public string UploadWarning { get; set; }
+        public string? UploadWarning { get; set; }
 
         /// <summary>An error which occurred while uploading the log.</summary>
-        public string UploadError { get; set; }
+        public string? UploadError { get; set; }
 
         /// <summary>An error which occurred while parsing the log file.</summary>
-        public string ParseError => this.ParsedLog?.Error;
+        public string? ParseError => this.ParsedLog?.Error;
 
         /// <summary>When the uploaded file will no longer be available.</summary>
         public DateTime? Expiry { get; set; }
 
+        /// <summary>Whether parsed log data is available.</summary>
+        [MemberNotNullWhen(true, nameof(LogParserModel.PasteID), nameof(LogParserModel.ParsedLog))]
+        public bool HasLog => this.ParsedLog != null;
+
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public LogParserModel() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="pasteID">The paste ID.</param>
         /// <param name="platform">The viewer's detected OS, if known.</param>
-        public LogParserModel(string pasteID, Platform? platform)
+        public LogParserModel(string? pasteID, Platform? platform)
         {
             this.PasteID = pasteID;
             this.DetectedPlatform = platform;
@@ -64,6 +65,26 @@ namespace StardewModdingAPI.Web.ViewModels
             this.ShowRaw = false;
         }
 
+        /// <summary>Construct an instance.</summary>
+        /// <param name="pasteId">The paste ID.</param>
+        /// <param name="detectedPlatform">The viewer's detected OS, if known.</param>
+        /// <param name="parsedLog">The parsed log info.</param>
+        /// <param name="showRaw">Whether to show the raw unparsed log.</param>
+        /// <param name="uploadWarning">A non-blocking warning while uploading the log.</param>
+        /// <param name="uploadError">An error which occurred while uploading the log.</param>
+        /// <param name="expiry">When the uploaded file will no longer be available.</param>
+        [JsonConstructor]
+        public LogParserModel(string pasteId, Platform? detectedPlatform, ParsedLog? parsedLog, bool showRaw, string? uploadWarning, string? uploadError, DateTime? expiry)
+        {
+            this.PasteID = pasteId;
+            this.DetectedPlatform = detectedPlatform;
+            this.ParsedLog = parsedLog;
+            this.ShowRaw = showRaw;
+            this.UploadWarning = uploadWarning;
+            this.UploadError = uploadError;
+            this.Expiry = expiry;
+        }
+
         /// <summary>Set the log parser result.</summary>
         /// <param name="parsedLog">The parsed log info.</param>
         /// <param name="showRaw">Whether to show the raw unparsed log.</param>
@@ -79,14 +100,14 @@ namespace StardewModdingAPI.Web.ViewModels
         public IDictionary<string, LogModInfo[]> GetContentPacksByMod()
         {
             // get all mods & content packs
-            LogModInfo[] mods = this.ParsedLog?.Mods;
+            LogModInfo[]? mods = this.ParsedLog?.Mods;
             if (mods == null || !mods.Any())
                 return new Dictionary<string, LogModInfo[]>();
 
             // group by mod
             return mods
                 .Where(mod => mod.IsContentPack)
-                .GroupBy(mod => mod.ContentPackFor)
+                .GroupBy(mod => mod.ContentPackFor!)
                 .ToDictionary(group => group.Key, group => group.ToArray());
         }
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index cf7e0a5c..a7552888 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -1,7 +1,3 @@
-@{
-    #nullable disable
-}
-
 @using Humanizer
 @using StardewModdingAPI.Toolkit.Utilities
 @using StardewModdingAPI.Web.Framework
@@ -12,7 +8,7 @@
 @{
     ViewData["Title"] = "SMAPI log parser";
 
-    ParsedLog log = Model!.ParsedLog;
+    ParsedLog? log = Model!.ParsedLog;
 
     IDictionary<string, LogModInfo[]> contentPacks = Model.GetContentPacksByMod();
     IDictionary<string, bool> defaultFilters = Enum
@@ -29,7 +25,7 @@
 
     string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true);
 
-    ISet<int> screenIds = new HashSet<int>(log?.Messages?.Select(p => p.ScreenId) ?? Array.Empty<int>());
+    ISet<int> screenIds = new HashSet<int>(log?.Messages.Select(p => p.ScreenId) ?? Array.Empty<int>());
 }
 
 @section Head {
@@ -58,7 +54,7 @@
                                 messages: @this.ForJson(log?.Messages),
                                 sections: @this.ForJson(logSections),
                                 logLevels: @this.ForJson(logLevels),
-                                modSlugs: @this.ForJson(log?.Mods?.DistinctBy(p => p.Name).Select(p => new { p.Name, Slug = Model.GetSlug(p.Name) }).Where(p => p.Name != p.Slug).ToDictionary(p => p.Name, p => p.Slug)),
+                                modSlugs: @this.ForJson(log?.Mods.DistinctBy(p => p.Name).Select(p => new { p.Name, Slug = Model.GetSlug(p.Name) }).Where(p => p.Name != p.Slug).ToDictionary(p => p.Name, p => p.Slug)),
                                 screenIds: @this.ForJson(screenIds)
                             },
                         </text>
@@ -68,7 +64,7 @@
                         <text>data: null,</text>
                     }
                     showPopup: @this.ForJson(log == null),
-                    showMods: @this.ForJson(log?.Mods?.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
+                    showMods: @this.ForJson(log?.Mods.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
                     showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, _ => false)),
                     showLevels: @this.ForJson(defaultFilters),
                     enableFilters: @this.ForJson(!Model.ShowRaw)
@@ -76,7 +72,7 @@
                 "@this.Url.PlainAction("Index", "LogParser", values: null)"
             );
 
-            new Tabby('[data-tabs]');
+            new Tabby("[data-tabs]");
         });
     </script>
 }
@@ -217,12 +213,12 @@ else if (log?.IsValid == true)
                     Consider updating these mods to fix problems:
 
                     <table id="updates" class="table">
-                        @foreach (LogModInfo mod in log.Mods.Where(mod => (mod.HasUpdate && !mod.IsContentPack) || (contentPacks.TryGetValue(mod.Name, out LogModInfo[] contentPackList) && contentPackList.Any(pack => pack.HasUpdate))))
+                        @foreach (LogModInfo mod in log.Mods.Where(mod => (mod.HasUpdate && !mod.IsContentPack) || (contentPacks.TryGetValue(mod.Name, out LogModInfo[]? contentPackList) && contentPackList.Any(pack => pack.HasUpdate))))
                         {
                             <tr class="mod-entry">
                                 <td>
                                     <strong class=@(!mod.HasUpdate ? "hidden" : "")>@mod.Name</strong>
-                                    @if (contentPacks != null && contentPacks.TryGetValue(mod.Name, out LogModInfo[] contentPackList))
+                                    @if (contentPacks != null && contentPacks.TryGetValue(mod.Name, out LogModInfo[]? contentPackList))
                                     {
                                         <div class="content-packs">
                                             @foreach (LogModInfo contentPack in contentPackList.Where(pack => pack.HasUpdate))
@@ -305,8 +301,7 @@ else if (log?.IsValid == true)
             </caption>
             @foreach (var mod in log.Mods.Where(p => p.Loaded && !p.IsContentPack))
             {
-                LogModInfo[]? contentPackList;
-                if (contentPacks == null || !contentPacks.TryGetValue(mod.Name, out contentPackList))
+                if (contentPacks == null || !contentPacks.TryGetValue(mod.Name, out LogModInfo[]? contentPackList))
                     contentPackList = null;
 
                 <tr v-on:click="toggleMod('@Model.GetSlug(mod.Name)')" class="mod-entry" v-bind:class="{ hidden: !showMods['@Model.GetSlug(mod.Name)'] }">

From 26d29a1070e00b4edeaf3334d4c4d072d52a56ff Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 15:44:17 -0400
Subject: [PATCH 524/856] minor refactoring

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  23 +-
 .../wwwroot/Content/css/log-parser.css        |   8 +-
 .../wwwroot/Content/js/log-parser.js          | 629 ++++++++++--------
 src/SMAPI.sln.DotSettings                     |   2 +
 4 files changed, 382 insertions(+), 280 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index a7552888..2d5dd403 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -68,8 +68,7 @@
                     showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, _ => false)),
                     showLevels: @this.ForJson(defaultFilters),
                     enableFilters: @this.ForJson(!Model.ShowRaw)
-                },
-                "@this.Url.PlainAction("Index", "LogParser", values: null)"
+                }
             );
 
             new Tabby("[data-tabs]");
@@ -296,7 +295,7 @@ else if (log?.IsValid == true)
                     <span class="notice txt"><i>click any mod to filter</i></span>
                     <span class="notice btn txt" v-on:click="showAllMods" v-bind:class="{ invisible: !anyModsHidden }">show all</span>
                     <span class="notice btn txt" v-on:click="hideAllMods" v-bind:class="{ invisible: !anyModsShown || !anyModsHidden }">hide all</span>
-                    <span class="notice btn txt" v-on:click="toggleContentPacks">toggle content packs</span>
+                    <span class="notice btn txt" v-on:click="toggleContentPacks">toggle content packs in list</span>
                 }
             </caption>
             @foreach (var mod in log.Mods.Where(p => p.Loaded && !p.IsContentPack))
@@ -316,7 +315,7 @@ else if (log?.IsValid == true)
                                     <text>+ @contentPack.Name @contentPack.Version</text><br />
                                 }
                             </div>
-                            <span v-else class="content-packs--short"> (+ @contentPackList.Length Content Packs)</span>
+                            <span v-else class="content-packs-collapsed"> (+ @contentPackList.Length content packs)</span>
                         }
                     </td>
                     <td>
@@ -365,14 +364,14 @@ else if (log?.IsValid == true)
                         <div class="filter-text">
                             <input
                                 type="text"
-                                v-bind:class="{ active: filterText && filterText != '' }"
+                                v-bind:class="{ active: !!filterText }"
                                 v-on:input="updateFilterText"
-                                placeholder="filter..."
+                                placeholder="search to filter log..."
                             />
-                            <span role="button" v-bind:class="{ active: filterUseRegex }" v-on:click="toggleFilterUseRegex" title="Use Regular Expression">.*</span>
-                            <span role="button" v-bind:class="{ active: !filterInsensitive }" v-on:click="toggleFilterInsensitive" title="Match Case">aA</span>
-                            <span role="button" v-bind:class="{ active: filterUseWord, 'whole-word': true }" v-on:click="toggleFilterWord" title="Match Whole Word"><i>Ab</i></span>
-                            <span role="button" v-bind:class="{ active: shouldHighlight }" v-on:click="toggleHighlight" title="Highlight Matches">HL</span>
+                            <span role="button" v-bind:class="{ active: filterUseRegex }" v-on:click="toggleFilterUseRegex" title="Use regular expression syntax.">.*</span>
+                            <span role="button" v-bind:class="{ active: !filterInsensitive }" v-on:click="toggleFilterInsensitive" title="Match exact capitalization only.">aA</span>
+                            <span role="button" v-bind:class="{ active: filterUseWord, 'whole-word': true }" v-on:click="toggleFilterWord" title="Match whole word only."><i>“ ”</i></span>
+                            <span role="button" v-bind:class="{ active: shouldHighlight }" v-on:click="toggleHighlight" title="Highlight matches in the log text.">HL</span>
                         </div>
                         <filter-stats
                             v-bind:start="start"
@@ -393,9 +392,7 @@ else if (log?.IsValid == true)
 
             <noscript>
                 <div>
-                    This website uses JavaScript to display a filterable table. To view this log, please either
-                    <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, format = LogViewFormat.RawView })">view the raw log</a>
-                    or enable JavaScript.
+                    This website uses JavaScript to display a filterable table. To view this log, please enable JavaScript or <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, format = LogViewFormat.RawView })">view the raw log</a>.
                 </div>
                 <br/>
             </noscript>
diff --git a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
index 94bc049b..41b54e11 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
@@ -113,7 +113,7 @@ table caption {
 }
 
 .table tr {
-    background: #eee
+    background: #eee;
 }
 
 #mods span.notice {
@@ -148,8 +148,10 @@ table caption {
     font-style: italic;
 }
 
-.content-packs--short {
+.table .content-packs-collapsed {
     opacity: 0.75;
+    font-size: 0.9em;
+    font-style: italic;
 }
 
 #metadata td:first-child {
@@ -157,7 +159,7 @@ table caption {
 }
 
 .table tr:nth-child(even) {
-    background: #fff
+    background: #fff;
 }
 
 #filters {
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index af7ceb1e..72cb4a11 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -1,29 +1,15 @@
-/* globals $ */
+/* globals $, Vue */
 
+/**
+ * The global SMAPI module.
+ */
 var smapi = smapi || {};
+
+/**
+ * The Vue app for the current page.
+ * @type {Vue}
+ */
 var app;
-var messages;
-
-
-// Necessary helper method for updating our text filter in a performant way.
-// Wouldn't want to update it for every individually typed character.
-function debounce(fn, delay) {
-    var timeoutID = null
-    return function () {
-        clearTimeout(timeoutID)
-        var args = arguments
-        var that = this
-        timeoutID = setTimeout(function () {
-            fn.apply(that, args)
-        }, delay)
-    }
-}
-
-// Case insensitive text searching and match word searching is best done in
-// regex, so if the user isn't trying to use regex, escape their input.
-function escapeRegex(text) {
-    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
 
 // Use a scroll event to apply a sticky effect to the filters / pagination
 // bar. We can't just use "position: sticky" due to how the page is structured
@@ -31,65 +17,133 @@ function escapeRegex(text) {
 $(function () {
     let sticking = false;
 
-    document.addEventListener("scroll", function (event) {
+    document.addEventListener("scroll", function () {
         const filters = document.getElementById("filters");
         const holder = document.getElementById("filterHolder");
         if (!filters || !holder)
             return;
 
         const offset = holder.offsetTop;
-        const should_stick = window.pageYOffset > offset;
-        if (should_stick === sticking)
+        const shouldStick = window.pageYOffset > offset;
+        if (shouldStick === sticking)
             return;
 
-        sticking = should_stick;
+        sticking = shouldStick;
         if (sticking) {
             holder.style.marginBottom = `calc(1em + ${filters.offsetHeight}px)`;
             filters.classList.add("sticky");
-        } else {
+        }
+        else {
             filters.classList.remove("sticky");
             holder.style.marginBottom = "";
         }
     });
 });
 
-// This method is called when we click a log line to toggle the visibility
-// of a section. Binding methods is problematic with functional components
-// so we just use the `data-section` parameter and our global reference
-// to the app.
-smapi.clickLogLine = function (event) {
-    app.toggleSection(event.currentTarget.dataset.section);
-    event.preventDefault();
-    return false;
-}
-
-// And these methods are called when doing pagination. Just makes things
-// easier, so may as well use helpers.
-smapi.prevPage = function () {
-    app.prevPage();
-}
-
-smapi.nextPage = function () {
-    app.nextPage();
-}
-
-smapi.changePage = function (event) {
-    if (typeof event === "number")
-        app.changePage(event);
-    else if (event) {
-        const page = parseInt(event.currentTarget.dataset.page);
-        if (!isNaN(page) && isFinite(page))
-            app.changePage(page);
-    }
-}
-
-
-smapi.logParser = function (state, sectionUrl) {
+/**
+ * Initialize a log parser view on the current page.
+ * @param {object} state The state options to use.
+ * @returns {void}
+ */
+smapi.logParser = function (state) {
     if (!state)
         state = {};
 
+    // internal helpers
+    const helpers = {
+        /**
+         * Get a handler which invokes the callback after a set delay, resetting the delay each time it's called.
+         * @param {(...*) => void} action The callback to invoke when the delay ends.
+         * @param {number} delay The number of milliseconds to delay the action after each call.
+         * @returns {() => void}
+         */
+        getDebouncedHandler(action, delay) {
+            let timeoutId = null;
+
+            return function () {
+                clearTimeout(timeoutId);
+
+                const args = arguments;
+                const self = this;
+
+                timeoutId = setTimeout(
+                    function () {
+                        action.apply(self, args);
+                    },
+                    delay
+                );
+            }
+        },
+
+        /**
+         * Escape regex special characters in the given string.
+         * @param {string} text
+         * @returns {string}
+         */
+        escapeRegex(text) {
+            return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        },
+
+        /**
+         * Format a number for the user's locale.
+         * @param {number} value The number to format.
+         * @returns {string}
+         */
+        formatNumber(value) {
+            const formatter = window.Intl && Intl.NumberFormat && new Intl.NumberFormat();
+            return formatter && formatter.format
+                ? formatter.format(value)
+                : `${value}`;
+        }
+    };
+
+    // internal event handlers
+    const handlers = {
+        /**
+         * Method called when the user clicks a log line to toggle the visibility of a section. Binding methods is problematic with functional components so we just use the `data-section` parameter and our global reference to the app.
+         * @param {any} event
+         * @returns {false}
+         */
+        clickLogLine(event) {
+            app.toggleSection(event.currentTarget.dataset.section);
+            event.preventDefault();
+            return false;
+        },
+
+        /**
+         * Navigate to the previous page of messages in the log.
+         * @returns {void}
+         */
+        prevPage() {
+            app.prevPage();
+        },
+
+        /**
+         * Navigate to the next page of messages in the log.
+         * @returns {void}
+         */
+        nextPage() {
+            app.nextPage();
+        },
+
+        /**
+         * Handle a click on a page number element.
+         * @param {number | Event} event
+         * @returns {void}
+         */
+        changePage(event) {
+            if (typeof event === "number")
+                app.changePage(event);
+            else if (event) {
+                const page = parseInt(event.currentTarget.dataset.page);
+                if (!isNaN(page) && isFinite(page))
+                    app.changePage(page);
+            }
+        }
+    };
+
     // internal filter counts
-    var stats = state.stats = {
+    const stats = state.stats = {
         modsShown: 0,
         modsHidden: 0
     };
@@ -98,7 +152,7 @@ smapi.logParser = function (state, sectionUrl) {
         // counts
         stats.modsShown = 0;
         stats.modsHidden = 0;
-        for (var key in state.showMods) {
+        for (let key in state.showMods) {
             if (state.showMods.hasOwnProperty(key)) {
                 if (state.showMods[key])
                     stats.modsShown++;
@@ -109,14 +163,14 @@ smapi.logParser = function (state, sectionUrl) {
     }
 
     // preprocess data for display
-    messages = state.data?.messages || [];
-    if (messages.length) {
+    state.messages = state.data?.messages || [];
+    if (state.messages.length) {
         const levels = state.data.logLevels;
         const sections = state.data.sections;
         const modSlugs = state.data.modSlugs;
 
-        for (let i = 0, length = messages.length; i < length; i++) {
-            const message = messages[i];
+        for (let i = 0, length = state.messages.length; i < length; i++) {
+            const message = state.messages[i];
 
             // add unique ID
             message.id = i;
@@ -136,10 +190,10 @@ smapi.logParser = function (state, sectionUrl) {
                     Section: message.Section,
                     Mod: message.Mod,
                     Repeated: message.Repeated,
-                    isRepeated: true,
+                    isRepeated: true
                 };
 
-                messages.splice(i + 1, 0, repeatNote);
+                state.messages.splice(i + 1, 0, repeatNote);
                 length++;
             }
 
@@ -147,55 +201,42 @@ smapi.logParser = function (state, sectionUrl) {
             Object.freeze(message);
         }
     }
-    Object.freeze(messages);
+    Object.freeze(state.messages);
 
     // set local time started
     if (state.logStarted)
         state.localTimeStarted = ("0" + state.logStarted.getHours()).slice(-2) + ":" + ("0" + state.logStarted.getMinutes()).slice(-2);
 
-    // Add some properties to the data we're passing to Vue.
-    state.totalMessages = messages.length;
-
+    // add the properties we're passing to Vue
+    state.totalMessages = state.messages.length;
     state.filterText = "";
     state.filterRegex = "";
-
     state.showContentPacks = true;
     state.useHighlight = true;
     state.useRegex = false;
     state.useInsensitive = true;
     state.useWord = false;
-
     state.perPage = 1000;
     state.page = 1;
 
-    // Now load these values.
+    // load saved values, if any
     if (localStorage.settings) {
         try {
             const saved = JSON.parse(localStorage.settings);
-            if (saved.hasOwnProperty("showContentPacks"))
-                state.showContentPacks = saved.showContentPacks;
-            if (saved.hasOwnProperty("useHighlight"))
-                dat.useHighlight = saved.useHighlight;
-            if (saved.hasOwnProperty("useRegex"))
-                state.useRegex = saved.useRegex;
-            if (saved.hasOwnProperty("useInsensitive"))
-                state.useInsensitive = saved.useInsensitive;
-            if (saved.hasOwnProperty("useWord"))
-                state.useWord = saved.useWord;
-        } catch { /* ignore errors */ }
+
+            state.showContentPacks = saved.showContentPacks ?? state.showContentPacks;
+            state.useHighlight = saved.useHighlight ?? state.useHighlight;
+            state.useRegex = saved.useRegex ?? state.useRegex;
+            state.useInsensitive = saved.useInsensitive ?? state.useInsensitive;
+            state.useWord = saved.useWord ?? state.useWord;
+        }
+        catch (error) {
+            // ignore settings if invalid
+        }
     }
 
-    // This would be easier if we could just use JSX but this project doesn't
-    // have a proper JavaScript build environment and I really don't feel
-    // like setting one up.
-
-    // Add a number formatter so that our numbers look nicer.
-    const fmt = window.Intl && Intl.NumberFormat && new Intl.NumberFormat();
-    function formatNumber(value) {
-        if (!fmt || !fmt.format) return `${value}`;
-        return fmt.format(value);
-    }
-    Vue.filter("number", formatNumber);
+    // add a number formatter so our numbers look nicer
+    Vue.filter("number", handlers.formatNumber);
 
     // Strictly speaking, we don't need this. However, due to the way our
     // Vue template is living in-page the browser is "helpful" and moves
@@ -205,11 +246,15 @@ smapi.logParser = function (state, sectionUrl) {
     Vue.component("log-table", {
         functional: true,
         render: function (createElement, context) {
-            return createElement("table", {
-                attrs: {
-                    id: "log"
-                }
-            }, context.children);
+            return createElement(
+                "table",
+                {
+                    attrs: {
+                        id: "log"
+                    }
+                },
+                context.children
+            );
         }
     });
 
@@ -220,29 +265,34 @@ smapi.logParser = function (state, sectionUrl) {
         functional: true,
         render: function (createElement, context) {
             const props = context.props;
-            if (props.pages > 1)
-                return createElement("div", {
-                    class: "stats"
-                }, [
-                    "showing ",
-                    createElement("strong", formatNumber(props.start + 1)),
-                    " to ",
-                    createElement("strong", formatNumber(props.end)),
-                    " of ",
-                    createElement("strong", formatNumber(props.filtered)),
-                    " (total: ",
-                    createElement("strong", formatNumber(props.total)),
-                    ")"
-                ]);
+            if (props.pages > 1) {
+                return createElement(
+                    "div",
+                    { class: "stats" },
+                    [
+                        "showing ",
+                        createElement("strong", helpers.formatNumber(props.start + 1)),
+                        " to ",
+                        createElement("strong", helpers.formatNumber(props.end)),
+                        " of ",
+                        createElement("strong", helpers.formatNumber(props.filtered)),
+                        " (total: ",
+                        createElement("strong", helpers.formatNumber(props.total)),
+                        ")"
+                    ]
+                );
+            }
 
-            return createElement("div", {
-                class: "stats"
-            }, [
-                "showing ",
-                createElement("strong", formatNumber(props.filtered)),
-                " out of ",
-                createElement("strong", formatNumber(props.total))
-            ]);
+            return createElement(
+                "div",
+                { class: "stats" },
+                [
+                    "showing ",
+                    createElement("strong", helpers.formatNumber(props.filtered)),
+                    " out of ",
+                    createElement("strong", helpers.formatNumber(props.total))
+                ]
+            );
         }
     });
 
@@ -256,15 +306,19 @@ smapi.logParser = function (state, sectionUrl) {
             links.push(" … ");
 
         visited.add(page);
-        links.push(createElement("span", {
-            class: page == currentPage ? "active" : null,
-            attrs: {
-                "data-page": page
+        links.push(createElement(
+            "span",
+            {
+                class: page === currentPage ? "active" : null,
+                attrs: {
+                    "data-page": page
+                },
+                on: {
+                    click: handlers.changePage
+                }
             },
-            on: {
-                click: smapi.changePage
-            }
-        }, formatNumber(page)));
+            helpers.formatNumber(page)
+        ));
     }
 
     Vue.component("pager", {
@@ -274,49 +328,55 @@ smapi.logParser = function (state, sectionUrl) {
             if (props.pages <= 1)
                 return null;
 
-            const visited = new Set;
+            const visited = new Set();
             const pageLinks = [];
 
             for (let i = 1; i <= 2; i++)
                 addPageLink(i, pageLinks, visited, createElement, props.page);
 
             for (let i = props.page - 2; i <= props.page + 2; i++) {
-                if (i < 1 || i > props.pages)
-                    continue;
-
-                addPageLink(i, pageLinks, visited, createElement, props.page);
+                if (i >= 1 && i <= props.pages)
+                    addPageLink(i, pageLinks, visited, createElement, props.page);
             }
 
             for (let i = props.pages - 2; i <= props.pages; i++) {
-                if (i < 1)
-                    continue;
-
-                addPageLink(i, pageLinks, visited, createElement, props.page);
+                if (i >= 1)
+                    addPageLink(i, pageLinks, visited, createElement, props.page);
             }
 
-            return createElement("div", {
-                class: "pager"
-            }, [
-                createElement("span", {
-                    class: props.page <= 1 ? "disabled" : null,
-                    on: {
-                        click: smapi.prevPage
-                    }
-                }, "Prev"),
-                " ",
-                "Page ",
-                formatNumber(props.page),
-                " of ",
-                formatNumber(props.pages),
-                " ",
-                createElement("span", {
-                    class: props.page >= props.pages ? "disabled" : null,
-                    on: {
-                        click: smapi.nextPage
-                    }
-                }, "Next"),
-                createElement("div", {}, pageLinks)
-            ]);
+            return createElement(
+                "div",
+                { class: "pager" },
+                [
+                    createElement(
+                        "span",
+                        {
+                            class: props.page <= 1 ? "disabled" : null,
+                            on: {
+                                click: handlers.prevPage
+                            }
+                        },
+                        "Prev"
+                    ),
+                    " ",
+                    "Page ",
+                    helpers.formatNumber(props.page),
+                    " of ",
+                    helpers.formatNumber(props.pages),
+                    " ",
+                    createElement(
+                        "span",
+                        {
+                            class: props.page >= props.pages ? "disabled" : null,
+                            on: {
+                                click: handlers.nextPage
+                            }
+                        },
+                        "Next"
+                    ),
+                    createElement("div", {}, pageLinks)
+                ]
+            );
         }
     });
 
@@ -342,26 +402,34 @@ smapi.logParser = function (state, sectionUrl) {
             const level = message.LevelName;
 
             if (message.isRepeated)
-                return createElement("tr", {
-                    class: [
-                        "mod",
-                        level,
-                        "mod-repeat"
+                return createElement(
+                    "tr",
+                    {
+                        class: [
+                            "mod",
+                            level,
+                            "mod-repeat"
+                        ]
+                    },
+                    [
+                        createElement(
+                            "td",
+                            {
+                                attrs: {
+                                    colspan: context.props.showScreenId ? 4 : 3
+                                }
+                            },
+                            ""
+                        ),
+                        createElement("td", `repeats ${message.Repeated} times`)
                     ]
-                }, [
-                    createElement("td", {
-                        attrs: {
-                            colspan: context.props.showScreenId ? 4 : 3
-                        }
-                    }, ""),
-                    createElement("td", `repeats ${message.Repeated} times`)
-                ]);
+                );
 
             const events = {};
             let toggleMessage;
             if (message.IsStartOfSection) {
                 const visible = message.SectionName && window.app && app.sectionsAllow(message.SectionName);
-                events.click = smapi.clickLogLine;
+                events.click = handlers.clickLogLine;
                 toggleMessage = visible
                     ? "This section is shown. Click here to hide it."
                     : "This section is hidden. Click here to show it.";
@@ -371,7 +439,9 @@ smapi.logParser = function (state, sectionUrl) {
             const filter = window.app && app.filterRegex;
             if (text && filter && context.props.highlight) {
                 text = [];
-                let match, consumed = 0, idx = 0;
+                let match;
+                let consumed = 0;
+                let index = 0;
                 filter.lastIndex = -1;
 
                 // Our logic to highlight the text is a bit funky because we
@@ -379,64 +449,85 @@ smapi.logParser = function (state, sectionUrl) {
                 // where a ton of single characters are in their own elements
                 // if the user gives us bad input.
 
-                while (match = filter.exec(message.Text)) {
+                while (true) {
+                    match = filter.exec(message.Text);
+                    if (!match)
+                        break;
+
                     // Do we have an area of non-matching text? This
                     // happens if the new match's index is further
                     // along than the last index.
-                    if (match.index > idx) {
+                    if (match.index > index) {
                         // Alright, do we have a previous match? If
                         // we do, we need to consume some text.
-                        if (consumed < idx)
-                            text.push(createElement("strong", {}, message.Text.slice(consumed, idx)));
+                        if (consumed < index)
+                            text.push(createElement("strong", {}, message.Text.slice(consumed, index)));
 
-                        text.push(message.Text.slice(idx, match.index));
+                        text.push(message.Text.slice(index, match.index));
                         consumed = match.index;
                     }
 
-                    idx = match.index + match[0].length;
+                    index = match.index + match[0].length;
                 }
 
                 // Add any trailing text after the last match was found.
                 if (consumed < message.Text.length) {
-                    if (consumed < idx)
-                        text.push(createElement("strong", {}, message.Text.slice(consumed, idx)));
+                    if (consumed < index)
+                        text.push(createElement("strong", {}, message.Text.slice(consumed, index)));
 
-                    if (idx < message.Text.length)
-                        text.push(message.Text.slice(idx));
+                    if (index < message.Text.length)
+                        text.push(message.Text.slice(index));
                 }
             }
 
-            return createElement("tr", {
-                class: [
-                    "mod",
-                    level,
-                    message.IsStartOfSection ? "section-start" : null
-                ],
-                attrs: {
-                    "data-section": message.SectionName
-                },
-                on: events
-            }, [
-                createElement("td", message.Time),
-                context.props.showScreenId ? createElement("td", message.ScreenId) : null,
-                createElement("td", level.toUpperCase()),
-                createElement("td", {
+            return createElement(
+                "tr",
+                {
+                    class: [
+                        "mod",
+                        level,
+                        message.IsStartOfSection ? "section-start" : null
+                    ],
                     attrs: {
-                        "data-title": message.Mod
-                    }
-                }, message.Mod),
-                createElement("td", [
-                    createElement("span", {
-                        class: "log-message-text"
-                    }, text),
-                    message.IsStartOfSection ? createElement("span", {
-                        class: "section-toggle-message"
-                    }, [
-                        " ",
-                        toggleMessage
-                    ]) : null
-                ])
-            ]);
+                        "data-section": message.SectionName
+                    },
+                    on: events
+                },
+                [
+                    createElement("td", message.Time),
+                    context.props.showScreenId ? createElement("td", message.ScreenId) : null,
+                    createElement("td", level.toUpperCase()),
+                    createElement(
+                        "td",
+                        {
+                            attrs: {
+                                "data-title": message.Mod
+                            }
+                        },
+                        message.Mod
+                    ),
+                    createElement(
+                        "td",
+                        [
+                            createElement(
+                                "span",
+                                { class: "log-message-text" },
+                                text
+                            ),
+                            message.IsStartOfSection
+                                ? createElement(
+                                    "span",
+                                    { class: "section-toggle-message" },
+                                    [
+                                        " ",
+                                        toggleMessage
+                                    ]
+                                )
+                                : null
+                        ]
+                    )
+                ]
+            );
         }
     });
 
@@ -463,44 +554,53 @@ smapi.logParser = function (state, sectionUrl) {
             },
 
             // Filter messages for visibility.
-            filterUseRegex: function () { return state.useRegex; },
-            filterInsensitive: function () { return state.useInsensitive; },
-            filterUseWord: function () { return state.useWord; },
-            shouldHighlight: function () { return state.useHighlight; },
+            filterUseRegex: function () {
+                return state.useRegex;
+            },
+            filterInsensitive: function () {
+                return state.useInsensitive;
+            },
+            filterUseWord: function () {
+                return state.useWord;
+            },
+            shouldHighlight: function () {
+                return state.useHighlight;
+            },
 
             filteredMessages: function () {
-                if (!messages)
+                if (!state.messages)
                     return [];
 
                 const start = performance.now();
-                const ret = [];
+                const filtered = [];
 
                 // This is slightly faster than messages.filter(), which is
                 // important when working with absolutely huge logs.
-                for (let i = 0, length = messages.length; i < length; i++) {
-                    const msg = messages[i];
+                for (let i = 0, length = state.messages.length; i < length; i++) {
+                    const msg = state.messages[i];
                     if (msg.SectionName && !msg.IsStartOfSection && !this.sectionsAllow(msg.SectionName))
                         continue;
 
                     if (!this.filtersAllow(msg.ModSlug, msg.LevelName))
                         continue;
 
-                    let text = msg.Text || (i > 0 ? messages[i - 1].Text : null);
+                    const text = msg.Text || (i > 0 ? state.messages[i - 1].Text : null);
 
                     if (this.filterRegex) {
                         this.filterRegex.lastIndex = -1;
                         if (!text || !this.filterRegex.test(text))
                             continue;
-                    } else if (this.filterText && (!text || text.indexOf(this.filterText) == -1))
+                    }
+                    else if (this.filterText && (!text || text.indexOf(this.filterText) === -1))
                         continue;
 
-                    ret.push(msg);
+                    filtered.push(msg);
                 }
 
                 const end = performance.now();
-                console.log(`filter took ${end - start}ms`);
+                //console.log(`applied ${(this.filterRegex ? "regex" : "text")} filter '${this.filterRegex || this.filterText}' in ${end - start}ms`);
 
-                return ret;
+                return filtered;
             },
 
             // And the rest are about pagination.
@@ -525,8 +625,7 @@ smapi.logParser = function (state, sectionUrl) {
             }
         },
         created: function () {
-            this.loadFromUrl = this.loadFromUrl.bind(this);
-            window.addEventListener("popstate", this.loadFromUrl);
+            window.addEventListener("popstate", () => this.loadFromUrl());
             this.loadFromUrl();
         },
         methods: {
@@ -536,19 +635,17 @@ smapi.logParser = function (state, sectionUrl) {
             // user can link to their exact page state for someone else?
             loadFromUrl: function () {
                 const params = new URL(location).searchParams;
-                if (params.has("PerPage"))
-                    try {
-                        const perPage = parseInt(params.get("PerPage"));
-                        if (!isNaN(perPage) && isFinite(perPage) && perPage > 0)
-                            state.perPage = perPage;
-                    } catch { /* ignore errors */ }
+                if (params.has("PerPage")) {
+                    const perPage = parseInt(params.get("PerPage"));
+                    if (!isNaN(perPage) && isFinite(perPage) && perPage > 0)
+                        state.perPage = perPage;
+                }
 
-                if (params.has("Page"))
-                    try {
-                        const page = parseInt(params.get("Page"));
-                        if (!isNaN(page) && isFinite(page) && page > 0)
-                            this.page = page;
-                    } catch { /* ignore errors */ }
+                if (params.has("Page")) {
+                    const page = parseInt(params.get("Page"));
+                    if (!isNaN(page) && isFinite(page) && page > 0)
+                        this.page = page;
+                }
             },
 
             toggleLevel: function (id) {
@@ -635,26 +732,30 @@ smapi.logParser = function (state, sectionUrl) {
             // a quarter second delay. We basically always build a regular expression
             // since we use it for highlighting, and it also make case insensitivity
             // much easier.
-            updateFilterText: debounce(function () {
-                let text = this.filterText = document.querySelector("input[type=text]").value;
-                if (!text || !text.length) {
-                    this.filterText = "";
-                    this.filterRegex = null;
-                } else {
-                    if (!state.useRegex)
-                        text = escapeRegex(text);
-                    this.filterRegex = new RegExp(
-                        state.useWord ? `\\b${text}\\b` : text,
-                        state.useInsensitive ? "ig" : "g"
-                    );
-                }
-            }, 250),
+            updateFilterText: helpers.getDebouncedHandler(
+                function () {
+                    let text = this.filterText = document.querySelector("input[type=text]").value;
+                    if (!text || !text.length) {
+                        this.filterText = "";
+                        this.filterRegex = null;
+                    }
+                    else {
+                        if (!state.useRegex)
+                            text = helpers.escapeRegex(text);
+                        this.filterRegex = new RegExp(
+                            state.useWord ? `\\b${text}\\b` : text,
+                            state.useInsensitive ? "ig" : "g"
+                        );
+                    }
+                },
+                250
+            ),
 
             toggleMod: function (id) {
                 if (!state.enableFilters)
                     return;
 
-                var curShown = this.showMods[id];
+                const curShown = this.showMods[id];
 
                 // first filter: only show this by default
                 if (stats.modsHidden === 0) {
@@ -684,7 +785,7 @@ smapi.logParser = function (state, sectionUrl) {
                 if (!state.enableFilters)
                     return;
 
-                for (var key in this.showMods) {
+                for (let key in this.showMods) {
                     if (this.showMods.hasOwnProperty(key)) {
                         this.showMods[key] = true;
                     }
@@ -696,7 +797,7 @@ smapi.logParser = function (state, sectionUrl) {
                 if (!state.enableFilters)
                     return;
 
-                for (var key in this.showMods) {
+                for (let key in this.showMods) {
                     if (this.showMods.hasOwnProperty(key)) {
                         this.showMods[key] = false;
                     }
@@ -717,7 +818,7 @@ smapi.logParser = function (state, sectionUrl) {
     /**********
     ** Upload form
     *********/
-    var input = $("#input");
+    const input = $("#input");
     if (input.length) {
         // file upload
         smapi.fileUpload({
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index 5b35c615..5cb13525 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -31,6 +31,8 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=craftables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=crossplatform/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=cutscene/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=debounce/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=debounced/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=decoratable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=devs/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=fallbacks/@EntryIndexedValue">True</s:Boolean>

From 07d07c79e00906f826cb6d3e7532f4a2ad2099ba Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 16:01:32 -0400
Subject: [PATCH 525/856] load raw data from JSON per discussion

This avoids loading the data synchronously as a JavaScript snippet, which improves performance when opening the page.
---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 45 ++++++++++++-------
 .../wwwroot/Content/js/log-parser.js          |  8 +++-
 2 files changed, 36 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 2d5dd403..11f15403 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -42,27 +42,40 @@
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
     <script src="~/Content/js/file-upload.js"></script>
     <script src="~/Content/js/log-parser.js"></script>
+
+    <script id="serializedData" type="application/json">
+        @if (!Model.ShowRaw)
+        {
+            <text>
+                {
+                    "messages": @this.ForJson(log?.Messages),
+                    "sections": @this.ForJson(logSections),
+                    "logLevels": @this.ForJson(logLevels),
+                    "modSlugs": @this.ForJson(log?.Mods.DistinctBy(p => p.Name).Select(p => new {p.Name, Slug = Model.GetSlug(p.Name)}).Where(p => p.Name != p.Slug).ToDictionary(p => p.Name, p => p.Slug)),
+                    "screenIds": @this.ForJson(screenIds)
+                }
+            </text>
+        }
+        else
+        {
+            <text>
+                {
+                    "messages": [],
+                    "sections": {},
+                    "logLevels": {},
+                    "modSlugs": {},
+                    "screenIds": []
+                }
+            </text>
+        }
+    </script>
+    
     <script>
         $(function() {
             smapi.logParser(
                 {
                     logStarted: new Date(@this.ForJson(log?.Timestamp)),
-                    @if (!Model.ShowRaw)
-                    {
-                        <text>
-                            data: {
-                                messages: @this.ForJson(log?.Messages),
-                                sections: @this.ForJson(logSections),
-                                logLevels: @this.ForJson(logLevels),
-                                modSlugs: @this.ForJson(log?.Mods.DistinctBy(p => p.Name).Select(p => new { p.Name, Slug = Model.GetSlug(p.Name) }).Where(p => p.Name != p.Slug).ToDictionary(p => p.Name, p => p.Slug)),
-                                screenIds: @this.ForJson(screenIds)
-                            },
-                        </text>
-                    }
-                    else
-                    {
-                        <text>data: null,</text>
-                    }
+                    dataElement: "script#serializedData",
                     showPopup: @this.ForJson(log == null),
                     showMods: @this.ForJson(log?.Mods.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
                     showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, _ => false)),
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 72cb4a11..5a12a521 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -162,8 +162,14 @@ smapi.logParser = function (state) {
         }
     }
 
+    // load raw log data
+    {
+        const dataElement = document.querySelector(state.dataElement);
+        state.data = JSON.parse(dataElement.textContent.trim());
+    }
+
     // preprocess data for display
-    state.messages = state.data?.messages || [];
+    state.messages = state.data.messages || [];
     if (state.messages.length) {
         const levels = state.data.logLevels;
         const sections = state.data.sections;

From ae7567674d480fbccf25b685d4ddceef01efcdb4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 16:05:34 -0400
Subject: [PATCH 526/856] restore data element unloading

---
 src/SMAPI.Web/wwwroot/Content/js/log-parser.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 5a12a521..59c6026c 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -166,6 +166,7 @@ smapi.logParser = function (state) {
     {
         const dataElement = document.querySelector(state.dataElement);
         state.data = JSON.parse(dataElement.textContent.trim());
+        dataElement.remove(); // let browser unload the data element since we won't need it anymore
     }
 
     // preprocess data for display

From 85c769d2a28da67bcc939ec2e6c458a3db81e77c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 16:57:41 -0400
Subject: [PATCH 527/856] update release notes

---
 docs/release-notes.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9fc0d432..0687b888 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,6 +16,12 @@
   * Fixed `set_farm_type` console command not updating warps.
 
 ### For the web UI
+* Overhauled log parser UI (thanks to KhloeLeclair!):
+  * Added pagination for big logs.
+  * Added search box to filter the log.
+  * Added option to show/hide content packs in the mod list.
+  * The filter options now stick to the top of the screen when scrolling.
+  * Rewrote rendering to improve performance.
 * Updated the JSON validator/schema for Content Patcher 1.25.0.
 * Added `data-*` attributes to the log parser page for external tools.
 * Fixed JSON validator showing incorrect error for update keys without a subkey.

From 376dadd3412752cf406958ca889e326bfdd53087 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 16:58:52 -0400
Subject: [PATCH 528/856] fix misplaced attribute (#837)

---
 src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
index 4c9ca2ff..960caf96 100644
--- a/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
+++ b/src/SMAPI.Toolkit/Framework/UpdateData/UpdateKey.cs
@@ -16,15 +16,15 @@ namespace StardewModdingAPI.Toolkit.Framework.UpdateData
         public ModSiteKey Site { get; }
 
         /// <summary>The mod ID within the repository.</summary>
-#if NET5_0_OR_GREATER
-        [MemberNotNullWhen(true, nameof(LooksValid))]
-#endif
         public string? ID { get; }
 
         /// <summary>If specified, a substring in download names/descriptions to match.</summary>
         public string? Subkey { get; }
 
         /// <summary>Whether the update key seems to be valid.</summary>
+#if NET5_0_OR_GREATER
+        [MemberNotNullWhen(true, nameof(UpdateKey.ID))]
+#endif
         public bool LooksValid { get; }
 
 

From 0336fb252420194d518d6c21c3d1a8f372565c2f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Apr 2022 17:04:39 -0400
Subject: [PATCH 529/856] add temporary cachebusting queries for log parser

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 11f15403..6c9feb43 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -34,14 +34,14 @@
         <meta name="robots" content="noindex" />
     }
     <link rel="stylesheet" href="~/Content/css/file-upload.css" />
-    <link rel="stylesheet" href="~/Content/css/log-parser.css" />
+    <link rel="stylesheet" href="~/Content/css/log-parser.css?r=20220409" />
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3/dist/css/tabby-ui-vertical.min.css" />
 
     <script src="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/vue@2.6.14" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
     <script src="~/Content/js/file-upload.js"></script>
-    <script src="~/Content/js/log-parser.js"></script>
+    <script src="~/Content/js/log-parser.js?r=20220409"></script>
 
     <script id="serializedData" type="application/json">
         @if (!Model.ShowRaw)

From c92efc65ce7cbfbca3e92e027141e6b8d90073c8 Mon Sep 17 00:00:00 2001
From: Nuz / Lovegood <nuztalgia@gmail.com>
Date: Sun, 10 Apr 2022 18:20:11 -0700
Subject: [PATCH 530/856] Make ModScanner ignore .gitignore files.

This is helpful for cases like this: https://cdn.discordapp.com/attachments/156109690059751424/962879339739885578/unknown.png
---
 src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 2af30092..59652832 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -56,7 +56,10 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 
             // Windows shortcut files
             ".url",
-            ".lnk"
+            ".lnk",
+
+            // gitignore files
+            ".gitignore"
         };
 
         /// <summary>The extensions for packed content files.</summary>

From 761f2d952b073b78a06453768992b7b0fd4c6463 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 10 Apr 2022 21:34:18 -0400
Subject: [PATCH 531/856] enable nullable annotations in mod data models (#837)

---
 src/SMAPI.Tests/Core/ModResolverTests.cs      | 29 +++++++++++------
 .../Framework/ModData/MetadataModel.cs        |  4 +--
 .../Framework/ModData/ModDataField.cs         | 10 +++---
 .../Framework/ModData/ModDataModel.cs         | 32 +++++++++++--------
 .../Framework/ModData/ModDataRecord.cs        | 10 +++---
 .../ModData/ModDataRecordVersionedFields.cs   | 28 +++++++++-------
 .../Framework/ModData/ModDatabase.cs          | 14 ++++----
 src/SMAPI.Toolkit/Properties/AssemblyInfo.cs  |  1 +
 .../Serialization/Models/Manifest.cs          |  2 +-
 9 files changed, 73 insertions(+), 57 deletions(-)

diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index e1b56559..b8649a7d 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -145,7 +145,7 @@ namespace SMAPI.Tests.Core
         {
             // arrange
             Mock<IModMetadata> mock = this.GetMetadata("Mod A", Array.Empty<string>(), allowStatusChange: true);
-            this.SetupMetadataForValidation(mock, new ModDataRecordVersionedFields
+            this.SetupMetadataForValidation(mock, new ModDataRecordVersionedFields(this.GetModDataRecord())
             {
                 Status = ModStatus.AssumeBroken
             });
@@ -216,9 +216,9 @@ namespace SMAPI.Tests.Core
             File.WriteAllText(Path.Combine(modFolder, manifest.EntryDll!), "");
 
             // arrange
-            Mock<IModMetadata> mock = new Mock<IModMetadata>(MockBehavior.Strict);
+            Mock<IModMetadata> mock = new(MockBehavior.Strict);
             mock.Setup(p => p.Status).Returns(ModMetadataStatus.Found);
-            mock.Setup(p => p.DataRecord).Returns(() => null);
+            mock.Setup(p => p.DataRecord).Returns(this.GetModDataRecordVersionedFields());
             mock.Setup(p => p.Manifest).Returns(manifest);
             mock.Setup(p => p.DirectoryPath).Returns(modFolder);
 
@@ -265,7 +265,7 @@ namespace SMAPI.Tests.Core
         public void ProcessDependencies_Skips_Failed()
         {
             // arrange
-            Mock<IModMetadata> mock = new Mock<IModMetadata>(MockBehavior.Strict);
+            Mock<IModMetadata> mock = new(MockBehavior.Strict);
             mock.Setup(p => p.Status).Returns(ModMetadataStatus.Failed);
 
             // act
@@ -380,7 +380,7 @@ namespace SMAPI.Tests.Core
             Mock<IModMetadata> modA = this.GetMetadata("Mod A");
             Mock<IModMetadata> modB = this.GetMetadata("Mod B", dependencies: new[] { "Mod A" });
             Mock<IModMetadata> modC = this.GetMetadata("Mod C", dependencies: new[] { "Mod B" }, allowStatusChange: true);
-            Mock<IModMetadata> modD = new Mock<IModMetadata>(MockBehavior.Strict);
+            Mock<IModMetadata> modD = new(MockBehavior.Strict);
             modD.Setup(p => p.Manifest).Returns<IManifest>(null);
             modD.Setup(p => p.Status).Returns(ModMetadataStatus.Failed);
 
@@ -516,8 +516,8 @@ namespace SMAPI.Tests.Core
         /// <param name="allowStatusChange">Whether the code being tested is allowed to change the mod status.</param>
         private Mock<IModMetadata> GetMetadata(IManifest manifest, bool allowStatusChange = false)
         {
-            Mock<IModMetadata> mod = new Mock<IModMetadata>(MockBehavior.Strict);
-            mod.Setup(p => p.DataRecord).Returns(() => null);
+            Mock<IModMetadata> mod = new(MockBehavior.Strict);
+            mod.Setup(p => p.DataRecord).Returns(this.GetModDataRecordVersionedFields());
             mod.Setup(p => p.Status).Returns(ModMetadataStatus.Found);
             mod.Setup(p => p.DisplayName).Returns(manifest.UniqueID);
             mod.Setup(p => p.Manifest).Returns(manifest);
@@ -538,11 +538,22 @@ namespace SMAPI.Tests.Core
         private void SetupMetadataForValidation(Mock<IModMetadata> mod, ModDataRecordVersionedFields? modRecord = null)
         {
             mod.Setup(p => p.Status).Returns(ModMetadataStatus.Found);
-            mod.Setup(p => p.DataRecord).Returns(() => null);
             mod.Setup(p => p.Manifest).Returns(this.GetManifest());
             mod.Setup(p => p.DirectoryPath).Returns(Path.GetTempPath());
-            mod.Setup(p => p.DataRecord).Returns(modRecord);
+            mod.Setup(p => p.DataRecord).Returns(modRecord ?? this.GetModDataRecordVersionedFields());
             mod.Setup(p => p.GetUpdateKeys(It.IsAny<bool>())).Returns(Enumerable.Empty<UpdateKey>());
         }
+
+        /// <summary>Generate a default mod data record.</summary>
+        private ModDataRecord GetModDataRecord()
+        {
+            return new("Default Display Name", new ModDataModel("Sample ID", null, ModWarning.None));
+        }
+
+        /// <summary>Generate a default mod data versioned fields instance.</summary>
+        private ModDataRecordVersionedFields GetModDataRecordVersionedFields()
+        {
+            return new ModDataRecordVersionedFields(this.GetModDataRecord());
+        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs b/src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs
index 3fa70615..da678ac9 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/MetadataModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Toolkit.Framework.ModData
@@ -11,6 +9,6 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         ** Accessors
         ********/
         /// <summary>Extra metadata about mods.</summary>
-        public IDictionary<string, ModDataModel> ModData { get; set; }
+        public IDictionary<string, ModDataModel> ModData { get; } = new Dictionary<string, ModDataModel>();
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
index 46cb81e1..9674d283 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataField.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Linq;
 
 namespace StardewModdingAPI.Toolkit.Framework.ModData
@@ -20,10 +18,10 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         public bool IsDefault { get; }
 
         /// <summary>The lowest version in the range, or <c>null</c> for all past versions.</summary>
-        public ISemanticVersion LowerVersion { get; }
+        public ISemanticVersion? LowerVersion { get; }
 
         /// <summary>The highest version in the range, or <c>null</c> for all future versions.</summary>
-        public ISemanticVersion UpperVersion { get; }
+        public ISemanticVersion? UpperVersion { get; }
 
 
         /*********
@@ -35,7 +33,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <param name="isDefault">Whether this field should only be applied if it's not already set.</param>
         /// <param name="lowerVersion">The lowest version in the range, or <c>null</c> for all past versions.</param>
         /// <param name="upperVersion">The highest version in the range, or <c>null</c> for all future versions.</param>
-        public ModDataField(ModDataFieldKey key, string value, bool isDefault, ISemanticVersion lowerVersion, ISemanticVersion upperVersion)
+        public ModDataField(ModDataFieldKey key, string value, bool isDefault, ISemanticVersion? lowerVersion, ISemanticVersion? upperVersion)
         {
             this.Key = key;
             this.Value = value;
@@ -46,7 +44,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
 
         /// <summary>Get whether this data field applies for the given manifest.</summary>
         /// <param name="manifest">The mod manifest.</param>
-        public bool IsMatch(IManifest manifest)
+        public bool IsMatch(IManifest? manifest)
         {
             return
                 manifest?.Version != null // ignore invalid manifest
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs
index 4d96a555..5912fb87 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -16,7 +14,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         ** Accessors
         *********/
         /// <summary>The mod's current unique ID.</summary>
-        public string ID { get; set; }
+        public string ID { get; }
 
         /// <summary>The former mod IDs (if any).</summary>
         /// <remarks>
@@ -25,14 +23,14 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// ID, if any. If the mod's ID changed over time, multiple variants can be separated by the
         /// <c>|</c> character.
         /// </remarks>
-        public string FormerIDs { get; set; }
+        public string? FormerIDs { get; }
 
         /// <summary>The mod warnings to suppress, even if they'd normally be shown.</summary>
-        public ModWarning SuppressWarnings { get; set; }
+        public ModWarning SuppressWarnings { get; }
 
         /// <summary>This field stores properties that aren't mapped to another field before they're parsed into <see cref="Fields"/>.</summary>
         [JsonExtensionData]
-        public IDictionary<string, JToken> ExtensionData { get; set; }
+        public IDictionary<string, JToken> ExtensionData { get; } = new Dictionary<string, JToken>();
 
         /// <summary>The versioned field data.</summary>
         /// <remarks>
@@ -52,6 +50,17 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="id">The mod's current unique ID.</param>
+        /// <param name="formerIds">The former mod IDs (if any).</param>
+        /// <param name="suppressWarnings">The mod warnings to suppress, even if they'd normally be shown.</param>
+        public ModDataModel(string id, string? formerIds, ModWarning suppressWarnings)
+        {
+            this.ID = id;
+            this.FormerIDs = formerIds;
+            this.SuppressWarnings = suppressWarnings;
+        }
+
         /// <summary>Get a parsed representation of the <see cref="Fields"/>.</summary>
         public IEnumerable<ModDataField> GetFields()
         {
@@ -61,8 +70,8 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
                 string packedKey = pair.Key;
                 string value = pair.Value;
                 bool isDefault = false;
-                ISemanticVersion lowerVersion = null;
-                ISemanticVersion upperVersion = null;
+                ISemanticVersion? lowerVersion = null;
+                ISemanticVersion? upperVersion = null;
 
                 // parse
                 string[] parts = packedKey.Split('|').Select(p => p.Trim()).ToArray();
@@ -113,11 +122,8 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         [OnDeserialized]
         private void OnDeserialized(StreamingContext context)
         {
-            if (this.ExtensionData != null)
-            {
-                this.Fields = this.ExtensionData.ToDictionary(p => p.Key, p => p.Value.ToString());
-                this.ExtensionData = null;
-            }
+            this.Fields = this.ExtensionData.ToDictionary(p => p.Key, p => p.Value.ToString());
+            this.ExtensionData.Clear();
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
index 4c09e1ba..e9ece387 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -22,7 +20,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         public string[] FormerIDs { get; }
 
         /// <summary>The mod warnings to suppress, even if they'd normally be shown.</summary>
-        public ModWarning SuppressWarnings { get; set; }
+        public ModWarning SuppressWarnings { get; }
 
         /// <summary>The versioned field data.</summary>
         public ModDataField[] Fields { get; }
@@ -72,9 +70,9 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         }
 
         /// <summary>Get the default update key for this mod, if any.</summary>
-        public string GetDefaultUpdateKey()
+        public string? GetDefaultUpdateKey()
         {
-            string updateKey = this.Fields.FirstOrDefault(p => p.Key == ModDataFieldKey.UpdateKey && p.IsDefault)?.Value;
+            string? updateKey = this.Fields.FirstOrDefault(p => p.Key == ModDataFieldKey.UpdateKey && p.IsDefault)?.Value;
             return !string.IsNullOrWhiteSpace(updateKey)
                 ? updateKey
                 : null;
@@ -84,7 +82,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <param name="manifest">The manifest to match.</param>
         public ModDataRecordVersionedFields GetVersionedFields(IManifest manifest)
         {
-            ModDataRecordVersionedFields parsed = new() { DisplayName = this.DisplayName, DataRecord = this };
+            ModDataRecordVersionedFields parsed = new(this);
             foreach (ModDataField field in this.Fields.Where(field => field.IsMatch(manifest)))
             {
                 switch (field.Key)
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
index b599b343..65fa424e 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecordVersionedFields.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Toolkit.Framework.ModData
 {
     /// <summary>The versioned fields from a <see cref="ModDataRecord"/> for a specific manifest.</summary>
@@ -9,24 +7,32 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         ** Accessors
         *********/
         /// <summary>The underlying data record.</summary>
-        public ModDataRecord DataRecord { get; set; }
+        public ModDataRecord DataRecord { get; }
 
-        /// <summary>The default mod name to display when the name isn't available (e.g. during dependency checks).</summary>
-        public string DisplayName { get; set; }
-
-        /// <summary>The update key to apply.</summary>
-        public string UpdateKey { get; set; }
+        /// <summary>The update key to apply (if any).</summary>
+        public string? UpdateKey { get; set; }
 
         /// <summary>The predefined compatibility status.</summary>
         public ModStatus Status { get; set; } = ModStatus.None;
 
         /// <summary>A reason phrase for the <see cref="Status"/>, or <c>null</c> to use the default reason.</summary>
-        public string StatusReasonPhrase { get; set; }
+        public string? StatusReasonPhrase { get; set; }
 
         /// <summary>Technical details shown in TRACE logs for the <see cref="Status"/>, or <c>null</c> to omit it.</summary>
-        public string StatusReasonDetails { get; set; }
+        public string? StatusReasonDetails { get; set; }
 
         /// <summary>The upper version for which the <see cref="Status"/> applies (if any).</summary>
-        public ISemanticVersion StatusUpperVersion { get; set; }
+        public ISemanticVersion? StatusUpperVersion { get; set; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="dataRecord">The underlying data record.</param>
+        public ModDataRecordVersionedFields(ModDataRecord dataRecord)
+        {
+            this.DataRecord = dataRecord;
+        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
index a5237334..168b8aac 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDatabase.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -16,7 +14,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         private readonly ModDataRecord[] Records;
 
         /// <summary>Get an update URL for an update key (if valid).</summary>
-        private readonly Func<string, string> GetUpdateUrl;
+        private readonly Func<string, string?> GetUpdateUrl;
 
 
         /*********
@@ -29,7 +27,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <summary>Construct an instance.</summary>
         /// <param name="records">The underlying mod data records indexed by default display name.</param>
         /// <param name="getUpdateUrl">Get an update URL for an update key (if valid).</param>
-        public ModDatabase(IEnumerable<ModDataRecord> records, Func<string, string> getUpdateUrl)
+        public ModDatabase(IEnumerable<ModDataRecord> records, Func<string, string?> getUpdateUrl)
         {
             this.Records = records.ToArray();
             this.GetUpdateUrl = getUpdateUrl;
@@ -43,7 +41,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
 
         /// <summary>Get a mod data record.</summary>
         /// <param name="modID">The unique mod ID.</param>
-        public ModDataRecord Get(string modID)
+        public ModDataRecord? Get(string? modID)
         {
             return !string.IsNullOrWhiteSpace(modID)
                 ? this.Records.FirstOrDefault(p => p.HasID(modID))
@@ -52,11 +50,11 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
 
         /// <summary>Get the mod page URL for a mod (if available).</summary>
         /// <param name="id">The unique mod ID.</param>
-        public string GetModPageUrlFor(string id)
+        public string? GetModPageUrlFor(string? id)
         {
             // get update key
-            ModDataRecord record = this.Get(id);
-            ModDataField updateKeyField = record?.Fields.FirstOrDefault(p => p.Key == ModDataFieldKey.UpdateKey);
+            ModDataRecord? record = this.Get(id);
+            ModDataField? updateKeyField = record?.Fields.FirstOrDefault(p => p.Key == ModDataFieldKey.UpdateKey);
             if (updateKeyField == null)
                 return null;
 
diff --git a/src/SMAPI.Toolkit/Properties/AssemblyInfo.cs b/src/SMAPI.Toolkit/Properties/AssemblyInfo.cs
index eede4562..6f5dffbe 100644
--- a/src/SMAPI.Toolkit/Properties/AssemblyInfo.cs
+++ b/src/SMAPI.Toolkit/Properties/AssemblyInfo.cs
@@ -2,4 +2,5 @@ using System.Runtime.CompilerServices;
 
 [assembly: InternalsVisibleTo("StardewModdingAPI")]
 [assembly: InternalsVisibleTo("SMAPI.Installer")]
+[assembly: InternalsVisibleTo("SMAPI.Tests")]
 [assembly: InternalsVisibleTo("SMAPI.Web")]
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 01010602..da3ad608 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -46,7 +46,7 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
 
         /// <summary>Any manifest fields which didn't match a valid field.</summary>
         [JsonExtensionData]
-        public IDictionary<string, object> ExtraFields { get; set; } = new Dictionary<string, object>();
+        public IDictionary<string, object> ExtraFields { get; } = new Dictionary<string, object>();
 
 
         /*********

From 2a05e287821c3ce48a79705d39d190b84c48d361 Mon Sep 17 00:00:00 2001
From: Nuz / Lovegood <nuztalgia@gmail.com>
Date: Sun, 10 Apr 2022 23:33:32 -0700
Subject: [PATCH 532/856] Revert "Make ModScanner ignore .gitignore files."

This reverts commit c92efc65ce7cbfbca3e92e027141e6b8d90073c8.
---
 src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 59652832..2af30092 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -56,10 +56,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 
             // Windows shortcut files
             ".url",
-            ".lnk",
-
-            // gitignore files
-            ".gitignore"
+            ".lnk"
         };
 
         /// <summary>The extensions for packed content files.</summary>

From 25e0b4b8ada9ce7aa02f9eafaf5e0609977685c4 Mon Sep 17 00:00:00 2001
From: Nuz / Lovegood <nuztalgia@gmail.com>
Date: Sun, 10 Apr 2022 23:34:50 -0700
Subject: [PATCH 533/856] Make IsRelevant return false for any files starting
 with "."

---
 src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 2af30092..12333c4e 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -306,8 +306,8 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         /// <param name="entry">The file or folder.</param>
         private bool IsRelevant(FileSystemInfo entry)
         {
-            // ignored file extension
-            if (entry is FileInfo file && this.IgnoreFileExtensions.Contains(file.Extension))
+            // ignored file extensions and any files starting with "."
+            if ((entry is FileInfo file) && (this.IgnoreFileExtensions.Contains(file.Extension) || file.Name.StartsWith(".")))
                 return false;
 
             // ignored entry name

From 0babc3e4461db10b05a60c138de017ff032dc884 Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Mon, 11 Apr 2022 14:29:33 -0400
Subject: [PATCH 534/856] Cleanup log filtering a bit, with a clearer string
 for the number of total messages. Additionally, save and restore filter state
 from the URL for better linking.

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  12 +-
 .../wwwroot/Content/js/log-parser.js          | 233 ++++++++++++++----
 2 files changed, 196 insertions(+), 49 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 6c9feb43..7aa0fd6b 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -77,14 +77,19 @@
                     logStarted: new Date(@this.ForJson(log?.Timestamp)),
                     dataElement: "script#serializedData",
                     showPopup: @this.ForJson(log == null),
-                    showMods: @this.ForJson(log?.Mods.Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
+                    showMods: @this.ForJson(log?.Mods.Where(p => p.Loaded && !p.IsContentPack).Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
                     showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, _ => false)),
                     showLevels: @this.ForJson(defaultFilters),
                     enableFilters: @this.ForJson(!Model.ShowRaw)
                 }
             );
 
-            new Tabby("[data-tabs]");
+            @if (log == null)
+            {
+                <text>
+                    new Tabby("[data-tabs]");
+                </text>
+            }
         });
     </script>
 }
@@ -378,6 +383,7 @@ else if (log?.IsValid == true)
                             <input
                                 type="text"
                                 v-bind:class="{ active: !!filterText }"
+                                v-model="filterText"
                                 v-on:input="updateFilterText"
                                 placeholder="search to filter log..."
                             />
@@ -390,7 +396,7 @@ else if (log?.IsValid == true)
                             v-bind:start="start"
                             v-bind:end="end"
                             v-bind:pages="totalPages"
-                            v-bind:filtered="filteredMessages.length"
+                            v-bind:filtered="filteredMessages.total"
                             v-bind:total="totalMessages"
                         />
                     </div>
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 59c6026c..69f0a46d 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -94,7 +94,93 @@ smapi.logParser = function (state) {
             return formatter && formatter.format
                 ? formatter.format(value)
                 : `${value}`;
+        },
+
+        /**
+         * Convert an array of boolean values into a bitmap.
+         * @param {Boolean[]} value An array of boolean values
+         * @returns {BigInt}
+         */
+        toBitmap(value) {
+            let result = BigInt(0);
+            if (!Array.isArray(value))
+                return value ? BigInt(1) : BigInt(0);
+
+            for (let i = 0; i < value.length; i++) {
+                if (value[i])
+                    result += BigInt(2) ** BigInt(value.length - i - 1);
+            }
+
+            return result;
+        },
+
+        /**
+         * Convert a bitmap into an array of boolean values.
+         * @param {BigInt} value The bitmap
+         * @param {Number} length The expected length of the result
+         * @returns {Boolean[]}
+         */
+        fromBitmap(value, length = -1) {
+            if (typeof value != "bigint")
+                value = "";
+            else
+                value = value.toString(2);
+
+            const result = [];
+            while (length > value.length) {
+                result.push(false);
+                length--;
+            }
+
+            for (let i = 0; i < value.length; i++) {
+                result.push(value[i] === "1" ? true : false);
+            }
+
+            return result;
+        },
+
+        b64ToBigInt(value) {
+            const bin = atob(value);
+            const hex = [];
+
+            for (let i = 0; i < bin.length; i++) {
+                let h = bin.charCodeAt(i).toString(16);
+                if (h.length % 2) h = `0${h}`;
+                hex.push(h);
+            }
+
+            return BigInt(`0x${hex.join('')}`);
+        },
+
+        bigIntTo64(value) {
+            let hex = value.toString(16);
+            if (hex.length % 2) hex = `0${hex}`;
+
+            const result = [];
+            for (let i = 0; i < hex.length; i += 2) {
+                const val = parseInt(hex.slice(i, i + 2), 16);
+                result.push(String.fromCharCode(val));
+            }
+
+            return btoa(result.join(''));
+        },
+
+        b64ToUrl(value) {
+            return value.replace(/\//g, '_').replace(/=/g, '-').replace(/\+/g, '.');
+        },
+
+        urlTob64(value) {
+            return value.replace(/_/g, '/').replace(/-/g, '=').replace(/\./g, '+');
+        },
+
+        toUrlBitmap(value) {
+            return helpers.b64ToUrl(helpers.bigIntTo64(helpers.toBitmap(value)));
+        },
+
+        fromUrlBitmap(value, length = -1) {
+            return helpers.fromBitmap(helpers.b64ToBigInt(helpers.urlTob64(value)), length);
         }
+
     };
 
     // internal event handlers
@@ -272,32 +358,19 @@ smapi.logParser = function (state) {
         functional: true,
         render: function (createElement, context) {
             const props = context.props;
-            if (props.pages > 1) {
-                return createElement(
-                    "div",
-                    { class: "stats" },
-                    [
-                        "showing ",
-                        createElement("strong", helpers.formatNumber(props.start + 1)),
-                        " to ",
-                        createElement("strong", helpers.formatNumber(props.end)),
-                        " of ",
-                        createElement("strong", helpers.formatNumber(props.filtered)),
-                        " (total: ",
-                        createElement("strong", helpers.formatNumber(props.total)),
-                        ")"
-                    ]
-                );
-            }
-
             return createElement(
                 "div",
                 { class: "stats" },
                 [
                     "showing ",
+                    createElement("strong", helpers.formatNumber(props.start + 1)),
+                    " to ",
+                    createElement("strong", helpers.formatNumber(props.end)),
+                    " of ",
                     createElement("strong", helpers.formatNumber(props.filtered)),
-                    " out of ",
-                    createElement("strong", helpers.formatNumber(props.total))
+                    " (total: ",
+                    createElement("strong", helpers.formatNumber(props.total)),
+                    ")"
                 ]
             );
         }
@@ -578,34 +651,39 @@ smapi.logParser = function (state) {
                 if (!state.messages)
                     return [];
 
-                const start = performance.now();
+                //const start = performance.now();
                 const filtered = [];
 
+                let total = 0;
+
                 // This is slightly faster than messages.filter(), which is
                 // important when working with absolutely huge logs.
                 for (let i = 0, length = state.messages.length; i < length; i++) {
                     const msg = state.messages[i];
-                    if (msg.SectionName && !msg.IsStartOfSection && !this.sectionsAllow(msg.SectionName))
-                        continue;
-
                     if (!this.filtersAllow(msg.ModSlug, msg.LevelName))
                         continue;
 
-                    const text = msg.Text || (i > 0 ? state.messages[i - 1].Text : null);
-
                     if (this.filterRegex) {
+                        const text = msg.Text || (i > 0 ? state.messages[i - 1].Text : null);
                         this.filterRegex.lastIndex = -1;
                         if (!text || !this.filterRegex.test(text))
                             continue;
                     }
-                    else if (this.filterText && (!text || text.indexOf(this.filterText) === -1))
+
+                    total++;
+
+                    if (msg.SectionName && !msg.IsStartOfSection && !this.sectionsAllow(msg.SectionName))
                         continue;
 
                     filtered.push(msg);
                 }
 
-                const end = performance.now();
-                //console.log(`applied ${(this.filterRegex ? "regex" : "text")} filter '${this.filterRegex || this.filterText}' in ${end - start}ms`);
+                filtered.total = total;
+
+                Object.freeze(filtered);
+
+                //const end = performance.now();
+                //console.log(`applied ${(this.useRegex ? "regex" : "text")} filter '${this.filterRegex}' in ${end - start}ms`);
 
                 return filtered;
             },
@@ -636,10 +714,6 @@ smapi.logParser = function (state) {
             this.loadFromUrl();
         },
         methods: {
-            // Mostly I wanted people to know they can override the PerPage
-            // message count with a URL parameter, but we can read Page too.
-            // In the future maybe we should read *all* filter state so a
-            // user can link to their exact page state for someone else?
             loadFromUrl: function () {
                 const params = new URL(location).searchParams;
                 if (params.has("PerPage")) {
@@ -653,6 +727,78 @@ smapi.logParser = function (state) {
                     if (!isNaN(page) && isFinite(page) && page > 0)
                         this.page = page;
                 }
+
+                let updateFilter = false;
+
+                if (params.has("Filter")) {
+                    state.filterText = params.get("Filter");
+                    updateFilter = true;
+                }
+
+                if (params.has("FilterMode")) {
+                    const values = helpers.fromUrlBitmap(params.get("FilterMode"), 3);
+                    state.useRegex = values[0];
+                    state.useInsensitive = values[1];
+                    state.useWord = values[2];
+                    updateFilter = true;
+                }
+
+                if (params.has("Mods")) {
+                    const keys = Object.keys(this.showMods);
+                    const value = params.get("Mods");
+                    const values = value === "all" ? true : value === "none" ? false : helpers.fromUrlBitmap(value, keys.length);
+
+                    for (let i = 0; i < keys.length; i++) {
+                        this.showMods[keys[i]] = Array.isArray(values) ? values[i] : values;
+                    }
+
+                    updateModFilters();
+                }
+
+                if (params.has("Levels")) {
+                    const keys = Object.keys(this.showLevels);
+                    const values = helpers.fromUrlBitmap(params.get("Levels"), keys.length);
+
+                    for (let i = 0; i < keys.length; i++) {
+                        this.showLevels[keys[i]] = values[i];
+                    }
+                }
+
+                if (params.has("Sections")) {
+                    const keys = Object.keys(this.showSections);
+                    const values = helpers.fromUrlBitmap(params.get("Levels"), keys.length);
+
+                    for (let i = 0; i < keys.length; i++) {
+                        this.showSections[keys[i]] = values[i];
+                    }
+                }
+
+                if (updateFilter)
+                    this.updateFilterText();
+            },
+
+            // Whenever the page state changed, replace the current page URL. Using
+            // replaceState rather than pushState to avoid filling the tab history
+            // with tons of useless history steps the user probably doesn't
+            // really care about.
+            updateUrl: function () {
+                const url = new URL(location);
+                url.searchParams.set("Page", state.page);
+                url.searchParams.set("PerPage", state.perPage);
+
+                url.searchParams.set("Mods", stats.modsHidden == 0 ? "all" : stats.modsShown == 0 ? "none" : helpers.toUrlBitmap(Object.values(this.showMods)));
+                url.searchParams.set("Levels", helpers.toUrlBitmap(Object.values(this.showLevels)));
+                url.searchParams.set("Sections", helpers.toUrlBitmap(Object.values(this.showSections)));
+
+                if (state.filterText && state.filterText.length) {
+                    url.searchParams.set("Filter", state.filterText);
+                    url.searchParams.set("FilterMode", helpers.toUrlBitmap([state.useRegex, state.useInsensitive, state.useWord]));
+                } else {
+                    url.searchParams.delete("Filter");
+                    url.searchParams.delete("FilterMode");
+                }
+
+                window.history.replaceState(null, document.title, url.toString());
             },
 
             toggleLevel: function (id) {
@@ -660,6 +806,7 @@ smapi.logParser = function (state) {
                     return;
 
                 this.showLevels[id] = !this.showLevels[id];
+                this.updateUrl();
             },
 
             toggleContentPacks: function () {
@@ -723,25 +870,13 @@ smapi.logParser = function (state) {
                 });
             },
 
-            // Whenever the page is changed, replace the current page URL. Using
-            // replaceState rather than pushState to avoid filling the tab history
-            // with tons of useless history steps the user probably doesn't
-            // really care about.
-            updateUrl: function () {
-                const url = new URL(location);
-                url.searchParams.set("Page", state.page);
-                url.searchParams.set("PerPage", state.perPage);
-
-                window.history.replaceState(null, document.title, url.toString());
-            },
-
             // We don't want to update the filter text often, so use a debounce with
             // a quarter second delay. We basically always build a regular expression
             // since we use it for highlighting, and it also make case insensitivity
             // much easier.
             updateFilterText: helpers.getDebouncedHandler(
                 function () {
-                    let text = this.filterText = document.querySelector("input[type=text]").value;
+                    let text = state.filterText;
                     if (!text || !text.length) {
                         this.filterText = "";
                         this.filterRegex = null;
@@ -754,6 +889,8 @@ smapi.logParser = function (state) {
                             state.useInsensitive ? "ig" : "g"
                         );
                     }
+
+                    this.updateUrl();
                 },
                 250
             ),
@@ -779,6 +916,7 @@ smapi.logParser = function (state) {
                     this.showMods[id] = !this.showMods[id];
 
                 updateModFilters();
+                this.updateUrl();
             },
 
             toggleSection: function (name) {
@@ -786,6 +924,7 @@ smapi.logParser = function (state) {
                     return;
 
                 this.showSections[name] = !this.showSections[name];
+                this.updateUrl();
             },
 
             showAllMods: function () {
@@ -798,6 +937,7 @@ smapi.logParser = function (state) {
                     }
                 }
                 updateModFilters();
+                this.updateUrl();
             },
 
             hideAllMods: function () {
@@ -810,6 +950,7 @@ smapi.logParser = function (state) {
                     }
                 }
                 updateModFilters();
+                this.updateUrl();
             },
 
             filtersAllow: function (modId, level) {

From 94b8507a4763020c578e98ecf5af645fe6583cee Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Mon, 11 Apr 2022 15:01:59 -0400
Subject: [PATCH 535/856] Add more documentation strings. Use shallow equality
 checking to decide whether to include a filter in the URL or not to avoid
 unnecessarily large URLs.

---
 .../wwwroot/Content/js/log-parser.js          | 90 ++++++++++++++++++-
 1 file changed, 86 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 69f0a46d..8538423f 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -139,6 +139,11 @@ smapi.logParser = function (state) {
             return result;
         },
 
+        /**
+         * Convert a base-64 string to a BigInt.
+         * @param {string} value
+         * @returns {BigInt}
+         */
         b64ToBigInt(value) {
             const bin = atob(value);
             const hex = [];
@@ -152,6 +157,11 @@ smapi.logParser = function (state) {
             return BigInt(`0x${hex.join('')}`);
         },
 
+        /**
+         * Convert a BigInt to a base-64 string.
+         * @param {BigInt} value
+         * @returns {string}
+         */
         bigIntTo64(value) {
             let hex = value.toString(16);
             if (hex.length % 2) hex = `0${hex}`;
@@ -165,22 +175,79 @@ smapi.logParser = function (state) {
             return btoa(result.join(''));
         },
 
+        /**
+         * Make a base-64 string URL safe.
+         * @param {string} value
+         * @returns {string}
+         */
         b64ToUrl(value) {
             return value.replace(/\//g, '_').replace(/=/g, '-').replace(/\+/g, '.');
         },
 
+        /**
+         * Convert a URL safe base-64 string back to normal.
+         * @param {string} value
+         * @returns {string}
+         */
         urlTob64(value) {
             return value.replace(/_/g, '/').replace(/-/g, '=').replace(/\./g, '+');
         },
 
+        /**
+         * Convert an array of booleans to a BigInt bitmap, then convert that
+         * to a base-64 string, then make it URL safe.
+         * @param {Boolean[]} value
+         * @returns {string}
+         */
         toUrlBitmap(value) {
             return helpers.b64ToUrl(helpers.bigIntTo64(helpers.toBitmap(value)));
         },
 
+        /**
+         * Convert a URL safe base-64 string to a normal base-64 string, convert
+         * that to a BigInt, and then parse a bitmap from the BigInt.
+         * @param {string} value
+         * @param {Number} length The expected length of the bitmap.
+         */
         fromUrlBitmap(value, length = -1) {
             return helpers.fromBitmap(helpers.b64ToBigInt(helpers.urlTob64(value)), length);
-        }
+        },
 
+        /**
+         * Check the shallow equality of two objects.
+         * @param {Array} first
+         * @param {Array} second
+         * @returns {Boolean}
+         */
+        shallowEquals(first, second) {
+            if (typeof first !== "object" || typeof second !== "object")
+                return first === second;
+
+            if (first == null || second == null)
+                return first == null && second == null;
+
+            const f_array = Array.isArray(first);
+            const s_array = Array.isArray(second);
+
+            if (f_array !== s_array)
+                return false;
+
+            const f_keys = Object.keys(first);
+            const s_keys = Object.keys(second);
+
+            if (f_keys.length != s_keys.length)
+                return false;
+
+            for (const key of f_keys) {
+                if (!s_keys.includes(key))
+                    return false;
+
+                if (first[key] !== second[key])
+                    return false;
+            }
+
+            return true;
+        }
     };
 
     // internal event handlers
@@ -312,6 +379,10 @@ smapi.logParser = function (state) {
     state.perPage = 1000;
     state.page = 1;
 
+    state.defaultMods = JSON.parse(JSON.stringify(state.showMods));
+    state.defaultSections = JSON.parse(JSON.stringify(state.showSections));
+    state.defaultLevels = JSON.parse(JSON.stringify(state.showLevels));
+
     // load saved values, if any
     if (localStorage.settings) {
         try {
@@ -786,9 +857,20 @@ smapi.logParser = function (state) {
                 url.searchParams.set("Page", state.page);
                 url.searchParams.set("PerPage", state.perPage);
 
-                url.searchParams.set("Mods", stats.modsHidden == 0 ? "all" : stats.modsShown == 0 ? "none" : helpers.toUrlBitmap(Object.values(this.showMods)));
-                url.searchParams.set("Levels", helpers.toUrlBitmap(Object.values(this.showLevels)));
-                url.searchParams.set("Sections", helpers.toUrlBitmap(Object.values(this.showSections)));
+                if (!helpers.shallowEquals(this.showMods, state.defaultMods))
+                    url.searchParams.set("Mods", stats.modsHidden == 0 ? "all" : stats.modsShown == 0 ? "none" : helpers.toUrlBitmap(Object.values(this.showMods)));
+                else
+                    url.searchParams.delete("Mods");
+
+                if (!helpers.shallowEquals(this.showLevels, state.defaultLevels))
+                    url.searchParams.set("Levels", helpers.toUrlBitmap(Object.values(this.showLevels)));
+                else
+                    url.searchParams.delete("Levels");
+
+                if (!helpers.shallowEquals(this.showSections, state.defaultSections))
+                    url.searchParams.set("Sections", helpers.toUrlBitmap(Object.values(this.showSections)));
+                else
+                    url.searchParams.delete("Sections");
 
                 if (state.filterText && state.filterText.length) {
                     url.searchParams.set("Filter", state.filterText);

From 1e61309d3dce484d5b646b1a8d15c825beac813f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 11 Apr 2022 22:56:14 -0400
Subject: [PATCH 536/856] add IAssetDataForMap.ExtendMap

---
 docs/release-notes.md                         |  1 +
 .../Framework/Content/AssetDataForMap.cs      | 54 ++++++++++++++++++-
 .../Framework/Content/AssetDataForObject.cs   | 23 ++++++--
 src/SMAPI/Framework/ContentCoordinator.cs     |  3 +-
 .../ContentManagers/BaseContentManager.cs     |  4 ++
 .../ContentManagers/GameContentManager.cs     |  6 +--
 .../Framework/ModHelpers/ContentHelper.cs     | 16 +++++-
 .../Framework/ModHelpers/GameContentHelper.cs | 16 +++++-
 .../Framework/ModHelpers/ModContentHelper.cs  | 16 +++++-
 src/SMAPI/Framework/SCore.cs                  | 14 ++---
 src/SMAPI/IAssetDataForImage.cs               |  4 +-
 src/SMAPI/IAssetDataForMap.cs                 |  7 +++
 12 files changed, 138 insertions(+), 26 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0687b888..7379cba3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -45,6 +45,7 @@ the C# mod that loads them is updated.
     _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
   * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
 * Other improvements:
+  * Added `IAssetDataForImage.ExtendMap` to resize maps in asset editors.
   * Added [command-line arguments](technical/smapi.md#command-line-arguments) to toggle developer mode (thanks to Tondorian!).
   * Added `IContentPack.ModContent` property.
   * Added `Constants.ContentPath`.
diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 0425e195..93148277 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -4,17 +4,27 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using Microsoft.Xna.Framework;
+using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
 using xTile;
+using xTile.Dimensions;
 using xTile.Layers;
 using xTile.Tiles;
+using Rectangle = Microsoft.Xna.Framework.Rectangle;
 
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>Encapsulates access and changes to image content being read from a data file.</summary>
     internal class AssetDataForMap : AssetData<Map>, IAssetDataForMap
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Simplifies access to private code.</summary>
+        private readonly Reflector Reflection;
+
+
         /*********
         ** Public methods
         *********/
@@ -24,8 +34,12 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
-        public AssetDataForMap(string locale, IAssetName assetName, Map data, Func<string, string> getNormalizedPath, Action<Map> onDataReplaced)
-            : base(locale, assetName, data, getNormalizedPath, onDataReplaced) { }
+        /// <param name="reflection">Simplifies access to private code.</param>
+        public AssetDataForMap(string locale, IAssetName assetName, Map data, Func<string, string> getNormalizedPath, Action<Map> onDataReplaced, Reflector reflection)
+            : base(locale, assetName, data, getNormalizedPath, onDataReplaced)
+        {
+            this.Reflection = reflection;
+        }
 
         /// <inheritdoc />
         /// <remarks>Derived from <see cref="GameLocation.ApplyMapOverride(Map,string,Rectangle?,Rectangle?)"/> with a few changes:
@@ -137,6 +151,42 @@ namespace StardewModdingAPI.Framework.Content
             }
         }
 
+        /// <inheritdoc />
+        public bool ExtendMap(Map map, int minWidth, int minHeight)
+        {
+            bool resized = false;
+
+            // resize layers
+            foreach (Layer layer in map.Layers)
+            {
+                // check if resize needed
+                if (layer.LayerWidth >= minWidth && layer.LayerHeight >= minHeight)
+                    continue;
+                resized = true;
+
+                // build new tile matrix
+                int width = Math.Max(minWidth, layer.LayerWidth);
+                int height = Math.Max(minHeight, layer.LayerHeight);
+                Tile[,] tiles = new Tile[width, height];
+                for (int x = 0; x < layer.LayerWidth; x++)
+                {
+                    for (int y = 0; y < layer.LayerHeight; y++)
+                        tiles[x, y] = layer.Tiles[x, y];
+                }
+
+                // update fields
+                this.Reflection.GetField<Tile[,]>(layer, "m_tiles").SetValue(tiles);
+                this.Reflection.GetField<TileArray>(layer, "m_tileArray").SetValue(new TileArray(layer, tiles));
+                this.Reflection.GetField<Size>(layer, "m_layerSize").SetValue(new Size(width, height));
+            }
+
+            // resize map
+            if (resized)
+                this.Reflection.GetMethod(map, "UpdateDisplaySize").Invoke();
+
+            return resized;
+        }
+
 
         /*********
         ** Private methods
diff --git a/src/SMAPI/Framework/Content/AssetDataForObject.cs b/src/SMAPI/Framework/Content/AssetDataForObject.cs
index 4a6df64b..bb3966b9 100644
--- a/src/SMAPI/Framework/Content/AssetDataForObject.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForObject.cs
@@ -3,6 +3,7 @@
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework.Reflection;
 using xTile;
 
 namespace StardewModdingAPI.Framework.Content
@@ -10,6 +11,13 @@ namespace StardewModdingAPI.Framework.Content
     /// <summary>Encapsulates access and changes to content being read from a data file.</summary>
     internal class AssetDataForObject : AssetData<object>, IAssetData
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>Simplifies access to private code.</summary>
+        private readonly Reflector Reflection;
+
+
         /*********
         ** Public methods
         *********/
@@ -18,15 +26,20 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="assetName">The asset name being read.</param>
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
-        public AssetDataForObject(string locale, IAssetName assetName, object data, Func<string, string> getNormalizedPath)
-            : base(locale, assetName, data, getNormalizedPath, onDataReplaced: null) { }
+        /// <param name="reflection">Simplifies access to private code.</param>
+        public AssetDataForObject(string locale, IAssetName assetName, object data, Func<string, string> getNormalizedPath, Reflector reflection)
+            : base(locale, assetName, data, getNormalizedPath, onDataReplaced: null)
+        {
+            this.Reflection = reflection;
+        }
 
         /// <summary>Construct an instance.</summary>
         /// <param name="info">The asset metadata.</param>
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
-        public AssetDataForObject(IAssetInfo info, object data, Func<string, string> getNormalizedPath)
-            : this(info.Locale, info.Name, data, getNormalizedPath) { }
+        /// <param name="reflection">Simplifies access to private code.</param>
+        public AssetDataForObject(IAssetInfo info, object data, Func<string, string> getNormalizedPath, Reflector reflection)
+            : this(info.Locale, info.Name, data, getNormalizedPath, reflection) { }
 
         /// <inheritdoc />
         public IAssetDataForDictionary<TKey, TValue> AsDictionary<TKey, TValue>()
@@ -43,7 +56,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <inheritdoc />
         public IAssetDataForMap AsMap()
         {
-            return new AssetDataForMap(this.Locale, this.Name, this.GetData<Map>(), this.GetNormalizedPath, this.ReplaceWith);
+            return new AssetDataForMap(this.Locale, this.Name, this.GetData<Map>(), this.GetNormalizedPath, this.ReplaceWith, this.Reflection);
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 81820b05..4e48b08c 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -727,7 +727,8 @@ namespace StardewModdingAPI.Framework
                     locale: null,
                     assetName: legacyName,
                     data: asset.Data,
-                    getNormalizedPath: this.MainContentManager.AssertAndNormalizeAssetName
+                    getNormalizedPath: this.MainContentManager.AssertAndNormalizeAssetName,
+                    reflection: this.Reflection
                 );
         }
 
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 4594d235..f1ccab48 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -32,6 +32,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Encapsulates monitoring and logging.</summary>
         protected readonly IMonitor Monitor;
 
+        /// <summary>Simplifies access to private code.</summary>
+        protected readonly Reflector Reflection;
+
         /// <summary>Whether to enable more aggressive memory optimizations.</summary>
         protected readonly bool AggressiveMemoryOptimizations;
 
@@ -90,6 +93,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.Coordinator = coordinator ?? throw new ArgumentNullException(nameof(coordinator));
             this.Cache = new ContentCache(this, reflection);
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
+            this.Reflection = reflection;
             this.OnDisposing = onDisposing;
             this.IsNamespaced = isNamespaced;
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index f4e1bda4..e494559d 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -124,7 +124,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     IAssetInfo info = new AssetInfo(assetName.LocaleCode, assetName, typeof(T), this.AssertAndNormalizeAssetName);
                     IAssetData asset =
                         this.ApplyLoader<T>(info)
-                        ?? new AssetDataForObject(info, this.RawLoad<T>(assetName, useCache), this.AssertAndNormalizeAssetName);
+                        ?? new AssetDataForObject(info, this.RawLoad<T>(assetName, useCache), this.AssertAndNormalizeAssetName, this.Reflection);
                     asset = this.ApplyEditors<T>(info, asset);
                     return (T)asset.Data;
                 });
@@ -187,7 +187,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // return matched asset
             return this.TryFixAndValidateLoadedAsset(info, data, loader)
-                ? new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName)
+                ? new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName, this.Reflection)
                 : null;
         }
 
@@ -197,7 +197,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="asset">The loaded asset.</param>
         private IAssetData ApplyEditors<T>(IAssetInfo info, IAssetData asset)
         {
-            IAssetData GetNewData(object data) => new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName);
+            IAssetData GetNewData(object data) => new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName, this.Reflection);
 
             // special case: if the asset was loaded with a more general type like 'object', call editors with the actual type instead.
             {
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index e72e397e..12ef0439 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -10,6 +10,7 @@ using System.Linq;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Exceptions;
+using StardewModdingAPI.Framework.Reflection;
 using StardewValley;
 
 namespace StardewModdingAPI.Framework.ModHelpers
@@ -36,6 +37,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Encapsulates monitoring and logging.</summary>
         private readonly IMonitor Monitor;
 
+        /// <summary>Simplifies access to private code.</summary>
+        private readonly Reflector Reflection;
+
 
         /*********
         ** Accessors
@@ -94,7 +98,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="modID">The unique ID of the relevant mod.</param>
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
-        public ContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IMonitor monitor)
+        /// <param name="reflection">Simplifies access to private code.</param>
+        public ContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IMonitor monitor, Reflector reflection)
             : base(modID)
         {
             string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
@@ -104,6 +109,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, modName, modFolderPath, this.GameContentManager);
             this.ModName = modName;
             this.Monitor = monitor;
+            this.Reflection = reflection;
         }
 
         /// <inheritdoc />
@@ -185,7 +191,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             assetName ??= $"temp/{Guid.NewGuid():N}";
 
-            return new AssetDataForObject(this.CurrentLocale, this.ContentCore.ParseAssetName(assetName, allowLocales: true/* no way to know if it's a game or mod asset here*/), data, this.NormalizeAssetName);
+            return new AssetDataForObject(
+                locale: this.CurrentLocale,
+                assetName: this.ContentCore.ParseAssetName(assetName, allowLocales: true/* no way to know if it's a game or mod asset here*/),
+                data: data,
+                getNormalizedPath: this.NormalizeAssetName,
+                reflection: this.Reflection
+            );
         }
 
 
diff --git a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
index 956bac7f..6d0c2f5f 100644
--- a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Exceptions;
+using StardewModdingAPI.Framework.Reflection;
 using StardewValley;
 
 namespace StardewModdingAPI.Framework.ModHelpers
@@ -27,6 +28,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Encapsulates monitoring and logging.</summary>
         private readonly IMonitor Monitor;
 
+        /// <summary>Simplifies access to private code.</summary>
+        private readonly Reflector Reflection;
+
 
         /*********
         ** Accessors
@@ -46,7 +50,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="modID">The unique ID of the relevant mod.</param>
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
-        public GameContentHelper(ContentCoordinator contentCore, string modID, string modName, IMonitor monitor)
+        /// <param name="reflection">Simplifies access to private code.</param>
+        public GameContentHelper(ContentCoordinator contentCore, string modID, string modName, IMonitor monitor, Reflector reflection)
             : base(modID)
         {
             string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
@@ -55,6 +60,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.GameContentManager = contentCore.CreateGameContentManager(managedAssetPrefix + ".content");
             this.ModName = modName;
             this.Monitor = monitor;
+            this.Reflection = reflection;
         }
 
         /// <inheritdoc />
@@ -119,7 +125,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             assetName ??= $"temp/{Guid.NewGuid():N}";
 
-            return new AssetDataForObject(this.CurrentLocale, this.ContentCore.ParseAssetName(assetName, allowLocales: true), data, key => this.ParseAssetName(key).Name);
+            return new AssetDataForObject(
+                locale: this.CurrentLocale,
+                assetName: this.ContentCore.ParseAssetName(assetName, allowLocales: true),
+                data: data,
+                getNormalizedPath: key => this.ParseAssetName(key).Name,
+                reflection: this.Reflection
+            );
         }
 
         /// <summary>Get the underlying game content manager.</summary>
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index 90064354..b149ed82 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -5,6 +5,7 @@ using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Exceptions;
+using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Utilities;
 
 namespace StardewModdingAPI.Framework.ModHelpers
@@ -27,6 +28,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>A case-insensitive lookup of relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
         private readonly CaseInsensitivePathCache RelativePathCache;
 
+        /// <summary>Simplifies access to private code.</summary>
+        private readonly Reflector Reflection;
+
 
         /*********
         ** Public methods
@@ -38,7 +42,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="gameContentManager">The game content manager used for map tilesheets not provided by the mod.</param>
         /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="relativePathCache"/>.</param>
-        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IContentManager gameContentManager, CaseInsensitivePathCache relativePathCache)
+        /// <param name="reflection">Simplifies access to private code.</param>
+        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IContentManager gameContentManager, CaseInsensitivePathCache relativePathCache, Reflector reflection)
             : base(modID)
         {
             string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
@@ -47,6 +52,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, modName, modFolderPath, gameContentManager);
             this.ModName = modName;
             this.RelativePathCache = relativePathCache;
+            this.Reflection = reflection;
         }
 
         /// <inheritdoc />
@@ -83,7 +89,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 ? this.RelativePathCache.GetAssetName(relativePath)
                 : $"temp/{Guid.NewGuid():N}";
 
-            return new AssetDataForObject(this.ContentCore.GetLocale(), this.ContentCore.ParseAssetName(relativePath, allowLocales: false), data, key => this.ContentCore.ParseAssetName(key, allowLocales: false).Name);
+            return new AssetDataForObject(
+                locale: this.ContentCore.GetLocale(),
+                assetName: this.ContentCore.ParseAssetName(relativePath, allowLocales: false),
+                data: data,
+                getNormalizedPath: key => this.ContentCore.ParseAssetName(key, allowLocales: false).Name,
+                reflection: this.Reflection
+            );
         }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 1a58d84b..364a7632 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1754,8 +1754,8 @@ namespace StardewModdingAPI.Framework
                 IManifest manifest = mod.Manifest;
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
                 CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
-                GameContentHelper gameContentHelper = new(this.ContentCore, manifest.UniqueID, mod.DisplayName, monitor);
-                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache);
+                GameContentHelper gameContentHelper = new(this.ContentCore, manifest.UniqueID, mod.DisplayName, monitor, this.Reflection);
+                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
                 TranslationHelper translationHelper = new(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
                 IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, modContentHelper, translationHelper, jsonHelper, relativePathCache);
                 mod.SetMod(contentPack, monitor, translationHelper);
@@ -1838,8 +1838,8 @@ namespace StardewModdingAPI.Framework
 
                             CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(packDirPath);
 
-                            GameContentHelper gameContentHelper = new(contentCore, packManifest.UniqueID, packManifest.Name, packMonitor);
-                            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache);
+                            GameContentHelper gameContentHelper = new(contentCore, packManifest.UniqueID, packManifest.Name, packMonitor, this.Reflection);
+                            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
                             TranslationHelper packTranslationHelper = new(packManifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
 
                             ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, relativePathCache);
@@ -1852,10 +1852,10 @@ namespace StardewModdingAPI.Framework
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
                         CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
 #pragma warning disable CS0612 // deprecated code
-                        ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor);
+                        ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor, this.Reflection);
 #pragma warning restore CS0612
-                        GameContentHelper gameContentHelper = new(contentCore, manifest.UniqueID, mod.DisplayName, monitor);
-                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache);
+                        GameContentHelper gameContentHelper = new(contentCore, manifest.UniqueID, mod.DisplayName, monitor, this.Reflection);
+                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
                         IContentPackHelper contentPackHelper = new ContentPackHelper(manifest.UniqueID, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
                         IDataHelper dataHelper = new DataHelper(manifest.UniqueID, mod.DirectoryPath, jsonHelper);
                         IReflectionHelper reflectionHelper = new ReflectionHelper(manifest.UniqueID, mod.DisplayName, this.Reflection);
diff --git a/src/SMAPI/IAssetDataForImage.cs b/src/SMAPI/IAssetDataForImage.cs
index 388caa68..1416592e 100644
--- a/src/SMAPI/IAssetDataForImage.cs
+++ b/src/SMAPI/IAssetDataForImage.cs
@@ -23,8 +23,8 @@ namespace StardewModdingAPI
         void PatchImage(Texture2D source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace);
 
         /// <summary>Extend the image if needed to fit the given size. Note that this is an expensive operation, creates a new texture instance, and that extending a spritesheet horizontally may cause game errors or bugs.</summary>
-        /// <param name="minWidth">The minimum texture width.</param>
-        /// <param name="minHeight">The minimum texture height.</param>
+        /// <param name="minWidth">The minimum texture width in pixels.</param>
+        /// <param name="minHeight">The minimum texture height in pixels.</param>
         /// <returns>Whether the texture was resized.</returns>
         bool ExtendImage(int minWidth, int minHeight);
     }
diff --git a/src/SMAPI/IAssetDataForMap.cs b/src/SMAPI/IAssetDataForMap.cs
index 89ee28f2..0b637baf 100644
--- a/src/SMAPI/IAssetDataForMap.cs
+++ b/src/SMAPI/IAssetDataForMap.cs
@@ -17,5 +17,12 @@ namespace StardewModdingAPI
         /// <param name="targetArea">The tile area within the target map to overwrite, or <c>null</c> to patch the whole map. The original content within this area will be erased. This must be within the bounds of the existing map.</param>
         /// <param name="patchMode">Indicates how the map should be patched.</param>
         void PatchMap(Map source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMapMode patchMode = PatchMapMode.Overlay);
+
+        /// <summary>Extend the map if needed to fit the given size. Note that this is an expensive operation and resizes the map in-place.</summary>
+        /// <param name="map">The map to resize.</param>
+        /// <param name="minWidth">The minimum map width in tiles.</param>
+        /// <param name="minHeight">The minimum map height in tiles.</param>
+        /// <returns>Whether the map was resized.</returns>
+        bool ExtendMap(Map map, int minWidth, int minHeight);
     }
 }

From a21d24f4b7d14701205a6805422de31da84da6ca Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Tue, 12 Apr 2022 02:07:21 -0400
Subject: [PATCH 537/856] Replace bitfields for state and just use
 comma-separated strings. Add a note that numbers may be inaccurate if
 filtering is used when sections are collapsed. Add quick navigation links.

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  13 +
 src/SMAPI.Web/wwwroot/Content/css/main.css    |  32 +++
 .../wwwroot/Content/js/log-parser.js          | 235 ++++++------------
 3 files changed, 124 insertions(+), 156 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 7aa0fd6b..d95499b7 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -94,6 +94,19 @@
     </script>
 }
 
+@* quick navigation links *@
+@if (log != null)
+{
+    <aside id="quickNav">
+        <h4>Scroll To...</h4>
+        <ul>
+            <li><a href="#content">Top</a></li>
+            <li><a href="#filterHolder">Log Start</a></li>
+            <li><a href="#footer">Bottom</a></li>
+        </ul>
+    </aside>
+}
+
 @* upload result banner *@
 @if (Model.UploadError != null)
 {
diff --git a/src/SMAPI.Web/wwwroot/Content/css/main.css b/src/SMAPI.Web/wwwroot/Content/css/main.css
index dcc7a798..52b304d0 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/main.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/main.css
@@ -72,6 +72,7 @@ a {
     color: #666;
 }
 
+#quickNav h4,
 #sidebar h4 {
     margin: 1.5em 0 0.2em 0;
     width: 10em;
@@ -80,11 +81,13 @@ a {
     font-weight: normal;
 }
 
+#quickNav a,
 #sidebar a {
     color: #77B;
     border: 0;
 }
 
+#quickNav ul, #quickNav li,
 #sidebar ul, #sidebar li {
     margin: 0;
     padding: 0;
@@ -93,10 +96,29 @@ a {
     color: #888;
 }
 
+#quickNav li,
 #sidebar li {
     margin-left: 1em;
 }
 
+/* quick navigation */
+
+#quickNav {
+    position: fixed;
+    left: 8px;
+    bottom: 3em;
+    width: 12em;
+    color: #666;
+}
+
+@media (max-height: 400px) {
+    #quickNav {
+        position: unset;
+        width: auto;
+    }
+}
+
+
 /* footer */
 #footer {
     margin: 1em;
@@ -111,11 +133,16 @@ a {
 
 /* mobile fixes */
 @media (min-width: 1020px) and (max-width: 1199px) {
+    #quickNav,
     #sidebar {
         width: 7em;
         background: none;
     }
 
+    #quickNav h4 {
+        width: unset;
+    }
+
     #content-column {
         left: 7em;
     }
@@ -138,4 +165,9 @@ a {
         top: inherit;
         left: inherit;
     }
+
+    #quickNav {
+        position: unset;
+        width: auto;
+    }
 }
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 8538423f..37c57082 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -97,120 +97,23 @@ smapi.logParser = function (state) {
         },
 
         /**
-         * Convert an array of boolean values into a bitmap.
-         * @param {Boolean[]} value An array of boolean values
-         * @returns {BigInt}
+         * Try parsing the value as an integer, in base 10. Return the number
+         * if it's valid, or return the default value otherwise.
+         * @param {String} value The value to parse.
+         * @param {Number} defaultValue The value to return if parsing fails.
+         * @param {Function} critera An optional criteria to check the number with.
          */
-        toBitmap(value) {
-            let result = BigInt(0);
-            if (!Array.isArray(value))
-                return value ? BigInt(1) : BigInt(0);
-
-            for (let i = 0; i < value.length; i++) {
-                if (value[i])
-                    result += BigInt(2) ** BigInt(value.length - i - 1);
+        tryNumber(value, defaultValue, critera = null) {
+            try {
+                value = parseInt(value, 10);
+            } catch {
+                return defaultValue;
             }
 
-            return result;
-        },
+            if (isNaN(value) || !isFinite(value) || (critera && !critera(value)))
+                return defaultValue;
 
-        /**
-         * Convert a bitmap into an array of boolean values.
-         * @param {BigInt} value The bitmap
-         * @param {Number} length The expected length of the result
-         * @returns {Boolean[]}
-         */
-        fromBitmap(value, length = -1) {
-            if (typeof value != "bigint")
-                value = "";
-            else
-                value = value.toString(2);
-
-            const result = [];
-            while (length > value.length) {
-                result.push(false);
-                length--;
-            }
-
-            for (let i = 0; i < value.length; i++) {
-                result.push(value[i] === "1" ? true : false);
-            }
-
-            return result;
-        },
-
-        /**
-         * Convert a base-64 string to a BigInt.
-         * @param {string} value
-         * @returns {BigInt}
-         */
-        b64ToBigInt(value) {
-            const bin = atob(value);
-            const hex = [];
-
-            for (let i = 0; i < bin.length; i++) {
-                let h = bin.charCodeAt(i).toString(16);
-                if (h.length % 2) h = `0${h}`;
-                hex.push(h);
-            }
-
-            return BigInt(`0x${hex.join('')}`);
-        },
-
-        /**
-         * Convert a BigInt to a base-64 string.
-         * @param {BigInt} value
-         * @returns {string}
-         */
-        bigIntTo64(value) {
-            let hex = value.toString(16);
-            if (hex.length % 2) hex = `0${hex}`;
-
-            const result = [];
-            for (let i = 0; i < hex.length; i += 2) {
-                const val = parseInt(hex.slice(i, i + 2), 16);
-                result.push(String.fromCharCode(val));
-            }
-
-            return btoa(result.join(''));
-        },
-
-        /**
-         * Make a base-64 string URL safe.
-         * @param {string} value
-         * @returns {string}
-         */
-        b64ToUrl(value) {
-            return value.replace(/\//g, '_').replace(/=/g, '-').replace(/\+/g, '.');
-        },
-
-        /**
-         * Convert a URL safe base-64 string back to normal.
-         * @param {string} value
-         * @returns {string}
-         */
-        urlTob64(value) {
-            return value.replace(/_/g, '/').replace(/-/g, '=').replace(/\./g, '+');
-        },
-
-        /**
-         * Convert an array of booleans to a BigInt bitmap, then convert that
-         * to a base-64 string, then make it URL safe.
-         * @param {Boolean[]} value
-         * @returns {string}
-         */
-        toUrlBitmap(value) {
-            return helpers.b64ToUrl(helpers.bigIntTo64(helpers.toBitmap(value)));
-        },
-
-        /**
-         * Convert a URL safe base-64 string to a normal base-64 string, convert
-         * that to a BigInt, and then parse a bitmap from the BigInt.
-         * @param {string} value
-         * @param {Number} length The expected length of the bitmap.
-         */
-        fromUrlBitmap(value, length = -1) {
-            return helpers.fromBitmap(helpers.b64ToBigInt(helpers.urlTob64(value)), length);
+            return value;
         },
 
         /**
@@ -433,12 +336,18 @@ smapi.logParser = function (state) {
                 "div",
                 { class: "stats" },
                 [
-                    "showing ",
-                    createElement("strong", helpers.formatNumber(props.start + 1)),
-                    " to ",
-                    createElement("strong", helpers.formatNumber(props.end)),
-                    " of ",
-                    createElement("strong", helpers.formatNumber(props.filtered)),
+                    createElement('abbr', {
+                        attrs: {
+                            title: "These numbers may be inaccurate when using filtering with sections collapsed."
+                        }
+                    }, [
+                        "showing ",
+                        createElement("strong", helpers.formatNumber(props.start + 1)),
+                        " to ",
+                        createElement("strong", helpers.formatNumber(props.end)),
+                        " of ",
+                        createElement("strong", helpers.formatNumber(props.filtered))
+                    ]),
                     " (total: ",
                     createElement("strong", helpers.formatNumber(props.total)),
                     ")"
@@ -788,64 +697,66 @@ smapi.logParser = function (state) {
             loadFromUrl: function () {
                 const params = new URL(location).searchParams;
                 if (params.has("PerPage")) {
-                    const perPage = parseInt(params.get("PerPage"));
-                    if (!isNaN(perPage) && isFinite(perPage) && perPage > 0)
-                        state.perPage = perPage;
+                    state.perPage = helpers.tryNumber(params.get("PerPage"), 1000, n => n > 0);
+                } else {
+                    state.perPage = 1000;
                 }
 
                 if (params.has("Page")) {
-                    const page = parseInt(params.get("Page"));
-                    if (!isNaN(page) && isFinite(page) && page > 0)
-                        this.page = page;
+                    this.page = helpers.tryNumber(params.get("Page"), 1, n => n > 0);
+                } else {
+                    this.page = 1;
                 }
 
-                let updateFilter = false;
-
-                if (params.has("Filter")) {
+                if (params.has("Filter"))
                     state.filterText = params.get("Filter");
-                    updateFilter = true;
-                }
+                else
+                    state.filterText = "";
 
                 if (params.has("FilterMode")) {
-                    const values = helpers.fromUrlBitmap(params.get("FilterMode"), 3);
-                    state.useRegex = values[0];
-                    state.useInsensitive = values[1];
-                    state.useWord = values[2];
-                    updateFilter = true;
+                    const values = params.get("FilterMode").split("~");
+                    state.useRegex = values.includes('Regex');
+                    state.useInsensitive = !values.includes('Sensitive');
+                    state.useWord = values.includes('Word');
+                } else {
+                    state.useRegex = false;
+                    state.useInsensitive = true;
+                    state.useWord = false;
                 }
 
                 if (params.has("Mods")) {
-                    const keys = Object.keys(this.showMods);
-                    const value = params.get("Mods");
-                    const values = value === "all" ? true : value === "none" ? false : helpers.fromUrlBitmap(value, keys.length);
+                    const value = params.get("Mods").split("~");
+                    for (const key of Object.keys(this.showMods))
+                        this.showMods[key] = value.includes(key);
 
-                    for (let i = 0; i < keys.length; i++) {
-                        this.showMods[keys[i]] = Array.isArray(values) ? values[i] : values;
-                    }
-
-                    updateModFilters();
+                } else {
+                    for (const key of Object.keys(this.showMods))
+                        this.showMods[key] = state.defaultMods[key];
                 }
 
                 if (params.has("Levels")) {
-                    const keys = Object.keys(this.showLevels);
-                    const values = helpers.fromUrlBitmap(params.get("Levels"), keys.length);
+                    const values = params.get("Levels").split("~");
+                    for (const key of Object.keys(this.showLevels))
+                        this.showLevels[key] = values.includes(key);
 
-                    for (let i = 0; i < keys.length; i++) {
-                        this.showLevels[keys[i]] = values[i];
-                    }
+                } else {
+                    const keys = Object.keys(this.showLevels);
+                    for (const key of Object.keys(this.showLevels))
+                        this.showLevels[key] = state.defaultLevels[key];
                 }
 
                 if (params.has("Sections")) {
-                    const keys = Object.keys(this.showSections);
-                    const values = helpers.fromUrlBitmap(params.get("Levels"), keys.length);
+                    const values = params.get("Sections").split("~");
+                    for (const key of Object.keys(this.showSections))
+                        this.showSections[key] = values.includes(key);
 
-                    for (let i = 0; i < keys.length; i++) {
-                        this.showSections[keys[i]] = values[i];
-                    }
+                } else {
+                    for (const key of Object.keys(this.showSections))
+                        this.showSections[key] = state.defaultSections[key];
                 }
 
-                if (updateFilter)
-                    this.updateFilterText();
+                updateModFilters();
+                this.updateFilterText();
             },
 
             // Whenever the page state changed, replace the current page URL. Using
@@ -858,23 +769,35 @@ smapi.logParser = function (state) {
                 url.searchParams.set("PerPage", state.perPage);
 
                 if (!helpers.shallowEquals(this.showMods, state.defaultMods))
-                    url.searchParams.set("Mods", stats.modsHidden == 0 ? "all" : stats.modsShown == 0 ? "none" : helpers.toUrlBitmap(Object.values(this.showMods)));
+                    url.searchParams.set("Mods", Object.entries(this.showMods).filter(x => x[1]).map(x => x[0]).join("~"));
                 else
                     url.searchParams.delete("Mods");
 
                 if (!helpers.shallowEquals(this.showLevels, state.defaultLevels))
-                    url.searchParams.set("Levels", helpers.toUrlBitmap(Object.values(this.showLevels)));
+                    url.searchParams.set("Levels", Object.entries(this.showLevels).filter(x => x[1]).map(x => x[0]).join("~"));
                 else
                     url.searchParams.delete("Levels");
 
                 if (!helpers.shallowEquals(this.showSections, state.defaultSections))
-                    url.searchParams.set("Sections", helpers.toUrlBitmap(Object.values(this.showSections)));
+                    url.searchParams.set("Sections", Object.entries(this.showSections).filter(x => x[1]).map(x => x[0]).join("~"));
                 else
                     url.searchParams.delete("Sections");
 
                 if (state.filterText && state.filterText.length) {
                     url.searchParams.set("Filter", state.filterText);
-                    url.searchParams.set("FilterMode", helpers.toUrlBitmap([state.useRegex, state.useInsensitive, state.useWord]));
+                    const modes = [];
+                    if (state.useRegex)
+                        modes.push("Regex");
+                    if (!state.useInsensitive)
+                        modes.push("Sensitive");
+                    if (state.useWord)
+                        modes.push("Word");
+
+                    if (modes.length)
+                        url.searchParams.set("FilterMode", modes.join("~"));
+                    else
+                        url.searchParams.delete("FilterMode");
+
                 } else {
                     url.searchParams.delete("Filter");
                     url.searchParams.delete("FilterMode");

From 0b9227564979b3e6e71dbd48ced2a9b7407fd640 Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Tue, 12 Apr 2022 02:18:51 -0400
Subject: [PATCH 538/856] Make horizontal scrolling with the quick navigation
 links less bad. Probably need to move them into the actual sidebar element
 though for proper sorting.

---
 src/SMAPI.Web/wwwroot/Content/css/log-parser.css | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
index 41b54e11..e47a938d 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
@@ -13,6 +13,9 @@ caption {
 #output {
     padding: 10px;
     overflow: auto;
+    z-index: 1;
+    background: #fff;
+    position: relative;
 }
 
 #output h2 {

From 4f54f517ce3d6fd6e87cfee6b0ce61346d62c3e3 Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Tue, 12 Apr 2022 13:50:51 -0400
Subject: [PATCH 539/856] Use an optional section for rendering quick
 navigation links on the mod viewer, containing them within the #sidebar
 element.

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 22 ++++++++++---------
 src/SMAPI.Web/Views/Shared/_Layout.cshtml     |  2 ++
 .../wwwroot/Content/css/log-parser.css        |  3 ---
 src/SMAPI.Web/wwwroot/Content/css/main.css    |  6 -----
 4 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index d95499b7..d55bfd4d 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -95,16 +95,18 @@
 }
 
 @* quick navigation links *@
-@if (log != null)
-{
-    <aside id="quickNav">
-        <h4>Scroll To...</h4>
-        <ul>
-            <li><a href="#content">Top</a></li>
-            <li><a href="#filterHolder">Log Start</a></li>
-            <li><a href="#footer">Bottom</a></li>
-        </ul>
-    </aside>
+@section SidebarExtra {
+    @if (log != null)
+    {
+        <aside id="quickNav">
+            <h4>Scroll To...</h4>
+            <ul>
+                <li><a href="#content">Top</a></li>
+                <li><a href="#filterHolder">Log Start</a></li>
+                <li><a href="#footer">Bottom</a></li>
+            </ul>
+        </aside>
+    }
 }
 
 @* upload result banner *@
diff --git a/src/SMAPI.Web/Views/Shared/_Layout.cshtml b/src/SMAPI.Web/Views/Shared/_Layout.cshtml
index 7c86a68c..248cc7ef 100644
--- a/src/SMAPI.Web/Views/Shared/_Layout.cshtml
+++ b/src/SMAPI.Web/Views/Shared/_Layout.cshtml
@@ -30,6 +30,8 @@
             <li><a href="@Url.PlainAction("Index", "LogParser", values: null)">Log parser</a></li>
             <li><a href="@Url.PlainAction("Index", "JsonValidator", values: null)">JSON validator</a></li>
         </ul>
+
+        @RenderSection("SidebarExtra", required: false)
     </div>
     <div id="content-column">
         <div id="content">
diff --git a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
index e47a938d..41b54e11 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
@@ -13,9 +13,6 @@ caption {
 #output {
     padding: 10px;
     overflow: auto;
-    z-index: 1;
-    background: #fff;
-    position: relative;
 }
 
 #output h2 {
diff --git a/src/SMAPI.Web/wwwroot/Content/css/main.css b/src/SMAPI.Web/wwwroot/Content/css/main.css
index 52b304d0..a0a407d8 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/main.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/main.css
@@ -72,7 +72,6 @@ a {
     color: #666;
 }
 
-#quickNav h4,
 #sidebar h4 {
     margin: 1.5em 0 0.2em 0;
     width: 10em;
@@ -81,13 +80,11 @@ a {
     font-weight: normal;
 }
 
-#quickNav a,
 #sidebar a {
     color: #77B;
     border: 0;
 }
 
-#quickNav ul, #quickNav li,
 #sidebar ul, #sidebar li {
     margin: 0;
     padding: 0;
@@ -96,7 +93,6 @@ a {
     color: #888;
 }
 
-#quickNav li,
 #sidebar li {
     margin-left: 1em;
 }
@@ -105,10 +101,8 @@ a {
 
 #quickNav {
     position: fixed;
-    left: 8px;
     bottom: 3em;
     width: 12em;
-    color: #666;
 }
 
 @media (max-height: 400px) {

From 0b48c1748b354458059c7607415288de072b01e9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 12 Apr 2022 19:15:39 -0400
Subject: [PATCH 540/856] enable nullable annotations in the web project &
 related code (#837)

---
 build/common.targets                          |   4 +-
 .../ISemanticVersion.cs                       |   4 +
 .../Framework/Clients/WebApi/ModEntryModel.cs |  19 ++-
 .../Clients/WebApi/ModEntryVersionModel.cs    |   9 +-
 .../WebApi/ModExtendedMetadataModel.cs        |  36 ++--
 .../Clients/WebApi/ModSearchEntryModel.cs     |  27 +--
 .../Clients/WebApi/ModSearchModel.cs          |  10 +-
 .../Framework/Clients/WebApi/WebApiClient.cs  |   5 +-
 .../Clients/Wiki/ChangeDescriptor.cs          |  12 +-
 .../Framework/Clients/Wiki/WikiClient.cs      | 159 ++++++++++--------
 .../Clients/Wiki/WikiCompatibilityInfo.cs     |  33 +++-
 .../Clients/Wiki/WikiCompatibilityStatus.cs   |   2 -
 .../Framework/Clients/Wiki/WikiModEntry.cs    |  96 ++++++++---
 .../Framework/Clients/Wiki/WikiModList.cs     |  23 ++-
 src/SMAPI.Toolkit/SemanticVersion.cs          |   3 +
 src/SMAPI.Toolkit/SemanticVersionComparer.cs  |   2 +-
 src/SMAPI.Web/BackgroundService.cs            |  24 ++-
 src/SMAPI.Web/Controllers/IndexController.cs  |  12 +-
 .../Controllers/JsonValidatorController.cs    |  46 +++--
 .../Controllers/LogParserController.cs        |   6 +-
 .../Controllers/ModsApiController.cs          |  70 ++++----
 src/SMAPI.Web/Controllers/ModsController.cs   |   7 +-
 .../Framework/AllowLargePostsAttribute.cs     |   4 +-
 src/SMAPI.Web/Framework/Caching/Cached.cs     |  11 +-
 .../Caching/Mods/IModCacheRepository.cs       |   5 +-
 .../Caching/Mods/ModCacheMemoryRepository.cs  |   5 +-
 .../Caching/Wiki/IWikiCacheRepository.cs      |   9 +-
 .../Caching/Wiki/WikiCacheMemoryRepository.cs |  11 +-
 .../Framework/Caching/Wiki/WikiMetadata.cs    |  11 +-
 .../Clients/Chucklefish/ChucklefishClient.cs  |  12 +-
 .../Clients/CurseForge/CurseForgeClient.cs    |  14 +-
 .../CurseForge/ResponseModels/ModFileModel.cs |  22 ++-
 .../CurseForge/ResponseModels/ModModel.cs     |  30 +++-
 .../Framework/Clients/GenericModDownload.cs   |  13 +-
 .../Framework/Clients/GenericModPage.cs       |  23 +--
 .../Framework/Clients/GitHub/GitAsset.cs      |  26 ++-
 .../Framework/Clients/GitHub/GitHubClient.cs  |  30 ++--
 .../Framework/Clients/GitHub/GitLicense.cs    |  26 ++-
 .../Framework/Clients/GitHub/GitRelease.cs    |  36 +++-
 .../Framework/Clients/GitHub/GitRepo.cs       |  26 ++-
 .../Framework/Clients/GitHub/IGitHubClient.cs |   6 +-
 .../Framework/Clients/IModSiteClient.cs       |   4 +-
 .../Clients/ModDrop/ModDropClient.cs          |  20 ++-
 .../ModDrop/ResponseModels/FileDataModel.cs   |  42 ++++-
 .../ModDrop/ResponseModels/ModDataModel.cs    |  24 ++-
 .../ModDrop/ResponseModels/ModListModel.cs    |   7 +-
 .../ModDrop/ResponseModels/ModModel.cs        |  22 ++-
 .../Framework/Clients/Nexus/NexusClient.cs    |  63 ++++---
 .../Clients/Nexus/ResponseModels/NexusMod.cs  |  43 ++++-
 .../Clients/Pastebin/IPastebinClient.cs       |   2 -
 .../Framework/Clients/Pastebin/PasteInfo.cs   |  28 ++-
 .../Clients/Pastebin/PastebinClient.cs        |  14 +-
 .../Framework/Compression/GzipHelper.cs       |   9 +-
 .../Framework/Compression/IGzipHelper.cs      |   5 +-
 .../ConfigModels/ApiClientsConfig.cs          |  36 ++--
 .../ConfigModels/ModOverrideConfig.cs         |   6 +-
 .../ConfigModels/ModUpdateCheckConfig.cs      |  10 +-
 .../Framework/ConfigModels/SiteConfig.cs      |   6 +-
 .../Framework/ConfigModels/SmapiInfoConfig.cs |   8 +-
 src/SMAPI.Web/Framework/Extensions.cs         |   8 +-
 src/SMAPI.Web/Framework/IModDownload.cs       |   9 +-
 src/SMAPI.Web/Framework/IModPage.cs           |  18 +-
 .../InternalControllerFeatureProvider.cs      |   2 -
 .../JobDashboardAuthorizationFilter.cs        |   2 -
 src/SMAPI.Web/Framework/ModInfoModel.cs       |  37 ++--
 src/SMAPI.Web/Framework/ModSiteManager.cs     |  58 ++++---
 .../RedirectRules/RedirectHostsToUrlsRule.cs  |  10 +-
 .../RedirectRules/RedirectMatchRule.cs        |   6 +-
 .../RedirectRules/RedirectPathsToUrlsRule.cs  |   6 +-
 .../RedirectRules/RedirectToHttpsRule.cs      |   6 +-
 .../Framework/Storage/IStorageProvider.cs     |   2 -
 .../Framework/Storage/StorageProvider.cs      |  52 ++----
 .../Framework/Storage/StoredFileInfo.cs       |  41 ++++-
 .../Framework/Storage/UploadResult.cs         |  14 +-
 src/SMAPI.Web/Framework/VersionConstraint.cs  |   6 +-
 src/SMAPI.Web/Program.cs                      |   2 -
 src/SMAPI.Web/Startup.cs                      |   4 +-
 src/SMAPI.Web/ViewModels/IndexModel.cs        |  13 +-
 src/SMAPI.Web/ViewModels/IndexVersionModel.cs |  15 +-
 .../JsonValidator/JsonValidatorErrorModel.cs  |  15 +-
 .../JsonValidator/JsonValidatorModel.cs       |  29 ++--
 .../JsonValidatorRequestModel.cs              |  19 ++-
 src/SMAPI.Web/ViewModels/LogParserModel.cs    |   2 +-
 .../ViewModels/ModCompatibilityModel.cs       |  27 ++-
 src/SMAPI.Web/ViewModels/ModLinkModel.cs      |   6 +-
 src/SMAPI.Web/ViewModels/ModListModel.cs      |  19 +--
 src/SMAPI.Web/ViewModels/ModModel.cs          |  65 +++++--
 src/SMAPI.Web/Views/Index/Index.cshtml        |   6 +-
 src/SMAPI.Web/Views/Index/Privacy.cshtml      |   4 -
 .../Views/JsonValidator/Index.cshtml          |  12 +-
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |   2 +-
 src/SMAPI.Web/Views/Mods/Index.cshtml         |   6 +-
 src/SMAPI.Web/Views/Shared/_Layout.cshtml     |   4 -
 src/SMAPI.Web/Views/_ViewStart.cshtml         |   4 -
 src/SMAPI.Web/appsettings.json                |   3 +-
 src/SMAPI.sln.DotSettings                     |   1 +
 src/SMAPI/SemanticVersion.cs                  |   3 +
 97 files changed, 1046 insertions(+), 770 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index c227190a..c04546d0 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,8 +7,8 @@
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
 
     <!--enable nullable annotations, except in .NET Standard 2.0 where they aren't supported-->
-    <Nullable Condition="'$(TargetFramework)' == 'net5.0'">enable</Nullable>
-    <NoWarn Condition="'$(TargetFramework)' != 'net5.0'">$(NoWarn);CS8632</NoWarn>
+    <Nullable Condition="'$(TargetFramework)' != 'netstandard2.0'">enable</Nullable>
+    <NoWarn Condition="'$(TargetFramework)' == 'netstandard2.0'">$(NoWarn);CS8632</NoWarn>
 
     <!--set platform-->
     <DefineConstants Condition="$(OS) == 'Windows_NT'">$(DefineConstants);SMAPI_FOR_WINDOWS</DefineConstants>
diff --git a/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs b/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
index 7998272f..dc226b7c 100644
--- a/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
+++ b/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI
 {
@@ -28,6 +29,9 @@ namespace StardewModdingAPI
         ** Accessors
         *********/
         /// <summary>Whether this is a prerelease version.</summary>
+#if NET5_0_OR_GREATER
+        [MemberNotNullWhen(true, nameof(ISemanticVersion.PrereleaseTag))]
+#endif
         bool IsPrerelease();
 
         /// <summary>Get whether this version is older than the specified version.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
index d5ca2034..4fc4ea54 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
@@ -11,15 +9,26 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         ** Accessors
         *********/
         /// <summary>The mod's unique ID (if known).</summary>
-        public string ID { get; set; }
+        public string ID { get; }
 
         /// <summary>The update version recommended by the web API based on its version update and mapping rules.</summary>
-        public ModEntryVersionModel SuggestedUpdate { get; set; }
+        public ModEntryVersionModel? SuggestedUpdate { get; set; }
 
         /// <summary>Optional extended data which isn't needed for update checks.</summary>
-        public ModExtendedMetadataModel Metadata { get; set; }
+        public ModExtendedMetadataModel? Metadata { get; set; }
 
         /// <summary>The errors that occurred while fetching update data.</summary>
         public string[] Errors { get; set; } = Array.Empty<string>();
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="id">The mod's unique ID (if known).</param>
+        public ModEntryModel(string id)
+        {
+            this.ID = id;
+        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryVersionModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryVersionModel.cs
index 9aac7fd3..a1e78986 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryVersionModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModEntryVersionModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Converters;
 
@@ -13,18 +11,15 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         *********/
         /// <summary>The version number.</summary>
         [JsonConverter(typeof(NonStandardSemanticVersionConverter))]
-        public ISemanticVersion Version { get; set; }
+        public ISemanticVersion Version { get; }
 
         /// <summary>The mod page URL.</summary>
-        public string Url { get; set; }
+        public string Url { get; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public ModEntryVersionModel() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="version">The version number.</param>
         /// <param name="url">The mod page URL.</param>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
index eb54ec78..272a2063 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModExtendedMetadataModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -23,7 +21,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         public string[] ID { get; set; } = Array.Empty<string>();
 
         /// <summary>The mod's display name.</summary>
-        public string Name { get; set; }
+        public string? Name { get; set; }
 
         /// <summary>The mod ID on Nexus.</summary>
         public int? NexusID { get; set; }
@@ -35,31 +33,31 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         public int? CurseForgeID { get; set; }
 
         /// <summary>The mod key in the CurseForge mod repo (used in mod page URLs).</summary>
-        public string CurseForgeKey { get; set; }
+        public string? CurseForgeKey { get; set; }
 
         /// <summary>The mod ID in the ModDrop mod repo.</summary>
         public int? ModDropID { get; set; }
 
         /// <summary>The GitHub repository in the form 'owner/repo'.</summary>
-        public string GitHubRepo { get; set; }
+        public string? GitHubRepo { get; set; }
 
         /// <summary>The URL to a non-GitHub source repo.</summary>
-        public string CustomSourceUrl { get; set; }
+        public string? CustomSourceUrl { get; set; }
 
         /// <summary>The custom mod page URL (if applicable).</summary>
-        public string CustomUrl { get; set; }
+        public string? CustomUrl { get; set; }
 
         /// <summary>The main version.</summary>
-        public ModEntryVersionModel Main { get; set; }
+        public ModEntryVersionModel? Main { get; set; }
 
         /// <summary>The latest optional version, if newer than <see cref="Main"/>.</summary>
-        public ModEntryVersionModel Optional { get; set; }
+        public ModEntryVersionModel? Optional { get; set; }
 
         /// <summary>The latest unofficial version, if newer than <see cref="Main"/> and <see cref="Optional"/>.</summary>
-        public ModEntryVersionModel Unofficial { get; set; }
+        public ModEntryVersionModel? Unofficial { get; set; }
 
         /// <summary>The latest unofficial version for the current Stardew Valley or SMAPI beta, if any.</summary>
-        public ModEntryVersionModel UnofficialForBeta { get; set; }
+        public ModEntryVersionModel? UnofficialForBeta { get; set; }
 
         /****
         ** Stable compatibility
@@ -69,10 +67,10 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         public WikiCompatibilityStatus? CompatibilityStatus { get; set; }
 
         /// <summary>The human-readable summary of the compatibility status or workaround, without HTML formatting.</summary>
-        public string CompatibilitySummary { get; set; }
+        public string? CompatibilitySummary { get; set; }
 
         /// <summary>The game or SMAPI version which broke this mod, if applicable.</summary>
-        public string BrokeIn { get; set; }
+        public string? BrokeIn { get; set; }
 
         /****
         ** Beta compatibility
@@ -82,22 +80,22 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         public WikiCompatibilityStatus? BetaCompatibilityStatus { get; set; }
 
         /// <summary>The human-readable summary of the compatibility status or workaround for the Stardew Valley beta (if any), without HTML formatting.</summary>
-        public string BetaCompatibilitySummary { get; set; }
+        public string? BetaCompatibilitySummary { get; set; }
 
         /// <summary>The beta game or SMAPI version which broke this mod, if applicable.</summary>
-        public string BetaBrokeIn { get; set; }
+        public string? BetaBrokeIn { get; set; }
 
         /****
         ** Version mappings
         ****/
         /// <summary>A serialized change descriptor to apply to the local version during update checks (see <see cref="ChangeDescriptor"/>).</summary>
-        public string ChangeLocalVersions { get; set; }
+        public string? ChangeLocalVersions { get; set; }
 
         /// <summary>A serialized change descriptor to apply to the remote version during update checks (see <see cref="ChangeDescriptor"/>).</summary>
-        public string ChangeRemoteVersions { get; set; }
+        public string? ChangeRemoteVersions { get; set; }
 
         /// <summary>A serialized change descriptor to apply to the update keys during update checks (see <see cref="ChangeDescriptor"/>).</summary>
-        public string ChangeUpdateKeys { get; set; }
+        public string? ChangeUpdateKeys { get; set; }
 
 
         /*********
@@ -113,7 +111,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         /// <param name="optional">The latest optional version, if newer than <paramref name="main"/>.</param>
         /// <param name="unofficial">The latest unofficial version, if newer than <paramref name="main"/> and <paramref name="optional"/>.</param>
         /// <param name="unofficialForBeta">The latest unofficial version for the current Stardew Valley or SMAPI beta, if any.</param>
-        public ModExtendedMetadataModel(WikiModEntry wiki, ModDataRecord db, ModEntryVersionModel main, ModEntryVersionModel optional, ModEntryVersionModel unofficial, ModEntryVersionModel unofficialForBeta)
+        public ModExtendedMetadataModel(WikiModEntry? wiki, ModDataRecord? db, ModEntryVersionModel? main, ModEntryVersionModel? optional, ModEntryVersionModel? unofficial, ModEntryVersionModel? unofficialForBeta)
         {
             // versions
             this.Main = main;
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
index 8fe8fa2a..9c11e1db 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchEntryModel.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Linq;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
 {
@@ -11,37 +10,39 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         ** Accessors
         *********/
         /// <summary>The unique mod ID.</summary>
-        public string ID { get; set; }
+        public string ID { get; }
 
         /// <summary>The namespaced mod update keys (if available).</summary>
-        public string[] UpdateKeys { get; set; }
+        public string[] UpdateKeys { get; private set; }
 
         /// <summary>The mod version installed by the local player. This is used for version mapping in some cases.</summary>
-        public ISemanticVersion InstalledVersion { get; set; }
+        public ISemanticVersion? InstalledVersion { get; }
 
         /// <summary>Whether the installed version is broken or could not be loaded.</summary>
-        public bool IsBroken { get; set; }
+        public bool IsBroken { get; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an empty instance.</summary>
-        public ModSearchEntryModel()
-        {
-            // needed for JSON deserializing
-        }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="id">The unique mod ID.</param>
         /// <param name="installedVersion">The version installed by the local player. This is used for version mapping in some cases.</param>
         /// <param name="updateKeys">The namespaced mod update keys (if available).</param>
         /// <param name="isBroken">Whether the installed version is broken or could not be loaded.</param>
-        public ModSearchEntryModel(string id, ISemanticVersion installedVersion, string[] updateKeys, bool isBroken = false)
+        public ModSearchEntryModel(string id, ISemanticVersion? installedVersion, string[]? updateKeys, bool isBroken = false)
         {
             this.ID = id;
             this.InstalledVersion = installedVersion;
             this.UpdateKeys = updateKeys ?? Array.Empty<string>();
+            this.IsBroken = isBroken;
+        }
+
+        /// <summary>Add update keys for the mod.</summary>
+        /// <param name="updateKeys">The update keys to add.</param>
+        public void AddUpdateKeys(params string[] updateKeys)
+        {
+            this.UpdateKeys = this.UpdateKeys.Concat(updateKeys).ToArray();
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
index 393391f7..a0cd9d4d 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Linq;
 using StardewModdingAPI.Toolkit.Utilities;
 
@@ -24,18 +22,12 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         public ISemanticVersion GameVersion { get; set; }
 
         /// <summary>The OS on which the player plays.</summary>
-        public Platform? Platform { get; set; }
+        public Platform Platform { get; set; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an empty instance.</summary>
-        public ModSearchModel()
-        {
-            // needed for JSON deserializing
-        }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="mods">The mods to search.</param>
         /// <param name="apiVersion">The SMAPI version installed by the player. If this is null, the API won't provide a recommended update.</param>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
index 56acb768..d4282617 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -72,7 +70,8 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
             client.Headers["Content-Type"] = "application/json";
             client.Headers["User-Agent"] = $"SMAPI/{this.Version}";
             string response = client.UploadString(fullUrl, data);
-            return JsonConvert.DeserializeObject<TResult>(response, this.JsonSettings);
+            return JsonConvert.DeserializeObject<TResult>(response, this.JsonSettings)
+                ?? throw new InvalidOperationException($"Could not parse the response from POST {url}.");
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
index 910bf793..5978803e 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
@@ -49,7 +47,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <summary>Apply the change descriptors to a comma-delimited field.</summary>
         /// <param name="rawField">The raw field text.</param>
         /// <returns>Returns the modified field.</returns>
-        public string ApplyToCopy(string rawField)
+        public string? ApplyToCopy(string? rawField)
         {
             // get list
             List<string> values = !string.IsNullOrWhiteSpace(rawField)
@@ -75,12 +73,12 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             {
                 for (int i = values.Count - 1; i >= 0; i--)
                 {
-                    string value = this.FormatValue(values[i]?.Trim() ?? string.Empty);
+                    string value = this.FormatValue(values[i].Trim());
 
                     if (this.Remove.Contains(value))
                         values.RemoveAt(i);
 
-                    else if (this.Replace.TryGetValue(value, out string newValue))
+                    else if (this.Replace.TryGetValue(value, out string? newValue))
                         values[i] = newValue;
                 }
             }
@@ -88,7 +86,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             // add values
             if (this.Add.Any())
             {
-                HashSet<string> curValues = new HashSet<string>(values.Select(p => p?.Trim() ?? string.Empty), StringComparer.OrdinalIgnoreCase);
+                HashSet<string> curValues = new HashSet<string>(values.Select(p => p.Trim()), StringComparer.OrdinalIgnoreCase);
                 foreach (string add in this.Add)
                 {
                     if (!curValues.Contains(add))
@@ -121,7 +119,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <param name="descriptor">The raw change descriptor.</param>
         /// <param name="errors">The human-readable error message describing any invalid values that were ignored.</param>
         /// <param name="formatValue">Format a raw value into a normalized form if needed.</param>
-        public static ChangeDescriptor Parse(string descriptor, out string[] errors, Func<string, string> formatValue = null)
+        public static ChangeDescriptor Parse(string descriptor, out string[] errors, Func<string, string>? formatValue = null)
         {
             // init
             formatValue ??= p => p;
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index 86c3bd75..7f06d170 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -53,8 +51,8 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             doc.LoadHtml(html);
 
             // fetch game versions
-            string stableVersion = doc.DocumentNode.SelectSingleNode("//div[@class='game-stable-version']")?.InnerText;
-            string betaVersion = doc.DocumentNode.SelectSingleNode("//div[@class='game-beta-version']")?.InnerText;
+            string? stableVersion = doc.DocumentNode.SelectSingleNode("//div[@class='game-stable-version']")?.InnerText;
+            string? betaVersion = doc.DocumentNode.SelectSingleNode("//div[@class='game-beta-version']")?.InnerText;
             if (betaVersion == stableVersion)
                 betaVersion = null;
 
@@ -65,7 +63,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                 if (modNodes == null)
                     throw new InvalidOperationException("Can't parse wiki compatibility list, no mod data overrides section found.");
 
-                foreach (var entry in this.ParseOverrideEntries(modNodes))
+                foreach (WikiDataOverrideEntry entry in this.ParseOverrideEntries(modNodes))
                 {
                     if (entry.Ids.Any() != true || !entry.HasChanges)
                         continue;
@@ -85,18 +83,17 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
             }
 
             // build model
-            return new WikiModList
-            {
-                StableVersion = stableVersion,
-                BetaVersion = betaVersion,
-                Mods = mods
-            };
+            return new WikiModList(
+                stableVersion: stableVersion,
+                betaVersion: betaVersion,
+                mods: mods
+            );
         }
 
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         public void Dispose()
         {
-            this.Client?.Dispose();
+            this.Client.Dispose();
         }
 
 
@@ -118,71 +115,68 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                 int? nexusID = this.GetAttributeAsNullableInt(node, "data-nexus-id");
                 int? chucklefishID = this.GetAttributeAsNullableInt(node, "data-cf-id");
                 int? curseForgeID = this.GetAttributeAsNullableInt(node, "data-curseforge-id");
-                string curseForgeKey = this.GetAttribute(node, "data-curseforge-key");
+                string? curseForgeKey = this.GetAttribute(node, "data-curseforge-key");
                 int? modDropID = this.GetAttributeAsNullableInt(node, "data-moddrop-id");
-                string githubRepo = this.GetAttribute(node, "data-github");
-                string customSourceUrl = this.GetAttribute(node, "data-custom-source");
-                string customUrl = this.GetAttribute(node, "data-url");
-                string anchor = this.GetAttribute(node, "id");
-                string contentPackFor = this.GetAttribute(node, "data-content-pack-for");
-                string devNote = this.GetAttribute(node, "data-dev-note");
-                string pullRequestUrl = this.GetAttribute(node, "data-pr");
+                string? githubRepo = this.GetAttribute(node, "data-github");
+                string? customSourceUrl = this.GetAttribute(node, "data-custom-source");
+                string? customUrl = this.GetAttribute(node, "data-url");
+                string? anchor = this.GetAttribute(node, "id");
+                string? contentPackFor = this.GetAttribute(node, "data-content-pack-for");
+                string? devNote = this.GetAttribute(node, "data-dev-note");
+                string? pullRequestUrl = this.GetAttribute(node, "data-pr");
 
                 // parse stable compatibility
-                WikiCompatibilityInfo compatibility = new()
-                {
-                    Status = this.GetAttributeAsEnum<WikiCompatibilityStatus>(node, "data-status") ?? WikiCompatibilityStatus.Ok,
-                    BrokeIn = this.GetAttribute(node, "data-broke-in"),
-                    UnofficialVersion = this.GetAttributeAsSemanticVersion(node, "data-unofficial-version"),
-                    UnofficialUrl = this.GetAttribute(node, "data-unofficial-url"),
-                    Summary = this.GetInnerHtml(node, "mod-summary")?.Trim()
-                };
+                WikiCompatibilityInfo compatibility = new(
+                    status: this.GetAttributeAsEnum<WikiCompatibilityStatus>(node, "data-status") ?? WikiCompatibilityStatus.Ok,
+                    brokeIn: this.GetAttribute(node, "data-broke-in"),
+                    unofficialVersion: this.GetAttributeAsSemanticVersion(node, "data-unofficial-version"),
+                    unofficialUrl: this.GetAttribute(node, "data-unofficial-url"),
+                    summary: this.GetInnerHtml(node, "mod-summary")?.Trim()
+                );
 
                 // parse beta compatibility
-                WikiCompatibilityInfo betaCompatibility = null;
+                WikiCompatibilityInfo? betaCompatibility = null;
                 {
                     WikiCompatibilityStatus? betaStatus = this.GetAttributeAsEnum<WikiCompatibilityStatus>(node, "data-beta-status");
                     if (betaStatus.HasValue)
                     {
-                        betaCompatibility = new WikiCompatibilityInfo
-                        {
-                            Status = betaStatus.Value,
-                            BrokeIn = this.GetAttribute(node, "data-beta-broke-in"),
-                            UnofficialVersion = this.GetAttributeAsSemanticVersion(node, "data-beta-unofficial-version"),
-                            UnofficialUrl = this.GetAttribute(node, "data-beta-unofficial-url"),
-                            Summary = this.GetInnerHtml(node, "mod-beta-summary")
-                        };
+                        betaCompatibility = new WikiCompatibilityInfo(
+                            status: betaStatus.Value,
+                            brokeIn: this.GetAttribute(node, "data-beta-broke-in"),
+                            unofficialVersion: this.GetAttributeAsSemanticVersion(node, "data-beta-unofficial-version"),
+                            unofficialUrl: this.GetAttribute(node, "data-beta-unofficial-url"),
+                            summary: this.GetInnerHtml(node, "mod-beta-summary")
+                        );
                     }
                 }
 
                 // find data overrides
-                WikiDataOverrideEntry overrides = ids
+                WikiDataOverrideEntry? overrides = ids
                     .Select(id => overridesById.TryGetValue(id, out overrides) ? overrides : null)
                     .FirstOrDefault(p => p != null);
 
                 // yield model
-                yield return new WikiModEntry
-                {
-                    ID = ids,
-                    Name = names,
-                    Author = authors,
-                    NexusID = nexusID,
-                    ChucklefishID = chucklefishID,
-                    CurseForgeID = curseForgeID,
-                    CurseForgeKey = curseForgeKey,
-                    ModDropID = modDropID,
-                    GitHubRepo = githubRepo,
-                    CustomSourceUrl = customSourceUrl,
-                    CustomUrl = customUrl,
-                    ContentPackFor = contentPackFor,
-                    Compatibility = compatibility,
-                    BetaCompatibility = betaCompatibility,
-                    Warnings = warnings,
-                    PullRequestUrl = pullRequestUrl,
-                    DevNote = devNote,
-                    Overrides = overrides,
-                    Anchor = anchor
-                };
+                yield return new WikiModEntry(
+                    id: ids,
+                    name: names,
+                    author: authors,
+                    nexusId: nexusID,
+                    chucklefishId: chucklefishID,
+                    curseForgeId: curseForgeID,
+                    curseForgeKey: curseForgeKey,
+                    modDropId: modDropID,
+                    githubRepo: githubRepo,
+                    customSourceUrl: customSourceUrl,
+                    customUrl: customUrl,
+                    contentPackFor: contentPackFor,
+                    compatibility: compatibility,
+                    betaCompatibility: betaCompatibility,
+                    warnings: warnings,
+                    pullRequestUrl: pullRequestUrl,
+                    devNote: devNote,
+                    overrides: overrides,
+                    anchor: anchor
+                );
             }
         }
 
@@ -196,10 +190,10 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
                 {
                     Ids = this.GetAttributeAsCsv(node, "data-id"),
                     ChangeLocalVersions = this.GetAttributeAsChangeDescriptor(node, "data-local-version",
-                        raw => SemanticVersion.TryParse(raw, out ISemanticVersion version) ? version.ToString() : raw
+                        raw => SemanticVersion.TryParse(raw, out ISemanticVersion? version) ? version.ToString() : raw
                     ),
                     ChangeRemoteVersions = this.GetAttributeAsChangeDescriptor(node, "data-remote-version",
-                        raw => SemanticVersion.TryParse(raw, out ISemanticVersion version) ? version.ToString() : raw
+                        raw => SemanticVersion.TryParse(raw, out ISemanticVersion? version) ? version.ToString() : raw
                     ),
 
                     ChangeUpdateKeys = this.GetAttributeAsChangeDescriptor(node, "data-update-keys",
@@ -212,7 +206,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <summary>Get an attribute value.</summary>
         /// <param name="element">The element whose attributes to read.</param>
         /// <param name="name">The attribute name.</param>
-        private string GetAttribute(HtmlNode element, string name)
+        private string? GetAttribute(HtmlNode element, string name)
         {
             string value = element.GetAttributeValue(name, null);
             if (string.IsNullOrWhiteSpace(value))
@@ -225,9 +219,9 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <param name="element">The element whose attributes to read.</param>
         /// <param name="name">The attribute name.</param>
         /// <param name="formatValue">Format an raw entry value when applying changes.</param>
-        private ChangeDescriptor GetAttributeAsChangeDescriptor(HtmlNode element, string name, Func<string, string> formatValue)
+        private ChangeDescriptor? GetAttributeAsChangeDescriptor(HtmlNode element, string name, Func<string, string> formatValue)
         {
-            string raw = this.GetAttribute(element, name);
+            string? raw = this.GetAttribute(element, name);
             return raw != null
                 ? ChangeDescriptor.Parse(raw, out _, formatValue)
                 : null;
@@ -238,7 +232,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <param name="name">The attribute name.</param>
         private string[] GetAttributeAsCsv(HtmlNode element, string name)
         {
-            string raw = this.GetAttribute(element, name);
+            string? raw = this.GetAttribute(element, name);
             return !string.IsNullOrWhiteSpace(raw)
                 ? raw.Split(new[] { ',' }, StringSplitOptions.RemoveEmptyEntries).Select(p => p.Trim()).ToArray()
                 : Array.Empty<string>();
@@ -250,7 +244,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <param name="name">The attribute name.</param>
         private TEnum? GetAttributeAsEnum<TEnum>(HtmlNode element, string name) where TEnum : struct
         {
-            string raw = this.GetAttribute(element, name);
+            string? raw = this.GetAttribute(element, name);
             if (raw == null)
                 return null;
             if (!Enum.TryParse(raw, true, out TEnum value) && Enum.IsDefined(typeof(TEnum), value))
@@ -261,10 +255,10 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <summary>Get an attribute value and parse it as a semantic version.</summary>
         /// <param name="element">The element whose attributes to read.</param>
         /// <param name="name">The attribute name.</param>
-        private ISemanticVersion GetAttributeAsSemanticVersion(HtmlNode element, string name)
+        private ISemanticVersion? GetAttributeAsSemanticVersion(HtmlNode element, string name)
         {
-            string raw = this.GetAttribute(element, name);
-            return SemanticVersion.TryParse(raw, out ISemanticVersion version)
+            string? raw = this.GetAttribute(element, name);
+            return SemanticVersion.TryParse(raw, out ISemanticVersion? version)
                 ? version
                 : null;
         }
@@ -274,7 +268,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <param name="name">The attribute name.</param>
         private int? GetAttributeAsNullableInt(HtmlNode element, string name)
         {
-            string raw = this.GetAttribute(element, name);
+            string? raw = this.GetAttribute(element, name);
             if (raw != null && int.TryParse(raw, out int value))
                 return value;
             return null;
@@ -283,7 +277,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <summary>Get the text of an element with the given class name.</summary>
         /// <param name="container">The metadata container.</param>
         /// <param name="className">The field name.</param>
-        private string GetInnerHtml(HtmlNode container, string className)
+        private string? GetInnerHtml(HtmlNode container, string className)
         {
             return container.Descendants().FirstOrDefault(p => p.HasClass(className))?.InnerHtml;
         }
@@ -293,8 +287,22 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         [SuppressMessage("ReSharper", "UnusedAutoPropertyAccessor.Local")]
         private class ResponseModel
         {
+            /*********
+            ** Accessors
+            *********/
             /// <summary>The parse API results.</summary>
-            public ResponseParseModel Parse { get; set; }
+            public ResponseParseModel Parse { get; }
+
+
+            /*********
+            ** Public methods
+            *********/
+            /// <summary>Construct an instance.</summary>
+            /// <param name="parse">The parse API results.</param>
+            public ResponseModel(ResponseParseModel parse)
+            {
+                this.Parse = parse;
+            }
         }
 
         /// <summary>The inner response model for the MediaWiki parse API.</summary>
@@ -303,8 +311,11 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         [SuppressMessage("ReSharper", "UnusedAutoPropertyAccessor.Local")]
         private class ResponseParseModel
         {
+            /*********
+            ** Accessors
+            *********/
             /// <summary>The parsed text.</summary>
-            public IDictionary<string, string> Text { get; set; }
+            public IDictionary<string, string> Text { get; } = new Dictionary<string, string>();
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityInfo.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityInfo.cs
index 30e76d04..71c90d0c 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityInfo.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityInfo.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>Compatibility info for a mod.</summary>
@@ -9,18 +7,37 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         ** Accessors
         *********/
         /// <summary>The compatibility status.</summary>
-        public WikiCompatibilityStatus Status { get; set; }
+        public WikiCompatibilityStatus Status { get; }
 
         /// <summary>The human-readable summary of the compatibility status or workaround, without HTML formatting.</summary>
-        public string Summary { get; set; }
+        public string? Summary { get; }
 
-        /// <summary>The game or SMAPI version which broke this mod (if applicable).</summary>
-        public string BrokeIn { get; set; }
+        /// <summary>The game or SMAPI version which broke this mod, if applicable.</summary>
+        public string? BrokeIn { get; }
 
         /// <summary>The version of the latest unofficial update, if applicable.</summary>
-        public ISemanticVersion UnofficialVersion { get; set; }
+        public ISemanticVersion? UnofficialVersion { get; }
 
         /// <summary>The URL to the latest unofficial update, if applicable.</summary>
-        public string UnofficialUrl { get; set; }
+        public string? UnofficialUrl { get; }
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="status">The compatibility status.</param>
+        /// <param name="summary">The human-readable summary of the compatibility status or workaround, without HTML formatting.</param>
+        /// <param name="brokeIn">The game or SMAPI version which broke this mod, if applicable.</param>
+        /// <param name="unofficialVersion">The version of the latest unofficial update, if applicable.</param>
+        /// <param name="unofficialUrl">The URL to the latest unofficial update, if applicable.</param>
+        public WikiCompatibilityInfo(WikiCompatibilityStatus status, string? summary, string? brokeIn, ISemanticVersion? unofficialVersion, string? unofficialUrl)
+        {
+            this.Status = status;
+            this.Summary = summary;
+            this.BrokeIn = brokeIn;
+            this.UnofficialVersion = unofficialVersion;
+            this.UnofficialUrl = unofficialUrl;
+        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityStatus.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityStatus.cs
index 2c222b71..5cdf489f 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityStatus.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiCompatibilityStatus.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>The compatibility status for a mod.</summary>
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
index 91943ff9..fc50125f 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModEntry.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
@@ -8,64 +8,114 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /*********
         ** Accessors
         *********/
-        /// <summary>The mod's unique ID. If the mod has alternate/old IDs, they're listed in latest to newest order.</summary>
-        public string[] ID { get; set; }
+        /// <summary>The mod's unique ID. If the mod has alternate/old IDs, they're listed in latest to oldest order.</summary>
+        public string[] ID { get; }
 
         /// <summary>The mod's display name. If the mod has multiple names, the first one is the most canonical name.</summary>
-        public string[] Name { get; set; }
+        public string[] Name { get; }
 
-        /// <summary>The mod's author name.  If the author has multiple names, the first one is the most canonical name.</summary>
-        public string[] Author { get; set; }
+        /// <summary>The mod's author name. If the author has multiple names, the first one is the most canonical name.</summary>
+        public string[] Author { get; }
 
         /// <summary>The mod ID on Nexus.</summary>
-        public int? NexusID { get; set; }
+        public int? NexusID { get; }
 
         /// <summary>The mod ID in the Chucklefish mod repo.</summary>
-        public int? ChucklefishID { get; set; }
+        public int? ChucklefishID { get; }
 
         /// <summary>The mod ID in the CurseForge mod repo.</summary>
-        public int? CurseForgeID { get; set; }
+        public int? CurseForgeID { get; }
 
         /// <summary>The mod key in the CurseForge mod repo (used in mod page URLs).</summary>
-        public string CurseForgeKey { get; set; }
+        public string? CurseForgeKey { get; }
 
         /// <summary>The mod ID in the ModDrop mod repo.</summary>
-        public int? ModDropID { get; set; }
+        public int? ModDropID { get; }
 
         /// <summary>The GitHub repository in the form 'owner/repo'.</summary>
-        public string GitHubRepo { get; set; }
+        public string? GitHubRepo { get; }
 
         /// <summary>The URL to a non-GitHub source repo.</summary>
-        public string CustomSourceUrl { get; set; }
+        public string? CustomSourceUrl { get; }
 
         /// <summary>The custom mod page URL (if applicable).</summary>
-        public string CustomUrl { get; set; }
+        public string? CustomUrl { get; }
 
         /// <summary>The name of the mod which loads this content pack, if applicable.</summary>
-        public string ContentPackFor { get; set; }
+        public string? ContentPackFor { get; }
 
         /// <summary>The mod's compatibility with the latest stable version of the game.</summary>
-        public WikiCompatibilityInfo Compatibility { get; set; }
+        public WikiCompatibilityInfo Compatibility { get; }
 
         /// <summary>The mod's compatibility with the latest beta version of the game (if any).</summary>
-        public WikiCompatibilityInfo BetaCompatibility { get; set; }
+        public WikiCompatibilityInfo? BetaCompatibility { get; }
 
         /// <summary>Whether a Stardew Valley or SMAPI beta which affects mod compatibility is in progress. If this is true, <see cref="BetaCompatibility"/> should be used for beta versions of SMAPI instead of <see cref="Compatibility"/>.</summary>
+#if NET5_0_OR_GREATER
+        [MemberNotNullWhen(true, nameof(WikiModEntry.BetaCompatibility))]
+#endif
         public bool HasBetaInfo => this.BetaCompatibility != null;
 
         /// <summary>The human-readable warnings for players about this mod.</summary>
-        public string[] Warnings { get; set; }
+        public string[] Warnings { get; }
 
         /// <summary>The URL of the pull request which submits changes for an unofficial update to the author, if any.</summary>
-        public string PullRequestUrl { get; set; }
+        public string? PullRequestUrl { get; }
 
-        /// <summary>Special notes intended for developers who maintain unofficial updates or submit pull requests. </summary>
-        public string DevNote { get; set; }
+        /// <summary>Special notes intended for developers who maintain unofficial updates or submit pull requests.</summary>
+        public string? DevNote { get; }
 
         /// <summary>The data overrides to apply to the mod's manifest or remote mod page data, if any.</summary>
-        public WikiDataOverrideEntry Overrides { get; set; }
+        public WikiDataOverrideEntry? Overrides { get; }
 
         /// <summary>The link anchor for the mod entry in the wiki compatibility list.</summary>
-        public string Anchor { get; set; }
+        public string? Anchor { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="id">The mod's unique ID. If the mod has alternate/old IDs, they're listed in latest to oldest order.</param>
+        /// <param name="name">The mod's display name. If the mod has multiple names, the first one is the most canonical name.</param>
+        /// <param name="author">The mod's author name. If the author has multiple names, the first one is the most canonical name.</param>
+        /// <param name="nexusId">The mod ID on Nexus.</param>
+        /// <param name="chucklefishId">The mod ID in the Chucklefish mod repo.</param>
+        /// <param name="curseForgeId">The mod ID in the CurseForge mod repo.</param>
+        /// <param name="curseForgeKey">The mod ID in the CurseForge mod repo.</param>
+        /// <param name="modDropId">The mod ID in the ModDrop mod repo.</param>
+        /// <param name="githubRepo">The GitHub repository in the form 'owner/repo'.</param>
+        /// <param name="customSourceUrl">The URL to a non-GitHub source repo.</param>
+        /// <param name="customUrl">The custom mod page URL (if applicable).</param>
+        /// <param name="contentPackFor">The name of the mod which loads this content pack, if applicable.</param>
+        /// <param name="compatibility">The mod's compatibility with the latest stable version of the game.</param>
+        /// <param name="betaCompatibility">The mod's compatibility with the latest beta version of the game (if any).</param>
+        /// <param name="warnings">The human-readable warnings for players about this mod.</param>
+        /// <param name="pullRequestUrl">The URL of the pull request which submits changes for an unofficial update to the author, if any.</param>
+        /// <param name="devNote">Special notes intended for developers who maintain unofficial updates or submit pull requests.</param>
+        /// <param name="overrides">The data overrides to apply to the mod's manifest or remote mod page data, if any.</param>
+        /// <param name="anchor">The link anchor for the mod entry in the wiki compatibility list.</param>
+        public WikiModEntry(string[] id, string[] name, string[] author, int? nexusId, int? chucklefishId, int? curseForgeId, string? curseForgeKey, int? modDropId, string? githubRepo, string? customSourceUrl, string? customUrl, string? contentPackFor, WikiCompatibilityInfo compatibility, WikiCompatibilityInfo? betaCompatibility, string[] warnings, string? pullRequestUrl, string? devNote, WikiDataOverrideEntry? overrides, string? anchor)
+        {
+            this.ID = id;
+            this.Name = name;
+            this.Author = author;
+            this.NexusID = nexusId;
+            this.ChucklefishID = chucklefishId;
+            this.CurseForgeID = curseForgeId;
+            this.CurseForgeKey = curseForgeKey;
+            this.ModDropID = modDropId;
+            this.GitHubRepo = githubRepo;
+            this.CustomSourceUrl = customSourceUrl;
+            this.CustomUrl = customUrl;
+            this.ContentPackFor = contentPackFor;
+            this.Compatibility = compatibility;
+            this.BetaCompatibility = betaCompatibility;
+            this.Warnings = warnings;
+            this.PullRequestUrl = pullRequestUrl;
+            this.DevNote = devNote;
+            this.Overrides = overrides;
+            this.Anchor = anchor;
+        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs
index 1787197a..24548078 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiModList.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
 {
     /// <summary>Metadata from the wiki's mod compatibility list.</summary>
@@ -9,12 +7,27 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         ** Accessors
         *********/
         /// <summary>The stable game version.</summary>
-        public string StableVersion { get; set; }
+        public string? StableVersion { get; }
 
         /// <summary>The beta game version (if any).</summary>
-        public string BetaVersion { get; set; }
+        public string? BetaVersion { get; }
 
         /// <summary>The mods on the wiki.</summary>
-        public WikiModEntry[] Mods { get; set; }
+        public WikiModEntry[] Mods { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="stableVersion">The stable game version.</param>
+        /// <param name="betaVersion">The beta game version (if any).</param>
+        /// <param name="mods">The mods on the wiki.</param>
+        public WikiModList(string? stableVersion, string? betaVersion, WikiModEntry[] mods)
+        {
+            this.StableVersion = stableVersion;
+            this.BetaVersion = betaVersion;
+            this.Mods = mods;
+        }
     }
 }
diff --git a/src/SMAPI.Toolkit/SemanticVersion.cs b/src/SMAPI.Toolkit/SemanticVersion.cs
index 2cb27e11..3713758f 100644
--- a/src/SMAPI.Toolkit/SemanticVersion.cs
+++ b/src/SMAPI.Toolkit/SemanticVersion.cs
@@ -119,6 +119,9 @@ namespace StardewModdingAPI.Toolkit
         }
 
         /// <inheritdoc />
+#if NET5_0_OR_GREATER
+        [MemberNotNullWhen(true, nameof(SemanticVersion.PrereleaseTag))]
+#endif
         public bool IsPrerelease()
         {
             return !string.IsNullOrWhiteSpace(this.PrereleaseTag);
diff --git a/src/SMAPI.Toolkit/SemanticVersionComparer.cs b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
index 85c974bd..2eca30df 100644
--- a/src/SMAPI.Toolkit/SemanticVersionComparer.cs
+++ b/src/SMAPI.Toolkit/SemanticVersionComparer.cs
@@ -3,7 +3,7 @@ using System.Collections.Generic;
 namespace StardewModdingAPI.Toolkit
 {
     /// <summary>A comparer for semantic versions based on the <see cref="SemanticVersion.CompareTo(ISemanticVersion)"/> field.</summary>
-    public class SemanticVersionComparer : IComparer<ISemanticVersion>
+    public class SemanticVersionComparer : IComparer<ISemanticVersion?>
     {
         /*********
         ** Accessors
diff --git a/src/SMAPI.Web/BackgroundService.cs b/src/SMAPI.Web/BackgroundService.cs
index 7706b276..49356f76 100644
--- a/src/SMAPI.Web/BackgroundService.cs
+++ b/src/SMAPI.Web/BackgroundService.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Threading;
@@ -21,13 +19,17 @@ namespace StardewModdingAPI.Web
         ** Fields
         *********/
         /// <summary>The background task server.</summary>
-        private static BackgroundJobServer JobServer;
+        private static BackgroundJobServer? JobServer;
 
         /// <summary>The cache in which to store wiki metadata.</summary>
-        private static IWikiCacheRepository WikiCache;
+        private static IWikiCacheRepository? WikiCache;
 
         /// <summary>The cache in which to store mod data.</summary>
-        private static IModCacheRepository ModCache;
+        private static IModCacheRepository? ModCache;
+
+        /// <summary>Whether the service has been started.</summary>
+        [MemberNotNullWhen(true, nameof(BackgroundService.JobServer), nameof(BackgroundService.WikiCache), nameof(BackgroundService.ModCache))]
+        private static bool IsStarted { get; set; }
 
 
         /*********
@@ -61,6 +63,8 @@ namespace StardewModdingAPI.Web
             RecurringJob.AddOrUpdate(() => BackgroundService.UpdateWikiAsync(), "*/10 * * * *"); // every 10 minutes
             RecurringJob.AddOrUpdate(() => BackgroundService.RemoveStaleModsAsync(), "0 * * * *"); // hourly
 
+            BackgroundService.IsStarted = true;
+
             return Task.CompletedTask;
         }
 
@@ -68,6 +72,8 @@ namespace StardewModdingAPI.Web
         /// <param name="cancellationToken">Tracks whether the shutdown process should no longer be graceful.</param>
         public async Task StopAsync(CancellationToken cancellationToken)
         {
+            BackgroundService.IsStarted = false;
+
             if (BackgroundService.JobServer != null)
                 await BackgroundService.JobServer.WaitForShutdownAsync(cancellationToken);
         }
@@ -75,6 +81,8 @@ namespace StardewModdingAPI.Web
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         public void Dispose()
         {
+            BackgroundService.IsStarted = false;
+
             BackgroundService.JobServer?.Dispose();
         }
 
@@ -85,6 +93,9 @@ namespace StardewModdingAPI.Web
         [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 30, 60, 120 })]
         public static async Task UpdateWikiAsync()
         {
+            if (!BackgroundService.IsStarted)
+                throw new InvalidOperationException($"Must call {nameof(BackgroundService.StartAsync)} before scheduling tasks.");
+
             WikiModList wikiCompatList = await new ModToolkit().GetWikiCompatibilityListAsync();
             BackgroundService.WikiCache.SaveWikiData(wikiCompatList.StableVersion, wikiCompatList.BetaVersion, wikiCompatList.Mods);
         }
@@ -92,6 +103,9 @@ namespace StardewModdingAPI.Web
         /// <summary>Remove mods which haven't been requested in over 48 hours.</summary>
         public static Task RemoveStaleModsAsync()
         {
+            if (!BackgroundService.IsStarted)
+                throw new InvalidOperationException($"Must call {nameof(BackgroundService.StartAsync)} before scheduling tasks.");
+
             BackgroundService.ModCache.RemoveStaleMods(TimeSpan.FromHours(48));
             return Task.CompletedTask;
         }
diff --git a/src/SMAPI.Web/Controllers/IndexController.cs b/src/SMAPI.Web/Controllers/IndexController.cs
index f7834b9c..522d77cd 100644
--- a/src/SMAPI.Web/Controllers/IndexController.cs
+++ b/src/SMAPI.Web/Controllers/IndexController.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -59,8 +57,8 @@ namespace StardewModdingAPI.Web.Controllers
         {
             // choose versions
             ReleaseVersion[] versions = await this.GetReleaseVersionsAsync();
-            ReleaseVersion stableVersion = versions.LastOrDefault(version => !version.IsForDevs);
-            ReleaseVersion stableVersionForDevs = versions.LastOrDefault(version => version.IsForDevs);
+            ReleaseVersion? stableVersion = versions.LastOrDefault(version => !version.IsForDevs);
+            ReleaseVersion? stableVersionForDevs = versions.LastOrDefault(version => version.IsForDevs);
 
             // render view
             IndexVersionModel stableVersionModel = stableVersion != null
@@ -91,7 +89,7 @@ namespace StardewModdingAPI.Web.Controllers
                 entry.AbsoluteExpiration = DateTimeOffset.UtcNow.Add(this.CacheTime);
 
                 // get latest stable release
-                GitRelease release = await this.GitHub.GetLatestReleaseAsync(this.RepositoryName, includePrerelease: false);
+                GitRelease? release = await this.GitHub.GetLatestReleaseAsync(this.RepositoryName, includePrerelease: false);
 
                 // strip 'noinclude' blocks from release description
                 if (release != null)
@@ -113,7 +111,7 @@ namespace StardewModdingAPI.Web.Controllers
 
         /// <summary>Get a parsed list of SMAPI downloads for a release.</summary>
         /// <param name="release">The GitHub release.</param>
-        private IEnumerable<ReleaseVersion> ParseReleaseVersions(GitRelease release)
+        private IEnumerable<ReleaseVersion> ParseReleaseVersions(GitRelease? release)
         {
             if (release?.Assets == null)
                 yield break;
@@ -124,7 +122,7 @@ namespace StardewModdingAPI.Web.Controllers
                     continue;
 
                 Match match = Regex.Match(asset.FileName, @"SMAPI-(?<version>[\d\.]+(?:-.+)?)-installer(?<forDevs>-for-developers)?.zip");
-                if (!match.Success || !SemanticVersion.TryParse(match.Groups["version"].Value, out ISemanticVersion version))
+                if (!match.Success || !SemanticVersion.TryParse(match.Groups["version"].Value, out ISemanticVersion? version))
                     continue;
                 bool isForDevs = match.Groups["forDevs"].Success;
 
diff --git a/src/SMAPI.Web/Controllers/JsonValidatorController.cs b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
index 5791d834..e78aeeb6 100644
--- a/src/SMAPI.Web/Controllers/JsonValidatorController.cs
+++ b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -66,7 +64,7 @@ namespace StardewModdingAPI.Web.Controllers
         [Route("json/{schemaName}")]
         [Route("json/{schemaName}/{id}")]
         [Route("json/{schemaName}/{id}/{operation}")]
-        public async Task<ViewResult> Index(string schemaName = null, string id = null, string operation = null)
+        public async Task<ViewResult> Index(string? schemaName = null, string? id = null, string? operation = null)
         {
             // parse arguments
             schemaName = this.NormalizeSchemaName(schemaName);
@@ -81,7 +79,7 @@ namespace StardewModdingAPI.Web.Controllers
                 return this.View("Index", result);
 
             // fetch raw JSON
-            StoredFileInfo file = await this.Storage.GetAsync(id, renew);
+            StoredFileInfo file = await this.Storage.GetAsync(id!, renew);
             if (string.IsNullOrWhiteSpace(file.Content))
                 return this.View("Index", result.SetUploadError("The JSON file seems to be empty."));
             result.SetContent(file.Content, expiry: file.Expiry, uploadWarning: file.Warning);
@@ -105,7 +103,7 @@ namespace StardewModdingAPI.Web.Controllers
                 }
                 catch (JsonReaderException ex)
                 {
-                    return this.View("Index", result.AddErrors(new JsonValidatorErrorModel(ex.LineNumber, ex.Path, ex.Message, ErrorType.None)));
+                    return this.View("Index", result.AddErrors(new JsonValidatorErrorModel(ex.LineNumber, ex.Path!, ex.Message, ErrorType.None)));
                 }
 
                 // format JSON
@@ -121,7 +119,7 @@ namespace StardewModdingAPI.Web.Controllers
             // load schema
             JSchema schema;
             {
-                FileInfo schemaFile = this.FindSchemaFile(schemaName);
+                FileInfo? schemaFile = this.FindSchemaFile(schemaName);
                 if (schemaFile == null)
                     return this.View("Index", result.SetParseError($"Invalid schema '{schemaName}'."));
                 schema = JSchema.Parse(System.IO.File.ReadAllText(schemaFile.FullName));
@@ -144,7 +142,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <summary>Save raw JSON data.</summary>
         [HttpPost, AllowLargePosts]
         [Route("json")]
-        public async Task<ActionResult> PostAsync(JsonValidatorRequestModel request)
+        public async Task<ActionResult> PostAsync(JsonValidatorRequestModel? request)
         {
             if (request == null)
                 return this.View("Index", this.GetModel(null, null, isEditView: true).SetUploadError("The request seems to be invalid."));
@@ -163,7 +161,7 @@ namespace StardewModdingAPI.Web.Controllers
                 return this.View("Index", this.GetModel(result.ID, schemaName, isEditView: true).SetContent(input, null).SetUploadError(result.UploadError));
 
             // redirect to view
-            return this.Redirect(this.Url.PlainAction("Index", "JsonValidator", new { schemaName, id = result.ID }));
+            return this.Redirect(this.Url.PlainAction("Index", "JsonValidator", new { schemaName, id = result.ID })!);
         }
 
 
@@ -174,14 +172,14 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="pasteID">The stored file ID.</param>
         /// <param name="schemaName">The schema name with which the JSON was validated.</param>
         /// <param name="isEditView">Whether to show the edit view.</param>
-        private JsonValidatorModel GetModel(string pasteID, string schemaName, bool isEditView)
+        private JsonValidatorModel GetModel(string? pasteID, string? schemaName, bool isEditView)
         {
             return new JsonValidatorModel(pasteID, schemaName, this.SchemaFormats, isEditView);
         }
 
         /// <summary>Get a normalized schema name, or the <see cref="DefaultSchemaID"/> if blank.</summary>
         /// <param name="schemaName">The raw schema name to normalize.</param>
-        private string NormalizeSchemaName(string schemaName)
+        private string NormalizeSchemaName(string? schemaName)
         {
             schemaName = schemaName?.Trim().ToLower();
             return !string.IsNullOrWhiteSpace(schemaName)
@@ -191,7 +189,7 @@ namespace StardewModdingAPI.Web.Controllers
 
         /// <summary>Get the schema file given its unique ID.</summary>
         /// <param name="id">The schema ID.</param>
-        private FileInfo FindSchemaFile(string id)
+        private FileInfo? FindSchemaFile(string? id)
         {
             // normalize ID
             id = id?.Trim().ToLower();
@@ -216,13 +214,13 @@ namespace StardewModdingAPI.Web.Controllers
             // skip through transparent errors
             if (this.IsTransparentError(error))
             {
-                foreach (var model in error.ChildErrors.SelectMany(this.GetErrorModels))
+                foreach (JsonValidatorErrorModel model in error.ChildErrors.SelectMany(this.GetErrorModels))
                     yield return model;
                 yield break;
             }
 
             // get message
-            string message = this.GetOverrideError(error);
+            string? message = this.GetOverrideError(error);
             if (message == null || message == this.TransparentToken)
                 message = this.FlattenErrorMessage(error);
 
@@ -236,7 +234,7 @@ namespace StardewModdingAPI.Web.Controllers
         private string FlattenErrorMessage(ValidationError error, int indent = 0)
         {
             // get override
-            string message = this.GetOverrideError(error);
+            string? message = this.GetOverrideError(error);
             if (message != null && message != this.TransparentToken)
                 return message;
 
@@ -257,7 +255,7 @@ namespace StardewModdingAPI.Web.Controllers
                     break;
 
                 case ErrorType.Required:
-                    message = $"Missing required fields: {string.Join(", ", (List<string>)error.Value)}.";
+                    message = $"Missing required fields: {string.Join(", ", (List<string>)error.Value!)}.";
                     break;
             }
 
@@ -274,7 +272,7 @@ namespace StardewModdingAPI.Web.Controllers
             if (!error.ChildErrors.Any())
                 return false;
 
-            string @override = this.GetOverrideError(error);
+            string? @override = this.GetOverrideError(error);
             return
                 @override == this.TransparentToken
                 || (error.ErrorType == ErrorType.Then && @override == null);
@@ -282,18 +280,18 @@ namespace StardewModdingAPI.Web.Controllers
 
         /// <summary>Get an override error from the JSON schema, if any.</summary>
         /// <param name="error">The schema validation error.</param>
-        private string GetOverrideError(ValidationError error)
+        private string? GetOverrideError(ValidationError error)
         {
-            string GetRawOverrideError()
+            string? GetRawOverrideError()
             {
                 // get override errors
-                IDictionary<string, string> errors = this.GetExtensionField<Dictionary<string, string>>(error.Schema, "@errorMessages");
+                IDictionary<string, string?>? errors = this.GetExtensionField<Dictionary<string, string?>>(error.Schema, "@errorMessages");
                 if (errors == null)
                     return null;
-                errors = new Dictionary<string, string>(errors, StringComparer.OrdinalIgnoreCase);
+                errors = new Dictionary<string, string?>(errors, StringComparer.OrdinalIgnoreCase);
 
                 // match error by type and message
-                foreach ((string target, string errorMessage) in errors)
+                foreach ((string target, string? errorMessage) in errors)
                 {
                     if (!target.Contains(":"))
                         continue;
@@ -304,7 +302,7 @@ namespace StardewModdingAPI.Web.Controllers
                 }
 
                 // match by type
-                return errors.TryGetValue(error.ErrorType.ToString(), out string message)
+                return errors.TryGetValue(error.ErrorType.ToString(), out string? message)
                     ? message?.Trim()
                     : null;
             }
@@ -317,7 +315,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <typeparam name="T">The field type.</typeparam>
         /// <param name="schema">The schema whose extension fields to search.</param>
         /// <param name="key">The case-insensitive field key.</param>
-        private T GetExtensionField<T>(JSchema schema, string key)
+        private T? GetExtensionField<T>(JSchema schema, string key)
         {
             foreach ((string curKey, JToken value) in schema.ExtensionData)
             {
@@ -330,7 +328,7 @@ namespace StardewModdingAPI.Web.Controllers
 
         /// <summary>Format a schema value for display.</summary>
         /// <param name="value">The value to format.</param>
-        private string FormatValue(object value)
+        private string FormatValue(object? value)
         {
             return value switch
             {
diff --git a/src/SMAPI.Web/Controllers/LogParserController.cs b/src/SMAPI.Web/Controllers/LogParserController.cs
index 93f2613e..33af5a81 100644
--- a/src/SMAPI.Web/Controllers/LogParserController.cs
+++ b/src/SMAPI.Web/Controllers/LogParserController.cs
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Web.Controllers
 
                 case LogViewFormat.RawDownload:
                     {
-                        string content = file.Error ?? file.Content;
+                        string content = file.Error ?? file.Content ?? string.Empty;
                         return this.File(Encoding.UTF8.GetBytes(content), "plain/text", $"SMAPI log ({id}).txt");
                     }
 
@@ -97,7 +97,7 @@ namespace StardewModdingAPI.Web.Controllers
                 return this.View("Index", this.GetModel(null, uploadError: uploadResult.UploadError));
 
             // redirect to view
-            return this.Redirect(this.Url.PlainAction("Index", "LogParser", new { id = uploadResult.ID }));
+            return this.Redirect(this.Url.PlainAction("Index", "LogParser", new { id = uploadResult.ID })!);
         }
 
 
@@ -109,7 +109,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="expiry">When the uploaded file will no longer be available.</param>
         /// <param name="uploadWarning">A non-blocking warning while uploading the log.</param>
         /// <param name="uploadError">An error which occurred while uploading the log.</param>
-        private LogParserModel GetModel(string? pasteID, DateTime? expiry = null, string? uploadWarning = null, string? uploadError = null)
+        private LogParserModel GetModel(string? pasteID, DateTimeOffset? expiry = null, string? uploadWarning = null, string? uploadError = null)
         {
             Platform? platform = this.DetectClientPlatform();
 
diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index 3dc1e366..401bba4f 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
@@ -78,7 +77,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="model">The mod search criteria.</param>
         /// <param name="version">The requested API version.</param>
         [HttpPost]
-        public async Task<IEnumerable<ModEntryModel>> PostAsync([FromBody] ModSearchModel model, [FromRoute] string version)
+        public async Task<IEnumerable<ModEntryModel>> PostAsync([FromBody] ModSearchModel? model, [FromRoute] string version)
         {
             if (model?.Mods == null)
                 return Array.Empty<ModEntryModel>();
@@ -94,16 +93,16 @@ namespace StardewModdingAPI.Web.Controllers
                     continue;
 
                 // special case: if this is an update check for the official SMAPI repo, check the Nexus mod page for beta versions
-                if (mod.ID == config.SmapiInfo.ID && mod.UpdateKeys?.Any(key => key == config.SmapiInfo.DefaultUpdateKey) == true && mod.InstalledVersion?.IsPrerelease() == true)
-                    mod.UpdateKeys = mod.UpdateKeys.Concat(config.SmapiInfo.AddBetaUpdateKeys).ToArray();
+                if (mod.ID == config.SmapiInfo.ID && mod.UpdateKeys.Any(key => key == config.SmapiInfo.DefaultUpdateKey) && mod.InstalledVersion?.IsPrerelease() == true)
+                    mod.AddUpdateKeys(config.SmapiInfo.AddBetaUpdateKeys);
 
                 // fetch result
                 ModEntryModel result = await this.GetModData(mod, wikiData, model.IncludeExtendedMetadata, model.ApiVersion);
                 if (!model.IncludeExtendedMetadata && (model.ApiVersion == null || mod.InstalledVersion == null))
                 {
-                    var errors = new List<string>(result.Errors);
-                    errors.Add($"This API can't suggest an update because {nameof(model.ApiVersion)} or {nameof(mod.InstalledVersion)} are null, and you didn't specify {nameof(model.IncludeExtendedMetadata)} to get other info. See the SMAPI technical docs for usage.");
-                    result.Errors = errors.ToArray();
+                    result.Errors = result.Errors
+                        .Concat(new[] { $"This API can't suggest an update because {nameof(model.ApiVersion)} or {nameof(mod.InstalledVersion)} are null, and you didn't specify {nameof(model.IncludeExtendedMetadata)} to get other info. See the SMAPI technical docs for usage." })
+                        .ToArray();
                 }
 
                 mods[mod.ID] = result;
@@ -123,26 +122,26 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="includeExtendedMetadata">Whether to include extended metadata for each mod.</param>
         /// <param name="apiVersion">The SMAPI version installed by the player.</param>
         /// <returns>Returns the mod data if found, else <c>null</c>.</returns>
-        private async Task<ModEntryModel> GetModData(ModSearchEntryModel search, WikiModEntry[] wikiData, bool includeExtendedMetadata, ISemanticVersion apiVersion)
+        private async Task<ModEntryModel> GetModData(ModSearchEntryModel search, WikiModEntry[] wikiData, bool includeExtendedMetadata, ISemanticVersion? apiVersion)
         {
             // cross-reference data
-            ModDataRecord record = this.ModDatabase.Get(search.ID);
-            WikiModEntry wikiEntry = wikiData.FirstOrDefault(entry => entry.ID.Contains(search.ID.Trim(), StringComparer.OrdinalIgnoreCase));
+            ModDataRecord? record = this.ModDatabase.Get(search.ID);
+            WikiModEntry? wikiEntry = wikiData.FirstOrDefault(entry => entry.ID.Contains(search.ID.Trim(), StringComparer.OrdinalIgnoreCase));
             UpdateKey[] updateKeys = this.GetUpdateKeys(search.UpdateKeys, record, wikiEntry).ToArray();
-            ModOverrideConfig overrides = this.Config.Value.ModOverrides.FirstOrDefault(p => p.ID.Equals(search.ID?.Trim(), StringComparison.OrdinalIgnoreCase));
+            ModOverrideConfig? overrides = this.Config.Value.ModOverrides.FirstOrDefault(p => p.ID.Equals(search.ID.Trim(), StringComparison.OrdinalIgnoreCase));
             bool allowNonStandardVersions = overrides?.AllowNonStandardVersions ?? false;
 
             // SMAPI versions with a '-beta' tag indicate major changes that may need beta mod versions.
             // This doesn't apply to normal prerelease versions which have an '-alpha' tag.
-            bool isSmapiBeta = apiVersion.IsPrerelease() && apiVersion.PrereleaseTag.StartsWith("beta");
+            bool isSmapiBeta = apiVersion != null && apiVersion.IsPrerelease() && apiVersion.PrereleaseTag.StartsWith("beta");
 
             // get latest versions
-            ModEntryModel result = new() { ID = search.ID };
+            ModEntryModel result = new(search.ID);
             IList<string> errors = new List<string>();
-            ModEntryVersionModel main = null;
-            ModEntryVersionModel optional = null;
-            ModEntryVersionModel unofficial = null;
-            ModEntryVersionModel unofficialForBeta = null;
+            ModEntryVersionModel? main = null;
+            ModEntryVersionModel? optional = null;
+            ModEntryVersionModel? unofficial = null;
+            ModEntryVersionModel? unofficialForBeta = null;
             foreach (UpdateKey updateKey in updateKeys)
             {
                 // validate update key
@@ -162,9 +161,9 @@ namespace StardewModdingAPI.Web.Controllers
 
                 // handle versions
                 if (this.IsNewer(data.Version, main?.Version))
-                    main = new ModEntryVersionModel(data.Version, data.Url);
+                    main = new ModEntryVersionModel(data.Version, data.Url!);
                 if (this.IsNewer(data.PreviewVersion, optional?.Version))
-                    optional = new ModEntryVersionModel(data.PreviewVersion, data.Url);
+                    optional = new ModEntryVersionModel(data.PreviewVersion, data.Url!);
             }
 
             // get unofficial version
@@ -172,7 +171,7 @@ namespace StardewModdingAPI.Web.Controllers
                 unofficial = new ModEntryVersionModel(wikiEntry.Compatibility.UnofficialVersion, $"{this.Url.PlainAction("Index", "Mods", absoluteUrl: true)}#{wikiEntry.Anchor}");
 
             // get unofficial version for beta
-            if (wikiEntry?.HasBetaInfo == true)
+            if (wikiEntry is { HasBetaInfo: true })
             {
                 if (wikiEntry.BetaCompatibility.Status == WikiCompatibilityStatus.Unofficial)
                 {
@@ -198,13 +197,13 @@ namespace StardewModdingAPI.Web.Controllers
             if (overrides?.SetUrl != null)
             {
                 if (main != null)
-                    main.Url = overrides.SetUrl;
+                    main = new(main.Version, overrides.SetUrl);
                 if (optional != null)
-                    optional.Url = overrides.SetUrl;
+                    optional = new(optional.Version, overrides.SetUrl);
             }
 
             // get recommended update (if any)
-            ISemanticVersion installedVersion = this.ModSites.GetMappedVersion(search.InstalledVersion?.ToString(), wikiEntry?.Overrides?.ChangeLocalVersions, allowNonStandard: allowNonStandardVersions);
+            ISemanticVersion? installedVersion = this.ModSites.GetMappedVersion(search.InstalledVersion?.ToString(), wikiEntry?.Overrides?.ChangeLocalVersions, allowNonStandard: allowNonStandardVersions);
             if (apiVersion != null && installedVersion != null)
             {
                 // get newer versions
@@ -219,7 +218,7 @@ namespace StardewModdingAPI.Web.Controllers
                     updates.Add(unofficialForBeta);
 
                 // get newest version
-                ModEntryVersionModel newest = null;
+                ModEntryVersionModel? newest = null;
                 foreach (ModEntryVersionModel update in updates)
                 {
                     if (newest == null || update.Version.IsNewerThan(newest.Version))
@@ -245,7 +244,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="currentVersion">The current semantic version.</param>
         /// <param name="newVersion">The target semantic version.</param>
         /// <param name="useBetaChannel">Whether the user enabled the beta channel and should be offered prerelease updates.</param>
-        private bool IsRecommendedUpdate(ISemanticVersion currentVersion, ISemanticVersion newVersion, bool useBetaChannel)
+        private bool IsRecommendedUpdate(ISemanticVersion currentVersion, [NotNullWhen(true)] ISemanticVersion? newVersion, bool useBetaChannel)
         {
             return
                 newVersion != null
@@ -256,7 +255,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <summary>Get whether a <paramref name="current"/> version is newer than an <paramref name="other"/> version.</summary>
         /// <param name="current">The current version.</param>
         /// <param name="other">The other version.</param>
-        private bool IsNewer(ISemanticVersion current, ISemanticVersion other)
+        private bool IsNewer([NotNullWhen(true)] ISemanticVersion? current, ISemanticVersion? other)
         {
             return current != null && (other == null || other.IsOlderThan(current));
         }
@@ -265,17 +264,20 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="updateKey">The namespaced update key.</param>
         /// <param name="allowNonStandardVersions">Whether to allow non-standard versions.</param>
         /// <param name="mapRemoteVersions">The changes to apply to remote versions for update checks.</param>
-        private async Task<ModInfoModel> GetInfoForUpdateKeyAsync(UpdateKey updateKey, bool allowNonStandardVersions, ChangeDescriptor mapRemoteVersions)
+        private async Task<ModInfoModel> GetInfoForUpdateKeyAsync(UpdateKey updateKey, bool allowNonStandardVersions, ChangeDescriptor? mapRemoteVersions)
         {
+            if (!updateKey.LooksValid)
+                return new ModInfoModel().SetError(RemoteModStatus.DoesNotExist, $"Invalid update key '{updateKey}'.");
+
             // get mod page
             IModPage page;
             {
                 bool isCached =
-                    this.ModCache.TryGetMod(updateKey.Site, updateKey.ID, out Cached<IModPage> cachedMod)
+                    this.ModCache.TryGetMod(updateKey.Site, updateKey.ID, out Cached<IModPage>? cachedMod)
                     && !this.ModCache.IsStale(cachedMod.LastUpdated, cachedMod.Data.Status == RemoteModStatus.TemporaryError ? this.Config.Value.ErrorCacheMinutes : this.Config.Value.SuccessCacheMinutes);
 
                 if (isCached)
-                    page = cachedMod.Data;
+                    page = cachedMod!.Data;
                 else
                 {
                     page = await this.ModSites.GetModPageAsync(updateKey);
@@ -291,7 +293,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="specifiedKeys">The specified update keys.</param>
         /// <param name="record">The mod's entry in SMAPI's internal database.</param>
         /// <param name="entry">The mod's entry in the wiki list.</param>
-        private IEnumerable<UpdateKey> GetUpdateKeys(string[] specifiedKeys, ModDataRecord record, WikiModEntry entry)
+        private IEnumerable<UpdateKey> GetUpdateKeys(string[]? specifiedKeys, ModDataRecord? record, WikiModEntry? entry)
         {
             // get unique update keys
             List<UpdateKey> updateKeys = this.GetUnfilteredUpdateKeys(specifiedKeys, record, entry)
@@ -310,7 +312,7 @@ namespace StardewModdingAPI.Web.Controllers
             // if the list has both an update key (like "Nexus:2400") and subkey (like "Nexus:2400@subkey") for the same page, the subkey takes priority
             {
                 var removeKeys = new HashSet<UpdateKey>();
-                foreach (var key in updateKeys)
+                foreach (UpdateKey key in updateKeys)
                 {
                     if (key.Subkey != null)
                         removeKeys.Add(new UpdateKey(key.Site, key.ID, null));
@@ -326,7 +328,7 @@ namespace StardewModdingAPI.Web.Controllers
         /// <param name="specifiedKeys">The specified update keys.</param>
         /// <param name="record">The mod's entry in SMAPI's internal database.</param>
         /// <param name="entry">The mod's entry in the wiki list.</param>
-        private IEnumerable<string> GetUnfilteredUpdateKeys(string[] specifiedKeys, ModDataRecord record, WikiModEntry entry)
+        private IEnumerable<string> GetUnfilteredUpdateKeys(string[]? specifiedKeys, ModDataRecord? record, WikiModEntry? entry)
         {
             // specified update keys
             foreach (string key in specifiedKeys ?? Array.Empty<string>())
@@ -337,7 +339,7 @@ namespace StardewModdingAPI.Web.Controllers
 
             // default update key
             {
-                string defaultKey = record?.GetDefaultUpdateKey();
+                string? defaultKey = record?.GetDefaultUpdateKey();
                 if (!string.IsNullOrWhiteSpace(defaultKey))
                     yield return defaultKey;
             }
diff --git a/src/SMAPI.Web/Controllers/ModsController.cs b/src/SMAPI.Web/Controllers/ModsController.cs
index 5292e1ce..919afa5b 100644
--- a/src/SMAPI.Web/Controllers/ModsController.cs
+++ b/src/SMAPI.Web/Controllers/ModsController.cs
@@ -1,5 +1,4 @@
-#nullable disable
-
+using System;
 using System.Linq;
 using System.Text.RegularExpressions;
 using Microsoft.AspNetCore.Mvc;
@@ -54,8 +53,8 @@ namespace StardewModdingAPI.Web.Controllers
         public ModListModel FetchData()
         {
             // fetch cached data
-            if (!this.Cache.TryGetWikiMetadata(out Cached<WikiMetadata> metadata))
-                return new ModListModel();
+            if (!this.Cache.TryGetWikiMetadata(out Cached<WikiMetadata>? metadata))
+                return new ModListModel(null, null, Array.Empty<ModModel>(), lastUpdated: DateTimeOffset.UtcNow, isStale: true);
 
             // build model
             return new ModListModel(
diff --git a/src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs b/src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs
index 108ceff7..bd414ea2 100644
--- a/src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs
+++ b/src/SMAPI.Web/Framework/AllowLargePostsAttribute.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.AspNetCore.Http.Features;
 using Microsoft.AspNetCore.Mvc.Filters;
@@ -42,7 +40,7 @@ namespace StardewModdingAPI.Web.Framework
         public void OnAuthorization(AuthorizationFilterContext context)
         {
             IFeatureCollection features = context.HttpContext.Features;
-            IFormFeature formFeature = features.Get<IFormFeature>();
+            IFormFeature? formFeature = features.Get<IFormFeature>();
 
             if (formFeature?.Form == null)
             {
diff --git a/src/SMAPI.Web/Framework/Caching/Cached.cs b/src/SMAPI.Web/Framework/Caching/Cached.cs
index aabbf146..b393e1e1 100644
--- a/src/SMAPI.Web/Framework/Caching/Cached.cs
+++ b/src/SMAPI.Web/Framework/Caching/Cached.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Web.Framework.Caching
@@ -12,21 +10,18 @@ namespace StardewModdingAPI.Web.Framework.Caching
         ** Accessors
         *********/
         /// <summary>The cached data.</summary>
-        public T Data { get; set; }
+        public T Data { get; }
 
         /// <summary>When the data was last updated.</summary>
-        public DateTimeOffset LastUpdated { get; set; }
+        public DateTimeOffset LastUpdated { get; }
 
         /// <summary>When the data was last requested through the mod API.</summary>
-        public DateTimeOffset LastRequested { get; set; }
+        public DateTimeOffset LastRequested { get; internal set; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an empty instance.</summary>
-        public Cached() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="data">The cached data.</param>
         public Cached(T data)
diff --git a/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs b/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
index 2020d747..fb74e9da 100644
--- a/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Mods/IModCacheRepository.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
 namespace StardewModdingAPI.Web.Framework.Caching.Mods
@@ -16,7 +15,7 @@ namespace StardewModdingAPI.Web.Framework.Caching.Mods
         /// <param name="id">The mod's unique ID within the <paramref name="site"/>.</param>
         /// <param name="mod">The fetched mod.</param>
         /// <param name="markRequested">Whether to update the mod's 'last requested' date.</param>
-        bool TryGetMod(ModSiteKey site, string id, out Cached<IModPage> mod, bool markRequested = true);
+        bool TryGetMod(ModSiteKey site, string id, [NotNullWhen(true)] out Cached<IModPage>? mod, bool markRequested = true);
 
         /// <summary>Save data fetched for a mod.</summary>
         /// <param name="site">The mod site on which the mod is found.</param>
diff --git a/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs b/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
index 338562d8..4ba0bd20 100644
--- a/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Mods/ModCacheMemoryRepository.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
@@ -25,7 +24,7 @@ namespace StardewModdingAPI.Web.Framework.Caching.Mods
         /// <param name="id">The mod's unique ID within the <paramref name="site"/>.</param>
         /// <param name="mod">The fetched mod.</param>
         /// <param name="markRequested">Whether to update the mod's 'last requested' date.</param>
-        public bool TryGetMod(ModSiteKey site, string id, out Cached<IModPage> mod, bool markRequested = true)
+        public bool TryGetMod(ModSiteKey site, string id, [NotNullWhen(true)] out Cached<IModPage>? mod, bool markRequested = true)
         {
             // get mod
             if (!this.Mods.TryGetValue(this.GetKey(site, id), out var cachedMod))
diff --git a/src/SMAPI.Web/Framework/Caching/Wiki/IWikiCacheRepository.cs b/src/SMAPI.Web/Framework/Caching/Wiki/IWikiCacheRepository.cs
index 6edafddc..b8a0df34 100644
--- a/src/SMAPI.Web/Framework/Caching/Wiki/IWikiCacheRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Wiki/IWikiCacheRepository.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
 
 namespace StardewModdingAPI.Web.Framework.Caching.Wiki
@@ -14,16 +13,16 @@ namespace StardewModdingAPI.Web.Framework.Caching.Wiki
         *********/
         /// <summary>Get the cached wiki metadata.</summary>
         /// <param name="metadata">The fetched metadata.</param>
-        bool TryGetWikiMetadata(out Cached<WikiMetadata> metadata);
+        bool TryGetWikiMetadata([NotNullWhen(true)] out Cached<WikiMetadata>? metadata);
 
         /// <summary>Get the cached wiki mods.</summary>
         /// <param name="filter">A filter to apply, if any.</param>
-        IEnumerable<Cached<WikiModEntry>> GetWikiMods(Func<WikiModEntry, bool> filter = null);
+        IEnumerable<Cached<WikiModEntry>> GetWikiMods(Func<WikiModEntry, bool>? filter = null);
 
         /// <summary>Save data fetched from the wiki compatibility list.</summary>
         /// <param name="stableVersion">The current stable Stardew Valley version.</param>
         /// <param name="betaVersion">The current beta Stardew Valley version.</param>
         /// <param name="mods">The mod data.</param>
-        void SaveWikiData(string stableVersion, string betaVersion, IEnumerable<WikiModEntry> mods);
+        void SaveWikiData(string? stableVersion, string? betaVersion, IEnumerable<WikiModEntry> mods);
     }
 }
diff --git a/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs b/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
index d1ccb9c7..8b4338e2 100644
--- a/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
+++ b/src/SMAPI.Web/Framework/Caching/Wiki/WikiCacheMemoryRepository.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
 
@@ -14,7 +13,7 @@ namespace StardewModdingAPI.Web.Framework.Caching.Wiki
         ** Fields
         *********/
         /// <summary>The saved wiki metadata.</summary>
-        private Cached<WikiMetadata> Metadata;
+        private Cached<WikiMetadata>? Metadata;
 
         /// <summary>The cached wiki data.</summary>
         private Cached<WikiModEntry>[] Mods = Array.Empty<Cached<WikiModEntry>>();
@@ -25,7 +24,7 @@ namespace StardewModdingAPI.Web.Framework.Caching.Wiki
         *********/
         /// <summary>Get the cached wiki metadata.</summary>
         /// <param name="metadata">The fetched metadata.</param>
-        public bool TryGetWikiMetadata(out Cached<WikiMetadata> metadata)
+        public bool TryGetWikiMetadata([NotNullWhen(true)] out Cached<WikiMetadata>? metadata)
         {
             metadata = this.Metadata;
             return metadata != null;
@@ -33,7 +32,7 @@ namespace StardewModdingAPI.Web.Framework.Caching.Wiki
 
         /// <summary>Get the cached wiki mods.</summary>
         /// <param name="filter">A filter to apply, if any.</param>
-        public IEnumerable<Cached<WikiModEntry>> GetWikiMods(Func<WikiModEntry, bool> filter = null)
+        public IEnumerable<Cached<WikiModEntry>> GetWikiMods(Func<WikiModEntry, bool>? filter = null)
         {
             foreach (var mod in this.Mods)
             {
@@ -46,7 +45,7 @@ namespace StardewModdingAPI.Web.Framework.Caching.Wiki
         /// <param name="stableVersion">The current stable Stardew Valley version.</param>
         /// <param name="betaVersion">The current beta Stardew Valley version.</param>
         /// <param name="mods">The mod data.</param>
-        public void SaveWikiData(string stableVersion, string betaVersion, IEnumerable<WikiModEntry> mods)
+        public void SaveWikiData(string? stableVersion, string? betaVersion, IEnumerable<WikiModEntry> mods)
         {
             this.Metadata = new Cached<WikiMetadata>(new WikiMetadata(stableVersion, betaVersion));
             this.Mods = mods.Select(mod => new Cached<WikiModEntry>(mod)).ToArray();
diff --git a/src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs b/src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs
index 6ae42488..f53ea201 100644
--- a/src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs
+++ b/src/SMAPI.Web/Framework/Caching/Wiki/WikiMetadata.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.Caching.Wiki
 {
     /// <summary>The model for cached wiki metadata.</summary>
@@ -9,22 +7,19 @@ namespace StardewModdingAPI.Web.Framework.Caching.Wiki
         ** Accessors
         *********/
         /// <summary>The current stable Stardew Valley version.</summary>
-        public string StableVersion { get; set; }
+        public string? StableVersion { get; }
 
         /// <summary>The current beta Stardew Valley version.</summary>
-        public string BetaVersion { get; set; }
+        public string? BetaVersion { get; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public WikiMetadata() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="stableVersion">The current stable Stardew Valley version.</param>
         /// <param name="betaVersion">The current beta Stardew Valley version.</param>
-        public WikiMetadata(string stableVersion, string betaVersion)
+        public WikiMetadata(string? stableVersion, string? betaVersion)
         {
             this.StableVersion = stableVersion;
             this.BetaVersion = betaVersion;
diff --git a/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs b/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
index 4d041c1b..ce0f1122 100644
--- a/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Chucklefish/ChucklefishClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Net;
 using System.Threading.Tasks;
@@ -44,7 +42,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Chucklefish
 
         /// <summary>Get update check info about a mod.</summary>
         /// <param name="id">The mod ID.</param>
-        public async Task<IModPage> GetModData(string id)
+        public async Task<IModPage?> GetModData(string id)
         {
             IModPage page = new GenericModPage(this.SiteKey, id);
 
@@ -53,7 +51,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Chucklefish
                 return page.SetError(RemoteModStatus.DoesNotExist, $"The value '{id}' isn't a valid Chucklefish mod ID, must be an integer ID.");
 
             // fetch HTML
-            string html;
+            string? html;
             try
             {
                 html = await this.Client
@@ -69,7 +67,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Chucklefish
 
             // extract mod info
             string url = this.GetModUrl(parsedId);
-            string version = doc.DocumentNode.SelectSingleNode("//h1/span")?.InnerText;
+            string? version = doc.DocumentNode.SelectSingleNode("//h1/span")?.InnerText;
             string name = doc.DocumentNode.SelectSingleNode("//h1").ChildNodes[0].InnerText.Trim();
             if (name.StartsWith("[SMAPI]"))
                 name = name.Substring("[SMAPI]".Length).TrimStart();
@@ -81,7 +79,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Chucklefish
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         public void Dispose()
         {
-            this.Client?.Dispose();
+            this.Client.Dispose();
         }
 
 
@@ -92,7 +90,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Chucklefish
         /// <param name="id">The mod ID.</param>
         private string GetModUrl(uint id)
         {
-            UriBuilder builder = new(this.Client.BaseClient.BaseAddress);
+            UriBuilder builder = new(this.Client.BaseClient.BaseAddress!);
             builder.Path += string.Format(this.ModPageUrlFormat, id);
             return builder.Uri.ToString();
         }
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
index 5ef369d5..d351b42d 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Text.RegularExpressions;
 using System.Threading.Tasks;
@@ -42,7 +40,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.CurseForge
 
         /// <summary>Get update check info about a mod.</summary>
         /// <param name="id">The mod ID.</param>
-        public async Task<IModPage> GetModData(string id)
+        public async Task<IModPage?> GetModData(string id)
         {
             IModPage page = new GenericModPage(this.SiteKey, id);
 
@@ -51,9 +49,9 @@ namespace StardewModdingAPI.Web.Framework.Clients.CurseForge
                 return page.SetError(RemoteModStatus.DoesNotExist, $"The value '{id}' isn't a valid CurseForge mod ID, must be an integer ID.");
 
             // get raw data
-            ModModel mod = await this.Client
+            ModModel? mod = await this.Client
                 .GetAsync($"addon/{parsedId}")
-                .As<ModModel>();
+                .As<ModModel?>();
             if (mod == null)
                 return page.SetError(RemoteModStatus.DoesNotExist, "Found no CurseForge mod with this ID.");
 
@@ -73,7 +71,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.CurseForge
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         public void Dispose()
         {
-            this.Client?.Dispose();
+            this.Client.Dispose();
         }
 
 
@@ -82,9 +80,9 @@ namespace StardewModdingAPI.Web.Framework.Clients.CurseForge
         *********/
         /// <summary>Get a raw version string for a mod file, if available.</summary>
         /// <param name="file">The file whose version to get.</param>
-        private string GetRawVersion(ModFileModel file)
+        private string? GetRawVersion(ModFileModel file)
         {
-            Match match = this.VersionInNamePattern.Match(file.DisplayName);
+            Match match = this.VersionInNamePattern.Match(file.DisplayName ?? "");
             if (!match.Success)
                 match = this.VersionInNamePattern.Match(file.FileName);
 
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModFileModel.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModFileModel.cs
index eabef9f0..e9adcf20 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModFileModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModFileModel.cs
@@ -1,14 +1,28 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.Clients.CurseForge.ResponseModels
 {
     /// <summary>Metadata from the CurseForge API about a mod file.</summary>
     public class ModFileModel
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The file name as downloaded.</summary>
-        public string FileName { get; set; }
+        public string FileName { get; }
 
         /// <summary>The file display name.</summary>
-        public string DisplayName { get; set; }
+        public string? DisplayName { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="fileName">The file name as downloaded.</param>
+        /// <param name="displayName">The file display name.</param>
+        public ModFileModel(string fileName, string? displayName)
+        {
+            this.FileName = fileName;
+            this.DisplayName = displayName;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
index a95df7f1..fd7796f2 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
@@ -1,20 +1,38 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.Clients.CurseForge.ResponseModels
 {
     /// <summary>An mod from the CurseForge API.</summary>
     public class ModModel
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The mod's unique ID on CurseForge.</summary>
-        public int ID { get; set; }
+        public int ID { get; }
 
         /// <summary>The mod name.</summary>
-        public string Name { get; set; }
+        public string Name { get; }
 
         /// <summary>The web URL for the mod page.</summary>
-        public string WebsiteUrl { get; set; }
+        public string WebsiteUrl { get; }
 
         /// <summary>The available file downloads.</summary>
-        public ModFileModel[] LatestFiles { get; set; }
+        public ModFileModel[] LatestFiles { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="id">The mod's unique ID on CurseForge.</param>
+        /// <param name="name">The mod name.</param>
+        /// <param name="websiteUrl">The web URL for the mod page.</param>
+        /// <param name="latestFiles">The available file downloads.</param>
+        public ModModel(int id, string name, string websiteUrl, ModFileModel[] latestFiles)
+        {
+            this.ID = id;
+            this.Name = name;
+            this.WebsiteUrl = websiteUrl;
+            this.LatestFiles = latestFiles;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/GenericModDownload.cs b/src/SMAPI.Web/Framework/Clients/GenericModDownload.cs
index 919072b0..548f17c3 100644
--- a/src/SMAPI.Web/Framework/Clients/GenericModDownload.cs
+++ b/src/SMAPI.Web/Framework/Clients/GenericModDownload.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.Clients
 {
     /// <summary>Generic metadata about a file download on a mod page.</summary>
@@ -9,26 +7,23 @@ namespace StardewModdingAPI.Web.Framework.Clients
         ** Accessors
         *********/
         /// <summary>The download's display name.</summary>
-        public string Name { get; set; }
+        public string Name { get; }
 
         /// <summary>The download's description.</summary>
-        public string Description { get; set; }
+        public string? Description { get; }
 
         /// <summary>The download's file version.</summary>
-        public string Version { get; set; }
+        public string? Version { get; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an empty instance.</summary>
-        public GenericModDownload() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="name">The download's display name.</param>
         /// <param name="description">The download's description.</param>
         /// <param name="version">The download's file version.</param>
-        public GenericModDownload(string name, string description, string version)
+        public GenericModDownload(string name, string? description, string? version)
         {
             this.Name = name;
             this.Description = description;
diff --git a/src/SMAPI.Web/Framework/Clients/GenericModPage.cs b/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
index 4788aa2a..5353c7e1 100644
--- a/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
+++ b/src/SMAPI.Web/Framework/Clients/GenericModPage.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
@@ -20,30 +19,31 @@ namespace StardewModdingAPI.Web.Framework.Clients
         public string Id { get; set; }
 
         /// <summary>The mod name.</summary>
-        public string Name { get; set; }
+        public string? Name { get; set; }
 
         /// <summary>The mod's semantic version number.</summary>
-        public string Version { get; set; }
+        public string? Version { get; set; }
 
         /// <summary>The mod's web URL.</summary>
-        public string Url { get; set; }
+        public string? Url { get; set; }
 
         /// <summary>The mod downloads.</summary>
         public IModDownload[] Downloads { get; set; } = Array.Empty<IModDownload>();
 
         /// <summary>The mod availability status on the remote site.</summary>
-        public RemoteModStatus Status { get; set; } = RemoteModStatus.Ok;
+        public RemoteModStatus Status { get; set; } = RemoteModStatus.InvalidData;
 
         /// <summary>A user-friendly error which indicates why fetching the mod info failed (if applicable).</summary>
-        public string Error { get; set; }
+        public string? Error { get; set; }
+
+        /// <summary>Whether the mod data is valid.</summary>
+        [MemberNotNullWhen(true, nameof(IModPage.Name), nameof(IModPage.Url))]
+        public bool IsValid => this.Status == RemoteModStatus.Ok;
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an empty instance.</summary>
-        public GenericModPage() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="site">The mod site containing the mod.</param>
         /// <param name="id">The mod's unique ID within the site.</param>
@@ -58,12 +58,13 @@ namespace StardewModdingAPI.Web.Framework.Clients
         /// <param name="version">The mod's semantic version number.</param>
         /// <param name="url">The mod's web URL.</param>
         /// <param name="downloads">The mod downloads.</param>
-        public IModPage SetInfo(string name, string version, string url, IEnumerable<IModDownload> downloads)
+        public IModPage SetInfo(string name, string? version, string url, IEnumerable<IModDownload> downloads)
         {
             this.Name = name;
             this.Version = version;
             this.Url = url;
             this.Downloads = downloads.ToArray();
+            this.Status = RemoteModStatus.Ok;
 
             return this;
         }
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs
index 39ebf94e..dbce9368 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitAsset.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.GitHub
@@ -7,16 +5,34 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
     /// <summary>A GitHub download attached to a release.</summary>
     internal class GitAsset
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The file name.</summary>
         [JsonProperty("name")]
-        public string FileName { get; set; }
+        public string FileName { get; }
 
         /// <summary>The file content type.</summary>
         [JsonProperty("content_type")]
-        public string ContentType { get; set; }
+        public string ContentType { get; }
 
         /// <summary>The download URL.</summary>
         [JsonProperty("browser_download_url")]
-        public string DownloadUrl { get; set; }
+        public string DownloadUrl { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="fileName">The file name.</param>
+        /// <param name="contentType">The file content type.</param>
+        /// <param name="downloadUrl">The download URL.</param>
+        public GitAsset(string fileName, string contentType, string downloadUrl)
+        {
+            this.FileName = fileName;
+            this.ContentType = contentType;
+            this.DownloadUrl = downloadUrl;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs
index 0e68e2c2..785979a5 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitHubClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Linq;
 using System.Net;
@@ -35,26 +33,26 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
         /// <param name="acceptHeader">The Accept header value expected by the GitHub API.</param>
         /// <param name="username">The username with which to authenticate to the GitHub API.</param>
         /// <param name="password">The password with which to authenticate to the GitHub API.</param>
-        public GitHubClient(string baseUrl, string userAgent, string acceptHeader, string username, string password)
+        public GitHubClient(string baseUrl, string userAgent, string acceptHeader, string? username, string? password)
         {
             this.Client = new FluentClient(baseUrl)
                 .SetUserAgent(userAgent)
                 .AddDefault(req => req.WithHeader("Accept", acceptHeader));
             if (!string.IsNullOrWhiteSpace(username))
-                this.Client = this.Client.SetBasicAuthentication(username, password);
+                this.Client = this.Client.SetBasicAuthentication(username, password!);
         }
 
         /// <summary>Get basic metadata for a GitHub repository, if available.</summary>
         /// <param name="repo">The repository key (like <c>Pathoschild/SMAPI</c>).</param>
         /// <returns>Returns the repository info if it exists, else <c>null</c>.</returns>
-        public async Task<GitRepo> GetRepositoryAsync(string repo)
+        public async Task<GitRepo?> GetRepositoryAsync(string repo)
         {
             this.AssertKeyFormat(repo);
             try
             {
                 return await this.Client
                     .GetAsync($"repos/{repo}")
-                    .As<GitRepo>();
+                    .As<GitRepo?>();
             }
             catch (ApiException ex) when (ex.Status == HttpStatusCode.NotFound)
             {
@@ -66,7 +64,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
         /// <param name="repo">The repository key (like <c>Pathoschild/SMAPI</c>).</param>
         /// <param name="includePrerelease">Whether to return a prerelease version if it's latest.</param>
         /// <returns>Returns the release if found, else <c>null</c>.</returns>
-        public async Task<GitRelease> GetLatestReleaseAsync(string repo, bool includePrerelease = false)
+        public async Task<GitRelease?> GetLatestReleaseAsync(string repo, bool includePrerelease = false)
         {
             this.AssertKeyFormat(repo);
             try
@@ -81,7 +79,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
 
                 return await this.Client
                     .GetAsync($"repos/{repo}/releases/latest")
-                    .As<GitRelease>();
+                    .As<GitRelease?>();
             }
             catch (ApiException ex) when (ex.Status == HttpStatusCode.NotFound)
             {
@@ -91,7 +89,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
 
         /// <summary>Get update check info about a mod.</summary>
         /// <param name="id">The mod ID.</param>
-        public async Task<IModPage> GetModData(string id)
+        public async Task<IModPage?> GetModData(string id)
         {
             IModPage page = new GenericModPage(this.SiteKey, id);
 
@@ -99,15 +97,15 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
                 return page.SetError(RemoteModStatus.DoesNotExist, $"The value '{id}' isn't a valid GitHub mod ID, must be a username and project name like 'Pathoschild/SMAPI'.");
 
             // fetch repo info
-            GitRepo repository = await this.GetRepositoryAsync(id);
+            GitRepo? repository = await this.GetRepositoryAsync(id);
             if (repository == null)
                 return page.SetError(RemoteModStatus.DoesNotExist, "Found no GitHub repository for this ID.");
             string name = repository.FullName;
             string url = $"{repository.WebUrl}/releases";
 
             // get releases
-            GitRelease latest;
-            GitRelease preview;
+            GitRelease? latest;
+            GitRelease? preview;
             {
                 // get latest release (whether preview or stable)
                 latest = await this.GetLatestReleaseAsync(id, includePrerelease: true);
@@ -118,7 +116,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
                 preview = null;
                 if (latest.IsPrerelease)
                 {
-                    GitRelease release = await this.GetLatestReleaseAsync(id, includePrerelease: false);
+                    GitRelease? release = await this.GetLatestReleaseAsync(id, includePrerelease: false);
                     if (release != null)
                     {
                         preview = latest;
@@ -129,8 +127,8 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
 
             // get downloads
             IModDownload[] downloads = new[] { latest, preview }
-                .Where(release => release != null)
-                .Select(release => (IModDownload)new GenericModDownload(release.Name, release.Body, release.Tag))
+                .Where(release => release is not null)
+                .Select(release => (IModDownload)new GenericModDownload(release!.Name, release.Body, release.Tag))
                 .ToArray();
 
             // return info
@@ -140,7 +138,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         public void Dispose()
         {
-            this.Client?.Dispose();
+            this.Client.Dispose();
         }
 
 
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs
index 275c775a..24d6c3c5 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitLicense.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.GitHub
@@ -7,16 +5,34 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
     /// <summary>The license info for a GitHub project.</summary>
     internal class GitLicense
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The license display name.</summary>
         [JsonProperty("name")]
-        public string Name { get; set; }
+        public string Name { get; }
 
         /// <summary>The SPDX ID for the license.</summary>
         [JsonProperty("spdx_id")]
-        public string SpdxId { get; set; }
+        public string SpdxId { get; }
 
         /// <summary>The URL for the license info.</summary>
         [JsonProperty("url")]
-        public string Url { get; set; }
+        public string Url { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="name">The license display name.</param>
+        /// <param name="spdxId">The SPDX ID for the license.</param>
+        /// <param name="url">The URL for the license info.</param>
+        public GitLicense(string name, string spdxId, string url)
+        {
+            this.Name = name;
+            this.SpdxId = spdxId;
+            this.Url = url;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs
index 383775d2..9de6f020 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitRelease.cs
@@ -1,5 +1,4 @@
-#nullable disable
-
+using System;
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.GitHub
@@ -12,24 +11,45 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
         *********/
         /// <summary>The display name.</summary>
         [JsonProperty("name")]
-        public string Name { get; set; }
+        public string Name { get; }
 
         /// <summary>The semantic version string.</summary>
         [JsonProperty("tag_name")]
-        public string Tag { get; set; }
+        public string Tag { get; }
 
         /// <summary>The Markdown description for the release.</summary>
-        public string Body { get; set; }
+        public string Body { get; internal set; }
 
         /// <summary>Whether this is a draft version.</summary>
         [JsonProperty("draft")]
-        public bool IsDraft { get; set; }
+        public bool IsDraft { get; }
 
         /// <summary>Whether this is a prerelease version.</summary>
         [JsonProperty("prerelease")]
-        public bool IsPrerelease { get; set; }
+        public bool IsPrerelease { get; }
 
         /// <summary>The attached files.</summary>
-        public GitAsset[] Assets { get; set; }
+        public GitAsset[] Assets { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="name">The display name.</param>
+        /// <param name="tag">The semantic version string.</param>
+        /// <param name="body">The Markdown description for the release.</param>
+        /// <param name="isDraft">Whether this is a draft version.</param>
+        /// <param name="isPrerelease">Whether this is a prerelease version.</param>
+        /// <param name="assets">The attached files.</param>
+        public GitRelease(string name, string tag, string? body, bool isDraft, bool isPrerelease, GitAsset[]? assets)
+        {
+            this.Name = name;
+            this.Tag = tag;
+            this.Body = body ?? string.Empty;
+            this.IsDraft = isDraft;
+            this.IsPrerelease = isPrerelease;
+            this.Assets = assets ?? Array.Empty<GitAsset>();
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs b/src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs
index 5b5ce6a6..879b5e49 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/GitRepo.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.GitHub
@@ -7,16 +5,34 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
     /// <summary>Basic metadata about a GitHub project.</summary>
     internal class GitRepo
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The full repository name, including the owner.</summary>
         [JsonProperty("full_name")]
-        public string FullName { get; set; }
+        public string FullName { get; }
 
         /// <summary>The URL to the repository web page, if any.</summary>
         [JsonProperty("html_url")]
-        public string WebUrl { get; set; }
+        public string? WebUrl { get; }
 
         /// <summary>The code license, if any.</summary>
         [JsonProperty("license")]
-        public GitLicense License { get; set; }
+        public GitLicense? License { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="fullName">The full repository name, including the owner.</param>
+        /// <param name="webUrl">The URL to the repository web page, if any.</param>
+        /// <param name="license">The code license, if any.</param>
+        public GitRepo(string fullName, string? webUrl, GitLicense? license)
+        {
+            this.FullName = fullName;
+            this.WebUrl = webUrl;
+            this.License = license;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs b/src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs
index e1961416..886e32d3 100644
--- a/src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/GitHub/IGitHubClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Threading.Tasks;
 
@@ -14,12 +12,12 @@ namespace StardewModdingAPI.Web.Framework.Clients.GitHub
         /// <summary>Get basic metadata for a GitHub repository, if available.</summary>
         /// <param name="repo">The repository key (like <c>Pathoschild/SMAPI</c>).</param>
         /// <returns>Returns the repository info if it exists, else <c>null</c>.</returns>
-        Task<GitRepo> GetRepositoryAsync(string repo);
+        Task<GitRepo?> GetRepositoryAsync(string repo);
 
         /// <summary>Get the latest release for a GitHub repository.</summary>
         /// <param name="repo">The repository key (like <c>Pathoschild/SMAPI</c>).</param>
         /// <param name="includePrerelease">Whether to return a prerelease version if it's latest.</param>
         /// <returns>Returns the release if found, else <c>null</c>.</returns>
-        Task<GitRelease> GetLatestReleaseAsync(string repo, bool includePrerelease = false);
+        Task<GitRelease?> GetLatestReleaseAsync(string repo, bool includePrerelease = false);
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/IModSiteClient.cs b/src/SMAPI.Web/Framework/Clients/IModSiteClient.cs
index 2cd1f635..3697ffae 100644
--- a/src/SMAPI.Web/Framework/Clients/IModSiteClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/IModSiteClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Threading.Tasks;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
@@ -20,6 +18,6 @@ namespace StardewModdingAPI.Web.Framework.Clients
         *********/
         /// <summary>Get update check info about a mod.</summary>
         /// <param name="id">The mod ID.</param>
-        Task<IModPage> GetModData(string id);
+        Task<IModPage?> GetModData(string id);
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
index 1a11a606..c60b2c90 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Threading.Tasks;
 using Pathoschild.Http.Client;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
@@ -43,9 +42,10 @@ namespace StardewModdingAPI.Web.Framework.Clients.ModDrop
 
         /// <summary>Get update check info about a mod.</summary>
         /// <param name="id">The mod ID.</param>
-        public async Task<IModPage> GetModData(string id)
+        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The nullability is validated in this method.")]
+        public async Task<IModPage?> GetModData(string id)
         {
-            var page = new GenericModPage(this.SiteKey, id);
+            IModPage page = new GenericModPage(this.SiteKey, id);
 
             if (!long.TryParse(id, out long parsedId))
                 return page.SetError(RemoteModStatus.DoesNotExist, $"The value '{id}' isn't a valid ModDrop mod ID, must be an integer ID.");
@@ -60,9 +60,11 @@ namespace StardewModdingAPI.Web.Framework.Clients.ModDrop
                     Mods = true
                 })
                 .As<ModListModel>();
-            ModModel mod = response.Mods[parsedId];
-            if (mod.Mod?.Title == null || mod.Mod.ErrorCode.HasValue)
-                return null;
+
+            if (!response.Mods.TryGetValue(parsedId, out ModModel? mod) || mod?.Mod is null)
+                return page.SetError(RemoteModStatus.DoesNotExist, "Found no ModDrop page with this ID.");
+            if (mod.Mod.ErrorCode is not null)
+                return page.SetError(RemoteModStatus.InvalidData, $"ModDrop returned error code {mod.Mod.ErrorCode} for mod ID '{id}'.");
 
             // get files
             var downloads = new List<IModDownload>();
@@ -77,7 +79,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.ModDrop
             }
 
             // return info
-            string name = mod.Mod?.Title;
+            string name = mod.Mod.Title;
             string url = string.Format(this.ModUrlFormat, id);
             return page.SetInfo(name: name, version: null, url: url, downloads: downloads);
         }
@@ -85,7 +87,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.ModDrop
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         public void Dispose()
         {
-            this.Client?.Dispose();
+            this.Client.Dispose();
         }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/FileDataModel.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/FileDataModel.cs
index dd6a95e0..31905338 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/FileDataModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/FileDataModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
@@ -7,27 +5,53 @@ namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
     /// <summary>Metadata from the ModDrop API about a mod file.</summary>
     public class FileDataModel
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The file title.</summary>
         [JsonProperty("title")]
-        public string Name { get; set; }
+        public string Name { get; }
 
         /// <summary>The file description.</summary>
         [JsonProperty("desc")]
-        public string Description { get; set; }
+        public string Description { get; }
 
         /// <summary>The file version.</summary>
-        public string Version { get; set; }
+        public string Version { get; }
 
         /// <summary>Whether the file is deleted.</summary>
-        public bool IsDeleted { get; set; }
+        public bool IsDeleted { get; }
 
         /// <summary>Whether the file is hidden from users.</summary>
-        public bool IsHidden { get; set; }
+        public bool IsHidden { get; }
 
         /// <summary>Whether this is the default file for the mod.</summary>
-        public bool IsDefault { get; set; }
+        public bool IsDefault { get; }
 
         /// <summary>Whether this is an archived file.</summary>
-        public bool IsOld { get; set; }
+        public bool IsOld { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="name">The file title.</param>
+        /// <param name="description">The file description.</param>
+        /// <param name="version">The file version.</param>
+        /// <param name="isDeleted">Whether the file is deleted.</param>
+        /// <param name="isHidden">Whether the file is hidden from users.</param>
+        /// <param name="isDefault">Whether this is the default file for the mod.</param>
+        /// <param name="isOld">Whether this is an archived file.</param>
+        public FileDataModel(string name, string description, string version, bool isDeleted, bool isHidden, bool isDefault, bool isOld)
+        {
+            this.Name = name;
+            this.Description = description;
+            this.Version = version;
+            this.IsDeleted = isDeleted;
+            this.IsHidden = isHidden;
+            this.IsDefault = isDefault;
+            this.IsOld = isOld;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModDataModel.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModDataModel.cs
index 6cae16d9..0654b576 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModDataModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModDataModel.cs
@@ -1,17 +1,33 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
 {
     /// <summary>Metadata about a mod from the ModDrop API.</summary>
     public class ModDataModel
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The mod's unique ID on ModDrop.</summary>
         public int ID { get; set; }
 
+        /// <summary>The mod name.</summary>
+        public string Title { get; set; }
+
         /// <summary>The error code, if any.</summary>
         public int? ErrorCode { get; set; }
 
-        /// <summary>The mod name.</summary>
-        public string Title { get; set; }
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="id">The mod's unique ID on ModDrop.</param>
+        /// <param name="title">The mod name.</param>
+        /// <param name="errorCode">The error code, if any.</param>
+        public ModDataModel(int id, string title, int? errorCode)
+        {
+            this.ID = id;
+            this.Title = title;
+            this.ErrorCode = errorCode;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModListModel.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModListModel.cs
index 445e25cb..cb4be35c 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModListModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModListModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
@@ -7,7 +5,10 @@ namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
     /// <summary>A list of mods from the ModDrop API.</summary>
     public class ModListModel
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The mod data.</summary>
-        public IDictionary<long, ModModel> Mods { get; set; }
+        public IDictionary<long, ModModel> Mods { get; } = new Dictionary<long, ModModel>();
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModModel.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModModel.cs
index 8869193e..60b818d6 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ResponseModels/ModModel.cs
@@ -1,14 +1,28 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.Clients.ModDrop.ResponseModels
 {
     /// <summary>An entry in a mod list from the ModDrop API.</summary>
     public class ModModel
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The available file downloads.</summary>
-        public FileDataModel[] Files { get; set; }
+        public FileDataModel[] Files { get; }
 
         /// <summary>The mod metadata.</summary>
-        public ModDataModel Mod { get; set; }
+        public ModDataModel Mod { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="files">The available file downloads.</param>
+        /// <param name="mod">The mod metadata.</param>
+        public ModModel(FileDataModel[] files, ModDataModel mod)
+        {
+            this.Files = files;
+            this.Mod = mod;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
index dd0bb94f..23b25f95 100644
--- a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -61,7 +59,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
 
         /// <summary>Get update check info about a mod.</summary>
         /// <param name="id">The mod ID.</param>
-        public async Task<IModPage> GetModData(string id)
+        public async Task<IModPage?> GetModData(string id)
         {
             IModPage page = new GenericModPage(this.SiteKey, id);
 
@@ -72,7 +70,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
             // adult content are hidden for anonymous users, so fall back to the API in that case.
             // Note that the API has very restrictive rate limits which means we can't just use it
             // for all cases.
-            NexusMod mod = await this.GetModFromWebsiteAsync(parsedId);
+            NexusMod? mod = await this.GetModFromWebsiteAsync(parsedId);
             if (mod?.Status == NexusModStatus.AdultContentForbidden)
                 mod = await this.GetModFromApiAsync(parsedId);
 
@@ -81,16 +79,16 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
                 return page.SetError(RemoteModStatus.DoesNotExist, "Found no Nexus mod with this ID.");
 
             // return info
-            page.SetInfo(name: mod.Name, url: mod.Url, version: mod.Version, downloads: mod.Downloads);
+            page.SetInfo(name: mod.Name ?? parsedId.ToString(), url: mod.Url ?? this.GetModUrl(parsedId), version: mod.Version, downloads: mod.Downloads);
             if (mod.Status != NexusModStatus.Ok)
-                page.SetError(RemoteModStatus.TemporaryError, mod.Error);
+                page.SetError(RemoteModStatus.TemporaryError, mod.Error!);
             return page;
         }
 
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         public void Dispose()
         {
-            this.WebClient?.Dispose();
+            this.WebClient.Dispose();
         }
 
 
@@ -100,7 +98,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
         /// <summary>Get metadata about a mod by scraping the Nexus website.</summary>
         /// <param name="id">The Nexus mod ID.</param>
         /// <returns>Returns the mod info if found, else <c>null</c>.</returns>
-        private async Task<NexusMod> GetModFromWebsiteAsync(uint id)
+        private async Task<NexusMod?> GetModFromWebsiteAsync(uint id)
         {
             // fetch HTML
             string html;
@@ -116,35 +114,38 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
             }
 
             // parse HTML
-            var doc = new HtmlDocument();
+            HtmlDocument doc = new();
             doc.LoadHtml(html);
 
             // handle Nexus error message
-            HtmlNode node = doc.DocumentNode.SelectSingleNode("//div[contains(@class, 'site-notice')][contains(@class, 'warning')]");
+            HtmlNode? node = doc.DocumentNode.SelectSingleNode("//div[contains(@class, 'site-notice')][contains(@class, 'warning')]");
             if (node != null)
             {
                 string[] errorParts = node.InnerText.Trim().Split(new[] { '\n' }, 2, System.StringSplitOptions.RemoveEmptyEntries);
                 string errorCode = errorParts[0];
-                string errorText = errorParts.Length > 1 ? errorParts[1] : null;
+                string? errorText = errorParts.Length > 1 ? errorParts[1] : null;
                 switch (errorCode.Trim().ToLower())
                 {
                     case "not found":
                         return null;
 
                     default:
-                        return new NexusMod { Error = $"Nexus error: {errorCode} ({errorText}).", Status = this.GetWebStatus(errorCode) };
+                        return new NexusMod(
+                            status: this.GetWebStatus(errorCode),
+                            error: $"Nexus error: {errorCode} ({errorText})."
+                        );
                 }
             }
 
             // extract mod info
             string url = this.GetModUrl(id);
-            string name = doc.DocumentNode.SelectSingleNode("//div[@id='pagetitle']//h1")?.InnerText.Trim();
-            string version = doc.DocumentNode.SelectSingleNode("//ul[contains(@class, 'stats')]//li[@class='stat-version']//div[@class='stat']")?.InnerText.Trim();
-            SemanticVersion.TryParse(version, out ISemanticVersion parsedVersion);
+            string? name = doc.DocumentNode.SelectSingleNode("//div[@id='pagetitle']//h1")?.InnerText.Trim();
+            string? version = doc.DocumentNode.SelectSingleNode("//ul[contains(@class, 'stats')]//li[@class='stat-version']//div[@class='stat']")?.InnerText.Trim();
+            SemanticVersion.TryParse(version, out ISemanticVersion? parsedVersion);
 
             // extract files
             var downloads = new List<IModDownload>();
-            foreach (var fileSection in doc.DocumentNode.SelectNodes("//div[contains(@class, 'files-tabs')]"))
+            foreach (HtmlNode fileSection in doc.DocumentNode.SelectNodes("//div[contains(@class, 'files-tabs')]"))
             {
                 string sectionName = fileSection.Descendants("h2").First().InnerText;
                 if (sectionName != "Main files" && sectionName != "Optional files")
@@ -154,7 +155,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
                 {
                     string fileName = container.GetDataAttribute("name").Value;
                     string fileVersion = container.GetDataAttribute("version").Value;
-                    string description = container.SelectSingleNode("following-sibling::*[1][self::dd]//div").InnerText?.Trim(); // get text of next <dd> tag; derived from https://stackoverflow.com/a/25535623/262123
+                    string? description = container.SelectSingleNode("following-sibling::*[1][self::dd]//div").InnerText?.Trim(); // get text of next <dd> tag; derived from https://stackoverflow.com/a/25535623/262123
 
                     downloads.Add(
                         new GenericModDownload(fileName, description, fileVersion)
@@ -163,13 +164,12 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
             }
 
             // yield info
-            return new NexusMod
-            {
-                Name = name,
-                Version = parsedVersion?.ToString() ?? version,
-                Url = url,
-                Downloads = downloads.ToArray()
-            };
+            return new NexusMod(
+                name: name ?? id.ToString(),
+                version: parsedVersion?.ToString() ?? version,
+                url: url,
+                downloads: downloads.ToArray()
+            );
         }
 
         /// <summary>Get metadata about a mod from the Nexus API.</summary>
@@ -182,22 +182,21 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
             ModFileList files = await this.ApiClient.ModFiles.GetModFiles("stardewvalley", (int)id, FileCategory.Main, FileCategory.Optional);
 
             // yield info
-            return new NexusMod
-            {
-                Name = mod.Name,
-                Version = SemanticVersion.TryParse(mod.Version, out ISemanticVersion version) ? version?.ToString() : mod.Version,
-                Url = this.GetModUrl(id),
-                Downloads = files.Files
+            return new NexusMod(
+                name: mod.Name,
+                version: SemanticVersion.TryParse(mod.Version, out ISemanticVersion? version) ? version.ToString() : mod.Version,
+                url: this.GetModUrl(id),
+                downloads: files.Files
                     .Select(file => (IModDownload)new GenericModDownload(file.Name, file.Description, file.FileVersion))
                     .ToArray()
-            };
+            );
         }
 
         /// <summary>Get the full mod page URL for a given ID.</summary>
         /// <param name="id">The mod ID.</param>
         private string GetModUrl(uint id)
         {
-            UriBuilder builder = new(this.WebClient.BaseClient.BaseAddress);
+            UriBuilder builder = new(this.WebClient.BaseClient.BaseAddress!);
             builder.Path += string.Format(this.WebModUrlFormat, id);
             return builder.Uri.ToString();
         }
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/ResponseModels/NexusMod.cs b/src/SMAPI.Web/Framework/Clients/Nexus/ResponseModels/NexusMod.cs
index 358c4633..3155cfda 100644
--- a/src/SMAPI.Web/Framework/Clients/Nexus/ResponseModels/NexusMod.cs
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/ResponseModels/NexusMod.cs
@@ -1,5 +1,4 @@
-#nullable disable
-
+using System;
 using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework.Clients.Nexus.ResponseModels
@@ -11,25 +10,53 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus.ResponseModels
         ** Accessors
         *********/
         /// <summary>The mod name.</summary>
-        public string Name { get; set; }
+        public string? Name { get; }
 
         /// <summary>The mod's semantic version number.</summary>
-        public string Version { get; set; }
+        public string? Version { get; }
 
         /// <summary>The mod's web URL.</summary>
         [JsonProperty("mod_page_uri")]
-        public string Url { get; set; }
+        public string? Url { get; }
 
         /// <summary>The mod's publication status.</summary>
         [JsonIgnore]
-        public NexusModStatus Status { get; set; } = NexusModStatus.Ok;
+        public NexusModStatus Status { get; }
 
         /// <summary>The files available to download.</summary>
         [JsonIgnore]
-        public IModDownload[] Downloads { get; set; }
+        public IModDownload[] Downloads { get; }
 
         /// <summary>A custom user-friendly error which indicates why fetching the mod info failed (if applicable).</summary>
         [JsonIgnore]
-        public string Error { get; set; }
+        public string? Error { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="name">The mod name</param>
+        /// <param name="version">The mod's semantic version number.</param>
+        /// <param name="url">The mod's web URL.</param>
+        /// <param name="downloads">The files available to download.</param>
+        public NexusMod(string name, string? version, string url, IModDownload[] downloads)
+        {
+            this.Name = name;
+            this.Version = version;
+            this.Url = url;
+            this.Status = NexusModStatus.Ok;
+            this.Downloads = downloads;
+        }
+
+        /// <summary>Construct an instance.</summary>
+        /// <param name="status">The mod's publication status.</param>
+        /// <param name="error">A custom user-friendly error which indicates why fetching the mod info failed (if applicable).</param>
+        public NexusMod(NexusModStatus status, string error)
+        {
+            this.Status = status;
+            this.Error = error;
+            this.Downloads = Array.Empty<IModDownload>();
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs b/src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs
index 03c78e01..431fed7b 100644
--- a/src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Pastebin/IPastebinClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Threading.Tasks;
 
diff --git a/src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs b/src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs
index 2d48a7ae..7f40e713 100644
--- a/src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs
+++ b/src/SMAPI.Web/Framework/Clients/Pastebin/PasteInfo.cs
@@ -1,17 +1,35 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Web.Framework.Clients.Pastebin
 {
     /// <summary>The response for a get-paste request.</summary>
     internal class PasteInfo
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>Whether the log was successfully fetched.</summary>
-        public bool Success { get; set; }
+        [MemberNotNullWhen(true, nameof(PasteInfo.Content))]
+        [MemberNotNullWhen(false, nameof(PasteInfo.Error))]
+        public bool Success => this.Error == null || this.Content != null;
 
         /// <summary>The fetched paste content (if <see cref="Success"/> is <c>true</c>).</summary>
-        public string Content { get; set; }
+        public string? Content { get; internal set; }
 
-        /// <summary>The error message if saving failed.</summary>
-        public string Error { get; set; }
+        /// <summary>The error message (if <see cref="Success"/> is <c>false</c>).</summary>
+        public string? Error { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="content">The fetched paste content.</param>
+        /// <param name="error">The error message, if it failed.</param>
+        public PasteInfo(string? content, string? error)
+        {
+            this.Content = content;
+            this.Error = error;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs b/src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs
index d0cdf374..0e00f071 100644
--- a/src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Pastebin/PastebinClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Net;
 using System.Threading.Tasks;
@@ -35,24 +33,24 @@ namespace StardewModdingAPI.Web.Framework.Clients.Pastebin
             try
             {
                 // get from API
-                string content = await this.Client
+                string? content = await this.Client
                     .GetAsync($"raw/{id}")
                     .AsString();
 
                 // handle Pastebin errors
                 if (string.IsNullOrWhiteSpace(content))
-                    return new PasteInfo { Error = "Received an empty response from Pastebin." };
+                    return new PasteInfo(null, "Received an empty response from Pastebin.");
                 if (content.StartsWith("<!DOCTYPE"))
-                    return new PasteInfo { Error = $"Received a captcha challenge from Pastebin. Please visit https://pastebin.com/{id} in a new window to solve it." };
-                return new PasteInfo { Success = true, Content = content };
+                    return new PasteInfo(null, $"Received a captcha challenge from Pastebin. Please visit https://pastebin.com/{id} in a new window to solve it.");
+                return new PasteInfo(content, null);
             }
             catch (ApiException ex) when (ex.Status == HttpStatusCode.NotFound)
             {
-                return new PasteInfo { Error = "There's no log with that ID." };
+                return new PasteInfo(null, "There's no log with that ID.");
             }
             catch (Exception ex)
             {
-                return new PasteInfo { Error = $"Pastebin error: {ex}" };
+                return new PasteInfo(null, $"Pastebin error: {ex}");
             }
         }
 
diff --git a/src/SMAPI.Web/Framework/Compression/GzipHelper.cs b/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
index 843b7735..e7a2df13 100644
--- a/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
+++ b/src/SMAPI.Web/Framework/Compression/GzipHelper.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.IO.Compression;
 using System.Text;
@@ -53,8 +52,12 @@ namespace StardewModdingAPI.Web.Framework.Compression
         /// <summary>Decompress a string.</summary>
         /// <param name="rawText">The compressed text.</param>
         /// <remarks>Derived from <a href="https://stackoverflow.com/a/17993002/262123"/>.</remarks>
-        public string DecompressString(string rawText)
+        [return: NotNullIfNotNull("rawText")]
+        public string? DecompressString(string? rawText)
         {
+            if (rawText is null)
+                return rawText;
+
             // get raw bytes
             byte[] zipBuffer;
             try
diff --git a/src/SMAPI.Web/Framework/Compression/IGzipHelper.cs b/src/SMAPI.Web/Framework/Compression/IGzipHelper.cs
index e1ec9b67..ef2d5696 100644
--- a/src/SMAPI.Web/Framework/Compression/IGzipHelper.cs
+++ b/src/SMAPI.Web/Framework/Compression/IGzipHelper.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Web.Framework.Compression
 {
@@ -14,6 +14,7 @@ namespace StardewModdingAPI.Web.Framework.Compression
 
         /// <summary>Decompress a string.</summary>
         /// <param name="rawText">The compressed text.</param>
-        string DecompressString(string rawText);
+        [return: NotNullIfNotNull("rawText")]
+        string? DecompressString(string? rawText);
     }
 }
diff --git a/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
index 3730a9db..b582b2b0 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
     /// <summary>The config settings for the API clients.</summary>
@@ -12,17 +10,17 @@ namespace StardewModdingAPI.Web.Framework.ConfigModels
         ** Generic
         ****/
         /// <summary>The user agent for API clients, where {0} is the SMAPI version.</summary>
-        public string UserAgent { get; set; }
+        public string UserAgent { get; set; } = null!;
 
 
         /****
         ** Azure
         ****/
         /// <summary>The connection string for the Azure Blob storage account.</summary>
-        public string AzureBlobConnectionString { get; set; }
+        public string? AzureBlobConnectionString { get; set; }
 
         /// <summary>The Azure Blob container in which to store temporary uploaded logs.</summary>
-        public string AzureBlobTempContainer { get; set; }
+        public string AzureBlobTempContainer { get; set; } = null!;
 
         /// <summary>The number of days since the blob's last-modified date when it will be deleted.</summary>
         public int AzureBlobTempExpiryDays { get; set; }
@@ -32,65 +30,65 @@ namespace StardewModdingAPI.Web.Framework.ConfigModels
         ** Chucklefish
         ****/
         /// <summary>The base URL for the Chucklefish mod site.</summary>
-        public string ChucklefishBaseUrl { get; set; }
+        public string ChucklefishBaseUrl { get; set; } = null!;
 
         /// <summary>The URL for a mod page on the Chucklefish mod site excluding the <see cref="GitHubBaseUrl"/>, where {0} is the mod ID.</summary>
-        public string ChucklefishModPageUrlFormat { get; set; }
+        public string ChucklefishModPageUrlFormat { get; set; } = null!;
 
 
         /****
         ** CurseForge
         ****/
         /// <summary>The base URL for the CurseForge API.</summary>
-        public string CurseForgeBaseUrl { get; set; }
+        public string CurseForgeBaseUrl { get; set; } = null!;
 
 
         /****
         ** GitHub
         ****/
         /// <summary>The base URL for the GitHub API.</summary>
-        public string GitHubBaseUrl { get; set; }
+        public string GitHubBaseUrl { get; set; } = null!;
 
         /// <summary>The Accept header value expected by the GitHub API.</summary>
-        public string GitHubAcceptHeader { get; set; }
+        public string GitHubAcceptHeader { get; set; } = null!;
 
         /// <summary>The username with which to authenticate to the GitHub API (if any).</summary>
-        public string GitHubUsername { get; set; }
+        public string? GitHubUsername { get; set; }
 
         /// <summary>The password with which to authenticate to the GitHub API (if any).</summary>
-        public string GitHubPassword { get; set; }
+        public string? GitHubPassword { get; set; }
 
 
         /****
         ** ModDrop
         ****/
         /// <summary>The base URL for the ModDrop API.</summary>
-        public string ModDropApiUrl { get; set; }
+        public string ModDropApiUrl { get; set; } = null!;
 
         /// <summary>The URL for a ModDrop mod page for the user, where {0} is the mod ID.</summary>
-        public string ModDropModPageUrl { get; set; }
+        public string ModDropModPageUrl { get; set; } = null!;
 
 
         /****
         ** Nexus Mods
         ****/
         /// <summary>The base URL for the Nexus Mods API.</summary>
-        public string NexusBaseUrl { get; set; }
+        public string NexusBaseUrl { get; set; } = null!;
 
         /// <summary>The URL for a Nexus mod page for the user, excluding the <see cref="NexusBaseUrl"/>, where {0} is the mod ID.</summary>
-        public string NexusModUrlFormat { get; set; }
+        public string NexusModUrlFormat { get; set; } = null!;
 
         /// <summary>The URL for a Nexus mod page to scrape for versions, excluding the <see cref="NexusBaseUrl"/>, where {0} is the mod ID.</summary>
-        public string NexusModScrapeUrlFormat { get; set; }
+        public string NexusModScrapeUrlFormat { get; set; } = null!;
 
         /// <summary>The Nexus API authentication key.</summary>
-        public string NexusApiKey { get; set; }
+        public string? NexusApiKey { get; set; }
 
 
         /****
         ** Pastebin
         ****/
         /// <summary>The base URL for the Pastebin API.</summary>
-        public string PastebinBaseUrl { get; set; }
+        public string PastebinBaseUrl { get; set; } = null!;
     }
 }
diff --git a/src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs
index 682c97e6..e46ecf2b 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/ModOverrideConfig.cs
@@ -1,17 +1,15 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
     /// <summary>Override update-check metadata for a mod.</summary>
     internal class ModOverrideConfig
     {
         /// <summary>The unique ID from the mod's manifest.</summary>
-        public string ID { get; set; }
+        public string ID { get; set; } = null!;
 
         /// <summary>Whether to allow non-standard versions.</summary>
         public bool AllowNonStandardVersions { get; set; }
 
         /// <summary>The mod page URL to use regardless of which site has the update, or <c>null</c> to use the site URL.</summary>
-        public string SetUrl { get; set; }
+        public string? SetUrl { get; set; }
     }
 }
diff --git a/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
index e525e09a..c3b136e8 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/ModUpdateCheckConfig.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System;
 
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
@@ -8,16 +8,16 @@ namespace StardewModdingAPI.Web.Framework.ConfigModels
         /*********
         ** Accessors
         *********/
-        /// <summary>The number of minutes successful update checks should be cached before refetching them.</summary>
+        /// <summary>The number of minutes successful update checks should be cached before re-fetching them.</summary>
         public int SuccessCacheMinutes { get; set; }
 
-        /// <summary>The number of minutes failed update checks should be cached before refetching them.</summary>
+        /// <summary>The number of minutes failed update checks should be cached before re-fetching them.</summary>
         public int ErrorCacheMinutes { get; set; }
 
         /// <summary>Update-check metadata to override.</summary>
-        public ModOverrideConfig[] ModOverrides { get; set; }
+        public ModOverrideConfig[] ModOverrides { get; set; } = Array.Empty<ModOverrideConfig>();
 
         /// <summary>The update-check config for SMAPI's own update checks.</summary>
-        public SmapiInfoConfig SmapiInfo { get; set; }
+        public SmapiInfoConfig SmapiInfo { get; set; } = null!;
     }
 }
diff --git a/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
index ef6c2659..62685e47 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/SiteConfig.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
     /// <summary>The site config settings.</summary>
@@ -9,9 +7,9 @@ namespace StardewModdingAPI.Web.Framework.ConfigModels
         ** Accessors
         *********/
         /// <summary>A message to show below the download button (e.g. for details on downloading a beta version), in Markdown format.</summary>
-        public string OtherBlurb { get; set; }
+        public string? OtherBlurb { get; set; }
 
         /// <summary>A list of supports to credit on the main page, in Markdown format.</summary>
-        public string SupporterList { get; set; }
+        public string? SupporterList { get; set; }
     }
 }
diff --git a/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs
index dbf58817..a95e0048 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/SmapiInfoConfig.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System;
 
 namespace StardewModdingAPI.Web.Framework.ConfigModels
 {
@@ -6,12 +6,12 @@ namespace StardewModdingAPI.Web.Framework.ConfigModels
     internal class SmapiInfoConfig
     {
         /// <summary>The mod ID used for SMAPI update checks.</summary>
-        public string ID { get; set; }
+        public string ID { get; set; } = null!;
 
         /// <summary>The default update key used for SMAPI update checks.</summary>
-        public string DefaultUpdateKey { get; set; }
+        public string DefaultUpdateKey { get; set; } = null!;
 
         /// <summary>The update keys to add for SMAPI update checks when the player has a beta version installed.</summary>
-        public string[] AddBetaUpdateKeys { get; set; }
+        public string[] AddBetaUpdateKeys { get; set; } = Array.Empty<string>();
     }
 }
diff --git a/src/SMAPI.Web/Framework/Extensions.cs b/src/SMAPI.Web/Framework/Extensions.cs
index a72c12c1..62a23155 100644
--- a/src/SMAPI.Web/Framework/Extensions.cs
+++ b/src/SMAPI.Web/Framework/Extensions.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using JetBrains.Annotations;
 using Microsoft.AspNetCore.Html;
@@ -28,7 +26,7 @@ namespace StardewModdingAPI.Web.Framework
         /// <param name="values">An object that contains route values.</param>
         /// <param name="absoluteUrl">Get an absolute URL instead of a server-relative path/</param>
         /// <returns>The generated URL.</returns>
-        public static string PlainAction(this IUrlHelper helper, [AspMvcAction] string action, [AspMvcController] string controller, object values = null, bool absoluteUrl = false)
+        public static string? PlainAction(this IUrlHelper helper, [AspMvcAction] string action, [AspMvcController] string controller, object? values = null, bool absoluteUrl = false)
         {
             // get route values
             RouteValueDictionary valuesDict = new(values);
@@ -39,7 +37,7 @@ namespace StardewModdingAPI.Web.Framework
             }
 
             // get relative URL
-            string url = helper.Action(action, controller, valuesDict);
+            string? url = helper.Action(action, controller, valuesDict);
             if (url == null && action.EndsWith("Async"))
                 url = helper.Action(action[..^"Async".Length], controller, valuesDict);
 
@@ -59,7 +57,7 @@ namespace StardewModdingAPI.Web.Framework
         /// <param name="value">The value to serialize.</param>
         /// <returns>The serialized JSON.</returns>
         /// <remarks>This bypasses unnecessary validation (e.g. not allowing null values) in <see cref="IJsonHelper.Serialize"/>.</remarks>
-        public static IHtmlContent ForJson(this RazorPageBase page, object value)
+        public static IHtmlContent ForJson(this RazorPageBase page, object? value)
         {
             string json = JsonConvert.SerializeObject(value);
             return new HtmlString(json);
diff --git a/src/SMAPI.Web/Framework/IModDownload.cs b/src/SMAPI.Web/Framework/IModDownload.cs
index b8d1f62c..fe171785 100644
--- a/src/SMAPI.Web/Framework/IModDownload.cs
+++ b/src/SMAPI.Web/Framework/IModDownload.cs
@@ -1,17 +1,18 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.Framework
 {
     /// <summary>Generic metadata about a file download on a mod page.</summary>
     internal interface IModDownload
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The download's display name.</summary>
         string Name { get; }
 
         /// <summary>The download's description.</summary>
-        string Description { get; }
+        string? Description { get; }
 
         /// <summary>The download's file version.</summary>
-        string Version { get; }
+        string? Version { get; }
     }
 }
diff --git a/src/SMAPI.Web/Framework/IModPage.cs b/src/SMAPI.Web/Framework/IModPage.cs
index 68220b49..4d0a8d61 100644
--- a/src/SMAPI.Web/Framework/IModPage.cs
+++ b/src/SMAPI.Web/Framework/IModPage.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 
 namespace StardewModdingAPI.Web.Framework
@@ -18,13 +17,13 @@ namespace StardewModdingAPI.Web.Framework
         string Id { get; }
 
         /// <summary>The mod name.</summary>
-        string Name { get; }
+        string? Name { get; }
 
         /// <summary>The mod's semantic version number.</summary>
-        string Version { get; }
+        string? Version { get; }
 
         /// <summary>The mod's web URL.</summary>
-        string Url { get; }
+        string? Url { get; }
 
         /// <summary>The mod downloads.</summary>
         IModDownload[] Downloads { get; }
@@ -33,7 +32,12 @@ namespace StardewModdingAPI.Web.Framework
         RemoteModStatus Status { get; }
 
         /// <summary>A user-friendly error which indicates why fetching the mod info failed (if applicable).</summary>
-        string Error { get; }
+        string? Error { get; }
+
+        /// <summary>Whether the mod data is valid.</summary>
+        [MemberNotNullWhen(true, nameof(IModPage.Name), nameof(IModPage.Url))]
+        [MemberNotNullWhen(false, nameof(IModPage.Error))]
+        bool IsValid { get; }
 
 
         /*********
@@ -44,7 +48,7 @@ namespace StardewModdingAPI.Web.Framework
         /// <param name="version">The mod's semantic version number.</param>
         /// <param name="url">The mod's web URL.</param>
         /// <param name="downloads">The mod downloads.</param>
-        IModPage SetInfo(string name, string version, string url, IEnumerable<IModDownload> downloads);
+        IModPage SetInfo(string name, string? version, string url, IEnumerable<IModDownload> downloads);
 
         /// <summary>Set a mod fetch error.</summary>
         /// <param name="status">The mod availability status on the remote site.</param>
diff --git a/src/SMAPI.Web/Framework/InternalControllerFeatureProvider.cs b/src/SMAPI.Web/Framework/InternalControllerFeatureProvider.cs
index 98738a82..2c24c610 100644
--- a/src/SMAPI.Web/Framework/InternalControllerFeatureProvider.cs
+++ b/src/SMAPI.Web/Framework/InternalControllerFeatureProvider.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 using Microsoft.AspNetCore.Mvc;
diff --git a/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs b/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
index 8db43dca..3c1405eb 100644
--- a/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
+++ b/src/SMAPI.Web/Framework/JobDashboardAuthorizationFilter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Hangfire.Dashboard;
 
 namespace StardewModdingAPI.Web.Framework
diff --git a/src/SMAPI.Web/Framework/ModInfoModel.cs b/src/SMAPI.Web/Framework/ModInfoModel.cs
index 021d14fb..e70b60bf 100644
--- a/src/SMAPI.Web/Framework/ModInfoModel.cs
+++ b/src/SMAPI.Web/Framework/ModInfoModel.cs
@@ -1,4 +1,5 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
+using Newtonsoft.Json;
 
 namespace StardewModdingAPI.Web.Framework
 {
@@ -9,22 +10,22 @@ namespace StardewModdingAPI.Web.Framework
         ** Accessors
         *********/
         /// <summary>The mod name.</summary>
-        public string Name { get; set; }
-
-        /// <summary>The mod's latest version.</summary>
-        public ISemanticVersion Version { get; set; }
-
-        /// <summary>The mod's latest optional or prerelease version, if newer than <see cref="Version"/>.</summary>
-        public ISemanticVersion PreviewVersion { get; set; }
+        public string? Name { get; private set; }
 
         /// <summary>The mod's web URL.</summary>
-        public string Url { get; set; }
+        public string? Url { get; private set; }
+
+        /// <summary>The mod's latest version.</summary>
+        public ISemanticVersion? Version { get; private set; }
+
+        /// <summary>The mod's latest optional or prerelease version, if newer than <see cref="Version"/>.</summary>
+        public ISemanticVersion? PreviewVersion { get; private set; }
 
         /// <summary>The mod availability status on the remote site.</summary>
-        public RemoteModStatus Status { get; set; } = RemoteModStatus.Ok;
+        public RemoteModStatus Status { get; private set; }
 
         /// <summary>The error message indicating why the mod is invalid (if applicable).</summary>
-        public string Error { get; set; }
+        public string? Error { get; private set; }
 
 
         /*********
@@ -35,19 +36,24 @@ namespace StardewModdingAPI.Web.Framework
 
         /// <summary>Construct an instance.</summary>
         /// <param name="name">The mod name.</param>
+        /// <param name="url">The mod's web URL.</param>
         /// <param name="version">The semantic version for the mod's latest release.</param>
         /// <param name="previewVersion">The semantic version for the mod's latest preview release, if available and different from <see cref="Version"/>.</param>
-        /// <param name="url">The mod's web URL.</param>
-        public ModInfoModel(string name, ISemanticVersion version, string url, ISemanticVersion previewVersion = null)
+        /// <param name="status">The mod availability status on the remote site.</param>
+        /// <param name="error">The error message indicating why the mod is invalid (if applicable).</param>
+        [JsonConstructor]
+        public ModInfoModel(string name, string url, ISemanticVersion? version, ISemanticVersion? previewVersion = null, RemoteModStatus status = RemoteModStatus.Ok, string? error = null)
         {
             this
                 .SetBasicInfo(name, url)
-                .SetVersions(version, previewVersion);
+                .SetVersions(version!, previewVersion)
+                .SetError(status, error!);
         }
 
         /// <summary>Set the basic mod info.</summary>
         /// <param name="name">The mod name.</param>
         /// <param name="url">The mod's web URL.</param>
+        [MemberNotNull(nameof(ModInfoModel.Name), nameof(ModInfoModel.Url))]
         public ModInfoModel SetBasicInfo(string name, string url)
         {
             this.Name = name;
@@ -59,7 +65,8 @@ namespace StardewModdingAPI.Web.Framework
         /// <summary>Set the mod version info.</summary>
         /// <param name="version">The semantic version for the mod's latest release.</param>
         /// <param name="previewVersion">The semantic version for the mod's latest preview release, if available and different from <see cref="Version"/>.</param>
-        public ModInfoModel SetVersions(ISemanticVersion version, ISemanticVersion previewVersion = null)
+        [MemberNotNull(nameof(ModInfoModel.Version))]
+        public ModInfoModel SetVersions(ISemanticVersion version, ISemanticVersion? previewVersion = null)
         {
             this.Version = version;
             this.PreviewVersion = previewVersion;
diff --git a/src/SMAPI.Web/Framework/ModSiteManager.cs b/src/SMAPI.Web/Framework/ModSiteManager.cs
index 2d6755d8..674b9ffc 100644
--- a/src/SMAPI.Web/Framework/ModSiteManager.cs
+++ b/src/SMAPI.Web/Framework/ModSiteManager.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Text.RegularExpressions;
 using System.Threading.Tasks;
@@ -36,12 +35,15 @@ namespace StardewModdingAPI.Web.Framework
         /// <param name="updateKey">The namespaced update key.</param>
         public async Task<IModPage> GetModPageAsync(UpdateKey updateKey)
         {
+            if (!updateKey.LooksValid)
+                return new GenericModPage(updateKey.Site, updateKey.ID!).SetError(RemoteModStatus.DoesNotExist, $"Invalid update key '{updateKey}'.");
+
             // get site
-            if (!this.ModSites.TryGetValue(updateKey.Site, out IModSiteClient client))
+            if (!this.ModSites.TryGetValue(updateKey.Site, out IModSiteClient? client))
                 return new GenericModPage(updateKey.Site, updateKey.ID).SetError(RemoteModStatus.DoesNotExist, $"There's no mod site with key '{updateKey.Site}'. Expected one of [{string.Join(", ", this.ModSites.Keys)}].");
 
             // fetch mod
-            IModPage mod;
+            IModPage? mod;
             try
             {
                 mod = await client.GetModData(updateKey.ID);
@@ -60,39 +62,42 @@ namespace StardewModdingAPI.Web.Framework
         /// <param name="subkey">The optional update subkey to match in available files. (If no file names or descriptions contain the subkey, it'll be ignored.)</param>
         /// <param name="mapRemoteVersions">The changes to apply to remote versions for update checks.</param>
         /// <param name="allowNonStandardVersions">Whether to allow non-standard versions.</param>
-        public ModInfoModel GetPageVersions(IModPage page, string subkey, bool allowNonStandardVersions, ChangeDescriptor mapRemoteVersions)
+        public ModInfoModel GetPageVersions(IModPage page, string? subkey, bool allowNonStandardVersions, ChangeDescriptor? mapRemoteVersions)
         {
             // get base model
-            ModInfoModel model = new ModInfoModel()
-                .SetBasicInfo(page.Name, page.Url)
-                .SetError(page.Status, page.Error);
-            if (page.Status != RemoteModStatus.Ok)
+            ModInfoModel model = new();
+            if (page.IsValid)
+                model.SetBasicInfo(page.Name, page.Url);
+            else
+            {
+                model.SetError(page.Status, page.Error);
                 return model;
+            }
 
             // fetch versions
-            bool hasVersions = this.TryGetLatestVersions(page, subkey, allowNonStandardVersions, mapRemoteVersions, out ISemanticVersion mainVersion, out ISemanticVersion previewVersion);
+            bool hasVersions = this.TryGetLatestVersions(page, subkey, allowNonStandardVersions, mapRemoteVersions, out ISemanticVersion? mainVersion, out ISemanticVersion? previewVersion);
             if (!hasVersions && subkey != null)
                 hasVersions = this.TryGetLatestVersions(page, null, allowNonStandardVersions, mapRemoteVersions, out mainVersion, out previewVersion);
             if (!hasVersions)
                 return model.SetError(RemoteModStatus.InvalidData, $"The {page.Site} mod with ID '{page.Id}' has no valid versions.");
 
             // return info
-            return model.SetVersions(mainVersion, previewVersion);
+            return model.SetVersions(mainVersion!, previewVersion);
         }
 
         /// <summary>Get a semantic local version for update checks.</summary>
         /// <param name="version">The version to parse.</param>
         /// <param name="map">Changes to apply to the raw version, if any.</param>
         /// <param name="allowNonStandard">Whether to allow non-standard versions.</param>
-        public ISemanticVersion GetMappedVersion(string version, ChangeDescriptor map, bool allowNonStandard)
+        public ISemanticVersion? GetMappedVersion(string? version, ChangeDescriptor? map, bool allowNonStandard)
         {
             // try mapped version
-            string rawNewVersion = this.GetRawMappedVersion(version, map, allowNonStandard);
-            if (SemanticVersion.TryParse(rawNewVersion, allowNonStandard, out ISemanticVersion parsedNew))
+            string? rawNewVersion = this.GetRawMappedVersion(version, map);
+            if (SemanticVersion.TryParse(rawNewVersion, allowNonStandard, out ISemanticVersion? parsedNew))
                 return parsedNew;
 
             // return original version
-            return SemanticVersion.TryParse(version, allowNonStandard, out ISemanticVersion parsedOld)
+            return SemanticVersion.TryParse(version, allowNonStandard, out ISemanticVersion? parsedOld)
                 ? parsedOld
                 : null;
         }
@@ -108,31 +113,31 @@ namespace StardewModdingAPI.Web.Framework
         /// <param name="mapRemoteVersions">The changes to apply to remote versions for update checks.</param>
         /// <param name="main">The main mod version.</param>
         /// <param name="preview">The latest prerelease version, if newer than <paramref name="main"/>.</param>
-        private bool TryGetLatestVersions(IModPage mod, string subkey, bool allowNonStandardVersions, ChangeDescriptor mapRemoteVersions, out ISemanticVersion main, out ISemanticVersion preview)
+        private bool TryGetLatestVersions(IModPage? mod, string? subkey, bool allowNonStandardVersions, ChangeDescriptor? mapRemoteVersions, [NotNullWhen(true)] out ISemanticVersion? main, out ISemanticVersion? preview)
         {
             main = null;
             preview = null;
 
             // parse all versions from the mod page
-            IEnumerable<(string name, string description, ISemanticVersion version)> GetAllVersions()
+            IEnumerable<(string? name, string? description, ISemanticVersion? version)> GetAllVersions()
             {
                 if (mod != null)
                 {
-                    ISemanticVersion ParseAndMapVersion(string raw)
+                    ISemanticVersion? ParseAndMapVersion(string? raw)
                     {
                         raw = this.NormalizeVersion(raw);
                         return this.GetMappedVersion(raw, mapRemoteVersions, allowNonStandardVersions);
                     }
 
                     // get mod version
-                    ISemanticVersion modVersion = ParseAndMapVersion(mod.Version);
+                    ISemanticVersion? modVersion = ParseAndMapVersion(mod.Version);
                     if (modVersion != null)
                         yield return (name: null, description: null, version: ParseAndMapVersion(mod.Version));
 
                     // get file versions
                     foreach (IModDownload download in mod.Downloads)
                     {
-                        ISemanticVersion cur = ParseAndMapVersion(download.Version);
+                        ISemanticVersion? cur = ParseAndMapVersion(download.Version);
                         if (cur != null)
                             yield return (download.Name, download.Description, cur);
                     }
@@ -143,15 +148,15 @@ namespace StardewModdingAPI.Web.Framework
                 .ToArray();
 
             // get main + preview versions
-            void TryGetVersions(out ISemanticVersion mainVersion, out ISemanticVersion previewVersion, Func<(string name, string description, ISemanticVersion version), bool> filter = null)
+            void TryGetVersions([NotNullWhen(true)] out ISemanticVersion? mainVersion, out ISemanticVersion? previewVersion, Func<(string? name, string? description, ISemanticVersion? version), bool>? filter = null)
             {
                 mainVersion = null;
                 previewVersion = null;
 
                 // get latest main + preview version
-                foreach (var entry in versions)
+                foreach ((string? name, string? description, ISemanticVersion? version) entry in versions)
                 {
-                    if (filter?.Invoke(entry) == false)
+                    if (entry.version is null || filter?.Invoke(entry) == false)
                         continue;
 
                     if (entry.version.IsPrerelease())
@@ -160,7 +165,7 @@ namespace StardewModdingAPI.Web.Framework
                         mainVersion ??= entry.version;
 
                     if (mainVersion != null)
-                        break; // any other values will be older
+                        break; // any others will be older since entries are sorted by version
                 }
 
                 // normalize values
@@ -183,8 +188,7 @@ namespace StardewModdingAPI.Web.Framework
         /// <summary>Get a semantic local version for update checks.</summary>
         /// <param name="version">The version to map.</param>
         /// <param name="map">Changes to apply to the raw version, if any.</param>
-        /// <param name="allowNonStandard">Whether to allow non-standard versions.</param>
-        private string GetRawMappedVersion(string version, ChangeDescriptor map, bool allowNonStandard)
+        private string? GetRawMappedVersion(string? version, ChangeDescriptor? map)
         {
             if (version == null || map?.HasChanges != true)
                 return version;
@@ -197,7 +201,7 @@ namespace StardewModdingAPI.Web.Framework
 
         /// <summary>Normalize a version string.</summary>
         /// <param name="version">The version to normalize.</param>
-        private string NormalizeVersion(string version)
+        private string? NormalizeVersion(string? version)
         {
             if (string.IsNullOrWhiteSpace(version))
                 return null;
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
index fe601524..7b8f0ec9 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectHostsToUrlsRule.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Net;
 using Microsoft.AspNetCore.Rewrite;
@@ -13,7 +11,7 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         ** Fields
         *********/
         /// <summary>Maps a lowercase hostname to the resulting redirect URL.</summary>
-        private readonly Func<string, string> Map;
+        private readonly Func<string, string?> Map;
 
 
         /*********
@@ -22,7 +20,7 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         /// <summary>Construct an instance.</summary>
         /// <param name="statusCode">The status code to use for redirects.</param>
         /// <param name="map">Hostnames mapped to the resulting redirect URL.</param>
-        public RedirectHostsToUrlsRule(HttpStatusCode statusCode, Func<string, string> map)
+        public RedirectHostsToUrlsRule(HttpStatusCode statusCode, Func<string, string?> map)
         {
             this.StatusCode = statusCode;
             this.Map = map ?? throw new ArgumentNullException(nameof(map));
@@ -35,10 +33,10 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         /// <summary>Get the new redirect URL.</summary>
         /// <param name="context">The rewrite context.</param>
         /// <returns>Returns the redirect URL, or <c>null</c> if the redirect doesn't apply.</returns>
-        protected override string GetNewUrl(RewriteContext context)
+        protected override string? GetNewUrl(RewriteContext context)
         {
             // get requested host
-            string host = context.HttpContext.Request.Host.Host;
+            string? host = context.HttpContext.Request.Host.Host;
 
             // get new host
             host = this.Map(host);
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs
index 81a265c9..b46e8f69 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectMatchRule.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Net;
 using Microsoft.AspNetCore.Http;
@@ -24,7 +22,7 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         /// <param name="context">The rewrite context.</param>
         public void ApplyRule(RewriteContext context)
         {
-            string newUrl = this.GetNewUrl(context);
+            string? newUrl = this.GetNewUrl(context);
             if (newUrl == null)
                 return;
 
@@ -41,7 +39,7 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         /// <summary>Get the new redirect URL.</summary>
         /// <param name="context">The rewrite context.</param>
         /// <returns>Returns the redirect URL, or <c>null</c> if the redirect doesn't apply.</returns>
-        protected abstract string GetNewUrl(RewriteContext context);
+        protected abstract string? GetNewUrl(RewriteContext context);
 
         /// <summary>Get the full request URL.</summary>
         /// <param name="request">The request.</param>
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectPathsToUrlsRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectPathsToUrlsRule.cs
index cb3e53ef..e691ffba 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectPathsToUrlsRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectPathsToUrlsRule.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Linq;
 using System.Net;
@@ -39,9 +37,9 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         /// <summary>Get the new redirect URL.</summary>
         /// <param name="context">The rewrite context.</param>
         /// <returns>Returns the redirect URL, or <c>null</c> if the redirect doesn't apply.</returns>
-        protected override string GetNewUrl(RewriteContext context)
+        protected override string? GetNewUrl(RewriteContext context)
         {
-            string path = context.HttpContext.Request.Path.Value;
+            string? path = context.HttpContext.Request.Path.Value;
 
             if (!string.IsNullOrWhiteSpace(path))
             {
diff --git a/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs b/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
index dd7c836f..01807608 100644
--- a/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
+++ b/src/SMAPI.Web/Framework/RedirectRules/RedirectToHttpsRule.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Net;
 using Microsoft.AspNetCore.Http;
@@ -22,7 +20,7 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="except">Matches requests which should be ignored.</param>
-        public RedirectToHttpsRule(Func<HttpRequest, bool> except = null)
+        public RedirectToHttpsRule(Func<HttpRequest, bool>? except = null)
         {
             this.Except = except ?? (_ => false);
             this.StatusCode = HttpStatusCode.RedirectKeepVerb;
@@ -35,7 +33,7 @@ namespace StardewModdingAPI.Web.Framework.RedirectRules
         /// <summary>Get the new redirect URL.</summary>
         /// <param name="context">The rewrite context.</param>
         /// <returns>Returns the redirect URL, or <c>null</c> if the redirect doesn't apply.</returns>
-        protected override string GetNewUrl(RewriteContext context)
+        protected override string? GetNewUrl(RewriteContext context)
         {
             HttpRequest request = context.HttpContext.Request;
             if (request.IsHttps || this.Except(request))
diff --git a/src/SMAPI.Web/Framework/Storage/IStorageProvider.cs b/src/SMAPI.Web/Framework/Storage/IStorageProvider.cs
index 2eca4845..dfc1fb47 100644
--- a/src/SMAPI.Web/Framework/Storage/IStorageProvider.cs
+++ b/src/SMAPI.Web/Framework/Storage/IStorageProvider.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Threading.Tasks;
 
 namespace StardewModdingAPI.Web.Framework.Storage
diff --git a/src/SMAPI.Web/Framework/Storage/StorageProvider.cs b/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
index 0177e602..effbbc9f 100644
--- a/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
+++ b/src/SMAPI.Web/Framework/Storage/StorageProvider.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -65,11 +63,11 @@ namespace StardewModdingAPI.Web.Framework.Storage
                     BlobClient blob = this.GetAzureBlobClient(id);
                     await blob.UploadAsync(stream);
 
-                    return new UploadResult(true, id, null);
+                    return new UploadResult(id, null);
                 }
                 catch (Exception ex)
                 {
-                    return new UploadResult(false, null, ex.Message);
+                    return new UploadResult(null, ex.Message);
                 }
             }
 
@@ -77,10 +75,10 @@ namespace StardewModdingAPI.Web.Framework.Storage
             else
             {
                 string path = this.GetDevFilePath(id);
-                Directory.CreateDirectory(Path.GetDirectoryName(path));
+                Directory.CreateDirectory(Path.GetDirectoryName(path)!);
 
                 File.WriteAllText(path, content);
-                return new UploadResult(true, id, null);
+                return new UploadResult(id, null);
             }
         }
 
@@ -110,21 +108,15 @@ namespace StardewModdingAPI.Web.Framework.Storage
                         string content = this.GzipHelper.DecompressString(reader.ReadToEnd());
 
                         // build model
-                        return new StoredFileInfo
-                        {
-                            Success = true,
-                            Content = content,
-                            Expiry = expiry.UtcDateTime
-                        };
+                        return new StoredFileInfo(content, expiry);
                     }
                     catch (RequestFailedException ex)
                     {
-                        return new StoredFileInfo
-                        {
-                            Error = ex.ErrorCode == "BlobNotFound"
+                        return new StoredFileInfo(
+                            error: ex.ErrorCode == "BlobNotFound"
                                 ? "There's no file with that ID."
                                 : $"Could not fetch that file from storage ({ex.ErrorCode}: {ex.Message})."
-                        };
+                        );
                     }
                 }
 
@@ -137,10 +129,7 @@ namespace StardewModdingAPI.Web.Framework.Storage
                         file.Delete();
                     if (!file.Exists)
                     {
-                        return new StoredFileInfo
-                        {
-                            Error = "There's no file with that ID."
-                        };
+                        return new StoredFileInfo(error: "There's no file with that ID.");
                     }
 
                     // renew
@@ -151,13 +140,11 @@ namespace StardewModdingAPI.Web.Framework.Storage
                     }
 
                     // build model
-                    return new StoredFileInfo
-                    {
-                        Success = true,
-                        Content = File.ReadAllText(file.FullName),
-                        Expiry = DateTime.UtcNow.AddDays(this.ExpiryDays),
-                        Warning = "This file was saved temporarily to the local computer. This should only happen in a local development environment."
-                    };
+                    return new StoredFileInfo(
+                        content: File.ReadAllText(file.FullName),
+                        expiry: DateTime.UtcNow.AddDays(this.ExpiryDays),
+                        warning: "This file was saved temporarily to the local computer. This should only happen in a local development environment."
+                    );
                 }
             }
 
@@ -166,12 +153,7 @@ namespace StardewModdingAPI.Web.Framework.Storage
             {
                 PasteInfo response = await this.Pastebin.GetAsync(id);
                 response.Content = this.GzipHelper.DecompressString(response.Content);
-                return new StoredFileInfo
-                {
-                    Success = response.Success,
-                    Content = response.Content,
-                    Error = response.Error
-                };
+                return new StoredFileInfo(response.Content, null, error: response.Error);
             }
         }
 
@@ -179,8 +161,8 @@ namespace StardewModdingAPI.Web.Framework.Storage
         /// <param name="id">The file ID.</param>
         private BlobClient GetAzureBlobClient(string id)
         {
-            var azure = new BlobServiceClient(this.ClientsConfig.AzureBlobConnectionString);
-            var container = azure.GetBlobContainerClient(this.ClientsConfig.AzureBlobTempContainer);
+            BlobServiceClient azure = new(this.ClientsConfig.AzureBlobConnectionString);
+            BlobContainerClient container = azure.GetBlobContainerClient(this.ClientsConfig.AzureBlobTempContainer);
             return container.GetBlobClient($"uploads/{id}");
         }
 
diff --git a/src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs b/src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs
index cd941c94..bbbcf2a9 100644
--- a/src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs
+++ b/src/SMAPI.Web/Framework/Storage/StoredFileInfo.cs
@@ -1,25 +1,52 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Web.Framework.Storage
 {
     /// <summary>The response for a get-file request.</summary>
     internal class StoredFileInfo
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>Whether the file was successfully fetched.</summary>
-        public bool Success { get; set; }
+        [MemberNotNullWhen(true, nameof(StoredFileInfo.Content))]
+        public bool Success => this.Content != null && this.Error == null;
 
         /// <summary>The fetched file content (if <see cref="Success"/> is <c>true</c>).</summary>
-        public string Content { get; set; }
+        public string? Content { get; }
 
         /// <summary>When the file will no longer be available.</summary>
-        public DateTime? Expiry { get; set; }
+        public DateTimeOffset? Expiry { get; }
 
         /// <summary>The error message if saving succeeded, but a non-blocking issue was encountered.</summary>
-        public string Warning { get; set; }
+        public string? Warning { get; }
 
         /// <summary>The error message if saving failed.</summary>
-        public string Error { get; set; }
+        public string? Error { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="content">The fetched file content (if <see cref="Success"/> is <c>true</c>).</param>
+        /// <param name="expiry">When the file will no longer be available.</param>
+        /// <param name="warning">The error message if saving succeeded, but a non-blocking issue was encountered.</param>
+        /// <param name="error">The error message if saving failed.</param>
+        public StoredFileInfo(string? content, DateTimeOffset? expiry, string? warning = null, string? error = null)
+        {
+            this.Content = content;
+            this.Expiry = expiry;
+            this.Warning = warning;
+            this.Error = error;
+        }
+
+        /// <summary>Construct an instance.</summary>
+        /// <param name="error">The error message if saving failed.</param>
+        public StoredFileInfo(string error)
+        {
+            this.Error = error;
+        }
     }
 }
diff --git a/src/SMAPI.Web/Framework/Storage/UploadResult.cs b/src/SMAPI.Web/Framework/Storage/UploadResult.cs
index b1eedd59..92993d42 100644
--- a/src/SMAPI.Web/Framework/Storage/UploadResult.cs
+++ b/src/SMAPI.Web/Framework/Storage/UploadResult.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Web.Framework.Storage
 {
@@ -9,25 +9,25 @@ namespace StardewModdingAPI.Web.Framework.Storage
         ** Accessors
         *********/
         /// <summary>Whether the file upload succeeded.</summary>
-        public bool Succeeded { get; }
+        [MemberNotNullWhen(true, nameof(UploadResult.ID))]
+        [MemberNotNullWhen(false, nameof(UploadResult.UploadError))]
+        public bool Succeeded => this.ID != null && this.UploadError == null;
 
         /// <summary>The file ID, if applicable.</summary>
-        public string ID { get; }
+        public string? ID { get; }
 
         /// <summary>The upload error, if any.</summary>
-        public string UploadError { get; }
+        public string? UploadError { get; }
 
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="succeeded">Whether the file upload succeeded.</param>
         /// <param name="id">The file ID, if applicable.</param>
         /// <param name="uploadError">The upload error, if any.</param>
-        public UploadResult(bool succeeded, string id, string uploadError)
+        public UploadResult(string? id, string? uploadError)
         {
-            this.Succeeded = succeeded;
             this.ID = id;
             this.UploadError = uploadError;
         }
diff --git a/src/SMAPI.Web/Framework/VersionConstraint.cs b/src/SMAPI.Web/Framework/VersionConstraint.cs
index f230a95b..1b1abd81 100644
--- a/src/SMAPI.Web/Framework/VersionConstraint.cs
+++ b/src/SMAPI.Web/Framework/VersionConstraint.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Routing;
@@ -20,7 +18,7 @@ namespace StardewModdingAPI.Web.Framework
         /// <param name="values">A dictionary that contains the parameters for the URL.</param>
         /// <param name="routeDirection">An object that indicates whether the constraint check is being performed when an incoming request is being handled or when a URL is being generated.</param>
         /// <returns><c>true</c> if the URL parameter contains a valid value; otherwise, <c>false</c>.</returns>
-        public bool Match(HttpContext httpContext, IRouter route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection)
+        public bool Match(HttpContext? httpContext, IRouter? route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection)
         {
             if (routeKey == null)
                 throw new ArgumentNullException(nameof(routeKey));
@@ -28,7 +26,7 @@ namespace StardewModdingAPI.Web.Framework
                 throw new ArgumentNullException(nameof(values));
 
             return
-                values.TryGetValue(routeKey, out object routeValue)
+                values.TryGetValue(routeKey, out object? routeValue)
                 && routeValue is string routeStr
                 && SemanticVersion.TryParse(routeStr, allowNonStandard: true, out _);
         }
diff --git a/src/SMAPI.Web/Program.cs b/src/SMAPI.Web/Program.cs
index 5134791a..1fdd3185 100644
--- a/src/SMAPI.Web/Program.cs
+++ b/src/SMAPI.Web/Program.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.Extensions.Hosting;
 
diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index 0199938d..98dbca5e 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Net;
 using Hangfire;
@@ -102,7 +100,7 @@ namespace StardewModdingAPI.Web
             // init API clients
             {
                 ApiClientsConfig api = this.Configuration.GetSection("ApiClients").Get<ApiClientsConfig>();
-                string version = this.GetType().Assembly.GetName().Version.ToString(3);
+                string version = this.GetType().Assembly.GetName().Version!.ToString(3);
                 string userAgent = string.Format(api.UserAgent, version);
 
                 services.AddSingleton<IChucklefishClient>(new ChucklefishClient(
diff --git a/src/SMAPI.Web/ViewModels/IndexModel.cs b/src/SMAPI.Web/ViewModels/IndexModel.cs
index 2283acd9..098f18cc 100644
--- a/src/SMAPI.Web/ViewModels/IndexModel.cs
+++ b/src/SMAPI.Web/ViewModels/IndexModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.ViewModels
 {
     /// <summary>The view model for the index page.</summary>
@@ -9,26 +7,23 @@ namespace StardewModdingAPI.Web.ViewModels
         ** Accessors
         *********/
         /// <summary>The latest stable SMAPI version.</summary>
-        public IndexVersionModel StableVersion { get; set; }
+        public IndexVersionModel StableVersion { get; }
 
         /// <summary>A message to show below the download button (e.g. for details on downloading a beta version), in Markdown format.</summary>
-        public string OtherBlurb { get; set; }
+        public string? OtherBlurb { get; }
 
         /// <summary>A list of supports to credit on the main page, in Markdown format.</summary>
-        public string SupporterList { get; set; }
+        public string? SupporterList { get; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public IndexModel() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="stableVersion">The latest stable SMAPI version.</param>
         /// <param name="otherBlurb">A message to show below the download button (e.g. for details on downloading a beta version), in Markdown format.</param>
         /// <param name="supporterList">A list of supports to credit on the main page, in Markdown format.</param>
-        internal IndexModel(IndexVersionModel stableVersion, string otherBlurb, string supporterList)
+        internal IndexModel(IndexVersionModel stableVersion, string? otherBlurb, string? supporterList)
         {
             this.StableVersion = stableVersion;
             this.OtherBlurb = otherBlurb;
diff --git a/src/SMAPI.Web/ViewModels/IndexVersionModel.cs b/src/SMAPI.Web/ViewModels/IndexVersionModel.cs
index 1f5d4ec0..a76a5924 100644
--- a/src/SMAPI.Web/ViewModels/IndexVersionModel.cs
+++ b/src/SMAPI.Web/ViewModels/IndexVersionModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.ViewModels
 {
     /// <summary>The fields for a SMAPI version.</summary>
@@ -9,30 +7,27 @@ namespace StardewModdingAPI.Web.ViewModels
         ** Accessors
         *********/
         /// <summary>The release version.</summary>
-        public string Version { get; set; }
+        public string Version { get; }
 
         /// <summary>The Markdown description for the release.</summary>
-        public string Description { get; set; }
+        public string Description { get; }
 
         /// <summary>The main download URL.</summary>
-        public string DownloadUrl { get; set; }
+        public string DownloadUrl { get; }
 
         /// <summary>The for-developers download URL (not applicable for prerelease versions).</summary>
-        public string DevDownloadUrl { get; set; }
+        public string? DevDownloadUrl { get; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public IndexVersionModel() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="version">The release number.</param>
         /// <param name="description">The Markdown description for the release.</param>
         /// <param name="downloadUrl">The main download URL.</param>
         /// <param name="devDownloadUrl">The for-developers download URL (not applicable for prerelease versions).</param>
-        internal IndexVersionModel(string version, string description, string downloadUrl, string devDownloadUrl)
+        internal IndexVersionModel(string version, string description, string downloadUrl, string? devDownloadUrl)
         {
             this.Version = version;
             this.Description = description;
diff --git a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorErrorModel.cs b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorErrorModel.cs
index 3c63b730..4d37d449 100644
--- a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorErrorModel.cs
+++ b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorErrorModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Newtonsoft.Json.Schema;
 
 namespace StardewModdingAPI.Web.ViewModels.JsonValidator
@@ -11,30 +9,27 @@ namespace StardewModdingAPI.Web.ViewModels.JsonValidator
         ** Accessors
         *********/
         /// <summary>The line number on which the error occurred.</summary>
-        public int Line { get; set; }
+        public int Line { get; }
 
         /// <summary>The field path in the JSON file where the error occurred.</summary>
-        public string Path { get; set; }
+        public string? Path { get; }
 
         /// <summary>A human-readable description of the error.</summary>
-        public string Message { get; set; }
+        public string Message { get; }
 
         /// <summary>The schema error type.</summary>
-        public ErrorType SchemaErrorType { get; set; }
+        public ErrorType SchemaErrorType { get; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public JsonValidatorErrorModel() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="line">The line number on which the error occurred.</param>
         /// <param name="path">The field path in the JSON file where the error occurred.</param>
         /// <param name="message">A human-readable description of the error.</param>
         /// <param name="schemaErrorType">The schema error type.</param>
-        public JsonValidatorErrorModel(int line, string path, string message, ErrorType schemaErrorType)
+        public JsonValidatorErrorModel(int line, string? path, string message, ErrorType schemaErrorType)
         {
             this.Line = line;
             this.Path = path;
diff --git a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
index 2543807f..85c2f44d 100644
--- a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
+++ b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -13,51 +11,48 @@ namespace StardewModdingAPI.Web.ViewModels.JsonValidator
         ** Accessors
         *********/
         /// <summary>Whether to show the edit view.</summary>
-        public bool IsEditView { get; set; }
+        public bool IsEditView { get; }
 
         /// <summary>The paste ID.</summary>
-        public string PasteID { get; set; }
+        public string? PasteID { get; }
 
         /// <summary>The schema name with which the JSON was validated.</summary>
-        public string SchemaName { get; set; }
+        public string? SchemaName { get; }
 
         /// <summary>The supported JSON schemas (names indexed by ID).</summary>
-        public readonly IDictionary<string, string> SchemaFormats;
+        public IDictionary<string, string> SchemaFormats { get; }
 
         /// <summary>The validated content.</summary>
-        public string Content { get; set; }
+        public string? Content { get; set; }
 
         /// <summary>The schema validation errors, if any.</summary>
         public JsonValidatorErrorModel[] Errors { get; set; } = Array.Empty<JsonValidatorErrorModel>();
 
         /// <summary>A non-blocking warning while uploading the file.</summary>
-        public string UploadWarning { get; set; }
+        public string? UploadWarning { get; set; }
 
         /// <summary>When the uploaded file will no longer be available.</summary>
-        public DateTime? Expiry { get; set; }
+        public DateTimeOffset? Expiry { get; set; }
 
         /// <summary>An error which occurred while uploading the JSON.</summary>
-        public string UploadError { get; set; }
+        public string? UploadError { get; set; }
 
         /// <summary>An error which occurred while parsing the JSON.</summary>
-        public string ParseError { get; set; }
+        public string? ParseError { get; set; }
 
         /// <summary>A web URL to the user-facing format documentation.</summary>
-        public string FormatUrl { get; set; }
+        public string? FormatUrl { get; set; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public JsonValidatorModel() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="pasteID">The stored file ID.</param>
         /// <param name="schemaName">The schema name with which the JSON was validated.</param>
         /// <param name="schemaFormats">The supported JSON schemas (names indexed by ID).</param>
         /// <param name="isEditView">Whether to show the edit view.</param>
-        public JsonValidatorModel(string pasteID, string schemaName, IDictionary<string, string> schemaFormats, bool isEditView)
+        public JsonValidatorModel(string? pasteID, string? schemaName, IDictionary<string, string> schemaFormats, bool isEditView)
         {
             this.PasteID = pasteID;
             this.SchemaName = schemaName;
@@ -69,7 +64,7 @@ namespace StardewModdingAPI.Web.ViewModels.JsonValidator
         /// <param name="content">The validated content.</param>
         /// <param name="expiry">When the uploaded file will no longer be available.</param>
         /// <param name="uploadWarning">A non-blocking warning while uploading the log.</param>
-        public JsonValidatorModel SetContent(string content, DateTime? expiry, string uploadWarning = null)
+        public JsonValidatorModel SetContent(string content, DateTimeOffset? expiry, string? uploadWarning = null)
         {
             this.Content = content;
             this.Expiry = expiry;
diff --git a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
index 43114d94..3edb58db 100644
--- a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
+++ b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.ViewModels.JsonValidator
 {
     /// <summary>The view model for a JSON validation request.</summary>
@@ -9,9 +7,22 @@ namespace StardewModdingAPI.Web.ViewModels.JsonValidator
         ** Accessors
         *********/
         /// <summary>The schema name with which to validate the JSON.</summary>
-        public string SchemaName { get; set; }
+        public string SchemaName { get; }
 
         /// <summary>The raw content to validate.</summary>
-        public string Content { get; set; }
+        public string Content { get; }
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="schemaName">The schema name with which to validate the JSON.</param>
+        /// <param name="content">The raw content to validate.</param>
+        public JsonValidatorRequestModel(string schemaName, string content)
+        {
+            this.SchemaName = schemaName;
+            this.Content = content;
+        }
     }
 }
diff --git a/src/SMAPI.Web/ViewModels/LogParserModel.cs b/src/SMAPI.Web/ViewModels/LogParserModel.cs
index d7e4d810..c39a9b0a 100644
--- a/src/SMAPI.Web/ViewModels/LogParserModel.cs
+++ b/src/SMAPI.Web/ViewModels/LogParserModel.cs
@@ -44,7 +44,7 @@ namespace StardewModdingAPI.Web.ViewModels
         public string? ParseError => this.ParsedLog?.Error;
 
         /// <summary>When the uploaded file will no longer be available.</summary>
-        public DateTime? Expiry { get; set; }
+        public DateTimeOffset? Expiry { get; set; }
 
         /// <summary>Whether parsed log data is available.</summary>
         [MemberNotNullWhen(true, nameof(LogParserModel.PasteID), nameof(LogParserModel.ParsedLog))]
diff --git a/src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs b/src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs
index 2af30cc3..36ea891d 100644
--- a/src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs
+++ b/src/SMAPI.Web/ViewModels/ModCompatibilityModel.cs
@@ -1,5 +1,4 @@
-#nullable disable
-
+using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
 
 namespace StardewModdingAPI.Web.ViewModels
@@ -11,21 +10,35 @@ namespace StardewModdingAPI.Web.ViewModels
         ** Accessors
         *********/
         /// <summary>The compatibility status, as a string like <c>"Broken"</c>.</summary>
-        public string Status { get; set; }
+        public string Status { get; }
 
         /// <summary>The human-readable summary, as an HTML block.</summary>
-        public string Summary { get; set; }
+        public string? Summary { get; }
 
         /// <summary>The game or SMAPI version which broke this mod (if applicable).</summary>
-        public string BrokeIn { get; set; }
+        public string? BrokeIn { get; }
 
         /// <summary>A link to the unofficial version which fixes compatibility, if any.</summary>
-        public ModLinkModel UnofficialVersion { get; set; }
+        public ModLinkModel? UnofficialVersion { get; }
 
 
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="status">The compatibility status, as a string like <c>"Broken"</c>.</param>
+        /// <param name="summary">The human-readable summary, as an HTML block.</param>
+        /// <param name="brokeIn">The game or SMAPI version which broke this mod (if applicable).</param>
+        /// <param name="unofficialVersion">A link to the unofficial version which fixes compatibility, if any.</param>
+        [JsonConstructor]
+        public ModCompatibilityModel(string status, string? summary, string? brokeIn, ModLinkModel? unofficialVersion)
+        {
+            this.Status = status;
+            this.Summary = summary;
+            this.BrokeIn = brokeIn;
+            this.UnofficialVersion = unofficialVersion;
+        }
+
         /// <summary>Construct an instance.</summary>
         /// <param name="info">The mod metadata.</param>
         public ModCompatibilityModel(WikiCompatibilityInfo info)
@@ -36,7 +49,7 @@ namespace StardewModdingAPI.Web.ViewModels
             this.Summary = info.Summary;
             this.BrokeIn = info.BrokeIn;
             if (info.UnofficialVersion != null)
-                this.UnofficialVersion = new ModLinkModel(info.UnofficialUrl, info.UnofficialVersion.ToString());
+                this.UnofficialVersion = new ModLinkModel(info.UnofficialUrl!, info.UnofficialVersion.ToString());
         }
     }
 }
diff --git a/src/SMAPI.Web/ViewModels/ModLinkModel.cs b/src/SMAPI.Web/ViewModels/ModLinkModel.cs
index 3039702e..96f14d48 100644
--- a/src/SMAPI.Web/ViewModels/ModLinkModel.cs
+++ b/src/SMAPI.Web/ViewModels/ModLinkModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Web.ViewModels
 {
     /// <summary>Metadata about a link.</summary>
@@ -9,10 +7,10 @@ namespace StardewModdingAPI.Web.ViewModels
         ** Accessors
         *********/
         /// <summary>The URL of the linked page.</summary>
-        public string Url { get; set; }
+        public string Url { get; }
 
         /// <summary>The suggested link text.</summary>
-        public string Text { get; set; }
+        public string Text { get; }
 
 
         /*********
diff --git a/src/SMAPI.Web/ViewModels/ModListModel.cs b/src/SMAPI.Web/ViewModels/ModListModel.cs
index f0cf0c3a..be9f973a 100644
--- a/src/SMAPI.Web/ViewModels/ModListModel.cs
+++ b/src/SMAPI.Web/ViewModels/ModListModel.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -13,37 +11,34 @@ namespace StardewModdingAPI.Web.ViewModels
         ** Accessors
         *********/
         /// <summary>The current stable version of the game.</summary>
-        public string StableVersion { get; set; }
+        public string? StableVersion { get; }
 
         /// <summary>The current beta version of the game (if any).</summary>
-        public string BetaVersion { get; set; }
+        public string? BetaVersion { get; }
 
         /// <summary>The mods to display.</summary>
-        public ModModel[] Mods { get; set; }
+        public ModModel[] Mods { get; }
 
         /// <summary>When the data was last updated.</summary>
-        public DateTimeOffset LastUpdated { get; set; }
+        public DateTimeOffset LastUpdated { get; }
 
         /// <summary>Whether the data hasn't been updated in a while.</summary>
-        public bool IsStale { get; set; }
+        public bool IsStale { get; }
 
         /// <summary>Whether the mod metadata is available.</summary>
-        public bool HasData => this.Mods?.Any() == true;
+        public bool HasData => this.Mods.Any();
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an empty instance.</summary>
-        public ModListModel() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="stableVersion">The current stable version of the game.</param>
         /// <param name="betaVersion">The current beta version of the game (if any).</param>
         /// <param name="mods">The mods to display.</param>
         /// <param name="lastUpdated">When the data was last updated.</param>
         /// <param name="isStale">Whether the data hasn't been updated in a while.</param>
-        public ModListModel(string stableVersion, string betaVersion, IEnumerable<ModModel> mods, DateTimeOffset lastUpdated, bool isStale)
+        public ModListModel(string? stableVersion, string? betaVersion, IEnumerable<ModModel> mods, DateTimeOffset lastUpdated, bool isStale)
         {
             this.StableVersion = stableVersion;
             this.BetaVersion = betaVersion;
diff --git a/src/SMAPI.Web/ViewModels/ModModel.cs b/src/SMAPI.Web/ViewModels/ModModel.cs
index d0d7373b..929bf682 100644
--- a/src/SMAPI.Web/ViewModels/ModModel.cs
+++ b/src/SMAPI.Web/ViewModels/ModModel.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Linq;
+using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Framework.Clients.Wiki;
 
 namespace StardewModdingAPI.Web.ViewModels
@@ -13,43 +12,43 @@ namespace StardewModdingAPI.Web.ViewModels
         ** Accessors
         *********/
         /// <summary>The mod name.</summary>
-        public string Name { get; set; }
+        public string? Name { get; }
 
         /// <summary>The mod's alternative names, if any.</summary>
-        public string AlternateNames { get; set; }
+        public string AlternateNames { get; }
 
         /// <summary>The mod author's name.</summary>
-        public string Author { get; set; }
+        public string? Author { get; }
 
         /// <summary>The mod author's alternative names, if any.</summary>
-        public string AlternateAuthors { get; set; }
+        public string AlternateAuthors { get; }
 
         /// <summary>The GitHub repo, if any.</summary>
-        public string GitHubRepo { get; set; }
+        public string? GitHubRepo { get; }
 
         /// <summary>The URL to the mod's source code, if any.</summary>
-        public string SourceUrl { get; set; }
+        public string? SourceUrl { get; }
 
         /// <summary>The compatibility status for the stable version of the game.</summary>
-        public ModCompatibilityModel Compatibility { get; set; }
+        public ModCompatibilityModel Compatibility { get; }
 
         /// <summary>The compatibility status for the beta version of the game.</summary>
-        public ModCompatibilityModel BetaCompatibility { get; set; }
+        public ModCompatibilityModel? BetaCompatibility { get; }
 
         /// <summary>Links to the available mod pages.</summary>
-        public ModLinkModel[] ModPages { get; set; }
+        public ModLinkModel[] ModPages { get; }
 
         /// <summary>The human-readable warnings for players about this mod.</summary>
-        public string[] Warnings { get; set; }
+        public string[] Warnings { get; }
 
         /// <summary>The URL of the pull request which submits changes for an unofficial update to the author, if any.</summary>
-        public string PullRequestUrl { get; set; }
+        public string? PullRequestUrl { get; }
 
-        /// <summary>Special notes intended for developers who maintain unofficial updates or submit pull requests. </summary>
-        public string DevNote { get; set; }
+        /// <summary>Special notes intended for developers who maintain unofficial updates or submit pull requests.</summary>
+        public string? DevNote { get; }
 
         /// <summary>A unique identifier for the mod that can be used in an anchor URL.</summary>
-        public string Slug { get; set; }
+        public string? Slug { get; }
 
         /// <summary>The sites where the mod can be downloaded.</summary>
         public string[] ModPageSites => this.ModPages.Select(p => p.Text).ToArray();
@@ -58,6 +57,38 @@ namespace StardewModdingAPI.Web.ViewModels
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="name">The mod name.</param>
+        /// <param name="alternateNames">The mod's alternative names, if any.</param>
+        /// <param name="author">The mod author's name.</param>
+        /// <param name="alternateAuthors">The mod author's alternative names, if any.</param>
+        /// <param name="gitHubRepo">The GitHub repo, if any.</param>
+        /// <param name="sourceUrl">The URL to the mod's source code, if any.</param>
+        /// <param name="compatibility">The compatibility status for the stable version of the game.</param>
+        /// <param name="betaCompatibility">The compatibility status for the beta version of the game.</param>
+        /// <param name="modPages">Links to the available mod pages.</param>
+        /// <param name="warnings">The human-readable warnings for players about this mod.</param>
+        /// <param name="pullRequestUrl">The URL of the pull request which submits changes for an unofficial update to the author, if any.</param>
+        /// <param name="devNote">Special notes intended for developers who maintain unofficial updates or submit pull requests.</param>
+        /// <param name="slug">A unique identifier for the mod that can be used in an anchor URL.</param>
+        [JsonConstructor]
+        public ModModel(string? name, string alternateNames, string author, string alternateAuthors, string gitHubRepo, string sourceUrl, ModCompatibilityModel compatibility, ModCompatibilityModel betaCompatibility, ModLinkModel[] modPages, string[] warnings, string pullRequestUrl, string devNote, string slug)
+        {
+            this.Name = name;
+            this.AlternateNames = alternateNames;
+            this.Author = author;
+            this.AlternateAuthors = alternateAuthors;
+            this.GitHubRepo = gitHubRepo;
+            this.SourceUrl = sourceUrl;
+            this.Compatibility = compatibility;
+            this.BetaCompatibility = betaCompatibility;
+            this.ModPages = modPages;
+            this.Warnings = warnings;
+            this.PullRequestUrl = pullRequestUrl;
+            this.DevNote = devNote;
+            this.Slug = slug;
+        }
+
         /// <summary>Construct an instance.</summary>
         /// <param name="entry">The mod metadata.</param>
         public ModModel(WikiModEntry entry)
@@ -84,7 +115,7 @@ namespace StardewModdingAPI.Web.ViewModels
         *********/
         /// <summary>Get the web URL for the mod's source code repository, if any.</summary>
         /// <param name="entry">The mod metadata.</param>
-        private string GetSourceUrl(WikiModEntry entry)
+        private string? GetSourceUrl(WikiModEntry entry)
         {
             if (!string.IsNullOrWhiteSpace(entry.GitHubRepo))
                 return $"https://github.com/{entry.GitHubRepo}";
diff --git a/src/SMAPI.Web/Views/Index/Index.cshtml b/src/SMAPI.Web/Views/Index/Index.cshtml
index 9841ca42..acb8df78 100644
--- a/src/SMAPI.Web/Views/Index/Index.cshtml
+++ b/src/SMAPI.Web/Views/Index/Index.cshtml
@@ -1,7 +1,3 @@
-@{
-    #nullable disable
-}
-
 @using Microsoft.Extensions.Options
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.Framework.ConfigModels
@@ -28,7 +24,7 @@
 
 <div id="call-to-action">
     <div class="cta-dropdown">
-        <a href="@Model.StableVersion.DownloadUrl" class="main-cta download">Download SMAPI @Model.StableVersion.Version</a><br />
+        <a href="@Model!.StableVersion.DownloadUrl" class="main-cta download">Download SMAPI @Model.StableVersion.Version</a><br />
         <div class="dropdown-content">
             <a href="https://www.nexusmods.com/stardewvalley/mods/2400"><img src="Content/images/nexus-icon.png" /> Download from Nexus</a>
             <a href="@Model.StableVersion.DownloadUrl"><img src="Content/images/direct-download-icon.png" /> Direct download</a>
diff --git a/src/SMAPI.Web/Views/Index/Privacy.cshtml b/src/SMAPI.Web/Views/Index/Privacy.cshtml
index 1dc327d7..fd78f908 100644
--- a/src/SMAPI.Web/Views/Index/Privacy.cshtml
+++ b/src/SMAPI.Web/Views/Index/Privacy.cshtml
@@ -1,7 +1,3 @@
-@{
-    #nullable disable
-}
-
 @using Microsoft.Extensions.Options
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.Framework.ConfigModels
diff --git a/src/SMAPI.Web/Views/JsonValidator/Index.cshtml b/src/SMAPI.Web/Views/JsonValidator/Index.cshtml
index 5e38e4dc..f5ec0f7a 100644
--- a/src/SMAPI.Web/Views/JsonValidator/Index.cshtml
+++ b/src/SMAPI.Web/Views/JsonValidator/Index.cshtml
@@ -1,7 +1,3 @@
-@{
-    #nullable disable
-}
-
 @using Humanizer
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.ViewModels.JsonValidator
@@ -9,10 +5,10 @@
 
 @{
     // get view data
-    string curPageUrl = this.Url.PlainAction("Index", "JsonValidator", new { schemaName = Model.SchemaName, id = Model.PasteID }, absoluteUrl: true);
-    string newUploadUrl = this.Url.PlainAction("Index", "JsonValidator", new { schemaName = Model.SchemaName });
-    string schemaDisplayName = null;
-    bool isValidSchema = Model.SchemaName != null && Model.SchemaFormats.TryGetValue(Model.SchemaName, out schemaDisplayName) && schemaDisplayName?.ToLower() != "none";
+    string curPageUrl = this.Url.PlainAction("Index", "JsonValidator", new { schemaName = Model!.SchemaName, id = Model.PasteID }, absoluteUrl: true)!;
+    string newUploadUrl = this.Url.PlainAction("Index", "JsonValidator", new { schemaName = Model.SchemaName })!;
+    string? schemaDisplayName = null;
+    bool isValidSchema = Model.SchemaName != null && Model.SchemaFormats.TryGetValue(Model.SchemaName, out schemaDisplayName) && schemaDisplayName.ToLower() != "none";
 
     // build title
     ViewData["Title"] = "JSON validator";
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 6c9feb43..2cf7d1e7 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -23,7 +23,7 @@
         .GetValues<LogSection>()
         .ToDictionary(section => (int)section, section => section.ToString());
 
-    string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true);
+    string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true)!;
 
     ISet<int> screenIds = new HashSet<int>(log?.Messages.Select(p => p.ScreenId) ?? Array.Empty<int>());
 }
diff --git a/src/SMAPI.Web/Views/Mods/Index.cshtml b/src/SMAPI.Web/Views/Mods/Index.cshtml
index 4b6400ad..78eabad7 100644
--- a/src/SMAPI.Web/Views/Mods/Index.cshtml
+++ b/src/SMAPI.Web/Views/Mods/Index.cshtml
@@ -1,7 +1,3 @@
-@{
-    #nullable disable
-}
-
 @using Humanizer
 @using Humanizer.Localisation
 @using StardewModdingAPI.Web.Framework
@@ -10,7 +6,7 @@
 @{
     ViewData["Title"] = "Mod compatibility";
 
-    TimeSpan staleAge = DateTimeOffset.UtcNow - Model.LastUpdated;
+    TimeSpan staleAge = DateTimeOffset.UtcNow - Model!.LastUpdated;
 
     bool hasBeta = Model.BetaVersion != null;
     string betaLabel = $"SDV {Model.BetaVersion} only";
diff --git a/src/SMAPI.Web/Views/Shared/_Layout.cshtml b/src/SMAPI.Web/Views/Shared/_Layout.cshtml
index 7c86a68c..67dcd3b3 100644
--- a/src/SMAPI.Web/Views/Shared/_Layout.cshtml
+++ b/src/SMAPI.Web/Views/Shared/_Layout.cshtml
@@ -1,7 +1,3 @@
-@{
-    #nullable disable
-}
-
 @using Microsoft.Extensions.Options
 @using StardewModdingAPI.Web.Framework
 @using StardewModdingAPI.Web.Framework.ConfigModels
diff --git a/src/SMAPI.Web/Views/_ViewStart.cshtml b/src/SMAPI.Web/Views/_ViewStart.cshtml
index 0dbac246..820a2f6e 100644
--- a/src/SMAPI.Web/Views/_ViewStart.cshtml
+++ b/src/SMAPI.Web/Views/_ViewStart.cshtml
@@ -1,7 +1,3 @@
-@{
-    #nullable disable
-}
-
 @{
     Layout = "_Layout";
 }
diff --git a/src/SMAPI.Web/appsettings.json b/src/SMAPI.Web/appsettings.json
index 0265a928..1231f824 100644
--- a/src/SMAPI.Web/appsettings.json
+++ b/src/SMAPI.Web/appsettings.json
@@ -17,7 +17,8 @@
 
     "Site": {
         "BetaEnabled": false,
-        "OtherBlurb": null
+        "OtherBlurb": null,
+        "SupporterList": null
     },
 
     "ApiClients": {
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index 5cb13525..866f2ed3 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -35,6 +35,7 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=debounced/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=decoratable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=devs/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=disambiguator/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=fallbacks/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=filenames/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gamepad/@EntryIndexedValue">True</s:Boolean>
diff --git a/src/SMAPI/SemanticVersion.cs b/src/SMAPI/SemanticVersion.cs
index 7a6cdcdd..81e526e7 100644
--- a/src/SMAPI/SemanticVersion.cs
+++ b/src/SMAPI/SemanticVersion.cs
@@ -85,6 +85,9 @@ namespace StardewModdingAPI
         }
 
         /// <inheritdoc />
+#if NET5_0_OR_GREATER
+        [MemberNotNullWhen(true, nameof(SemanticVersion.PrereleaseTag))]
+#endif
         public bool IsPrerelease()
         {
             return this.Version.IsPrerelease();

From 4e0e928c943bc2d5f1bec27c117a648f55ab5894 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 12 Apr 2022 19:19:37 -0400
Subject: [PATCH 541/856] remove `#nullable disable` in mod build package
 (#837)

Since it targets .NET Standard 2.0, they're not available anyway.
---
 src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs    | 8 +++-----
 src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs     | 2 --
 .../ObsoleteFieldAnalyzer.cs                              | 2 --
 src/SMAPI.ModBuildConfig/DeployModTask.cs                 | 2 --
 src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs      | 2 --
 src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs  | 2 --
 6 files changed, 3 insertions(+), 15 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs b/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
index 1cc37b38..2e34cf71 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/AnalyzerUtilities.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.CSharp;
@@ -42,8 +40,8 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
 
             // invalid
             fromExpression = null;
-            fromType = default(TypeInfo);
-            toType = default(TypeInfo);
+            fromType = default;
+            toType = default;
             return false;
         }
 
@@ -76,7 +74,7 @@ namespace StardewModdingAPI.ModBuildConfig.Analyzer
 
             // invalid
             declaringType = null;
-            memberType = default(TypeInfo);
+            memberType = default;
             memberName = null;
             return false;
         }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
index cb2856da..553aae99 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/NetFieldAnalyzer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
index 158d7243..ba089513 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer/ObsoleteFieldAnalyzer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index 43fac9d5..c7026ee1 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index ad2c0de3..80955f67 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs b/src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs
index 588118ef..64e31c29 100644
--- a/src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/UserErrorException.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.ModBuildConfig.Framework

From c3851ae2e6c8fb286d4744612fbfea039d1baf7f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 12 Apr 2022 19:56:52 -0400
Subject: [PATCH 542/856] enable nullable annotations in shared projects (#837)

---
 src/SMAPI.Internal.Patching/BasePatcher.cs    |  6 ++---
 src/SMAPI.Internal.Patching/HarmonyPatcher.cs |  2 --
 src/SMAPI.Internal.Patching/IPatcher.cs       |  2 --
 src/SMAPI.Internal.Patching/PatchHelper.cs    |  8 +++----
 .../ConsoleWriting/ColorSchemeConfig.cs       | 22 +++++++++++++++----
 .../ConsoleWriting/ColorfulConsoleWriter.cs   | 19 ++++++++--------
 .../ConsoleWriting/IConsoleWriter.cs          |  2 --
 src/SMAPI.Internal/ExceptionHelper.cs         |  6 ++---
 8 files changed, 34 insertions(+), 33 deletions(-)

diff --git a/src/SMAPI.Internal.Patching/BasePatcher.cs b/src/SMAPI.Internal.Patching/BasePatcher.cs
index 6d019b52..c1936ccc 100644
--- a/src/SMAPI.Internal.Patching/BasePatcher.cs
+++ b/src/SMAPI.Internal.Patching/BasePatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 using HarmonyLib;
@@ -32,7 +30,7 @@ namespace StardewModdingAPI.Internal.Patching
         /// <param name="name">The method name.</param>
         /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
         /// <param name="generics">The method generic types, or <c>null</c> if it's not generic.</param>
-        protected MethodInfo RequireMethod<TTarget>(string name, Type[] parameters = null, Type[] generics = null)
+        protected MethodInfo RequireMethod<TTarget>(string name, Type[]? parameters = null, Type[]? generics = null)
         {
             return PatchHelper.RequireMethod<TTarget>(name, parameters, generics);
         }
@@ -42,7 +40,7 @@ namespace StardewModdingAPI.Internal.Patching
         /// <param name="priority">The patch priority to apply, usually specified using Harmony's <see cref="Priority"/> enum, or <c>null</c> to keep the default value.</param>
         protected HarmonyMethod GetHarmonyMethod(string name, int? priority = null)
         {
-            var method = new HarmonyMethod(
+            HarmonyMethod method = new(
                 AccessTools.Method(this.GetType(), name)
                 ?? throw new InvalidOperationException($"Can't find patcher method {PatchHelper.GetMethodString(this.GetType(), name)}.")
             );
diff --git a/src/SMAPI.Internal.Patching/HarmonyPatcher.cs b/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
index fc239fd2..6f30c241 100644
--- a/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
+++ b/src/SMAPI.Internal.Patching/HarmonyPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using HarmonyLib;
 
diff --git a/src/SMAPI.Internal.Patching/IPatcher.cs b/src/SMAPI.Internal.Patching/IPatcher.cs
index 5b373117..a732d64f 100644
--- a/src/SMAPI.Internal.Patching/IPatcher.cs
+++ b/src/SMAPI.Internal.Patching/IPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using HarmonyLib;
 
 namespace StardewModdingAPI.Internal.Patching
diff --git a/src/SMAPI.Internal.Patching/PatchHelper.cs b/src/SMAPI.Internal.Patching/PatchHelper.cs
index 52b15fd1..edd8ef57 100644
--- a/src/SMAPI.Internal.Patching/PatchHelper.cs
+++ b/src/SMAPI.Internal.Patching/PatchHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Linq;
 using System.Reflection;
@@ -18,7 +16,7 @@ namespace StardewModdingAPI.Internal.Patching
         /// <typeparam name="TTarget">The type containing the method.</typeparam>
         /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
         /// <exception cref="InvalidOperationException">The type has no matching constructor.</exception>
-        public static ConstructorInfo RequireConstructor<TTarget>(Type[] parameters = null)
+        public static ConstructorInfo RequireConstructor<TTarget>(Type[]? parameters = null)
         {
             return
                 AccessTools.Constructor(typeof(TTarget), parameters)
@@ -31,7 +29,7 @@ namespace StardewModdingAPI.Internal.Patching
         /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
         /// <param name="generics">The method generic types, or <c>null</c> if it's not generic.</param>
         /// <exception cref="InvalidOperationException">The type has no matching method.</exception>
-        public static MethodInfo RequireMethod<TTarget>(string name, Type[] parameters = null, Type[] generics = null)
+        public static MethodInfo RequireMethod<TTarget>(string name, Type[]? parameters = null, Type[]? generics = null)
         {
             return
                 AccessTools.Method(typeof(TTarget), name, parameters, generics)
@@ -43,7 +41,7 @@ namespace StardewModdingAPI.Internal.Patching
         /// <param name="name">The method name, or <c>null</c> for a constructor.</param>
         /// <param name="parameters">The method parameter types, or <c>null</c> if it's not overloaded.</param>
         /// <param name="generics">The method generic types, or <c>null</c> if it's not generic.</param>
-        public static string GetMethodString(Type type, string name, Type[] parameters = null, Type[] generics = null)
+        public static string GetMethodString(Type type, string? name, Type[]? parameters = null, Type[]? generics = null)
         {
             StringBuilder str = new();
 
diff --git a/src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs b/src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs
index b22aa231..4e5850ea 100644
--- a/src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs
+++ b/src/SMAPI.Internal/ConsoleWriting/ColorSchemeConfig.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 
@@ -8,10 +6,26 @@ namespace StardewModdingAPI.Internal.ConsoleWriting
     /// <summary>The console color scheme options.</summary>
     internal class ColorSchemeConfig
     {
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The default color scheme ID to use, or <see cref="MonitorColorScheme.AutoDetect"/> to select one automatically.</summary>
-        public MonitorColorScheme UseScheme { get; set; }
+        public MonitorColorScheme UseScheme { get; }
 
         /// <summary>The available console color schemes.</summary>
-        public IDictionary<MonitorColorScheme, IDictionary<ConsoleLogLevel, ConsoleColor>> Schemes { get; set; }
+        public IDictionary<MonitorColorScheme, IDictionary<ConsoleLogLevel, ConsoleColor>> Schemes { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="useScheme">The default color scheme ID to use, or <see cref="MonitorColorScheme.AutoDetect"/> to select one automatically.</param>
+        /// <param name="schemes">The available console color schemes.</param>
+        public ColorSchemeConfig(MonitorColorScheme useScheme, IDictionary<MonitorColorScheme, IDictionary<ConsoleLogLevel, ConsoleColor>> schemes)
+        {
+            this.UseScheme = useScheme;
+            this.Schemes = schemes;
+        }
     }
 }
diff --git a/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs b/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
index 19a31c7b..78db0d65 100644
--- a/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
+++ b/src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Internal.ConsoleWriting
@@ -13,10 +12,11 @@ namespace StardewModdingAPI.Internal.ConsoleWriting
         ** Fields
         *********/
         /// <summary>The console text color for each log level.</summary>
-        private readonly IDictionary<ConsoleLogLevel, ConsoleColor> Colors;
+        private readonly IDictionary<ConsoleLogLevel, ConsoleColor>? Colors;
 
         /// <summary>Whether the current console supports color formatting.</summary>
-        private readonly bool SupportsColor;
+        [MemberNotNullWhen(true, nameof(ColorfulConsoleWriter.Colors))]
+        private bool SupportsColor { get; }
 
 
         /*********
@@ -74,10 +74,9 @@ namespace StardewModdingAPI.Internal.ConsoleWriting
         /// <remarks>The colors here should be kept in sync with the SMAPI config file.</remarks>
         public static ColorSchemeConfig GetDefaultColorSchemeConfig(MonitorColorScheme useScheme)
         {
-            return new ColorSchemeConfig
-            {
-                UseScheme = useScheme,
-                Schemes = new Dictionary<MonitorColorScheme, IDictionary<ConsoleLogLevel, ConsoleColor>>
+            return new ColorSchemeConfig(
+                useScheme: useScheme,
+                schemes: new Dictionary<MonitorColorScheme, IDictionary<ConsoleLogLevel, ConsoleColor>>
                 {
                     [MonitorColorScheme.DarkBackground] = new Dictionary<ConsoleLogLevel, ConsoleColor>
                     {
@@ -100,7 +99,7 @@ namespace StardewModdingAPI.Internal.ConsoleWriting
                         [ConsoleLogLevel.Success] = ConsoleColor.DarkGreen
                     }
                 }
-            };
+            );
         }
 
 
@@ -136,7 +135,7 @@ namespace StardewModdingAPI.Internal.ConsoleWriting
             }
 
             // get colors for scheme
-            return colorConfig.Schemes.TryGetValue(schemeID, out IDictionary<ConsoleLogLevel, ConsoleColor> scheme)
+            return colorConfig.Schemes.TryGetValue(schemeID, out IDictionary<ConsoleLogLevel, ConsoleColor>? scheme)
                 ? scheme
                 : throw new NotSupportedException($"Unknown color scheme '{schemeID}'.");
         }
diff --git a/src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs b/src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs
index 84e17207..fbcf161c 100644
--- a/src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs
+++ b/src/SMAPI.Internal/ConsoleWriting/IConsoleWriter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Internal.ConsoleWriting
 {
     /// <summary>Writes text to the console.</summary>
diff --git a/src/SMAPI.Internal/ExceptionHelper.cs b/src/SMAPI.Internal/ExceptionHelper.cs
index a856cf71..7edc0f62 100644
--- a/src/SMAPI.Internal/ExceptionHelper.cs
+++ b/src/SMAPI.Internal/ExceptionHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 using System.Text.RegularExpressions;
@@ -14,7 +12,7 @@ namespace StardewModdingAPI.Internal
         *********/
         /// <summary>Get a string representation of an exception suitable for writing to the error log.</summary>
         /// <param name="exception">The error to summarize.</param>
-        public static string GetLogSummary(this Exception exception)
+        public static string GetLogSummary(this Exception? exception)
         {
             try
             {
@@ -27,7 +25,7 @@ namespace StardewModdingAPI.Internal
 
                     case ReflectionTypeLoadException ex:
                         string summary = ex.ToString();
-                        foreach (Exception childEx in ex.LoaderExceptions)
+                        foreach (Exception? childEx in ex.LoaderExceptions)
                             summary += $"\n\n{childEx?.GetLogSummary()}";
                         message = summary;
                         break;

From 5f7a92a74592a53529890eebb1ee9fe519afd92f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 12 Apr 2022 20:52:01 -0400
Subject: [PATCH 543/856] enable nullable annotations in unit tests (#837)

---
 .../Framework/DiagnosticResult.cs             |   5 +-
 .../Framework/DiagnosticVerifier.Helper.cs    |  29 +--
 .../Framework/DiagnosticVerifier.cs           |  31 +--
 .../Mock/Netcode/NetCollection.cs             |   6 +-
 .../Mock/Netcode/NetFieldBase.cs              |   9 +-
 .../Mock/Netcode/NetInt.cs                    |   2 -
 .../Mock/Netcode/NetList.cs                   |   5 +-
 .../Mock/Netcode/NetObjectList.cs             |   2 -
 .../Mock/StardewValley/Farmer.cs              |   6 +-
 .../Mock/StardewValley/Item.cs                |   3 +-
 .../Mock/StardewValley/Object.cs              |   2 -
 .../NetFieldAnalyzerTests.cs                  |   2 -
 .../ObsoleteFieldAnalyzerTests.cs             |   2 -
 src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs |   2 -
 .../Interfaces/ISimpleApi.cs                  |   2 -
 .../Framework/BaseApi.cs                      |   4 +-
 .../Framework/SimpleApi.cs                    |  12 +-
 src/SMAPI.Tests.ModApiProvider/ProviderMod.cs |   2 -
 src/SMAPI.Tests/Core/AssetNameTests.cs        |  10 +-
 src/SMAPI.Tests/Core/InterfaceProxyTests.cs   |  12 +-
 src/SMAPI.Tests/Core/ModResolverTests.cs      |   2 +-
 src/SMAPI.Tests/Core/TranslationTests.cs      |  47 +++--
 src/SMAPI.Tests/Sample.cs                     |   2 -
 src/SMAPI.Tests/Utilities/KeybindListTests.cs |  12 +-
 .../Utilities/PathUtilitiesTests.cs           | 183 ++++++++----------
 src/SMAPI.Tests/Utilities/SDateTests.cs       |  19 +-
 .../WikiClient/ChangeDescriptorTests.cs       |  24 +--
 .../Clients/Wiki/ChangeDescriptor.cs          |   6 +-
 28 files changed, 191 insertions(+), 252 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticResult.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticResult.cs
index 8c24eda9..845149bd 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticResult.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticResult.cs
@@ -1,8 +1,7 @@
-#nullable disable
-
 // <generated />
-using Microsoft.CodeAnalysis;
+// ReSharper disable All -- generated code
 using System;
+using Microsoft.CodeAnalysis;
 
 namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
 {
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
index 68a892a9..4bda70ff 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.Helper.cs
@@ -1,14 +1,14 @@
-#nullable disable
-
 // <generated />
-using Microsoft.CodeAnalysis;
-using Microsoft.CodeAnalysis.CSharp;
-using Microsoft.CodeAnalysis.Diagnostics;
-using Microsoft.CodeAnalysis.Text;
+// ReSharper disable All -- generated code
+
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp;
+using Microsoft.CodeAnalysis.Diagnostics;
+using Microsoft.CodeAnalysis.Text;
 
 namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
 {
@@ -61,7 +61,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
             var diagnostics = new List<Diagnostic>();
             foreach (Project project in projects)
             {
-                CompilationWithAnalyzers compilationWithAnalyzers = project.GetCompilationAsync().Result.WithAnalyzers(ImmutableArray.Create(analyzer));
+                CompilationWithAnalyzers compilationWithAnalyzers = project.GetCompilationAsync().Result!.WithAnalyzers(ImmutableArray.Create(analyzer));
                 var diags = compilationWithAnalyzers.GetAnalyzerDiagnosticsAsync().Result;
                 foreach (Diagnostic diag in diags)
                 {
@@ -74,7 +74,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                         for (int i = 0; i < documents.Length; i++)
                         {
                             Document document = documents[i];
-                            SyntaxTree tree = document.GetSyntaxTreeAsync().Result;
+                            SyntaxTree? tree = document.GetSyntaxTreeAsync().Result;
                             if (tree == diag.Location.SourceTree)
                             {
                                 diagnostics.Add(diag);
@@ -126,17 +126,6 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
             return documents;
         }
 
-        /// <summary>
-        /// Create a Document from a string through creating a project that contains it.
-        /// </summary>
-        /// <param name="source">Classes in the form of a string</param>
-        /// <param name="language">The language the source code is in</param>
-        /// <returns>A Document created from the source string</returns>
-        protected static Document CreateDocument(string source, string language = LanguageNames.CSharp)
-        {
-            return CreateProject(new[] { source }, language).Documents.First();
-        }
-
         /// <summary>
         /// Create a project using the inputted strings as sources.
         /// </summary>
@@ -167,7 +156,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                 solution = solution.AddDocument(documentId, newFileName, SourceText.From(source));
                 count++;
             }
-            return solution.GetProject(projectId);
+            return solution.GetProject(projectId)!;
         }
         #endregion
     }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
index 4170042d..efe69e4a 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Framework/DiagnosticVerifier.cs
@@ -1,6 +1,6 @@
-#nullable disable
-
 // <generated />
+// ReSharper disable All -- generated code
+
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
@@ -19,18 +19,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
         /// <summary>
         /// Get the CSharp analyzer being tested - to be implemented in non-abstract class
         /// </summary>
-        protected virtual DiagnosticAnalyzer GetCSharpDiagnosticAnalyzer()
-        {
-            return null;
-        }
-
-        /// <summary>
-        /// Get the Visual Basic analyzer being tested (C#) - to be implemented in non-abstract class
-        /// </summary>
-        protected virtual DiagnosticAnalyzer GetBasicDiagnosticAnalyzer()
-        {
-            return null;
-        }
+        protected abstract DiagnosticAnalyzer GetCSharpDiagnosticAnalyzer();
         #endregion
 
         #region Verifier wrappers
@@ -46,17 +35,6 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
             this.VerifyDiagnostics(new[] { source }, LanguageNames.CSharp, this.GetCSharpDiagnosticAnalyzer(), expected);
         }
 
-        /// <summary>
-        /// Called to test a C# DiagnosticAnalyzer when applied on the inputted strings as a source
-        /// Note: input a DiagnosticResult for each Diagnostic expected
-        /// </summary>
-        /// <param name="sources">An array of strings to create source documents from to run the analyzers on</param>
-        /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources</param>
-        protected void VerifyCSharpDiagnostic(string[] sources, params DiagnosticResult[] expected)
-        {
-            this.VerifyDiagnostics(sources, LanguageNames.CSharp, this.GetCSharpDiagnosticAnalyzer(), expected);
-        }
-
         /// <summary>
         /// General method that gets a collection of actual diagnostics found in the source after the analyzer is run, 
         /// then verifies each of them.
@@ -222,11 +200,10 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests.Framework
                             Assert.IsTrue(location.IsInSource,
                                 $"Test base does not currently handle diagnostics in metadata locations. Diagnostic in metadata: {diagnostics[i]}\r\n");
 
-                            string resultMethodName = diagnostics[i].Location.SourceTree.FilePath.EndsWith(".cs") ? "GetCSharpResultAt" : "GetBasicResultAt";
                             var linePosition = diagnostics[i].Location.GetLineSpan().StartLinePosition;
 
                             builder.AppendFormat("{0}({1}, {2}, {3}.{4})",
-                                resultMethodName,
+                                "GetCSharpResultAt",
                                 linePosition.Line + 1,
                                 linePosition.Character + 1,
                                 analyzerType.Name,
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs
index 54aa1c6c..8bedd583 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs
@@ -1,12 +1,8 @@
-#nullable disable
-
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
-using System.Collections;
-using System.Collections.Generic;
 using System.Collections.ObjectModel;
 
 namespace Netcode
 {
     /// <summary>A simplified version of Stardew Valley's <c>Netcode.NetCollection</c> for unit testing.</summary>
-    public class NetCollection<T> : Collection<T>, IList<T>, ICollection<T>, IEnumerable<T>, IEnumerable { }
+    public class NetCollection<T> : Collection<T> { }
 }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetFieldBase.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetFieldBase.cs
index 1c349a0b..8f6b8987 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetFieldBase.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetFieldBase.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
 namespace Netcode
 {
@@ -9,10 +7,13 @@ namespace Netcode
     public class NetFieldBase<T, TSelf> where TSelf : NetFieldBase<T, TSelf>
     {
         /// <summary>The synchronised value.</summary>
-        public T Value { get; set; }
+        public T? Value { get; set; }
 
         /// <summary>Implicitly convert a net field to the its type.</summary>
         /// <param name="field">The field to convert.</param>
-        public static implicit operator T(NetFieldBase<T, TSelf> field) => field.Value;
+        public static implicit operator T?(NetFieldBase<T, TSelf> field)
+        {
+            return field.Value;
+        }
     }
 }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs
index e8e1dc63..b3abc467 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
 namespace Netcode
 {
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs
index f7fb9617..33e616fb 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs
@@ -1,11 +1,8 @@
-#nullable disable
-
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
-using System.Collections;
 using System.Collections.Generic;
 
 namespace Netcode
 {
     /// <summary>A simplified version of Stardew Valley's <c>Netcode.NetObjectList</c> for unit testing.</summary>
-    public class NetList<T> : List<T>, IList<T>, ICollection<T>, IEnumerable<T>, IEnumerable { }
+    public class NetList<T> : List<T> { }
 }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs
index 74c17843..7814e7d6 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 // ReSharper disable CheckNamespace -- matches Stardew Valley's code
 namespace Netcode
 {
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Farmer.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Farmer.cs
index bdbf9b45..dbd05792 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Farmer.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Farmer.cs
@@ -1,7 +1,5 @@
-#nullable disable
-
 // ReSharper disable CheckNamespace, InconsistentNaming -- matches Stardew Valley's code
-#pragma warning disable 649 // (never assigned) -- only used to test type conversions
+// ReSharper disable UnusedMember.Global -- used dynamically for unit tests
 using System.Collections.Generic;
 
 namespace StardewValley
@@ -10,6 +8,6 @@ namespace StardewValley
     internal class Farmer
     {
         /// <summary>A sample field which should be replaced with a different property.</summary>
-        public readonly IDictionary<string, int[]> friendships;
+        public readonly IDictionary<string, int[]> friendships = new Dictionary<string, int[]>();
     }
 }
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
index d1f0afc4..d50deb72 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Item.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 // ReSharper disable CheckNamespace, InconsistentNaming -- matches Stardew Valley's code
+// ReSharper disable UnusedMember.Global -- used dynamically for unit tests
 using Netcode;
 
 namespace StardewValley
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
index f54b22fe..151010a7 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/StardewValley/Object.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 // ReSharper disable CheckNamespace, InconsistentNaming -- matches Stardew Valley's code
 using Netcode;
 
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
index 29f3b956..f11a59d3 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.Diagnostics;
 using NUnit.Framework;
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
index 1cf7369f..76607b8e 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/ObsoleteFieldAnalyzerTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.Diagnostics;
 using NUnit.Framework;
diff --git a/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs b/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
index 285dd259..ac7bd338 100644
--- a/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
+++ b/src/SMAPI.Tests.ModApiConsumer/ApiConsumer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using SMAPI.Tests.ModApiConsumer.Interfaces;
 
diff --git a/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs b/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
index 23491fd1..7f94e137 100644
--- a/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
+++ b/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Reflection;
diff --git a/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs b/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
index b5870baa..77001e4c 100644
--- a/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
+++ b/src/SMAPI.Tests.ModApiProvider/Framework/BaseApi.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace SMAPI.Tests.ModApiProvider.Framework
 {
     /// <summary>The base class for <see cref="SimpleApi"/>.</summary>
@@ -9,6 +7,6 @@ namespace SMAPI.Tests.ModApiProvider.Framework
         ** Test interface
         *********/
         /// <summary>A property inherited from a base class.</summary>
-        public string InheritedProperty { get; set; }
+        public string? InheritedProperty { get; set; }
     }
 }
diff --git a/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs b/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
index 82e902f5..e7e1ccef 100644
--- a/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
+++ b/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
@@ -1,4 +1,4 @@
-#nullable disable
+// ReSharper disable UnusedMember.Global -- used dynamically through proxies
 
 using System;
 using System.Collections.Generic;
@@ -16,7 +16,7 @@ namespace SMAPI.Tests.ModApiProvider.Framework
         ** Events
         ****/
         /// <summary>A simple event field.</summary>
-        public event EventHandler<int> OnEventRaised;
+        public event EventHandler<int>? OnEventRaised;
 
         /// <summary>A simple event property with custom add/remove logic.</summary>
         public event EventHandler<int> OnEventRaisedProperty
@@ -33,16 +33,16 @@ namespace SMAPI.Tests.ModApiProvider.Framework
         public int NumberProperty { get; set; }
 
         /// <summary>A simple object property.</summary>
-        public object ObjectProperty { get; set; }
+        public object? ObjectProperty { get; set; }
 
         /// <summary>A simple list property.</summary>
-        public List<string> ListProperty { get; set; }
+        public List<string>? ListProperty { get; set; }
 
         /// <summary>A simple list property with an interface.</summary>
-        public IList<string> ListPropertyWithInterface { get; set; }
+        public IList<string>? ListPropertyWithInterface { get; set; }
 
         /// <summary>A property with nested generics.</summary>
-        public IDictionary<string, IList<string>> GenericsProperty { get; set; }
+        public IDictionary<string, IList<string>>? GenericsProperty { get; set; }
 
         /// <summary>A property using an enum available to both mods.</summary>
         public BindingFlags EnumProperty { get; set; }
diff --git a/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs b/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
index 3fc8d749..c36e1c6d 100644
--- a/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
+++ b/src/SMAPI.Tests.ModApiProvider/ProviderMod.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Reflection;
 using SMAPI.Tests.ModApiProvider.Framework;
diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index ef8a08ef..8018442c 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using FluentAssertions;
@@ -28,7 +26,7 @@ namespace SMAPI.Tests.Core
         [TestCase("Characters/Dialogue/Abigail.fr-FR", "Characters/Dialogue/Abigail", "fr-FR", LocalizedContentManager.LanguageCode.fr)]
         [TestCase("Characters/Dialogue\\Abigail.fr-FR", "Characters/Dialogue/Abigail.fr-FR", null, null)]
         [TestCase("Characters/Dialogue/Abigail.fr-FR", "Characters/Dialogue/Abigail", "fr-FR", LocalizedContentManager.LanguageCode.fr)]
-        public void Constructor_Valid(string name, string expectedBaseName, string expectedLocale, LocalizedContentManager.LanguageCode? expectedLanguageCode)
+        public void Constructor_Valid(string name, string expectedBaseName, string? expectedLocale, LocalizedContentManager.LanguageCode? expectedLanguageCode)
         {
             // arrange
             name = PathUtilities.NormalizeAssetName(name);
@@ -55,13 +53,13 @@ namespace SMAPI.Tests.Core
         [TestCase(" ")]
         [TestCase("\t")]
         [TestCase("  \t   ")]
-        public void Constructor_NullOrWhitespace(string name)
+        public void Constructor_NullOrWhitespace(string? name)
         {
             // act
-            ArgumentException exception = Assert.Throws<ArgumentException>(() => _ = AssetName.Parse(name, null));
+            ArgumentException exception = Assert.Throws<ArgumentException>(() => _ = AssetName.Parse(name!, null))!;
 
             // assert
-            exception!.ParamName.Should().Be("rawName");
+            exception.ParamName.Should().Be("rawName");
             exception.Message.Should().Be("The asset name can't be null or empty. (Parameter 'rawName')");
         }
 
diff --git a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
index 1bf2ed68..0b4919ed 100644
--- a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
+++ b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -41,7 +39,7 @@ namespace SMAPI.Tests.Core
         public void CanProxy_EventField()
         {
             // arrange
-            var providerMod = new ProviderMod();
+            ProviderMod providerMod = new();
             object implementation = providerMod.GetModApi();
             int expectedValue = this.Random.Next();
 
@@ -61,7 +59,7 @@ namespace SMAPI.Tests.Core
         public void CanProxy_EventProperty()
         {
             // arrange
-            var providerMod = new ProviderMod();
+            ProviderMod providerMod = new();
             object implementation = providerMod.GetModApi();
             int expectedValue = this.Random.Next();
 
@@ -86,7 +84,7 @@ namespace SMAPI.Tests.Core
         public void CanProxy_Properties(string setVia)
         {
             // arrange
-            var providerMod = new ProviderMod();
+            ProviderMod providerMod = new();
             object implementation = providerMod.GetModApi();
             int expectedNumber = this.Random.Next();
             int expectedObject = this.Random.Next();
@@ -317,13 +315,13 @@ namespace SMAPI.Tests.Core
         /// <summary>Get a property value from an instance.</summary>
         /// <param name="parent">The instance whose property to read.</param>
         /// <param name="name">The property name.</param>
-        private object GetPropertyValue(object parent, string name)
+        private object? GetPropertyValue(object parent, string name)
         {
             if (parent is null)
                 throw new ArgumentNullException(nameof(parent));
 
             Type type = parent.GetType();
-            PropertyInfo property = type.GetProperty(name);
+            PropertyInfo? property = type.GetProperty(name);
             if (property is null)
                 throw new InvalidOperationException($"The '{type.FullName}' type has no public property named '{name}'.");
 
diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index b8649a7d..bd621bbf 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -507,7 +507,7 @@ namespace SMAPI.Tests.Core
         /// <param name="allowStatusChange">Whether the code being tested is allowed to change the mod status.</param>
         private Mock<IModMetadata> GetMetadata(string uniqueID, string[] dependencies, bool allowStatusChange = false)
         {
-            IManifest manifest = this.GetManifest(id: uniqueID, version: "1.0", dependencies: dependencies?.Select(dependencyID => (IManifestDependency)new ManifestDependency(dependencyID, null as ISemanticVersion)).ToArray());
+            IManifest manifest = this.GetManifest(id: uniqueID, version: "1.0", dependencies: dependencies.Select(dependencyID => (IManifestDependency)new ManifestDependency(dependencyID, null as ISemanticVersion)).ToArray());
             return this.GetMetadata(manifest, allowStatusChange);
         }
 
diff --git a/src/SMAPI.Tests/Core/TranslationTests.cs b/src/SMAPI.Tests/Core/TranslationTests.cs
index f8f0e315..a65bf772 100644
--- a/src/SMAPI.Tests/Core/TranslationTests.cs
+++ b/src/SMAPI.Tests/Core/TranslationTests.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using NUnit.Framework;
 using StardewModdingAPI;
@@ -18,7 +17,7 @@ namespace SMAPI.Tests.Core
         ** Data
         *********/
         /// <summary>Sample translation text for unit tests.</summary>
-        public static string[] Samples = { null, "", "  ", "boop", "  boop  " };
+        public static string?[] Samples = { null, "", "  ", "boop", "  boop  " };
 
 
         /*********
@@ -36,13 +35,13 @@ namespace SMAPI.Tests.Core
             // act
             ITranslationHelper helper = new TranslationHelper("ModID", "en", LocalizedContentManager.LanguageCode.en).SetTranslations(data);
             Translation translation = helper.Get("key");
-            Translation[] translationList = helper.GetTranslations()?.ToArray();
+            Translation[]? translationList = helper.GetTranslations()?.ToArray();
 
             // assert
             Assert.AreEqual("en", helper.Locale, "The locale doesn't match the input value.");
             Assert.AreEqual(LocalizedContentManager.LanguageCode.en, helper.LocaleEnum, "The locale enum doesn't match the input value.");
             Assert.IsNotNull(translationList, "The full list of translations is unexpectedly null.");
-            Assert.AreEqual(0, translationList.Length, "The full list of translations is unexpectedly not empty.");
+            Assert.AreEqual(0, translationList!.Length, "The full list of translations is unexpectedly not empty.");
 
             Assert.IsNotNull(translation, "The translation helper unexpectedly returned a null translation.");
             Assert.AreEqual(this.GetPlaceholderText("key"), translation.ToString(), "The translation returned an unexpected value.");
@@ -56,7 +55,7 @@ namespace SMAPI.Tests.Core
             var expected = this.GetExpectedTranslations();
 
             // act
-            var actual = new Dictionary<string, Translation[]>();
+            var actual = new Dictionary<string, Translation[]?>();
             TranslationHelper helper = new TranslationHelper("ModID", "en", LocalizedContentManager.LanguageCode.en).SetTranslations(data);
             foreach (string locale in expected.Keys)
             {
@@ -109,13 +108,13 @@ namespace SMAPI.Tests.Core
         [TestCase("  ", ExpectedResult = true)]
         [TestCase("boop", ExpectedResult = true)]
         [TestCase("  boop  ", ExpectedResult = true)]
-        public bool Translation_HasValue(string text)
+        public bool Translation_HasValue(string? text)
         {
             return new Translation("pt-BR", "key", text).HasValue();
         }
 
         [Test(Description = "Assert that the translation's ToString method returns the expected text for various inputs.")]
-        public void Translation_ToString([ValueSource(nameof(TranslationTests.Samples))] string text)
+        public void Translation_ToString([ValueSource(nameof(TranslationTests.Samples))] string? text)
         {
             // act
             Translation translation = new("pt-BR", "key", text);
@@ -128,7 +127,7 @@ namespace SMAPI.Tests.Core
         }
 
         [Test(Description = "Assert that the translation's implicit string conversion returns the expected text for various inputs.")]
-        public void Translation_ImplicitStringConversion([ValueSource(nameof(TranslationTests.Samples))] string text)
+        public void Translation_ImplicitStringConversion([ValueSource(nameof(TranslationTests.Samples))] string? text)
         {
             // act
             Translation translation = new("pt-BR", "key", text);
@@ -141,7 +140,7 @@ namespace SMAPI.Tests.Core
         }
 
         [Test(Description = "Assert that the translation returns the expected text given a use-placeholder setting.")]
-        public void Translation_UsePlaceholder([Values(true, false)] bool value, [ValueSource(nameof(TranslationTests.Samples))] string text)
+        public void Translation_UsePlaceholder([Values(true, false)] bool value, [ValueSource(nameof(TranslationTests.Samples))] string? text)
         {
             // act
             Translation translation = new Translation("pt-BR", "key", text).UsePlaceholder(value);
@@ -156,7 +155,7 @@ namespace SMAPI.Tests.Core
         }
 
         [Test(Description = "Assert that the translation returns the expected text after setting the default.")]
-        public void Translation_Default([ValueSource(nameof(TranslationTests.Samples))] string text, [ValueSource(nameof(TranslationTests.Samples))] string @default)
+        public void Translation_Default([ValueSource(nameof(TranslationTests.Samples))] string? text, [ValueSource(nameof(TranslationTests.Samples))] string? @default)
         {
             // act
             Translation translation = new Translation("pt-BR", "key", text).Default(@default);
@@ -192,7 +191,7 @@ namespace SMAPI.Tests.Core
                     break;
 
                 case "class":
-                    translation = translation.Tokens(new TokenModel { Start = start, Middle = middle, End = end });
+                    translation = translation.Tokens(new TokenModel(start, middle, end));
                     break;
 
                 case "IDictionary<string, object>":
@@ -331,16 +330,36 @@ namespace SMAPI.Tests.Core
         ** Test models
         *********/
         /// <summary>A model used to test token support.</summary>
+        [SuppressMessage("ReSharper", "NotAccessedField.Local", Justification = "Used dynamically via translation helper.")]
+        [SuppressMessage("ReSharper", "UnusedAutoPropertyAccessor.Local", Justification = "Used dynamically via translation helper.")]
         private class TokenModel
         {
+            /*********
+            ** Accessors
+            *********/
             /// <summary>A sample token property.</summary>
-            public string Start { get; set; }
+            public string Start { get; }
 
             /// <summary>A sample token property.</summary>
-            public string Middle { get; set; }
+            public string Middle { get; }
 
             /// <summary>A sample token field.</summary>
             public string End;
+
+
+            /*********
+            ** public methods
+            *********/
+            /// <summary>Construct an instance.</summary>
+            /// <param name="start">A sample token property.</param>
+            /// <param name="middle">A sample token field.</param>
+            /// <param name="end">A sample token property.</param>
+            public TokenModel(string start, string middle, string end)
+            {
+                this.Start = start;
+                this.Middle = middle;
+                this.End = end;
+            }
         }
     }
 }
diff --git a/src/SMAPI.Tests/Sample.cs b/src/SMAPI.Tests/Sample.cs
index 6d4339ca..9587a100 100644
--- a/src/SMAPI.Tests/Sample.cs
+++ b/src/SMAPI.Tests/Sample.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace SMAPI.Tests
diff --git a/src/SMAPI.Tests/Utilities/KeybindListTests.cs b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
index f5c156c4..060c93ed 100644
--- a/src/SMAPI.Tests/Utilities/KeybindListTests.cs
+++ b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using NUnit.Framework;
@@ -46,7 +44,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(",", ExpectedResult = "None")]
         [TestCase("A,", ExpectedResult = "A")]
         [TestCase(",A", ExpectedResult = "A")]
-        public string TryParse_MultiValues(string input)
+        public string TryParse_MultiValues(string? input)
         {
             // act
             bool success = KeybindList.TryParse(input, out KeybindList parsed, out string[] errors);
@@ -100,13 +98,15 @@ namespace SMAPI.Tests.Utilities
         public SButtonState GetState(string input, string stateMap)
         {
             // act
-            bool success = KeybindList.TryParse(input, out KeybindList parsed, out string[] errors);
+            bool success = KeybindList.TryParse(input, out KeybindList? parsed, out string[] errors);
             if (success && parsed?.Keybinds != null)
             {
-                foreach (var keybind in parsed.Keybinds)
+                foreach (Keybind? keybind in parsed.Keybinds)
+                {
 #pragma warning disable 618 // method is marked obsolete because it should only be used in unit tests
                     keybind.GetButtonState = key => this.GetStateFromMap(key, stateMap);
 #pragma warning restore 618
+                }
             }
 
             // assert
@@ -114,7 +114,7 @@ namespace SMAPI.Tests.Utilities
             Assert.IsNotNull(parsed, "The parsed result should not be null.");
             Assert.IsNotNull(errors, message: "The errors should never be null.");
             Assert.IsEmpty(errors, message: "The input bindings incorrectly reported errors.");
-            return parsed.GetState();
+            return parsed!.GetState();
         }
 
 
diff --git a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
index ae2cc6ce..3219d89d 100644
--- a/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
+++ b/src/SMAPI.Tests/Utilities/PathUtilitiesTests.cs
@@ -1,5 +1,4 @@
-#nullable disable
-
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using NUnit.Framework;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -8,6 +7,7 @@ namespace SMAPI.Tests.Utilities
 {
     /// <summary>Unit tests for <see cref="PathUtilities"/>.</summary>
     [TestFixture]
+    [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These are standard game install paths.")]
     internal class PathUtilitiesTests
     {
         /*********
@@ -16,136 +16,125 @@ namespace SMAPI.Tests.Utilities
         /// <summary>Sample paths used in unit tests.</summary>
         public static readonly SamplePath[] SamplePaths = {
             // Windows absolute path
-            new()
-            {
-                OriginalPath = @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley",
+            new(
+                OriginalPath: @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley",
 
-                Segments = new[] { "C:", "Program Files (x86)", "Steam", "steamapps", "common", "Stardew Valley" },
-                SegmentsLimit3 = new [] { "C:", "Program Files (x86)", @"Steam\steamapps\common\Stardew Valley" },
+                Segments: new[] { "C:", "Program Files (x86)", "Steam", "steamapps", "common", "Stardew Valley" },
+                SegmentsLimit3: new [] { "C:", "Program Files (x86)", @"Steam\steamapps\common\Stardew Valley" },
 
-                NormalizedOnWindows = @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley",
-                NormalizedOnUnix = @"C:/Program Files (x86)/Steam/steamapps/common/Stardew Valley"
-            },
+                NormalizedOnWindows: @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley",
+                NormalizedOnUnix: @"C:/Program Files (x86)/Steam/steamapps/common/Stardew Valley"
+            ),
 
             // Windows absolute path (with trailing slash)
-            new()
-            {
-                OriginalPath = @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\",
+            new(
+                OriginalPath: @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\",
 
-                Segments = new[] { "C:", "Program Files (x86)", "Steam", "steamapps", "common", "Stardew Valley" },
-                SegmentsLimit3 = new [] { "C:", "Program Files (x86)", @"Steam\steamapps\common\Stardew Valley\" },
+                Segments: new[] { "C:", "Program Files (x86)", "Steam", "steamapps", "common", "Stardew Valley" },
+                SegmentsLimit3: new [] { "C:", "Program Files (x86)", @"Steam\steamapps\common\Stardew Valley\" },
 
-                NormalizedOnWindows = @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\",
-                NormalizedOnUnix = @"C:/Program Files (x86)/Steam/steamapps/common/Stardew Valley/"
-            },
+                NormalizedOnWindows: @"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\",
+                NormalizedOnUnix: @"C:/Program Files (x86)/Steam/steamapps/common/Stardew Valley/"
+            ),
 
             // Windows relative path
-            new()
-            {
-                OriginalPath = @"Content\Characters\Dialogue\Abigail",
+            new(
+                OriginalPath: @"Content\Characters\Dialogue\Abigail",
 
-                Segments = new [] { "Content", "Characters", "Dialogue", "Abigail" },
-                SegmentsLimit3 = new [] { "Content", "Characters", @"Dialogue\Abigail" },
+                Segments: new [] { "Content", "Characters", "Dialogue", "Abigail" },
+                SegmentsLimit3: new [] { "Content", "Characters", @"Dialogue\Abigail" },
 
-                NormalizedOnWindows = @"Content\Characters\Dialogue\Abigail",
-                NormalizedOnUnix = @"Content/Characters/Dialogue/Abigail"
-            },
+                NormalizedOnWindows: @"Content\Characters\Dialogue\Abigail",
+                NormalizedOnUnix: @"Content/Characters/Dialogue/Abigail"
+            ),
 
             // Windows relative path (with directory climbing)
-            new()
-            {
-                OriginalPath = @"..\..\Content",
+            new(
+                OriginalPath: @"..\..\Content",
 
-                Segments = new [] { "..", "..", "Content" },
-                SegmentsLimit3 = new [] { "..", "..", "Content" },
+                Segments: new [] { "..", "..", "Content" },
+                SegmentsLimit3: new [] { "..", "..", "Content" },
 
-                NormalizedOnWindows = @"..\..\Content",
-                NormalizedOnUnix = @"../../Content"
-            },
+                NormalizedOnWindows: @"..\..\Content",
+                NormalizedOnUnix: @"../../Content"
+            ),
 
             // Windows UNC path
-            new()
-            {
-                OriginalPath = @"\\unc\path",
+            new(
+                OriginalPath: @"\\unc\path",
 
-                Segments = new [] { "unc", "path" },
-                SegmentsLimit3 = new [] { "unc", "path" },
+                Segments: new [] { "unc", "path" },
+                SegmentsLimit3: new [] { "unc", "path" },
 
-                NormalizedOnWindows = @"\\unc\path",
-                NormalizedOnUnix = "/unc/path" // there's no good way to normalize this on Unix since UNC paths aren't supported; path normalization is meant for asset names anyway, so this test only ensures it returns some sort of sane value
-            },
+                NormalizedOnWindows: @"\\unc\path",
+                NormalizedOnUnix: "/unc/path" // there's no good way to normalize this on Unix since UNC paths aren't supported; path normalization is meant for asset names anyway, so this test only ensures it returns some sort of sane value
+            ),
 
             // Linux absolute path
-            new()
-            {
-                OriginalPath = @"/home/.steam/steam/steamapps/common/Stardew Valley",
+            new(
+                OriginalPath: @"/home/.steam/steam/steamapps/common/Stardew Valley",
 
-                Segments = new [] { "home", ".steam", "steam", "steamapps", "common", "Stardew Valley" },
-                SegmentsLimit3 = new [] { "home", ".steam", "steam/steamapps/common/Stardew Valley" },
+                Segments: new [] { "home", ".steam", "steam", "steamapps", "common", "Stardew Valley" },
+                SegmentsLimit3: new [] { "home", ".steam", "steam/steamapps/common/Stardew Valley" },
 
-                NormalizedOnWindows = @"\home\.steam\steam\steamapps\common\Stardew Valley",
-                NormalizedOnUnix = @"/home/.steam/steam/steamapps/common/Stardew Valley"
-            },
+                NormalizedOnWindows: @"\home\.steam\steam\steamapps\common\Stardew Valley",
+                NormalizedOnUnix: @"/home/.steam/steam/steamapps/common/Stardew Valley"
+            ),
 
             // Linux absolute path (with trailing slash)
-            new()
-            {
-                OriginalPath = @"/home/.steam/steam/steamapps/common/Stardew Valley/",
+            new(
+                OriginalPath: @"/home/.steam/steam/steamapps/common/Stardew Valley/",
 
-                Segments = new [] { "home", ".steam", "steam", "steamapps", "common", "Stardew Valley" },
-                SegmentsLimit3 = new [] { "home", ".steam", "steam/steamapps/common/Stardew Valley/" },
+                Segments: new [] { "home", ".steam", "steam", "steamapps", "common", "Stardew Valley" },
+                SegmentsLimit3: new [] { "home", ".steam", "steam/steamapps/common/Stardew Valley/" },
 
-                NormalizedOnWindows = @"\home\.steam\steam\steamapps\common\Stardew Valley\",
-                NormalizedOnUnix = @"/home/.steam/steam/steamapps/common/Stardew Valley/"
-            },
+                NormalizedOnWindows: @"\home\.steam\steam\steamapps\common\Stardew Valley\",
+                NormalizedOnUnix: @"/home/.steam/steam/steamapps/common/Stardew Valley/"
+            ),
 
             // Linux absolute path (with ~)
-            new()
-            {
-                OriginalPath = @"~/.steam/steam/steamapps/common/Stardew Valley",
+            new(
+                OriginalPath: @"~/.steam/steam/steamapps/common/Stardew Valley",
 
-                Segments = new [] { "~", ".steam", "steam", "steamapps", "common", "Stardew Valley" },
-                SegmentsLimit3 = new [] { "~", ".steam", "steam/steamapps/common/Stardew Valley" },
+                Segments: new [] { "~", ".steam", "steam", "steamapps", "common", "Stardew Valley" },
+                SegmentsLimit3: new [] { "~", ".steam", "steam/steamapps/common/Stardew Valley" },
 
-                NormalizedOnWindows = @"~\.steam\steam\steamapps\common\Stardew Valley",
-                NormalizedOnUnix = @"~/.steam/steam/steamapps/common/Stardew Valley"
-            },
+                NormalizedOnWindows: @"~\.steam\steam\steamapps\common\Stardew Valley",
+                NormalizedOnUnix: @"~/.steam/steam/steamapps/common/Stardew Valley"
+            ),
 
             // Linux relative path
-            new()
-            {
-                OriginalPath = @"Content/Characters/Dialogue/Abigail",
+            new(
+                OriginalPath: @"Content/Characters/Dialogue/Abigail",
 
-                Segments = new [] { "Content", "Characters", "Dialogue", "Abigail" },
-                SegmentsLimit3 = new [] { "Content", "Characters", "Dialogue/Abigail" },
+                Segments: new [] { "Content", "Characters", "Dialogue", "Abigail" },
+                SegmentsLimit3: new [] { "Content", "Characters", "Dialogue/Abigail" },
 
-                NormalizedOnWindows = @"Content\Characters\Dialogue\Abigail",
-                NormalizedOnUnix = @"Content/Characters/Dialogue/Abigail"
-            },
+                NormalizedOnWindows: @"Content\Characters\Dialogue\Abigail",
+                NormalizedOnUnix: @"Content/Characters/Dialogue/Abigail"
+            ),
 
             // Linux relative path (with directory climbing)
-            new()
-            {
-                OriginalPath = @"../../Content",
+            new(
+                OriginalPath: @"../../Content",
 
-                Segments = new [] { "..", "..", "Content" },
-                SegmentsLimit3 = new [] { "..", "..", "Content" },
+                Segments: new [] { "..", "..", "Content" },
+                SegmentsLimit3: new [] { "..", "..", "Content" },
 
-                NormalizedOnWindows = @"..\..\Content",
-                NormalizedOnUnix = @"../../Content"
-            },
+                NormalizedOnWindows: @"..\..\Content",
+                NormalizedOnUnix: @"../../Content"
+            ),
 
             // Mixed directory separators
-            new()
-            {
-                OriginalPath = @"C:\some/mixed\path/separators",
+            new(
+                OriginalPath: @"C:\some/mixed\path/separators",
 
-                Segments = new [] { "C:", "some", "mixed", "path", "separators" },
-                SegmentsLimit3 = new [] { "C:", "some", @"mixed\path/separators" },
+                Segments: new [] { "C:", "some", "mixed", "path", "separators" },
+                SegmentsLimit3: new [] { "C:", "some", @"mixed\path/separators" },
 
-                NormalizedOnWindows = @"C:\some\mixed\path\separators",
-                NormalizedOnUnix = @"C:/some/mixed/path/separators"
-            },
+                NormalizedOnWindows: @"C:\some\mixed\path\separators",
+                NormalizedOnUnix: @"C:/some/mixed/path/separators"
+            )
         };
 
 
@@ -283,14 +272,14 @@ namespace SMAPI.Tests.Utilities
         /*********
         ** Private classes
         *********/
-        public class SamplePath
+        /// <summary>A sample path in multiple formats.</summary>
+        /// <param name="OriginalPath">The original path to pass to the <see cref="PathUtilities"/>.</param>
+        /// <param name="Segments">The normalized path segments.</param>
+        /// <param name="SegmentsLimit3">The normalized path segments, if we stop segmenting after the second one.</param>
+        /// <param name="NormalizedOnWindows">The normalized form on Windows.</param>
+        /// <param name="NormalizedOnUnix">The normalized form on Linux or macOS.</param>
+        public record SamplePath(string OriginalPath, string[] Segments, string[] SegmentsLimit3, string NormalizedOnWindows, string NormalizedOnUnix)
         {
-            public string OriginalPath { get; set; }
-            public string[] Segments { get; set; }
-            public string[] SegmentsLimit3 { get; set; }
-            public string NormalizedOnWindows { get; set; }
-            public string NormalizedOnUnix { get; set; }
-
             public override string ToString()
             {
                 return this.OriginalPath;
diff --git a/src/SMAPI.Tests/Utilities/SDateTests.cs b/src/SMAPI.Tests/Utilities/SDateTests.cs
index a4a36828..b9c3d202 100644
--- a/src/SMAPI.Tests/Utilities/SDateTests.cs
+++ b/src/SMAPI.Tests/Utilities/SDateTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -258,7 +256,7 @@ namespace SMAPI.Tests.Utilities
                     {
                         SDate date = new(day, season, year);
                         int hash = date.GetHashCode();
-                        if (hashes.TryGetValue(hash, out SDate otherDate))
+                        if (hashes.TryGetValue(hash, out SDate? otherDate))
                             Assert.Fail($"Received identical hash code {hash} for dates {otherDate} and {date}.");
                         if (hash < lastHash)
                             Assert.Fail($"Received smaller hash code for date {date} ({hash}) relative to {hashes[lastHash]} ({lastHash}).");
@@ -298,7 +296,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(Dates.Now, Dates.NextDay, ExpectedResult = false)]
         [TestCase(Dates.Now, Dates.NextMonth, ExpectedResult = false)]
         [TestCase(Dates.Now, Dates.NextYear, ExpectedResult = false)]
-        public bool Operators_Equals(string now, string other)
+        public bool Operators_Equals(string? now, string other)
         {
             return this.GetDate(now) == this.GetDate(other);
         }
@@ -312,7 +310,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(Dates.Now, Dates.NextDay, ExpectedResult = true)]
         [TestCase(Dates.Now, Dates.NextMonth, ExpectedResult = true)]
         [TestCase(Dates.Now, Dates.NextYear, ExpectedResult = true)]
-        public bool Operators_NotEquals(string now, string other)
+        public bool Operators_NotEquals(string? now, string other)
         {
             return this.GetDate(now) != this.GetDate(other);
         }
@@ -326,7 +324,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(Dates.Now, Dates.NextDay, ExpectedResult = true)]
         [TestCase(Dates.Now, Dates.NextMonth, ExpectedResult = true)]
         [TestCase(Dates.Now, Dates.NextYear, ExpectedResult = true)]
-        public bool Operators_LessThan(string now, string other)
+        public bool Operators_LessThan(string? now, string other)
         {
             return this.GetDate(now) < this.GetDate(other);
         }
@@ -340,7 +338,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(Dates.Now, Dates.NextDay, ExpectedResult = true)]
         [TestCase(Dates.Now, Dates.NextMonth, ExpectedResult = true)]
         [TestCase(Dates.Now, Dates.NextYear, ExpectedResult = true)]
-        public bool Operators_LessThanOrEqual(string now, string other)
+        public bool Operators_LessThanOrEqual(string? now, string other)
         {
             return this.GetDate(now) <= this.GetDate(other);
         }
@@ -354,7 +352,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(Dates.Now, Dates.NextDay, ExpectedResult = false)]
         [TestCase(Dates.Now, Dates.NextMonth, ExpectedResult = false)]
         [TestCase(Dates.Now, Dates.NextYear, ExpectedResult = false)]
-        public bool Operators_MoreThan(string now, string other)
+        public bool Operators_MoreThan(string? now, string other)
         {
             return this.GetDate(now) > this.GetDate(other);
         }
@@ -368,7 +366,7 @@ namespace SMAPI.Tests.Utilities
         [TestCase(Dates.Now, Dates.NextDay, ExpectedResult = false)]
         [TestCase(Dates.Now, Dates.NextMonth, ExpectedResult = false)]
         [TestCase(Dates.Now, Dates.NextYear, ExpectedResult = false)]
-        public bool Operators_MoreThanOrEqual(string now, string other)
+        public bool Operators_MoreThanOrEqual(string? now, string other)
         {
             return this.GetDate(now) > this.GetDate(other);
         }
@@ -379,7 +377,8 @@ namespace SMAPI.Tests.Utilities
         *********/
         /// <summary>Convert a string date into a game date, to make unit tests easier to read.</summary>
         /// <param name="dateStr">The date string like "dd MMMM yy".</param>
-        private SDate GetDate(string dateStr)
+        [return: NotNullIfNotNull("dateStr")]
+        private SDate? GetDate(string? dateStr)
         {
             if (dateStr == null)
                 return null;
diff --git a/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs b/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
index 7695fbf8..8e7e1fb8 100644
--- a/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
+++ b/src/SMAPI.Tests/WikiClient/ChangeDescriptorTests.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using NUnit.Framework;
 using StardewModdingAPI;
@@ -22,15 +20,14 @@ namespace SMAPI.Tests.WikiClient
         {
             // arrange
             string rawDescriptor = "-Nexus:2400,    -B, XX → YY, Nexus:451,+A, XXX → YYY, invalidA →, → invalidB";
-            string[] expectedAdd = new[] { "Nexus:451", "A" };
-            string[] expectedRemove = new[] { "Nexus:2400", "B" };
+            string[] expectedAdd = { "Nexus:451", "A" };
+            string[] expectedRemove = { "Nexus:2400", "B" };
             IDictionary<string, string> expectedReplace = new Dictionary<string, string>
             {
                 ["XX"] = "YY",
                 ["XXX"] = "YYY"
             };
-            string[] expectedErrors = new[]
-            {
+            string[] expectedErrors = {
                 "Failed parsing ' invalidA →': can't map to a blank value. Use the '-value' format to remove a value.",
                 "Failed parsing ' → invalidB': can't map from a blank old value. Use the '+value' format to add a value."
             };
@@ -50,15 +47,14 @@ namespace SMAPI.Tests.WikiClient
         {
             // arrange
             string rawDescriptor = "-1.0.1,    -2.0-beta, 1.00 → 1.0, 1.0.0,+2.0-beta.15, 2.0 → 2.0-beta, invalidA →, → invalidB";
-            string[] expectedAdd = new[] { "1.0.0", "2.0.0-beta.15" };
-            string[] expectedRemove = new[] { "1.0.1", "2.0.0-beta" };
+            string[] expectedAdd = { "1.0.0", "2.0.0-beta.15" };
+            string[] expectedRemove = { "1.0.1", "2.0.0-beta" };
             IDictionary<string, string> expectedReplace = new Dictionary<string, string>
             {
                 ["1.00"] = "1.0.0",
                 ["2.0.0"] = "2.0.0-beta"
             };
-            string[] expectedErrors = new[]
-            {
+            string[] expectedErrors = {
                 "Failed parsing ' invalidA →': can't map to a blank value. Use the '-value' format to remove a value.",
                 "Failed parsing ' → invalidB': can't map from a blank old value. Use the '+value' format to add a value."
             };
@@ -67,7 +63,7 @@ namespace SMAPI.Tests.WikiClient
             ChangeDescriptor parsed = ChangeDescriptor.Parse(
                 rawDescriptor,
                 out string[] errors,
-                formatValue: raw => SemanticVersion.TryParse(raw, out ISemanticVersion version)
+                formatValue: raw => SemanticVersion.TryParse(raw, out ISemanticVersion? version)
                     ? version.ToString()
                     : raw
             );
@@ -111,9 +107,9 @@ namespace SMAPI.Tests.WikiClient
         [TestCase("", "+Nexus:A, Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A→Nexus:B", ExpectedResult = "Nexus:A, Nexus:B")]
         [TestCase("Nexus:2400", "+Nexus:A, Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A→Nexus:B", ExpectedResult = "Nexus:2401, Nexus:A, Nexus:B")]
         [TestCase("Nexus:2400, Nexus:2401, Nexus:B,Chucklefish:14", "+Nexus:A, Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A→Nexus:B", ExpectedResult = "Nexus:2401, Nexus:2401, Nexus:B, Nexus:A")]
-        public string Apply_Raw(string input, string descriptor)
+        public string Apply_Raw(string input, string? descriptor)
         {
-            var parsed = ChangeDescriptor.Parse(descriptor, out string[] errors);
+            ChangeDescriptor parsed = ChangeDescriptor.Parse(descriptor, out string[] errors);
 
             Assert.IsEmpty(errors, "Parsing the descriptor failed.");
 
@@ -128,7 +124,7 @@ namespace SMAPI.Tests.WikiClient
         [TestCase("-Nexus:2400", ExpectedResult = "-Nexus:2400")]
         [TestCase("  Nexus:2400   →Nexus:2401  ", ExpectedResult = "Nexus:2400 → Nexus:2401")]
         [TestCase("+Nexus:A, Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A→Nexus:B", ExpectedResult = "+Nexus:A, +Nexus:B, -Chucklefish:14, Nexus:2400 → Nexus:2401, Nexus:A → Nexus:B")]
-        public string ToString(string descriptor)
+        public string ToString(string? descriptor)
         {
             var parsed = ChangeDescriptor.Parse(descriptor, out string[] errors);
 
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
index 5978803e..8646f1cc 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
@@ -47,6 +48,9 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <summary>Apply the change descriptors to a comma-delimited field.</summary>
         /// <param name="rawField">The raw field text.</param>
         /// <returns>Returns the modified field.</returns>
+#if NET5_0_OR_GREATER
+        [return: NotNullIfNotNull("rawField")]
+#endif
         public string? ApplyToCopy(string? rawField)
         {
             // get list
@@ -119,7 +123,7 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         /// <param name="descriptor">The raw change descriptor.</param>
         /// <param name="errors">The human-readable error message describing any invalid values that were ignored.</param>
         /// <param name="formatValue">Format a raw value into a normalized form if needed.</param>
-        public static ChangeDescriptor Parse(string descriptor, out string[] errors, Func<string, string>? formatValue = null)
+        public static ChangeDescriptor Parse(string? descriptor, out string[] errors, Func<string, string>? formatValue = null)
         {
             // init
             formatValue ??= p => p;

From 40aebb74c65e0c7300b5f4fcb066f3fd2b2a5fdd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 12 Apr 2022 21:01:13 -0400
Subject: [PATCH 544/856] enable nullable annotations in installer (#837)

---
 .../Framework/InstallerContext.cs             |  4 +-
 .../Framework/InstallerPaths.cs               |  2 -
 src/SMAPI.Installer/InteractiveInstaller.cs   | 81 +++++++++++--------
 src/SMAPI.Installer/Program.cs                |  8 +-
 4 files changed, 52 insertions(+), 43 deletions(-)

diff --git a/src/SMAPI.Installer/Framework/InstallerContext.cs b/src/SMAPI.Installer/Framework/InstallerContext.cs
index 23d5b17c..a2c63dd8 100644
--- a/src/SMAPI.Installer/Framework/InstallerContext.cs
+++ b/src/SMAPI.Installer/Framework/InstallerContext.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.IO;
 using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.GameScanning;
@@ -46,7 +44,7 @@ namespace StardewModdingAPI.Installer.Framework
         /// <summary>Get the installer's version number.</summary>
         public ISemanticVersion GetInstallerVersion()
         {
-            var raw = this.GetType().Assembly.GetName().Version;
+            var raw = this.GetType().Assembly.GetName().Version!;
             return new SemanticVersion(raw);
         }
 
diff --git a/src/SMAPI.Installer/Framework/InstallerPaths.cs b/src/SMAPI.Installer/Framework/InstallerPaths.cs
index fd9d1be6..0976eceb 100644
--- a/src/SMAPI.Installer/Framework/InstallerPaths.cs
+++ b/src/SMAPI.Installer/Framework/InstallerPaths.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.IO;
 using StardewModdingAPI.Toolkit.Framework;
 
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index b07c0461..5138173a 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -1,8 +1,7 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
 using System.IO;
 using System.Linq;
@@ -37,6 +36,7 @@ namespace StardewModdingApi.Installer
         /// <summary>Get the absolute file or folder paths to remove when uninstalling SMAPI.</summary>
         /// <param name="installDir">The folder for Stardew Valley and SMAPI.</param>
         /// <param name="modsDir">The folder for SMAPI mods.</param>
+        [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These are valid file names.")]
         private IEnumerable<string> GetUninstallPaths(DirectoryInfo installDir, DirectoryInfo modsDir)
         {
             string GetInstallPath(string path) => Path.Combine(installDir.FullName, path);
@@ -166,7 +166,7 @@ namespace StardewModdingApi.Installer
             }
 
             // get game path from CLI
-            string gamePathArg = null;
+            string? gamePathArg = null;
             {
                 int pathIndex = Array.LastIndexOf(args, "--game-path") + 1;
                 if (pathIndex >= 1 && args.Length >= pathIndex)
@@ -191,8 +191,8 @@ namespace StardewModdingApi.Installer
                 ** show theme selector
                 ****/
                 // get theme writers
-                var lightBackgroundWriter = new ColorfulConsoleWriter(context.Platform, ColorfulConsoleWriter.GetDefaultColorSchemeConfig(MonitorColorScheme.LightBackground));
-                var darkBackgroundWriter = new ColorfulConsoleWriter(context.Platform, ColorfulConsoleWriter.GetDefaultColorSchemeConfig(MonitorColorScheme.DarkBackground));
+                ColorfulConsoleWriter lightBackgroundWriter = new(context.Platform, ColorfulConsoleWriter.GetDefaultColorSchemeConfig(MonitorColorScheme.LightBackground));
+                ColorfulConsoleWriter darkBackgroundWriter = new(context.Platform, ColorfulConsoleWriter.GetDefaultColorSchemeConfig(MonitorColorScheme.DarkBackground));
 
                 // print question
                 this.PrintPlain("Which text looks more readable?");
@@ -239,7 +239,7 @@ namespace StardewModdingApi.Installer
                 ** collect details
                 ****/
                 // get game path
-                DirectoryInfo installDir = this.InteractivelyGetInstallPath(toolkit, context, gamePathArg);
+                DirectoryInfo? installDir = this.InteractivelyGetInstallPath(toolkit, context, gamePathArg);
                 if (installDir == null)
                 {
                     this.PrintError("Failed finding your game path.");
@@ -451,7 +451,7 @@ namespace StardewModdingApi.Installer
                             }
 
                             // find target folder
-                            ModFolder targetMod = targetMods.FirstOrDefault(p => p.Manifest?.UniqueID?.Equals(sourceMod.Manifest.UniqueID, StringComparison.OrdinalIgnoreCase) == true);
+                            ModFolder? targetMod = targetMods.FirstOrDefault(p => p.Manifest?.UniqueID?.Equals(sourceMod.Manifest.UniqueID, StringComparison.OrdinalIgnoreCase) == true);
                             DirectoryInfo defaultTargetFolder = new(Path.Combine(paths.ModsPath, sourceMod.Directory.Name));
                             DirectoryInfo targetFolder = targetMod?.Directory ?? defaultTargetFolder;
                             this.PrintDebug(targetFolder.FullName == defaultTargetFolder.FullName
@@ -534,27 +534,45 @@ namespace StardewModdingApi.Installer
 
         /// <summary>Print a message without formatting.</summary>
         /// <param name="text">The text to print.</param>
-        private void PrintPlain(string text) => Console.WriteLine(text);
+        private void PrintPlain(string text)
+        {
+            Console.WriteLine(text);
+        }
 
         /// <summary>Print a debug message.</summary>
         /// <param name="text">The text to print.</param>
-        private void PrintDebug(string text) => this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Debug);
+        private void PrintDebug(string text)
+        {
+            this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Debug);
+        }
 
         /// <summary>Print a debug message.</summary>
         /// <param name="text">The text to print.</param>
-        private void PrintInfo(string text) => this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Info);
+        private void PrintInfo(string text)
+        {
+            this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Info);
+        }
 
         /// <summary>Print a warning message.</summary>
         /// <param name="text">The text to print.</param>
-        private void PrintWarning(string text) => this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Warn);
+        private void PrintWarning(string text)
+        {
+            this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Warn);
+        }
 
         /// <summary>Print a warning message.</summary>
         /// <param name="text">The text to print.</param>
-        private void PrintError(string text) => this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Error);
+        private void PrintError(string text)
+        {
+            this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Error);
+        }
 
         /// <summary>Print a success message.</summary>
         /// <param name="text">The text to print.</param>
-        private void PrintSuccess(string text) => this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Success);
+        private void PrintSuccess(string text)
+        {
+            this.ConsoleWriter.WriteLine(text, ConsoleLogLevel.Success);
+        }
 
         /// <summary>Interactively delete a file or folder path, and block until deletion completes.</summary>
         /// <param name="path">The file or folder path.</param>
@@ -580,7 +598,7 @@ namespace StardewModdingApi.Installer
         /// <param name="source">The file or folder to copy.</param>
         /// <param name="targetFolder">The folder to copy into.</param>
         /// <param name="filter">A filter which matches directories and files to copy, or <c>null</c> to match all.</param>
-        private void RecursiveCopy(FileSystemInfo source, DirectoryInfo targetFolder, Func<FileSystemInfo, bool> filter = null)
+        private void RecursiveCopy(FileSystemInfo source, DirectoryInfo targetFolder, Func<FileSystemInfo, bool>? filter = null)
         {
             if (filter != null && !filter(source))
                 return;
@@ -596,7 +614,7 @@ namespace StardewModdingApi.Installer
 
                 case DirectoryInfo sourceDir:
                     DirectoryInfo targetSubfolder = new(Path.Combine(targetFolder.FullName, sourceDir.Name));
-                    foreach (var entry in sourceDir.EnumerateFileSystemInfos())
+                    foreach (FileSystemInfo entry in sourceDir.EnumerateFileSystemInfos())
                         this.RecursiveCopy(entry, targetSubfolder, filter);
                     break;
 
@@ -610,7 +628,7 @@ namespace StardewModdingApi.Installer
         /// <param name="message">The message to print.</param>
         /// <param name="options">The allowed options (not case sensitive).</param>
         /// <param name="indent">The indentation to prefix to output.</param>
-        private string InteractivelyChoose(string message, string[] options, string indent = "", Action<string> print = null)
+        private string InteractivelyChoose(string message, string[] options, string indent = "", Action<string>? print = null)
         {
             print ??= this.PrintInfo;
 
@@ -618,8 +636,8 @@ namespace StardewModdingApi.Installer
             {
                 print(indent + message);
                 Console.Write(indent);
-                string input = Console.ReadLine()?.Trim().ToLowerInvariant();
-                if (!options.Contains(input))
+                string? input = Console.ReadLine()?.Trim().ToLowerInvariant();
+                if (input == null || !options.Contains(input))
                 {
                     print($"{indent}That's not a valid option.");
                     continue;
@@ -632,7 +650,7 @@ namespace StardewModdingApi.Installer
         /// <param name="toolkit">The mod toolkit.</param>
         /// <param name="context">The installer context.</param>
         /// <param name="specifiedPath">The path specified as a command-line argument (if any), which should override automatic path detection.</param>
-        private DirectoryInfo InteractivelyGetInstallPath(ModToolkit toolkit, InstallerContext context, string specifiedPath)
+        private DirectoryInfo? InteractivelyGetInstallPath(ModToolkit toolkit, InstallerContext context, string? specifiedPath)
         {
             // use specified path
             if (specifiedPath != null)
@@ -699,7 +717,7 @@ namespace StardewModdingApi.Installer
                 // get path from user
                 Console.WriteLine();
                 this.PrintInfo($"Type the file path to the game directory (the one containing '{Constants.GameDllName}'), then press enter.");
-                string path = Console.ReadLine()?.Trim();
+                string? path = Console.ReadLine()?.Trim();
                 if (string.IsNullOrWhiteSpace(path))
                 {
                     this.PrintWarning("You must specify a directory path to continue.");
@@ -712,13 +730,13 @@ namespace StardewModdingApi.Installer
                     : path.Replace("\\ ", " "); // in Linux/macOS, spaces in paths may be escaped if copied from the command line
                 if (path.StartsWith("~/"))
                 {
-                    string home = Environment.GetEnvironmentVariable("HOME") ?? Environment.GetEnvironmentVariable("USERPROFILE");
+                    string home = Environment.GetEnvironmentVariable("HOME") ?? Environment.GetEnvironmentVariable("USERPROFILE")!;
                     path = Path.Combine(home, path.Substring(2));
                 }
 
                 // get directory
                 if (File.Exists(path))
-                    path = Path.GetDirectoryName(path);
+                    path = Path.GetDirectoryName(path)!;
                 DirectoryInfo directory = new(path);
 
                 // validate path
@@ -765,7 +783,7 @@ namespace StardewModdingApi.Installer
 
             // game folder which contains the installer, if any
             {
-                DirectoryInfo curPath = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory;
+                DirectoryInfo? curPath = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory;
                 while (curPath?.Parent != null) // must be in a folder (not at the root)
                 {
                     if (context.LooksLikeGameFolder(curPath))
@@ -787,7 +805,7 @@ namespace StardewModdingApi.Installer
             }
         }
 
-        /// <summary>Interactively move mods out of the appdata directory.</summary>
+        /// <summary>Interactively move mods out of the app data directory.</summary>
         /// <param name="properModsDir">The directory which should contain all mods.</param>
         /// <param name="packagedModsDir">The installer directory containing packaged mods.</param>
         private void InteractivelyRemoveAppDataMods(DirectoryInfo properModsDir, DirectoryInfo packagedModsDir)
@@ -847,7 +865,7 @@ namespace StardewModdingApi.Installer
         /// <summary>Move a filesystem entry to a new parent directory.</summary>
         /// <param name="entry">The filesystem entry to move.</param>
         /// <param name="newPath">The destination path.</param>
-        /// <remarks>We can't use <see cref="FileInfo.MoveTo"/> or <see cref="DirectoryInfo.MoveTo"/>, because those don't work across partitions.</remarks>
+        /// <remarks>We can't use <see cref="FileInfo.MoveTo(string)"/> or <see cref="DirectoryInfo.MoveTo"/>, because those don't work across partitions.</remarks>
         private void Move(FileSystemInfo entry, string newPath)
         {
             // file
@@ -874,15 +892,12 @@ namespace StardewModdingApi.Installer
         /// <param name="entry">The file or folder info.</param>
         private bool ShouldCopy(FileSystemInfo entry)
         {
-            switch (entry.Name)
+            return entry.Name switch
             {
-                case "mcs":
-                    return false; // ignore macOS symlink
-                case "Mods":
-                    return false; // Mods folder handled separately
-                default:
-                    return true;
-            }
+                "mcs" => false, // ignore macOS symlink
+                "Mods" => false, // Mods folder handled separately
+                _ => true
+            };
         }
     }
 }
diff --git a/src/SMAPI.Installer/Program.cs b/src/SMAPI.Installer/Program.cs
index 5139513f..dc452a46 100644
--- a/src/SMAPI.Installer/Program.cs
+++ b/src/SMAPI.Installer/Program.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
@@ -17,7 +15,7 @@ namespace StardewModdingApi.Installer
         *********/
         /// <summary>The absolute path of the installer folder.</summary>
         [SuppressMessage("ReSharper", "AssignNullToNotNullAttribute", Justification = "The assembly location is never null in this context.")]
-        private static readonly string InstallerPath = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
+        private static readonly string InstallerPath = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location)!;
 
         /// <summary>The absolute path of the folder containing the unzipped installer files.</summary>
         private static readonly string ExtractedBundlePath = Path.Combine(Path.GetTempPath(), $"SMAPI-installer-{Guid.NewGuid():N}");
@@ -68,14 +66,14 @@ namespace StardewModdingApi.Installer
         /// <summary>Method called when assembly resolution fails, which may return a manually resolved assembly.</summary>
         /// <param name="sender">The event sender.</param>
         /// <param name="e">The event arguments.</param>
-        private static Assembly CurrentDomain_AssemblyResolve(object sender, ResolveEventArgs e)
+        private static Assembly? CurrentDomain_AssemblyResolve(object? sender, ResolveEventArgs e)
         {
             try
             {
                 AssemblyName name = new(e.Name);
                 foreach (FileInfo dll in new DirectoryInfo(Program.InternalFilesPath).EnumerateFiles("*.dll"))
                 {
-                    if (name.Name.Equals(AssemblyName.GetAssemblyName(dll.FullName).Name, StringComparison.OrdinalIgnoreCase))
+                    if (name.Name != null && name.Name.Equals(AssemblyName.GetAssemblyName(dll.FullName).Name, StringComparison.OrdinalIgnoreCase))
                         return Assembly.LoadFrom(dll.FullName);
                 }
                 return null;

From 6e9e8aef1ef97e1a4ef4410ce300cb1c47eca986 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 19:00:24 -0400
Subject: [PATCH 545/856] enable nullable annotations in SMAPI where no changes
 are needed (#837)

---
 src/SMAPI/Context.cs                                         | 2 --
 src/SMAPI/Events/AssetReadyEventArgs.cs                      | 2 --
 src/SMAPI/Events/AssetsInvalidatedEventArgs.cs               | 2 --
 src/SMAPI/Events/BuildingListChangedEventArgs.cs             | 2 --
 src/SMAPI/Events/ButtonPressedEventArgs.cs                   | 2 --
 src/SMAPI/Events/ButtonReleasedEventArgs.cs                  | 2 --
 src/SMAPI/Events/ButtonsChangedEventArgs.cs                  | 2 --
 src/SMAPI/Events/ChestInventoryChangedEventArgs.cs           | 2 --
 src/SMAPI/Events/CursorMovedEventArgs.cs                     | 2 --
 src/SMAPI/Events/DebrisListChangedEventArgs.cs               | 2 --
 src/SMAPI/Events/FurnitureListChangedEventArgs.cs            | 2 --
 src/SMAPI/Events/IContentEvents.cs                           | 2 --
 src/SMAPI/Events/IDisplayEvents.cs                           | 2 --
 src/SMAPI/Events/IGameLoopEvents.cs                          | 2 --
 src/SMAPI/Events/IInputEvents.cs                             | 2 --
 src/SMAPI/Events/IModEvents.cs                               | 2 --
 src/SMAPI/Events/IMultiplayerEvents.cs                       | 2 --
 src/SMAPI/Events/IPlayerEvents.cs                            | 2 --
 src/SMAPI/Events/ISpecialisedEvents.cs                       | 2 --
 src/SMAPI/Events/IWorldEvents.cs                             | 2 --
 src/SMAPI/Events/InventoryChangedEventArgs.cs                | 2 --
 src/SMAPI/Events/ItemStackSizeChange.cs                      | 2 --
 src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs  | 2 --
 src/SMAPI/Events/LevelChangedEventArgs.cs                    | 2 --
 src/SMAPI/Events/LocaleChangedEventArgs.cs                   | 2 --
 src/SMAPI/Events/LocationListChangedEventArgs.cs             | 2 --
 src/SMAPI/Events/NpcListChangedEventArgs.cs                  | 2 --
 src/SMAPI/Events/ObjectListChangedEventArgs.cs               | 2 --
 src/SMAPI/Events/PeerConnectedEventArgs.cs                   | 2 --
 src/SMAPI/Events/PeerContextReceivedEventArgs.cs             | 2 --
 src/SMAPI/Events/PeerDisconnectedEventArgs.cs                | 2 --
 src/SMAPI/Events/RenderedActiveMenuEventArgs.cs              | 2 --
 src/SMAPI/Events/RenderedEventArgs.cs                        | 2 --
 src/SMAPI/Events/RenderedHudEventArgs.cs                     | 2 --
 src/SMAPI/Events/RenderedWorldEventArgs.cs                   | 2 --
 src/SMAPI/Events/RenderingActiveMenuEventArgs.cs             | 2 --
 src/SMAPI/Events/RenderingEventArgs.cs                       | 2 --
 src/SMAPI/Events/RenderingHudEventArgs.cs                    | 2 --
 src/SMAPI/Events/RenderingWorldEventArgs.cs                  | 2 --
 src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs       | 2 --
 src/SMAPI/Events/WarpedEventArgs.cs                          | 2 --
 src/SMAPI/Framework/Commands/IInternalCommand.cs             | 2 --
 src/SMAPI/Framework/Commands/ReloadI18nCommand.cs            | 2 --
 src/SMAPI/Framework/Content/AssetOperationGroup.cs           | 2 --
 src/SMAPI/Framework/Content/TilesheetReference.cs            | 2 --
 src/SMAPI/Framework/DeprecationWarning.cs                    | 2 --
 src/SMAPI/Framework/Events/EventManager.cs                   | 2 --
 src/SMAPI/Framework/Events/IManagedEvent.cs                  | 2 --
 src/SMAPI/Framework/Events/ModContentEvents.cs               | 2 --
 src/SMAPI/Framework/Events/ModDisplayEvents.cs               | 2 --
 src/SMAPI/Framework/Events/ModEvents.cs                      | 2 --
 src/SMAPI/Framework/Events/ModEventsBase.cs                  | 2 --
 src/SMAPI/Framework/Events/ModGameLoopEvents.cs              | 2 --
 src/SMAPI/Framework/Events/ModInputEvents.cs                 | 2 --
 src/SMAPI/Framework/Events/ModMultiplayerEvents.cs           | 2 --
 src/SMAPI/Framework/Events/ModPlayerEvents.cs                | 2 --
 src/SMAPI/Framework/Events/ModSpecialisedEvents.cs           | 2 --
 src/SMAPI/Framework/Events/ModWorldEvents.cs                 | 2 --
 .../Framework/Exceptions/SAssemblyLoadFailedException.cs     | 2 --
 src/SMAPI/Framework/Input/IInputStateBuilder.cs              | 2 --
 src/SMAPI/Framework/Input/KeyboardStateBuilder.cs            | 4 +---
 src/SMAPI/Framework/Input/MouseStateBuilder.cs               | 2 --
 src/SMAPI/Framework/ModHelpers/BaseHelper.cs                 | 2 --
 src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs          | 2 --
 src/SMAPI/Framework/ModHelpers/InputHelper.cs                | 2 --
 src/SMAPI/Framework/ModHelpers/ModHelper.cs                  | 2 --
 src/SMAPI/Framework/ModHelpers/TranslationHelper.cs          | 2 --
 src/SMAPI/Framework/ModLinked.cs                             | 2 --
 src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs         | 2 --
 src/SMAPI/Framework/ModLoading/IInstructionHandler.cs        | 2 --
 .../Framework/ModLoading/IncompatibleInstructionException.cs | 2 --
 src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs        | 2 --
 .../Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs | 5 ++---
 .../ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs     | 2 --
 src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs       | 2 --
 .../Framework/ModLoading/Symbols/SymbolWriterProvider.cs     | 2 --
 src/SMAPI/Framework/Monitor.cs                               | 2 --
 src/SMAPI/Framework/Networking/SGalaxyNetClient.cs           | 2 --
 src/SMAPI/Framework/Networking/SGalaxyNetServer.cs           | 2 --
 src/SMAPI/Framework/Networking/SLidgrenClient.cs             | 2 --
 src/SMAPI/Framework/Networking/SLidgrenServer.cs             | 2 --
 src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs      | 2 --
 src/SMAPI/Framework/SChatBox.cs                              | 2 --
 src/SMAPI/Framework/SGameRunner.cs                           | 4 +---
 src/SMAPI/Framework/Singleton.cs                             | 2 --
 .../StateTracking/FieldWatchers/BaseDisposableWatcher.cs     | 2 --
 .../StateTracking/FieldWatchers/ComparableListWatcher.cs     | 2 --
 .../FieldWatchers/ImmutableCollectionWatcher.cs              | 2 --
 .../StateTracking/FieldWatchers/NetCollectionWatcher.cs      | 2 --
 .../Framework/StateTracking/FieldWatchers/NetListWatcher.cs  | 2 --
 .../Framework/StateTracking/FieldWatchers/NetValueWatcher.cs | 2 --
 src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs      | 2 --
 src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs      | 2 --
 src/SMAPI/Framework/StateTracking/IValueWatcher.cs           | 2 --
 src/SMAPI/Framework/StateTracking/IWatcher.cs                | 2 --
 src/SMAPI/Framework/Utilities/ContextHash.cs                 | 2 --
 src/SMAPI/GamePlatform.cs                                    | 2 --
 src/SMAPI/IAssetDataForDictionary.cs                         | 2 --
 src/SMAPI/IAssetDataForImage.cs                              | 2 --
 src/SMAPI/IAssetDataForMap.cs                                | 2 --
 src/SMAPI/IAssetEditor.cs                                    | 2 --
 src/SMAPI/IAssetLoader.cs                                    | 2 --
 src/SMAPI/ICommandHelper.cs                                  | 2 --
 src/SMAPI/IContentPackHelper.cs                              | 2 --
 src/SMAPI/ICursorPosition.cs                                 | 2 --
 src/SMAPI/IInputHelper.cs                                    | 2 --
 src/SMAPI/IModHelper.cs                                      | 2 --
 src/SMAPI/IModInfo.cs                                        | 2 --
 src/SMAPI/IModLinked.cs                                      | 2 --
 src/SMAPI/IMonitor.cs                                        | 2 --
 src/SMAPI/IMultiplayerPeerMod.cs                             | 2 --
 src/SMAPI/ITranslationHelper.cs                              | 4 +---
 112 files changed, 5 insertions(+), 228 deletions(-)

diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index e906375b..aa4ecf35 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Events;
diff --git a/src/SMAPI/Events/AssetReadyEventArgs.cs b/src/SMAPI/Events/AssetReadyEventArgs.cs
index 19e5a9df..2c308f18 100644
--- a/src/SMAPI/Events/AssetReadyEventArgs.cs
+++ b/src/SMAPI/Events/AssetReadyEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
index bd0df598..614cdf49 100644
--- a/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
+++ b/src/SMAPI/Events/AssetsInvalidatedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
diff --git a/src/SMAPI/Events/BuildingListChangedEventArgs.cs b/src/SMAPI/Events/BuildingListChangedEventArgs.cs
index ba9574cc..74f37710 100644
--- a/src/SMAPI/Events/BuildingListChangedEventArgs.cs
+++ b/src/SMAPI/Events/BuildingListChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/ButtonPressedEventArgs.cs b/src/SMAPI/Events/ButtonPressedEventArgs.cs
index 94684513..1b30fd23 100644
--- a/src/SMAPI/Events/ButtonPressedEventArgs.cs
+++ b/src/SMAPI/Events/ButtonPressedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Framework.Input;
 
diff --git a/src/SMAPI/Events/ButtonReleasedEventArgs.cs b/src/SMAPI/Events/ButtonReleasedEventArgs.cs
index 6ff3727d..40ec1cc1 100644
--- a/src/SMAPI/Events/ButtonReleasedEventArgs.cs
+++ b/src/SMAPI/Events/ButtonReleasedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Framework.Input;
 
diff --git a/src/SMAPI/Events/ButtonsChangedEventArgs.cs b/src/SMAPI/Events/ButtonsChangedEventArgs.cs
index c63d34e6..a5e87735 100644
--- a/src/SMAPI/Events/ButtonsChangedEventArgs.cs
+++ b/src/SMAPI/Events/ButtonsChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/ChestInventoryChangedEventArgs.cs b/src/SMAPI/Events/ChestInventoryChangedEventArgs.cs
index bc8ac0c0..4b4c4210 100644
--- a/src/SMAPI/Events/ChestInventoryChangedEventArgs.cs
+++ b/src/SMAPI/Events/ChestInventoryChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using StardewValley;
diff --git a/src/SMAPI/Events/CursorMovedEventArgs.cs b/src/SMAPI/Events/CursorMovedEventArgs.cs
index f3e7513b..43ff90ce 100644
--- a/src/SMAPI/Events/CursorMovedEventArgs.cs
+++ b/src/SMAPI/Events/CursorMovedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/DebrisListChangedEventArgs.cs b/src/SMAPI/Events/DebrisListChangedEventArgs.cs
index 56b1f30a..61b7590a 100644
--- a/src/SMAPI/Events/DebrisListChangedEventArgs.cs
+++ b/src/SMAPI/Events/DebrisListChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/FurnitureListChangedEventArgs.cs b/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
index cda1b6cc..683f4620 100644
--- a/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
+++ b/src/SMAPI/Events/FurnitureListChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/IContentEvents.cs b/src/SMAPI/Events/IContentEvents.cs
index 109f9753..d537db70 100644
--- a/src/SMAPI/Events/IContentEvents.cs
+++ b/src/SMAPI/Events/IContentEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IDisplayEvents.cs b/src/SMAPI/Events/IDisplayEvents.cs
index b8b89120..dbf8d90f 100644
--- a/src/SMAPI/Events/IDisplayEvents.cs
+++ b/src/SMAPI/Events/IDisplayEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewValley;
 
diff --git a/src/SMAPI/Events/IGameLoopEvents.cs b/src/SMAPI/Events/IGameLoopEvents.cs
index 52bac3f8..6855737b 100644
--- a/src/SMAPI/Events/IGameLoopEvents.cs
+++ b/src/SMAPI/Events/IGameLoopEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IInputEvents.cs b/src/SMAPI/Events/IInputEvents.cs
index 01ceb224..081c40c0 100644
--- a/src/SMAPI/Events/IInputEvents.cs
+++ b/src/SMAPI/Events/IInputEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IModEvents.cs b/src/SMAPI/Events/IModEvents.cs
index a1aacbce..2603961b 100644
--- a/src/SMAPI/Events/IModEvents.cs
+++ b/src/SMAPI/Events/IModEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Events
 {
     /// <summary>Manages access to events raised by SMAPI.</summary>
diff --git a/src/SMAPI/Events/IMultiplayerEvents.cs b/src/SMAPI/Events/IMultiplayerEvents.cs
index c50eaf04..af9b5f17 100644
--- a/src/SMAPI/Events/IMultiplayerEvents.cs
+++ b/src/SMAPI/Events/IMultiplayerEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IPlayerEvents.cs b/src/SMAPI/Events/IPlayerEvents.cs
index 9d18bfad..81e17b1a 100644
--- a/src/SMAPI/Events/IPlayerEvents.cs
+++ b/src/SMAPI/Events/IPlayerEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/ISpecialisedEvents.cs b/src/SMAPI/Events/ISpecialisedEvents.cs
index 0ec5bf54..bf70956d 100644
--- a/src/SMAPI/Events/ISpecialisedEvents.cs
+++ b/src/SMAPI/Events/ISpecialisedEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/IWorldEvents.cs b/src/SMAPI/Events/IWorldEvents.cs
index 785dfa8f..c023e1f0 100644
--- a/src/SMAPI/Events/IWorldEvents.cs
+++ b/src/SMAPI/Events/IWorldEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/InventoryChangedEventArgs.cs b/src/SMAPI/Events/InventoryChangedEventArgs.cs
index 58c0ff8f..40cd4128 100644
--- a/src/SMAPI/Events/InventoryChangedEventArgs.cs
+++ b/src/SMAPI/Events/InventoryChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using StardewValley;
diff --git a/src/SMAPI/Events/ItemStackSizeChange.cs b/src/SMAPI/Events/ItemStackSizeChange.cs
index 5d0986aa..35369be2 100644
--- a/src/SMAPI/Events/ItemStackSizeChange.cs
+++ b/src/SMAPI/Events/ItemStackSizeChange.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using StardewValley;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs b/src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs
index aedb0e46..59d79f0f 100644
--- a/src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs
+++ b/src/SMAPI/Events/LargeTerrainFeatureListChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/LevelChangedEventArgs.cs b/src/SMAPI/Events/LevelChangedEventArgs.cs
index 3beb9fd5..c7303603 100644
--- a/src/SMAPI/Events/LevelChangedEventArgs.cs
+++ b/src/SMAPI/Events/LevelChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Enums;
 using StardewValley;
diff --git a/src/SMAPI/Events/LocaleChangedEventArgs.cs b/src/SMAPI/Events/LocaleChangedEventArgs.cs
index 015e7ec8..09d3f6e5 100644
--- a/src/SMAPI/Events/LocaleChangedEventArgs.cs
+++ b/src/SMAPI/Events/LocaleChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using LanguageCode = StardewValley.LocalizedContentManager.LanguageCode;
 
diff --git a/src/SMAPI/Events/LocationListChangedEventArgs.cs b/src/SMAPI/Events/LocationListChangedEventArgs.cs
index 055463dd..1ebb3e2d 100644
--- a/src/SMAPI/Events/LocationListChangedEventArgs.cs
+++ b/src/SMAPI/Events/LocationListChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/NpcListChangedEventArgs.cs b/src/SMAPI/Events/NpcListChangedEventArgs.cs
index fb6dc1c5..3a37f1e7 100644
--- a/src/SMAPI/Events/NpcListChangedEventArgs.cs
+++ b/src/SMAPI/Events/NpcListChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/ObjectListChangedEventArgs.cs b/src/SMAPI/Events/ObjectListChangedEventArgs.cs
index b1a636aa..b21d2867 100644
--- a/src/SMAPI/Events/ObjectListChangedEventArgs.cs
+++ b/src/SMAPI/Events/ObjectListChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/PeerConnectedEventArgs.cs b/src/SMAPI/Events/PeerConnectedEventArgs.cs
index 3d11a3b5..bfaa2bd3 100644
--- a/src/SMAPI/Events/PeerConnectedEventArgs.cs
+++ b/src/SMAPI/Events/PeerConnectedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/PeerContextReceivedEventArgs.cs b/src/SMAPI/Events/PeerContextReceivedEventArgs.cs
index 35a4b20d..151a295c 100644
--- a/src/SMAPI/Events/PeerContextReceivedEventArgs.cs
+++ b/src/SMAPI/Events/PeerContextReceivedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/PeerDisconnectedEventArgs.cs b/src/SMAPI/Events/PeerDisconnectedEventArgs.cs
index 0675b8fe..8517988a 100644
--- a/src/SMAPI/Events/PeerDisconnectedEventArgs.cs
+++ b/src/SMAPI/Events/PeerDisconnectedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Events
diff --git a/src/SMAPI/Events/RenderedActiveMenuEventArgs.cs b/src/SMAPI/Events/RenderedActiveMenuEventArgs.cs
index 3da0b4b4..efd4163b 100644
--- a/src/SMAPI/Events/RenderedActiveMenuEventArgs.cs
+++ b/src/SMAPI/Events/RenderedActiveMenuEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderedEventArgs.cs b/src/SMAPI/Events/RenderedEventArgs.cs
index e8beaaac..d6341b19 100644
--- a/src/SMAPI/Events/RenderedEventArgs.cs
+++ b/src/SMAPI/Events/RenderedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderedHudEventArgs.cs b/src/SMAPI/Events/RenderedHudEventArgs.cs
index b25ecd4c..46e89013 100644
--- a/src/SMAPI/Events/RenderedHudEventArgs.cs
+++ b/src/SMAPI/Events/RenderedHudEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderedWorldEventArgs.cs b/src/SMAPI/Events/RenderedWorldEventArgs.cs
index a99d6ab3..56145381 100644
--- a/src/SMAPI/Events/RenderedWorldEventArgs.cs
+++ b/src/SMAPI/Events/RenderedWorldEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderingActiveMenuEventArgs.cs b/src/SMAPI/Events/RenderingActiveMenuEventArgs.cs
index 3e3f3258..103f56df 100644
--- a/src/SMAPI/Events/RenderingActiveMenuEventArgs.cs
+++ b/src/SMAPI/Events/RenderingActiveMenuEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderingEventArgs.cs b/src/SMAPI/Events/RenderingEventArgs.cs
index 8f6b3557..5acbef09 100644
--- a/src/SMAPI/Events/RenderingEventArgs.cs
+++ b/src/SMAPI/Events/RenderingEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderingHudEventArgs.cs b/src/SMAPI/Events/RenderingHudEventArgs.cs
index 87269b90..84c96ecd 100644
--- a/src/SMAPI/Events/RenderingHudEventArgs.cs
+++ b/src/SMAPI/Events/RenderingHudEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/RenderingWorldEventArgs.cs b/src/SMAPI/Events/RenderingWorldEventArgs.cs
index 2fc9964f..d0d44789 100644
--- a/src/SMAPI/Events/RenderingWorldEventArgs.cs
+++ b/src/SMAPI/Events/RenderingWorldEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
diff --git a/src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs b/src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs
index 77a73102..cdf1e6dc 100644
--- a/src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs
+++ b/src/SMAPI/Events/TerrainFeatureListChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Events/WarpedEventArgs.cs b/src/SMAPI/Events/WarpedEventArgs.cs
index 92a8ea77..9afe4a4e 100644
--- a/src/SMAPI/Events/WarpedEventArgs.cs
+++ b/src/SMAPI/Events/WarpedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewValley;
 
diff --git a/src/SMAPI/Framework/Commands/IInternalCommand.cs b/src/SMAPI/Framework/Commands/IInternalCommand.cs
index 32e3e9f1..abf105b6 100644
--- a/src/SMAPI/Framework/Commands/IInternalCommand.cs
+++ b/src/SMAPI/Framework/Commands/IInternalCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework.Commands
 {
     /// <summary>A core SMAPI console command.</summary>
diff --git a/src/SMAPI/Framework/Commands/ReloadI18nCommand.cs b/src/SMAPI/Framework/Commands/ReloadI18nCommand.cs
index 2043b35e..12328bb6 100644
--- a/src/SMAPI/Framework/Commands/ReloadI18nCommand.cs
+++ b/src/SMAPI/Framework/Commands/ReloadI18nCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework.Commands
diff --git a/src/SMAPI/Framework/Content/AssetOperationGroup.cs b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
index e3c3f92c..a2fcb722 100644
--- a/src/SMAPI/Framework/Content/AssetOperationGroup.cs
+++ b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>A set of operations to apply to an asset for a given <see cref="IAssetEditor"/> or <see cref="IAssetLoader"/> implementation.</summary>
diff --git a/src/SMAPI/Framework/Content/TilesheetReference.cs b/src/SMAPI/Framework/Content/TilesheetReference.cs
index cdc4bc62..0339b802 100644
--- a/src/SMAPI/Framework/Content/TilesheetReference.cs
+++ b/src/SMAPI/Framework/Content/TilesheetReference.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using xTile.Dimensions;
 
 namespace StardewModdingAPI.Framework.Content
diff --git a/src/SMAPI/Framework/DeprecationWarning.cs b/src/SMAPI/Framework/DeprecationWarning.cs
index f155358b..5201b06c 100644
--- a/src/SMAPI/Framework/DeprecationWarning.cs
+++ b/src/SMAPI/Framework/DeprecationWarning.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework
 {
     /// <summary>A deprecation warning for a mod.</summary>
diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index c977e73d..41540047 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
diff --git a/src/SMAPI/Framework/Events/IManagedEvent.cs b/src/SMAPI/Framework/Events/IManagedEvent.cs
index 57277576..e4e3ca08 100644
--- a/src/SMAPI/Framework/Events/IManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/IManagedEvent.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework.Events
 {
     /// <summary>Metadata for an event raised by SMAPI.</summary>
diff --git a/src/SMAPI/Framework/Events/ModContentEvents.cs b/src/SMAPI/Framework/Events/ModContentEvents.cs
index f198b793..beb96031 100644
--- a/src/SMAPI/Framework/Events/ModContentEvents.cs
+++ b/src/SMAPI/Framework/Events/ModContentEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModDisplayEvents.cs b/src/SMAPI/Framework/Events/ModDisplayEvents.cs
index b2110cce..48f55324 100644
--- a/src/SMAPI/Framework/Events/ModDisplayEvents.cs
+++ b/src/SMAPI/Framework/Events/ModDisplayEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModEvents.cs b/src/SMAPI/Framework/Events/ModEvents.cs
index e8f8885d..1fb3482c 100644
--- a/src/SMAPI/Framework/Events/ModEvents.cs
+++ b/src/SMAPI/Framework/Events/ModEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI.Framework.Events
diff --git a/src/SMAPI/Framework/Events/ModEventsBase.cs b/src/SMAPI/Framework/Events/ModEventsBase.cs
index 295caa0d..77708fc1 100644
--- a/src/SMAPI/Framework/Events/ModEventsBase.cs
+++ b/src/SMAPI/Framework/Events/ModEventsBase.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework.Events
 {
     /// <summary>An internal base class for event API classes.</summary>
diff --git a/src/SMAPI/Framework/Events/ModGameLoopEvents.cs b/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
index 51803daf..5f0db369 100644
--- a/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
+++ b/src/SMAPI/Framework/Events/ModGameLoopEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModInputEvents.cs b/src/SMAPI/Framework/Events/ModInputEvents.cs
index 6af79c59..40edf806 100644
--- a/src/SMAPI/Framework/Events/ModInputEvents.cs
+++ b/src/SMAPI/Framework/Events/ModInputEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs b/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
index 7d3ce510..b90f64fa 100644
--- a/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
+++ b/src/SMAPI/Framework/Events/ModMultiplayerEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModPlayerEvents.cs b/src/SMAPI/Framework/Events/ModPlayerEvents.cs
index dac8f05b..b2d89e9a 100644
--- a/src/SMAPI/Framework/Events/ModPlayerEvents.cs
+++ b/src/SMAPI/Framework/Events/ModPlayerEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs b/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
index 4b438034..7980208b 100644
--- a/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
+++ b/src/SMAPI/Framework/Events/ModSpecialisedEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Events/ModWorldEvents.cs b/src/SMAPI/Framework/Events/ModWorldEvents.cs
index 614945c7..a7b7d799 100644
--- a/src/SMAPI/Framework/Events/ModWorldEvents.cs
+++ b/src/SMAPI/Framework/Events/ModWorldEvents.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/Framework/Exceptions/SAssemblyLoadFailedException.cs b/src/SMAPI/Framework/Exceptions/SAssemblyLoadFailedException.cs
index 4e03a687..ec9279f1 100644
--- a/src/SMAPI/Framework/Exceptions/SAssemblyLoadFailedException.cs
+++ b/src/SMAPI/Framework/Exceptions/SAssemblyLoadFailedException.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework.Exceptions
diff --git a/src/SMAPI/Framework/Input/IInputStateBuilder.cs b/src/SMAPI/Framework/Input/IInputStateBuilder.cs
index 3fb62686..28d62439 100644
--- a/src/SMAPI/Framework/Input/IInputStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/IInputStateBuilder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.Input
diff --git a/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs b/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
index 81ca0ebb..f66fbd07 100644
--- a/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/KeyboardStateBuilder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Linq;
 using Microsoft.Xna.Framework.Input;
@@ -29,7 +27,7 @@ namespace StardewModdingAPI.Framework.Input
             this.State = state;
 
             this.PressedButtons.Clear();
-            foreach (var button in state.GetPressedKeys())
+            foreach (Keys button in state.GetPressedKeys())
                 this.PressedButtons.Add(button);
         }
 
diff --git a/src/SMAPI/Framework/Input/MouseStateBuilder.cs b/src/SMAPI/Framework/Input/MouseStateBuilder.cs
index 85b38d32..c2a0891b 100644
--- a/src/SMAPI/Framework/Input/MouseStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/MouseStateBuilder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Input;
 
diff --git a/src/SMAPI/Framework/ModHelpers/BaseHelper.cs b/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
index 1cd1a6b3..5a3d4bed 100644
--- a/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework.ModHelpers
 {
     /// <summary>The common base class for mod helpers.</summary>
diff --git a/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
index 336214e2..d39abc7d 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
diff --git a/src/SMAPI/Framework/ModHelpers/InputHelper.cs b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
index 29f80d87..88caf4c3 100644
--- a/src/SMAPI/Framework/ModHelpers/InputHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Framework.Input;
 using StardewModdingAPI.Utilities;
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 3cfe52bf..e1529a75 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.IO;
 using StardewModdingAPI.Events;
diff --git a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
index 37345a76..869664fe 100644
--- a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using StardewValley;
 
diff --git a/src/SMAPI/Framework/ModLinked.cs b/src/SMAPI/Framework/ModLinked.cs
index 5a3e38ca..8cfe6f5f 100644
--- a/src/SMAPI/Framework/ModLinked.cs
+++ b/src/SMAPI/Framework/ModLinked.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework
 {
     /// <summary>A generic tuple which links something to a mod.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs
index d2d5d83b..11be19fc 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoadStatus.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework.ModLoading
 {
     /// <summary>Indicates the result of an assembly load.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
index 126504e3..d41732f8 100644
--- a/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/IInstructionHandler.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using Mono.Cecil;
diff --git a/src/SMAPI/Framework/ModLoading/IncompatibleInstructionException.cs b/src/SMAPI/Framework/ModLoading/IncompatibleInstructionException.cs
index 29406f2a..1f9add30 100644
--- a/src/SMAPI/Framework/ModLoading/IncompatibleInstructionException.cs
+++ b/src/SMAPI/Framework/ModLoading/IncompatibleInstructionException.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework.ModLoading
diff --git a/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs b/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
index 0898f095..d4366294 100644
--- a/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
+++ b/src/SMAPI/Framework/ModLoading/PlatformAssemblyMap.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
index 20a30f8f..67569424 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
@@ -20,7 +18,8 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        public SpriteBatchFacade(GraphicsDevice graphicsDevice) : base(graphicsDevice) { }
+        public SpriteBatchFacade(GraphicsDevice graphicsDevice)
+            : base(graphicsDevice) { }
 
 
         /****
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
index 4985d72a..cc830216 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/ArchitectureAssemblyRewriter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
index 55b7e0c8..2171895d 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReader.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.IO;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
index c2ac4cd6..8f7e05d1 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolWriterProvider.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.IO;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
diff --git a/src/SMAPI/Framework/Monitor.cs b/src/SMAPI/Framework/Monitor.cs
index de145d1d..6b53daff 100644
--- a/src/SMAPI/Framework/Monitor.cs
+++ b/src/SMAPI/Framework/Monitor.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI/Framework/Networking/SGalaxyNetClient.cs b/src/SMAPI/Framework/Networking/SGalaxyNetClient.cs
index 8e19b4a7..01095c66 100644
--- a/src/SMAPI/Framework/Networking/SGalaxyNetClient.cs
+++ b/src/SMAPI/Framework/Networking/SGalaxyNetClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Galaxy.Api;
 using StardewValley.Network;
diff --git a/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs b/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
index 07a004a2..71e11576 100644
--- a/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
+++ b/src/SMAPI/Framework/Networking/SGalaxyNetServer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
diff --git a/src/SMAPI/Framework/Networking/SLidgrenClient.cs b/src/SMAPI/Framework/Networking/SLidgrenClient.cs
index ecf18cbd..39876744 100644
--- a/src/SMAPI/Framework/Networking/SLidgrenClient.cs
+++ b/src/SMAPI/Framework/Networking/SLidgrenClient.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewValley.Network;
 
diff --git a/src/SMAPI/Framework/Networking/SLidgrenServer.cs b/src/SMAPI/Framework/Networking/SLidgrenServer.cs
index c0b247c8..ff871e64 100644
--- a/src/SMAPI/Framework/Networking/SLidgrenServer.cs
+++ b/src/SMAPI/Framework/Networking/SLidgrenServer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index 4c49e219..40adde8e 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Reflection;
 using System.Reflection.Emit;
 using Nanoray.Pintail;
diff --git a/src/SMAPI/Framework/SChatBox.cs b/src/SMAPI/Framework/SChatBox.cs
index d6286c12..e000d1cd 100644
--- a/src/SMAPI/Framework/SChatBox.cs
+++ b/src/SMAPI/Framework/SChatBox.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using StardewValley;
 using StardewValley.Menus;
 
diff --git a/src/SMAPI/Framework/SGameRunner.cs b/src/SMAPI/Framework/SGameRunner.cs
index dae314af..213fe561 100644
--- a/src/SMAPI/Framework/SGameRunner.cs
+++ b/src/SMAPI/Framework/SGameRunner.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -150,7 +148,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Update metadata when a split screen is added or removed.</summary>
         private void UpdateForSplitScreenChanges()
         {
-            HashSet<int> oldScreenIds = new HashSet<int>(Context.ActiveScreenIds);
+            HashSet<int> oldScreenIds = new(Context.ActiveScreenIds);
 
             // track active screens
             Context.ActiveScreenIds.Clear();
diff --git a/src/SMAPI/Framework/Singleton.cs b/src/SMAPI/Framework/Singleton.cs
index da16c48e..1bf318c4 100644
--- a/src/SMAPI/Framework/Singleton.cs
+++ b/src/SMAPI/Framework/Singleton.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework
 {
     /// <summary>Provides singleton instances of a given type.</summary>
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/BaseDisposableWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/BaseDisposableWatcher.cs
index 03bf84d9..60006c51 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/BaseDisposableWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/BaseDisposableWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
index 52e1dbad..256370ce 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Linq;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
index 94ce0c8e..84340fbf 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
index e662c433..676c9fb4 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using Netcode;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
index a97e754c..0b4d3030 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using Netcode;
 using StardewModdingAPI.Framework.StateTracking.Comparers;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
index 26641750..48d5d681 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Netcode;
 
 namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
diff --git a/src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs
index 74c9313b..7a7759e3 100644
--- a/src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/ICollectionWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.StateTracking
diff --git a/src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs b/src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs
index 81fb7460..691ed377 100644
--- a/src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/IDictionaryWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI.Framework.StateTracking
diff --git a/src/SMAPI/Framework/StateTracking/IValueWatcher.cs b/src/SMAPI/Framework/StateTracking/IValueWatcher.cs
index 7d46053c..4afca972 100644
--- a/src/SMAPI/Framework/StateTracking/IValueWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/IValueWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework.StateTracking
 {
     /// <summary>A watcher which tracks changes to a value.</summary>
diff --git a/src/SMAPI/Framework/StateTracking/IWatcher.cs b/src/SMAPI/Framework/StateTracking/IWatcher.cs
index 3603b6f8..8c7fa51c 100644
--- a/src/SMAPI/Framework/StateTracking/IWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/IWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework.StateTracking
diff --git a/src/SMAPI/Framework/Utilities/ContextHash.cs b/src/SMAPI/Framework/Utilities/ContextHash.cs
index 46b9099e..6c0fdc90 100644
--- a/src/SMAPI/Framework/Utilities/ContextHash.cs
+++ b/src/SMAPI/Framework/Utilities/ContextHash.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 
diff --git a/src/SMAPI/GamePlatform.cs b/src/SMAPI/GamePlatform.cs
index 8013faa9..cce5ed8d 100644
--- a/src/SMAPI/GamePlatform.cs
+++ b/src/SMAPI/GamePlatform.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IAssetDataForDictionary.cs b/src/SMAPI/IAssetDataForDictionary.cs
index 82ba25cb..1136316f 100644
--- a/src/SMAPI/IAssetDataForDictionary.cs
+++ b/src/SMAPI/IAssetDataForDictionary.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IAssetDataForImage.cs b/src/SMAPI/IAssetDataForImage.cs
index 1416592e..6f8a4719 100644
--- a/src/SMAPI/IAssetDataForImage.cs
+++ b/src/SMAPI/IAssetDataForImage.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
diff --git a/src/SMAPI/IAssetDataForMap.cs b/src/SMAPI/IAssetDataForMap.cs
index 0b637baf..19bdf3b2 100644
--- a/src/SMAPI/IAssetDataForMap.cs
+++ b/src/SMAPI/IAssetDataForMap.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Microsoft.Xna.Framework;
 using xTile;
 
diff --git a/src/SMAPI/IAssetEditor.cs b/src/SMAPI/IAssetEditor.cs
index f3d91bd0..9f22ed83 100644
--- a/src/SMAPI/IAssetEditor.cs
+++ b/src/SMAPI/IAssetEditor.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/IAssetLoader.cs b/src/SMAPI/IAssetLoader.cs
index 0d52a481..96b98793 100644
--- a/src/SMAPI/IAssetLoader.cs
+++ b/src/SMAPI/IAssetLoader.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/ICommandHelper.cs b/src/SMAPI/ICommandHelper.cs
index a0c524d6..9f1c345c 100644
--- a/src/SMAPI/ICommandHelper.cs
+++ b/src/SMAPI/ICommandHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IContentPackHelper.cs b/src/SMAPI/IContentPackHelper.cs
index 5464df22..c48a4f86 100644
--- a/src/SMAPI/IContentPackHelper.cs
+++ b/src/SMAPI/IContentPackHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/ICursorPosition.cs b/src/SMAPI/ICursorPosition.cs
index da6cbb62..99c1b84d 100644
--- a/src/SMAPI/ICursorPosition.cs
+++ b/src/SMAPI/ICursorPosition.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework;
 using StardewValley;
diff --git a/src/SMAPI/IInputHelper.cs b/src/SMAPI/IInputHelper.cs
index b7ed0838..2b907b0d 100644
--- a/src/SMAPI/IInputHelper.cs
+++ b/src/SMAPI/IInputHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using StardewModdingAPI.Utilities;
 
 namespace StardewModdingAPI
diff --git a/src/SMAPI/IModHelper.cs b/src/SMAPI/IModHelper.cs
index 5e4246aa..15e4ed8d 100644
--- a/src/SMAPI/IModHelper.cs
+++ b/src/SMAPI/IModHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
diff --git a/src/SMAPI/IModInfo.cs b/src/SMAPI/IModInfo.cs
index 2788e4fc..3c85d454 100644
--- a/src/SMAPI/IModInfo.cs
+++ b/src/SMAPI/IModInfo.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI
 {
     /// <summary>Metadata for a loaded mod.</summary>
diff --git a/src/SMAPI/IModLinked.cs b/src/SMAPI/IModLinked.cs
index cf08c9c5..172ee30c 100644
--- a/src/SMAPI/IModLinked.cs
+++ b/src/SMAPI/IModLinked.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI
 {
     /// <summary>An instance linked to a mod.</summary>
diff --git a/src/SMAPI/IMonitor.cs b/src/SMAPI/IMonitor.cs
index 535f56e3..c400a211 100644
--- a/src/SMAPI/IMonitor.cs
+++ b/src/SMAPI/IMonitor.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI
 {
     /// <summary>Encapsulates monitoring and logging for a given module.</summary>
diff --git a/src/SMAPI/IMultiplayerPeerMod.cs b/src/SMAPI/IMultiplayerPeerMod.cs
index 81978bef..005408b1 100644
--- a/src/SMAPI/IMultiplayerPeerMod.cs
+++ b/src/SMAPI/IMultiplayerPeerMod.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI
 {
     /// <summary>Metadata about a mod installed by a connected player.</summary>
diff --git a/src/SMAPI/ITranslationHelper.cs b/src/SMAPI/ITranslationHelper.cs
index 3c297731..32199910 100644
--- a/src/SMAPI/ITranslationHelper.cs
+++ b/src/SMAPI/ITranslationHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using StardewValley;
 
@@ -11,7 +9,7 @@ namespace StardewModdingAPI
         /*********
         ** Accessors
         *********/
-        /// <summary>The current locale.</summary>
+        /// <summary>The current locale code like <c>fr-FR</c>, or an empty string for English.</summary>
         string Locale { get; }
 
         /// <summary>The game's current language code.</summary>

From f39da383a17b368e92fd243cf155b27ba42671f3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 20:24:14 -0400
Subject: [PATCH 546/856] enable nullable annotations in SMAPI where no logic
 changes are needed (#837)

---
 src/SMAPI.Tests/Core/AssetNameTests.cs        |  2 +-
 src/SMAPI.Tests/Core/TranslationTests.cs      |  4 +-
 .../Framework/ModData/ModDataRecord.cs        |  2 +-
 src/SMAPI/Constants.cs                        | 26 ++++-----
 src/SMAPI/Events/AssetRequestedEventArgs.cs   | 14 ++---
 src/SMAPI/Events/MenuChangedEventArgs.cs      | 16 +++---
 src/SMAPI/Framework/Command.cs                |  6 +-
 .../Commands/HarmonySummaryCommand.cs         | 20 +++----
 src/SMAPI/Framework/Content/AssetData.cs      |  7 +--
 .../Content/AssetDataForDictionary.cs         |  4 +-
 .../Framework/Content/AssetDataForImage.cs    |  4 +-
 .../Framework/Content/AssetDataForObject.cs   |  4 +-
 .../Framework/Content/AssetEditOperation.cs   |  6 +-
 src/SMAPI/Framework/Content/AssetInfo.cs      | 12 ++--
 .../Content/AssetInterceptorChange.cs         |  7 +--
 .../Framework/Content/AssetLoadOperation.cs   |  6 +-
 src/SMAPI/Framework/ContentCoordinator.cs     | 35 ++++++------
 .../ContentManagers/GameContentManager.cs     | 34 +++++++-----
 .../GameContentManagerForAssetPropagation.cs  |  4 +-
 .../ContentManagers/IContentManager.cs        | 13 +++--
 src/SMAPI/Framework/ContentPack.cs            |  9 ++-
 src/SMAPI/Framework/CursorPosition.cs         |  4 +-
 src/SMAPI/Framework/Events/ManagedEvent.cs    |  8 +--
 .../Framework/Events/ManagedEventHandler.cs   |  4 +-
 .../Exceptions/SContentLoadException.cs       |  4 +-
 src/SMAPI/Framework/GameVersion.cs            | 10 ++--
 src/SMAPI/Framework/IModMetadata.cs           | 26 ++++-----
 src/SMAPI/Framework/Logging/LogFileManager.cs |  4 +-
 .../Framework/ModHelpers/ContentHelper.cs     |  9 +--
 src/SMAPI/Framework/ModHelpers/DataHelper.cs  | 28 ++++++----
 .../Framework/ModHelpers/GameContentHelper.cs |  8 ++-
 .../Framework/ModHelpers/ModContentHelper.cs  |  6 +-
 .../Framework/ModHelpers/ModRegistryHelper.cs | 13 ++---
 .../Framework/ModHelpers/MultiplayerHelper.cs |  8 +--
 .../Framework/ModHelpers/ReflectionHelper.cs  | 26 ++++-----
 .../ModLoading/AssemblyDefinitionResolver.cs  |  8 +--
 .../ModLoading/Finders/EventFinder.cs         |  4 +-
 .../ModLoading/Finders/FieldFinder.cs         |  4 +-
 .../ModLoading/Finders/MethodFinder.cs        |  4 +-
 .../ModLoading/Finders/PropertyFinder.cs      |  4 +-
 ...ferenceToMemberWithUnexpectedTypeFinder.cs | 15 +++--
 .../Finders/ReferenceToMissingMemberFinder.cs | 13 ++---
 .../ModLoading/Finders/TypeAssemblyFinder.cs  |  6 +-
 .../ModLoading/Finders/TypeFinder.cs          |  8 +--
 .../Framework/BaseInstructionHandler.cs       |  4 +-
 .../ModLoading/Framework/RecursiveRewriter.cs | 25 +++++----
 .../ModLoading/Framework/RewriteHelper.cs     | 10 ++--
 .../ModLoading/InvalidModStateException.cs    |  4 +-
 src/SMAPI/Framework/ModLoading/ModMetadata.cs | 38 +++++++------
 .../RewriteFacades/AccessToolsFacade.cs       |  6 +-
 .../RewriteFacades/HarmonyInstanceFacade.cs   |  9 ++-
 .../RewriteFacades/HarmonyMethodFacade.cs     |  6 +-
 .../ModLoading/Rewriters/HarmonyRewriter.cs   | 16 +++---
 .../Rewriters/HeuristicFieldRewriter.cs       | 19 +++----
 .../Rewriters/HeuristicMethodRewriter.cs      | 15 +++--
 .../Rewriters/MethodParentRewriter.cs         | 13 ++---
 .../Rewriters/TypeReferenceRewriter.cs        |  6 +-
 .../Symbols/SymbolReaderProvider.cs           |  6 +-
 .../ModLoading/TypeReferenceComparer.cs       | 14 ++---
 src/SMAPI/Framework/ModRegistry.cs            | 16 +++---
 .../Framework/Reflection/ReflectedField.cs    | 16 +++---
 .../Framework/Reflection/ReflectedMethod.cs   | 18 +++---
 .../Framework/Reflection/ReflectedProperty.cs | 18 +++---
 .../Framework/Rendering/SDisplayDevice.cs     |  8 +--
 .../Framework/Rendering/SXnaDisplayDevice.cs  |  4 +-
 src/SMAPI/Framework/SGame.cs                  | 27 +++++----
 src/SMAPI/Framework/SModHooks.cs              |  4 +-
 src/SMAPI/Framework/SnapshotDiff.cs           |  6 +-
 src/SMAPI/Framework/SnapshotItemListDiff.cs   |  5 +-
 src/SMAPI/Framework/SnapshotListDiff.cs       |  4 +-
 .../Framework/StateTracking/ChestTracker.cs   |  5 +-
 .../Comparers/EquatableComparer.cs            |  4 +-
 .../Comparers/GenericEqualsComparer.cs        |  4 +-
 .../Comparers/ObjectReferenceComparer.cs      |  4 +-
 .../FieldWatchers/NetDictionaryWatcher.cs     |  3 +-
 .../ObservableCollectionWatcher.cs            |  8 +--
 .../FieldWatchers/WatcherFactory.cs           | 15 +++--
 .../StateTracking/LocationTracker.cs          | 14 ++---
 .../Snapshots/LocationSnapshot.cs             |  4 +-
 .../Snapshots/WatcherSnapshot.cs              |  6 +-
 .../Snapshots/WorldLocationsSnapshot.cs       |  4 +-
 .../StateTracking/WorldLocationsTracker.cs    | 23 ++++----
 src/SMAPI/Framework/Translator.cs             | 20 +++----
 .../Utilities/TickCacheDictionary.cs          |  5 +-
 src/SMAPI/Framework/WatcherCore.cs            |  4 +-
 src/SMAPI/IAssetData.cs                       |  3 +-
 src/SMAPI/IAssetInfo.cs                       |  4 +-
 src/SMAPI/IAssetName.cs                       | 12 ++--
 src/SMAPI/IContentHelper.cs                   | 14 +++--
 src/SMAPI/IContentPack.cs                     | 11 ++--
 src/SMAPI/IDataHelper.cs                      | 20 ++++---
 src/SMAPI/IGameContentHelper.cs               | 14 +++--
 src/SMAPI/IMod.cs                             |  4 +-
 src/SMAPI/IModContentHelper.cs                |  8 +--
 src/SMAPI/IModRegistry.cs                     |  9 ++-
 src/SMAPI/IMultiplayerHelper.cs               |  6 +-
 src/SMAPI/IMultiplayerPeer.cs                 | 10 ++--
 src/SMAPI/IReflectedField.cs                  |  6 +-
 src/SMAPI/IReflectedMethod.cs                 |  6 +-
 src/SMAPI/IReflectedProperty.cs               |  6 +-
 src/SMAPI/IReflectionHelper.cs                | 30 ++++++----
 src/SMAPI/Metadata/InstructionMetadata.cs     | 24 ++++----
 src/SMAPI/Mod.cs                              | 12 ++--
 src/SMAPI/Patches/Game1Patcher.cs             |  6 +-
 src/SMAPI/Patches/TitleMenuPatcher.cs         |  4 +-
 src/SMAPI/Program.cs                          | 22 ++++----
 src/SMAPI/Translation.cs                      | 30 +++++-----
 .../Utilities/CaseInsensitivePathCache.cs     |  4 +-
 src/SMAPI/Utilities/Keybind.cs                |  5 +-
 src/SMAPI/Utilities/KeybindList.cs            | 11 ++--
 src/SMAPI/Utilities/SDate.cs                  | 55 ++++++++-----------
 111 files changed, 558 insertions(+), 677 deletions(-)

diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index 8018442c..a1712726 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -56,7 +56,7 @@ namespace SMAPI.Tests.Core
         public void Constructor_NullOrWhitespace(string? name)
         {
             // act
-            ArgumentException exception = Assert.Throws<ArgumentException>(() => _ = AssetName.Parse(name!, null))!;
+            ArgumentException exception = Assert.Throws<ArgumentException>(() => _ = AssetName.Parse(name!, _ => null))!;
 
             // assert
             exception.ParamName.Should().Be("rawName");
diff --git a/src/SMAPI.Tests/Core/TranslationTests.cs b/src/SMAPI.Tests/Core/TranslationTests.cs
index a65bf772..ced1525a 100644
--- a/src/SMAPI.Tests/Core/TranslationTests.cs
+++ b/src/SMAPI.Tests/Core/TranslationTests.cs
@@ -134,9 +134,9 @@ namespace SMAPI.Tests.Core
 
             // assert
             if (translation.HasValue())
-                Assert.AreEqual(text, (string)translation, "The translation returned an unexpected value given a valid input.");
+                Assert.AreEqual(text, (string?)translation, "The translation returned an unexpected value given a valid input.");
             else
-                Assert.AreEqual(this.GetPlaceholderText("key"), (string)translation, "The translation returned an unexpected value given a null or empty input.");
+                Assert.AreEqual(this.GetPlaceholderText("key"), (string?)translation, "The translation returned an unexpected value given a null or empty input.");
         }
 
         [Test(Description = "Assert that the translation returns the expected text given a use-placeholder setting.")]
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
index e9ece387..ab0e4377 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModDataRecord.cs
@@ -80,7 +80,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
 
         /// <summary>Get a parsed representation of the <see cref="ModDataRecord.Fields"/> which match a given manifest.</summary>
         /// <param name="manifest">The manifest to match.</param>
-        public ModDataRecordVersionedFields GetVersionedFields(IManifest manifest)
+        public ModDataRecordVersionedFields GetVersionedFields(IManifest? manifest)
         {
             ModDataRecordVersionedFields parsed = new(this);
             foreach (ModDataField field in this.Fields.Where(field => field.IsMatch(manifest)))
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 2d9ab666..fd2b813a 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -33,7 +31,7 @@ namespace StardewModdingAPI
         ** Accessors
         *********/
         /// <summary>The path to the game folder.</summary>
-        public static string GamePath { get; } = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
+        public static string GamePath { get; } = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location)!;
 
         /// <summary>The absolute path to the folder containing SMAPI's internal files.</summary>
         public static readonly string InternalFilesPath = Path.Combine(EarlyConstants.GamePath, "smapi-internal");
@@ -69,8 +67,8 @@ namespace StardewModdingAPI
         /// <summary>The minimum supported version of Stardew Valley.</summary>
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.6");
 
-        /// <summary>The maximum supported version of Stardew Valley.</summary>
-        public static ISemanticVersion MaximumGameVersion { get; } = null;
+        /// <summary>The maximum supported version of Stardew Valley, if any.</summary>
+        public static ISemanticVersion? MaximumGameVersion { get; } = null;
 
         /// <summary>The target game platform.</summary>
         public static GamePlatform TargetPlatform { get; } = EarlyConstants.Platform;
@@ -111,10 +109,10 @@ namespace StardewModdingAPI
         public static string SavesPath { get; } = Path.Combine(Constants.DataPath, "Saves");
 
         /// <summary>The name of the current save folder (if save info is available, regardless of whether the save file exists yet).</summary>
-        public static string SaveFolderName => Constants.GetSaveFolderName();
+        public static string? SaveFolderName => Constants.GetSaveFolderName();
 
         /// <summary>The absolute path to the current save folder (if save info is available and the save file exists).</summary>
-        public static string CurrentSavePath => Constants.GetSaveFolderPathIfExists();
+        public static string? CurrentSavePath => Constants.GetSaveFolderPathIfExists();
 
         /****
         ** Internal
@@ -164,7 +162,7 @@ namespace StardewModdingAPI
         internal static string DefaultModsPath { get; } = Path.Combine(Constants.GamePath, "Mods");
 
         /// <summary>The actual full path to search for mods.</summary>
-        internal static string ModsPath { get; set; }
+        internal static string ModsPath { get; set; } = null!; // initialized early during SMAPI startup
 
         /// <summary>The game's current semantic version.</summary>
         internal static ISemanticVersion GameVersion { get; } = new GameVersion(Game1.version);
@@ -179,7 +177,7 @@ namespace StardewModdingAPI
         /// <summary>Get the SMAPI version to recommend for an older game version, if any.</summary>
         /// <param name="version">The game version to search.</param>
         /// <returns>Returns the compatible SMAPI version, or <c>null</c> if none was found.</returns>
-        internal static ISemanticVersion GetCompatibleApiVersion(ISemanticVersion version)
+        internal static ISemanticVersion? GetCompatibleApiVersion(ISemanticVersion version)
         {
             // This covers all officially supported public game updates. It might seem like version
             // ranges would be better, but the given SMAPI versions may not be compatible with
@@ -337,22 +335,22 @@ namespace StardewModdingAPI
         }
 
         /// <summary>Get the name of the save folder, if any.</summary>
-        private static string GetSaveFolderName()
+        private static string? GetSaveFolderName()
         {
             return Constants.GetSaveFolder()?.Name;
         }
 
         /// <summary>Get the absolute path to the current save folder, if any.</summary>
-        private static string GetSaveFolderPathIfExists()
+        private static string? GetSaveFolderPathIfExists()
         {
-            DirectoryInfo saveFolder = Constants.GetSaveFolder();
+            DirectoryInfo? saveFolder = Constants.GetSaveFolder();
             return saveFolder?.Exists == true
                 ? saveFolder.FullName
                 : null;
         }
 
         /// <summary>Get the current save folder, if any.</summary>
-        private static DirectoryInfo GetSaveFolder()
+        private static DirectoryInfo? GetSaveFolder()
         {
             // save not available
             if (Context.LoadStage == LoadStage.None)
@@ -365,7 +363,7 @@ namespace StardewModdingAPI
                 : Game1.uniqueIDForThisGame;
 
             // get best match (accounting for rare case where folder name isn't sanitized)
-            DirectoryInfo folder = null;
+            DirectoryInfo? folder = null;
             foreach (string saveName in new[] { rawSaveName, new string(rawSaveName.Where(char.IsLetterOrDigit).ToArray()) })
             {
                 try
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index 3c51c95d..3bcf83b9 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
@@ -19,7 +17,7 @@ namespace StardewModdingAPI.Events
         private readonly IModMetadata Mod;
 
         /// <summary>Get the mod metadata for a content pack, if it's a valid content pack for the mod.</summary>
-        private readonly Func<IModMetadata, string, string, IModMetadata> GetOnBehalfOf;
+        private readonly Func<IModMetadata, string?, string, IModMetadata?> GetOnBehalfOf;
 
 
         /*********
@@ -51,7 +49,7 @@ namespace StardewModdingAPI.Events
         /// <param name="dataType">The requested data type.</param>
         /// <param name="nameWithoutLocale">The <paramref name="name"/> with any locale codes stripped.</param>
         /// <param name="getOnBehalfOf">Get the mod metadata for a content pack, if it's a valid content pack for the mod.</param>
-        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name, IAssetName nameWithoutLocale, Type dataType, Func<IModMetadata, string, string, IModMetadata> getOnBehalfOf)
+        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name, IAssetName nameWithoutLocale, Type dataType, Func<IModMetadata, string?, string, IModMetadata?> getOnBehalfOf)
         {
             this.Mod = mod;
             this.Name = name;
@@ -71,7 +69,7 @@ namespace StardewModdingAPI.Events
         ///   <item>Each asset can logically only have one initial instance. If multiple loads apply at the same time, SMAPI will use the <paramref name="priority"/> parameter to decide what happens. If you're making changes to the existing asset instead of replacing it, you should use <see cref="Edit"/> instead to avoid those limitations and improve mod compatibility.</item>
         /// </list>
         /// </remarks>
-        public void LoadFrom(Func<object> load, AssetLoadPriority priority, string onBehalfOf = null)
+        public void LoadFrom(Func<object> load, AssetLoadPriority priority, string? onBehalfOf = null)
         {
             this.LoadOperations.Add(
                 new AssetLoadOperation(
@@ -95,13 +93,15 @@ namespace StardewModdingAPI.Events
         /// </list>
         /// </remarks>
         public void LoadFromModFile<TAsset>(string relativePath, AssetLoadPriority priority)
+            where TAsset : notnull
         {
             this.LoadOperations.Add(
                 new AssetLoadOperation(
                     mod: this.Mod,
                     priority: priority,
                     onBehalfOf: null,
-                    _ => this.Mod.Mod.Helper.ModContent.Load<TAsset>(relativePath))
+                    _ => this.Mod.Mod!.Helper.ModContent.Load<TAsset>(relativePath)
+                )
             );
         }
 
@@ -116,7 +116,7 @@ namespace StardewModdingAPI.Events
         ///   <item>You can apply any number of edits to the asset. Each edit will be applied on top of the previous one (i.e. it'll see the merged asset from all previous edits as its input).</item>
         /// </list>
         /// </remarks>
-        public void Edit(Action<IAssetData> apply, AssetEditPriority priority = AssetEditPriority.Default, string onBehalfOf = null)
+        public void Edit(Action<IAssetData> apply, AssetEditPriority priority = AssetEditPriority.Default, string? onBehalfOf = null)
         {
             this.EditOperations.Add(
                 new AssetEditOperation(
diff --git a/src/SMAPI/Events/MenuChangedEventArgs.cs b/src/SMAPI/Events/MenuChangedEventArgs.cs
index 362accec..c37fd216 100644
--- a/src/SMAPI/Events/MenuChangedEventArgs.cs
+++ b/src/SMAPI/Events/MenuChangedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewValley.Menus;
 
@@ -11,20 +9,20 @@ namespace StardewModdingAPI.Events
         /*********
         ** Accessors
         *********/
-        /// <summary>The previous menu.</summary>
-        public IClickableMenu OldMenu { get; }
+        /// <summary>The previous menu, if any.</summary>
+        public IClickableMenu? OldMenu { get; }
 
-        /// <summary>The current menu.</summary>
-        public IClickableMenu NewMenu { get; }
+        /// <summary>The current menu, if any.</summary>
+        public IClickableMenu? NewMenu { get; }
 
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="oldMenu">The previous menu.</param>
-        /// <param name="newMenu">The current menu.</param>
-        internal MenuChangedEventArgs(IClickableMenu oldMenu, IClickableMenu newMenu)
+        /// <param name="oldMenu">The previous menu, if any.</param>
+        /// <param name="newMenu">The current menu, if any.</param>
+        internal MenuChangedEventArgs(IClickableMenu? oldMenu, IClickableMenu? newMenu)
         {
             this.OldMenu = oldMenu;
             this.NewMenu = newMenu;
diff --git a/src/SMAPI/Framework/Command.cs b/src/SMAPI/Framework/Command.cs
index 776ba238..dca1dd09 100644
--- a/src/SMAPI/Framework/Command.cs
+++ b/src/SMAPI/Framework/Command.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework
@@ -11,7 +9,7 @@ namespace StardewModdingAPI.Framework
         ** Accessor
         *********/
         /// <summary>The mod that registered the command (or <c>null</c> if registered by SMAPI).</summary>
-        public IModMetadata Mod { get; }
+        public IModMetadata? Mod { get; }
 
         /// <summary>The command name, which the user must type to trigger it.</summary>
         public string Name { get; }
@@ -31,7 +29,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="name">The command name, which the user must type to trigger it.</param>
         /// <param name="documentation">The human-readable documentation shown when the player runs the built-in 'help' command.</param>
         /// <param name="callback">The method to invoke when the command is triggered. This method is passed the command name and arguments submitted by the user.</param>
-        public Command(IModMetadata mod, string name, string documentation, Action<string, string[]> callback)
+        public Command(IModMetadata? mod, string name, string documentation, Action<string, string[]> callback)
         {
             this.Mod = mod;
             this.Name = name;
diff --git a/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs b/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
index fcfa928e..6dc6f131 100644
--- a/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
+++ b/src/SMAPI/Framework/Commands/HarmonySummaryCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -73,9 +71,9 @@ namespace StardewModdingAPI.Framework.Commands
         private IEnumerable<SearchResult> FilterPatches(string[] searchTerms)
         {
             bool hasSearch = searchTerms.Any();
-            bool IsMatch(string target) => !hasSearch || searchTerms.Any(search => target != null && target.IndexOf(search, StringComparison.OrdinalIgnoreCase) > -1);
+            bool IsMatch(string? target) => !hasSearch || searchTerms.Any(search => target != null && target.IndexOf(search, StringComparison.OrdinalIgnoreCase) > -1);
 
-            foreach (var patch in this.GetAllPatches())
+            foreach (SearchResult patch in this.GetAllPatches())
             {
                 // matches entire patch
                 if (IsMatch(patch.MethodDescription))
@@ -85,10 +83,10 @@ namespace StardewModdingAPI.Framework.Commands
                 }
 
                 // matches individual patchers
-                foreach (var pair in patch.PatchTypesByOwner.ToArray())
+                foreach ((string patcherId, ISet<PatchType> patchTypes) in patch.PatchTypesByOwner.ToArray())
                 {
-                    if (!IsMatch(pair.Key) && !pair.Value.Any(type => IsMatch(type.ToString())))
-                        patch.PatchTypesByOwner.Remove(pair.Key);
+                    if (!IsMatch(patcherId) && !patchTypes.Any(type => IsMatch(type.ToString())))
+                        patch.PatchTypesByOwner.Remove(patcherId);
                 }
 
                 if (patch.PatchTypesByOwner.Any())
@@ -114,13 +112,13 @@ namespace StardewModdingAPI.Framework.Commands
 
                 // get patch types by owner
                 var typesByOwner = new Dictionary<string, ISet<PatchType>>();
-                foreach (var group in patchGroups)
+                foreach ((PatchType type, IReadOnlyCollection<Patch> patches) in patchGroups)
                 {
-                    foreach (var patch in group.Value)
+                    foreach (Patch patch in patches)
                     {
-                        if (!typesByOwner.TryGetValue(patch.owner, out ISet<PatchType> patchTypes))
+                        if (!typesByOwner.TryGetValue(patch.owner, out ISet<PatchType>? patchTypes))
                             typesByOwner[patch.owner] = patchTypes = new HashSet<PatchType>();
-                        patchTypes.Add(group.Key);
+                        patchTypes.Add(type);
                     }
                 }
 
diff --git a/src/SMAPI/Framework/Content/AssetData.cs b/src/SMAPI/Framework/Content/AssetData.cs
index be4a7ce6..0367e999 100644
--- a/src/SMAPI/Framework/Content/AssetData.cs
+++ b/src/SMAPI/Framework/Content/AssetData.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework.Content
@@ -7,12 +5,13 @@ namespace StardewModdingAPI.Framework.Content
     /// <summary>Base implementation for a content helper which encapsulates access and changes to content being read from a data file.</summary>
     /// <typeparam name="TValue">The interface value type.</typeparam>
     internal class AssetData<TValue> : AssetInfo, IAssetData<TValue>
+        where TValue : notnull
     {
         /*********
         ** Fields
         *********/
         /// <summary>A callback to invoke when the data is replaced (if any).</summary>
-        private readonly Action<TValue> OnDataReplaced;
+        private readonly Action<TValue>? OnDataReplaced;
 
 
         /*********
@@ -31,7 +30,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
-        public AssetData(string locale, IAssetName assetName, TValue data, Func<string, string> getNormalizedPath, Action<TValue> onDataReplaced)
+        public AssetData(string? locale, IAssetName assetName, TValue data, Func<string, string> getNormalizedPath, Action<TValue>? onDataReplaced)
             : base(locale, assetName, data.GetType(), getNormalizedPath)
         {
             this.Data = data;
diff --git a/src/SMAPI/Framework/Content/AssetDataForDictionary.cs b/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
index 06dbe259..d9bfa7bf 100644
--- a/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForDictionary.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 
@@ -17,7 +15,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
-        public AssetDataForDictionary(string locale, IAssetName assetName, IDictionary<TKey, TValue> data, Func<string, string> getNormalizedPath, Action<IDictionary<TKey, TValue>> onDataReplaced)
+        public AssetDataForDictionary(string? locale, IAssetName assetName, IDictionary<TKey, TValue> data, Func<string, string> getNormalizedPath, Action<IDictionary<TKey, TValue>> onDataReplaced)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced) { }
     }
 }
diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 8e59cd27..97729c95 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
@@ -27,7 +25,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
-        public AssetDataForImage(string locale, IAssetName assetName, Texture2D data, Func<string, string> getNormalizedPath, Action<Texture2D> onDataReplaced)
+        public AssetDataForImage(string? locale, IAssetName assetName, Texture2D data, Func<string, string> getNormalizedPath, Action<Texture2D> onDataReplaced)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced) { }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/Content/AssetDataForObject.cs b/src/SMAPI/Framework/Content/AssetDataForObject.cs
index bb3966b9..e508ca30 100644
--- a/src/SMAPI/Framework/Content/AssetDataForObject.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForObject.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
@@ -27,7 +25,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public AssetDataForObject(string locale, IAssetName assetName, object data, Func<string, string> getNormalizedPath, Reflector reflection)
+        public AssetDataForObject(string? locale, IAssetName assetName, object data, Func<string, string> getNormalizedPath, Reflector reflection)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced: null)
         {
             this.Reflection = reflection;
diff --git a/src/SMAPI/Framework/Content/AssetEditOperation.cs b/src/SMAPI/Framework/Content/AssetEditOperation.cs
index 1b7d0c93..464948b0 100644
--- a/src/SMAPI/Framework/Content/AssetEditOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetEditOperation.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
@@ -18,7 +16,7 @@ namespace StardewModdingAPI.Framework.Content
         public AssetEditPriority Priority { get; }
 
         /// <summary>The content pack on whose behalf the edit is being applied, if any.</summary>
-        public IModMetadata OnBehalfOf { get; }
+        public IModMetadata? OnBehalfOf { get; }
 
         /// <summary>Apply the edit to an asset.</summary>
         public Action<IAssetData> ApplyEdit { get; }
@@ -32,7 +30,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="priority">If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</param>
         /// <param name="onBehalfOf">The content pack on whose behalf the edit is being applied, if any.</param>
         /// <param name="applyEdit">Apply the edit to an asset.</param>
-        public AssetEditOperation(IModMetadata mod, AssetEditPriority priority, IModMetadata onBehalfOf, Action<IAssetData> applyEdit)
+        public AssetEditOperation(IModMetadata mod, AssetEditPriority priority, IModMetadata? onBehalfOf, Action<IAssetData> applyEdit)
         {
             this.Mod = mod;
             this.Priority = priority;
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 51dcc61f..0f0e9bf3 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
@@ -19,7 +17,7 @@ namespace StardewModdingAPI.Framework.Content
         ** Accessors
         *********/
         /// <inheritdoc />
-        public string Locale { get; }
+        public string? Locale { get; }
 
         /// <inheritdoc />
         public IAssetName Name { get; }
@@ -28,7 +26,7 @@ namespace StardewModdingAPI.Framework.Content
         public IAssetName NameWithoutLocale { get; }
 
         /// <inheritdoc />
-        [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead. This property will be removed in SMAPI 4.0.0.")]
+        [Obsolete($"Use {nameof(AssetInfo.Name)} or {nameof(AssetInfo.NameWithoutLocale)} instead. This property will be removed in SMAPI 4.0.0.")]
         public string AssetName
         {
             get
@@ -56,7 +54,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="assetName">The asset name being read.</param>
         /// <param name="type">The content type being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
-        public AssetInfo(string locale, IAssetName assetName, Type type, Func<string, string> getNormalizedPath)
+        public AssetInfo(string? locale, IAssetName assetName, Type type, Func<string, string> getNormalizedPath)
         {
             this.Locale = locale;
             this.Name = assetName;
@@ -66,7 +64,7 @@ namespace StardewModdingAPI.Framework.Content
         }
 
         /// <inheritdoc />
-        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead. This method will be removed in SMAPI 4.0.0.")]
+        [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(AssetInfo.NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead. This method will be removed in SMAPI 4.0.0.")]
         public bool AssetNameEquals(string path)
         {
             SCore.DeprecationManager.Warn(
@@ -106,7 +104,7 @@ namespace StardewModdingAPI.Framework.Content
                 return "string";
 
             // default
-            return type.FullName;
+            return type.FullName!;
         }
     }
 }
diff --git a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
index 7f53db9b..fc8199e8 100644
--- a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
+++ b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
@@ -1,9 +1,8 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 using StardewModdingAPI.Internal;
 
+#pragma warning disable CS0618 // obsolete asset interceptors deliberately supported here
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>A wrapper for <see cref="IAssetEditor"/> and <see cref="IAssetLoader"/> for internal cache invalidation.</summary>
@@ -46,11 +45,11 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="asset">Basic metadata about the asset being loaded.</param>
         public bool CanIntercept(IAssetInfo asset)
         {
-            MethodInfo canIntercept = this.GetType().GetMethod(nameof(this.CanInterceptImpl), BindingFlags.Instance | BindingFlags.NonPublic);
+            MethodInfo? canIntercept = this.GetType().GetMethod(nameof(this.CanInterceptImpl), BindingFlags.Instance | BindingFlags.NonPublic);
             if (canIntercept == null)
                 throw new InvalidOperationException($"SMAPI couldn't access the {nameof(AssetInterceptorChange)}.{nameof(this.CanInterceptImpl)} implementation.");
 
-            return (bool)canIntercept.MakeGenericMethod(asset.DataType).Invoke(this, new object[] { asset });
+            return (bool)canIntercept.MakeGenericMethod(asset.DataType).Invoke(this, new object[] { asset })!;
         }
 
 
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
index 73e60e24..b6cdec27 100644
--- a/src/SMAPI/Framework/Content/AssetLoadOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
@@ -15,7 +13,7 @@ namespace StardewModdingAPI.Framework.Content
         public IModMetadata Mod { get; }
 
         /// <summary>The content pack on whose behalf the asset is being loaded, if any.</summary>
-        public IModMetadata OnBehalfOf { get; }
+        public IModMetadata? OnBehalfOf { get; }
 
         /// <summary>If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</summary>
         public AssetLoadPriority Priority { get; }
@@ -32,7 +30,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
         /// <param name="onBehalfOf">The content pack on whose behalf the asset is being loaded, if any.</param>
         /// <param name="getData">Load the initial value for an asset.</param>
-        public AssetLoadOperation(IModMetadata mod, AssetLoadPriority priority, IModMetadata onBehalfOf, Func<IAssetInfo, object> getData)
+        public AssetLoadOperation(IModMetadata mod, AssetLoadPriority priority, IModMetadata? onBehalfOf, Func<IAssetInfo, object> getData)
         {
             this.Mod = mod;
             this.Priority = priority;
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 4e48b08c..92452224 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -71,7 +69,7 @@ namespace StardewModdingAPI.Framework
         private readonly ReaderWriterLockSlim ContentManagerLock = new();
 
         /// <summary>A cache of ordered tilesheet IDs used by vanilla maps.</summary>
-        private readonly Dictionary<string, TilesheetReference[]> VanillaTilesheets = new(StringComparer.OrdinalIgnoreCase);
+        private readonly Dictionary<string, TilesheetReference[]?> VanillaTilesheets = new(StringComparer.OrdinalIgnoreCase);
 
         /// <summary>An unmodified content manager which doesn't intercept assets, used to compare asset data.</summary>
         private readonly LocalizedContentManager VanillaContentManager;
@@ -230,7 +228,7 @@ namespace StardewModdingAPI.Framework
         public void OnAdditionalLanguagesInitialized()
         {
             // update locale cache for custom languages, and load it now (since languages added later won't work)
-            var customLanguages = this.MainContentManager.Load<List<ModLanguage>>("Data/AdditionalLanguages");
+            var customLanguages = this.MainContentManager.Load<List<ModLanguage?>>("Data/AdditionalLanguages");
             this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(customLanguages));
             _ = this.LocaleCodes.Value;
         }
@@ -303,7 +301,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="contentManagerID">The unique name for the content manager which should load this asset.</param>
         /// <param name="relativePath">The asset name within the mod folder.</param>
         /// <returns>Returns whether the asset was parsed successfully.</returns>
-        public bool TryParseManagedAssetKey(string key, out string contentManagerID, out IAssetName relativePath)
+        public bool TryParseManagedAssetKey(string key, [NotNullWhen(true)] out string? contentManagerID, [NotNullWhen(true)] out IAssetName? relativePath)
         {
             contentManagerID = null;
             relativePath = null;
@@ -333,9 +331,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="contentManagerID">The unique name for the content manager which should load this asset.</param>
         /// <param name="assetName">The asset name within the mod folder.</param>
         public bool DoesManagedAssetExist<T>(string contentManagerID, IAssetName assetName)
+            where T : notnull
         {
             // get content manager
-            IContentManager contentManager = this.ContentManagerLock.InReadLock(() =>
+            IContentManager? contentManager = this.ContentManagerLock.InReadLock(() =>
                 this.ContentManagers.FirstOrDefault(p => p.IsNamespaced && p.Name == contentManagerID)
             );
             if (contentManager == null)
@@ -350,9 +349,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="contentManagerID">The unique name for the content manager which should load this asset.</param>
         /// <param name="relativePath">The asset name within the mod folder.</param>
         public T LoadManagedAsset<T>(string contentManagerID, IAssetName relativePath)
+            where T : notnull
         {
             // get content manager
-            IContentManager contentManager = this.ContentManagerLock.InReadLock(() =>
+            IContentManager? contentManager = this.ContentManagerLock.InReadLock(() =>
                 this.ContentManagers.FirstOrDefault(p => p.IsNamespaced && p.Name == contentManagerID)
             );
             if (contentManager == null)
@@ -461,6 +461,7 @@ namespace StardewModdingAPI.Framework
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The asset info to load or edit.</param>
         public IEnumerable<AssetOperationGroup> GetAssetOperations<T>(IAssetInfo info)
+            where T : notnull
         {
             return this.AssetOperationsByKey.GetOrSet(
                 info.Name,
@@ -491,7 +492,7 @@ namespace StardewModdingAPI.Framework
         {
             rootPath = PathUtilities.NormalizePath(rootPath);
 
-            if (!this.CaseInsensitivePathCaches.TryGetValue(rootPath, out CaseInsensitivePathCache cache))
+            if (!this.CaseInsensitivePathCaches.TryGetValue(rootPath, out CaseInsensitivePathCache? cache))
                 this.CaseInsensitivePathCaches[rootPath] = cache = new CaseInsensitivePathCache(rootPath);
 
             return cache;
@@ -501,9 +502,9 @@ namespace StardewModdingAPI.Framework
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
         public TilesheetReference[] GetVanillaTilesheetIds(string assetName)
         {
-            if (!this.VanillaTilesheets.TryGetValue(assetName, out TilesheetReference[] tilesheets))
+            if (!this.VanillaTilesheets.TryGetValue(assetName, out TilesheetReference[]? tilesheets))
             {
-                tilesheets = this.TryLoadVanillaAsset(assetName, out Map map)
+                tilesheets = this.TryLoadVanillaAsset(assetName, out Map? map)
                     ? map.TileSheets.Select((sheet, index) => new TilesheetReference(index, sheet.Id, sheet.ImageSource, sheet.SheetSize, sheet.TileSize)).ToArray()
                     : null;
 
@@ -516,7 +517,7 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Get the locale code which corresponds to a language enum (e.g. <c>fr-FR</c> given <see cref="LocalizedContentManager.LanguageCode.fr"/>).</summary>
         /// <param name="language">The language enum to search.</param>
-        public string GetLocaleCode(LocalizedContentManager.LanguageCode language)
+        public string? GetLocaleCode(LocalizedContentManager.LanguageCode language)
         {
             if (language == LocalizedContentManager.LanguageCode.mod && LocalizedContentManager.CurrentModLanguage == null)
                 return null;
@@ -535,7 +536,7 @@ namespace StardewModdingAPI.Framework
             foreach (IContentManager contentManager in this.ContentManagers)
                 contentManager.Dispose();
             this.ContentManagers.Clear();
-            this.MainContentManager = null;
+            this.MainContentManager = null!; // instance no longer usable
 
             this.ContentManagerLock.Dispose();
         }
@@ -560,7 +561,8 @@ namespace StardewModdingAPI.Framework
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
         /// <param name="asset">The loaded asset data.</param>
-        private bool TryLoadVanillaAsset<T>(string assetName, out T asset)
+        private bool TryLoadVanillaAsset<T>(string assetName, [NotNullWhen(true)] out T? asset)
+            where T : notnull
         {
             try
             {
@@ -576,12 +578,12 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Get the language enums (like <see cref="LocalizedContentManager.LanguageCode.ja"/>) indexed by locale code (like <c>ja-JP</c>).</summary>
         /// <param name="customLanguages">The custom languages to add to the lookup.</param>
-        private Dictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes(IEnumerable<ModLanguage> customLanguages)
+        private Dictionary<string, LocalizedContentManager.LanguageCode> GetLocaleCodes(IEnumerable<ModLanguage?> customLanguages)
         {
             var map = new Dictionary<string, LocalizedContentManager.LanguageCode>(StringComparer.OrdinalIgnoreCase);
 
             // custom languages
-            foreach (ModLanguage language in customLanguages)
+            foreach (ModLanguage? language in customLanguages)
             {
                 if (!string.IsNullOrWhiteSpace(language?.LanguageCode))
                     map[language.LanguageCode] = LocalizedContentManager.LanguageCode.mod;
@@ -590,7 +592,7 @@ namespace StardewModdingAPI.Framework
             // vanilla languages (override custom language if they conflict)
             foreach (LocalizedContentManager.LanguageCode code in Enum.GetValues(typeof(LocalizedContentManager.LanguageCode)))
             {
-                string locale = this.GetLocaleCode(code);
+                string? locale = this.GetLocaleCode(code);
                 if (locale != null)
                     map[locale] = code;
             }
@@ -602,6 +604,7 @@ namespace StardewModdingAPI.Framework
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The asset info to load or edit.</param>
         private IEnumerable<AssetOperationGroup> GetAssetOperationsWithoutCache<T>(IAssetInfo info)
+            where T : notnull
         {
             IAssetInfo legacyInfo = this.GetLegacyAssetInfo(info);
 
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index e494559d..6469fea4 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
 using System.IO;
 using System.Linq;
@@ -70,7 +69,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return true;
 
             // managed asset
-            if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
+            if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string? contentManagerID, out IAssetName? relativePath))
                 return this.Coordinator.DoesManagedAssetExist<T>(contentManagerID, relativePath);
 
             // custom asset from a loader
@@ -78,7 +77,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             IAssetInfo info = new AssetInfo(locale, assetName, typeof(T), this.AssertAndNormalizeAssetName);
             AssetLoadOperation[] loaders = this.GetLoaders<object>(info).ToArray();
 
-            if (!this.AssertMaxOneRequiredLoader(info, loaders, out string error))
+            if (!this.AssertMaxOneRequiredLoader(info, loaders, out string? error))
             {
                 this.Monitor.Log(error, LogLevel.Warn);
                 return false;
@@ -102,7 +101,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return this.RawLoad<T>(assetName, useCache: true);
 
             // get managed asset
-            if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
+            if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string? contentManagerID, out IAssetName? relativePath))
             {
                 T managedAsset = this.Coordinator.LoadManagedAsset<T>(contentManagerID, relativePath);
                 this.TrackAsset(assetName, managedAsset, useCache);
@@ -151,14 +150,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Load the initial asset from the registered loaders.</summary>
         /// <param name="info">The basic asset metadata.</param>
         /// <returns>Returns the loaded asset metadata, or <c>null</c> if no loader matched.</returns>
-        private IAssetData ApplyLoader<T>(IAssetInfo info)
+        private IAssetData? ApplyLoader<T>(IAssetInfo info)
+            where T : notnull
         {
             // find matching loader
-            AssetLoadOperation loader;
+            AssetLoadOperation? loader;
             {
                 AssetLoadOperation[] loaders = this.GetLoaders<T>(info).OrderByDescending(p => p.Priority).ToArray();
 
-                if (!this.AssertMaxOneRequiredLoader(info, loaders, out string error))
+                if (!this.AssertMaxOneRequiredLoader(info, loaders, out string? error))
                 {
                     this.Monitor.Log(error, LogLevel.Warn);
                     return null;
@@ -196,20 +196,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="info">The basic asset metadata.</param>
         /// <param name="asset">The loaded asset.</param>
         private IAssetData ApplyEditors<T>(IAssetInfo info, IAssetData asset)
+            where T : notnull
         {
             IAssetData GetNewData(object data) => new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName, this.Reflection);
 
             // special case: if the asset was loaded with a more general type like 'object', call editors with the actual type instead.
             {
                 Type actualType = asset.Data.GetType();
-                Type actualOpenType = actualType.IsGenericType ? actualType.GetGenericTypeDefinition() : null;
+                Type? actualOpenType = actualType.IsGenericType ? actualType.GetGenericTypeDefinition() : null;
 
                 if (typeof(T) != actualType && (actualOpenType == typeof(Dictionary<,>) || actualOpenType == typeof(List<>) || actualType == typeof(Texture2D) || actualType == typeof(Map)))
                 {
                     return (IAssetData)this.GetType()
                         .GetMethod(nameof(this.ApplyEditors), BindingFlags.NonPublic | BindingFlags.Instance)!
                         .MakeGenericMethod(actualType)
-                        .Invoke(this, new object[] { info, asset });
+                        .Invoke(this, new object[] { info, asset })!;
                 }
             }
 
@@ -232,6 +233,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 }
 
                 // validate edit
+                // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- it's only guaranteed non-null after this method
                 if (asset.Data == null)
                 {
                     mod.LogAsMod($"Mod incorrectly set asset '{info.Name}'{this.GetOnBehalfOfLabel(editor.OnBehalfOf)} to a null value; ignoring override.", LogLevel.Warn);
@@ -252,6 +254,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
         private IEnumerable<AssetLoadOperation> GetLoaders<T>(IAssetInfo info)
+            where T : notnull
         {
             return this.Coordinator
                 .GetAssetOperations<T>(info)
@@ -262,6 +265,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
         private IEnumerable<AssetEditOperation> GetEditors<T>(IAssetInfo info)
+            where T : notnull
         {
             return this.Coordinator
                 .GetAssetOperations<T>(info)
@@ -273,7 +277,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="loaders">The asset loaders to apply.</param>
         /// <param name="error">The error message to show to the user, if the method returns false.</param>
         /// <returns>Returns true if only one loader will apply, else false.</returns>
-        private bool AssertMaxOneRequiredLoader(IAssetInfo info, AssetLoadOperation[] loaders, out string error)
+        private bool AssertMaxOneRequiredLoader(IAssetInfo info, AssetLoadOperation[] loaders, [NotNullWhen(false)] out string? error)
         {
             AssetLoadOperation[] required = loaders.Where(p => p.Priority == AssetLoadPriority.Exclusive).ToArray();
             if (required.Length <= 1)
@@ -299,7 +303,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="onBehalfOf">The content pack on whose behalf the action is being performed.</param>
         /// <param name="parenthetical">whether to format the label as a parenthetical shown after the mod name like <c> (for the 'X' content pack)</c>, instead of a standalone label like <c>the 'X' content pack</c>.</param>
         /// <returns>Returns the on-behalf-of label if applicable, else <c>null</c>.</returns>
-        private string GetOnBehalfOfLabel(IModMetadata onBehalfOf, bool parenthetical = true)
+        [return: NotNullIfNotNull("onBehalfOf")]
+        private string? GetOnBehalfOfLabel(IModMetadata? onBehalfOf, bool parenthetical = true)
         {
             if (onBehalfOf == null)
                 return null;
@@ -315,7 +320,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="data">The loaded asset data.</param>
         /// <param name="loader">The loader which loaded the asset.</param>
         /// <returns>Returns whether the asset passed validation checks (after any fixes were applied).</returns>
-        private bool TryFixAndValidateLoadedAsset<T>(IAssetInfo info, T data, AssetLoadOperation loader)
+        private bool TryFixAndValidateLoadedAsset<T>(IAssetInfo info, [NotNullWhen(true)] T? data, AssetLoadOperation loader)
+            where T : notnull
         {
             IModMetadata mod = loader.Mod;
 
@@ -335,7 +341,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     // add missing tilesheet
                     if (loadedMap.GetTileSheet(vanillaSheet.Id) == null)
                     {
-                        mod.Monitor.LogOnce("SMAPI fixed maps loaded by this mod to prevent errors. See the log file for details.", LogLevel.Warn);
+                        mod.Monitor!.LogOnce("SMAPI fixed maps loaded by this mod to prevent errors. See the log file for details.", LogLevel.Warn);
                         this.Monitor.Log($"Fixed broken map replacement: {mod.DisplayName} loaded '{info.Name}' without a required tilesheet (id: {vanillaSheet.Id}, source: {vanillaSheet.ImageSource}).");
 
                         loadedMap.AddTileSheet(new TileSheet(vanillaSheet.Id, loadedMap, vanillaSheet.ImageSource, vanillaSheet.SheetSize, vanillaSheet.TileSize));
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
index 46d5d24e..1b0e1016 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Globalization;
 using Microsoft.Xna.Framework.Graphics;
@@ -39,7 +37,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Get whether a texture was loaded by this content manager.</summary>
         /// <param name="texture">The texture to check.</param>
-        public bool IsResponsibleFor(Texture2D texture)
+        public bool IsResponsibleFor(Texture2D? texture)
         {
             return
                 texture?.Tag is string tag
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index c8b2ae64..ac67cad5 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Content;
@@ -33,25 +31,28 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Get whether an asset exists and can be loaded.</summary>
         /// <typeparam name="T">The expected asset type.</typeparam>
         /// <param name="assetName">The normalized asset name.</param>
-        bool DoesAssetExist<T>(IAssetName assetName);
+        bool DoesAssetExist<T>(IAssetName assetName)
+            where T: notnull;
 
         /// <summary>Load an asset through the content pipeline, using a localized variant of the <paramref name="assetName"/> if available.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
         /// <param name="language">The language for which to load the asset.</param>
         /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
-        T LoadLocalized<T>(IAssetName assetName, LocalizedContentManager.LanguageCode language, bool useCache);
+        T LoadLocalized<T>(IAssetName assetName, LocalizedContentManager.LanguageCode language, bool useCache)
+            where T : notnull;
 
         /// <summary>Load an asset through the content pipeline, using the exact asset name without checking for localized variants.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
         /// <param name="useCache">Whether to read/write the loaded asset to the asset cache.</param>
-        T LoadExact<T>(IAssetName assetName, bool useCache);
+        T LoadExact<T>(IAssetName assetName, bool useCache)
+            where T : notnull;
 
         /// <summary>Assert that the given key has a valid format and return a normalized form consistent with the underlying cache.</summary>
         /// <param name="assetName">The asset key to check.</param>
         /// <exception cref="SContentLoadException">The asset key is empty or contains invalid characters.</exception>
-        string AssertAndNormalizeAssetName(string assetName);
+        string AssertAndNormalizeAssetName(string? assetName);
 
         /// <summary>Get the current content locale.</summary>
         string GetLocale();
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index 2d33a22e..2cfd5cce 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.IO;
 using StardewModdingAPI.Framework.ModHelpers;
@@ -69,12 +67,12 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <inheritdoc />
-        public TModel ReadJsonFile<TModel>(string path) where TModel : class
+        public TModel? ReadJsonFile<TModel>(string path) where TModel : class
         {
             path = PathUtilities.NormalizePath(path);
 
             FileInfo file = this.GetFile(path);
-            return file.Exists && this.JsonHelper.ReadJsonFileIfExists(file.FullName, out TModel model)
+            return file.Exists && this.JsonHelper.ReadJsonFileIfExists(file.FullName, out TModel? model)
                 ? model
                 : null;
         }
@@ -93,6 +91,7 @@ namespace StardewModdingAPI.Framework
         /// <inheritdoc />
         [Obsolete]
         public T LoadAsset<T>(string key)
+            where T : notnull
         {
             return this.ModContent.Load<T>(key);
         }
@@ -101,7 +100,7 @@ namespace StardewModdingAPI.Framework
         [Obsolete]
         public string GetActualAssetKey(string key)
         {
-            return this.ModContent.GetInternalAssetName(key)?.Name;
+            return this.ModContent.GetInternalAssetName(key).Name;
         }
 
 
diff --git a/src/SMAPI/Framework/CursorPosition.cs b/src/SMAPI/Framework/CursorPosition.cs
index 8f36a554..24084830 100644
--- a/src/SMAPI/Framework/CursorPosition.cs
+++ b/src/SMAPI/Framework/CursorPosition.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Microsoft.Xna.Framework;
 using StardewValley;
 
@@ -41,7 +39,7 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <inheritdoc />
-        public bool Equals(ICursorPosition other)
+        public bool Equals(ICursorPosition? other)
         {
             return other != null && this.AbsolutePixels == other.AbsolutePixels;
         }
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index 8fa31165..4b8a770d 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -23,7 +21,7 @@ namespace StardewModdingAPI.Framework.Events
         private readonly List<ManagedEventHandler<TEventArgs>> Handlers = new();
 
         /// <summary>A cached snapshot of <see cref="Handlers"/>, or <c>null</c> to rebuild it next raise.</summary>
-        private ManagedEventHandler<TEventArgs>[] CachedHandlers = Array.Empty<ManagedEventHandler<TEventArgs>>();
+        private ManagedEventHandler<TEventArgs>[]? CachedHandlers = Array.Empty<ManagedEventHandler<TEventArgs>>();
 
         /// <summary>The total number of event handlers registered for this events, regardless of whether they're still registered.</summary>
         private int RegistrationIndex;
@@ -100,7 +98,7 @@ namespace StardewModdingAPI.Framework.Events
         /// <summary>Raise the event and notify all handlers.</summary>
         /// <param name="args">The event arguments to pass.</param>
         /// <param name="match">A lambda which returns true if the event should be raised for the given mod.</param>
-        public void Raise(TEventArgs args, Func<IModMetadata, bool> match = null)
+        public void Raise(TEventArgs args, Func<IModMetadata, bool>? match = null)
         {
             this.Raise((_, invoke) => invoke(args), match);
         }
@@ -108,7 +106,7 @@ namespace StardewModdingAPI.Framework.Events
         /// <summary>Raise the event and notify all handlers.</summary>
         /// <param name="invoke">Invoke an event handler. This receives the mod which registered the handler, and should invoke the callback with the event arguments to pass it.</param>
         /// <param name="match">A lambda which returns true if the event should be raised for the given mod.</param>
-        public void Raise(Action<IModMetadata, Action<TEventArgs>> invoke, Func<IModMetadata, bool> match = null)
+        public void Raise(Action<IModMetadata, Action<TEventArgs>> invoke, Func<IModMetadata, bool>? match = null)
         {
             // skip if no handlers
             if (this.Handlers.Count == 0)
diff --git a/src/SMAPI/Framework/Events/ManagedEventHandler.cs b/src/SMAPI/Framework/Events/ManagedEventHandler.cs
index f31bc04d..d32acdb9 100644
--- a/src/SMAPI/Framework/Events/ManagedEventHandler.cs
+++ b/src/SMAPI/Framework/Events/ManagedEventHandler.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Events;
 
@@ -42,7 +40,7 @@ namespace StardewModdingAPI.Framework.Events
         }
 
         /// <inheritdoc />
-        public int CompareTo(object obj)
+        public int CompareTo(object? obj)
         {
             if (obj is not ManagedEventHandler<TEventArgs> other)
                 throw new ArgumentException("Can't compare to an unrelated object type.");
diff --git a/src/SMAPI/Framework/Exceptions/SContentLoadException.cs b/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
index c21a6b0e..be1fe748 100644
--- a/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
+++ b/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Content;
 
@@ -14,7 +12,7 @@ namespace StardewModdingAPI.Framework.Exceptions
         /// <summary>Construct an instance.</summary>
         /// <param name="message">The error message.</param>
         /// <param name="ex">The underlying exception, if any.</param>
-        public SContentLoadException(string message, Exception ex = null)
+        public SContentLoadException(string message, Exception? ex = null)
             : base(message, ex) { }
     }
 }
diff --git a/src/SMAPI/Framework/GameVersion.cs b/src/SMAPI/Framework/GameVersion.cs
index aa91d8f3..542c1345 100644
--- a/src/SMAPI/Framework/GameVersion.cs
+++ b/src/SMAPI/Framework/GameVersion.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 
@@ -55,7 +53,7 @@ namespace StardewModdingAPI.Framework
         private static string GetSemanticVersionString(string gameVersion)
         {
             // mapped version
-            return GameVersion.VersionMap.TryGetValue(gameVersion, out string semanticVersion)
+            return GameVersion.VersionMap.TryGetValue(gameVersion, out string? semanticVersion)
                 ? semanticVersion
                 : gameVersion;
         }
@@ -64,10 +62,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="semanticVersion">The semantic version string.</param>
         private static string GetGameVersionString(string semanticVersion)
         {
-            foreach (var mapping in GameVersion.VersionMap)
+            foreach ((string gameVersion, string equivalentSemanticVersion) in GameVersion.VersionMap)
             {
-                if (mapping.Value.Equals(semanticVersion, StringComparison.OrdinalIgnoreCase))
-                    return mapping.Key;
+                if (equivalentSemanticVersion.Equals(semanticVersion, StringComparison.OrdinalIgnoreCase))
+                    return gameVersion;
             }
 
             return semanticVersion;
diff --git a/src/SMAPI/Framework/IModMetadata.cs b/src/SMAPI/Framework/IModMetadata.cs
index 800b198a..7cee20b9 100644
--- a/src/SMAPI/Framework/IModMetadata.cs
+++ b/src/SMAPI/Framework/IModMetadata.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.ModHelpers;
@@ -29,7 +27,7 @@ namespace StardewModdingAPI.Framework
         string RelativeDirectoryPath { get; }
 
         /// <summary>Metadata about the mod from SMAPI's internal data (if any).</summary>
-        ModDataRecordVersionedFields DataRecord { get; }
+        ModDataRecordVersionedFields? DataRecord { get; }
 
         /// <summary>The metadata resolution status.</summary>
         ModMetadataStatus Status { get; }
@@ -41,31 +39,31 @@ namespace StardewModdingAPI.Framework
         ModWarning Warnings { get; }
 
         /// <summary>The reason the metadata is invalid, if any.</summary>
-        string Error { get; }
+        string? Error { get; }
 
         /// <summary>A detailed technical message for <see cref="Error"/>, if any.</summary>
-        public string ErrorDetails { get; }
+        string? ErrorDetails { get; }
 
         /// <summary>Whether the mod folder should be ignored. This is <c>true</c> if it was found within a folder whose name starts with a dot.</summary>
         bool IsIgnored { get; }
 
         /// <summary>The mod instance (if loaded and <see cref="IModInfo.IsContentPack"/> is false).</summary>
-        IMod Mod { get; }
+        IMod? Mod { get; }
 
         /// <summary>The content pack instance (if loaded and <see cref="IModInfo.IsContentPack"/> is true).</summary>
-        IContentPack ContentPack { get; }
+        IContentPack? ContentPack { get; }
 
         /// <summary>The translations for this mod (if loaded).</summary>
-        TranslationHelper Translations { get; }
+        TranslationHelper? Translations { get; }
 
         /// <summary>Writes messages to the console and log file as this mod.</summary>
-        IMonitor Monitor { get; }
+        IMonitor? Monitor { get; }
 
         /// <summary>The mod-provided API (if any).</summary>
-        object Api { get; }
+        object? Api { get; }
 
         /// <summary>The update-check metadata for this mod (if any).</summary>
-        ModEntryModel UpdateCheckData { get; }
+        ModEntryModel? UpdateCheckData { get; }
 
         /// <summary>The fake content packs created by this mod, if any.</summary>
         ISet<WeakReference<ContentPack>> FakeContentPacks { get; }
@@ -84,7 +82,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="error">The reason the metadata is invalid, if any.</param>
         /// <param name="errorDetails">A detailed technical message, if any.</param>
         /// <returns>Return the instance for chaining.</returns>
-        IModMetadata SetStatus(ModMetadataStatus status, ModFailReason reason, string error, string errorDetails = null);
+        IModMetadata SetStatus(ModMetadataStatus status, ModFailReason reason, string? error, string? errorDetails = null);
 
         /// <summary>Set a warning flag for the mod.</summary>
         /// <param name="warning">The warning to set.</param>
@@ -103,7 +101,7 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Set the mod-provided API instance.</summary>
         /// <param name="api">The mod-provided API.</param>
-        IModMetadata SetApi(object api);
+        IModMetadata SetApi(object? api);
 
         /// <summary>Set the update-check metadata for this mod.</summary>
         /// <param name="data">The update-check metadata.</param>
@@ -117,7 +115,7 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Whether the mod has the given ID.</summary>
         /// <param name="id">The mod ID to check.</param>
-        bool HasID(string id);
+        bool HasID(string? id);
 
         /// <summary>Get the defined update keys.</summary>
         /// <param name="validOnly">Only return valid update keys.</param>
diff --git a/src/SMAPI/Framework/Logging/LogFileManager.cs b/src/SMAPI/Framework/Logging/LogFileManager.cs
index 0b6f9ad2..b396091a 100644
--- a/src/SMAPI/Framework/Logging/LogFileManager.cs
+++ b/src/SMAPI/Framework/Logging/LogFileManager.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.IO;
 
@@ -32,7 +30,7 @@ namespace StardewModdingAPI.Framework.Logging
             this.Path = path;
 
             // create log directory if needed
-            string logDir = System.IO.Path.GetDirectoryName(path);
+            string? logDir = System.IO.Path.GetDirectoryName(path);
             if (logDir == null)
                 throw new ArgumentException($"The log path '{path}' is not valid.");
             Directory.CreateDirectory(logDir);
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 12ef0439..b610b395 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
@@ -114,6 +112,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
         /// <inheritdoc />
         public T Load<T>(string key, ContentSource source = ContentSource.ModFolder)
+            where T : notnull
         {
             IAssetName assetName = this.ContentCore.ParseAssetName(key, allowLocales: source == ContentSource.GameContent);
 
@@ -140,7 +139,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
         /// <inheritdoc />
         [Pure]
-        public string NormalizeAssetName(string assetName)
+        public string NormalizeAssetName(string? assetName)
         {
             return this.ModContentManager.AssertAndNormalizeAssetName(assetName);
         }
@@ -171,6 +170,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
         /// <inheritdoc />
         public bool InvalidateCache<T>()
+            where T : notnull
         {
             this.Monitor.Log($"Requested cache invalidation for all assets of type {typeof(T)}. This is an expensive operation and should be avoided if possible.");
             return this.ContentCore.InvalidateCache((_, _, type) => typeof(T).IsAssignableFrom(type)).Any();
@@ -184,7 +184,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        public IAssetData GetPatchHelper<T>(T data, string assetName = null)
+        public IAssetData GetPatchHelper<T>(T data, string? assetName = null)
+            where T : notnull
         {
             if (data == null)
                 throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
diff --git a/src/SMAPI/Framework/ModHelpers/DataHelper.cs b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
index 86a34ee8..92b3b398 100644
--- a/src/SMAPI/Framework/ModHelpers/DataHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -42,19 +40,21 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** JSON file
         ****/
         /// <inheritdoc />
-        public TModel ReadJsonFile<TModel>(string path) where TModel : class
+        public TModel? ReadJsonFile<TModel>(string path)
+            where TModel : class
         {
             if (!PathUtilities.IsSafeRelativePath(path))
                 throw new InvalidOperationException($"You must call {nameof(IModHelper.Data)}.{nameof(this.ReadJsonFile)} with a relative path.");
 
             path = Path.Combine(this.ModFolderPath, PathUtilities.NormalizePath(path));
-            return this.JsonHelper.ReadJsonFileIfExists(path, out TModel data)
+            return this.JsonHelper.ReadJsonFileIfExists(path, out TModel? data)
                 ? data
                 : null;
         }
 
         /// <inheritdoc />
-        public void WriteJsonFile<TModel>(string path, TModel data) where TModel : class
+        public void WriteJsonFile<TModel>(string path, TModel? data)
+            where TModel : class
         {
             if (!PathUtilities.IsSafeRelativePath(path))
                 throw new InvalidOperationException($"You must call {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.WriteJsonFile)} with a relative path (without directory climbing).");
@@ -71,7 +71,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Save file
         ****/
         /// <inheritdoc />
-        public TModel ReadSaveData<TModel>(string key) where TModel : class
+        public TModel? ReadSaveData<TModel>(string key)
+            where TModel : class
         {
             if (Context.LoadStage == LoadStage.None)
                 throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.ReadSaveData)} when a save file isn't loaded.");
@@ -82,14 +83,15 @@ namespace StardewModdingAPI.Framework.ModHelpers
             string internalKey = this.GetSaveFileKey(key);
             foreach (IDictionary<string, string> dataField in this.GetDataFields(Context.LoadStage))
             {
-                if (dataField.TryGetValue(internalKey, out string value))
+                if (dataField.TryGetValue(internalKey, out string? value))
                     return this.JsonHelper.Deserialize<TModel>(value);
             }
             return null;
         }
 
         /// <inheritdoc />
-        public void WriteSaveData<TModel>(string key, TModel model) where TModel : class
+        public void WriteSaveData<TModel>(string key, TModel? model)
+            where TModel : class
         {
             if (Context.LoadStage == LoadStage.None)
                 throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.WriteSaveData)} when a save file isn't loaded.");
@@ -97,7 +99,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 throw new InvalidOperationException($"Can't use {nameof(IMod.Helper)}.{nameof(IModHelper.Data)}.{nameof(this.WriteSaveData)} when connected to a remote host. (Save files are stored on the main player's computer.)");
 
             string internalKey = this.GetSaveFileKey(key);
-            string data = model != null
+            string? data = model != null
                 ? this.JsonHelper.Serialize(model, Formatting.None)
                 : null;
 
@@ -114,16 +116,18 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Global app data
         ****/
         /// <inheritdoc />
-        public TModel ReadGlobalData<TModel>(string key) where TModel : class
+        public TModel? ReadGlobalData<TModel>(string key)
+            where TModel : class
         {
             string path = this.GetGlobalDataPath(key);
-            return this.JsonHelper.ReadJsonFileIfExists(path, out TModel data)
+            return this.JsonHelper.ReadJsonFileIfExists(path, out TModel? data)
                 ? data
                 : null;
         }
 
         /// <inheritdoc />
-        public void WriteGlobalData<TModel>(string key, TModel data) where TModel : class
+        public void WriteGlobalData<TModel>(string key, TModel? data)
+            where TModel : class
         {
             string path = this.GetGlobalDataPath(key);
             if (data != null)
diff --git a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
index 6d0c2f5f..4c1cde02 100644
--- a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Linq;
 using StardewModdingAPI.Framework.Content;
@@ -71,6 +69,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
         /// <inheritdoc />
         public T Load<T>(string key)
+            where T : notnull
         {
             IAssetName assetName = this.ContentCore.ParseAssetName(key, allowLocales: true);
             return this.Load<T>(assetName);
@@ -78,6 +77,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
         /// <inheritdoc />
         public T Load<T>(IAssetName assetName)
+            where T : notnull
         {
             try
             {
@@ -105,6 +105,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
         /// <inheritdoc />
         public bool InvalidateCache<T>()
+            where T : notnull
         {
             this.Monitor.Log($"Requested cache invalidation for all assets of type {typeof(T)}. This is an expensive operation and should be avoided if possible.");
             return this.ContentCore.InvalidateCache((_, _, type) => typeof(T).IsAssignableFrom(type)).Any();
@@ -118,7 +119,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        public IAssetData GetPatchHelper<T>(T data, string assetName = null)
+        public IAssetData GetPatchHelper<T>(T data, string? assetName = null)
+            where T : notnull
         {
             if (data == null)
                 throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index b149ed82..fc47f269 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Content;
@@ -57,6 +55,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
         /// <inheritdoc />
         public T Load<T>(string relativePath)
+            where T : notnull
         {
             relativePath = this.RelativePathCache.GetAssetName(relativePath);
 
@@ -80,7 +79,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        public IAssetData GetPatchHelper<T>(T data, string relativePath = null)
+        public IAssetData GetPatchHelper<T>(T data, string? relativePath = null)
+            where T : notnull
         {
             if (data == null)
                 throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index e277e6fa..84899610 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.Reflection;
 
@@ -47,7 +45,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        public IModInfo Get(string uniqueID)
+        public IModInfo? Get(string uniqueID)
         {
             return this.Registry.Get(uniqueID);
         }
@@ -59,7 +57,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        public object GetApi(string uniqueID)
+        public object? GetApi(string uniqueID)
         {
             // validate ready
             if (!this.Registry.AreAllModsInitialized)
@@ -69,17 +67,18 @@ namespace StardewModdingAPI.Framework.ModHelpers
             }
 
             // get raw API
-            IModMetadata mod = this.Registry.Get(uniqueID);
+            IModMetadata? mod = this.Registry.Get(uniqueID);
             if (mod?.Api != null && this.AccessedModApis.Add(mod.Manifest.UniqueID))
                 this.Monitor.Log($"Accessed mod-provided API for {mod.DisplayName}.");
             return mod?.Api;
         }
 
         /// <inheritdoc />
-        public TInterface GetApi<TInterface>(string uniqueID) where TInterface : class
+        public TInterface? GetApi<TInterface>(string uniqueID)
+            where TInterface : class
         {
             // get raw API
-            object api = this.GetApi(uniqueID);
+            object? api = this.GetApi(uniqueID);
             if (api == null)
                 return null;
 
diff --git a/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs b/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
index 96b074e2..a419327e 100644
--- a/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.Networking;
 using StardewValley;
@@ -41,9 +39,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        public IMultiplayerPeer GetConnectedPlayer(long id)
+        public IMultiplayerPeer? GetConnectedPlayer(long id)
         {
-            return this.Multiplayer.Peers.TryGetValue(id, out MultiplayerPeer peer)
+            return this.Multiplayer.Peers.TryGetValue(id, out MultiplayerPeer? peer)
                 ? peer
                 : null;
         }
@@ -55,7 +53,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        public void SendMessage<TMessage>(TMessage message, string messageType, string[] modIDs = null, long[] playerIDs = null)
+        public void SendMessage<TMessage>(TMessage message, string messageType, string[]? modIDs = null, long[]? playerIDs = null)
         {
             this.Multiplayer.BroadcastModMessage(
                 message: message,
diff --git a/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs b/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
index 24cbd01c..af018c87 100644
--- a/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 using StardewModdingAPI.Framework.Reflection;
@@ -39,7 +37,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             return this.AssertAccessAllowed(
                 this.Reflector.GetField<TValue>(obj, name, required)
-            );
+            )!;
         }
 
         /// <inheritdoc />
@@ -47,7 +45,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             return this.AssertAccessAllowed(
                 this.Reflector.GetField<TValue>(type, name, required)
-            );
+            )!;
         }
 
         /// <inheritdoc />
@@ -55,7 +53,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             return this.AssertAccessAllowed(
                 this.Reflector.GetProperty<TValue>(obj, name, required)
-            );
+            )!;
         }
 
         /// <inheritdoc />
@@ -63,7 +61,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             return this.AssertAccessAllowed(
                 this.Reflector.GetProperty<TValue>(type, name, required)
-            );
+            )!;
         }
 
         /// <inheritdoc />
@@ -71,7 +69,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             return this.AssertAccessAllowed(
                 this.Reflector.GetMethod(obj, name, required)
-            );
+            )!;
         }
 
         /// <inheritdoc />
@@ -79,7 +77,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         {
             return this.AssertAccessAllowed(
                 this.Reflector.GetMethod(type, name, required)
-            );
+            )!;
         }
 
 
@@ -90,7 +88,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <typeparam name="T">The field value type.</typeparam>
         /// <param name="field">The field being accessed.</param>
         /// <returns>Returns the same field instance for convenience.</returns>
-        private IReflectedField<T> AssertAccessAllowed<T>(IReflectedField<T> field)
+        private IReflectedField<T>? AssertAccessAllowed<T>(IReflectedField<T>? field)
         {
             this.AssertAccessAllowed(field?.FieldInfo);
             return field;
@@ -100,7 +98,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <typeparam name="T">The property value type.</typeparam>
         /// <param name="property">The property being accessed.</param>
         /// <returns>Returns the same property instance for convenience.</returns>
-        private IReflectedProperty<T> AssertAccessAllowed<T>(IReflectedProperty<T> property)
+        private IReflectedProperty<T>? AssertAccessAllowed<T>(IReflectedProperty<T>? property)
         {
             this.AssertAccessAllowed(property?.PropertyInfo.GetMethod?.GetBaseDefinition());
             this.AssertAccessAllowed(property?.PropertyInfo.SetMethod?.GetBaseDefinition());
@@ -110,7 +108,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Assert that mods can use the reflection helper to access the given member.</summary>
         /// <param name="method">The method being accessed.</param>
         /// <returns>Returns the same method instance for convenience.</returns>
-        private IReflectedMethod AssertAccessAllowed(IReflectedMethod method)
+        private IReflectedMethod? AssertAccessAllowed(IReflectedMethod? method)
         {
             this.AssertAccessAllowed(method?.MethodInfo.GetBaseDefinition());
             return method;
@@ -118,18 +116,18 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
         /// <summary>Assert that mods can use the reflection helper to access the given member.</summary>
         /// <param name="member">The member being accessed.</param>
-        private void AssertAccessAllowed(MemberInfo member)
+        private void AssertAccessAllowed(MemberInfo? member)
         {
             if (member == null)
                 return;
 
             // get type which defines the member
-            Type declaringType = member.DeclaringType;
+            Type? declaringType = member.DeclaringType;
             if (declaringType == null)
                 throw new InvalidOperationException($"Can't validate access to {member.MemberType} {member.Name} because it has no declaring type."); // should never happen
 
             // validate access
-            string rootNamespace = typeof(Program).Namespace;
+            string? rootNamespace = typeof(Program).Namespace;
             if (declaringType.Namespace == rootNamespace || declaringType.Namespace?.StartsWith(rootNamespace + ".") == true)
                 throw new InvalidOperationException($"SMAPI blocked access by {this.ModName} to its internals through the reflection API. Accessing the SMAPI internals is strongly discouraged since they're subject to change, which means the mod can break without warning. (Detected access to {declaringType.FullName}.{member.Name}.)");
         }
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
index 1d4ddf72..b3378ad1 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using Mono.Cecil;
 
@@ -38,6 +36,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
         /// <summary>Resolve an assembly reference.</summary>
         /// <param name="name">The assembly name.</param>
+        /// <exception cref="AssemblyResolutionException">The assembly can't be resolved.</exception>
         public override AssemblyDefinition Resolve(AssemblyNameReference name)
         {
             return this.ResolveName(name.Name) ?? base.Resolve(name);
@@ -46,6 +45,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Resolve an assembly reference.</summary>
         /// <param name="name">The assembly name.</param>
         /// <param name="parameters">The assembly reader parameters.</param>
+        /// <exception cref="AssemblyResolutionException">The assembly can't be resolved.</exception>
         public override AssemblyDefinition Resolve(AssemblyNameReference name, ReaderParameters parameters)
         {
             return this.ResolveName(name.Name) ?? base.Resolve(name, parameters);
@@ -57,9 +57,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         *********/
         /// <summary>Resolve a known assembly definition based on its short or full name.</summary>
         /// <param name="name">The assembly's short or full name.</param>
-        private AssemblyDefinition ResolveName(string name)
+        private AssemblyDefinition? ResolveName(string name)
         {
-            return this.Lookup.TryGetValue(name, out AssemblyDefinition match)
+            return this.Lookup.TryGetValue(name, out AssemblyDefinition? match)
                 ? match
                 : null;
         }
diff --git a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
index 7c94beb7..f5d449c5 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Linq;
 using Mono.Cecil;
@@ -57,7 +55,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         {
             if (this.MethodNames.Any())
             {
-                MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+                MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
                 if (methodRef != null && methodRef.DeclaringType.FullName == this.FullTypeName && this.MethodNames.Contains(methodRef.Name))
                 {
                     string eventName = methodRef.Name.Split(new[] { '_' }, 2)[1];
diff --git a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
index 96b4098a..7fe4abec 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/FieldFinder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Linq;
 using Mono.Cecil;
@@ -51,7 +49,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         {
             if (this.FieldNames.Any())
             {
-                FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
+                FieldReference? fieldRef = RewriteHelper.AsFieldReference(instruction);
                 if (fieldRef != null && fieldRef.DeclaringType.FullName == this.FullTypeName && this.FieldNames.Contains(fieldRef.Name))
                 {
                     this.FieldNames.Remove(fieldRef.Name);
diff --git a/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
index 7d3c1fd7..e8fdc8c7 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/MethodFinder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
@@ -54,7 +52,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /// <param name="instruction">The IL instruction.</param>
         protected bool IsMatch(Instruction instruction)
         {
-            MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+            MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
             return
                 methodRef != null
                 && methodRef.DeclaringType.FullName == this.FullTypeName
diff --git a/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
index b2f2e193..2af76f55 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/PropertyFinder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
@@ -54,7 +52,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /// <param name="instruction">The IL instruction.</param>
         protected bool IsMatch(Instruction instruction)
         {
-            MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+            MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
             return
                 methodRef != null
                 && methodRef.DeclaringType.FullName == this.FullTypeName
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
index 81f90498..f34542c3 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMemberWithUnexpectedTypeFinder.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -34,11 +33,11 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
             // field reference
-            FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
+            FieldReference? fieldRef = RewriteHelper.AsFieldReference(instruction);
             if (fieldRef != null && this.ShouldValidate(fieldRef.DeclaringType))
             {
                 // get target field
-                FieldDefinition targetField = fieldRef.DeclaringType.Resolve()?.Fields.FirstOrDefault(p => p.Name == fieldRef.Name);
+                FieldDefinition? targetField = fieldRef.DeclaringType.Resolve()?.Fields.FirstOrDefault(p => p.Name == fieldRef.Name);
                 if (targetField == null)
                     return false;
 
@@ -51,16 +50,16 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
             }
 
             // method reference
-            MethodReference methodReference = RewriteHelper.AsMethodReference(instruction);
+            MethodReference? methodReference = RewriteHelper.AsMethodReference(instruction);
             if (methodReference != null && !this.IsUnsupported(methodReference) && this.ShouldValidate(methodReference.DeclaringType))
             {
                 // get potential targets
-                MethodDefinition[] candidateMethods = methodReference.DeclaringType.Resolve()?.Methods.Where(found => found.Name == methodReference.Name).ToArray();
+                MethodDefinition[]? candidateMethods = methodReference.DeclaringType.Resolve()?.Methods.Where(found => found.Name == methodReference.Name).ToArray();
                 if (candidateMethods == null || !candidateMethods.Any())
                     return false;
 
                 // compare return types
-                MethodDefinition methodDef = methodReference.Resolve();
+                MethodDefinition? methodDef = methodReference.Resolve();
                 if (methodDef == null)
                     return false; // validated by ReferenceToMissingMemberFinder
 
@@ -80,7 +79,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         *********/
         /// <summary>Whether references to the given type should be validated.</summary>
         /// <param name="type">The type reference.</param>
-        private bool ShouldValidate(TypeReference type)
+        private bool ShouldValidate([NotNullWhen(true)] TypeReference? type)
         {
             return type != null && this.ValidateReferencesToAssemblies.Contains(type.Scope.Name);
         }
diff --git a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
index 001d1986..fae7fb12 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/ReferenceToMissingMemberFinder.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
@@ -33,10 +32,10 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
             // field reference
-            FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
+            FieldReference? fieldRef = RewriteHelper.AsFieldReference(instruction);
             if (fieldRef != null && this.ShouldValidate(fieldRef.DeclaringType))
             {
-                FieldDefinition target = fieldRef.Resolve();
+                FieldDefinition? target = fieldRef.Resolve();
                 if (target == null || target.HasConstant)
                 {
                     this.MarkFlag(InstructionHandleResult.NotCompatible, $"reference to {fieldRef.DeclaringType.FullName}.{fieldRef.Name} (no such field)");
@@ -45,10 +44,10 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
             }
 
             // method reference
-            MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+            MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
             if (methodRef != null && this.ShouldValidate(methodRef.DeclaringType) && !this.IsUnsupported(methodRef))
             {
-                MethodDefinition target = methodRef.Resolve();
+                MethodDefinition? target = methodRef.Resolve();
                 if (target == null)
                 {
                     string phrase;
@@ -73,7 +72,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         *********/
         /// <summary>Whether references to the given type should be validated.</summary>
         /// <param name="type">The type reference.</param>
-        private bool ShouldValidate(TypeReference type)
+        private bool ShouldValidate([NotNullWhen(true)] TypeReference? type)
         {
             return type != null && this.ValidateReferencesToAssemblies.Contains(type.Scope.Name);
         }
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
index 4c589ed8..17acbf9a 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeAssemblyFinder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
@@ -19,7 +17,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         private readonly InstructionHandleResult Result;
 
         /// <summary>Get whether a matched type should be ignored.</summary>
-        private readonly Func<TypeReference, bool> ShouldIgnore;
+        private readonly Func<TypeReference, bool>? ShouldIgnore;
 
 
         /*********
@@ -29,7 +27,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /// <param name="assemblyName">The full assembly name to which to find references.</param>
         /// <param name="result">The result to return for matching instructions.</param>
         /// <param name="shouldIgnore">Get whether a matched type should be ignored.</param>
-        public TypeAssemblyFinder(string assemblyName, InstructionHandleResult result, Func<TypeReference, bool> shouldIgnore = null)
+        public TypeAssemblyFinder(string assemblyName, InstructionHandleResult result, Func<TypeReference, bool>? shouldIgnore = null)
             : base(defaultPhrase: $"{assemblyName} assembly")
         {
             this.AssemblyName = assemblyName;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
index 04a5b970..77762f41 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/TypeFinder.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using Mono.Cecil;
@@ -20,7 +18,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         private readonly InstructionHandleResult Result;
 
         /// <summary>Get whether a matched type should be ignored.</summary>
-        private readonly Func<TypeReference, bool> ShouldIgnore;
+        private readonly Func<TypeReference, bool>? ShouldIgnore;
 
 
         /*********
@@ -30,7 +28,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /// <param name="fullTypeNames">The full type names to match.</param>
         /// <param name="result">The result to return for matching instructions.</param>
         /// <param name="shouldIgnore">Get whether a matched type should be ignored.</param>
-        public TypeFinder(string[] fullTypeNames, InstructionHandleResult result, Func<TypeReference, bool> shouldIgnore = null)
+        public TypeFinder(string[] fullTypeNames, InstructionHandleResult result, Func<TypeReference, bool>? shouldIgnore = null)
             : base(defaultPhrase: $"{string.Join(", ", fullTypeNames)} type{(fullTypeNames.Length != 1 ? "s" : "")}") // default phrase should never be used
         {
             this.FullTypeNames = new HashSet<string>(fullTypeNames);
@@ -42,7 +40,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         /// <param name="fullTypeName">The full type name to match.</param>
         /// <param name="result">The result to return for matching instructions.</param>
         /// <param name="shouldIgnore">Get whether a matched type should be ignored.</param>
-        public TypeFinder(string fullTypeName, InstructionHandleResult result, Func<TypeReference, bool> shouldIgnore = null)
+        public TypeFinder(string fullTypeName, InstructionHandleResult result, Func<TypeReference, bool>? shouldIgnore = null)
             : this(new[] { fullTypeName }, result, shouldIgnore) { }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
index bea786cd..865bf076 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/BaseInstructionHandler.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using Mono.Cecil;
@@ -59,7 +57,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         /// <param name="flag">The result flag to set.</param>
         /// <param name="resultMessage">The result message to add.</param>
         /// <returns>Returns true for convenience.</returns>
-        protected bool MarkFlag(InstructionHandleResult flag, string resultMessage = null)
+        protected bool MarkFlag(InstructionHandleResult flag, string? resultMessage = null)
         {
             this.Flags.Add(flag);
             if (resultMessage != null)
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
index 09ff78f7..55369602 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RecursiveRewriter.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -10,6 +9,7 @@ using Mono.Collections.Generic;
 namespace StardewModdingAPI.Framework.ModLoading.Framework
 {
     /// <summary>Handles recursively rewriting loaded assembly code.</summary>
+    [SuppressMessage("ReSharper", "AccessToModifiedClosure", Justification = "Rewrite callbacks are invoked immediately.")]
     internal class RecursiveRewriter
     {
         /*********
@@ -77,7 +77,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
             {
                 changed |= this.RewriteModuleImpl(this.Module);
 
-                foreach (var type in types)
+                foreach (TypeDefinition type in types)
                     changed |= this.RewriteTypeDefinition(type);
             }
             catch (Exception ex)
@@ -129,9 +129,10 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
                     ILProcessor cil = method.Body.GetILProcessor();
                     Collection<Instruction> instructions = cil.Body.Instructions;
                     bool addedInstructions = false;
+                    // ReSharper disable once ForCanBeConvertedToForeach -- deliberate to allow changing the collection
                     for (int i = 0; i < instructions.Count; i++)
                     {
-                        var instruction = instructions[i];
+                        Instruction instruction = instructions[i];
                         if (instruction.OpCode.Code == Code.Nop)
                             continue;
 
@@ -174,7 +175,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
             bool rewritten = false;
 
             // field reference
-            FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
+            FieldReference? fieldRef = RewriteHelper.AsFieldReference(instruction);
             if (fieldRef != null)
             {
                 rewritten |= this.RewriteTypeReference(fieldRef.DeclaringType, newType => fieldRef.DeclaringType = newType);
@@ -182,7 +183,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
             }
 
             // method reference
-            MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+            MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
             if (methodRef != null)
                 this.RewriteMethodReference(methodRef);
 
@@ -212,7 +213,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
             });
             rewritten |= this.RewriteTypeReference(methodRef.ReturnType, newType => methodRef.ReturnType = newType);
 
-            foreach (var parameter in methodRef.Parameters)
+            foreach (ParameterDefinition parameter in methodRef.Parameters)
                 rewritten |= this.RewriteTypeReference(parameter.ParameterType, newType => parameter.ParameterType = newType);
 
             if (methodRef is GenericInstanceMethod genericRef)
@@ -264,7 +265,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
                 bool curChanged = false;
 
                 // attribute type
-                TypeReference newAttrType = null;
+                TypeReference? newAttrType = null;
                 rewritten |= this.RewriteTypeReference(attribute.AttributeType, newType =>
                 {
                     newAttrType = newType;
@@ -289,9 +290,9 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
                 if (curChanged)
                 {
                     // get constructor
-                    MethodDefinition constructor = (newAttrType ?? attribute.AttributeType)
+                    MethodDefinition? constructor = (newAttrType ?? attribute.AttributeType)
                         .Resolve()
-                        .Methods
+                        ?.Methods
                         .Where(method => method.IsConstructor)
                         .FirstOrDefault(ctor => RewriteHelper.HasMatchingSignature(ctor, attribute.Constructor));
                     if (constructor == null)
@@ -301,9 +302,9 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
                     var newAttr = new CustomAttribute(this.Module.ImportReference(constructor));
                     for (int i = 0; i < argTypes.Length; i++)
                         newAttr.ConstructorArguments.Add(new CustomAttributeArgument(argTypes[i], attribute.ConstructorArguments[i].Value));
-                    foreach (var prop in attribute.Properties)
+                    foreach (CustomAttributeNamedArgument prop in attribute.Properties)
                         newAttr.Properties.Add(new CustomAttributeNamedArgument(prop.Name, prop.Argument));
-                    foreach (var field in attribute.Fields)
+                    foreach (CustomAttributeNamedArgument field in attribute.Fields)
                         newAttr.Fields.Add(new CustomAttributeNamedArgument(field.Name, field.Argument));
 
                     // swap attribute
diff --git a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
index 8f47fbdd..15f71251 100644
--- a/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
+++ b/src/SMAPI/Framework/ModLoading/Framework/RewriteHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Linq;
 using System.Reflection;
@@ -23,7 +21,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         *********/
         /// <summary>Get the field reference from an instruction if it matches.</summary>
         /// <param name="instruction">The IL instruction.</param>
-        public static FieldReference AsFieldReference(Instruction instruction)
+        public static FieldReference? AsFieldReference(Instruction instruction)
         {
             return instruction.OpCode == OpCodes.Ldfld || instruction.OpCode == OpCodes.Ldsfld || instruction.OpCode == OpCodes.Stfld || instruction.OpCode == OpCodes.Stsfld
                 ? (FieldReference)instruction.Operand
@@ -32,7 +30,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
 
         /// <summary>Get the method reference from an instruction if it matches.</summary>
         /// <param name="instruction">The IL instruction.</param>
-        public static MethodReference AsMethodReference(Instruction instruction)
+        public static MethodReference? AsMethodReference(Instruction instruction)
         {
             return instruction.OpCode == OpCodes.Call || instruction.OpCode == OpCodes.Callvirt || instruction.OpCode == OpCodes.Newobj
                 ? (MethodReference)instruction.Operand
@@ -42,7 +40,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         /// <summary>Get the CIL instruction to load a value onto the stack.</summary>
         /// <param name="rawValue">The constant value to inject.</param>
         /// <returns>Returns the instruction, or <c>null</c> if the value type isn't supported.</returns>
-        public static Instruction GetLoadValueInstruction(object rawValue)
+        public static Instruction? GetLoadValueInstruction(object? rawValue)
         {
             return rawValue switch
             {
@@ -151,7 +149,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Framework
         /// <param name="typeA">The type ID to compare.</param>
         /// <param name="typeB">The other type ID to compare.</param>
         /// <returns>true if the type IDs look like the same type, false if not.</returns>
-        public static bool LooksLikeSameType(TypeReference typeA, TypeReference typeB)
+        public static bool LooksLikeSameType(TypeReference? typeA, TypeReference? typeB)
         {
             return RewriteHelper.TypeDefinitionComparer.Equals(typeA, typeB);
         }
diff --git a/src/SMAPI/Framework/ModLoading/InvalidModStateException.cs b/src/SMAPI/Framework/ModLoading/InvalidModStateException.cs
index 9dca9bc4..b53a9886 100644
--- a/src/SMAPI/Framework/ModLoading/InvalidModStateException.cs
+++ b/src/SMAPI/Framework/ModLoading/InvalidModStateException.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework.ModLoading
@@ -10,7 +8,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Construct an instance.</summary>
         /// <param name="message">The error message.</param>
         /// <param name="ex">The underlying exception, if any.</param>
-        public InvalidModStateException(string message, Exception ex = null)
+        public InvalidModStateException(string message, Exception? ex = null)
             : base(message, ex) { }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index 0e698bfd..fe54634b 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using StardewModdingAPI.Framework.ModHelpers;
@@ -44,7 +43,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         public IManifest Manifest { get; }
 
         /// <inheritdoc />
-        public ModDataRecordVersionedFields DataRecord { get; }
+        public ModDataRecordVersionedFields? DataRecord { get; }
 
         /// <inheritdoc />
         public ModMetadataStatus Status { get; private set; }
@@ -56,33 +55,35 @@ namespace StardewModdingAPI.Framework.ModLoading
         public ModWarning Warnings => this.ActualWarnings & ~(this.DataRecord?.DataRecord.SuppressWarnings ?? ModWarning.None);
 
         /// <inheritdoc />
-        public string Error { get; private set; }
+        public string? Error { get; private set; }
 
         /// <inheritdoc />
-        public string ErrorDetails { get; private set; }
+        public string? ErrorDetails { get; private set; }
 
         /// <inheritdoc />
         public bool IsIgnored { get; }
 
         /// <inheritdoc />
-        public IMod Mod { get; private set; }
+        public IMod? Mod { get; private set; }
 
         /// <inheritdoc />
-        public IContentPack ContentPack { get; private set; }
+        public IContentPack? ContentPack { get; private set; }
 
         /// <inheritdoc />
-        public TranslationHelper Translations { get; private set; }
+        public TranslationHelper? Translations { get; private set; }
 
         /// <inheritdoc />
-        public IMonitor Monitor { get; private set; }
+        public IMonitor? Monitor { get; private set; }
 
         /// <inheritdoc />
-        public object Api { get; private set; }
+        public object? Api { get; private set; }
 
         /// <inheritdoc />
-        public ModEntryModel UpdateCheckData { get; private set; }
+        public ModEntryModel? UpdateCheckData { get; private set; }
 
         /// <inheritdoc />
+        [MemberNotNullWhen(true, nameof(ModMetadata.ContentPack))]
+        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The manifest may be null for broken mods while loading.")]
         public bool IsContentPack => this.Manifest?.ContentPackFor != null;
 
         /// <summary>The fake content packs created by this mod, if any.</summary>
@@ -99,13 +100,13 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="manifest">The mod manifest.</param>
         /// <param name="dataRecord">Metadata about the mod from SMAPI's internal data (if any).</param>
         /// <param name="isIgnored">Whether the mod folder should be ignored. This should be <c>true</c> if it was found within a folder whose name starts with a dot.</param>
-        public ModMetadata(string displayName, string directoryPath, string rootPath, IManifest manifest, ModDataRecordVersionedFields dataRecord, bool isIgnored)
+        public ModMetadata(string displayName, string directoryPath, string rootPath, IManifest? manifest, ModDataRecordVersionedFields? dataRecord, bool isIgnored)
         {
             this.DisplayName = displayName;
             this.DirectoryPath = directoryPath;
             this.RootPath = rootPath;
             this.RelativeDirectoryPath = PathUtilities.GetRelativePath(this.RootPath, this.DirectoryPath);
-            this.Manifest = manifest;
+            this.Manifest = manifest!; // manifest may be null in low-level SMAPI code, but won't be null once it's received by mods via IModInfo
             this.DataRecord = dataRecord;
             this.IsIgnored = isIgnored;
 
@@ -121,7 +122,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         }
 
         /// <inheritdoc />
-        public IModMetadata SetStatus(ModMetadataStatus status, ModFailReason reason, string error, string errorDetails = null)
+        public IModMetadata SetStatus(ModMetadataStatus status, ModFailReason reason, string? error, string? errorDetails = null)
         {
             this.Status = status;
             this.FailReason = reason;
@@ -162,7 +163,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         }
 
         /// <inheritdoc />
-        public IModMetadata SetApi(object api)
+        public IModMetadata SetApi(object? api)
         {
             this.Api = api;
             return this;
@@ -176,6 +177,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         }
 
         /// <inheritdoc />
+        [MemberNotNullWhen(true, nameof(IModInfo.Manifest))]
         public bool HasManifest()
         {
             return this.Manifest != null;
@@ -190,7 +192,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         }
 
         /// <inheritdoc />
-        public bool HasID(string id)
+        public bool HasID(string? id)
         {
             return
                 this.HasID()
@@ -245,7 +247,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <inheritdoc />
         public string GetRelativePathWithRoot()
         {
-            string rootFolderName = Path.GetFileName(this.RootPath) ?? "";
+            string rootFolderName = Path.GetFileName(this.RootPath);
             return Path.Combine(rootFolderName, this.RelativeDirectoryPath);
         }
 
@@ -254,7 +256,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         {
             foreach (var reference in this.FakeContentPacks.ToArray())
             {
-                if (!reference.TryGetTarget(out ContentPack pack))
+                if (!reference.TryGetTarget(out ContentPack? pack))
                 {
                     this.FakeContentPacks.Remove(reference);
                     continue;
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
index c05005b8..afe38bfd 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/AccessToolsFacade.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -19,7 +17,7 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
         /*********
         ** Public methods
         *********/
-        public static ConstructorInfo DeclaredConstructor(Type type, Type[] parameters = null)
+        public static ConstructorInfo DeclaredConstructor(Type type, Type[]? parameters = null)
         {
             // Harmony 1.x matched both static and instance constructors
             return
@@ -27,7 +25,7 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
                 ?? AccessTools.DeclaredConstructor(type, parameters, searchForStatic: true);
         }
 
-        public static ConstructorInfo Constructor(Type type, Type[] parameters = null)
+        public static ConstructorInfo Constructor(Type type, Type[]? parameters = null)
         {
             // Harmony 1.x matched both static and instance constructors
             return
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
index fea8c100..9c8ba2b0 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -30,7 +28,8 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
             return new Harmony(id);
         }
 
-        public DynamicMethod Patch(MethodBase original, HarmonyMethod prefix = null, HarmonyMethod postfix = null, HarmonyMethod transpiler = null)
+        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "If the user passes a null original method, we let it fail in the underlying Harmony instance instead of handling it here.")]
+        public DynamicMethod Patch(MethodBase original, HarmonyMethod? prefix = null, HarmonyMethod? postfix = null, HarmonyMethod? transpiler = null)
         {
             // In Harmony 1.x you could target a virtual method that's not implemented by the
             // target type, but in Harmony 2.0 you need to target the concrete implementation.
@@ -60,7 +59,7 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
         /// <param name="prefix">The prefix method, if any.</param>
         /// <param name="postfix">The postfix method, if any.</param>
         /// <param name="transpiler">The transpiler method, if any.</param>
-        private string GetPatchTypesLabel(HarmonyMethod prefix = null, HarmonyMethod postfix = null, HarmonyMethod transpiler = null)
+        private string GetPatchTypesLabel(HarmonyMethod? prefix = null, HarmonyMethod? postfix = null, HarmonyMethod? transpiler = null)
         {
             var patchTypes = new List<string>();
 
@@ -76,7 +75,7 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
 
         /// <summary>Get a human-readable label for the method being patched.</summary>
         /// <param name="method">The method being patched.</param>
-        private string GetMethodLabel(MethodBase method)
+        private string GetMethodLabel(MethodBase? method)
         {
             return method != null
                 ? $"method {method.DeclaringType?.FullName}.{method.Name}"
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
index 93124591..2b1ca54b 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyMethodFacade.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
@@ -23,7 +21,7 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
             this.ImportMethodImpl(method);
         }
 
-        public HarmonyMethodFacade(Type type, string name, Type[] parameters = null)
+        public HarmonyMethodFacade(Type type, string name, Type[]? parameters = null)
         {
             this.ImportMethodImpl(AccessTools.Method(type, name, parameters));
         }
@@ -40,7 +38,7 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
             // internal code still handles null fine. For backwards compatibility, this bypasses
             // the new restriction when the mod hasn't been updated for Harmony 2.0 yet.
 
-            MethodInfo importMethod = typeof(HarmonyMethod).GetMethod("ImportMethod", BindingFlags.Instance | BindingFlags.NonPublic);
+            MethodInfo? importMethod = typeof(HarmonyMethod).GetMethod("ImportMethod", BindingFlags.Instance | BindingFlags.NonPublic);
             if (importMethod == null)
                 throw new InvalidOperationException("Can't find 'HarmonyMethod.ImportMethod' method");
             importMethod.Invoke(this, new object[] { methodInfo });
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
index 92397c58..aea490c8 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HarmonyRewriter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using HarmonyLib;
 using Mono.Cecil;
@@ -59,7 +57,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
             if (this.ShouldRewrite)
             {
                 // rewrite Harmony 1.x methods to Harmony 2.0
-                MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+                MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
                 if (this.TryRewriteMethodsToFacade(module, methodRef))
                 {
                     this.OnChanged();
@@ -67,7 +65,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
                 }
 
                 // rewrite renamed fields
-                FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
+                FieldReference? fieldRef = RewriteHelper.AsFieldReference(instruction);
                 if (fieldRef != null)
                 {
                     if (fieldRef.DeclaringType.FullName == "HarmonyLib.HarmonyMethod" && fieldRef.Name == "prioritiy")
@@ -95,13 +93,13 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /// <summary>Rewrite methods to use Harmony facades if needed.</summary>
         /// <param name="module">The assembly module containing the method reference.</param>
         /// <param name="methodRef">The method reference to map.</param>
-        private bool TryRewriteMethodsToFacade(ModuleDefinition module, MethodReference methodRef)
+        private bool TryRewriteMethodsToFacade(ModuleDefinition module, MethodReference? methodRef)
         {
             if (!this.ReplacedTypes)
                 return false; // not Harmony (or already using Harmony 2.0)
 
             // get facade type
-            Type toType = methodRef?.DeclaringType.FullName switch
+            Type? toType = methodRef?.DeclaringType.FullName switch
             {
                 "HarmonyLib.Harmony" => typeof(HarmonyInstanceFacade),
                 "HarmonyLib.AccessTools" => typeof(AccessToolsFacade),
@@ -112,9 +110,9 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
                 return false;
 
             // map if there's a matching method
-            if (RewriteHelper.HasMatchingSignature(toType, methodRef))
+            if (RewriteHelper.HasMatchingSignature(toType, methodRef!))
             {
-                methodRef.DeclaringType = module.ImportReference(toType);
+                methodRef!.DeclaringType = module.ImportReference(toType);
                 return true;
             }
 
@@ -139,7 +137,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         {
             string fullName = type.FullName.Replace("Harmony.", "HarmonyLib.");
             string targetName = typeof(Harmony).AssemblyQualifiedName!.Replace(typeof(Harmony).FullName!, fullName);
-            return Type.GetType(targetName, throwOnError: true);
+            return Type.GetType(targetName, throwOnError: true)!;
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
index fc06e779..9c6a3980 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicFieldRewriter.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -33,17 +32,17 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
             // get field ref
-            FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
+            FieldReference? fieldRef = RewriteHelper.AsFieldReference(instruction);
             if (fieldRef == null || !this.ShouldValidate(fieldRef.DeclaringType))
                 return false;
 
             // skip if not broken
-            FieldDefinition fieldDefinition = fieldRef.Resolve();
+            FieldDefinition? fieldDefinition = fieldRef.Resolve();
             if (fieldDefinition?.HasConstant == false)
                 return false;
 
             // rewrite if possible
-            TypeDefinition declaringType = fieldRef.DeclaringType.Resolve();
+            TypeDefinition? declaringType = fieldRef.DeclaringType.Resolve();
             bool isRead = instruction.OpCode == OpCodes.Ldsfld || instruction.OpCode == OpCodes.Ldfld;
             return
                 this.TryRewriteToProperty(module, instruction, fieldRef, declaringType, isRead)
@@ -56,7 +55,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         *********/
         /// <summary>Whether references to the given type should be validated.</summary>
         /// <param name="type">The type reference.</param>
-        private bool ShouldValidate(TypeReference type)
+        private bool ShouldValidate([NotNullWhen(true)] TypeReference? type)
         {
             return type != null && this.RewriteReferencesToAssemblies.Contains(type.Scope.Name);
         }
@@ -70,8 +69,8 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         private bool TryRewriteToProperty(ModuleDefinition module, Instruction instruction, FieldReference fieldRef, TypeDefinition declaringType, bool isRead)
         {
             // get equivalent property
-            PropertyDefinition property = declaringType?.Properties.FirstOrDefault(p => p.Name == fieldRef.Name);
-            MethodDefinition method = isRead ? property?.GetMethod : property?.SetMethod;
+            PropertyDefinition? property = declaringType?.Properties.FirstOrDefault(p => p.Name == fieldRef.Name);
+            MethodDefinition? method = isRead ? property?.GetMethod : property?.SetMethod;
             if (method == null)
                 return false;
 
@@ -86,14 +85,14 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /// <summary>Try rewriting the field into a matching const field.</summary>
         /// <param name="instruction">The CIL instruction to rewrite.</param>
         /// <param name="field">The field definition.</param>
-        private bool TryRewriteToConstField(Instruction instruction, FieldDefinition field)
+        private bool TryRewriteToConstField(Instruction instruction, FieldDefinition? field)
         {
             // must have been a static field read, and the new field must be const
             if (instruction.OpCode != OpCodes.Ldsfld || field?.HasConstant != true)
                 return false;
 
             // get opcode for value type
-            Instruction loadInstruction = RewriteHelper.GetLoadValueInstruction(field.Constant);
+            Instruction? loadInstruction = RewriteHelper.GetLoadValueInstruction(field.Constant);
             if (loadInstruction == null)
                 return false;
 
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
index 4860072c..601ecbbc 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/HeuristicMethodRewriter.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -33,7 +32,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
             // get method ref
-            MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+            MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
             if (methodRef == null || !this.ShouldValidate(methodRef.DeclaringType))
                 return false;
 
@@ -42,13 +41,13 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
                 return false;
 
             // get type
-            var type = methodRef.DeclaringType.Resolve();
+            TypeDefinition? type = methodRef.DeclaringType.Resolve();
             if (type == null)
                 return false;
 
             // get method definition
-            MethodDefinition method = null;
-            foreach (var match in type.Methods.Where(p => p.Name == methodRef.Name))
+            MethodDefinition? method = null;
+            foreach (MethodDefinition match in type.Methods.Where(p => p.Name == methodRef.Name))
             {
                 // reference matches initial parameters of definition
                 if (methodRef.Parameters.Count >= match.Parameters.Count || !this.InitialParametersMatch(methodRef, match))
@@ -72,7 +71,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
                 return false; // SMAPI needs to load the value onto the stack before the method call, but the optional parameter type wasn't recognized
 
             // rewrite method reference
-            foreach (Instruction loadInstruction in loadInstructions)
+            foreach (Instruction? loadInstruction in loadInstructions)
                 cil.InsertBefore(instruction, loadInstruction);
             instruction.Operand = module.ImportReference(method);
 
@@ -86,7 +85,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         *********/
         /// <summary>Whether references to the given type should be validated.</summary>
         /// <param name="type">The type reference.</param>
-        private bool ShouldValidate(TypeReference type)
+        private bool ShouldValidate([NotNullWhen(true)] TypeReference? type)
         {
             return type != null && this.RewriteReferencesToAssemblies.Contains(type.Scope.Name);
         }
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
index 00daf337..2e2f6316 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/MethodParentRewriter.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -28,7 +27,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /// <param name="fromType">The type whose methods to remap.</param>
         /// <param name="toType">The type with methods to map to.</param>
         /// <param name="nounPhrase">A brief noun phrase indicating what the instruction finder matches (or <c>null</c> to generate one).</param>
-        public MethodParentRewriter(string fromType, Type toType, string nounPhrase = null)
+        public MethodParentRewriter(string fromType, Type toType, string? nounPhrase = null)
             : base(nounPhrase ?? $"{fromType.Split('.').Last()} methods")
         {
             this.FromType = fromType;
@@ -39,14 +38,14 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /// <param name="fromType">The type whose methods to remap.</param>
         /// <param name="toType">The type with methods to map to.</param>
         /// <param name="nounPhrase">A brief noun phrase indicating what the instruction finder matches (or <c>null</c> to generate one).</param>
-        public MethodParentRewriter(Type fromType, Type toType, string nounPhrase = null)
-            : this(fromType.FullName, toType, nounPhrase) { }
+        public MethodParentRewriter(Type fromType, Type toType, string? nounPhrase = null)
+            : this(fromType.FullName!, toType, nounPhrase) { }
 
         /// <inheritdoc />
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
             // get method ref
-            MethodReference methodRef = RewriteHelper.AsMethodReference(instruction);
+            MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
             if (!this.IsMatch(methodRef))
                 return false;
 
@@ -61,7 +60,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         *********/
         /// <summary>Get whether a CIL instruction matches.</summary>
         /// <param name="methodRef">The method reference.</param>
-        private bool IsMatch(MethodReference methodRef)
+        private bool IsMatch([NotNullWhen(true)] MethodReference? methodRef)
         {
             return
                 methodRef != null
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
index bdc4c4f3..a81cb5be 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/TypeReferenceRewriter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
@@ -19,7 +17,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         private readonly Type ToType;
 
         /// <summary>Get whether a matched type should be ignored.</summary>
-        private readonly Func<TypeReference, bool> ShouldIgnore;
+        private readonly Func<TypeReference, bool>? ShouldIgnore;
 
 
         /*********
@@ -29,7 +27,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /// <param name="fromTypeFullName">The full type name to which to find references.</param>
         /// <param name="toType">The new type to reference.</param>
         /// <param name="shouldIgnore">Get whether a matched type should be ignored.</param>
-        public TypeReferenceRewriter(string fromTypeFullName, Type toType, Func<TypeReference, bool> shouldIgnore = null)
+        public TypeReferenceRewriter(string fromTypeFullName, Type toType, Func<TypeReference, bool>? shouldIgnore = null)
             : base($"{fromTypeFullName} type")
         {
             this.FromTypeName = fromTypeFullName;
diff --git a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
index 4af7c1e7..0d3aff9f 100644
--- a/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
+++ b/src/SMAPI/Framework/ModLoading/Symbols/SymbolReaderProvider.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -38,7 +36,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Symbols
         /// <param name="fileName">The assembly file name.</param>
         public ISymbolReader GetSymbolReader(ModuleDefinition module, string fileName)
         {
-            return this.SymbolsByAssemblyPath.TryGetValue(module.Name, out Stream symbolData)
+            return this.SymbolsByAssemblyPath.TryGetValue(module.Name, out Stream? symbolData)
                 ? new SymbolReader(module, symbolData)
                 : this.BaseProvider.GetSymbolReader(module, fileName);
         }
@@ -48,7 +46,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Symbols
         /// <param name="symbolStream">The loaded symbol file stream.</param>
         public ISymbolReader GetSymbolReader(ModuleDefinition module, Stream symbolStream)
         {
-            return this.SymbolsByAssemblyPath.TryGetValue(module.Name, out Stream symbolData)
+            return this.SymbolsByAssemblyPath.TryGetValue(module.Name, out Stream? symbolData)
                 ? new SymbolReader(module, symbolData)
                 : this.BaseProvider.GetSymbolReader(module, symbolStream);
         }
diff --git a/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs b/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
index 248c29fc..d81d763e 100644
--- a/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
+++ b/src/SMAPI/Framework/ModLoading/TypeReferenceComparer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -18,7 +16,7 @@ namespace StardewModdingAPI.Framework.ModLoading
     /// <c>TKey</c> in the above example). If all components are equal after substitution, and the
     /// tokens can all be mapped to the same generic type, the types are considered equal.
     /// </remarks>
-    internal class TypeReferenceComparer : IEqualityComparer<TypeReference>
+    internal class TypeReferenceComparer : IEqualityComparer<TypeReference?>
     {
         /*********
         ** Public methods
@@ -26,7 +24,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Get whether the specified objects are equal.</summary>
         /// <param name="a">The first object to compare.</param>
         /// <param name="b">The second object to compare.</param>
-        public bool Equals(TypeReference a, TypeReference b)
+        public bool Equals(TypeReference? a, TypeReference? b)
         {
             if (a == null || b == null)
                 return a == b;
@@ -54,7 +52,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="typeB">The second type to compare.</param>
         private bool HeuristicallyEquals(TypeReference typeA, TypeReference typeB)
         {
-            bool HeuristicallyEquals(string typeNameA, string typeNameB, IDictionary<string, string> tokenMap)
+            bool HeuristicallyEqualsImpl(string typeNameA, string typeNameB, IDictionary<string, string> tokenMap)
             {
                 // analyze type names
                 bool hasTokensA = typeNameA.Contains("!");
@@ -82,14 +80,14 @@ namespace StardewModdingAPI.Framework.ModLoading
 
                 for (int i = 0; i < symbolsA.Length; i++)
                 {
-                    if (!HeuristicallyEquals(symbolsA[i], symbolsB[i], tokenMap))
+                    if (!HeuristicallyEqualsImpl(symbolsA[i], symbolsB[i], tokenMap))
                         return false;
                 }
 
                 return true;
             }
 
-            return HeuristicallyEquals(typeA.FullName, typeB.FullName, new Dictionary<string, string>());
+            return HeuristicallyEqualsImpl(typeA.FullName, typeB.FullName, new Dictionary<string, string>());
         }
 
         /// <summary>Map a generic type placeholder (like <c>!0</c>) to its actual type.</summary>
@@ -99,7 +97,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <returns>Returns the previously-mapped type if applicable, else the <paramref name="type"/>.</returns>
         private string MapPlaceholder(string placeholder, string type, IDictionary<string, string> map)
         {
-            if (map.TryGetValue(placeholder, out string result))
+            if (map.TryGetValue(placeholder, out string? result))
                 return result;
 
             map[placeholder] = type;
diff --git a/src/SMAPI/Framework/ModRegistry.cs b/src/SMAPI/Framework/ModRegistry.cs
index cae38637..de16a780 100644
--- a/src/SMAPI/Framework/ModRegistry.cs
+++ b/src/SMAPI/Framework/ModRegistry.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -42,7 +40,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="modAssembly">The mod assembly.</param>
         public void TrackAssemblies(IModMetadata metadata, Assembly modAssembly)
         {
-            this.ModNamesByAssembly[modAssembly.FullName] = metadata;
+            this.ModNamesByAssembly[modAssembly.FullName!] = metadata;
         }
 
         /// <summary>Get metadata for all loaded mods.</summary>
@@ -62,7 +60,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get metadata for a loaded mod.</summary>
         /// <param name="uniqueID">The mod's unique ID.</param>
         /// <returns>Returns the matching mod's metadata, or <c>null</c> if not found.</returns>
-        public IModMetadata Get(string uniqueID)
+        public IModMetadata? Get(string uniqueID)
         {
             // normalize search ID
             if (string.IsNullOrWhiteSpace(uniqueID))
@@ -76,14 +74,14 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get the mod metadata from one of its assemblies.</summary>
         /// <param name="type">The type to check.</param>
         /// <returns>Returns the mod name, or <c>null</c> if the type isn't part of a known mod.</returns>
-        public IModMetadata GetFrom(Type type)
+        public IModMetadata? GetFrom(Type? type)
         {
             // null
             if (type == null)
                 return null;
 
             // known type
-            string assemblyName = type.Assembly.FullName;
+            string assemblyName = type.Assembly.FullName!;
             if (this.ModNamesByAssembly.ContainsKey(assemblyName))
                 return this.ModNamesByAssembly[assemblyName];
 
@@ -93,7 +91,7 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Get the friendly name for the closest assembly registered as a source of deprecation warnings.</summary>
         /// <returns>Returns the source name, or <c>null</c> if no registered assemblies were found.</returns>
-        public IModMetadata GetFromStack()
+        public IModMetadata? GetFromStack()
         {
             // get stack frames
             StackTrace stack = new();
@@ -102,8 +100,8 @@ namespace StardewModdingAPI.Framework
             // search stack for a source assembly
             foreach (StackFrame frame in frames)
             {
-                MethodBase method = frame.GetMethod();
-                IModMetadata mod = this.GetFrom(method.ReflectedType);
+                MethodBase? method = frame.GetMethod();
+                IModMetadata? mod = this.GetFrom(method?.ReflectedType);
                 if (mod != null)
                     return mod;
             }
diff --git a/src/SMAPI/Framework/Reflection/ReflectedField.cs b/src/SMAPI/Framework/Reflection/ReflectedField.cs
index 921876b9..197a246e 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedField.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedField.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 
@@ -15,8 +13,8 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <summary>The type that has the field.</summary>
         private readonly Type ParentType;
 
-        /// <summary>The object that has the instance field (if applicable).</summary>
-        private readonly object Parent;
+        /// <summary>The object that has the instance field, or <c>null</c> for a static field.</summary>
+        private readonly object? Parent;
 
         /// <summary>The display name shown in error messages.</summary>
         private string DisplayName => $"{this.ParentType.FullName}::{this.FieldInfo.Name}";
@@ -34,12 +32,12 @@ namespace StardewModdingAPI.Framework.Reflection
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="parentType">The type that has the field.</param>
-        /// <param name="obj">The object that has the instance field (if applicable).</param>
+        /// <param name="obj">The object that has the instance field, or <c>null</c> for a static field.</param>
         /// <param name="field">The reflection metadata.</param>
         /// <param name="isStatic">Whether the field is static.</param>
         /// <exception cref="ArgumentNullException">The <paramref name="parentType"/> or <paramref name="field"/> is null.</exception>
         /// <exception cref="ArgumentException">The <paramref name="obj"/> is null for a non-static field, or not null for a static field.</exception>
-        public ReflectedField(Type parentType, object obj, FieldInfo field, bool isStatic)
+        public ReflectedField(Type parentType, object? obj, FieldInfo field, bool isStatic)
         {
             // validate
             if (parentType == null)
@@ -58,11 +56,11 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public TValue GetValue()
+        public TValue? GetValue()
         {
             try
             {
-                return (TValue)this.FieldInfo.GetValue(this.Parent);
+                return (TValue?)this.FieldInfo.GetValue(this.Parent);
             }
             catch (InvalidCastException)
             {
@@ -75,7 +73,7 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public void SetValue(TValue value)
+        public void SetValue(TValue? value)
         {
             try
             {
diff --git a/src/SMAPI/Framework/Reflection/ReflectedMethod.cs b/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
index 50f89b40..c245e843 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 
@@ -14,8 +12,8 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <summary>The type that has the method.</summary>
         private readonly Type ParentType;
 
-        /// <summary>The object that has the instance method (if applicable).</summary>
-        private readonly object Parent;
+        /// <summary>The object that has the instance method, or <c>null</c> for a static method.</summary>
+        private readonly object? Parent;
 
         /// <summary>The display name shown in error messages.</summary>
         private string DisplayName => $"{this.ParentType.FullName}::{this.MethodInfo.Name}";
@@ -33,12 +31,12 @@ namespace StardewModdingAPI.Framework.Reflection
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="parentType">The type that has the method.</param>
-        /// <param name="obj">The object that has the instance method(if applicable).</param>
+        /// <param name="obj">The object that has the instance method, or <c>null</c> for a static method.</param>
         /// <param name="method">The reflection metadata.</param>
         /// <param name="isStatic">Whether the method is static.</param>
         /// <exception cref="ArgumentNullException">The <paramref name="parentType"/> or <paramref name="method"/> is null.</exception>
         /// <exception cref="ArgumentException">The <paramref name="obj"/> is null for a non-static method, or not null for a static method.</exception>
-        public ReflectedMethod(Type parentType, object obj, MethodInfo method, bool isStatic)
+        public ReflectedMethod(Type parentType, object? obj, MethodInfo method, bool isStatic)
         {
             // validate
             if (parentType == null)
@@ -57,10 +55,10 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public TValue Invoke<TValue>(params object[] arguments)
+        public TValue? Invoke<TValue>(params object?[] arguments)
         {
             // invoke method
-            object result;
+            object? result;
             try
             {
                 result = this.MethodInfo.Invoke(this.Parent, arguments);
@@ -77,7 +75,7 @@ namespace StardewModdingAPI.Framework.Reflection
             // cast return value
             try
             {
-                return (TValue)result;
+                return (TValue?)result;
             }
             catch (InvalidCastException)
             {
@@ -86,7 +84,7 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public void Invoke(params object[] arguments)
+        public void Invoke(params object?[] arguments)
         {
             // invoke method
             try
diff --git a/src/SMAPI/Framework/Reflection/ReflectedProperty.cs b/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
index a6d8c75c..638953a3 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 
@@ -16,10 +14,10 @@ namespace StardewModdingAPI.Framework.Reflection
         private readonly string DisplayName;
 
         /// <summary>The underlying property getter.</summary>
-        private readonly Func<TValue> GetMethod;
+        private readonly Func<TValue?>? GetMethod;
 
         /// <summary>The underlying property setter.</summary>
-        private readonly Action<TValue> SetMethod;
+        private readonly Action<TValue?>? SetMethod;
 
 
         /*********
@@ -34,12 +32,12 @@ namespace StardewModdingAPI.Framework.Reflection
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="parentType">The type that has the property.</param>
-        /// <param name="obj">The object that has the instance property (if applicable).</param>
+        /// <param name="obj">The object that has the instance property, or <c>null</c> for a static property.</param>
         /// <param name="property">The reflection metadata.</param>
         /// <param name="isStatic">Whether the property is static.</param>
         /// <exception cref="ArgumentNullException">The <paramref name="parentType"/> or <paramref name="property"/> is null.</exception>
         /// <exception cref="ArgumentException">The <paramref name="obj"/> is null for a non-static property, or not null for a static property.</exception>
-        public ReflectedProperty(Type parentType, object obj, PropertyInfo property, bool isStatic)
+        public ReflectedProperty(Type parentType, object? obj, PropertyInfo property, bool isStatic)
         {
             // validate input
             if (parentType == null)
@@ -58,13 +56,13 @@ namespace StardewModdingAPI.Framework.Reflection
             this.PropertyInfo = property;
 
             if (this.PropertyInfo.GetMethod != null)
-                this.GetMethod = (Func<TValue>)Delegate.CreateDelegate(typeof(Func<TValue>), obj, this.PropertyInfo.GetMethod);
+                this.GetMethod = (Func<TValue?>)Delegate.CreateDelegate(typeof(Func<TValue?>), obj, this.PropertyInfo.GetMethod);
             if (this.PropertyInfo.SetMethod != null)
-                this.SetMethod = (Action<TValue>)Delegate.CreateDelegate(typeof(Action<TValue>), obj, this.PropertyInfo.SetMethod);
+                this.SetMethod = (Action<TValue?>)Delegate.CreateDelegate(typeof(Action<TValue?>), obj, this.PropertyInfo.SetMethod);
         }
 
         /// <inheritdoc />
-        public TValue GetValue()
+        public TValue? GetValue()
         {
             if (this.GetMethod == null)
                 throw new InvalidOperationException($"The {this.DisplayName} property has no get method.");
@@ -84,7 +82,7 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public void SetValue(TValue value)
+        public void SetValue(TValue? value)
         {
             if (this.SetMethod == null)
                 throw new InvalidOperationException($"The {this.DisplayName} property has no set method.");
diff --git a/src/SMAPI/Framework/Rendering/SDisplayDevice.cs b/src/SMAPI/Framework/Rendering/SDisplayDevice.cs
index 8718bcb1..37996b0f 100644
--- a/src/SMAPI/Framework/Rendering/SDisplayDevice.cs
+++ b/src/SMAPI/Framework/Rendering/SDisplayDevice.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Content;
@@ -27,7 +25,7 @@ namespace StardewModdingAPI.Framework.Rendering
         /// <param name="tile">The tile to draw.</param>
         /// <param name="location">The tile position to draw.</param>
         /// <param name="layerDepth">The layer depth at which to draw.</param>
-        public override void DrawTile(Tile tile, Location location, float layerDepth)
+        public override void DrawTile(Tile? tile, Location location, float layerDepth)
         {
             // identical to XnaDisplayDevice
             if (tile == null)
@@ -58,7 +56,7 @@ namespace StardewModdingAPI.Framework.Rendering
         /// <param name="tile">The tile being drawn.</param>
         private SpriteEffects GetSpriteEffects(Tile tile)
         {
-            return tile.Properties.TryGetValue("@Flip", out PropertyValue propertyValue) && int.TryParse(propertyValue, out int value)
+            return tile.Properties.TryGetValue("@Flip", out PropertyValue? propertyValue) && int.TryParse(propertyValue, out int value)
                 ? (SpriteEffects)value
                 : SpriteEffects.None;
         }
@@ -67,7 +65,7 @@ namespace StardewModdingAPI.Framework.Rendering
         /// <param name="tile">The tile being drawn.</param>
         private float GetRotation(Tile tile)
         {
-            if (!tile.Properties.TryGetValue("@Rotation", out PropertyValue propertyValue) || !int.TryParse(propertyValue, out int value))
+            if (!tile.Properties.TryGetValue("@Rotation", out PropertyValue? propertyValue) || !int.TryParse(propertyValue, out int value))
                 return 0;
 
             value %= 360;
diff --git a/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs b/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
index 21edaedd..94b13378 100644
--- a/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
+++ b/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -91,7 +89,7 @@ namespace StardewModdingAPI.Framework.Rendering
         /// <param name="tile">The tile to draw.</param>
         /// <param name="location">The tile position to draw.</param>
         /// <param name="layerDepth">The layer depth at which to draw.</param>
-        public virtual void DrawTile(Tile tile, Location location, float layerDepth)
+        public virtual void DrawTile(Tile? tile, Location location, float layerDepth)
         {
             if (tile == null)
                 return;
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 7ca89eec..4fa7fe7b 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.ObjectModel;
 using System.Diagnostics.CodeAnalysis;
@@ -48,10 +46,10 @@ namespace StardewModdingAPI.Framework
         private readonly Action<string> ExitGameImmediately;
 
         /// <summary>The initial override for <see cref="Input"/>. This value is null after initialization.</summary>
-        private SInputState InitialInput;
+        private SInputState? InitialInput;
 
         /// <summary>The initial override for <see cref="Multiplayer"/>. This value is null after initialization.</summary>
-        private SMultiplayer InitialMultiplayer;
+        private SMultiplayer? InitialMultiplayer;
 
         /// <summary>Raised when the instance is updating its state (roughly 60 times per second).</summary>
         private readonly Action<SGame, GameTime, Action> OnUpdating;
@@ -70,7 +68,7 @@ namespace StardewModdingAPI.Framework
         public Task NewDayTask => Game1._newDayTask;
 
         /// <summary>Monitors the entire game state for changes.</summary>
-        public WatcherCore Watchers { get; private set; }
+        public WatcherCore Watchers { get; private set; } = null!; // initialized on first update tick
 
         /// <summary>A snapshot of the current <see cref="Watchers"/> state.</summary>
         public WatcherSnapshot WatcherSnapshot { get; } = new();
@@ -94,7 +92,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Construct a content manager to read game content files.</summary>
         /// <remarks>This must be static because the game accesses it before the <see cref="SGame"/> constructor is called.</remarks>
         [NonInstancedStatic]
-        public static Func<IServiceProvider, string, LocalizedContentManager> CreateContentManagerImpl;
+        public static Func<IServiceProvider, string, LocalizedContentManager>? CreateContentManagerImpl;
 
 
         /*********
@@ -138,11 +136,10 @@ namespace StardewModdingAPI.Framework
         /// <remarks>This is intended for use by <see cref="Keybind"/> and shouldn't be used directly in most cases.</remarks>
         internal static SButtonState GetInputState(SButton button)
         {
-            SInputState input = Game1.input as SInputState;
-            if (input == null)
+            if (Game1.input is not SInputState inputHandler)
                 throw new InvalidOperationException("SMAPI's input state is not in a ready state yet.");
 
-            return input.GetState(button);
+            return inputHandler.GetState(button);
         }
 
         /// <inheritdoc />
@@ -172,13 +169,11 @@ namespace StardewModdingAPI.Framework
         {
             base.Initialize();
 
-            // The game resets public static fields after the class is constructed (see
-            // GameRunner.SetInstanceDefaults), so SMAPI needs to re-override them here.
+            // The game resets public static fields after the class is constructed (see GameRunner.SetInstanceDefaults), so SMAPI needs to re-override them here.
             Game1.input = this.InitialInput;
             Game1.multiplayer = this.InitialMultiplayer;
 
-            // The Initial* fields should no longer be used after this point, since mods may
-            // further override them after initialization.
+            // The Initial* fields should no longer be used after this point, since mods may further override them after initialization.
             this.InitialInput = null;
             this.InitialMultiplayer = null;
         }
@@ -251,6 +246,7 @@ namespace StardewModdingAPI.Framework
             Context.IsInDrawLoop = false;
         }
 
+#nullable disable
         /// <summary>Replicate the game's draw logic with some changes for SMAPI.</summary>
         /// <param name="gameTime">A snapshot of the game timing state.</param>
         /// <param name="target_screen">The render target, if any.</param>
@@ -258,6 +254,7 @@ namespace StardewModdingAPI.Framework
         [SuppressMessage("ReSharper", "CompareOfFloatsByEqualityOperator", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "LocalVariableHidesMember", Justification = "copied from game code as-is")]
+        [SuppressMessage("ReSharper", "MergeIntoPattern", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "PossibleLossOfFraction", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantArgumentDefaultValue", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantBaseQualifier", Justification = "copied from game code as-is")]
@@ -265,8 +262,9 @@ namespace StardewModdingAPI.Framework
         [SuppressMessage("ReSharper", "RedundantExplicitNullableCreation", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantTypeArgumentsOfMethod", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "copied from game code as-is")]
-        [SuppressMessage("SMAPI.CommonErrors", "AvoidNetField", Justification = "copied from game code as-is")]
+        [SuppressMessage("ReSharper", "MergeIntoPattern", Justification = "copied from game code as-is")]
         [SuppressMessage("SMAPI.CommonErrors", "AvoidImplicitNetFieldCast", Justification = "copied from game code as-is")]
+        [SuppressMessage("SMAPI.CommonErrors", "AvoidNetField", Justification = "copied from game code as-is")]
         private void DrawImpl(GameTime gameTime, RenderTarget2D target_screen)
         {
             var events = this.Events;
@@ -952,5 +950,6 @@ namespace StardewModdingAPI.Framework
             this.drawOverlays(Game1.spriteBatch);
             Game1.PopUIMode();
         }
+#nullable enable
     }
 }
diff --git a/src/SMAPI/Framework/SModHooks.cs b/src/SMAPI/Framework/SModHooks.cs
index 7941e102..a7736c8b 100644
--- a/src/SMAPI/Framework/SModHooks.cs
+++ b/src/SMAPI/Framework/SModHooks.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Threading.Tasks;
 using StardewValley;
@@ -35,7 +33,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="action">The vanilla <see cref="Game1.newDayAfterFade"/> logic.</param>
         public override void OnGame1_NewDayAfterFade(Action action)
         {
-            this.BeforeNewDayAfterFade?.Invoke();
+            this.BeforeNewDayAfterFade();
             action();
         }
 
diff --git a/src/SMAPI/Framework/SnapshotDiff.cs b/src/SMAPI/Framework/SnapshotDiff.cs
index eb2aebe1..d659d2b4 100644
--- a/src/SMAPI/Framework/SnapshotDiff.cs
+++ b/src/SMAPI/Framework/SnapshotDiff.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using StardewModdingAPI.Framework.StateTracking;
 
 namespace StardewModdingAPI.Framework
@@ -15,10 +13,10 @@ namespace StardewModdingAPI.Framework
         public bool IsChanged { get; private set; }
 
         /// <summary>The previous value.</summary>
-        public T Old { get; private set; }
+        public T? Old { get; private set; }
 
         /// <summary>The current value.</summary>
-        public T New { get; private set; }
+        public T? New { get; private set; }
 
 
         /*********
diff --git a/src/SMAPI/Framework/SnapshotItemListDiff.cs b/src/SMAPI/Framework/SnapshotItemListDiff.cs
index 97942783..76060db2 100644
--- a/src/SMAPI/Framework/SnapshotItemListDiff.cs
+++ b/src/SMAPI/Framework/SnapshotItemListDiff.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Events;
 using StardewValley;
@@ -48,7 +47,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="stackSizes">The items with their previous stack sizes.</param>
         /// <param name="changes">The inventory changes, or <c>null</c> if nothing changed.</param>
         /// <returns>Returns whether anything changed.</returns>
-        public static bool TryGetChanges(ISet<Item> added, ISet<Item> removed, IDictionary<Item, int> stackSizes, out SnapshotItemListDiff changes)
+        public static bool TryGetChanges(ISet<Item> added, ISet<Item> removed, IDictionary<Item, int> stackSizes, [NotNullWhen(true)] out SnapshotItemListDiff? changes)
         {
             KeyValuePair<Item, int>[] sizesChanged = stackSizes.Where(p => p.Key.Stack != p.Value).ToArray();
             if (sizesChanged.Any() || added.Any() || removed.Any())
diff --git a/src/SMAPI/Framework/SnapshotListDiff.cs b/src/SMAPI/Framework/SnapshotListDiff.cs
index 1d585c15..90066af1 100644
--- a/src/SMAPI/Framework/SnapshotListDiff.cs
+++ b/src/SMAPI/Framework/SnapshotListDiff.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.StateTracking;
 
@@ -39,7 +37,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="isChanged">Whether the value changed since the last update.</param>
         /// <param name="removed">The removed values.</param>
         /// <param name="added">The added values.</param>
-        public void Update(bool isChanged, IEnumerable<T> removed, IEnumerable<T> added)
+        public void Update(bool isChanged, IEnumerable<T>? removed, IEnumerable<T>? added)
         {
             this.IsChanged = isChanged;
 
diff --git a/src/SMAPI/Framework/StateTracking/ChestTracker.cs b/src/SMAPI/Framework/StateTracking/ChestTracker.cs
index 28335200..c33a7498 100644
--- a/src/SMAPI/Framework/StateTracking/ChestTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/ChestTracker.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Framework.StateTracking.Comparers;
 using StardewModdingAPI.Framework.StateTracking.FieldWatchers;
@@ -86,7 +85,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         /// <summary>Get the inventory changes since the last update, if anything changed.</summary>
         /// <param name="changes">The inventory changes, or <c>null</c> if nothing changed.</param>
         /// <returns>Returns whether anything changed.</returns>
-        public bool TryGetInventoryChanges(out SnapshotItemListDiff changes)
+        public bool TryGetInventoryChanges([NotNullWhen(true)] out SnapshotItemListDiff? changes)
         {
             return SnapshotItemListDiff.TryGetChanges(added: this.Added, removed: this.Removed, stackSizes: this.StackSizes, out changes);
         }
diff --git a/src/SMAPI/Framework/StateTracking/Comparers/EquatableComparer.cs b/src/SMAPI/Framework/StateTracking/Comparers/EquatableComparer.cs
index 987e1820..9d8559b4 100644
--- a/src/SMAPI/Framework/StateTracking/Comparers/EquatableComparer.cs
+++ b/src/SMAPI/Framework/StateTracking/Comparers/EquatableComparer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Runtime.CompilerServices;
@@ -17,7 +15,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Comparers
         /// <returns>true if the specified objects are equal; otherwise, false.</returns>
         /// <param name="x">The first object to compare.</param>
         /// <param name="y">The second object to compare.</param>
-        public bool Equals(T x, T y)
+        public bool Equals(T? x, T? y)
         {
             if (x == null)
                 return y == null;
diff --git a/src/SMAPI/Framework/StateTracking/Comparers/GenericEqualsComparer.cs b/src/SMAPI/Framework/StateTracking/Comparers/GenericEqualsComparer.cs
index f6b04583..41b17e10 100644
--- a/src/SMAPI/Framework/StateTracking/Comparers/GenericEqualsComparer.cs
+++ b/src/SMAPI/Framework/StateTracking/Comparers/GenericEqualsComparer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Runtime.CompilerServices;
 
@@ -16,7 +14,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Comparers
         /// <returns>true if the specified objects are equal; otherwise, false.</returns>
         /// <param name="x">The first object to compare.</param>
         /// <param name="y">The second object to compare.</param>
-        public bool Equals(T x, T y)
+        public bool Equals(T? x, T? y)
         {
             if (x == null)
                 return y == null;
diff --git a/src/SMAPI/Framework/StateTracking/Comparers/ObjectReferenceComparer.cs b/src/SMAPI/Framework/StateTracking/Comparers/ObjectReferenceComparer.cs
index 8d3a7eb9..e6ece854 100644
--- a/src/SMAPI/Framework/StateTracking/Comparers/ObjectReferenceComparer.cs
+++ b/src/SMAPI/Framework/StateTracking/Comparers/ObjectReferenceComparer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Runtime.CompilerServices;
 
@@ -16,7 +14,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Comparers
         /// <returns>true if the specified objects are equal; otherwise, false.</returns>
         /// <param name="x">The first object to compare.</param>
         /// <param name="y">The second object to compare.</param>
-        public bool Equals(T x, T y)
+        public bool Equals(T? x, T? y)
         {
             return object.ReferenceEquals(x, y);
         }
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
index 0d7f2ad2..f55e4cea 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using Netcode;
 
@@ -12,6 +10,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
     /// <typeparam name="TSerialDict">The serializable dictionary type that can store the keys and values.</typeparam>
     /// <typeparam name="TSelf">The net field instance type.</typeparam>
     internal class NetDictionaryWatcher<TKey, TValue, TField, TSerialDict, TSelf> : BaseDisposableWatcher, IDictionaryWatcher<TKey, TValue>
+        where TKey : notnull
         where TField : class, INetObject<INetSerializable>, new()
         where TSerialDict : IDictionary<TKey, TValue>, new()
         where TSelf : NetDictionary<TKey, TValue, TField, TSerialDict, TSelf>
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
index 82e5387e..97aedca8 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using System.Collections.Specialized;
@@ -81,7 +79,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <summary>A callback invoked when an entry is added or removed from the collection.</summary>
         /// <param name="sender">The event sender.</param>
         /// <param name="e">The event arguments.</param>
-        private void OnCollectionChanged(object sender, NotifyCollectionChangedEventArgs e)
+        private void OnCollectionChanged(object? sender, NotifyCollectionChangedEventArgs e)
         {
             if (e.Action == NotifyCollectionChangedAction.Reset)
             {
@@ -90,8 +88,8 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             }
             else
             {
-                TValue[] added = e.NewItems?.Cast<TValue>().ToArray();
-                TValue[] removed = e.OldItems?.Cast<TValue>().ToArray();
+                TValue[]? added = e.NewItems?.Cast<TValue>().ToArray();
+                TValue[]? removed = e.OldItems?.Cast<TValue>().ToArray();
 
                 if (removed != null)
                 {
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
index 0b99914c..c4a4d0b9 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
@@ -20,7 +18,8 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <summary>Get a watcher which compares values using their <see cref="object.Equals(object)"/> method. This method should only be used when <see cref="ForEquatable{T}"/> won't work, since this doesn't validate whether they're comparable.</summary>
         /// <typeparam name="T">The value type.</typeparam>
         /// <param name="getValue">Get the current value.</param>
-        public static IValueWatcher<T> ForGenericEquality<T>(Func<T> getValue) where T : struct
+        public static IValueWatcher<T> ForGenericEquality<T>(Func<T> getValue)
+            where T : struct
         {
             return new ComparableWatcher<T>(getValue, new GenericEqualsComparer<T>());
         }
@@ -28,7 +27,8 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <summary>Get a watcher for an <see cref="IEquatable{T}"/> value.</summary>
         /// <typeparam name="T">The value type.</typeparam>
         /// <param name="getValue">Get the current value.</param>
-        public static IValueWatcher<T> ForEquatable<T>(Func<T> getValue) where T : IEquatable<T>
+        public static IValueWatcher<T> ForEquatable<T>(Func<T> getValue)
+            where T : IEquatable<T>
         {
             return new ComparableWatcher<T>(getValue, new EquatableComparer<T>());
         }
@@ -79,7 +79,8 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <summary>Get a watcher for a net collection.</summary>
         /// <typeparam name="T">The value type.</typeparam>
         /// <param name="collection">The net collection.</param>
-        public static ICollectionWatcher<T> ForNetCollection<T>(NetCollection<T> collection) where T : class, INetObject<INetSerializable>
+        public static ICollectionWatcher<T> ForNetCollection<T>(NetCollection<T> collection)
+            where T : class, INetObject<INetSerializable>
         {
             return new NetCollectionWatcher<T>(collection);
         }
@@ -87,7 +88,8 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <summary>Get a watcher for a net list.</summary>
         /// <typeparam name="T">The value type.</typeparam>
         /// <param name="collection">The net list.</param>
-        public static ICollectionWatcher<T> ForNetList<T>(NetList<T, NetRef<T>> collection) where T : class, INetObject<INetSerializable>
+        public static ICollectionWatcher<T> ForNetList<T>(NetList<T, NetRef<T>> collection)
+            where T : class, INetObject<INetSerializable>
         {
             return new NetListWatcher<T>(collection);
         }
@@ -100,6 +102,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <typeparam name="TSelf">The net field instance type.</typeparam>
         /// <param name="field">The net field.</param>
         public static NetDictionaryWatcher<TKey, TValue, TField, TSerialDict, TSelf> ForNetDictionary<TKey, TValue, TField, TSerialDict, TSelf>(NetDictionary<TKey, TValue, TField, TSerialDict, TSelf> field)
+            where TKey : notnull
             where TField : class, INetObject<INetSerializable>, new()
             where TSerialDict : IDictionary<TKey, TValue>, new()
             where TSelf : NetDictionary<TKey, TValue, TField, TSerialDict, TSelf>
diff --git a/src/SMAPI/Framework/StateTracking/LocationTracker.cs b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
index 9c2ff7f0..ff72a19b 100644
--- a/src/SMAPI/Framework/StateTracking/LocationTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -132,20 +130,20 @@ namespace StardewModdingAPI.Framework.StateTracking
         private void UpdateChestWatcherList(IEnumerable<KeyValuePair<Vector2, SObject>> added, IEnumerable<KeyValuePair<Vector2, SObject>> removed)
         {
             // remove unused watchers
-            foreach (KeyValuePair<Vector2, SObject> pair in removed)
+            foreach ((Vector2 tile, SObject? obj) in removed)
             {
-                if (pair.Value is Chest && this.ChestWatchers.TryGetValue(pair.Key, out ChestTracker watcher))
+                if (obj is Chest && this.ChestWatchers.TryGetValue(tile, out ChestTracker? watcher))
                 {
                     watcher.Dispose();
-                    this.ChestWatchers.Remove(pair.Key);
+                    this.ChestWatchers.Remove(tile);
                 }
             }
 
             // add new watchers
-            foreach (KeyValuePair<Vector2, SObject> pair in added)
+            foreach ((Vector2 tile, SObject? obj) in added)
             {
-                if (pair.Value is Chest chest && !this.ChestWatchers.ContainsKey(pair.Key))
-                    this.ChestWatchers.Add(pair.Key, new ChestTracker(chest));
+                if (obj is Chest chest && !this.ChestWatchers.ContainsKey(tile))
+                    this.ChestWatchers.Add(tile, new ChestTracker(chest));
             }
         }
     }
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
index 3d13f92b..0d0469d7 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/LocationSnapshot.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using Microsoft.Xna.Framework;
 using StardewValley;
@@ -70,7 +68,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
             this.ChestItems.Clear();
             foreach (ChestTracker tracker in watcher.ChestWatchers.Values)
             {
-                if (tracker.TryGetInventoryChanges(out SnapshotItemListDiff changes))
+                if (tracker.TryGetInventoryChanges(out SnapshotItemListDiff? changes))
                     this.ChestItems[tracker.Chest] = changes;
             }
         }
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
index 1d43ef26..27a891de 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/WatcherSnapshot.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using Microsoft.Xna.Framework;
 using StardewValley;
 using StardewValley.Menus;
@@ -16,7 +14,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         public SnapshotDiff<Point> WindowSize { get; } = new();
 
         /// <summary>Tracks changes to the current player.</summary>
-        public PlayerSnapshot CurrentPlayer { get; private set; }
+        public PlayerSnapshot? CurrentPlayer { get; private set; }
 
         /// <summary>Tracks changes to the time of day (in 24-hour military format).</summary>
         public SnapshotDiff<int> Time { get; } = new();
@@ -56,7 +54,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
             // update snapshots
             this.WindowSize.Update(watchers.WindowSizeWatcher);
             this.Locale.Update(watchers.LocaleWatcher);
-            this.CurrentPlayer?.Update(watchers.CurrentPlayerTracker);
+            this.CurrentPlayer?.Update(watchers.CurrentPlayerTracker!);
             this.Time.Update(watchers.TimeWatcher);
             this.SaveID.Update(watchers.SaveIdWatcher);
             this.Locations.Update(watchers.LocationsWatcher);
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
index 88aac0df..59f94942 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/WorldLocationsSnapshot.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Linq;
 using StardewModdingAPI.Framework.StateTracking.Comparers;
@@ -44,7 +42,7 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
             // update locations
             foreach (LocationTracker locationWatcher in watcher.Locations)
             {
-                if (!this.LocationsDict.TryGetValue(locationWatcher.Location, out LocationSnapshot snapshot))
+                if (!this.LocationsDict.TryGetValue(locationWatcher.Location, out LocationSnapshot? snapshot))
                     this.LocationsDict[locationWatcher.Location] = snapshot = new LocationSnapshot(locationWatcher.Location);
 
                 snapshot.Update(locationWatcher);
diff --git a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
index ab02d7d5..817a6011 100644
--- a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using System.Linq;
@@ -27,10 +25,10 @@ namespace StardewModdingAPI.Framework.StateTracking
         private readonly ICollectionWatcher<GameLocation> VolcanoLocationListWatcher;
 
         /// <summary>A lookup of the tracked locations.</summary>
-        private IDictionary<GameLocation, LocationTracker> LocationDict { get; } = new Dictionary<GameLocation, LocationTracker>(new ObjectReferenceComparer<GameLocation>());
+        private Dictionary<GameLocation, LocationTracker> LocationDict { get; } = new(new ObjectReferenceComparer<GameLocation>());
 
         /// <summary>A lookup of registered buildings and their indoor location.</summary>
-        private readonly IDictionary<Building, GameLocation> BuildingIndoors = new Dictionary<Building, GameLocation>(new ObjectReferenceComparer<Building>());
+        private readonly Dictionary<Building, GameLocation?> BuildingIndoors = new(new ObjectReferenceComparer<Building>());
 
 
         /*********
@@ -101,10 +99,9 @@ namespace StardewModdingAPI.Framework.StateTracking
             }
 
             // detect building interiors changed (e.g. construction completed)
-            foreach (KeyValuePair<Building, GameLocation> pair in this.BuildingIndoors.Where(p => !object.Equals(p.Key.indoors.Value, p.Value)))
+            foreach ((Building building, GameLocation? oldIndoors) in this.BuildingIndoors.Where(p => !object.Equals(p.Key.indoors.Value, p.Value)))
             {
-                GameLocation oldIndoors = pair.Value;
-                GameLocation newIndoors = pair.Key.indoors.Value;
+                GameLocation? newIndoors = building.indoors.Value;
 
                 if (oldIndoors != null)
                     this.Added.Add(oldIndoors);
@@ -189,19 +186,19 @@ namespace StardewModdingAPI.Framework.StateTracking
         ****/
         /// <summary>Add the given building.</summary>
         /// <param name="building">The building to add.</param>
-        public void Add(Building building)
+        public void Add(Building? building)
         {
             if (building == null)
                 return;
 
-            GameLocation indoors = building.indoors.Value;
+            GameLocation? indoors = building.indoors.Value;
             this.BuildingIndoors[building] = indoors;
             this.Add(indoors);
         }
 
         /// <summary>Add the given location.</summary>
         /// <param name="location">The location to add.</param>
-        public void Add(GameLocation location)
+        public void Add(GameLocation? location)
         {
             if (location == null)
                 return;
@@ -220,7 +217,7 @@ namespace StardewModdingAPI.Framework.StateTracking
 
         /// <summary>Remove the given building.</summary>
         /// <param name="building">The building to remove.</param>
-        public void Remove(Building building)
+        public void Remove(Building? building)
         {
             if (building == null)
                 return;
@@ -231,12 +228,12 @@ namespace StardewModdingAPI.Framework.StateTracking
 
         /// <summary>Remove the given location.</summary>
         /// <param name="location">The location to remove.</param>
-        public void Remove(GameLocation location)
+        public void Remove(GameLocation? location)
         {
             if (location == null)
                 return;
 
-            if (this.LocationDict.TryGetValue(location, out LocationTracker watcher))
+            if (this.LocationDict.TryGetValue(location, out LocationTracker? watcher))
             {
                 // track change
                 this.Removed.Add(location);
diff --git a/src/SMAPI/Framework/Translator.cs b/src/SMAPI/Framework/Translator.cs
index 144b043c..794e3cde 100644
--- a/src/SMAPI/Framework/Translator.cs
+++ b/src/SMAPI/Framework/Translator.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
 
@@ -23,7 +22,7 @@ namespace StardewModdingAPI.Framework
         /*********
         ** Accessors
         *********/
-        /// <summary>The current locale.</summary>
+        /// <summary>The current locale code like <c>fr-FR</c>, or an empty string for English.</summary>
         public string Locale { get; private set; }
 
         /// <summary>The game's current language code.</summary>
@@ -39,9 +38,10 @@ namespace StardewModdingAPI.Framework
             this.SetLocale(string.Empty, LocalizedContentManager.LanguageCode.en);
         }
 
-        /// <summary>Set the current locale and precache translations.</summary>
+        /// <summary>Set the current locale and pre-cache translations.</summary>
         /// <param name="locale">The current locale.</param>
         /// <param name="localeEnum">The game's current language code.</param>
+        [MemberNotNull(nameof(Translator.ForLocale), nameof(Translator.Locale))]
         public void SetLocale(string locale, LocalizedContentManager.LanguageCode localeEnum)
         {
             this.Locale = locale.ToLower().Trim();
@@ -50,7 +50,7 @@ namespace StardewModdingAPI.Framework
             this.ForLocale = new Dictionary<string, Translation>(StringComparer.OrdinalIgnoreCase);
             foreach (string key in this.GetAllKeysRaw())
             {
-                string text = this.GetRaw(key, locale, withFallback: true);
+                string? text = this.GetRaw(key, locale, withFallback: true);
                 this.ForLocale.Add(key, new Translation(this.Locale, key, text));
             }
         }
@@ -65,7 +65,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="key">The translation key.</param>
         public Translation Get(string key)
         {
-            this.ForLocale.TryGetValue(key, out Translation translation);
+            this.ForLocale.TryGetValue(key, out Translation? translation);
             return translation ?? new Translation(this.Locale, key, null);
         }
 
@@ -87,7 +87,7 @@ namespace StardewModdingAPI.Framework
             foreach (var localeSet in this.All)
             {
                 string locale = localeSet.Key;
-                string text = this.GetRaw(key, locale, withFallback);
+                string? text = this.GetRaw(key, locale, withFallback);
 
                 if (text != null)
                     translations[locale] = new Translation(locale, key, text);
@@ -128,13 +128,13 @@ namespace StardewModdingAPI.Framework
         /// <param name="key">The translation key.</param>
         /// <param name="locale">The locale to get.</param>
         /// <param name="withFallback">Whether to add duplicate translations for locale fallback. For example, if a translation is defined in <c>default.json</c> but not <c>fr.json</c>, setting this to true will add a <c>fr</c> entry which duplicates the default text.</param>
-        private string GetRaw(string key, string locale, bool withFallback)
+        private string? GetRaw(string key, string locale, bool withFallback)
         {
             foreach (string next in this.GetRelevantLocales(locale))
             {
-                string translation = null;
+                string? translation = null;
                 bool hasTranslation =
-                    this.All.TryGetValue(next, out IDictionary<string, string> translations)
+                    this.All.TryGetValue(next, out IDictionary<string, string>? translations)
                     && translations.TryGetValue(key, out translation);
 
                 if (hasTranslation)
diff --git a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
index 94ce0069..20d206e2 100644
--- a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
+++ b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 
@@ -9,6 +7,7 @@ namespace StardewModdingAPI.Framework.Utilities
     /// <typeparam name="TKey">The dictionary key type.</typeparam>
     /// <typeparam name="TValue">The dictionary value type.</typeparam>
     internal class TickCacheDictionary<TKey, TValue>
+        where TKey : notnull
     {
         /*********
         ** Fields
@@ -36,7 +35,7 @@ namespace StardewModdingAPI.Framework.Utilities
             }
 
             // fetch value
-            if (!this.Cache.TryGetValue(cacheKey, out TValue cached))
+            if (!this.Cache.TryGetValue(cacheKey, out TValue? cached))
                 this.Cache[cacheKey] = cached = get();
             return cached;
         }
diff --git a/src/SMAPI/Framework/WatcherCore.cs b/src/SMAPI/Framework/WatcherCore.cs
index bd8d3367..5e20ac7b 100644
--- a/src/SMAPI/Framework/WatcherCore.cs
+++ b/src/SMAPI/Framework/WatcherCore.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using Microsoft.Xna.Framework;
@@ -29,7 +27,7 @@ namespace StardewModdingAPI.Framework
         public readonly IValueWatcher<Point> WindowSizeWatcher;
 
         /// <summary>Tracks changes to the current player.</summary>
-        public PlayerTracker CurrentPlayerTracker;
+        public PlayerTracker? CurrentPlayerTracker;
 
         /// <summary>Tracks changes to the time of day (in 24-hour military format).</summary>
         public readonly IValueWatcher<int> TimeWatcher;
diff --git a/src/SMAPI/IAssetData.cs b/src/SMAPI/IAssetData.cs
index f07340e4..1ec09d87 100644
--- a/src/SMAPI/IAssetData.cs
+++ b/src/SMAPI/IAssetData.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI
@@ -7,6 +5,7 @@ namespace StardewModdingAPI
     /// <summary>Generic metadata and methods for a content asset being loaded.</summary>
     /// <typeparam name="TValue">The expected data type.</typeparam>
     public interface IAssetData<TValue> : IAssetInfo
+        where TValue : notnull
     {
         /*********
         ** Accessors
diff --git a/src/SMAPI/IAssetInfo.cs b/src/SMAPI/IAssetInfo.cs
index 5b4ac479..4d651a72 100644
--- a/src/SMAPI/IAssetInfo.cs
+++ b/src/SMAPI/IAssetInfo.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI
@@ -11,7 +9,7 @@ namespace StardewModdingAPI
         ** Accessors
         *********/
         /// <summary>The content's locale code, if the content is localized.</summary>
-        string Locale { get; }
+        string? Locale { get; }
 
         /// <summary>The asset name being read.</summary>
         /// <remarks>NOTE: when reading this field from an <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> implementation, it's always equivalent to <see cref="NameWithoutLocale"/> for backwards compatibility.</remarks>
diff --git a/src/SMAPI/IAssetName.cs b/src/SMAPI/IAssetName.cs
index 22f5c6b7..71b6ed6b 100644
--- a/src/SMAPI/IAssetName.cs
+++ b/src/SMAPI/IAssetName.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewValley;
 
@@ -18,7 +16,7 @@ namespace StardewModdingAPI
         string BaseName { get; }
 
         /// <summary>The locale code specified in the <see cref="Name"/>, if it's a valid code recognized by the game content.</summary>
-        string LocaleCode { get; }
+        string? LocaleCode { get; }
 
         /// <summary>The language code matching the <see cref="LocaleCode"/>, if applicable.</summary>
         LocalizedContentManager.LanguageCode? LanguageCode { get; }
@@ -30,23 +28,23 @@ namespace StardewModdingAPI
         /// <summary>Get whether the given asset name is equivalent, ignoring capitalization and formatting.</summary>
         /// <param name="assetName">The asset name to compare this instance to.</param>
         /// <param name="useBaseName">Whether to compare the given name with the <see cref="BaseName"/> (if true) or <see cref="Name"/> (if false). This has no effect on any locale included in the given <paramref name="assetName"/>.</param>
-        bool IsEquivalentTo(string assetName, bool useBaseName = false);
+        bool IsEquivalentTo(string? assetName, bool useBaseName = false);
 
         /// <summary>Get whether the given asset name is equivalent, ignoring capitalization and formatting.</summary>
         /// <param name="assetName">The asset name to compare this instance to.</param>
         /// <param name="useBaseName">Whether to compare the given name with the <see cref="BaseName"/> (if true) or <see cref="Name"/> (if false).</param>
-        bool IsEquivalentTo(IAssetName assetName, bool useBaseName = false);
+        bool IsEquivalentTo(IAssetName? assetName, bool useBaseName = false);
 
         /// <summary>Get whether the asset name starts with the given value, ignoring capitalization and formatting. This can be used with a trailing slash to test for an asset folder, like <c>Data/</c>.</summary>
         /// <param name="prefix">The prefix to match.</param>
         /// <param name="allowPartialWord">Whether to match if the prefix occurs mid-word, so <c>Data/AchievementsToIgnore</c> matches prefix <c>Data/Achievements</c>. If this is false, the prefix only matches if the asset name starts with the prefix followed by a non-alphanumeric character (including <c>.</c>, <c>/</c>, or <c>\\</c>) or the end of string.</param>
         /// <param name="allowSubfolder">Whether to match the prefix if there's a subfolder path after it, so <c>Data/Achievements/Example</c> matches prefix <c>Data/Achievements</c>. If this is false, the prefix only matches if the asset name has no <c>/</c> or <c>\\</c> characters after the prefix.</param>
-        bool StartsWith(string prefix, bool allowPartialWord = true, bool allowSubfolder = true);
+        bool StartsWith(string? prefix, bool allowPartialWord = true, bool allowSubfolder = true);
 
         /// <summary>Get whether the asset is directly within the given asset path.</summary>
         /// <remarks>For example, <c>Characters/Dialogue/Abigail</c> is directly under <c>Characters/Dialogue</c> but not <c>Characters</c> or <c>Characters/Dialogue/Ab</c>. To allow sub-paths, use <see cref="StartsWith"/> instead.</remarks>
         /// <param name="assetFolder">The asset path to check. This doesn't need a trailing slash.</param>
-        bool IsDirectlyUnderPath(string assetFolder);
+        bool IsDirectlyUnderPath(string? assetFolder);
 
         /// <summary>Get an asset name representing the <see cref="BaseName"/> without locale.</summary>
         internal IAssetName GetBaseAssetName();
diff --git a/src/SMAPI/IContentHelper.cs b/src/SMAPI/IContentHelper.cs
index 0ad209ab..2cd0c1fc 100644
--- a/src/SMAPI/IContentHelper.cs
+++ b/src/SMAPI/IContentHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.Contracts;
@@ -42,12 +40,14 @@ namespace StardewModdingAPI
         /// <param name="source">Where to search for a matching content asset.</param>
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
         /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
-        T Load<T>(string key, ContentSource source = ContentSource.ModFolder);
+        T Load<T>(string key, ContentSource source = ContentSource.ModFolder)
+            where T : notnull;
 
         /// <summary>Normalize an asset name so it's consistent with those generated by the game. This is mainly useful for string comparisons like <see cref="string.StartsWith(string)"/> on generated asset names, and isn't necessary when passing asset names into other content helper methods.</summary>
         /// <param name="assetName">The asset key.</param>
+        /// <exception cref="ContentLoadException">The asset key is empty or contains invalid characters.</exception>
         [Pure]
-        string NormalizeAssetName(string assetName);
+        string NormalizeAssetName(string? assetName);
 
         /// <summary>Get the underlying key in the game's content cache for an asset. This can be used to load custom map tilesheets, but should be avoided when you can use the content API instead. This does not validate whether the asset exists.</summary>
         /// <param name="key">The asset key to fetch (if the <paramref name="source"/> is <see cref="ContentSource.GameContent"/>), or the local path to a content file relative to the mod folder.</param>
@@ -64,7 +64,8 @@ namespace StardewModdingAPI
         /// <summary>Remove all assets of the given type from the cache so they're reloaded on the next request. <b>This can be a very expensive operation and should only be used in very specific cases.</b> This will reload core game assets if needed, but references to the former assets will still show the previous content.</summary>
         /// <typeparam name="T">The asset type to remove from the cache.</typeparam>
         /// <returns>Returns whether any assets were invalidated.</returns>
-        bool InvalidateCache<T>();
+        bool InvalidateCache<T>()
+            where T : notnull;
 
         /// <summary>Remove matching assets from the content cache so they're reloaded on the next request. This will reload core game assets if needed, but references to the former asset will still show the previous content.</summary>
         /// <param name="predicate">A predicate matching the assets to invalidate.</param>
@@ -75,6 +76,7 @@ namespace StardewModdingAPI
         /// <typeparam name="T">The data type.</typeparam>
         /// <param name="data">The asset data.</param>
         /// <param name="assetName">The asset name. This is only used for tracking purposes and has no effect on the patch helper.</param>
-        IAssetData GetPatchHelper<T>(T data, string assetName = null);
+        IAssetData GetPatchHelper<T>(T data, string? assetName = null)
+            where T : notnull;
     }
 }
diff --git a/src/SMAPI/IContentPack.cs b/src/SMAPI/IContentPack.cs
index f853e2b4..1215fe0b 100644
--- a/src/SMAPI/IContentPack.cs
+++ b/src/SMAPI/IContentPack.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
@@ -38,14 +36,16 @@ namespace StardewModdingAPI
         /// <param name="path">The relative file path within the content pack (case-insensitive).</param>
         /// <returns>Returns the deserialized model, or <c>null</c> if the file doesn't exist or is empty.</returns>
         /// <exception cref="InvalidOperationException">The <paramref name="path"/> is not relative or contains directory climbing (../).</exception>
-        TModel ReadJsonFile<TModel>(string path) where TModel : class;
+        TModel? ReadJsonFile<TModel>(string path)
+            where TModel : class;
 
         /// <summary>Save data to a JSON file in the content pack's folder.</summary>
         /// <typeparam name="TModel">The model type. This should be a plain class that has public properties for the data you want. The properties can be complex types.</typeparam>
         /// <param name="path">The relative file path within the content pack (case-insensitive).</param>
         /// <param name="data">The arbitrary data to save.</param>
         /// <exception cref="InvalidOperationException">The <paramref name="path"/> is not relative or contains directory climbing (../).</exception>
-        void WriteJsonFile<TModel>(string path, TModel data) where TModel : class;
+        void WriteJsonFile<TModel>(string path, TModel data)
+            where TModel : class;
 
         /// <summary>Load content from the content pack folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
         /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, and dictionaries; other types may be supported by the game's content pipeline.</typeparam>
@@ -53,7 +53,8 @@ namespace StardewModdingAPI
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
         /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
         [Obsolete($"Use {nameof(IContentPack.ModContent)}.{nameof(IModContentHelper.Load)} instead. This method will be removed in SMAPI 4.0.0.")]
-        T LoadAsset<T>(string key);
+        T LoadAsset<T>(string key)
+            where T : notnull;
 
         /// <summary>Get the underlying key in the game's content cache for an asset. This can be used to load custom map tilesheets, but should be avoided when you can use the content API instead. This does not validate whether the asset exists.</summary>
         /// <param name="key">The relative file path within the content pack (case-insensitive).</param>
diff --git a/src/SMAPI/IDataHelper.cs b/src/SMAPI/IDataHelper.cs
index 4c96367b..7ddf851e 100644
--- a/src/SMAPI/IDataHelper.cs
+++ b/src/SMAPI/IDataHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI
@@ -18,14 +16,16 @@ namespace StardewModdingAPI
         /// <param name="path">The file path relative to the mod folder.</param>
         /// <returns>Returns the deserialized model, or <c>null</c> if the file doesn't exist or is empty.</returns>
         /// <exception cref="InvalidOperationException">The <paramref name="path"/> is not relative or contains directory climbing (../).</exception>
-        TModel ReadJsonFile<TModel>(string path) where TModel : class;
+        TModel? ReadJsonFile<TModel>(string path)
+            where TModel : class;
 
         /// <summary>Save data to a JSON file in the mod's folder.</summary>
         /// <typeparam name="TModel">The model type. This should be a plain class that has public properties for the data you want. The properties can be complex types.</typeparam>
         /// <param name="path">The file path relative to the mod folder.</param>
         /// <param name="data">The arbitrary data to save, or <c>null</c> to delete the file.</param>
         /// <exception cref="InvalidOperationException">The <paramref name="path"/> is not relative or contains directory climbing (../).</exception>
-        void WriteJsonFile<TModel>(string path, TModel data) where TModel : class;
+        void WriteJsonFile<TModel>(string path, TModel? data)
+            where TModel : class;
 
         /****
         ** Save file
@@ -35,14 +35,16 @@ namespace StardewModdingAPI
         /// <param name="key">The unique key identifying the data.</param>
         /// <returns>Returns the parsed data, or <c>null</c> if the entry doesn't exist or is empty.</returns>
         /// <exception cref="InvalidOperationException">The player hasn't loaded a save file yet or isn't the main player.</exception>
-        TModel ReadSaveData<TModel>(string key) where TModel : class;
+        TModel? ReadSaveData<TModel>(string key)
+            where TModel : class;
 
         /// <summary>Save arbitrary data to the current save slot. This is only possible if a save has been loaded, and the data will be lost if the player exits without saving the current day.</summary>
         /// <typeparam name="TModel">The model type. This should be a plain class that has public properties for the data you want. The properties can be complex types.</typeparam>
         /// <param name="key">The unique key identifying the data.</param>
         /// <param name="data">The arbitrary data to save, or <c>null</c> to remove the entry.</param>
         /// <exception cref="InvalidOperationException">The player hasn't loaded a save file yet or isn't the main player.</exception>
-        void WriteSaveData<TModel>(string key, TModel data) where TModel : class;
+        void WriteSaveData<TModel>(string key, TModel? data)
+            where TModel : class;
 
 
         /****
@@ -52,12 +54,14 @@ namespace StardewModdingAPI
         /// <typeparam name="TModel">The model type. This should be a plain class that has public properties for the data you want. The properties can be complex types.</typeparam>
         /// <param name="key">The unique key identifying the data.</param>
         /// <returns>Returns the parsed data, or <c>null</c> if the entry doesn't exist or is empty.</returns>
-        TModel ReadGlobalData<TModel>(string key) where TModel : class;
+        TModel? ReadGlobalData<TModel>(string key)
+            where TModel : class;
 
         /// <summary>Save arbitrary data to the local computer, synchronised by GOG/Steam if applicable.</summary>
         /// <typeparam name="TModel">The model type. This should be a plain class that has public properties for the data you want. The properties can be complex types.</typeparam>
         /// <param name="key">The unique key identifying the data.</param>
         /// <param name="data">The arbitrary data to save, or <c>null</c> to delete the file.</param>
-        void WriteGlobalData<TModel>(string key, TModel data) where TModel : class;
+        void WriteGlobalData<TModel>(string key, TModel? data)
+            where TModel : class;
     }
 }
diff --git a/src/SMAPI/IGameContentHelper.cs b/src/SMAPI/IGameContentHelper.cs
index 4b967993..d40d0c82 100644
--- a/src/SMAPI/IGameContentHelper.cs
+++ b/src/SMAPI/IGameContentHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
@@ -35,14 +33,16 @@ namespace StardewModdingAPI
         /// <param name="assetName">The asset name to load.</param>
         /// <exception cref="ArgumentException">The <paramref name="assetName"/> is empty or contains invalid characters.</exception>
         /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
-        T Load<T>(string assetName);
+        T Load<T>(string assetName)
+            where T : notnull;
 
         /// <summary>Load content from the game folder or mod folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
         /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="assetName">The asset name to load.</param>
         /// <exception cref="ArgumentException">The <paramref name="assetName"/> is empty or contains invalid characters.</exception>
         /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
-        T Load<T>(IAssetName assetName);
+        T Load<T>(IAssetName assetName)
+            where T : notnull;
 
         /// <summary>Remove an asset from the content cache so it's reloaded on the next request. This will reload core game assets if needed, but references to the former asset will still show the previous content.</summary>
         /// <param name="assetName">The asset key to invalidate in the content folder.</param>
@@ -59,7 +59,8 @@ namespace StardewModdingAPI
         /// <summary>Remove all assets of the given type from the cache so they're reloaded on the next request. <b>This can be a very expensive operation and should only be used in very specific cases.</b> This will reload core game assets if needed, but references to the former assets will still show the previous content.</summary>
         /// <typeparam name="T">The asset type to remove from the cache.</typeparam>
         /// <returns>Returns whether any assets were invalidated.</returns>
-        bool InvalidateCache<T>();
+        bool InvalidateCache<T>()
+            where T : notnull;
 
         /// <summary>Remove matching assets from the content cache so they're reloaded on the next request. This will reload core game assets if needed, but references to the former asset will still show the previous content.</summary>
         /// <param name="predicate">A predicate matching the assets to invalidate.</param>
@@ -70,6 +71,7 @@ namespace StardewModdingAPI
         /// <typeparam name="T">The data type.</typeparam>
         /// <param name="data">The asset data.</param>
         /// <param name="assetName">The asset name. This is only used for tracking purposes and has no effect on the patch helper.</param>
-        IAssetData GetPatchHelper<T>(T data, string assetName = null);
+        IAssetData GetPatchHelper<T>(T data, string? assetName = null)
+            where T : notnull;
     }
 }
diff --git a/src/SMAPI/IMod.cs b/src/SMAPI/IMod.cs
index 0de4961e..b81ba0e3 100644
--- a/src/SMAPI/IMod.cs
+++ b/src/SMAPI/IMod.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI
 {
     /// <summary>The implementation for a Stardew Valley mod.</summary>
@@ -26,6 +24,6 @@ namespace StardewModdingAPI
         void Entry(IModHelper helper);
 
         /// <summary>Get an API that other mods can access. This is always called after <see cref="Entry"/>.</summary>
-        object GetApi();
+        object? GetApi();
     }
 }
diff --git a/src/SMAPI/IModContentHelper.cs b/src/SMAPI/IModContentHelper.cs
index 815d6848..f1f6ce94 100644
--- a/src/SMAPI/IModContentHelper.cs
+++ b/src/SMAPI/IModContentHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
@@ -18,7 +16,8 @@ namespace StardewModdingAPI
         /// <param name="relativePath">The local path to a content file relative to the mod folder.</param>
         /// <exception cref="ArgumentException">The <paramref name="relativePath"/> is empty or contains invalid characters.</exception>
         /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
-        T Load<T>(string relativePath);
+        T Load<T>(string relativePath)
+            where T : notnull;
 
         /// <summary>Get the internal asset name which allows loading a mod file through any of the game's content managers. This can be used when passing asset names directly to the game (e.g. for map tilesheets), but should be avoided if you can use <see cref="Load{T}"/> instead. This does not validate whether the asset exists.</summary>
         /// <param name="relativePath">The local path to a content file relative to the mod folder.</param>
@@ -29,6 +28,7 @@ namespace StardewModdingAPI
         /// <typeparam name="T">The data type.</typeparam>
         /// <param name="data">The asset data.</param>
         /// <param name="relativePath">The local path to the content file being edited relative to the mod folder. This is only used for tracking purposes and has no effect on the patch helper.</param>
-        IAssetData GetPatchHelper<T>(T data, string relativePath = null);
+        IAssetData GetPatchHelper<T>(T data, string? relativePath = null)
+            where T : notnull;
     }
 }
diff --git a/src/SMAPI/IModRegistry.cs b/src/SMAPI/IModRegistry.cs
index 9cab08a1..cf60bc29 100644
--- a/src/SMAPI/IModRegistry.cs
+++ b/src/SMAPI/IModRegistry.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 
 namespace StardewModdingAPI
@@ -13,7 +11,7 @@ namespace StardewModdingAPI
         /// <summary>Get metadata for a loaded mod.</summary>
         /// <param name="uniqueID">The mod's unique ID.</param>
         /// <returns>Returns the matching mod's metadata, or <c>null</c> if not found.</returns>
-        IModInfo Get(string uniqueID);
+        IModInfo? Get(string uniqueID);
 
         /// <summary>Get whether a mod has been loaded.</summary>
         /// <param name="uniqueID">The mod's unique ID.</param>
@@ -21,11 +19,12 @@ namespace StardewModdingAPI
 
         /// <summary>Get the API provided by a mod, or <c>null</c> if it has none. This signature requires using the <see cref="IModHelper.Reflection"/> API to access the API's properties and methods.</summary>
         /// <param name="uniqueID">The mod's unique ID.</param>
-        object GetApi(string uniqueID);
+        object? GetApi(string uniqueID);
 
         /// <summary>Get the API provided by a mod, mapped to a given interface which specifies the expected properties and methods. If the mod has no API or it's not compatible with the given interface, get <c>null</c>.</summary>
         /// <typeparam name="TInterface">The interface which matches the properties and methods you intend to access.</typeparam>
         /// <param name="uniqueID">The mod's unique ID.</param>
-        TInterface GetApi<TInterface>(string uniqueID) where TInterface : class;
+        TInterface? GetApi<TInterface>(string uniqueID)
+            where TInterface : class;
     }
 }
diff --git a/src/SMAPI/IMultiplayerHelper.cs b/src/SMAPI/IMultiplayerHelper.cs
index 77a0f3f4..bb851410 100644
--- a/src/SMAPI/IMultiplayerHelper.cs
+++ b/src/SMAPI/IMultiplayerHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using StardewValley;
@@ -18,7 +16,7 @@ namespace StardewModdingAPI
         /// <summary>Get a connected player.</summary>
         /// <param name="id">The player's unique ID.</param>
         /// <returns>Returns the connected player, or <c>null</c> if no such player is connected.</returns>
-        IMultiplayerPeer GetConnectedPlayer(long id);
+        IMultiplayerPeer? GetConnectedPlayer(long id);
 
         /// <summary>Get all connected players.</summary>
         IEnumerable<IMultiplayerPeer> GetConnectedPlayers();
@@ -30,6 +28,6 @@ namespace StardewModdingAPI
         /// <param name="modIDs">The mod IDs which should receive the message on the destination computers, or <c>null</c> for all mods. Specifying mod IDs is recommended to improve performance, unless it's a general-purpose broadcast.</param>
         /// <param name="playerIDs">The <see cref="Farmer.UniqueMultiplayerID" /> values for the players who should receive the message, or <c>null</c> for all players. If you don't need to broadcast to all players, specifying player IDs is recommended to reduce latency.</param>
         /// <exception cref="ArgumentNullException">The <paramref name="message"/> or <paramref name="messageType" /> is null.</exception>
-        void SendMessage<TMessage>(TMessage message, string messageType, string[] modIDs = null, long[] playerIDs = null);
+        void SendMessage<TMessage>(TMessage message, string messageType, string[]? modIDs = null, long[]? playerIDs = null);
     }
 }
diff --git a/src/SMAPI/IMultiplayerPeer.cs b/src/SMAPI/IMultiplayerPeer.cs
index e487f100..8b0062b5 100644
--- a/src/SMAPI/IMultiplayerPeer.cs
+++ b/src/SMAPI/IMultiplayerPeer.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI
 {
@@ -20,6 +19,7 @@ namespace StardewModdingAPI
         bool IsSplitScreen { get; }
 
         /// <summary>Whether the player has SMAPI installed.</summary>
+        [MemberNotNullWhen(true, nameof(IMultiplayerPeer.Platform), nameof(IMultiplayerPeer.GameVersion), nameof(IMultiplayerPeer.ApiVersion), nameof(IMultiplayerPeer.Mods))]
         bool HasSmapi { get; }
 
         /// <summary>The player's screen ID, if applicable.</summary>
@@ -30,10 +30,10 @@ namespace StardewModdingAPI
         GamePlatform? Platform { get; }
 
         /// <summary>The installed version of Stardew Valley, if <see cref="HasSmapi"/> is true.</summary>
-        ISemanticVersion GameVersion { get; }
+        ISemanticVersion? GameVersion { get; }
 
         /// <summary>The installed version of SMAPI, if <see cref="HasSmapi"/> is true.</summary>
-        ISemanticVersion ApiVersion { get; }
+        ISemanticVersion? ApiVersion { get; }
 
         /// <summary>The installed mods, if <see cref="HasSmapi"/> is true.</summary>
         IEnumerable<IMultiplayerPeerMod> Mods { get; }
@@ -45,6 +45,6 @@ namespace StardewModdingAPI
         /// <summary>Get metadata for a mod installed by the player.</summary>
         /// <param name="id">The unique mod ID.</param>
         /// <returns>Returns the mod info, or <c>null</c> if the player doesn't have that mod.</returns>
-        IMultiplayerPeerMod GetMod(string id);
+        IMultiplayerPeerMod? GetMod(string? id);
     }
 }
diff --git a/src/SMAPI/IReflectedField.cs b/src/SMAPI/IReflectedField.cs
index 94dbe6a3..5a24b3dc 100644
--- a/src/SMAPI/IReflectedField.cs
+++ b/src/SMAPI/IReflectedField.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Reflection;
 
 namespace StardewModdingAPI
@@ -19,10 +17,10 @@ namespace StardewModdingAPI
         ** Public methods
         *********/
         /// <summary>Get the field value.</summary>
-        TValue GetValue();
+        TValue? GetValue();
 
         /// <summary>Set the field value.</summary>
         //// <param name="value">The value to set.</param>
-        void SetValue(TValue value);
+        void SetValue(TValue? value);
     }
 }
diff --git a/src/SMAPI/IReflectedMethod.cs b/src/SMAPI/IReflectedMethod.cs
index 78e66cb1..6d87966a 100644
--- a/src/SMAPI/IReflectedMethod.cs
+++ b/src/SMAPI/IReflectedMethod.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Reflection;
 
 namespace StardewModdingAPI
@@ -20,10 +18,10 @@ namespace StardewModdingAPI
         /// <summary>Invoke the method.</summary>
         /// <typeparam name="TValue">The return type.</typeparam>
         /// <param name="arguments">The method arguments to pass in.</param>
-        TValue Invoke<TValue>(params object[] arguments);
+        TValue? Invoke<TValue>(params object?[] arguments);
 
         /// <summary>Invoke the method.</summary>
         /// <param name="arguments">The method arguments to pass in.</param>
-        void Invoke(params object[] arguments);
+        void Invoke(params object?[] arguments);
     }
 }
diff --git a/src/SMAPI/IReflectedProperty.cs b/src/SMAPI/IReflectedProperty.cs
index edbf0b21..ad55b9a1 100644
--- a/src/SMAPI/IReflectedProperty.cs
+++ b/src/SMAPI/IReflectedProperty.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Reflection;
 
 namespace StardewModdingAPI
@@ -19,10 +17,10 @@ namespace StardewModdingAPI
         ** Public methods
         *********/
         /// <summary>Get the property value.</summary>
-        TValue GetValue();
+        TValue? GetValue();
 
         /// <summary>Set the property value.</summary>
         //// <param name="value">The value to set.</param>
-        void SetValue(TValue value);
+        void SetValue(TValue? value);
     }
 }
diff --git a/src/SMAPI/IReflectionHelper.cs b/src/SMAPI/IReflectionHelper.cs
index bf7270cf..b8fb877f 100644
--- a/src/SMAPI/IReflectionHelper.cs
+++ b/src/SMAPI/IReflectionHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI
@@ -14,40 +12,52 @@ namespace StardewModdingAPI
         /// <typeparam name="TValue">The field type.</typeparam>
         /// <param name="obj">The object which has the field.</param>
         /// <param name="name">The field name.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
+        /// <param name="required">Whether to throw an exception if the field isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the return value non-nullable.</strong></param>
+        /// <returns>Returns the method wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the field doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target field doesn't exist, and <paramref name="required"/> is true.</exception>
         IReflectedField<TValue> GetField<TValue>(object obj, string name, bool required = true);
 
         /// <summary>Get a static field.</summary>
         /// <typeparam name="TValue">The field type.</typeparam>
         /// <param name="type">The type which has the field.</param>
         /// <param name="name">The field name.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
+        /// <param name="required">Whether to throw an exception if the field isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the return value non-nullable.</strong></param>
+        /// <returns>Returns the method wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the field doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target field doesn't exist, and <paramref name="required"/> is true.</exception>
         IReflectedField<TValue> GetField<TValue>(Type type, string name, bool required = true);
 
         /// <summary>Get an instance property.</summary>
         /// <typeparam name="TValue">The property type.</typeparam>
         /// <param name="obj">The object which has the property.</param>
         /// <param name="name">The property name.</param>
-        /// <param name="required">Whether to throw an exception if the property is not found.</param>
+        /// <param name="required">Whether to throw an exception if the property isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the return value non-nullable.</strong></param>
+        /// <returns>Returns the method wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the property doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target property doesn't exist, and <paramref name="required"/> is true.</exception>
         IReflectedProperty<TValue> GetProperty<TValue>(object obj, string name, bool required = true);
 
         /// <summary>Get a static property.</summary>
         /// <typeparam name="TValue">The property type.</typeparam>
         /// <param name="type">The type which has the property.</param>
         /// <param name="name">The property name.</param>
-        /// <param name="required">Whether to throw an exception if the property is not found.</param>
+        /// <param name="required">Whether to throw an exception if the property isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the return value non-nullable.</strong></param>
+        /// <returns>Returns the method wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the property doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target property doesn't exist, and <paramref name="required"/> is true.</exception>
         IReflectedProperty<TValue> GetProperty<TValue>(Type type, string name, bool required = true);
 
         /// <summary>Get an instance method.</summary>
         /// <param name="obj">The object which has the method.</param>
-        /// <param name="name">The field name.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
+        /// <param name="name">The method name.</param>
+        /// <param name="required">Whether to throw an exception if the method isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the return value non-nullable.</strong></param>
+        /// <returns>Returns the method wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the method doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target method doesn't exist, and <paramref name="required"/> is true.</exception>
         IReflectedMethod GetMethod(object obj, string name, bool required = true);
 
         /// <summary>Get a static method.</summary>
         /// <param name="type">The type which has the method.</param>
-        /// <param name="name">The field name.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
+        /// <param name="name">The method name.</param>
+        /// <param name="required">Whether to throw an exception if the method isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the return value non-nullable.</strong></param>
+        /// <returns>Returns the method wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the method doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target method doesn't exist, and <paramref name="required"/> is true.</exception>
         IReflectedMethod GetMethod(Type type, string name, bool required = true);
     }
 }
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 5617fd13..9b56f963 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Events;
@@ -70,8 +68,8 @@ namespace StardewModdingAPI.Metadata
             ** detect code which may impact game stability
             ****/
             yield return new TypeFinder("System.Runtime.CompilerServices.CallSite", InstructionHandleResult.DetectedDynamic);
-            yield return new FieldFinder(typeof(SaveGame).FullName, new[] { nameof(SaveGame.serializer), nameof(SaveGame.farmerSerializer), nameof(SaveGame.locationSerializer) }, InstructionHandleResult.DetectedSaveSerializer);
-            yield return new EventFinder(typeof(ISpecializedEvents).FullName, new[] { nameof(ISpecializedEvents.UnvalidatedUpdateTicked), nameof(ISpecializedEvents.UnvalidatedUpdateTicking) }, InstructionHandleResult.DetectedUnvalidatedUpdateTick);
+            yield return new FieldFinder(typeof(SaveGame).FullName!, new[] { nameof(SaveGame.serializer), nameof(SaveGame.farmerSerializer), nameof(SaveGame.locationSerializer) }, InstructionHandleResult.DetectedSaveSerializer);
+            yield return new EventFinder(typeof(ISpecializedEvents).FullName!, new[] { nameof(ISpecializedEvents.UnvalidatedUpdateTicked), nameof(ISpecializedEvents.UnvalidatedUpdateTicking) }, InstructionHandleResult.DetectedUnvalidatedUpdateTick);
 
             /****
             ** detect paranoid issues
@@ -79,23 +77,23 @@ namespace StardewModdingAPI.Metadata
             if (paranoidMode)
             {
                 // filesystem access
-                yield return new TypeFinder(typeof(System.Console).FullName, InstructionHandleResult.DetectedConsoleAccess);
+                yield return new TypeFinder(typeof(System.Console).FullName!, InstructionHandleResult.DetectedConsoleAccess);
                 yield return new TypeFinder(
                     new[]
                     {
-                        typeof(System.IO.File).FullName,
-                        typeof(System.IO.FileStream).FullName,
-                        typeof(System.IO.FileInfo).FullName,
-                        typeof(System.IO.Directory).FullName,
-                        typeof(System.IO.DirectoryInfo).FullName,
-                        typeof(System.IO.DriveInfo).FullName,
-                        typeof(System.IO.FileSystemWatcher).FullName
+                        typeof(System.IO.File).FullName!,
+                        typeof(System.IO.FileStream).FullName!,
+                        typeof(System.IO.FileInfo).FullName!,
+                        typeof(System.IO.Directory).FullName!,
+                        typeof(System.IO.DirectoryInfo).FullName!,
+                        typeof(System.IO.DriveInfo).FullName!,
+                        typeof(System.IO.FileSystemWatcher).FullName!
                     },
                     InstructionHandleResult.DetectedFilesystemAccess
                 );
 
                 // shell access
-                yield return new TypeFinder(typeof(System.Diagnostics.Process).FullName, InstructionHandleResult.DetectedShellAccess);
+                yield return new TypeFinder(typeof(System.Diagnostics.Process).FullName!, InstructionHandleResult.DetectedShellAccess);
             }
         }
     }
diff --git a/src/SMAPI/Mod.cs b/src/SMAPI/Mod.cs
index 2b3750d5..cffe2998 100644
--- a/src/SMAPI/Mod.cs
+++ b/src/SMAPI/Mod.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI
@@ -11,13 +9,13 @@ namespace StardewModdingAPI
         ** Accessors
         *********/
         /// <inheritdoc />
-        public IModHelper Helper { get; internal set; }
+        public IModHelper Helper { get; internal set; } = null!;
 
         /// <inheritdoc />
-        public IMonitor Monitor { get; internal set; }
+        public IMonitor Monitor { get; internal set; } = null!;
 
         /// <inheritdoc />
-        public IManifest ModManifest { get; internal set; }
+        public IManifest ModManifest { get; internal set; } = null!;
 
 
         /*********
@@ -27,7 +25,7 @@ namespace StardewModdingAPI
         public abstract void Entry(IModHelper helper);
 
         /// <inheritdoc />
-        public virtual object GetApi()
+        public virtual object? GetApi()
         {
             return null;
         }
@@ -35,7 +33,7 @@ namespace StardewModdingAPI
         /// <summary>Release or reset unmanaged resources.</summary>
         public void Dispose()
         {
-            (this.Helper as IDisposable)?.Dispose(); // deliberate do this outside overridable dispose method so mods don't accidentally suppress it
+            (this.Helper as IDisposable)?.Dispose(); // deliberately do this outside overridable dispose method so mods don't accidentally suppress it
             this.Dispose(true);
             GC.SuppressFinalize(this);
         }
diff --git a/src/SMAPI/Patches/Game1Patcher.cs b/src/SMAPI/Patches/Game1Patcher.cs
index c5d98e9e..8f806790 100644
--- a/src/SMAPI/Patches/Game1Patcher.cs
+++ b/src/SMAPI/Patches/Game1Patcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
@@ -22,10 +20,10 @@ namespace StardewModdingAPI.Patches
         ** Fields
         *********/
         /// <summary>Simplifies access to private code.</summary>
-        private static Reflector Reflection;
+        private static Reflector Reflection = null!; // initialized in constructor
 
         /// <summary>A callback to invoke when the load stage changes.</summary>
-        private static Action<LoadStage> OnStageChanged;
+        private static Action<LoadStage> OnStageChanged = null!; // initialized in constructor
 
         /// <summary>Whether the game is running running the code in <see cref="Game1.loadForNewGame"/>.</summary>
         private static bool IsInLoadForNewGame;
diff --git a/src/SMAPI/Patches/TitleMenuPatcher.cs b/src/SMAPI/Patches/TitleMenuPatcher.cs
index 56e5597c..18f1a830 100644
--- a/src/SMAPI/Patches/TitleMenuPatcher.cs
+++ b/src/SMAPI/Patches/TitleMenuPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
@@ -19,7 +17,7 @@ namespace StardewModdingAPI.Patches
         ** Fields
         *********/
         /// <summary>A callback to invoke when the load stage changes.</summary>
-        private static Action<LoadStage> OnStageChanged;
+        private static Action<LoadStage> OnStageChanged = null!; // initialized in constructor
 
 
         /*********
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index b2e213fe..a6861bca 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -22,7 +20,7 @@ namespace StardewModdingAPI
         private static readonly string DllSearchPath = EarlyConstants.InternalFilesPath;
 
         /// <summary>The assembly paths in the search folders indexed by assembly name.</summary>
-        private static Dictionary<string, string> AssemblyPathsByName;
+        private static Dictionary<string, string>? AssemblyPathsByName;
 
 
         /*********
@@ -61,7 +59,7 @@ namespace StardewModdingAPI
         /// <summary>Method called when assembly resolution fails, which may return a manually resolved assembly.</summary>
         /// <param name="sender">The event sender.</param>
         /// <param name="e">The event arguments.</param>
-        private static Assembly CurrentDomain_AssemblyResolve(object sender, ResolveEventArgs e)
+        private static Assembly? CurrentDomain_AssemblyResolve(object? sender, ResolveEventArgs e)
         {
             // cache assembly paths by name
             if (Program.AssemblyPathsByName == null)
@@ -74,7 +72,7 @@ namespace StardewModdingAPI
                     {
                         try
                         {
-                            string curName = AssemblyName.GetAssemblyName(dllPath).Name;
+                            string? curName = AssemblyName.GetAssemblyName(dllPath).Name;
                             if (curName != null)
                                 Program.AssemblyPathsByName[curName] = dllPath;
                         }
@@ -89,8 +87,8 @@ namespace StardewModdingAPI
             // resolve
             try
             {
-                string searchName = new AssemblyName(e.Name).Name;
-                return searchName != null && Program.AssemblyPathsByName.TryGetValue(searchName, out string assemblyPath)
+                string? searchName = new AssemblyName(e.Name).Name;
+                return searchName != null && Program.AssemblyPathsByName.TryGetValue(searchName, out string? assemblyPath)
                     ? Assembly.LoadFrom(assemblyPath)
                     : null;
             }
@@ -129,7 +127,7 @@ namespace StardewModdingAPI
             // min version
             if (Constants.GameVersion.IsOlderThan(Constants.MinimumGameVersion))
             {
-                ISemanticVersion suggestedApiVersion = Constants.GetCompatibleApiVersion(Constants.GameVersion);
+                ISemanticVersion? suggestedApiVersion = Constants.GetCompatibleApiVersion(Constants.GameVersion);
                 Program.PrintErrorAndExit(suggestedApiVersion != null
                     ? $"Oops! You're running Stardew Valley {Constants.GameVersion}, but the oldest supported version is {Constants.MinimumGameVersion}. You can install SMAPI {suggestedApiVersion} instead to fix this error, or update your game to the latest version."
                     : $"Oops! You're running Stardew Valley {Constants.GameVersion}, but the oldest supported version is {Constants.MinimumGameVersion}. Please update your game before using SMAPI."
@@ -152,7 +150,7 @@ namespace StardewModdingAPI
             foreach (var type in new[] { typeof(IManifest), typeof(Manifest) })
             {
                 AssemblyName assemblyName = type.Assembly.GetName();
-                ISemanticVersion assemblyVersion = new SemanticVersion(assemblyName.Version);
+                ISemanticVersion assemblyVersion = new SemanticVersion(assemblyName.Version!);
                 if (!assemblyVersion.Equals(smapiVersion))
                     Program.PrintErrorAndExit($"Oops! The 'smapi-internal/{assemblyName.Name}.dll' file is version {assemblyVersion} instead of the required {Constants.ApiVersion}. SMAPI doesn't seem to be installed correctly.");
             }
@@ -184,7 +182,7 @@ namespace StardewModdingAPI
             bool? developerMode = null;
             string modsPath;
             {
-                string rawModsPath = null;
+                string? rawModsPath = null;
 
                 // get mods path from command line args
                 int pathIndex = Array.LastIndexOf(args, "--mods-path") + 1;
@@ -202,7 +200,7 @@ namespace StardewModdingAPI
                     rawModsPath = Environment.GetEnvironmentVariable("SMAPI_MODS_PATH");
                 if (developerMode is null)
                 {
-                    string rawDeveloperMode = Environment.GetEnvironmentVariable("SMAPI_DEVELOPER_MODE");
+                    string? rawDeveloperMode = Environment.GetEnvironmentVariable("SMAPI_DEVELOPER_MODE");
                     if (rawDeveloperMode != null)
                         developerMode = bool.Parse(rawDeveloperMode);
                 }
@@ -221,7 +219,7 @@ namespace StardewModdingAPI
         /// <summary>Write an error directly to the console and exit.</summary>
         /// <param name="message">The error message to display.</param>
         /// <param name="technicalMessage">An additional message to log with technical details.</param>
-        private static void PrintErrorAndExit(string message, string technicalMessage = null)
+        private static void PrintErrorAndExit(string message, string? technicalMessage = null)
         {
             Console.ForegroundColor = ConsoleColor.Red;
             Console.WriteLine(message);
diff --git a/src/SMAPI/Translation.cs b/src/SMAPI/Translation.cs
index ef98a00f..2a0d2ce8 100644
--- a/src/SMAPI/Translation.cs
+++ b/src/SMAPI/Translation.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections;
 using System.Collections.Generic;
@@ -17,14 +15,14 @@ namespace StardewModdingAPI
         /// <summary>The placeholder text when the translation is <c>null</c> or empty, where <c>{0}</c> is the translation key.</summary>
         internal const string PlaceholderText = "(no translation:{0})";
 
-        /// <summary>The locale for which the translation was fetched.</summary>
+        /// <summary>The locale for which the translation was fetched like <c>fr-FR</c>, or an empty string for English.</summary>
         private readonly string Locale;
 
         /// <summary>The underlying translation text.</summary>
-        private readonly string Text;
+        private readonly string? Text;
 
         /// <summary>The value to return if the translations is undefined.</summary>
-        private readonly string Placeholder;
+        private readonly string? Placeholder;
 
 
         /*********
@@ -41,12 +39,12 @@ namespace StardewModdingAPI
         /// <param name="locale">The locale for which the translation was fetched.</param>
         /// <param name="key">The translation key.</param>
         /// <param name="text">The underlying translation text.</param>
-        internal Translation(string locale, string key, string text)
+        internal Translation(string locale, string key, string? text)
             : this(locale, key, text, string.Format(Translation.PlaceholderText, key)) { }
 
         /// <summary>Replace the text if it's <c>null</c> or empty. If you set a <c>null</c> or empty value, the translation will show the fallback "no translation" placeholder (see <see cref="UsePlaceholder"/> if you want to disable that). Returns a new instance if changed.</summary>
         /// <param name="default">The default value.</param>
-        public Translation Default(string @default)
+        public Translation Default(string? @default)
         {
             return this.HasValue()
                 ? this
@@ -54,7 +52,7 @@ namespace StardewModdingAPI
         }
 
         /// <summary>Whether to return a "no translation" placeholder if the translation is <c>null</c> or empty. Returns a new instance.</summary>
-        /// <param name="use">Whether to return a placeholder.</param>
+        /// <param name="use">Whether to return a placeholder. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the text non-nullable.</strong></param>
         public Translation UsePlaceholder(bool use)
         {
             return new Translation(this.Locale, this.Key, this.Text, use ? string.Format(Translation.PlaceholderText, this.Key) : null);
@@ -63,20 +61,20 @@ namespace StardewModdingAPI
         /// <summary>Replace tokens in the text like <c>{{value}}</c> with the given values. Returns a new instance.</summary>
         /// <param name="tokens">An object containing token key/value pairs. This can be an anonymous object (like <c>new { value = 42, name = "Cranberries" }</c>), a dictionary, or a class instance.</param>
         /// <exception cref="ArgumentNullException">The <paramref name="tokens"/> argument is <c>null</c>.</exception>
-        public Translation Tokens(object tokens)
+        public Translation Tokens(object? tokens)
         {
             if (string.IsNullOrWhiteSpace(this.Text) || tokens == null)
                 return this;
 
             // get dictionary of tokens
-            IDictionary<string, string> tokenLookup = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
+            Dictionary<string, string?> tokenLookup = new(StringComparer.OrdinalIgnoreCase);
             {
                 // from dictionary
                 if (tokens is IDictionary inputLookup)
                 {
                     foreach (DictionaryEntry entry in inputLookup)
                     {
-                        string key = entry.Key.ToString()?.Trim();
+                        string? key = entry.Key.ToString()?.Trim();
                         if (key != null)
                             tokenLookup[key] = entry.Value?.ToString();
                     }
@@ -97,7 +95,7 @@ namespace StardewModdingAPI
             string text = Regex.Replace(this.Text, @"{{([ \w\.\-]+)}}", match =>
             {
                 string key = match.Groups[1].Value.Trim();
-                return tokenLookup.TryGetValue(key, out string value)
+                return tokenLookup.TryGetValue(key, out string? value)
                     ? value
                     : match.Value;
             });
@@ -111,18 +109,20 @@ namespace StardewModdingAPI
         }
 
         /// <summary>Get the translation text. Calling this method isn't strictly necessary, since you can assign a <see cref="Translation"/> value directly to a string.</summary>
+        /// <remarks><strong>Limitation with nullable reference types: if there's no text and you disabled the fallback via <see cref="UsePlaceholder"/>, this will return null but the return value will still be marked non-nullable.</strong></remarks>
         public override string ToString()
         {
             return this.Placeholder != null && !this.HasValue()
                 ? this.Placeholder
-                : this.Text;
+                : this.Text!;
         }
 
         /// <summary>Get a string representation of the given translation.</summary>
         /// <param name="translation">The translation key.</param>
+        /// <remarks><strong>Limitation with nullable reference types: if there's no text and you disabled the fallback via <see cref="UsePlaceholder"/>, this will return null but the return value will still be marked non-nullable.</strong></remarks>
         public static implicit operator string(Translation translation)
         {
-            return translation?.ToString();
+            return translation.ToString();
         }
 
 
@@ -134,7 +134,7 @@ namespace StardewModdingAPI
         /// <param name="key">The translation key.</param>
         /// <param name="text">The underlying translation text.</param>
         /// <param name="placeholder">The value to return if the translations is undefined.</param>
-        private Translation(string locale, string key, string text, string placeholder)
+        private Translation(string locale, string key, string? text, string? placeholder)
         {
             this.Locale = locale;
             this.Key = key;
diff --git a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs b/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
index 4596fdce..2ac1b9f9 100644
--- a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
+++ b/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -81,7 +79,7 @@ namespace StardewModdingAPI.Utilities
                 return relativePath;
 
             // already cached
-            if (this.RelativePathCache.Value.TryGetValue(relativePath, out string resolved))
+            if (this.RelativePathCache.Value.TryGetValue(relativePath, out string? resolved))
                 return resolved;
 
             // file exists but isn't cached for some reason
diff --git a/src/SMAPI/Utilities/Keybind.cs b/src/SMAPI/Utilities/Keybind.cs
index 7b1acf1d..3455ce77 100644
--- a/src/SMAPI/Utilities/Keybind.cs
+++ b/src/SMAPI/Utilities/Keybind.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Framework;
 
@@ -44,7 +43,7 @@ namespace StardewModdingAPI.Utilities
         /// <param name="input">The keybind string. See remarks on <see cref="ToString"/> for format details.</param>
         /// <param name="parsed">The parsed keybind, if valid.</param>
         /// <param name="errors">The parse errors, if any.</param>
-        public static bool TryParse(string input, out Keybind parsed, out string[] errors)
+        public static bool TryParse(string input, [NotNullWhen(true)] out Keybind? parsed, out string[] errors)
         {
             // empty input
             if (string.IsNullOrWhiteSpace(input))
diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
index 7b2c396b..18eeb9fd 100644
--- a/src/SMAPI/Utilities/KeybindList.cs
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Serialization;
 
@@ -42,7 +41,7 @@ namespace StardewModdingAPI.Utilities
         /// <exception cref="FormatException">The <paramref name="input"/> format is invalid.</exception>
         public static KeybindList Parse(string input)
         {
-            return KeybindList.TryParse(input, out KeybindList parsed, out string[] errors)
+            return KeybindList.TryParse(input, out KeybindList? parsed, out string[] errors)
                 ? parsed
                 : throw new SParseException($"Can't parse {nameof(Keybind)} from invalid value '{input}'.\n{string.Join("\n", errors)}");
         }
@@ -51,7 +50,7 @@ namespace StardewModdingAPI.Utilities
         /// <param name="input">The keybind string. See remarks on <see cref="ToString"/> for format details.</param>
         /// <param name="parsed">The parsed keybind list, if valid.</param>
         /// <param name="errors">The errors that occurred while parsing the input, if any.</param>
-        public static bool TryParse(string input, out KeybindList parsed, out string[] errors)
+        public static bool TryParse(string input, [NotNullWhen(true)] out KeybindList? parsed, out string[] errors)
         {
             // empty input
             if (string.IsNullOrWhiteSpace(input))
@@ -69,7 +68,7 @@ namespace StardewModdingAPI.Utilities
                 if (string.IsNullOrWhiteSpace(rawSet))
                     continue;
 
-                if (!Keybind.TryParse(rawSet, out Keybind keybind, out string[] curErrors))
+                if (!Keybind.TryParse(rawSet, out Keybind? keybind, out string[] curErrors))
                     rawErrors.AddRange(curErrors);
                 else
                     keybinds.Add(keybind);
@@ -151,7 +150,7 @@ namespace StardewModdingAPI.Utilities
         }
 
         /// <summary>Get the keybind which is currently down, if any. If there are multiple keybinds down, the first one is returned.</summary>
-        public Keybind GetKeybindCurrentlyDown()
+        public Keybind? GetKeybindCurrentlyDown()
         {
             return this.Keybinds.FirstOrDefault(p => p.GetState().IsDown());
         }
diff --git a/src/SMAPI/Utilities/SDate.cs b/src/SMAPI/Utilities/SDate.cs
index b10bc3da..1d4e4489 100644
--- a/src/SMAPI/Utilities/SDate.cs
+++ b/src/SMAPI/Utilities/SDate.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Newtonsoft.Json;
 using StardewModdingAPI.Framework;
@@ -24,7 +23,7 @@ namespace StardewModdingAPI.Utilities
         private readonly int DaysInSeason = 28;
 
         /// <summary>The core SMAPI translations.</summary>
-        internal static Translator Translations;
+        internal static Translator? Translations;
 
 
         /*********
@@ -94,7 +93,8 @@ namespace StardewModdingAPI.Utilities
 
         /// <summary>Get a date from a game date instance.</summary>
         /// <param name="date">The world date.</param>
-        public static SDate From(WorldDate date)
+        [return: NotNullIfNotNull("date")]
+        public static SDate? From(WorldDate? date)
         {
             if (date == null)
                 return null;
@@ -170,14 +170,14 @@ namespace StardewModdingAPI.Utilities
         ****/
         /// <summary>Get whether this instance is equal to another.</summary>
         /// <param name="other">The other value to compare.</param>
-        public bool Equals(SDate other)
+        public bool Equals(SDate? other)
         {
             return this == other;
         }
 
         /// <summary>Get whether this instance is equal to another.</summary>
         /// <param name="obj">The other value to compare.</param>
-        public override bool Equals(object obj)
+        public override bool Equals(object? obj)
         {
             return obj is SDate other && this == other;
         }
@@ -195,7 +195,7 @@ namespace StardewModdingAPI.Utilities
         /// <param name="date">The base date to compare.</param>
         /// <param name="other">The other date to compare.</param>
         /// <returns>The equality of the dates</returns>
-        public static bool operator ==(SDate date, SDate other)
+        public static bool operator ==(SDate? date, SDate? other)
         {
             return date?.DaysSinceStart == other?.DaysSinceStart;
         }
@@ -203,7 +203,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get whether one date is not equal to another.</summary>
         /// <param name="date">The base date to compare.</param>
         /// <param name="other">The other date to compare.</param>
-        public static bool operator !=(SDate date, SDate other)
+        public static bool operator !=(SDate? date, SDate? other)
         {
             return date?.DaysSinceStart != other?.DaysSinceStart;
         }
@@ -211,7 +211,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get whether one date is more than another.</summary>
         /// <param name="date">The base date to compare.</param>
         /// <param name="other">The other date to compare.</param>
-        public static bool operator >(SDate date, SDate other)
+        public static bool operator >(SDate? date, SDate? other)
         {
             return date?.DaysSinceStart > other?.DaysSinceStart;
         }
@@ -219,7 +219,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get whether one date is more than or equal to another.</summary>
         /// <param name="date">The base date to compare.</param>
         /// <param name="other">The other date to compare.</param>
-        public static bool operator >=(SDate date, SDate other)
+        public static bool operator >=(SDate? date, SDate? other)
         {
             return date?.DaysSinceStart >= other?.DaysSinceStart;
         }
@@ -227,7 +227,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get whether one date is less than or equal to another.</summary>
         /// <param name="date">The base date to compare.</param>
         /// <param name="other">The other date to compare.</param>
-        public static bool operator <=(SDate date, SDate other)
+        public static bool operator <=(SDate? date, SDate? other)
         {
             return date?.DaysSinceStart <= other?.DaysSinceStart;
         }
@@ -235,7 +235,7 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Get whether one date is less than another.</summary>
         /// <param name="date">The base date to compare.</param>
         /// <param name="other">The other date to compare.</param>
-        public static bool operator <(SDate date, SDate other)
+        public static bool operator <(SDate? date, SDate? other)
         {
             return date?.DaysSinceStart < other?.DaysSinceStart;
         }
@@ -250,9 +250,10 @@ namespace StardewModdingAPI.Utilities
         /// <param name="year">The year.</param>
         /// <param name="allowDayZero">Whether to allow 0 spring Y1 as a valid date.</param>
         /// <exception cref="ArgumentException">One of the arguments has an invalid value (like day 35).</exception>
+        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The nullability is validated in this constructor.")]
         private SDate(int day, string season, int year, bool allowDayZero)
         {
-            season = season?.Trim().ToLowerInvariant();
+            season = season?.Trim().ToLowerInvariant()!; // null-checked below
 
             // validate
             if (season == null)
@@ -288,25 +289,17 @@ namespace StardewModdingAPI.Utilities
         /// <param name="day">The day of month.</param>
         private DayOfWeek GetDayOfWeek(int day)
         {
-            switch (day % 7)
+            return (day % 7) switch
             {
-                case 0:
-                    return DayOfWeek.Sunday;
-                case 1:
-                    return DayOfWeek.Monday;
-                case 2:
-                    return DayOfWeek.Tuesday;
-                case 3:
-                    return DayOfWeek.Wednesday;
-                case 4:
-                    return DayOfWeek.Thursday;
-                case 5:
-                    return DayOfWeek.Friday;
-                case 6:
-                    return DayOfWeek.Saturday;
-                default:
-                    return 0;
-            }
+                0 => DayOfWeek.Sunday,
+                1 => DayOfWeek.Monday,
+                2 => DayOfWeek.Tuesday,
+                3 => DayOfWeek.Wednesday,
+                4 => DayOfWeek.Thursday,
+                5 => DayOfWeek.Friday,
+                6 => DayOfWeek.Saturday,
+                _ => 0
+            };
         }
 
         /// <summary>Get the number of days since the game began (starting at 1 for the first day of spring in Y1).</summary>

From 5b24fff4771dd11c627ae20c827599fe37fa89ad Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 20:41:34 -0400
Subject: [PATCH 547/856] remove unused code (#837)

---
 src/SMAPI/Events/ChangeType.cs                | 15 -----
 src/SMAPI/Framework/CommandManager.cs         |  5 +-
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 16 ------
 src/SMAPI/Framework/Reflection/Reflector.cs   | 57 -------------------
 src/SMAPI/Framework/RequestExitDelegate.cs    |  9 ---
 src/SMAPI/Framework/SGame.cs                  |  4 --
 6 files changed, 2 insertions(+), 104 deletions(-)
 delete mode 100644 src/SMAPI/Events/ChangeType.cs
 delete mode 100644 src/SMAPI/Framework/RequestExitDelegate.cs

diff --git a/src/SMAPI/Events/ChangeType.cs b/src/SMAPI/Events/ChangeType.cs
deleted file mode 100644
index 0fc717df..00000000
--- a/src/SMAPI/Events/ChangeType.cs
+++ /dev/null
@@ -1,15 +0,0 @@
-namespace StardewModdingAPI.Events
-{
-    /// <summary>Indicates how an inventory item changed.</summary>
-    public enum ChangeType
-    {
-        /// <summary>The entire stack was removed.</summary>
-        Removed,
-
-        /// <summary>The entire stack was added.</summary>
-        Added,
-
-        /// <summary>The stack size changed.</summary>
-        StackChange
-    }
-}
diff --git a/src/SMAPI/Framework/CommandManager.cs b/src/SMAPI/Framework/CommandManager.cs
index df798b0c..80c08f34 100644
--- a/src/SMAPI/Framework/CommandManager.cs
+++ b/src/SMAPI/Framework/CommandManager.cs
@@ -36,11 +36,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="name">The command name, which the user must type to trigger it.</param>
         /// <param name="documentation">The human-readable documentation shown when the player runs the built-in 'help' command.</param>
         /// <param name="callback">The method to invoke when the command is triggered. This method is passed the command name and arguments submitted by the user.</param>
-        /// <param name="allowNullCallback">Whether to allow a null <paramref name="callback"/> argument; this should only used for backwards compatibility.</param>
         /// <exception cref="ArgumentNullException">The <paramref name="name"/> or <paramref name="callback"/> is null or empty.</exception>
         /// <exception cref="FormatException">The <paramref name="name"/> is not a valid format.</exception>
         /// <exception cref="ArgumentException">There's already a command with that name.</exception>
-        public CommandManager Add(IModMetadata mod, string name, string documentation, Action<string, string[]> callback, bool allowNullCallback = false)
+        public CommandManager Add(IModMetadata mod, string name, string documentation, Action<string, string[]> callback)
         {
             name = this.GetNormalizedName(name);
 
@@ -49,7 +48,7 @@ namespace StardewModdingAPI.Framework
                 throw new ArgumentNullException(nameof(name), "Can't register a command with no name.");
             if (name.Any(char.IsWhiteSpace))
                 throw new FormatException($"Can't register the '{name}' command because the name can't contain whitespace.");
-            if (callback == null && !allowNullCallback)
+            if (callback == null)
                 throw new ArgumentNullException(nameof(callback), $"Can't register the '{name}' command because without a callback.");
 
             // ensure uniqueness
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 2842c11a..4fdeefbc 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -394,22 +394,6 @@ namespace StardewModdingAPI.Framework.ModLoading
             }
         }
 
-        /// <summary>Get all mod folders in a root folder, passing through empty folders as needed.</summary>
-        /// <param name="rootPath">The root folder path to search.</param>
-        private IEnumerable<DirectoryInfo> GetModFolders(string rootPath)
-        {
-            foreach (string modRootPath in Directory.GetDirectories(rootPath))
-            {
-                DirectoryInfo directory = new(modRootPath);
-
-                // if a folder only contains another folder, check the inner folder instead
-                while (!directory.GetFiles().Any() && directory.GetDirectories().Length == 1)
-                    directory = directory.GetDirectories().First();
-
-                yield return directory;
-            }
-        }
-
         /// <summary>Get the dependencies declared in a manifest.</summary>
         /// <param name="manifest">The mod manifest.</param>
         /// <param name="loadedMods">The loaded mods.</param>
diff --git a/src/SMAPI/Framework/Reflection/Reflector.cs b/src/SMAPI/Framework/Reflection/Reflector.cs
index d5938c3f..c6fc2c79 100644
--- a/src/SMAPI/Framework/Reflection/Reflector.cs
+++ b/src/SMAPI/Framework/Reflection/Reflector.cs
@@ -1,7 +1,6 @@
 #nullable disable
 
 using System;
-using System.Linq;
 using System.Reflection;
 using System.Runtime.Caching;
 
@@ -128,41 +127,6 @@ namespace StardewModdingAPI.Framework.Reflection
             return method;
         }
 
-        /****
-        ** Methods by signature
-        ****/
-        /// <summary>Get a instance method.</summary>
-        /// <param name="obj">The object which has the method.</param>
-        /// <param name="name">The field name.</param>
-        /// <param name="argumentTypes">The argument types of the method signature to find.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
-        public IReflectedMethod GetMethod(object obj, string name, Type[] argumentTypes, bool required = true)
-        {
-            // validate parent
-            if (obj == null)
-                throw new ArgumentNullException(nameof(obj), "Can't get a instance method from a null object.");
-
-            // get method from hierarchy
-            ReflectedMethod method = this.GetMethodFromHierarchy(obj.GetType(), obj, name, BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public, argumentTypes);
-            if (required && method == null)
-                throw new InvalidOperationException($"The {obj.GetType().FullName} object doesn't have a '{name}' instance method with that signature.");
-            return method;
-        }
-
-        /// <summary>Get a static method.</summary>
-        /// <param name="type">The type which has the method.</param>
-        /// <param name="name">The field name.</param>
-        /// <param name="argumentTypes">The argument types of the method signature to find.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
-        public IReflectedMethod GetMethod(Type type, string name, Type[] argumentTypes, bool required = true)
-        {
-            // get field from hierarchy
-            ReflectedMethod method = this.GetMethodFromHierarchy(type, null, name, BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Static, argumentTypes);
-            if (required && method == null)
-                throw new InvalidOperationException($"The {type.FullName} object doesn't have a '{name}' static method with that signature.");
-            return method;
-        }
-
 
         /*********
         ** Private methods
@@ -232,27 +196,6 @@ namespace StardewModdingAPI.Framework.Reflection
                 : null;
         }
 
-        /// <summary>Get a method from the type hierarchy.</summary>
-        /// <param name="type">The type which has the method.</param>
-        /// <param name="obj">The object which has the method.</param>
-        /// <param name="name">The method name.</param>
-        /// <param name="bindingFlags">The reflection binding which flags which indicates what type of method to find.</param>
-        /// <param name="argumentTypes">The argument types of the method signature to find.</param>
-        private ReflectedMethod GetMethodFromHierarchy(Type type, object obj, string name, BindingFlags bindingFlags, Type[] argumentTypes)
-        {
-            bool isStatic = bindingFlags.HasFlag(BindingFlags.Static);
-            MethodInfo method = this.GetCached($"method::{isStatic}::{type.FullName}::{name}({string.Join(",", argumentTypes.Select(p => p.FullName))})", () =>
-            {
-                MethodInfo methodInfo = null;
-                for (; type != null && methodInfo == null; type = type.BaseType)
-                    methodInfo = type.GetMethod(name, bindingFlags, null, argumentTypes, null);
-                return methodInfo;
-            });
-            return method != null
-                ? new ReflectedMethod(type, obj, method, isStatic)
-                : null;
-        }
-
         /// <summary>Get a method or field through the cache.</summary>
         /// <typeparam name="TMemberInfo">The expected <see cref="MemberInfo"/> type.</typeparam>
         /// <param name="key">The cache key.</param>
diff --git a/src/SMAPI/Framework/RequestExitDelegate.cs b/src/SMAPI/Framework/RequestExitDelegate.cs
deleted file mode 100644
index 93ef1cf9..00000000
--- a/src/SMAPI/Framework/RequestExitDelegate.cs
+++ /dev/null
@@ -1,9 +0,0 @@
-#nullable disable
-
-namespace StardewModdingAPI.Framework
-{
-    /// <summary>A delegate which requests that SMAPI immediately exit the game. This should only be invoked when an irrecoverable fatal error happens that risks save corruption or game-breaking bugs.</summary>
-    /// <param name="module">The module which requested an immediate exit.</param>
-    /// <param name="reason">The reason provided for the shutdown.</param>
-    internal delegate void RequestExitDelegate(string module, string reason);
-}
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 4fa7fe7b..0a8a068f 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -2,7 +2,6 @@ using System;
 using System.Collections.ObjectModel;
 using System.Diagnostics.CodeAnalysis;
 using System.Text;
-using System.Threading.Tasks;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Events;
@@ -64,9 +63,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>Manages input visible to the game.</summary>
         public SInputState Input => (SInputState)Game1.input;
 
-        /// <summary>The game background task which initializes a new day.</summary>
-        public Task NewDayTask => Game1._newDayTask;
-
         /// <summary>Monitors the entire game state for changes.</summary>
         public WatcherCore Watchers { get; private set; } = null!; // initialized on first update tick
 

From 4adf8611131a5d86b15f017a42a0366837d14528 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 21:07:43 -0400
Subject: [PATCH 548/856] enable nullable annotations in the rest of SMAPI core
 (#837)

---
 src/SMAPI.Tests/Utilities/KeybindListTests.cs |  10 +-
 .../Events/ModMessageReceivedEventArgs.cs     |   6 +-
 src/SMAPI/Framework/CommandManager.cs         |  34 ++--
 src/SMAPI/Framework/Commands/HelpCommand.cs   |   8 +-
 .../Framework/Content/AssetDataForMap.cs      |  23 ++-
 src/SMAPI/Framework/Content/AssetName.cs      |  21 ++-
 src/SMAPI/Framework/Content/ContentCache.cs   |  11 +-
 .../ContentManagers/BaseContentManager.cs     |  21 ++-
 .../ContentManagers/ModContentManager.cs      |  21 ++-
 src/SMAPI/Framework/DeprecationManager.cs     |  25 +--
 .../Framework/Input/GamePadStateBuilder.cs    |   9 +-
 src/SMAPI/Framework/Input/SInputState.cs      |   6 +-
 src/SMAPI/Framework/InternalExtensions.cs     |   9 +-
 .../Logging/InterceptingTextWriter.cs         |  24 ++-
 src/SMAPI/Framework/Logging/LogManager.cs     |  36 ++--
 .../Framework/ModHelpers/CommandHelper.cs     |   4 +-
 .../Framework/ModLoading/AssemblyLoader.cs    |  35 ++--
 .../ModLoading/AssemblyParseResult.cs         |  15 +-
 src/SMAPI/Framework/ModLoading/ModResolver.cs |  75 ++++----
 .../Rewriters/FieldReplaceRewriter.cs         |  20 +-
 src/SMAPI/Framework/Models/SConfig.cs         |  80 +++++---
 .../Framework/Networking/ModMessageModel.cs   |  21 +--
 .../Framework/Networking/MultiplayerPeer.cs   |  16 +-
 .../Networking/MultiplayerPeerMod.cs          |   5 +-
 .../Networking/RemoteContextModModel.cs       |  30 ++-
 .../Networking/RemoteContextModel.cs          |  33 +++-
 src/SMAPI/Framework/Reflection/CacheEntry.cs  |  12 +-
 src/SMAPI/Framework/Reflection/Reflector.cs   | 127 ++++++++-----
 src/SMAPI/Framework/SCore.cs                  | 172 +++++++++---------
 src/SMAPI/Framework/SMultiplayer.cs           |  89 +++++----
 .../Serialization/KeybindConverter.cs         |   4 +-
 .../FieldWatchers/ComparableWatcher.cs        |   5 +-
 .../Framework/StateTracking/PlayerTracker.cs  |  16 +-
 .../StateTracking/Snapshots/PlayerSnapshot.cs |  11 +-
 .../TemporaryHacks/MiniMonoModHotfix.cs       | 124 ++++++-------
 src/SMAPI/Metadata/CoreAssetPropagator.cs     |  47 ++---
 src/SMAPI/Translation.cs                      |   2 +-
 src/SMAPI/Utilities/KeybindList.cs            |   2 +-
 src/SMAPI/Utilities/PerScreen.cs              |  23 ++-
 39 files changed, 681 insertions(+), 551 deletions(-)

diff --git a/src/SMAPI.Tests/Utilities/KeybindListTests.cs b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
index 060c93ed..c4c086de 100644
--- a/src/SMAPI.Tests/Utilities/KeybindListTests.cs
+++ b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
@@ -21,12 +21,12 @@ namespace SMAPI.Tests.Utilities
         public void TryParse_SimpleValue(SButton button)
         {
             // act
-            bool success = KeybindList.TryParse($"{button}", out KeybindList parsed, out string[] errors);
+            bool success = KeybindList.TryParse($"{button}", out KeybindList? parsed, out string[] errors);
 
             // assert
             Assert.IsTrue(success, "Parsing unexpectedly failed.");
             Assert.IsNotNull(parsed, "The parsed result should not be null.");
-            Assert.AreEqual(parsed.ToString(), $"{button}");
+            Assert.AreEqual(parsed!.ToString(), $"{button}");
             Assert.IsNotNull(errors, message: "The errors should never be null.");
             Assert.IsEmpty(errors, message: "The input bindings incorrectly reported errors.");
         }
@@ -47,14 +47,14 @@ namespace SMAPI.Tests.Utilities
         public string TryParse_MultiValues(string? input)
         {
             // act
-            bool success = KeybindList.TryParse(input, out KeybindList parsed, out string[] errors);
+            bool success = KeybindList.TryParse(input, out KeybindList? parsed, out string[] errors);
 
             // assert
             Assert.IsTrue(success, "Parsing unexpectedly failed.");
             Assert.IsNotNull(parsed, "The parsed result should not be null.");
             Assert.IsNotNull(errors, message: "The errors should never be null.");
             Assert.IsEmpty(errors, message: "The input bindings incorrectly reported errors.");
-            return parsed.ToString();
+            return parsed!.ToString();
         }
 
         /// <summary>Assert invalid values are rejected.</summary>
@@ -67,7 +67,7 @@ namespace SMAPI.Tests.Utilities
         public void TryParse_InvalidValues(string input, string expectedError)
         {
             // act
-            bool success = KeybindList.TryParse(input, out KeybindList parsed, out string[] errors);
+            bool success = KeybindList.TryParse(input, out KeybindList? parsed, out string[] errors);
 
             // assert
             Assert.IsFalse(success, "Parsing unexpectedly succeeded.");
diff --git a/src/SMAPI/Events/ModMessageReceivedEventArgs.cs b/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
index 671bdf38..84a27d18 100644
--- a/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
+++ b/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Framework.Networking;
 using StardewModdingAPI.Toolkit.Serialization;
@@ -47,8 +45,10 @@ namespace StardewModdingAPI.Events
         /// <summary>Read the message data into the given model type.</summary>
         /// <typeparam name="TModel">The message model type.</typeparam>
         public TModel ReadAs<TModel>()
+            where TModel : notnull
         {
-            return this.Message.Data.ToObject<TModel>(this.JsonHelper.GetSerializer());
+            return this.Message.Data.ToObject<TModel>(this.JsonHelper.GetSerializer())
+                ?? throw new InvalidOperationException($"Can't read empty mod message data as a {typeof(TModel).FullName} value.");
         }
     }
 }
diff --git a/src/SMAPI/Framework/CommandManager.cs b/src/SMAPI/Framework/CommandManager.cs
index 80c08f34..d3b9c8ee 100644
--- a/src/SMAPI/Framework/CommandManager.cs
+++ b/src/SMAPI/Framework/CommandManager.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Text;
 using StardewModdingAPI.Framework.Commands;
@@ -39,9 +38,9 @@ namespace StardewModdingAPI.Framework
         /// <exception cref="ArgumentNullException">The <paramref name="name"/> or <paramref name="callback"/> is null or empty.</exception>
         /// <exception cref="FormatException">The <paramref name="name"/> is not a valid format.</exception>
         /// <exception cref="ArgumentException">There's already a command with that name.</exception>
-        public CommandManager Add(IModMetadata mod, string name, string documentation, Action<string, string[]> callback)
+        public CommandManager Add(IModMetadata? mod, string name, string documentation, Action<string, string[]> callback)
         {
-            name = this.GetNormalizedName(name);
+            name = this.GetNormalizedName(name)!; // null-checked below
 
             // validate format
             if (string.IsNullOrWhiteSpace(name))
@@ -72,10 +71,13 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get a command by its unique name.</summary>
         /// <param name="name">The command name.</param>
         /// <returns>Returns the matching command, or <c>null</c> if not found.</returns>
-        public Command Get(string name)
+        public Command? Get(string? name)
         {
-            name = this.GetNormalizedName(name);
-            this.Commands.TryGetValue(name, out Command command);
+            name = this.GetNormalizedName(name)!;
+            if (string.IsNullOrWhiteSpace(name))
+                return null;
+
+            this.Commands.TryGetValue(name, out Command? command);
             return command;
         }
 
@@ -94,7 +96,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="command">The command which can handle the input.</param>
         /// <param name="screenId">The screen ID on which to run the command.</param>
         /// <returns>Returns true if the input was successfully parsed and matched to a command; else false.</returns>
-        public bool TryParse(string input, out string name, out string[] args, out Command command, out int screenId)
+        public bool TryParse(string? input, [NotNullWhen(true)] out string? name, [NotNullWhen(true)] out string[]? args, [NotNullWhen(true)] out Command? command, out int screenId)
         {
             // ignore if blank
             if (string.IsNullOrWhiteSpace(input))
@@ -108,7 +110,7 @@ namespace StardewModdingAPI.Framework
 
             // parse input
             args = this.ParseArgs(input);
-            name = this.GetNormalizedName(args[0]);
+            name = this.GetNormalizedName(args[0])!;
             args = args.Skip(1).ToArray();
 
             // get screen ID argument
@@ -116,7 +118,7 @@ namespace StardewModdingAPI.Framework
             for (int i = 0; i < args.Length; i++)
             {
                 // consume arg & set screen ID
-                if (this.TryParseScreenId(args[i], out int rawScreenId, out string error))
+                if (this.TryParseScreenId(args[i], out int rawScreenId, out string? error))
                 {
                     args = args.Take(i).Concat(args.Skip(i + 1)).ToArray();
                     screenId = rawScreenId;
@@ -140,15 +142,15 @@ namespace StardewModdingAPI.Framework
         /// <param name="name">The command name.</param>
         /// <param name="arguments">The command arguments.</param>
         /// <returns>Returns whether a matching command was triggered.</returns>
-        public bool Trigger(string name, string[] arguments)
+        public bool Trigger(string? name, string[] arguments)
         {
             // get normalized name
-            name = this.GetNormalizedName(name);
-            if (name == null)
+            name = this.GetNormalizedName(name)!;
+            if (string.IsNullOrWhiteSpace(name))
                 return false;
 
             // get command
-            if (this.Commands.TryGetValue(name, out Command command))
+            if (this.Commands.TryGetValue(name, out Command? command))
             {
                 command.Callback.Invoke(name, arguments);
                 return true;
@@ -191,7 +193,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="screen">The parsed screen ID, if any.</param>
         /// <param name="error">The error which indicates an invalid screen ID, if applicable.</param>
         /// <returns>Returns whether the screen ID was parsed successfully.</returns>
-        private bool TryParseScreenId(string arg, out int screen, out string error)
+        private bool TryParseScreenId(string arg, out int screen, out string? error)
         {
             screen = -1;
             error = null;
@@ -220,7 +222,7 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Get a normalized command name.</summary>
         /// <param name="name">The command name.</param>
-        private string GetNormalizedName(string name)
+        private string? GetNormalizedName(string? name)
         {
             name = name?.Trim().ToLower();
             return !string.IsNullOrWhiteSpace(name)
diff --git a/src/SMAPI/Framework/Commands/HelpCommand.cs b/src/SMAPI/Framework/Commands/HelpCommand.cs
index eb6c74f5..65dc3bce 100644
--- a/src/SMAPI/Framework/Commands/HelpCommand.cs
+++ b/src/SMAPI/Framework/Commands/HelpCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Linq;
 
 namespace StardewModdingAPI.Framework.Commands
@@ -41,7 +39,7 @@ namespace StardewModdingAPI.Framework.Commands
         {
             if (args.Any())
             {
-                Command result = this.CommandManager.Get(args[0]);
+                Command? result = this.CommandManager.Get(args[0]);
                 if (result == null)
                     monitor.Log("There's no command with that name. Type 'help' by itself for more info.", LogLevel.Error);
                 else
@@ -63,10 +61,10 @@ namespace StardewModdingAPI.Framework.Commands
                     + "--------------\n"
                     + "The following commands are registered. For more info about a command, type 'help command_name'.\n\n";
 
-                IGrouping<string, string>[] groups = (from command in this.CommandManager.GetAll() orderby command.Mod?.DisplayName, command.Name group command.Name by command.Mod?.DisplayName).ToArray();
+                IGrouping<string, string>[] groups = (from command in this.CommandManager.GetAll() orderby command.Mod?.DisplayName, command.Name group command.Name by command.Mod?.DisplayName ?? "SMAPI").ToArray();
                 foreach (var group in groups)
                 {
-                    string modName = group.Key ?? "SMAPI";
+                    string modName = group.Key;
                     string[] commandNames = group.ToArray();
                     message += $"{modName}:\n  {string.Join("\n  ", commandNames)}\n\n";
                 }
diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 93148277..133dcc6c 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -35,7 +33,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public AssetDataForMap(string locale, IAssetName assetName, Map data, Func<string, string> getNormalizedPath, Action<Map> onDataReplaced, Reflector reflection)
+        public AssetDataForMap(string? locale, IAssetName assetName, Map data, Func<string, string> getNormalizedPath, Action<Map> onDataReplaced, Reflector reflection)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced)
         {
             this.Reflection = reflection;
@@ -126,8 +124,7 @@ namespace StardewModdingAPI.Framework.Content
                     foreach (Layer sourceLayer in source.Layers)
                     {
                         // get layer
-                        Layer targetLayer = sourceToTargetLayers[sourceLayer];
-                        if (targetLayer == null)
+                        if (!sourceToTargetLayers.TryGetValue(sourceLayer, out Layer? targetLayer))
                         {
                             target.AddLayer(targetLayer = new Layer(sourceLayer.Id, target, target.Layers[0].LayerSize, Layer.m_tileSize));
                             sourceToTargetLayers[sourceLayer] = target.GetLayer(sourceLayer.Id);
@@ -137,11 +134,13 @@ namespace StardewModdingAPI.Framework.Content
                         targetLayer.Properties.CopyFrom(sourceLayer.Properties);
 
                         // create new tile
-                        Tile sourceTile = sourceLayer.Tiles[sourcePos.X, sourcePos.Y];
-                        Tile newTile = sourceTile != null
-                            ? this.CreateTile(sourceTile, targetLayer, tilesheetMap[sourceTile.TileSheet])
-                            : null;
-                        newTile?.Properties.CopyFrom(sourceTile.Properties);
+                        Tile? sourceTile = sourceLayer.Tiles[sourcePos.X, sourcePos.Y];
+                        Tile? newTile = null;
+                        if (sourceTile != null)
+                        {
+                            newTile = this.CreateTile(sourceTile, targetLayer, tilesheetMap[sourceTile.TileSheet]);
+                            newTile?.Properties.CopyFrom(sourceTile.Properties);
+                        }
 
                         // replace tile
                         if (newTile != null || replaceByLayer || replaceAll)
@@ -195,7 +194,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="sourceTile">The source tile to copy.</param>
         /// <param name="targetLayer">The target layer.</param>
         /// <param name="targetSheet">The target tilesheet.</param>
-        private Tile CreateTile(Tile sourceTile, Layer targetLayer, TileSheet targetSheet)
+        private Tile? CreateTile(Tile sourceTile, Layer targetLayer, TileSheet targetSheet)
         {
             switch (sourceTile)
             {
@@ -220,7 +219,7 @@ namespace StardewModdingAPI.Framework.Content
         }
         /// <summary>Normalize a map tilesheet path for comparison. This value should *not* be used as the actual tilesheet path.</summary>
         /// <param name="path">The path to normalize.</param>
-        private string NormalizeTilesheetPathForComparison(string path)
+        private string NormalizeTilesheetPathForComparison(string? path)
         {
             if (string.IsNullOrWhiteSpace(path))
                 return string.Empty;
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 4d583d82..4c691b9a 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
@@ -26,7 +24,7 @@ namespace StardewModdingAPI.Framework.Content
         public string BaseName { get; }
 
         /// <inheritdoc />
-        public string LocaleCode { get; }
+        public string? LocaleCode { get; }
 
         /// <inheritdoc />
         public LocalizedContentManager.LanguageCode? LanguageCode { get; }
@@ -39,7 +37,7 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="baseName">The base asset name without the locale code.</param>
         /// <param name="localeCode">The locale code specified in the <see cref="Name"/>, if it's a valid code recognized by the game content.</param>
         /// <param name="languageCode">The language code matching the <see cref="LocaleCode"/>, if applicable.</param>
-        public AssetName(string baseName, string localeCode, LocalizedContentManager.LanguageCode? languageCode)
+        public AssetName(string baseName, string? localeCode, LocalizedContentManager.LanguageCode? languageCode)
         {
             // validate
             if (string.IsNullOrWhiteSpace(baseName))
@@ -69,7 +67,7 @@ namespace StardewModdingAPI.Framework.Content
                 throw new ArgumentException("The asset name can't be null or empty.", nameof(rawName));
 
             string baseName = rawName;
-            string localeCode = null;
+            string? localeCode = null;
             LocalizedContentManager.LanguageCode? languageCode = null;
 
             int lastPeriodIndex = rawName.LastIndexOf('.');
@@ -90,7 +88,7 @@ namespace StardewModdingAPI.Framework.Content
         }
 
         /// <inheritdoc />
-        public bool IsEquivalentTo(string assetName, bool useBaseName = false)
+        public bool IsEquivalentTo(string? assetName, bool useBaseName = false)
         {
             // empty asset key is never equivalent
             if (string.IsNullOrWhiteSpace(assetName))
@@ -103,7 +101,7 @@ namespace StardewModdingAPI.Framework.Content
         }
 
         /// <inheritdoc />
-        public bool IsEquivalentTo(IAssetName assetName, bool useBaseName = false)
+        public bool IsEquivalentTo(IAssetName? assetName, bool useBaseName = false)
         {
             if (useBaseName)
                 return this.BaseName.Equals(assetName?.BaseName, StringComparison.OrdinalIgnoreCase);
@@ -115,7 +113,7 @@ namespace StardewModdingAPI.Framework.Content
         }
 
         /// <inheritdoc />
-        public bool StartsWith(string prefix, bool allowPartialWord = true, bool allowSubfolder = true)
+        public bool StartsWith(string? prefix, bool allowPartialWord = true, bool allowSubfolder = true)
         {
             // asset keys never start with null
             if (prefix is null)
@@ -157,8 +155,11 @@ namespace StardewModdingAPI.Framework.Content
 
 
         /// <inheritdoc />
-        public bool IsDirectlyUnderPath(string assetFolder)
+        public bool IsDirectlyUnderPath(string? assetFolder)
         {
+            if (assetFolder is null)
+                return false;
+
             return this.StartsWith(assetFolder + "/", allowPartialWord: false, allowSubfolder: false);
         }
 
@@ -171,7 +172,7 @@ namespace StardewModdingAPI.Framework.Content
         }
 
         /// <inheritdoc />
-        public bool Equals(IAssetName other)
+        public bool Equals(IAssetName? other)
         {
             return other switch
             {
diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index 4e620d28..d8862eb3 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Diagnostics.Contracts;
 using System.Linq;
 using StardewModdingAPI.Framework.Reflection;
@@ -46,7 +45,8 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="reflection">Simplifies access to private game code.</param>
         public ContentCache(LocalizedContentManager contentManager, Reflector reflection)
         {
-            this.Cache = reflection.GetField<Dictionary<string, object>>(contentManager, "loadedAssets").GetValue();
+            this.Cache = reflection.GetField<Dictionary<string, object>>(contentManager, "loadedAssets").GetValue()
+                ?? throw new InvalidOperationException("Can't initialize content cache: required field 'loadedAssets' is missing.");
         }
 
         /****
@@ -66,7 +66,8 @@ namespace StardewModdingAPI.Framework.Content
         /// <summary>Normalize path separators in an asset name.</summary>
         /// <param name="path">The file path to normalize.</param>
         [Pure]
-        public string NormalizePathSeparators(string path)
+        [return: NotNullIfNotNull("path")]
+        public string? NormalizePathSeparators(string? path)
         {
             return PathUtilities.NormalizeAssetName(path);
         }
@@ -93,7 +94,7 @@ namespace StardewModdingAPI.Framework.Content
         public bool Remove(string key, bool dispose)
         {
             // get entry
-            if (!this.Cache.TryGetValue(key, out object value))
+            if (!this.Cache.TryGetValue(key, out object? value))
                 return false;
 
             // dispose & remove entry
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index f1ccab48..5ae5313d 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -99,11 +97,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
 
             // get asset data
-            this.BaseDisposableReferences = reflection.GetField<List<IDisposable>>(this, "disposableAssets").GetValue();
+            this.BaseDisposableReferences = reflection.GetField<List<IDisposable>>(this, "disposableAssets").GetValue()
+                ?? throw new InvalidOperationException("Can't initialize content manager: the required 'disposableAssets' field wasn't found.");
         }
 
         /// <inheritdoc />
         public virtual bool DoesAssetExist<T>(IAssetName assetName)
+            where T : notnull
         {
             return this.Cache.ContainsKey(assetName.Name);
         }
@@ -131,6 +131,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <inheritdoc />
         public T LoadLocalized<T>(IAssetName assetName, LanguageCode language, bool useCache)
+            where T : notnull
         {
             // ignore locale in English (or if disabled)
             if (!this.TryLocalizeKeys || language == LocalizedContentManager.LanguageCode.en)
@@ -172,11 +173,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        public abstract T LoadExact<T>(IAssetName assetName, bool useCache);
+        public abstract T LoadExact<T>(IAssetName assetName, bool useCache)
+            where T : notnull;
 
         /// <inheritdoc />
         [SuppressMessage("ReSharper", "ParameterOnlyUsedForPreconditionCheck.Local", Justification = "Parameter is only used for assertion checks by design.")]
-        public string AssertAndNormalizeAssetName(string assetName)
+        public string AssertAndNormalizeAssetName(string? assetName)
         {
             // NOTE: the game checks for ContentLoadException to handle invalid keys, so avoid
             // throwing other types like ArgumentException here.
@@ -253,7 +255,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // dispose uncached assets
             foreach (WeakReference<IDisposable> reference in this.Disposables)
             {
-                if (reference.TryGetTarget(out IDisposable disposable))
+                if (reference.TryGetTarget(out IDisposable? disposable))
                 {
                     try
                     {
@@ -285,7 +287,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         *********/
         /// <summary>Apply initial normalization to a raw asset name before it's parsed.</summary>
         /// <param name="assetName">The asset name to normalize.</param>
-        private string PrenormalizeRawAssetName(string assetName)
+        [return: NotNullIfNotNull("assetName")]
+        private string? PrenormalizeRawAssetName(string? assetName)
         {
             // trim
             assetName = assetName?.Trim();
@@ -301,7 +304,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Normalize path separators in a file path. For asset keys, see <see cref="AssertAndNormalizeAssetName"/> instead.</summary>
         /// <param name="path">The file path to normalize.</param>
         [Pure]
-        protected string NormalizePathSeparators(string path)
+        [return: NotNullIfNotNull("path")]
+        protected string? NormalizePathSeparators(string? path)
         {
             return this.Cache.NormalizePathSeparators(path);
         }
@@ -323,6 +327,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="value">The asset value.</param>
         /// <param name="useCache">Whether to save the asset to the asset cache.</param>
         protected virtual void TrackAsset<T>(IAssetName assetName, T value, bool useCache)
+            where T : notnull
         {
             // track asset key
             if (value is Texture2D texture)
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 8051c296..f0f4bce9 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Globalization;
 using System.IO;
@@ -92,7 +90,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // resolve managed asset key
             {
-                if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string contentManagerID, out IAssetName relativePath))
+                if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string? contentManagerID, out IAssetName? relativePath))
                 {
                     if (contentManagerID != this.Name)
                         throw this.GetLoadError(assetName, "can't load a different mod's managed asset key through this mod content manager.");
@@ -173,7 +171,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file to load.</param>
         private T LoadDataFile<T>(IAssetName assetName, FileInfo file)
         {
-            if (!this.JsonHelper.ReadJsonFileIfExists(file.FullName, out T asset))
+            if (!this.JsonHelper.ReadJsonFileIfExists(file.FullName, out T? asset))
                 throw this.GetLoadError(assetName, "the JSON file is invalid."); // should never happen since we check for file existence before calling this method
 
             return asset;
@@ -249,7 +247,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="assetName">The asset name that failed to load.</param>
         /// <param name="reasonPhrase">The reason the file couldn't be loaded.</param>
         /// <param name="exception">The underlying exception, if applicable.</param>
-        private SContentLoadException GetLoadError(IAssetName assetName, string reasonPhrase, Exception exception = null)
+        private SContentLoadException GetLoadError(IAssetName assetName, string reasonPhrase, Exception? exception = null)
         {
             return new($"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);
         }
@@ -338,13 +336,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // load best match
                 try
                 {
-                    if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out IAssetName assetName, out string error))
+                    if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out IAssetName? assetName, out string? error))
                         throw new SContentLoadException($"{errorPrefix} {error}");
 
-                    if (!assetName.IsEquivalentTo(tilesheet.ImageSource))
-                        this.Monitor.VerboseLog($"   Mapped tilesheet '{tilesheet.ImageSource}' to '{assetName}'.");
+                    if (assetName is not null)
+                    {
+                        if (!assetName.IsEquivalentTo(tilesheet.ImageSource))
+                            this.Monitor.VerboseLog($"   Mapped tilesheet '{tilesheet.ImageSource}' to '{assetName}'.");
 
-                    tilesheet.ImageSource = assetName.Name;
+                        tilesheet.ImageSource = assetName.Name;
+                    }
                 }
                 catch (Exception ex) when (ex is not SContentLoadException)
                 {
@@ -360,7 +361,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="error">A message indicating why the file couldn't be loaded.</param>
         /// <returns>Returns whether the asset name was found.</returns>
         /// <remarks>See remarks on <see cref="FixTilesheetPaths"/>.</remarks>
-        private bool TryGetTilesheetAssetName(string modRelativeMapFolder, string relativePath, out IAssetName assetName, out string error)
+        private bool TryGetTilesheetAssetName(string modRelativeMapFolder, string relativePath, out IAssetName? assetName, out string? error)
         {
             assetName = null;
             error = null;
diff --git a/src/SMAPI/Framework/DeprecationManager.cs b/src/SMAPI/Framework/DeprecationManager.cs
index fe1b623f..44b0ba2f 100644
--- a/src/SMAPI/Framework/DeprecationManager.cs
+++ b/src/SMAPI/Framework/DeprecationManager.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -38,14 +36,14 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Get the source name for a mod from its unique ID.</summary>
-        public string GetSourceNameFromStack()
+        public string? GetSourceNameFromStack()
         {
             return this.ModRegistry.GetFromStack()?.DisplayName;
         }
 
         /// <summary>Get the source name for a mod from its unique ID.</summary>
         /// <param name="modId">The mod's unique ID.</param>
-        public string GetSourceName(string modId)
+        public string? GetSourceName(string modId)
         {
             return this.ModRegistry.Get(modId)?.DisplayName;
         }
@@ -55,10 +53,12 @@ namespace StardewModdingAPI.Framework
         /// <param name="nounPhrase">A noun phrase describing what is deprecated.</param>
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <param name="severity">How deprecated the code is.</param>
-        public void Warn(string source, string nounPhrase, string version, DeprecationLevel severity)
+        public void Warn(string? source, string nounPhrase, string version, DeprecationLevel severity)
         {
+            source ??= this.GetSourceNameFromStack() ?? "<unknown>";
+
             // ignore if already warned
-            if (!this.MarkWarned(source ?? this.GetSourceNameFromStack() ?? "<unknown>", nounPhrase, version))
+            if (!this.MarkWarned(source, nounPhrase, version))
                 return;
 
             // queue warning
@@ -99,17 +99,12 @@ namespace StardewModdingAPI.Framework
                 }
 
                 // log message
-                if (warning.ModName != null)
-                    this.Monitor.Log(message, level);
+                if (level == LogLevel.Trace)
+                    this.Monitor.Log($"{message}\n{warning.StackTrace}", level);
                 else
                 {
-                    if (level == LogLevel.Trace)
-                        this.Monitor.Log($"{message}\n{warning.StackTrace}", level);
-                    else
-                    {
-                        this.Monitor.Log(message, level);
-                        this.Monitor.Log(warning.StackTrace, LogLevel.Debug);
-                    }
+                    this.Monitor.Log(message, level);
+                    this.Monitor.Log(warning.StackTrace, LogLevel.Debug);
                 }
             }
 
diff --git a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
index 21168b7a..4ac3332c 100644
--- a/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
+++ b/src/SMAPI/Framework/Input/GamePadStateBuilder.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Input;
@@ -23,7 +22,7 @@ namespace StardewModdingAPI.Framework.Input
         private GamePadState? State;
 
         /// <summary>The current button states.</summary>
-        private readonly IDictionary<SButton, ButtonState> ButtonStates;
+        private readonly IDictionary<SButton, ButtonState>? ButtonStates;
 
         /// <summary>The left trigger value.</summary>
         private float LeftTrigger;
@@ -42,6 +41,7 @@ namespace StardewModdingAPI.Framework.Input
         ** Accessors
         *********/
         /// <summary>Whether the gamepad is currently connected.</summary>
+        [MemberNotNullWhen(true, nameof(GamePadStateBuilder.ButtonStates))]
         public bool IsConnected { get; }
 
 
@@ -213,6 +213,9 @@ namespace StardewModdingAPI.Framework.Input
         /// <summary>Get the pressed gamepad buttons.</summary>
         private IEnumerable<Buttons> GetPressedGamePadButtons()
         {
+            if (!this.IsConnected)
+                yield break;
+
             foreach (var pair in this.ButtonStates)
             {
                 if (pair.Value == ButtonState.Pressed && pair.Key.TryGetController(out Buttons button))
diff --git a/src/SMAPI/Framework/Input/SInputState.cs b/src/SMAPI/Framework/Input/SInputState.cs
index 37b3c8ef..fef83af7 100644
--- a/src/SMAPI/Framework/Input/SInputState.cs
+++ b/src/SMAPI/Framework/Input/SInputState.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -17,7 +15,7 @@ namespace StardewModdingAPI.Framework.Input
         ** Accessors
         *********/
         /// <summary>The cursor position on the screen adjusted for the zoom level.</summary>
-        private CursorPosition CursorPositionImpl;
+        private CursorPosition CursorPositionImpl = new(Vector2.Zero, Vector2.Zero, Vector2.Zero, Vector2.Zero);
 
         /// <summary>The player's last known tile position.</summary>
         private Vector2? LastPlayerTile;
@@ -106,7 +104,7 @@ namespace StardewModdingAPI.Framework.Input
                 this.KeyboardState = keyboard.GetState();
                 this.MouseState = mouse.GetState();
                 this.ButtonStates = activeButtons;
-                if (cursorAbsolutePos != this.CursorPositionImpl?.AbsolutePixels || playerTilePos != this.LastPlayerTile)
+                if (cursorAbsolutePos != this.CursorPositionImpl.AbsolutePixels || playerTilePos != this.LastPlayerTile)
                 {
                     this.LastPlayerTile = playerTilePos;
                     this.CursorPositionImpl = this.GetCursorPosition(this.MouseState, cursorAbsolutePos, zoomMultiplier);
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index a1d87487..fd8cc86f 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -43,6 +41,9 @@ namespace StardewModdingAPI.Framework
         /// <param name="level">The log severity level.</param>
         public static void LogAsMod(this IModMetadata metadata, string message, LogLevel level = LogLevel.Trace)
         {
+            if (metadata.Monitor is null)
+                throw new InvalidOperationException($"Can't log as mod {metadata.DisplayName}: mod is broken or a content pack. Logged message:\n[{level}] {message}");
+
             metadata.Monitor.Log(message, level);
         }
 
@@ -52,7 +53,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="level">The log severity level.</param>
         public static void LogAsModOnce(this IModMetadata metadata, string message, LogLevel level = LogLevel.Trace)
         {
-            metadata.Monitor.LogOnce(message, level);
+            metadata.Monitor?.LogOnce(message, level);
         }
 
         /****
@@ -159,7 +160,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="reflection">The reflection helper with which to access private fields.</param>
         public static bool IsOpen(this SpriteBatch spriteBatch, Reflector reflection)
         {
-            return reflection.GetField<bool>(spriteBatch, "_beginCalled").GetValue();
+            return reflection.GetField<bool>(spriteBatch, "_beginCalled")!.GetValue();
         }
     }
 }
diff --git a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
index a0957b90..9ecc1626 100644
--- a/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
+++ b/src/SMAPI/Framework/Logging/InterceptingTextWriter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.IO;
 using System.Text;
@@ -9,6 +7,13 @@ namespace StardewModdingAPI.Framework.Logging
     /// <summary>A text writer which allows intercepting output.</summary>
     internal class InterceptingTextWriter : TextWriter
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The event raised when a message is written to the console directly.</summary>
+        private readonly Action<string> OnMessageIntercepted;
+
+
         /*********
         ** Accessors
         *********/
@@ -21,9 +26,6 @@ namespace StardewModdingAPI.Framework.Logging
         /// <inheritdoc />
         public override Encoding Encoding => this.Out.Encoding;
 
-        /// <summary>The event raised when a message is written to the console directly.</summary>
-        public event Action<string> OnMessageIntercepted;
-
         /// <summary>Whether the text writer should ignore the next input if it's a newline.</summary>
         /// <remarks>This is used when log output is suppressed from the console, since <c>Console.WriteLine</c> writes the trailing newline as a separate call.</remarks>
         public bool IgnoreNextIfNewline { get; set; }
@@ -34,9 +36,11 @@ namespace StardewModdingAPI.Framework.Logging
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="output">The underlying output writer.</param>
-        public InterceptingTextWriter(TextWriter output)
+        /// <param name="onMessageIntercepted">The event raised when a message is written to the console directly.</param>
+        public InterceptingTextWriter(TextWriter output, Action<string> onMessageIntercepted)
         {
             this.Out = output;
+            this.OnMessageIntercepted = onMessageIntercepted;
         }
 
         /// <inheritdoc />
@@ -65,7 +69,7 @@ namespace StardewModdingAPI.Framework.Logging
                     this.Out.Write(buffer, index, count);
             }
             else
-                this.OnMessageIntercepted?.Invoke(new string(buffer, index, count));
+                this.OnMessageIntercepted(new string(buffer, index, count));
         }
 
         /// <inheritdoc />
@@ -74,12 +78,6 @@ namespace StardewModdingAPI.Framework.Logging
             this.Out.Write(ch);
         }
 
-        /// <inheritdoc />
-        protected override void Dispose(bool disposing)
-        {
-            this.OnMessageIntercepted = null;
-        }
-
 
         /*********
         ** Private methods
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index dab7f554..a5989673 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -95,6 +93,11 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="getScreenIdForLog">Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</param>
         public LogManager(string logPath, ColorSchemeConfig colorConfig, bool writeToConsole, bool isVerbose, bool isDeveloperMode, Func<int?> getScreenIdForLog)
         {
+            // init fields
+            this.LogFile = new LogFileManager(logPath);
+            this.Monitor = this.GetMonitor("SMAPI");
+            this.MonitorForGame = this.GetMonitor("game");
+
             // init construction logic
             this.GetMonitorImpl = name => new Monitor(name, LogManager.IgnoreChar, this.LogFile, colorConfig, isVerbose, getScreenIdForLog)
             {
@@ -103,15 +106,13 @@ namespace StardewModdingAPI.Framework.Logging
                 ShowFullStampInConsole = isDeveloperMode
             };
 
-            // init fields
-            this.LogFile = new LogFileManager(logPath);
-            this.Monitor = this.GetMonitor("SMAPI");
-            this.MonitorForGame = this.GetMonitor("game");
-
             // redirect direct console output
-            this.ConsoleInterceptor = new InterceptingTextWriter(Console.Out);
-            if (writeToConsole)
-                this.ConsoleInterceptor.OnMessageIntercepted += message => this.HandleConsoleMessage(this.MonitorForGame, message);
+            this.ConsoleInterceptor = new InterceptingTextWriter(
+                output: Console.Out,
+                onMessageIntercepted: writeToConsole
+                    ? message => this.HandleConsoleMessage(this.MonitorForGame, message)
+                    : _ => { }
+            );
             Console.SetOut(this.ConsoleInterceptor);
 
             // enable Unicode handling on Windows
@@ -156,7 +157,7 @@ namespace StardewModdingAPI.Framework.Logging
                 while (true)
                 {
                     // get input
-                    string input = Console.ReadLine();
+                    string? input = Console.ReadLine();
                     if (string.IsNullOrWhiteSpace(input))
                         continue;
 
@@ -222,7 +223,7 @@ namespace StardewModdingAPI.Framework.Logging
             if (File.Exists(Constants.UpdateMarker))
             {
                 string[] rawUpdateFound = File.ReadAllText(Constants.UpdateMarker).Split(new[] { '|' }, 2);
-                if (SemanticVersion.TryParse(rawUpdateFound[0], out ISemanticVersion updateFound))
+                if (SemanticVersion.TryParse(rawUpdateFound[0], out ISemanticVersion? updateFound))
                 {
                     if (Constants.ApiVersion.IsPrerelease() && updateFound.IsNewerThan(Constants.ApiVersion))
                     {
@@ -264,7 +265,7 @@ namespace StardewModdingAPI.Framework.Logging
         /// <summary>Log the initial header with general SMAPI and system details.</summary>
         /// <param name="modsPath">The path from which mods will be loaded.</param>
         /// <param name="customSettings">The custom SMAPI settings.</param>
-        public void LogIntro(string modsPath, IDictionary<string, object> customSettings)
+        public void LogIntro(string modsPath, IDictionary<string, object?> customSettings)
         {
             // log platform
             this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} (build {Constants.GetBuildVersionLabel()}) on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
@@ -326,7 +327,7 @@ namespace StardewModdingAPI.Framework.Logging
             // log loaded content packs
             if (loadedContentPacks.Any())
             {
-                string GetModDisplayName(string id) => loadedMods.FirstOrDefault(p => p.HasID(id))?.DisplayName;
+                string? GetModDisplayName(string id) => loadedMods.FirstOrDefault(p => p.HasID(id))?.DisplayName;
 
                 this.Monitor.Log($"Loaded {loadedContentPacks.Length} content packs:", LogLevel.Info);
                 foreach (IModMetadata metadata in loadedContentPacks.OrderBy(p => p.DisplayName))
@@ -335,7 +336,7 @@ namespace StardewModdingAPI.Framework.Logging
                     this.Monitor.Log(
                         $"   {metadata.DisplayName} {manifest.Version}"
                         + (!string.IsNullOrWhiteSpace(manifest.Author) ? $" by {manifest.Author}" : "")
-                        + $" | for {GetModDisplayName(metadata.Manifest.ContentPackFor.UniqueID)}"
+                        + $" | for {GetModDisplayName(metadata.Manifest.ContentPackFor!.UniqueID)}"
                         + (!string.IsNullOrWhiteSpace(manifest.Description) ? $" | {manifest.Description}" : ""),
                         LogLevel.Info
                     );
@@ -398,6 +399,7 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="mods">The loaded mods.</param>
         /// <param name="skippedMods">The mods which could not be loaded.</param>
         /// <param name="logParanoidWarnings">Whether to log issues for mods which directly use potentially sensitive .NET APIs like file or shell access.</param>
+        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "Manifests aren't guaranteed non-null at this point in the loading process.")]
         private void LogModWarnings(IEnumerable<IModMetadata> mods, IModMetadata[] skippedMods, bool logParanoidWarnings)
         {
             // get mods with warnings
@@ -431,7 +433,7 @@ namespace StardewModdingAPI.Framework.Logging
                             // duplicate mod: log first one only, don't show redundant version
                             if (mod.FailReason == ModFailReason.Duplicate && mod.HasManifest())
                             {
-                                if (loggedDuplicateIds.Add(mod.Manifest.UniqueID))
+                                if (loggedDuplicateIds.Add(mod.Manifest!.UniqueID))
                                     continue; // already logged
 
                                 message = $"      - {mod.DisplayName} because {mod.Error}";
@@ -610,7 +612,7 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="heading">A brief heading label for the group.</param>
         /// <param name="blurb">A detailed explanation of the warning, split into lines.</param>
         /// <param name="modLabel">Formats the mod label, or <c>null</c> to use the <see cref="IModMetadata.DisplayName"/>.</param>
-        private void LogModWarningGroup(IModMetadata[] mods, Func<IModMetadata, bool> match, LogLevel level, string heading, string[] blurb, Func<IModMetadata, string> modLabel = null)
+        private void LogModWarningGroup(IModMetadata[] mods, Func<IModMetadata, bool> match, LogLevel level, string heading, string[] blurb, Func<IModMetadata, string>? modLabel = null)
         {
             // get matching mods
             string[] modLabels = mods
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index c2b5092e..7d25979c 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 
 namespace StardewModdingAPI.Framework.ModHelpers
@@ -24,7 +22,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="mod">The mod using this instance.</param>
         /// <param name="commandManager">Manages console commands.</param>
         public CommandHelper(IModMetadata mod, CommandManager commandManager)
-            : base(mod?.Manifest?.UniqueID ?? "SMAPI")
+            : base(mod.Manifest.UniqueID)
         {
             this.Mod = mod;
             this.CommandManager = commandManager;
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 070ee803..72b547b1 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -96,7 +94,12 @@ namespace StardewModdingAPI.Framework.ModLoading
             // get referenced local assemblies
             AssemblyParseResult[] assemblies;
             {
-                HashSet<string> visitedAssemblyNames = new HashSet<string>(AppDomain.CurrentDomain.GetAssemblies().Select(p => p.GetName().Name)); // don't try loading assemblies that are already loaded
+                HashSet<string> visitedAssemblyNames = new HashSet<string>( // don't try loading assemblies that are already loaded
+                    from assembly in AppDomain.CurrentDomain.GetAssemblies()
+                    let name = assembly.GetName().Name
+                    where name != null
+                    select name
+                );
                 assemblies = this.GetReferencedLocalAssemblies(new FileInfo(assemblyPath), visitedAssemblyNames, this.AssemblyDefinitionResolver).ToArray();
             }
 
@@ -113,11 +116,11 @@ namespace StardewModdingAPI.Framework.ModLoading
 
             // rewrite & load assemblies in leaf-to-root order
             bool oneAssembly = assemblies.Length == 1;
-            Assembly lastAssembly = null;
+            Assembly? lastAssembly = null;
             HashSet<string> loggedMessages = new HashSet<string>();
             foreach (AssemblyParseResult assembly in assemblies)
             {
-                if (assembly.Status == AssemblyLoadStatus.AlreadyLoaded)
+                if (!assembly.HasDefinition)
                     continue;
 
                 // rewrite assembly
@@ -165,7 +168,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 throw new IncompatibleInstructionException();
 
             // last assembly loaded is the root
-            return lastAssembly;
+            return lastAssembly!;
         }
 
         /// <summary>Get whether an assembly is loaded.</summary>
@@ -174,7 +177,8 @@ namespace StardewModdingAPI.Framework.ModLoading
         {
             try
             {
-                return this.AssemblyDefinitionResolver.Resolve(reference) != null;
+                _ = this.AssemblyDefinitionResolver.Resolve(reference);
+                return true;
             }
             catch (AssemblyResolutionException)
             {
@@ -190,7 +194,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// assemblies (especially with Mono). Since this is meant to be called on <see cref="AppDomain.AssemblyResolve"/>,
         /// the implicit assumption is that loading the exact assembly failed.
         /// </remarks>
-        public static Assembly ResolveAssembly(string name)
+        public static Assembly? ResolveAssembly(string name)
         {
             string shortName = name.Split(new[] { ',' }, 2).First(); // get simple name (without version and culture)
             return AppDomain.CurrentDomain
@@ -212,7 +216,8 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Track an object for disposal as part of the assembly loader.</summary>
         /// <typeparam name="T">The instance type.</typeparam>
         /// <param name="instance">The disposable instance.</param>
-        private T TrackForDisposal<T>(T instance) where T : IDisposable
+        private T TrackForDisposal<T>(T instance)
+            where T : IDisposable
         {
             this.Disposables.Add(instance);
             return instance;
@@ -321,9 +326,9 @@ namespace StardewModdingAPI.Framework.ModLoading
                     // rewrite types using custom attributes
                     foreach (TypeDefinition type in module.GetTypes())
                     {
-                        foreach (var attr in type.CustomAttributes)
+                        foreach (CustomAttribute attr in type.CustomAttributes)
                         {
-                            foreach (var conField in attr.ConstructorArguments)
+                            foreach (CustomAttributeArgument conField in attr.ConstructorArguments)
                             {
                                 if (conField.Value is TypeReference typeRef)
                                     this.ChangeTypeScope(typeRef);
@@ -382,7 +387,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         {
             // get message template
             // ($phrase is replaced with the noun phrase or messages)
-            string template = null;
+            string? template = null;
             switch (result)
             {
                 case InstructionHandleResult.Rewritten:
@@ -441,20 +446,20 @@ namespace StardewModdingAPI.Framework.ModLoading
             // format messages
             string phrase = handler.Phrases.Any()
                 ? string.Join(", ", handler.Phrases)
-                : handler.DefaultPhrase ?? handler.GetType().Name;
+                : handler.DefaultPhrase;
             this.Monitor.LogOnce(loggedMessages, template.Replace("$phrase", phrase));
         }
 
         /// <summary>Get the correct reference to use for compatibility with the current platform.</summary>
         /// <param name="type">The type reference to rewrite.</param>
-        private void ChangeTypeScope(TypeReference type)
+        private void ChangeTypeScope(TypeReference? type)
         {
             // check skip conditions
             if (type == null || type.FullName.StartsWith("System."))
                 return;
 
             // get assembly
-            if (!this.TypeAssemblies.TryGetValue(type.FullName, out Assembly assembly))
+            if (!this.TypeAssemblies.TryGetValue(type.FullName, out Assembly? assembly))
                 return;
 
             // replace scope
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs b/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
index 56bd5a8b..b133f8d6 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyParseResult.cs
@@ -1,5 +1,5 @@
-#nullable disable
-
+using System;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using Mono.Cecil;
 
@@ -15,11 +15,15 @@ namespace StardewModdingAPI.Framework.ModLoading
         public readonly FileInfo File;
 
         /// <summary>The assembly definition.</summary>
-        public readonly AssemblyDefinition Definition;
+        public readonly AssemblyDefinition? Definition;
 
         /// <summary>The result of the assembly load.</summary>
         public AssemblyLoadStatus Status;
 
+        /// <summary>Whether the <see cref="Definition"/> is loaded and ready (i.e. the <see cref="Status"/> is not <see cref="AssemblyLoadStatus.AlreadyLoaded"/> or <see cref="AssemblyLoadStatus.Failed"/>).</summary>
+        [MemberNotNullWhen(true, nameof(AssemblyParseResult.Definition))]
+        public bool HasDefinition => this.Status == AssemblyLoadStatus.Okay;
+
 
         /*********
         ** Public methods
@@ -28,11 +32,14 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="file">The original assembly file.</param>
         /// <param name="assembly">The assembly definition.</param>
         /// <param name="status">The result of the assembly load.</param>
-        public AssemblyParseResult(FileInfo file, AssemblyDefinition assembly, AssemblyLoadStatus status)
+        public AssemblyParseResult(FileInfo file, AssemblyDefinition? assembly, AssemblyLoadStatus status)
         {
             this.File = file;
             this.Definition = assembly;
             this.Status = status;
+
+            if (status == AssemblyLoadStatus.Okay && assembly == null)
+                throw new InvalidOperationException($"Invalid assembly parse result: load status {status} with a null assembly.");
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 4fdeefbc..afb388d0 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using StardewModdingAPI.Toolkit;
@@ -28,10 +27,10 @@ namespace StardewModdingAPI.Framework.ModLoading
         {
             foreach (ModFolder folder in toolkit.GetModFolders(rootPath))
             {
-                Manifest manifest = folder.Manifest;
+                Manifest? manifest = folder.Manifest;
 
                 // parse internal data record (if any)
-                ModDataRecordVersionedFields dataRecord = modDatabase.Get(manifest?.UniqueID)?.GetVersionedFields(manifest);
+                ModDataRecordVersionedFields? dataRecord = modDatabase.Get(manifest?.UniqueID)?.GetVersionedFields(manifest);
 
                 // apply defaults
                 if (manifest != null && dataRecord?.UpdateKey is not null)
@@ -43,7 +42,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                     ? ModMetadataStatus.Found
                     : ModMetadataStatus.Failed;
 
-                var metadata = new ModMetadata(folder.DisplayName, folder.Directory.FullName, rootPath, manifest, dataRecord, isIgnored: shouldIgnore);
+                IModMetadata metadata = new ModMetadata(folder.DisplayName, folder.Directory.FullName, rootPath, manifest, dataRecord, isIgnored: shouldIgnore);
                 if (shouldIgnore)
                     metadata.SetStatus(status, ModFailReason.DisabledByDotConvention, "disabled by dot convention");
                 else
@@ -57,7 +56,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="mods">The mod manifests to validate.</param>
         /// <param name="apiVersion">The current SMAPI version.</param>
         /// <param name="getUpdateUrl">Get an update URL for an update key (if valid).</param>
-        public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string> getUpdateUrl)
+        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "Manifest values may be null before they're validated.")]
+        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "Manifest values may be null before they're validated.")]
+        public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string?> getUpdateUrl)
         {
             mods = mods.ToArray();
 
@@ -84,7 +85,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                             List<string> updateUrls = new List<string>();
                             foreach (UpdateKey key in mod.GetUpdateKeys(validOnly: true))
                             {
-                                string url = getUpdateUrl(key.ToString());
+                                string? url = getUpdateUrl(key.ToString());
                                 if (url != null)
                                     updateUrls.Add(url);
                             }
@@ -94,7 +95,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
                             // build error
                             string error = $"{reasonPhrase}. Please check for a ";
-                            if (mod.DataRecord.StatusUpperVersion == null || mod.Manifest.Version.Equals(mod.DataRecord.StatusUpperVersion))
+                            if (mod.DataRecord.StatusUpperVersion == null || mod.Manifest.Version?.Equals(mod.DataRecord.StatusUpperVersion) == true)
                                 error += "newer version";
                             else
                                 error += $"version newer than {mod.DataRecord.StatusUpperVersion}";
@@ -133,21 +134,21 @@ namespace StardewModdingAPI.Framework.ModLoading
                     if (hasDll)
                     {
                         // invalid filename format
-                        if (mod.Manifest.EntryDll.Intersect(Path.GetInvalidFileNameChars()).Any())
+                        if (mod.Manifest.EntryDll!.Intersect(Path.GetInvalidFileNameChars()).Any())
                         {
                             mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has invalid filename '{mod.Manifest.EntryDll}' for the EntryDLL field.");
                             continue;
                         }
 
                         // invalid path
-                        if (!File.Exists(Path.Combine(mod.DirectoryPath, mod.Manifest.EntryDll)))
+                        if (!File.Exists(Path.Combine(mod.DirectoryPath, mod.Manifest.EntryDll!)))
                         {
                             mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
                             continue;
                         }
 
                         // invalid capitalization
-                        string actualFilename = new DirectoryInfo(mod.DirectoryPath).GetFiles(mod.Manifest.EntryDll).FirstOrDefault()?.Name;
+                        string? actualFilename = new DirectoryInfo(mod.DirectoryPath).GetFiles(mod.Manifest.EntryDll!).FirstOrDefault()?.Name;
                         if (actualFilename != mod.Manifest.EntryDll)
                         {
                             mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its {nameof(IManifest.EntryDll)} value '{mod.Manifest.EntryDll}' doesn't match the actual file capitalization '{actualFilename}'. The capitalization must match for crossplatform compatibility.");
@@ -159,7 +160,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                     else
                     {
                         // invalid content pack ID
-                        if (string.IsNullOrWhiteSpace(mod.Manifest.ContentPackFor.UniqueID))
+                        if (string.IsNullOrWhiteSpace(mod.Manifest.ContentPackFor!.UniqueID))
                         {
                             mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.");
                             continue;
@@ -190,7 +191,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                     mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, "its manifest specifies an invalid ID (IDs must only contain letters, numbers, underscores, periods, or hyphens).");
 
                 // validate dependencies
-                foreach (var dependency in mod.Manifest.Dependencies)
+                foreach (IManifestDependency? dependency in mod.Manifest.Dependencies)
                 {
                     // null dependency
                     if (dependency == null)
@@ -328,8 +329,11 @@ namespace StardewModdingAPI.Framework.ModLoading
                 string[] failedLabels =
                     (
                         from entry in dependencies
-                        where entry.Mod != null && entry.MinVersion != null && entry.MinVersion.IsNewerThan(entry.Mod.Manifest.Version)
-                        select $"{entry.Mod.DisplayName} (needs {entry.MinVersion} or later)"
+                        where
+                            entry.Mod != null
+                            && entry.MinVersion != null
+                            && entry.MinVersion.IsNewerThan(entry.Mod.Manifest.Version)
+                        select $"{entry.Mod!.DisplayName} (needs {entry.MinVersion} or later)"
                     )
                     .ToArray();
                 if (failedLabels.Any())
@@ -345,16 +349,14 @@ namespace StardewModdingAPI.Framework.ModLoading
                 states[mod] = ModDependencyStatus.Checking;
 
                 // recursively sort dependencies
-                foreach (var dependency in dependencies)
+                foreach (ModDependency dependency in dependencies)
                 {
-                    IModMetadata requiredMod = dependency.Mod;
-                    var subchain = new List<IModMetadata>(currentChain) { mod };
-
-                    // ignore missing optional dependency
-                    if (!dependency.IsRequired && requiredMod == null)
-                        continue;
+                    IModMetadata? requiredMod = dependency.Mod;
+                    if (requiredMod == null)
+                        continue; // missing dependencies are handled earlier
 
                     // detect dependency loop
+                    var subchain = new List<IModMetadata>(currentChain) { mod };
                     if (states[requiredMod] == ModDependencyStatus.Checking)
                     {
                         sortedMods.Push(mod);
@@ -363,8 +365,8 @@ namespace StardewModdingAPI.Framework.ModLoading
                     }
 
                     // recursively process each dependency
-                    var substatus = this.ProcessDependencies(mods, modDatabase, requiredMod, states, sortedMods, subchain);
-                    switch (substatus)
+                    var subStatus = this.ProcessDependencies(mods, modDatabase, requiredMod, states, sortedMods, subchain);
+                    switch (subStatus)
                     {
                         // sorted successfully
                         case ModDependencyStatus.Sorted:
@@ -380,7 +382,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                         // unexpected status
                         case ModDependencyStatus.Queued:
                         case ModDependencyStatus.Checking:
-                            throw new InvalidModStateException($"Something went wrong sorting dependencies: mod '{requiredMod.DisplayName}' unexpectedly stayed in the '{substatus}' status.");
+                            throw new InvalidModStateException($"Something went wrong sorting dependencies: mod '{requiredMod.DisplayName}' unexpectedly stayed in the '{subStatus}' status.");
 
                         // sanity check
                         default:
@@ -399,14 +401,11 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="loadedMods">The loaded mods.</param>
         private IEnumerable<ModDependency> GetDependenciesFrom(IManifest manifest, IModMetadata[] loadedMods)
         {
-            IModMetadata FindMod(string id) => loadedMods.FirstOrDefault(m => m.HasID(id));
+            IModMetadata? FindMod(string id) => loadedMods.FirstOrDefault(m => m.HasID(id));
 
             // yield dependencies
-            if (manifest.Dependencies != null)
-            {
-                foreach (var entry in manifest.Dependencies)
-                    yield return new ModDependency(entry.UniqueID, entry.MinimumVersion, FindMod(entry.UniqueID), entry.IsRequired);
-            }
+            foreach (IManifestDependency entry in manifest.Dependencies)
+                yield return new ModDependency(entry.UniqueID, entry.MinimumVersion, FindMod(entry.UniqueID), entry.IsRequired);
 
             // yield content pack parent
             if (manifest.ContentPackFor != null)
@@ -415,10 +414,10 @@ namespace StardewModdingAPI.Framework.ModLoading
 
         /// <summary>Get a technical message indicating why a mod's compatibility status was overridden, if applicable.</summary>
         /// <param name="mod">The mod metadata.</param>
-        private string GetTechnicalReasonForStatusOverride(IModMetadata mod)
+        private string? GetTechnicalReasonForStatusOverride(IModMetadata mod)
         {
             // get compatibility list record
-            var data = mod.DataRecord;
+            ModDataRecordVersionedFields? data = mod.DataRecord;
             if (data == null)
                 return null;
 
@@ -432,14 +431,14 @@ namespace StardewModdingAPI.Framework.ModLoading
             };
 
             // get reason
-            string[] reasons = new[] { mod.DataRecord.StatusReasonPhrase, mod.DataRecord.StatusReasonDetails }
+            string?[] reasons = new[] { data.StatusReasonPhrase, data.StatusReasonDetails }
                 .Where(p => !string.IsNullOrWhiteSpace(p))
                 .ToArray();
 
             // build message
             return
                 $"marked {statusLabel} in SMAPI's internal compatibility list for "
-                + (mod.DataRecord.StatusUpperVersion != null ? $"versions up to {mod.DataRecord.StatusUpperVersion}" : "all versions")
+                + (data.StatusUpperVersion != null ? $"versions up to {data.StatusUpperVersion}" : "all versions")
                 + ": "
                 + (reasons.Any() ? string.Join(": ", reasons) : "no reason given")
                 + ".";
@@ -459,13 +458,13 @@ namespace StardewModdingAPI.Framework.ModLoading
             public string ID { get; }
 
             /// <summary>The minimum required version (if any).</summary>
-            public ISemanticVersion MinVersion { get; }
+            public ISemanticVersion? MinVersion { get; }
 
             /// <summary>Whether the mod shouldn't be loaded if the dependency isn't available.</summary>
             public bool IsRequired { get; }
 
             /// <summary>The loaded mod that fulfills the dependency (if available).</summary>
-            public IModMetadata Mod { get; }
+            public IModMetadata? Mod { get; }
 
 
             /*********
@@ -476,7 +475,7 @@ namespace StardewModdingAPI.Framework.ModLoading
             /// <param name="minVersion">The minimum required version (if any).</param>
             /// <param name="mod">The loaded mod that fulfills the dependency (if available).</param>
             /// <param name="isRequired">Whether the mod shouldn't be loaded if the dependency isn't available.</param>
-            public ModDependency(string id, ISemanticVersion minVersion, IModMetadata mod, bool isRequired)
+            public ModDependency(string id, ISemanticVersion? minVersion, IModMetadata? mod, bool isRequired)
             {
                 this.ID = id;
                 this.MinVersion = minVersion;
diff --git a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
index 806fca62..d5f4cf4a 100644
--- a/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
+++ b/src/SMAPI/Framework/ModLoading/Rewriters/FieldReplaceRewriter.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Reflection;
@@ -33,13 +31,19 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /// <param name="toFieldName">The new field name to reference.</param>
         public FieldReplaceRewriter AddField(Type fromType, string fromFieldName, Type toType, string toFieldName)
         {
+            // validate parameters
+            if (fromType == null)
+                throw new InvalidOperationException("Can't replace a field on a null source type.");
+            if (toType == null)
+                throw new InvalidOperationException("Can't replace a field on a null target type.");
+
             // get full type name
-            string fromTypeName = fromType?.FullName;
+            string? fromTypeName = fromType.FullName;
             if (fromTypeName == null)
                 throw new InvalidOperationException($"Can't replace field for invalid type reference {toType}.");
 
             // get target field
-            FieldInfo toField = toType.GetField(toFieldName);
+            FieldInfo? toField = toType.GetField(toFieldName);
             if (toField == null)
                 throw new InvalidOperationException($"The {toType.FullName} class doesn't have a {toFieldName} field.");
 
@@ -54,15 +58,15 @@ namespace StardewModdingAPI.Framework.ModLoading.Rewriters
         /// <inheritdoc />
         public override bool Handle(ModuleDefinition module, ILProcessor cil, Instruction instruction)
         {
-            FieldReference fieldRef = RewriteHelper.AsFieldReference(instruction);
-            string declaringType = fieldRef?.DeclaringType?.FullName;
+            FieldReference? fieldRef = RewriteHelper.AsFieldReference(instruction);
+            string? declaringType = fieldRef?.DeclaringType?.FullName;
 
             // get mapped field
-            if (declaringType == null || !this.FieldMaps.TryGetValue(declaringType, out var fieldMap) || !fieldMap.TryGetValue(fieldRef.Name, out FieldInfo toField))
+            if (declaringType == null || !this.FieldMaps.TryGetValue(declaringType, out var fieldMap) || !fieldMap.TryGetValue(fieldRef!.Name, out FieldInfo? toField))
                 return false;
 
             // replace with new field
-            this.Phrases.Add($"{fieldRef.DeclaringType.Name}.{fieldRef.Name} field");
+            this.Phrases.Add($"{fieldRef.DeclaringType!.Name}.{fieldRef.Name} field");
             instruction.Operand = module.ImportReference(toField);
             return this.MarkRewritten();
         }
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index e74d73b5..d626ab4d 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -40,60 +38,96 @@ namespace StardewModdingAPI.Framework.Models
         ** Accessors
         ********/
         /// <summary>Whether to enable development features.</summary>
-        public bool DeveloperMode { get; set; }
+        public bool DeveloperMode { get; private set; }
 
         /// <summary>Whether to check for newer versions of SMAPI and mods on startup.</summary>
-        public bool CheckForUpdates { get; set; }
+        public bool CheckForUpdates { get; }
 
         /// <summary>Whether to add a section to the 'mod issues' list for mods which which directly use potentially sensitive .NET APIs like file or shell access.</summary>
-        public bool ParanoidWarnings { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.ParanoidWarnings)];
+        public bool ParanoidWarnings { get; }
 
         /// <summary>Whether to show beta versions as valid updates.</summary>
-        public bool UseBetaChannel { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.UseBetaChannel)];
+        public bool UseBetaChannel { get; }
 
         /// <summary>SMAPI's GitHub project name, used to perform update checks.</summary>
-        public string GitHubProjectName { get; set; }
+        public string GitHubProjectName { get; }
 
         /// <summary>The base URL for SMAPI's web API, used to perform update checks.</summary>
-        public string WebApiBaseUrl { get; set; }
+        public string WebApiBaseUrl { get; }
 
         /// <summary>Whether SMAPI should log more information about the game context.</summary>
-        public bool VerboseLogging { get; set; }
+        public bool VerboseLogging { get; }
 
         /// <summary>Whether SMAPI should rewrite mods for compatibility.</summary>
-        public bool RewriteMods { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
+        public bool RewriteMods { get; }
 
         /// <summary>Whether to enable more aggressive memory optimizations.</summary>
-        public bool AggressiveMemoryOptimizations { get; set; } = (bool)SConfig.DefaultValues[nameof(SConfig.AggressiveMemoryOptimizations)];
+        public bool AggressiveMemoryOptimizations { get; }
 
         /// <summary>Whether SMAPI should log network traffic. Best combined with <see cref="VerboseLogging"/>, which includes network metadata.</summary>
-        public bool LogNetworkTraffic { get; set; }
+        public bool LogNetworkTraffic { get; }
 
         /// <summary>The colors to use for text written to the SMAPI console.</summary>
-        public ColorSchemeConfig ConsoleColors { get; set; }
+        public ColorSchemeConfig ConsoleColors { get; }
 
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
-        public string[] SuppressUpdateChecks { get; set; }
+        public string[] SuppressUpdateChecks { get; }
 
 
         /********
         ** Public methods
         ********/
-        /// <summary>Get the settings which have been customized by the player.</summary>
-        public IDictionary<string, object> GetCustomSettings()
+        /// <summary>Construct an instance.</summary>
+        /// <param name="developerMode">Whether to enable development features.</param>
+        /// <param name="checkForUpdates">Whether to check for newer versions of SMAPI and mods on startup.</param>
+        /// <param name="paranoidWarnings">Whether to add a section to the 'mod issues' list for mods which which directly use potentially sensitive .NET APIs like file or shell access.</param>
+        /// <param name="useBetaChannel">Whether to show beta versions as valid updates.</param>
+        /// <param name="gitHubProjectName">SMAPI's GitHub project name, used to perform update checks.</param>
+        /// <param name="webApiBaseUrl">The base URL for SMAPI's web API, used to perform update checks.</param>
+        /// <param name="verboseLogging">Whether SMAPI should log more information about the game context.</param>
+        /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
+        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
+        /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
+        /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
+        public SConfig(bool developerMode, bool checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool verboseLogging, bool? rewriteMods, bool? aggressiveMemoryOptimizations, bool logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
-            IDictionary<string, object> custom = new Dictionary<string, object>();
+            this.DeveloperMode = developerMode;
+            this.CheckForUpdates = checkForUpdates;
+            this.ParanoidWarnings = paranoidWarnings ?? (bool)SConfig.DefaultValues[nameof(SConfig.ParanoidWarnings)];
+            this.UseBetaChannel = useBetaChannel ?? (bool)SConfig.DefaultValues[nameof(SConfig.UseBetaChannel)];
+            this.GitHubProjectName = gitHubProjectName;
+            this.WebApiBaseUrl = webApiBaseUrl;
+            this.VerboseLogging = verboseLogging;
+            this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
+            this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations ?? (bool)SConfig.DefaultValues[nameof(SConfig.AggressiveMemoryOptimizations)];
+            this.LogNetworkTraffic = logNetworkTraffic;
+            this.ConsoleColors = consoleColors;
+            this.SuppressUpdateChecks = suppressUpdateChecks ?? Array.Empty<string>();
+        }
 
-            foreach (var pair in SConfig.DefaultValues)
+        /// <summary>Override the value of <see cref="DeveloperMode"/>.</summary>
+        /// <param name="value">The value to set.</param>
+        public void OverrideDeveloperMode(bool value)
+        {
+            this.DeveloperMode = value;
+        }
+
+        /// <summary>Get the settings which have been customized by the player.</summary>
+        public IDictionary<string, object?> GetCustomSettings()
+        {
+            Dictionary<string, object?> custom = new();
+
+            foreach ((string? name, object defaultValue) in SConfig.DefaultValues)
             {
-                object value = typeof(SConfig).GetProperty(pair.Key)?.GetValue(this);
-                if (!pair.Value.Equals(value))
-                    custom[pair.Key] = value;
+                object? value = typeof(SConfig).GetProperty(name)?.GetValue(this);
+                if (!defaultValue.Equals(value))
+                    custom[name] = value;
             }
 
-            HashSet<string> curSuppressUpdateChecks = new HashSet<string>(this.SuppressUpdateChecks ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
+            HashSet<string> curSuppressUpdateChecks = new(this.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
             if (SConfig.DefaultSuppressUpdateChecks.Count != curSuppressUpdateChecks.Count || SConfig.DefaultSuppressUpdateChecks.Any(p => !curSuppressUpdateChecks.Contains(p)))
-                custom[nameof(this.SuppressUpdateChecks)] = "[" + string.Join(", ", this.SuppressUpdateChecks ?? Array.Empty<string>()) + "]";
+                custom[nameof(this.SuppressUpdateChecks)] = "[" + string.Join(", ", this.SuppressUpdateChecks) + "]";
 
             return custom;
         }
diff --git a/src/SMAPI/Framework/Networking/ModMessageModel.cs b/src/SMAPI/Framework/Networking/ModMessageModel.cs
index 4e7d01eb..01672714 100644
--- a/src/SMAPI/Framework/Networking/ModMessageModel.cs
+++ b/src/SMAPI/Framework/Networking/ModMessageModel.cs
@@ -1,6 +1,5 @@
-#nullable disable
-
 using System.Linq;
+using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
 
 namespace StardewModdingAPI.Framework.Networking
@@ -15,33 +14,30 @@ namespace StardewModdingAPI.Framework.Networking
         ** Origin
         ****/
         /// <summary>The unique ID of the player who broadcast the message.</summary>
-        public long FromPlayerID { get; set; }
+        public long FromPlayerID { get; }
 
         /// <summary>The unique ID of the mod which broadcast the message.</summary>
-        public string FromModID { get; set; }
+        public string FromModID { get; }
 
         /****
         ** Destination
         ****/
         /// <summary>The players who should receive the message.</summary>
-        public long[] ToPlayerIDs { get; set; }
+        public long[]? ToPlayerIDs { get; init; }
 
         /// <summary>The mods which should receive the message, or <c>null</c> for all mods.</summary>
-        public string[] ToModIDs { get; set; }
+        public string[]? ToModIDs { get; }
 
         /// <summary>A message type which receiving mods can use to decide whether it's the one they want to handle, like <c>SetPlayerLocation</c>. This doesn't need to be globally unique, since mods should check the originating mod ID.</summary>
-        public string Type { get; set; }
+        public string Type { get; }
 
         /// <summary>The custom mod data being broadcast.</summary>
-        public JToken Data { get; set; }
+        public JToken Data { get; }
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        public ModMessageModel() { }
-
         /// <summary>Construct an instance.</summary>
         /// <param name="fromPlayerID">The unique ID of the player who broadcast the message.</param>
         /// <param name="fromModID">The unique ID of the mod which broadcast the message.</param>
@@ -49,7 +45,8 @@ namespace StardewModdingAPI.Framework.Networking
         /// <param name="toModIDs">The mods which should receive the message, or <c>null</c> for all mods.</param>
         /// <param name="type">A message type which receiving mods can use to decide whether it's the one they want to handle, like <c>SetPlayerLocation</c>. This doesn't need to be globally unique, since mods should check the originating mod ID.</param>
         /// <param name="data">The custom mod data being broadcast.</param>
-        public ModMessageModel(long fromPlayerID, string fromModID, long[] toPlayerIDs, string[] toModIDs, string type, JToken data)
+        [JsonConstructor]
+        public ModMessageModel(long fromPlayerID, string fromModID, long[]? toPlayerIDs, string[]? toModIDs, string type, JToken data)
         {
             this.FromPlayerID = fromPlayerID;
             this.FromModID = fromModID;
diff --git a/src/SMAPI/Framework/Networking/MultiplayerPeer.cs b/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
index 8ee5c309..b37c1e89 100644
--- a/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
+++ b/src/SMAPI/Framework/Networking/MultiplayerPeer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -39,10 +37,10 @@ namespace StardewModdingAPI.Framework.Networking
         public GamePlatform? Platform { get; }
 
         /// <inheritdoc />
-        public ISemanticVersion GameVersion { get; }
+        public ISemanticVersion? GameVersion { get; }
 
         /// <inheritdoc />
-        public ISemanticVersion ApiVersion { get; }
+        public ISemanticVersion? ApiVersion { get; }
 
         /// <inheritdoc />
         public IEnumerable<IMultiplayerPeerMod> Mods { get; }
@@ -57,11 +55,12 @@ namespace StardewModdingAPI.Framework.Networking
         /// <param name="model">The metadata to copy.</param>
         /// <param name="sendMessage">A method which sends a message to the peer.</param>
         /// <param name="isHost">Whether this is a connection to the host player.</param>
-        public MultiplayerPeer(long playerID, int? screenID, RemoteContextModel model, Action<OutgoingMessage> sendMessage, bool isHost)
+        public MultiplayerPeer(long playerID, int? screenID, RemoteContextModel? model, Action<OutgoingMessage> sendMessage, bool isHost)
         {
             this.PlayerID = playerID;
             this.ScreenID = screenID;
             this.IsHost = isHost;
+
             if (model != null)
             {
                 this.Platform = model.Platform;
@@ -69,13 +68,16 @@ namespace StardewModdingAPI.Framework.Networking
                 this.ApiVersion = model.ApiVersion;
                 this.Mods = model.Mods.Select(mod => new MultiplayerPeerMod(mod)).ToArray();
             }
+            else
+                this.Mods = Array.Empty<IMultiplayerPeerMod>();
+
             this.SendMessageImpl = sendMessage;
         }
 
         /// <inheritdoc />
-        public IMultiplayerPeerMod GetMod(string id)
+        public IMultiplayerPeerMod? GetMod(string? id)
         {
-            if (string.IsNullOrWhiteSpace(id) || this.Mods == null || !this.Mods.Any())
+            if (string.IsNullOrWhiteSpace(id) || !this.Mods.Any())
                 return null;
 
             id = id.Trim();
diff --git a/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs b/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
index 6fdb9e54..1e150508 100644
--- a/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
+++ b/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System.Diagnostics.CodeAnalysis;
 
 namespace StardewModdingAPI.Framework.Networking
 {
@@ -22,10 +22,11 @@ namespace StardewModdingAPI.Framework.Networking
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod metadata.</param>
+        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The ID shouldn't be null, but we should handle it to avoid an error just in case.")]
         public MultiplayerPeerMod(RemoteContextModModel mod)
         {
             this.Name = mod.Name;
-            this.ID = mod.ID?.Trim();
+            this.ID = mod.ID?.Trim() ?? string.Empty;
             this.Version = mod.Version;
         }
     }
diff --git a/src/SMAPI/Framework/Networking/RemoteContextModModel.cs b/src/SMAPI/Framework/Networking/RemoteContextModModel.cs
index 0383576c..7571acba 100644
--- a/src/SMAPI/Framework/Networking/RemoteContextModModel.cs
+++ b/src/SMAPI/Framework/Networking/RemoteContextModModel.cs
@@ -1,17 +1,33 @@
-#nullable disable
-
 namespace StardewModdingAPI.Framework.Networking
 {
     /// <summary>Metadata about an installed mod exchanged with connected computers.</summary>
     public class RemoteContextModModel
     {
-        /// <summary>The mod's display name.</summary>
-        public string Name { get; set; }
-
+        /*********
+        ** Accessors
+        *********/
         /// <summary>The unique mod ID.</summary>
-        public string ID { get; set; }
+        public string ID { get; }
+
+        /// <summary>The mod's display name.</summary>
+        public string Name { get; }
 
         /// <summary>The mod version.</summary>
-        public ISemanticVersion Version { get; set; }
+        public ISemanticVersion Version { get; }
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="id">The unique mod ID.</param>
+        /// <param name="name">The mod's display name.</param>
+        /// <param name="version">The mod version.</param>
+        public RemoteContextModModel(string id, string name, ISemanticVersion version)
+        {
+            this.ID = id;
+            this.Name = name;
+            this.Version = version;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Networking/RemoteContextModel.cs b/src/SMAPI/Framework/Networking/RemoteContextModel.cs
index 37fafa67..7d53e732 100644
--- a/src/SMAPI/Framework/Networking/RemoteContextModel.cs
+++ b/src/SMAPI/Framework/Networking/RemoteContextModel.cs
@@ -1,4 +1,4 @@
-#nullable disable
+using System;
 
 namespace StardewModdingAPI.Framework.Networking
 {
@@ -9,18 +9,37 @@ namespace StardewModdingAPI.Framework.Networking
         ** Accessors
         *********/
         /// <summary>Whether this player is the host player.</summary>
-        public bool IsHost { get; set; }
+        public bool IsHost { get; }
 
-        /// <summary>The game's platform version.</summary>
-        public GamePlatform Platform { get; set; }
+        /// <summary>The game's platform.</summary>
+        public GamePlatform Platform { get; }
 
         /// <summary>The installed version of Stardew Valley.</summary>
-        public ISemanticVersion GameVersion { get; set; }
+        public ISemanticVersion? GameVersion { get; }
 
         /// <summary>The installed version of SMAPI.</summary>
-        public ISemanticVersion ApiVersion { get; set; }
+        public ISemanticVersion? ApiVersion { get; }
 
         /// <summary>The installed mods.</summary>
-        public RemoteContextModModel[] Mods { get; set; }
+        public RemoteContextModModel[] Mods { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="isHost">Whether this player is the host player.</param>
+        /// <param name="platform">The game's platform.</param>
+        /// <param name="gameVersion">The installed version of Stardew Valley.</param>
+        /// <param name="apiVersion">The installed version of SMAPI.</param>
+        /// <param name="mods">The installed mods.</param>
+        public RemoteContextModel(bool isHost, GamePlatform platform, ISemanticVersion gameVersion, ISemanticVersion apiVersion, RemoteContextModModel[]? mods)
+        {
+            this.IsHost = isHost;
+            this.Platform = platform;
+            this.GameVersion = gameVersion;
+            this.ApiVersion = apiVersion;
+            this.Mods = mods ?? Array.Empty<RemoteContextModModel>();
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Reflection/CacheEntry.cs b/src/SMAPI/Framework/Reflection/CacheEntry.cs
index 6b18d204..27f48a1f 100644
--- a/src/SMAPI/Framework/Reflection/CacheEntry.cs
+++ b/src/SMAPI/Framework/Reflection/CacheEntry.cs
@@ -1,5 +1,4 @@
-#nullable disable
-
+using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
 
 namespace StardewModdingAPI.Framework.Reflection
@@ -11,21 +10,20 @@ namespace StardewModdingAPI.Framework.Reflection
         ** Accessors
         *********/
         /// <summary>Whether the lookup found a valid match.</summary>
-        public bool IsValid { get; }
+        [MemberNotNullWhen(true, nameof(CacheEntry.MemberInfo))]
+        public bool IsValid => this.MemberInfo != null;
 
         /// <summary>The reflection data for this member (or <c>null</c> if invalid).</summary>
-        public MemberInfo MemberInfo { get; }
+        public MemberInfo? MemberInfo { get; }
 
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="isValid">Whether the lookup found a valid match.</param>
         /// <param name="memberInfo">The reflection data for this member (or <c>null</c> if invalid).</param>
-        public CacheEntry(bool isValid, MemberInfo memberInfo)
+        public CacheEntry(MemberInfo? memberInfo)
         {
-            this.IsValid = isValid;
             this.MemberInfo = memberInfo;
         }
     }
diff --git a/src/SMAPI/Framework/Reflection/Reflector.cs b/src/SMAPI/Framework/Reflection/Reflector.cs
index c6fc2c79..3490ee97 100644
--- a/src/SMAPI/Framework/Reflection/Reflector.cs
+++ b/src/SMAPI/Framework/Reflection/Reflector.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 using System.Runtime.Caching;
@@ -14,7 +12,7 @@ namespace StardewModdingAPI.Framework.Reflection
         ** Fields
         *********/
         /// <summary>The cached fields and methods found via reflection.</summary>
-        private readonly MemoryCache Cache = new(typeof(Reflector).FullName);
+        private readonly MemoryCache Cache = new(typeof(Reflector).FullName!);
 
         /// <summary>The sliding cache expiration time.</summary>
         private readonly TimeSpan SlidingCacheExpiry = TimeSpan.FromMinutes(5);
@@ -30,8 +28,9 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <typeparam name="TValue">The field type.</typeparam>
         /// <param name="obj">The object which has the field.</param>
         /// <param name="name">The field name.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
-        /// <returns>Returns the field wrapper, or <c>null</c> if the field doesn't exist and <paramref name="required"/> is <c>false</c>.</returns>
+        /// <param name="required">Whether to throw an exception if the field isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the value non-nullable.</strong></param>
+        /// <returns>Returns the field wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the field doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target field doesn't exist, and <paramref name="required"/> is true.</exception>
         public IReflectedField<TValue> GetField<TValue>(object obj, string name, bool required = true)
         {
             // validate
@@ -39,24 +38,26 @@ namespace StardewModdingAPI.Framework.Reflection
                 throw new ArgumentNullException(nameof(obj), "Can't get a instance field from a null object.");
 
             // get field from hierarchy
-            IReflectedField<TValue> field = this.GetFieldFromHierarchy<TValue>(obj.GetType(), obj, name, BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
+            IReflectedField<TValue>? field = this.GetFieldFromHierarchy<TValue>(obj.GetType(), obj, name, BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
             if (required && field == null)
                 throw new InvalidOperationException($"The {obj.GetType().FullName} object doesn't have a '{name}' instance field.");
-            return field;
+            return field!;
         }
 
         /// <summary>Get a static field.</summary>
         /// <typeparam name="TValue">The field type.</typeparam>
         /// <param name="type">The type which has the field.</param>
         /// <param name="name">The field name.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
+        /// <param name="required">Whether to throw an exception if the field isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the value non-nullable.</strong></param>
+        /// <returns>Returns the field wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the field doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target field doesn't exist, and <paramref name="required"/> is true.</exception>
         public IReflectedField<TValue> GetField<TValue>(Type type, string name, bool required = true)
         {
             // get field from hierarchy
-            IReflectedField<TValue> field = this.GetFieldFromHierarchy<TValue>(type, null, name, BindingFlags.NonPublic | BindingFlags.Static | BindingFlags.Public);
+            IReflectedField<TValue>? field = this.GetFieldFromHierarchy<TValue>(type, null, name, BindingFlags.NonPublic | BindingFlags.Static | BindingFlags.Public);
             if (required && field == null)
                 throw new InvalidOperationException($"The {type.FullName} object doesn't have a '{name}' static field.");
-            return field;
+            return field!;
         }
 
         /****
@@ -66,7 +67,9 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <typeparam name="TValue">The property type.</typeparam>
         /// <param name="obj">The object which has the property.</param>
         /// <param name="name">The property name.</param>
-        /// <param name="required">Whether to throw an exception if the property is not found.</param>
+        /// <param name="required">Whether to throw an exception if the property isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the value non-nullable.</strong></param>
+        /// <returns>Returns the property wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the property doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target property doesn't exist, and <paramref name="required"/> is true.</exception>
         public IReflectedProperty<TValue> GetProperty<TValue>(object obj, string name, bool required = true)
         {
             // validate
@@ -74,24 +77,26 @@ namespace StardewModdingAPI.Framework.Reflection
                 throw new ArgumentNullException(nameof(obj), "Can't get a instance property from a null object.");
 
             // get property from hierarchy
-            IReflectedProperty<TValue> property = this.GetPropertyFromHierarchy<TValue>(obj.GetType(), obj, name, BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
+            IReflectedProperty<TValue>? property = this.GetPropertyFromHierarchy<TValue>(obj.GetType(), obj, name, BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
             if (required && property == null)
                 throw new InvalidOperationException($"The {obj.GetType().FullName} object doesn't have a '{name}' instance property.");
-            return property;
+            return property!;
         }
 
         /// <summary>Get a static property.</summary>
         /// <typeparam name="TValue">The property type.</typeparam>
         /// <param name="type">The type which has the property.</param>
         /// <param name="name">The property name.</param>
-        /// <param name="required">Whether to throw an exception if the property is not found.</param>
+        /// <param name="required">Whether to throw an exception if the property isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the value non-nullable.</strong></param>
+        /// <returns>Returns the property wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the property doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target property doesn't exist, and <paramref name="required"/> is true.</exception>
         public IReflectedProperty<TValue> GetProperty<TValue>(Type type, string name, bool required = true)
         {
             // get field from hierarchy
-            IReflectedProperty<TValue> property = this.GetPropertyFromHierarchy<TValue>(type, null, name, BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Static);
+            IReflectedProperty<TValue>? property = this.GetPropertyFromHierarchy<TValue>(type, null, name, BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Static);
             if (required && property == null)
                 throw new InvalidOperationException($"The {type.FullName} object doesn't have a '{name}' static property.");
-            return property;
+            return property!;
         }
 
         /****
@@ -99,8 +104,10 @@ namespace StardewModdingAPI.Framework.Reflection
         ****/
         /// <summary>Get a instance method.</summary>
         /// <param name="obj">The object which has the method.</param>
-        /// <param name="name">The field name.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
+        /// <param name="name">The method name.</param>
+        /// <param name="required">Whether to throw an exception if the method isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the value non-nullable.</strong></param>
+        /// <returns>Returns the method wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the method doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target method doesn't exist, and <paramref name="required"/> is true.</exception>
         public IReflectedMethod GetMethod(object obj, string name, bool required = true)
         {
             // validate
@@ -108,23 +115,25 @@ namespace StardewModdingAPI.Framework.Reflection
                 throw new ArgumentNullException(nameof(obj), "Can't get a instance method from a null object.");
 
             // get method from hierarchy
-            IReflectedMethod method = this.GetMethodFromHierarchy(obj.GetType(), obj, name, BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
+            IReflectedMethod? method = this.GetMethodFromHierarchy(obj.GetType(), obj, name, BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
             if (required && method == null)
                 throw new InvalidOperationException($"The {obj.GetType().FullName} object doesn't have a '{name}' instance method.");
-            return method;
+            return method!;
         }
 
         /// <summary>Get a static method.</summary>
         /// <param name="type">The type which has the method.</param>
-        /// <param name="name">The field name.</param>
-        /// <param name="required">Whether to throw an exception if the field is not found.</param>
+        /// <param name="name">The method name.</param>
+        /// <param name="required">Whether to throw an exception if the method isn't found. <strong>Due to limitations with nullable reference types, setting this to <c>false</c> will still mark the value non-nullable.</strong></param>
+        /// <returns>Returns the method wrapper, or <c>null</c> if <paramref name="required"/> is <c>false</c> and the method doesn't exist.</returns>
+        /// <exception cref="InvalidOperationException">The target method doesn't exist, and <paramref name="required"/> is true.</exception>
         public IReflectedMethod GetMethod(Type type, string name, bool required = true)
         {
             // get method from hierarchy
-            IReflectedMethod method = this.GetMethodFromHierarchy(type, null, name, BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Static);
+            IReflectedMethod? method = this.GetMethodFromHierarchy(type, null, name, BindingFlags.NonPublic | BindingFlags.Public | BindingFlags.Static);
             if (required && method == null)
                 throw new InvalidOperationException($"The {type.FullName} object doesn't have a '{name}' static method.");
-            return method;
+            return method!;
         }
 
 
@@ -134,18 +143,25 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <summary>Get a field from the type hierarchy.</summary>
         /// <typeparam name="TValue">The expected field type.</typeparam>
         /// <param name="type">The type which has the field.</param>
-        /// <param name="obj">The object which has the field.</param>
+        /// <param name="obj">The object which has the field, or <c>null</c> for a static field.</param>
         /// <param name="name">The field name.</param>
         /// <param name="bindingFlags">The reflection binding which flags which indicates what type of field to find.</param>
-        private IReflectedField<TValue> GetFieldFromHierarchy<TValue>(Type type, object obj, string name, BindingFlags bindingFlags)
+        private IReflectedField<TValue>? GetFieldFromHierarchy<TValue>(Type type, object? obj, string name, BindingFlags bindingFlags)
         {
             bool isStatic = bindingFlags.HasFlag(BindingFlags.Static);
-            FieldInfo field = this.GetCached<FieldInfo>($"field::{isStatic}::{type.FullName}::{name}", () =>
+            FieldInfo? field = this.GetCached($"field::{isStatic}::{type.FullName}::{name}", () =>
             {
-                FieldInfo fieldInfo = null;
-                for (; type != null && fieldInfo == null; type = type.BaseType)
-                    fieldInfo = type.GetField(name, bindingFlags);
-                return fieldInfo;
+                for (Type? curType = type; curType != null; curType = curType.BaseType)
+                {
+                    FieldInfo? fieldInfo = type.GetField(name, bindingFlags);
+                    if (fieldInfo != null)
+                    {
+                        type = curType;
+                        return fieldInfo;
+                    }
+                }
+
+                return null;
             });
 
             return field != null
@@ -156,18 +172,25 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <summary>Get a property from the type hierarchy.</summary>
         /// <typeparam name="TValue">The expected property type.</typeparam>
         /// <param name="type">The type which has the property.</param>
-        /// <param name="obj">The object which has the property.</param>
+        /// <param name="obj">The object which has the property, or <c>null</c> for a static property.</param>
         /// <param name="name">The property name.</param>
         /// <param name="bindingFlags">The reflection binding which flags which indicates what type of property to find.</param>
-        private IReflectedProperty<TValue> GetPropertyFromHierarchy<TValue>(Type type, object obj, string name, BindingFlags bindingFlags)
+        private IReflectedProperty<TValue>? GetPropertyFromHierarchy<TValue>(Type type, object? obj, string name, BindingFlags bindingFlags)
         {
             bool isStatic = bindingFlags.HasFlag(BindingFlags.Static);
-            PropertyInfo property = this.GetCached<PropertyInfo>($"property::{isStatic}::{type.FullName}::{name}", () =>
+            PropertyInfo? property = this.GetCached<PropertyInfo>($"property::{isStatic}::{type.FullName}::{name}", () =>
             {
-                PropertyInfo propertyInfo = null;
-                for (; type != null && propertyInfo == null; type = type.BaseType)
-                    propertyInfo = type.GetProperty(name, bindingFlags);
-                return propertyInfo;
+                for (Type? curType = type; curType != null; curType = curType.BaseType)
+                {
+                    PropertyInfo? propertyInfo = type.GetProperty(name, bindingFlags);
+                    if (propertyInfo != null)
+                    {
+                        type = curType;
+                        return propertyInfo;
+                    }
+                }
+
+                return null;
             });
 
             return property != null
@@ -177,18 +200,25 @@ namespace StardewModdingAPI.Framework.Reflection
 
         /// <summary>Get a method from the type hierarchy.</summary>
         /// <param name="type">The type which has the method.</param>
-        /// <param name="obj">The object which has the method.</param>
+        /// <param name="obj">The object which has the method, or <c>null</c> for a static method.</param>
         /// <param name="name">The method name.</param>
         /// <param name="bindingFlags">The reflection binding which flags which indicates what type of method to find.</param>
-        private IReflectedMethod GetMethodFromHierarchy(Type type, object obj, string name, BindingFlags bindingFlags)
+        private IReflectedMethod? GetMethodFromHierarchy(Type type, object? obj, string name, BindingFlags bindingFlags)
         {
             bool isStatic = bindingFlags.HasFlag(BindingFlags.Static);
-            MethodInfo method = this.GetCached($"method::{isStatic}::{type.FullName}::{name}", () =>
+            MethodInfo? method = this.GetCached($"method::{isStatic}::{type.FullName}::{name}", () =>
             {
-                MethodInfo methodInfo = null;
-                for (; type != null && methodInfo == null; type = type.BaseType)
-                    methodInfo = type.GetMethod(name, bindingFlags);
-                return methodInfo;
+                for (Type? curType = type; curType != null; curType = curType.BaseType)
+                {
+                    MethodInfo? methodInfo = type.GetMethod(name, bindingFlags);
+                    if (methodInfo != null)
+                    {
+                        type = curType;
+                        return methodInfo;
+                    }
+                }
+
+                return null;
             });
 
             return method != null
@@ -200,7 +230,8 @@ namespace StardewModdingAPI.Framework.Reflection
         /// <typeparam name="TMemberInfo">The expected <see cref="MemberInfo"/> type.</typeparam>
         /// <param name="key">The cache key.</param>
         /// <param name="fetch">Fetches a new value to cache.</param>
-        private TMemberInfo GetCached<TMemberInfo>(string key, Func<TMemberInfo> fetch) where TMemberInfo : MemberInfo
+        private TMemberInfo? GetCached<TMemberInfo>(string key, Func<TMemberInfo?> fetch)
+            where TMemberInfo : MemberInfo
         {
             // get from cache
             if (this.Cache.Contains(key))
@@ -212,8 +243,8 @@ namespace StardewModdingAPI.Framework.Reflection
             }
 
             // fetch & cache new value
-            TMemberInfo result = fetch();
-            CacheEntry cacheEntry = new(result != null, result);
+            TMemberInfo? result = fetch();
+            CacheEntry cacheEntry = new(result);
             this.Cache.Add(key, cacheEntry, new CacheItemPolicy { SlidingExpiration = this.SlidingCacheExpiry });
             return result;
         }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 364a7632..bce7cffa 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
@@ -92,13 +90,13 @@ namespace StardewModdingAPI.Framework
         private readonly CommandManager CommandManager;
 
         /// <summary>The underlying game instance.</summary>
-        private SGameRunner Game;
+        private SGameRunner Game = null!; // initialized very early
 
         /// <summary>SMAPI's content manager.</summary>
-        private ContentCoordinator ContentCore;
+        private ContentCoordinator ContentCore = null!; // initialized very early
 
         /// <summary>The game's core multiplayer utility for the main player.</summary>
-        private SMultiplayer Multiplayer;
+        private SMultiplayer Multiplayer = null!; // initialized very early
 
         /// <summary>Tracks the installed mods.</summary>
         /// <remarks>This is initialized after the game starts.</remarks>
@@ -146,19 +144,18 @@ namespace StardewModdingAPI.Framework
         private readonly ConcurrentQueue<string> RawCommandQueue = new();
 
         /// <summary>A list of commands to execute on each screen.</summary>
-        private readonly PerScreen<List<Tuple<Command, string, string[]>>> ScreenCommandQueue = new(() => new List<Tuple<Command, string, string[]>>());
-
+        private readonly PerScreen<List<QueuedCommand>> ScreenCommandQueue = new(() => new List<QueuedCommand>());
 
         /*********
         ** Accessors
         *********/
         /// <summary>Manages deprecation warnings.</summary>
         /// <remarks>This is initialized after the game starts. This is accessed directly because it's not part of the normal class model.</remarks>
-        internal static DeprecationManager DeprecationManager { get; private set; }
+        internal static DeprecationManager DeprecationManager { get; private set; } = null!; // initialized in constructor, which happens before other code can access it
 
         /// <summary>The singleton instance.</summary>
         /// <remarks>This is only intended for use by external code like the Error Handler mod.</remarks>
-        internal static SCore Instance { get; private set; }
+        internal static SCore Instance { get; private set; } = null!; // initialized in constructor, which happens before other code can access it
 
         /// <summary>The number of game update ticks which have already executed. This is similar to <see cref="Game1.ticks"/>, but incremented more consistently for every tick.</summary>
         internal static uint TicksElapsed { get; private set; }
@@ -191,7 +188,8 @@ namespace StardewModdingAPI.Framework
             this.Settings = JsonConvert.DeserializeObject<SConfig>(File.ReadAllText(Constants.ApiConfigPath));
             if (File.Exists(Constants.ApiUserConfigPath))
                 JsonConvert.PopulateObject(File.ReadAllText(Constants.ApiUserConfigPath), this.Settings);
-            this.Settings.DeveloperMode = developerMode ?? this.Settings.DeveloperMode;
+            if (developerMode.HasValue)
+                this.Settings.OverrideDeveloperMode(developerMode.Value);
 
             this.LogManager = new LogManager(logPath: logPath, colorConfig: this.Settings.ConsoleColors, writeToConsole: writeToConsole, isVerbose: this.Settings.VerboseLogging, isDeveloperMode: this.Settings.DeveloperMode, getScreenIdForLog: this.GetScreenIdForLog);
             this.CommandManager = new CommandManager(this.Monitor);
@@ -331,6 +329,7 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
+        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "May be disposed before SMAPI is fully initialized.")]
         public void Dispose()
         {
             // skip if already disposed
@@ -355,9 +354,9 @@ namespace StardewModdingAPI.Framework
             // dispose core components
             this.IsGameRunning = false;
             this.ContentCore?.Dispose();
-            this.CancellationToken?.Dispose();
+            this.CancellationToken.Dispose();
             this.Game?.Dispose();
-            this.LogManager?.Dispose(); // dispose last to allow for any last-second log messages
+            this.LogManager.Dispose(); // dispose last to allow for any last-second log messages
 
             // end game (moved from Game1.OnExiting to let us clean up first)
             Process.GetCurrentProcess().Kill();
@@ -517,12 +516,12 @@ namespace StardewModdingAPI.Framework
                 /*********
                 ** Parse commands
                 *********/
-                while (this.RawCommandQueue.TryDequeue(out string rawInput))
+                while (this.RawCommandQueue.TryDequeue(out string? rawInput))
                 {
                     // parse command
-                    string name;
-                    string[] args;
-                    Command command;
+                    string? name;
+                    string[]? args;
+                    Command? command;
                     int screenId;
                     try
                     {
@@ -539,7 +538,7 @@ namespace StardewModdingAPI.Framework
                     }
 
                     // queue command for screen
-                    this.ScreenCommandQueue.GetValueForScreen(screenId).Add(Tuple.Create(command, name, args));
+                    this.ScreenCommandQueue.GetValueForScreen(screenId).Add(new(command, name, args));
                 }
 
 
@@ -556,7 +555,7 @@ namespace StardewModdingAPI.Framework
             catch (Exception ex)
             {
                 // log error
-                this.Monitor.Log($"An error occured in the overridden update loop: {ex.GetLogSummary()}", LogLevel.Error);
+                this.Monitor.Log($"An error occurred in the overridden update loop: {ex.GetLogSummary()}", LogLevel.Error);
 
                 // exit if irrecoverable
                 if (!this.UpdateCrashTimer.Decrement())
@@ -575,7 +574,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="runUpdate">Invoke the game's update logic.</param>
         private void OnPlayerInstanceUpdating(SGame instance, GameTime gameTime, Action runUpdate)
         {
-            var events = this.EventManager;
+            EventManager events = this.EventManager;
 
             try
             {
@@ -595,12 +594,8 @@ namespace StardewModdingAPI.Framework
                 *********/
                 {
                     var commandQueue = this.ScreenCommandQueue.Value;
-                    foreach (var entry in commandQueue)
+                    foreach ((Command? command, string? name, string[]? args) in commandQueue)
                     {
-                        Command command = entry.Item1;
-                        string name = entry.Item2;
-                        string[] args = entry.Item3;
-
                         try
                         {
                             command.Callback.Invoke(name, args);
@@ -637,6 +632,7 @@ namespace StardewModdingAPI.Framework
                 {
                     this.Monitor.Log("Game loader synchronizing...");
                     this.Reflection.GetMethod(Game1.game1, "UpdateTitleScreen").Invoke(Game1.currentGameTime); // run game logic to change music on load, etc
+                    // ReSharper disable once ConstantConditionalAccessQualifier -- may become null within the loop
                     while (Game1.currentLoader?.MoveNext() == true)
                     {
                         SCore.ProcessTicksElapsed++;
@@ -825,7 +821,7 @@ namespace StardewModdingAPI.Framework
 
                             // raise cursor moved event
                             if (state.Cursor.IsChanged)
-                                events.CursorMoved.Raise(new CursorMovedEventArgs(state.Cursor.Old, state.Cursor.New));
+                                events.CursorMoved.Raise(new CursorMovedEventArgs(state.Cursor.Old!, state.Cursor.New!));
 
                             // raise mouse wheel scrolled
                             if (state.MouseWheelScroll.IsChanged)
@@ -956,7 +952,7 @@ namespace StardewModdingAPI.Framework
                         // raise player events
                         if (raiseWorldEvents)
                         {
-                            PlayerSnapshot playerState = state.CurrentPlayer;
+                            PlayerSnapshot playerState = state.CurrentPlayer!; // not null at this point
                             Farmer player = playerState.Player;
 
                             // raise current location changed
@@ -965,25 +961,25 @@ namespace StardewModdingAPI.Framework
                                 if (this.Monitor.IsVerbose)
                                     this.Monitor.Log($"Context: set location to {playerState.Location.New}.");
 
-                                events.Warped.Raise(new WarpedEventArgs(player, playerState.Location.Old, playerState.Location.New));
+                                events.Warped.Raise(new WarpedEventArgs(player, playerState.Location.Old!, playerState.Location.New!));
                             }
 
                             // raise player leveled up a skill
-                            foreach (var pair in playerState.Skills)
+                            foreach ((SkillType skill, var value) in playerState.Skills)
                             {
-                                if (!pair.Value.IsChanged)
+                                if (!value.IsChanged)
                                     continue;
 
                                 if (this.Monitor.IsVerbose)
-                                    this.Monitor.Log($"Events: player skill '{pair.Key}' changed from {pair.Value.Old} to {pair.Value.New}.");
+                                    this.Monitor.Log($"Events: player skill '{skill}' changed from {value.Old} to {value.New}.");
 
-                                events.LevelChanged.Raise(new LevelChangedEventArgs(player, pair.Key, pair.Value.Old, pair.Value.New));
+                                events.LevelChanged.Raise(new LevelChangedEventArgs(player, skill, value.Old, value.New));
                             }
 
                             // raise player inventory changed
                             if (playerState.Inventory.IsChanged)
                             {
-                                var inventory = playerState.Inventory;
+                                SnapshotItemListDiff inventory = playerState.Inventory;
 
                                 if (this.Monitor.IsVerbose)
                                     this.Monitor.Log("Events: player inventory changed.");
@@ -1070,7 +1066,8 @@ namespace StardewModdingAPI.Framework
             // update mod translation helpers
             foreach (IModMetadata mod in this.ModRegistry.GetAll())
             {
-                mod.Translations.SetLocale(locale, languageCode);
+                TranslationHelper translations = mod.Translations!; // not null at this point
+                translations.SetLocale(locale, languageCode);
 
                 foreach (ContentPack contentPack in mod.GetFakeContentPacks())
                     contentPack.TranslationImpl.SetLocale(locale, languageCode);
@@ -1117,7 +1114,7 @@ namespace StardewModdingAPI.Framework
                     break;
 
                 case LoadStage.Loaded:
-                    // override chatbox
+                    // override chat box
                     Game1.onScreenMenus.Remove(Game1.chatBox);
                     Game1.onScreenMenus.Add(Game1.chatBox = new SChatBox(this.LogManager.MonitorForGame));
                     break;
@@ -1182,7 +1179,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="id">The content pack ID.</param>
         /// <param name="verb">The verb phrase indicating what action will be performed, like 'load assets' or 'edit assets'.</param>
         /// <returns>Returns the content pack metadata if valid, else <c>null</c>.</returns>
-        private IModMetadata GetOnBehalfOfContentPack(IModMetadata mod, string id, string verb)
+        private IModMetadata? GetOnBehalfOfContentPack(IModMetadata mod, string? id, string verb)
         {
             if (id == null)
                 return null;
@@ -1190,7 +1187,7 @@ namespace StardewModdingAPI.Framework
             string errorPrefix = $"Can't {verb} on behalf of content pack ID '{id}'";
 
             // get target mod
-            IModMetadata onBehalfOf = this.ModRegistry.Get(id);
+            IModMetadata? onBehalfOf = this.ModRegistry.Get(id);
             if (onBehalfOf == null)
             {
                 mod.LogAsModOnce($"{errorPrefix}: there's no content pack installed with that ID.", LogLevel.Warn);
@@ -1198,7 +1195,7 @@ namespace StardewModdingAPI.Framework
             }
 
             // make sure it's a content pack for the requesting mod
-            if (!onBehalfOf.IsContentPack || !string.Equals(onBehalfOf.Manifest?.ContentPackFor?.UniqueID, mod.Manifest.UniqueID))
+            if (!onBehalfOf.IsContentPack || !string.Equals(onBehalfOf.Manifest.ContentPackFor?.UniqueID, mod.Manifest.UniqueID))
             {
                 mod.LogAsModOnce($"{errorPrefix}: that isn't a content pack for this mod.", LogLevel.Warn);
                 return null;
@@ -1232,7 +1229,7 @@ namespace StardewModdingAPI.Framework
                 modIDs.Remove(message.FromModID); // don't send a broadcast back to the sender
 
             // raise events
-            this.EventManager.ModMessageReceived.Raise(new ModMessageReceivedEventArgs(message, this.Toolkit.JsonHelper), mod => mod != null && modIDs.Contains(mod.Manifest.UniqueID));
+            this.EventManager.ModMessageReceived.Raise(new ModMessageReceivedEventArgs(message, this.Toolkit.JsonHelper), mod => modIDs.Contains(mod.Manifest.UniqueID));
         }
 
         /// <summary>Constructor a content manager to read game content files.</summary>
@@ -1241,6 +1238,7 @@ namespace StardewModdingAPI.Framework
         private LocalizedContentManager CreateContentManager(IServiceProvider serviceProvider, string rootDirectory)
         {
             // Game1._temporaryContent initializing from SGame constructor
+            // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- this is the method that initializes it
             if (this.ContentCore == null)
             {
                 this.ContentCore = new ContentCoordinator(
@@ -1293,21 +1291,21 @@ namespace StardewModdingAPI.Framework
                 // detect issues
                 bool hasObjectIssues = false;
                 void LogIssue(int id, string issue) => this.Monitor.Log($@"Detected issue: item #{id} in Content\Data\ObjectInformation.xnb is invalid ({issue}).");
-                foreach (KeyValuePair<int, string> entry in Game1.objectInformation)
+                foreach ((int id, string? fieldsStr) in Game1.objectInformation)
                 {
                     // must not be empty
-                    if (string.IsNullOrWhiteSpace(entry.Value))
+                    if (string.IsNullOrWhiteSpace(fieldsStr))
                     {
-                        LogIssue(entry.Key, "entry is empty");
+                        LogIssue(id, "entry is empty");
                         hasObjectIssues = true;
                         continue;
                     }
 
                     // require core fields
-                    string[] fields = entry.Value.Split('/');
+                    string[] fields = fieldsStr.Split('/');
                     if (fields.Length < SObject.objectInfoDescriptionIndex + 1)
                     {
-                        LogIssue(entry.Key, "too few fields for an object");
+                        LogIssue(id, "too few fields for an object");
                         hasObjectIssues = true;
                         continue;
                     }
@@ -1318,7 +1316,7 @@ namespace StardewModdingAPI.Framework
                         case "Cooking":
                             if (fields.Length < SObject.objectInfoBuffDurationIndex + 1)
                             {
-                                LogIssue(entry.Key, "too few fields for a cooking item");
+                                LogIssue(id, "too few fields for a cooking item");
                                 hasObjectIssues = true;
                             }
                             break;
@@ -1366,7 +1364,7 @@ namespace StardewModdingAPI.Framework
                 string[] installedNames = registryKeys
                     .SelectMany(registryKey =>
                     {
-                        using RegistryKey key = Registry.LocalMachine.OpenSubKey(registryKey);
+                        using RegistryKey? key = Registry.LocalMachine.OpenSubKey(registryKey);
                         if (key == null)
                             return Array.Empty<string>();
 
@@ -1374,9 +1372,9 @@ namespace StardewModdingAPI.Framework
                             .GetSubKeyNames()
                             .Select(subkeyName =>
                             {
-                                using RegistryKey subkey = key.OpenSubKey(subkeyName);
-                                string displayName = (string)subkey?.GetValue("DisplayName");
-                                string displayVersion = (string)subkey?.GetValue("DisplayVersion");
+                                using RegistryKey? subkey = key.OpenSubKey(subkeyName);
+                                string? displayName = (string?)subkey?.GetValue("DisplayName");
+                                string? displayVersion = (string?)subkey?.GetValue("DisplayVersion");
 
                                 if (displayName != null && displayVersion != null && displayName.EndsWith($" {displayVersion}"))
                                     displayName = displayName.Substring(0, displayName.Length - displayVersion.Length - 1);
@@ -1386,6 +1384,7 @@ namespace StardewModdingAPI.Framework
                             .ToArray();
                     })
                     .Where(name => name != null && (name.Contains("MSI Afterburner") || name.Contains("RivaTuner")))
+                    .Select(name => name!)
                     .Distinct()
                     .OrderBy(name => name)
                     .ToArray();
@@ -1418,14 +1417,14 @@ namespace StardewModdingAPI.Framework
 
                 // check SMAPI version
                 {
-                    ISemanticVersion updateFound = null;
-                    string updateUrl = null;
+                    ISemanticVersion? updateFound = null;
+                    string? updateUrl = null;
                     try
                     {
                         // fetch update check
                         ModEntryModel response = client.GetModInfo(new[] { new ModSearchEntryModel("Pathoschild.SMAPI", Constants.ApiVersion, new[] { $"GitHub:{this.Settings.GitHubProjectName}" }) }, apiVersion: Constants.ApiVersion, gameVersion: Constants.GameVersion, platform: Constants.Platform).Single().Value;
                         updateFound = response.SuggestedUpdate?.Version;
-                        updateUrl = response.SuggestedUpdate?.Url ?? Constants.HomePageUrl;
+                        updateUrl = response.SuggestedUpdate?.Url;
 
                         // log message
                         if (updateFound != null)
@@ -1451,7 +1450,7 @@ namespace StardewModdingAPI.Framework
 
                     // show update message on next launch
                     if (updateFound != null)
-                        this.LogManager.WriteUpdateMarker(updateFound.ToString(), updateUrl);
+                        this.LogManager.WriteUpdateMarker(updateFound.ToString(), updateUrl ?? Constants.HomePageUrl);
                 }
 
                 // check mod versions
@@ -1485,12 +1484,12 @@ namespace StardewModdingAPI.Framework
                         foreach (IModMetadata mod in mods.OrderBy(p => p.DisplayName))
                         {
                             // link to update-check data
-                            if (!mod.HasID() || !results.TryGetValue(mod.Manifest.UniqueID, out ModEntryModel result))
+                            if (!mod.HasID() || !results.TryGetValue(mod.Manifest.UniqueID, out ModEntryModel? result))
                                 continue;
                             mod.SetUpdateData(result);
 
                             // handle errors
-                            if (result.Errors != null && result.Errors.Any())
+                            if (result.Errors.Any())
                             {
                                 errors.AppendLine(result.Errors.Length == 1
                                     ? $"   {mod.DisplayName}: {result.Errors[0]}"
@@ -1512,13 +1511,8 @@ namespace StardewModdingAPI.Framework
                         {
                             this.Monitor.Newline();
                             this.Monitor.Log($"You can update {updates.Count} mod{(updates.Count != 1 ? "s" : "")}:", LogLevel.Alert);
-                            foreach (var entry in updates)
-                            {
-                                IModMetadata mod = entry.Item1;
-                                ISemanticVersion newVersion = entry.Item2;
-                                string newUrl = entry.Item3;
+                            foreach ((IModMetadata mod, ISemanticVersion newVersion, string newUrl) in updates)
                                 this.Monitor.Log($"   {mod.DisplayName} {newVersion}: {newUrl}", LogLevel.Alert);
-                            }
                         }
                         else
                             this.Monitor.Log("   All mods up to date.");
@@ -1571,9 +1565,8 @@ namespace StardewModdingAPI.Framework
                 // load mods
                 foreach (IModMetadata mod in mods)
                 {
-                    if (!this.TryLoadMod(mod, mods, modAssemblyLoader, proxyFactory, jsonHelper, contentCore, modDatabase, suppressUpdateChecks, out ModFailReason? failReason, out string errorPhrase, out string errorDetails))
+                    if (!this.TryLoadMod(mod, mods, modAssemblyLoader, proxyFactory, jsonHelper, contentCore, modDatabase, suppressUpdateChecks, out ModFailReason? failReason, out string? errorPhrase, out string? errorDetails))
                     {
-                        failReason ??= ModFailReason.LoadFailed;
                         mod.SetStatus(ModMetadataStatus.Failed, failReason.Value, errorPhrase, errorDetails);
                         skippedMods.Add(mod);
                     }
@@ -1599,7 +1592,7 @@ namespace StardewModdingAPI.Framework
             foreach (IModMetadata metadata in loadedMods)
             {
                 // add interceptors
-                if (metadata.Mod.Helper is ModHelper helper)
+                if (metadata.Mod?.Helper is ModHelper helper)
                 {
                     // ReSharper disable SuspiciousTypeConversion.Global
                     if (metadata.Mod is IAssetEditor editor)
@@ -1636,8 +1629,8 @@ namespace StardewModdingAPI.Framework
                 // call entry method
                 try
                 {
-                    IMod mod = metadata.Mod;
-                    mod.Entry(mod.Helper);
+                    IMod mod = metadata.Mod!;
+                    mod.Entry(mod.Helper!);
                 }
                 catch (Exception ex)
                 {
@@ -1647,7 +1640,7 @@ namespace StardewModdingAPI.Framework
                 // get mod API
                 try
                 {
-                    object api = metadata.Mod.GetApi();
+                    object? api = metadata.Mod!.GetApi();
                     if (api != null && !api.GetType().IsPublic)
                     {
                         api = null;
@@ -1676,7 +1669,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="added">The interceptors that were added.</param>
         /// <param name="removed">The interceptors that were removed.</param>
         /// <param name="list">A list of interceptors to update for the change.</param>
-        private void OnAssetInterceptorsChanged<T>(IModMetadata mod, IEnumerable<T> added, IEnumerable<T> removed, IList<ModLinked<T>> list)
+        private void OnAssetInterceptorsChanged<T>(IModMetadata mod, IEnumerable<T>? added, IEnumerable<T>? removed, IList<ModLinked<T>> list)
+            where T : notnull
         {
             foreach (T interceptor in added ?? Array.Empty<T>())
             {
@@ -1705,7 +1699,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="errorReasonPhrase">The user-facing reason phrase explaining why the mod couldn't be loaded (if applicable).</param>
         /// <param name="errorDetails">More detailed details about the error intended for developers (if any).</param>
         /// <returns>Returns whether the mod was successfully loaded.</returns>
-        private bool TryLoadMod(IModMetadata mod, IModMetadata[] mods, AssemblyLoader assemblyLoader, InterfaceProxyFactory proxyFactory, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase, HashSet<string> suppressUpdateChecks, out ModFailReason? failReason, out string errorReasonPhrase, out string errorDetails)
+        private bool TryLoadMod(IModMetadata mod, IModMetadata[] mods, AssemblyLoader assemblyLoader, InterfaceProxyFactory proxyFactory, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase, HashSet<string> suppressUpdateChecks, [NotNullWhen(false)] out ModFailReason? failReason, out string? errorReasonPhrase, out string? errorDetails)
         {
             errorDetails = null;
 
@@ -1714,6 +1708,7 @@ namespace StardewModdingAPI.Framework
                 string relativePath = mod.GetRelativePathWithRoot();
                 if (mod.IsContentPack)
                     this.Monitor.Log($"   {mod.DisplayName} (from {relativePath}) [content pack]...");
+                // ReSharper disable once ConstantConditionalAccessQualifier -- mod may be invalid at this point
                 else if (mod.Manifest?.EntryDll != null)
                     this.Monitor.Log($"   {mod.DisplayName} (from {relativePath}{Path.DirectorySeparatorChar}{mod.Manifest.EntryDll})..."); // don't use Path.Combine here, since EntryDLL might not be valid
                 else
@@ -1721,21 +1716,22 @@ namespace StardewModdingAPI.Framework
             }
 
             // add warning for missing update key
-            if (mod.HasID() && !suppressUpdateChecks.Contains(mod.Manifest.UniqueID) && !mod.HasValidUpdateKeys())
+            if (mod.HasID() && !suppressUpdateChecks.Contains(mod.Manifest!.UniqueID) && !mod.HasValidUpdateKeys())
                 mod.SetWarning(ModWarning.NoUpdateKeys);
 
             // validate status
             if (mod.Status == ModMetadataStatus.Failed)
             {
                 this.Monitor.Log($"      Failed: {mod.ErrorDetails ?? mod.Error}");
-                failReason = mod.FailReason;
+                failReason = mod.FailReason ?? ModFailReason.LoadFailed;
                 errorReasonPhrase = mod.Error;
                 return false;
             }
+            IManifest manifest = mod.Manifest!;
 
             // validate dependencies
             // Although dependencies are validated before mods are loaded, a dependency may have failed to load.
-            foreach (IManifestDependency dependency in mod.Manifest.Dependencies.Where(p => p.IsRequired))
+            foreach (IManifestDependency dependency in manifest.Dependencies.Where(p => p.IsRequired))
             {
                 if (this.ModRegistry.Get(dependency.UniqueID) == null)
                 {
@@ -1751,7 +1747,6 @@ namespace StardewModdingAPI.Framework
             // load as content pack
             if (mod.IsContentPack)
             {
-                IManifest manifest = mod.Manifest;
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
                 CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
                 GameContentHelper gameContentHelper = new(this.ContentCore, manifest.UniqueID, mod.DisplayName, monitor, this.Reflection);
@@ -1770,8 +1765,7 @@ namespace StardewModdingAPI.Framework
             else
             {
                 // get mod info
-                IManifest manifest = mod.Manifest;
-                string assemblyPath = Path.Combine(mod.DirectoryPath, manifest.EntryDll);
+                string assemblyPath = Path.Combine(mod.DirectoryPath, manifest.EntryDll!);
 
                 // load mod
                 Assembly modAssembly;
@@ -1782,7 +1776,7 @@ namespace StardewModdingAPI.Framework
                 }
                 catch (IncompatibleInstructionException) // details already in trace logs
                 {
-                    string[] updateUrls = new[] { modDatabase.GetModPageUrlFor(manifest.UniqueID), "https://smapi.io/mods" }.Where(p => p != null).ToArray();
+                    string[] updateUrls = new[] { modDatabase.GetModPageUrlFor(manifest.UniqueID), "https://smapi.io/mods" }.Where(p => p != null).ToArray()!;
                     errorReasonPhrase = $"it's no longer compatible. Please check for a new version at {string.Join(" or ", updateUrls)}";
                     failReason = ModFailReason.Incompatible;
                     return false;
@@ -1808,7 +1802,7 @@ namespace StardewModdingAPI.Framework
                 try
                 {
                     // get mod instance
-                    if (!this.TryLoadModEntry(modAssembly, out Mod modEntry, out errorReasonPhrase))
+                    if (!this.TryLoadModEntry(modAssembly, out Mod? modEntry, out errorReasonPhrase))
                     {
                         failReason = ModFailReason.LoadFailed;
                         return false;
@@ -1822,8 +1816,8 @@ namespace StardewModdingAPI.Framework
 
                         return this.ModRegistry
                             .GetAll(assemblyMods: false)
-                            .Where(p => p.IsContentPack && mod.HasID(p.Manifest.ContentPackFor.UniqueID))
-                            .Select(p => p.ContentPack)
+                            .Where(p => p.IsContentPack && mod.HasID(p.Manifest.ContentPackFor!.UniqueID))
+                            .Select(p => p.ContentPack!)
                             .ToArray();
                     }
 
@@ -1890,7 +1884,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="mod">The loaded instance.</param>
         /// <param name="error">The error indicating why loading failed (if applicable).</param>
         /// <returns>Returns whether the mod entry class was successfully loaded.</returns>
-        private bool TryLoadModEntry(Assembly modAssembly, out Mod mod, out string error)
+        private bool TryLoadModEntry(Assembly modAssembly, [NotNullWhen(true)] out Mod? mod, [NotNullWhen(false)] out string? error)
         {
             mod = null;
 
@@ -1908,7 +1902,7 @@ namespace StardewModdingAPI.Framework
             }
 
             // get implementation
-            mod = (Mod)modAssembly.CreateInstance(modEntries[0].ToString());
+            mod = (Mod?)modAssembly.CreateInstance(modEntries[0].ToString());
             if (mod == null)
             {
                 error = "its entry class couldn't be instantiated.";
@@ -1954,7 +1948,7 @@ namespace StardewModdingAPI.Framework
                             metadata.LogAsMod($"  - {error}", LogLevel.Warn);
                     }
 
-                    metadata.Translations.SetTranslations(translations);
+                    metadata.Translations!.SetTranslations(translations);
                 }
 
                 // fake content packs
@@ -1997,7 +1991,7 @@ namespace StardewModdingAPI.Framework
                     string locale = Path.GetFileNameWithoutExtension(file.Name.ToLower().Trim());
                     try
                     {
-                        if (!jsonHelper.ReadJsonFileIfExists(file.FullName, out IDictionary<string, string> data) || data == null)
+                        if (!jsonHelper.ReadJsonFileIfExists(file.FullName, out IDictionary<string, string>? data))
                         {
                             errors.Add($"{file.Name} file couldn't be read"); // mainly happens when the file is corrupted or empty
                             continue;
@@ -2016,8 +2010,8 @@ namespace StardewModdingAPI.Framework
             foreach (string locale in translations.Keys.ToArray())
             {
                 // handle duplicates
-                HashSet<string> keys = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
-                HashSet<string> duplicateKeys = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+                HashSet<string> keys = new(StringComparer.OrdinalIgnoreCase);
+                HashSet<string> duplicateKeys = new(StringComparer.OrdinalIgnoreCase);
                 foreach (string key in translations[locale].Keys.ToArray())
                 {
                     if (!keys.Add(key))
@@ -2107,5 +2101,15 @@ namespace StardewModdingAPI.Framework
 
             return null;
         }
+
+
+        /*********
+        ** Private types
+        *********/
+        /// <summary>A queued console command to run during the update loop.</summary>
+        /// <param name="Command">The command which can handle the input.</param>
+        /// <param name="Name">The parsed command name.</param>
+        /// <param name="Args">The parsed command arguments.</param>
+        private readonly record struct QueuedCommand(Command Command, string Name, string[] Args);
     }
 }
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index de3c25a5..c0e8ee81 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -61,7 +59,7 @@ namespace StardewModdingAPI.Framework
         private readonly PerScreen<IDictionary<long, MultiplayerPeer>> PeersImpl = new(() => new Dictionary<long, MultiplayerPeer>());
 
         /// <summary>The backing field for <see cref="HostPeer"/>.</summary>
-        private readonly PerScreen<MultiplayerPeer> HostPeerImpl = new();
+        private readonly PerScreen<MultiplayerPeer?> HostPeerImpl = new();
 
 
         /*********
@@ -71,7 +69,7 @@ namespace StardewModdingAPI.Framework
         public IDictionary<long, MultiplayerPeer> Peers => this.PeersImpl.Value;
 
         /// <summary>The metadata for the host player, if the current player is a farmhand.</summary>
-        public MultiplayerPeer HostPeer
+        public MultiplayerPeer? HostPeer
         {
             get => this.HostPeerImpl.Value;
             private set => this.HostPeerImpl.Value = value;
@@ -115,13 +113,13 @@ namespace StardewModdingAPI.Framework
             {
                 case LidgrenClient:
                     {
-                        string address = this.Reflection.GetField<string>(client, "address").GetValue();
+                        string address = this.Reflection.GetField<string>(client, "address").GetValue() ?? throw new InvalidOperationException("Can't initialize base networking client: no valid address found.");
                         return new SLidgrenClient(address, this.OnClientProcessingMessage, this.OnClientSendingMessage);
                     }
 
                 case GalaxyNetClient:
                     {
-                        GalaxyID address = this.Reflection.GetField<GalaxyID>(client, "lobbyId").GetValue();
+                        GalaxyID address = this.Reflection.GetField<GalaxyID>(client, "lobbyId").GetValue() ?? throw new InvalidOperationException("Can't initialize GOG networking client: no valid address found.");
                         return new SGalaxyNetClient(address, this.OnClientProcessingMessage, this.OnClientSendingMessage);
                     }
 
@@ -139,13 +137,13 @@ namespace StardewModdingAPI.Framework
             {
                 case LidgrenServer:
                     {
-                        IGameServer gameServer = this.Reflection.GetField<IGameServer>(server, "gameServer").GetValue();
+                        IGameServer gameServer = this.Reflection.GetField<IGameServer>(server, "gameServer").GetValue() ?? throw new InvalidOperationException("Can't initialize base networking client: the required 'gameServer' field wasn't found.");
                         return new SLidgrenServer(gameServer, this, this.OnServerProcessingMessage);
                     }
 
                 case GalaxyNetServer:
                     {
-                        IGameServer gameServer = this.Reflection.GetField<IGameServer>(server, "gameServer").GetValue();
+                        IGameServer gameServer = this.Reflection.GetField<IGameServer>(server, "gameServer").GetValue() ?? throw new InvalidOperationException("Can't initialize GOG networking client: the required 'gameServer' field wasn't found.");
                         return new SGalaxyNetServer(gameServer, this, this.OnServerProcessingMessage);
                     }
 
@@ -194,7 +192,7 @@ namespace StardewModdingAPI.Framework
                 case (byte)MessageType.ModContext:
                     {
                         // parse message
-                        RemoteContextModel model = this.ReadContext(message.Reader);
+                        RemoteContextModel? model = this.ReadContext(message.Reader);
                         this.Monitor.Log($"Received context for farmhand {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.");
 
                         // store peer
@@ -290,7 +288,7 @@ namespace StardewModdingAPI.Framework
                 case (byte)MessageType.ModContext:
                     {
                         // parse message
-                        RemoteContextModel model = this.ReadContext(message.Reader);
+                        RemoteContextModel? model = this.ReadContext(message.Reader);
                         this.Monitor.Log($"Received context for {(model?.IsHost == true ? "host" : "farmhand")} {message.FarmerID} running {(model != null ? $"SMAPI {model.ApiVersion} with {model.Mods.Length} mods" : "vanilla")}.");
 
                         // store peer
@@ -334,7 +332,7 @@ namespace StardewModdingAPI.Framework
                 case (byte)MessageType.PlayerIntroduction:
                     {
                         // store peer
-                        if (!this.Peers.TryGetValue(message.FarmerID, out MultiplayerPeer peer))
+                        if (!this.Peers.TryGetValue(message.FarmerID, out MultiplayerPeer? peer))
                         {
                             peer = new MultiplayerPeer(
                                 playerID: message.FarmerID,
@@ -367,7 +365,7 @@ namespace StardewModdingAPI.Framework
         {
             foreach (long playerID in this.disconnectingFarmers)
             {
-                if (this.Peers.TryGetValue(playerID, out MultiplayerPeer peer))
+                if (this.Peers.TryGetValue(playerID, out MultiplayerPeer? peer))
                 {
                     this.Monitor.Log($"Player quit: {playerID}");
                     this.Peers.Remove(playerID);
@@ -384,7 +382,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="fromModID">The unique ID of the mod sending the message.</param>
         /// <param name="toModIDs">The mod IDs which should receive the message on the destination computers, or <c>null</c> for all mods. Specifying mod IDs is recommended to improve performance, unless it's a general-purpose broadcast.</param>
         /// <param name="toPlayerIDs">The <see cref="Farmer.UniqueMultiplayerID" /> values for the players who should receive the message, or <c>null</c> for all players. If you don't need to broadcast to all players, specifying player IDs is recommended to reduce latency.</param>
-        public void BroadcastModMessage<TMessage>(TMessage message, string messageType, string fromModID, string[] toModIDs, long[] toPlayerIDs)
+        public void BroadcastModMessage<TMessage>(TMessage message, string messageType, string fromModID, string[]? toModIDs, long[]? toPlayerIDs)
         {
             // validate input
             if (message == null)
@@ -488,13 +486,13 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Read the metadata context for a player.</summary>
         /// <param name="reader">The stream reader.</param>
-        private RemoteContextModel ReadContext(BinaryReader reader)
+        private RemoteContextModel? ReadContext(BinaryReader reader)
         {
             string data = reader.ReadString();
             RemoteContextModel model = this.JsonHelper.Deserialize<RemoteContextModel>(data);
             return model.ApiVersion != null
                 ? model
-                : null; // no data available for unmodded players
+                : null; // no data available for vanilla players
         }
 
         /// <summary>Receive a mod message sent from another player's mods.</summary>
@@ -515,12 +513,15 @@ namespace StardewModdingAPI.Framework
             // forward to other players
             if (Context.IsMainPlayer && playerIDs.Any(p => p != Game1.player.UniqueMultiplayerID))
             {
-                ModMessageModel newModel = new(model);
                 foreach (long playerID in playerIDs)
                 {
-                    if (playerID != Game1.player.UniqueMultiplayerID && playerID != model.FromPlayerID && this.Peers.TryGetValue(playerID, out MultiplayerPeer peer))
+                    if (playerID != Game1.player.UniqueMultiplayerID && playerID != model.FromPlayerID && this.Peers.TryGetValue(playerID, out MultiplayerPeer? peer))
                     {
-                        newModel.ToPlayerIDs = new[] { peer.PlayerID };
+                        ModMessageModel newModel = new(model)
+                        {
+                            ToPlayerIDs = new[] { peer.PlayerID }
+                        };
+
                         this.Monitor.VerboseLog($"  Forwarding message to player {peer.PlayerID}.");
                         peer.SendMessage(new OutgoingMessage((byte)MessageType.ModMessage, peer.PlayerID, this.JsonHelper.Serialize(newModel, Formatting.None)));
                     }
@@ -546,22 +547,20 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get the fields to include in a context sync message sent to other players.</summary>
         private object[] GetContextSyncMessageFields()
         {
-            RemoteContextModel model = new()
-            {
-                IsHost = Context.IsWorldReady && Context.IsMainPlayer,
-                Platform = Constants.TargetPlatform,
-                ApiVersion = Constants.ApiVersion,
-                GameVersion = Constants.GameVersion,
-                Mods = this.ModRegistry
+            RemoteContextModel model = new(
+                isHost: Context.IsWorldReady && Context.IsMainPlayer,
+                platform: Constants.TargetPlatform,
+                apiVersion: Constants.ApiVersion,
+                gameVersion: Constants.GameVersion,
+                mods: this.ModRegistry
                     .GetAll()
-                    .Select(mod => new RemoteContextModModel
-                    {
-                        ID = mod.Manifest.UniqueID,
-                        Name = mod.Manifest.Name,
-                        Version = mod.Manifest.Version
-                    })
+                    .Select(mod => new RemoteContextModModel(
+                        id: mod.Manifest.UniqueID,
+                        name: mod.Manifest.Name,
+                        version: mod.Manifest.Version
+                    ))
                     .ToArray()
-            };
+            );
 
             return new object[] { this.JsonHelper.Serialize(model, Formatting.None) };
         }
@@ -573,21 +572,19 @@ namespace StardewModdingAPI.Framework
             if (!peer.HasSmapi)
                 return new object[] { "{}" };
 
-            RemoteContextModel model = new()
-            {
-                IsHost = peer.IsHost,
-                Platform = peer.Platform.Value,
-                ApiVersion = peer.ApiVersion,
-                GameVersion = peer.GameVersion,
-                Mods = peer.Mods
-                    .Select(mod => new RemoteContextModModel
-                    {
-                        ID = mod.ID,
-                        Name = mod.Name,
-                        Version = mod.Version
-                    })
+            RemoteContextModel model = new(
+                isHost: peer.IsHost,
+                platform: peer.Platform.Value,
+                apiVersion: peer.ApiVersion,
+                gameVersion: peer.GameVersion,
+                mods: peer.Mods
+                    .Select(mod => new RemoteContextModModel(
+                        id: mod.ID,
+                        name: mod.Name,
+                        version: mod.Version
+                    ))
                     .ToArray()
-            };
+            );
 
             return new object[] { this.JsonHelper.Serialize(model, Formatting.None) };
         }
diff --git a/src/SMAPI/Framework/Serialization/KeybindConverter.cs b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
index f3bab20d..539f1291 100644
--- a/src/SMAPI/Framework/Serialization/KeybindConverter.cs
+++ b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
@@ -53,13 +53,13 @@ namespace StardewModdingAPI.Framework.Serialization
 
                         if (objectType == typeof(Keybind))
                         {
-                            return Keybind.TryParse(str, out Keybind parsed, out string[] errors)
+                            return Keybind.TryParse(str, out Keybind? parsed, out string[] errors)
                                 ? parsed
                                 : throw new SParseException($"Can't parse {nameof(Keybind)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
                         }
                         else
                         {
-                            return KeybindList.TryParse(str, out KeybindList parsed, out string[] errors)
+                            return KeybindList.TryParse(str, out KeybindList? parsed, out string[] errors)
                                 ? parsed
                                 : throw new SParseException($"Can't parse {nameof(KeybindList)} from invalid value '{str}' (path: {path}).\n{string.Join("\n", errors)}");
                         }
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
index 4f94294c..5f76fe0a 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 
@@ -42,7 +40,8 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         {
             this.GetValue = getValue;
             this.Comparer = comparer;
-            this.PreviousValue = getValue();
+            this.CurrentValue = getValue();
+            this.PreviousValue = this.CurrentValue;
         }
 
         /// <summary>Update the current value if needed.</summary>
diff --git a/src/SMAPI/Framework/StateTracking/PlayerTracker.cs b/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
index 367eafea..5433ac8e 100644
--- a/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Framework.StateTracking.Comparers;
@@ -23,7 +22,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         private IDictionary<Item, int> CurrentInventory;
 
         /// <summary>The player's last valid location.</summary>
-        private GameLocation LastValidLocation;
+        private GameLocation? LastValidLocation;
 
         /// <summary>The underlying watchers.</summary>
         private readonly List<IWatcher> Watchers = new();
@@ -36,7 +35,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         public Farmer Player { get; }
 
         /// <summary>The player's current location.</summary>
-        public IValueWatcher<GameLocation> LocationWatcher { get; }
+        public IValueWatcher<GameLocation?> LocationWatcher { get; }
 
         /// <summary>Tracks changes to the player's skill levels.</summary>
         public IDictionary<SkillType, IValueWatcher<int>> SkillWatchers { get; }
@@ -51,7 +50,8 @@ namespace StardewModdingAPI.Framework.StateTracking
         {
             // init player data
             this.Player = player;
-            this.PreviousInventory = this.GetInventory();
+            this.CurrentInventory = this.GetInventory();
+            this.PreviousInventory = new Dictionary<Item, int>(this.CurrentInventory);
 
             // init trackers
             this.LocationWatcher = WatcherFactory.ForReference(this.GetCurrentLocation);
@@ -95,7 +95,7 @@ namespace StardewModdingAPI.Framework.StateTracking
 
         /// <summary>Get the player's current location, ignoring temporary null values.</summary>
         /// <remarks>The game will set <see cref="Character.currentLocation"/> to null in some cases, e.g. when they're a secondary player in multiplayer and transition to a location that hasn't been synced yet. While that's happening, this returns the player's last valid location instead.</remarks>
-        public GameLocation GetCurrentLocation()
+        public GameLocation? GetCurrentLocation()
         {
             return this.Player.currentLocation ?? this.LastValidLocation;
         }
@@ -103,7 +103,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         /// <summary>Get the inventory changes since the last update, if anything changed.</summary>
         /// <param name="changes">The inventory changes, or <c>null</c> if nothing changed.</param>
         /// <returns>Returns whether anything changed.</returns>
-        public bool TryGetInventoryChanges(out SnapshotItemListDiff changes)
+        public bool TryGetInventoryChanges([NotNullWhen(true)] out SnapshotItemListDiff? changes)
         {
             IDictionary<Item, int> current = this.GetInventory();
 
@@ -124,7 +124,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         public void Dispose()
         {
             this.PreviousInventory.Clear();
-            this.CurrentInventory?.Clear();
+            this.CurrentInventory.Clear();
 
             foreach (IWatcher watcher in this.Watchers)
                 watcher.Dispose();
diff --git a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
index bf81a35e..6a24ec30 100644
--- a/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
+++ b/src/SMAPI/Framework/StateTracking/Snapshots/PlayerSnapshot.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -47,17 +45,18 @@ namespace StardewModdingAPI.Framework.StateTracking.Snapshots
         public PlayerSnapshot(Farmer player)
         {
             this.Player = player;
+            this.Inventory = this.EmptyItemListDiff;
         }
 
         /// <summary>Update the tracked values.</summary>
         /// <param name="watcher">The player watcher to snapshot.</param>
         public void Update(PlayerTracker watcher)
         {
-            this.Location.Update(watcher.LocationWatcher);
-            foreach (var pair in this.Skills)
-                pair.Value.Update(watcher.SkillWatchers[pair.Key]);
+            this.Location.Update(watcher.LocationWatcher!);
+            foreach ((SkillType skill, var value) in this.Skills)
+                value.Update(watcher.SkillWatchers[skill]);
 
-            this.Inventory = watcher.TryGetInventoryChanges(out SnapshotItemListDiff itemChanges)
+            this.Inventory = watcher.TryGetInventoryChanges(out SnapshotItemListDiff? itemChanges)
                 ? itemChanges
                 : this.EmptyItemListDiff;
         }
diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
index 5f0ecfa0..b5fc1f57 100644
--- a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 // This temporary utility fixes an esoteric issue in XNA Framework where deserialization depends on
 // the order of fields returned by Type.GetFields, but that order changes after Harmony/MonoMod use
 // reflection to access the fields due to an issue in .NET Framework.
@@ -7,15 +5,15 @@
 //
 // This will be removed when Harmony/MonoMod are updated to incorporate the fix.
 //
-// Special thanks to 0x0ade for submitting this worokaround! Copy/pasted and adapted from MonoMod.
+// Special thanks to 0x0ade for submitting this workaround! Copy/pasted and adapted from MonoMod.
 
 using System;
-using System.Reflection;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
+using System.Reflection;
+using System.Reflection.Emit;
 using System.Runtime.CompilerServices;
 using HarmonyLib;
-using System.Reflection.Emit;
 
 // ReSharper disable once CheckNamespace -- Temporary hotfix submitted by the MonoMod author.
 namespace MonoMod.Utils
@@ -26,33 +24,33 @@ namespace MonoMod.Utils
     {
         // .NET Framework can break member ordering if using Module.Resolve* on certain members.
 
-        private static object[] _NoArgs = Array.Empty<object>();
-        private static object[] _CacheGetterArgs = { /* MemberListType.All */ 0, /* name apparently always null? */ null };
+        private static readonly object[] _NoArgs = Array.Empty<object>();
+        private static readonly object?[] _CacheGetterArgs = { /* MemberListType.All */ 0, /* name apparently always null? */ null };
 
-        private static Type t_RuntimeModule =
+        private static readonly Type? t_RuntimeModule =
             typeof(Module).Assembly
             .GetType("System.Reflection.RuntimeModule");
 
-        private static PropertyInfo p_RuntimeModule_RuntimeType =
+        private static readonly PropertyInfo? p_RuntimeModule_RuntimeType =
             typeof(Module).Assembly
             .GetType("System.Reflection.RuntimeModule")
             ?.GetProperty("RuntimeType", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
 
-        private static Type t_RuntimeType =
+        private static readonly Type? t_RuntimeType =
             typeof(Type).Assembly
             .GetType("System.RuntimeType");
 
-        private static PropertyInfo p_RuntimeType_Cache =
+        private static readonly PropertyInfo? p_RuntimeType_Cache =
             typeof(Type).Assembly
             .GetType("System.RuntimeType")
             ?.GetProperty("Cache", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
 
-        private static MethodInfo m_RuntimeTypeCache_GetFieldList =
+        private static readonly MethodInfo? m_RuntimeTypeCache_GetFieldList =
             typeof(Type).Assembly
             .GetType("System.RuntimeType+RuntimeTypeCache")
             ?.GetMethod("GetFieldList", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
 
-        private static MethodInfo m_RuntimeTypeCache_GetPropertyList =
+        private static readonly MethodInfo? m_RuntimeTypeCache_GetPropertyList =
             typeof(Type).Assembly
             .GetType("System.RuntimeType+RuntimeTypeCache")
             ?.GetMethod("GetPropertyList", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
@@ -65,37 +63,37 @@ namespace MonoMod.Utils
 
             harmony.Patch(
                 original: typeof(Harmony).Assembly
-                    .GetType("HarmonyLib.MethodBodyReader")
+                    .GetType("HarmonyLib.MethodBodyReader", throwOnError: true)!
                     .GetMethod("ReadOperand", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance),
                 transpiler: new HarmonyMethod(typeof(MiniMonoModHotfix), nameof(ResolveTokenFix))
             );
 
             harmony.Patch(
                 original: typeof(MonoMod.Utils.ReflectionHelper).Assembly
-                    .GetType("MonoMod.Utils.DynamicMethodDefinition+<>c__DisplayClass3_0")
+                    .GetType("MonoMod.Utils.DynamicMethodDefinition+<>c__DisplayClass3_0", throwOnError: true)!
                     .GetMethod("<_CopyMethodToDefinition>g__ResolveTokenAs|1", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance),
                 transpiler: new HarmonyMethod(typeof(MiniMonoModHotfix), nameof(ResolveTokenFix))
             );
 
         }
 
-        private static IEnumerable<CodeInstruction> ResolveTokenFix(IEnumerable<CodeInstruction> instrs)
+        private static IEnumerable<CodeInstruction> ResolveTokenFix(IEnumerable<CodeInstruction> instructions)
         {
-            MethodInfo getdecl = typeof(MiniMonoModHotfix).GetMethod(nameof(GetRealDeclaringType));
-            MethodInfo fixup = typeof(MiniMonoModHotfix).GetMethod(nameof(FixReflectionCache));
+            MethodInfo getRealDeclaringType = typeof(MiniMonoModHotfix).GetMethod(nameof(MiniMonoModHotfix.GetRealDeclaringType)) ?? throw new InvalidOperationException($"Can't get required method {nameof(MiniMonoModHotfix)}.{nameof(GetRealDeclaringType)}");
+            MethodInfo fixReflectionCache = typeof(MiniMonoModHotfix).GetMethod(nameof(MiniMonoModHotfix.FixReflectionCache)) ?? throw new InvalidOperationException($"Can't get required method {nameof(MiniMonoModHotfix)}.{nameof(FixReflectionCache)}");
 
-            foreach (CodeInstruction instr in instrs)
+            foreach (CodeInstruction instruction in instructions)
             {
-                yield return instr;
+                yield return instruction;
 
-                if (instr.operand is MethodInfo called)
+                if (instruction.operand is MethodInfo called)
                 {
                     switch (called.Name)
                     {
                         case "ResolveType":
                             // type.FixReflectionCache();
                             yield return new CodeInstruction(OpCodes.Dup);
-                            yield return new CodeInstruction(OpCodes.Call, fixup);
+                            yield return new CodeInstruction(OpCodes.Call, fixReflectionCache);
                             break;
 
                         case "ResolveMember":
@@ -103,15 +101,15 @@ namespace MonoMod.Utils
                         case "ResolveField":
                             // member.GetRealDeclaringType().FixReflectionCache();
                             yield return new CodeInstruction(OpCodes.Dup);
-                            yield return new CodeInstruction(OpCodes.Call, getdecl);
-                            yield return new CodeInstruction(OpCodes.Call, fixup);
+                            yield return new CodeInstruction(OpCodes.Call, getRealDeclaringType);
+                            yield return new CodeInstruction(OpCodes.Call, fixReflectionCache);
                             break;
                     }
                 }
             }
         }
 
-        public static Type GetModuleType(this Module module)
+        public static Type? GetModuleType(this Module? module)
         {
             // Sadly we can't blindly resolve type 0x02000001 as the runtime throws ArgumentException.
 
@@ -120,22 +118,21 @@ namespace MonoMod.Utils
 
             // .NET
             if (p_RuntimeModule_RuntimeType != null)
-                return (Type)p_RuntimeModule_RuntimeType.GetValue(module, _NoArgs);
+                return (Type?)p_RuntimeModule_RuntimeType.GetValue(module, _NoArgs);
 
             // The hotfix doesn't apply to Mono anyway, thus that's not copied over.
 
             return null;
         }
 
-        public static Type GetRealDeclaringType(this MemberInfo member)
-            => member.DeclaringType ?? member.Module.GetModuleType();
-
-        public static void FixReflectionCache(this Type type)
+        public static Type? GetRealDeclaringType(this MemberInfo member)
         {
-            if (t_RuntimeType == null ||
-                p_RuntimeType_Cache == null ||
-                m_RuntimeTypeCache_GetFieldList == null ||
-                m_RuntimeTypeCache_GetPropertyList == null)
+            return member.DeclaringType ?? member.Module.GetModuleType();
+        }
+
+        public static void FixReflectionCache(this Type? type)
+        {
+            if (t_RuntimeType == null || p_RuntimeType_Cache == null || m_RuntimeTypeCache_GetFieldList == null || m_RuntimeTypeCache_GetPropertyList == null)
                 return;
 
             for (; type != null; type = type.DeclaringType)
@@ -145,21 +142,17 @@ namespace MonoMod.Utils
                 if (!t_RuntimeType.IsInstanceOfType(type))
                     continue;
 
-                CacheFixEntry entry = _CacheFixed.GetValue(type, rt => {
-                    CacheFixEntry entryNew = new();
-                    object cache;
-                    Array properties, fields;
-
+                CacheFixEntry entry = _CacheFixed.GetValue(type, rt =>
+                {
                     // All RuntimeTypes MUST have a cache, the getter is non-virtual, it creates on demand and asserts non-null.
-                    entryNew.Cache = cache = p_RuntimeType_Cache.GetValue(rt, _NoArgs);
-                    entryNew.Properties = properties = _GetArray(cache, m_RuntimeTypeCache_GetPropertyList);
-                    entryNew.Fields = fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList);
+                    object cache = MiniMonoModHotfix.p_RuntimeType_Cache.GetValue(rt, MiniMonoModHotfix._NoArgs)!;
+                    Array properties = MiniMonoModHotfix._GetArray(cache, MiniMonoModHotfix.m_RuntimeTypeCache_GetPropertyList);
+                    Array fields = MiniMonoModHotfix._GetArray(cache, MiniMonoModHotfix.m_RuntimeTypeCache_GetFieldList);
 
                     _FixReflectionCacheOrder<PropertyInfo>(properties);
                     _FixReflectionCacheOrder<FieldInfo>(fields);
 
-                    entryNew.NeedsVerify = false;
-                    return entryNew;
+                    return new CacheFixEntry(cache, properties, fields, needsVerify: false);
                 });
 
                 if (entry.NeedsVerify && !_Verify(entry, type))
@@ -177,44 +170,43 @@ namespace MonoMod.Utils
 
         private static bool _Verify(CacheFixEntry entry, Type type)
         {
-            object cache;
-            Array properties, fields;
-
             // The cache can sometimes be invalidated.
             // TODO: Figure out if only the arrays get replaced or if the entire cache object gets replaced!
-            if (entry.Cache != (cache = p_RuntimeType_Cache.GetValue(type, _NoArgs)))
+            object cache = p_RuntimeType_Cache!.GetValue(type, _NoArgs)!;
+            if (entry.Cache != cache)
             {
                 entry.Cache = cache;
-                entry.Properties = _GetArray(cache, m_RuntimeTypeCache_GetPropertyList);
-                entry.Fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList);
+                entry.Properties = _GetArray(cache, m_RuntimeTypeCache_GetPropertyList!);
+                entry.Fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList!);
                 return false;
 
             }
-            else if (entry.Properties != (properties = _GetArray(cache, m_RuntimeTypeCache_GetPropertyList)))
+
+            Array properties = _GetArray(cache, m_RuntimeTypeCache_GetPropertyList!);
+            if (entry.Properties != properties)
             {
                 entry.Properties = properties;
-                entry.Fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList);
+                entry.Fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList!);
                 return false;
-
             }
-            else if (entry.Fields != (fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList)))
+
+            Array fields = _GetArray(cache, m_RuntimeTypeCache_GetFieldList!);
+            if (entry.Fields != fields)
             {
                 entry.Fields = fields;
                 return false;
 
             }
-            else
-            {
-                // Cache should still be the same, no re-fix necessary.
-                return true;
-            }
+
+            // Cache should still be the same, no re-fix necessary.
+            return true;
         }
 
         private static Array _GetArray(object cache, MethodInfo getter)
         {
             // Get and discard once, otherwise we might not be getting the actual backing array.
             getter.Invoke(cache, _CacheGetterArgs);
-            return (Array)getter.Invoke(cache, _CacheGetterArgs);
+            return (Array)getter.Invoke(cache, _CacheGetterArgs)!;
         }
 
         private static void _FixReflectionCacheOrder<T>(Array orig) where T : MemberInfo
@@ -222,7 +214,7 @@ namespace MonoMod.Utils
             // Sort using a short-lived list.
             List<T> list = new List<T>(orig.Length);
             for (int i = 0; i < orig.Length; i++)
-                list.Add((T)orig.GetValue(i));
+                list.Add((T)orig.GetValue(i)!);
 
             list.Sort((a, b) => a.MetadataToken - b.MetadataToken);
 
@@ -232,10 +224,18 @@ namespace MonoMod.Utils
 
         private class CacheFixEntry
         {
-            public object Cache;
+            public object? Cache;
             public Array Properties;
             public Array Fields;
             public bool NeedsVerify;
+
+            public CacheFixEntry(object? cache, Array properties, Array fields, bool needsVerify)
+            {
+                this.Cache = cache;
+                this.Properties = properties;
+                this.Fields = fields;
+                this.NeedsVerify = needsVerify;
+            }
         }
     }
 }
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index b7cec72c..f1b9af9a 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -712,7 +710,7 @@ namespace StardewModdingAPI.Metadata
             bool isPaintMask = assetName.BaseName.EndsWith(paintMaskSuffix, StringComparison.OrdinalIgnoreCase);
 
             // get building type
-            string type = Path.GetFileName(assetName.BaseName)!;
+            string type = Path.GetFileName(assetName.BaseName);
             if (isPaintMask)
                 type = type.Substring(0, type.Length - paintMaskSuffix.Length);
 
@@ -749,7 +747,7 @@ namespace StardewModdingAPI.Metadata
 
             if (!ignoreWorld)
             {
-                foreach (var location in this.GetLocations())
+                foreach (GameLocation location in this.GetLocations())
                 {
                     foreach (MapSeat seat in location.mapSeats.Where(p => p != null))
                     {
@@ -783,7 +781,7 @@ namespace StardewModdingAPI.Metadata
 
             // update sprites
             Texture2D texture = content.Load<Texture2D>(assetName.BaseName);
-            foreach (var entry in critters)
+            foreach (Critter entry in critters)
                 entry.sprite.spriteTexture = texture;
 
             return critters.Length;
@@ -799,16 +797,16 @@ namespace StardewModdingAPI.Metadata
 
             foreach (GameLocation location in this.GetLocations())
             {
-                IEnumerable<InteriorDoor> doors = location.interiorDoors?.Doors;
+                IEnumerable<InteriorDoor?>? doors = location.interiorDoors?.Doors;
                 if (doors == null)
                     continue;
 
-                foreach (InteriorDoor door in doors)
+                foreach (InteriorDoor? door in doors)
                 {
                     if (door?.Sprite == null)
                         continue;
 
-                    string curKey = this.Reflection.GetField<string>(door.Sprite, "textureName").GetValue();
+                    string? curKey = this.Reflection.GetField<string>(door.Sprite, "textureName").GetValue();
                     if (this.IsSameBaseName(assetName, curKey))
                         door.Sprite.texture = texture.Value;
                 }
@@ -933,7 +931,7 @@ namespace StardewModdingAPI.Metadata
             // warping onto the wrong tile (or even off-screen) if a patch changes the farmhouse
             // map on location change.
             if (playerPos.HasValue)
-                Game1.player.Position = playerPos.Value;
+                Game1.player!.Position = playerPos.Value;
         }
 
         /// <summary>Reload the disposition data for matching NPCs.</summary>
@@ -1003,7 +1001,11 @@ namespace StardewModdingAPI.Metadata
                 {
                     GameLocation adventureGuild = Game1.getLocationFromName("AdventureGuild");
                     if (adventureGuild != null)
-                        characters.Add(new { Npc = this.Reflection.GetField<NPC>(adventureGuild, "Gil").GetValue(), AssetName = gilKey });
+                    {
+                        NPC? gil = this.Reflection.GetField<NPC>(adventureGuild, "Gil").GetValue();
+                        if (gil != null)
+                            characters.Add(new { Npc = gil, AssetName = gilKey });
+                    }
                 }
             }
 
@@ -1029,7 +1031,7 @@ namespace StardewModdingAPI.Metadata
 
             foreach (Farmer player in players)
             {
-                this.Reflection.GetField<Dictionary<string, Dictionary<int, List<int>>>>(typeof(FarmerRenderer), "_recolorOffsets").GetValue().Remove(player.getTexture());
+                this.Reflection.GetField<Dictionary<string, Dictionary<int, List<int>>>>(typeof(FarmerRenderer), "_recolorOffsets").GetValue()?.Remove(player.getTexture());
                 player.FarmerRenderer.MarkSpriteDirty();
             }
 
@@ -1048,11 +1050,12 @@ namespace StardewModdingAPI.Metadata
             {
                 // get suspension bridges field
                 var field = this.Reflection.GetField<IEnumerable<SuspensionBridge>>(location, nameof(IslandNorth.suspensionBridges), required: false);
+                // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- field is nullable when required: false
                 if (field == null || !typeof(IEnumerable<SuspensionBridge>).IsAssignableFrom(field.FieldInfo.FieldType))
                     continue;
 
                 // update textures
-                foreach (SuspensionBridge bridge in field.GetValue())
+                foreach (SuspensionBridge bridge in field.GetValue()!)
                     this.Reflection.GetField<Texture2D>(bridge, "_texture").SetValue(texture.Value);
             }
 
@@ -1158,7 +1161,7 @@ namespace StardewModdingAPI.Metadata
             Game1.samBandName = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.2156");
             Game1.elliottBookName = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.2157");
 
-            string[] dayNames = this.Reflection.GetField<string[]>(typeof(Game1), "_shortDayDisplayName").GetValue();
+            string[] dayNames = this.Reflection.GetField<string[]>(typeof(Game1), "_shortDayDisplayName").GetValue()!;
             dayNames[0] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3042");
             dayNames[1] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3043");
             dayNames[2] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3044");
@@ -1227,7 +1230,7 @@ namespace StardewModdingAPI.Metadata
                 {
                     foreach (Building building in buildableLocation.buildings)
                     {
-                        GameLocation indoors = building.indoors.Value;
+                        GameLocation? indoors = building.indoors.Value;
                         if (indoors != null)
                             yield return new LocationInfo(indoors, building);
                     }
@@ -1238,19 +1241,19 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Get whether two asset names are equivalent if you ignore the locale code.</summary>
         /// <param name="left">The first value to compare.</param>
         /// <param name="right">The second value to compare.</param>
-        private bool IsSameBaseName(IAssetName left, string right)
+        private bool IsSameBaseName(IAssetName? left, string? right)
         {
             if (left is null || right is null)
                 return false;
 
-            IAssetName parsedB = this.ParseAssetNameOrNull(right);
+            IAssetName? parsedB = this.ParseAssetNameOrNull(right);
             return this.IsSameBaseName(left, parsedB);
         }
 
         /// <summary>Get whether two asset names are equivalent if you ignore the locale code.</summary>
         /// <param name="left">The first value to compare.</param>
         /// <param name="right">The second value to compare.</param>
-        private bool IsSameBaseName(IAssetName left, IAssetName right)
+        private bool IsSameBaseName(IAssetName? left, IAssetName? right)
         {
             if (left is null || right is null)
                 return false;
@@ -1260,7 +1263,7 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Normalize an asset key to match the cache key and assert that it's valid, but don't raise an error for null or empty values.</summary>
         /// <param name="path">The asset key to normalize.</param>
-        private IAssetName ParseAssetNameOrNull(string path)
+        private IAssetName? ParseAssetNameOrNull(string? path)
         {
             if (string.IsNullOrWhiteSpace(path))
                 return null;
@@ -1270,7 +1273,7 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Get the segments in a path (e.g. 'a/b' is 'a' and 'b').</summary>
         /// <param name="path">The path to check.</param>
-        private string[] GetSegments(string path)
+        private string[] GetSegments(string? path)
         {
             return path != null
                 ? PathUtilities.GetSegments(path)
@@ -1280,7 +1283,7 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Load a texture, and dispose the old one if <see cref="AggressiveMemoryOptimizations"/> is enabled and it's different from the new instance.</summary>
         /// <param name="oldTexture">The previous texture to dispose.</param>
         /// <param name="key">The asset key to load.</param>
-        private Texture2D LoadAndDisposeIfNeeded(Texture2D oldTexture, string key)
+        private Texture2D LoadAndDisposeIfNeeded(Texture2D? oldTexture, string key)
         {
             // if aggressive memory optimizations are enabled, load the asset from the disposable
             // content manager and dispose the old instance if needed.
@@ -1322,7 +1325,7 @@ namespace StardewModdingAPI.Metadata
             public GameLocation Location { get; }
 
             /// <summary>The building which contains the location, if any.</summary>
-            public Building ParentBuilding { get; }
+            public Building? ParentBuilding { get; }
 
 
             /*********
@@ -1331,7 +1334,7 @@ namespace StardewModdingAPI.Metadata
             /// <summary>Construct an instance.</summary>
             /// <param name="location">The location instance.</param>
             /// <param name="parentBuilding">The building which contains the location, if any.</param>
-            public LocationInfo(GameLocation location, Building parentBuilding)
+            public LocationInfo(GameLocation location, Building? parentBuilding)
             {
                 this.Location = location;
                 this.ParentBuilding = parentBuilding;
diff --git a/src/SMAPI/Translation.cs b/src/SMAPI/Translation.cs
index 2a0d2ce8..eb608f15 100644
--- a/src/SMAPI/Translation.cs
+++ b/src/SMAPI/Translation.cs
@@ -96,7 +96,7 @@ namespace StardewModdingAPI
             {
                 string key = match.Groups[1].Value.Trim();
                 return tokenLookup.TryGetValue(key, out string? value)
-                    ? value
+                    ? (value ?? "")
                     : match.Value;
             });
             return new Translation(this.Locale, this.Key, text);
diff --git a/src/SMAPI/Utilities/KeybindList.cs b/src/SMAPI/Utilities/KeybindList.cs
index 18eeb9fd..aa12a37a 100644
--- a/src/SMAPI/Utilities/KeybindList.cs
+++ b/src/SMAPI/Utilities/KeybindList.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI.Utilities
         /// <param name="input">The keybind string. See remarks on <see cref="ToString"/> for format details.</param>
         /// <param name="parsed">The parsed keybind list, if valid.</param>
         /// <param name="errors">The errors that occurred while parsing the input, if any.</param>
-        public static bool TryParse(string input, [NotNullWhen(true)] out KeybindList? parsed, out string[] errors)
+        public static bool TryParse(string? input, [NotNullWhen(true)] out KeybindList? parsed, out string[] errors)
         {
             // empty input
             if (string.IsNullOrWhiteSpace(input))
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index afe3ba91..799ff63b 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -1,8 +1,7 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using StardewModdingAPI.Framework;
 
 namespace StardewModdingAPI.Utilities
 {
@@ -39,14 +38,28 @@ namespace StardewModdingAPI.Utilities
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <remarks><strong>Limitation with nullable reference types:</strong> when the underlying type <typeparamref name="T"/> is nullable, this sets the default value to null regardless of whether you marked the type parameter nullable. To avoid that, set the default value with the 'createNewState' argument instead.</remarks>
         public PerScreen()
-            : this(null) { }
+            : this(null!) { }
 
         /// <summary>Construct an instance.</summary>
         /// <param name="createNewState">Create the initial state for a screen.</param>
         public PerScreen(Func<T> createNewState)
         {
-            this.CreateNewState = createNewState ?? (() => default);
+            // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- required for backwards compatibility
+            if (createNewState is null)
+            {
+                SCore.DeprecationManager.Warn(
+                    SCore.DeprecationManager.GetSourceNameFromStack(),
+                    $"calling the {nameof(PerScreen<T>)} constructor with null",
+                    "3.14.0",
+                    DeprecationLevel.Notice
+                );
+
+                createNewState = (() => default!);
+            }
+
+            this.CreateNewState = createNewState;
         }
 
         /// <summary>Get all active values by screen ID. This doesn't initialize the value for a screen ID if it's not created yet.</summary>
@@ -61,7 +74,7 @@ namespace StardewModdingAPI.Utilities
         public T GetValueForScreen(int screenId)
         {
             this.RemoveDeadScreens();
-            return this.States.TryGetValue(screenId, out T state)
+            return this.States.TryGetValue(screenId, out T? state)
                 ? state
                 : this.States[screenId] = this.CreateNewState();
         }

From 7c411b29bbe1323145d130eb8771c67617b6d3ee Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 21:07:58 -0400
Subject: [PATCH 549/856] fix spelling warnings

---
 .../Framework/GameScanning/GameScanner.cs         |  2 ++
 src/SMAPI.sln.DotSettings                         | 15 +++++++++++++++
 .../Framework/ModHelpers/TranslationHelper.cs     |  2 +-
 src/SMAPI/Framework/SChatBox.cs                   |  2 +-
 4 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 4f872f1c..8e1538a5 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using System.Xml.Linq;
@@ -13,6 +14,7 @@ using Microsoft.Win32;
 namespace StardewModdingAPI.Toolkit.Framework.GameScanning
 {
     /// <summary>Finds installed game folders.</summary>
+    [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These are valid game install paths.")]
     public class GameScanner
     {
         /*********
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index 866f2ed3..ad546665 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -25,8 +25,12 @@
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EMigrateBlankLinesAroundFieldToBlankLinesAroundProperty/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EMigrateThisQualifierSettings/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=analytics/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=backports/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=bigcraftable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=bigcraftables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Chucklefish/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=clickable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Comparers/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=craftable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=craftables/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=crossplatform/@EntryIndexedValue">True</s:Boolean>
@@ -36,6 +40,7 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=decoratable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=devs/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=disambiguator/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=equippable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=fallbacks/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=filenames/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=gamepad/@EntryIndexedValue">True</s:Boolean>
@@ -45,6 +50,8 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Junimo/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Keybind/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=keybinds/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Lidgren/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=minigames/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=modder/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=modders/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Mongo/@EntryIndexedValue">True</s:Boolean>
@@ -57,8 +64,11 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=premultiplied/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=premultiply/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Prenormalize/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Preprocesses/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=prerelease/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=pufferchick/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=rasterizer/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=reimplements/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rewriter/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rewriters/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=SMAPI/@EntryIndexedValue">True</s:Boolean>
@@ -67,15 +77,20 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=spritesheet/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=stackable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Stardew/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=subchain/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=subdomain/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=subkey/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=synchronised/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=tbin/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=textbox/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=thumbstick/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=tilesheet/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=tilesheets/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=tilesheet_0027s/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=transpiler/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=unloadable/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=unlocalized/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=versioning/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=virally/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Xbox/@EntryIndexedValue">True</s:Boolean>
 </wpf:ResourceDictionary>
\ No newline at end of file
diff --git a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
index 869664fe..d00ff279 100644
--- a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             return this;
         }
 
-        /// <summary>Set the current locale and precache translations.</summary>
+        /// <summary>Set the current locale and pre-cache translations.</summary>
         /// <param name="locale">The current locale.</param>
         /// <param name="localeEnum">The game's current language code.</param>
         internal void SetLocale(string locale, LocalizedContentManager.LanguageCode localeEnum)
diff --git a/src/SMAPI/Framework/SChatBox.cs b/src/SMAPI/Framework/SChatBox.cs
index e000d1cd..7d6f2e5f 100644
--- a/src/SMAPI/Framework/SChatBox.cs
+++ b/src/SMAPI/Framework/SChatBox.cs
@@ -3,7 +3,7 @@ using StardewValley.Menus;
 
 namespace StardewModdingAPI.Framework
 {
-    /// <summary>SMAPI's implementation of the chatbox which intercepts errors for logging.</summary>
+    /// <summary>SMAPI's implementation of the chat box which intercepts errors for logging.</summary>
     internal class SChatBox : ChatBox
     {
         /*********

From aa7b0caf4656d65ee156c3cf5ea786f561b850bb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 21:08:07 -0400
Subject: [PATCH 550/856] fix helpers not disposed if the mod is finalized

---
 src/SMAPI/Mod.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/SMAPI/Mod.cs b/src/SMAPI/Mod.cs
index cffe2998..f764752b 100644
--- a/src/SMAPI/Mod.cs
+++ b/src/SMAPI/Mod.cs
@@ -49,6 +49,7 @@ namespace StardewModdingAPI
         /// <summary>Destruct the instance.</summary>
         ~Mod()
         {
+            (this.Helper as IDisposable)?.Dispose(); // deliberately do this outside overridable dispose method so mods don't accidentally suppress it
             this.Dispose(false);
         }
     }

From 2765e3f9b379f0dc2a5732c1ca9ba23dbe2a7f15 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 22:06:07 -0400
Subject: [PATCH 551/856] enable nullable annotations in bundled mods (#837)

---
 .../Framework/Commands/ArgumentParser.cs      |  7 ++--
 .../Framework/Commands/ConsoleCommand.cs      |  2 -
 .../Framework/Commands/IConsoleCommand.cs     |  2 -
 .../Commands/Other/ApplySaveFixCommand.cs     |  4 +-
 .../Framework/Commands/Other/DebugCommand.cs  |  2 -
 .../Commands/Other/RegenerateBundles.cs       |  2 -
 .../Commands/Other/ShowDataFilesCommand.cs    |  2 -
 .../Commands/Other/ShowGameFilesCommand.cs    |  2 -
 .../Commands/Other/TestInputCommand.cs        |  2 -
 .../Framework/Commands/Player/AddCommand.cs   | 14 +++----
 .../Commands/Player/ListItemTypesCommand.cs   |  2 -
 .../Commands/Player/ListItemsCommand.cs       |  9 ++--
 .../Commands/Player/SetColorCommand.cs        |  6 +--
 .../Commands/Player/SetFarmTypeCommand.cs     | 14 +++----
 .../Commands/Player/SetHealthCommand.cs       |  2 -
 .../Commands/Player/SetImmunityCommand.cs     |  2 -
 .../Commands/Player/SetMaxHealthCommand.cs    |  2 -
 .../Commands/Player/SetMaxStaminaCommand.cs   |  2 -
 .../Commands/Player/SetMoneyCommand.cs        |  2 -
 .../Commands/Player/SetNameCommand.cs         |  6 +--
 .../Commands/Player/SetStaminaCommand.cs      |  2 -
 .../Commands/Player/SetStyleCommand.cs        |  4 +-
 .../Framework/Commands/World/ClearCommand.cs  | 23 +++++-----
 .../Commands/World/DownMineLevelCommand.cs    |  2 -
 .../Commands/World/FreezeTimeCommand.cs       |  2 -
 .../Commands/World/HurryAllCommand.cs         |  2 -
 .../Framework/Commands/World/SetDayCommand.cs |  2 -
 .../Commands/World/SetMineLevelCommand.cs     |  2 -
 .../Commands/World/SetSeasonCommand.cs        |  4 +-
 .../Commands/World/SetTimeCommand.cs          |  2 -
 .../Commands/World/SetYearCommand.cs          |  2 -
 .../Framework/ItemData/SearchableItem.cs      |  2 -
 .../Framework/ItemRepository.cs               | 42 +++++++++++--------
 src/SMAPI.Mods.ConsoleCommands/ModEntry.cs    | 14 +++----
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  6 +--
 .../Patches/DialoguePatcher.cs                | 10 ++---
 .../Patches/EventPatcher.cs                   |  4 +-
 .../Patches/GameLocationPatcher.cs            |  9 ++--
 .../Patches/IClickableMenuPatcher.cs          |  2 -
 .../Patches/NpcPatcher.cs                     |  8 ++--
 .../Patches/ObjectPatcher.cs                  |  4 +-
 .../Patches/SaveGamePatcher.cs                | 10 ++---
 .../Patches/SpriteBatchPatcher.cs             |  6 +--
 .../Patches/UtilityPatcher.cs                 |  4 +-
 src/SMAPI.Mods.SaveBackup/ModEntry.cs         | 11 +++--
 45 files changed, 92 insertions(+), 173 deletions(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
index 8fcbf711..66f2f105 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ArgumentParser.cs
@@ -1,8 +1,7 @@
-#nullable disable
-
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
@@ -54,7 +53,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
         /// <param name="value">The parsed value.</param>
         /// <param name="required">Whether to show an error if the argument is missing.</param>
         /// <param name="oneOf">Require that the argument match one of the given values (case-insensitive).</param>
-        public bool TryGet(int index, string name, out string value, bool required = true, string[] oneOf = null)
+        public bool TryGet(int index, string name, [NotNullWhen(true)] out string? value, bool required = true, string[]? oneOf = null)
         {
             value = null;
 
@@ -88,7 +87,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
             value = 0;
 
             // get argument
-            if (!this.TryGet(index, name, out string raw, required))
+            if (!this.TryGet(index, name, out string? raw, required))
                 return false;
 
             // parse
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
index a8dd41f5..44b7824e 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/ConsoleCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
index 4c6df538..9c82bbd3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/IConsoleCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands
 {
     /// <summary>A console command to register.</summary>
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
index f31457ed..f2194cff 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ApplySaveFixCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -25,7 +23,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Other
         public override void Handle(IMonitor monitor, string command, ArgumentParser args)
         {
             // get fix ID
-            if (!args.TryGet(0, "fix_id", out string rawFixId, required: false))
+            if (!args.TryGet(0, "fix_id", out string? rawFixId, required: false))
             {
                 monitor.Log("Invalid usage. Type 'help apply_save_fix' for details.", LogLevel.Error);
                 return;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
index f289c669..cf1dcbce 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/DebugCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
index 81a8c570..159d7c4a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/RegenerateBundles.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
index d762d8bf..a233d588 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowDataFilesCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
index b5733eb9..745b821b 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/ShowGameFilesCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
index 5484fc7c..8bf9f5db 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Other/TestInputCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
index 0d8db870..74d3d9df 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Linq;
 using StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData;
@@ -42,7 +40,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
             }
 
             // read arguments
-            if (!args.TryGet(0, "item type", out string type, oneOf: this.ValidTypes))
+            if (!args.TryGet(0, "item type", out string? type, oneOf: this.ValidTypes))
                 return;
             if (!args.TryGetInt(2, "count", out int count, min: 1, required: false))
                 count = 1;
@@ -50,7 +48,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
                 quality = Object.lowQuality;
 
             // find matching item
-            SearchableItem match = Enum.TryParse(type, true, out ItemType itemType)
+            SearchableItem? match = Enum.TryParse(type, true, out ItemType itemType)
                 ? this.FindItemByID(monitor, args, itemType)
                 : this.FindItemByName(monitor, args);
             if (match == null)
@@ -78,14 +76,14 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         /// <param name="monitor">Writes messages to the console and log file.</param>
         /// <param name="args">The command arguments.</param>
         /// <param name="type">The item type.</param>
-        private SearchableItem FindItemByID(IMonitor monitor, ArgumentParser args, ItemType type)
+        private SearchableItem? FindItemByID(IMonitor monitor, ArgumentParser args, ItemType type)
         {
             // read arguments
             if (!args.TryGetInt(1, "item ID", out int id, min: 0))
                 return null;
 
             // find matching item
-            SearchableItem item = this.Items.GetAll().FirstOrDefault(p => p.Type == type && p.ID == id);
+            SearchableItem? item = this.Items.GetAll().FirstOrDefault(p => p.Type == type && p.ID == id);
             if (item == null)
                 monitor.Log($"There's no {type} item with ID {id}.", LogLevel.Error);
             return item;
@@ -94,10 +92,10 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         /// <summary>Get a matching item by its name.</summary>
         /// <param name="monitor">Writes messages to the console and log file.</param>
         /// <param name="args">The command arguments.</param>
-        private SearchableItem FindItemByName(IMonitor monitor, ArgumentParser args)
+        private SearchableItem? FindItemByName(IMonitor monitor, ArgumentParser args)
         {
             // read arguments
-            if (!args.TryGet(1, "item name", out string name))
+            if (!args.TryGet(1, "item name", out string? name))
                 return null;
 
             // find matching items
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
index e57d4065..ef35ad19 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemTypesCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Mods.ConsoleCommands.Framework.ItemData;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
index 5a21b459..73d5b79d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/ListItemsCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -63,15 +61,14 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         private IEnumerable<SearchableItem> GetItems(string[] searchWords)
         {
             // normalize search term
-            searchWords = searchWords?.Where(word => !string.IsNullOrWhiteSpace(word)).ToArray();
-            if (searchWords?.Any() == false)
-                searchWords = null;
+            searchWords = searchWords.Where(word => !string.IsNullOrWhiteSpace(word)).ToArray();
+            bool getAll = !searchWords.Any();
 
             // find matches
             return (
                 from item in this.Items.GetAll()
                 let term = $"{item.ID}|{item.Type}|{item.Name}|{item.DisplayName}"
-                where searchWords == null || searchWords.All(word => term.IndexOf(word, StringComparison.CurrentCultureIgnoreCase) != -1)
+                where getAll || searchWords.All(word => term.IndexOf(word, StringComparison.CurrentCultureIgnoreCase) != -1)
                 select item
             );
         }
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
index e8605163..12a51bc9 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using Microsoft.Xna.Framework;
 using StardewValley;
@@ -24,9 +22,9 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         public override void Handle(IMonitor monitor, string command, ArgumentParser args)
         {
             // parse arguments
-            if (!args.TryGet(0, "target", out string target, oneOf: new[] { "hair", "eyes", "pants" }))
+            if (!args.TryGet(0, "target", out string? target, oneOf: new[] { "hair", "eyes", "pants" }))
                 return;
-            if (!args.TryGet(1, "color", out string rawColor))
+            if (!args.TryGet(1, "color", out string? rawColor))
                 return;
 
             // parse color
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
index 02670911..b2035d42 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetFarmTypeCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections;
 using System.Collections.Generic;
@@ -37,7 +35,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
             }
 
             // parse arguments
-            if (!args.TryGet(0, "farm type", out string farmType))
+            if (!args.TryGet(0, "farm type", out string? farmType))
                 return;
             bool isVanillaId = int.TryParse(farmType, out int vanillaId) && vanillaId is (>= 0 and < Farm.layout_max);
 
@@ -112,7 +110,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
                 return;
             }
 
-            if (!this.GetCustomFarmTypes().TryGetValue(id, out ModFarmType customFarmType))
+            if (!this.GetCustomFarmTypes().TryGetValue(id, out ModFarmType? customFarmType))
             {
                 monitor.Log($"Invalid farm type '{id}'. Enter `help set_farm_type` for more info.", LogLevel.Error);
                 return;
@@ -125,7 +123,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         /// <summary>Change the farm type.</summary>
         /// <param name="type">The farm type ID.</param>
         /// <param name="customFarmData">The custom farm type data, if applicable.</param>
-        private void SetFarmType(int type, ModFarmType customFarmData)
+        private void SetFarmType(int type, ModFarmType? customFarmData)
         {
             // set flags
             Game1.whichFarm = type;
@@ -138,7 +136,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
             farm.updateWarps();
 
             // clear spouse area cache to avoid errors
-            FieldInfo cacheField = farm.GetType().GetField("_baseSpouseAreaTiles", BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
+            FieldInfo? cacheField = farm.GetType().GetField("_baseSpouseAreaTiles", BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public);
             if (cacheField == null)
                 throw new InvalidOperationException("Failed to access '_baseSpouseAreaTiles' field to clear spouse area cache.");
             if (cacheField.GetValue(farm) is not IDictionary cache)
@@ -166,7 +164,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         /// <param name="type">The farm type.</param>
         private string GetVanillaName(int type)
         {
-            string translationKey = type switch
+            string? translationKey = type switch
             {
                 Farm.default_layout => "Character_FarmStandard",
                 Farm.riverlands_layout => "Character_FarmFishing",
@@ -199,7 +197,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         ****/
         /// <summary>Get the display name for a custom farm type.</summary>
         /// <param name="farmType">The custom farm type.</param>
-        private string GetCustomName(ModFarmType farmType)
+        private string? GetCustomName(ModFarmType? farmType)
         {
             if (string.IsNullOrWhiteSpace(farmType?.TooltipStringPath))
                 return farmType?.ID;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
index 1a1a9eab..f169159f 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetHealthCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
index d1dede1f..1065bd21 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetImmunityCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
index 2b3b140c..c2c4931d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxHealthCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
index f9ed6c58..8c794e75 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMaxStaminaCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
index 56447a65..3afcc62b 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetMoneyCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
index 4ce7e1f8..37c02ed0 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetNameCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
@@ -23,9 +21,9 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         public override void Handle(IMonitor monitor, string command, ArgumentParser args)
         {
             // parse arguments
-            if (!args.TryGet(0, "target", out string target, oneOf: new[] { "player", "farm" }))
+            if (!args.TryGet(0, "target", out string? target, oneOf: new[] { "player", "farm" }))
                 return;
-            args.TryGet(1, "name", out string name, required: false);
+            args.TryGet(1, "name", out string? name, required: false);
 
             // handle
             switch (target)
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
index ea8d74c2..24718ace 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStaminaCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
index 84625a34..8193ff27 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetStyleCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 
@@ -23,7 +21,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         public override void Handle(IMonitor monitor, string command, ArgumentParser args)
         {
             // parse arguments
-            if (!args.TryGet(0, "target", out string target, oneOf: new[] { "hair", "shirt", "acc", "skin", "shoe", "swim", "gender" }))
+            if (!args.TryGet(0, "target", out string? target, oneOf: new[] { "hair", "shirt", "acc", "skin", "shoe", "swim", "gender" }))
                 return;
             if (!args.TryGetInt(1, "style ID", out int styleID))
                 return;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
index 92c73e08..4905b89a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/ClearCommand.cs
@@ -1,8 +1,7 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
+using Microsoft.Xna.Framework;
 using StardewValley;
 using StardewValley.Locations;
 using StardewValley.Objects;
@@ -53,13 +52,13 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
             }
 
             // parse arguments
-            if (!args.TryGet(0, "location", out string locationName, required: true))
+            if (!args.TryGet(0, "location", out string? locationName, required: true))
                 return;
-            if (!args.TryGet(1, "object type", out string type, required: true, oneOf: this.ValidTypes))
+            if (!args.TryGet(1, "object type", out string? type, required: true, oneOf: this.ValidTypes))
                 return;
 
             // get target location
-            GameLocation location = Game1.locations.FirstOrDefault(p => p.Name != null && p.Name.Equals(locationName, StringComparison.OrdinalIgnoreCase));
+            GameLocation? location = Game1.locations.FirstOrDefault(p => p.Name != null && p.Name.Equals(locationName, StringComparison.OrdinalIgnoreCase));
             if (location == null && locationName == "current")
                 location = Game1.currentLocation;
             if (location == null)
@@ -168,11 +167,11 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         {
             int removed = 0;
 
-            foreach (var pair in location.Objects.Pairs.ToArray())
+            foreach ((Vector2 tile, SObject? obj) in location.Objects.Pairs.ToArray())
             {
-                if (shouldRemove(pair.Value))
+                if (shouldRemove(obj))
                 {
-                    location.Objects.Remove(pair.Key);
+                    location.Objects.Remove(tile);
                     removed++;
                 }
             }
@@ -188,11 +187,11 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         {
             int removed = 0;
 
-            foreach (var pair in location.terrainFeatures.Pairs.ToArray())
+            foreach ((Vector2 tile, TerrainFeature? feature) in location.terrainFeatures.Pairs.ToArray())
             {
-                if (shouldRemove(pair.Value))
+                if (shouldRemove(feature))
                 {
-                    location.terrainFeatures.Remove(pair.Key);
+                    location.terrainFeatures.Remove(tile);
                     removed++;
                 }
             }
@@ -228,7 +227,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
         {
             int removed = 0;
 
-            foreach (var clump in location.resourceClumps.Where(shouldRemove).ToArray())
+            foreach (ResourceClump clump in location.resourceClumps.Where(shouldRemove).ToArray())
             {
                 location.resourceClumps.Remove(clump);
                 removed++;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
index 0f18c760..5b1a4a13 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/DownMineLevelCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
 using StardewValley.Locations;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
index 8808fe35..16faa2fe 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/FreezeTimeCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Linq;
 using StardewValley;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
index f9810dc3..09531720 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/HurryAllCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
index 8aa27d93..399fd934 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetDayCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Utilities;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
index ad6ac777..f977fce3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetMineLevelCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using StardewValley;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
index ebe58913..505c0d1d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetSeasonCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Utilities;
@@ -39,7 +37,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.World
             }
 
             // parse arguments
-            if (!args.TryGet(0, "season", out string season, oneOf: this.ValidSeasons))
+            if (!args.TryGet(0, "season", out string? season, oneOf: this.ValidSeasons))
                 return;
 
             // handle
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
index 1e6bab96..8c4458dd 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetTimeCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Microsoft.Xna.Framework;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
index 995f222e..a666a634 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/World/SetYearCommand.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Utilities;
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
index ab0b2e05..3675a963 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemData/SearchableItem.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using StardewValley;
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 7d2a1662..3722e155 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -33,7 +31,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
         /// <param name="itemTypes">The item types to fetch (or null for any type).</param>
         /// <param name="includeVariants">Whether to include flavored variants like "Sunflower Honey".</param>
         [SuppressMessage("ReSharper", "AccessToModifiedClosure", Justification = "TryCreate invokes the lambda immediately.")]
-        public IEnumerable<SearchableItem> GetAll(ItemType[] itemTypes = null, bool includeVariants = true)
+        public IEnumerable<SearchableItem> GetAll(ItemType[]? itemTypes = null, bool includeVariants = true)
         {
             //
             //
@@ -45,9 +43,9 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
             //
             //
 
-            IEnumerable<SearchableItem> GetAllRaw()
+            IEnumerable<SearchableItem?> GetAllRaw()
             {
-                HashSet<ItemType> types = itemTypes?.Any() == true ? new HashSet<ItemType>(itemTypes) : null;
+                HashSet<ItemType>? types = itemTypes?.Any() == true ? new HashSet<ItemType>(itemTypes) : null;
                 bool ShouldGet(ItemType type) => types == null || types.Contains(type);
 
                 // get tools
@@ -134,7 +132,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                 {
                     foreach (int id in Game1.objectInformation.Keys)
                     {
-                        string[] fields = Game1.objectInformation[id]?.Split('/');
+                        string[]? fields = Game1.objectInformation[id]?.Split('/');
 
                         // ring
                         if (id != 801 && fields?.Length >= 4 && fields[3] == "Ring") // 801 = wedding ring, which isn't an equippable ring
@@ -148,7 +146,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                         {
                             if (ShouldGet(ItemType.Object))
                             {
-                                foreach (SearchableItem journalScrap in this.GetSecretNotes(isJournalScrap: true))
+                                foreach (SearchableItem? journalScrap in this.GetSecretNotes(isJournalScrap: true))
                                     yield return journalScrap;
                             }
                         }
@@ -158,7 +156,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                         {
                             if (ShouldGet(ItemType.Object))
                             {
-                                foreach (SearchableItem secretNote in this.GetSecretNotes(isJournalScrap: false))
+                                foreach (SearchableItem? secretNote in this.GetSecretNotes(isJournalScrap: false))
                                     yield return secretNote;
                             }
                         }
@@ -167,7 +165,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                         else if (ShouldGet(ItemType.Object))
                         {
                             // spawn main item
-                            SObject item = null;
+                            SObject? item = null;
                             yield return this.TryCreate(ItemType.Object, id, p =>
                             {
                                 return item = (p.ID == 812 // roe
@@ -181,7 +179,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                             // flavored items
                             if (includeVariants)
                             {
-                                foreach (SearchableItem variant in this.GetFlavoredObjectVariants(item))
+                                foreach (SearchableItem? variant in this.GetFlavoredObjectVariants(item))
                                     yield return variant;
                             }
                         }
@@ -189,7 +187,11 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                 }
             }
 
-            return GetAllRaw().Where(p => p != null);
+            return (
+                from item in GetAllRaw()
+                where item != null
+                select item
+            );
         }
 
 
@@ -199,7 +201,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
         /// <summary>Get the individual secret note or journal scrap items.</summary>
         /// <param name="isJournalScrap">Whether to get journal scraps.</param>
         /// <remarks>Derived from <see cref="GameLocation.tryToCreateUnseenSecretNote"/>.</remarks>
-        private IEnumerable<SearchableItem> GetSecretNotes(bool isJournalScrap)
+        private IEnumerable<SearchableItem?> GetSecretNotes(bool isJournalScrap)
         {
             // get base item ID
             int baseId = isJournalScrap ? 842 : 79;
@@ -235,7 +237,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
 
         /// <summary>Get flavored variants of a base item (like Blueberry Wine for Blueberry), if any.</summary>
         /// <param name="item">A sample of the base item.</param>
-        private IEnumerable<SearchableItem> GetFlavoredObjectVariants(SObject item)
+        private IEnumerable<SearchableItem?> GetFlavoredObjectVariants(SObject item)
         {
             int id = item.ParentSheetIndex;
 
@@ -305,9 +307,12 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                         foreach (var pair in Game1.objectInformation)
                         {
                             // get input
-                            SObject input = this.TryCreate(ItemType.Object, pair.Key, p => new SObject(p.ID, 1))?.Item as SObject;
-                            var inputTags = input?.GetContextTags();
-                            if (inputTags?.Any() != true)
+                            SObject? input = this.TryCreate(ItemType.Object, pair.Key, p => new SObject(p.ID, 1))?.Item as SObject;
+                            if (input == null)
+                                continue;
+
+                            HashSet<string> inputTags = input.GetContextTags();
+                            if (!inputTags.Any())
                                 continue;
 
                             // check if roe-producing fish
@@ -315,7 +320,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                                 continue;
 
                             // yield roe
-                            SObject roe = null;
+                            SObject? roe = null;
                             Color color = this.GetRoeColor(input);
                             yield return this.TryCreate(ItemType.Object, this.CustomIDOffset * 7 + id, _ =>
                             {
@@ -372,6 +377,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
         /// <typeparam name="TValue">The asset value type.</typeparam>
         /// <param name="assetName">The data asset name.</param>
         private Dictionary<TKey, TValue> TryLoad<TKey, TValue>(string assetName)
+            where TKey : notnull
         {
             try
             {
@@ -388,7 +394,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
         /// <param name="type">The item type.</param>
         /// <param name="id">The unique ID (if different from the item's parent sheet index).</param>
         /// <param name="createItem">Create an item instance.</param>
-        private SearchableItem TryCreate(ItemType type, int id, Func<SearchableItem, Item> createItem)
+        private SearchableItem? TryCreate(ItemType type, int id, Func<SearchableItem, Item> createItem)
         {
             try
             {
diff --git a/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs b/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
index e3ca1a39..dbfca815 100644
--- a/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/ModEntry.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -15,13 +13,13 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         ** Fields
         *********/
         /// <summary>The commands to handle.</summary>
-        private IConsoleCommand[] Commands;
+        private IConsoleCommand[] Commands = null!;
 
         /// <summary>The commands which may need to handle update ticks.</summary>
-        private IConsoleCommand[] UpdateHandlers;
+        private IConsoleCommand[] UpdateHandlers = null!;
 
         /// <summary>The commands which may need to handle input.</summary>
-        private IConsoleCommand[] InputHandlers;
+        private IConsoleCommand[] InputHandlers = null!;
 
 
         /*********
@@ -52,7 +50,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         /// <summary>The method invoked when a button is pressed.</summary>
         /// <param name="sender">The event sender.</param>
         /// <param name="e">The event arguments.</param>
-        private void OnButtonPressed(object sender, ButtonPressedEventArgs e)
+        private void OnButtonPressed(object? sender, ButtonPressedEventArgs e)
         {
             foreach (IConsoleCommand command in this.InputHandlers)
                 command.OnButtonPressed(this.Monitor, e.Button);
@@ -61,7 +59,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
         /// <summary>The method invoked when the game updates its state.</summary>
         /// <param name="sender">The event sender.</param>
         /// <param name="e">The event arguments.</param>
-        private void OnUpdateTicked(object sender, EventArgs e)
+        private void OnUpdateTicked(object? sender, EventArgs e)
         {
             foreach (IConsoleCommand command in this.UpdateHandlers)
                 command.OnUpdated(this.Monitor);
@@ -83,7 +81,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands
             return (
                 from type in this.GetType().Assembly.GetTypes()
                 where !type.IsAbstract && typeof(IConsoleCommand).IsAssignableFrom(type)
-                select (IConsoleCommand)Activator.CreateInstance(type)
+                select (IConsoleCommand)Activator.CreateInstance(type)!
             );
         }
     }
diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index fa171012..bfbfd2dc 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Reflection;
 using StardewModdingAPI.Events;
@@ -59,7 +57,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
         /// <summary>The method invoked when a save is loaded.</summary>
         /// <param name="sender">The event sender.</param>
         /// <param name="e">The event arguments.</param>
-        private void OnSaveLoaded(object sender, SaveLoadedEventArgs e)
+        private void OnSaveLoaded(object? sender, SaveLoadedEventArgs e)
         {
             // show in-game warning for removed save content
             if (this.IsSaveContentRemoved)
@@ -82,7 +80,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
             MethodInfo getMonitorForGame = coreType.GetMethod("GetMonitorForGame")
                 ?? throw new InvalidOperationException("Can't access the SMAPI's 'GetMonitorForGame' method. This mod may not work correctly.");
 
-            return (IMonitor)getMonitorForGame.Invoke(core, Array.Empty<object>()) ?? this.Monitor;
+            return (IMonitor?)getMonitorForGame.Invoke(core, Array.Empty<object>()) ?? this.Monitor;
         }
     }
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
index b05c8cca..e98eec3c 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/DialoguePatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
@@ -19,10 +17,10 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Fields
         *********/
         /// <summary>Writes messages to the console and log file on behalf of the game.</summary>
-        private static IMonitor MonitorForGame;
+        private static IMonitor MonitorForGame = null!;
 
         /// <summary>Simplifies access to private code.</summary>
-        private static IReflectionHelper Reflection;
+        private static IReflectionHelper Reflection = null!;
 
 
         /*********
@@ -56,12 +54,12 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="speaker">The NPC for which the dialogue is being parsed.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_Constructor(Dialogue __instance, string masterDialogue, NPC speaker, Exception __exception)
+        private static Exception? Finalize_Constructor(Dialogue __instance, string masterDialogue, NPC? speaker, Exception? __exception)
         {
             if (__exception != null)
             {
                 // log message
-                string name = !string.IsNullOrWhiteSpace(speaker?.Name) ? speaker.Name : null;
+                string? name = !string.IsNullOrWhiteSpace(speaker?.Name) ? speaker.Name : null;
                 DialoguePatcher.MonitorForGame.Log($"Failed parsing dialogue string{(name != null ? $" for {name}" : "")}:\n{masterDialogue}\n{__exception.GetLogSummary()}", LogLevel.Error);
 
                 // set default dialogue
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
index 63674d09..073c62cc 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/EventPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
@@ -18,7 +16,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Fields
         *********/
         /// <summary>Writes messages to the console and log file on behalf of the game.</summary>
-        private static IMonitor MonitorForGame;
+        private static IMonitor MonitorForGame = null!;
 
 
         /*********
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
index 98aa4a38..9247fa48 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/GameLocationPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
@@ -19,8 +17,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Fields
         *********/
         /// <summary>Writes messages to the console and log file on behalf of the game.</summary>
-        private static IMonitor MonitorForGame;
-
+        private static IMonitor MonitorForGame = null!;
 
         /*********
         ** Public methods
@@ -54,7 +51,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="precondition">The precondition to be parsed.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_CheckEventPrecondition(ref int __result, string precondition, Exception __exception)
+        private static Exception? Finalize_CheckEventPrecondition(ref int __result, string precondition, Exception? __exception)
         {
             if (__exception != null)
             {
@@ -70,7 +67,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="map">The map whose tilesheets to update.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_UpdateSeasonalTileSheets(GameLocation __instance, Map map, Exception __exception)
+        private static Exception? Finalize_UpdateSeasonalTileSheets(GameLocation __instance, Map map, Exception? __exception)
         {
             if (__exception != null)
                 GameLocationPatcher.MonitorForGame.Log($"Failed updating seasonal tilesheets for location '{__instance.NameOrUniqueName}': \n{__exception}", LogLevel.Error);
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
index 85ce8ac4..b65a695a 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/IClickableMenuPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
 using StardewModdingAPI.Internal.Patching;
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
index 5354f724..11f7ec69 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/NpcPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -20,7 +18,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Fields
         *********/
         /// <summary>Writes messages to the console and log file on behalf of the game.</summary>
-        private static IMonitor MonitorForGame;
+        private static IMonitor MonitorForGame = null!;
 
 
         /*********
@@ -56,7 +54,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="__result">The return value of the original method.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_CurrentDialogue(NPC __instance, ref Stack<Dialogue> __result, Exception __exception)
+        private static Exception? Finalize_CurrentDialogue(NPC __instance, ref Stack<Dialogue> __result, Exception? __exception)
         {
             if (__exception == null)
                 return null;
@@ -73,7 +71,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="__result">The patched method's return value.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_ParseMasterSchedule(string rawData, NPC __instance, ref Dictionary<int, SchedulePathDescription> __result, Exception __exception)
+        private static Exception? Finalize_ParseMasterSchedule(string rawData, NPC __instance, ref Dictionary<int, SchedulePathDescription> __result, Exception? __exception)
         {
             if (__exception != null)
             {
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
index 499718b0..09a6fbbd 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/ObjectPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -59,7 +57,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="__result">The patched method's return value.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_Object_loadDisplayName(ref string __result, Exception __exception)
+        private static Exception? Finalize_Object_loadDisplayName(ref string __result, Exception? __exception)
         {
             if (__exception is KeyNotFoundException)
             {
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
index 1941d2a8..490bbfb6 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SaveGamePatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
@@ -24,10 +22,10 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         ** Fields
         *********/
         /// <summary>Writes messages to the console and log file.</summary>
-        private static IMonitor Monitor;
+        private static IMonitor Monitor = null!;
 
         /// <summary>A callback invoked when custom content is removed from the save data to avoid a crash.</summary>
-        private static Action OnContentRemoved;
+        private static Action OnContentRemoved = null!;
 
 
         /*********
@@ -76,7 +74,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <summary>The method to call after <see cref="SaveGame.LoadFarmType"/> throws an exception.</summary>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_LoadFarmType(Exception __exception)
+        private static Exception? Finalize_LoadFarmType(Exception? __exception)
         {
             // missing custom farm type
             if (__exception?.Message.Contains("not a valid farm type") == true && !int.TryParse(SaveGame.loaded.whichFarm, out _))
@@ -110,7 +108,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <summary>Remove content which no longer exists in the game data.</summary>
         /// <param name="location">The current game location.</param>
         /// <param name="npcs">The NPC data.</param>
-        private static bool RemoveBrokenContent(GameLocation location, IDictionary<string, string> npcs)
+        private static bool RemoveBrokenContent(GameLocation? location, IDictionary<string, string> npcs)
         {
             bool removedAny = false;
             if (location == null)
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
index b4c03bb9..d369e0ef 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/SpriteBatchPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
@@ -30,9 +28,9 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /*********
         ** Private methods
         *********/
-        /// <summary>The method to call after <see cref="SpriteBatch.CheckValid"/>.</summary>
+        /// <summary>The method to call after <see cref="SpriteBatch.CheckValid(Texture2D)"/>.</summary>
         /// <param name="texture">The texture to validate.</param>
-        private static void After_CheckValid(Texture2D texture)
+        private static void After_CheckValid(Texture2D? texture)
         {
             if (texture?.IsDisposed == true)
                 throw new ObjectDisposedException("Cannot draw this texture because it's disposed.");
diff --git a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
index 108ed585..6d75a581 100644
--- a/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/Patches/UtilityPatcher.cs
@@ -1,5 +1,3 @@
-#nullable disable
-
 using System;
 using System.Diagnostics.CodeAnalysis;
 using HarmonyLib;
@@ -35,7 +33,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.Patches
         /// <param name="delimiter">The delimiter by which to split the text description.</param>
         /// <param name="__exception">The exception thrown by the wrapped method, if any.</param>
         /// <returns>Returns the exception to throw, if any.</returns>
-        private static Exception Finalize_GetItemFromStandardTextDescription(string description, char delimiter, ref Exception __exception)
+        private static Exception? Finalize_GetItemFromStandardTextDescription(string description, char delimiter, ref Exception? __exception)
         {
             return __exception != null
                 ? new FormatException($"Failed to parse item text description \"{description}\" with delimiter \"{delimiter}\".", __exception)
diff --git a/src/SMAPI.Mods.SaveBackup/ModEntry.cs b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
index b2b41ca6..a79c092f 100644
--- a/src/SMAPI.Mods.SaveBackup/ModEntry.cs
+++ b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
@@ -1,7 +1,6 @@
-#nullable disable
-
 using System;
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.IO.Compression;
 using System.Linq;
@@ -82,7 +81,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
                 }
 
                 // compress backup if possible
-                if (!this.TryCompress(fallbackDir.FullName, targetFile, out Exception compressError))
+                if (!this.TryCompress(fallbackDir.FullName, targetFile, out Exception? compressError))
                 {
                     this.Monitor.Log(Constants.TargetPlatform != GamePlatform.Android
                         ? $"Backed up to {fallbackDir.FullName}." // expected to fail on Android
@@ -142,7 +141,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
         /// <param name="destination">The destination file to create.</param>
         /// <param name="error">The error which occurred trying to compress, if applicable. This is <see cref="NotSupportedException"/> if compression isn't supported on this platform.</param>
         /// <returns>Returns whether compression succeeded.</returns>
-        private bool TryCompress(string sourcePath, FileInfo destination, out Exception error)
+        private bool TryCompress(string sourcePath, FileInfo destination, [NotNullWhen(false)] out Exception? error)
         {
             try
             {
@@ -210,7 +209,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
         /// <param name="filter">A filter which matches the files or directories to copy, or <c>null</c> to copy everything.</param>
         /// <remarks>Derived from the SMAPI installer code.</remarks>
         /// <returns>Returns whether any files were copied.</returns>
-        private bool RecursiveCopy(FileSystemInfo source, DirectoryInfo targetFolder, Func<FileSystemInfo, bool> filter, bool copyRoot = true)
+        private bool RecursiveCopy(FileSystemInfo source, DirectoryInfo targetFolder, Func<FileSystemInfo, bool>? filter, bool copyRoot = true)
         {
             if (!source.Exists || filter?.Invoke(source) == false)
                 return false;
@@ -244,7 +243,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
         private bool MatchSaveFolders(DirectoryInfo savesFolder, FileSystemInfo entry)
         {
             // only need to filter top-level entries
-            string parentPath = (entry as FileInfo)?.DirectoryName ?? (entry as DirectoryInfo)?.Parent?.FullName;
+            string? parentPath = (entry as FileInfo)?.DirectoryName ?? (entry as DirectoryInfo)?.Parent?.FullName;
             if (parentPath != savesFolder.FullName)
                 return true;
 

From 3078ae2a8e10294c86f8702769e15da16511ecde Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 22:17:26 -0400
Subject: [PATCH 552/856] fix typos in recent changes (#837)

---
 src/SMAPI/Framework/Logging/LogManager.cs   | 8 ++++----
 src/SMAPI/Framework/Reflection/Reflector.cs | 6 +++---
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index a5989673..b94807b5 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -93,18 +93,18 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="getScreenIdForLog">Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</param>
         public LogManager(string logPath, ColorSchemeConfig colorConfig, bool writeToConsole, bool isVerbose, bool isDeveloperMode, Func<int?> getScreenIdForLog)
         {
-            // init fields
+            // init log file
             this.LogFile = new LogFileManager(logPath);
-            this.Monitor = this.GetMonitor("SMAPI");
-            this.MonitorForGame = this.GetMonitor("game");
 
-            // init construction logic
+            // init monitor
             this.GetMonitorImpl = name => new Monitor(name, LogManager.IgnoreChar, this.LogFile, colorConfig, isVerbose, getScreenIdForLog)
             {
                 WriteToConsole = writeToConsole,
                 ShowTraceInConsole = isDeveloperMode,
                 ShowFullStampInConsole = isDeveloperMode
             };
+            this.Monitor = this.GetMonitor("SMAPI");
+            this.MonitorForGame = this.GetMonitor("game");
 
             // redirect direct console output
             this.ConsoleInterceptor = new InterceptingTextWriter(
diff --git a/src/SMAPI/Framework/Reflection/Reflector.cs b/src/SMAPI/Framework/Reflection/Reflector.cs
index 3490ee97..79575c26 100644
--- a/src/SMAPI/Framework/Reflection/Reflector.cs
+++ b/src/SMAPI/Framework/Reflection/Reflector.cs
@@ -153,7 +153,7 @@ namespace StardewModdingAPI.Framework.Reflection
             {
                 for (Type? curType = type; curType != null; curType = curType.BaseType)
                 {
-                    FieldInfo? fieldInfo = type.GetField(name, bindingFlags);
+                    FieldInfo? fieldInfo = curType.GetField(name, bindingFlags);
                     if (fieldInfo != null)
                     {
                         type = curType;
@@ -182,7 +182,7 @@ namespace StardewModdingAPI.Framework.Reflection
             {
                 for (Type? curType = type; curType != null; curType = curType.BaseType)
                 {
-                    PropertyInfo? propertyInfo = type.GetProperty(name, bindingFlags);
+                    PropertyInfo? propertyInfo = curType.GetProperty(name, bindingFlags);
                     if (propertyInfo != null)
                     {
                         type = curType;
@@ -210,7 +210,7 @@ namespace StardewModdingAPI.Framework.Reflection
             {
                 for (Type? curType = type; curType != null; curType = curType.BaseType)
                 {
-                    MethodInfo? methodInfo = type.GetMethod(name, bindingFlags);
+                    MethodInfo? methodInfo = curType.GetMethod(name, bindingFlags);
                     if (methodInfo != null)
                     {
                         type = curType;

From ff1b4cd323384d472cb5028529017b52746958c0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 22:19:45 -0400
Subject: [PATCH 553/856] remove reflection no longer needed after migration to
 MonoGame

---
 src/SMAPI/Framework/Content/ContentCache.cs            | 10 +++-------
 .../Framework/ContentManagers/BaseContentManager.cs    |  3 ++-
 2 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index d8862eb3..cbb6c1e9 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -3,9 +3,7 @@ using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
 using System.Diagnostics.Contracts;
 using System.Linq;
-using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Utilities;
-using StardewValley;
 
 namespace StardewModdingAPI.Framework.Content
 {
@@ -41,12 +39,10 @@ namespace StardewModdingAPI.Framework.Content
         ** Constructor
         ****/
         /// <summary>Construct an instance.</summary>
-        /// <param name="contentManager">The underlying content manager whose cache to manage.</param>
-        /// <param name="reflection">Simplifies access to private game code.</param>
-        public ContentCache(LocalizedContentManager contentManager, Reflector reflection)
+        /// <param name="loadedAssets">The asset cache for the underlying content manager.</param>
+        public ContentCache(Dictionary<string, object> loadedAssets)
         {
-            this.Cache = reflection.GetField<Dictionary<string, object>>(contentManager, "loadedAssets").GetValue()
-                ?? throw new InvalidOperationException("Can't initialize content cache: required field 'loadedAssets' is missing.");
+            this.Cache = loadedAssets;
         }
 
         /****
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 5ae5313d..613df023 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -89,7 +89,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // init
             this.Name = name;
             this.Coordinator = coordinator ?? throw new ArgumentNullException(nameof(coordinator));
-            this.Cache = new ContentCache(this, reflection);
+            // ReSharper disable once VirtualMemberCallInConstructor -- LoadedAssets isn't overridden by SMAPI or Stardew Valley
+            this.Cache = new ContentCache(this.LoadedAssets);
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.Reflection = reflection;
             this.OnDisposing = onDisposing;

From 045e4ddf2df278f740903294057a67cac8c95052 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 22:58:47 -0400
Subject: [PATCH 554/856] update release notes (#837)

---
 docs/release-notes.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7379cba3..2e7b26e1 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -40,10 +40,12 @@ the C# mod that loads them is updated.
 * Major changes:
   * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
     _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
+  * Added [nullable reference type annotations](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Nullable_reference_type_annotations) for all APIs.
   * Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.
   * Overhauled [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
     _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
   * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
+  * Enabled deprecation notices for all deprecated APIs. These will only be shown in `TRACE` logs for at least a month after SMAPI 3.14.0 releases.
 * Other improvements:
   * Added `IAssetDataForImage.ExtendMap` to resize maps in asset editors.
   * Added [command-line arguments](technical/smapi.md#command-line-arguments) to toggle developer mode (thanks to Tondorian!).
@@ -58,6 +60,7 @@ the C# mod that loads them is updated.
   * Fixed the `SDate` constructor being case-sensitive.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
+  * Fixed null handling in various edge cases.
 
 ## 3.13.4
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.

From 66272cbe46b848c64859cd0ab8cca6032c307137 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 13 Apr 2022 23:40:47 -0400
Subject: [PATCH 555/856] fix false-positive deprecation notice (#837)

---
 src/SMAPI/Utilities/PerScreen.cs | 43 +++++++++++++++++++-------------
 1 file changed, 26 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 799ff63b..ba4f3325 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -40,27 +40,12 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Construct an instance.</summary>
         /// <remarks><strong>Limitation with nullable reference types:</strong> when the underlying type <typeparamref name="T"/> is nullable, this sets the default value to null regardless of whether you marked the type parameter nullable. To avoid that, set the default value with the 'createNewState' argument instead.</remarks>
         public PerScreen()
-            : this(null!) { }
+            : this(null, nullExpected: true) { }
 
         /// <summary>Construct an instance.</summary>
         /// <param name="createNewState">Create the initial state for a screen.</param>
         public PerScreen(Func<T> createNewState)
-        {
-            // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- required for backwards compatibility
-            if (createNewState is null)
-            {
-                SCore.DeprecationManager.Warn(
-                    SCore.DeprecationManager.GetSourceNameFromStack(),
-                    $"calling the {nameof(PerScreen<T>)} constructor with null",
-                    "3.14.0",
-                    DeprecationLevel.Notice
-                );
-
-                createNewState = (() => default!);
-            }
-
-            this.CreateNewState = createNewState;
-        }
+            : this(createNewState, nullExpected: false) { }
 
         /// <summary>Get all active values by screen ID. This doesn't initialize the value for a screen ID if it's not created yet.</summary>
         public IEnumerable<KeyValuePair<int, T>> GetActiveValues()
@@ -98,6 +83,30 @@ namespace StardewModdingAPI.Utilities
         /*********
         ** Private methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="createNewState">Create the initial state for a screen.</param>
+        /// <param name="nullExpected">Whether a null <paramref name="createNewState"/> value is expected.</param>
+        /// <remarks>This constructor only exists to maintain backwards compatibility. In SMAPI 4.0.0, the overload that passes <c>nullExpected: false</c> should throw an exception instead.</remarks>
+        private PerScreen(Func<T>? createNewState, bool nullExpected)
+        {
+            if (createNewState is null)
+            {
+                createNewState = (() => default!);
+
+                if (!nullExpected)
+                {
+                    SCore.DeprecationManager.Warn(
+                        SCore.DeprecationManager.GetSourceNameFromStack(),
+                        $"calling the {nameof(PerScreen<T>)} constructor with null",
+                        "3.14.0",
+                        DeprecationLevel.Notice
+                    );
+                }
+            }
+
+            this.CreateNewState = createNewState;
+        }
+
         /// <summary>Remove screens which are no longer active.</summary>
         private void RemoveDeadScreens()
         {

From 4de18b516fb12c3f842e72560b4d41aae7b7eff9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 14 Apr 2022 18:13:27 -0400
Subject: [PATCH 556/856] fix nullable annotation (#837)

---
 src/SMAPI/Framework/ModHelpers/TranslationHelper.cs | 2 +-
 src/SMAPI/Framework/Translator.cs                   | 2 +-
 src/SMAPI/ITranslationHelper.cs                     | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
index d00ff279..684837ff 100644
--- a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        public Translation Get(string key, object tokens)
+        public Translation Get(string key, object? tokens)
         {
             return this.Translator.Get(key, tokens);
         }
diff --git a/src/SMAPI/Framework/Translator.cs b/src/SMAPI/Framework/Translator.cs
index 794e3cde..b230a727 100644
--- a/src/SMAPI/Framework/Translator.cs
+++ b/src/SMAPI/Framework/Translator.cs
@@ -72,7 +72,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get a translation for the current locale.</summary>
         /// <param name="key">The translation key.</param>
         /// <param name="tokens">An object containing token key/value pairs. This can be an anonymous object (like <c>new { value = 42, name = "Cranberries" }</c>), a dictionary, or a class instance.</param>
-        public Translation Get(string key, object tokens)
+        public Translation Get(string key, object? tokens)
         {
             return this.Get(key).Tokens(tokens);
         }
diff --git a/src/SMAPI/ITranslationHelper.cs b/src/SMAPI/ITranslationHelper.cs
index 32199910..8be8d2c1 100644
--- a/src/SMAPI/ITranslationHelper.cs
+++ b/src/SMAPI/ITranslationHelper.cs
@@ -29,7 +29,7 @@ namespace StardewModdingAPI
         /// <summary>Get a translation for the current locale.</summary>
         /// <param name="key">The translation key.</param>
         /// <param name="tokens">An object containing token key/value pairs. This can be an anonymous object (like <c>new { value = 42, name = "Cranberries" }</c>), a dictionary, or a class instance.</param>
-        Translation Get(string key, object tokens);
+        Translation Get(string key, object? tokens);
 
         /// <summary>Get a translation in every locale for which it's defined.</summary>
         /// <param name="key">The translation key.</param>

From eb125f1994c605704be384ffdcf4da64b88d9405 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 14 Apr 2022 18:14:08 -0400
Subject: [PATCH 557/856] fix assembly version conflict error in mod build
 package

---
 docs/technical/mod-package.md                        | 1 +
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj | 6 ++++++
 2 files changed, 7 insertions(+)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 4c31f69b..b29f3f72 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -414,6 +414,7 @@ when you compile it.
 ## Release notes
 ## Upcoming release
 * Added detection for Xbox app game folders.
+* Fixed "_conflicts between different versions of Microsoft.Win32.Registry_" warnings in recent SMAPI versions.
 * Internal refactoring.
 
 ## 4.0.0
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 82eac7f6..09792d3c 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -25,6 +25,12 @@
   <ItemGroup>
     <PackageReference Include="Microsoft.Build.Utilities.Core" Version="16.10" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
+
+    <!--
+      This is imported through Microsoft.Build.Utilities.Core. When installed by a mod, NuGet
+      otherwise imports version 4.3.0 instead of 5.0.0, which conflicts with SMAPI's version.
+    -->
+    <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" />
   </ItemGroup>
 
   <ItemGroup>

From 3a777a511d65c1a99237937dce789f98d0dd1933 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 14 Apr 2022 18:15:02 -0400
Subject: [PATCH 558/856] update release notes

---
 docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2e7b26e1..fed92d8d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 ### For players
 * Changes:
+  * When scanning for mod folders, dot-prefixed files are now ignored (thanks to Nuztalgia!).
   * On Linux, SMAPI now fixes many issues with case-sensitive mod paths automatically.
   * On Linux/macOS, added `--use-current-shell` [command-line argument](technical/smapi.md#command-line-arguments) to avoid opening a separate terminal window.
   * Dropped update checks for the unofficial 64-bit patcher (obsolete since SMAPI 3.12.6).

From 43c875c4c225ad248790c29f3abcb787cbbd2d7f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 14 Apr 2022 19:21:18 -0400
Subject: [PATCH 559/856] prepare mod build package 4.0.1 for release

---
 docs/technical/mod-package.md                        | 4 +++-
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index b29f3f72..c632af84 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -412,7 +412,9 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
-## Upcoming release
+## 4.0.1
+Released 14 April 2022.
+
 * Added detection for Xbox app game folders.
 * Fixed "_conflicts between different versions of Microsoft.Win32.Registry_" warnings in recent SMAPI versions.
 * Internal refactoring.
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index 09792d3c..c5790186 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -10,7 +10,7 @@
     <!--NuGet package-->
     <PackageId>Pathoschild.Stardew.ModBuildConfig</PackageId>
     <Title>Build package for SMAPI mods</Title>
-    <Version>4.0.0</Version>
+    <Version>4.0.1</Version>
     <Authors>Pathoschild</Authors>
     <Description>Automates the build configuration for crossplatform Stardew Valley SMAPI mods. For SMAPI 3.13.0 or later.</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>

From 1a3befa93e073b45e63781cc546cd7c52f316d7c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 14 Apr 2022 23:00:30 -0400
Subject: [PATCH 560/856] track mod metadata reference in APIs for upcoming
 deprecation changes

---
 src/SMAPI.Tests/Core/TranslationTests.cs      | 32 +++++++++++++++++--
 src/SMAPI/Framework/ModHelpers/BaseHelper.cs  | 15 ++++++---
 .../Framework/ModHelpers/CommandHelper.cs     |  6 +---
 .../Framework/ModHelpers/ContentHelper.cs     |  8 ++---
 .../Framework/ModHelpers/ContentPackHelper.cs |  6 ++--
 src/SMAPI/Framework/ModHelpers/DataHelper.cs  |  6 ++--
 .../Framework/ModHelpers/GameContentHelper.cs |  8 ++---
 src/SMAPI/Framework/ModHelpers/InputHelper.cs |  6 ++--
 .../Framework/ModHelpers/ModContentHelper.cs  |  8 ++---
 src/SMAPI/Framework/ModHelpers/ModHelper.cs   |  8 ++---
 .../Framework/ModHelpers/ModRegistryHelper.cs |  6 ++--
 .../Framework/ModHelpers/MultiplayerHelper.cs |  6 ++--
 .../Framework/ModHelpers/ReflectionHelper.cs  |  6 ++--
 .../Framework/ModHelpers/TranslationHelper.cs |  6 ++--
 src/SMAPI/Framework/SCore.cs                  | 32 +++++++++----------
 15 files changed, 94 insertions(+), 65 deletions(-)

diff --git a/src/SMAPI.Tests/Core/TranslationTests.cs b/src/SMAPI.Tests/Core/TranslationTests.cs
index ced1525a..a52df607 100644
--- a/src/SMAPI.Tests/Core/TranslationTests.cs
+++ b/src/SMAPI.Tests/Core/TranslationTests.cs
@@ -1,10 +1,14 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
+using System.IO;
 using System.Linq;
 using NUnit.Framework;
 using StardewModdingAPI;
+using StardewModdingAPI.Framework;
 using StardewModdingAPI.Framework.ModHelpers;
+using StardewModdingAPI.Framework.ModLoading;
+using StardewModdingAPI.Toolkit.Serialization.Models;
 using StardewValley;
 
 namespace SMAPI.Tests.Core
@@ -33,7 +37,7 @@ namespace SMAPI.Tests.Core
             var data = new Dictionary<string, IDictionary<string, string>>();
 
             // act
-            ITranslationHelper helper = new TranslationHelper("ModID", "en", LocalizedContentManager.LanguageCode.en).SetTranslations(data);
+            ITranslationHelper helper = new TranslationHelper(this.CreateModMetadata(), "en", LocalizedContentManager.LanguageCode.en).SetTranslations(data);
             Translation translation = helper.Get("key");
             Translation[]? translationList = helper.GetTranslations()?.ToArray();
 
@@ -56,7 +60,7 @@ namespace SMAPI.Tests.Core
 
             // act
             var actual = new Dictionary<string, Translation[]?>();
-            TranslationHelper helper = new TranslationHelper("ModID", "en", LocalizedContentManager.LanguageCode.en).SetTranslations(data);
+            TranslationHelper helper = new TranslationHelper(this.CreateModMetadata(), "en", LocalizedContentManager.LanguageCode.en).SetTranslations(data);
             foreach (string locale in expected.Keys)
             {
                 this.AssertSetLocale(helper, locale, LocalizedContentManager.LanguageCode.en);
@@ -80,7 +84,7 @@ namespace SMAPI.Tests.Core
 
             // act
             var actual = new Dictionary<string, Translation[]>();
-            TranslationHelper helper = new TranslationHelper("ModID", "en", LocalizedContentManager.LanguageCode.en).SetTranslations(data);
+            TranslationHelper helper = new TranslationHelper(this.CreateModMetadata(), "en", LocalizedContentManager.LanguageCode.en).SetTranslations(data);
             foreach (string locale in expected.Keys)
             {
                 this.AssertSetLocale(helper, locale, LocalizedContentManager.LanguageCode.en);
@@ -325,6 +329,28 @@ namespace SMAPI.Tests.Core
             return string.Format(Translation.PlaceholderText, key);
         }
 
+        /// <summary>Create a fake mod manifest.</summary>
+        private IModMetadata CreateModMetadata()
+        {
+            string id = $"smapi.unit-tests.fake-mod-{Guid.NewGuid():N}";
+
+            string tempPath = Path.Combine(Path.GetTempPath(), id);
+            return new ModMetadata(
+                displayName: "Mod Display Name",
+                directoryPath: tempPath,
+                rootPath: tempPath,
+                manifest: new Manifest(
+                    uniqueID: id,
+                    name: "Mod Name",
+                    author: "Mod Author",
+                    description: "Mod Description",
+                    version: new SemanticVersion(1, 0, 0)
+                ),
+                dataRecord: null,
+                isIgnored: false
+            );
+        }
+
 
         /*********
         ** Test models
diff --git a/src/SMAPI/Framework/ModHelpers/BaseHelper.cs b/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
index 5a3d4bed..12390976 100644
--- a/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/BaseHelper.cs
@@ -3,21 +3,28 @@ namespace StardewModdingAPI.Framework.ModHelpers
     /// <summary>The common base class for mod helpers.</summary>
     internal abstract class BaseHelper : IModLinked
     {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The mod using this instance.</summary>
+        protected readonly IModMetadata Mod;
+
+
         /*********
         ** Accessors
         *********/
         /// <inheritdoc />
-        public string ModID { get; }
+        public string ModID => this.Mod.Manifest.UniqueID;
 
 
         /*********
         ** Protected methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
-        protected BaseHelper(string modID)
+        /// <param name="mod">The mod using this instance.</param>
+        protected BaseHelper(IModMetadata mod)
         {
-            this.ModID = modID;
+            this.Mod = mod;
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index 7d25979c..319922a9 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -8,9 +8,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /*********
         ** Fields
         *********/
-        /// <summary>The mod using this instance.</summary>
-        private readonly IModMetadata Mod;
-
         /// <summary>Manages console commands.</summary>
         private readonly CommandManager CommandManager;
 
@@ -22,9 +19,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="mod">The mod using this instance.</param>
         /// <param name="commandManager">Manages console commands.</param>
         public CommandHelper(IModMetadata mod, CommandManager commandManager)
-            : base(mod.Manifest.UniqueID)
+            : base(mod)
         {
-            this.Mod = mod;
             this.CommandManager = commandManager;
         }
 
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index b610b395..7cffcee1 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -93,14 +93,14 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Construct an instance.</summary>
         /// <param name="contentCore">SMAPI's core content logic.</param>
         /// <param name="modFolderPath">The absolute path to the mod folder.</param>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public ContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IMonitor monitor, Reflector reflection)
-            : base(modID)
+        public ContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IMonitor monitor, Reflector reflection)
+            : base(mod)
         {
-            string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
+            string managedAssetPrefix = contentCore.GetManagedAssetPrefix(mod.Manifest.UniqueID);
 
             this.ContentCore = contentCore;
             this.GameContentManager = contentCore.CreateGameContentManager(managedAssetPrefix + ".content");
diff --git a/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
index d39abc7d..9f4a7ceb 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
@@ -22,11 +22,11 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="contentPacks">The content packs loaded for this mod.</param>
         /// <param name="createContentPack">Create a temporary content pack.</param>
-        public ContentPackHelper(string modID, Lazy<IContentPack[]> contentPacks, Func<string, IManifest, IContentPack> createContentPack)
-            : base(modID)
+        public ContentPackHelper(IModMetadata mod, Lazy<IContentPack[]> contentPacks, Func<string, IManifest, IContentPack> createContentPack)
+            : base(mod)
         {
             this.ContentPacks = contentPacks;
             this.CreateContentPack = createContentPack;
diff --git a/src/SMAPI/Framework/ModHelpers/DataHelper.cs b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
index 92b3b398..2eaa940a 100644
--- a/src/SMAPI/Framework/ModHelpers/DataHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/DataHelper.cs
@@ -26,11 +26,11 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="modFolderPath">The absolute path to the mod folder.</param>
         /// <param name="jsonHelper">The absolute path to the mod folder.</param>
-        public DataHelper(string modID, string modFolderPath, JsonHelper jsonHelper)
-            : base(modID)
+        public DataHelper(IModMetadata mod, string modFolderPath, JsonHelper jsonHelper)
+            : base(mod)
         {
             this.ModFolderPath = modFolderPath;
             this.JsonHelper = jsonHelper;
diff --git a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
index 4c1cde02..232e9287 100644
--- a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
@@ -45,14 +45,14 @@ namespace StardewModdingAPI.Framework.ModHelpers
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="contentCore">SMAPI's core content logic.</param>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public GameContentHelper(ContentCoordinator contentCore, string modID, string modName, IMonitor monitor, Reflector reflection)
-            : base(modID)
+        public GameContentHelper(ContentCoordinator contentCore, IModMetadata mod, string modName, IMonitor monitor, Reflector reflection)
+            : base(mod)
         {
-            string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
+            string managedAssetPrefix = contentCore.GetManagedAssetPrefix(mod.Manifest.UniqueID);
 
             this.ContentCore = contentCore;
             this.GameContentManager = contentCore.CreateGameContentManager(managedAssetPrefix + ".content");
diff --git a/src/SMAPI/Framework/ModHelpers/InputHelper.cs b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
index 88caf4c3..6c158258 100644
--- a/src/SMAPI/Framework/ModHelpers/InputHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/InputHelper.cs
@@ -18,10 +18,10 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="currentInputState">Manages the game's input state for the current player instance. That may not be the main player in split-screen mode.</param>
-        public InputHelper(string modID, Func<SInputState> currentInputState)
-            : base(modID)
+        public InputHelper(IModMetadata mod, Func<SInputState> currentInputState)
+            : base(mod)
         {
             this.CurrentInputState = currentInputState;
         }
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index fc47f269..4a058a48 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -36,15 +36,15 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Construct an instance.</summary>
         /// <param name="contentCore">SMAPI's core content logic.</param>
         /// <param name="modFolderPath">The absolute path to the mod folder.</param>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="gameContentManager">The game content manager used for map tilesheets not provided by the mod.</param>
         /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="relativePathCache"/>.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, string modID, string modName, IContentManager gameContentManager, CaseInsensitivePathCache relativePathCache, Reflector reflection)
-            : base(modID)
+        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IContentManager gameContentManager, CaseInsensitivePathCache relativePathCache, Reflector reflection)
+            : base(mod)
         {
-            string managedAssetPrefix = contentCore.GetManagedAssetPrefix(modID);
+            string managedAssetPrefix = contentCore.GetManagedAssetPrefix(mod.Manifest.UniqueID);
 
             this.ContentCore = contentCore;
             this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, modName, modFolderPath, gameContentManager);
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index e1529a75..4eb91f05 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -77,7 +77,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The mod's unique ID.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="modDirectory">The full path to the mod's folder.</param>
         /// <param name="currentInputState">Manages the game's input state for the current player instance. That may not be the main player in split-screen mode.</param>
         /// <param name="events">Manages access to events raised by SMAPI.</param>
@@ -94,13 +94,13 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <exception cref="ArgumentNullException">An argument is null or empty.</exception>
         /// <exception cref="InvalidOperationException">The <paramref name="modDirectory"/> path does not exist on disk.</exception>
         public ModHelper(
-            string modID, string modDirectory, Func<SInputState> currentInputState, IModEvents events,
+            IModMetadata mod, string modDirectory, Func<SInputState> currentInputState, IModEvents events,
 #pragma warning disable CS0612 // deprecated code
             ContentHelper contentHelper,
 #pragma warning restore CS0612
             IGameContentHelper gameContentHelper, IModContentHelper modContentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper
         )
-            : base(modID)
+            : base(mod)
         {
             // validate directory
             if (string.IsNullOrWhiteSpace(modDirectory))
@@ -117,7 +117,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.ModContent = modContentHelper ?? throw new ArgumentNullException(nameof(modContentHelper));
             this.ContentPacks = contentPackHelper ?? throw new ArgumentNullException(nameof(contentPackHelper));
             this.Data = dataHelper ?? throw new ArgumentNullException(nameof(dataHelper));
-            this.Input = new InputHelper(modID, currentInputState);
+            this.Input = new InputHelper(mod, currentInputState);
             this.ModRegistry = modRegistry ?? throw new ArgumentNullException(nameof(modRegistry));
             this.ConsoleCommands = commandHelper ?? throw new ArgumentNullException(nameof(commandHelper));
             this.Reflection = reflectionHelper ?? throw new ArgumentNullException(nameof(reflectionHelper));
diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 84899610..39cef758 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -26,12 +26,12 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="registry">The underlying mod registry.</param>
         /// <param name="proxyFactory">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
         /// <param name="monitor">Encapsulates monitoring and logging for the mod.</param>
-        public ModRegistryHelper(string modID, ModRegistry registry, InterfaceProxyFactory proxyFactory, IMonitor monitor)
-            : base(modID)
+        public ModRegistryHelper(IModMetadata mod, ModRegistry registry, InterfaceProxyFactory proxyFactory, IMonitor monitor)
+            : base(mod)
         {
             this.Registry = registry;
             this.ProxyFactory = proxyFactory;
diff --git a/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs b/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
index a419327e..6900a1d2 100644
--- a/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/MultiplayerHelper.cs
@@ -18,10 +18,10 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="multiplayer">SMAPI's core multiplayer utility.</param>
-        public MultiplayerHelper(string modID, SMultiplayer multiplayer)
-            : base(modID)
+        public MultiplayerHelper(IModMetadata mod, SMultiplayer multiplayer)
+            : base(mod)
         {
             this.Multiplayer = multiplayer;
         }
diff --git a/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs b/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
index af018c87..a559906b 100644
--- a/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ReflectionHelper.cs
@@ -22,11 +22,11 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="modName">The mod name for error messages.</param>
         /// <param name="reflector">The underlying reflection helper.</param>
-        public ReflectionHelper(string modID, string modName, Reflector reflector)
-            : base(modID)
+        public ReflectionHelper(IModMetadata mod, string modName, Reflector reflector)
+            : base(mod)
         {
             this.ModName = modName;
             this.Reflector = reflector;
diff --git a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
index 684837ff..ae49d651 100644
--- a/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/TranslationHelper.cs
@@ -27,11 +27,11 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modID">The unique ID of the relevant mod.</param>
+        /// <param name="mod">The mod using this instance.</param>
         /// <param name="locale">The initial locale.</param>
         /// <param name="languageCode">The game's current language code.</param>
-        public TranslationHelper(string modID, string locale, LocalizedContentManager.LanguageCode languageCode)
-            : base(modID)
+        public TranslationHelper(IModMetadata mod, string locale, LocalizedContentManager.LanguageCode languageCode)
+            : base(mod)
         {
             this.Translator = new Translator();
             this.Translator.SetLocale(locale, languageCode);
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index bce7cffa..814ac56f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1749,9 +1749,9 @@ namespace StardewModdingAPI.Framework
             {
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
                 CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
-                GameContentHelper gameContentHelper = new(this.ContentCore, manifest.UniqueID, mod.DisplayName, monitor, this.Reflection);
-                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
-                TranslationHelper translationHelper = new(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
+                GameContentHelper gameContentHelper = new(this.ContentCore, mod, mod.DisplayName, monitor, this.Reflection);
+                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
+                TranslationHelper translationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
                 IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, modContentHelper, translationHelper, jsonHelper, relativePathCache);
                 mod.SetMod(contentPack, monitor, translationHelper);
                 this.ModRegistry.Add(mod);
@@ -1823,7 +1823,7 @@ namespace StardewModdingAPI.Framework
 
                     // init mod helpers
                     IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
-                    TranslationHelper translationHelper = new(manifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
+                    TranslationHelper translationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
                     IModHelper modHelper;
                     {
                         IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest)
@@ -1832,9 +1832,9 @@ namespace StardewModdingAPI.Framework
 
                             CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(packDirPath);
 
-                            GameContentHelper gameContentHelper = new(contentCore, packManifest.UniqueID, packManifest.Name, packMonitor, this.Reflection);
-                            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, packManifest.UniqueID, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
-                            TranslationHelper packTranslationHelper = new(packManifest.UniqueID, contentCore.GetLocale(), contentCore.Language);
+                            GameContentHelper gameContentHelper = new(contentCore, mod, packManifest.Name, packMonitor, this.Reflection);
+                            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, mod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
+                            TranslationHelper packTranslationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
 
                             ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, relativePathCache);
                             this.ReloadTranslationsForTemporaryContentPack(mod, contentPack);
@@ -1846,17 +1846,17 @@ namespace StardewModdingAPI.Framework
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
                         CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
 #pragma warning disable CS0612 // deprecated code
-                        ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, monitor, this.Reflection);
+                        ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, mod, mod.DisplayName, monitor, this.Reflection);
 #pragma warning restore CS0612
-                        GameContentHelper gameContentHelper = new(contentCore, manifest.UniqueID, mod.DisplayName, monitor, this.Reflection);
-                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, manifest.UniqueID, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
-                        IContentPackHelper contentPackHelper = new ContentPackHelper(manifest.UniqueID, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
-                        IDataHelper dataHelper = new DataHelper(manifest.UniqueID, mod.DirectoryPath, jsonHelper);
-                        IReflectionHelper reflectionHelper = new ReflectionHelper(manifest.UniqueID, mod.DisplayName, this.Reflection);
-                        IModRegistry modRegistryHelper = new ModRegistryHelper(manifest.UniqueID, this.ModRegistry, proxyFactory, monitor);
-                        IMultiplayerHelper multiplayerHelper = new MultiplayerHelper(manifest.UniqueID, this.Multiplayer);
+                        GameContentHelper gameContentHelper = new(contentCore, mod, mod.DisplayName, monitor, this.Reflection);
+                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
+                        IContentPackHelper contentPackHelper = new ContentPackHelper(mod, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
+                        IDataHelper dataHelper = new DataHelper(mod, mod.DirectoryPath, jsonHelper);
+                        IReflectionHelper reflectionHelper = new ReflectionHelper(mod, mod.DisplayName, this.Reflection);
+                        IModRegistry modRegistryHelper = new ModRegistryHelper(mod, this.ModRegistry, proxyFactory, monitor);
+                        IMultiplayerHelper multiplayerHelper = new MultiplayerHelper(mod, this.Multiplayer);
 
-                        modHelper = new ModHelper(manifest.UniqueID, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events, contentHelper, gameContentHelper, modContentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
+                        modHelper = new ModHelper(mod, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events, contentHelper, gameContentHelper, modContentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
                     }
 
                     // init mod

From fd136d34c5d4fbfc708eabf82a5eb9396d8a4756 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 14 Apr 2022 23:11:41 -0400
Subject: [PATCH 561/856] track full mod & stack metadata in queued deprecation
 warnings

---
 src/SMAPI/Constants.cs                        |  2 +-
 src/SMAPI/Framework/Content/AssetInfo.cs      |  4 +--
 src/SMAPI/Framework/DeprecationManager.cs     | 33 +++++++++----------
 src/SMAPI/Framework/DeprecationWarning.cs     | 17 ++++++----
 .../Framework/ModHelpers/CommandHelper.cs     |  2 +-
 .../Framework/ModHelpers/ContentHelper.cs     | 17 ++++------
 src/SMAPI/Framework/ModHelpers/ModHelper.cs   |  2 +-
 src/SMAPI/Framework/SCore.cs                  |  6 ++--
 src/SMAPI/Utilities/PerScreen.cs              |  2 +-
 9 files changed, 41 insertions(+), 44 deletions(-)

diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index fd2b813a..d40b97f4 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -83,7 +83,7 @@ namespace StardewModdingAPI
             get
             {
                 SCore.DeprecationManager.Warn(
-                    source: SCore.DeprecationManager.GetSourceNameFromStack(),
+                    source: SCore.DeprecationManager.GetModFromStack(),
                     nounPhrase: $"{nameof(Constants)}.{nameof(Constants.ExecutionPath)}",
                     version: "3.14.0",
                     severity: DeprecationLevel.Notice
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 0f0e9bf3..16b71487 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -32,7 +32,7 @@ namespace StardewModdingAPI.Framework.Content
             get
             {
                 SCore.DeprecationManager.Warn(
-                    source: SCore.DeprecationManager.GetSourceNameFromStack(),
+                    source: SCore.DeprecationManager.GetModFromStack(),
                     nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetName)}",
                     version: "3.14.0",
                     severity: DeprecationLevel.Notice
@@ -68,7 +68,7 @@ namespace StardewModdingAPI.Framework.Content
         public bool AssetNameEquals(string path)
         {
             SCore.DeprecationManager.Warn(
-                source: SCore.DeprecationManager.GetSourceNameFromStack(),
+                source: SCore.DeprecationManager.GetModFromStack(),
                 nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetNameEquals)}",
                 version: "3.14.0",
                 severity: DeprecationLevel.Notice
diff --git a/src/SMAPI/Framework/DeprecationManager.cs b/src/SMAPI/Framework/DeprecationManager.cs
index 44b0ba2f..c80fdce7 100644
--- a/src/SMAPI/Framework/DeprecationManager.cs
+++ b/src/SMAPI/Framework/DeprecationManager.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 
 namespace StardewModdingAPI.Framework
@@ -35,34 +36,33 @@ namespace StardewModdingAPI.Framework
             this.ModRegistry = modRegistry;
         }
 
-        /// <summary>Get the source name for a mod from its unique ID.</summary>
-        public string? GetSourceNameFromStack()
+        /// <summary>Get a mod for the closest assembly registered as a source of deprecation warnings.</summary>
+        /// <returns>Returns the source name, or <c>null</c> if no registered assemblies were found.</returns>
+        public IModMetadata? GetModFromStack()
         {
-            return this.ModRegistry.GetFromStack()?.DisplayName;
+            return this.ModRegistry.GetFromStack();
         }
 
-        /// <summary>Get the source name for a mod from its unique ID.</summary>
+        /// <summary>Get a mod from its unique ID.</summary>
         /// <param name="modId">The mod's unique ID.</param>
-        public string? GetSourceName(string modId)
+        public IModMetadata? GetMod(string modId)
         {
-            return this.ModRegistry.Get(modId)?.DisplayName;
+            return this.ModRegistry.Get(modId);
         }
 
         /// <summary>Log a deprecation warning.</summary>
-        /// <param name="source">The friendly mod name which used the deprecated code.</param>
+        /// <param name="source">The mod which used the deprecated code, if known.</param>
         /// <param name="nounPhrase">A noun phrase describing what is deprecated.</param>
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <param name="severity">How deprecated the code is.</param>
-        public void Warn(string? source, string nounPhrase, string version, DeprecationLevel severity)
+        public void Warn(IModMetadata? source, string nounPhrase, string version, DeprecationLevel severity)
         {
-            source ??= this.GetSourceNameFromStack() ?? "<unknown>";
-
             // ignore if already warned
             if (!this.MarkWarned(source, nounPhrase, version))
                 return;
 
             // queue warning
-            this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, Environment.StackTrace));
+            this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, new StackTrace(skipFrames: 1)));
         }
 
         /// <summary>A placeholder method used to track deprecated code for which a separate warning will be shown.</summary>
@@ -104,7 +104,7 @@ namespace StardewModdingAPI.Framework
                 else
                 {
                     this.Monitor.Log(message, level);
-                    this.Monitor.Log(warning.StackTrace, LogLevel.Debug);
+                    this.Monitor.Log(warning.StackTrace.ToString(), LogLevel.Debug);
                 }
             }
 
@@ -116,16 +116,13 @@ namespace StardewModdingAPI.Framework
         ** Private methods
         *********/
         /// <summary>Mark a deprecation warning as already logged.</summary>
-        /// <param name="source">The friendly name of the assembly which used the deprecated code.</param>
+        /// <param name="source">The mod which used the deprecated code.</param>
         /// <param name="nounPhrase">A noun phrase describing what is deprecated (e.g. "the Extensions.AsInt32 method").</param>
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <returns>Returns whether the deprecation was successfully marked as warned. Returns <c>false</c> if it was already marked.</returns>
-        private bool MarkWarned(string source, string nounPhrase, string version)
+        private bool MarkWarned(IModMetadata? source, string nounPhrase, string version)
         {
-            if (string.IsNullOrWhiteSpace(source))
-                throw new InvalidOperationException("The deprecation source cannot be empty.");
-
-            string key = $"{source}::{nounPhrase}::{version}";
+            string key = $"{source?.DisplayName ?? "<unknown>"}::{nounPhrase}::{version}";
             if (this.LoggedDeprecations.Contains(key))
                 return false;
             this.LoggedDeprecations.Add(key);
diff --git a/src/SMAPI/Framework/DeprecationWarning.cs b/src/SMAPI/Framework/DeprecationWarning.cs
index 5201b06c..1e83f679 100644
--- a/src/SMAPI/Framework/DeprecationWarning.cs
+++ b/src/SMAPI/Framework/DeprecationWarning.cs
@@ -1,3 +1,5 @@
+using System.Diagnostics;
+
 namespace StardewModdingAPI.Framework
 {
     /// <summary>A deprecation warning for a mod.</summary>
@@ -6,8 +8,11 @@ namespace StardewModdingAPI.Framework
         /*********
         ** Accessors
         *********/
-        /// <summary>The affected mod's display name.</summary>
-        public string ModName { get; }
+        /// <summary>The affected mod.</summary>
+        public IModMetadata? Mod { get; }
+
+        /// <summary>Get the display name for the affected mod.</summary>
+        public string ModName => this.Mod?.DisplayName ?? "<unknown mod>";
 
         /// <summary>A noun phrase describing what is deprecated.</summary>
         public string NounPhrase { get; }
@@ -19,21 +24,21 @@ namespace StardewModdingAPI.Framework
         public DeprecationLevel Level { get; }
 
         /// <summary>The stack trace when the deprecation warning was raised.</summary>
-        public string StackTrace { get; }
+        public StackTrace StackTrace { get; }
 
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="modName">The affected mod's display name.</param>
+        /// <param name="mod">The affected mod.</param>
         /// <param name="nounPhrase">A noun phrase describing what is deprecated.</param>
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <param name="level">The deprecation level for the affected code.</param>
         /// <param name="stackTrace">The stack trace when the deprecation warning was raised.</param>
-        public DeprecationWarning(string modName, string nounPhrase, string version, DeprecationLevel level, string stackTrace)
+        public DeprecationWarning(IModMetadata? mod, string nounPhrase, string version, DeprecationLevel level, StackTrace stackTrace)
         {
-            this.ModName = modName;
+            this.Mod = mod;
             this.NounPhrase = nounPhrase;
             this.Version = version;
             this.Level = level;
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index 319922a9..e430fb1c 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -36,7 +36,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public bool Trigger(string name, string[] arguments)
         {
             SCore.DeprecationManager.Warn(
-                source: SCore.DeprecationManager.GetSourceName(this.ModID),
+                source: SCore.DeprecationManager.GetMod(this.ModID),
                 nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.ConsoleCommands)}.{nameof(ICommandHelper.Trigger)}",
                 version: "3.8.1",
                 severity: DeprecationLevel.Notice
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 7cffcee1..534ac138 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -29,9 +29,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>A content manager for this mod which manages files from the mod's folder.</summary>
         private readonly ModContentManager ModContentManager;
 
-        /// <summary>The friendly mod name for use in errors.</summary>
-        private readonly string ModName;
-
         /// <summary>Encapsulates monitoring and logging.</summary>
         private readonly IMonitor Monitor;
 
@@ -60,7 +57,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             get
             {
                 SCore.DeprecationManager.Warn(
-                    source: this.ModName,
+                    source: this.Mod,
                     nounPhrase: $"{nameof(IContentHelper)}.{nameof(IContentHelper.AssetLoaders)}",
                     version: "3.14.0",
                     severity: DeprecationLevel.Notice
@@ -76,7 +73,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             get
             {
                 SCore.DeprecationManager.Warn(
-                    source: this.ModName,
+                    source: this.Mod,
                     nounPhrase: $"{nameof(IContentHelper)}.{nameof(IContentHelper.AssetEditors)}",
                     version: "3.14.0",
                     severity: DeprecationLevel.Notice
@@ -94,18 +91,16 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="contentCore">SMAPI's core content logic.</param>
         /// <param name="modFolderPath">The absolute path to the mod folder.</param>
         /// <param name="mod">The mod using this instance.</param>
-        /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public ContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IMonitor monitor, Reflector reflection)
+        public ContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, IMonitor monitor, Reflector reflection)
             : base(mod)
         {
             string managedAssetPrefix = contentCore.GetManagedAssetPrefix(mod.Manifest.UniqueID);
 
             this.ContentCore = contentCore;
             this.GameContentManager = contentCore.CreateGameContentManager(managedAssetPrefix + ".content");
-            this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, modName, modFolderPath, this.GameContentManager);
-            this.ModName = modName;
+            this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, this.Mod.DisplayName, modFolderPath, this.GameContentManager);
             this.Monitor = monitor;
             this.Reflection = reflection;
         }
@@ -128,12 +123,12 @@ namespace StardewModdingAPI.Framework.ModHelpers
                         return this.ModContentManager.LoadExact<T>(assetName, useCache: false);
 
                     default:
-                        throw new SContentLoadException($"{this.ModName} failed loading content asset '{key}' from {source}: unknown content source '{source}'.");
+                        throw new SContentLoadException($"{this.Mod.DisplayName} failed loading content asset '{key}' from {source}: unknown content source '{source}'.");
                 }
             }
             catch (Exception ex) when (ex is not SContentLoadException)
             {
-                throw new SContentLoadException($"{this.ModName} failed loading content asset '{key}' from {source}.", ex);
+                throw new SContentLoadException($"{this.Mod.DisplayName} failed loading content asset '{key}' from {source}.", ex);
             }
         }
 
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 4eb91f05..5b450c36 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -32,7 +32,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             get
             {
                 SCore.DeprecationManager.Warn(
-                    source: SCore.DeprecationManager.GetSourceName(this.ModID),
+                    source: SCore.DeprecationManager.GetMod(this.ModID),
                     nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.Content)}",
                     version: "3.14.0",
                     severity: DeprecationLevel.Notice
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 814ac56f..990fe5ea 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1598,7 +1598,7 @@ namespace StardewModdingAPI.Framework
                     if (metadata.Mod is IAssetEditor editor)
                     {
                         SCore.DeprecationManager.Warn(
-                            source: metadata.DisplayName,
+                            source: metadata,
                             nounPhrase: $"{nameof(IAssetEditor)}",
                             version: "3.14.0",
                             severity: DeprecationLevel.Notice
@@ -1610,7 +1610,7 @@ namespace StardewModdingAPI.Framework
                     if (metadata.Mod is IAssetLoader loader)
                     {
                         SCore.DeprecationManager.Warn(
-                            source: metadata.DisplayName,
+                            source: metadata,
                             nounPhrase: $"{nameof(IAssetLoader)}",
                             version: "3.14.0",
                             severity: DeprecationLevel.Notice
@@ -1846,7 +1846,7 @@ namespace StardewModdingAPI.Framework
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
                         CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
 #pragma warning disable CS0612 // deprecated code
-                        ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, mod, mod.DisplayName, monitor, this.Reflection);
+                        ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, mod, monitor, this.Reflection);
 #pragma warning restore CS0612
                         GameContentHelper gameContentHelper = new(contentCore, mod, mod.DisplayName, monitor, this.Reflection);
                         IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index ba4f3325..6c2e436b 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -96,7 +96,7 @@ namespace StardewModdingAPI.Utilities
                 if (!nullExpected)
                 {
                     SCore.DeprecationManager.Warn(
-                        SCore.DeprecationManager.GetSourceNameFromStack(),
+                        SCore.DeprecationManager.GetModFromStack(),
                         $"calling the {nameof(PerScreen<T>)} constructor with null",
                         "3.14.0",
                         DeprecationLevel.Notice

From c0d0ad0282169a829ffee4808088ebf434ba498d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 14 Apr 2022 23:55:08 -0400
Subject: [PATCH 562/856] show simplified stack trace for deprecation notices

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Framework/DeprecationManager.cs | 45 +++++++++++++++++++++--
 src/SMAPI/Framework/ModRegistry.cs        | 20 +++++++---
 3 files changed, 57 insertions(+), 9 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index fed92d8d..01ba6e30 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -57,6 +57,7 @@ the C# mod that loads them is updated.
   * Added `helper.Content.ParseAssetName` to get an `IAssetName` for an arbitrary asset key.
   * If an asset is loaded multiple times in the same tick, `IAssetLoader.CanLoad` and `IAssetEditor.CanEdit` are now cached unless invalidated by `helper.Content.InvalidateCache`.
   * The `ISemanticVersion` comparison methods (`CompareTo`, `IsBetween`, `IsNewerThan`, and `IsOlderThan`) now allow null values. A null version is always considered older than any non-null version per [best practices](https://docs.microsoft.com/en-us/dotnet/api/system.icomparable-1.compareto#remarks).
+  * Deprecation notices now show a shorter stack trace in most cases, so it's clearer where the deprecated code is in the mod.
 * Fixes:
   * Fixed the `SDate` constructor being case-sensitive.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
diff --git a/src/SMAPI/Framework/DeprecationManager.cs b/src/SMAPI/Framework/DeprecationManager.cs
index c80fdce7..37a5c8ef 100644
--- a/src/SMAPI/Framework/DeprecationManager.cs
+++ b/src/SMAPI/Framework/DeprecationManager.cs
@@ -2,6 +2,7 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
+using System.Text;
 
 namespace StardewModdingAPI.Framework
 {
@@ -62,7 +63,8 @@ namespace StardewModdingAPI.Framework
                 return;
 
             // queue warning
-            this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, new StackTrace(skipFrames: 1)));
+            var stack = new StackTrace(skipFrames: 1); // skip this method
+            this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, stack));
         }
 
         /// <summary>A placeholder method used to track deprecated code for which a separate warning will be shown.</summary>
@@ -100,11 +102,11 @@ namespace StardewModdingAPI.Framework
 
                 // log message
                 if (level == LogLevel.Trace)
-                    this.Monitor.Log($"{message}\n{warning.StackTrace}", level);
+                    this.Monitor.Log($"{message}\n{this.GetSimplifiedStackTrace(warning.StackTrace, warning.Mod)}", level);
                 else
                 {
                     this.Monitor.Log(message, level);
-                    this.Monitor.Log(warning.StackTrace.ToString(), LogLevel.Debug);
+                    this.Monitor.Log(this.GetSimplifiedStackTrace(warning.StackTrace, warning.Mod), LogLevel.Debug);
                 }
             }
 
@@ -128,5 +130,42 @@ namespace StardewModdingAPI.Framework
             this.LoggedDeprecations.Add(key);
             return true;
         }
+
+        /// <summary>Get the simplest stack trace which shows where in the mod the deprecated code was called from.</summary>
+        /// <param name="stack">The stack trace.</param>
+        /// <param name="mod">The mod for which to show a stack trace.</param>
+        private string GetSimplifiedStackTrace(StackTrace stack, IModMetadata? mod)
+        {
+            // unknown mod, show entire stack trace
+            if (mod == null)
+                return stack.ToString();
+
+            // get frame info
+            var frames = stack
+                .GetFrames()
+                .Select(frame => (Frame: frame, Mod: this.ModRegistry.GetFrom(frame)))
+                .ToArray();
+            var modIds = new HashSet<string>(
+                from frame in frames
+                let id = frame.Mod?.Manifest.UniqueID
+                where id != null
+                select id
+            );
+
+            // can't filter to the target mod
+            if (modIds.Count != 1 || !modIds.Contains(mod.Manifest.UniqueID))
+                return stack.ToString();
+
+            // get stack frames for the target mod, plus one for context
+            var framesStartingAtMod = frames.SkipWhile(p => p.Mod == null).ToArray();
+            var displayFrames = framesStartingAtMod.TakeWhile(p => p.Mod != null).ToArray();
+            displayFrames = displayFrames.Concat(framesStartingAtMod.Skip(displayFrames.Length).Take(1)).ToArray();
+
+            // build stack trace
+            StringBuilder str = new();
+            foreach (var frame in displayFrames)
+                str.Append(new StackTrace(frame.Frame));
+            return str.ToString().TrimEnd();
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ModRegistry.cs b/src/SMAPI/Framework/ModRegistry.cs
index de16a780..449dccb1 100644
--- a/src/SMAPI/Framework/ModRegistry.cs
+++ b/src/SMAPI/Framework/ModRegistry.cs
@@ -59,7 +59,7 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Get metadata for a loaded mod.</summary>
         /// <param name="uniqueID">The mod's unique ID.</param>
-        /// <returns>Returns the matching mod's metadata, or <c>null</c> if not found.</returns>
+        /// <returns>Returns the mod's metadata, or <c>null</c> if not found.</returns>
         public IModMetadata? Get(string uniqueID)
         {
             // normalize search ID
@@ -73,7 +73,7 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Get the mod metadata from one of its assemblies.</summary>
         /// <param name="type">The type to check.</param>
-        /// <returns>Returns the mod name, or <c>null</c> if the type isn't part of a known mod.</returns>
+        /// <returns>Returns the mod's metadata, or <c>null</c> if the type isn't part of a known mod.</returns>
         public IModMetadata? GetFrom(Type? type)
         {
             // null
@@ -89,8 +89,17 @@ namespace StardewModdingAPI.Framework
             return null;
         }
 
-        /// <summary>Get the friendly name for the closest assembly registered as a source of deprecation warnings.</summary>
-        /// <returns>Returns the source name, or <c>null</c> if no registered assemblies were found.</returns>
+        /// <summary>Get the mod metadata from a stack frame, if any.</summary>
+        /// <param name="frame">The stack frame to check.</param>
+        /// <returns>Returns the mod's metadata, or <c>null</c> if the frame isn't part of a known mod.</returns>
+        public IModMetadata? GetFrom(StackFrame frame)
+        {
+            MethodBase? method = frame.GetMethod();
+            return this.GetFrom(method?.ReflectedType);
+        }
+
+        /// <summary>Get the mod metadata from the closest assembly registered as a source of deprecation warnings.</summary>
+        /// <returns>Returns the mod's metadata, or <c>null</c> if no registered assemblies were found.</returns>
         public IModMetadata? GetFromStack()
         {
             // get stack frames
@@ -100,8 +109,7 @@ namespace StardewModdingAPI.Framework
             // search stack for a source assembly
             foreach (StackFrame frame in frames)
             {
-                MethodBase? method = frame.GetMethod();
-                IModMetadata? mod = this.GetFrom(method?.ReflectedType);
+                IModMetadata? mod = this.GetFrom(frame);
                 if (mod != null)
                     return mod;
             }

From 2dc20be5f711c50cc80de024c8a6afb96c04d8a1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 11:10:13 -0400
Subject: [PATCH 563/856] use specified nullability in reflection API (#837)

---
 .../ContentManagers/BaseContentManager.cs     |  2 +-
 src/SMAPI/Framework/InternalExtensions.cs     |  2 +-
 src/SMAPI/Framework/ModRegistry.cs            |  2 +-
 .../Framework/Reflection/ReflectedField.cs    |  6 +++---
 .../Framework/Reflection/ReflectedMethod.cs   |  4 ++--
 .../Framework/Reflection/ReflectedProperty.cs | 12 +++++------
 src/SMAPI/Framework/SMultiplayer.cs           |  8 ++++----
 src/SMAPI/IReflectedField.cs                  |  4 ++--
 src/SMAPI/IReflectedMethod.cs                 |  2 +-
 src/SMAPI/IReflectedProperty.cs               |  4 ++--
 src/SMAPI/Metadata/CoreAssetPropagator.cs     | 20 +++++++++++--------
 11 files changed, 35 insertions(+), 31 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 613df023..b2e3ec0f 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -98,7 +98,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
 
             // get asset data
-            this.BaseDisposableReferences = reflection.GetField<List<IDisposable>>(this, "disposableAssets").GetValue()
+            this.BaseDisposableReferences = reflection.GetField<List<IDisposable>?>(this, "disposableAssets").GetValue()
                 ?? throw new InvalidOperationException("Can't initialize content manager: the required 'disposableAssets' field wasn't found.");
         }
 
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index fd8cc86f..580651f3 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -160,7 +160,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="reflection">The reflection helper with which to access private fields.</param>
         public static bool IsOpen(this SpriteBatch spriteBatch, Reflector reflection)
         {
-            return reflection.GetField<bool>(spriteBatch, "_beginCalled")!.GetValue();
+            return reflection.GetField<bool>(spriteBatch, "_beginCalled").GetValue();
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModRegistry.cs b/src/SMAPI/Framework/ModRegistry.cs
index 449dccb1..1ae5643f 100644
--- a/src/SMAPI/Framework/ModRegistry.cs
+++ b/src/SMAPI/Framework/ModRegistry.cs
@@ -35,7 +35,7 @@ namespace StardewModdingAPI.Framework
             this.Mods.Add(metadata);
         }
 
-        /// <summary>Track a mod's assembly for use via <see cref="GetFrom"/>.</summary>
+        /// <summary>Track a mod's assembly for use via <see cref="GetFrom(Type?)"/>.</summary>
         /// <param name="metadata">The mod metadata.</param>
         /// <param name="modAssembly">The mod assembly.</param>
         public void TrackAssemblies(IModMetadata metadata, Assembly modAssembly)
diff --git a/src/SMAPI/Framework/Reflection/ReflectedField.cs b/src/SMAPI/Framework/Reflection/ReflectedField.cs
index 197a246e..a97ca3f0 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedField.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedField.cs
@@ -56,11 +56,11 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public TValue? GetValue()
+        public TValue GetValue()
         {
             try
             {
-                return (TValue?)this.FieldInfo.GetValue(this.Parent);
+                return (TValue)this.FieldInfo.GetValue(this.Parent)!;
             }
             catch (InvalidCastException)
             {
@@ -73,7 +73,7 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public void SetValue(TValue? value)
+        public void SetValue(TValue value)
         {
             try
             {
diff --git a/src/SMAPI/Framework/Reflection/ReflectedMethod.cs b/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
index c245e843..a607141e 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedMethod.cs
@@ -55,7 +55,7 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public TValue? Invoke<TValue>(params object?[] arguments)
+        public TValue Invoke<TValue>(params object?[] arguments)
         {
             // invoke method
             object? result;
@@ -75,7 +75,7 @@ namespace StardewModdingAPI.Framework.Reflection
             // cast return value
             try
             {
-                return (TValue?)result;
+                return (TValue)result!;
             }
             catch (InvalidCastException)
             {
diff --git a/src/SMAPI/Framework/Reflection/ReflectedProperty.cs b/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
index 638953a3..72e701d1 100644
--- a/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
+++ b/src/SMAPI/Framework/Reflection/ReflectedProperty.cs
@@ -14,10 +14,10 @@ namespace StardewModdingAPI.Framework.Reflection
         private readonly string DisplayName;
 
         /// <summary>The underlying property getter.</summary>
-        private readonly Func<TValue?>? GetMethod;
+        private readonly Func<TValue>? GetMethod;
 
         /// <summary>The underlying property setter.</summary>
-        private readonly Action<TValue?>? SetMethod;
+        private readonly Action<TValue>? SetMethod;
 
 
         /*********
@@ -56,13 +56,13 @@ namespace StardewModdingAPI.Framework.Reflection
             this.PropertyInfo = property;
 
             if (this.PropertyInfo.GetMethod != null)
-                this.GetMethod = (Func<TValue?>)Delegate.CreateDelegate(typeof(Func<TValue?>), obj, this.PropertyInfo.GetMethod);
+                this.GetMethod = (Func<TValue>)Delegate.CreateDelegate(typeof(Func<TValue>), obj, this.PropertyInfo.GetMethod);
             if (this.PropertyInfo.SetMethod != null)
-                this.SetMethod = (Action<TValue?>)Delegate.CreateDelegate(typeof(Action<TValue?>), obj, this.PropertyInfo.SetMethod);
+                this.SetMethod = (Action<TValue>)Delegate.CreateDelegate(typeof(Action<TValue>), obj, this.PropertyInfo.SetMethod);
         }
 
         /// <inheritdoc />
-        public TValue? GetValue()
+        public TValue GetValue()
         {
             if (this.GetMethod == null)
                 throw new InvalidOperationException($"The {this.DisplayName} property has no get method.");
@@ -82,7 +82,7 @@ namespace StardewModdingAPI.Framework.Reflection
         }
 
         /// <inheritdoc />
-        public void SetValue(TValue? value)
+        public void SetValue(TValue value)
         {
             if (this.SetMethod == null)
                 throw new InvalidOperationException($"The {this.DisplayName} property has no set method.");
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index c0e8ee81..e41e7edc 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -113,13 +113,13 @@ namespace StardewModdingAPI.Framework
             {
                 case LidgrenClient:
                     {
-                        string address = this.Reflection.GetField<string>(client, "address").GetValue() ?? throw new InvalidOperationException("Can't initialize base networking client: no valid address found.");
+                        string address = this.Reflection.GetField<string?>(client, "address").GetValue() ?? throw new InvalidOperationException("Can't initialize base networking client: no valid address found.");
                         return new SLidgrenClient(address, this.OnClientProcessingMessage, this.OnClientSendingMessage);
                     }
 
                 case GalaxyNetClient:
                     {
-                        GalaxyID address = this.Reflection.GetField<GalaxyID>(client, "lobbyId").GetValue() ?? throw new InvalidOperationException("Can't initialize GOG networking client: no valid address found.");
+                        GalaxyID address = this.Reflection.GetField<GalaxyID?>(client, "lobbyId").GetValue() ?? throw new InvalidOperationException("Can't initialize GOG networking client: no valid address found.");
                         return new SGalaxyNetClient(address, this.OnClientProcessingMessage, this.OnClientSendingMessage);
                     }
 
@@ -137,13 +137,13 @@ namespace StardewModdingAPI.Framework
             {
                 case LidgrenServer:
                     {
-                        IGameServer gameServer = this.Reflection.GetField<IGameServer>(server, "gameServer").GetValue() ?? throw new InvalidOperationException("Can't initialize base networking client: the required 'gameServer' field wasn't found.");
+                        IGameServer gameServer = this.Reflection.GetField<IGameServer?>(server, "gameServer").GetValue() ?? throw new InvalidOperationException("Can't initialize base networking client: the required 'gameServer' field wasn't found.");
                         return new SLidgrenServer(gameServer, this, this.OnServerProcessingMessage);
                     }
 
                 case GalaxyNetServer:
                     {
-                        IGameServer gameServer = this.Reflection.GetField<IGameServer>(server, "gameServer").GetValue() ?? throw new InvalidOperationException("Can't initialize GOG networking client: the required 'gameServer' field wasn't found.");
+                        IGameServer gameServer = this.Reflection.GetField<IGameServer?>(server, "gameServer").GetValue() ?? throw new InvalidOperationException("Can't initialize GOG networking client: the required 'gameServer' field wasn't found.");
                         return new SGalaxyNetServer(gameServer, this, this.OnServerProcessingMessage);
                     }
 
diff --git a/src/SMAPI/IReflectedField.cs b/src/SMAPI/IReflectedField.cs
index 5a24b3dc..8b00909c 100644
--- a/src/SMAPI/IReflectedField.cs
+++ b/src/SMAPI/IReflectedField.cs
@@ -17,10 +17,10 @@ namespace StardewModdingAPI
         ** Public methods
         *********/
         /// <summary>Get the field value.</summary>
-        TValue? GetValue();
+        TValue GetValue();
 
         /// <summary>Set the field value.</summary>
         //// <param name="value">The value to set.</param>
-        void SetValue(TValue? value);
+        void SetValue(TValue value);
     }
 }
diff --git a/src/SMAPI/IReflectedMethod.cs b/src/SMAPI/IReflectedMethod.cs
index 6d87966a..04636b84 100644
--- a/src/SMAPI/IReflectedMethod.cs
+++ b/src/SMAPI/IReflectedMethod.cs
@@ -18,7 +18,7 @@ namespace StardewModdingAPI
         /// <summary>Invoke the method.</summary>
         /// <typeparam name="TValue">The return type.</typeparam>
         /// <param name="arguments">The method arguments to pass in.</param>
-        TValue? Invoke<TValue>(params object?[] arguments);
+        TValue Invoke<TValue>(params object?[] arguments);
 
         /// <summary>Invoke the method.</summary>
         /// <param name="arguments">The method arguments to pass in.</param>
diff --git a/src/SMAPI/IReflectedProperty.cs b/src/SMAPI/IReflectedProperty.cs
index ad55b9a1..73ad9f30 100644
--- a/src/SMAPI/IReflectedProperty.cs
+++ b/src/SMAPI/IReflectedProperty.cs
@@ -17,10 +17,10 @@ namespace StardewModdingAPI
         ** Public methods
         *********/
         /// <summary>Get the property value.</summary>
-        TValue? GetValue();
+        TValue GetValue();
 
         /// <summary>Set the property value.</summary>
         //// <param name="value">The value to set.</param>
-        void SetValue(TValue? value);
+        void SetValue(TValue value);
     }
 }
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index f1b9af9a..5dee2c4d 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -806,7 +806,7 @@ namespace StardewModdingAPI.Metadata
                     if (door?.Sprite == null)
                         continue;
 
-                    string? curKey = this.Reflection.GetField<string>(door.Sprite, "textureName").GetValue();
+                    string? curKey = this.Reflection.GetField<string?>(door.Sprite, "textureName").GetValue();
                     if (this.IsSameBaseName(assetName, curKey))
                         door.Sprite.texture = texture.Value;
                 }
@@ -1002,7 +1002,7 @@ namespace StardewModdingAPI.Metadata
                     GameLocation adventureGuild = Game1.getLocationFromName("AdventureGuild");
                     if (adventureGuild != null)
                     {
-                        NPC? gil = this.Reflection.GetField<NPC>(adventureGuild, "Gil").GetValue();
+                        NPC? gil = this.Reflection.GetField<NPC?>(adventureGuild, "Gil").GetValue();
                         if (gil != null)
                             characters.Add(new { Npc = gil, AssetName = gilKey });
                     }
@@ -1031,7 +1031,7 @@ namespace StardewModdingAPI.Metadata
 
             foreach (Farmer player in players)
             {
-                this.Reflection.GetField<Dictionary<string, Dictionary<int, List<int>>>>(typeof(FarmerRenderer), "_recolorOffsets").GetValue()?.Remove(player.getTexture());
+                this.Reflection.GetField<Dictionary<string, Dictionary<int, List<int>>>?>(typeof(FarmerRenderer), "_recolorOffsets").GetValue()?.Remove(player.getTexture());
                 player.FarmerRenderer.MarkSpriteDirty();
             }
 
@@ -1049,14 +1049,18 @@ namespace StardewModdingAPI.Metadata
             foreach (GameLocation location in this.GetLocations(buildingInteriors: false))
             {
                 // get suspension bridges field
-                var field = this.Reflection.GetField<IEnumerable<SuspensionBridge>>(location, nameof(IslandNorth.suspensionBridges), required: false);
+                var field = this.Reflection.GetField<IEnumerable<SuspensionBridge>?>(location, nameof(IslandNorth.suspensionBridges), required: false);
                 // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- field is nullable when required: false
                 if (field == null || !typeof(IEnumerable<SuspensionBridge>).IsAssignableFrom(field.FieldInfo.FieldType))
                     continue;
 
                 // update textures
-                foreach (SuspensionBridge bridge in field.GetValue()!)
-                    this.Reflection.GetField<Texture2D>(bridge, "_texture").SetValue(texture.Value);
+                IEnumerable<SuspensionBridge>? bridges = field.GetValue();
+                if (bridges != null)
+                {
+                    foreach (SuspensionBridge bridge in bridges)
+                        this.Reflection.GetField<Texture2D>(bridge, "_texture").SetValue(texture.Value);
+                }
             }
 
             return texture.IsValueCreated;
@@ -1134,7 +1138,7 @@ namespace StardewModdingAPI.Metadata
             {
                 // reload schedule
                 this.Reflection.GetField<bool>(villager, "_hasLoadedMasterScheduleData").SetValue(false);
-                this.Reflection.GetField<Dictionary<string, string>>(villager, "_masterScheduleData").SetValue(null);
+                this.Reflection.GetField<Dictionary<string, string>?>(villager, "_masterScheduleData").SetValue(null);
                 villager.Schedule = villager.getSchedule(Game1.dayOfMonth);
 
                 // switch to new schedule if needed
@@ -1161,7 +1165,7 @@ namespace StardewModdingAPI.Metadata
             Game1.samBandName = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.2156");
             Game1.elliottBookName = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.2157");
 
-            string[] dayNames = this.Reflection.GetField<string[]>(typeof(Game1), "_shortDayDisplayName").GetValue()!;
+            string[] dayNames = this.Reflection.GetField<string[]>(typeof(Game1), "_shortDayDisplayName").GetValue();
             dayNames[0] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3042");
             dayNames[1] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3043");
             dayNames[2] = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.3044");

From 9ba06704077c32f84aa4c4aeff8b75e66e1c0486 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 11:21:44 -0400
Subject: [PATCH 564/856] fix Nexus API key needed to launch web project
 locally

---
 docs/release-notes.md                         |  3 ++
 .../Clients/Nexus/DisabledNexusClient.cs      | 31 +++++++++++++++++++
 src/SMAPI.Web/Startup.cs                      | 23 +++++++++-----
 3 files changed, 49 insertions(+), 8 deletions(-)
 create mode 100644 src/SMAPI.Web/Framework/Clients/Nexus/DisabledNexusClient.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 01ba6e30..de30a23b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -64,6 +64,9 @@ the C# mod that loads them is updated.
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
   * Fixed null handling in various edge cases.
 
+### For SMAPI contributors
+* You no longer need a Nexus API key to launch the SMAPI web project locally.
+
 ## 3.13.4
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/DisabledNexusClient.cs b/src/SMAPI.Web/Framework/Clients/Nexus/DisabledNexusClient.cs
new file mode 100644
index 00000000..6edd5f64
--- /dev/null
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/DisabledNexusClient.cs
@@ -0,0 +1,31 @@
+using System.Threading.Tasks;
+using StardewModdingAPI.Toolkit.Framework.UpdateData;
+
+namespace StardewModdingAPI.Web.Framework.Clients.Nexus
+{
+    /// <summary>A client for the Nexus website which does nothing, used for local development.</summary>
+    internal class DisabledNexusClient : INexusClient
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <inheritdoc />
+        public ModSiteKey SiteKey => ModSiteKey.Nexus;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get update check info about a mod.</summary>
+        /// <param name="id">The mod ID.</param>
+        public Task<IModPage?> GetModData(string id)
+        {
+            return Task.FromResult<IModPage?>(
+                new GenericModPage(ModSiteKey.Nexus, id).SetError(RemoteModStatus.TemporaryError, "The Nexus client is currently disabled due to the configuration.")
+            );
+        }
+
+        /// <inheritdoc />
+        public void Dispose() { }
+    }
+}
diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index 98dbca5e..2693aa90 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -128,14 +128,21 @@ namespace StardewModdingAPI.Web
                     modUrlFormat: api.ModDropModPageUrl
                 ));
 
-                services.AddSingleton<INexusClient>(new NexusClient(
-                    webUserAgent: userAgent,
-                    webBaseUrl: api.NexusBaseUrl,
-                    webModUrlFormat: api.NexusModUrlFormat,
-                    webModScrapeUrlFormat: api.NexusModScrapeUrlFormat,
-                    apiAppVersion: version,
-                    apiKey: api.NexusApiKey
-                ));
+                if (!string.IsNullOrWhiteSpace(api.NexusApiKey))
+                {
+                    services.AddSingleton<INexusClient>(new NexusClient(
+                        webUserAgent: userAgent,
+                        webBaseUrl: api.NexusBaseUrl,
+                        webModUrlFormat: api.NexusModUrlFormat,
+                        webModScrapeUrlFormat: api.NexusModScrapeUrlFormat,
+                        apiAppVersion: version,
+                        apiKey: api.NexusApiKey
+                    ));
+                }
+                else
+                {
+                    services.AddSingleton<INexusClient>(new DisabledNexusClient());
+                }
 
                 services.AddSingleton<IPastebinClient>(new PastebinClient(
                     baseUrl: api.PastebinBaseUrl,

From 64b9da560fcde5696b27126adbc45e8331f1cc70 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 12:56:38 -0400
Subject: [PATCH 565/856] minor refactoring & code style

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |   8 +-
 .../wwwroot/Content/js/log-parser.js          | 192 ++++++++----------
 2 files changed, 93 insertions(+), 107 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index d55bfd4d..dbaa14e0 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -98,14 +98,14 @@
 @section SidebarExtra {
     @if (log != null)
     {
-        <aside id="quickNav">
-            <h4>Scroll To...</h4>
+        <nav id="quickNav">
+            <h4>Scroll to...</h4>
             <ul>
                 <li><a href="#content">Top</a></li>
-                <li><a href="#filterHolder">Log Start</a></li>
+                <li><a href="#filterHolder">Log start</a></li>
                 <li><a href="#footer">Bottom</a></li>
             </ul>
-        </aside>
+        </nav>
     }
 }
 
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 37c57082..c730309b 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -97,55 +97,43 @@ smapi.logParser = function (state) {
         },
 
         /**
-         * Try parsing the value as an integer, in base 10. Return the number
-         * if it's valid, or return the default value otherwise.
-         * @param {String} value The value to parse.
-         * @param {Number} defaultValue The value to return if parsing fails.
-         * @param {Function} critera An optional criteria to check the number with.
+         * Try parsing the value as a base-10 integer.
+         * @param {string} value The value to parse.
+         * @param {number} defaultValue The value to return if parsing fails.
+         * @param {() => boolean} criteria An optional callback to check whether a parsed number is valid.
+         * @returns {number} The parsed number if it's valid, else the default value.
          */
-        tryNumber(value, defaultValue, critera = null) {
-            try {
-                value = parseInt(value, 10);
-            } catch {
-                return defaultValue;
-            }
-
-            if (isNaN(value) || !isFinite(value) || (critera && !critera(value)))
-                return defaultValue;
-
-            return value;
+        tryParseNumber(value, defaultValue, criteria = null) {
+            value = parseInt(value, 10);
+            return !isNaN(value) && isFinite(value) && (!criteria || criteria(value))
+                ? value
+                : defaultValue;
         },
 
         /**
-         * Check the shallow equality of two objects.
-         * @param {Array} first
-         * @param {Array} second
+         * Get whether two objects are equivalent based on their top-level properties.
+         * @param {Object} left The first value to compare.
+         * @param {Object} right The second value to compare.
          * @returns {Boolean}
          */
-        shallowEquals(first, second) {
-            if (typeof first !== "object" || typeof second !== "object")
-                return first === second;
+        shallowEquals(left, right) {
+            if (typeof left !== "object" || typeof right !== "object")
+                return left === right;
 
-            if (first == null || second == null)
-                return first == null && second == null;
+            if (left == null || right == null)
+                return left == null && right == null;
 
-            const f_array = Array.isArray(first);
-            const s_array = Array.isArray(second);
-
-            if (f_array !== s_array)
+            if (Array.isArray(left) !== Array.isArray(right))
                 return false;
 
-            const f_keys = Object.keys(first);
-            const s_keys = Object.keys(second);
+            const leftKeys = Object.keys(left);
+            const rightKeys = Object.keys(right);
 
-            if (f_keys.length != s_keys.length)
+            if (leftKeys.length != rightKeys.length)
                 return false;
 
-            for (const key of f_keys) {
-                if (!s_keys.includes(key))
-                    return false;
-
-                if (first[key] !== second[key])
+            for (const key of leftKeys) {
+                if (!rightKeys.includes(key) || left[key] !== right[key])
                     return false;
             }
 
@@ -204,20 +192,6 @@ smapi.logParser = function (state) {
         modsHidden: 0
     };
 
-    function updateModFilters() {
-        // counts
-        stats.modsShown = 0;
-        stats.modsHidden = 0;
-        for (let key in state.showMods) {
-            if (state.showMods.hasOwnProperty(key)) {
-                if (state.showMods[key])
-                    stats.modsShown++;
-                else
-                    stats.modsHidden++;
-            }
-        }
-    }
-
     // load raw log data
     {
         const dataElement = document.querySelector(state.dataElement);
@@ -282,9 +256,9 @@ smapi.logParser = function (state) {
     state.perPage = 1000;
     state.page = 1;
 
-    state.defaultMods = JSON.parse(JSON.stringify(state.showMods));
-    state.defaultSections = JSON.parse(JSON.stringify(state.showSections));
-    state.defaultLevels = JSON.parse(JSON.stringify(state.showLevels));
+    state.defaultMods = { ...state.showMods };
+    state.defaultSections = { ...state.showSections };
+    state.defaultLevels = { ...state.showLevels };
 
     // load saved values, if any
     if (localStorage.settings) {
@@ -336,18 +310,22 @@ smapi.logParser = function (state) {
                 "div",
                 { class: "stats" },
                 [
-                    createElement('abbr', {
-                        attrs: {
-                            title: "These numbers may be inaccurate when using filtering with sections collapsed."
-                        }
-                    }, [
-                        "showing ",
-                        createElement("strong", helpers.formatNumber(props.start + 1)),
-                        " to ",
-                        createElement("strong", helpers.formatNumber(props.end)),
-                        " of ",
-                        createElement("strong", helpers.formatNumber(props.filtered))
-                    ]),
+                    createElement(
+                        "abbr",
+                        {
+                            attrs: {
+                                title: "These numbers may be inaccurate when using filtering with sections collapsed."
+                            }
+                        },
+                        [
+                            "showing ",
+                            createElement("strong", helpers.formatNumber(props.start + 1)),
+                            " to ",
+                            createElement("strong", helpers.formatNumber(props.end)),
+                            " of ",
+                            createElement("strong", helpers.formatNumber(props.filtered))
+                        ]
+                    ),
                     " (total: ",
                     createElement("strong", helpers.formatNumber(props.total)),
                     ")"
@@ -696,29 +674,18 @@ smapi.logParser = function (state) {
         methods: {
             loadFromUrl: function () {
                 const params = new URL(location).searchParams;
-                if (params.has("PerPage")) {
-                    state.perPage = helpers.tryNumber(params.get("PerPage"), 1000, n => n > 0);
-                } else {
-                    state.perPage = 1000;
-                }
 
-                if (params.has("Page")) {
-                    this.page = helpers.tryNumber(params.get("Page"), 1, n => n > 0);
-                } else {
-                    this.page = 1;
-                }
-
-                if (params.has("Filter"))
-                    state.filterText = params.get("Filter");
-                else
-                    state.filterText = "";
+                state.perPage = helpers.tryParseNumber(params.get("PerPage"), 1000, n => n > 0);
+                this.page = helpers.tryParseNumber(params.get("Page"), 1, n => n > 0);
+                state.filterText = params.get("Filter") || "";
 
                 if (params.has("FilterMode")) {
                     const values = params.get("FilterMode").split("~");
-                    state.useRegex = values.includes('Regex');
-                    state.useInsensitive = !values.includes('Sensitive');
-                    state.useWord = values.includes('Word');
-                } else {
+                    state.useRegex = values.includes("Regex");
+                    state.useInsensitive = !values.includes("Sensitive");
+                    state.useWord = values.includes("Word");
+                }
+                else {
                     state.useRegex = false;
                     state.useInsensitive = true;
                     state.useWord = false;
@@ -729,7 +696,8 @@ smapi.logParser = function (state) {
                     for (const key of Object.keys(this.showMods))
                         this.showMods[key] = value.includes(key);
 
-                } else {
+                }
+                else {
                     for (const key of Object.keys(this.showMods))
                         this.showMods[key] = state.defaultMods[key];
                 }
@@ -739,7 +707,8 @@ smapi.logParser = function (state) {
                     for (const key of Object.keys(this.showLevels))
                         this.showLevels[key] = values.includes(key);
 
-                } else {
+                }
+                else {
                     const keys = Object.keys(this.showLevels);
                     for (const key of Object.keys(this.showLevels))
                         this.showLevels[key] = state.defaultLevels[key];
@@ -750,41 +719,42 @@ smapi.logParser = function (state) {
                     for (const key of Object.keys(this.showSections))
                         this.showSections[key] = values.includes(key);
 
-                } else {
+                }
+                else {
                     for (const key of Object.keys(this.showSections))
                         this.showSections[key] = state.defaultSections[key];
                 }
 
-                updateModFilters();
+                this.updateModFilters();
                 this.updateFilterText();
             },
 
-            // Whenever the page state changed, replace the current page URL. Using
-            // replaceState rather than pushState to avoid filling the tab history
-            // with tons of useless history steps the user probably doesn't
-            // really care about.
+            /**
+             * Update the page URL to track non-default filter values.
+             */
             updateUrl: function () {
                 const url = new URL(location);
                 url.searchParams.set("Page", state.page);
                 url.searchParams.set("PerPage", state.perPage);
 
                 if (!helpers.shallowEquals(this.showMods, state.defaultMods))
-                    url.searchParams.set("Mods", Object.entries(this.showMods).filter(x => x[1]).map(x => x[0]).join("~"));
+                    url.searchParams.set("Mods", Object.entries(this.showMods).filter(p => p[1]).map(p => p[0]).join("~"));
                 else
                     url.searchParams.delete("Mods");
 
                 if (!helpers.shallowEquals(this.showLevels, state.defaultLevels))
-                    url.searchParams.set("Levels", Object.entries(this.showLevels).filter(x => x[1]).map(x => x[0]).join("~"));
+                    url.searchParams.set("Levels", Object.entries(this.showLevels).filter(p => p[1]).map(p => p[0]).join("~"));
                 else
                     url.searchParams.delete("Levels");
 
                 if (!helpers.shallowEquals(this.showSections, state.defaultSections))
-                    url.searchParams.set("Sections", Object.entries(this.showSections).filter(x => x[1]).map(x => x[0]).join("~"));
+                    url.searchParams.set("Sections", Object.entries(this.showSections).filter(p => p[1]).map(p => p[0]).join("~"));
                 else
                     url.searchParams.delete("Sections");
 
-                if (state.filterText && state.filterText.length) {
+                if (state.filterText?.length) {
                     url.searchParams.set("Filter", state.filterText);
+
                     const modes = [];
                     if (state.useRegex)
                         modes.push("Regex");
@@ -798,12 +768,13 @@ smapi.logParser = function (state) {
                     else
                         url.searchParams.delete("FilterMode");
 
-                } else {
+                }
+                else {
                     url.searchParams.delete("Filter");
                     url.searchParams.delete("FilterMode");
                 }
 
-                window.history.replaceState(null, document.title, url.toString());
+                window.history.replaceState(null, document.title, url.toString()); // use replaceState instead of pushState to avoid filling the tab history with history steps the user probably doesn't care about
             },
 
             toggleLevel: function (id) {
@@ -863,8 +834,9 @@ smapi.logParser = function (state) {
                 this.updateUrl();
             },
 
-            // Persist settings into localStorage for use the next time
-            // the user opens a log.
+            /**
+             * Persist settings into localStorage for use the next time the user opens a log.
+             */
             saveSettings: function () {
                 localStorage.settings = JSON.stringify({
                     showContentPacks: state.showContentPacks,
@@ -900,6 +872,20 @@ smapi.logParser = function (state) {
                 250
             ),
 
+            updateModFilters: function () {
+                // counts
+                stats.modsShown = 0;
+                stats.modsHidden = 0;
+                for (let key in state.showMods) {
+                    if (state.showMods.hasOwnProperty(key)) {
+                        if (state.showMods[key])
+                            stats.modsShown++;
+                        else
+                            stats.modsHidden++;
+                    }
+                }
+            },
+
             toggleMod: function (id) {
                 if (!state.enableFilters)
                     return;
@@ -920,7 +906,7 @@ smapi.logParser = function (state) {
                 else
                     this.showMods[id] = !this.showMods[id];
 
-                updateModFilters();
+                this.updateModFilters();
                 this.updateUrl();
             },
 
@@ -941,7 +927,7 @@ smapi.logParser = function (state) {
                         this.showMods[key] = true;
                     }
                 }
-                updateModFilters();
+                this.updateModFilters();
                 this.updateUrl();
             },
 
@@ -954,7 +940,7 @@ smapi.logParser = function (state) {
                         this.showMods[key] = false;
                     }
                 }
-                updateModFilters();
+                this.updateModFilters();
                 this.updateUrl();
             },
 

From e7fd95aafd044d7b8c95b93d0618324254db4eff Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 13:04:16 -0400
Subject: [PATCH 566/856] update release notes

---
 docs/release-notes.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index de30a23b..75c1941e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -17,10 +17,11 @@
   * Fixed `set_farm_type` console command not updating warps.
 
 ### For the web UI
-* Overhauled log parser UI (thanks to KhloeLeclair!):
+* Improved log parser UI (thanks to KhloeLeclair!):
   * Added pagination for big logs.
   * Added search box to filter the log.
   * Added option to show/hide content packs in the mod list.
+  * Added jump links in the sidebar.
   * The filter options now stick to the top of the screen when scrolling.
   * Rewrote rendering to improve performance.
 * Updated the JSON validator/schema for Content Patcher 1.25.0.

From 1974324c43b093a360507546e8be12ad594b56f2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 13:41:37 -0400
Subject: [PATCH 567/856] make EntryDll manifest field case-insensitive

---
 src/SMAPI/Framework/ContentCoordinator.cs     | 17 +-------------
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 15 ++++--------
 src/SMAPI/Framework/SCore.cs                  | 11 +++++----
 .../Utilities/CaseInsensitivePathCache.cs     | 23 +++++++++++++++----
 4 files changed, 30 insertions(+), 36 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 92452224..f83d4090 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -80,9 +80,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
         private readonly TickCacheDictionary<IAssetName, AssetOperationGroup[]> AssetOperationsByKey = new();
 
-        /// <summary>The previously created case-insensitive path caches by root path.</summary>
-        private readonly Dictionary<string, CaseInsensitivePathCache> CaseInsensitivePathCaches = new(StringComparer.OrdinalIgnoreCase);
-
 
         /*********
         ** Accessors
@@ -211,7 +208,7 @@ namespace StardewModdingAPI.Framework
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
                     aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations,
-                    relativePathCache: this.GetCaseInsensitivePathCache(rootDirectory)
+                    relativePathCache: CaseInsensitivePathCache.GetFor(rootDirectory)
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
@@ -486,18 +483,6 @@ namespace StardewModdingAPI.Framework
             });
         }
 
-        /// <summary>Get a dictionary of relative paths within a root path, for case-insensitive file lookups.</summary>
-        /// <param name="rootPath">The root path to scan.</param>
-        public CaseInsensitivePathCache GetCaseInsensitivePathCache(string rootPath)
-        {
-            rootPath = PathUtilities.NormalizePath(rootPath);
-
-            if (!this.CaseInsensitivePathCaches.TryGetValue(rootPath, out CaseInsensitivePathCache? cache))
-                this.CaseInsensitivePathCaches[rootPath] = cache = new CaseInsensitivePathCache(rootPath);
-
-            return cache;
-        }
-
         /// <summary>Get the tilesheet ID order used by the unmodified version of a map asset.</summary>
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
         public TilesheetReference[] GetVanillaTilesheetIds(string assetName)
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index afb388d0..e3c7873c 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -8,7 +8,7 @@ using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Toolkit.Serialization.Models;
-using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Utilities;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
@@ -140,20 +140,13 @@ namespace StardewModdingAPI.Framework.ModLoading
                             continue;
                         }
 
-                        // invalid path
-                        if (!File.Exists(Path.Combine(mod.DirectoryPath, mod.Manifest.EntryDll!)))
+                        // file doesn't exist
+                        string fileName = CaseInsensitivePathCache.GetFor(mod.DirectoryPath).GetFilePath(mod.Manifest.EntryDll!);
+                        if (!File.Exists(Path.Combine(mod.DirectoryPath, fileName)))
                         {
                             mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
                             continue;
                         }
-
-                        // invalid capitalization
-                        string? actualFilename = new DirectoryInfo(mod.DirectoryPath).GetFiles(mod.Manifest.EntryDll!).FirstOrDefault()?.Name;
-                        if (actualFilename != mod.Manifest.EntryDll)
-                        {
-                            mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its {nameof(IManifest.EntryDll)} value '{mod.Manifest.EntryDll}' doesn't match the actual file capitalization '{actualFilename}'. The capitalization must match for crossplatform compatibility.");
-                            continue;
-                        }
                     }
 
                     // validate content pack
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 990fe5ea..d2890c29 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1748,7 +1748,7 @@ namespace StardewModdingAPI.Framework
             if (mod.IsContentPack)
             {
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
-                CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
+                CaseInsensitivePathCache relativePathCache = CaseInsensitivePathCache.GetFor(mod.DirectoryPath);
                 GameContentHelper gameContentHelper = new(this.ContentCore, mod, mod.DisplayName, monitor, this.Reflection);
                 IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
                 TranslationHelper translationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
@@ -1765,7 +1765,10 @@ namespace StardewModdingAPI.Framework
             else
             {
                 // get mod info
-                string assemblyPath = Path.Combine(mod.DirectoryPath, manifest.EntryDll!);
+                string assemblyPath = Path.Combine(
+                    mod.DirectoryPath,
+                    CaseInsensitivePathCache.GetFor(mod.DirectoryPath).GetFilePath(manifest.EntryDll!)
+                );
 
                 // load mod
                 Assembly modAssembly;
@@ -1830,7 +1833,7 @@ namespace StardewModdingAPI.Framework
                         {
                             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
 
-                            CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(packDirPath);
+                            CaseInsensitivePathCache relativePathCache = CaseInsensitivePathCache.GetFor(packDirPath);
 
                             GameContentHelper gameContentHelper = new(contentCore, mod, packManifest.Name, packMonitor, this.Reflection);
                             IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, mod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
@@ -1844,7 +1847,7 @@ namespace StardewModdingAPI.Framework
 
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
-                        CaseInsensitivePathCache relativePathCache = this.ContentCore.GetCaseInsensitivePathCache(mod.DirectoryPath);
+                        CaseInsensitivePathCache relativePathCache = CaseInsensitivePathCache.GetFor(mod.DirectoryPath);
 #pragma warning disable CS0612 // deprecated code
                         ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, mod, monitor, this.Reflection);
 #pragma warning restore CS0612
diff --git a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs b/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
index 2ac1b9f9..04fdcfae 100644
--- a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
+++ b/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
@@ -16,6 +16,9 @@ namespace StardewModdingAPI.Utilities
         /// <summary>A case-insensitive lookup of file paths within the <see cref="RootPath"/>. Each path is listed in both file path and asset name format, so it's usable in both contexts without needing to re-parse paths.</summary>
         private readonly Lazy<Dictionary<string, string>> RelativePathCache;
 
+        /// <summary>The case-insensitive path caches by root path.</summary>
+        private static readonly Dictionary<string, CaseInsensitivePathCache> CachesByRootPath = new(StringComparer.OrdinalIgnoreCase);
+
 
         /*********
         ** Public methods
@@ -65,6 +68,18 @@ namespace StardewModdingAPI.Utilities
             this.CacheRawPath(this.RelativePathCache.Value, relativePath);
         }
 
+        /// <summary>Get a cached dictionary of relative paths within a root path, for case-insensitive file lookups.</summary>
+        /// <param name="rootPath">The root path to scan.</param>
+        public static CaseInsensitivePathCache GetFor(string rootPath)
+        {
+            rootPath = PathUtilities.NormalizePath(rootPath);
+
+            if (!CaseInsensitivePathCache.CachesByRootPath.TryGetValue(rootPath, out CaseInsensitivePathCache? cache))
+                CaseInsensitivePathCache.CachesByRootPath[rootPath] = cache = new CaseInsensitivePathCache(rootPath);
+
+            return cache;
+        }
+
 
         /*********
         ** Private methods
@@ -82,15 +97,13 @@ namespace StardewModdingAPI.Utilities
             if (this.RelativePathCache.Value.TryGetValue(relativePath, out string? resolved))
                 return resolved;
 
-            // file exists but isn't cached for some reason
-            // cache it now so any later references to it are case-insensitive
+            // keep capitalization as-is
             if (File.Exists(Path.Combine(this.RootPath, relativePath)))
             {
+                // file exists but isn't cached for some reason
+                // cache it now so any later references to it are case-insensitive
                 this.CacheRawPath(this.RelativePathCache.Value, relativePath);
-                return relativePath;
             }
-
-            // no such file, keep capitalization as-is
             return relativePath;
         }
 

From 446205c7bd342422f4b4f14d6c8f36dc0b6cf468 Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Sat, 16 Apr 2022 13:55:54 -0400
Subject: [PATCH 568/856] Add regex error checking, and display a message to
 the user when their regular expression has a syntax error. Additionally, use
 a non-capturing group to surround the user input when `Match whole word` is
 enabled in case alternates are being used. Finally, add a safety check to
 highlighting to avoid an infinite loop when zero-length matches happen.

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  6 ++++
 .../wwwroot/Content/css/log-parser.css        |  7 +++-
 .../wwwroot/Content/js/log-parser.js          | 33 ++++++++++++++++---
 3 files changed, 40 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index dfb603f2..5e55906d 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -406,6 +406,12 @@ else if (log?.IsValid == true)
                             <span role="button" v-bind:class="{ active: !filterInsensitive }" v-on:click="toggleFilterInsensitive" title="Match exact capitalization only.">aA</span>
                             <span role="button" v-bind:class="{ active: filterUseWord, 'whole-word': true }" v-on:click="toggleFilterWord" title="Match whole word only."><i>“ ”</i></span>
                             <span role="button" v-bind:class="{ active: shouldHighlight }" v-on:click="toggleHighlight" title="Highlight matches in the log text.">HL</span>
+                            <div
+                                v-if="filterError"
+                                class="filter-error"
+                            >
+                                {{ filterError }}
+                            </div>
                         </div>
                         <filter-stats
                             v-bind:start="start"
diff --git a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
index 41b54e11..1d457e35 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
@@ -187,6 +187,11 @@ table caption {
     margin-top: 0.5em;
 }
 
+#filters .filter-error {
+    color: #880000;
+}
+
+#filters .filter-error,
 #filters .stats {
     margin-top: 0.5em;
     font-size: 0.75em;
@@ -210,7 +215,7 @@ table caption {
 
 @media (max-width: 1019px) {
     #filters:not(.sticky) {
-        width: calc(100vw - 3em);
+        width: calc(100vw - 5em);
     }
 
     #filters {
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index c730309b..e19e3301 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -247,7 +247,8 @@ smapi.logParser = function (state) {
     // add the properties we're passing to Vue
     state.totalMessages = state.messages.length;
     state.filterText = "";
-    state.filterRegex = "";
+    state.filterRegex = null;
+    state.filterError = null;
     state.showContentPacks = true;
     state.useHighlight = true;
     state.useRegex = false;
@@ -506,6 +507,12 @@ smapi.logParser = function (state) {
                     }
 
                     index = match.index + match[0].length;
+
+                    // In the event of a zero-length match, forcibly increment
+                    // the last index of the regular expression to ensure we
+                    // aren't stuck in an infinite loop.
+                    if (match[0].length == 0)
+                        filter.lastIndex++;
                 }
 
                 // Add any trailing text after the last match was found.
@@ -857,14 +864,30 @@ smapi.logParser = function (state) {
                     if (!text || !text.length) {
                         this.filterText = "";
                         this.filterRegex = null;
+                        this.filterError = null;
                     }
                     else {
                         if (!state.useRegex)
                             text = helpers.escapeRegex(text);
-                        this.filterRegex = new RegExp(
-                            state.useWord ? `\\b${text}\\b` : text,
-                            state.useInsensitive ? "ig" : "g"
-                        );
+
+                        const flags = state.useInsensitive ? "ig" : "g";
+
+                        this.filterError = null;
+                        let regex;
+
+                        try {
+                            regex = new RegExp(text, flags);
+                        } catch (err) {
+                            regex = null;
+                            this.filterError = err.message;
+                        }
+
+                        if (regex)
+                            this.filterRegex = state.useWord ?
+                                new RegExp(`\\b(?:${text})\\b`, flags) :
+                                regex;
+                        else
+                            this.filterRegex = null;
                     }
 
                     this.updateUrl();

From 95d7ba8935ac7214805147e694353206a56bddb7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 14:07:09 -0400
Subject: [PATCH 569/856] move case-insensitive path lookup into toolkit for
 reuse

---
 .../Utilities/CaseInsensitivePathLookup.cs}        | 14 +++++++-------
 src/SMAPI/Framework/ContentCoordinator.cs          |  4 ++--
 .../Framework/ContentManagers/ModContentManager.cs |  6 +++---
 src/SMAPI/Framework/ContentPack.cs                 |  6 +++---
 src/SMAPI/Framework/ModHelpers/ModContentHelper.cs |  6 +++---
 src/SMAPI/Framework/ModLoading/ModResolver.cs      |  4 ++--
 src/SMAPI/Framework/SCore.cs                       |  8 ++++----
 7 files changed, 24 insertions(+), 24 deletions(-)
 rename src/{SMAPI/Utilities/CaseInsensitivePathCache.cs => SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs} (91%)

diff --git a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs b/src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs
similarity index 91%
rename from src/SMAPI/Utilities/CaseInsensitivePathCache.cs
rename to src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs
index 04fdcfae..2e149e3c 100644
--- a/src/SMAPI/Utilities/CaseInsensitivePathCache.cs
+++ b/src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs
@@ -2,10 +2,10 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 
-namespace StardewModdingAPI.Utilities
+namespace StardewModdingAPI.Toolkit.Utilities
 {
     /// <summary>Provides an API for case-insensitive relative path lookups within a root directory.</summary>
-    internal class CaseInsensitivePathCache
+    internal class CaseInsensitivePathLookup
     {
         /*********
         ** Fields
@@ -17,7 +17,7 @@ namespace StardewModdingAPI.Utilities
         private readonly Lazy<Dictionary<string, string>> RelativePathCache;
 
         /// <summary>The case-insensitive path caches by root path.</summary>
-        private static readonly Dictionary<string, CaseInsensitivePathCache> CachesByRootPath = new(StringComparer.OrdinalIgnoreCase);
+        private static readonly Dictionary<string, CaseInsensitivePathLookup> CachedRoots = new(StringComparer.OrdinalIgnoreCase);
 
 
         /*********
@@ -25,7 +25,7 @@ namespace StardewModdingAPI.Utilities
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="rootPath">The root directory path for relative paths.</param>
-        public CaseInsensitivePathCache(string rootPath)
+        public CaseInsensitivePathLookup(string rootPath)
         {
             this.RootPath = rootPath;
             this.RelativePathCache = new(this.GetRelativePathCache);
@@ -70,12 +70,12 @@ namespace StardewModdingAPI.Utilities
 
         /// <summary>Get a cached dictionary of relative paths within a root path, for case-insensitive file lookups.</summary>
         /// <param name="rootPath">The root path to scan.</param>
-        public static CaseInsensitivePathCache GetFor(string rootPath)
+        public static CaseInsensitivePathLookup GetCachedFor(string rootPath)
         {
             rootPath = PathUtilities.NormalizePath(rootPath);
 
-            if (!CaseInsensitivePathCache.CachesByRootPath.TryGetValue(rootPath, out CaseInsensitivePathCache? cache))
-                CaseInsensitivePathCache.CachesByRootPath[rootPath] = cache = new CaseInsensitivePathCache(rootPath);
+            if (!CaseInsensitivePathLookup.CachedRoots.TryGetValue(rootPath, out CaseInsensitivePathLookup? cache))
+                CaseInsensitivePathLookup.CachedRoots[rootPath] = cache = new CaseInsensitivePathLookup(rootPath);
 
             return cache;
         }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index f83d4090..aade7b36 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -15,7 +15,7 @@ using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
 using StardewModdingAPI.Metadata;
 using StardewModdingAPI.Toolkit.Serialization;
-using StardewModdingAPI.Utilities;
+using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
 using StardewValley.GameData;
 using xTile;
@@ -208,7 +208,7 @@ namespace StardewModdingAPI.Framework
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
                     aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations,
-                    relativePathCache: CaseInsensitivePathCache.GetFor(rootDirectory)
+                    relativePathCache: CaseInsensitivePathLookup.GetCachedFor(rootDirectory)
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index f0f4bce9..8f64c5a8 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -9,7 +9,7 @@ using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Serialization;
-using StardewModdingAPI.Utilities;
+using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
 using xTile;
 using xTile.Format;
@@ -33,7 +33,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private readonly IContentManager GameContentManager;
 
         /// <summary>A case-insensitive lookup of relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
-        private readonly CaseInsensitivePathCache RelativePathCache;
+        private readonly CaseInsensitivePathLookup RelativePathCache;
 
         /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
         private readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
@@ -56,7 +56,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
         /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="rootDirectory"/>.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, bool aggressiveMemoryOptimizations, CaseInsensitivePathCache relativePathCache)
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, bool aggressiveMemoryOptimizations, CaseInsensitivePathLookup relativePathCache)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true, aggressiveMemoryOptimizations: aggressiveMemoryOptimizations)
         {
             this.GameContentManager = gameContentManager;
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index 2cfd5cce..dde33c95 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -2,7 +2,7 @@ using System;
 using System.IO;
 using StardewModdingAPI.Framework.ModHelpers;
 using StardewModdingAPI.Toolkit.Serialization;
-using StardewModdingAPI.Utilities;
+using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Framework
 {
@@ -16,7 +16,7 @@ namespace StardewModdingAPI.Framework
         private readonly JsonHelper JsonHelper;
 
         /// <summary>A case-insensitive lookup of relative paths within the <see cref="DirectoryPath"/>.</summary>
-        private readonly CaseInsensitivePathCache RelativePathCache;
+        private readonly CaseInsensitivePathLookup RelativePathCache;
 
 
         /*********
@@ -48,7 +48,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="translation">Provides translations stored in the content pack's <c>i18n</c> folder.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="directoryPath"/>.</param>
-        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper, CaseInsensitivePathCache relativePathCache)
+        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper, CaseInsensitivePathLookup relativePathCache)
         {
             this.DirectoryPath = directoryPath;
             this.Manifest = manifest;
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index 4a058a48..def0b728 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -4,7 +4,7 @@ using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
-using StardewModdingAPI.Utilities;
+using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Framework.ModHelpers
 {
@@ -24,7 +24,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         private readonly string ModName;
 
         /// <summary>A case-insensitive lookup of relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
-        private readonly CaseInsensitivePathCache RelativePathCache;
+        private readonly CaseInsensitivePathLookup RelativePathCache;
 
         /// <summary>Simplifies access to private code.</summary>
         private readonly Reflector Reflection;
@@ -41,7 +41,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="gameContentManager">The game content manager used for map tilesheets not provided by the mod.</param>
         /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="relativePathCache"/>.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IContentManager gameContentManager, CaseInsensitivePathCache relativePathCache, Reflector reflection)
+        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IContentManager gameContentManager, CaseInsensitivePathLookup relativePathCache, Reflector reflection)
             : base(mod)
         {
             string managedAssetPrefix = contentCore.GetManagedAssetPrefix(mod.Manifest.UniqueID);
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index e3c7873c..4a02e90d 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -8,7 +8,7 @@ using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Toolkit.Serialization.Models;
-using StardewModdingAPI.Utilities;
+using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
@@ -141,7 +141,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                         }
 
                         // file doesn't exist
-                        string fileName = CaseInsensitivePathCache.GetFor(mod.DirectoryPath).GetFilePath(mod.Manifest.EntryDll!);
+                        string fileName = CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath).GetFilePath(mod.Manifest.EntryDll!);
                         if (!File.Exists(Path.Combine(mod.DirectoryPath, fileName)))
                         {
                             mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index d2890c29..b3c9087f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1748,7 +1748,7 @@ namespace StardewModdingAPI.Framework
             if (mod.IsContentPack)
             {
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
-                CaseInsensitivePathCache relativePathCache = CaseInsensitivePathCache.GetFor(mod.DirectoryPath);
+                CaseInsensitivePathLookup relativePathCache = CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath);
                 GameContentHelper gameContentHelper = new(this.ContentCore, mod, mod.DisplayName, monitor, this.Reflection);
                 IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
                 TranslationHelper translationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
@@ -1767,7 +1767,7 @@ namespace StardewModdingAPI.Framework
                 // get mod info
                 string assemblyPath = Path.Combine(
                     mod.DirectoryPath,
-                    CaseInsensitivePathCache.GetFor(mod.DirectoryPath).GetFilePath(manifest.EntryDll!)
+                    CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath).GetFilePath(manifest.EntryDll!)
                 );
 
                 // load mod
@@ -1833,7 +1833,7 @@ namespace StardewModdingAPI.Framework
                         {
                             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
 
-                            CaseInsensitivePathCache relativePathCache = CaseInsensitivePathCache.GetFor(packDirPath);
+                            CaseInsensitivePathLookup relativePathCache = CaseInsensitivePathLookup.GetCachedFor(packDirPath);
 
                             GameContentHelper gameContentHelper = new(contentCore, mod, packManifest.Name, packMonitor, this.Reflection);
                             IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, mod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
@@ -1847,7 +1847,7 @@ namespace StardewModdingAPI.Framework
 
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
-                        CaseInsensitivePathCache relativePathCache = CaseInsensitivePathCache.GetFor(mod.DirectoryPath);
+                        CaseInsensitivePathLookup relativePathCache = CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath);
 #pragma warning disable CS0612 // deprecated code
                         ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, mod, monitor, this.Reflection);
 #pragma warning restore CS0612

From f93c41f55c199293b4b8e00fc38ab89d24837f03 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 14:28:20 -0400
Subject: [PATCH 570/856] make manifest.json filename case-insensitive

---
 .../Framework/ModScanning/ModScanner.cs          | 16 ++++++++++++++--
 .../Utilities/CaseInsensitivePathLookup.cs       | 10 ++++++----
 2 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 12333c4e..84329f63 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using System.Text.RegularExpressions;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Serialization.Models;
+using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 {
@@ -251,8 +252,19 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         {
             while (true)
             {
-                // check for manifest in current folder
-                FileInfo file = new(Path.Combine(folder.FullName, "manifest.json"));
+                // check for conventional manifest in current folder
+                const string defaultName = "manifest.json";
+                FileInfo file = new(Path.Combine(folder.FullName, defaultName));
+                if (file.Exists)
+                    return file;
+
+                // check for manifest with incorrect capitalization
+                {
+                    CaseInsensitivePathLookup pathLookup = new(folder.FullName, SearchOption.TopDirectoryOnly); // don't use GetCachedFor, since we only need it temporarily
+                    string realName = pathLookup.GetFilePath(defaultName);
+                    if (realName != defaultName)
+                        file = new(Path.Combine(folder.FullName, realName));
+                }
                 if (file.Exists)
                     return file;
 
diff --git a/src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs b/src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs
index 2e149e3c..12fad008 100644
--- a/src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs
+++ b/src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs
@@ -25,10 +25,11 @@ namespace StardewModdingAPI.Toolkit.Utilities
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="rootPath">The root directory path for relative paths.</param>
-        public CaseInsensitivePathLookup(string rootPath)
+        /// <param name="searchOption">Which directories to scan from the root.</param>
+        public CaseInsensitivePathLookup(string rootPath, SearchOption searchOption = SearchOption.AllDirectories)
         {
             this.RootPath = rootPath;
-            this.RelativePathCache = new(this.GetRelativePathCache);
+            this.RelativePathCache = new(() => this.GetRelativePathCache(searchOption));
         }
 
         /// <summary>Get the exact capitalization for a given relative file path.</summary>
@@ -108,11 +109,12 @@ namespace StardewModdingAPI.Toolkit.Utilities
         }
 
         /// <summary>Get a case-insensitive lookup of file paths (see <see cref="RelativePathCache"/>).</summary>
-        private Dictionary<string, string> GetRelativePathCache()
+        /// <param name="searchOption">Which directories to scan from the root.</param>
+        private Dictionary<string, string> GetRelativePathCache(SearchOption searchOption)
         {
             Dictionary<string, string> cache = new(StringComparer.OrdinalIgnoreCase);
 
-            foreach (string path in Directory.EnumerateFiles(this.RootPath, "*", SearchOption.AllDirectories))
+            foreach (string path in Directory.EnumerateFiles(this.RootPath, "*", searchOption))
             {
                 string relativePath = path.Substring(this.RootPath.Length + 1);
 

From 559d763756e3ccbd7feaa3b82d7924d8cd97969f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 14:34:52 -0400
Subject: [PATCH 571/856] remove unused subfolder manifest scanning

This isn't needed anymore with the current is-mod-folder scanning.
---
 .../Framework/ModScanning/ModScanner.cs       | 43 +++++++------------
 1 file changed, 16 insertions(+), 27 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 84329f63..24485620 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -250,35 +250,24 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         /// <param name="folder">The folder to search.</param>
         private FileInfo? FindManifest(DirectoryInfo folder)
         {
-            while (true)
+            // check for conventional manifest in current folder
+            const string defaultName = "manifest.json";
+            FileInfo file = new(Path.Combine(folder.FullName, defaultName));
+            if (file.Exists)
+                return file;
+
+            // check for manifest with incorrect capitalization
             {
-                // check for conventional manifest in current folder
-                const string defaultName = "manifest.json";
-                FileInfo file = new(Path.Combine(folder.FullName, defaultName));
-                if (file.Exists)
-                    return file;
-
-                // check for manifest with incorrect capitalization
-                {
-                    CaseInsensitivePathLookup pathLookup = new(folder.FullName, SearchOption.TopDirectoryOnly); // don't use GetCachedFor, since we only need it temporarily
-                    string realName = pathLookup.GetFilePath(defaultName);
-                    if (realName != defaultName)
-                        file = new(Path.Combine(folder.FullName, realName));
-                }
-                if (file.Exists)
-                    return file;
-
-                // check for single subfolder
-                FileSystemInfo[] entries = folder.EnumerateFileSystemInfos().Take(2).ToArray();
-                if (entries.Length == 1 && entries[0] is DirectoryInfo subfolder)
-                {
-                    folder = subfolder;
-                    continue;
-                }
-
-                // not found
-                return null;
+                CaseInsensitivePathLookup pathLookup = new(folder.FullName, SearchOption.TopDirectoryOnly); // don't use GetCachedFor, since we only need it temporarily
+                string realName = pathLookup.GetFilePath(defaultName);
+                if (realName != defaultName)
+                    file = new(Path.Combine(folder.FullName, realName));
             }
+            if (file.Exists)
+                return file;
+
+            // not found
+            return null;
         }
 
         /// <summary>Get whether a given folder should be treated as a search folder (i.e. look for subfolders containing mods).</summary>

From 20224d293d03d34860505980cabdb4bc5cf13319 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 16:59:53 -0400
Subject: [PATCH 572/856] add unit test for proxied out parameters

---
 .../Interfaces/ISimpleApi.cs                  |  4 ++
 .../Framework/SimpleApi.cs                    | 15 +++++++
 .../SMAPI.Tests.ModApiProvider.csproj         |  4 ++
 src/SMAPI.Tests/Core/InterfaceProxyTests.cs   | 39 +++++++++++++++++++
 4 files changed, 62 insertions(+)

diff --git a/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs b/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
index 7f94e137..c99605e4 100644
--- a/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
+++ b/src/SMAPI.Tests.ModApiConsumer/Interfaces/ISimpleApi.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Reflection;
+using StardewModdingAPI.Utilities;
 
 namespace SMAPI.Tests.ModApiConsumer.Interfaces
 {
@@ -69,6 +70,9 @@ namespace SMAPI.Tests.ModApiConsumer.Interfaces
         /// <summary>A simple method which returns a lambda.</summary>
         Func<string, string> GetLambda(Func<string, string> value);
 
+        /// <summary>A simple method which returns out parameters.</summary>
+        bool TryGetOutParameter(int inputNumber, out int outNumber, out string outString, out PerScreen<int> outReference, out IDictionary<int, PerScreen<int>> outComplexType);
+
 
         /****
         ** Inherited members
diff --git a/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs b/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
index e7e1ccef..c8781da5 100644
--- a/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
+++ b/src/SMAPI.Tests.ModApiProvider/Framework/SimpleApi.cs
@@ -3,6 +3,7 @@
 using System;
 using System.Collections.Generic;
 using System.Reflection;
+using StardewModdingAPI.Utilities;
 
 namespace SMAPI.Tests.ModApiProvider.Framework
 {
@@ -96,6 +97,20 @@ namespace SMAPI.Tests.ModApiProvider.Framework
             return value;
         }
 
+        /// <summary>A simple method which returns out parameters.</summary>
+        public bool TryGetOutParameter(int inputNumber, out int outNumber, out string outString, out PerScreen<int> outReference, out IDictionary<int, PerScreen<int>> outComplexType)
+        {
+            outNumber = inputNumber;
+            outString = inputNumber.ToString();
+            outReference = new PerScreen<int>(() => inputNumber);
+            outComplexType = new Dictionary<int, PerScreen<int>>
+            {
+                [inputNumber] = new PerScreen<int>(() => inputNumber)
+            };
+
+            return true;
+        }
+
 
         /*********
         ** Helper methods
diff --git a/src/SMAPI.Tests.ModApiProvider/SMAPI.Tests.ModApiProvider.csproj b/src/SMAPI.Tests.ModApiProvider/SMAPI.Tests.ModApiProvider.csproj
index 70d5a0ce..7fef4ebd 100644
--- a/src/SMAPI.Tests.ModApiProvider/SMAPI.Tests.ModApiProvider.csproj
+++ b/src/SMAPI.Tests.ModApiProvider/SMAPI.Tests.ModApiProvider.csproj
@@ -4,4 +4,8 @@
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
+
+  <ItemGroup>
+    <ProjectReference Include="..\SMAPI\SMAPI.csproj" />
+  </ItemGroup>
 </Project>
diff --git a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
index 0b4919ed..8d27f6af 100644
--- a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
+++ b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using System.Reflection;
 using FluentAssertions;
 using NUnit.Framework;
@@ -8,6 +9,7 @@ using SMAPI.Tests.ModApiConsumer;
 using SMAPI.Tests.ModApiConsumer.Interfaces;
 using SMAPI.Tests.ModApiProvider;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Utilities;
 
 namespace SMAPI.Tests.Core
 {
@@ -308,6 +310,43 @@ namespace SMAPI.Tests.Core
             actualValue.Should().BeSameAs(expectedValue);
         }
 
+        /// <summary>Assert that a method with out parameters can be proxied correctly.</summary>
+        [Test]
+        [SuppressMessage("ReSharper", "ConvertToLocalFunction")]
+        public void CanProxy_Method_OutParameters()
+        {
+            // arrange
+            object implementation = new ProviderMod().GetModApi();
+            const int expectedNumber = 42;
+
+            // act
+            ISimpleApi proxy = this.GetProxy(implementation);
+            bool result = proxy.TryGetOutParameter(
+                inputNumber: expectedNumber,
+
+                out int outNumber,
+                out string outString,
+                out PerScreen<int> outReference,
+                out IDictionary<int, PerScreen<int>> outComplexType
+            );
+
+            // assert
+            result.Should().BeTrue();
+
+            outNumber.Should().Be(expectedNumber);
+
+            outString.Should().Be(expectedNumber.ToString());
+
+            outReference.Should().NotBeNull();
+            outReference.Value.Should().Be(expectedNumber);
+
+            outComplexType.Should().NotBeNull();
+            outComplexType.Count.Should().Be(1);
+            outComplexType.Keys.First().Should().Be(expectedNumber);
+            outComplexType.Values.First().Should().NotBeNull();
+            outComplexType.Values.First().Value.Should().Be(expectedNumber);
+        }
+
 
         /*********
         ** Private methods

From 7dec51923418b269e111a266edb319ff3b0cb118 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 18:29:52 -0400
Subject: [PATCH 573/856] fix broken unit tests

---
 .../NetFieldAnalyzerTests.cs                  |  2 +-
 src/SMAPI.Tests/Core/AssetNameTests.cs        | 16 ++---
 src/SMAPI.Tests/Core/ModResolverTests.cs      | 60 ++++++++++---------
 .../Clients/Wiki/ChangeDescriptor.cs          |  7 ++-
 src/SMAPI/Framework/Content/AssetName.cs      | 16 ++---
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 14 +++--
 src/SMAPI/Framework/Translator.cs             |  3 +-
 7 files changed, 68 insertions(+), 50 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs b/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
index f11a59d3..a6fa5633 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/NetFieldAnalyzerTests.cs
@@ -87,7 +87,7 @@ namespace SMAPI.ModBuildConfig.Analyzer.Tests
         [TestCase("SObject obj = null; if (obj.netRefProperty != null);", 24, "obj.netRefProperty", "NetRef", "object")]
         [TestCase("Item item = new Item(); object list = item.netList;", 38, "item.netList", "NetList", "object")] // ↓ NetList field converted to a non-interface type
         [TestCase("Item item = new Item(); object list = item.netCollection;", 38, "item.netCollection", "NetCollection", "object")]
-        [TestCase("Item item = new Item(); int x = (int)item.netIntField;", 32, "item.netIntField", "NetInt", "int")] // ↓ explicit conversion to invalid type
+        [TestCase("Item item = new Item(); int x = (int)item.netIntField;", 32, "item.netIntField", "NetFieldBase", "int")] // ↓ explicit conversion to invalid type
         [TestCase("Item item = new Item(); int x = item.netRefField as object;", 32, "item.netRefField", "NetRef", "object")]
         public void AvoidImplicitNetFieldComparisons_RaisesDiagnostic(string codeText, int column, string expression, string fromType, string toType)
         {
diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index a1712726..655e9bae 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -78,9 +78,9 @@ namespace SMAPI.Tests.Core
         [TestCase("DATA\\achievements", "data/ACHIEVEMENTS", ExpectedResult = true)]
         [TestCase("DATA\\\\achievements", "data////ACHIEVEMENTS", ExpectedResult = true)]
 
-        // whitespace-sensitive
-        [TestCase("Data/Achievements", " Data/Achievements ", ExpectedResult = false)]
-        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = false)]
+        // whitespace-insensitive
+        [TestCase("Data/Achievements", " Data/Achievements ", ExpectedResult = true)]
+        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = true)]
 
         // other is null or whitespace
         [TestCase("Data/Achievements", null, ExpectedResult = false)]
@@ -109,7 +109,7 @@ namespace SMAPI.Tests.Core
         [TestCase("Data/Achievements", "Data/Achievements", ExpectedResult = true)]
         [TestCase("DATA/achievements", "data/ACHIEVEMENTS", ExpectedResult = true)]
         [TestCase("DATA\\\\achievements", "data////ACHIEVEMENTS", ExpectedResult = true)]
-        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = false)]
+        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = true)]
         [TestCase("Data/Achievements", "   ", ExpectedResult = false)]
 
         // with locale codes
@@ -141,13 +141,13 @@ namespace SMAPI.Tests.Core
         [TestCase("DATA\\achievements", "data/ACHIEVEMENTS", ExpectedResult = true)]
         [TestCase("DATA\\\\achievements", "data////ACHIEVEMENTS", ExpectedResult = true)]
 
-        // leading-whitespace-sensitive
-        [TestCase("Data/Achievements", " Data/Achievements", ExpectedResult = false)]
-        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = false)]
+        // whitespace-insensitive
+        [TestCase("Data/Achievements", " Data/Achievements", ExpectedResult = true)]
+        [TestCase(" Data/Achievements ", "Data/Achievements", ExpectedResult = true)]
+        [TestCase("Data/Achievements", "   ", ExpectedResult = true)]
 
         // invalid prefixes
         [TestCase("Data/Achievements", null, ExpectedResult = false)]
-        [TestCase("Data/Achievements", "   ", ExpectedResult = false)]
 
         // with locale codes
         [TestCase("Data/Achievements.fr-FR", "Data/Achievements", ExpectedResult = true)]
diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index bd621bbf..6b2746f5 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -38,6 +38,9 @@ namespace SMAPI.Tests.Core
 
             // assert
             Assert.AreEqual(0, mods.Length, 0, $"Expected to find zero manifests, found {mods.Length} instead.");
+
+            // cleanup
+            Directory.Delete(rootFolder, recursive: true);
         }
 
         [Test(Description = "Assert that the resolver correctly returns a failed metadata if there's an empty mod folder.")]
@@ -56,6 +59,9 @@ namespace SMAPI.Tests.Core
             Assert.AreEqual(1, mods.Length, 0, $"Expected to find one manifest, found {mods.Length} instead.");
             Assert.AreEqual(ModMetadataStatus.Failed, mod!.Status, "The mod metadata was not marked failed.");
             Assert.IsNotNull(mod.Error, "The mod metadata did not have an error message set.");
+
+            // cleanup
+            Directory.Delete(rootFolder, recursive: true);
         }
 
         [Test(Description = "Assert that the resolver correctly reads manifest data from a randomized file.")]
@@ -115,6 +121,9 @@ namespace SMAPI.Tests.Core
             Assert.IsNotNull(mod.Manifest.Dependencies, "The dependencies field should not be null.");
             Assert.AreEqual(1, mod.Manifest.Dependencies.Length, "The dependencies field should contain one value.");
             Assert.AreEqual(originalDependency[nameof(IManifestDependency.UniqueID)], mod.Manifest.Dependencies[0].UniqueID, "The first dependency's unique ID doesn't match.");
+
+            // cleanup
+            Directory.Delete(rootFolder, recursive: true);
         }
 
         /****
@@ -123,7 +132,7 @@ namespace SMAPI.Tests.Core
         [Test(Description = "Assert that validation doesn't fail if there are no mods installed.")]
         public void ValidateManifests_NoMods_DoesNothing()
         {
-            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
+            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
         }
 
         [Test(Description = "Assert that validation skips manifests that have already failed without calling any other properties.")]
@@ -134,7 +143,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.Status).Returns(ModMetadataStatus.Failed);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
 
             // assert
             mock.VerifyGet(p => p.Status, Times.Once, "The validation did not check the manifest status.");
@@ -145,13 +154,13 @@ namespace SMAPI.Tests.Core
         {
             // arrange
             Mock<IModMetadata> mock = this.GetMetadata("Mod A", Array.Empty<string>(), allowStatusChange: true);
-            this.SetupMetadataForValidation(mock, new ModDataRecordVersionedFields(this.GetModDataRecord())
+            mock.Setup(p => p.DataRecord).Returns(() => new ModDataRecordVersionedFields(this.GetModDataRecord())
             {
                 Status = ModStatus.AssumeBroken
             });
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -163,10 +172,9 @@ namespace SMAPI.Tests.Core
             // arrange
             Mock<IModMetadata> mock = this.GetMetadata("Mod A", Array.Empty<string>(), allowStatusChange: true);
             mock.Setup(p => p.Manifest).Returns(this.GetManifest(minimumApiVersion: "1.1"));
-            this.SetupMetadataForValidation(mock);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -176,14 +184,18 @@ namespace SMAPI.Tests.Core
         public void ValidateManifests_MissingEntryDLL_Fails()
         {
             // arrange
-            Mock<IModMetadata> mock = this.GetMetadata(this.GetManifest(id: "Mod A", version: "1.0", entryDll: "Missing.dll"), allowStatusChange: true);
-            this.SetupMetadataForValidation(mock);
+            string directoryPath = this.GetTempFolderPath();
+            Mock<IModMetadata> mock = this.GetMetadata(this.GetManifest(id: "Mod A", version: "1.0", entryDll: "Missing.dll"), allowStatusChange: true, directoryPath: directoryPath);
+            Directory.CreateDirectory(directoryPath);
 
             // act
             new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
+
+            // cleanup
+            Directory.Delete(directoryPath);
         }
 
         [Test(Description = "Assert that validation fails when multiple mods have the same unique ID.")]
@@ -192,16 +204,13 @@ namespace SMAPI.Tests.Core
             // arrange
             Mock<IModMetadata> modA = this.GetMetadata("Mod A", Array.Empty<string>(), allowStatusChange: true);
             Mock<IModMetadata> modB = this.GetMetadata(this.GetManifest(id: "Mod A", name: "Mod B", version: "1.0"), allowStatusChange: true);
-            Mock<IModMetadata> modC = this.GetMetadata("Mod C", Array.Empty<string>(), allowStatusChange: false);
-            foreach (Mock<IModMetadata> mod in new[] { modA, modB, modC })
-                this.SetupMetadataForValidation(mod);
 
             // act
-            new ModResolver().ValidateManifests(new[] { modA.Object, modB.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
+            new ModResolver().ValidateManifests(new[] { modA.Object, modB.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
 
             // assert
-            modA.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the first mod with a unique ID.");
-            modB.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the second mod with a unique ID.");
+            modA.Verify(p => p.SetStatus(ModMetadataStatus.Failed, ModFailReason.Duplicate, It.IsAny<string>(), It.IsAny<string>()), Times.AtLeastOnce, "The validation did not fail the first mod with a unique ID.");
+            modB.Verify(p => p.SetStatus(ModMetadataStatus.Failed, ModFailReason.Duplicate, It.IsAny<string>(), It.IsAny<string>()), Times.AtLeastOnce, "The validation did not fail the second mod with a unique ID.");
         }
 
         [Test(Description = "Assert that validation fails when the manifest references a DLL that does not exist.")]
@@ -227,6 +236,9 @@ namespace SMAPI.Tests.Core
 
             // assert
             // if Moq doesn't throw a method-not-setup exception, the validation didn't override the status.
+
+            // cleanup
+            Directory.Delete(modFolder, recursive: true);
         }
 
         /****
@@ -514,14 +526,20 @@ namespace SMAPI.Tests.Core
         /// <summary>Get a randomized basic manifest.</summary>
         /// <param name="manifest">The mod manifest.</param>
         /// <param name="allowStatusChange">Whether the code being tested is allowed to change the mod status.</param>
-        private Mock<IModMetadata> GetMetadata(IManifest manifest, bool allowStatusChange = false)
+        /// <param name="directoryPath">The directory path the mod metadata should be pointed at, or <c>null</c> to generate a fake path.</param>
+        private Mock<IModMetadata> GetMetadata(IManifest manifest, bool allowStatusChange = false, string? directoryPath = null)
         {
+            directoryPath ??= this.GetTempFolderPath();
+
             Mock<IModMetadata> mod = new(MockBehavior.Strict);
             mod.Setup(p => p.DataRecord).Returns(this.GetModDataRecordVersionedFields());
             mod.Setup(p => p.Status).Returns(ModMetadataStatus.Found);
             mod.Setup(p => p.DisplayName).Returns(manifest.UniqueID);
+            mod.Setup(p => p.DirectoryPath).Returns(directoryPath);
             mod.Setup(p => p.Manifest).Returns(manifest);
             mod.Setup(p => p.HasID(It.IsAny<string>())).Returns((string id) => manifest.UniqueID == id);
+            mod.Setup(p => p.GetUpdateKeys(It.IsAny<bool>())).Returns(Enumerable.Empty<UpdateKey>());
+            mod.Setup(p => p.GetRelativePathWithRoot()).Returns(directoryPath);
             if (allowStatusChange)
             {
                 mod
@@ -532,18 +550,6 @@ namespace SMAPI.Tests.Core
             return mod;
         }
 
-        /// <summary>Set up a mock mod metadata for <see cref="ModResolver.ValidateManifests"/>.</summary>
-        /// <param name="mod">The mock mod metadata.</param>
-        /// <param name="modRecord">The extra metadata about the mod from SMAPI's internal data (if any).</param>
-        private void SetupMetadataForValidation(Mock<IModMetadata> mod, ModDataRecordVersionedFields? modRecord = null)
-        {
-            mod.Setup(p => p.Status).Returns(ModMetadataStatus.Found);
-            mod.Setup(p => p.Manifest).Returns(this.GetManifest());
-            mod.Setup(p => p.DirectoryPath).Returns(Path.GetTempPath());
-            mod.Setup(p => p.DataRecord).Returns(modRecord ?? this.GetModDataRecordVersionedFields());
-            mod.Setup(p => p.GetUpdateKeys(It.IsAny<bool>())).Returns(Enumerable.Empty<UpdateKey>());
-        }
-
         /// <summary>Generate a default mod data record.</summary>
         private ModDataRecord GetModDataRecord()
         {
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
index 8646f1cc..a2497dea 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/ChangeDescriptor.cs
@@ -55,7 +55,12 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         {
             // get list
             List<string> values = !string.IsNullOrWhiteSpace(rawField)
-                ? new List<string>(rawField.Split(','))
+                ? new List<string>(
+                    from field in rawField.Split(',')
+                    let value = field.Trim()
+                    where value.Length > 0
+                    select value
+                )
                 : new List<string>();
 
             // apply changes
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 4c691b9a..148354a1 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -119,25 +119,27 @@ namespace StardewModdingAPI.Framework.Content
             if (prefix is null)
                 return false;
 
+            string rawTrimmed = prefix.Trim();
+
             // asset keys can't have a leading slash, but NormalizeAssetName will trim them
-            {
-                string trimmed = prefix.TrimStart();
-                if (trimmed.StartsWith('/') || trimmed.StartsWith('\\'))
-                    return false;
-            }
+            if (rawTrimmed.StartsWith('/') || rawTrimmed.StartsWith('\\'))
+                return false;
 
             // normalize prefix
             {
                 string normalized = PathUtilities.NormalizeAssetName(prefix);
 
-                string trimmed = prefix.TrimEnd();
-                if (trimmed.EndsWith('/') || trimmed.EndsWith('\\'))
+                // keep trailing slash
+                if (rawTrimmed.EndsWith('/') || rawTrimmed.EndsWith('\\'))
                     normalized += PathUtilities.PreferredAssetSeparator;
 
                 prefix = normalized;
             }
 
             // compare
+            if (prefix.Length == 0)
+                return true;
+
             return
                 this.Name.StartsWith(prefix, StringComparison.OrdinalIgnoreCase)
                 && (
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 4a02e90d..74e7cb32 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -56,9 +56,10 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="mods">The mod manifests to validate.</param>
         /// <param name="apiVersion">The current SMAPI version.</param>
         /// <param name="getUpdateUrl">Get an update URL for an update key (if valid).</param>
+        /// <param name="validateFilesExist">Whether to validate that files referenced in the manifest (like <see cref="IManifest.EntryDll"/>) exist on disk. This can be disabled to only validate the manifest itself.</param>
         [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "Manifest values may be null before they're validated.")]
         [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "Manifest values may be null before they're validated.")]
-        public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string?> getUpdateUrl)
+        public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string?> getUpdateUrl, bool validateFilesExist = true)
         {
             mods = mods.ToArray();
 
@@ -141,11 +142,14 @@ namespace StardewModdingAPI.Framework.ModLoading
                         }
 
                         // file doesn't exist
-                        string fileName = CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath).GetFilePath(mod.Manifest.EntryDll!);
-                        if (!File.Exists(Path.Combine(mod.DirectoryPath, fileName)))
+                        if (validateFilesExist)
                         {
-                            mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
-                            continue;
+                            string fileName = CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath).GetFilePath(mod.Manifest.EntryDll!);
+                            if (!File.Exists(Path.Combine(mod.DirectoryPath, fileName)))
+                            {
+                                mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
+                                continue;
+                            }
                         }
                     }
 
diff --git a/src/SMAPI/Framework/Translator.cs b/src/SMAPI/Framework/Translator.cs
index b230a727..3beee250 100644
--- a/src/SMAPI/Framework/Translator.cs
+++ b/src/SMAPI/Framework/Translator.cs
@@ -51,7 +51,8 @@ namespace StardewModdingAPI.Framework
             foreach (string key in this.GetAllKeysRaw())
             {
                 string? text = this.GetRaw(key, locale, withFallback: true);
-                this.ForLocale.Add(key, new Translation(this.Locale, key, text));
+                if (text != null)
+                    this.ForLocale.Add(key, new Translation(this.Locale, key, text));
             }
         }
 

From 0a69cb4bf71e6e822e595141ce5f24009e509246 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 19:15:50 -0400
Subject: [PATCH 574/856] allow switching between Pintail & original API
 proxying

---
 src/SMAPI.Tests/Core/InterfaceProxyTests.cs   |  68 ++++++----
 src/SMAPI.sln.DotSettings                     |   2 +
 .../Framework/ModHelpers/ModRegistryHelper.cs |   4 +-
 src/SMAPI/Framework/Models/SConfig.cs         |  10 +-
 .../Reflection/IInterfaceProxyFactory.cs      |  17 +++
 .../Reflection/InterfaceProxyFactory.cs       |  10 +-
 .../OriginalInterfaceProxyBuilder.cs          | 118 ++++++++++++++++++
 .../OriginalInterfaceProxyFactory.cs          |  57 +++++++++
 src/SMAPI/Framework/SCore.cs                  |   6 +-
 src/SMAPI/SMAPI.config.json                   |   6 +
 10 files changed, 259 insertions(+), 39 deletions(-)
 create mode 100644 src/SMAPI/Framework/Reflection/IInterfaceProxyFactory.cs
 create mode 100644 src/SMAPI/Framework/Reflection/OriginalInterfaceProxyBuilder.cs
 create mode 100644 src/SMAPI/Framework/Reflection/OriginalInterfaceProxyFactory.cs

diff --git a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
index 8d27f6af..6be97526 100644
--- a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
+++ b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
@@ -29,6 +29,12 @@ namespace SMAPI.Tests.Core
         /// <summary>The random number generator with which to create sample values.</summary>
         private readonly Random Random = new();
 
+        /// <summary>Sample user inputs for season names.</summary>
+        private static readonly IInterfaceProxyFactory[] ProxyFactories = {
+            new InterfaceProxyFactory(),
+            new OriginalInterfaceProxyFactory()
+        };
+
 
         /*********
         ** Unit tests
@@ -37,8 +43,9 @@ namespace SMAPI.Tests.Core
         ** Events
         ****/
         /// <summary>Assert that an event field can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
-        public void CanProxy_EventField()
+        public void CanProxy_EventField([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             ProviderMod providerMod = new();
@@ -46,7 +53,7 @@ namespace SMAPI.Tests.Core
             int expectedValue = this.Random.Next();
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             new ApiConsumer().UseEventField(proxy, out Func<(int timesCalled, int lastValue)> getValues);
             providerMod.RaiseEvent(expectedValue);
             (int timesCalled, int lastValue) = getValues();
@@ -57,8 +64,9 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Assert that an event property can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
-        public void CanProxy_EventProperty()
+        public void CanProxy_EventProperty([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             ProviderMod providerMod = new();
@@ -66,7 +74,7 @@ namespace SMAPI.Tests.Core
             int expectedValue = this.Random.Next();
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             new ApiConsumer().UseEventProperty(proxy, out Func<(int timesCalled, int lastValue)> getValues);
             providerMod.RaiseEvent(expectedValue);
             (int timesCalled, int lastValue) = getValues();
@@ -80,10 +88,10 @@ namespace SMAPI.Tests.Core
         ** Properties
         ****/
         /// <summary>Assert that properties can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         /// <param name="setVia">Whether to set the properties through the <c>provider mod</c> or <c>proxy interface</c>.</param>
-        [TestCase("set via provider mod")]
-        [TestCase("set via proxy interface")]
-        public void CanProxy_Properties(string setVia)
+        [Test]
+        public void CanProxy_Properties([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory, [Values("set via provider mod", "set via proxy interface")] string setVia)
         {
             // arrange
             ProviderMod providerMod = new();
@@ -98,7 +106,7 @@ namespace SMAPI.Tests.Core
             BindingFlags expectedEnum = BindingFlags.Instance | BindingFlags.Public;
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             switch (setVia)
             {
                 case "set via provider mod":
@@ -198,27 +206,29 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Assert that a simple method with no return value can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
-        public void CanProxy_SimpleMethod_Void()
+        public void CanProxy_SimpleMethod_Void([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             object implementation = new ProviderMod().GetModApi();
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             proxy.GetNothing();
         }
 
         /// <summary>Assert that a simple int method can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
-        public void CanProxy_SimpleMethod_Int()
+        public void CanProxy_SimpleMethod_Int([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             object implementation = new ProviderMod().GetModApi();
             int expectedValue = this.Random.Next();
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             int actualValue = proxy.GetInt(expectedValue);
 
             // assert
@@ -226,15 +236,16 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Assert that a simple object method can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
-        public void CanProxy_SimpleMethod_Object()
+        public void CanProxy_SimpleMethod_Object([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             object implementation = new ProviderMod().GetModApi();
             object expectedValue = new();
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             object actualValue = proxy.GetObject(expectedValue);
 
             // assert
@@ -242,15 +253,16 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Assert that a simple list method can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
-        public void CanProxy_SimpleMethod_List()
+        public void CanProxy_SimpleMethod_List([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             object implementation = new ProviderMod().GetModApi();
             string expectedValue = this.GetRandomString();
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             IList<string> actualValue = proxy.GetList(expectedValue);
 
             // assert
@@ -258,15 +270,16 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Assert that a simple list with interface method can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
-        public void CanProxy_SimpleMethod_ListWithInterface()
+        public void CanProxy_SimpleMethod_ListWithInterface([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             object implementation = new ProviderMod().GetModApi();
             string expectedValue = this.GetRandomString();
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             IList<string> actualValue = proxy.GetListWithInterface(expectedValue);
 
             // assert
@@ -274,8 +287,9 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Assert that a simple method which returns generic types can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
-        public void CanProxy_SimpleMethod_GenericTypes()
+        public void CanProxy_SimpleMethod_GenericTypes([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             object implementation = new ProviderMod().GetModApi();
@@ -283,7 +297,7 @@ namespace SMAPI.Tests.Core
             string expectedValue = this.GetRandomString();
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             IDictionary<string, IList<string>> actualValue = proxy.GetGenerics(expectedKey, expectedValue);
 
             // assert
@@ -294,16 +308,17 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Assert that a simple lambda method can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
         [SuppressMessage("ReSharper", "ConvertToLocalFunction")]
-        public void CanProxy_SimpleMethod_Lambda()
+        public void CanProxy_SimpleMethod_Lambda([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             object implementation = new ProviderMod().GetModApi();
             Func<string, string> expectedValue = _ => "test";
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             object actualValue = proxy.GetObject(expectedValue);
 
             // assert
@@ -311,16 +326,17 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Assert that a method with out parameters can be proxied correctly.</summary>
+        /// <param name="proxyFactory">The proxy factory to test.</param>
         [Test]
         [SuppressMessage("ReSharper", "ConvertToLocalFunction")]
-        public void CanProxy_Method_OutParameters()
+        public void CanProxy_Method_OutParameters([ValueSource(nameof(InterfaceProxyTests.ProxyFactories))] IInterfaceProxyFactory proxyFactory)
         {
             // arrange
             object implementation = new ProviderMod().GetModApi();
             const int expectedNumber = 42;
 
             // act
-            ISimpleApi proxy = this.GetProxy(implementation);
+            ISimpleApi proxy = this.GetProxy(proxyFactory, implementation);
             bool result = proxy.TryGetOutParameter(
                 inputNumber: expectedNumber,
 
@@ -374,10 +390,10 @@ namespace SMAPI.Tests.Core
         }
 
         /// <summary>Get a proxy API instance.</summary>
+        /// <param name="proxyFactory">The proxy factory to use.</param>
         /// <param name="implementation">The underlying API instance.</param>
-        private ISimpleApi GetProxy(object implementation)
+        private ISimpleApi GetProxy(IInterfaceProxyFactory proxyFactory, object implementation)
         {
-            var proxyFactory = new InterfaceProxyFactory();
             return proxyFactory.CreateProxy<ISimpleApi>(implementation, this.FromModId, this.ToModId);
         }
     }
diff --git a/src/SMAPI.sln.DotSettings b/src/SMAPI.sln.DotSettings
index ad546665..c8dcdb55 100644
--- a/src/SMAPI.sln.DotSettings
+++ b/src/SMAPI.sln.DotSettings
@@ -61,11 +61,13 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pastebin/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=pathfinding/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pathoschild/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pintail/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=premultiplied/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=premultiply/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Prenormalize/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Preprocesses/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=prerelease/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=proxying/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=pufferchick/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rasterizer/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=reimplements/@EntryIndexedValue">True</s:Boolean>
diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 39cef758..348ba225 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -19,7 +19,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         private readonly HashSet<string> AccessedModApis = new();
 
         /// <summary>Generates proxy classes to access mod APIs through an arbitrary interface.</summary>
-        private readonly InterfaceProxyFactory ProxyFactory;
+        private readonly IInterfaceProxyFactory ProxyFactory;
 
 
         /*********
@@ -30,7 +30,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="registry">The underlying mod registry.</param>
         /// <param name="proxyFactory">Generates proxy classes to access mod APIs through an arbitrary interface.</param>
         /// <param name="monitor">Encapsulates monitoring and logging for the mod.</param>
-        public ModRegistryHelper(IModMetadata mod, ModRegistry registry, InterfaceProxyFactory proxyFactory, IMonitor monitor)
+        public ModRegistryHelper(IModMetadata mod, ModRegistry registry, IInterfaceProxyFactory proxyFactory, IMonitor monitor)
             : base(mod)
         {
             this.Registry = registry;
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index d626ab4d..1a43c1fc 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -22,7 +22,8 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(VerboseLogging)] = false,
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
-            [nameof(AggressiveMemoryOptimizations)] = false
+            [nameof(AggressiveMemoryOptimizations)] = false,
+            [nameof(UsePintail)] = true
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
@@ -64,6 +65,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether to enable more aggressive memory optimizations.</summary>
         public bool AggressiveMemoryOptimizations { get; }
 
+        /// <summary>Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</summary>
+        public bool UsePintail { get; }
+
         /// <summary>Whether SMAPI should log network traffic. Best combined with <see cref="VerboseLogging"/>, which includes network metadata.</summary>
         public bool LogNetworkTraffic { get; }
 
@@ -87,10 +91,11 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="verboseLogging">Whether SMAPI should log more information about the game context.</param>
         /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        /// <param name="usePintail">Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool verboseLogging, bool? rewriteMods, bool? aggressiveMemoryOptimizations, bool logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool verboseLogging, bool? rewriteMods, bool? aggressiveMemoryOptimizations, bool usePintail, bool logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates;
@@ -101,6 +106,7 @@ namespace StardewModdingAPI.Framework.Models
             this.VerboseLogging = verboseLogging;
             this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations ?? (bool)SConfig.DefaultValues[nameof(SConfig.AggressiveMemoryOptimizations)];
+            this.UsePintail = usePintail;
             this.LogNetworkTraffic = logNetworkTraffic;
             this.ConsoleColors = consoleColors;
             this.SuppressUpdateChecks = suppressUpdateChecks ?? Array.Empty<string>();
diff --git a/src/SMAPI/Framework/Reflection/IInterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/IInterfaceProxyFactory.cs
new file mode 100644
index 00000000..6429db58
--- /dev/null
+++ b/src/SMAPI/Framework/Reflection/IInterfaceProxyFactory.cs
@@ -0,0 +1,17 @@
+namespace StardewModdingAPI.Framework.Reflection
+{
+    /// <summary>Generates proxy classes to access mod APIs through an arbitrary interface.</summary>
+    internal interface IInterfaceProxyFactory
+    {
+        /*********
+        ** Methods
+        *********/
+        /// <summary>Create an API proxy.</summary>
+        /// <typeparam name="TInterface">The interface through which to access the API.</typeparam>
+        /// <param name="instance">The API instance to access.</param>
+        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
+        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
+        TInterface CreateProxy<TInterface>(object instance, string sourceModID, string targetModID)
+            where TInterface : class;
+    }
+}
diff --git a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
index 40adde8e..694c563d 100644
--- a/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
+++ b/src/SMAPI/Framework/Reflection/InterfaceProxyFactory.cs
@@ -4,8 +4,8 @@ using Nanoray.Pintail;
 
 namespace StardewModdingAPI.Framework.Reflection
 {
-    /// <summary>Generates proxy classes to access mod APIs through an arbitrary interface.</summary>
-    internal class InterfaceProxyFactory
+    /// <inheritdoc />
+    internal class InterfaceProxyFactory : IInterfaceProxyFactory
     {
         /*********
         ** Fields
@@ -28,11 +28,7 @@ namespace StardewModdingAPI.Framework.Reflection
             ));
         }
 
-        /// <summary>Create an API proxy.</summary>
-        /// <typeparam name="TInterface">The interface through which to access the API.</typeparam>
-        /// <param name="instance">The API instance to access.</param>
-        /// <param name="sourceModID">The unique ID of the mod consuming the API.</param>
-        /// <param name="targetModID">The unique ID of the mod providing the API.</param>
+        /// <inheritdoc />
         public TInterface CreateProxy<TInterface>(object instance, string sourceModID, string targetModID)
             where TInterface : class
         {
diff --git a/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyBuilder.cs
new file mode 100644
index 00000000..9576f768
--- /dev/null
+++ b/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyBuilder.cs
@@ -0,0 +1,118 @@
+using System;
+using System.Linq;
+using System.Reflection;
+using System.Reflection.Emit;
+
+namespace StardewModdingAPI.Framework.Reflection
+{
+    /// <summary>Generates a proxy class to access a mod API through an arbitrary interface.</summary>
+    internal class OriginalInterfaceProxyBuilder
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The target class type.</summary>
+        private readonly Type TargetType;
+
+        /// <summary>The generated proxy type.</summary>
+        private readonly Type ProxyType;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="name">The type name to generate.</param>
+        /// <param name="moduleBuilder">The CLR module in which to create proxy classes.</param>
+        /// <param name="interfaceType">The interface type to implement.</param>
+        /// <param name="targetType">The target type.</param>
+        public OriginalInterfaceProxyBuilder(string name, ModuleBuilder moduleBuilder, Type interfaceType, Type targetType)
+        {
+            // validate
+            if (name == null)
+                throw new ArgumentNullException(nameof(name));
+            if (targetType == null)
+                throw new ArgumentNullException(nameof(targetType));
+
+            // define proxy type
+            TypeBuilder proxyBuilder = moduleBuilder.DefineType(name, TypeAttributes.Public | TypeAttributes.Class);
+            proxyBuilder.AddInterfaceImplementation(interfaceType);
+
+            // create field to store target instance
+            FieldBuilder targetField = proxyBuilder.DefineField("__Target", targetType, FieldAttributes.Private);
+
+            // create constructor which accepts target instance and sets field
+            {
+                ConstructorBuilder constructor = proxyBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard | CallingConventions.HasThis, new[] { targetType });
+                ILGenerator il = constructor.GetILGenerator();
+
+                il.Emit(OpCodes.Ldarg_0); // this
+                // ReSharper disable once AssignNullToNotNullAttribute -- never null
+                il.Emit(OpCodes.Call, typeof(object).GetConstructor(Type.EmptyTypes)!); // call base constructor
+                il.Emit(OpCodes.Ldarg_0);      // this
+                il.Emit(OpCodes.Ldarg_1);      // load argument
+                il.Emit(OpCodes.Stfld, targetField); // set field to loaded argument
+                il.Emit(OpCodes.Ret);
+            }
+
+            // proxy methods
+            foreach (MethodInfo proxyMethod in interfaceType.GetMethods())
+            {
+                var targetMethod = targetType.GetMethod(proxyMethod.Name, proxyMethod.GetParameters().Select(a => a.ParameterType).ToArray());
+                if (targetMethod == null)
+                    throw new InvalidOperationException($"The {interfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
+
+                this.ProxyMethod(proxyBuilder, targetMethod, targetField);
+            }
+
+            // save info
+            this.TargetType = targetType;
+            this.ProxyType = proxyBuilder.CreateType()!;
+        }
+
+        /// <summary>Create an instance of the proxy for a target instance.</summary>
+        /// <param name="targetInstance">The target instance.</param>
+        public object CreateInstance(object targetInstance)
+        {
+            ConstructorInfo? constructor = this.ProxyType.GetConstructor(new[] { this.TargetType });
+            if (constructor == null)
+                throw new InvalidOperationException($"Couldn't find the constructor for generated proxy type '{this.ProxyType.Name}'."); // should never happen
+            return constructor.Invoke(new[] { targetInstance });
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Define a method which proxies access to a method on the target.</summary>
+        /// <param name="proxyBuilder">The proxy type being generated.</param>
+        /// <param name="target">The target method.</param>
+        /// <param name="instanceField">The proxy field containing the API instance.</param>
+        private void ProxyMethod(TypeBuilder proxyBuilder, MethodInfo target, FieldBuilder instanceField)
+        {
+            Type[] argTypes = target.GetParameters().Select(a => a.ParameterType).ToArray();
+
+            // create method
+            MethodBuilder methodBuilder = proxyBuilder.DefineMethod(target.Name, MethodAttributes.Public | MethodAttributes.Final | MethodAttributes.Virtual);
+            methodBuilder.SetParameters(argTypes);
+            methodBuilder.SetReturnType(target.ReturnType);
+
+            // create method body
+            {
+                ILGenerator il = methodBuilder.GetILGenerator();
+
+                // load target instance
+                il.Emit(OpCodes.Ldarg_0);
+                il.Emit(OpCodes.Ldfld, instanceField);
+
+                // invoke target method on instance
+                for (int i = 0; i < argTypes.Length; i++)
+                    il.Emit(OpCodes.Ldarg, i + 1);
+                il.Emit(OpCodes.Call, target);
+
+                // return result
+                il.Emit(OpCodes.Ret);
+            }
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyFactory.cs
new file mode 100644
index 00000000..d6966978
--- /dev/null
+++ b/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyFactory.cs
@@ -0,0 +1,57 @@
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+using System.Reflection.Emit;
+
+namespace StardewModdingAPI.Framework.Reflection
+{
+    /// <inheritdoc />
+    internal class OriginalInterfaceProxyFactory : IInterfaceProxyFactory
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The CLR module in which to create proxy classes.</summary>
+        private readonly ModuleBuilder ModuleBuilder;
+
+        /// <summary>The generated proxy types.</summary>
+        private readonly IDictionary<string, OriginalInterfaceProxyBuilder> Builders = new Dictionary<string, OriginalInterfaceProxyBuilder>();
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public OriginalInterfaceProxyFactory()
+        {
+            AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
+            this.ModuleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
+        }
+
+        /// <inheritdoc />
+        public TInterface CreateProxy<TInterface>(object instance, string sourceModID, string targetModID)
+            where TInterface : class
+        {
+            lock (this.Builders)
+            {
+                // validate
+                if (instance == null)
+                    throw new InvalidOperationException("Can't proxy access to a null API.");
+                if (!typeof(TInterface).IsInterface)
+                    throw new InvalidOperationException("The proxy type must be an interface, not a class.");
+
+                // get proxy type
+                Type targetType = instance.GetType();
+                string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{typeof(TInterface).FullName}>_To<{targetModID}_{targetType.FullName}>";
+                if (!this.Builders.TryGetValue(proxyTypeName, out OriginalInterfaceProxyBuilder? builder))
+                {
+                    builder = new OriginalInterfaceProxyBuilder(proxyTypeName, this.ModuleBuilder, typeof(TInterface), targetType);
+                    this.Builders[proxyTypeName] = builder;
+                }
+
+                // create instance
+                return (TInterface)builder.CreateInstance(instance);
+            }
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index b3c9087f..44853627 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1560,7 +1560,9 @@ namespace StardewModdingAPI.Framework
             {
                 // init
                 HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
-                InterfaceProxyFactory proxyFactory = new();
+                IInterfaceProxyFactory proxyFactory = this.Settings.UsePintail
+                    ? new InterfaceProxyFactory()
+                    : new OriginalInterfaceProxyFactory();
 
                 // load mods
                 foreach (IModMetadata mod in mods)
@@ -1699,7 +1701,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="errorReasonPhrase">The user-facing reason phrase explaining why the mod couldn't be loaded (if applicable).</param>
         /// <param name="errorDetails">More detailed details about the error intended for developers (if any).</param>
         /// <returns>Returns whether the mod was successfully loaded.</returns>
-        private bool TryLoadMod(IModMetadata mod, IModMetadata[] mods, AssemblyLoader assemblyLoader, InterfaceProxyFactory proxyFactory, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase, HashSet<string> suppressUpdateChecks, [NotNullWhen(false)] out ModFailReason? failReason, out string? errorReasonPhrase, out string? errorDetails)
+        private bool TryLoadMod(IModMetadata mod, IModMetadata[] mods, AssemblyLoader assemblyLoader, IInterfaceProxyFactory proxyFactory, JsonHelper jsonHelper, ContentCoordinator contentCore, ModDatabase modDatabase, HashSet<string> suppressUpdateChecks, [NotNullWhen(false)] out ModFailReason? failReason, out string? errorReasonPhrase, out string? errorDetails)
         {
             errorDetails = null;
 
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 49056e83..065dfa8c 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -46,6 +46,12 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "AggressiveMemoryOptimizations": false,
 
+    /**
+     * Whether to use the experimental Pintail API proxying library, instead of the original
+     * proxying built into SMAPI itself.
+     */
+    "UsePintail": true,
+
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially
      * sensitive .NET APIs like file or shell access. Note that many mods do this legitimately as

From d486d940bae57f627fbe3210bbfa611a5586c8e8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 19:17:16 -0400
Subject: [PATCH 575/856] temporarily disable Pintail by default pending out
 parameter fix

---
 docs/release-notes.md                 | 4 ++--
 src/SMAPI/Framework/Models/SConfig.cs | 2 +-
 src/SMAPI/SMAPI.config.json           | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 75c1941e..0c14360b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -44,8 +44,8 @@ the C# mod that loads them is updated.
     _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
   * Added [nullable reference type annotations](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Nullable_reference_type_annotations) for all APIs.
   * Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.
-  * Overhauled [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
-    _This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
+  * Added optional overhaul of [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
+    _This is experimental (you can enable it via `UsePintail` in `smapi-internal/config.json`). This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
   * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
   * Enabled deprecation notices for all deprecated APIs. These will only be shown in `TRACE` logs for at least a month after SMAPI 3.14.0 releases.
 * Other improvements:
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 1a43c1fc..af2e1035 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -23,7 +23,7 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
             [nameof(AggressiveMemoryOptimizations)] = false,
-            [nameof(UsePintail)] = true
+            [nameof(UsePintail)] = false
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 065dfa8c..a317e6b8 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -50,7 +50,7 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      * Whether to use the experimental Pintail API proxying library, instead of the original
      * proxying built into SMAPI itself.
      */
-    "UsePintail": true,
+    "UsePintail": false,
 
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially

From 7b79703de69f044a03884be83d6df3790d8f8ee9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 16 Apr 2022 21:07:34 -0400
Subject: [PATCH 576/856] tweak code style

---
 .../wwwroot/Content/js/log-parser.js          | 27 ++++++++-----------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index e19e3301..8886715e 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -860,34 +860,29 @@ smapi.logParser = function (state) {
             // much easier.
             updateFilterText: helpers.getDebouncedHandler(
                 function () {
+                    // reset
+                    this.filterError = null;
+                    this.filterRegex = null;
+
+                    // apply search
                     let text = state.filterText;
-                    if (!text || !text.length) {
+                    if (!text)
                         this.filterText = "";
-                        this.filterRegex = null;
-                        this.filterError = null;
-                    }
                     else {
                         if (!state.useRegex)
                             text = helpers.escapeRegex(text);
 
                         const flags = state.useInsensitive ? "ig" : "g";
 
-                        this.filterError = null;
-                        let regex;
-
                         try {
-                            regex = new RegExp(text, flags);
-                        } catch (err) {
-                            regex = null;
+                            this.filterRegex = new RegExp(text, flags);
+                        }
+                        catch (err) {
                             this.filterError = err.message;
                         }
 
-                        if (regex)
-                            this.filterRegex = state.useWord ?
-                                new RegExp(`\\b(?:${text})\\b`, flags) :
-                                regex;
-                        else
-                            this.filterRegex = null;
+                        if (this.filterRegex && state.useWord)
+                            this.filterRegex = new RegExp(`\\b(?:${text})\\b`, flags);
                     }
 
                     this.updateUrl();

From b25e30a896cd7ed65d02db7d8639cd28a11981f0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Apr 2022 01:07:18 -0400
Subject: [PATCH 577/856] fix model binding error

---
 .../Controllers/JsonValidatorController.cs      |  4 ++--
 .../JsonValidator/JsonValidatorRequestModel.cs  | 17 ++---------------
 2 files changed, 4 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI.Web/Controllers/JsonValidatorController.cs b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
index e78aeeb6..c551a805 100644
--- a/src/SMAPI.Web/Controllers/JsonValidatorController.cs
+++ b/src/SMAPI.Web/Controllers/JsonValidatorController.cs
@@ -122,7 +122,7 @@ namespace StardewModdingAPI.Web.Controllers
                 FileInfo? schemaFile = this.FindSchemaFile(schemaName);
                 if (schemaFile == null)
                     return this.View("Index", result.SetParseError($"Invalid schema '{schemaName}'."));
-                schema = JSchema.Parse(System.IO.File.ReadAllText(schemaFile.FullName));
+                schema = JSchema.Parse(await System.IO.File.ReadAllTextAsync(schemaFile.FullName));
             }
 
             // get format doc URL
@@ -151,7 +151,7 @@ namespace StardewModdingAPI.Web.Controllers
             string schemaName = this.NormalizeSchemaName(request.SchemaName);
 
             // get raw text
-            string input = request.Content;
+            string? input = request.Content;
             if (string.IsNullOrWhiteSpace(input))
                 return this.View("Index", this.GetModel(null, schemaName, isEditView: true).SetUploadError("The JSON file seems to be empty."));
 
diff --git a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
index 3edb58db..1313264f 100644
--- a/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
+++ b/src/SMAPI.Web/ViewModels/JsonValidator/JsonValidatorRequestModel.cs
@@ -7,22 +7,9 @@ namespace StardewModdingAPI.Web.ViewModels.JsonValidator
         ** Accessors
         *********/
         /// <summary>The schema name with which to validate the JSON.</summary>
-        public string SchemaName { get; }
+        public string? SchemaName { get; set; }
 
         /// <summary>The raw content to validate.</summary>
-        public string Content { get; }
-
-
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="schemaName">The schema name with which to validate the JSON.</param>
-        /// <param name="content">The raw content to validate.</param>
-        public JsonValidatorRequestModel(string schemaName, string content)
-        {
-            this.SchemaName = schemaName;
-            this.Content = content;
-        }
+        public string? Content { get; set; }
     }
 }

From a8a4d314dff1f80970090e9d364f36e787df73d6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Apr 2022 22:12:17 -0400
Subject: [PATCH 578/856] simplify ExtendMap usage

---
 src/SMAPI/Framework/Content/AssetDataForMap.cs | 3 ++-
 src/SMAPI/IAssetDataForMap.cs                  | 3 +--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 133dcc6c..8674461e 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -151,9 +151,10 @@ namespace StardewModdingAPI.Framework.Content
         }
 
         /// <inheritdoc />
-        public bool ExtendMap(Map map, int minWidth, int minHeight)
+        public bool ExtendMap(int minWidth = 0, int minHeight = 0)
         {
             bool resized = false;
+            Map map = this.Data;
 
             // resize layers
             foreach (Layer layer in map.Layers)
diff --git a/src/SMAPI/IAssetDataForMap.cs b/src/SMAPI/IAssetDataForMap.cs
index 19bdf3b2..dcc7135d 100644
--- a/src/SMAPI/IAssetDataForMap.cs
+++ b/src/SMAPI/IAssetDataForMap.cs
@@ -17,10 +17,9 @@ namespace StardewModdingAPI
         void PatchMap(Map source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMapMode patchMode = PatchMapMode.Overlay);
 
         /// <summary>Extend the map if needed to fit the given size. Note that this is an expensive operation and resizes the map in-place.</summary>
-        /// <param name="map">The map to resize.</param>
         /// <param name="minWidth">The minimum map width in tiles.</param>
         /// <param name="minHeight">The minimum map height in tiles.</param>
         /// <returns>Whether the map was resized.</returns>
-        bool ExtendMap(Map map, int minWidth, int minHeight);
+        bool ExtendMap(int minWidth = 0, int minHeight = 0);
     }
 }

From 889004f1eba31aa3a5069e1dcbe79896d05720b0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Apr 2022 19:03:47 -0400
Subject: [PATCH 579/856] move deprecation code into namespace

---
 src/SMAPI/Constants.cs                                       | 1 +
 src/SMAPI/Framework/Content/AssetInfo.cs                     | 1 +
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs    | 1 +
 src/SMAPI/Framework/{ => Deprecations}/DeprecationLevel.cs   | 2 +-
 src/SMAPI/Framework/{ => Deprecations}/DeprecationManager.cs | 2 +-
 src/SMAPI/Framework/{ => Deprecations}/DeprecationWarning.cs | 2 +-
 src/SMAPI/Framework/ModHelpers/CommandHelper.cs              | 1 +
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs              | 1 +
 src/SMAPI/Framework/ModHelpers/ModHelper.cs                  | 1 +
 src/SMAPI/Framework/SCore.cs                                 | 1 +
 src/SMAPI/Utilities/PerScreen.cs                             | 1 +
 11 files changed, 11 insertions(+), 3 deletions(-)
 rename src/SMAPI/Framework/{ => Deprecations}/DeprecationLevel.cs (92%)
 rename src/SMAPI/Framework/{ => Deprecations}/DeprecationManager.cs (99%)
 rename src/SMAPI/Framework/{ => Deprecations}/DeprecationWarning.cs (97%)

diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index d40b97f4..ddb08435 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -6,6 +6,7 @@ using System.Reflection;
 using Mono.Cecil;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Framework;
+using StardewModdingAPI.Framework.Deprecations;
 using StardewModdingAPI.Framework.ModLoading;
 using StardewModdingAPI.Toolkit.Framework;
 using StardewModdingAPI.Toolkit.Utilities;
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 16b71487..c632249d 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework.Deprecations;
 
 namespace StardewModdingAPI.Framework.Content
 {
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 6469fea4..083df454 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -8,6 +8,7 @@ using System.Reflection;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Content;
+using StardewModdingAPI.Framework.Deprecations;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
diff --git a/src/SMAPI/Framework/DeprecationLevel.cs b/src/SMAPI/Framework/Deprecations/DeprecationLevel.cs
similarity index 92%
rename from src/SMAPI/Framework/DeprecationLevel.cs
rename to src/SMAPI/Framework/Deprecations/DeprecationLevel.cs
index 12b50952..8b15b59a 100644
--- a/src/SMAPI/Framework/DeprecationLevel.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationLevel.cs
@@ -1,4 +1,4 @@
-namespace StardewModdingAPI.Framework
+namespace StardewModdingAPI.Framework.Deprecations
 {
     /// <summary>Indicates how deprecated something is.</summary>
     internal enum DeprecationLevel
diff --git a/src/SMAPI/Framework/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
similarity index 99%
rename from src/SMAPI/Framework/DeprecationManager.cs
rename to src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index 37a5c8ef..da17ce7e 100644
--- a/src/SMAPI/Framework/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -4,7 +4,7 @@ using System.Diagnostics;
 using System.Linq;
 using System.Text;
 
-namespace StardewModdingAPI.Framework
+namespace StardewModdingAPI.Framework.Deprecations
 {
     /// <summary>Manages deprecation warnings.</summary>
     internal class DeprecationManager
diff --git a/src/SMAPI/Framework/DeprecationWarning.cs b/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
similarity index 97%
rename from src/SMAPI/Framework/DeprecationWarning.cs
rename to src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
index 1e83f679..38062daf 100644
--- a/src/SMAPI/Framework/DeprecationWarning.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
@@ -1,6 +1,6 @@
 using System.Diagnostics;
 
-namespace StardewModdingAPI.Framework
+namespace StardewModdingAPI.Framework.Deprecations
 {
     /// <summary>A deprecation warning for a mod.</summary>
     internal class DeprecationWarning
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index e430fb1c..226a8d69 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -1,4 +1,5 @@
 using System;
+using StardewModdingAPI.Framework.Deprecations;
 
 namespace StardewModdingAPI.Framework.ModHelpers
 {
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 534ac138..94a30bf1 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -7,6 +7,7 @@ using System.IO;
 using System.Linq;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
+using StardewModdingAPI.Framework.Deprecations;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewValley;
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 5b450c36..a23a9beb 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -1,6 +1,7 @@
 using System;
 using System.IO;
 using StardewModdingAPI.Events;
+using StardewModdingAPI.Framework.Deprecations;
 using StardewModdingAPI.Framework.Input;
 
 namespace StardewModdingAPI.Framework.ModHelpers
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 44853627..c208788a 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -20,6 +20,7 @@ using StardewModdingAPI.Enums;
 using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
+using StardewModdingAPI.Framework.Deprecations;
 using StardewModdingAPI.Framework.Events;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Input;
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 6c2e436b..1c4c56fe 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -2,6 +2,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using StardewModdingAPI.Framework;
+using StardewModdingAPI.Framework.Deprecations;
 
 namespace StardewModdingAPI.Utilities
 {

From e6c696fa6b0bfe5ef013e1179765ce1dcb071c38 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Apr 2022 19:11:58 -0400
Subject: [PATCH 580/856] add immutable stack trace to cache stack info

---
 .../Deprecations/DeprecationManager.cs        |  4 +-
 .../Deprecations/DeprecationWarning.cs        |  4 +-
 .../Deprecations/ImmutableStackTrace.cs       | 53 +++++++++++++++++++
 3 files changed, 57 insertions(+), 4 deletions(-)
 create mode 100644 src/SMAPI/Framework/Deprecations/ImmutableStackTrace.cs

diff --git a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index da17ce7e..84ce2132 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -63,7 +63,7 @@ namespace StardewModdingAPI.Framework.Deprecations
                 return;
 
             // queue warning
-            var stack = new StackTrace(skipFrames: 1); // skip this method
+            ImmutableStackTrace stack = ImmutableStackTrace.Get(skipFrames: 1);
             this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, stack));
         }
 
@@ -134,7 +134,7 @@ namespace StardewModdingAPI.Framework.Deprecations
         /// <summary>Get the simplest stack trace which shows where in the mod the deprecated code was called from.</summary>
         /// <param name="stack">The stack trace.</param>
         /// <param name="mod">The mod for which to show a stack trace.</param>
-        private string GetSimplifiedStackTrace(StackTrace stack, IModMetadata? mod)
+        private string GetSimplifiedStackTrace(ImmutableStackTrace stack, IModMetadata? mod)
         {
             // unknown mod, show entire stack trace
             if (mod == null)
diff --git a/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs b/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
index 38062daf..e00881b1 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
@@ -24,7 +24,7 @@ namespace StardewModdingAPI.Framework.Deprecations
         public DeprecationLevel Level { get; }
 
         /// <summary>The stack trace when the deprecation warning was raised.</summary>
-        public StackTrace StackTrace { get; }
+        public ImmutableStackTrace StackTrace { get; }
 
 
         /*********
@@ -36,7 +36,7 @@ namespace StardewModdingAPI.Framework.Deprecations
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <param name="level">The deprecation level for the affected code.</param>
         /// <param name="stackTrace">The stack trace when the deprecation warning was raised.</param>
-        public DeprecationWarning(IModMetadata? mod, string nounPhrase, string version, DeprecationLevel level, StackTrace stackTrace)
+        public DeprecationWarning(IModMetadata? mod, string nounPhrase, string version, DeprecationLevel level, ImmutableStackTrace stackTrace)
         {
             this.Mod = mod;
             this.NounPhrase = nounPhrase;
diff --git a/src/SMAPI/Framework/Deprecations/ImmutableStackTrace.cs b/src/SMAPI/Framework/Deprecations/ImmutableStackTrace.cs
new file mode 100644
index 00000000..059d871c
--- /dev/null
+++ b/src/SMAPI/Framework/Deprecations/ImmutableStackTrace.cs
@@ -0,0 +1,53 @@
+using System.Diagnostics;
+
+namespace StardewModdingAPI.Framework.Deprecations
+{
+    /// <summary>An immutable stack trace that caches its values.</summary>
+    internal class ImmutableStackTrace
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The underlying stack trace.</summary>
+        private readonly StackTrace StackTrace;
+
+        /// <summary>The individual method calls in the stack trace.</summary>
+        private StackFrame[]? Frames;
+
+        /// <summary>The string representation of the stack trace.</summary>
+        private string? StringForm;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="stackTrace">The underlying stack trace.</param>
+        public ImmutableStackTrace(StackTrace stackTrace)
+        {
+            this.StackTrace = stackTrace;
+        }
+
+        /// <summary>Get the underlying frames.</summary>
+        /// <remarks>This is a reference to the underlying stack frames, so this array should not be edited.</remarks>
+        public StackFrame[] GetFrames()
+        {
+            return this.Frames ??= this.StackTrace.GetFrames();
+        }
+
+        /// <inheritdoc />
+        public override string ToString()
+        {
+            return this.StringForm ??= this.StackTrace.ToString();
+        }
+
+        /// <summary>Get the current stack trace.</summary>
+        /// <param name="skipFrames">The number of frames up the stack from which to start the trace.</param>
+        public static ImmutableStackTrace Get(int skipFrames = 0)
+        {
+            return new ImmutableStackTrace(
+                new StackTrace(skipFrames: skipFrames + 1) // also skip this method
+            );
+        }
+    }
+}

From 5c819662f88cd7004a85ac0d0e30a79b5dc4be37 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Apr 2022 19:14:53 -0400
Subject: [PATCH 581/856] suppress some duplicate deprecation notices

---
 src/SMAPI/Framework/Content/AssetInfo.cs      | 14 ++++++-
 .../Deprecations/DeprecationManager.cs        | 42 ++++++++++++-------
 2 files changed, 38 insertions(+), 18 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index c632249d..363fffb3 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -36,7 +36,12 @@ namespace StardewModdingAPI.Framework.Content
                     source: SCore.DeprecationManager.GetModFromStack(),
                     nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetName)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Notice
+                    severity: DeprecationLevel.Notice,
+                    unlessStackIncludes: new[]
+                    {
+                        $"{typeof(AssetInterceptorChange).FullName}.{nameof(AssetInterceptorChange.CanIntercept)}",
+                        $"{typeof(ContentCoordinator).FullName}.{nameof(ContentCoordinator.GetAssetOperations)}"
+                    }
                 );
 
                 return this.NameWithoutLocale.Name;
@@ -72,7 +77,12 @@ namespace StardewModdingAPI.Framework.Content
                 source: SCore.DeprecationManager.GetModFromStack(),
                 nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetNameEquals)}",
                 version: "3.14.0",
-                severity: DeprecationLevel.Notice
+                severity: DeprecationLevel.Notice,
+                unlessStackIncludes: new[]
+                {
+                    $"{typeof(AssetInterceptorChange).FullName}.{nameof(AssetInterceptorChange.CanIntercept)}",
+                    $"{typeof(ContentCoordinator).FullName}.{nameof(ContentCoordinator.GetAssetOperations)}"
+                }
             );
 
 
diff --git a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index 84ce2132..5ca07702 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -56,15 +56,21 @@ namespace StardewModdingAPI.Framework.Deprecations
         /// <param name="nounPhrase">A noun phrase describing what is deprecated.</param>
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <param name="severity">How deprecated the code is.</param>
-        public void Warn(IModMetadata? source, string nounPhrase, string version, DeprecationLevel severity)
+        /// <param name="unlessStackIncludes">A list of stack trace substrings which should suppress deprecation warnings if they appear in the stack trace.</param>
+        public void Warn(IModMetadata? source, string nounPhrase, string version, DeprecationLevel severity, string[]? unlessStackIncludes = null)
         {
-            // ignore if already warned
-            if (!this.MarkWarned(source, nounPhrase, version))
+            // skip if already warned
+            string cacheKey = $"{source?.DisplayName ?? "<unknown>"}::{nounPhrase}::{version}";
+            if (this.LoggedDeprecations.Contains(cacheKey))
                 return;
 
-            // queue warning
+            // warn if valid
             ImmutableStackTrace stack = ImmutableStackTrace.Get(skipFrames: 1);
-            this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, stack));
+            if (!this.ShouldSuppress(stack, unlessStackIncludes))
+            {
+                this.LoggedDeprecations.Add(cacheKey);
+                this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, stack));
+            }
         }
 
         /// <summary>A placeholder method used to track deprecated code for which a separate warning will be shown.</summary>
@@ -117,18 +123,22 @@ namespace StardewModdingAPI.Framework.Deprecations
         /*********
         ** Private methods
         *********/
-        /// <summary>Mark a deprecation warning as already logged.</summary>
-        /// <param name="source">The mod which used the deprecated code.</param>
-        /// <param name="nounPhrase">A noun phrase describing what is deprecated (e.g. "the Extensions.AsInt32 method").</param>
-        /// <param name="version">The SMAPI version which deprecated it.</param>
-        /// <returns>Returns whether the deprecation was successfully marked as warned. Returns <c>false</c> if it was already marked.</returns>
-        private bool MarkWarned(IModMetadata? source, string nounPhrase, string version)
+        /// <summary>Get whether a deprecation warning should be suppressed.</summary>
+        /// <param name="stack">The stack trace for which it was raised.</param>
+        /// <param name="unlessStackIncludes">A list of stack trace substrings which should suppress deprecation warnings if they appear in the stack trace.</param>
+        private bool ShouldSuppress(ImmutableStackTrace stack, string[]? unlessStackIncludes)
         {
-            string key = $"{source?.DisplayName ?? "<unknown>"}::{nounPhrase}::{version}";
-            if (this.LoggedDeprecations.Contains(key))
-                return false;
-            this.LoggedDeprecations.Add(key);
-            return true;
+            if (unlessStackIncludes?.Any() == true)
+            {
+                string stackTrace = stack.ToString();
+                foreach (string method in unlessStackIncludes)
+                {
+                    if (stackTrace.Contains(method))
+                        return true;
+                }
+            }
+
+            return false;
         }
 
         /// <summary>Get the simplest stack trace which shows where in the mod the deprecated code was called from.</summary>

From d4d378bff3a8079e6d665b8c99d9a80937f588cd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Apr 2022 19:25:10 -0400
Subject: [PATCH 582/856] don't add default pagination values to log URL

---
 src/SMAPI.Web/wwwroot/Content/js/log-parser.js | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 8886715e..3fb5fd6c 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -245,6 +245,7 @@ smapi.logParser = function (state) {
         state.localTimeStarted = ("0" + state.logStarted.getHours()).slice(-2) + ":" + ("0" + state.logStarted.getMinutes()).slice(-2);
 
     // add the properties we're passing to Vue
+    const defaultPerPage = 1000;
     state.totalMessages = state.messages.length;
     state.filterText = "";
     state.filterRegex = null;
@@ -254,7 +255,7 @@ smapi.logParser = function (state) {
     state.useRegex = false;
     state.useInsensitive = true;
     state.useWord = false;
-    state.perPage = 1000;
+    state.perPage = defaultPerPage;
     state.page = 1;
 
     state.defaultMods = { ...state.showMods };
@@ -682,7 +683,7 @@ smapi.logParser = function (state) {
             loadFromUrl: function () {
                 const params = new URL(location).searchParams;
 
-                state.perPage = helpers.tryParseNumber(params.get("PerPage"), 1000, n => n > 0);
+                state.perPage = helpers.tryParseNumber(params.get("PerPage"), defaultPerPage, n => n > 0);
                 this.page = helpers.tryParseNumber(params.get("Page"), 1, n => n > 0);
                 state.filterText = params.get("Filter") || "";
 
@@ -741,8 +742,12 @@ smapi.logParser = function (state) {
              */
             updateUrl: function () {
                 const url = new URL(location);
-                url.searchParams.set("Page", state.page);
-                url.searchParams.set("PerPage", state.perPage);
+
+                if (state.page != 1)
+                    url.searchParams.set("Page", state.page);
+
+                if (state.perPage != defaultPerPage)
+                    url.searchParams.set("PerPage", state.perPage);
 
                 if (!helpers.shallowEquals(this.showMods, state.defaultMods))
                     url.searchParams.set("Mods", Object.entries(this.showMods).filter(p => p[1]).map(p => p[0]).join("~"));

From 9939061615c41fabca004bf8f5b6f2b018a40b06 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Apr 2022 19:26:12 -0400
Subject: [PATCH 583/856] fix typo

---
 docs/technical/smapi.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index e117db2f..789ea20b 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -83,7 +83,7 @@ folder before compiling.
 ## Prepare a release
 ### On any platform
 **⚠ Ideally we'd have one set of instructions for all platforms. The instructions in this section
-will produce a fully functional release for all supported platfrms, _except_ that the application
+will produce a fully functional release for all supported platforms, _except_ that the application
 icon for SMAPI on Windows will disappear due to [.NET runtime bug
 3828](https://github.com/dotnet/runtime/issues/3828). Until that's fixed, see the _[on
 Windows](#on-windows)_ section below to create a build that retains the icon.**

From f0645c59931f56415999b9befe473f5af642a5ce Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Apr 2022 22:08:34 -0400
Subject: [PATCH 584/856] fix null reference when adding new layers in a map
 patch

---
 src/SMAPI/Framework/Content/AssetDataForMap.cs | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForMap.cs b/src/SMAPI/Framework/Content/AssetDataForMap.cs
index 8674461e..b8722ead 100644
--- a/src/SMAPI/Framework/Content/AssetDataForMap.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForMap.cs
@@ -99,8 +99,15 @@ namespace StardewModdingAPI.Framework.Content
             }
 
             // get target layers
-            IDictionary<Layer, Layer> sourceToTargetLayers = source.Layers.ToDictionary(p => p, p => target.GetLayer(p.Id));
-            HashSet<Layer> orphanedTargetLayers = new HashSet<Layer>(target.Layers.Except(sourceToTargetLayers.Values));
+            Dictionary<Layer, Layer> sourceToTargetLayers =
+                (
+                    from sourceLayer in source.Layers
+                    let targetLayer = target.GetLayer(sourceLayer.Id)
+                    where targetLayer != null
+                    select (sourceLayer, targetLayer)
+                )
+                .ToDictionary(p => p.sourceLayer, p => p.targetLayer);
+            HashSet<Layer> orphanedTargetLayers = new(target.Layers.Except(sourceToTargetLayers.Values));
 
             // apply tiles
             bool replaceAll = patchMode == PatchMapMode.Replace;

From c05505646048d8f7aaabfb65bd1e789e94857d65 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 19 Apr 2022 22:11:43 -0400
Subject: [PATCH 585/856] update Pintail to fix out parameter issue

---
 src/SMAPI/SMAPI.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 1540ee42..9be8ba07 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Pintail" Version="2.0.0" />
+    <PackageReference Include="Pintail" Version="2.0.1" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />

From 4fa414c2bd5ddb452c0560d00e0d4f1d383c1d8b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 21 Apr 2022 20:59:35 -0400
Subject: [PATCH 586/856] set page/perPage URL args together

Since there's no UI to set the page size, this makes the argument more discoverable.
---
 src/SMAPI.Web/wwwroot/Content/js/log-parser.js | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index 3fb5fd6c..fccd00be 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -743,11 +743,14 @@ smapi.logParser = function (state) {
             updateUrl: function () {
                 const url = new URL(location);
 
-                if (state.page != 1)
+                if (state.page != 1 || state.perPage != defaultPerPage) {
                     url.searchParams.set("Page", state.page);
-
-                if (state.perPage != defaultPerPage)
                     url.searchParams.set("PerPage", state.perPage);
+                }
+                else {
+                    url.searchParams.delete("Page");
+                    url.searchParams.delete("PerPage");
+                }
 
                 if (!helpers.shallowEquals(this.showMods, state.defaultMods))
                     url.searchParams.set("Mods", Object.entries(this.showMods).filter(p => p[1]).map(p => p[0]).join("~"));

From 4a14792e4db223f1d7faf4a22759268c91186e32 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 23 Apr 2022 16:47:24 -0400
Subject: [PATCH 587/856] fix ReplaceWith not working for legacy IAssetEditor
 implementations

---
 src/SMAPI/Framework/Content/AssetDataForObject.cs | 10 ++++++----
 src/SMAPI/Framework/ContentCoordinator.cs         |  3 ++-
 2 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForObject.cs b/src/SMAPI/Framework/Content/AssetDataForObject.cs
index e508ca30..6c40f5f9 100644
--- a/src/SMAPI/Framework/Content/AssetDataForObject.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForObject.cs
@@ -25,8 +25,9 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public AssetDataForObject(string? locale, IAssetName assetName, object data, Func<string, string> getNormalizedPath, Reflector reflection)
-            : base(locale, assetName, data, getNormalizedPath, onDataReplaced: null)
+        /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
+        public AssetDataForObject(string? locale, IAssetName assetName, object data, Func<string, string> getNormalizedPath, Reflector reflection, Action<object>? onDataReplaced = null)
+            : base(locale, assetName, data, getNormalizedPath, onDataReplaced)
         {
             this.Reflection = reflection;
         }
@@ -36,8 +37,9 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="data">The content data being read.</param>
         /// <param name="getNormalizedPath">Normalizes an asset key to match the cache key.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public AssetDataForObject(IAssetInfo info, object data, Func<string, string> getNormalizedPath, Reflector reflection)
-            : this(info.Locale, info.Name, data, getNormalizedPath, reflection) { }
+        /// <param name="onDataReplaced">A callback to invoke when the data is replaced (if any).</param>
+        public AssetDataForObject(IAssetInfo info, object data, Func<string, string> getNormalizedPath, Reflector reflection, Action<object>? onDataReplaced = null)
+            : this(info.Locale, info.Name, data, getNormalizedPath, reflection, onDataReplaced) { }
 
         /// <inheritdoc />
         public IAssetDataForDictionary<TKey, TValue> AsDictionary<TKey, TValue>()
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index aade7b36..93b6d9f3 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -716,7 +716,8 @@ namespace StardewModdingAPI.Framework
                     assetName: legacyName,
                     data: asset.Data,
                     getNormalizedPath: this.MainContentManager.AssertAndNormalizeAssetName,
-                    reflection: this.Reflection
+                    reflection: this.Reflection,
+                    onDataReplaced: asset.ReplaceWith
                 );
         }
 

From 55c254deb86d90ed0c176df0d695ff67ffe701d9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 25 Apr 2022 00:15:31 -0400
Subject: [PATCH 588/856] fix null reference error when implicitly converting
 null translation to string

---
 src/SMAPI/Translation.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/Translation.cs b/src/SMAPI/Translation.cs
index eb608f15..01cb92b2 100644
--- a/src/SMAPI/Translation.cs
+++ b/src/SMAPI/Translation.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
 using System.Text.RegularExpressions;
 
@@ -120,9 +121,10 @@ namespace StardewModdingAPI
         /// <summary>Get a string representation of the given translation.</summary>
         /// <param name="translation">The translation key.</param>
         /// <remarks><strong>Limitation with nullable reference types: if there's no text and you disabled the fallback via <see cref="UsePlaceholder"/>, this will return null but the return value will still be marked non-nullable.</strong></remarks>
+        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The null check is required due to limitations in nullable type annotations (see remarks).")]
         public static implicit operator string(Translation translation)
         {
-            return translation.ToString();
+            return translation?.ToString()!;
         }
 
 

From 6a43171e9242e53e299b38dd88370d7070d9186e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 26 Apr 2022 23:38:16 -0400
Subject: [PATCH 589/856] re-enable Pintail by default

---
 docs/release-notes.md                 | 4 ++--
 src/SMAPI/Framework/Models/SConfig.cs | 2 +-
 src/SMAPI/SMAPI.config.json           | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0c14360b..fc7e4918 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -44,8 +44,8 @@ the C# mod that loads them is updated.
     _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
   * Added [nullable reference type annotations](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Nullable_reference_type_annotations) for all APIs.
   * Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.
-  * Added optional overhaul of [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
-    _This is experimental (you can enable it via `UsePintail` in `smapi-internal/config.json`). This adds support for many previously unsupported cases: proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. Existing mod APIs should work fine as-is._
+  * Improved [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
+    _This adds support for proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. This is an internal change, you don't need to do anything different in your mod code._
   * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
   * Enabled deprecation notices for all deprecated APIs. These will only be shown in `TRACE` logs for at least a month after SMAPI 3.14.0 releases.
 * Other improvements:
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index af2e1035..1a43c1fc 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -23,7 +23,7 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
             [nameof(AggressiveMemoryOptimizations)] = false,
-            [nameof(UsePintail)] = false
+            [nameof(UsePintail)] = true
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index a317e6b8..065dfa8c 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -50,7 +50,7 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      * Whether to use the experimental Pintail API proxying library, instead of the original
      * proxying built into SMAPI itself.
      */
-    "UsePintail": false,
+    "UsePintail": true,
 
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially

From 8425c8203394c436645828fcd11976078d04a1f7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 26 Apr 2022 23:54:48 -0400
Subject: [PATCH 590/856] fix locale change for legacy IAssetEditor/Loader
 implementations

---
 src/SMAPI/Framework/ContentCoordinator.cs | 49 ++++++++++-------------
 src/SMAPI/IAssetInfo.cs                   |  3 +-
 2 files changed, 23 insertions(+), 29 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 93b6d9f3..84fff250 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -691,12 +691,9 @@ namespace StardewModdingAPI.Framework
         /// <param name="asset">The asset info.</param>
         private IAssetInfo GetLegacyAssetInfo(IAssetInfo asset)
         {
-            if (!this.TryGetLegacyAssetName(asset.Name, out IAssetName legacyName))
-                return asset;
-
             return new AssetInfo(
-                locale: null,
-                assetName: legacyName,
+                locale: this.GetLegacyLocale(asset),
+                assetName: this.GetLegacyAssetName(asset.Name),
                 type: asset.DataType,
                 getNormalizedPath: this.MainContentManager.AssertAndNormalizeAssetName
             );
@@ -706,49 +703,45 @@ namespace StardewModdingAPI.Framework
         /// <param name="asset">The asset data.</param>
         private IAssetData GetLegacyAssetData(IAssetData asset)
         {
-            if (!this.TryGetLegacyAssetName(asset.Name, out IAssetName legacyName))
-                return asset;
+            return new AssetDataForObject(
+                locale: this.GetLegacyLocale(asset),
+                assetName: this.GetLegacyAssetName(asset.Name),
+                data: asset.Data,
+                getNormalizedPath: this.MainContentManager.AssertAndNormalizeAssetName,
+                reflection: this.Reflection,
+                onDataReplaced: asset.ReplaceWith
+            );
+        }
 
-            return asset.Name.LocaleCode == null
-                ? asset
-                : new AssetDataForObject(
-                    locale: null,
-                    assetName: legacyName,
-                    data: asset.Data,
-                    getNormalizedPath: this.MainContentManager.AssertAndNormalizeAssetName,
-                    reflection: this.Reflection,
-                    onDataReplaced: asset.ReplaceWith
-                );
+        /// <summary>Get the <see cref="IAssetInfo.Locale"/> value compatible with legacy <see cref="IAssetLoader"/> and <see cref="IAssetEditor"/> instances, which expect the locale to default to the current game locale or an empty string.</summary>
+        /// <param name="asset">The non-legacy asset info to map.</param>
+        private string GetLegacyLocale(IAssetInfo asset)
+        {
+            return asset.Locale ?? this.GetLocale();
         }
 
         /// <summary>Get an asset name compatible with legacy <see cref="IAssetLoader"/> and <see cref="IAssetEditor"/> instances, which always expect the base name.</summary>
         /// <param name="asset">The asset name to map.</param>
-        /// <param name="newAsset">The legacy asset name (or the <paramref name="asset"/> if no change is needed).</param>
-        /// <returns>Returns whether any change is needed for legacy compatibility.</returns>
-        private bool TryGetLegacyAssetName(IAssetName asset, out IAssetName newAsset)
+        /// <returns>Returns the legacy asset name if needed, or the <paramref name="asset"/> if no change is needed.</returns>
+        private IAssetName GetLegacyAssetName(IAssetName asset)
         {
             // strip _international suffix
             const string internationalSuffix = "_international";
             if (asset.Name.EndsWith(internationalSuffix))
             {
-                newAsset = new AssetName(
+                return new AssetName(
                     baseName: asset.Name[..^internationalSuffix.Length],
                     localeCode: null,
                     languageCode: null
                 );
-                return true;
             }
 
             // else strip locale
             if (asset.LocaleCode != null)
-            {
-                newAsset = new AssetName(asset.BaseName, null, null);
-                return true;
-            }
+                return new AssetName(asset.BaseName, null, null);
 
             // else no change needed
-            newAsset = asset;
-            return false;
+            return asset;
         }
     }
 }
diff --git a/src/SMAPI/IAssetInfo.cs b/src/SMAPI/IAssetInfo.cs
index 4d651a72..44fd91a5 100644
--- a/src/SMAPI/IAssetInfo.cs
+++ b/src/SMAPI/IAssetInfo.cs
@@ -9,10 +9,11 @@ namespace StardewModdingAPI
         ** Accessors
         *********/
         /// <summary>The content's locale code, if the content is localized.</summary>
+        /// <remarks>LEGACY NOTE: when reading this field from an <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> implementation, for non-localized assets it will return the current game locale (or an empty string for English) instead of null.</remarks>
         string? Locale { get; }
 
         /// <summary>The asset name being read.</summary>
-        /// <remarks>NOTE: when reading this field from an <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> implementation, it's always equivalent to <see cref="NameWithoutLocale"/> for backwards compatibility.</remarks>
+        /// <remarks>LEGACY NOTE: when reading this field from an <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> implementation, it's always equivalent to <see cref="NameWithoutLocale"/> for backwards compatibility.</remarks>
         public IAssetName Name { get; }
 
         /// <summary>The <see cref="Name"/> with any locale codes stripped.</summary>

From d7d8cdaa5a4bc01001e3538a9189b04d1130d3bb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 27 Apr 2022 20:09:43 -0400
Subject: [PATCH 591/856] add backwards compatibility for loading content
 assets with .xnb extension

---
 src/SMAPI/Framework/Content/ContentCache.cs     |  2 +-
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs | 11 +++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index cbb6c1e9..736ee5da 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -76,7 +76,7 @@ namespace StardewModdingAPI.Framework.Content
         {
             key = this.NormalizePathSeparators(key);
             return key.EndsWith(".xnb", StringComparison.OrdinalIgnoreCase)
-                ? key.Substring(0, key.Length - 4)
+                ? key[..^4]
                 : key;
         }
 
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 94a30bf1..3c2441e8 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -118,6 +118,17 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 switch (source)
                 {
                     case ContentSource.GameContent:
+                        if (assetName.Name.EndsWith(".xnb", StringComparison.OrdinalIgnoreCase))
+                        {
+                            assetName = this.ContentCore.ParseAssetName(assetName.Name[..^4], allowLocales: true);
+                            SCore.DeprecationManager.Warn(
+                                this.Mod,
+                                "loading assets from the Content folder with a .xnb file extension",
+                                "3.14.0",
+                                DeprecationLevel.Notice
+                            );
+                        }
+
                         return this.GameContentManager.LoadLocalized<T>(assetName, this.CurrentLocaleConstant, useCache: false);
 
                     case ContentSource.ModFolder:

From a340c8b8ce8cf0c3b218162117cbc2e8f5acb2b8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 29 Apr 2022 22:46:37 -0400
Subject: [PATCH 592/856] enable some disabled steps in Windows build script

This simplifies preparing test Windows-only installers.
---
 build/windows/prepare-install-package.ps1 | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index 9922cbc6..b6a23124 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -184,14 +184,13 @@ foreach ($folder in $folders) {
     # disable developer mode in main package
     In-Place-Regex -Path "$packagePath/internal/$folder/bundle/smapi-internal/config.json" -Search "`"DeveloperMode`": true" -Replace "`"DeveloperMode`": false"
 
-    # DISABLED: will be handled by Linux script
     # convert bundle folder into final 'install.dat' files
-    #foreach ($path in @("$packagePath/internal/$folder", "$packageDevPath/internal/$folder"))
-    #{
-    #    Compress-Archive -Path "$path/bundle/*" -CompressionLevel Optimal -DestinationPath "$path/install.zip"
-    #    mv "$path/install.zip" "$path/install.dat"
-    #    rm -Recurse -Force "$path/bundle"
-    #}
+    foreach ($path in @("$packagePath/internal/$folder", "$packageDevPath/internal/$folder"))
+    {
+        Compress-Archive -Path "$path/bundle/*" -CompressionLevel Optimal -DestinationPath "$path/install.zip"
+        mv "$path/install.zip" "$path/install.dat"
+        rm -Recurse -Force "$path/bundle"
+    }
 }
 
 
@@ -208,10 +207,9 @@ if (!$version) {
 mv "$packagePath" "bin/SMAPI $version installer"
 mv "$packageDevPath" "bin/SMAPI $version installer for developers"
 
-# DISABLED: will be handled by Linux script
-## package files
-#Compress-Archive -Path "bin/SMAPI $version installer" -DestinationPath "bin/SMAPI $version installer.zip" -CompressionLevel Optimal
-#Compress-Archive -Path "bin/SMAPI $version installer for developers" -DestinationPath "bin/SMAPI $version installer for developers.zip" -CompressionLevel Optimal
+# package files
+Compress-Archive -Path "bin/SMAPI $version installer" -DestinationPath "bin/SMAPI $version installer.zip" -CompressionLevel Optimal
+Compress-Archive -Path "bin/SMAPI $version installer for developers" -DestinationPath "bin/SMAPI $version installer for developers.zip" -CompressionLevel Optimal
 
 echo ""
 echo "Done! See docs/technical/smapi.md to create the release zips."

From f507bd0f9cebe68fa2adf176740a0d00b3e6f884 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 29 Apr 2022 22:55:12 -0400
Subject: [PATCH 593/856] set SMAPI version from main build script

---
 build/unix/prepare-install-package.sh     | 21 ++++++++++++++-------
 build/windows/prepare-install-package.ps1 | 20 ++++++++++++++------
 docs/technical/smapi.md                   | 22 ++++++++++------------
 3 files changed, 38 insertions(+), 25 deletions(-)

diff --git a/build/unix/prepare-install-package.sh b/build/unix/prepare-install-package.sh
index 9dd24b82..e9b413b4 100755
--- a/build/unix/prepare-install-package.sh
+++ b/build/unix/prepare-install-package.sh
@@ -28,6 +28,20 @@ declare -A msBuildPlatformNames=(["linux"]="Unix" ["macOS"]="OSX" ["windows"]="W
 cd "`dirname "$0"`/../.."
 
 
+##########
+## Set version
+##########
+# get version number
+version="$1"
+if [ $# -eq 0 ]; then
+    echo "SMAPI release version (like '4.0.0'):"
+    read version
+fi
+
+# set version
+. ${0%/*}/set-smapi-version.sh "$version"
+
+
 ##########
 ## Clear old build files
 ##########
@@ -190,13 +204,6 @@ done
 ##########
 ## Create release zips
 ##########
-# get version number
-version="$1"
-if [ $# -eq 0 ]; then
-    echo "SMAPI release version (like '4.0.0'):"
-    read version
-fi
-
 # rename folders
 mv "$packagePath" "bin/SMAPI $version installer"
 mv "$packageDevPath" "bin/SMAPI $version installer for developers"
diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index b6a23124..5a1e0bcc 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -12,6 +12,20 @@
 
 . "$PSScriptRoot\lib\in-place-regex.ps1"
 
+
+##########
+## Set version
+##########
+# get version number
+$version = $args[0]
+if (!$version) {
+    $version = Read-Host "SMAPI release version (like '4.0.0')"
+}
+
+# set version
+. "$PSScriptRoot/set-smapi-version.ps1" "$version"
+
+
 ##########
 ## Constants
 ##########
@@ -197,12 +211,6 @@ foreach ($folder in $folders) {
 ###########
 ### Create release zips
 ###########
-# get version number
-$version = $args[0]
-if (!$version) {
-    $version = Read-Host "SMAPI release version (like '4.0.0')"
-}
-
 # rename folders
 mv "$packagePath" "bin/SMAPI $version installer"
 mv "$packageDevPath" "bin/SMAPI $version installer for developers"
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 789ea20b..4d75aef2 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -120,8 +120,10 @@ Windows](#on-windows)_ section below to create a build that retains the icon.**
 2. Launch the game through the Steam UI.
 
 ### Prepare the release
-1. Run `build/unix/set-smapi-version.sh` to set the SMAPI version. Make sure you use a [semantic
-   version](https://semver.org). Recommended format:
+1. Run `build/unix/prepare-install-package.sh VERSION_HERE` to create the release package in the
+   root `bin` folder.
+
+   Make sure you use a [semantic version](https://semver.org). Recommended format:
 
    build type | format                   | example
    :--------- | :----------------------- | :------
@@ -129,9 +131,6 @@ Windows](#on-windows)_ section below to create a build that retains the icon.**
    prerelease | `<version>-beta.<date>`  | `4.0.0-beta.20251230`
    release    | `<version>`              | `4.0.0`
 
-2. Run `build/unix/prepare-install-package.sh` to create the release package in the root `bin`
-   folder.
-
 ### On Windows
 #### First-time setup
 1. Set up Windows Subsystem for Linux (WSL):
@@ -147,8 +146,10 @@ Windows](#on-windows)_ section below to create a build that retains the icon.**
    ```
 
 ### Prepare the release
-1. Run `build/windows/set-smapi-version.ps1` in PowerShell to set the SMAPI version. Make sure you
-   use a [semantic version](https://semver.org). Recommended format:
+1. Run `build/windows/prepare-install-package.ps1 VERSION_HERE` in PowerShell to create the release
+   package folders in the root `bin` folder.
+
+   Make sure you use a [semantic version](https://semver.org). Recommended format:
 
    build type | format                   | example
    :--------- | :----------------------- | :------
@@ -156,12 +157,9 @@ Windows](#on-windows)_ section below to create a build that retains the icon.**
    prerelease | `<version>-beta.<date>`  | `4.0.0-beta.20251230`
    release    | `<version>`              | `4.0.0`
 
-2. Run `build/windows/prepare-install-package.ps1` in PowerShell to create the release package
-   folders in the root `bin` folder.
-
-3. Launch WSL and run this script:
+2. Launch WSL and run this script:
    ```bash
-   # edit to match the build created in steps 1-2
+   # edit to match the build created in steps 1
    # In WSL, `/mnt/c/example` accesses `C:\example` on the Windows filesystem.
    version="4.0.0"
    binFolder="/mnt/e/source/_Stardew/SMAPI/bin"

From ed337ab9644527465205547bd7e319194df553ab Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 30 Apr 2022 12:33:33 -0400
Subject: [PATCH 594/856] fix model binding for mod update-check API

---
 .../Framework/Clients/WebApi/ModSearchModel.cs         | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
index a0cd9d4d..d1b7fa4d 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Utilities;
 
@@ -28,6 +29,15 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an empty instance.</summary>
+        [Obsolete("This constructor only exists to support ASP.NET model binding, and shouldn't be used directly.")]
+        public ModSearchModel()
+        {
+            // ASP.NET Web API needs a public empty constructor for top-level request models, and
+            // it'll fail if the other constructor is marked with [JsonConstructor]. Apparently
+            // it's fine with non-empty constructors in nested models like ModSearchEntryModel.
+        }
+
         /// <summary>Construct an instance.</summary>
         /// <param name="mods">The mods to search.</param>
         /// <param name="apiVersion">The SMAPI version installed by the player. If this is null, the API won't provide a recommended update.</param>

From 7bb7a7522fcdfef27f8f22ba77f24c7609f49912 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 30 Apr 2022 12:57:28 -0400
Subject: [PATCH 595/856] omit stack trace for deprecated code not called
 directly by the mod

---
 .../Framework/Deprecations/DeprecationManager.cs   | 14 ++++++++++----
 .../Framework/Deprecations/DeprecationWarning.cs   |  9 ++++++---
 src/SMAPI/Framework/SCore.cs                       |  6 ++++--
 3 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index 5ca07702..288abde2 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -57,7 +57,8 @@ namespace StardewModdingAPI.Framework.Deprecations
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <param name="severity">How deprecated the code is.</param>
         /// <param name="unlessStackIncludes">A list of stack trace substrings which should suppress deprecation warnings if they appear in the stack trace.</param>
-        public void Warn(IModMetadata? source, string nounPhrase, string version, DeprecationLevel severity, string[]? unlessStackIncludes = null)
+        /// <param name="logStackTrace">Whether to log a stack trace showing where the deprecated code is in the mod.</param>
+        public void Warn(IModMetadata? source, string nounPhrase, string version, DeprecationLevel severity, string[]? unlessStackIncludes = null, bool logStackTrace = true)
         {
             // skip if already warned
             string cacheKey = $"{source?.DisplayName ?? "<unknown>"}::{nounPhrase}::{version}";
@@ -69,7 +70,7 @@ namespace StardewModdingAPI.Framework.Deprecations
             if (!this.ShouldSuppress(stack, unlessStackIncludes))
             {
                 this.LoggedDeprecations.Add(cacheKey);
-                this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, stack));
+                this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, stack, logStackTrace));
             }
         }
 
@@ -108,11 +109,16 @@ namespace StardewModdingAPI.Framework.Deprecations
 
                 // log message
                 if (level == LogLevel.Trace)
-                    this.Monitor.Log($"{message}\n{this.GetSimplifiedStackTrace(warning.StackTrace, warning.Mod)}", level);
+                {
+                    if (warning.LogStackTrace)
+                        message += $"\n{this.GetSimplifiedStackTrace(warning.StackTrace, warning.Mod)}";
+                    this.Monitor.Log(message, level);
+                }
                 else
                 {
                     this.Monitor.Log(message, level);
-                    this.Monitor.Log(this.GetSimplifiedStackTrace(warning.StackTrace, warning.Mod), LogLevel.Debug);
+                    if (warning.LogStackTrace)
+                        this.Monitor.Log(this.GetSimplifiedStackTrace(warning.StackTrace, warning.Mod), LogLevel.Debug);
                 }
             }
 
diff --git a/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs b/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
index e00881b1..5936517b 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationWarning.cs
@@ -1,5 +1,3 @@
-using System.Diagnostics;
-
 namespace StardewModdingAPI.Framework.Deprecations
 {
     /// <summary>A deprecation warning for a mod.</summary>
@@ -26,6 +24,9 @@ namespace StardewModdingAPI.Framework.Deprecations
         /// <summary>The stack trace when the deprecation warning was raised.</summary>
         public ImmutableStackTrace StackTrace { get; }
 
+        /// <summary>Whether to log a stack trace showing where the deprecated code is in the mod.</summary>
+        public bool LogStackTrace { get; }
+
 
         /*********
         ** Public methods
@@ -36,13 +37,15 @@ namespace StardewModdingAPI.Framework.Deprecations
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <param name="level">The deprecation level for the affected code.</param>
         /// <param name="stackTrace">The stack trace when the deprecation warning was raised.</param>
-        public DeprecationWarning(IModMetadata? mod, string nounPhrase, string version, DeprecationLevel level, ImmutableStackTrace stackTrace)
+        /// <param name="logStackTrace">Whether to log a stack trace showing where the deprecated code is in the mod.</param>
+        public DeprecationWarning(IModMetadata? mod, string nounPhrase, string version, DeprecationLevel level, ImmutableStackTrace stackTrace, bool logStackTrace)
         {
             this.Mod = mod;
             this.NounPhrase = nounPhrase;
             this.Version = version;
             this.Level = level;
             this.StackTrace = stackTrace;
+            this.LogStackTrace = logStackTrace;
         }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c208788a..e64318a5 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1604,7 +1604,8 @@ namespace StardewModdingAPI.Framework
                             source: metadata,
                             nounPhrase: $"{nameof(IAssetEditor)}",
                             version: "3.14.0",
-                            severity: DeprecationLevel.Notice
+                            severity: DeprecationLevel.Notice,
+                            logStackTrace: false
                         );
 
                         this.ContentCore.Editors.Add(new ModLinked<IAssetEditor>(metadata, editor));
@@ -1616,7 +1617,8 @@ namespace StardewModdingAPI.Framework
                             source: metadata,
                             nounPhrase: $"{nameof(IAssetLoader)}",
                             version: "3.14.0",
-                            severity: DeprecationLevel.Notice
+                            severity: DeprecationLevel.Notice,
+                            logStackTrace: false
                         );
 
                         this.ContentCore.Loaders.Add(new ModLinked<IAssetLoader>(metadata, loader));

From db43fc22a4c7f5eb16a44d3b83ecba3f39ab5dc6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 1 May 2022 01:34:44 -0400
Subject: [PATCH 596/856] update Pintail to fix proxy type name conflict edge
 case

---
 src/SMAPI/SMAPI.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 9be8ba07..27044679 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="Pintail" Version="2.0.1" />
+    <PackageReference Include="Pintail" Version="2.1.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
     <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />

From ea9324586d4aaafd9d18f09e0bf110e57d86c449 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 1 May 2022 17:31:54 -0400
Subject: [PATCH 597/856] fix warnings for model-binding hack

---
 src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
index d1b7fa4d..3c74bab0 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/ModSearchModel.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Utilities;
 
@@ -31,11 +32,15 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         *********/
         /// <summary>Construct an empty instance.</summary>
         [Obsolete("This constructor only exists to support ASP.NET model binding, and shouldn't be used directly.")]
+        [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Used by ASP.NET model binding.")]
         public ModSearchModel()
         {
             // ASP.NET Web API needs a public empty constructor for top-level request models, and
             // it'll fail if the other constructor is marked with [JsonConstructor]. Apparently
             // it's fine with non-empty constructors in nested models like ModSearchEntryModel.
+            this.Mods = Array.Empty<ModSearchEntryModel>();
+            this.ApiVersion = null!;
+            this.GameVersion = null!;
         }
 
         /// <summary>Construct an instance.</summary>

From 0e4aa65708df7ca4096b9019428d9fccabd37384 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 1 May 2022 17:33:41 -0400
Subject: [PATCH 598/856] fix crossplatform build scripts

---
 build/unix/prepare-install-package.sh     | 22 +++-----
 build/windows/prepare-install-package.ps1 | 66 ++++++++++++++---------
 docs/technical/smapi.md                   |  3 ++
 3 files changed, 51 insertions(+), 40 deletions(-)

diff --git a/build/unix/prepare-install-package.sh b/build/unix/prepare-install-package.sh
index e9b413b4..9b195f37 100755
--- a/build/unix/prepare-install-package.sh
+++ b/build/unix/prepare-install-package.sh
@@ -9,7 +9,7 @@
 
 
 ##########
-## Constants
+## Fetch values
 ##########
 # paths
 gamePath="/home/pathoschild/Stardew Valley"
@@ -21,25 +21,18 @@ folders=("linux" "macOS" "windows")
 declare -A runtimes=(["linux"]="linux-x64" ["macOS"]="osx-x64" ["windows"]="win-x64")
 declare -A msBuildPlatformNames=(["linux"]="Unix" ["macOS"]="OSX" ["windows"]="Windows_NT")
 
-
-##########
-## Move to SMAPI root
-##########
-cd "`dirname "$0"`/../.."
-
-
-##########
-## Set version
-##########
-# get version number
+# version number
 version="$1"
 if [ $# -eq 0 ]; then
     echo "SMAPI release version (like '4.0.0'):"
     read version
 fi
 
-# set version
-. ${0%/*}/set-smapi-version.sh "$version"
+
+##########
+## Move to SMAPI root
+##########
+cd "`dirname "$0"`/../.."
 
 
 ##########
@@ -56,6 +49,7 @@ echo ""
 ##########
 ## Compile files
 ##########
+. ${0%/*}/set-smapi-version.sh "$version"
 for folder in ${folders[@]}; do
     runtime=${runtimes[$folder]}
     msbuildPlatformName=${msBuildPlatformNames[$folder]}
diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index 5a1e0bcc..5e116019 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -1,33 +1,19 @@
 #
 #
 # This is the PowerShell equivalent of ../unix/prepare-install-package.sh, *except* that it doesn't
-# set Linux permissions, create the install.dat files, or create the final zip. Due to limitations
-# in PowerShell, the final changes are handled by the windows/finalize-install-package.sh file in
-# WSL.
+# set Linux permissions, create the install.dat files, or create the final zip (unless you specify
+# --windows-only). Due to limitations in PowerShell, the final changes are handled by the
+# windows/finalize-install-package.sh file in WSL.
 #
 # When making changes, make sure to update ../unix/prepare-install-package.ps1 too.
 #
 #
 
-
-. "$PSScriptRoot\lib\in-place-regex.ps1"
+. "$PSScriptRoot/lib/in-place-regex.ps1"
 
 
 ##########
-## Set version
-##########
-# get version number
-$version = $args[0]
-if (!$version) {
-    $version = Read-Host "SMAPI release version (like '4.0.0')"
-}
-
-# set version
-. "$PSScriptRoot/set-smapi-version.ps1" "$version"
-
-
-##########
-## Constants
+## Fetch values
 ##########
 # paths
 $gamePath = "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley"
@@ -39,6 +25,23 @@ $folders = "linux", "macOS", "windows"
 $runtimes = @{ linux = "linux-x64"; macOS = "osx-x64"; windows = "win-x64" }
 $msBuildPlatformNames = @{ linux = "Unix"; macOS = "OSX"; windows = "Windows_NT" }
 
+# version number
+$version = $args[0]
+if (!$version) {
+    $version = Read-Host "SMAPI release version (like '4.0.0')"
+}
+
+# Windows-only build
+$windowsOnly = $false
+foreach ($arg in $args) {
+    if ($arg -eq "--windows-only") {
+        $windowsOnly = $true
+        $folders = "windows"
+        $runtimes = @{ windows = "win-x64" }
+        $msBuildPlatformNames = @{ windows = "Windows_NT" }
+    }
+}
+
 
 ##########
 ## Move to SMAPI root
@@ -62,7 +65,8 @@ echo ""
 ##########
 ## Compile files
 ##########
-ForEach ($folder in $folders) {
+. "$PSScriptRoot/set-smapi-version.ps1" "$version"
+foreach ($folder in $folders) {
     $runtime = $runtimes[$folder]
     $msbuildPlatformName = $msBuildPlatformNames[$folder]
 
@@ -106,6 +110,10 @@ foreach ($folder in $folders) {
 
 # copy base installer files
 foreach ($name in @("install on Linux.sh", "install on macOS.command", "install on Windows.bat", "README.txt")) {
+    if ($windowsOnly -and ($name -eq "install on Linux.sh" -or $name -eq "install on macOS.command")) {
+        continue;
+    }
+
     cp "$installAssets/$name" "$packagePath"
 }
 
@@ -199,11 +207,14 @@ foreach ($folder in $folders) {
     In-Place-Regex -Path "$packagePath/internal/$folder/bundle/smapi-internal/config.json" -Search "`"DeveloperMode`": true" -Replace "`"DeveloperMode`": false"
 
     # convert bundle folder into final 'install.dat' files
-    foreach ($path in @("$packagePath/internal/$folder", "$packageDevPath/internal/$folder"))
+    if ($windowsOnly)
     {
-        Compress-Archive -Path "$path/bundle/*" -CompressionLevel Optimal -DestinationPath "$path/install.zip"
-        mv "$path/install.zip" "$path/install.dat"
-        rm -Recurse -Force "$path/bundle"
+        foreach ($path in @("$packagePath/internal/$folder", "$packageDevPath/internal/$folder"))
+        {
+            Compress-Archive -Path "$path/bundle/*" -CompressionLevel Optimal -DestinationPath "$path/install.zip"
+            mv "$path/install.zip" "$path/install.dat"
+            rm -Recurse -Force "$path/bundle"
+        }
     }
 }
 
@@ -216,8 +227,11 @@ mv "$packagePath" "bin/SMAPI $version installer"
 mv "$packageDevPath" "bin/SMAPI $version installer for developers"
 
 # package files
-Compress-Archive -Path "bin/SMAPI $version installer" -DestinationPath "bin/SMAPI $version installer.zip" -CompressionLevel Optimal
-Compress-Archive -Path "bin/SMAPI $version installer for developers" -DestinationPath "bin/SMAPI $version installer for developers.zip" -CompressionLevel Optimal
+if ($windowsOnly)
+{
+    Compress-Archive -Path "bin/SMAPI $version installer" -DestinationPath "bin/SMAPI $version installer.zip" -CompressionLevel Optimal
+    Compress-Archive -Path "bin/SMAPI $version installer for developers" -DestinationPath "bin/SMAPI $version installer for developers.zip" -CompressionLevel Optimal
+}
 
 echo ""
 echo "Done! See docs/technical/smapi.md to create the release zips."
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 4d75aef2..44b6e49f 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -166,5 +166,8 @@ Windows](#on-windows)_ section below to create a build that retains the icon.**
    build/windows/finalize-install-package.sh "$version" "$binFolder"
    ```
 
+Note: to prepare a test Windows-only build, you can pass `--windows-only` in the first step and
+skip the second one.
+
 ## Release notes
 See [release notes](../release-notes.md).

From f78093bdb58d477b400cde3f19b70ffd6ddf833d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 1 May 2022 17:39:57 -0400
Subject: [PATCH 599/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 64 ++++++++++----------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 +-
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 +-
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 +-
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 41 insertions(+), 39 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index c04546d0..a8dda9e0 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.13.4</Version>
+    <Version>3.14.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index fc7e4918..499c1d9b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,61 +1,59 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.14.0
+Released 01 May 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/65265507).
+
 ### For players
-* Changes:
-  * When scanning for mod folders, dot-prefixed files are now ignored (thanks to Nuztalgia!).
-  * On Linux, SMAPI now fixes many issues with case-sensitive mod paths automatically.
+This is a big update, but existing mods should all work fine. If the latest version of a mod breaks in SMAPI 3.14, please report it [on the SMAPI mod page](https://www.nexusmods.com/stardewvalley/mods/2400?tab=posts).
+
+* Improvements:
+  * SMAPI now ignores dot-prefixed files when searching for mod folders (thanks to Nuztalgia!).
+  * On Linux, SMAPI now fixes many case-sensitive mod path issues automatically.
   * On Linux/macOS, added `--use-current-shell` [command-line argument](technical/smapi.md#command-line-arguments) to avoid opening a separate terminal window.
-  * Dropped update checks for the unofficial 64-bit patcher (obsolete since SMAPI 3.12.6).
+  * Improved performance in some cases.
   * Improved translations. Thanks to ChulkyBow (updated Ukrainian)!
+  * Dropped update checks for the unofficial 64-bit patcher (obsolete since SMAPI 3.12.6).
 * Fixes:
   * Fixed some movie theater textures not translated when loaded through SMAPI (specifically assets with the `_international` suffix).
   * Fixed the warning text when a mod causes an asset load conflict with itself.
   * Fixed `--no-terminal` [command-line argument](technical/smapi.md#command-line-arguments) on Linux/macOS still opening a terminal window, even if nothing is logged to it (thanks to Ryhon0!).
   * Fixed `player_add` console command not handling journal scraps and secret notes correctly.
   * Fixed `set_farm_type` console command not updating warps.
-
-### For the web UI
-* Improved log parser UI (thanks to KhloeLeclair!):
-  * Added pagination for big logs.
-  * Added search box to filter the log.
-  * Added option to show/hide content packs in the mod list.
-  * Added jump links in the sidebar.
-  * The filter options now stick to the top of the screen when scrolling.
-  * Rewrote rendering to improve performance.
-* Updated the JSON validator/schema for Content Patcher 1.25.0.
-* Added `data-*` attributes to the log parser page for external tools.
-* Fixed JSON validator showing incorrect error for update keys without a subkey.
+* For the web UI:
+  * Improved log parser UI (thanks to KhloeLeclair!):
+    * Added pagination for big logs.
+    * Added search box to filter the log.
+    * Added option to show/hide content packs in the mod list.
+    * Added jump links in the sidebar.
+    * The filter options now stick to the top of the screen when scrolling.
+    * Rewrote rendering to improve performance.
 
 ### For mod authors
-This is a big release that includes the new APIs planned for SMAPI 4.0.0, alongside the old ones.
+This is a big release that includes the new features planned for SMAPI 4.0.0.
 
-For C# mod authors: SMAPI 4.0.0 will release _no sooner_ than August 2022 (and later if needed to
-update open-source mods). At that point it will **remove all deprecated APIs and break C# mods
-which haven't updated yet**. See [_Migrate to SMAPI 4.0_](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0)
-for help updating your mod code. (You can update now, there's no need to wait for 4.0.0.)
+For C# mod authors: your mods should still work fine in SMAPI 3.14.0. However you should review the [migration to SMAPI 4.0](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0) guide and update your mods when possible. Deprecated code will be removed when SMAPI 4.0.0 releases later this year (no sooner than August 2022), and break any mods which haven't updated by that time. You can update affected mods now, there's no need to wait for 4.0.0.
 
-For content pack authors: SMAPI 4.0.0 won't affect content packs. They should work fine as long as
+For content pack authors: SMAPI 3.14.0 and 4.0.0 don't affect content packs. They should work fine as long as
 the C# mod that loads them is updated.
 
 * Major changes:
   * Added [content events](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Content), which will replace `IAssetEditor` and `IAssetLoader` in SMAPI 4.0.0.  
     _These include new features not supported by the old API like load conflict resolution, edit priority, and content pack labels. They also support new cases like easily detecting when an asset has changed, and avoid data corruption issues in some edge cases._
   * Added [nullable reference type annotations](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Nullable_reference_type_annotations) for all APIs.
-  * Added `helper.GameContent` and `helper.ModContent`, which will replace `helper.Content` in SMAPI 4.0.0.
+  * Added [`helper.GameContent` and `helper.ModContent`](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Content_loading_API), which will replace `helper.Content` in SMAPI 4.0.0.
   * Improved [mod-provided API](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations#Mod-provided_APIs) proxying (thanks to Shockah!).  
-    _This adds support for proxied interfaces in return values or input arguments, proxied enums if their values match, generic methods, and more. This is an internal change, you don't need to do anything different in your mod code._
+    _This adds support for custom interfaces in return values or input arguments, custom enums if their values match, generic methods, and more. This is an internal change, you don't need to do anything different in your mod code._
   * Mod files loaded through SMAPI APIs (including `helper.Content.Load`) are now case-insensitive, even on Linux.
   * Enabled deprecation notices for all deprecated APIs. These will only be shown in `TRACE` logs for at least a month after SMAPI 3.14.0 releases.
 * Other improvements:
   * Added `IAssetDataForImage.ExtendMap` to resize maps in asset editors.
-  * Added [command-line arguments](technical/smapi.md#command-line-arguments) to toggle developer mode (thanks to Tondorian!).
-  * Added `IContentPack.ModContent` property.
-  * Added `Constants.ContentPath`.
-  * Added `IAssetName` fields to the info received by `IAssetEditor` and `IAssetLoader` methods.  
+  * Added `IContentPack.ModContent` property to manage content pack assets.
+  * Added `Constants.ContentPath` to get the full path to the game's `Content` folder.
+  * Added `IAssetName` fields to the info received by `IAssetEditor`, `IAssetLoader`, and content event methods.  
     _This adds methods for working with asset names, parsed locales, etc._
   * Added `helper.Content.ParseAssetName` to get an `IAssetName` for an arbitrary asset key.
+  * Added [command-line arguments](technical/smapi.md#command-line-arguments) to toggle developer mode (thanks to Tondorian!).
   * If an asset is loaded multiple times in the same tick, `IAssetLoader.CanLoad` and `IAssetEditor.CanEdit` are now cached unless invalidated by `helper.Content.InvalidateCache`.
   * The `ISemanticVersion` comparison methods (`CompareTo`, `IsBetween`, `IsNewerThan`, and `IsOlderThan`) now allow null values. A null version is always considered older than any non-null version per [best practices](https://docs.microsoft.com/en-us/dotnet/api/system.icomparable-1.compareto#remarks).
   * Deprecation notices now show a shorter stack trace in most cases, so it's clearer where the deprecated code is in the mod.
@@ -64,9 +62,13 @@ the C# mod that loads them is updated.
   * Fixed support for using locale codes from custom languages in asset names (e.g. `Data/Achievements.eo-EU`).
   * Fixed issue where suppressing `[Left|Right]Thumbstick[Down|Left]` keys would suppress the opposite direction instead.
   * Fixed null handling in various edge cases.
+* For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.25.0.
+  * Added `data-*` attributes to the log parser page for external tools.
+  * Fixed JSON validator showing incorrect error for update keys without a subkey.
 
 ### For SMAPI contributors
-* You no longer need a Nexus API key to launch the SMAPI web project locally.
+* You no longer need a Nexus API key to launch the `SMAPI.Web` project locally.
 
 ## 3.13.4
 Released 16 January 2022 for Stardew Valley 1.5.6 or later.
@@ -123,7 +125,7 @@ Released 30 November 2021 for Stardew Valley 1.5.5 or later.
   * Fixed installer failing on Windows when run from the game folder.
 
 ## 3.13.0
-Released 30 November 2021 for Stardew Valley 1.5.5 or later.
+Released 30 November 2021 for Stardew Valley 1.5.5 or later. See [release highlights](https://www.patreon.com/posts/59348226).
 
 * For players:
   * Updated for Stardew Valley 1.5.5.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index fa5f6d6f..38945c5d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.13.4",
+    "Version": "3.14.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.13.4"
+    "MinimumApiVersion": "3.14.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 11bc0b42..c082bf75 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.13.4",
+    "Version": "3.14.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.13.4"
+    "MinimumApiVersion": "3.14.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index c50cff14..28bffa98 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.13.4",
+    "Version": "3.14.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.13.4"
+    "MinimumApiVersion": "3.14.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index ddb08435..f5da286a 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.13.4";
+        internal static string RawApiVersion = "3.14.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 42bf82d870ab744f13197ad781b7529a959861e1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 1 May 2022 22:46:56 -0400
Subject: [PATCH 600/856] update compatibility list

---
 docs/release-notes.md                     | 4 ++++
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 9 +++++++++
 2 files changed, 13 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 499c1d9b..776d7a48 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Updated compatibility list.
+
 ## 3.14.0
 Released 01 May 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/65265507).
 
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 75a3f8c7..53c9db82 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -167,6 +167,15 @@
             "~ | StatusReasonPhrase": "split-screen mode was added in Stardew Valley 1.5"
         },
 
+        /*********
+        ** Broke in SMAPI 3.14.0
+        *********/
+        "Dynamic Game Assets": {
+            "ID": "spacechase0.DynamicGameAssets",
+            "~1.4.1 | Status": "AssumeBroken",
+            "~1.4.1 | StatusReasonDetails": "causes runtime errors fixed in Dynamic Game Assets 1.4.2"
+        },
+
         /*********
         ** Broke in SDV 1.5.5
         *********/

From c1342bd4cd6b75b24d11275bdd73ebf893f916ea Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 4 May 2022 20:35:08 -0400
Subject: [PATCH 601/856] disable case-insensitive paths by default pending
 performance rework

---
 docs/release-notes.md                         |  2 ++
 src/SMAPI.Installer/InteractiveInstaller.cs   |  4 +--
 src/SMAPI.Tests/Core/ModResolverTests.cs      | 21 +++++++------
 .../Framework/ModScanning/ModScanner.cs       | 18 ++++++-----
 src/SMAPI.Toolkit/ModToolkit.cs               | 10 +++---
 .../CaseInsensitivePathLookup.cs              | 17 ++++------
 .../Utilities/PathLookups/IFilePathLookup.cs  | 20 ++++++++++++
 .../PathLookups/MinimalPathLookup.cs          | 31 +++++++++++++++++++
 src/SMAPI/Framework/ContentCoordinator.cs     | 10 ++++--
 .../ContentManagers/ModContentManager.cs      | 13 ++++----
 src/SMAPI/Framework/ContentPack.cs            |  9 +++---
 .../Framework/ModHelpers/ModContentHelper.cs  | 18 +++++------
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 12 ++++---
 src/SMAPI/Framework/Models/SConfig.cs         | 12 +++++--
 src/SMAPI/Framework/SCore.cs                  | 25 ++++++++++-----
 src/SMAPI/SMAPI.config.json                   |  6 ++++
 16 files changed, 158 insertions(+), 70 deletions(-)
 rename src/SMAPI.Toolkit/Utilities/{ => PathLookups}/CaseInsensitivePathLookup.cs (85%)
 create mode 100644 src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs
 create mode 100644 src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 776d7a48..11cccee2 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,8 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Case-insensitive file paths (introduced in 3.14.0) are now disabled by default.  
+    _You can enable them via `smapi-internal/config.json` if needed. These will be re-enabled in a later version after reworking them to reduce performance impact._
   * Updated compatibility list.
 
 ## 3.14.0
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 5138173a..19cefd32 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -435,8 +435,8 @@ namespace StardewModdingApi.Installer
                     {
                         this.PrintDebug("Adding bundled mods...");
 
-                        ModFolder[] targetMods = toolkit.GetModFolders(paths.ModsPath).ToArray();
-                        foreach (ModFolder sourceMod in toolkit.GetModFolders(bundledModsDir.FullName))
+                        ModFolder[] targetMods = toolkit.GetModFolders(paths.ModsPath, useCaseInsensitiveFilePaths: true).ToArray();
+                        foreach (ModFolder sourceMod in toolkit.GetModFolders(bundledModsDir.FullName, useCaseInsensitiveFilePaths: true))
                         {
                             // validate source mod
                             if (sourceMod.Manifest == null)
diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index 6b2746f5..3dfc9461 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -12,6 +12,7 @@ using StardewModdingAPI.Toolkit;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Toolkit.Serialization.Models;
+using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 using SemanticVersion = StardewModdingAPI.SemanticVersion;
 
 namespace SMAPI.Tests.Core
@@ -34,7 +35,7 @@ namespace SMAPI.Tests.Core
             Directory.CreateDirectory(rootFolder);
 
             // act
-            IModMetadata[] mods = new ModResolver().ReadManifests(new ModToolkit(), rootFolder, new ModDatabase()).ToArray();
+            IModMetadata[] mods = new ModResolver().ReadManifests(new ModToolkit(), rootFolder, new ModDatabase(), useCaseInsensitiveFilePaths: true).ToArray();
 
             // assert
             Assert.AreEqual(0, mods.Length, 0, $"Expected to find zero manifests, found {mods.Length} instead.");
@@ -52,7 +53,7 @@ namespace SMAPI.Tests.Core
             Directory.CreateDirectory(modFolder);
 
             // act
-            IModMetadata[] mods = new ModResolver().ReadManifests(new ModToolkit(), rootFolder, new ModDatabase()).ToArray();
+            IModMetadata[] mods = new ModResolver().ReadManifests(new ModToolkit(), rootFolder, new ModDatabase(), useCaseInsensitiveFilePaths: true).ToArray();
             IModMetadata? mod = mods.FirstOrDefault();
 
             // assert
@@ -94,7 +95,7 @@ namespace SMAPI.Tests.Core
             File.WriteAllText(filename, JsonConvert.SerializeObject(original));
 
             // act
-            IModMetadata[] mods = new ModResolver().ReadManifests(new ModToolkit(), rootFolder, new ModDatabase()).ToArray();
+            IModMetadata[] mods = new ModResolver().ReadManifests(new ModToolkit(), rootFolder, new ModDatabase(), useCaseInsensitiveFilePaths: true).ToArray();
             IModMetadata? mod = mods.FirstOrDefault();
 
             // assert
@@ -132,7 +133,7 @@ namespace SMAPI.Tests.Core
         [Test(Description = "Assert that validation doesn't fail if there are no mods installed.")]
         public void ValidateManifests_NoMods_DoesNothing()
         {
-            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
+            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
         }
 
         [Test(Description = "Assert that validation skips manifests that have already failed without calling any other properties.")]
@@ -143,7 +144,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.Status).Returns(ModMetadataStatus.Failed);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
 
             // assert
             mock.VerifyGet(p => p.Status, Times.Once, "The validation did not check the manifest status.");
@@ -160,7 +161,7 @@ namespace SMAPI.Tests.Core
             });
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -174,7 +175,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.Manifest).Returns(this.GetManifest(minimumApiVersion: "1.1"));
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -189,7 +190,7 @@ namespace SMAPI.Tests.Core
             Directory.CreateDirectory(directoryPath);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -206,7 +207,7 @@ namespace SMAPI.Tests.Core
             Mock<IModMetadata> modB = this.GetMetadata(this.GetManifest(id: "Mod A", name: "Mod B", version: "1.0"), allowStatusChange: true);
 
             // act
-            new ModResolver().ValidateManifests(new[] { modA.Object, modB.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, validateFilesExist: false);
+            new ModResolver().ValidateManifests(new[] { modA.Object, modB.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
 
             // assert
             modA.Verify(p => p.SetStatus(ModMetadataStatus.Failed, ModFailReason.Duplicate, It.IsAny<string>(), It.IsAny<string>()), Times.AtLeastOnce, "The validation did not fail the first mod with a unique ID.");
@@ -232,7 +233,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.DirectoryPath).Returns(modFolder);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance);
 
             // assert
             // if Moq doesn't throw a method-not-setup exception, the validation didn't override the status.
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index 24485620..aa4c3338 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -5,7 +5,7 @@ using System.Linq;
 using System.Text.RegularExpressions;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Serialization.Models;
-using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 
 namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 {
@@ -95,19 +95,20 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 
         /// <summary>Extract information about all mods in the given folder.</summary>
         /// <param name="rootPath">The root folder containing mods.</param>
-        public IEnumerable<ModFolder> GetModFolders(string rootPath)
+        /// <param name="useCaseInsensitiveFilePaths">Whether to match file paths case-insensitively, even on Linux.</param>
+        public IEnumerable<ModFolder> GetModFolders(string rootPath, bool useCaseInsensitiveFilePaths)
         {
             DirectoryInfo root = new(rootPath);
-            return this.GetModFolders(root, root);
+            return this.GetModFolders(root, root, useCaseInsensitiveFilePaths);
         }
 
         /// <summary>Extract information about all mods in the given folder.</summary>
         /// <param name="rootPath">The root folder containing mods. Only the <paramref name="modPath"/> will be searched, but this field allows it to be treated as a potential mod folder of its own.</param>
         /// <param name="modPath">The mod path to search.</param>
-        // /// <param name="tryConsolidateMod">If the folder contains multiple XNB mods, treat them as subfolders of a single mod. This is useful when reading a single mod archive, as opposed to a mods folder.</param>
-        public IEnumerable<ModFolder> GetModFolders(string rootPath, string modPath)
+        /// <param name="useCaseInsensitiveFilePaths">Whether to match file paths case-insensitively, even on Linux.</param>
+        public IEnumerable<ModFolder> GetModFolders(string rootPath, string modPath, bool useCaseInsensitiveFilePaths)
         {
-            return this.GetModFolders(root: new DirectoryInfo(rootPath), folder: new DirectoryInfo(modPath));
+            return this.GetModFolders(root: new DirectoryInfo(rootPath), folder: new DirectoryInfo(modPath), useCaseInsensitiveFilePaths: useCaseInsensitiveFilePaths);
         }
 
         /// <summary>Extract information from a mod folder.</summary>
@@ -195,7 +196,8 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         /// <summary>Recursively extract information about all mods in the given folder.</summary>
         /// <param name="root">The root mod folder.</param>
         /// <param name="folder">The folder to search for mods.</param>
-        private IEnumerable<ModFolder> GetModFolders(DirectoryInfo root, DirectoryInfo folder)
+        /// <param name="useCaseInsensitiveFilePaths">Whether to match file paths case-insensitively, even on Linux.</param>
+        private IEnumerable<ModFolder> GetModFolders(DirectoryInfo root, DirectoryInfo folder, bool useCaseInsensitiveFilePaths)
         {
             bool isRoot = folder.FullName == root.FullName;
 
@@ -214,7 +216,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             // find mods in subfolders
             if (this.IsModSearchFolder(root, folder))
             {
-                IEnumerable<ModFolder> subfolders = folder.EnumerateDirectories().SelectMany(sub => this.GetModFolders(root, sub));
+                IEnumerable<ModFolder> subfolders = folder.EnumerateDirectories().SelectMany(sub => this.GetModFolders(root, sub, useCaseInsensitiveFilePaths));
                 if (!isRoot)
                     subfolders = this.TryConsolidate(root, folder, subfolders.ToArray());
                 foreach (ModFolder subfolder in subfolders)
diff --git a/src/SMAPI.Toolkit/ModToolkit.cs b/src/SMAPI.Toolkit/ModToolkit.cs
index 51f6fa24..ce14b057 100644
--- a/src/SMAPI.Toolkit/ModToolkit.cs
+++ b/src/SMAPI.Toolkit/ModToolkit.cs
@@ -72,17 +72,19 @@ namespace StardewModdingAPI.Toolkit
 
         /// <summary>Extract information about all mods in the given folder.</summary>
         /// <param name="rootPath">The root folder containing mods.</param>
-        public IEnumerable<ModFolder> GetModFolders(string rootPath)
+        /// <param name="useCaseInsensitiveFilePaths">Whether to match file paths case-insensitively, even on Linux.</param>
+        public IEnumerable<ModFolder> GetModFolders(string rootPath, bool useCaseInsensitiveFilePaths)
         {
-            return new ModScanner(this.JsonHelper).GetModFolders(rootPath);
+            return new ModScanner(this.JsonHelper).GetModFolders(rootPath, useCaseInsensitiveFilePaths);
         }
 
         /// <summary>Extract information about all mods in the given folder.</summary>
         /// <param name="rootPath">The root folder containing mods. Only the <paramref name="modPath"/> will be searched, but this field allows it to be treated as a potential mod folder of its own.</param>
         /// <param name="modPath">The mod path to search.</param>
-        public IEnumerable<ModFolder> GetModFolders(string rootPath, string modPath)
+        /// <param name="useCaseInsensitiveFilePaths">Whether to match file paths case-insensitively, even on Linux.</param>
+        public IEnumerable<ModFolder> GetModFolders(string rootPath, string modPath, bool useCaseInsensitiveFilePaths)
         {
-            return new ModScanner(this.JsonHelper).GetModFolders(rootPath, modPath);
+            return new ModScanner(this.JsonHelper).GetModFolders(rootPath, modPath, useCaseInsensitiveFilePaths);
         }
 
         /// <summary>Get an update URL for an update key (if valid).</summary>
diff --git a/src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs
similarity index 85%
rename from src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs
rename to src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs
index 12fad008..9cc00737 100644
--- a/src/SMAPI.Toolkit/Utilities/CaseInsensitivePathLookup.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs
@@ -2,10 +2,10 @@ using System;
 using System.Collections.Generic;
 using System.IO;
 
-namespace StardewModdingAPI.Toolkit.Utilities
+namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
 {
-    /// <summary>Provides an API for case-insensitive relative path lookups within a root directory.</summary>
-    internal class CaseInsensitivePathLookup
+    /// <summary>An API for case-insensitive relative path lookups within a root directory.</summary>
+    internal class CaseInsensitivePathLookup : IFilePathLookup
     {
         /*********
         ** Fields
@@ -32,24 +32,19 @@ namespace StardewModdingAPI.Toolkit.Utilities
             this.RelativePathCache = new(() => this.GetRelativePathCache(searchOption));
         }
 
-        /// <summary>Get the exact capitalization for a given relative file path.</summary>
-        /// <param name="relativePath">The relative path.</param>
-        /// <remarks>Returns the resolved path in file path format, else the normalized <paramref name="relativePath"/>.</remarks>
+        /// <inheritdoc />
         public string GetFilePath(string relativePath)
         {
             return this.GetImpl(PathUtilities.NormalizePath(relativePath));
         }
 
-        /// <summary>Get the exact capitalization for a given asset name.</summary>
-        /// <param name="relativePath">The relative path.</param>
-        /// <remarks>Returns the resolved path in asset name format, else the normalized <paramref name="relativePath"/>.</remarks>
+        /// <inheritdoc />
         public string GetAssetName(string relativePath)
         {
             return this.GetImpl(PathUtilities.NormalizeAssetName(relativePath));
         }
 
-        /// <summary>Add a relative path that was just created by a SMAPI API.</summary>
-        /// <param name="relativePath">The relative path. This must already be normalized in asset name or file path format.</param>
+        /// <inheritdoc />
         public void Add(string relativePath)
         {
             // skip if cache isn't created yet (no need to add files manually in that case)
diff --git a/src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs
new file mode 100644
index 00000000..678e1383
--- /dev/null
+++ b/src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs
@@ -0,0 +1,20 @@
+namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
+{
+    /// <summary>An API for relative path lookups within a root directory.</summary>
+    internal interface IFilePathLookup
+    {
+        /// <summary>Get the actual path for a given relative file path.</summary>
+        /// <param name="relativePath">The relative path.</param>
+        /// <remarks>Returns the resolved path in file path format, else the normalized <paramref name="relativePath"/>.</remarks>
+        string GetFilePath(string relativePath);
+
+        /// <summary>Get the actual path for a given asset name.</summary>
+        /// <param name="relativePath">The relative path.</param>
+        /// <remarks>Returns the resolved path in asset name format, else the normalized <paramref name="relativePath"/>.</remarks>
+        string GetAssetName(string relativePath);
+
+        /// <summary>Add a relative path that was just created by a SMAPI API.</summary>
+        /// <param name="relativePath">The relative path. This must already be normalized in asset name or file path format.</param>
+        void Add(string relativePath);
+    }
+}
diff --git a/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs
new file mode 100644
index 00000000..2cf14704
--- /dev/null
+++ b/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs
@@ -0,0 +1,31 @@
+namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
+{
+    /// <summary>An API for relative path lookups within a root directory with minimal preprocessing.</summary>
+    internal class MinimalPathLookup : IFilePathLookup
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>A singleton instance for reuse.</summary>
+        public static readonly MinimalPathLookup Instance = new();
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <inheritdoc />
+        public string GetFilePath(string relativePath)
+        {
+            return PathUtilities.NormalizePath(relativePath);
+        }
+
+        /// <inheritdoc />
+        public string GetAssetName(string relativePath)
+        {
+            return PathUtilities.NormalizeAssetName(relativePath);
+        }
+
+        /// <inheritdoc />
+        public void Add(string relativePath) { }
+    }
+}
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 84fff250..1a82d194 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -16,6 +16,7 @@ using StardewModdingAPI.Internal;
 using StardewModdingAPI.Metadata;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 using StardewValley;
 using StardewValley.GameData;
 using xTile;
@@ -34,6 +35,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>Whether to enable more aggressive memory optimizations.</summary>
         private readonly bool AggressiveMemoryOptimizations;
 
+        /// <summary>Get a file path lookup for the given directory.</summary>
+        private readonly Func<string, IFilePathLookup> GetFilePathLookup;
+
         /// <summary>Encapsulates monitoring and logging.</summary>
         private readonly IMonitor Monitor;
 
@@ -115,11 +119,13 @@ namespace StardewModdingAPI.Framework
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
         /// <param name="onAssetLoaded">A callback to invoke when an asset is fully loaded.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
+        /// <param name="getFilePathLookup">Get a file path lookup for the given directory.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations, Func<string, IFilePathLookup> getFilePathLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
         {
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
+            this.GetFilePathLookup = getFilePathLookup;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.Reflection = reflection;
             this.JsonHelper = jsonHelper;
@@ -208,7 +214,7 @@ namespace StardewModdingAPI.Framework
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
                     aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations,
-                    relativePathCache: CaseInsensitivePathLookup.GetCachedFor(rootDirectory)
+                    relativePathLookup: this.GetFilePathLookup(rootDirectory)
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 8f64c5a8..91de769f 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -10,6 +10,7 @@ using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 using StardewValley;
 using xTile;
 using xTile.Format;
@@ -32,8 +33,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>The game content manager used for map tilesheets not provided by the mod.</summary>
         private readonly IContentManager GameContentManager;
 
-        /// <summary>A case-insensitive lookup of relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
-        private readonly CaseInsensitivePathLookup RelativePathCache;
+        /// <summary>A lookup for relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
+        private readonly IFilePathLookup RelativePathLookup;
 
         /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
         private readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
@@ -55,12 +56,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="rootDirectory"/>.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, bool aggressiveMemoryOptimizations, CaseInsensitivePathLookup relativePathCache)
+        /// <param name="relativePathLookup">A lookup for relative paths within the <paramref name="rootDirectory"/>.</param>
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, bool aggressiveMemoryOptimizations, IFilePathLookup relativePathLookup)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true, aggressiveMemoryOptimizations: aggressiveMemoryOptimizations)
         {
             this.GameContentManager = gameContentManager;
-            this.RelativePathCache = relativePathCache;
+            this.RelativePathLookup = relativePathLookup;
             this.JsonHelper = jsonHelper;
             this.ModName = modName;
 
@@ -257,7 +258,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private FileInfo GetModFile(string path)
         {
             // map to case-insensitive path if needed
-            path = this.RelativePathCache.GetFilePath(path);
+            path = this.RelativePathLookup.GetFilePath(path);
 
             // try exact match
             FileInfo file = new(Path.Combine(this.FullRootDirectory, path));
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index dde33c95..9503a0e6 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -3,6 +3,7 @@ using System.IO;
 using StardewModdingAPI.Framework.ModHelpers;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 
 namespace StardewModdingAPI.Framework
 {
@@ -15,8 +16,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>Encapsulates SMAPI's JSON file parsing.</summary>
         private readonly JsonHelper JsonHelper;
 
-        /// <summary>A case-insensitive lookup of relative paths within the <see cref="DirectoryPath"/>.</summary>
-        private readonly CaseInsensitivePathLookup RelativePathCache;
+        /// <summary>A lookup for relative paths within the <see cref="DirectoryPath"/>.</summary>
+        private readonly IFilePathLookup RelativePathCache;
 
 
         /*********
@@ -47,8 +48,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="content">Provides an API for loading content assets from the content pack's folder.</param>
         /// <param name="translation">Provides translations stored in the content pack's <c>i18n</c> folder.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
-        /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="directoryPath"/>.</param>
-        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper, CaseInsensitivePathLookup relativePathCache)
+        /// <param name="relativePathCache">A lookup for relative paths within the <paramref name="directoryPath"/>.</param>
+        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper, IFilePathLookup relativePathCache)
         {
             this.DirectoryPath = directoryPath;
             this.Manifest = manifest;
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index def0b728..74ea73de 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -4,7 +4,7 @@ using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
-using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 
 namespace StardewModdingAPI.Framework.ModHelpers
 {
@@ -23,8 +23,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>The friendly mod name for use in errors.</summary>
         private readonly string ModName;
 
-        /// <summary>A case-insensitive lookup of relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
-        private readonly CaseInsensitivePathLookup RelativePathCache;
+        /// <summary>A lookup for relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
+        private readonly IFilePathLookup RelativePathLookup;
 
         /// <summary>Simplifies access to private code.</summary>
         private readonly Reflector Reflection;
@@ -39,9 +39,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="mod">The mod using this instance.</param>
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="gameContentManager">The game content manager used for map tilesheets not provided by the mod.</param>
-        /// <param name="relativePathCache">A case-insensitive lookup of relative paths within the <paramref name="relativePathCache"/>.</param>
+        /// <param name="relativePathLookup">A lookup for relative paths within the <paramref name="relativePathLookup"/>.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IContentManager gameContentManager, CaseInsensitivePathLookup relativePathCache, Reflector reflection)
+        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IContentManager gameContentManager, IFilePathLookup relativePathLookup, Reflector reflection)
             : base(mod)
         {
             string managedAssetPrefix = contentCore.GetManagedAssetPrefix(mod.Manifest.UniqueID);
@@ -49,7 +49,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.ContentCore = contentCore;
             this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, modName, modFolderPath, gameContentManager);
             this.ModName = modName;
-            this.RelativePathCache = relativePathCache;
+            this.RelativePathLookup = relativePathLookup;
             this.Reflection = reflection;
         }
 
@@ -57,7 +57,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public T Load<T>(string relativePath)
             where T : notnull
         {
-            relativePath = this.RelativePathCache.GetAssetName(relativePath);
+            relativePath = this.RelativePathLookup.GetAssetName(relativePath);
 
             IAssetName assetName = this.ContentCore.ParseAssetName(relativePath, allowLocales: false);
 
@@ -74,7 +74,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <inheritdoc />
         public IAssetName GetInternalAssetName(string relativePath)
         {
-            relativePath = this.RelativePathCache.GetAssetName(relativePath);
+            relativePath = this.RelativePathLookup.GetAssetName(relativePath);
             return this.ModContentManager.GetInternalAssetKey(relativePath);
         }
 
@@ -86,7 +86,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
 
             relativePath = relativePath != null
-                ? this.RelativePathCache.GetAssetName(relativePath)
+                ? this.RelativePathLookup.GetAssetName(relativePath)
                 : $"temp/{Guid.NewGuid():N}";
 
             return new AssetDataForObject(
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 74e7cb32..1b1fa04e 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -9,6 +9,7 @@ using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Toolkit.Serialization.Models;
 using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 
 namespace StardewModdingAPI.Framework.ModLoading
 {
@@ -22,10 +23,11 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="toolkit">The mod toolkit.</param>
         /// <param name="rootPath">The root path to search for mods.</param>
         /// <param name="modDatabase">Handles access to SMAPI's internal mod metadata list.</param>
+        /// <param name="useCaseInsensitiveFilePaths">Whether to match file paths case-insensitively, even on Linux.</param>
         /// <returns>Returns the manifests by relative folder.</returns>
-        public IEnumerable<IModMetadata> ReadManifests(ModToolkit toolkit, string rootPath, ModDatabase modDatabase)
+        public IEnumerable<IModMetadata> ReadManifests(ModToolkit toolkit, string rootPath, ModDatabase modDatabase, bool useCaseInsensitiveFilePaths)
         {
-            foreach (ModFolder folder in toolkit.GetModFolders(rootPath))
+            foreach (ModFolder folder in toolkit.GetModFolders(rootPath, useCaseInsensitiveFilePaths))
             {
                 Manifest? manifest = folder.Manifest;
 
@@ -56,10 +58,11 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="mods">The mod manifests to validate.</param>
         /// <param name="apiVersion">The current SMAPI version.</param>
         /// <param name="getUpdateUrl">Get an update URL for an update key (if valid).</param>
+        /// <param name="getFilePathLookup">Get a file path lookup for the given directory.</param>
         /// <param name="validateFilesExist">Whether to validate that files referenced in the manifest (like <see cref="IManifest.EntryDll"/>) exist on disk. This can be disabled to only validate the manifest itself.</param>
         [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "Manifest values may be null before they're validated.")]
         [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "Manifest values may be null before they're validated.")]
-        public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string?> getUpdateUrl, bool validateFilesExist = true)
+        public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string?> getUpdateUrl, Func<string, IFilePathLookup> getFilePathLookup, bool validateFilesExist = true)
         {
             mods = mods.ToArray();
 
@@ -144,7 +147,8 @@ namespace StardewModdingAPI.Framework.ModLoading
                         // file doesn't exist
                         if (validateFilesExist)
                         {
-                            string fileName = CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath).GetFilePath(mod.Manifest.EntryDll!);
+                            IFilePathLookup pathLookup = getFilePathLookup(mod.DirectoryPath);
+                            string fileName = pathLookup.GetFilePath(mod.Manifest.EntryDll!);
                             if (!File.Exists(Path.Combine(mod.DirectoryPath, fileName)))
                             {
                                 mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 1a43c1fc..b4184abb 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -23,7 +23,8 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
             [nameof(AggressiveMemoryOptimizations)] = false,
-            [nameof(UsePintail)] = true
+            [nameof(UsePintail)] = true,
+            [nameof(UseCaseInsensitivePaths)] = false
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
@@ -68,6 +69,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</summary>
         public bool UsePintail { get; }
 
+        /// <summary>Whether to make SMAPI file APIs case-insensitive, even on Linux.</summary>
+        public bool UseCaseInsensitivePaths { get; }
+
         /// <summary>Whether SMAPI should log network traffic. Best combined with <see cref="VerboseLogging"/>, which includes network metadata.</summary>
         public bool LogNetworkTraffic { get; }
 
@@ -92,10 +96,11 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
         /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
         /// <param name="usePintail">Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</param>
+        /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool verboseLogging, bool? rewriteMods, bool? aggressiveMemoryOptimizations, bool usePintail, bool logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool verboseLogging, bool? rewriteMods, bool? aggressiveMemoryOptimizations, bool? usePintail, bool? useCaseInsensitivePaths, bool logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates;
@@ -106,7 +111,8 @@ namespace StardewModdingAPI.Framework.Models
             this.VerboseLogging = verboseLogging;
             this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
             this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations ?? (bool)SConfig.DefaultValues[nameof(SConfig.AggressiveMemoryOptimizations)];
-            this.UsePintail = usePintail;
+            this.UsePintail = usePintail ?? (bool)SConfig.DefaultValues[nameof(SConfig.UsePintail)];
+            this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(SConfig.UseCaseInsensitivePaths)];
             this.LogNetworkTraffic = logNetworkTraffic;
             this.ConsoleColors = consoleColors;
             this.SuppressUpdateChecks = suppressUpdateChecks ?? Array.Empty<string>();
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index e64318a5..50765083 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -43,6 +43,7 @@ using StardewModdingAPI.Toolkit.Framework.Clients.WebApi;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.Menus;
@@ -396,7 +397,7 @@ namespace StardewModdingAPI.Framework
                 }
 
                 // load manifests
-                IModMetadata[] mods = resolver.ReadManifests(toolkit, this.ModsPath, modDatabase).ToArray();
+                IModMetadata[] mods = resolver.ReadManifests(toolkit, this.ModsPath, modDatabase, useCaseInsensitiveFilePaths: this.Settings.UseCaseInsensitivePaths).ToArray();
 
                 // filter out ignored mods
                 foreach (IModMetadata mod in mods.Where(p => p.IsIgnored))
@@ -404,7 +405,7 @@ namespace StardewModdingAPI.Framework
                 mods = mods.Where(p => !p.IsIgnored).ToArray();
 
                 // load mods
-                resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl);
+                resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl, getFilePathLookup: this.GetFilePathLookup);
                 mods = resolver.ProcessDependencies(mods, modDatabase).ToArray();
                 this.LoadMods(mods, this.Toolkit.JsonHelper, this.ContentCore, modDatabase);
 
@@ -1253,6 +1254,7 @@ namespace StardewModdingAPI.Framework
                     onAssetLoaded: this.OnAssetLoaded,
                     onAssetsInvalidated: this.OnAssetsInvalidated,
                     aggressiveMemoryOptimizations: this.Settings.AggressiveMemoryOptimizations,
+                    getFilePathLookup: this.GetFilePathLookup,
                     requestAssetOperations: this.RequestAssetOperations
                 );
                 if (this.ContentCore.Language != this.Translator.LocaleEnum)
@@ -1753,7 +1755,7 @@ namespace StardewModdingAPI.Framework
             if (mod.IsContentPack)
             {
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
-                CaseInsensitivePathLookup relativePathCache = CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath);
+                IFilePathLookup relativePathCache = this.GetFilePathLookup(mod.DirectoryPath);
                 GameContentHelper gameContentHelper = new(this.ContentCore, mod, mod.DisplayName, monitor, this.Reflection);
                 IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
                 TranslationHelper translationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
@@ -1772,7 +1774,7 @@ namespace StardewModdingAPI.Framework
                 // get mod info
                 string assemblyPath = Path.Combine(
                     mod.DirectoryPath,
-                    CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath).GetFilePath(manifest.EntryDll!)
+                    this.GetFilePathLookup(mod.DirectoryPath).GetFilePath(manifest.EntryDll!)
                 );
 
                 // load mod
@@ -1838,7 +1840,7 @@ namespace StardewModdingAPI.Framework
                         {
                             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
 
-                            CaseInsensitivePathLookup relativePathCache = CaseInsensitivePathLookup.GetCachedFor(packDirPath);
+                            IFilePathLookup relativePathCache = this.GetFilePathLookup(packDirPath);
 
                             GameContentHelper gameContentHelper = new(contentCore, mod, packManifest.Name, packMonitor, this.Reflection);
                             IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, mod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
@@ -1852,12 +1854,12 @@ namespace StardewModdingAPI.Framework
 
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
-                        CaseInsensitivePathLookup relativePathCache = CaseInsensitivePathLookup.GetCachedFor(mod.DirectoryPath);
+                        IFilePathLookup relativePathLookup = this.GetFilePathLookup(mod.DirectoryPath);
 #pragma warning disable CS0612 // deprecated code
                         ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, mod, monitor, this.Reflection);
 #pragma warning restore CS0612
                         GameContentHelper gameContentHelper = new(contentCore, mod, mod.DisplayName, monitor, this.Reflection);
-                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
+                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathLookup, this.Reflection);
                         IContentPackHelper contentPackHelper = new ContentPackHelper(mod, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
                         IDataHelper dataHelper = new DataHelper(mod, mod.DirectoryPath, jsonHelper);
                         IReflectionHelper reflectionHelper = new ReflectionHelper(mod, mod.DisplayName, this.Reflection);
@@ -2035,6 +2037,15 @@ namespace StardewModdingAPI.Framework
             return translations;
         }
 
+        /// <summary>Get a file path lookup for the given directory.</summary>
+        /// <param name="rootDirectory">The root path to scan.</param>
+        private IFilePathLookup GetFilePathLookup(string rootDirectory)
+        {
+            return this.Settings.UseCaseInsensitivePaths
+                ? CaseInsensitivePathLookup.GetCachedFor(rootDirectory)
+                : MinimalPathLookup.Instance;
+        }
+
         /// <summary>Get the map display device which applies SMAPI features like tile rotation to loaded maps.</summary>
         /// <remarks>This is separate to let mods like PyTK wrap it with their own functionality.</remarks>
         private IDisplayDevice GetMapDisplayDevice()
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 065dfa8c..544aeaec 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -46,6 +46,12 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "AggressiveMemoryOptimizations": false,
 
+    /**
+     * Whether to make SMAPI file APIs case-insensitive, even on Linux.
+     * This is experimental, and the initial implementation may impact load times.
+     */
+    "UseCaseInsensitivePaths": false,
+
     /**
      * Whether to use the experimental Pintail API proxying library, instead of the original
      * proxying built into SMAPI itself.

From 295ad29b8d60fdbae0c0030e8d887a2adab779a3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 4 May 2022 21:02:41 -0400
Subject: [PATCH 602/856] remove aggressive memory optimizations option

---
 docs/release-notes.md                         |  6 ++-
 src/SMAPI/Framework/ContentCoordinator.cs     | 30 ++---------
 .../ContentManagers/BaseContentManager.cs     | 16 +-----
 .../ContentManagers/GameContentManager.cs     |  5 +-
 .../GameContentManagerForAssetPropagation.cs  |  4 +-
 .../ContentManagers/ModContentManager.cs      |  5 +-
 src/SMAPI/Framework/Models/SConfig.cs         |  8 +--
 src/SMAPI/Framework/SCore.cs                  |  1 -
 src/SMAPI/Metadata/CoreAssetPropagator.cs     | 51 ++++---------------
 src/SMAPI/SMAPI.config.json                   |  7 ---
 10 files changed, 27 insertions(+), 106 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 11cccee2..2fff0c58 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,8 +3,10 @@
 # Release notes
 ## Upcoming release
 * For players:
-  * Case-insensitive file paths (introduced in 3.14.0) are now disabled by default.  
-    _You can enable them via `smapi-internal/config.json` if needed. These will be re-enabled in a later version after reworking them to reduce performance impact._
+  * Disabled case-insensitive file paths (introduced in 3.14.0) by default.  
+    _You can enable them by editing `smapi-internal/config.json` if needed. They'll be re-enabled in a later version after they're reworked to reduce performance impact._
+  * Removed experimental 'aggressive memory optimizations' option.  
+    _This was disabled by default and is no longer needed in most cases. Memory usage will be better reduced by reworked asset propagation in the upcoming SMAPI 4.0.0._
   * Updated compatibility list.
 
 ## 3.14.0
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 1a82d194..ef442fbe 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -32,9 +32,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>An asset key prefix for assets from SMAPI mod folders.</summary>
         private readonly string ManagedPrefix = "SMAPI";
 
-        /// <summary>Whether to enable more aggressive memory optimizations.</summary>
-        private readonly bool AggressiveMemoryOptimizations;
-
         /// <summary>Get a file path lookup for the given directory.</summary>
         private readonly Func<string, IFilePathLookup> GetFilePathLookup;
 
@@ -118,13 +115,11 @@ namespace StardewModdingAPI.Framework
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
         /// <param name="onAssetLoaded">A callback to invoke when an asset is fully loaded.</param>
-        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
         /// <param name="getFilePathLookup">Get a file path lookup for the given directory.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations, Func<string, IFilePathLookup> getFilePathLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFilePathLookup> getFilePathLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
         {
-            this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
             this.GetFilePathLookup = getFilePathLookup;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.Reflection = reflection;
@@ -145,26 +140,11 @@ namespace StardewModdingAPI.Framework
                     reflection: reflection,
                     onDisposing: this.OnDisposing,
                     onLoadingFirstAsset: onLoadingFirstAsset,
-                    onAssetLoaded: onAssetLoaded,
-                    aggressiveMemoryOptimizations: aggressiveMemoryOptimizations
+                    onAssetLoaded: onAssetLoaded
                 )
             );
-            var contentManagerForAssetPropagation = new GameContentManagerForAssetPropagation(
-                name: nameof(GameContentManagerForAssetPropagation),
-                serviceProvider: serviceProvider,
-                rootDirectory: rootDirectory,
-                currentCulture: currentCulture,
-                coordinator: this,
-                monitor: monitor,
-                reflection: reflection,
-                onDisposing: this.OnDisposing,
-                onLoadingFirstAsset: onLoadingFirstAsset,
-                onAssetLoaded: onAssetLoaded,
-                aggressiveMemoryOptimizations: aggressiveMemoryOptimizations
-            );
-            this.ContentManagers.Add(contentManagerForAssetPropagation);
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
-            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, aggressiveMemoryOptimizations, name => this.ParseAssetName(name, allowLocales: true));
+            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, this.Monitor, reflection, name => this.ParseAssetName(name, allowLocales: true));
             this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(customLanguages: Enumerable.Empty<ModLanguage>()));
         }
 
@@ -184,8 +164,7 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     onDisposing: this.OnDisposing,
                     onLoadingFirstAsset: this.OnLoadingFirstAsset,
-                    onAssetLoaded: this.OnAssetLoaded,
-                    aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations
+                    onAssetLoaded: this.OnAssetLoaded
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
@@ -213,7 +192,6 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
-                    aggressiveMemoryOptimizations: this.AggressiveMemoryOptimizations,
                     relativePathLookup: this.GetFilePathLookup(rootDirectory)
                 );
                 this.ContentManagers.Add(manager);
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index b2e3ec0f..db2934a0 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -11,7 +11,6 @@ using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewValley;
-using xTile;
 
 namespace StardewModdingAPI.Framework.ContentManagers
 {
@@ -33,9 +32,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Simplifies access to private code.</summary>
         protected readonly Reflector Reflection;
 
-        /// <summary>Whether to enable more aggressive memory optimizations.</summary>
-        protected readonly bool AggressiveMemoryOptimizations;
-
         /// <summary>Whether to automatically try resolving keys to a localized form if available.</summary>
         protected bool TryLocalizeKeys = true;
 
@@ -82,8 +78,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="isNamespaced">Whether this content manager handles managed asset keys (e.g. to load assets from a mod folder).</param>
-        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        protected BaseContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, bool isNamespaced, bool aggressiveMemoryOptimizations)
+        protected BaseContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, bool isNamespaced)
             : base(serviceProvider, rootDirectory, currentCulture)
         {
             // init
@@ -95,7 +90,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
             this.Reflection = reflection;
             this.OnDisposing = onDisposing;
             this.IsNamespaced = isNamespaced;
-            this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
 
             // get asset data
             this.BaseDisposableReferences = reflection.GetField<List<IDisposable>?>(this, "disposableAssets").GetValue()
@@ -231,14 +225,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     removeAssets[baseAssetName] = asset;
                     remove = true;
                 }
-
-                // dispose if safe
-                if (remove && this.AggressiveMemoryOptimizations)
-                {
-                    if (asset is Map map)
-                        map.DisposeTileSheets(Game1.mapDisplayDevice);
-                }
-
                 return remove;
             }, dispose);
 
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 083df454..c53040e1 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -51,9 +51,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
         /// <param name="onAssetLoaded">A callback to invoke when an asset is fully loaded.</param>
-        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
-        public GameContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations)
-            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: false, aggressiveMemoryOptimizations: aggressiveMemoryOptimizations)
+        public GameContentManager(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded)
+            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: false)
         {
             this.OnLoadingFirstAsset = onLoadingFirstAsset;
             this.OnAssetLoaded = onAssetLoaded;
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
index 1b0e1016..5c574a1a 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManagerForAssetPropagation.cs
@@ -21,8 +21,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         ** Public methods
         *********/
         /// <inheritdoc />
-        public GameContentManagerForAssetPropagation(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, bool aggressiveMemoryOptimizations)
-            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, onLoadingFirstAsset, onAssetLoaded, aggressiveMemoryOptimizations) { }
+        public GameContentManagerForAssetPropagation(string name, IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, Action<BaseContentManager> onDisposing, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded)
+            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, onLoadingFirstAsset, onAssetLoaded) { }
 
         /// <inheritdoc />
         public override T LoadExact<T>(IAssetName assetName, bool useCache)
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 91de769f..65dffd8b 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -55,10 +55,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
-        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
         /// <param name="relativePathLookup">A lookup for relative paths within the <paramref name="rootDirectory"/>.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, bool aggressiveMemoryOptimizations, IFilePathLookup relativePathLookup)
-            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true, aggressiveMemoryOptimizations: aggressiveMemoryOptimizations)
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFilePathLookup relativePathLookup)
+            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
         {
             this.GameContentManager = gameContentManager;
             this.RelativePathLookup = relativePathLookup;
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index b4184abb..80d0d9ba 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -22,7 +22,6 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(VerboseLogging)] = false,
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
-            [nameof(AggressiveMemoryOptimizations)] = false,
             [nameof(UsePintail)] = true,
             [nameof(UseCaseInsensitivePaths)] = false
         };
@@ -63,9 +62,6 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether SMAPI should rewrite mods for compatibility.</summary>
         public bool RewriteMods { get; }
 
-        /// <summary>Whether to enable more aggressive memory optimizations.</summary>
-        public bool AggressiveMemoryOptimizations { get; }
-
         /// <summary>Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</summary>
         public bool UsePintail { get; }
 
@@ -94,13 +90,12 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="webApiBaseUrl">The base URL for SMAPI's web API, used to perform update checks.</param>
         /// <param name="verboseLogging">Whether SMAPI should log more information about the game context.</param>
         /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
-        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
         /// <param name="usePintail">Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</param>
         /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool verboseLogging, bool? rewriteMods, bool? aggressiveMemoryOptimizations, bool? usePintail, bool? useCaseInsensitivePaths, bool logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool verboseLogging, bool? rewriteMods, bool? usePintail, bool? useCaseInsensitivePaths, bool logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates;
@@ -110,7 +105,6 @@ namespace StardewModdingAPI.Framework.Models
             this.WebApiBaseUrl = webApiBaseUrl;
             this.VerboseLogging = verboseLogging;
             this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
-            this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations ?? (bool)SConfig.DefaultValues[nameof(SConfig.AggressiveMemoryOptimizations)];
             this.UsePintail = usePintail ?? (bool)SConfig.DefaultValues[nameof(SConfig.UsePintail)];
             this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(SConfig.UseCaseInsensitivePaths)];
             this.LogNetworkTraffic = logNetworkTraffic;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 50765083..a9296d9b 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1253,7 +1253,6 @@ namespace StardewModdingAPI.Framework
                     onLoadingFirstAsset: this.InitializeBeforeFirstAssetLoaded,
                     onAssetLoaded: this.OnAssetLoaded,
                     onAssetsInvalidated: this.OnAssetsInvalidated,
-                    aggressiveMemoryOptimizations: this.Settings.AggressiveMemoryOptimizations,
                     getFilePathLookup: this.GetFilePathLookup,
                     requestAssetOperations: this.RequestAssetOperations
                 );
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 5dee2c4d..12b73515 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -5,7 +5,6 @@ using System.IO;
 using System.Linq;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
-using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Internal;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -33,18 +32,12 @@ namespace StardewModdingAPI.Metadata
         /// <summary>The main content manager through which to reload assets.</summary>
         private readonly LocalizedContentManager MainContentManager;
 
-        /// <summary>An internal content manager used only for asset propagation. See remarks on <see cref="GameContentManagerForAssetPropagation"/>.</summary>
-        private readonly GameContentManagerForAssetPropagation DisposableContentManager;
-
         /// <summary>Writes messages to the console.</summary>
         private readonly IMonitor Monitor;
 
         /// <summary>Simplifies access to private game code.</summary>
         private readonly Reflector Reflection;
 
-        /// <summary>Whether to enable more aggressive memory optimizations.</summary>
-        private readonly bool AggressiveMemoryOptimizations;
-
         /// <summary>Parse a raw asset name.</summary>
         private readonly Func<string, IAssetName> ParseAssetName;
 
@@ -67,18 +60,14 @@ namespace StardewModdingAPI.Metadata
         *********/
         /// <summary>Initialize the core asset data.</summary>
         /// <param name="mainContent">The main content manager through which to reload assets.</param>
-        /// <param name="disposableContent">An internal content manager used only for asset propagation.</param>
         /// <param name="monitor">Writes messages to the console.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        /// <param name="aggressiveMemoryOptimizations">Whether to enable more aggressive memory optimizations.</param>
         /// <param name="parseAssetName">Parse a raw asset name.</param>
-        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, IMonitor monitor, Reflector reflection, bool aggressiveMemoryOptimizations, Func<string, IAssetName> parseAssetName)
+        public CoreAssetPropagator(LocalizedContentManager mainContent, IMonitor monitor, Reflector reflection, Func<string, IAssetName> parseAssetName)
         {
             this.MainContentManager = mainContent;
-            this.DisposableContentManager = disposableContent;
             this.Monitor = monitor;
             this.Reflection = reflection;
-            this.AggressiveMemoryOptimizations = aggressiveMemoryOptimizations;
             this.ParseAssetName = parseAssetName;
         }
 
@@ -230,7 +219,7 @@ namespace StardewModdingAPI.Metadata
                 ** Buildings
                 ****/
                 case "buildings/houses": // Farm
-                    Farm.houseTextures = this.LoadAndDisposeIfNeeded(Farm.houseTextures, key);
+                    Farm.houseTextures = this.LoadTexture(key);
                     return true;
 
                 case "buildings/houses_paintmask": // Farm
@@ -247,7 +236,7 @@ namespace StardewModdingAPI.Metadata
                 ** Content\Characters\Farmer
                 ****/
                 case "characters/farmer/accessories": // Game1.LoadContent
-                    FarmerRenderer.accessoriesTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.accessoriesTexture, key);
+                    FarmerRenderer.accessoriesTexture = this.LoadTexture(key);
                     return true;
 
                 case "characters/farmer/farmer_base": // Farmer
@@ -257,19 +246,19 @@ namespace StardewModdingAPI.Metadata
                     return !ignoreWorld && this.ReloadPlayerSprites(assetName);
 
                 case "characters/farmer/hairstyles": // Game1.LoadContent
-                    FarmerRenderer.hairStylesTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.hairStylesTexture, key);
+                    FarmerRenderer.hairStylesTexture = this.LoadTexture(key);
                     return true;
 
                 case "characters/farmer/hats": // Game1.LoadContent
-                    FarmerRenderer.hatsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.hatsTexture, key);
+                    FarmerRenderer.hatsTexture = this.LoadTexture(key);
                     return true;
 
                 case "characters/farmer/pants": // Game1.LoadContent
-                    FarmerRenderer.pantsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.pantsTexture, key);
+                    FarmerRenderer.pantsTexture = this.LoadTexture(key);
                     return true;
 
                 case "characters/farmer/shirts": // Game1.LoadContent
-                    FarmerRenderer.shirtsTexture = this.LoadAndDisposeIfNeeded(FarmerRenderer.shirtsTexture, key);
+                    FarmerRenderer.shirtsTexture = this.LoadTexture(key);
                     return true;
 
                 /****
@@ -905,9 +894,6 @@ namespace StardewModdingAPI.Metadata
             GameLocation location = locationInfo.Location;
             Vector2? playerPos = Game1.player?.Position;
 
-            if (this.AggressiveMemoryOptimizations)
-                location.map.DisposeTileSheets(Game1.mapDisplayDevice);
-
             // reload map
             location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist
             location.reloadMap();
@@ -973,7 +959,7 @@ namespace StardewModdingAPI.Metadata
             // update sprite
             foreach (var target in characters)
             {
-                target.Npc.Sprite.spriteTexture = this.LoadAndDisposeIfNeeded(target.Npc.Sprite.spriteTexture, target.AssetName.BaseName);
+                target.Npc.Sprite.spriteTexture = this.LoadTexture(target.AssetName.BaseName);
                 propagated[target.AssetName] = true;
             }
         }
@@ -1012,7 +998,7 @@ namespace StardewModdingAPI.Metadata
             // update portrait
             foreach (var target in characters)
             {
-                target.Npc.Portrait = this.LoadAndDisposeIfNeeded(target.Npc.Portrait, target.AssetName.BaseName);
+                target.Npc.Portrait = this.LoadTexture(target.AssetName.BaseName);
                 propagated[target.AssetName] = true;
             }
         }
@@ -1284,25 +1270,10 @@ namespace StardewModdingAPI.Metadata
                 : Array.Empty<string>();
         }
 
-        /// <summary>Load a texture, and dispose the old one if <see cref="AggressiveMemoryOptimizations"/> is enabled and it's different from the new instance.</summary>
-        /// <param name="oldTexture">The previous texture to dispose.</param>
+        /// <summary>Load a texture from the main content manager.</summary>
         /// <param name="key">The asset key to load.</param>
-        private Texture2D LoadAndDisposeIfNeeded(Texture2D? oldTexture, string key)
+        private Texture2D LoadTexture(string key)
         {
-            // if aggressive memory optimizations are enabled, load the asset from the disposable
-            // content manager and dispose the old instance if needed.
-            if (this.AggressiveMemoryOptimizations)
-            {
-                GameContentManagerForAssetPropagation content = this.DisposableContentManager;
-
-                Texture2D newTexture = content.Load<Texture2D>(key);
-                if (oldTexture?.IsDisposed == false && !object.ReferenceEquals(oldTexture, newTexture) && content.IsResponsibleFor(oldTexture))
-                    oldTexture.Dispose();
-
-                return newTexture;
-            }
-
-            // else just (re)load it from the main content manager
             return this.MainContentManager.Load<Texture2D>(key);
         }
 
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 544aeaec..bdd6374a 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -39,13 +39,6 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "RewriteMods": true,
 
-    /**
-     * Whether to enable more aggressive memory optimizations.
-     * If you get frequent 'OutOfMemoryException' errors, you can try enabling this to reduce their
-     * frequency. This may cause crashes for farmhands in multiplayer.
-     */
-    "AggressiveMemoryOptimizations": false,
-
     /**
      * Whether to make SMAPI file APIs case-insensitive, even on Linux.
      * This is experimental, and the initial implementation may impact load times.

From 87d5288287520f750651667839ebbe7bbeb97bba Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 6 May 2022 18:05:40 -0400
Subject: [PATCH 603/856] fix content managers' LoadBaseString not recognizing
 localized mod assets

---
 docs/release-notes.md                         |  1 +
 .../ContentManagers/BaseContentManager.cs     | 49 +++++++++++++++++++
 2 files changed, 50 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2fff0c58..99269bc6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,7 @@
     _You can enable them by editing `smapi-internal/config.json` if needed. They'll be re-enabled in a later version after they're reworked to reduce performance impact._
   * Removed experimental 'aggressive memory optimizations' option.  
     _This was disabled by default and is no longer needed in most cases. Memory usage will be better reduced by reworked asset propagation in the upcoming SMAPI 4.0.0._
+  * Fixed 'content file was not found' error when the game tries to load unlocalized text from a localizable mod data asset.
   * Updated compatibility list.
 
 ## 3.14.0
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index db2934a0..e4695588 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -110,6 +110,26 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return this.Load<T>(assetName, LanguageCode.en);
         }
 
+        /// <inheritdoc />
+        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "Copied as-is from game code")]
+        public sealed override string LoadBaseString(string path)
+        {
+            try
+            {
+                // copied as-is from LocalizedContentManager.LoadBaseString
+                // This is only changed to call this.Load instead of base.Load, to support mod assets
+                this.ParseStringPath(path, out string assetName, out string key);
+                Dictionary<string, string> strings = this.Load<Dictionary<string, string>>(assetName, LanguageCode.en);
+                return strings != null && strings.ContainsKey(key)
+                    ? this.GetString(strings, key)
+                    : path;
+            }
+            catch (Exception ex)
+            {
+                throw new InvalidOperationException($"Failed loading string path '{path}' from '{this.Name}'.", ex);
+            }
+        }
+
         /// <inheritdoc />
         public sealed override T Load<T>(string assetName)
         {
@@ -331,5 +351,34 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // avoid hard disposable references; see remarks on the field
             this.BaseDisposableReferences.Clear();
         }
+
+        /****
+        ** Private methods copied from the game code
+        ****/
+#pragma warning disable CS1574 // <see cref /> can't be resolved: the reference is valid but private
+        /// <summary>Parse a string path like <c>assetName:key</c>.</summary>
+        /// <param name="path">The string path.</param>
+        /// <param name="assetName">The extracted asset name.</param>
+        /// <param name="key">The extracted entry key.</param>
+        /// <exception cref="ContentLoadException">The string path is not in a valid format.</exception>
+        /// <remarks>This is copied as-is from <see cref="LocalizedContentManager.parseStringPath"/>.</remarks>
+        private void ParseStringPath(string path, out string assetName, out string key)
+        {
+            int length = path.IndexOf(':');
+            assetName = length != -1 ? path.Substring(0, length) : throw new ContentLoadException("Unable to parse string path: " + path);
+            key = path.Substring(length + 1, path.Length - length - 1);
+        }
+
+        /// <summary>Get a string value from a dictionary asset.</summary>
+        /// <param name="strings">The asset to read.</param>
+        /// <param name="key">The string key to find.</param>
+        /// <remarks>This is copied as-is from <see cref="LocalizedContentManager.GetString"/>.</remarks>
+        private string GetString(Dictionary<string, string> strings, string key)
+        {
+            return strings.TryGetValue(key + ".desktop", out string? str)
+                ? str
+                : strings[key];
+        }
+#pragma warning restore CS1574
     }
 }

From b834ed7ef5095203529f8b77aee3f25f5387fbcc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 6 May 2022 18:06:47 -0400
Subject: [PATCH 604/856] fix errors reading empty JSON files

---
 docs/release-notes.md                         |  1 +
 src/SMAPI.Toolkit/Serialization/JsonHelper.cs |  5 ++--
 src/SMAPI/Framework/SMultiplayer.cs           | 29 +++++++++++++++----
 3 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 99269bc6..a0d8826b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,7 @@
   * Removed experimental 'aggressive memory optimizations' option.  
     _This was disabled by default and is no longer needed in most cases. Memory usage will be better reduced by reworked asset propagation in the upcoming SMAPI 4.0.0._
   * Fixed 'content file was not found' error when the game tries to load unlocalized text from a localizable mod data asset.
+  * Fixed error reading empty JSON files. These are now treated as if they didn't exist like before 3.14.0.
   * Updated compatibility list.
 
 ## 3.14.0
diff --git a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
index 3c9308f2..1a003c51 100644
--- a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
+++ b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
@@ -108,12 +108,11 @@ namespace StardewModdingAPI.Toolkit.Serialization
         /// <summary>Deserialize JSON text if possible.</summary>
         /// <typeparam name="TModel">The model type.</typeparam>
         /// <param name="json">The raw JSON text.</param>
-        public TModel Deserialize<TModel>(string json)
+        public TModel? Deserialize<TModel>(string json)
         {
             try
             {
-                return JsonConvert.DeserializeObject<TModel>(json, this.JsonSettings)
-                    ?? throw new InvalidOperationException($"Couldn't deserialize model type '{typeof(TModel)}' from empty or null JSON.");
+                return JsonConvert.DeserializeObject<TModel>(json, this.JsonSettings);
             }
             catch (JsonReaderException)
             {
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index e41e7edc..2badcbbf 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -9,6 +9,7 @@ using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Events;
 using StardewModdingAPI.Framework.Networking;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Internal;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Utilities;
 using StardewValley;
@@ -489,8 +490,8 @@ namespace StardewModdingAPI.Framework
         private RemoteContextModel? ReadContext(BinaryReader reader)
         {
             string data = reader.ReadString();
-            RemoteContextModel model = this.JsonHelper.Deserialize<RemoteContextModel>(data);
-            return model.ApiVersion != null
+            RemoteContextModel? model = this.JsonHelper.Deserialize<RemoteContextModel>(data);
+            return model?.ApiVersion != null
                 ? model
                 : null; // no data available for vanilla players
         }
@@ -499,13 +500,31 @@ namespace StardewModdingAPI.Framework
         /// <param name="message">The raw message to parse.</param>
         private void ReceiveModMessage(IncomingMessage message)
         {
-            // parse message
+            // read message JSON
             string json = message.Reader.ReadString();
-            ModMessageModel model = this.JsonHelper.Deserialize<ModMessageModel>(json);
-            HashSet<long> playerIDs = new HashSet<long>(model.ToPlayerIDs ?? this.GetKnownPlayerIDs());
             if (this.LogNetworkTraffic)
                 this.Monitor.Log($"Received message: {json}.");
 
+            // deserialize model
+            ModMessageModel? model;
+            try
+            {
+                model = this.JsonHelper.Deserialize<ModMessageModel>(json);
+                if (model is null)
+                {
+                    this.Monitor.Log($"Received invalid mod message from {message.FarmerID}.\nRaw message data: {json}");
+                    return;
+                }
+            }
+            catch (Exception ex)
+            {
+                this.Monitor.Log($"Received invalid mod message from {message.FarmerID}.\nRaw message data: {json}\nError details: {ex.GetLogSummary()}");
+                return;
+            }
+
+            // get player IDs
+            HashSet<long> playerIDs = new HashSet<long>(model.ToPlayerIDs ?? this.GetKnownPlayerIDs());
+
             // notify local mods
             if (playerIDs.Contains(Game1.player.UniqueMultiplayerID))
                 this.OnModMessageReceived(model);

From a969828e9357306aaac5163c430e108ab57f578b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 6 May 2022 18:26:35 -0400
Subject: [PATCH 605/856] cache asset operation instances created legacy
 interceptors

---
 docs/release-notes.md                     |  3 +-
 src/SMAPI/Framework/ContentCoordinator.cs | 74 ++++++++++++++---------
 2 files changed, 48 insertions(+), 29 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a0d8826b..eb30ef7c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,8 +3,9 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Improved performance for many mods still using the older content API.
   * Disabled case-insensitive file paths (introduced in 3.14.0) by default.  
-    _You can enable them by editing `smapi-internal/config.json` if needed. They'll be re-enabled in a later version after they're reworked to reduce performance impact._
+    _You can enable them by editing `smapi-internal/config.json` if needed. They'll be re-enabled in an upcoming version after they're reworked a bit._
   * Removed experimental 'aggressive memory optimizations' option.  
     _This was disabled by default and is no longer needed in most cases. Memory usage will be better reduced by reworked asset propagation in the upcoming SMAPI 4.0.0._
   * Fixed 'content file was not found' error when the game tries to load unlocalized text from a localizable mod data asset.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index ef442fbe..8ce0dba1 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -81,6 +81,14 @@ namespace StardewModdingAPI.Framework
         /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
         private readonly TickCacheDictionary<IAssetName, AssetOperationGroup[]> AssetOperationsByKey = new();
 
+        /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetLoader"/> implementations.</summary>
+        [Obsolete]
+        private readonly Dictionary<IAssetLoader, AssetOperationGroup> LegacyLoaderCache = new(ReferenceEqualityComparer.Instance);
+
+        /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetEditor"/> implementations.</summary>
+        [Obsolete]
+        private readonly Dictionary<IAssetEditor, AssetOperationGroup> LegacyEditorCache = new(ReferenceEqualityComparer.Instance);
+
 
         /*********
         ** Accessors
@@ -598,21 +606,26 @@ namespace StardewModdingAPI.Framework
                 }
 
                 // add operation
-                yield return new AssetOperationGroup(
-                    mod: loader.Mod,
-                    loadOperations: new[]
-                    {
-                        new AssetLoadOperation(
-                            mod: loader.Mod,
-                            priority: AssetLoadPriority.Exclusive,
-                            onBehalfOf: null,
-                            getData: assetInfo => loader.Data.Load<T>(
-                                this.GetLegacyAssetInfo(assetInfo)
+                if (!this.LegacyLoaderCache.TryGetValue(loader.Data, out AssetOperationGroup? group))
+                {
+                    this.LegacyLoaderCache[loader.Data] = group = new AssetOperationGroup(
+                        mod: loader.Mod,
+                        loadOperations: new[]
+                        {
+                            new AssetLoadOperation(
+                                mod: loader.Mod,
+                                priority: AssetLoadPriority.Exclusive,
+                                onBehalfOf: null,
+                                getData: assetInfo => loader.Data.Load<T>(
+                                    this.GetLegacyAssetInfo(assetInfo)
+                                )
                             )
-                        )
-                    },
-                    editOperations: Array.Empty<AssetEditOperation>()
-                );
+                        },
+                        editOperations: Array.Empty<AssetEditOperation>()
+                    );
+                }
+
+                yield return group;
             }
 
             // legacy edit operations
@@ -652,21 +665,26 @@ namespace StardewModdingAPI.Framework
                 };
 
                 // add operation
-                yield return new AssetOperationGroup(
-                    mod: editor.Mod,
-                    loadOperations: Array.Empty<AssetLoadOperation>(),
-                    editOperations: new[]
-                    {
-                        new AssetEditOperation(
-                            mod: editor.Mod,
-                            priority: priority,
-                            onBehalfOf: null,
-                            applyEdit: assetData => editor.Data.Edit<T>(
-                                this.GetLegacyAssetData(assetData)
+                if (!this.LegacyEditorCache.TryGetValue(editor.Data, out AssetOperationGroup? group))
+                {
+                    this.LegacyEditorCache[editor.Data] = group = new AssetOperationGroup(
+                        mod: editor.Mod,
+                        loadOperations: Array.Empty<AssetLoadOperation>(),
+                        editOperations: new[]
+                        {
+                            new AssetEditOperation(
+                                mod: editor.Mod,
+                                priority: priority,
+                                onBehalfOf: null,
+                                applyEdit: assetData => editor.Data.Edit<T>(
+                                    this.GetLegacyAssetData(assetData)
+                                )
                             )
-                        )
-                    }
-                );
+                        }
+                    );
+                }
+
+                yield return group;
             }
 #pragma warning restore CS0612, CS0618
         }

From 09c52fb3f530bb450de5a7b4ba2ca09c1035b3cd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 6 May 2022 19:39:51 -0400
Subject: [PATCH 606/856] cache legacy asset operations by target type

---
 src/SMAPI/Framework/ContentCoordinator.cs | 50 +++++++++++++++--------
 1 file changed, 34 insertions(+), 16 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 8ce0dba1..4f52d57e 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -83,11 +83,11 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetLoader"/> implementations.</summary>
         [Obsolete]
-        private readonly Dictionary<IAssetLoader, AssetOperationGroup> LegacyLoaderCache = new(ReferenceEqualityComparer.Instance);
+        private readonly Dictionary<IAssetLoader, Dictionary<Type, AssetOperationGroup>> LegacyLoaderCache = new(ReferenceEqualityComparer.Instance);
 
         /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetEditor"/> implementations.</summary>
         [Obsolete]
-        private readonly Dictionary<IAssetEditor, AssetOperationGroup> LegacyEditorCache = new(ReferenceEqualityComparer.Instance);
+        private readonly Dictionary<IAssetEditor, Dictionary<Type, AssetOperationGroup>> LegacyEditorCache = new(ReferenceEqualityComparer.Instance);
 
 
         /*********
@@ -606,9 +606,11 @@ namespace StardewModdingAPI.Framework
                 }
 
                 // add operation
-                if (!this.LegacyLoaderCache.TryGetValue(loader.Data, out AssetOperationGroup? group))
-                {
-                    this.LegacyLoaderCache[loader.Data] = group = new AssetOperationGroup(
+                yield return this.GetOrCreateLegacyOperationGroup(
+                    cache: this.LegacyLoaderCache,
+                    editor: loader.Data,
+                    dataType: info.DataType,
+                    createGroup: () => new AssetOperationGroup(
                         mod: loader.Mod,
                         loadOperations: new[]
                         {
@@ -622,10 +624,8 @@ namespace StardewModdingAPI.Framework
                             )
                         },
                         editOperations: Array.Empty<AssetEditOperation>()
-                    );
-                }
-
-                yield return group;
+                    )
+                );
             }
 
             // legacy edit operations
@@ -665,9 +665,11 @@ namespace StardewModdingAPI.Framework
                 };
 
                 // add operation
-                if (!this.LegacyEditorCache.TryGetValue(editor.Data, out AssetOperationGroup? group))
-                {
-                    this.LegacyEditorCache[editor.Data] = group = new AssetOperationGroup(
+                yield return this.GetOrCreateLegacyOperationGroup(
+                    cache: this.LegacyEditorCache,
+                    editor: editor.Data,
+                    dataType: info.DataType,
+                    createGroup: () => new AssetOperationGroup(
                         mod: editor.Mod,
                         loadOperations: Array.Empty<AssetLoadOperation>(),
                         editOperations: new[]
@@ -681,14 +683,30 @@ namespace StardewModdingAPI.Framework
                                 )
                             )
                         }
-                    );
-                }
-
-                yield return group;
+                    )
+                );
             }
 #pragma warning restore CS0612, CS0618
         }
 
+        /// <summary>Get a cached asset operation group for a legacy <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> instance, creating it if needed.</summary>
+        /// <typeparam name="TInterceptor">The editor type (one of <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/>).</typeparam>
+        /// <param name="cache">The cached operation groups for the interceptor type.</param>
+        /// <param name="editor">The legacy asset interceptor.</param>
+        /// <param name="dataType">The asset data type.</param>
+        /// <param name="createGroup">Create the asset operation group if it's not cached yet.</param>
+        private AssetOperationGroup GetOrCreateLegacyOperationGroup<TInterceptor>(Dictionary<TInterceptor, Dictionary<Type, AssetOperationGroup>> cache, TInterceptor editor, Type dataType, Func<AssetOperationGroup> createGroup)
+            where TInterceptor : class
+        {
+            if (!cache.TryGetValue(editor, out Dictionary<Type, AssetOperationGroup>? cacheByType))
+                cache[editor] = cacheByType = new Dictionary<Type, AssetOperationGroup>();
+
+            if (!cacheByType.TryGetValue(dataType, out AssetOperationGroup? group))
+                cacheByType[dataType] = group = createGroup();
+
+            return group;
+        }
+
         /// <summary>Get an asset info compatible with legacy <see cref="IAssetLoader"/> and <see cref="IAssetEditor"/> instances, which always expect the base name.</summary>
         /// <param name="asset">The asset info.</param>
         private IAssetInfo GetLegacyAssetInfo(IAssetInfo asset)

From b45f50b57e3895620a682e2c7a438391dce0c5dd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 6 May 2022 19:40:13 -0400
Subject: [PATCH 607/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 10 ++++++----
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index a8dda9e0..44ee0caf 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.14.0</Version>
+    <Version>3.14.1</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index eb30ef7c..82cf51db 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,15 +1,17 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.14.1
+Released 06 May 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
-  * Improved performance for many mods still using the older content API.
+  * Improved performance for mods still using the previous content API.
   * Disabled case-insensitive file paths (introduced in 3.14.0) by default.  
     _You can enable them by editing `smapi-internal/config.json` if needed. They'll be re-enabled in an upcoming version after they're reworked a bit._
   * Removed experimental 'aggressive memory optimizations' option.  
     _This was disabled by default and is no longer needed in most cases. Memory usage will be better reduced by reworked asset propagation in the upcoming SMAPI 4.0.0._
-  * Fixed 'content file was not found' error when the game tries to load unlocalized text from a localizable mod data asset.
-  * Fixed error reading empty JSON files. These are now treated as if they didn't exist like before 3.14.0.
+  * Fixed 'content file was not found' error when the game tries to load unlocalized text from a localizable mod data asset in 3.14.0.
+  * Fixed error reading empty JSON files. These are now treated as if they didn't exist (matching pre-3.14.0 behavior).
   * Updated compatibility list.
 
 ## 3.14.0
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 38945c5d..edbdd081 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.14.0",
+    "Version": "3.14.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.14.0"
+    "MinimumApiVersion": "3.14.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index c082bf75..af67453d 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.14.0",
+    "Version": "3.14.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.14.0"
+    "MinimumApiVersion": "3.14.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 28bffa98..14b68cb4 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.14.0",
+    "Version": "3.14.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.14.0"
+    "MinimumApiVersion": "3.14.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index f5da286a..b1a9cc82 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.14.0";
+        internal static string RawApiVersion = "3.14.1";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From f973b4c51839aa2364879ec2ba66da703f20ae06 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 7 May 2022 21:18:09 -0400
Subject: [PATCH 608/856] move CreateFakeContentPack into its own method

---
 src/SMAPI/Framework/SCore.cs | 43 ++++++++++++++++++++++--------------
 1 file changed, 26 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index a9296d9b..ad6de997 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1835,22 +1835,6 @@ namespace StardewModdingAPI.Framework
                     TranslationHelper translationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
                     IModHelper modHelper;
                     {
-                        IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest)
-                        {
-                            IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
-
-                            IFilePathLookup relativePathCache = this.GetFilePathLookup(packDirPath);
-
-                            GameContentHelper gameContentHelper = new(contentCore, mod, packManifest.Name, packMonitor, this.Reflection);
-                            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, mod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
-                            TranslationHelper packTranslationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
-
-                            ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, relativePathCache);
-                            this.ReloadTranslationsForTemporaryContentPack(mod, contentPack);
-                            mod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
-                            return contentPack;
-                        }
-
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
                         IFilePathLookup relativePathLookup = this.GetFilePathLookup(mod.DirectoryPath);
@@ -1859,7 +1843,11 @@ namespace StardewModdingAPI.Framework
 #pragma warning restore CS0612
                         GameContentHelper gameContentHelper = new(contentCore, mod, mod.DisplayName, monitor, this.Reflection);
                         IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathLookup, this.Reflection);
-                        IContentPackHelper contentPackHelper = new ContentPackHelper(mod, new Lazy<IContentPack[]>(GetContentPacks), CreateFakeContentPack);
+                        IContentPackHelper contentPackHelper = new ContentPackHelper(
+                            mod: mod,
+                            contentPacks: new Lazy<IContentPack[]>(GetContentPacks),
+                            createContentPack: (dirPath, manifest) => this.CreateFakeContentPack(dirPath, manifest, contentCore, mod)
+                        );
                         IDataHelper dataHelper = new DataHelper(mod, mod.DirectoryPath, jsonHelper);
                         IReflectionHelper reflectionHelper = new ReflectionHelper(mod, mod.DisplayName, this.Reflection);
                         IModRegistry modRegistryHelper = new ModRegistryHelper(mod, this.ModRegistry, proxyFactory, monitor);
@@ -1888,6 +1876,27 @@ namespace StardewModdingAPI.Framework
             }
         }
 
+        /// <summary>Create a fake content pack instance for a parent mod.</summary>
+        /// <param name="packDirPath">The absolute path to the fake content pack's directory.</param>
+        /// <param name="packManifest">The fake content pack's manifest.</param>
+        /// <param name="contentCore">The content manager to use for mod content.</param>
+        /// <param name="mod">The mod for which the content pack is being created.</param>
+        private IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest, ContentCoordinator contentCore, IModMetadata mod)
+        {
+            IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
+
+            IFilePathLookup relativePathCache = this.GetFilePathLookup(packDirPath);
+
+            GameContentHelper gameContentHelper = new(contentCore, mod, packManifest.Name, packMonitor, this.Reflection);
+            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, mod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
+            TranslationHelper packTranslationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
+
+            ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, relativePathCache);
+            this.ReloadTranslationsForTemporaryContentPack(mod, contentPack);
+            mod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
+            return contentPack;
+        }
+
         /// <summary>Load a mod's entry class.</summary>
         /// <param name="modAssembly">The mod assembly.</param>
         /// <param name="mod">The loaded instance.</param>

From 709638f197093ed9aaa9a3a764c85d40f4c19eac Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 7 May 2022 21:21:02 -0400
Subject: [PATCH 609/856] fix assets loaded through fake content pack using
 parent mod's path info

---
 docs/release-notes.md        |  4 ++++
 src/SMAPI/Framework/SCore.cs | 24 ++++++++++++++++--------
 2 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 82cf51db..9cd45f61 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For mod authors:
+  * Fixed assets loaded through a fake content pack not working correctly since 3.14.0.
+
 ## 3.14.1
 Released 06 May 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index ad6de997..c8dcf747 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1880,20 +1880,28 @@ namespace StardewModdingAPI.Framework
         /// <param name="packDirPath">The absolute path to the fake content pack's directory.</param>
         /// <param name="packManifest">The fake content pack's manifest.</param>
         /// <param name="contentCore">The content manager to use for mod content.</param>
-        /// <param name="mod">The mod for which the content pack is being created.</param>
-        private IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest, ContentCoordinator contentCore, IModMetadata mod)
+        /// <param name="parentMod">The mod for which the content pack is being created.</param>
+        private IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest, ContentCoordinator contentCore, IModMetadata parentMod)
         {
-            IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
+            IModMetadata fakeMod = new ModMetadata(
+                displayName: $"{parentMod.DisplayName} (fake content pack: {Path.GetRelativePath(Constants.ModsPath, packDirPath)})",
+                directoryPath: packDirPath,
+                rootPath: Constants.ModsPath,
+                manifest: packManifest,
+                dataRecord: null,
+                isIgnored: false
+            );
 
+            IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
             IFilePathLookup relativePathCache = this.GetFilePathLookup(packDirPath);
 
-            GameContentHelper gameContentHelper = new(contentCore, mod, packManifest.Name, packMonitor, this.Reflection);
-            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, mod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
-            TranslationHelper packTranslationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
+            GameContentHelper gameContentHelper = new(contentCore, fakeMod, packManifest.Name, packMonitor, this.Reflection);
+            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, fakeMod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
+            TranslationHelper packTranslationHelper = new(fakeMod, contentCore.GetLocale(), contentCore.Language);
 
             ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, relativePathCache);
-            this.ReloadTranslationsForTemporaryContentPack(mod, contentPack);
-            mod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
+            this.ReloadTranslationsForTemporaryContentPack(parentMod, contentPack);
+            parentMod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
             return contentPack;
         }
 

From d4ff9f3f5c108493452879938aa224adb556b7c3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 7 May 2022 21:53:18 -0400
Subject: [PATCH 610/856] log fake content packs created by mods

---
 docs/release-notes.md                              |  1 +
 .../Framework/ModHelpers/ContentPackHelper.cs      | 10 +++++++++-
 src/SMAPI/Framework/SCore.cs                       | 14 +++++++++++---
 3 files changed, 21 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9cd45f61..e558a1bb 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For mod authors:
+  * Dynamic content packs created via `helper.ContentPacks.CreateTemporary` or `CreateFake` are now listed in the log file.
   * Fixed assets loaded through a fake content pack not working correctly since 3.14.0.
 
 ## 3.14.1
diff --git a/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
index 9f4a7ceb..6bc091fa 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentPackHelper.cs
@@ -42,7 +42,15 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public IContentPack CreateFake(string directoryPath)
         {
             string id = Guid.NewGuid().ToString("N");
-            return this.CreateTemporary(directoryPath, id, id, id, id, new SemanticVersion(1, 0, 0));
+            string relativePath = Path.GetRelativePath(Constants.ModsPath, directoryPath);
+            return this.CreateTemporary(
+                directoryPath: directoryPath,
+                id: id,
+                name: $"{this.Mod.DisplayName} (fake content pack: {relativePath})",
+                description: $"A temporary content pack created by the {this.Mod.DisplayName} mod.",
+                author: "???",
+                new SemanticVersion(1, 0, 0)
+            );
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c8dcf747..0465b6f1 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1846,7 +1846,7 @@ namespace StardewModdingAPI.Framework
                         IContentPackHelper contentPackHelper = new ContentPackHelper(
                             mod: mod,
                             contentPacks: new Lazy<IContentPack[]>(GetContentPacks),
-                            createContentPack: (dirPath, manifest) => this.CreateFakeContentPack(dirPath, manifest, contentCore, mod)
+                            createContentPack: (dirPath, fakeManifest) => this.CreateFakeContentPack(dirPath, fakeManifest, contentCore, mod)
                         );
                         IDataHelper dataHelper = new DataHelper(mod, mod.DirectoryPath, jsonHelper);
                         IReflectionHelper reflectionHelper = new ReflectionHelper(mod, mod.DisplayName, this.Reflection);
@@ -1883,8 +1883,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="parentMod">The mod for which the content pack is being created.</param>
         private IContentPack CreateFakeContentPack(string packDirPath, IManifest packManifest, ContentCoordinator contentCore, IModMetadata parentMod)
         {
+            // create fake mod info
+            string relativePath = Path.GetRelativePath(Constants.ModsPath, packDirPath);
             IModMetadata fakeMod = new ModMetadata(
-                displayName: $"{parentMod.DisplayName} (fake content pack: {Path.GetRelativePath(Constants.ModsPath, packDirPath)})",
+                displayName: packManifest.Name,
                 directoryPath: packDirPath,
                 rootPath: Constants.ModsPath,
                 manifest: packManifest,
@@ -1892,16 +1894,22 @@ namespace StardewModdingAPI.Framework
                 isIgnored: false
             );
 
+            // create mod helpers
             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
             IFilePathLookup relativePathCache = this.GetFilePathLookup(packDirPath);
-
             GameContentHelper gameContentHelper = new(contentCore, fakeMod, packManifest.Name, packMonitor, this.Reflection);
             IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, fakeMod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
             TranslationHelper packTranslationHelper = new(fakeMod, contentCore.GetLocale(), contentCore.Language);
 
+            // add content pack
             ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, relativePathCache);
             this.ReloadTranslationsForTemporaryContentPack(parentMod, contentPack);
             parentMod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
+
+            // log change
+            string pathLabel = packDirPath.Contains("..") ? packDirPath : relativePath;
+            this.Monitor.Log($"{parentMod.DisplayName} created dynamic content pack '{packManifest.Name}' (unique ID: {packManifest.UniqueID}{(packManifest.Name.Contains(pathLabel) ? "" : $", path: {pathLabel}")}).");
+
             return contentPack;
         }
 

From 3db035312641b629aaa5517569d0d30cf71bac29 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 7 May 2022 23:12:33 -0400
Subject: [PATCH 611/856] simplify and rewrite case-insensitive file path
 feature

---
 docs/release-notes.md                         |  2 +
 src/SMAPI.Tests/Core/ModResolverTests.cs      | 21 +++--
 .../Framework/ModScanning/ModScanner.cs       | 22 +++---
 .../PathLookups/CaseInsensitivePathLookup.cs  | 78 ++++++-------------
 .../Utilities/PathLookups/IFilePathLookup.cs  | 18 ++---
 .../PathLookups/MinimalPathLookup.cs          | 39 +++++++---
 src/SMAPI/Framework/ContentCoordinator.cs     | 12 +--
 .../ContentManagers/ModContentManager.cs      | 39 +++++-----
 src/SMAPI/Framework/ContentPack.cs            | 33 ++++----
 .../Framework/ModHelpers/ModContentHelper.cs  | 16 +---
 .../Framework/ModLoading/AssemblyLoader.cs    | 14 ++--
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 10 +--
 src/SMAPI/Framework/SCore.cs                  | 36 ++++-----
 13 files changed, 158 insertions(+), 182 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e558a1bb..d9761a6d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,8 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Improved performance of case-insensitive file paths.
 * For mod authors:
   * Dynamic content packs created via `helper.ContentPacks.CreateTemporary` or `CreateFake` are now listed in the log file.
   * Fixed assets loaded through a fake content pack not working correctly since 3.14.0.
diff --git a/src/SMAPI.Tests/Core/ModResolverTests.cs b/src/SMAPI.Tests/Core/ModResolverTests.cs
index 3dfc9461..70c782ab 100644
--- a/src/SMAPI.Tests/Core/ModResolverTests.cs
+++ b/src/SMAPI.Tests/Core/ModResolverTests.cs
@@ -133,7 +133,7 @@ namespace SMAPI.Tests.Core
         [Test(Description = "Assert that validation doesn't fail if there are no mods installed.")]
         public void ValidateManifests_NoMods_DoesNothing()
         {
-            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
+            new ModResolver().ValidateManifests(Array.Empty<ModMetadata>(), apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFileLookup: this.GetFileLookup, validateFilesExist: false);
         }
 
         [Test(Description = "Assert that validation skips manifests that have already failed without calling any other properties.")]
@@ -144,7 +144,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.Status).Returns(ModMetadataStatus.Failed);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFileLookup: this.GetFileLookup, validateFilesExist: false);
 
             // assert
             mock.VerifyGet(p => p.Status, Times.Once, "The validation did not check the manifest status.");
@@ -161,7 +161,7 @@ namespace SMAPI.Tests.Core
             });
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFileLookup: this.GetFileLookup, validateFilesExist: false);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -175,7 +175,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.Manifest).Returns(this.GetManifest(minimumApiVersion: "1.1"));
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFileLookup: this.GetFileLookup, validateFilesExist: false);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -190,7 +190,7 @@ namespace SMAPI.Tests.Core
             Directory.CreateDirectory(directoryPath);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFileLookup: this.GetFileLookup);
 
             // assert
             mock.Verify(p => p.SetStatus(ModMetadataStatus.Failed, It.IsAny<ModFailReason>(), It.IsAny<string>(), It.IsAny<string>()), Times.Once, "The validation did not fail the metadata.");
@@ -207,7 +207,7 @@ namespace SMAPI.Tests.Core
             Mock<IModMetadata> modB = this.GetMetadata(this.GetManifest(id: "Mod A", name: "Mod B", version: "1.0"), allowStatusChange: true);
 
             // act
-            new ModResolver().ValidateManifests(new[] { modA.Object, modB.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance, validateFilesExist: false);
+            new ModResolver().ValidateManifests(new[] { modA.Object, modB.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFileLookup: this.GetFileLookup, validateFilesExist: false);
 
             // assert
             modA.Verify(p => p.SetStatus(ModMetadataStatus.Failed, ModFailReason.Duplicate, It.IsAny<string>(), It.IsAny<string>()), Times.AtLeastOnce, "The validation did not fail the first mod with a unique ID.");
@@ -233,7 +233,7 @@ namespace SMAPI.Tests.Core
             mock.Setup(p => p.DirectoryPath).Returns(modFolder);
 
             // act
-            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFilePathLookup: _ => MinimalPathLookup.Instance);
+            new ModResolver().ValidateManifests(new[] { mock.Object }, apiVersion: new SemanticVersion("1.0"), getUpdateUrl: _ => null, getFileLookup: this.GetFileLookup);
 
             // assert
             // if Moq doesn't throw a method-not-setup exception, the validation didn't override the status.
@@ -483,6 +483,13 @@ namespace SMAPI.Tests.Core
             return Path.Combine(Path.GetTempPath(), "smapi-unit-tests", Guid.NewGuid().ToString("N"));
         }
 
+        /// <summary>Get a file lookup for a given directory.</summary>
+        /// <param name="rootDirectory">The full path to the directory.</param>
+        private IFileLookup GetFileLookup(string rootDirectory)
+        {
+            return MinimalFileLookup.GetCachedFor(rootDirectory);
+        }
+
         /// <summary>Get a randomized basic manifest.</summary>
         /// <param name="id">The <see cref="IManifest.UniqueID"/> value, or <c>null</c> for a generated value.</param>
         /// <param name="name">The <see cref="IManifest.Name"/> value, or <c>null</c> for a generated value.</param>
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index aa4c3338..a85ef109 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -114,10 +114,11 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
         /// <summary>Extract information from a mod folder.</summary>
         /// <param name="root">The root folder containing mods.</param>
         /// <param name="searchFolder">The folder to search for a mod.</param>
-        public ModFolder ReadFolder(DirectoryInfo root, DirectoryInfo searchFolder)
+        /// <param name="useCaseInsensitiveFilePaths">Whether to match file paths case-insensitively, even on Linux.</param>
+        public ModFolder ReadFolder(DirectoryInfo root, DirectoryInfo searchFolder, bool useCaseInsensitiveFilePaths)
         {
             // find manifest.json
-            FileInfo? manifestFile = this.FindManifest(searchFolder);
+            FileInfo? manifestFile = this.FindManifest(searchFolder, useCaseInsensitiveFilePaths);
 
             // set appropriate invalid-mod error
             if (manifestFile == null)
@@ -225,7 +226,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 
             // treat as mod folder
             else
-                yield return this.ReadFolder(root, folder);
+                yield return this.ReadFolder(root, folder, useCaseInsensitiveFilePaths);
         }
 
         /// <summary>Consolidate adjacent folders into one mod folder, if possible.</summary>
@@ -250,7 +251,8 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
 
         /// <summary>Find the manifest for a mod folder.</summary>
         /// <param name="folder">The folder to search.</param>
-        private FileInfo? FindManifest(DirectoryInfo folder)
+        /// <param name="useCaseInsensitiveFilePaths">Whether to match file paths case-insensitively, even on Linux.</param>
+        private FileInfo? FindManifest(DirectoryInfo folder, bool useCaseInsensitiveFilePaths)
         {
             // check for conventional manifest in current folder
             const string defaultName = "manifest.json";
@@ -259,14 +261,14 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
                 return file;
 
             // check for manifest with incorrect capitalization
+            if (useCaseInsensitiveFilePaths)
             {
-                CaseInsensitivePathLookup pathLookup = new(folder.FullName, SearchOption.TopDirectoryOnly); // don't use GetCachedFor, since we only need it temporarily
-                string realName = pathLookup.GetFilePath(defaultName);
-                if (realName != defaultName)
-                    file = new(Path.Combine(folder.FullName, realName));
+                CaseInsensitiveFileLookup fileLookup = new(folder.FullName, SearchOption.TopDirectoryOnly); // don't use GetCachedFor, since we only need it temporarily
+                file = fileLookup.GetFile(defaultName);
+                return file.Exists
+                    ? file
+                    : null;
             }
-            if (file.Exists)
-                return file;
 
             // not found
             return null;
diff --git a/src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs
index 9cc00737..496d54c3 100644
--- a/src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs
@@ -4,8 +4,8 @@ using System.IO;
 
 namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
 {
-    /// <summary>An API for case-insensitive relative path lookups within a root directory.</summary>
-    internal class CaseInsensitivePathLookup : IFilePathLookup
+    /// <summary>An API for case-insensitive file lookups within a root directory.</summary>
+    internal class CaseInsensitiveFileLookup : IFileLookup
     {
         /*********
         ** Fields
@@ -16,8 +16,8 @@ namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
         /// <summary>A case-insensitive lookup of file paths within the <see cref="RootPath"/>. Each path is listed in both file path and asset name format, so it's usable in both contexts without needing to re-parse paths.</summary>
         private readonly Lazy<Dictionary<string, string>> RelativePathCache;
 
-        /// <summary>The case-insensitive path caches by root path.</summary>
-        private static readonly Dictionary<string, CaseInsensitivePathLookup> CachedRoots = new(StringComparer.OrdinalIgnoreCase);
+        /// <summary>The case-insensitive file lookups by root path.</summary>
+        private static readonly Dictionary<string, CaseInsensitiveFileLookup> CachedRoots = new(StringComparer.OrdinalIgnoreCase);
 
 
         /*********
@@ -26,22 +26,28 @@ namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
         /// <summary>Construct an instance.</summary>
         /// <param name="rootPath">The root directory path for relative paths.</param>
         /// <param name="searchOption">Which directories to scan from the root.</param>
-        public CaseInsensitivePathLookup(string rootPath, SearchOption searchOption = SearchOption.AllDirectories)
+        public CaseInsensitiveFileLookup(string rootPath, SearchOption searchOption = SearchOption.AllDirectories)
         {
-            this.RootPath = rootPath;
+            this.RootPath = PathUtilities.NormalizePath(rootPath);
             this.RelativePathCache = new(() => this.GetRelativePathCache(searchOption));
         }
 
         /// <inheritdoc />
-        public string GetFilePath(string relativePath)
+        public FileInfo GetFile(string relativePath)
         {
-            return this.GetImpl(PathUtilities.NormalizePath(relativePath));
-        }
+            // invalid path
+            if (string.IsNullOrWhiteSpace(relativePath))
+                throw new InvalidOperationException("Can't get a file from an empty relative path.");
 
-        /// <inheritdoc />
-        public string GetAssetName(string relativePath)
-        {
-            return this.GetImpl(PathUtilities.NormalizeAssetName(relativePath));
+            // already cached
+            if (this.RelativePathCache.Value.TryGetValue(relativePath, out string? resolved))
+                return new(Path.Combine(this.RootPath, resolved));
+
+            // keep capitalization as-is
+            FileInfo file = new(Path.Combine(this.RootPath, relativePath));
+            if (file.Exists)
+                this.RelativePathCache.Value[relativePath] = relativePath;
+            return file;
         }
 
         /// <inheritdoc />
@@ -61,17 +67,17 @@ namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
                 throw new InvalidOperationException($"Can't add relative path '{relativePath}' to the case-insensitive cache for '{this.RootPath}' because that file doesn't exist.");
 
             // cache path
-            this.CacheRawPath(this.RelativePathCache.Value, relativePath);
+            this.RelativePathCache.Value[relativePath] = relativePath;
         }
 
         /// <summary>Get a cached dictionary of relative paths within a root path, for case-insensitive file lookups.</summary>
         /// <param name="rootPath">The root path to scan.</param>
-        public static CaseInsensitivePathLookup GetCachedFor(string rootPath)
+        public static CaseInsensitiveFileLookup GetCachedFor(string rootPath)
         {
             rootPath = PathUtilities.NormalizePath(rootPath);
 
-            if (!CaseInsensitivePathLookup.CachedRoots.TryGetValue(rootPath, out CaseInsensitivePathLookup? cache))
-                CaseInsensitivePathLookup.CachedRoots[rootPath] = cache = new CaseInsensitivePathLookup(rootPath);
+            if (!CaseInsensitiveFileLookup.CachedRoots.TryGetValue(rootPath, out CaseInsensitiveFileLookup? cache))
+                CaseInsensitiveFileLookup.CachedRoots[rootPath] = cache = new CaseInsensitiveFileLookup(rootPath);
 
             return cache;
         }
@@ -80,29 +86,6 @@ namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
         /*********
         ** Private methods
         *********/
-        /// <summary>Get the exact capitalization for a given relative path.</summary>
-        /// <param name="relativePath">The relative path. This must already be normalized into asset name or file path format (i.e. using <see cref="PathUtilities.NormalizeAssetName"/> or <see cref="PathUtilities.NormalizePath"/> respectively).</param>
-        /// <remarks>Returns the resolved path in the same format if found, else returns the path as-is.</remarks>
-        private string GetImpl(string relativePath)
-        {
-            // invalid path
-            if (string.IsNullOrWhiteSpace(relativePath))
-                return relativePath;
-
-            // already cached
-            if (this.RelativePathCache.Value.TryGetValue(relativePath, out string? resolved))
-                return resolved;
-
-            // keep capitalization as-is
-            if (File.Exists(Path.Combine(this.RootPath, relativePath)))
-            {
-                // file exists but isn't cached for some reason
-                // cache it now so any later references to it are case-insensitive
-                this.CacheRawPath(this.RelativePathCache.Value, relativePath);
-            }
-            return relativePath;
-        }
-
         /// <summary>Get a case-insensitive lookup of file paths (see <see cref="RelativePathCache"/>).</summary>
         /// <param name="searchOption">Which directories to scan from the root.</param>
         private Dictionary<string, string> GetRelativePathCache(SearchOption searchOption)
@@ -112,23 +95,10 @@ namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
             foreach (string path in Directory.EnumerateFiles(this.RootPath, "*", searchOption))
             {
                 string relativePath = path.Substring(this.RootPath.Length + 1);
-
-                this.CacheRawPath(cache, relativePath);
+                cache[relativePath] = relativePath;
             }
 
             return cache;
         }
-
-        /// <summary>Add a raw relative path to the cache.</summary>
-        /// <param name="cache">The cache to update.</param>
-        /// <param name="relativePath">The relative path to cache, with its exact filesystem capitalization.</param>
-        private void CacheRawPath(IDictionary<string, string> cache, string relativePath)
-        {
-            string filePath = PathUtilities.NormalizePath(relativePath);
-            string assetName = PathUtilities.NormalizeAssetName(relativePath);
-
-            cache[filePath] = filePath;
-            cache[assetName] = assetName;
-        }
     }
 }
diff --git a/src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs
index 678e1383..d43b5141 100644
--- a/src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs
@@ -1,20 +1,16 @@
+using System.IO;
+
 namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
 {
-    /// <summary>An API for relative path lookups within a root directory.</summary>
-    internal interface IFilePathLookup
+    /// <summary>An API for file lookups within a root directory.</summary>
+    internal interface IFileLookup
     {
-        /// <summary>Get the actual path for a given relative file path.</summary>
+        /// <summary>Get the file for a given relative file path, if it exists.</summary>
         /// <param name="relativePath">The relative path.</param>
-        /// <remarks>Returns the resolved path in file path format, else the normalized <paramref name="relativePath"/>.</remarks>
-        string GetFilePath(string relativePath);
-
-        /// <summary>Get the actual path for a given asset name.</summary>
-        /// <param name="relativePath">The relative path.</param>
-        /// <remarks>Returns the resolved path in asset name format, else the normalized <paramref name="relativePath"/>.</remarks>
-        string GetAssetName(string relativePath);
+        FileInfo GetFile(string relativePath);
 
         /// <summary>Add a relative path that was just created by a SMAPI API.</summary>
-        /// <param name="relativePath">The relative path. This must already be normalized in asset name or file path format.</param>
+        /// <param name="relativePath">The relative path.</param>
         void Add(string relativePath);
     }
 }
diff --git a/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs
index 2cf14704..414b569b 100644
--- a/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs
+++ b/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs
@@ -1,31 +1,52 @@
+using System.Collections.Generic;
+using System.IO;
+
 namespace StardewModdingAPI.Toolkit.Utilities.PathLookups
 {
-    /// <summary>An API for relative path lookups within a root directory with minimal preprocessing.</summary>
-    internal class MinimalPathLookup : IFilePathLookup
+    /// <summary>An API for file lookups within a root directory with minimal preprocessing.</summary>
+    internal class MinimalFileLookup : IFileLookup
     {
         /*********
         ** Accessors
         *********/
-        /// <summary>A singleton instance for reuse.</summary>
-        public static readonly MinimalPathLookup Instance = new();
+        /// <summary>The file lookups by root path.</summary>
+        private static readonly Dictionary<string, MinimalFileLookup> CachedRoots = new();
+
+        /// <summary>The root directory path for relative paths.</summary>
+        private readonly string RootPath;
 
 
         /*********
         ** Public methods
         *********/
-        /// <inheritdoc />
-        public string GetFilePath(string relativePath)
+        /// <summary>Construct an instance.</summary>
+        /// <param name="rootPath">The root directory path for relative paths.</param>
+        public MinimalFileLookup(string rootPath)
         {
-            return PathUtilities.NormalizePath(relativePath);
+            this.RootPath = rootPath;
         }
 
         /// <inheritdoc />
-        public string GetAssetName(string relativePath)
+        public FileInfo GetFile(string relativePath)
         {
-            return PathUtilities.NormalizeAssetName(relativePath);
+            return new(
+                Path.Combine(this.RootPath, PathUtilities.NormalizePath(relativePath))
+            );
         }
 
         /// <inheritdoc />
         public void Add(string relativePath) { }
+
+        /// <summary>Get a cached dictionary of relative paths within a root path, for case-insensitive file lookups.</summary>
+        /// <param name="rootPath">The root path to scan.</param>
+        public static MinimalFileLookup GetCachedFor(string rootPath)
+        {
+            rootPath = PathUtilities.NormalizePath(rootPath);
+
+            if (!MinimalFileLookup.CachedRoots.TryGetValue(rootPath, out MinimalFileLookup? lookup))
+                MinimalFileLookup.CachedRoots[rootPath] = lookup = new MinimalFileLookup(rootPath);
+
+            return lookup;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 4f52d57e..02b753ba 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -32,8 +32,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>An asset key prefix for assets from SMAPI mod folders.</summary>
         private readonly string ManagedPrefix = "SMAPI";
 
-        /// <summary>Get a file path lookup for the given directory.</summary>
-        private readonly Func<string, IFilePathLookup> GetFilePathLookup;
+        /// <summary>Get a file lookup for the given directory.</summary>
+        private readonly Func<string, IFileLookup> GetFileLookup;
 
         /// <summary>Encapsulates monitoring and logging.</summary>
         private readonly IMonitor Monitor;
@@ -123,12 +123,12 @@ namespace StardewModdingAPI.Framework
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
         /// <param name="onAssetLoaded">A callback to invoke when an asset is fully loaded.</param>
-        /// <param name="getFilePathLookup">Get a file path lookup for the given directory.</param>
+        /// <param name="getFileLookup">Get a file lookup for the given directory.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFilePathLookup> getFilePathLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
         {
-            this.GetFilePathLookup = getFilePathLookup;
+            this.GetFileLookup = getFileLookup;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
             this.Reflection = reflection;
             this.JsonHelper = jsonHelper;
@@ -200,7 +200,7 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
-                    relativePathLookup: this.GetFilePathLookup(rootDirectory)
+                    fileLookup: this.GetFileLookup(rootDirectory)
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 65dffd8b..7cac8f36 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.Globalization;
 using System.IO;
 using System.Linq;
@@ -33,11 +34,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>The game content manager used for map tilesheets not provided by the mod.</summary>
         private readonly IContentManager GameContentManager;
 
-        /// <summary>A lookup for relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
-        private readonly IFilePathLookup RelativePathLookup;
+        /// <summary>A lookup for files within the <see cref="ContentManager.RootDirectory"/>.</summary>
+        private readonly IFileLookup FileLookup;
 
         /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
-        private readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
+        private static readonly HashSet<string> LocalTilesheetExtensions = new(StringComparer.OrdinalIgnoreCase) { ".png", ".xnb" };
 
 
         /*********
@@ -55,12 +56,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
-        /// <param name="relativePathLookup">A lookup for relative paths within the <paramref name="rootDirectory"/>.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFilePathLookup relativePathLookup)
+        /// <param name="fileLookup">A lookup for files within the <paramref name="rootDirectory"/>.</param>
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
         {
             this.GameContentManager = gameContentManager;
-            this.RelativePathLookup = relativePathLookup;
+            this.FileLookup = fileLookup;
             this.JsonHelper = jsonHelper;
             this.ModName = modName;
 
@@ -73,7 +74,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             if (base.DoesAssetExist<T>(assetName))
                 return true;
 
-            FileInfo file = this.GetModFile(assetName.Name);
+            FileInfo file = this.GetModFile<T>(assetName.Name);
             return file.Exists;
         }
 
@@ -103,7 +104,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             try
             {
                 // get file
-                FileInfo file = this.GetModFile(assetName.Name);
+                FileInfo file = this.GetModFile<T>(assetName.Name);
                 if (!file.Exists)
                     throw this.GetLoadError(assetName, "the specified path doesn't exist.");
 
@@ -139,9 +140,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
         public IAssetName GetInternalAssetKey(string key)
         {
-            FileInfo file = this.GetModFile(key);
-            string relativePath = Path.GetRelativePath(this.RootDirectory, file.FullName);
-            string internalKey = Path.Combine(this.Name, relativePath);
+            string internalKey = Path.Combine(this.Name, PathUtilities.NormalizeAssetName(key));
 
             return this.Coordinator.ParseAssetName(internalKey, allowLocales: false);
         }
@@ -253,19 +252,17 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <summary>Get a file from the mod folder.</summary>
+        /// <typeparam name="T">The expected asset type.</typeparam>
         /// <param name="path">The asset path relative to the content folder.</param>
-        private FileInfo GetModFile(string path)
+        private FileInfo GetModFile<T>(string path)
         {
-            // map to case-insensitive path if needed
-            path = this.RelativePathLookup.GetFilePath(path);
+            // get exact file
+            FileInfo file = this.FileLookup.GetFile(path);
 
-            // try exact match
-            FileInfo file = new(Path.Combine(this.FullRootDirectory, path));
-
-            // try with default extension
-            if (!file.Exists)
+            // try with default image extensions
+            if (!file.Exists && typeof(Texture2D).IsAssignableFrom(typeof(T)) && !ModContentManager.LocalTilesheetExtensions.Contains(file.Extension))
             {
-                foreach (string extension in this.LocalTilesheetExtensions)
+                foreach (string extension in ModContentManager.LocalTilesheetExtensions)
                 {
                     FileInfo result = new(file.FullName + extension);
                     if (result.Exists)
@@ -385,7 +382,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // get relative to map file
             {
                 string localKey = Path.Combine(modRelativeMapFolder, relativePath);
-                if (this.GetModFile(localKey).Exists)
+                if (this.GetModFile<Texture2D>(localKey).Exists)
                 {
                     assetName = this.GetInternalAssetKey(localKey);
                     return true;
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index 9503a0e6..5975fff6 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -16,8 +16,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>Encapsulates SMAPI's JSON file parsing.</summary>
         private readonly JsonHelper JsonHelper;
 
-        /// <summary>A lookup for relative paths within the <see cref="DirectoryPath"/>.</summary>
-        private readonly IFilePathLookup RelativePathCache;
+        /// <summary>A lookup for files within the <see cref="DirectoryPath"/>.</summary>
+        private readonly IFileLookup FileLookup;
 
 
         /*********
@@ -48,15 +48,15 @@ namespace StardewModdingAPI.Framework
         /// <param name="content">Provides an API for loading content assets from the content pack's folder.</param>
         /// <param name="translation">Provides translations stored in the content pack's <c>i18n</c> folder.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
-        /// <param name="relativePathCache">A lookup for relative paths within the <paramref name="directoryPath"/>.</param>
-        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper, IFilePathLookup relativePathCache)
+        /// <param name="fileLookup">A lookup for files within the <paramref name="directoryPath"/>.</param>
+        public ContentPack(string directoryPath, IManifest manifest, IModContentHelper content, TranslationHelper translation, JsonHelper jsonHelper, IFileLookup fileLookup)
         {
             this.DirectoryPath = directoryPath;
             this.Manifest = manifest;
             this.ModContent = content;
             this.TranslationImpl = translation;
             this.JsonHelper = jsonHelper;
-            this.RelativePathCache = relativePathCache;
+            this.FileLookup = fileLookup;
         }
 
         /// <inheritdoc />
@@ -83,10 +83,17 @@ namespace StardewModdingAPI.Framework
         {
             path = PathUtilities.NormalizePath(path);
 
-            FileInfo file = this.GetFile(path, out path);
+            FileInfo file = this.GetFile(path);
+            bool didExist = file.Exists;
+
             this.JsonHelper.WriteJsonFile(file.FullName, data);
 
-            this.RelativePathCache.Add(path);
+            if (!didExist)
+            {
+                this.FileLookup.Add(
+                    Path.GetRelativePath(this.DirectoryPath, file.FullName)
+                );
+            }
         }
 
         /// <inheritdoc />
@@ -111,21 +118,11 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get the underlying file info.</summary>
         /// <param name="relativePath">The normalized file path relative to the content pack directory.</param>
         private FileInfo GetFile(string relativePath)
-        {
-            return this.GetFile(relativePath, out _);
-        }
-
-        /// <summary>Get the underlying file info.</summary>
-        /// <param name="relativePath">The normalized file path relative to the content pack directory.</param>
-        /// <param name="actualRelativePath">The relative path after case-insensitive matching.</param>
-        private FileInfo GetFile(string relativePath, out string actualRelativePath)
         {
             if (!PathUtilities.IsSafeRelativePath(relativePath))
                 throw new InvalidOperationException($"You must call {nameof(IContentPack)} methods with a relative path.");
 
-            actualRelativePath = this.RelativePathCache.GetFilePath(relativePath);
-
-            return new FileInfo(Path.Combine(this.DirectoryPath, actualRelativePath));
+            return this.FileLookup.GetFile(relativePath);
         }
     }
 }
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index 74ea73de..6429f9bf 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -1,10 +1,8 @@
 using System;
-using Microsoft.Xna.Framework.Content;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
-using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 
 namespace StardewModdingAPI.Framework.ModHelpers
 {
@@ -23,9 +21,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>The friendly mod name for use in errors.</summary>
         private readonly string ModName;
 
-        /// <summary>A lookup for relative paths within the <see cref="ContentManager.RootDirectory"/>.</summary>
-        private readonly IFilePathLookup RelativePathLookup;
-
         /// <summary>Simplifies access to private code.</summary>
         private readonly Reflector Reflection;
 
@@ -39,9 +34,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="mod">The mod using this instance.</param>
         /// <param name="modName">The friendly mod name for use in errors.</param>
         /// <param name="gameContentManager">The game content manager used for map tilesheets not provided by the mod.</param>
-        /// <param name="relativePathLookup">A lookup for relative paths within the <paramref name="relativePathLookup"/>.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
-        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IContentManager gameContentManager, IFilePathLookup relativePathLookup, Reflector reflection)
+        public ModContentHelper(ContentCoordinator contentCore, string modFolderPath, IModMetadata mod, string modName, IContentManager gameContentManager, Reflector reflection)
             : base(mod)
         {
             string managedAssetPrefix = contentCore.GetManagedAssetPrefix(mod.Manifest.UniqueID);
@@ -49,7 +43,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.ContentCore = contentCore;
             this.ModContentManager = contentCore.CreateModContentManager(managedAssetPrefix, modName, modFolderPath, gameContentManager);
             this.ModName = modName;
-            this.RelativePathLookup = relativePathLookup;
             this.Reflection = reflection;
         }
 
@@ -57,8 +50,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public T Load<T>(string relativePath)
             where T : notnull
         {
-            relativePath = this.RelativePathLookup.GetAssetName(relativePath);
-
             IAssetName assetName = this.ContentCore.ParseAssetName(relativePath, allowLocales: false);
 
             try
@@ -74,7 +65,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <inheritdoc />
         public IAssetName GetInternalAssetName(string relativePath)
         {
-            relativePath = this.RelativePathLookup.GetAssetName(relativePath);
             return this.ModContentManager.GetInternalAssetKey(relativePath);
         }
 
@@ -85,9 +75,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             if (data == null)
                 throw new ArgumentNullException(nameof(data), "Can't get a patch helper for a null value.");
 
-            relativePath = relativePath != null
-                ? this.RelativePathLookup.GetAssetName(relativePath)
-                : $"temp/{Guid.NewGuid():N}";
+            relativePath ??= $"temp/{Guid.NewGuid():N}";
 
             return new AssetDataForObject(
                 locale: this.ContentCore.GetLocale(),
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 72b547b1..a6756e0e 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -85,11 +85,11 @@ namespace StardewModdingAPI.Framework.ModLoading
 
         /// <summary>Preprocess and load an assembly.</summary>
         /// <param name="mod">The mod for which the assembly is being loaded.</param>
-        /// <param name="assemblyPath">The assembly file path.</param>
+        /// <param name="assemblyFile">The assembly file.</param>
         /// <param name="assumeCompatible">Assume the mod is compatible, even if incompatible code is detected.</param>
         /// <returns>Returns the rewrite metadata for the preprocessed assembly.</returns>
         /// <exception cref="IncompatibleInstructionException">An incompatible CIL instruction was found while rewriting the assembly.</exception>
-        public Assembly Load(IModMetadata mod, string assemblyPath, bool assumeCompatible)
+        public Assembly Load(IModMetadata mod, FileInfo assemblyFile, bool assumeCompatible)
         {
             // get referenced local assemblies
             AssemblyParseResult[] assemblies;
@@ -100,19 +100,19 @@ namespace StardewModdingAPI.Framework.ModLoading
                     where name != null
                     select name
                 );
-                assemblies = this.GetReferencedLocalAssemblies(new FileInfo(assemblyPath), visitedAssemblyNames, this.AssemblyDefinitionResolver).ToArray();
+                assemblies = this.GetReferencedLocalAssemblies(assemblyFile, visitedAssemblyNames, this.AssemblyDefinitionResolver).ToArray();
             }
 
             // validate load
             if (!assemblies.Any() || assemblies[0].Status == AssemblyLoadStatus.Failed)
             {
-                throw new SAssemblyLoadFailedException(!File.Exists(assemblyPath)
-                    ? $"Could not load '{assemblyPath}' because it doesn't exist."
-                    : $"Could not load '{assemblyPath}'."
+                throw new SAssemblyLoadFailedException(!assemblyFile.Exists
+                    ? $"Could not load '{assemblyFile.FullName}' because it doesn't exist."
+                    : $"Could not load '{assemblyFile.FullName}'."
                 );
             }
             if (assemblies.Last().Status == AssemblyLoadStatus.AlreadyLoaded) // mod assembly is last in dependency order
-                throw new SAssemblyLoadFailedException($"Could not load '{assemblyPath}' because it was already loaded. Do you have two copies of this mod?");
+                throw new SAssemblyLoadFailedException($"Could not load '{assemblyFile.FullName}' because it was already loaded. Do you have two copies of this mod?");
 
             // rewrite & load assemblies in leaf-to-root order
             bool oneAssembly = assemblies.Length == 1;
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 1b1fa04e..3e7144f9 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -58,11 +58,11 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="mods">The mod manifests to validate.</param>
         /// <param name="apiVersion">The current SMAPI version.</param>
         /// <param name="getUpdateUrl">Get an update URL for an update key (if valid).</param>
-        /// <param name="getFilePathLookup">Get a file path lookup for the given directory.</param>
+        /// <param name="getFileLookup">Get a file lookup for the given directory.</param>
         /// <param name="validateFilesExist">Whether to validate that files referenced in the manifest (like <see cref="IManifest.EntryDll"/>) exist on disk. This can be disabled to only validate the manifest itself.</param>
         [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "Manifest values may be null before they're validated.")]
         [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "Manifest values may be null before they're validated.")]
-        public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string?> getUpdateUrl, Func<string, IFilePathLookup> getFilePathLookup, bool validateFilesExist = true)
+        public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string?> getUpdateUrl, Func<string, IFileLookup> getFileLookup, bool validateFilesExist = true)
         {
             mods = mods.ToArray();
 
@@ -147,9 +147,9 @@ namespace StardewModdingAPI.Framework.ModLoading
                         // file doesn't exist
                         if (validateFilesExist)
                         {
-                            IFilePathLookup pathLookup = getFilePathLookup(mod.DirectoryPath);
-                            string fileName = pathLookup.GetFilePath(mod.Manifest.EntryDll!);
-                            if (!File.Exists(Path.Combine(mod.DirectoryPath, fileName)))
+                            IFileLookup pathLookup = getFileLookup(mod.DirectoryPath);
+                            FileInfo file = pathLookup.GetFile(mod.Manifest.EntryDll!);
+                            if (!file.Exists)
                             {
                                 mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
                                 continue;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 0465b6f1..3c6e1b6c 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -405,7 +405,7 @@ namespace StardewModdingAPI.Framework
                 mods = mods.Where(p => !p.IsIgnored).ToArray();
 
                 // load mods
-                resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl, getFilePathLookup: this.GetFilePathLookup);
+                resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl, getFileLookup: this.GetFileLookup);
                 mods = resolver.ProcessDependencies(mods, modDatabase).ToArray();
                 this.LoadMods(mods, this.Toolkit.JsonHelper, this.ContentCore, modDatabase);
 
@@ -1253,7 +1253,7 @@ namespace StardewModdingAPI.Framework
                     onLoadingFirstAsset: this.InitializeBeforeFirstAssetLoaded,
                     onAssetLoaded: this.OnAssetLoaded,
                     onAssetsInvalidated: this.OnAssetsInvalidated,
-                    getFilePathLookup: this.GetFilePathLookup,
+                    getFileLookup: this.GetFileLookup,
                     requestAssetOperations: this.RequestAssetOperations
                 );
                 if (this.ContentCore.Language != this.Translator.LocaleEnum)
@@ -1754,11 +1754,11 @@ namespace StardewModdingAPI.Framework
             if (mod.IsContentPack)
             {
                 IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
-                IFilePathLookup relativePathCache = this.GetFilePathLookup(mod.DirectoryPath);
+                IFileLookup fileLookup = this.GetFileLookup(mod.DirectoryPath);
                 GameContentHelper gameContentHelper = new(this.ContentCore, mod, mod.DisplayName, monitor, this.Reflection);
-                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
+                IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), this.Reflection);
                 TranslationHelper translationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
-                IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, modContentHelper, translationHelper, jsonHelper, relativePathCache);
+                IContentPack contentPack = new ContentPack(mod.DirectoryPath, manifest, modContentHelper, translationHelper, jsonHelper, fileLookup);
                 mod.SetMod(contentPack, monitor, translationHelper);
                 this.ModRegistry.Add(mod);
 
@@ -1771,16 +1771,13 @@ namespace StardewModdingAPI.Framework
             else
             {
                 // get mod info
-                string assemblyPath = Path.Combine(
-                    mod.DirectoryPath,
-                    this.GetFilePathLookup(mod.DirectoryPath).GetFilePath(manifest.EntryDll!)
-                );
+                FileInfo assemblyFile = this.GetFileLookup(mod.DirectoryPath).GetFile(manifest.EntryDll!);
 
                 // load mod
                 Assembly modAssembly;
                 try
                 {
-                    modAssembly = assemblyLoader.Load(mod, assemblyPath, assumeCompatible: mod.DataRecord?.Status == ModStatus.AssumeCompatible);
+                    modAssembly = assemblyLoader.Load(mod, assemblyFile, assumeCompatible: mod.DataRecord?.Status == ModStatus.AssumeCompatible);
                     this.ModRegistry.TrackAssemblies(mod, modAssembly);
                 }
                 catch (IncompatibleInstructionException) // details already in trace logs
@@ -1799,7 +1796,7 @@ namespace StardewModdingAPI.Framework
                 catch (Exception ex)
                 {
                     errorReasonPhrase = "its DLL couldn't be loaded.";
-                    if (ex is BadImageFormatException && !EnvironmentUtility.Is64BitAssembly(assemblyPath))
+                    if (ex is BadImageFormatException && !EnvironmentUtility.Is64BitAssembly(assemblyFile.FullName))
                         errorReasonPhrase = "it needs to be updated for 64-bit mode.";
 
                     errorDetails = $"Error: {ex.GetLogSummary()}";
@@ -1837,12 +1834,11 @@ namespace StardewModdingAPI.Framework
                     {
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
-                        IFilePathLookup relativePathLookup = this.GetFilePathLookup(mod.DirectoryPath);
 #pragma warning disable CS0612 // deprecated code
                         ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, mod, monitor, this.Reflection);
 #pragma warning restore CS0612
                         GameContentHelper gameContentHelper = new(contentCore, mod, mod.DisplayName, monitor, this.Reflection);
-                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), relativePathLookup, this.Reflection);
+                        IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), this.Reflection);
                         IContentPackHelper contentPackHelper = new ContentPackHelper(
                             mod: mod,
                             contentPacks: new Lazy<IContentPack[]>(GetContentPacks),
@@ -1896,13 +1892,13 @@ namespace StardewModdingAPI.Framework
 
             // create mod helpers
             IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
-            IFilePathLookup relativePathCache = this.GetFilePathLookup(packDirPath);
             GameContentHelper gameContentHelper = new(contentCore, fakeMod, packManifest.Name, packMonitor, this.Reflection);
-            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, fakeMod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), relativePathCache, this.Reflection);
+            IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, fakeMod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), this.Reflection);
             TranslationHelper packTranslationHelper = new(fakeMod, contentCore.GetLocale(), contentCore.Language);
 
             // add content pack
-            ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, relativePathCache);
+            IFileLookup fileLookup = this.GetFileLookup(packDirPath);
+            ContentPack contentPack = new(packDirPath, packManifest, packContentHelper, packTranslationHelper, this.Toolkit.JsonHelper, fileLookup);
             this.ReloadTranslationsForTemporaryContentPack(parentMod, contentPack);
             parentMod.FakeContentPacks.Add(new WeakReference<ContentPack>(contentPack));
 
@@ -2061,13 +2057,13 @@ namespace StardewModdingAPI.Framework
             return translations;
         }
 
-        /// <summary>Get a file path lookup for the given directory.</summary>
+        /// <summary>Get a file lookup for the given directory.</summary>
         /// <param name="rootDirectory">The root path to scan.</param>
-        private IFilePathLookup GetFilePathLookup(string rootDirectory)
+        private IFileLookup GetFileLookup(string rootDirectory)
         {
             return this.Settings.UseCaseInsensitivePaths
-                ? CaseInsensitivePathLookup.GetCachedFor(rootDirectory)
-                : MinimalPathLookup.Instance;
+                ? CaseInsensitiveFileLookup.GetCachedFor(rootDirectory)
+                : MinimalFileLookup.GetCachedFor(rootDirectory);
         }
 
         /// <summary>Get the map display device which applies SMAPI features like tile rotation to loaded maps.</summary>

From ecdda9b07798df516d8fd91d9c388b4be5f27230 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 7 May 2022 23:13:59 -0400
Subject: [PATCH 612/856] update filenames for case-insensitive path rewrite

---
 ...{CaseInsensitivePathLookup.cs => CaseInsensitiveFileLookup.cs} | 0
 .../Utilities/PathLookups/{IFilePathLookup.cs => IFileLookup.cs}  | 0
 .../PathLookups/{MinimalPathLookup.cs => MinimalFileLookup.cs}    | 0
 3 files changed, 0 insertions(+), 0 deletions(-)
 rename src/SMAPI.Toolkit/Utilities/PathLookups/{CaseInsensitivePathLookup.cs => CaseInsensitiveFileLookup.cs} (100%)
 rename src/SMAPI.Toolkit/Utilities/PathLookups/{IFilePathLookup.cs => IFileLookup.cs} (100%)
 rename src/SMAPI.Toolkit/Utilities/PathLookups/{MinimalPathLookup.cs => MinimalFileLookup.cs} (100%)

diff --git a/src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitiveFileLookup.cs
similarity index 100%
rename from src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitivePathLookup.cs
rename to src/SMAPI.Toolkit/Utilities/PathLookups/CaseInsensitiveFileLookup.cs
diff --git a/src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/IFileLookup.cs
similarity index 100%
rename from src/SMAPI.Toolkit/Utilities/PathLookups/IFilePathLookup.cs
rename to src/SMAPI.Toolkit/Utilities/PathLookups/IFileLookup.cs
diff --git a/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs b/src/SMAPI.Toolkit/Utilities/PathLookups/MinimalFileLookup.cs
similarity index 100%
rename from src/SMAPI.Toolkit/Utilities/PathLookups/MinimalPathLookup.cs
rename to src/SMAPI.Toolkit/Utilities/PathLookups/MinimalFileLookup.cs

From e286e5591b315712909024f79f46c46563b65a56 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 7 May 2022 23:26:34 -0400
Subject: [PATCH 613/856] enable case-insensitive file paths by default for
 Android/Linux players

---
 docs/release-notes.md                 | 2 ++
 src/SMAPI/Framework/Models/SConfig.cs | 3 ++-
 src/SMAPI/SMAPI.config.json           | 5 +++--
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d9761a6d..25dd295e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,8 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Enabled case-insensitive file paths by default for Android and Linux players.  
+    _This was temporarily disabled in SMAPI 3.14.1. This is no longer enabled by default for macOS and Windows players._
   * Improved performance of case-insensitive file paths.
 * For mod authors:
   * Dynamic content packs created via `helper.ContentPacks.CreateTemporary` or `CreateFake` are now listed in the log file.
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 80d0d9ba..56ab623c 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -2,6 +2,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using StardewModdingAPI.Internal.ConsoleWriting;
+using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Framework.Models
 {
@@ -22,7 +23,7 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(VerboseLogging)] = false,
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
-            [nameof(UsePintail)] = true,
+            [nameof(UsePintail)] = Constants.Platform is Platform.Android or Platform.Linux,
             [nameof(UseCaseInsensitivePaths)] = false
         };
 
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index bdd6374a..31513438 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -41,9 +41,10 @@ copy all the settings, or you may cause bugs due to overridden changes in future
 
     /**
      * Whether to make SMAPI file APIs case-insensitive, even on Linux.
-     * This is experimental, and the initial implementation may impact load times.
+     *
+     * When this is commented out, it'll be true on Android or Linux, and false otherwise.
      */
-    "UseCaseInsensitivePaths": false,
+    "UseCaseInsensitivePaths": null,
 
     /**
      * Whether to use the experimental Pintail API proxying library, instead of the original

From 37617e9c26cad93dac462bc1893d167a4692d9df Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 7 May 2022 23:34:30 -0400
Subject: [PATCH 614/856] tweak default settings logic

---
 src/SMAPI/Framework/Models/SConfig.cs | 18 +++++++++---------
 src/SMAPI/SMAPI.config.json           | 13 ++++++-------
 2 files changed, 15 insertions(+), 16 deletions(-)

diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 56ab623c..d27c6311 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -96,19 +96,19 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool verboseLogging, bool? rewriteMods, bool? usePintail, bool? useCaseInsensitivePaths, bool logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool? verboseLogging, bool? rewriteMods, bool? usePintail, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
-            this.CheckForUpdates = checkForUpdates;
-            this.ParanoidWarnings = paranoidWarnings ?? (bool)SConfig.DefaultValues[nameof(SConfig.ParanoidWarnings)];
-            this.UseBetaChannel = useBetaChannel ?? (bool)SConfig.DefaultValues[nameof(SConfig.UseBetaChannel)];
+            this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
+            this.ParanoidWarnings = paranoidWarnings ?? (bool)SConfig.DefaultValues[nameof(this.ParanoidWarnings)];
+            this.UseBetaChannel = useBetaChannel ?? (bool)SConfig.DefaultValues[nameof(this.UseBetaChannel)];
             this.GitHubProjectName = gitHubProjectName;
             this.WebApiBaseUrl = webApiBaseUrl;
-            this.VerboseLogging = verboseLogging;
-            this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(SConfig.RewriteMods)];
-            this.UsePintail = usePintail ?? (bool)SConfig.DefaultValues[nameof(SConfig.UsePintail)];
-            this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(SConfig.UseCaseInsensitivePaths)];
-            this.LogNetworkTraffic = logNetworkTraffic;
+            this.VerboseLogging = verboseLogging ?? (bool)SConfig.DefaultValues[nameof(this.VerboseLogging)];
+            this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(this.RewriteMods)];
+            this.UsePintail = usePintail ?? (bool)SConfig.DefaultValues[nameof(this.UsePintail)];
+            this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(this.UseCaseInsensitivePaths)];
+            this.LogNetworkTraffic = logNetworkTraffic ?? (bool)SConfig.DefaultValues[nameof(this.LogNetworkTraffic)];
             this.ConsoleColors = consoleColors;
             this.SuppressUpdateChecks = suppressUpdateChecks ?? Array.Empty<string>();
         }
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 31513438..8324f45b 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -40,9 +40,9 @@ copy all the settings, or you may cause bugs due to overridden changes in future
     "RewriteMods": true,
 
     /**
-     * Whether to make SMAPI file APIs case-insensitive, even on Linux.
+     * Whether to make SMAPI file APIs case-insensitive (even if the filesystem is case-sensitive).
      *
-     * When this is commented out, it'll be true on Android or Linux, and false otherwise.
+     * If null, it's only enabled on Android and Linux.
      */
     "UseCaseInsensitivePaths": null,
 
@@ -58,17 +58,16 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      * part of their normal functionality, so these warnings are meaningless without further
      * investigation.
      *
-     * When this is commented out, it'll be true for local debug builds and false otherwise.
+     * If null, it's only enabled for local debug builds.
      */
-    //"ParanoidWarnings": true,
+    "ParanoidWarnings": null,
 
     /**
      * Whether SMAPI should show newer beta versions as an available update.
      *
-     * When this is commented out, it'll be true if the current SMAPI version is beta, and false
-     * otherwise.
+     * If null, it's only enabled if the current SMAPI version is beta.
      */
-    //"UseBetaChannel": true,
+    "UseBetaChannel": null,
 
     /**
      * SMAPI's GitHub project name, used to perform update checks.

From b924fbae4ba6c490b84d06453d7f46fecf480bf4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 May 2022 12:24:52 -0400
Subject: [PATCH 615/856] fix default settings

---
 src/SMAPI/Framework/Models/SConfig.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index d27c6311..1c7cd3ed 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -23,8 +23,8 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(VerboseLogging)] = false,
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
-            [nameof(UsePintail)] = Constants.Platform is Platform.Android or Platform.Linux,
-            [nameof(UseCaseInsensitivePaths)] = false
+            [nameof(UsePintail)] = true,
+            [nameof(UseCaseInsensitivePaths)] = Constants.Platform is Platform.Android or Platform.Linux
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>

From 26f95bca63e199cda3b3de1fa71eacab3110d17b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 May 2022 18:22:35 -0400
Subject: [PATCH 616/856] optimize case where there's no legacy
 IAssetLoader/IAssetEditor instances

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Framework/ContentCoordinator.cs | 23 +++++++++++++----------
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 25dd295e..ee75bb83 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@
   * Enabled case-insensitive file paths by default for Android and Linux players.  
     _This was temporarily disabled in SMAPI 3.14.1. This is no longer enabled by default for macOS and Windows players._
   * Improved performance of case-insensitive file paths.
+  * Internal optimizations.
 * For mod authors:
   * Dynamic content packs created via `helper.ContentPacks.CreateTemporary` or `CreateFake` are now listed in the log file.
   * Fixed assets loaded through a fake content pack not working correctly since 3.14.0.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 02b753ba..f7cab23d 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -79,14 +79,14 @@ namespace StardewModdingAPI.Framework
         private Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>> LocaleCodes;
 
         /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
-        private readonly TickCacheDictionary<IAssetName, AssetOperationGroup[]> AssetOperationsByKey = new();
+        private readonly TickCacheDictionary<IAssetName, IList<AssetOperationGroup>> AssetOperationsByKey = new();
 
         /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetLoader"/> implementations.</summary>
-        [Obsolete]
+        [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         private readonly Dictionary<IAssetLoader, Dictionary<Type, AssetOperationGroup>> LegacyLoaderCache = new(ReferenceEqualityComparer.Instance);
 
         /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetEditor"/> implementations.</summary>
-        [Obsolete]
+        [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         private readonly Dictionary<IAssetEditor, Dictionary<Type, AssetOperationGroup>> LegacyEditorCache = new(ReferenceEqualityComparer.Instance);
 
 
@@ -100,11 +100,11 @@ namespace StardewModdingAPI.Framework
         public LocalizedContentManager.LanguageCode Language => this.MainContentManager.Language;
 
         /// <summary>Interceptors which provide the initial versions of matching assets.</summary>
-        [Obsolete]
+        [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         public IList<ModLinked<IAssetLoader>> Loaders { get; } = new List<ModLinked<IAssetLoader>>();
 
         /// <summary>Interceptors which edit matching assets after they're loaded.</summary>
-        [Obsolete]
+        [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         public IList<ModLinked<IAssetEditor>> Editors { get; } = new List<ModLinked<IAssetEditor>>();
 
         /// <summary>The absolute path to the <see cref="ContentManager.RootDirectory"/>.</summary>
@@ -449,12 +449,16 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The asset info to load or edit.</param>
-        public IEnumerable<AssetOperationGroup> GetAssetOperations<T>(IAssetInfo info)
+        public IList<AssetOperationGroup> GetAssetOperations<T>(IAssetInfo info)
             where T : notnull
         {
             return this.AssetOperationsByKey.GetOrSet(
                 info.Name,
-                () => this.GetAssetOperationsWithoutCache<T>(info).ToArray()
+#pragma warning disable CS0612, CS0618 // deprecated code
+                () => this.Editors.Count > 0 || this.Loaders.Count > 0
+                    ? this.GetAssetOperationsIncludingLegacyWithoutCache<T>(info).ToArray()
+#pragma warning restore CS0612, CS0618
+                    : this.RequestAssetOperations(info)
             );
         }
 
@@ -580,7 +584,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now, ignoring the <see cref="AssetOperationsByKey"/> cache.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The asset info to load or edit.</param>
-        private IEnumerable<AssetOperationGroup> GetAssetOperationsWithoutCache<T>(IAssetInfo info)
+        [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
+        private IEnumerable<AssetOperationGroup> GetAssetOperationsIncludingLegacyWithoutCache<T>(IAssetInfo info)
             where T : notnull
         {
             IAssetInfo legacyInfo = this.GetLegacyAssetInfo(info);
@@ -590,7 +595,6 @@ namespace StardewModdingAPI.Framework
                 yield return group;
 
             // legacy load operations
-#pragma warning disable CS0612, CS0618 // deprecated code
             foreach (ModLinked<IAssetLoader> loader in this.Loaders)
             {
                 // check if loader applies
@@ -686,7 +690,6 @@ namespace StardewModdingAPI.Framework
                     )
                 );
             }
-#pragma warning restore CS0612, CS0618
         }
 
         /// <summary>Get a cached asset operation group for a legacy <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> instance, creating it if needed.</summary>

From e2a3fc4f9974e4ea0c575c82be9b431904d6706d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 May 2022 18:28:02 -0400
Subject: [PATCH 617/856] avoid [Obsolete] without message for clarity

---
 src/SMAPI/Framework/ContentPack.cs              | 4 ++--
 src/SMAPI/Framework/ModHelpers/CommandHelper.cs | 2 +-
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs | 2 +-
 src/SMAPI/Framework/ModHelpers/ModHelper.cs     | 6 +++---
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index 5975fff6..70fe51f8 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -97,7 +97,7 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <inheritdoc />
-        [Obsolete]
+        [Obsolete($"Use {nameof(IContentPack.ModContent)}.{nameof(IModContentHelper.Load)} instead. This method will be removed in SMAPI 4.0.0.")]
         public T LoadAsset<T>(string key)
             where T : notnull
         {
@@ -105,7 +105,7 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <inheritdoc />
-        [Obsolete]
+        [Obsolete($"Use {nameof(IContentPack.ModContent)}.{nameof(IModContentHelper.GetInternalAssetName)} instead. This method will be removed in SMAPI 4.0.0.")]
         public string GetActualAssetKey(string key)
         {
             return this.ModContent.GetInternalAssetName(key).Name;
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index 226a8d69..f39ed42e 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -33,7 +33,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <inheritdoc />
-        [Obsolete]
+        [Obsolete("Use mod-provided APIs to integrate with mods instead. This method will be removed in SMAPI 4.0.0.")]
         public bool Trigger(string name, string[] arguments)
         {
             SCore.DeprecationManager.Warn(
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 3c2441e8..6a92da24 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -15,7 +15,7 @@ using StardewValley;
 namespace StardewModdingAPI.Framework.ModHelpers
 {
     /// <summary>Provides an API for loading content assets.</summary>
-    [Obsolete]
+    [Obsolete($"Use {nameof(IMod.Helper)}.{nameof(IModHelper.GameContent)} or {nameof(IMod.Helper)}.{nameof(IModHelper.ModContent)} instead. This interface will be removed in SMAPI 4.0.0.")]
     internal class ContentHelper : BaseHelper, IContentHelper
     {
         /*********
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index a23a9beb..008195d9 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -13,7 +13,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         ** Fields
         *********/
         /// <summary>The backing field for <see cref="Content"/>.</summary>
-        [Obsolete]
+        [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         private readonly ContentHelper ContentImpl;
 
 
@@ -27,7 +27,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public IModEvents Events { get; }
 
         /// <inheritdoc />
-        [Obsolete]
+        [Obsolete($"Use {nameof(IGameContentHelper)} or {nameof(IModContentHelper)} instead.")]
         public IContentHelper Content
         {
             get
@@ -128,7 +128,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
 
         /// <summary>Get the underlying instance for <see cref="IContentHelper"/>.</summary>
-        [Obsolete]
+        [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         public ContentHelper GetLegacyContentHelper()
         {
             return this.ContentImpl;

From 5f2e83969a0994d798b869b1b53e9fc82d556093 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 May 2022 18:37:23 -0400
Subject: [PATCH 618/856] only build AssetWithoutLocale when it's used

---
 src/SMAPI/Events/AssetRequestedEventArgs.cs | 19 +++++++++----------
 src/SMAPI/Framework/Content/AssetInfo.cs    |  6 ++++--
 src/SMAPI/Framework/SCore.cs                |  2 +-
 3 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index 3bcf83b9..6b00b1d9 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -19,19 +19,22 @@ namespace StardewModdingAPI.Events
         /// <summary>Get the mod metadata for a content pack, if it's a valid content pack for the mod.</summary>
         private readonly Func<IModMetadata, string?, string, IModMetadata?> GetOnBehalfOf;
 
+        /// <summary>The asset info being requested.</summary>
+        private readonly IAssetInfo AssetInfo;
+
 
         /*********
         ** Accessors
         *********/
         /// <summary>The name of the asset being requested.</summary>
-        public IAssetName Name { get; }
+        public IAssetName Name => this.AssetInfo.Name;
 
         /// <summary>The <see cref="Name"/> with any locale codes stripped.</summary>
         /// <remarks>For example, if <see cref="Name"/> contains a locale like <c>Data/Bundles.fr-FR</c>, this will be the name without locale like <c>Data/Bundles</c>. If the name has no locale, this field is equivalent.</remarks>
-        public IAssetName NameWithoutLocale { get; }
+        public IAssetName NameWithoutLocale => this.AssetInfo.NameWithoutLocale;
 
         /// <summary>The requested data type.</summary>
-        public Type DataType { get; }
+        public Type DataType => this.AssetInfo.DataType;
 
         /// <summary>The load operations requested by the event handler.</summary>
         internal IList<AssetLoadOperation> LoadOperations { get; } = new List<AssetLoadOperation>();
@@ -45,16 +48,12 @@ namespace StardewModdingAPI.Events
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod handling the event.</param>
-        /// <param name="name">The name of the asset being requested.</param>
-        /// <param name="dataType">The requested data type.</param>
-        /// <param name="nameWithoutLocale">The <paramref name="name"/> with any locale codes stripped.</param>
+        /// <param name="assetInfo">The asset info being requested.</param>
         /// <param name="getOnBehalfOf">Get the mod metadata for a content pack, if it's a valid content pack for the mod.</param>
-        internal AssetRequestedEventArgs(IModMetadata mod, IAssetName name, IAssetName nameWithoutLocale, Type dataType, Func<IModMetadata, string?, string, IModMetadata?> getOnBehalfOf)
+        internal AssetRequestedEventArgs(IModMetadata mod, IAssetInfo assetInfo, Func<IModMetadata, string?, string, IModMetadata?> getOnBehalfOf)
         {
             this.Mod = mod;
-            this.Name = name;
-            this.NameWithoutLocale = nameWithoutLocale;
-            this.DataType = dataType;
+            this.AssetInfo = assetInfo;
             this.GetOnBehalfOf = getOnBehalfOf;
         }
 
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 363fffb3..a4f0a408 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -13,6 +13,9 @@ namespace StardewModdingAPI.Framework.Content
         /// <summary>Normalizes an asset key to match the cache key.</summary>
         protected readonly Func<string, string> GetNormalizedPath;
 
+        /// <summary>The backing field for <see cref="NameWithoutLocale"/>.</summary>
+        private IAssetName? NameWithoutLocaleImpl;
+
 
         /*********
         ** Accessors
@@ -24,7 +27,7 @@ namespace StardewModdingAPI.Framework.Content
         public IAssetName Name { get; }
 
         /// <inheritdoc />
-        public IAssetName NameWithoutLocale { get; }
+        public IAssetName NameWithoutLocale => this.NameWithoutLocaleImpl ??= this.Name.GetBaseAssetName();
 
         /// <inheritdoc />
         [Obsolete($"Use {nameof(AssetInfo.Name)} or {nameof(AssetInfo.NameWithoutLocale)} instead. This property will be removed in SMAPI 4.0.0.")]
@@ -64,7 +67,6 @@ namespace StardewModdingAPI.Framework.Content
         {
             this.Locale = locale;
             this.Name = assetName;
-            this.NameWithoutLocale = assetName.GetBaseAssetName();
             this.DataType = type;
             this.GetNormalizedPath = getNormalizedPath;
         }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 3c6e1b6c..f882682e 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1160,7 +1160,7 @@ namespace StardewModdingAPI.Framework
             this.EventManager.AssetRequested.Raise(
                 invoke: (mod, invoke) =>
                 {
-                    AssetRequestedEventArgs args = new(mod, asset.Name, asset.NameWithoutLocale, asset.DataType, this.GetOnBehalfOfContentPack);
+                    AssetRequestedEventArgs args = new(mod, asset, this.GetOnBehalfOfContentPack);
 
                     invoke(args);
 

From f8f8b237996a1c883d43e539a379bf713a5fd7be Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 May 2022 18:50:07 -0400
Subject: [PATCH 619/856] use records for asset edit operations

---
 src/SMAPI/Events/AssetRequestedEventArgs.cs   | 24 ++++++------
 .../Framework/Content/AssetEditOperation.cs   | 39 +++----------------
 .../Framework/Content/AssetLoadOperation.cs   | 39 +++----------------
 .../Framework/Content/AssetOperationGroup.cs  | 33 ++--------------
 src/SMAPI/Framework/ContentCoordinator.cs     | 28 ++++++-------
 5 files changed, 40 insertions(+), 123 deletions(-)

diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index 6b00b1d9..d0aef1db 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -72,10 +72,10 @@ namespace StardewModdingAPI.Events
         {
             this.LoadOperations.Add(
                 new AssetLoadOperation(
-                    mod: this.Mod,
-                    priority: priority,
-                    onBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "load assets"),
-                    getData: _ => load()
+                    Mod: this.Mod,
+                    OnBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "load assets"),
+                    Priority: priority,
+                    GetData: _ => load()
                 )
             );
         }
@@ -96,10 +96,10 @@ namespace StardewModdingAPI.Events
         {
             this.LoadOperations.Add(
                 new AssetLoadOperation(
-                    mod: this.Mod,
-                    priority: priority,
-                    onBehalfOf: null,
-                    _ => this.Mod.Mod!.Helper.ModContent.Load<TAsset>(relativePath)
+                    Mod: this.Mod,
+                    OnBehalfOf: null,
+                    Priority: priority,
+                    GetData: _ => this.Mod.Mod!.Helper.ModContent.Load<TAsset>(relativePath)
                 )
             );
         }
@@ -119,10 +119,10 @@ namespace StardewModdingAPI.Events
         {
             this.EditOperations.Add(
                 new AssetEditOperation(
-                    mod: this.Mod,
-                    priority: priority,
-                    onBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "edit assets"),
-                    apply
+                    Mod: this.Mod,
+                    Priority: priority,
+                    OnBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "edit assets"),
+                    ApplyEdit: apply
                 )
             );
         }
diff --git a/src/SMAPI/Framework/Content/AssetEditOperation.cs b/src/SMAPI/Framework/Content/AssetEditOperation.cs
index 464948b0..11b8811b 100644
--- a/src/SMAPI/Framework/Content/AssetEditOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetEditOperation.cs
@@ -4,38 +4,9 @@ using StardewModdingAPI.Events;
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>An edit to apply to an asset when it's requested from the content pipeline.</summary>
-    internal class AssetEditOperation
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The mod applying the edit.</summary>
-        public IModMetadata Mod { get; }
-
-        /// <summary>If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</summary>
-        public AssetEditPriority Priority { get; }
-
-        /// <summary>The content pack on whose behalf the edit is being applied, if any.</summary>
-        public IModMetadata? OnBehalfOf { get; }
-
-        /// <summary>Apply the edit to an asset.</summary>
-        public Action<IAssetData> ApplyEdit { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="mod">The mod applying the edit.</param>
-        /// <param name="priority">If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</param>
-        /// <param name="onBehalfOf">The content pack on whose behalf the edit is being applied, if any.</param>
-        /// <param name="applyEdit">Apply the edit to an asset.</param>
-        public AssetEditOperation(IModMetadata mod, AssetEditPriority priority, IModMetadata? onBehalfOf, Action<IAssetData> applyEdit)
-        {
-            this.Mod = mod;
-            this.Priority = priority;
-            this.OnBehalfOf = onBehalfOf;
-            this.ApplyEdit = applyEdit;
-        }
-    }
+    /// <param name="Mod">The mod applying the edit.</param>
+    /// <param name="Priority">If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</param>
+    /// <param name="OnBehalfOf">The content pack on whose behalf the edit is being applied, if any.</param>
+    /// <param name="ApplyEdit">Apply the edit to an asset.</param>
+    internal record AssetEditOperation(IModMetadata Mod, AssetEditPriority Priority, IModMetadata? OnBehalfOf, Action<IAssetData> ApplyEdit);
 }
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
index b6cdec27..7af07dfd 100644
--- a/src/SMAPI/Framework/Content/AssetLoadOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -4,38 +4,9 @@ using StardewModdingAPI.Events;
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>An operation which provides the initial instance of an asset when it's requested from the content pipeline.</summary>
-    internal class AssetLoadOperation
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The mod loading the asset.</summary>
-        public IModMetadata Mod { get; }
-
-        /// <summary>The content pack on whose behalf the asset is being loaded, if any.</summary>
-        public IModMetadata? OnBehalfOf { get; }
-
-        /// <summary>If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</summary>
-        public AssetLoadPriority Priority { get; }
-
-        /// <summary>Load the initial value for an asset.</summary>
-        public Func<IAssetInfo, object> GetData { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="mod">The mod applying the edit.</param>
-        /// <param name="priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
-        /// <param name="onBehalfOf">The content pack on whose behalf the asset is being loaded, if any.</param>
-        /// <param name="getData">Load the initial value for an asset.</param>
-        public AssetLoadOperation(IModMetadata mod, AssetLoadPriority priority, IModMetadata? onBehalfOf, Func<IAssetInfo, object> getData)
-        {
-            this.Mod = mod;
-            this.Priority = priority;
-            this.OnBehalfOf = onBehalfOf;
-            this.GetData = getData;
-        }
-    }
+    /// <param name="Mod">The mod applying the edit.</param>
+    /// <param name="Priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
+    /// <param name="OnBehalfOf">The content pack on whose behalf the asset is being loaded, if any.</param>
+    /// <param name="GetData">Load the initial value for an asset.</param>
+    internal record AssetLoadOperation(IModMetadata Mod, IModMetadata? OnBehalfOf, AssetLoadPriority Priority, Func<IAssetInfo, object> GetData);
 }
diff --git a/src/SMAPI/Framework/Content/AssetOperationGroup.cs b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
index a2fcb722..1566a8f0 100644
--- a/src/SMAPI/Framework/Content/AssetOperationGroup.cs
+++ b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
@@ -1,33 +1,8 @@
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>A set of operations to apply to an asset for a given <see cref="IAssetEditor"/> or <see cref="IAssetLoader"/> implementation.</summary>
-    internal class AssetOperationGroup
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The mod applying the changes.</summary>
-        public IModMetadata Mod { get; }
-
-        /// <summary>The load operations to apply.</summary>
-        public AssetLoadOperation[] LoadOperations { get; }
-
-        /// <summary>The edit operations to apply.</summary>
-        public AssetEditOperation[] EditOperations { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="mod">The mod applying the changes.</param>
-        /// <param name="loadOperations">The load operations to apply.</param>
-        /// <param name="editOperations">The edit operations to apply.</param>
-        public AssetOperationGroup(IModMetadata mod, AssetLoadOperation[] loadOperations, AssetEditOperation[] editOperations)
-        {
-            this.Mod = mod;
-            this.LoadOperations = loadOperations;
-            this.EditOperations = editOperations;
-        }
-    }
+    /// <param name="Mod">The mod applying the changes.</param>
+    /// <param name="LoadOperations">The load operations to apply.</param>
+    /// <param name="EditOperations">The edit operations to apply.</param>
+    internal record AssetOperationGroup(IModMetadata Mod, AssetLoadOperation[] LoadOperations, AssetEditOperation[] EditOperations);
 }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index f7cab23d..6702f5e6 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -615,19 +615,19 @@ namespace StardewModdingAPI.Framework
                     editor: loader.Data,
                     dataType: info.DataType,
                     createGroup: () => new AssetOperationGroup(
-                        mod: loader.Mod,
-                        loadOperations: new[]
+                        Mod: loader.Mod,
+                        LoadOperations: new[]
                         {
                             new AssetLoadOperation(
-                                mod: loader.Mod,
-                                priority: AssetLoadPriority.Exclusive,
-                                onBehalfOf: null,
-                                getData: assetInfo => loader.Data.Load<T>(
+                                Mod: loader.Mod,
+                                OnBehalfOf: null,
+                                Priority: AssetLoadPriority.Exclusive,
+                                GetData: assetInfo => loader.Data.Load<T>(
                                     this.GetLegacyAssetInfo(assetInfo)
                                 )
                             )
                         },
-                        editOperations: Array.Empty<AssetEditOperation>()
+                        EditOperations: Array.Empty<AssetEditOperation>()
                     )
                 );
             }
@@ -674,15 +674,15 @@ namespace StardewModdingAPI.Framework
                     editor: editor.Data,
                     dataType: info.DataType,
                     createGroup: () => new AssetOperationGroup(
-                        mod: editor.Mod,
-                        loadOperations: Array.Empty<AssetLoadOperation>(),
-                        editOperations: new[]
+                        Mod: editor.Mod,
+                        LoadOperations: Array.Empty<AssetLoadOperation>(),
+                        EditOperations: new[]
                         {
                             new AssetEditOperation(
-                                mod: editor.Mod,
-                                priority: priority,
-                                onBehalfOf: null,
-                                applyEdit: assetData => editor.Data.Edit<T>(
+                                Mod: editor.Mod,
+                                OnBehalfOf: null,
+                                Priority: priority,
+                                ApplyEdit: assetData => editor.Data.Edit<T>(
                                     this.GetLegacyAssetData(assetData)
                                 )
                             )

From cbe8b597cb55285dea2bb2c34ab26f148a76bc17 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 May 2022 20:11:02 -0400
Subject: [PATCH 620/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 9 +++++----
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 44ee0caf..0436ed5b 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.14.1</Version>
+    <Version>3.14.2</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index ee75bb83..98747613 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,12 +1,13 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.14.2
+Released 08 May 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
   * Enabled case-insensitive file paths by default for Android and Linux players.  
-    _This was temporarily disabled in SMAPI 3.14.1. This is no longer enabled by default for macOS and Windows players._
-  * Improved performance of case-insensitive file paths.
-  * Internal optimizations.
+    _This was temporarily disabled in SMAPI 3.14.1, and will remain disabled by default on macOS and Windows since their filesystems are already case-insensitive._
+  * Various performance improvements.
 * For mod authors:
   * Dynamic content packs created via `helper.ContentPacks.CreateTemporary` or `CreateFake` are now listed in the log file.
   * Fixed assets loaded through a fake content pack not working correctly since 3.14.0.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index edbdd081..c263456a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.14.1",
+    "Version": "3.14.2",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.14.1"
+    "MinimumApiVersion": "3.14.2"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index af67453d..6e6a271f 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.14.1",
+    "Version": "3.14.2",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.14.1"
+    "MinimumApiVersion": "3.14.2"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 14b68cb4..5ba91568 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.14.1",
+    "Version": "3.14.2",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.14.1"
+    "MinimumApiVersion": "3.14.2"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index b1a9cc82..a289ce4b 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.14.1";
+        internal static string RawApiVersion = "3.14.2";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 7a91cf1cd875bc62072571e1b259a10cbacdaaab Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 9 May 2022 00:18:37 -0400
Subject: [PATCH 621/856] update schema for Content Patcher 1.26.0

---
 docs/release-notes.md                              | 4 ++++
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 9 +++++++--
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 98747613..23783a8a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.26.0.
+
 ## 3.14.2
 Released 08 May 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index 4975a973..f0fe74c2 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -14,9 +14,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features, avoid obsolete behavior, and reduce load times.",
             "type": "string",
-            "const": "1.25.0",
+            "const": "1.26.0",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. You should always use the latest format version (currently 1.25.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
+                "const": "Incorrect value '@value'. You should always use the latest format version (currently 1.26.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
             }
         },
         "ConfigSchema": {
@@ -51,6 +51,11 @@
                         "description": "An optional explanation of the config field for players, shown in UIs like Generic Mod Config Menu.",
                         "type": "string"
                     },
+                    "Section": {
+                        "title": "Section",
+                        "description": "An optional section key to group related fields on config UIs. This can be the literal text to show, or you can add a translation with the key 'config.section.<section value>.name' and '.description' to add a translated name & tooltip.",
+                        "type": "string" 
+                    },
 
                     "additionalProperties": false
                 },

From eb01aa275b272774c48672a2560455d3fb902a4e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 10 May 2022 18:51:37 -0400
Subject: [PATCH 622/856] fix asset propagation for player sprite recolor masks

---
 docs/release-notes.md                     | 3 +++
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 4 +++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 23783a8a..3ba11edd 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 # Release notes
 ## Upcoming release
+* For mod authors:
+  * Fixed asset propagation for player sprites not fully updating recolor masks in some cases.
+
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.26.0.
 
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 12b73515..e014f9a9 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1017,7 +1017,9 @@ namespace StardewModdingAPI.Metadata
 
             foreach (Farmer player in players)
             {
-                this.Reflection.GetField<Dictionary<string, Dictionary<int, List<int>>>?>(typeof(FarmerRenderer), "_recolorOffsets").GetValue()?.Remove(player.getTexture());
+                var recolorOffsets = this.Reflection.GetField<Dictionary<string, Dictionary<int, List<int>>>?>(typeof(FarmerRenderer), "_recolorOffsets").GetValue();
+                recolorOffsets?.Clear();
+
                 player.FarmerRenderer.MarkSpriteDirty();
             }
 

From 8c8ec6a4572fd3e59b738fc7545fcddc764f4519 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 10 May 2022 23:05:24 -0400
Subject: [PATCH 623/856] remove unused IsPerformanceCritical event field

---
 src/SMAPI/Framework/Events/EventManager.cs  | 34 ++++++++++-----------
 src/SMAPI/Framework/Events/IManagedEvent.cs |  3 --
 src/SMAPI/Framework/Events/ManagedEvent.cs  |  7 +----
 3 files changed, 18 insertions(+), 26 deletions(-)

diff --git a/src/SMAPI/Framework/Events/EventManager.cs b/src/SMAPI/Framework/Events/EventManager.cs
index 41540047..b21d5c7d 100644
--- a/src/SMAPI/Framework/Events/EventManager.cs
+++ b/src/SMAPI/Framework/Events/EventManager.cs
@@ -198,9 +198,9 @@ namespace StardewModdingAPI.Framework.Events
         public EventManager(ModRegistry modRegistry)
         {
             // create shortcut initializers
-            ManagedEvent<TEventArgs> ManageEventOf<TEventArgs>(string typeName, string eventName, bool isPerformanceCritical = false)
+            ManagedEvent<TEventArgs> ManageEventOf<TEventArgs>(string typeName, string eventName)
             {
-                return new ManagedEvent<TEventArgs>($"{typeName}.{eventName}", modRegistry, isPerformanceCritical);
+                return new ManagedEvent<TEventArgs>($"{typeName}.{eventName}", modRegistry);
             }
 
             // init events
@@ -210,21 +210,21 @@ namespace StardewModdingAPI.Framework.Events
             this.LocaleChanged = ManageEventOf<LocaleChangedEventArgs>(nameof(IModEvents.Content), nameof(IContentEvents.LocaleChanged));
 
             this.MenuChanged = ManageEventOf<MenuChangedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.MenuChanged));
-            this.Rendering = ManageEventOf<RenderingEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendering), isPerformanceCritical: true);
-            this.Rendered = ManageEventOf<RenderedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendered), isPerformanceCritical: true);
-            this.RenderingWorld = ManageEventOf<RenderingWorldEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderingWorld), isPerformanceCritical: true);
-            this.RenderedWorld = ManageEventOf<RenderedWorldEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderedWorld), isPerformanceCritical: true);
-            this.RenderingActiveMenu = ManageEventOf<RenderingActiveMenuEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderingActiveMenu), isPerformanceCritical: true);
-            this.RenderedActiveMenu = ManageEventOf<RenderedActiveMenuEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderedActiveMenu), isPerformanceCritical: true);
-            this.RenderingHud = ManageEventOf<RenderingHudEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderingHud), isPerformanceCritical: true);
-            this.RenderedHud = ManageEventOf<RenderedHudEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderedHud), isPerformanceCritical: true);
+            this.Rendering = ManageEventOf<RenderingEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendering));
+            this.Rendered = ManageEventOf<RenderedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.Rendered));
+            this.RenderingWorld = ManageEventOf<RenderingWorldEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderingWorld));
+            this.RenderedWorld = ManageEventOf<RenderedWorldEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderedWorld));
+            this.RenderingActiveMenu = ManageEventOf<RenderingActiveMenuEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderingActiveMenu));
+            this.RenderedActiveMenu = ManageEventOf<RenderedActiveMenuEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderedActiveMenu));
+            this.RenderingHud = ManageEventOf<RenderingHudEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderingHud));
+            this.RenderedHud = ManageEventOf<RenderedHudEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.RenderedHud));
             this.WindowResized = ManageEventOf<WindowResizedEventArgs>(nameof(IModEvents.Display), nameof(IDisplayEvents.WindowResized));
 
             this.GameLaunched = ManageEventOf<GameLaunchedEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.GameLaunched));
-            this.UpdateTicking = ManageEventOf<UpdateTickingEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.UpdateTicking), isPerformanceCritical: true);
-            this.UpdateTicked = ManageEventOf<UpdateTickedEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.UpdateTicked), isPerformanceCritical: true);
-            this.OneSecondUpdateTicking = ManageEventOf<OneSecondUpdateTickingEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.OneSecondUpdateTicking), isPerformanceCritical: true);
-            this.OneSecondUpdateTicked = ManageEventOf<OneSecondUpdateTickedEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.OneSecondUpdateTicked), isPerformanceCritical: true);
+            this.UpdateTicking = ManageEventOf<UpdateTickingEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.UpdateTicking));
+            this.UpdateTicked = ManageEventOf<UpdateTickedEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.UpdateTicked));
+            this.OneSecondUpdateTicking = ManageEventOf<OneSecondUpdateTickingEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.OneSecondUpdateTicking));
+            this.OneSecondUpdateTicked = ManageEventOf<OneSecondUpdateTickedEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.OneSecondUpdateTicked));
             this.SaveCreating = ManageEventOf<SaveCreatingEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.SaveCreating));
             this.SaveCreated = ManageEventOf<SaveCreatedEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.SaveCreated));
             this.Saving = ManageEventOf<SavingEventArgs>(nameof(IModEvents.GameLoop), nameof(IGameLoopEvents.Saving));
@@ -238,7 +238,7 @@ namespace StardewModdingAPI.Framework.Events
             this.ButtonsChanged = ManageEventOf<ButtonsChangedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.ButtonsChanged));
             this.ButtonPressed = ManageEventOf<ButtonPressedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.ButtonPressed));
             this.ButtonReleased = ManageEventOf<ButtonReleasedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.ButtonReleased));
-            this.CursorMoved = ManageEventOf<CursorMovedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.CursorMoved), isPerformanceCritical: true);
+            this.CursorMoved = ManageEventOf<CursorMovedEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.CursorMoved));
             this.MouseWheelScrolled = ManageEventOf<MouseWheelScrolledEventArgs>(nameof(IModEvents.Input), nameof(IInputEvents.MouseWheelScrolled));
 
             this.PeerContextReceived = ManageEventOf<PeerContextReceivedEventArgs>(nameof(IModEvents.Multiplayer), nameof(IMultiplayerEvents.PeerContextReceived));
@@ -261,8 +261,8 @@ namespace StardewModdingAPI.Framework.Events
             this.FurnitureListChanged = ManageEventOf<FurnitureListChangedEventArgs>(nameof(IModEvents.World), nameof(IWorldEvents.FurnitureListChanged));
 
             this.LoadStageChanged = ManageEventOf<LoadStageChangedEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.LoadStageChanged));
-            this.UnvalidatedUpdateTicking = ManageEventOf<UnvalidatedUpdateTickingEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.UnvalidatedUpdateTicking), isPerformanceCritical: true);
-            this.UnvalidatedUpdateTicked = ManageEventOf<UnvalidatedUpdateTickedEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.UnvalidatedUpdateTicked), isPerformanceCritical: true);
+            this.UnvalidatedUpdateTicking = ManageEventOf<UnvalidatedUpdateTickingEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.UnvalidatedUpdateTicking));
+            this.UnvalidatedUpdateTicked = ManageEventOf<UnvalidatedUpdateTickedEventArgs>(nameof(IModEvents.Specialized), nameof(ISpecializedEvents.UnvalidatedUpdateTicked));
         }
     }
 }
diff --git a/src/SMAPI/Framework/Events/IManagedEvent.cs b/src/SMAPI/Framework/Events/IManagedEvent.cs
index e4e3ca08..0ae8c55a 100644
--- a/src/SMAPI/Framework/Events/IManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/IManagedEvent.cs
@@ -8,8 +8,5 @@ namespace StardewModdingAPI.Framework.Events
         *********/
         /// <summary>A human-readable name for the event.</summary>
         string EventName { get; }
-
-        /// <summary>Whether the event is typically called at least once per second.</summary>
-        bool IsPerformanceCritical { get; }
     }
 }
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index 4b8a770d..a16beb77 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -36,9 +36,6 @@ namespace StardewModdingAPI.Framework.Events
         /// <inheritdoc />
         public string EventName { get; }
 
-        /// <inheritdoc />
-        public bool IsPerformanceCritical { get; }
-
 
         /*********
         ** Public methods
@@ -46,12 +43,10 @@ namespace StardewModdingAPI.Framework.Events
         /// <summary>Construct an instance.</summary>
         /// <param name="eventName">A human-readable name for the event.</param>
         /// <param name="modRegistry">The mod registry with which to identify mods.</param>
-        /// <param name="isPerformanceCritical">Whether the event is typically called at least once per second.</param>
-        public ManagedEvent(string eventName, ModRegistry modRegistry, bool isPerformanceCritical = false)
+        public ManagedEvent(string eventName, ModRegistry modRegistry)
         {
             this.EventName = eventName;
             this.ModRegistry = modRegistry;
-            this.IsPerformanceCritical = isPerformanceCritical;
         }
 
         /// <summary>Get whether anything is listening to the event.</summary>

From e14916f9622592a993fad54fe184a03de0b95c7b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 17:12:58 -0400
Subject: [PATCH 624/856] add error code to SContentLoadException

---
 .../ContentManagers/BaseContentManager.cs     |  4 +--
 .../ContentManagers/ModContentManager.cs      | 27 ++++++++++---------
 .../Exceptions/ContentLoadErrorType.cs        | 21 +++++++++++++++
 .../Exceptions/SContentLoadException.cs       | 15 +++++++++--
 .../Framework/ModHelpers/ContentHelper.cs     |  4 +--
 .../Framework/ModHelpers/GameContentHelper.cs |  2 +-
 .../Framework/ModHelpers/ModContentHelper.cs  |  2 +-
 7 files changed, 54 insertions(+), 21 deletions(-)
 create mode 100644 src/SMAPI/Framework/Exceptions/ContentLoadErrorType.cs

diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index e4695588..575d252e 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -198,9 +198,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // NOTE: the game checks for ContentLoadException to handle invalid keys, so avoid
             // throwing other types like ArgumentException here.
             if (string.IsNullOrWhiteSpace(assetName))
-                throw new SContentLoadException("The asset key or local path is empty.");
+                throw new SContentLoadException(ContentLoadErrorType.InvalidName, "The asset key or local path is empty.");
             if (assetName.Intersect(Path.GetInvalidPathChars()).Any())
-                throw new SContentLoadException("The asset key or local path contains invalid characters.");
+                throw new SContentLoadException(ContentLoadErrorType.InvalidName, "The asset key or local path contains invalid characters.");
 
             return this.Cache.NormalizeKey(assetName);
         }
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 7cac8f36..85e109c8 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -94,7 +94,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string? contentManagerID, out IAssetName? relativePath))
                 {
                     if (contentManagerID != this.Name)
-                        throw this.GetLoadError(assetName, "can't load a different mod's managed asset key through this mod content manager.");
+                        throw this.GetLoadError(assetName, ContentLoadErrorType.AccessDenied, "can't load a different mod's managed asset key through this mod content manager.");
                     assetName = relativePath;
                 }
             }
@@ -106,7 +106,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // get file
                 FileInfo file = this.GetModFile<T>(assetName.Name);
                 if (!file.Exists)
-                    throw this.GetLoadError(assetName, "the specified path doesn't exist.");
+                    throw this.GetLoadError(assetName, ContentLoadErrorType.AssetDoesNotExist, "the specified path doesn't exist.");
 
                 // load content
                 asset = file.Extension.ToLower() switch
@@ -121,7 +121,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
             catch (Exception ex) when (ex is not SContentLoadException)
             {
-                throw this.GetLoadError(assetName, "an unexpected occurred.", ex);
+                throw this.GetLoadError(assetName, ContentLoadErrorType.Other, "an unexpected occurred.", ex);
             }
 
             // track & return asset
@@ -157,7 +157,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // validate
             if (!typeof(T).IsAssignableFrom(typeof(XmlSource)))
-                throw this.GetLoadError(assetName, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(XmlSource)}'.");
+                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(XmlSource)}'.");
 
             // load
             string source = File.ReadAllText(file.FullName);
@@ -171,7 +171,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadDataFile<T>(IAssetName assetName, FileInfo file)
         {
             if (!this.JsonHelper.ReadJsonFileIfExists(file.FullName, out T? asset))
-                throw this.GetLoadError(assetName, "the JSON file is invalid."); // should never happen since we check for file existence before calling this method
+                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, "the JSON file is invalid."); // should never happen since we check for file existence before calling this method
 
             return asset;
         }
@@ -184,7 +184,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // validate
             if (typeof(T) != typeof(Texture2D))
-                throw this.GetLoadError(assetName, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Texture2D)}'.");
+                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Texture2D)}'.");
 
             // load
             using FileStream stream = File.OpenRead(file.FullName);
@@ -201,7 +201,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // validate
             if (typeof(T) != typeof(Map))
-                throw this.GetLoadError(assetName, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Map)}'.");
+                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Map)}'.");
 
             // load
             FormatManager formatManager = FormatManager.Instance;
@@ -239,16 +239,17 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file to load.</param>
         private T HandleUnknownFileType<T>(IAssetName assetName, FileInfo file)
         {
-            throw this.GetLoadError(assetName, $"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'.");
+            throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidName, $"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'.");
         }
 
         /// <summary>Get an error which indicates that an asset couldn't be loaded.</summary>
+        /// <param name="errorType">Why loading an asset through the content pipeline failed.</param>
         /// <param name="assetName">The asset name that failed to load.</param>
         /// <param name="reasonPhrase">The reason the file couldn't be loaded.</param>
         /// <param name="exception">The underlying exception, if applicable.</param>
-        private SContentLoadException GetLoadError(IAssetName assetName, string reasonPhrase, Exception? exception = null)
+        private SContentLoadException GetLoadError(IAssetName assetName, ContentLoadErrorType errorType, string reasonPhrase, Exception? exception = null)
         {
-            return new($"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);
+            return new(errorType, $"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);
         }
 
         /// <summary>Get a file from the mod folder.</summary>
@@ -328,13 +329,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // validate tilesheet path
                 string errorPrefix = $"{this.ModName} loaded map '{relativeMapPath}' with invalid tilesheet path '{imageSource}'.";
                 if (Path.IsPathRooted(imageSource) || PathUtilities.GetSegments(imageSource).Contains(".."))
-                    throw new SContentLoadException($"{errorPrefix} Tilesheet paths must be a relative path without directory climbing (../).");
+                    throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} Tilesheet paths must be a relative path without directory climbing (../).");
 
                 // load best match
                 try
                 {
                     if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out IAssetName? assetName, out string? error))
-                        throw new SContentLoadException($"{errorPrefix} {error}");
+                        throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} {error}");
 
                     if (assetName is not null)
                     {
@@ -346,7 +347,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 }
                 catch (Exception ex) when (ex is not SContentLoadException)
                 {
-                    throw new SContentLoadException($"{errorPrefix} The tilesheet couldn't be loaded.", ex);
+                    throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} The tilesheet couldn't be loaded.", ex);
                 }
             }
         }
diff --git a/src/SMAPI/Framework/Exceptions/ContentLoadErrorType.cs b/src/SMAPI/Framework/Exceptions/ContentLoadErrorType.cs
new file mode 100644
index 00000000..16689b67
--- /dev/null
+++ b/src/SMAPI/Framework/Exceptions/ContentLoadErrorType.cs
@@ -0,0 +1,21 @@
+namespace StardewModdingAPI.Framework.Exceptions
+{
+    /// <summary>Indicates why loading an asset through the content pipeline failed.</summary>
+    internal enum ContentLoadErrorType
+    {
+        /// <summary>The asset name is empty or has an invalid format.</summary>
+        InvalidName,
+
+        /// <summary>The asset doesn't exist.</summary>
+        AssetDoesNotExist,
+
+        /// <summary>The asset is not available in the current context (e.g. an attempt to load another mod's assets).</summary>
+        AccessDenied,
+
+        /// <summary>The asset exists, but the data could not be deserialized or it doesn't match the expected type.</summary>
+        InvalidData,
+
+        /// <summary>An unknown error occurred.</summary>
+        Other
+    }
+}
diff --git a/src/SMAPI/Framework/Exceptions/SContentLoadException.cs b/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
index be1fe748..4db24d06 100644
--- a/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
+++ b/src/SMAPI/Framework/Exceptions/SContentLoadException.cs
@@ -6,13 +6,24 @@ namespace StardewModdingAPI.Framework.Exceptions
     /// <summary>An implementation of <see cref="ContentLoadException"/> used by SMAPI to detect whether it was thrown by SMAPI or the underlying framework.</summary>
     internal class SContentLoadException : ContentLoadException
     {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>Why loading the asset through the content pipeline failed.</summary>
+        public ContentLoadErrorType ErrorType { get; }
+
+
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="errorType">Why loading the asset through the content pipeline failed.</param>
         /// <param name="message">The error message.</param>
         /// <param name="ex">The underlying exception, if any.</param>
-        public SContentLoadException(string message, Exception? ex = null)
-            : base(message, ex) { }
+        public SContentLoadException(ContentLoadErrorType errorType, string message, Exception? ex = null)
+            : base(message, ex)
+        {
+            this.ErrorType = errorType;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 6a92da24..24e511c3 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -135,12 +135,12 @@ namespace StardewModdingAPI.Framework.ModHelpers
                         return this.ModContentManager.LoadExact<T>(assetName, useCache: false);
 
                     default:
-                        throw new SContentLoadException($"{this.Mod.DisplayName} failed loading content asset '{key}' from {source}: unknown content source '{source}'.");
+                        throw new SContentLoadException(ContentLoadErrorType.Other, $"{this.Mod.DisplayName} failed loading content asset '{key}' from {source}: unknown content source '{source}'.");
                 }
             }
             catch (Exception ex) when (ex is not SContentLoadException)
             {
-                throw new SContentLoadException($"{this.Mod.DisplayName} failed loading content asset '{key}' from {source}.", ex);
+                throw new SContentLoadException(ContentLoadErrorType.Other, $"{this.Mod.DisplayName} failed loading content asset '{key}' from {source}.", ex);
             }
         }
 
diff --git a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
index 232e9287..7c4eda89 100644
--- a/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/GameContentHelper.cs
@@ -85,7 +85,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             }
             catch (Exception ex) when (ex is not SContentLoadException)
             {
-                throw new SContentLoadException($"{this.ModName} failed loading content asset '{assetName}' from the game content.", ex);
+                throw new SContentLoadException(ContentLoadErrorType.Other, $"{this.ModName} failed loading content asset '{assetName}' from the game content.", ex);
             }
         }
 
diff --git a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
index 6429f9bf..5fcb80b2 100644
--- a/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModContentHelper.cs
@@ -58,7 +58,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             }
             catch (Exception ex) when (ex is not SContentLoadException)
             {
-                throw new SContentLoadException($"{this.ModName} failed loading content asset '{relativePath}' from its mod folder.", ex);
+                throw new SContentLoadException(ContentLoadErrorType.Other, $"{this.ModName} failed loading content asset '{relativePath}' from its mod folder.", ex);
             }
         }
 

From d097825c84bbe7d4b4812d4948358dd22abd166a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 17:25:06 -0400
Subject: [PATCH 625/856] fix error when mod loads XNB mod file without
 extension

---
 docs/release-notes.md                         |  1 +
 .../Framework/ModHelpers/ContentHelper.cs     | 27 ++++++++++++++++++-
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3ba11edd..d66fea5d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For mod authors:
+  * Fixed error when loading a `.xnb` file through the old content API without the file extension.
   * Fixed asset propagation for player sprites not fully updating recolor masks in some cases.
 
 * For the web UI:
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 24e511c3..427adac2 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -132,7 +132,32 @@ namespace StardewModdingAPI.Framework.ModHelpers
                         return this.GameContentManager.LoadLocalized<T>(assetName, this.CurrentLocaleConstant, useCache: false);
 
                     case ContentSource.ModFolder:
-                        return this.ModContentManager.LoadExact<T>(assetName, useCache: false);
+                        try
+                        {
+                            return this.ModContentManager.LoadExact<T>(assetName, useCache: false);
+                        }
+                        catch (SContentLoadException ex) when (ex.ErrorType == ContentLoadErrorType.AssetDoesNotExist)
+                        {
+                            // legacy behavior: you can load a .xnb file without the file extension
+                            try
+                            {
+                                IAssetName newName = this.ContentCore.ParseAssetName(assetName.Name + ".xnb", allowLocales: false);
+                                if (this.ModContentManager.DoesAssetExist<T>(newName))
+                                {
+                                    T data = this.ModContentManager.LoadExact<T>(newName, useCache: false);
+                                    SCore.DeprecationManager.Warn(
+                                        this.Mod,
+                                        "loading XNB files from the mod folder without the .xnb file extension",
+                                        "3.14.0",
+                                        DeprecationLevel.Notice
+                                    );
+                                    return data;
+                                }
+                            }
+                            catch { /* legacy behavior failed, rethrow original error */ }
+
+                            throw;
+                        }
 
                     default:
                         throw new SContentLoadException(ContentLoadErrorType.Other, $"{this.Mod.DisplayName} failed loading content asset '{key}' from {source}: unknown content source '{source}'.");

From 45f674303454fb27327a0404ed403ac15ed04580 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 17:59:44 -0400
Subject: [PATCH 626/856] optimize raising events for the most common cases

---
 docs/release-notes.md                      |  3 +
 src/SMAPI/Framework/Events/ManagedEvent.cs | 81 +++++++++++++++-------
 src/SMAPI/Framework/SCore.cs               |  3 +-
 3 files changed, 60 insertions(+), 27 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d66fea5d..7ccd466a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Further improved performance in some cases.
+
 * For mod authors:
   * Fixed error when loading a `.xnb` file through the old content API without the file extension.
   * Fixed asset propagation for player sprites not fully updating recolor masks in some cases.
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index a16beb77..abeea098 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -20,14 +20,17 @@ namespace StardewModdingAPI.Framework.Events
         /// <summary>The underlying event handlers.</summary>
         private readonly List<ManagedEventHandler<TEventArgs>> Handlers = new();
 
-        /// <summary>A cached snapshot of <see cref="Handlers"/>, or <c>null</c> to rebuild it next raise.</summary>
+        /// <summary>A cached snapshot of the <see cref="Handlers"/> sorted by event priority, or <c>null</c> to rebuild it next raise.</summary>
         private ManagedEventHandler<TEventArgs>[]? CachedHandlers = Array.Empty<ManagedEventHandler<TEventArgs>>();
 
         /// <summary>The total number of event handlers registered for this events, regardless of whether they're still registered.</summary>
         private int RegistrationIndex;
 
-        /// <summary>Whether new handlers were added since the last raise.</summary>
-        private bool HasNewHandlers;
+        /// <summary>Whether handlers were removed since the last raise.</summary>
+        private bool HasRemovedHandlers;
+
+        /// <summary>Whether any of the handlers have a custom priority.</summary>
+        private bool HasPriorities;
 
 
         /*********
@@ -67,7 +70,7 @@ namespace StardewModdingAPI.Framework.Events
 
                 this.Handlers.Add(managedHandler);
                 this.CachedHandlers = null;
-                this.HasNewHandlers = true;
+                this.HasPriorities |= priority != EventPriority.Normal;
             }
         }
 
@@ -85,6 +88,7 @@ namespace StardewModdingAPI.Framework.Events
 
                     this.Handlers.RemoveAt(i);
                     this.CachedHandlers = null;
+                    this.HasRemovedHandlers = true;
                     break;
                 }
             }
@@ -92,10 +96,24 @@ namespace StardewModdingAPI.Framework.Events
 
         /// <summary>Raise the event and notify all handlers.</summary>
         /// <param name="args">The event arguments to pass.</param>
-        /// <param name="match">A lambda which returns true if the event should be raised for the given mod.</param>
-        public void Raise(TEventArgs args, Func<IModMetadata, bool>? match = null)
+        public void Raise(TEventArgs args)
         {
-            this.Raise((_, invoke) => invoke(args), match);
+            // skip if no handlers
+            if (this.Handlers.Count == 0)
+                return;
+
+            // raise event
+            foreach (ManagedEventHandler<TEventArgs> handler in this.GetHandlers())
+            {
+                try
+                {
+                    handler.Handler(null, args);
+                }
+                catch (Exception ex)
+                {
+                    this.LogError(handler, ex);
+                }
+            }
         }
 
         /// <summary>Raise the event and notify all handlers.</summary>
@@ -107,31 +125,15 @@ namespace StardewModdingAPI.Framework.Events
             if (this.Handlers.Count == 0)
                 return;
 
-            // update cached data
-            // (This is debounced here to avoid repeatedly sorting when handlers are added/removed,
-            // and keeping a separate cached list allows changes during enumeration.)
-            var handlers = this.CachedHandlers; // iterate local copy in case a mod adds/removes a handler while handling the event, which will set this field to null
-            if (handlers == null)
-            {
-                lock (this.Handlers)
-                {
-                    if (this.HasNewHandlers && this.Handlers.Any(p => p.Priority != EventPriority.Normal))
-                        this.Handlers.Sort();
-
-                    this.CachedHandlers = handlers = this.Handlers.ToArray();
-                    this.HasNewHandlers = false;
-                }
-            }
-
             // raise event
-            foreach (ManagedEventHandler<TEventArgs> handler in handlers)
+            foreach (ManagedEventHandler<TEventArgs> handler in this.GetHandlers())
             {
                 if (match != null && !match(handler.SourceMod))
                     continue;
 
                 try
                 {
-                    invoke(handler.SourceMod, args => handler.Handler.Invoke(null, args));
+                    invoke(handler.SourceMod, args => handler.Handler(null, args));
                 }
                 catch (Exception ex)
                 {
@@ -147,9 +149,36 @@ namespace StardewModdingAPI.Framework.Events
         /// <summary>Log an exception from an event handler.</summary>
         /// <param name="handler">The event handler instance.</param>
         /// <param name="ex">The exception that was raised.</param>
-        protected void LogError(ManagedEventHandler<TEventArgs> handler, Exception ex)
+        private void LogError(ManagedEventHandler<TEventArgs> handler, Exception ex)
         {
             handler.SourceMod.LogAsMod($"This mod failed in the {this.EventName} event. Technical details: \n{ex.GetLogSummary()}", LogLevel.Error);
         }
+
+        /// <summary>Get cached copy of the sorted handlers to invoke.</summary>
+        /// <remarks>This returns the handlers sorted by priority, and allows iterating the list even if a mod adds/removes handlers while handling it. This is debounced when requested to avoid repeatedly sorting when handlers are added/removed.</remarks>
+        private ManagedEventHandler<TEventArgs>[] GetHandlers()
+        {
+            ManagedEventHandler<TEventArgs>[]? handlers = this.CachedHandlers;
+
+            if (handlers == null)
+            {
+                lock (this.Handlers)
+                {
+                    // recheck priorities
+                    if (this.HasRemovedHandlers)
+                        this.HasPriorities = this.Handlers.Any(p => p.Priority != EventPriority.Normal);
+
+                    // sort by priority if needed
+                    if (this.HasPriorities)
+                        this.Handlers.Sort();
+
+                    // update cache
+                    this.CachedHandlers = handlers = this.Handlers.ToArray();
+                    this.HasRemovedHandlers = false;
+                }
+            }
+
+            return handlers;
+        }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index f882682e..c3f0c05f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1231,7 +1231,8 @@ namespace StardewModdingAPI.Framework
                 modIDs.Remove(message.FromModID); // don't send a broadcast back to the sender
 
             // raise events
-            this.EventManager.ModMessageReceived.Raise(new ModMessageReceivedEventArgs(message, this.Toolkit.JsonHelper), mod => modIDs.Contains(mod.Manifest.UniqueID));
+            var args = new ModMessageReceivedEventArgs(message, this.Toolkit.JsonHelper);
+            this.EventManager.ModMessageReceived.Raise((_, invoke) => invoke(args), mod => modIDs.Contains(mod.Manifest.UniqueID));
         }
 
         /// <summary>Constructor a content manager to read game content files.</summary>

From cae1063ad99a29aed3a0c162bad1d2842376c608 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 19:15:22 -0400
Subject: [PATCH 627/856] move filtering only used in one place out of managed
 event

---
 src/SMAPI/Framework/Events/ManagedEvent.cs |  6 +-----
 src/SMAPI/Framework/SCore.cs               | 13 +++++++++++--
 2 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index abeea098..a34106ce 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -118,8 +118,7 @@ namespace StardewModdingAPI.Framework.Events
 
         /// <summary>Raise the event and notify all handlers.</summary>
         /// <param name="invoke">Invoke an event handler. This receives the mod which registered the handler, and should invoke the callback with the event arguments to pass it.</param>
-        /// <param name="match">A lambda which returns true if the event should be raised for the given mod.</param>
-        public void Raise(Action<IModMetadata, Action<TEventArgs>> invoke, Func<IModMetadata, bool>? match = null)
+        public void Raise(Action<IModMetadata, Action<TEventArgs>> invoke)
         {
             // skip if no handlers
             if (this.Handlers.Count == 0)
@@ -128,9 +127,6 @@ namespace StardewModdingAPI.Framework.Events
             // raise event
             foreach (ManagedEventHandler<TEventArgs> handler in this.GetHandlers())
             {
-                if (match != null && !match(handler.SourceMod))
-                    continue;
-
                 try
                 {
                     invoke(handler.SourceMod, args => handler.Handler(null, args));
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c3f0c05f..1fea6d69 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1231,8 +1231,17 @@ namespace StardewModdingAPI.Framework
                 modIDs.Remove(message.FromModID); // don't send a broadcast back to the sender
 
             // raise events
-            var args = new ModMessageReceivedEventArgs(message, this.Toolkit.JsonHelper);
-            this.EventManager.ModMessageReceived.Raise((_, invoke) => invoke(args), mod => modIDs.Contains(mod.Manifest.UniqueID));
+            ModMessageReceivedEventArgs? args = null;
+            this.EventManager.ModMessageReceived.Raise(
+                invoke: (mod, invoke) =>
+                {
+                    if (modIDs.Contains(mod.Manifest.UniqueID))
+                    {
+                        args ??= new(message, this.Toolkit.JsonHelper);
+                        invoke(args);
+                    }
+                }
+            );
         }
 
         /// <summary>Constructor a content manager to read game content files.</summary>

From 05b39b7cd9a40f1660c2c53ef70b75a67f2fccc3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 19:26:28 -0400
Subject: [PATCH 628/856] cache verbose flag in main update method

---
 src/SMAPI/Framework/SCore.cs | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 1fea6d69..667fcf0f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -577,6 +577,7 @@ namespace StardewModdingAPI.Framework
         private void OnPlayerInstanceUpdating(SGame instance, GameTime gameTime, Action runUpdate)
         {
             EventManager events = this.EventManager;
+            bool verbose = this.Monitor.IsVerbose;
 
             try
             {
@@ -804,7 +805,7 @@ namespace StardewModdingAPI.Framework
                     // since the game adds & removes its own handler on the fly.
                     if (state.WindowSize.IsChanged)
                     {
-                        if (this.Monitor.IsVerbose)
+                        if (verbose)
                             this.Monitor.Log($"Events: window size changed to {state.WindowSize.New}.");
 
                         events.WindowResized.Raise(new WindowResizedEventArgs(state.WindowSize.Old, state.WindowSize.New));
@@ -828,7 +829,7 @@ namespace StardewModdingAPI.Framework
                             // raise mouse wheel scrolled
                             if (state.MouseWheelScroll.IsChanged)
                             {
-                                if (this.Monitor.IsVerbose)
+                                if (verbose)
                                     this.Monitor.Log($"Events: mouse wheel scrolled to {state.MouseWheelScroll.New}.");
                                 events.MouseWheelScrolled.Raise(new MouseWheelScrolledEventArgs(cursor, state.MouseWheelScroll.Old, state.MouseWheelScroll.New));
                             }
@@ -845,14 +846,14 @@ namespace StardewModdingAPI.Framework
 
                                     if (status == SButtonState.Pressed)
                                     {
-                                        if (this.Monitor.IsVerbose)
+                                        if (verbose)
                                             this.Monitor.Log($"Events: button {button} pressed.");
 
                                         events.ButtonPressed.Raise(new ButtonPressedEventArgs(button, cursor, inputState));
                                     }
                                     else if (status == SButtonState.Released)
                                     {
-                                        if (this.Monitor.IsVerbose)
+                                        if (verbose)
                                             this.Monitor.Log($"Events: button {button} released.");
 
                                         events.ButtonReleased.Raise(new ButtonReleasedEventArgs(button, cursor, inputState));
@@ -870,7 +871,7 @@ namespace StardewModdingAPI.Framework
                         var was = state.ActiveMenu.Old;
                         var now = state.ActiveMenu.New;
 
-                        if (this.Monitor.IsVerbose)
+                        if (verbose)
                             this.Monitor.Log($"Context: menu changed from {was?.GetType().FullName ?? "none"} to {now?.GetType().FullName ?? "none"}.");
 
                         // raise menu events
@@ -885,12 +886,12 @@ namespace StardewModdingAPI.Framework
                         bool raiseWorldEvents = !state.SaveID.IsChanged; // don't report changes from unloaded => loaded
 
                         // location list changes
-                        if (state.Locations.LocationList.IsChanged && (events.LocationListChanged.HasListeners() || this.Monitor.IsVerbose))
+                        if (state.Locations.LocationList.IsChanged && (events.LocationListChanged.HasListeners() || verbose))
                         {
                             var added = state.Locations.LocationList.Added.ToArray();
                             var removed = state.Locations.LocationList.Removed.ToArray();
 
-                            if (this.Monitor.IsVerbose)
+                            if (verbose)
                             {
                                 string addedText = added.Any() ? string.Join(", ", added.Select(p => p.Name)) : "none";
                                 string removedText = removed.Any() ? string.Join(", ", removed.Select(p => p.Name)) : "none";
@@ -960,7 +961,7 @@ namespace StardewModdingAPI.Framework
                             // raise current location changed
                             if (playerState.Location.IsChanged)
                             {
-                                if (this.Monitor.IsVerbose)
+                                if (verbose)
                                     this.Monitor.Log($"Context: set location to {playerState.Location.New}.");
 
                                 events.Warped.Raise(new WarpedEventArgs(player, playerState.Location.Old!, playerState.Location.New!));
@@ -972,7 +973,7 @@ namespace StardewModdingAPI.Framework
                                 if (!value.IsChanged)
                                     continue;
 
-                                if (this.Monitor.IsVerbose)
+                                if (verbose)
                                     this.Monitor.Log($"Events: player skill '{skill}' changed from {value.Old} to {value.New}.");
 
                                 events.LevelChanged.Raise(new LevelChangedEventArgs(player, skill, value.Old, value.New));
@@ -983,7 +984,7 @@ namespace StardewModdingAPI.Framework
                             {
                                 SnapshotItemListDiff inventory = playerState.Inventory;
 
-                                if (this.Monitor.IsVerbose)
+                                if (verbose)
                                     this.Monitor.Log("Events: player inventory changed.");
                                 events.InventoryChanged.Raise(new InventoryChangedEventArgs(player, added: inventory.Added, removed: inventory.Removed, quantityChanged: inventory.QuantityChanged));
                             }

From 077c897d53371d12c812be5145d917c59583d7cb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 19:29:57 -0400
Subject: [PATCH 629/856] replace event.HasListeners() with property

---
 src/SMAPI/Framework/Events/IManagedEvent.cs |  3 +++
 src/SMAPI/Framework/Events/ManagedEvent.cs  | 11 +++++------
 src/SMAPI/Framework/SCore.cs                | 10 +++++-----
 src/SMAPI/Framework/SGame.cs                |  4 ++--
 4 files changed, 15 insertions(+), 13 deletions(-)

diff --git a/src/SMAPI/Framework/Events/IManagedEvent.cs b/src/SMAPI/Framework/Events/IManagedEvent.cs
index 0ae8c55a..55994c04 100644
--- a/src/SMAPI/Framework/Events/IManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/IManagedEvent.cs
@@ -8,5 +8,8 @@ namespace StardewModdingAPI.Framework.Events
         *********/
         /// <summary>A human-readable name for the event.</summary>
         string EventName { get; }
+
+        /// <summary>Whether any handlers are listening to the event.</summary>
+        bool HasListeners { get; }
     }
 }
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index a34106ce..8a3ca839 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -39,6 +39,9 @@ namespace StardewModdingAPI.Framework.Events
         /// <inheritdoc />
         public string EventName { get; }
 
+        /// <inheritdoc />
+        public bool HasListeners { get; private set; }
+
 
         /*********
         ** Public methods
@@ -52,12 +55,6 @@ namespace StardewModdingAPI.Framework.Events
             this.ModRegistry = modRegistry;
         }
 
-        /// <summary>Get whether anything is listening to the event.</summary>
-        public bool HasListeners()
-        {
-            return this.Handlers.Count > 0;
-        }
-
         /// <summary>Add an event handler.</summary>
         /// <param name="handler">The event handler.</param>
         /// <param name="mod">The mod which added the event handler.</param>
@@ -70,6 +67,7 @@ namespace StardewModdingAPI.Framework.Events
 
                 this.Handlers.Add(managedHandler);
                 this.CachedHandlers = null;
+                this.HasListeners = true;
                 this.HasPriorities |= priority != EventPriority.Normal;
             }
         }
@@ -88,6 +86,7 @@ namespace StardewModdingAPI.Framework.Events
 
                     this.Handlers.RemoveAt(i);
                     this.CachedHandlers = null;
+                    this.HasListeners = this.Handlers.Count != 0;
                     this.HasRemovedHandlers = true;
                     break;
                 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 667fcf0f..c1e03634 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -886,7 +886,7 @@ namespace StardewModdingAPI.Framework
                         bool raiseWorldEvents = !state.SaveID.IsChanged; // don't report changes from unloaded => loaded
 
                         // location list changes
-                        if (state.Locations.LocationList.IsChanged && (events.LocationListChanged.HasListeners() || verbose))
+                        if (state.Locations.LocationList.IsChanged && (events.LocationListChanged.HasListeners || verbose))
                         {
                             var added = state.Locations.LocationList.Added.ToArray();
                             var removed = state.Locations.LocationList.Removed.ToArray();
@@ -929,7 +929,7 @@ namespace StardewModdingAPI.Framework
                                     events.ObjectListChanged.Raise(new ObjectListChangedEventArgs(location, locState.Objects.Added, locState.Objects.Removed));
 
                                 // chest items changed
-                                if (events.ChestInventoryChanged.HasListeners())
+                                if (events.ChestInventoryChanged.HasListeners)
                                 {
                                     foreach (var pair in locState.ChestItems)
                                     {
@@ -1077,7 +1077,7 @@ namespace StardewModdingAPI.Framework
             }
 
             // raise event
-            if (this.EventManager.LocaleChanged.HasListeners())
+            if (this.EventManager.LocaleChanged.HasListeners)
             {
                 this.EventManager.LocaleChanged.Raise(
                     new LocaleChangedEventArgs(
@@ -1140,7 +1140,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="assetName">The asset name that was loaded.</param>
         private void OnAssetLoaded(IContentManager contentManager, IAssetName assetName)
         {
-            if (this.EventManager.AssetReady.HasListeners())
+            if (this.EventManager.AssetReady.HasListeners)
                 this.EventManager.AssetReady.Raise(new AssetReadyEventArgs(assetName, assetName.GetBaseAssetName()));
         }
 
@@ -1148,7 +1148,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="assetNames">The invalidated asset names.</param>
         private void OnAssetsInvalidated(IList<IAssetName> assetNames)
         {
-            if (this.EventManager.AssetsInvalidated.HasListeners())
+            if (this.EventManager.AssetsInvalidated.HasListeners)
                 this.EventManager.AssetsInvalidated.Raise(new AssetsInvalidatedEventArgs(assetNames, assetNames.Select(p => p.GetBaseAssetName())));
         }
 
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 0a8a068f..38043e1c 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -353,7 +353,7 @@ namespace StardewModdingAPI.Framework
             }
             if (Game1.currentMinigame != null)
             {
-                if (events.Rendering.HasListeners())
+                if (events.Rendering.HasListeners)
                 {
                     Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                     events.Rendering.RaiseEmpty();
@@ -372,7 +372,7 @@ namespace StardewModdingAPI.Framework
                 Game1.PushUIMode();
                 this.drawOverlays(Game1.spriteBatch);
                 Game1.PopUIMode();
-                if (events.Rendered.HasListeners())
+                if (events.Rendered.HasListeners)
                 {
                     Game1.spriteBatch.Begin(SpriteSortMode.Deferred, BlendState.AlphaBlend, SamplerState.PointClamp, null, null);
                     events.Rendered.RaiseEmpty();

From 42a797a01240893e9a8e645253a269087b2d178d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 19:56:45 -0400
Subject: [PATCH 630/856] don't raise events that have no listeners

This mainly avoids allocating event arg objects unnecessarily.
---
 src/SMAPI/Framework/InternalExtensions.cs |   3 +-
 src/SMAPI/Framework/SCore.cs              | 167 +++++++++++++---------
 src/SMAPI/Framework/SMultiplayer.cs       |  12 +-
 3 files changed, 111 insertions(+), 71 deletions(-)

diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index 580651f3..ba9bbcec 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -64,7 +64,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="event">The event to raise.</param>
         public static void RaiseEmpty<TEventArgs>(this ManagedEvent<TEventArgs> @event) where TEventArgs : new()
         {
-            @event.Raise(Singleton<TEventArgs>.Instance);
+            if (@event.HasListeners)
+                @event.Raise(Singleton<TEventArgs>.Instance);
         }
 
         /****
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c1e03634..ec21e38a 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -47,6 +47,7 @@ using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.Menus;
+using StardewValley.Objects;
 using xTile.Display;
 using LanguageCode = StardewValley.LocalizedContentManager.LanguageCode;
 using MiniMonoModHotfix = MonoMod.Utils.MiniMonoModHotfix;
@@ -808,7 +809,8 @@ namespace StardewModdingAPI.Framework
                         if (verbose)
                             this.Monitor.Log($"Events: window size changed to {state.WindowSize.New}.");
 
-                        events.WindowResized.Raise(new WindowResizedEventArgs(state.WindowSize.Old, state.WindowSize.New));
+                        if (events.WindowResized.HasListeners)
+                            events.WindowResized.Raise(new WindowResizedEventArgs(state.WindowSize.Old, state.WindowSize.New));
                     }
 
                     /*********
@@ -823,7 +825,7 @@ namespace StardewModdingAPI.Framework
                             ICursorPosition cursor = instance.Input.CursorPosition;
 
                             // raise cursor moved event
-                            if (state.Cursor.IsChanged)
+                            if (state.Cursor.IsChanged && events.CursorMoved.HasListeners)
                                 events.CursorMoved.Raise(new CursorMovedEventArgs(state.Cursor.Old!, state.Cursor.New!));
 
                             // raise mouse wheel scrolled
@@ -831,32 +833,42 @@ namespace StardewModdingAPI.Framework
                             {
                                 if (verbose)
                                     this.Monitor.Log($"Events: mouse wheel scrolled to {state.MouseWheelScroll.New}.");
-                                events.MouseWheelScrolled.Raise(new MouseWheelScrolledEventArgs(cursor, state.MouseWheelScroll.Old, state.MouseWheelScroll.New));
+
+                                if (events.MouseWheelScrolled.HasListeners)
+                                    events.MouseWheelScrolled.Raise(new MouseWheelScrolledEventArgs(cursor, state.MouseWheelScroll.Old, state.MouseWheelScroll.New));
                             }
 
                             // raise input button events
                             if (inputState.ButtonStates.Count > 0)
                             {
-                                events.ButtonsChanged.Raise(new ButtonsChangedEventArgs(cursor, inputState));
+                                if (events.ButtonsChanged.HasListeners)
+                                    events.ButtonsChanged.Raise(new ButtonsChangedEventArgs(cursor, inputState));
 
-                                foreach (var pair in inputState.ButtonStates)
+                                bool raisePressed = events.ButtonPressed.HasListeners;
+                                bool raiseReleased = events.ButtonReleased.HasListeners;
+
+                                if (verbose || raisePressed || raiseReleased)
                                 {
-                                    SButton button = pair.Key;
-                                    SButtonState status = pair.Value;
-
-                                    if (status == SButtonState.Pressed)
+                                    foreach ((SButton button, SButtonState status) in inputState.ButtonStates)
                                     {
-                                        if (verbose)
-                                            this.Monitor.Log($"Events: button {button} pressed.");
+                                        switch (status)
+                                        {
+                                            case SButtonState.Pressed:
+                                                if (verbose)
+                                                    this.Monitor.Log($"Events: button {button} pressed.");
 
-                                        events.ButtonPressed.Raise(new ButtonPressedEventArgs(button, cursor, inputState));
-                                    }
-                                    else if (status == SButtonState.Released)
-                                    {
-                                        if (verbose)
-                                            this.Monitor.Log($"Events: button {button} released.");
+                                                if (raisePressed)
+                                                    events.ButtonPressed.Raise(new ButtonPressedEventArgs(button, cursor, inputState));
+                                                break;
 
-                                        events.ButtonReleased.Raise(new ButtonReleasedEventArgs(button, cursor, inputState));
+                                            case SButtonState.Released:
+                                                if (verbose)
+                                                    this.Monitor.Log($"Events: button {button} released.");
+
+                                                if (raiseReleased)
+                                                    events.ButtonReleased.Raise(new ButtonReleasedEventArgs(button, cursor, inputState));
+                                                break;
+                                        }
                                     }
                                 }
                             }
@@ -868,14 +880,15 @@ namespace StardewModdingAPI.Framework
                     *********/
                     if (state.ActiveMenu.IsChanged)
                     {
-                        var was = state.ActiveMenu.Old;
-                        var now = state.ActiveMenu.New;
+                        IClickableMenu? was = state.ActiveMenu.Old;
+                        IClickableMenu? now = state.ActiveMenu.New;
 
                         if (verbose)
                             this.Monitor.Log($"Context: menu changed from {was?.GetType().FullName ?? "none"} to {now?.GetType().FullName ?? "none"}.");
 
                         // raise menu events
-                        events.MenuChanged.Raise(new MenuChangedEventArgs(was, now));
+                        if (events.MenuChanged.HasListeners)
+                            events.MenuChanged.Raise(new MenuChangedEventArgs(was, now));
                     }
 
                     /*********
@@ -898,7 +911,8 @@ namespace StardewModdingAPI.Framework
                                 this.Monitor.Log($"Context: location list changed (added {addedText}; removed {removedText}).");
                             }
 
-                            events.LocationListChanged.Raise(new LocationListChangedEventArgs(added, removed));
+                            if (events.LocationListChanged.HasListeners)
+                                events.LocationListChanged.Raise(new LocationListChangedEventArgs(added, removed));
                         }
 
                         // raise location contents changed
@@ -906,50 +920,47 @@ namespace StardewModdingAPI.Framework
                         {
                             foreach (LocationSnapshot locState in state.Locations.Locations)
                             {
-                                var location = locState.Location;
+                                GameLocation location = locState.Location;
 
                                 // buildings changed
-                                if (locState.Buildings.IsChanged)
+                                if (locState.Buildings.IsChanged && events.BuildingListChanged.HasListeners)
                                     events.BuildingListChanged.Raise(new BuildingListChangedEventArgs(location, locState.Buildings.Added, locState.Buildings.Removed));
 
                                 // debris changed
-                                if (locState.Debris.IsChanged)
+                                if (locState.Debris.IsChanged && events.DebrisListChanged.HasListeners)
                                     events.DebrisListChanged.Raise(new DebrisListChangedEventArgs(location, locState.Debris.Added, locState.Debris.Removed));
 
                                 // large terrain features changed
-                                if (locState.LargeTerrainFeatures.IsChanged)
+                                if (locState.LargeTerrainFeatures.IsChanged && events.LargeTerrainFeatureListChanged.HasListeners)
                                     events.LargeTerrainFeatureListChanged.Raise(new LargeTerrainFeatureListChangedEventArgs(location, locState.LargeTerrainFeatures.Added, locState.LargeTerrainFeatures.Removed));
 
                                 // NPCs changed
-                                if (locState.Npcs.IsChanged)
+                                if (locState.Npcs.IsChanged && events.NpcListChanged.HasListeners)
                                     events.NpcListChanged.Raise(new NpcListChangedEventArgs(location, locState.Npcs.Added, locState.Npcs.Removed));
 
                                 // objects changed
-                                if (locState.Objects.IsChanged)
+                                if (locState.Objects.IsChanged && events.ObjectListChanged.HasListeners)
                                     events.ObjectListChanged.Raise(new ObjectListChangedEventArgs(location, locState.Objects.Added, locState.Objects.Removed));
 
                                 // chest items changed
                                 if (events.ChestInventoryChanged.HasListeners)
                                 {
-                                    foreach (var pair in locState.ChestItems)
-                                    {
-                                        SnapshotItemListDiff diff = pair.Value;
-                                        events.ChestInventoryChanged.Raise(new ChestInventoryChangedEventArgs(pair.Key, location, added: diff.Added, removed: diff.Removed, quantityChanged: diff.QuantityChanged));
-                                    }
+                                    foreach ((Chest chest, SnapshotItemListDiff diff) in locState.ChestItems)
+                                        events.ChestInventoryChanged.Raise(new ChestInventoryChangedEventArgs(chest, location, added: diff.Added, removed: diff.Removed, quantityChanged: diff.QuantityChanged));
                                 }
 
                                 // terrain features changed
-                                if (locState.TerrainFeatures.IsChanged)
+                                if (locState.TerrainFeatures.IsChanged && events.TerrainFeatureListChanged.HasListeners)
                                     events.TerrainFeatureListChanged.Raise(new TerrainFeatureListChangedEventArgs(location, locState.TerrainFeatures.Added, locState.TerrainFeatures.Removed));
 
                                 // furniture changed
-                                if (locState.Furniture.IsChanged)
+                                if (locState.Furniture.IsChanged && events.FurnitureListChanged.HasListeners)
                                     events.FurnitureListChanged.Raise(new FurnitureListChangedEventArgs(location, locState.Furniture.Added, locState.Furniture.Removed));
                             }
                         }
 
                         // raise time changed
-                        if (raiseWorldEvents && state.Time.IsChanged)
+                        if (raiseWorldEvents && state.Time.IsChanged && events.TimeChanged.HasListeners)
                             events.TimeChanged.Raise(new TimeChangedEventArgs(state.Time.Old, state.Time.New));
 
                         // raise player events
@@ -964,29 +975,38 @@ namespace StardewModdingAPI.Framework
                                 if (verbose)
                                     this.Monitor.Log($"Context: set location to {playerState.Location.New}.");
 
-                                events.Warped.Raise(new WarpedEventArgs(player, playerState.Location.Old!, playerState.Location.New!));
+                                if (events.Warped.HasListeners)
+                                    events.Warped.Raise(new WarpedEventArgs(player, playerState.Location.Old!, playerState.Location.New!));
                             }
 
                             // raise player leveled up a skill
-                            foreach ((SkillType skill, var value) in playerState.Skills)
+                            bool raiseLevelChanged = events.LevelChanged.HasListeners;
+                            if (verbose || raiseLevelChanged)
                             {
-                                if (!value.IsChanged)
-                                    continue;
+                                foreach ((SkillType skill, var value) in playerState.Skills)
+                                {
+                                    if (!value.IsChanged)
+                                        continue;
 
-                                if (verbose)
-                                    this.Monitor.Log($"Events: player skill '{skill}' changed from {value.Old} to {value.New}.");
+                                    if (verbose)
+                                        this.Monitor.Log($"Events: player skill '{skill}' changed from {value.Old} to {value.New}.");
 
-                                events.LevelChanged.Raise(new LevelChangedEventArgs(player, skill, value.Old, value.New));
+                                    if (raiseLevelChanged)
+                                        events.LevelChanged.Raise(new LevelChangedEventArgs(player, skill, value.Old, value.New));
+                                }
                             }
 
                             // raise player inventory changed
                             if (playerState.Inventory.IsChanged)
                             {
-                                SnapshotItemListDiff inventory = playerState.Inventory;
-
                                 if (verbose)
                                     this.Monitor.Log("Events: player inventory changed.");
-                                events.InventoryChanged.Raise(new InventoryChangedEventArgs(player, added: inventory.Added, removed: inventory.Removed, quantityChanged: inventory.QuantityChanged));
+
+                                if (events.InventoryChanged.HasListeners)
+                                {
+                                    SnapshotItemListDiff inventory = playerState.Inventory;
+                                    events.InventoryChanged.Raise(new InventoryChangedEventArgs(player, added: inventory.Added, removed: inventory.Removed, quantityChanged: inventory.QuantityChanged));
+                                }
                             }
                         }
                     }
@@ -998,7 +1018,9 @@ namespace StardewModdingAPI.Framework
                     if (instance.IsFirstTick && !Context.IsGameLaunched)
                     {
                         Context.IsGameLaunched = true;
-                        events.GameLaunched.Raise(new GameLaunchedEventArgs());
+
+                        if (events.GameLaunched.HasListeners)
+                            events.GameLaunched.Raise(new GameLaunchedEventArgs());
                     }
 
                     // preloaded
@@ -1124,9 +1146,11 @@ namespace StardewModdingAPI.Framework
             }
 
             // raise events
-            this.EventManager.LoadStageChanged.Raise(new LoadStageChangedEventArgs(oldStage, newStage));
+            EventManager events = this.EventManager;
+            if (events.LoadStageChanged.HasListeners)
+                events.LoadStageChanged.Raise(new LoadStageChangedEventArgs(oldStage, newStage));
             if (newStage == LoadStage.None)
-                this.EventManager.ReturnedToTitle.RaiseEmpty();
+                events.ReturnedToTitle.RaiseEmpty();
         }
 
         /// <summary>A callback invoked before <see cref="Game1.newDayAfterFade"/> runs.</summary>
@@ -1156,9 +1180,14 @@ namespace StardewModdingAPI.Framework
         /// <param name="asset">The asset info being requested.</param>
         private IList<AssetOperationGroup> RequestAssetOperations(IAssetInfo asset)
         {
-            List<AssetOperationGroup> operations = new();
+            // get event
+            var @event = this.EventManager.AssetRequested;
+            if (!@event.HasListeners)
+                return Array.Empty<AssetOperationGroup>();
 
-            this.EventManager.AssetRequested.Raise(
+            // get operations
+            List<AssetOperationGroup>? operations = null;
+            @event.Raise(
                 invoke: (mod, invoke) =>
                 {
                     AssetRequestedEventArgs args = new(mod, asset, this.GetOnBehalfOfContentPack);
@@ -1167,6 +1196,7 @@ namespace StardewModdingAPI.Framework
 
                     if (args.LoadOperations.Any() || args.EditOperations.Any())
                     {
+                        operations ??= new();
                         operations.Add(
                             new AssetOperationGroup(mod, args.LoadOperations.ToArray(), args.EditOperations.ToArray())
                         );
@@ -1174,7 +1204,9 @@ namespace StardewModdingAPI.Framework
                 }
             );
 
-            return operations;
+            return operations != null
+                ? operations
+                : Array.Empty<AssetOperationGroup>();
         }
 
         /// <summary>Get the mod metadata for a content pack whose ID matches <paramref name="id"/>, if it's a valid content pack for the given <paramref name="mod"/>.</summary>
@@ -1226,23 +1258,26 @@ namespace StardewModdingAPI.Framework
         /// <param name="message">The message to deliver to applicable mods.</param>
         private void OnModMessageReceived(ModMessageModel message)
         {
-            // get mod IDs to notify
-            HashSet<string> modIDs = new HashSet<string>(message.ToModIDs ?? this.ModRegistry.GetAll().Select(p => p.Manifest.UniqueID), StringComparer.OrdinalIgnoreCase);
-            if (message.FromPlayerID == Game1.player?.UniqueMultiplayerID)
-                modIDs.Remove(message.FromModID); // don't send a broadcast back to the sender
+            if (this.EventManager.ModMessageReceived.HasListeners)
+            {
+                // get mod IDs to notify
+                HashSet<string> modIDs = new(message.ToModIDs ?? this.ModRegistry.GetAll().Select(p => p.Manifest.UniqueID), StringComparer.OrdinalIgnoreCase);
+                if (message.FromPlayerID == Game1.player?.UniqueMultiplayerID)
+                    modIDs.Remove(message.FromModID); // don't send a broadcast back to the sender
 
-            // raise events
-            ModMessageReceivedEventArgs? args = null;
-            this.EventManager.ModMessageReceived.Raise(
-                invoke: (mod, invoke) =>
-                {
-                    if (modIDs.Contains(mod.Manifest.UniqueID))
+                // raise events
+                ModMessageReceivedEventArgs? args = null;
+                this.EventManager.ModMessageReceived.Raise(
+                    invoke: (mod, invoke) =>
                     {
-                        args ??= new(message, this.Toolkit.JsonHelper);
-                        invoke(args);
+                        if (modIDs.Contains(mod.Manifest.UniqueID))
+                        {
+                            args ??= new(message, this.Toolkit.JsonHelper);
+                            invoke(args);
+                        }
                     }
-                }
-            );
+                );
+            }
         }
 
         /// <summary>Constructor a content manager to read game content files.</summary>
diff --git a/src/SMAPI/Framework/SMultiplayer.cs b/src/SMAPI/Framework/SMultiplayer.cs
index 2badcbbf..441a50ef 100644
--- a/src/SMAPI/Framework/SMultiplayer.cs
+++ b/src/SMAPI/Framework/SMultiplayer.cs
@@ -235,7 +235,8 @@ namespace StardewModdingAPI.Framework
                         }
 
                         // raise event
-                        this.EventManager.PeerContextReceived.Raise(new PeerContextReceivedEventArgs(newPeer));
+                        if (this.EventManager.PeerContextReceived.HasListeners)
+                            this.EventManager.PeerContextReceived.Raise(new PeerContextReceivedEventArgs(newPeer));
                     }
                     break;
 
@@ -259,7 +260,8 @@ namespace StardewModdingAPI.Framework
                     resume();
 
                     // raise event
-                    this.EventManager.PeerConnected.Raise(new PeerConnectedEventArgs(this.Peers[message.FarmerID]));
+                    if (this.EventManager.PeerConnected.HasListeners)
+                        this.EventManager.PeerConnected.Raise(new PeerConnectedEventArgs(this.Peers[message.FarmerID]));
                     break;
 
                 // handle mod message
@@ -370,7 +372,9 @@ namespace StardewModdingAPI.Framework
                 {
                     this.Monitor.Log($"Player quit: {playerID}");
                     this.Peers.Remove(playerID);
-                    this.EventManager.PeerDisconnected.Raise(new PeerDisconnectedEventArgs(peer));
+
+                    if (this.EventManager.PeerDisconnected.HasListeners)
+                        this.EventManager.PeerDisconnected.Raise(new PeerDisconnectedEventArgs(peer));
                 }
             }
 
@@ -481,7 +485,7 @@ namespace StardewModdingAPI.Framework
                 this.HostPeer = peer;
 
             // raise event
-            if (raiseEvent)
+            if (raiseEvent && this.EventManager.PeerContextReceived.HasListeners)
                 this.EventManager.PeerContextReceived.Raise(new PeerContextReceivedEventArgs(peer));
         }
 

From bbe5983acdd082d2185a69e2ad37d659a298223d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 21:36:45 -0400
Subject: [PATCH 631/856] rewrite asset operations to reduce allocations
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

• When raising AssetRequested, SMAPI now creates a single event args model and reuses it for each handler.
• There's now a single AssetOperationGroup per asset, which tracks the loaders/editors registered by every mod for that asset.
• The operation group's loader/editor lists are now used directly instead of querying them.
---
 docs/release-notes.md                         |   3 +-
 src/SMAPI/Events/AssetRequestedEventArgs.cs   |  43 ++--
 .../Framework/Content/AssetOperationGroup.cs  |   7 +-
 src/SMAPI/Framework/ContentCoordinator.cs     | 188 +++++++++---------
 .../ContentManagers/GameContentManager.cs     |  71 +++----
 src/SMAPI/Framework/SCore.cs                  |  32 ++-
 6 files changed, 168 insertions(+), 176 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7ccd466a..b35a4760 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,9 +3,10 @@
 # Release notes
 ## Upcoming release
 * For players:
-  * Further improved performance in some cases.
+  * Reduced mods' in-game performance impact.
 
 * For mod authors:
+  * Refactored how event handling works under the hood, particularly the new content API. This should have no effect on mod usage.
   * Fixed error when loading a `.xnb` file through the old content API without the file extension.
   * Fixed asset propagation for player sprites not fully updating recolor masks in some cases.
 
diff --git a/src/SMAPI/Events/AssetRequestedEventArgs.cs b/src/SMAPI/Events/AssetRequestedEventArgs.cs
index d0aef1db..d6561028 100644
--- a/src/SMAPI/Events/AssetRequestedEventArgs.cs
+++ b/src/SMAPI/Events/AssetRequestedEventArgs.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Events
         ** Fields
         *********/
         /// <summary>The mod handling the event.</summary>
-        private readonly IModMetadata Mod;
+        private IModMetadata? Mod;
 
         /// <summary>Get the mod metadata for a content pack, if it's a valid content pack for the mod.</summary>
         private readonly Func<IModMetadata, string?, string, IModMetadata?> GetOnBehalfOf;
@@ -37,26 +37,31 @@ namespace StardewModdingAPI.Events
         public Type DataType => this.AssetInfo.DataType;
 
         /// <summary>The load operations requested by the event handler.</summary>
-        internal IList<AssetLoadOperation> LoadOperations { get; } = new List<AssetLoadOperation>();
+        internal List<AssetLoadOperation> LoadOperations { get; } = new();
 
         /// <summary>The edit operations requested by the event handler.</summary>
-        internal IList<AssetEditOperation> EditOperations { get; } = new List<AssetEditOperation>();
+        internal List<AssetEditOperation> EditOperations { get; } = new();
 
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="mod">The mod handling the event.</param>
         /// <param name="assetInfo">The asset info being requested.</param>
         /// <param name="getOnBehalfOf">Get the mod metadata for a content pack, if it's a valid content pack for the mod.</param>
-        internal AssetRequestedEventArgs(IModMetadata mod, IAssetInfo assetInfo, Func<IModMetadata, string?, string, IModMetadata?> getOnBehalfOf)
+        internal AssetRequestedEventArgs(IAssetInfo assetInfo, Func<IModMetadata, string?, string, IModMetadata?> getOnBehalfOf)
         {
-            this.Mod = mod;
             this.AssetInfo = assetInfo;
             this.GetOnBehalfOf = getOnBehalfOf;
         }
 
+        /// <summary>Set the mod handling the event.</summary>
+        /// <param name="mod">The mod handling the event.</param>
+        internal void SetMod(IModMetadata mod)
+        {
+            this.Mod = mod;
+        }
+
         /// <summary>Provide the initial instance for the asset, instead of trying to load it from the game's <c>Content</c> folder.</summary>
         /// <param name="load">Get the initial instance of an asset.</param>
         /// <param name="priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
@@ -70,10 +75,11 @@ namespace StardewModdingAPI.Events
         /// </remarks>
         public void LoadFrom(Func<object> load, AssetLoadPriority priority, string? onBehalfOf = null)
         {
+            IModMetadata mod = this.GetMod();
             this.LoadOperations.Add(
                 new AssetLoadOperation(
-                    Mod: this.Mod,
-                    OnBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "load assets"),
+                    Mod: mod,
+                    OnBehalfOf: this.GetOnBehalfOf(mod, onBehalfOf, "load assets"),
                     Priority: priority,
                     GetData: _ => load()
                 )
@@ -94,12 +100,13 @@ namespace StardewModdingAPI.Events
         public void LoadFromModFile<TAsset>(string relativePath, AssetLoadPriority priority)
             where TAsset : notnull
         {
+            IModMetadata mod = this.GetMod();
             this.LoadOperations.Add(
                 new AssetLoadOperation(
-                    Mod: this.Mod,
+                    Mod: mod,
                     OnBehalfOf: null,
                     Priority: priority,
-                    GetData: _ => this.Mod.Mod!.Helper.ModContent.Load<TAsset>(relativePath)
+                    GetData: _ => mod.Mod!.Helper.ModContent.Load<TAsset>(relativePath)
                 )
             );
         }
@@ -117,14 +124,26 @@ namespace StardewModdingAPI.Events
         /// </remarks>
         public void Edit(Action<IAssetData> apply, AssetEditPriority priority = AssetEditPriority.Default, string? onBehalfOf = null)
         {
+            IModMetadata mod = this.GetMod();
             this.EditOperations.Add(
                 new AssetEditOperation(
-                    Mod: this.Mod,
+                    Mod: mod,
                     Priority: priority,
-                    OnBehalfOf: this.GetOnBehalfOf(this.Mod, onBehalfOf, "edit assets"),
+                    OnBehalfOf: this.GetOnBehalfOf(mod, onBehalfOf, "edit assets"),
                     ApplyEdit: apply
                 )
             );
         }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get the mod handling the event.</summary>
+        /// <exception cref="InvalidOperationException">This instance hasn't been initialized with the mod metadata yet.</exception>
+        private IModMetadata GetMod()
+        {
+            return this.Mod ?? throw new InvalidOperationException($"This {nameof(AssetRequestedEventArgs)} instance hasn't been initialized yet.");
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Content/AssetOperationGroup.cs b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
index 1566a8f0..11767d39 100644
--- a/src/SMAPI/Framework/Content/AssetOperationGroup.cs
+++ b/src/SMAPI/Framework/Content/AssetOperationGroup.cs
@@ -1,8 +1,9 @@
+using System.Collections.Generic;
+
 namespace StardewModdingAPI.Framework.Content
 {
-    /// <summary>A set of operations to apply to an asset for a given <see cref="IAssetEditor"/> or <see cref="IAssetLoader"/> implementation.</summary>
-    /// <param name="Mod">The mod applying the changes.</param>
+    /// <summary>A set of operations to apply to an asset.</summary>
     /// <param name="LoadOperations">The load operations to apply.</param>
     /// <param name="EditOperations">The edit operations to apply.</param>
-    internal record AssetOperationGroup(IModMetadata Mod, AssetLoadOperation[] LoadOperations, AssetEditOperation[] EditOperations);
+    internal record AssetOperationGroup(List<AssetLoadOperation> LoadOperations, List<AssetEditOperation> EditOperations);
 }
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 6702f5e6..a24581a0 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -57,7 +57,7 @@ namespace StardewModdingAPI.Framework
         private readonly Action<IList<IAssetName>> OnAssetsInvalidated;
 
         /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
-        private readonly Func<IAssetInfo, IList<AssetOperationGroup>> RequestAssetOperations;
+        private readonly Func<IAssetInfo, AssetOperationGroup?> RequestAssetOperations;
 
         /// <summary>The loaded content managers (including the <see cref="MainContentManager"/>).</summary>
         private readonly List<IContentManager> ContentManagers = new();
@@ -79,15 +79,15 @@ namespace StardewModdingAPI.Framework
         private Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>> LocaleCodes;
 
         /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
-        private readonly TickCacheDictionary<IAssetName, IList<AssetOperationGroup>> AssetOperationsByKey = new();
+        private readonly TickCacheDictionary<IAssetName, AssetOperationGroup?> AssetOperationsByKey = new();
 
         /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetLoader"/> implementations.</summary>
         [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
-        private readonly Dictionary<IAssetLoader, Dictionary<Type, AssetOperationGroup>> LegacyLoaderCache = new(ReferenceEqualityComparer.Instance);
+        private readonly Dictionary<IAssetLoader, Dictionary<Type, AssetLoadOperation>> LegacyLoaderCache = new(ReferenceEqualityComparer.Instance);
 
         /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetEditor"/> implementations.</summary>
         [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
-        private readonly Dictionary<IAssetEditor, Dictionary<Type, AssetOperationGroup>> LegacyEditorCache = new(ReferenceEqualityComparer.Instance);
+        private readonly Dictionary<IAssetEditor, Dictionary<Type, AssetEditOperation>> LegacyEditorCache = new(ReferenceEqualityComparer.Instance);
 
 
         /*********
@@ -126,7 +126,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="getFileLookup">Get a file lookup for the given directory.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, IList<AssetOperationGroup>> requestAssetOperations)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations)
         {
             this.GetFileLookup = getFileLookup;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
@@ -449,16 +449,12 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The asset info to load or edit.</param>
-        public IList<AssetOperationGroup> GetAssetOperations<T>(IAssetInfo info)
+        public AssetOperationGroup? GetAssetOperations<T>(IAssetInfo info)
             where T : notnull
         {
             return this.AssetOperationsByKey.GetOrSet(
                 info.Name,
-#pragma warning disable CS0612, CS0618 // deprecated code
-                () => this.Editors.Count > 0 || this.Loaders.Count > 0
-                    ? this.GetAssetOperationsIncludingLegacyWithoutCache<T>(info).ToArray()
-#pragma warning restore CS0612, CS0618
-                    : this.RequestAssetOperations(info)
+                () => this.GetAssetOperationsWithoutCache<T>(info)
             );
         }
 
@@ -584,41 +580,40 @@ namespace StardewModdingAPI.Framework
         /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now, ignoring the <see cref="AssetOperationsByKey"/> cache.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The asset info to load or edit.</param>
-        [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
-        private IEnumerable<AssetOperationGroup> GetAssetOperationsIncludingLegacyWithoutCache<T>(IAssetInfo info)
+        private AssetOperationGroup? GetAssetOperationsWithoutCache<T>(IAssetInfo info)
             where T : notnull
         {
-            IAssetInfo legacyInfo = this.GetLegacyAssetInfo(info);
-
             // new content API
-            foreach (AssetOperationGroup group in this.RequestAssetOperations(info))
-                yield return group;
+            AssetOperationGroup? group = this.RequestAssetOperations(info);
 
             // legacy load operations
-            foreach (ModLinked<IAssetLoader> loader in this.Loaders)
+#pragma warning disable CS0612, CS0618 // deprecated code
+            if (this.Editors.Count > 0 || this.Loaders.Count > 0)
             {
-                // check if loader applies
-                try
-                {
-                    if (!loader.Data.CanLoad<T>(legacyInfo))
-                        continue;
-                }
-                catch (Exception ex)
-                {
-                    loader.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{legacyInfo.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
-                    continue;
-                }
+                IAssetInfo legacyInfo = this.GetLegacyAssetInfo(info);
 
-                // add operation
-                yield return this.GetOrCreateLegacyOperationGroup(
-                    cache: this.LegacyLoaderCache,
-                    editor: loader.Data,
-                    dataType: info.DataType,
-                    createGroup: () => new AssetOperationGroup(
-                        Mod: loader.Mod,
-                        LoadOperations: new[]
-                        {
-                            new AssetLoadOperation(
+                foreach (ModLinked<IAssetLoader> loader in this.Loaders)
+                {
+                    // check if loader applies
+                    try
+                    {
+                        if (!loader.Data.CanLoad<T>(legacyInfo))
+                            continue;
+                    }
+                    catch (Exception ex)
+                    {
+                        loader.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{legacyInfo.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
+                        continue;
+                    }
+
+                    // add operation
+                    group ??= new AssetOperationGroup(new List<AssetLoadOperation>(), new List<AssetEditOperation>());
+                    group.LoadOperations.Add(
+                        this.GetOrCreateLegacyOperation(
+                            cache: this.LegacyLoaderCache,
+                            editor: loader.Data,
+                            dataType: info.DataType,
+                            create: () => new AssetLoadOperation(
                                 Mod: loader.Mod,
                                 OnBehalfOf: null,
                                 Priority: AssetLoadPriority.Exclusive,
@@ -626,59 +621,54 @@ namespace StardewModdingAPI.Framework
                                     this.GetLegacyAssetInfo(assetInfo)
                                 )
                             )
-                        },
-                        EditOperations: Array.Empty<AssetEditOperation>()
-                    )
-                );
-            }
+                        )
+                    );
+                }
 
-            // legacy edit operations
-            foreach (var editor in this.Editors)
-            {
-                // check if editor applies
-                try
+                // legacy edit operations
+                foreach (var editor in this.Editors)
                 {
-                    if (!editor.Data.CanEdit<T>(legacyInfo))
+                    // check if editor applies
+                    try
+                    {
+                        if (!editor.Data.CanEdit<T>(legacyInfo))
+                            continue;
+                    }
+                    catch (Exception ex)
+                    {
+                        editor.Mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{legacyInfo.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                         continue;
-                }
-                catch (Exception ex)
-                {
-                    editor.Mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{legacyInfo.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
-                    continue;
-                }
+                    }
 
-                // HACK
-                //
-                // If two editors have the same priority, they're applied in registration order (so
-                // whichever was registered first is applied first). Mods often depend on this
-                // behavior, like Json Assets registering its interceptors before Content Patcher.
-                //
-                // Unfortunately the old & new content APIs have separate lists, so new-API
-                // interceptors always ran before old-API interceptors with the same priority,
-                // regardless of the registration order *between* APIs. Since the new API works in
-                // a fundamentally different way (i.e. loads/edits are defined on asset request
-                // instead of by registering a global 'editor' or 'loader' class), there's no way
-                // to track registration order between them.
-                //
-                // Until we drop the old content API in SMAPI 4.0.0, this sets the priority for
-                // specific legacy editors to maintain compatibility.
-                AssetEditPriority priority = editor.Data.GetType().FullName switch
-                {
-                    "JsonAssets.Framework.ContentInjector1" => AssetEditPriority.Default - 1, // must be applied before Content Patcher
-                    _ => AssetEditPriority.Default
-                };
+                    // HACK
+                    //
+                    // If two editors have the same priority, they're applied in registration order (so
+                    // whichever was registered first is applied first). Mods often depend on this
+                    // behavior, like Json Assets registering its interceptors before Content Patcher.
+                    //
+                    // Unfortunately the old & new content APIs have separate lists, so new-API
+                    // interceptors always ran before old-API interceptors with the same priority,
+                    // regardless of the registration order *between* APIs. Since the new API works in
+                    // a fundamentally different way (i.e. loads/edits are defined on asset request
+                    // instead of by registering a global 'editor' or 'loader' class), there's no way
+                    // to track registration order between them.
+                    //
+                    // Until we drop the old content API in SMAPI 4.0.0, this sets the priority for
+                    // specific legacy editors to maintain compatibility.
+                    AssetEditPriority priority = editor.Data.GetType().FullName switch
+                    {
+                        "JsonAssets.Framework.ContentInjector1" => AssetEditPriority.Default - 1, // must be applied before Content Patcher
+                        _ => AssetEditPriority.Default
+                    };
 
-                // add operation
-                yield return this.GetOrCreateLegacyOperationGroup(
-                    cache: this.LegacyEditorCache,
-                    editor: editor.Data,
-                    dataType: info.DataType,
-                    createGroup: () => new AssetOperationGroup(
-                        Mod: editor.Mod,
-                        LoadOperations: Array.Empty<AssetLoadOperation>(),
-                        EditOperations: new[]
-                        {
-                            new AssetEditOperation(
+                    // add operation
+                    group ??= new AssetOperationGroup(new List<AssetLoadOperation>(), new List<AssetEditOperation>());
+                    group.EditOperations.Add(
+                        this.GetOrCreateLegacyOperation(
+                            cache: this.LegacyEditorCache,
+                            editor: editor.Data,
+                            dataType: info.DataType,
+                            create: () => new AssetEditOperation(
                                 Mod: editor.Mod,
                                 OnBehalfOf: null,
                                 Priority: priority,
@@ -686,28 +676,32 @@ namespace StardewModdingAPI.Framework
                                     this.GetLegacyAssetData(assetData)
                                 )
                             )
-                        }
-                    )
-                );
+                        )
+                    );
+                }
             }
+#pragma warning restore CS0612, CS0618
+
+            return group;
         }
 
         /// <summary>Get a cached asset operation group for a legacy <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> instance, creating it if needed.</summary>
         /// <typeparam name="TInterceptor">The editor type (one of <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/>).</typeparam>
+        /// <typeparam name="TOperation">The operation model type.</typeparam>
         /// <param name="cache">The cached operation groups for the interceptor type.</param>
         /// <param name="editor">The legacy asset interceptor.</param>
         /// <param name="dataType">The asset data type.</param>
-        /// <param name="createGroup">Create the asset operation group if it's not cached yet.</param>
-        private AssetOperationGroup GetOrCreateLegacyOperationGroup<TInterceptor>(Dictionary<TInterceptor, Dictionary<Type, AssetOperationGroup>> cache, TInterceptor editor, Type dataType, Func<AssetOperationGroup> createGroup)
+        /// <param name="create">Create the asset operation group if it's not cached yet.</param>
+        private TOperation GetOrCreateLegacyOperation<TInterceptor, TOperation>(Dictionary<TInterceptor, Dictionary<Type, TOperation>> cache, TInterceptor editor, Type dataType, Func<TOperation> create)
             where TInterceptor : class
         {
-            if (!cache.TryGetValue(editor, out Dictionary<Type, AssetOperationGroup>? cacheByType))
-                cache[editor] = cacheByType = new Dictionary<Type, AssetOperationGroup>();
+            if (!cache.TryGetValue(editor, out Dictionary<Type, TOperation>? cacheByType))
+                cache[editor] = cacheByType = new Dictionary<Type, TOperation>();
 
-            if (!cacheByType.TryGetValue(dataType, out AssetOperationGroup? group))
-                cacheByType[dataType] = group = createGroup();
+            if (!cacheByType.TryGetValue(dataType, out TOperation? operation))
+                cacheByType[dataType] = operation = create();
 
-            return group;
+            return operation;
         }
 
         /// <summary>Get an asset info compatible with legacy <see cref="IAssetLoader"/> and <see cref="IAssetEditor"/> instances, which always expect the base name.</summary>
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index c53040e1..2aa50542 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -75,15 +75,19 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // custom asset from a loader
             string locale = this.GetLocale();
             IAssetInfo info = new AssetInfo(locale, assetName, typeof(T), this.AssertAndNormalizeAssetName);
-            AssetLoadOperation[] loaders = this.GetLoaders<object>(info).ToArray();
-
-            if (!this.AssertMaxOneRequiredLoader(info, loaders, out string? error))
+            AssetOperationGroup? operations = this.Coordinator.GetAssetOperations<object>(info);
+            if (operations?.LoadOperations.Count > 0)
             {
-                this.Monitor.Log(error, LogLevel.Warn);
-                return false;
+                if (!this.AssertMaxOneRequiredLoader(info, operations.LoadOperations, out string? error))
+                {
+                    this.Monitor.Log(error, LogLevel.Warn);
+                    return false;
+                }
+
+                return true;
             }
 
-            return loaders.Any();
+            return false;
         }
 
         /// <inheritdoc />
@@ -121,10 +125,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 data = this.AssetsBeingLoaded.Track(assetName.Name, () =>
                 {
                     IAssetInfo info = new AssetInfo(assetName.LocaleCode, assetName, typeof(T), this.AssertAndNormalizeAssetName);
+                    AssetOperationGroup? operations = this.Coordinator.GetAssetOperations<T>(info);
                     IAssetData asset =
-                        this.ApplyLoader<T>(info)
+                        this.ApplyLoader<T>(info, operations?.LoadOperations)
                         ?? new AssetDataForObject(info, this.RawLoad<T>(assetName, useCache), this.AssertAndNormalizeAssetName, this.Reflection);
-                    asset = this.ApplyEditors<T>(info, asset);
+                    asset = this.ApplyEditors<T>(info, asset, operations?.EditOperations);
                     return (T)asset.Data;
                 });
             }
@@ -149,25 +154,23 @@ namespace StardewModdingAPI.Framework.ContentManagers
         *********/
         /// <summary>Load the initial asset from the registered loaders.</summary>
         /// <param name="info">The basic asset metadata.</param>
+        /// <param name="loadOperations">The load operations to apply to the asset.</param>
         /// <returns>Returns the loaded asset metadata, or <c>null</c> if no loader matched.</returns>
-        private IAssetData? ApplyLoader<T>(IAssetInfo info)
+        private IAssetData? ApplyLoader<T>(IAssetInfo info, List<AssetLoadOperation>? loadOperations)
             where T : notnull
         {
             // find matching loader
-            AssetLoadOperation? loader;
+            AssetLoadOperation? loader = null;
+            if (loadOperations?.Count > 0)
             {
-                AssetLoadOperation[] loaders = this.GetLoaders<T>(info).OrderByDescending(p => p.Priority).ToArray();
-
-                if (!this.AssertMaxOneRequiredLoader(info, loaders, out string? error))
+                if (!this.AssertMaxOneRequiredLoader(info, loadOperations, out string? error))
                 {
                     this.Monitor.Log(error, LogLevel.Warn);
                     return null;
                 }
 
-                loader = loaders.FirstOrDefault();
+                loader = loadOperations.OrderByDescending(p => p.Priority).FirstOrDefault();
             }
-
-            // no loader found
             if (loader == null)
                 return null;
 
@@ -195,9 +198,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The basic asset metadata.</param>
         /// <param name="asset">The loaded asset.</param>
-        private IAssetData ApplyEditors<T>(IAssetInfo info, IAssetData asset)
+        /// <param name="editOperations">The edit operations to apply to the asset.</param>
+        private IAssetData ApplyEditors<T>(IAssetInfo info, IAssetData asset, List<AssetEditOperation>? editOperations)
             where T : notnull
         {
+            if (editOperations?.Count is not > 0)
+                return asset;
+
             IAssetData GetNewData(object data) => new AssetDataForObject(info, data, this.AssertAndNormalizeAssetName, this.Reflection);
 
             // special case: if the asset was loaded with a more general type like 'object', call editors with the actual type instead.
@@ -210,12 +217,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     return (IAssetData)this.GetType()
                         .GetMethod(nameof(this.ApplyEditors), BindingFlags.NonPublic | BindingFlags.Instance)!
                         .MakeGenericMethod(actualType)
-                        .Invoke(this, new object[] { info, asset })!;
+                        .Invoke(this, new object[] { info, asset, editOperations })!;
                 }
             }
 
             // edit asset
-            AssetEditOperation[] editors = this.GetEditors<T>(info).OrderBy(p => p.Priority).ToArray();
+            AssetEditOperation[] editors = editOperations.OrderBy(p => p.Priority).ToArray();
             foreach (AssetEditOperation editor in editors)
             {
                 IModMetadata mod = editor.Mod;
@@ -250,34 +257,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return asset;
         }
 
-        /// <summary>Get the asset loaders which handle an asset.</summary>
-        /// <typeparam name="T">The asset type.</typeparam>
-        /// <param name="info">The basic asset metadata.</param>
-        private IEnumerable<AssetLoadOperation> GetLoaders<T>(IAssetInfo info)
-            where T : notnull
-        {
-            return this.Coordinator
-                .GetAssetOperations<T>(info)
-                .SelectMany(p => p.LoadOperations);
-        }
-
-        /// <summary>Get the asset editors to apply to an asset.</summary>
-        /// <typeparam name="T">The asset type.</typeparam>
-        /// <param name="info">The basic asset metadata.</param>
-        private IEnumerable<AssetEditOperation> GetEditors<T>(IAssetInfo info)
-            where T : notnull
-        {
-            return this.Coordinator
-                .GetAssetOperations<T>(info)
-                .SelectMany(p => p.EditOperations);
-        }
-
         /// <summary>Assert that at most one loader will be applied to an asset.</summary>
         /// <param name="info">The basic asset metadata.</param>
         /// <param name="loaders">The asset loaders to apply.</param>
         /// <param name="error">The error message to show to the user, if the method returns false.</param>
         /// <returns>Returns true if only one loader will apply, else false.</returns>
-        private bool AssertMaxOneRequiredLoader(IAssetInfo info, AssetLoadOperation[] loaders, [NotNullWhen(false)] out string? error)
+        private bool AssertMaxOneRequiredLoader(IAssetInfo info, List<AssetLoadOperation> loaders, [NotNullWhen(false)] out string? error)
         {
             AssetLoadOperation[] required = loaders.Where(p => p.Priority == AssetLoadPriority.Exclusive).ToArray();
             if (required.Length <= 1)
@@ -295,7 +280,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 ? $"Multiple mods want to provide the '{info.Name}' asset: {string.Join(", ", loaderNames)}"
                 : $"The '{loaderNames[0]}' mod wants to provide the '{info.Name}' asset multiple times";
 
-            error = $"{errorPhrase}. An asset can't be loaded multiple times, so SMAPI will use the default asset instead. Uninstall one of the mods to fix this. (Message for modders: you should usually use {typeof(IAssetEditor)} instead to avoid conflicts.)";
+            error = $"{errorPhrase}. An asset can't be loaded multiple times, so SMAPI will use the default asset instead. Uninstall one of the mods to fix this. (Message for modders: you should avoid {nameof(AssetLoadPriority)}.{nameof(AssetLoadPriority.Exclusive)} and {nameof(IAssetLoader)} if possible to avoid conflicts.)";
             return false;
         }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index ec21e38a..41b975e8 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1178,35 +1178,27 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</summary>
         /// <param name="asset">The asset info being requested.</param>
-        private IList<AssetOperationGroup> RequestAssetOperations(IAssetInfo asset)
+        private AssetOperationGroup? RequestAssetOperations(IAssetInfo asset)
         {
             // get event
-            var @event = this.EventManager.AssetRequested;
-            if (!@event.HasListeners)
-                return Array.Empty<AssetOperationGroup>();
+            var requestedEvent = this.EventManager.AssetRequested;
+            if (!requestedEvent.HasListeners)
+                return null;
 
-            // get operations
-            List<AssetOperationGroup>? operations = null;
-            @event.Raise(
+            // raise event
+            AssetRequestedEventArgs args = new(asset, this.GetOnBehalfOfContentPack);
+            requestedEvent.Raise(
                 invoke: (mod, invoke) =>
                 {
-                    AssetRequestedEventArgs args = new(mod, asset, this.GetOnBehalfOfContentPack);
-
+                    args.SetMod(mod);
                     invoke(args);
-
-                    if (args.LoadOperations.Any() || args.EditOperations.Any())
-                    {
-                        operations ??= new();
-                        operations.Add(
-                            new AssetOperationGroup(mod, args.LoadOperations.ToArray(), args.EditOperations.ToArray())
-                        );
-                    }
                 }
             );
 
-            return operations != null
-                ? operations
-                : Array.Empty<AssetOperationGroup>();
+            // collect operations
+            return args.LoadOperations.Count != 0 || args.EditOperations.Count != 0
+                ? new AssetOperationGroup(args.LoadOperations, args.EditOperations)
+                : null;
         }
 
         /// <summary>Get the mod metadata for a content pack whose ID matches <paramref name="id"/>, if it's a valid content pack for the given <paramref name="mod"/>.</summary>

From 5a7422b3122dc0c46c6fe9b445eae0bc5df77298 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 11 May 2022 22:32:33 -0400
Subject: [PATCH 632/856] log time change in verbose mode

---
 docs/release-notes.md        |  1 +
 src/SMAPI/Framework/SCore.cs | 10 ++++++++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b35a4760..53711454 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,7 @@
 
 * For mod authors:
   * Refactored how event handling works under the hood, particularly the new content API. This should have no effect on mod usage.
+  * In-game time changes are now logged in verbose mod.
   * Fixed error when loading a `.xnb` file through the old content API without the file extension.
   * Fixed asset propagation for player sprites not fully updating recolor masks in some cases.
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 41b975e8..5ae4fdbb 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -960,8 +960,14 @@ namespace StardewModdingAPI.Framework
                         }
 
                         // raise time changed
-                        if (raiseWorldEvents && state.Time.IsChanged && events.TimeChanged.HasListeners)
-                            events.TimeChanged.Raise(new TimeChangedEventArgs(state.Time.Old, state.Time.New));
+                        if (raiseWorldEvents && state.Time.IsChanged)
+                        {
+                            if (verbose)
+                                this.Monitor.Log($"Context: time changed to {state.Time.New}.");
+
+                            if (events.TimeChanged.HasListeners)
+                                events.TimeChanged.Raise(new TimeChangedEventArgs(state.Time.Old, state.Time.New));
+                        }
 
                         // raise player events
                         if (raiseWorldEvents)

From e943ae84136d46432e04e577041850d2aa7db43e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 12 May 2022 00:21:46 -0400
Subject: [PATCH 633/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 8 +++++---
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 0436ed5b..a7db917c 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.14.2</Version>
+    <Version>3.14.3</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 53711454..6311d7dc 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,13 +1,15 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.14.3
+Released 12 May 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
-  * Reduced mods' in-game performance impact.
+  * Reduced in-game performance impact.
 
 * For mod authors:
   * Refactored how event handling works under the hood, particularly the new content API. This should have no effect on mod usage.
-  * In-game time changes are now logged in verbose mod.
+  * Verbose mode now logs the in-game time.
   * Fixed error when loading a `.xnb` file through the old content API without the file extension.
   * Fixed asset propagation for player sprites not fully updating recolor masks in some cases.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index c263456a..0e2b023d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.14.2",
+    "Version": "3.14.3",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.14.2"
+    "MinimumApiVersion": "3.14.3"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 6e6a271f..f449b3bd 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.14.2",
+    "Version": "3.14.3",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.14.2"
+    "MinimumApiVersion": "3.14.3"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 5ba91568..23e241b5 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.14.2",
+    "Version": "3.14.3",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.14.2"
+    "MinimumApiVersion": "3.14.3"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index a289ce4b..ef729f4f 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.14.2";
+        internal static string RawApiVersion = "3.14.3";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 3a4758dfa63f0f8e03166bffa15e16f7995499d7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 14 May 2022 13:32:13 -0400
Subject: [PATCH 634/856] remove warning for mods which use `dynamic`

---
 docs/release-notes.md                                     | 5 +++++
 src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs         | 1 +
 src/SMAPI/Framework/Logging/LogManager.cs                 | 5 -----
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs          | 5 -----
 src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs | 3 ---
 src/SMAPI/Metadata/InstructionMetadata.cs                 | 1 -
 6 files changed, 6 insertions(+), 14 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6311d7dc..da3b666c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,11 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For mod authors:
+  * Removed warning for mods which use `dynamic`.  
+    _This no longer causes errors on Linux/macOS after Stardew Valley 1.5.5._
+
 ## 3.14.3
 Released 12 May 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
index afebba87..cf804df4 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
@@ -19,6 +19,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         PatchesGame = 4,
 
         /// <summary>The mod uses the <c>dynamic</c> keyword which won't work on Linux/macOS.</summary>
+        [Obsolete("This value is no longer used by SMAPI and will be removed in the upcoming SMAPI 4.0.0.")]
         UsesDynamic = 8,
 
         /// <summary>The mod references specialized 'unvalidated update tick' events which may impact stability.</summary>
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index b94807b5..ed5b6959 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -511,11 +511,6 @@ namespace StardewModdingAPI.Framework.Logging
                     "These mods have no update keys in their manifest. SMAPI may not notify you about updates for these",
                     "mods. Consider notifying the mod authors about this problem."
                 );
-
-                // not crossplatform
-                this.LogModWarningGroup(modsWithWarnings, ModWarning.UsesDynamic, LogLevel.Debug, "Not crossplatform",
-                    "These mods use the 'dynamic' keyword, and won't work on Linux/macOS."
-                );
             }
         }
 
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index a6756e0e..fb5ebc01 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -414,11 +414,6 @@ namespace StardewModdingAPI.Framework.ModLoading
                     mod.SetWarning(ModWarning.UsesUnvalidatedUpdateTick);
                     break;
 
-                case InstructionHandleResult.DetectedDynamic:
-                    template = $"{logPrefix}Detected 'dynamic' keyword ($phrase) in assembly {filename}.";
-                    mod.SetWarning(ModWarning.UsesDynamic);
-                    break;
-
                 case InstructionHandleResult.DetectedConsoleAccess:
                     template = $"{logPrefix}Detected direct console access ($phrase) in assembly {filename}.";
                     mod.SetWarning(ModWarning.AccessesConsole);
diff --git a/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs b/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
index baffc50e..e3f108cb 100644
--- a/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
+++ b/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
@@ -20,9 +20,6 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>The instruction is compatible, but affects the save serializer in a way that may make saves unloadable without the mod.</summary>
         DetectedSaveSerializer,
 
-        /// <summary>The instruction is compatible, but uses the <c>dynamic</c> keyword which won't work on Linux/macOS.</summary>
-        DetectedDynamic,
-
         /// <summary>The instruction is compatible, but references <see cref="ISpecializedEvents.UnvalidatedUpdateTicking"/> or <see cref="ISpecializedEvents.UnvalidatedUpdateTicked"/> which may impact stability.</summary>
         DetectedUnvalidatedUpdateTick,
 
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 9b56f963..4d512546 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -67,7 +67,6 @@ namespace StardewModdingAPI.Metadata
             /****
             ** detect code which may impact game stability
             ****/
-            yield return new TypeFinder("System.Runtime.CompilerServices.CallSite", InstructionHandleResult.DetectedDynamic);
             yield return new FieldFinder(typeof(SaveGame).FullName!, new[] { nameof(SaveGame.serializer), nameof(SaveGame.farmerSerializer), nameof(SaveGame.locationSerializer) }, InstructionHandleResult.DetectedSaveSerializer);
             yield return new EventFinder(typeof(ISpecializedEvents).FullName!, new[] { nameof(ISpecializedEvents.UnvalidatedUpdateTicked), nameof(ISpecializedEvents.UnvalidatedUpdateTicking) }, InstructionHandleResult.DetectedUnvalidatedUpdateTick);
 

From 048f41244f6b2c7f95ac5bf75be2b16f42b99169 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 15 May 2022 01:54:01 -0400
Subject: [PATCH 635/856] reduce performance impact of deprecation warnings

Creating a stack is *very* slow, so it should be avoided if possible until after the duplicate-warning check.
---
 docs/release-notes.md                         |  3 ++
 src/SMAPI/Constants.cs                        |  2 +-
 src/SMAPI/Context.cs                          |  5 +++
 src/SMAPI/Framework/Content/AssetInfo.cs      |  4 +-
 .../Content/AssetInterceptorChange.cs         | 10 +++++
 src/SMAPI/Framework/ContentCoordinator.cs     | 18 +++++---
 .../ContentManagers/GameContentManager.cs     | 12 +++++-
 .../Deprecations/DeprecationManager.cs        | 41 ++++++++++++-------
 src/SMAPI/Framework/Events/ManagedEvent.cs    | 12 ++++++
 .../Framework/ModHelpers/CommandHelper.cs     |  2 +-
 src/SMAPI/Framework/ModHelpers/ModHelper.cs   |  2 +-
 src/SMAPI/Framework/ModRegistry.cs            |  9 +---
 src/SMAPI/Framework/SCore.cs                  | 18 ++++++--
 src/SMAPI/Utilities/PerScreen.cs              |  2 +-
 14 files changed, 103 insertions(+), 37 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index da3b666c..1d1e3760 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Improved performance for mods using deprecated APIs.
+
 * For mod authors:
   * Removed warning for mods which use `dynamic`.  
     _This no longer causes errors on Linux/macOS after Stardew Valley 1.5.5._
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index ef729f4f..6c9a56cc 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -84,7 +84,7 @@ namespace StardewModdingAPI
             get
             {
                 SCore.DeprecationManager.Warn(
-                    source: SCore.DeprecationManager.GetModFromStack(),
+                    source: null,
                     nounPhrase: $"{nameof(Constants)}.{nameof(Constants.ExecutionPath)}",
                     version: "3.14.0",
                     severity: DeprecationLevel.Notice
diff --git a/src/SMAPI/Context.cs b/src/SMAPI/Context.cs
index aa4ecf35..c822908e 100644
--- a/src/SMAPI/Context.cs
+++ b/src/SMAPI/Context.cs
@@ -1,6 +1,7 @@
 using System.Collections.Generic;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Events;
+using StardewModdingAPI.Framework;
 using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.Menus;
@@ -41,6 +42,10 @@ namespace StardewModdingAPI
         /// <summary>Whether the in-game world is completely unloaded and not in the process of being loaded. The world may still exist in memory at this point, but should be ignored.</summary>
         internal static bool IsWorldFullyUnloaded => Context.LoadStage is LoadStage.ReturningToTitle or LoadStage.None;
 
+        /// <summary>If SMAPI is currently waiting for mod code, the mods to which it belongs (with the most recent at the top of the stack).</summary>
+        /// <remarks><strong>This is heuristic only.</strong> It provides a quick way to identify the most likely mod for deprecation warnings, but it should be followed with a more accurate check if needed.</remarks>
+        internal static Stack<IModMetadata> HeuristicModsRunningCode { get; } = new();
+
 
         /*********
         ** Accessors
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index a4f0a408..773e3126 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -36,7 +36,7 @@ namespace StardewModdingAPI.Framework.Content
             get
             {
                 SCore.DeprecationManager.Warn(
-                    source: SCore.DeprecationManager.GetModFromStack(),
+                    source: null,
                     nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetName)}",
                     version: "3.14.0",
                     severity: DeprecationLevel.Notice,
@@ -76,7 +76,7 @@ namespace StardewModdingAPI.Framework.Content
         public bool AssetNameEquals(string path)
         {
             SCore.DeprecationManager.Warn(
-                source: SCore.DeprecationManager.GetModFromStack(),
+                source: null,
                 nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetNameEquals)}",
                 version: "3.14.0",
                 severity: DeprecationLevel.Notice,
diff --git a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
index fc8199e8..f3d4f3f4 100644
--- a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
+++ b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
@@ -64,6 +64,7 @@ namespace StardewModdingAPI.Framework.Content
             // check edit
             if (this.Instance is IAssetEditor editor)
             {
+                Context.HeuristicModsRunningCode.Push(this.Mod);
                 try
                 {
                     if (editor.CanEdit<TAsset>(asset))
@@ -73,11 +74,16 @@ namespace StardewModdingAPI.Framework.Content
                 {
                     this.Mod.LogAsMod($"Mod failed when checking whether it could edit asset '{asset.Name}'. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 }
+                finally
+                {
+                    Context.HeuristicModsRunningCode.TryPop(out _);
+                }
             }
 
             // check load
             if (this.Instance is IAssetLoader loader)
             {
+                Context.HeuristicModsRunningCode.Push(this.Mod);
                 try
                 {
                     if (loader.CanLoad<TAsset>(asset))
@@ -87,6 +93,10 @@ namespace StardewModdingAPI.Framework.Content
                 {
                     this.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{asset.Name}'. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 }
+                finally
+                {
+                    Context.HeuristicModsRunningCode.TryPop(out _);
+                }
             }
 
             return false;
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index a24581a0..2b13f57a 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -595,6 +595,7 @@ namespace StardewModdingAPI.Framework
                 foreach (ModLinked<IAssetLoader> loader in this.Loaders)
                 {
                     // check if loader applies
+                    Context.HeuristicModsRunningCode.Push(loader.Mod);
                     try
                     {
                         if (!loader.Data.CanLoad<T>(legacyInfo))
@@ -605,6 +606,10 @@ namespace StardewModdingAPI.Framework
                         loader.Mod.LogAsMod($"Mod failed when checking whether it could load asset '{legacyInfo.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                         continue;
                     }
+                    finally
+                    {
+                        Context.HeuristicModsRunningCode.TryPop(out _);
+                    }
 
                     // add operation
                     group ??= new AssetOperationGroup(new List<AssetLoadOperation>(), new List<AssetEditOperation>());
@@ -617,9 +622,7 @@ namespace StardewModdingAPI.Framework
                                 Mod: loader.Mod,
                                 OnBehalfOf: null,
                                 Priority: AssetLoadPriority.Exclusive,
-                                GetData: assetInfo => loader.Data.Load<T>(
-                                    this.GetLegacyAssetInfo(assetInfo)
-                                )
+                                GetData: assetInfo => loader.Data.Load<T>(this.GetLegacyAssetInfo(assetInfo))
                             )
                         )
                     );
@@ -629,6 +632,7 @@ namespace StardewModdingAPI.Framework
                 foreach (var editor in this.Editors)
                 {
                     // check if editor applies
+                    Context.HeuristicModsRunningCode.Push(editor.Mod);
                     try
                     {
                         if (!editor.Data.CanEdit<T>(legacyInfo))
@@ -639,6 +643,10 @@ namespace StardewModdingAPI.Framework
                         editor.Mod.LogAsMod($"Mod crashed when checking whether it could edit asset '{legacyInfo.Name}', and will be ignored. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                         continue;
                     }
+                    finally
+                    {
+                        Context.HeuristicModsRunningCode.TryPop(out _);
+                    }
 
                     // HACK
                     //
@@ -672,9 +680,7 @@ namespace StardewModdingAPI.Framework
                                 Mod: editor.Mod,
                                 OnBehalfOf: null,
                                 Priority: priority,
-                                ApplyEdit: assetData => editor.Data.Edit<T>(
-                                    this.GetLegacyAssetData(assetData)
-                                )
+                                ApplyEdit: assetData => editor.Data.Edit<T>(this.GetLegacyAssetData(assetData))
                             )
                         )
                     );
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 2aa50542..1c603f85 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -177,6 +177,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // fetch asset from loader
             IModMetadata mod = loader.Mod;
             T data;
+            Context.HeuristicModsRunningCode.Push(loader.Mod);
             try
             {
                 data = (T)loader.GetData(info);
@@ -187,6 +188,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 mod.LogAsMod($"Mod crashed when loading asset '{info.Name}'{this.GetOnBehalfOfLabel(loader.OnBehalfOf)}. SMAPI will use the default asset instead. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 return null;
             }
+            finally
+            {
+                Context.HeuristicModsRunningCode.TryPop(out _);
+            }
 
             // return matched asset
             return this.TryFixAndValidateLoadedAsset(info, data, loader)
@@ -229,6 +234,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
                 // try edit
                 object prevAsset = asset.Data;
+                Context.HeuristicModsRunningCode.Push(editor.Mod);
                 try
                 {
                     editor.ApplyEdit(asset);
@@ -238,9 +244,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 {
                     mod.LogAsMod($"Mod crashed when editing asset '{info.Name}'{this.GetOnBehalfOfLabel(editor.OnBehalfOf)}, which may cause errors in-game. Error details:\n{ex.GetLogSummary()}", LogLevel.Error);
                 }
+                finally
+                {
+                    Context.HeuristicModsRunningCode.TryPop(out _);
+                }
 
                 // validate edit
-                // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- it's only guaranteed non-null after this method
+                // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- it's only guaranteed non-null after this method
                 if (asset.Data == null)
                 {
                     mod.LogAsMod($"Mod incorrectly set asset '{info.Name}'{this.GetOnBehalfOfLabel(editor.OnBehalfOf)} to a null value; ignoring override.", LogLevel.Warn);
diff --git a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index 288abde2..3bbbd7b8 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -37,13 +37,6 @@ namespace StardewModdingAPI.Framework.Deprecations
             this.ModRegistry = modRegistry;
         }
 
-        /// <summary>Get a mod for the closest assembly registered as a source of deprecation warnings.</summary>
-        /// <returns>Returns the source name, or <c>null</c> if no registered assemblies were found.</returns>
-        public IModMetadata? GetModFromStack()
-        {
-            return this.ModRegistry.GetFromStack();
-        }
-
         /// <summary>Get a mod from its unique ID.</summary>
         /// <param name="modId">The mod's unique ID.</param>
         public IModMetadata? GetMod(string modId)
@@ -52,7 +45,7 @@ namespace StardewModdingAPI.Framework.Deprecations
         }
 
         /// <summary>Log a deprecation warning.</summary>
-        /// <param name="source">The mod which used the deprecated code, if known.</param>
+        /// <param name="source">The mod which used the deprecated code, or <c>null</c> to get it heuristically. Note that getting it heuristically is very slow in some cases, and should be avoided if at all possible.</param>
         /// <param name="nounPhrase">A noun phrase describing what is deprecated.</param>
         /// <param name="version">The SMAPI version which deprecated it.</param>
         /// <param name="severity">How deprecated the code is.</param>
@@ -60,18 +53,38 @@ namespace StardewModdingAPI.Framework.Deprecations
         /// <param name="logStackTrace">Whether to log a stack trace showing where the deprecated code is in the mod.</param>
         public void Warn(IModMetadata? source, string nounPhrase, string version, DeprecationLevel severity, string[]? unlessStackIncludes = null, bool logStackTrace = true)
         {
+            // get heuristic source
+            // The call stack is usually the most reliable way to get the source if it's unknown. This is *very* slow
+            // though, especially before we check whether this is a duplicate warning. The initial cache check uses a
+            // quick heuristic method if at all possible to avoid that.
+            IModMetadata? heuristicSource = source;
+            ImmutableStackTrace? stack = null;
+            if (heuristicSource is null)
+                Context.HeuristicModsRunningCode.TryPeek(out heuristicSource);
+            if (heuristicSource is null)
+            {
+                stack = ImmutableStackTrace.Get(skipFrames: 1);
+                heuristicSource = this.ModRegistry.GetFromStack(stack.GetFrames());
+            }
+
             // skip if already warned
-            string cacheKey = $"{source?.DisplayName ?? "<unknown>"}::{nounPhrase}::{version}";
+            string cacheKey = $"{heuristicSource?.Manifest.UniqueID ?? "<unknown>"}::{nounPhrase}::{version}";
             if (this.LoggedDeprecations.Contains(cacheKey))
                 return;
+            this.LoggedDeprecations.Add(cacheKey);
 
-            // warn if valid
-            ImmutableStackTrace stack = ImmutableStackTrace.Get(skipFrames: 1);
-            if (!this.ShouldSuppress(stack, unlessStackIncludes))
+            // get more accurate source
+            if (stack is not null)
+                source ??= heuristicSource!;
+            else
             {
-                this.LoggedDeprecations.Add(cacheKey);
-                this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, stack, logStackTrace));
+                stack ??= ImmutableStackTrace.Get(skipFrames: 1);
+                source ??= this.ModRegistry.GetFromStack(stack.GetFrames());
             }
+
+            // log unless suppressed
+            if (!this.ShouldSuppress(stack, unlessStackIncludes))
+                this.QueuedWarnings.Add(new DeprecationWarning(source, nounPhrase, version, severity, stack, logStackTrace));
         }
 
         /// <summary>A placeholder method used to track deprecated code for which a separate warning will be shown.</summary>
diff --git a/src/SMAPI/Framework/Events/ManagedEvent.cs b/src/SMAPI/Framework/Events/ManagedEvent.cs
index 8a3ca839..a72d8d04 100644
--- a/src/SMAPI/Framework/Events/ManagedEvent.cs
+++ b/src/SMAPI/Framework/Events/ManagedEvent.cs
@@ -104,6 +104,8 @@ namespace StardewModdingAPI.Framework.Events
             // raise event
             foreach (ManagedEventHandler<TEventArgs> handler in this.GetHandlers())
             {
+                Context.HeuristicModsRunningCode.Push(handler.SourceMod);
+
                 try
                 {
                     handler.Handler(null, args);
@@ -112,6 +114,10 @@ namespace StardewModdingAPI.Framework.Events
                 {
                     this.LogError(handler, ex);
                 }
+                finally
+                {
+                    Context.HeuristicModsRunningCode.TryPop(out _);
+                }
             }
         }
 
@@ -126,6 +132,8 @@ namespace StardewModdingAPI.Framework.Events
             // raise event
             foreach (ManagedEventHandler<TEventArgs> handler in this.GetHandlers())
             {
+                Context.HeuristicModsRunningCode.Push(handler.SourceMod);
+
                 try
                 {
                     invoke(handler.SourceMod, args => handler.Handler(null, args));
@@ -134,6 +142,10 @@ namespace StardewModdingAPI.Framework.Events
                 {
                     this.LogError(handler, ex);
                 }
+                finally
+                {
+                    Context.HeuristicModsRunningCode.TryPop(out _);
+                }
             }
         }
 
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index f39ed42e..ddbd618a 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -37,7 +37,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         public bool Trigger(string name, string[] arguments)
         {
             SCore.DeprecationManager.Warn(
-                source: SCore.DeprecationManager.GetMod(this.ModID),
+                source: this.Mod,
                 nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.ConsoleCommands)}.{nameof(ICommandHelper.Trigger)}",
                 version: "3.8.1",
                 severity: DeprecationLevel.Notice
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 008195d9..48973691 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -33,7 +33,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             get
             {
                 SCore.DeprecationManager.Warn(
-                    source: SCore.DeprecationManager.GetMod(this.ModID),
+                    source: this.Mod,
                     nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.Content)}",
                     version: "3.14.0",
                     severity: DeprecationLevel.Notice
diff --git a/src/SMAPI/Framework/ModRegistry.cs b/src/SMAPI/Framework/ModRegistry.cs
index 1ae5643f..1b0a076f 100644
--- a/src/SMAPI/Framework/ModRegistry.cs
+++ b/src/SMAPI/Framework/ModRegistry.cs
@@ -99,14 +99,10 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Get the mod metadata from the closest assembly registered as a source of deprecation warnings.</summary>
+        /// <param name="frames">The call stack to analyze.</param>
         /// <returns>Returns the mod's metadata, or <c>null</c> if no registered assemblies were found.</returns>
-        public IModMetadata? GetFromStack()
+        public IModMetadata? GetFromStack(StackFrame[] frames)
         {
-            // get stack frames
-            StackTrace stack = new();
-            StackFrame[] frames = stack.GetFrames();
-
-            // search stack for a source assembly
             foreach (StackFrame frame in frames)
             {
                 IModMetadata? mod = this.GetFrom(frame);
@@ -114,7 +110,6 @@ namespace StardewModdingAPI.Framework
                     return mod;
             }
 
-            // no known assembly found
             return null;
         }
     }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 5ae4fdbb..7042e83a 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1677,6 +1677,7 @@ namespace StardewModdingAPI.Framework
 #pragma warning restore CS0612, CS0618
 
                 // call entry method
+                Context.HeuristicModsRunningCode.Push(metadata);
                 try
                 {
                     IMod mod = metadata.Mod!;
@@ -1705,6 +1706,7 @@ namespace StardewModdingAPI.Framework
                 {
                     this.Monitor.Log($"Failed loading mod-provided API for {metadata.DisplayName}. Integrations with other mods may not work. Error: {ex.GetLogSummary()}", LogLevel.Error);
                 }
+                Context.HeuristicModsRunningCode.TryPop(out _);
             }
 
             // unlock mod integrations
@@ -1852,7 +1854,7 @@ namespace StardewModdingAPI.Framework
                 try
                 {
                     // get mod instance
-                    if (!this.TryLoadModEntry(modAssembly, out Mod? modEntry, out errorReasonPhrase))
+                    if (!this.TryLoadModEntry(mod, modAssembly, out Mod? modEntry, out errorReasonPhrase))
                     {
                         failReason = ModFailReason.LoadFailed;
                         return false;
@@ -1954,11 +1956,12 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Load a mod's entry class.</summary>
+        /// <param name="metadata">The mod metadata whose entry class is being loaded.</param>
         /// <param name="modAssembly">The mod assembly.</param>
         /// <param name="mod">The loaded instance.</param>
         /// <param name="error">The error indicating why loading failed (if applicable).</param>
         /// <returns>Returns whether the mod entry class was successfully loaded.</returns>
-        private bool TryLoadModEntry(Assembly modAssembly, [NotNullWhen(true)] out Mod? mod, [NotNullWhen(false)] out string? error)
+        private bool TryLoadModEntry(IModMetadata metadata, Assembly modAssembly, [NotNullWhen(true)] out Mod? mod, [NotNullWhen(false)] out string? error)
         {
             mod = null;
 
@@ -1976,7 +1979,16 @@ namespace StardewModdingAPI.Framework
             }
 
             // get implementation
-            mod = (Mod?)modAssembly.CreateInstance(modEntries[0].ToString());
+            Context.HeuristicModsRunningCode.Push(metadata);
+            try
+            {
+                mod = (Mod?)modAssembly.CreateInstance(modEntries[0].ToString());
+            }
+            finally
+            {
+                Context.HeuristicModsRunningCode.TryPop(out _);
+            }
+
             if (mod == null)
             {
                 error = "its entry class couldn't be instantiated.";
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 1c4c56fe..b86310b8 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -97,7 +97,7 @@ namespace StardewModdingAPI.Utilities
                 if (!nullExpected)
                 {
                     SCore.DeprecationManager.Warn(
-                        SCore.DeprecationManager.GetModFromStack(),
+                        null,
                         $"calling the {nameof(PerScreen<T>)} constructor with null",
                         "3.14.0",
                         DeprecationLevel.Notice

From 8505f4ae4dc5c7bf64c1ea9ae4ea9fd38c4bd1c4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 15 May 2022 15:07:52 -0400
Subject: [PATCH 636/856] fix typo

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 85e109c8..38a21383 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -121,7 +121,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
             catch (Exception ex) when (ex is not SContentLoadException)
             {
-                throw this.GetLoadError(assetName, ContentLoadErrorType.Other, "an unexpected occurred.", ex);
+                throw this.GetLoadError(assetName, ContentLoadErrorType.Other, "an unexpected error occurred.", ex);
             }
 
             // track & return asset

From 3253797cbab1e49901b9da3701954f93282363fd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 15 May 2022 19:13:32 -0400
Subject: [PATCH 637/856] fix wiki client not being disposed

---
 src/SMAPI.Toolkit/ModToolkit.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Toolkit/ModToolkit.cs b/src/SMAPI.Toolkit/ModToolkit.cs
index ce14b057..0df75a31 100644
--- a/src/SMAPI.Toolkit/ModToolkit.cs
+++ b/src/SMAPI.Toolkit/ModToolkit.cs
@@ -57,7 +57,7 @@ namespace StardewModdingAPI.Toolkit
         /// <summary>Extract mod metadata from the wiki compatibility list.</summary>
         public async Task<WikiModList> GetWikiCompatibilityListAsync()
         {
-            WikiClient client = new(this.UserAgent);
+            using WikiClient client = new(this.UserAgent);
             return await client.FetchModsAsync();
         }
 

From cd843dc10b902adc32e96e34c5db3ebf98e9a159 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 15 May 2022 19:14:28 -0400
Subject: [PATCH 638/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index a7db917c..76343b8d 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.14.3</Version>
+    <Version>3.14.4</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1d1e3760..c29bc39c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,7 +1,9 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.14.4
+Released 15 May 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
   * Improved performance for mods using deprecated APIs.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 0e2b023d..78d26802 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.14.3",
+    "Version": "3.14.4",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.14.3"
+    "MinimumApiVersion": "3.14.4"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index f449b3bd..be1030f4 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.14.3",
+    "Version": "3.14.4",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.14.3"
+    "MinimumApiVersion": "3.14.4"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 23e241b5..8a50162e 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.14.3",
+    "Version": "3.14.4",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.14.3"
+    "MinimumApiVersion": "3.14.4"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 6c9a56cc..357b8db8 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.14.3";
+        internal static string RawApiVersion = "3.14.4";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 3a161a30a7faa2d69ebe08938cd68f43921b4a81 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 18 May 2022 19:23:26 -0400
Subject: [PATCH 639/856] update for the new CurseForge API

---
 docs/release-notes.md                         |  4 ++
 .../Clients/CurseForge/CurseForgeClient.cs    | 25 +++++++----
 .../ResponseModels/ModLinksModel.cs           |  7 ++++
 .../CurseForge/ResponseModels/ModModel.cs     | 41 +++----------------
 .../ResponseModels/ResponseModel.cs           |  8 ++++
 .../ConfigModels/ApiClientsConfig.cs          |  3 ++
 src/SMAPI.Web/Startup.cs                      |  3 +-
 src/SMAPI.Web/appsettings.json                |  3 +-
 8 files changed, 50 insertions(+), 44 deletions(-)
 create mode 100644 src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModLinksModel.cs
 create mode 100644 src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ResponseModel.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c29bc39c..1f394849 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Fixed CurseForge update checks for the new CurseForge API.
+
 ## 3.14.4
 Released 15 May 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
index d351b42d..9b4f2580 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/CurseForgeClient.cs
@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using System.Net;
 using System.Text.RegularExpressions;
 using System.Threading.Tasks;
 using Pathoschild.Http.Client;
@@ -33,9 +34,12 @@ namespace StardewModdingAPI.Web.Framework.Clients.CurseForge
         /// <summary>Construct an instance.</summary>
         /// <param name="userAgent">The user agent for the API client.</param>
         /// <param name="apiUrl">The base URL for the CurseForge API.</param>
-        public CurseForgeClient(string userAgent, string apiUrl)
+        /// <param name="apiKey">The API authentication key.</param>
+        public CurseForgeClient(string userAgent, string apiUrl, string apiKey)
         {
-            this.Client = new FluentClient(apiUrl).SetUserAgent(userAgent);
+            this.Client = new FluentClient(apiUrl)
+                .SetUserAgent(userAgent)
+                .AddDefault(request => request.WithHeader("x-api-key", apiKey));
         }
 
         /// <summary>Get update check info about a mod.</summary>
@@ -49,11 +53,18 @@ namespace StardewModdingAPI.Web.Framework.Clients.CurseForge
                 return page.SetError(RemoteModStatus.DoesNotExist, $"The value '{id}' isn't a valid CurseForge mod ID, must be an integer ID.");
 
             // get raw data
-            ModModel? mod = await this.Client
-                .GetAsync($"addon/{parsedId}")
-                .As<ModModel?>();
-            if (mod == null)
+            ModModel? mod;
+            try
+            {
+                ResponseModel<ModModel> response = await this.Client
+                    .GetAsync($"mods/{parsedId}")
+                    .As<ResponseModel<ModModel>>();
+                mod = response.Data;
+            }
+            catch (ApiException ex) when (ex.Status == HttpStatusCode.NotFound)
+            {
                 return page.SetError(RemoteModStatus.DoesNotExist, "Found no CurseForge mod with this ID.");
+            }
 
             // get downloads
             List<IModDownload> downloads = new List<IModDownload>();
@@ -65,7 +76,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.CurseForge
             }
 
             // return info
-            return page.SetInfo(name: mod.Name, version: null, url: mod.WebsiteUrl, downloads: downloads);
+            return page.SetInfo(name: mod.Name, version: null, url: mod.Links.WebsiteUrl, downloads: downloads);
         }
 
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModLinksModel.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModLinksModel.cs
new file mode 100644
index 00000000..2f9abe4f
--- /dev/null
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModLinksModel.cs
@@ -0,0 +1,7 @@
+namespace StardewModdingAPI.Web.Framework.Clients.CurseForge.ResponseModels
+{
+    /// <summary>A list of links for a mod.</summary>
+    /// <param name="WebsiteUrl">The URL for the CurseForge mod page.</param>
+    /// <param name="SourceUrl">The URL for the mod's source code, if any.</param>
+    public record ModLinksModel(string WebsiteUrl, string? SourceUrl);
+}
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
index fd7796f2..7018be54 100644
--- a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ModModel.cs
@@ -1,38 +1,9 @@
 namespace StardewModdingAPI.Web.Framework.Clients.CurseForge.ResponseModels
 {
-    /// <summary>An mod from the CurseForge API.</summary>
-    public class ModModel
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>The mod's unique ID on CurseForge.</summary>
-        public int ID { get; }
-
-        /// <summary>The mod name.</summary>
-        public string Name { get; }
-
-        /// <summary>The web URL for the mod page.</summary>
-        public string WebsiteUrl { get; }
-
-        /// <summary>The available file downloads.</summary>
-        public ModFileModel[] LatestFiles { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="id">The mod's unique ID on CurseForge.</param>
-        /// <param name="name">The mod name.</param>
-        /// <param name="websiteUrl">The web URL for the mod page.</param>
-        /// <param name="latestFiles">The available file downloads.</param>
-        public ModModel(int id, string name, string websiteUrl, ModFileModel[] latestFiles)
-        {
-            this.ID = id;
-            this.Name = name;
-            this.WebsiteUrl = websiteUrl;
-            this.LatestFiles = latestFiles;
-        }
-    }
+    /// <summary>A mod from the CurseForge API.</summary>
+    /// <param name="Id">The mod's unique ID on CurseForge.</param>
+    /// <param name="Name">The mod name.</param>
+    /// <param name="LatestFiles">The available file downloads.</param>
+    /// <param name="Links">The URLs for this mod.</param>
+    public record ModModel(int Id, string Name, ModFileModel[] LatestFiles, ModLinksModel Links);
 }
diff --git a/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ResponseModel.cs b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ResponseModel.cs
new file mode 100644
index 00000000..4d538a93
--- /dev/null
+++ b/src/SMAPI.Web/Framework/Clients/CurseForge/ResponseModels/ResponseModel.cs
@@ -0,0 +1,8 @@
+using Newtonsoft.Json;
+
+namespace StardewModdingAPI.Web.Framework.Clients.CurseForge.ResponseModels
+{
+    /// <summary>A response from the CurseForge API.</summary>
+    /// <param name="Data">The data returned by the API.</param>
+    public record ResponseModel<TData>(TData Data);
+}
diff --git a/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs b/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
index b582b2b0..ebb3618a 100644
--- a/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
+++ b/src/SMAPI.Web/Framework/ConfigModels/ApiClientsConfig.cs
@@ -42,6 +42,9 @@ namespace StardewModdingAPI.Web.Framework.ConfigModels
         /// <summary>The base URL for the CurseForge API.</summary>
         public string CurseForgeBaseUrl { get; set; } = null!;
 
+        /// <summary>The API authentication key for the CurseForge API.</summary>
+        public string CurseForgeApiKey { get; set; } = null!;
+
 
         /****
         ** GitHub
diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index 2693aa90..9980d00c 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -111,7 +111,8 @@ namespace StardewModdingAPI.Web
 
                 services.AddSingleton<ICurseForgeClient>(new CurseForgeClient(
                     userAgent: userAgent,
-                    apiUrl: api.CurseForgeBaseUrl
+                    apiUrl: api.CurseForgeBaseUrl,
+                    apiKey: api.CurseForgeApiKey
                 ));
 
                 services.AddSingleton<IGitHubClient>(new GitHubClient(
diff --git a/src/SMAPI.Web/appsettings.json b/src/SMAPI.Web/appsettings.json
index 1231f824..10fcbe9c 100644
--- a/src/SMAPI.Web/appsettings.json
+++ b/src/SMAPI.Web/appsettings.json
@@ -31,7 +31,8 @@
         "ChucklefishBaseUrl": "https://community.playstarbound.com",
         "ChucklefishModPageUrlFormat": "resources/{0}",
 
-        "CurseForgeBaseUrl": "https://addons-ecs.forgesvc.net/api/v2/",
+        "CurseForgeBaseUrl": "https://api.curseforge.com/v1/",
+        "CurseForgeApiKey": null,
 
         "GitHubBaseUrl": "https://api.github.com",
         "GitHubAcceptHeader": "application/vnd.github.v3+json",

From cb11f1e2ca907cf9d99d5ff76c40b2d0b2957ceb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 18 May 2022 20:02:12 -0400
Subject: [PATCH 640/856] re-add internal content manager for asset propagation

This will be used by the new asset propagation in SMAPI 4.0 & Stardew Valley 1.6.
---
 src/SMAPI/Framework/ContentCoordinator.cs | 17 ++++++++++++++++-
 src/SMAPI/Metadata/CoreAssetPropagator.cs |  8 +++++++-
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 2b13f57a..da8f0da9 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -151,8 +151,23 @@ namespace StardewModdingAPI.Framework
                     onAssetLoaded: onAssetLoaded
                 )
             );
+
+            var contentManagerForAssetPropagation = new GameContentManagerForAssetPropagation(
+                name: nameof(GameContentManagerForAssetPropagation),
+                serviceProvider: serviceProvider,
+                rootDirectory: rootDirectory,
+                currentCulture: currentCulture,
+                coordinator: this,
+                monitor: monitor,
+                reflection: reflection,
+                onDisposing: this.OnDisposing,
+                onLoadingFirstAsset: onLoadingFirstAsset,
+                onAssetLoaded: onAssetLoaded
+            );
+            this.ContentManagers.Add(contentManagerForAssetPropagation);
+
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
-            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, this.Monitor, reflection, name => this.ParseAssetName(name, allowLocales: true));
+            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, name => this.ParseAssetName(name, allowLocales: true));
             this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(customLanguages: Enumerable.Empty<ModLanguage>()));
         }
 
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index e014f9a9..6cb5a73a 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -5,6 +5,7 @@ using System.IO;
 using System.Linq;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Internal;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -32,6 +33,9 @@ namespace StardewModdingAPI.Metadata
         /// <summary>The main content manager through which to reload assets.</summary>
         private readonly LocalizedContentManager MainContentManager;
 
+        /// <summary>An internal content manager used only for asset propagation. See remarks on <see cref="GameContentManagerForAssetPropagation"/>.</summary>
+        private readonly GameContentManagerForAssetPropagation DisposableContentManager;
+
         /// <summary>Writes messages to the console.</summary>
         private readonly IMonitor Monitor;
 
@@ -60,12 +64,14 @@ namespace StardewModdingAPI.Metadata
         *********/
         /// <summary>Initialize the core asset data.</summary>
         /// <param name="mainContent">The main content manager through which to reload assets.</param>
+        /// <param name="disposableContent">An internal content manager used only for asset propagation.</param>
         /// <param name="monitor">Writes messages to the console.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="parseAssetName">Parse a raw asset name.</param>
-        public CoreAssetPropagator(LocalizedContentManager mainContent, IMonitor monitor, Reflector reflection, Func<string, IAssetName> parseAssetName)
+        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, IMonitor monitor, Reflector reflection, Func<string, IAssetName> parseAssetName)
         {
             this.MainContentManager = mainContent;
+            this.DisposableContentManager = disposableContent;
             this.Monitor = monitor;
             this.Reflection = reflection;
             this.ParseAssetName = parseAssetName;

From f8b62e271e5019fd02c4cbd0cdeb8a3b7938c620 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 18 May 2022 20:04:51 -0400
Subject: [PATCH 641/856] fix asset type when checking if a mod asset exists

---
 src/SMAPI/Framework/ContentManagers/GameContentManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 1c603f85..4390d472 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -75,7 +75,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // custom asset from a loader
             string locale = this.GetLocale();
             IAssetInfo info = new AssetInfo(locale, assetName, typeof(T), this.AssertAndNormalizeAssetName);
-            AssetOperationGroup? operations = this.Coordinator.GetAssetOperations<object>(info);
+            AssetOperationGroup? operations = this.Coordinator.GetAssetOperations<T>(info);
             if (operations?.LoadOperations.Count > 0)
             {
                 if (!this.AssertMaxOneRequiredLoader(info, operations.LoadOperations, out string? error))

From 1ddf70697eda8b721617c023cd827fa6ac0759c4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 18 May 2022 20:13:09 -0400
Subject: [PATCH 642/856] simplify asset propagation a bit to prepare for the
 upcoming SDV 1.6

---
 src/SMAPI/Framework/ContentCoordinator.cs     |  7 ++++-
 .../ContentManagers/BaseContentManager.cs     | 27 +++++++++----------
 .../ContentManagers/IContentManager.cs        | 11 +++++---
 3 files changed, 25 insertions(+), 20 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index da8f0da9..dd3d2917 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -394,9 +394,14 @@ namespace StardewModdingAPI.Framework
                 // cached assets
                 foreach (IContentManager contentManager in this.ContentManagers)
                 {
-                    foreach ((string key, object asset) in contentManager.InvalidateCache((key, type) => predicate(contentManager, key, type), dispose))
+                    foreach ((string key, object asset) in contentManager.GetCachedAssets())
                     {
+                        if (!predicate(contentManager, key, asset.GetType()))
+                            continue;
+
                         AssetName assetName = this.ParseAssetName(key, allowLocales: true);
+                        contentManager.InvalidateCache(assetName, dispose);
+
                         if (!invalidatedAssets.ContainsKey(assetName))
                             invalidatedAssets[assetName] = asset.GetType();
                     }
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 575d252e..ddc02a8c 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -231,24 +231,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
         ** Cache invalidation
         ****/
         /// <inheritdoc />
-        public IDictionary<string, object> InvalidateCache(Func<string, Type, bool> predicate, bool dispose = false)
+        public IEnumerable<KeyValuePair<string, object>> GetCachedAssets()
         {
-            IDictionary<string, object> removeAssets = new Dictionary<string, object>(StringComparer.OrdinalIgnoreCase);
-            this.Cache.Remove((key, asset) =>
-            {
-                string baseAssetName = this.Coordinator.ParseAssetName(key, allowLocales: this.TryLocalizeKeys).BaseName;
+            foreach (string key in this.Cache.Keys)
+                yield return new(key, this.Cache[key]);
+        }
 
-                // check if asset should be removed
-                bool remove = removeAssets.ContainsKey(baseAssetName);
-                if (!remove && predicate(baseAssetName, asset.GetType()))
-                {
-                    removeAssets[baseAssetName] = asset;
-                    remove = true;
-                }
-                return remove;
-            }, dispose);
+        /// <inheritdoc />
+        public bool InvalidateCache(IAssetName assetName, bool dispose = false)
+        {
+            if (!this.Cache.ContainsKey(assetName.Name))
+                return false;
 
-            return removeAssets;
+            // remove from cache
+            this.Cache.Remove(assetName.Name, dispose);
+            return true;
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/ContentManagers/IContentManager.cs b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
index ac67cad5..f2e3b9f0 100644
--- a/src/SMAPI/Framework/ContentManagers/IContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/IContentManager.cs
@@ -32,7 +32,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <typeparam name="T">The expected asset type.</typeparam>
         /// <param name="assetName">The normalized asset name.</param>
         bool DoesAssetExist<T>(IAssetName assetName)
-            where T: notnull;
+            where T : notnull;
 
         /// <summary>Load an asset through the content pipeline, using a localized variant of the <paramref name="assetName"/> if available.</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
@@ -65,10 +65,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="assetName">The asset path relative to the loader root directory, not including the <c>.xnb</c> extension.</param>
         bool IsLoaded(IAssetName assetName);
 
+        /// <summary>Get all assets in the cache.</summary>
+        IEnumerable<KeyValuePair<string, object>> GetCachedAssets();
+
         /// <summary>Purge matched assets from the cache.</summary>
-        /// <param name="predicate">Matches the asset keys to invalidate.</param>
+        /// <param name="assetName">The asset name to dispose.</param>
         /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
-        /// <returns>Returns the invalidated asset names and instances.</returns>
-        IDictionary<string, object> InvalidateCache(Func<string, Type, bool> predicate, bool dispose = false);
+        /// <returns>Returns whether the asset was in the cache.</returns>
+        bool InvalidateCache(IAssetName assetName, bool dispose = false);
     }
 }

From 0a050622f6d2b535bed3ddf28de9ef861469b759 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 19 May 2022 21:04:32 -0400
Subject: [PATCH 643/856] tweak asset propagator to avoid assumption that
 assets must be reloaded

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 396 ++++++++++------------
 1 file changed, 188 insertions(+), 208 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 6cb5a73a..dabd802d 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -110,12 +110,12 @@ namespace StardewModdingAPI.Metadata
                 {
                     case AssetBucket.Sprite:
                         if (!ignoreWorld)
-                            this.ReloadNpcSprites(propagatedAssets);
+                            this.UpdateNpcSprites(propagatedAssets);
                         break;
 
                     case AssetBucket.Portrait:
                         if (!ignoreWorld)
-                            this.ReloadNpcPortraits(propagatedAssets);
+                            this.UpdateNpcPortraits(propagatedAssets);
                         break;
 
                     default:
@@ -198,7 +198,7 @@ namespace StardewModdingAPI.Metadata
                             }
 
                             var oldWarps = GetWarpSet(location);
-                            this.ReloadMap(info);
+                            this.UpdateMap(info);
                             var newWarps = GetWarpSet(location);
 
                             changedWarps = changedWarps || oldWarps.Count != newWarps.Count || oldWarps.Any(p => !newWarps.Contains(p));
@@ -219,7 +219,7 @@ namespace StardewModdingAPI.Metadata
                 ** Animals
                 ****/
                 case "animals/horse":
-                    return !ignoreWorld && this.ReloadPetOrHorseSprites<Horse>(content, assetName);
+                    return !ignoreWorld && this.UpdatePetOrHorseSprites<Horse>(content, assetName);
 
                 /****
                 ** Buildings
@@ -249,7 +249,7 @@ namespace StardewModdingAPI.Metadata
                 case "characters/farmer/farmer_base_bald":
                 case "characters/farmer/farmer_girl_base":
                 case "characters/farmer/farmer_girl_base_bald":
-                    return !ignoreWorld && this.ReloadPlayerSprites(assetName);
+                    return !ignoreWorld && this.UpdatePlayerSprites(assetName);
 
                 case "characters/farmer/hairstyles": // Game1.LoadContent
                     FarmerRenderer.hairStylesTexture = this.LoadTexture(key);
@@ -301,10 +301,10 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "data/farmanimals": // FarmAnimal constructor
-                    return !ignoreWorld && this.ReloadFarmAnimalData();
+                    return !ignoreWorld && this.UpdateFarmAnimalData();
 
                 case "data/hairdata": // Farmer.GetHairStyleMetadataFile
-                    return this.ReloadHairData();
+                    return this.UpdateHairData();
 
                 case "data/movies": // MovieTheater.GetMovieData
                 case "data/moviesreactions": // MovieTheater.GetMovieReactions
@@ -312,7 +312,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "data/npcdispositions": // NPC constructor
-                    return !ignoreWorld && this.ReloadNpcDispositions(content, assetName);
+                    return !ignoreWorld && this.UpdateNpcDispositions(content, assetName);
 
                 case "data/npcgifttastes": // Game1.LoadContent
                     Game1.NPCGiftTastes = content.Load<Dictionary<string, string>>(key);
@@ -392,7 +392,7 @@ namespace StardewModdingAPI.Metadata
                     }
 
                     if (!ignoreWorld)
-                        this.ReloadDoorSprites(content, assetName);
+                        this.UpdateDoorSprites(content, assetName);
                     return true;
 
                 case "loosesprites/cursors2": // Game1.LoadContent
@@ -424,7 +424,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "loosesprites/suspensionbridge": // SuspensionBridge constructor
-                    return !ignoreWorld && this.ReloadSuspensionBridges(content, assetName);
+                    return !ignoreWorld && this.UpdateSuspensionBridges(content, assetName);
 
                 /****
                 ** Content\Maps
@@ -455,13 +455,13 @@ namespace StardewModdingAPI.Metadata
                     return false;
 
                 case "minigames/titlebuttons": // TitleMenu
-                    return this.ReloadTitleButtons(content, assetName);
+                    return this.UpdateTitleButtons(content, assetName);
 
                 /****
                 ** Content\Strings
                 ****/
                 case "strings/stringsfromcsfiles":
-                    return this.ReloadStringsFromCsFiles(content);
+                    return this.UpdateStringsFromCsFiles(content);
 
                 /****
                 ** Content\TileSheets
@@ -479,14 +479,14 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "tilesheets/chairtiles": // Game1.LoadContent
-                    return this.ReloadChairTiles(content, assetName, ignoreWorld);
+                    return this.UpdateChairTiles(content, assetName, ignoreWorld);
 
                 case "tilesheets/craftables": // Game1.LoadContent
                     Game1.bigCraftableSpriteSheet = content.Load<Texture2D>(key);
                     return true;
 
                 case "tilesheets/critters": // Critter constructor
-                    return !ignoreWorld && this.ReloadCritterTextures(content, assetName) > 0;
+                    return !ignoreWorld && this.UpdateCritterTextures(content, assetName);
 
                 case "tilesheets/crops": // Game1.LoadContent
                     Game1.cropSpriteSheet = content.Load<Texture2D>(key);
@@ -540,7 +540,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures/grass": // from Grass
-                    return !ignoreWorld && this.ReloadGrassTextures(content, assetName);
+                    return !ignoreWorld && this.UpdateGrassTextures(content, assetName);
 
                 case "terrainfeatures/hoedirt": // from HoeDirt
                     HoeDirt.lightTexture = content.Load<Texture2D>(key);
@@ -555,27 +555,27 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures/mushroom_tree": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.mushroomTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.mushroomTree);
 
                 case "terrainfeatures/tree_palm": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.palmTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.palmTree);
 
                 case "terrainfeatures/tree1_fall": // from Tree
                 case "terrainfeatures/tree1_spring": // from Tree
                 case "terrainfeatures/tree1_summer": // from Tree
                 case "terrainfeatures/tree1_winter": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.bushyTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.bushyTree);
 
                 case "terrainfeatures/tree2_fall": // from Tree
                 case "terrainfeatures/tree2_spring": // from Tree
                 case "terrainfeatures/tree2_summer": // from Tree
                 case "terrainfeatures/tree2_winter": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.leafyTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.leafyTree);
 
                 case "terrainfeatures/tree3_fall": // from Tree
                 case "terrainfeatures/tree3_spring": // from Tree
                 case "terrainfeatures/tree3_winter": // from Tree
-                    return !ignoreWorld && this.ReloadTreeTextures(content, assetName, Tree.pineTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.pineTree);
             }
 
             /****
@@ -585,24 +585,24 @@ namespace StardewModdingAPI.Metadata
             {
                 // dynamic textures
                 if (assetName.StartsWith("animals/cat"))
-                    return this.ReloadPetOrHorseSprites<Cat>(content, assetName);
+                    return this.UpdatePetOrHorseSprites<Cat>(content, assetName);
                 if (assetName.StartsWith("animals/dog"))
-                    return this.ReloadPetOrHorseSprites<Dog>(content, assetName);
+                    return this.UpdatePetOrHorseSprites<Dog>(content, assetName);
                 if (assetName.IsDirectlyUnderPath("Animals"))
-                    return this.ReloadFarmAnimalSprites(content, assetName);
+                    return this.UpdateFarmAnimalSprites(content, assetName);
 
                 if (assetName.IsDirectlyUnderPath("Buildings"))
-                    return this.ReloadBuildings(assetName);
+                    return this.UpdateBuildings(assetName);
 
                 if (assetName.StartsWith("LooseSprites/Fence"))
-                    return this.ReloadFenceTextures(assetName);
+                    return this.UpdateFenceTextures(assetName);
 
                 // dynamic data
                 if (assetName.IsDirectlyUnderPath("Characters/Dialogue"))
-                    return this.ReloadNpcDialogue(assetName);
+                    return this.UpdateNpcDialogue(assetName);
 
                 if (assetName.IsDirectlyUnderPath("Characters/schedules"))
-                    return this.ReloadNpcSchedules(assetName);
+                    return this.UpdateNpcSchedules(assetName);
             }
 
             return false;
@@ -613,14 +613,14 @@ namespace StardewModdingAPI.Metadata
         ** Private methods
         *********/
         /****
-        ** Reload texture methods
+        ** Update texture methods
         ****/
-        /// <summary>Reload buttons on the title screen.</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
+        /// <summary>Update buttons on the title screen.</summary>
+        /// <param name="content">The content manager through which to update the asset.</param>
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
         /// <remarks>Derived from the <see cref="TitleMenu"/> constructor and <see cref="TitleMenu.setUpIcons"/>.</remarks>
-        private bool ReloadTitleButtons(LocalizedContentManager content, IAssetName assetName)
+        private bool UpdateTitleButtons(LocalizedContentManager content, IAssetName assetName)
         {
             if (Game1.activeClickableMenu is TitleMenu titleMenu)
             {
@@ -641,12 +641,12 @@ namespace StardewModdingAPI.Metadata
             return false;
         }
 
-        /// <summary>Reload the sprites for matching pets or horses.</summary>
+        /// <summary>Update the sprites for matching pets or horses.</summary>
         /// <typeparam name="TAnimal">The animal type.</typeparam>
-        /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadPetOrHorseSprites<TAnimal>(LocalizedContentManager content, IAssetName assetName)
+        /// <param name="content">The content manager through which to update the asset.</param>
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
+        private bool UpdatePetOrHorseSprites<TAnimal>(LocalizedContentManager content, IAssetName assetName)
             where TAnimal : NPC
         {
             // find matches
@@ -664,12 +664,12 @@ namespace StardewModdingAPI.Metadata
             return true;
         }
 
-        /// <summary>Reload the sprites for matching farm animals.</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
+        /// <summary>Update the sprites for matching farm animals.</summary>
+        /// <param name="content">The content manager through which to update the asset.</param>
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
         /// <remarks>Derived from <see cref="FarmAnimal.reload"/>.</remarks>
-        private bool ReloadFarmAnimalSprites(LocalizedContentManager content, IAssetName assetName)
+        private bool UpdateFarmAnimalSprites(LocalizedContentManager content, IAssetName assetName)
         {
             // find matches
             FarmAnimal[] animals = this.GetFarmAnimals().ToArray();
@@ -695,10 +695,10 @@ namespace StardewModdingAPI.Metadata
             return texture.IsValueCreated;
         }
 
-        /// <summary>Reload building textures.</summary>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadBuildings(IAssetName assetName)
+        /// <summary>Update building textures.</summary>
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
+        private bool UpdateBuildings(IAssetName assetName)
         {
             // get paint mask info
             const string paintMaskSuffix = "_PaintMask";
@@ -731,12 +731,12 @@ namespace StardewModdingAPI.Metadata
             return removedFromCache;
         }
 
-        /// <summary>Reload map seat textures.</summary>
+        /// <summary>Update map seat textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
+        /// <param name="assetName">The asset name to update.</param>
         /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadChairTiles(LocalizedContentManager content, IAssetName assetName, bool ignoreWorld)
+        /// <returns>Returns whether any references were updated.</returns>
+        private bool UpdateChairTiles(LocalizedContentManager content, IAssetName assetName, bool ignoreWorld)
         {
             MapSeat.mapChairTexture = content.Load<Texture2D>(assetName.BaseName);
 
@@ -755,11 +755,11 @@ namespace StardewModdingAPI.Metadata
             return true;
         }
 
-        /// <summary>Reload critter textures.</summary>
+        /// <summary>Update critter textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns the number of reloaded assets.</returns>
-        private int ReloadCritterTextures(LocalizedContentManager content, IAssetName assetName)
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
+        private bool UpdateCritterTextures(LocalizedContentManager content, IAssetName assetName)
         {
             // get critters
             Critter[] critters =
@@ -772,21 +772,21 @@ namespace StardewModdingAPI.Metadata
                 )
                 .ToArray();
             if (!critters.Any())
-                return 0;
+                return false;
 
             // update sprites
             Texture2D texture = content.Load<Texture2D>(assetName.BaseName);
             foreach (Critter entry in critters)
                 entry.sprite.spriteTexture = texture;
 
-            return critters.Length;
+            return true;
         }
 
-        /// <summary>Reload the sprites for interior doors.</summary>
+        /// <summary>Update the sprites for interior doors.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any doors were affected.</returns>
-        private bool ReloadDoorSprites(LocalizedContentManager content, IAssetName assetName)
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
+        private void UpdateDoorSprites(LocalizedContentManager content, IAssetName assetName)
         {
             Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
 
@@ -806,29 +806,12 @@ namespace StardewModdingAPI.Metadata
                         door.Sprite.texture = texture.Value;
                 }
             }
-
-            return texture.IsValueCreated;
         }
 
-        /// <summary>Reload the data for matching farm animals.</summary>
-        /// <returns>Returns whether any farm animals were affected.</returns>
-        /// <remarks>Derived from the <see cref="FarmAnimal"/> constructor.</remarks>
-        private bool ReloadFarmAnimalData()
-        {
-            bool changed = false;
-            foreach (FarmAnimal animal in this.GetFarmAnimals())
-            {
-                animal.reloadData();
-                changed = true;
-            }
-
-            return changed;
-        }
-
-        /// <summary>Reload the sprites for a fence type.</summary>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadFenceTextures(IAssetName assetName)
+        /// <summary>Update the sprites for a fence type.</summary>
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
+        private bool UpdateFenceTextures(IAssetName assetName)
         {
             // get fence type (e.g. LooseSprites/Fence3 => 3)
             if (!int.TryParse(this.GetSegments(assetName.BaseName)[1].Substring("Fence".Length), out int fenceType))
@@ -852,11 +835,11 @@ namespace StardewModdingAPI.Metadata
             return true;
         }
 
-        /// <summary>Reload tree textures.</summary>
+        /// <summary>Update tree textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadGrassTextures(LocalizedContentManager content, IAssetName assetName)
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
+        private bool UpdateGrassTextures(LocalizedContentManager content, IAssetName assetName)
         {
             Grass[] grasses =
                 (
@@ -878,77 +861,9 @@ namespace StardewModdingAPI.Metadata
             return false;
         }
 
-        /// <summary>Reload hair style metadata.</summary>
-        /// <returns>Returns whether any assets were reloaded.</returns>
-        /// <remarks>Derived from the <see cref="Farmer.GetHairStyleMetadataFile"/> and <see cref="Farmer.GetHairStyleMetadata"/>.</remarks>
-        private bool ReloadHairData()
-        {
-            if (Farmer.hairStyleMetadataFile == null)
-                return false;
-
-            Farmer.hairStyleMetadataFile = null;
-            Farmer.allHairStyleIndices = null;
-            Farmer.hairStyleMetadata.Clear();
-
-            return true;
-        }
-
-        /// <summary>Reload the map for a location.</summary>
-        /// <param name="locationInfo">The location whose map to reload.</param>
-        private void ReloadMap(LocationInfo locationInfo)
-        {
-            GameLocation location = locationInfo.Location;
-            Vector2? playerPos = Game1.player?.Position;
-
-            // reload map
-            location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist
-            location.reloadMap();
-
-            // reload interior doors
-            location.interiorDoors.Clear();
-            location.interiorDoors.ResetSharedState(); // load doors from map properties
-            location.interiorDoors.ResetLocalState(); // reapply door tiles
-
-            // reapply map changes (after reloading doors so they apply theirs too)
-            location.MakeMapModifications(force: true);
-
-            // update for changes
-            location.updateWarps();
-            location.updateDoors();
-            locationInfo.ParentBuilding?.updateInteriorWarps();
-
-            // reset player position
-            // The game may move the player as part of the map changes, even if they're not in that
-            // location. That's not needed in this case, and it can have weird effects like players
-            // warping onto the wrong tile (or even off-screen) if a patch changes the farmhouse
-            // map on location change.
-            if (playerPos.HasValue)
-                Game1.player!.Position = playerPos.Value;
-        }
-
-        /// <summary>Reload the disposition data for matching NPCs.</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any NPCs were affected.</returns>
-        private bool ReloadNpcDispositions(LocalizedContentManager content, IAssetName assetName)
-        {
-            IDictionary<string, string> data = content.Load<Dictionary<string, string>>(assetName.BaseName);
-            bool changed = false;
-            foreach (NPC npc in this.GetCharacters())
-            {
-                if (npc.isVillager() && data.ContainsKey(npc.Name))
-                {
-                    npc.reloadData();
-                    changed = true;
-                }
-            }
-
-            return changed;
-        }
-
-        /// <summary>Reload the sprites for matching NPCs.</summary>
-        /// <param name="propagated">The asset keys which are being propagated.</param>
-        private void ReloadNpcSprites(IDictionary<IAssetName, bool> propagated)
+        /// <summary>Update the sprites for matching NPCs.</summary>
+        /// <param name="propagated">The asset names being propagated.</param>
+        private void UpdateNpcSprites(IDictionary<IAssetName, bool> propagated)
         {
             // get NPCs
             var characters =
@@ -970,9 +885,9 @@ namespace StardewModdingAPI.Metadata
             }
         }
 
-        /// <summary>Reload the portraits for matching NPCs.</summary>
-        /// <param name="propagated">The asset keys which are being propagated.</param>
-        private void ReloadNpcPortraits(IDictionary<IAssetName, bool> propagated)
+        /// <summary>Update the portraits for matching NPCs.</summary>
+        /// <param name="propagated">The asset names being propagated.</param>
+        private void UpdateNpcPortraits(IDictionary<IAssetName, bool> propagated)
         {
             // get NPCs
             var characters =
@@ -1009,9 +924,9 @@ namespace StardewModdingAPI.Metadata
             }
         }
 
-        /// <summary>Reload the sprites for matching players.</summary>
-        /// <param name="assetName">The asset name to reload.</param>
-        private bool ReloadPlayerSprites(IAssetName assetName)
+        /// <summary>Update the sprites for matching players.</summary>
+        /// <param name="assetName">The asset name to update.</param>
+        private bool UpdatePlayerSprites(IAssetName assetName)
         {
             Farmer[] players =
                 (
@@ -1032,11 +947,11 @@ namespace StardewModdingAPI.Metadata
             return players.Any();
         }
 
-        /// <summary>Reload suspension bridge textures.</summary>
+        /// <summary>Update suspension bridge textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadSuspensionBridges(LocalizedContentManager content, IAssetName assetName)
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
+        private bool UpdateSuspensionBridges(LocalizedContentManager content, IAssetName assetName)
         {
             Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
 
@@ -1060,12 +975,12 @@ namespace StardewModdingAPI.Metadata
             return texture.IsValueCreated;
         }
 
-        /// <summary>Reload tree textures.</summary>
+        /// <summary>Update tree textures.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <param name="type">The type to reload.</param>
-        /// <returns>Returns whether any textures were reloaded.</returns>
-        private bool ReloadTreeTextures(LocalizedContentManager content, IAssetName assetName, int type)
+        /// <param name="assetName">The asset name to update.</param>
+        /// <param name="type">The type to update.</param>
+        /// <returns>Returns whether any references were updated.</returns>
+        private bool UpdateTreeTextures(LocalizedContentManager content, IAssetName assetName, int type)
         {
             Tree[] trees = this.GetLocations()
                 .SelectMany(p => p.terrainFeatures.Values.OfType<Tree>())
@@ -1084,12 +999,42 @@ namespace StardewModdingAPI.Metadata
         }
 
         /****
-        ** Reload data methods
+        ** Update data methods
         ****/
-        /// <summary>Reload the dialogue data for matching NPCs.</summary>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any assets were reloaded.</returns>
-        private bool ReloadNpcDialogue(IAssetName assetName)
+        /// <summary>Update the data for matching farm animals.</summary>
+        /// <returns>Returns whether any farm animals were updated.</returns>
+        /// <remarks>Derived from the <see cref="FarmAnimal"/> constructor.</remarks>
+        private bool UpdateFarmAnimalData()
+        {
+            bool changed = false;
+            foreach (FarmAnimal animal in this.GetFarmAnimals())
+            {
+                animal.reloadData();
+                changed = true;
+            }
+
+            return changed;
+        }
+
+        /// <summary>Update hair style metadata.</summary>
+        /// <returns>Returns whether any data was updated.</returns>
+        /// <remarks>Derived from the <see cref="Farmer.GetHairStyleMetadataFile"/> and <see cref="Farmer.GetHairStyleMetadata"/>.</remarks>
+        private bool UpdateHairData()
+        {
+            if (Farmer.hairStyleMetadataFile == null)
+                return false;
+
+            Farmer.hairStyleMetadataFile = null;
+            Farmer.allHairStyleIndices = null;
+            Farmer.hairStyleMetadata.Clear();
+
+            return true;
+        }
+
+        /// <summary>Update the dialogue data for matching NPCs.</summary>
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any NPCs were updated.</returns>
+        private bool UpdateNpcDialogue(IAssetName assetName)
         {
             // get NPCs
             string name = Path.GetFileName(assetName.BaseName);
@@ -1116,10 +1061,30 @@ namespace StardewModdingAPI.Metadata
             return true;
         }
 
-        /// <summary>Reload the schedules for matching NPCs.</summary>
-        /// <param name="assetName">The asset name to reload.</param>
-        /// <returns>Returns whether any assets were reloaded.</returns>
-        private bool ReloadNpcSchedules(IAssetName assetName)
+        /// <summary>Update the disposition data for matching NPCs.</summary>
+        /// <param name="content">The content manager through which to reload the asset.</param>
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any NPCs were updated.</returns>
+        private bool UpdateNpcDispositions(LocalizedContentManager content, IAssetName assetName)
+        {
+            IDictionary<string, string> data = content.Load<Dictionary<string, string>>(assetName.BaseName);
+            bool changed = false;
+            foreach (NPC npc in this.GetCharacters())
+            {
+                if (npc.isVillager() && data.ContainsKey(npc.Name))
+                {
+                    npc.reloadData();
+                    changed = true;
+                }
+            }
+
+            return changed;
+        }
+
+        /// <summary>Update the schedules for matching NPCs.</summary>
+        /// <param name="assetName">The asset name to update.</param>
+        /// <returns>Returns whether any NPCs were updated.</returns>
+        private bool UpdateNpcSchedules(IAssetName assetName)
         {
             // get NPCs
             string name = Path.GetFileName(assetName.BaseName);
@@ -1150,11 +1115,11 @@ namespace StardewModdingAPI.Metadata
             return true;
         }
 
-        /// <summary>Reload cached translations from the <c>Strings\StringsFromCSFiles</c> asset.</summary>
+        /// <summary>Update cached translations from the <c>Strings\StringsFromCSFiles</c> asset.</summary>
         /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <returns>Returns whether any data was reloaded.</returns>
+        /// <returns>Returns whether any data was updated.</returns>
         /// <remarks>Derived from the <see cref="Game1.TranslateFields"/>.</remarks>
-        private bool ReloadStringsFromCsFiles(LocalizedContentManager content)
+        private bool UpdateStringsFromCsFiles(LocalizedContentManager content)
         {
             Game1.samBandName = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.2156");
             Game1.elliottBookName = content.LoadString("Strings/StringsFromCSFiles:Game1.cs.2157");
@@ -1171,6 +1136,42 @@ namespace StardewModdingAPI.Metadata
             return true;
         }
 
+        /****
+        ** Update map methods
+        ****/
+        /// <summary>Update the map for a location.</summary>
+        /// <param name="locationInfo">The location whose map to update.</param>
+        private void UpdateMap(LocationInfo locationInfo)
+        {
+            GameLocation location = locationInfo.Location;
+            Vector2? playerPos = Game1.player?.Position;
+
+            // reload map
+            location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist
+            location.reloadMap();
+
+            // reload interior doors
+            location.interiorDoors.Clear();
+            location.interiorDoors.ResetSharedState(); // load doors from map properties
+            location.interiorDoors.ResetLocalState(); // reapply door tiles
+
+            // reapply map changes (after reloading doors so they apply theirs too)
+            location.MakeMapModifications(force: true);
+
+            // update for changes
+            location.updateWarps();
+            location.updateDoors();
+            locationInfo.ParentBuilding?.updateInteriorWarps();
+
+            // reset player position
+            // The game may move the player as part of the map changes, even if they're not in that
+            // location. That's not needed in this case, and it can have weird effects like players
+            // warping onto the wrong tile (or even off-screen) if a patch changes the farmhouse
+            // map on location change.
+            if (playerPos.HasValue)
+                Game1.player!.Position = playerPos.Value;
+        }
+
         /****
         ** Helpers
         ****/
@@ -1299,29 +1300,8 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Metadata about a location used in asset propagation.</summary>
-        private readonly struct LocationInfo
-        {
-            /*********
-            ** Accessors
-            *********/
-            /// <summary>The location instance.</summary>
-            public GameLocation Location { get; }
-
-            /// <summary>The building which contains the location, if any.</summary>
-            public Building? ParentBuilding { get; }
-
-
-            /*********
-            ** Public methods
-            *********/
-            /// <summary>Construct an instance.</summary>
-            /// <param name="location">The location instance.</param>
-            /// <param name="parentBuilding">The building which contains the location, if any.</param>
-            public LocationInfo(GameLocation location, Building? parentBuilding)
-            {
-                this.Location = location;
-                this.ParentBuilding = parentBuilding;
-            }
-        }
+        /// <param name="Location">The location instance.</param>
+        /// <param name="ParentBuilding">The building which contains the location, if any.</param>
+        private record LocationInfo(GameLocation Location, Building? ParentBuilding);
     }
 }

From 7332879351f396572abd1785abf5d7807ef97ca4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 19 May 2022 21:04:32 -0400
Subject: [PATCH 644/856] defer asset reload during propagation when possible

---
 docs/release-notes.md                     |   1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 128 ++++++++++++----------
 2 files changed, 70 insertions(+), 59 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1f394849..8dc53e19 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 # Release notes
 ## Upcoming release
 * For players:
+  * Improved performance when mods change some asset types (including NPC portraits/sprites).
   * Fixed CurseForge update checks for the new CurseForge API.
 
 ## 3.14.4
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index dabd802d..ce9ba7a8 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -219,7 +219,7 @@ namespace StardewModdingAPI.Metadata
                 ** Animals
                 ****/
                 case "animals/horse":
-                    return !ignoreWorld && this.UpdatePetOrHorseSprites<Horse>(content, assetName);
+                    return !ignoreWorld && this.UpdatePetOrHorseSprites<Horse>(assetName);
 
                 /****
                 ** Buildings
@@ -486,7 +486,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "tilesheets/critters": // Critter constructor
-                    return !ignoreWorld && this.UpdateCritterTextures(content, assetName);
+                    return !ignoreWorld && this.UpdateCritterTextures(assetName);
 
                 case "tilesheets/crops": // Game1.LoadContent
                     Game1.cropSpriteSheet = content.Load<Texture2D>(key);
@@ -555,27 +555,27 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures/mushroom_tree": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.mushroomTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(Tree.mushroomTree);
 
                 case "terrainfeatures/tree_palm": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.palmTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(Tree.palmTree);
 
                 case "terrainfeatures/tree1_fall": // from Tree
                 case "terrainfeatures/tree1_spring": // from Tree
                 case "terrainfeatures/tree1_summer": // from Tree
                 case "terrainfeatures/tree1_winter": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.bushyTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(Tree.bushyTree);
 
                 case "terrainfeatures/tree2_fall": // from Tree
                 case "terrainfeatures/tree2_spring": // from Tree
                 case "terrainfeatures/tree2_summer": // from Tree
                 case "terrainfeatures/tree2_winter": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.leafyTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(Tree.leafyTree);
 
                 case "terrainfeatures/tree3_fall": // from Tree
                 case "terrainfeatures/tree3_spring": // from Tree
                 case "terrainfeatures/tree3_winter": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(content, assetName, Tree.pineTree);
+                    return !ignoreWorld && this.UpdateTreeTextures(Tree.pineTree);
             }
 
             /****
@@ -585,11 +585,11 @@ namespace StardewModdingAPI.Metadata
             {
                 // dynamic textures
                 if (assetName.StartsWith("animals/cat"))
-                    return this.UpdatePetOrHorseSprites<Cat>(content, assetName);
+                    return this.UpdatePetOrHorseSprites<Cat>(assetName);
                 if (assetName.StartsWith("animals/dog"))
-                    return this.UpdatePetOrHorseSprites<Dog>(content, assetName);
+                    return this.UpdatePetOrHorseSprites<Dog>(assetName);
                 if (assetName.IsDirectlyUnderPath("Animals"))
-                    return this.UpdateFarmAnimalSprites(content, assetName);
+                    return this.UpdateFarmAnimalSprites(assetName);
 
                 if (assetName.IsDirectlyUnderPath("Buildings"))
                     return this.UpdateBuildings(assetName);
@@ -643,33 +643,29 @@ namespace StardewModdingAPI.Metadata
 
         /// <summary>Update the sprites for matching pets or horses.</summary>
         /// <typeparam name="TAnimal">The animal type.</typeparam>
-        /// <param name="content">The content manager through which to update the asset.</param>
         /// <param name="assetName">The asset name to update.</param>
         /// <returns>Returns whether any references were updated.</returns>
-        private bool UpdatePetOrHorseSprites<TAnimal>(LocalizedContentManager content, IAssetName assetName)
+        private bool UpdatePetOrHorseSprites<TAnimal>(IAssetName assetName)
             where TAnimal : NPC
         {
             // find matches
             TAnimal[] animals = this.GetCharacters()
                 .OfType<TAnimal>()
-                .Where(p => this.IsSameBaseName(assetName, p.Sprite?.Texture?.Name))
+                .Where(p => this.IsSameBaseName(assetName, p.Sprite?.spriteTexture?.Name))
                 .ToArray();
-            if (!animals.Any())
-                return false;
 
             // update sprites
-            Texture2D texture = content.Load<Texture2D>(assetName.BaseName);
+            bool changed = false;
             foreach (TAnimal animal in animals)
-                animal.Sprite.spriteTexture = texture;
-            return true;
+                changed |= this.MarkSpriteDirty(animal.Sprite);
+            return changed;
         }
 
         /// <summary>Update the sprites for matching farm animals.</summary>
-        /// <param name="content">The content manager through which to update the asset.</param>
         /// <param name="assetName">The asset name to update.</param>
         /// <returns>Returns whether any references were updated.</returns>
         /// <remarks>Derived from <see cref="FarmAnimal.reload"/>.</remarks>
-        private bool UpdateFarmAnimalSprites(LocalizedContentManager content, IAssetName assetName)
+        private bool UpdateFarmAnimalSprites(IAssetName assetName)
         {
             // find matches
             FarmAnimal[] animals = this.GetFarmAnimals().ToArray();
@@ -677,7 +673,7 @@ namespace StardewModdingAPI.Metadata
                 return false;
 
             // update sprites
-            Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
+            bool changed = true;
             foreach (FarmAnimal animal in animals)
             {
                 // get expected key
@@ -690,9 +686,9 @@ namespace StardewModdingAPI.Metadata
 
                 // reload asset
                 if (this.IsSameBaseName(assetName, expectedKey))
-                    animal.Sprite.spriteTexture = texture.Value;
+                    changed |= this.MarkSpriteDirty(animal.Sprite);
             }
-            return texture.IsValueCreated;
+            return changed;
         }
 
         /// <summary>Update building textures.</summary>
@@ -707,7 +703,7 @@ namespace StardewModdingAPI.Metadata
             // get building type
             string type = Path.GetFileName(assetName.BaseName);
             if (isPaintMask)
-                type = type.Substring(0, type.Length - paintMaskSuffix.Length);
+                type = type[..^paintMaskSuffix.Length];
 
             // get buildings
             Building[] buildings = this.GetLocations(buildingInteriors: false)
@@ -747,7 +743,7 @@ namespace StardewModdingAPI.Metadata
                     foreach (MapSeat seat in location.mapSeats.Where(p => p != null))
                     {
                         if (this.IsSameBaseName(assetName, seat._loadedTextureFile))
-                            seat.overlayTexture = MapSeat.mapChairTexture;
+                            seat._loadedTextureFile = null;
                     }
                 }
             }
@@ -756,10 +752,9 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Update critter textures.</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
         /// <param name="assetName">The asset name to update.</param>
         /// <returns>Returns whether any references were updated.</returns>
-        private bool UpdateCritterTextures(LocalizedContentManager content, IAssetName assetName)
+        private bool UpdateCritterTextures(IAssetName assetName)
         {
             // get critters
             Critter[] critters =
@@ -767,19 +762,16 @@ namespace StardewModdingAPI.Metadata
                     from location in this.GetLocations()
                     where location.critters != null
                     from Critter critter in location.critters
-                    where this.IsSameBaseName(assetName, critter.sprite?.Texture?.Name)
+                    where this.IsSameBaseName(assetName, critter.sprite?.spriteTexture?.Name)
                     select critter
                 )
                 .ToArray();
-            if (!critters.Any())
-                return false;
 
             // update sprites
-            Texture2D texture = content.Load<Texture2D>(assetName.BaseName);
+            bool changed = false;
             foreach (Critter entry in critters)
-                entry.sprite.spriteTexture = texture;
-
-            return true;
+                changed |= this.MarkSpriteDirty(entry.sprite);
+            return changed;
         }
 
         /// <summary>Update the sprites for interior doors.</summary>
@@ -814,7 +806,7 @@ namespace StardewModdingAPI.Metadata
         private bool UpdateFenceTextures(IAssetName assetName)
         {
             // get fence type (e.g. LooseSprites/Fence3 => 3)
-            if (!int.TryParse(this.GetSegments(assetName.BaseName)[1].Substring("Fence".Length), out int fenceType))
+            if (!int.TryParse(this.GetSegments(assetName.BaseName)[1]["Fence".Length..], out int fenceType))
                 return false;
 
             // get fences
@@ -830,9 +822,16 @@ namespace StardewModdingAPI.Metadata
                 .ToArray();
 
             // update fence textures
+            bool changed = false;
             foreach (Fence fence in fences)
-                fence.fenceTexture = new Lazy<Texture2D>(fence.loadFenceTexture);
-            return true;
+            {
+                if (fence.fenceTexture.IsValueCreated)
+                {
+                    fence.fenceTexture = new Lazy<Texture2D>(fence.loadFenceTexture);
+                    changed = true;
+                }
+            }
+            return changed;
         }
 
         /// <summary>Update tree textures.</summary>
@@ -850,15 +849,16 @@ namespace StardewModdingAPI.Metadata
                 )
                 .ToArray();
 
-            if (grasses.Any())
+            bool changed = false;
+            foreach (Grass grass in grasses)
             {
-                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
-                foreach (Grass grass in grasses)
-                    grass.texture = texture;
-                return true;
+                if (grass.texture.IsValueCreated)
+                {
+                    grass.texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
+                    changed = true;
+                }
             }
-
-            return false;
+            return changed;
         }
 
         /// <summary>Update the sprites for matching NPCs.</summary>
@@ -869,19 +869,17 @@ namespace StardewModdingAPI.Metadata
             var characters =
                 (
                     from npc in this.GetCharacters()
-                    let key = this.ParseAssetNameOrNull(npc.Sprite?.Texture?.Name)?.GetBaseAssetName()
+                    let key = this.ParseAssetNameOrNull(npc.Sprite?.spriteTexture?.Name)?.GetBaseAssetName()
                     where key != null && propagated.ContainsKey(key)
                     select new { Npc = npc, AssetName = key }
                 )
                 .ToArray();
-            if (!characters.Any())
-                return;
 
             // update sprite
             foreach (var target in characters)
             {
-                target.Npc.Sprite.spriteTexture = this.LoadTexture(target.AssetName.BaseName);
-                propagated[target.AssetName] = true;
+                if (this.MarkSpriteDirty(target.Npc.Sprite))
+                    propagated[target.AssetName] = true;
             }
         }
 
@@ -919,7 +917,7 @@ namespace StardewModdingAPI.Metadata
             // update portrait
             foreach (var target in characters)
             {
-                target.Npc.Portrait = this.LoadTexture(target.AssetName.BaseName);
+                target.Npc.resetPortrait();
                 propagated[target.AssetName] = true;
             }
         }
@@ -976,26 +974,38 @@ namespace StardewModdingAPI.Metadata
         }
 
         /// <summary>Update tree textures.</summary>
-        /// <param name="content">The content manager through which to reload the asset.</param>
-        /// <param name="assetName">The asset name to update.</param>
         /// <param name="type">The type to update.</param>
         /// <returns>Returns whether any references were updated.</returns>
-        private bool UpdateTreeTextures(LocalizedContentManager content, IAssetName assetName, int type)
+        private bool UpdateTreeTextures(int type)
         {
             Tree[] trees = this.GetLocations()
                 .SelectMany(p => p.terrainFeatures.Values.OfType<Tree>())
                 .Where(tree => tree.treeType.Value == type)
                 .ToArray();
 
-            if (trees.Any())
+            bool changed = false;
+            foreach (Tree tree in trees)
             {
-                Lazy<Texture2D> texture = new Lazy<Texture2D>(() => content.Load<Texture2D>(assetName.BaseName));
-                foreach (Tree tree in trees)
-                    tree.texture = texture;
-                return true;
+                if (tree.texture.IsValueCreated)
+                {
+                    this.Reflection.GetMethod(tree, "resetTexture").Invoke();
+                    changed = true;
+                }
             }
+            return changed;
+        }
 
-            return false;
+        /// <summary>Mark an animated sprite's texture dirty, so it's reloaded next time it's rendered.</summary>
+        /// <param name="sprite">The animated sprite to change.</param>
+        /// <returns>Returns whether the sprite was changed.</returns>
+        private bool MarkSpriteDirty(AnimatedSprite sprite)
+        {
+            if (sprite.loadedTexture is null && sprite.spriteTexture is null)
+                return false;
+
+            sprite.loadedTexture = null;
+            sprite.spriteTexture = null;
+            return true;
         }
 
         /****

From e6ef71bae149b0d94055141075a84783f91e7c52 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 20 May 2022 17:39:05 -0400
Subject: [PATCH 645/856] add tick cache to asset propagation

---
 .../Utilities/TickCacheDictionary.cs          |  26 ++++
 src/SMAPI/Metadata/CoreAssetPropagator.cs     | 125 ++++++++++++------
 2 files changed, 113 insertions(+), 38 deletions(-)

diff --git a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
index 20d206e2..7732ace8 100644
--- a/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
+++ b/src/SMAPI/Framework/Utilities/TickCacheDictionary.cs
@@ -48,4 +48,30 @@ namespace StardewModdingAPI.Framework.Utilities
             return this.Cache.Remove(cacheKey);
         }
     }
+
+    /// <summary>An in-memory dictionary cache that stores data for the duration of a game update tick.</summary>
+    /// <typeparam name="TKey">The dictionary key type.</typeparam>
+    internal class TickCacheDictionary<TKey> : TickCacheDictionary<TKey, object>
+        where TKey : notnull
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get a value from the cache, fetching it first if it's not cached yet.</summary>
+        /// <param name="cacheKey">The unique key for the cached value.</param>
+        /// <param name="get">Get the latest data if it's not in the cache yet.</param>
+        public TValue GetOrSet<TValue>(TKey cacheKey, Func<TValue> get)
+        {
+            object? value = base.GetOrSet(cacheKey, () => get()!);
+
+            try
+            {
+                return (TValue)value;
+            }
+            catch (Exception ex)
+            {
+                throw new InvalidCastException($"Can't cast value of the '{cacheKey}' cache entry from {value?.GetType().FullName ?? "null"} to {typeof(TValue).FullName}.", ex);
+            }
+        }
+    }
 }
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index ce9ba7a8..8ed6b591 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -7,6 +7,7 @@ using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewValley;
@@ -58,6 +59,9 @@ namespace StardewModdingAPI.Metadata
             Other
         };
 
+        /// <summary>A cache of world data fetched for the current tick.</summary>
+        private readonly TickCacheDictionary<string> WorldCache = new();
+
 
         /*********
         ** Public methods
@@ -842,8 +846,7 @@ namespace StardewModdingAPI.Metadata
         {
             Grass[] grasses =
                 (
-                    from location in this.GetLocations()
-                    from grass in location.terrainFeatures.Values.OfType<Grass>()
+                    from grass in this.GetTerrainFeatures().OfType<Grass>()
                     where this.IsSameBaseName(assetName, grass.textureName())
                     select grass
                 )
@@ -978,8 +981,9 @@ namespace StardewModdingAPI.Metadata
         /// <returns>Returns whether any references were updated.</returns>
         private bool UpdateTreeTextures(int type)
         {
-            Tree[] trees = this.GetLocations()
-                .SelectMany(p => p.terrainFeatures.Values.OfType<Tree>())
+            Tree[] trees = this
+                .GetTerrainFeatures()
+                .OfType<Tree>()
                 .Where(tree => tree.treeType.Value == type)
                 .ToArray();
 
@@ -1188,63 +1192,108 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Get all NPCs in the game (excluding farm animals).</summary>
         private IEnumerable<NPC> GetCharacters()
         {
-            foreach (NPC character in this.GetLocations().SelectMany(p => p.characters))
-                yield return character;
+            return this.WorldCache.GetOrSet(
+                nameof(this.GetCharacters),
+                () =>
+                {
+                    List<NPC> characters = new();
 
-            if (Game1.CurrentEvent?.actors != null)
-            {
-                foreach (NPC character in Game1.CurrentEvent.actors)
-                    yield return character;
-            }
+                    foreach (NPC character in this.GetLocations().SelectMany(p => p.characters))
+                        characters.Add(character);
+
+                    if (Game1.CurrentEvent?.actors != null)
+                    {
+                        foreach (NPC character in Game1.CurrentEvent.actors)
+                            characters.Add(character);
+                    }
+
+                    return characters;
+                }
+            );
         }
 
         /// <summary>Get all farm animals in the game.</summary>
         private IEnumerable<FarmAnimal> GetFarmAnimals()
         {
-            foreach (GameLocation location in this.GetLocations())
-            {
-                if (location is Farm farm)
+            return this.WorldCache.GetOrSet(
+                nameof(this.GetFarmAnimals),
+                () =>
                 {
-                    foreach (FarmAnimal animal in farm.animals.Values)
-                        yield return animal;
+                    List<FarmAnimal> animals = new();
+
+                    foreach (GameLocation location in this.GetLocations())
+                    {
+                        if (location is Farm farm)
+                        {
+                            foreach (FarmAnimal animal in farm.animals.Values)
+                                animals.Add(animal);
+                        }
+                        else if (location is AnimalHouse animalHouse)
+                        {
+                            foreach (FarmAnimal animal in animalHouse.animals.Values)
+                                animals.Add(animal);
+                        }
+                    }
+
+                    return animals;
                 }
-                else if (location is AnimalHouse animalHouse)
-                    foreach (FarmAnimal animal in animalHouse.animals.Values)
-                        yield return animal;
-            }
+            );
         }
 
         /// <summary>Get all locations in the game.</summary>
         /// <param name="buildingInteriors">Whether to also get the interior locations for constructable buildings.</param>
         private IEnumerable<GameLocation> GetLocations(bool buildingInteriors = true)
         {
-            return this.GetLocationsWithInfo(buildingInteriors).Select(info => info.Location);
+            return this.WorldCache.GetOrSet(
+                $"{nameof(this.GetLocations)}_{buildingInteriors}",
+                () => this.GetLocationsWithInfo(buildingInteriors).Select(info => info.Location).ToArray()
+            );
         }
 
         /// <summary>Get all locations in the game.</summary>
         /// <param name="buildingInteriors">Whether to also get the interior locations for constructable buildings.</param>
         private IEnumerable<LocationInfo> GetLocationsWithInfo(bool buildingInteriors = true)
         {
-            // get available root locations
-            IEnumerable<GameLocation> rootLocations = Game1.locations;
-            if (SaveGame.loaded?.locations != null)
-                rootLocations = rootLocations.Concat(SaveGame.loaded.locations);
-
-            // yield root + child locations
-            foreach (GameLocation location in rootLocations)
-            {
-                yield return new LocationInfo(location, null);
-
-                if (buildingInteriors && location is BuildableGameLocation buildableLocation)
+            return this.WorldCache.GetOrSet(
+                $"{nameof(this.GetLocationsWithInfo)}_{buildingInteriors}",
+                () =>
                 {
-                    foreach (Building building in buildableLocation.buildings)
+                    List<LocationInfo> locations = new();
+
+                    // get root locations
+                    foreach (GameLocation location in Game1.locations)
+                        locations.Add(new LocationInfo(location, null));
+                    if (SaveGame.loaded?.locations != null)
                     {
-                        GameLocation? indoors = building.indoors.Value;
-                        if (indoors != null)
-                            yield return new LocationInfo(indoors, building);
+                        foreach (GameLocation location in SaveGame.loaded.locations)
+                            locations.Add(new LocationInfo(location, null));
                     }
-                }
-            }
+
+                    // get child locations
+                    if (buildingInteriors)
+                    {
+                        foreach (BuildableGameLocation location in locations.Select(p => p.Location).OfType<BuildableGameLocation>().ToArray())
+                        {
+                            foreach (Building building in location.buildings)
+                            {
+                                GameLocation indoors = building.indoors.Value;
+                                if (indoors is not null)
+                                    locations.Add(new LocationInfo(indoors, building));
+                            }
+                        }
+                    }
+
+                    return locations;
+                });
+        }
+
+        /// <summary>Get all terrain features in the game.</summary>
+        private IEnumerable<TerrainFeature> GetTerrainFeatures()
+        {
+            return this.WorldCache.GetOrSet(
+                $"{nameof(this.GetTerrainFeatures)}",
+                () => this.GetLocations().SelectMany(p => p.terrainFeatures.Values).ToArray()
+            );
         }
 
         /// <summary>Get whether two asset names are equivalent if you ignore the locale code.</summary>

From 7e7ac459a54a607de5843be37ea4b222058d5d3e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 21 May 2022 18:06:23 -0400
Subject: [PATCH 646/856] fix error when mod localizes an unlocalizable asset
 and then stops doing so

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Framework/ContentCoordinator.cs | 12 ++++++++++++
 2 files changed, 13 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8dc53e19..9de06f3f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,7 @@
 * For players:
   * Improved performance when mods change some asset types (including NPC portraits/sprites).
   * Fixed CurseForge update checks for the new CurseForge API.
+  * Fixed _could not find file_ error if a mod provides a localized version of a normally unlocalized asset and then stops providing it.
 
 ## 3.14.4
 Released 15 May 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index dd3d2917..fc61b44b 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -407,6 +407,18 @@ namespace StardewModdingAPI.Framework
                     }
                 }
 
+                // forget localized flags
+                // A mod might provide a localized variant of a normally non-localized asset (like
+                // `Maps/MovieTheater.fr-FR`). When the asset is invalidated, we need to recheck
+                // whether the asset is localized in case it stops providing it.
+                foreach (IAssetName assetName in invalidatedAssets.Keys)
+                {
+                    LocalizedContentManager.localizedAssetNames.Remove(assetName.Name);
+
+                    if (LocalizedContentManager.localizedAssetNames.TryGetValue(assetName.BaseName, out string? targetForBaseKey) && targetForBaseKey == assetName.Name)
+                        LocalizedContentManager.localizedAssetNames.Remove(assetName.BaseName);
+                }
+
                 // special case: maps may be loaded through a temporary content manager that's removed while the map is still in use.
                 // This notably affects the town and farmhouse maps.
                 if (Game1.locations != null)

From 336cc1cc0f250c96ee23d45e1e08569b67a2e562 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 22 May 2022 14:38:33 -0400
Subject: [PATCH 647/856]  prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 6 ++++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 76343b8d..7b59e4ae 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.14.4</Version>
+    <Version>3.14.5</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9de06f3f..cd177f61 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,11 +1,13 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.14.5
+Released 22 May 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
   * Improved performance when mods change some asset types (including NPC portraits/sprites).
-  * Fixed CurseForge update checks for the new CurseForge API.
   * Fixed _could not find file_ error if a mod provides a localized version of a normally unlocalized asset and then stops providing it.
+  * Fixed CurseForge update checks for the new CurseForge API.
 
 ## 3.14.4
 Released 15 May 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 78d26802..7b403a75 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.14.4",
+    "Version": "3.14.5",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.14.4"
+    "MinimumApiVersion": "3.14.5"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index be1030f4..2ac959bb 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.14.4",
+    "Version": "3.14.5",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.14.4"
+    "MinimumApiVersion": "3.14.5"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 8a50162e..707b6d8a 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.14.4",
+    "Version": "3.14.5",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.14.4"
+    "MinimumApiVersion": "3.14.5"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 357b8db8..b2916a8d 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.14.4";
+        internal static string RawApiVersion = "3.14.5";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 62665649bdec8b1b45b04e2d48bc68da689124d4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 23 May 2022 12:19:06 -0400
Subject: [PATCH 648/856] shortcut common cases in hot code paths

---
 src/SMAPI/Framework/Deprecations/DeprecationManager.cs | 3 +++
 src/SMAPI/Framework/SCore.cs                           | 1 +
 2 files changed, 4 insertions(+)

diff --git a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index 3bbbd7b8..4597a764 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -95,6 +95,9 @@ namespace StardewModdingAPI.Framework.Deprecations
         /// <summary>Print any queued messages.</summary>
         public void PrintQueued()
         {
+            if (!this.QueuedWarnings.Any())
+                return;
+
             foreach (DeprecationWarning warning in this.QueuedWarnings.OrderBy(p => p.ModName).ThenBy(p => p.NounPhrase))
             {
                 // build message
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 7042e83a..67f78400 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -596,6 +596,7 @@ namespace StardewModdingAPI.Framework
                 /*********
                 ** Execute commands
                 *********/
+                if (this.ScreenCommandQueue.Value.Any())
                 {
                     var commandQueue = this.ScreenCommandQueue.Value;
                     foreach ((Command? command, string? name, string[]? args) in commandQueue)

From 9933acad35375c994ada78109eb1af957288d9ea Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 23 May 2022 12:57:33 -0400
Subject: [PATCH 649/856] use <inheritdoc/> in watchers

---
 .../FieldWatchers/ComparableListWatcher.cs           | 10 +++++-----
 .../StateTracking/FieldWatchers/ComparableWatcher.cs | 12 ++++++------
 .../FieldWatchers/ImmutableCollectionWatcher.cs      | 12 ++++++------
 .../FieldWatchers/NetCollectionWatcher.cs            | 12 ++++++------
 .../FieldWatchers/NetDictionaryWatcher.cs            | 12 ++++++------
 .../StateTracking/FieldWatchers/NetListWatcher.cs    | 12 ++++++------
 .../StateTracking/FieldWatchers/NetValueWatcher.cs   | 12 ++++++------
 .../FieldWatchers/ObservableCollectionWatcher.cs     | 12 ++++++------
 src/SMAPI/Framework/StateTracking/LocationTracker.cs |  8 ++++----
 .../Framework/StateTracking/WorldLocationsTracker.cs |  8 ++++----
 10 files changed, 55 insertions(+), 55 deletions(-)

diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
index 256370ce..3d178a36 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
@@ -26,13 +26,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
-        /// <summary>Whether the value changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged => this.AddedImpl.Count > 0 || this.RemovedImpl.Count > 0;
 
-        /// <summary>The values added since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Added => this.AddedImpl;
 
-        /// <summary>The values removed since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Removed => this.RemovedImpl;
 
 
@@ -48,7 +48,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             this.LastValues = new HashSet<TValue>(comparer);
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             this.AssertNotDisposed();
@@ -71,7 +71,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             this.LastValues = curValues;
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             this.AssertNotDisposed();
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
index 5f76fe0a..e51c46c1 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
@@ -20,13 +20,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
-        /// <summary>The field value at the last reset.</summary>
+        /// <inheritdoc />
         public TValue PreviousValue { get; private set; }
 
-        /// <summary>The latest value.</summary>
+        /// <inheritdoc />
         public TValue CurrentValue { get; private set; }
 
-        /// <summary>Whether the value changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged { get; private set; }
 
 
@@ -44,21 +44,21 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             this.PreviousValue = this.CurrentValue;
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             this.CurrentValue = this.GetValue();
             this.IsChanged = !this.Comparer.Equals(this.PreviousValue, this.CurrentValue);
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             this.PreviousValue = this.CurrentValue;
             this.IsChanged = false;
         }
 
-        /// <summary>Release any references if needed when the field is no longer needed.</summary>
+        /// <inheritdoc />
         public void Dispose() { }
     }
 }
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
index 84340fbf..b46e0b24 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
@@ -13,26 +13,26 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <summary>A singleton collection watcher instance.</summary>
         public static ImmutableCollectionWatcher<TValue> Instance { get; } = new();
 
-        /// <summary>Whether the collection changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged { get; } = false;
 
-        /// <summary>The values added since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Added { get; } = Array.Empty<TValue>();
 
-        /// <summary>The values removed since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Removed { get; } = Array.Empty<TValue>();
 
 
         /*********
         ** Public methods
         *********/
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update() { }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset() { }
 
-        /// <summary>Stop watching the field and release all references.</summary>
+        /// <inheritdoc />
         public override void Dispose() { }
     }
 }
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
index 676c9fb4..e278fa99 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
@@ -24,13 +24,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
-        /// <summary>Whether the collection changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged => this.AddedImpl.Count > 0 || this.RemovedImpl.Count > 0;
 
-        /// <summary>The values added since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Added => this.AddedImpl;
 
-        /// <summary>The values removed since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Removed => this.RemovedImpl;
 
 
@@ -46,13 +46,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             field.OnValueRemoved += this.OnValueRemoved;
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             this.AssertNotDisposed();
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             this.AssertNotDisposed();
@@ -61,7 +61,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             this.RemovedImpl.Clear();
         }
 
-        /// <summary>Stop watching the field and release all references.</summary>
+        /// <inheritdoc />
         public override void Dispose()
         {
             if (!this.IsDisposed)
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
index f55e4cea..a0fcc236 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
@@ -31,13 +31,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
-        /// <summary>Whether the collection changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged => this.PairsAdded.Count > 0 || this.PairsRemoved.Count > 0;
 
-        /// <summary>The values added since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<KeyValuePair<TKey, TValue>> Added => this.PairsAdded;
 
-        /// <summary>The values removed since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<KeyValuePair<TKey, TValue>> Removed => this.PairsRemoved;
 
 
@@ -54,13 +54,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             field.OnValueRemoved += this.OnValueRemoved;
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             this.AssertNotDisposed();
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             this.AssertNotDisposed();
@@ -69,7 +69,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             this.PairsRemoved.Clear();
         }
 
-        /// <summary>Stop watching the field and release all references.</summary>
+        /// <inheritdoc />
         public override void Dispose()
         {
             if (!this.IsDisposed)
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
index 0b4d3030..79c3cb8b 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
@@ -25,13 +25,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
-        /// <summary>Whether the collection changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged => this.AddedImpl.Count > 0 || this.RemovedImpl.Count > 0;
 
-        /// <summary>The values added since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Added => this.AddedImpl;
 
-        /// <summary>The values removed since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Removed => this.RemovedImpl;
 
 
@@ -47,20 +47,20 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             field.OnArrayReplaced += this.OnArrayReplaced;
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             this.AddedImpl.Clear();
             this.RemovedImpl.Clear();
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             this.AssertNotDisposed();
         }
 
-        /// <summary>Stop watching the field and release all references.</summary>
+        /// <inheritdoc />
         public override void Dispose()
         {
             if (!this.IsDisposed)
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
index 48d5d681..d00f4582 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
@@ -17,13 +17,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
-        /// <summary>Whether the value changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged { get; private set; }
 
-        /// <summary>The field value at the last reset.</summary>
+        /// <inheritdoc />
         public TValue PreviousValue { get; private set; }
 
-        /// <summary>The latest value.</summary>
+        /// <inheritdoc />
         public TValue CurrentValue { get; private set; }
 
 
@@ -42,13 +42,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             field.fieldChangeEvent += this.OnValueChanged;
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             this.AssertNotDisposed();
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             this.AssertNotDisposed();
@@ -57,7 +57,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             this.IsChanged = false;
         }
 
-        /// <summary>Stop watching the field and release all references.</summary>
+        /// <inheritdoc />
         public override void Dispose()
         {
             if (!this.IsDisposed)
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
index 97aedca8..f503c47f 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
@@ -28,13 +28,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
-        /// <summary>Whether the collection changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged => this.AddedImpl.Count > 0 || this.RemovedImpl.Count > 0;
 
-        /// <summary>The values added since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Added => this.AddedImpl;
 
-        /// <summary>The values removed since the last reset.</summary>
+        /// <inheritdoc />
         public IEnumerable<TValue> Removed => this.RemovedImpl;
 
 
@@ -49,13 +49,13 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             field.CollectionChanged += this.OnCollectionChanged;
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             this.AssertNotDisposed();
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             this.AssertNotDisposed();
@@ -64,7 +64,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             this.RemovedImpl.Clear();
         }
 
-        /// <summary>Stop watching the field and release all references.</summary>
+        /// <inheritdoc />
         public override void Dispose()
         {
             if (!this.IsDisposed)
diff --git a/src/SMAPI/Framework/StateTracking/LocationTracker.cs b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
index ff72a19b..036ed73a 100644
--- a/src/SMAPI/Framework/StateTracking/LocationTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
@@ -25,7 +25,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         /*********
         ** Accessors
         *********/
-        /// <summary>Whether the value changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged => this.Watchers.Any(p => p.IsChanged);
 
         /// <summary>The tracked location.</summary>
@@ -88,7 +88,7 @@ namespace StardewModdingAPI.Framework.StateTracking
             this.UpdateChestWatcherList(added: location.Objects.Pairs, removed: Array.Empty<KeyValuePair<Vector2, SObject>>());
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             foreach (IWatcher watcher in this.Watchers)
@@ -100,7 +100,7 @@ namespace StardewModdingAPI.Framework.StateTracking
                 watcher.Value.Update();
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             foreach (IWatcher watcher in this.Watchers)
@@ -110,7 +110,7 @@ namespace StardewModdingAPI.Framework.StateTracking
                 watcher.Value.Reset();
         }
 
-        /// <summary>Stop watching the player fields and release all references.</summary>
+        /// <inheritdoc />
         public void Dispose()
         {
             foreach (IWatcher watcher in this.Watchers)
diff --git a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
index 817a6011..f328d659 100644
--- a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
@@ -37,7 +37,7 @@ namespace StardewModdingAPI.Framework.StateTracking
         /// <summary>Whether locations were added or removed since the last reset.</summary>
         public bool IsLocationListChanged => this.Added.Any() || this.Removed.Any();
 
-        /// <summary>Whether any tracked location data changed since the last reset.</summary>
+        /// <inheritdoc />
         public bool IsChanged => this.IsLocationListChanged || this.Locations.Any(p => p.IsChanged);
 
         /// <summary>The tracked locations.</summary>
@@ -64,7 +64,7 @@ namespace StardewModdingAPI.Framework.StateTracking
             this.VolcanoLocationListWatcher = WatcherFactory.ForReferenceList(activeVolcanoLocations);
         }
 
-        /// <summary>Update the current value if needed.</summary>
+        /// <inheritdoc />
         public void Update()
         {
             // update watchers
@@ -120,7 +120,7 @@ namespace StardewModdingAPI.Framework.StateTracking
             this.VolcanoLocationListWatcher.Reset();
         }
 
-        /// <summary>Set the current value as the baseline.</summary>
+        /// <inheritdoc />
         public void Reset()
         {
             this.ResetLocationList();
@@ -135,7 +135,7 @@ namespace StardewModdingAPI.Framework.StateTracking
             return this.LocationDict.ContainsKey(location);
         }
 
-        /// <summary>Stop watching the player fields and release all references.</summary>
+        /// <inheritdoc />
         public void Dispose()
         {
             foreach (IWatcher watcher in this.GetWatchers())

From 87ac7fc4032c1edbc246e7f7a96881f1284c04b9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 23 May 2022 12:57:33 -0400
Subject: [PATCH 650/856] fix nullable annotations in NetListWatcher

---
 .../Framework/StateTracking/FieldWatchers/NetListWatcher.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
index 79c3cb8b..3badb533 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
@@ -102,7 +102,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <param name="index">The list index which changed.</param>
         /// <param name="oldValue">The previous value.</param>
         /// <param name="newValue">The new value.</param>
-        private void OnElementChanged(NetList<TValue, NetRef<TValue>> list, int index, TValue oldValue, TValue newValue)
+        private void OnElementChanged(NetList<TValue, NetRef<TValue>> list, int index, TValue? oldValue, TValue? newValue)
         {
             this.Remove(oldValue);
             this.Add(newValue);
@@ -110,7 +110,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
 
         /// <summary>Track an added item.</summary>
         /// <param name="value">The value that was added.</param>
-        private void Add(TValue value)
+        private void Add(TValue? value)
         {
             if (value == null)
                 return;
@@ -126,7 +126,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
 
         /// <summary>Track a removed item.</summary>
         /// <param name="value">The value that was removed.</param>
-        private void Remove(TValue value)
+        private void Remove(TValue? value)
         {
             if (value == null)
                 return;

From 5675f9fcebfdeb03510c347712df8e9934b362c6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 23 May 2022 12:57:33 -0400
Subject: [PATCH 651/856] add watcher names to simplify troubleshooting

---
 .../Framework/StateTracking/ChestTracker.cs   |  5 ++-
 .../FieldWatchers/ComparableListWatcher.cs    |  7 ++-
 .../FieldWatchers/ComparableWatcher.cs        |  7 ++-
 .../ImmutableCollectionWatcher.cs             |  3 ++
 .../FieldWatchers/NetCollectionWatcher.cs     |  7 ++-
 .../FieldWatchers/NetDictionaryWatcher.cs     |  7 ++-
 .../FieldWatchers/NetListWatcher.cs           |  7 ++-
 .../FieldWatchers/NetValueWatcher.cs          |  7 ++-
 .../ObservableCollectionWatcher.cs            |  7 ++-
 .../FieldWatchers/WatcherFactory.cs           | 45 +++++++++++--------
 src/SMAPI/Framework/StateTracking/IWatcher.cs |  3 ++
 .../StateTracking/LocationTracker.cs          | 20 +++++----
 .../Framework/StateTracking/PlayerTracker.cs  | 14 +++---
 .../StateTracking/WorldLocationsTracker.cs    |  9 ++--
 src/SMAPI/Framework/WatcherCore.cs            | 14 +++---
 15 files changed, 110 insertions(+), 52 deletions(-)

diff --git a/src/SMAPI/Framework/StateTracking/ChestTracker.cs b/src/SMAPI/Framework/StateTracking/ChestTracker.cs
index c33a7498..2796ad54 100644
--- a/src/SMAPI/Framework/StateTracking/ChestTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/ChestTracker.cs
@@ -39,11 +39,12 @@ namespace StardewModdingAPI.Framework.StateTracking
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="chest">The chest being tracked.</param>
-        public ChestTracker(Chest chest)
+        public ChestTracker(string name, Chest chest)
         {
             this.Chest = chest;
-            this.InventoryWatcher = WatcherFactory.ForNetList(chest.items);
+            this.InventoryWatcher = WatcherFactory.ForNetList($"{name}.{nameof(chest.items)}", chest.items);
 
             this.StackSizes = this.Chest.items
                 .Where(n => n != null)
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
index 3d178a36..0b13434a 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
@@ -26,6 +26,9 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
         /// <inheritdoc />
         public bool IsChanged => this.AddedImpl.Count > 0 || this.RemovedImpl.Count > 0;
 
@@ -40,10 +43,12 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="values">The collection to watch.</param>
         /// <param name="comparer">The equality comparer which indicates whether two values are the same.</param>
-        public ComparableListWatcher(ICollection<TValue> values, IEqualityComparer<TValue> comparer)
+        public ComparableListWatcher(string name, ICollection<TValue> values, IEqualityComparer<TValue> comparer)
         {
+            this.Name = name;
             this.CurrentValues = values;
             this.LastValues = new HashSet<TValue>(comparer);
         }
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
index e51c46c1..e2f6c7fd 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableWatcher.cs
@@ -20,6 +20,9 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
         /// <inheritdoc />
         public TValue PreviousValue { get; private set; }
 
@@ -34,10 +37,12 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="getValue">Get the current value.</param>
         /// <param name="comparer">The equality comparer which indicates whether two values are the same.</param>
-        public ComparableWatcher(Func<TValue> getValue, IEqualityComparer<TValue> comparer)
+        public ComparableWatcher(string name, Func<TValue> getValue, IEqualityComparer<TValue> comparer)
         {
+            this.Name = name;
             this.GetValue = getValue;
             this.Comparer = comparer;
             this.CurrentValue = getValue();
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
index b46e0b24..9c2ba9bc 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ImmutableCollectionWatcher.cs
@@ -13,6 +13,9 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /// <summary>A singleton collection watcher instance.</summary>
         public static ImmutableCollectionWatcher<TValue> Instance { get; } = new();
 
+        /// <inheritdoc />
+        public string Name => nameof(ImmutableCollectionWatcher<TValue>);
+
         /// <inheritdoc />
         public bool IsChanged { get; } = false;
 
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
index e278fa99..1d5e4851 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetCollectionWatcher.cs
@@ -24,6 +24,9 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
         /// <inheritdoc />
         public bool IsChanged => this.AddedImpl.Count > 0 || this.RemovedImpl.Count > 0;
 
@@ -38,9 +41,11 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="field">The field to watch.</param>
-        public NetCollectionWatcher(NetCollection<TValue> field)
+        public NetCollectionWatcher(string name, NetCollection<TValue> field)
         {
+            this.Name = name;
             this.Field = field;
             field.OnValueAdded += this.OnValueAdded;
             field.OnValueRemoved += this.OnValueRemoved;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
index a0fcc236..3bd8e09d 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetDictionaryWatcher.cs
@@ -31,6 +31,9 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
         /// <inheritdoc />
         public bool IsChanged => this.PairsAdded.Count > 0 || this.PairsRemoved.Count > 0;
 
@@ -45,9 +48,11 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="field">The field to watch.</param>
-        public NetDictionaryWatcher(NetDictionary<TKey, TValue, TField, TSerialDict, TSelf> field)
+        public NetDictionaryWatcher(string name, NetDictionary<TKey, TValue, TField, TSerialDict, TSelf> field)
         {
+            this.Name = name;
             this.Field = field;
 
             field.OnValueAdded += this.OnValueAdded;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
index 3badb533..5b6a3e1f 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetListWatcher.cs
@@ -25,6 +25,9 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
         /// <inheritdoc />
         public bool IsChanged => this.AddedImpl.Count > 0 || this.RemovedImpl.Count > 0;
 
@@ -39,9 +42,11 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="field">The field to watch.</param>
-        public NetListWatcher(NetList<TValue, NetRef<TValue>> field)
+        public NetListWatcher(string name, NetList<TValue, NetRef<TValue>> field)
         {
+            this.Name = name;
             this.Field = field;
             field.OnElementChanged += this.OnElementChanged;
             field.OnArrayReplaced += this.OnArrayReplaced;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
index d00f4582..e4219dda 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/NetValueWatcher.cs
@@ -17,6 +17,9 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
         /// <inheritdoc />
         public bool IsChanged { get; private set; }
 
@@ -31,9 +34,11 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="field">The field to watch.</param>
-        public NetValueWatcher(NetFieldBase<TValue, TNetField> field)
+        public NetValueWatcher(string name, NetFieldBase<TValue, TNetField> field)
         {
+            this.Name = name;
             this.Field = field;
             this.PreviousValue = field.Value;
             this.CurrentValue = field.Value;
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
index f503c47f..1f95ac89 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ObservableCollectionWatcher.cs
@@ -28,6 +28,9 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
         /// <inheritdoc />
         public bool IsChanged => this.AddedImpl.Count > 0 || this.RemovedImpl.Count > 0;
 
@@ -42,9 +45,11 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="field">The field to watch.</param>
-        public ObservableCollectionWatcher(ObservableCollection<TValue> field)
+        public ObservableCollectionWatcher(string name, ObservableCollection<TValue> field)
         {
+            this.Name = name;
             this.Field = field;
             field.CollectionChanged += this.OnCollectionChanged;
         }
diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
index c4a4d0b9..c31be1fc 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/WatcherFactory.cs
@@ -17,37 +17,41 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ****/
         /// <summary>Get a watcher which compares values using their <see cref="object.Equals(object)"/> method. This method should only be used when <see cref="ForEquatable{T}"/> won't work, since this doesn't validate whether they're comparable.</summary>
         /// <typeparam name="T">The value type.</typeparam>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="getValue">Get the current value.</param>
-        public static IValueWatcher<T> ForGenericEquality<T>(Func<T> getValue)
+        public static IValueWatcher<T> ForGenericEquality<T>(string name, Func<T> getValue)
             where T : struct
         {
-            return new ComparableWatcher<T>(getValue, new GenericEqualsComparer<T>());
+            return new ComparableWatcher<T>(name, getValue, new GenericEqualsComparer<T>());
         }
 
         /// <summary>Get a watcher for an <see cref="IEquatable{T}"/> value.</summary>
         /// <typeparam name="T">The value type.</typeparam>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="getValue">Get the current value.</param>
-        public static IValueWatcher<T> ForEquatable<T>(Func<T> getValue)
+        public static IValueWatcher<T> ForEquatable<T>(string name, Func<T> getValue)
             where T : IEquatable<T>
         {
-            return new ComparableWatcher<T>(getValue, new EquatableComparer<T>());
+            return new ComparableWatcher<T>(name, getValue, new EquatableComparer<T>());
         }
 
         /// <summary>Get a watcher which detects when an object reference changes.</summary>
         /// <typeparam name="T">The value type.</typeparam>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="getValue">Get the current value.</param>
-        public static IValueWatcher<T> ForReference<T>(Func<T> getValue)
+        public static IValueWatcher<T> ForReference<T>(string name, Func<T> getValue)
         {
-            return new ComparableWatcher<T>(getValue, new ObjectReferenceComparer<T>());
+            return new ComparableWatcher<T>(name, getValue, new ObjectReferenceComparer<T>());
         }
 
         /// <summary>Get a watcher for a net collection.</summary>
         /// <typeparam name="T">The value type.</typeparam>
         /// <typeparam name="TSelf">The net field instance type.</typeparam>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="field">The net collection.</param>
-        public static IValueWatcher<T> ForNetValue<T, TSelf>(NetFieldBase<T, TSelf> field) where TSelf : NetFieldBase<T, TSelf>
+        public static IValueWatcher<T> ForNetValue<T, TSelf>(string name, NetFieldBase<T, TSelf> field) where TSelf : NetFieldBase<T, TSelf>
         {
-            return new NetValueWatcher<T, TSelf>(field);
+            return new NetValueWatcher<T, TSelf>(name, field);
         }
 
         /****
@@ -55,18 +59,20 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
         ****/
         /// <summary>Get a watcher which detects when an object reference in a collection changes.</summary>
         /// <typeparam name="T">The value type.</typeparam>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="collection">The observable collection.</param>
-        public static ICollectionWatcher<T> ForReferenceList<T>(ICollection<T> collection)
+        public static ICollectionWatcher<T> ForReferenceList<T>(string name, ICollection<T> collection)
         {
-            return new ComparableListWatcher<T>(collection, new ObjectReferenceComparer<T>());
+            return new ComparableListWatcher<T>(name, collection, new ObjectReferenceComparer<T>());
         }
 
         /// <summary>Get a watcher for an observable collection.</summary>
         /// <typeparam name="T">The value type.</typeparam>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="collection">The observable collection.</param>
-        public static ICollectionWatcher<T> ForObservableCollection<T>(ObservableCollection<T> collection)
+        public static ICollectionWatcher<T> ForObservableCollection<T>(string name, ObservableCollection<T> collection)
         {
-            return new ObservableCollectionWatcher<T>(collection);
+            return new ObservableCollectionWatcher<T>(name, collection);
         }
 
         /// <summary>Get a watcher for a collection that never changes.</summary>
@@ -78,36 +84,39 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
 
         /// <summary>Get a watcher for a net collection.</summary>
         /// <typeparam name="T">The value type.</typeparam>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="collection">The net collection.</param>
-        public static ICollectionWatcher<T> ForNetCollection<T>(NetCollection<T> collection)
+        public static ICollectionWatcher<T> ForNetCollection<T>(string name, NetCollection<T> collection)
             where T : class, INetObject<INetSerializable>
         {
-            return new NetCollectionWatcher<T>(collection);
+            return new NetCollectionWatcher<T>(name, collection);
         }
 
         /// <summary>Get a watcher for a net list.</summary>
         /// <typeparam name="T">The value type.</typeparam>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <param name="collection">The net list.</param>
-        public static ICollectionWatcher<T> ForNetList<T>(NetList<T, NetRef<T>> collection)
+        public static ICollectionWatcher<T> ForNetList<T>(string name, NetList<T, NetRef<T>> collection)
             where T : class, INetObject<INetSerializable>
         {
-            return new NetListWatcher<T>(collection);
+            return new NetListWatcher<T>(name, collection);
         }
 
         /// <summary>Get a watcher for a net dictionary.</summary>
+        /// <param name="name">A name which identifies what the watcher is watching, used for troubleshooting.</param>
         /// <typeparam name="TKey">The dictionary key type.</typeparam>
         /// <typeparam name="TValue">The dictionary value type.</typeparam>
         /// <typeparam name="TField">The net type equivalent to <typeparamref name="TValue"/>.</typeparam>
         /// <typeparam name="TSerialDict">The serializable dictionary type that can store the keys and values.</typeparam>
         /// <typeparam name="TSelf">The net field instance type.</typeparam>
         /// <param name="field">The net field.</param>
-        public static NetDictionaryWatcher<TKey, TValue, TField, TSerialDict, TSelf> ForNetDictionary<TKey, TValue, TField, TSerialDict, TSelf>(NetDictionary<TKey, TValue, TField, TSerialDict, TSelf> field)
+        public static NetDictionaryWatcher<TKey, TValue, TField, TSerialDict, TSelf> ForNetDictionary<TKey, TValue, TField, TSerialDict, TSelf>(string name, NetDictionary<TKey, TValue, TField, TSerialDict, TSelf> field)
             where TKey : notnull
             where TField : class, INetObject<INetSerializable>, new()
             where TSerialDict : IDictionary<TKey, TValue>, new()
             where TSelf : NetDictionary<TKey, TValue, TField, TSerialDict, TSelf>
         {
-            return new NetDictionaryWatcher<TKey, TValue, TField, TSerialDict, TSelf>(field);
+            return new NetDictionaryWatcher<TKey, TValue, TField, TSerialDict, TSelf>(name, field);
         }
     }
 }
diff --git a/src/SMAPI/Framework/StateTracking/IWatcher.cs b/src/SMAPI/Framework/StateTracking/IWatcher.cs
index 8c7fa51c..4a0e3998 100644
--- a/src/SMAPI/Framework/StateTracking/IWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/IWatcher.cs
@@ -8,6 +8,9 @@ namespace StardewModdingAPI.Framework.StateTracking
         /*********
         ** Accessors
         *********/
+        /// <summary>A name which identifies what the watcher is watching, used for troubleshooting.</summary>
+        string Name { get; }
+
         /// <summary>Whether the value changed since the last reset.</summary>
         bool IsChanged { get; }
 
diff --git a/src/SMAPI/Framework/StateTracking/LocationTracker.cs b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
index 036ed73a..790c71dd 100644
--- a/src/SMAPI/Framework/StateTracking/LocationTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/LocationTracker.cs
@@ -25,6 +25,9 @@ namespace StardewModdingAPI.Framework.StateTracking
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name { get; }
+
         /// <inheritdoc />
         public bool IsChanged => this.Watchers.Any(p => p.IsChanged);
 
@@ -63,16 +66,17 @@ namespace StardewModdingAPI.Framework.StateTracking
         /// <param name="location">The location to track.</param>
         public LocationTracker(GameLocation location)
         {
+            this.Name = $"Locations.{location.NameOrUniqueName}";
             this.Location = location;
 
             // init watchers
-            this.BuildingsWatcher = location is BuildableGameLocation buildableLocation ? WatcherFactory.ForNetCollection(buildableLocation.buildings) : WatcherFactory.ForImmutableCollection<Building>();
-            this.DebrisWatcher = WatcherFactory.ForNetCollection(location.debris);
-            this.LargeTerrainFeaturesWatcher = WatcherFactory.ForNetCollection(location.largeTerrainFeatures);
-            this.NpcsWatcher = WatcherFactory.ForNetCollection(location.characters);
-            this.ObjectsWatcher = WatcherFactory.ForNetDictionary(location.netObjects);
-            this.TerrainFeaturesWatcher = WatcherFactory.ForNetDictionary(location.terrainFeatures);
-            this.FurnitureWatcher = WatcherFactory.ForNetCollection(location.furniture);
+            this.BuildingsWatcher = location is BuildableGameLocation buildableLocation ? WatcherFactory.ForNetCollection($"{this.Name}.{nameof(buildableLocation.buildings)}", buildableLocation.buildings) : WatcherFactory.ForImmutableCollection<Building>();
+            this.DebrisWatcher = WatcherFactory.ForNetCollection($"{this.Name}.{nameof(location.debris)}", location.debris);
+            this.LargeTerrainFeaturesWatcher = WatcherFactory.ForNetCollection($"{this.Name}.{nameof(location.largeTerrainFeatures)}", location.largeTerrainFeatures);
+            this.NpcsWatcher = WatcherFactory.ForNetCollection($"{this.Name}.{nameof(location.characters)}", location.characters);
+            this.ObjectsWatcher = WatcherFactory.ForNetDictionary($"{this.Name}.{nameof(location.netObjects)}", location.netObjects);
+            this.TerrainFeaturesWatcher = WatcherFactory.ForNetDictionary($"{this.Name}.{nameof(location.terrainFeatures)}", location.terrainFeatures);
+            this.FurnitureWatcher = WatcherFactory.ForNetCollection($"{this.Name}.{nameof(location.furniture)}", location.furniture);
 
             this.Watchers.AddRange(new IWatcher[]
             {
@@ -143,7 +147,7 @@ namespace StardewModdingAPI.Framework.StateTracking
             foreach ((Vector2 tile, SObject? obj) in added)
             {
                 if (obj is Chest chest && !this.ChestWatchers.ContainsKey(tile))
-                    this.ChestWatchers.Add(tile, new ChestTracker(chest));
+                    this.ChestWatchers.Add(tile, new ChestTracker($"{this.Name}.chest({tile})", chest));
             }
         }
     }
diff --git a/src/SMAPI/Framework/StateTracking/PlayerTracker.cs b/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
index 5433ac8e..fae90678 100644
--- a/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/PlayerTracker.cs
@@ -54,15 +54,15 @@ namespace StardewModdingAPI.Framework.StateTracking
             this.PreviousInventory = new Dictionary<Item, int>(this.CurrentInventory);
 
             // init trackers
-            this.LocationWatcher = WatcherFactory.ForReference(this.GetCurrentLocation);
+            this.LocationWatcher = WatcherFactory.ForReference($"player.{nameof(player.currentLocation)}", this.GetCurrentLocation);
             this.SkillWatchers = new Dictionary<SkillType, IValueWatcher<int>>
             {
-                [SkillType.Combat] = WatcherFactory.ForNetValue(player.combatLevel),
-                [SkillType.Farming] = WatcherFactory.ForNetValue(player.farmingLevel),
-                [SkillType.Fishing] = WatcherFactory.ForNetValue(player.fishingLevel),
-                [SkillType.Foraging] = WatcherFactory.ForNetValue(player.foragingLevel),
-                [SkillType.Luck] = WatcherFactory.ForNetValue(player.luckLevel),
-                [SkillType.Mining] = WatcherFactory.ForNetValue(player.miningLevel)
+                [SkillType.Combat] = WatcherFactory.ForNetValue($"player.{nameof(player.combatLevel)}", player.combatLevel),
+                [SkillType.Farming] = WatcherFactory.ForNetValue($"player.{nameof(player.farmingLevel)}", player.farmingLevel),
+                [SkillType.Fishing] = WatcherFactory.ForNetValue($"player.{nameof(player.fishingLevel)}", player.fishingLevel),
+                [SkillType.Foraging] = WatcherFactory.ForNetValue($"player.{nameof(player.foragingLevel)}", player.foragingLevel),
+                [SkillType.Luck] = WatcherFactory.ForNetValue($"player.{nameof(player.luckLevel)}", player.luckLevel),
+                [SkillType.Mining] = WatcherFactory.ForNetValue($"player.{nameof(player.miningLevel)}", player.miningLevel)
             };
 
             // track watchers for convenience
diff --git a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
index f328d659..ca6988ad 100644
--- a/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
+++ b/src/SMAPI/Framework/StateTracking/WorldLocationsTracker.cs
@@ -34,6 +34,9 @@ namespace StardewModdingAPI.Framework.StateTracking
         /*********
         ** Accessors
         *********/
+        /// <inheritdoc />
+        public string Name => nameof(WorldLocationsTracker);
+
         /// <summary>Whether locations were added or removed since the last reset.</summary>
         public bool IsLocationListChanged => this.Added.Any() || this.Removed.Any();
 
@@ -59,9 +62,9 @@ namespace StardewModdingAPI.Framework.StateTracking
         /// <param name="activeVolcanoLocations">The game's list of active volcano locations.</param>
         public WorldLocationsTracker(ObservableCollection<GameLocation> locations, IList<MineShaft> activeMineLocations, IList<VolcanoDungeon> activeVolcanoLocations)
         {
-            this.LocationListWatcher = WatcherFactory.ForObservableCollection(locations);
-            this.MineLocationListWatcher = WatcherFactory.ForReferenceList(activeMineLocations);
-            this.VolcanoLocationListWatcher = WatcherFactory.ForReferenceList(activeVolcanoLocations);
+            this.LocationListWatcher = WatcherFactory.ForObservableCollection($"{this.Name}.{nameof(locations)}", locations);
+            this.MineLocationListWatcher = WatcherFactory.ForReferenceList($"{this.Name}.{nameof(activeMineLocations)}", activeMineLocations);
+            this.VolcanoLocationListWatcher = WatcherFactory.ForReferenceList($"{this.Name}.{nameof(activeVolcanoLocations)}", activeVolcanoLocations);
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/Framework/WatcherCore.cs b/src/SMAPI/Framework/WatcherCore.cs
index 5e20ac7b..35f27cc7 100644
--- a/src/SMAPI/Framework/WatcherCore.cs
+++ b/src/SMAPI/Framework/WatcherCore.cs
@@ -60,14 +60,14 @@ namespace StardewModdingAPI.Framework
         public WatcherCore(SInputState inputState, ObservableCollection<GameLocation> gameLocations)
         {
             // init watchers
-            this.CursorWatcher = WatcherFactory.ForEquatable(() => inputState.CursorPosition);
-            this.MouseWheelScrollWatcher = WatcherFactory.ForEquatable(() => inputState.MouseState.ScrollWheelValue);
-            this.SaveIdWatcher = WatcherFactory.ForEquatable(() => Game1.hasLoadedGame ? Game1.uniqueIDForThisGame : 0);
-            this.WindowSizeWatcher = WatcherFactory.ForEquatable(() => new Point(Game1.viewport.Width, Game1.viewport.Height));
-            this.TimeWatcher = WatcherFactory.ForEquatable(() => Game1.timeOfDay);
-            this.ActiveMenuWatcher = WatcherFactory.ForReference(() => Game1.activeClickableMenu);
+            this.CursorWatcher = WatcherFactory.ForEquatable(nameof(inputState.CursorPosition), () => inputState.CursorPosition);
+            this.MouseWheelScrollWatcher = WatcherFactory.ForEquatable(nameof(inputState.MouseState.ScrollWheelValue), () => inputState.MouseState.ScrollWheelValue);
+            this.SaveIdWatcher = WatcherFactory.ForEquatable(nameof(Game1.uniqueIDForThisGame), () => Game1.hasLoadedGame ? Game1.uniqueIDForThisGame : 0);
+            this.WindowSizeWatcher = WatcherFactory.ForEquatable(nameof(Game1.viewport), () => new Point(Game1.viewport.Width, Game1.viewport.Height));
+            this.TimeWatcher = WatcherFactory.ForEquatable(nameof(Game1.timeOfDay), () => Game1.timeOfDay);
+            this.ActiveMenuWatcher = WatcherFactory.ForReference(nameof(Game1.activeClickableMenu), () => Game1.activeClickableMenu);
             this.LocationsWatcher = new WorldLocationsTracker(gameLocations, MineShaft.activeMines, VolcanoDungeon.activeLevels);
-            this.LocaleWatcher = WatcherFactory.ForGenericEquality(() => LocalizedContentManager.CurrentLanguageCode);
+            this.LocaleWatcher = WatcherFactory.ForGenericEquality(nameof(LocalizedContentManager.CurrentLanguageCode), () => LocalizedContentManager.CurrentLanguageCode);
             this.Watchers.AddRange(new IWatcher[]
             {
                 this.CursorWatcher,

From 5083b65c8708b0c5c0a12871d2fdda830bb98f09 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 23 May 2022 14:33:01 -0400
Subject: [PATCH 652/856] fix readme headings for mod build package

---
 docs/technical/mod-package.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index c632af84..dd65a992 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -412,14 +412,14 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
-## 4.0.1
+### 4.0.1
 Released 14 April 2022.
 
 * Added detection for Xbox app game folders.
 * Fixed "_conflicts between different versions of Microsoft.Win32.Registry_" warnings in recent SMAPI versions.
 * Internal refactoring.
 
-## 4.0.0
+### 4.0.0
 Released 30 November 2021.
 
 * Updated for Stardew Valley 1.5.5 and SMAPI 3.13.0. (Older versions are no longer supported.)
@@ -441,7 +441,7 @@ Released 30 November 2021.
    * If you need to bundle extra DLLs besides your mod DLL, see the [`BundleExtraAssemblies`
      documentation](#configure).
 
-## 3.3.0
+### 3.3.0
 Released 30 March 2021.
 
 * Added a build warning when the mod isn't compiled for `Any CPU`.
@@ -450,7 +450,7 @@ Released 30 March 2021.
 * Added support for building mods against the 64-bit Linux version of the game on Windows.
 * The package now suppresses the misleading 'processor architecture mismatch' warnings.
 
-## 3.2.2
+### 3.2.2
 Released 23 September 2020.
 
 * Reworked and streamlined how the package is compiled.

From 064346594d2239b1dceb9ddbc78e147c555d63d7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 24 May 2022 18:12:06 -0400
Subject: [PATCH 653/856] fix split-screen error when a mod provides a
 localized asset in one screen but not another

---
 docs/release-notes.md                         |  4 ++++
 src/SMAPI/Framework/ContentCoordinator.cs     | 24 +++++++++++++++----
 .../ContentManagers/BaseContentManager.cs     | 12 ++++++----
 3 files changed, 30 insertions(+), 10 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index cd177f61..91ff0618 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Fixed error in split-screen mode when a mod provides a localized asset in one screen but not another.
+
 ## 3.14.5
 Released 22 May 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index fc61b44b..cfeb35c8 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -15,8 +15,8 @@ using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
 using StardewModdingAPI.Metadata;
 using StardewModdingAPI.Toolkit.Serialization;
-using StardewModdingAPI.Toolkit.Utilities;
 using StardewModdingAPI.Toolkit.Utilities.PathLookups;
+using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.GameData;
 using xTile;
@@ -110,6 +110,10 @@ namespace StardewModdingAPI.Framework
         /// <summary>The absolute path to the <see cref="ContentManager.RootDirectory"/>.</summary>
         public string FullRootDirectory { get; }
 
+        /// <summary>A lookup which tracks whether each given asset name has a localized form.</summary>
+        /// <remarks>This is a per-screen equivalent to the base game's <see cref="LocalizedContentManager.localizedAssetNames"/> field, since mods may provide different assets per-screen.</remarks>
+        public PerScreen<Dictionary<string, string>> LocalizedAssetNames { get; } = new(() => new());
+
 
         /*********
         ** Public methods
@@ -245,6 +249,9 @@ namespace StardewModdingAPI.Framework
             {
                 this.VanillaContentManager.Unload();
             });
+
+            // forget localized flags (to match the logic in Game1.TranslateFields, which is called on language change)
+            this.LocalizedAssetNames.Value.Clear();
         }
 
         /// <summary>Clean up when the player is returning to the title screen.</summary>
@@ -275,6 +282,10 @@ namespace StardewModdingAPI.Framework
             // their changes, the assets won't be found in the cache so no changes will be propagated.
             if (LocalizedContentManager.CurrentLanguageCode != LocalizedContentManager.LanguageCode.en)
                 this.InvalidateCache((contentManager, _, _) => contentManager is GameContentManager);
+
+            // clear the localized assets lookup (to match the logic in Game1.CleanupReturningToTitle)
+            foreach ((_, Dictionary<string, string> localizedAssets) in this.LocalizedAssetNames.GetActiveValues())
+                localizedAssets.Clear();
         }
 
         /// <summary>Parse a raw asset name.</summary>
@@ -411,12 +422,15 @@ namespace StardewModdingAPI.Framework
                 // A mod might provide a localized variant of a normally non-localized asset (like
                 // `Maps/MovieTheater.fr-FR`). When the asset is invalidated, we need to recheck
                 // whether the asset is localized in case it stops providing it.
-                foreach (IAssetName assetName in invalidatedAssets.Keys)
                 {
-                    LocalizedContentManager.localizedAssetNames.Remove(assetName.Name);
+                    Dictionary<string, string> localizedAssetNames = this.LocalizedAssetNames.Value;
+                    foreach (IAssetName assetName in invalidatedAssets.Keys)
+                    {
+                        localizedAssetNames.Remove(assetName.Name);
 
-                    if (LocalizedContentManager.localizedAssetNames.TryGetValue(assetName.BaseName, out string? targetForBaseKey) && targetForBaseKey == assetName.Name)
-                        LocalizedContentManager.localizedAssetNames.Remove(assetName.BaseName);
+                        if (localizedAssetNames.TryGetValue(assetName.BaseName, out string? targetForBaseKey) && targetForBaseKey == assetName.Name)
+                            localizedAssetNames.Remove(assetName.BaseName);
+                    }
                 }
 
                 // special case: maps may be loaded through a temporary content manager that's removed while the map is still in use.
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index ddc02a8c..d7be0c37 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -153,7 +153,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return this.LoadExact<T>(assetName, useCache: useCache);
 
             // check for localized asset
-            if (!LocalizedContentManager.localizedAssetNames.TryGetValue(assetName.Name, out _))
+            // ReSharper disable once LocalVariableHidesMember -- this is deliberate
+            Dictionary<string, string> localizedAssetNames = this.Coordinator.LocalizedAssetNames.Value;
+            if (!localizedAssetNames.TryGetValue(assetName.Name, out _))
             {
                 string localeCode = this.LanguageCodeString(language);
                 IAssetName localizedName = new AssetName(baseName: assetName.BaseName, localeCode: localeCode, languageCode: language);
@@ -161,7 +163,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 try
                 {
                     T data = this.LoadExact<T>(localizedName, useCache: useCache);
-                    LocalizedContentManager.localizedAssetNames[assetName.Name] = localizedName.Name;
+                    localizedAssetNames[assetName.Name] = localizedName.Name;
                     return data;
                 }
                 catch (ContentLoadException)
@@ -170,18 +172,18 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     try
                     {
                         T data = this.LoadExact<T>(localizedName, useCache: useCache);
-                        LocalizedContentManager.localizedAssetNames[assetName.Name] = localizedName.Name;
+                        localizedAssetNames[assetName.Name] = localizedName.Name;
                         return data;
                     }
                     catch (ContentLoadException)
                     {
-                        LocalizedContentManager.localizedAssetNames[assetName.Name] = assetName.Name;
+                        localizedAssetNames[assetName.Name] = assetName.Name;
                     }
                 }
             }
 
             // use cached key
-            string rawName = LocalizedContentManager.localizedAssetNames[assetName.Name];
+            string rawName = localizedAssetNames[assetName.Name];
             if (assetName.Name != rawName)
                 assetName = this.Coordinator.ParseAssetName(rawName, allowLocales: this.TryLocalizeKeys);
             return this.LoadExact<T>(assetName, useCache: useCache);

From e8c6221d967fd3b7387ecce879a082e7dead92da Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 26 May 2022 01:53:39 -0400
Subject: [PATCH 654/856] fix typo

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 38a21383..1b94b8c6 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -176,7 +176,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             return asset;
         }
 
-        /// <summary>Load an unpacked image file (<c>.json</c>).</summary>
+        /// <summary>Load an unpacked image file (<c>.png</c>).</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
         /// <param name="file">The file to load.</param>

From e4cd7c8eb09fa50802ce4eb9dbe4683ce61f7a5d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 27 May 2022 18:08:30 -0400
Subject: [PATCH 655/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 5 ++++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 7b59e4ae..2e37e729 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.14.5</Version>
+    <Version>3.14.6</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 91ff0618..4770bd4f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,9 +1,12 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.14.6
+Released 27 May 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
   * Fixed error in split-screen mode when a mod provides a localized asset in one screen but not another.
+  * Minor optimizations.
 
 ## 3.14.5
 Released 22 May 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 7b403a75..9d9a8061 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.14.5",
+    "Version": "3.14.6",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.14.5"
+    "MinimumApiVersion": "3.14.6"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 2ac959bb..07c2512b 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.14.5",
+    "Version": "3.14.6",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.14.5"
+    "MinimumApiVersion": "3.14.6"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 707b6d8a..ec048dea 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.14.5",
+    "Version": "3.14.6",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.14.5"
+    "MinimumApiVersion": "3.14.6"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index b2916a8d..9212fc90 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.14.5";
+        internal static string RawApiVersion = "3.14.6";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 9ef3f7edb1589a52794c7da7075996d4a02de6e7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 30 May 2022 17:30:26 -0400
Subject: [PATCH 656/856] remove
 `System.Reflection.Metadata.MetadataUpdater.IsSupported: false` in runtime
 config

This doesn't seem to be needed, and was probably added as part of the early experimenting with self-contained .NET.
---
 docs/release-notes.md                         | 4 ++++
 src/SMAPI.Installer/assets/runtimeconfig.json | 5 +++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4770bd4f..cdc0f548 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For mod authors:
+  * Removed `runtimeconfig.json` setting which impacted hot reload support.
+
 ## 3.14.6
 Released 27 May 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Installer/assets/runtimeconfig.json b/src/SMAPI.Installer/assets/runtimeconfig.json
index 34018b8a..bd6a5240 100644
--- a/src/SMAPI.Installer/assets/runtimeconfig.json
+++ b/src/SMAPI.Installer/assets/runtimeconfig.json
@@ -9,8 +9,9 @@
             }
         ],
         "configProperties": {
-            "System.Runtime.TieredCompilation": false,
-            "System.Reflection.Metadata.MetadataUpdater.IsSupported": false
+            // disable tiered runtime JIT: https://github.com/dotnet/runtime/blob/main/docs/design/features/tiered-compilation.md
+            // This is disabled by the base game, and causes issues with Harmony patches.
+            "System.Runtime.TieredCompilation": false
         }
     }
 }

From 9992915f565578949cad8d9bb8ceb360e0db5c85 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 31 May 2022 18:32:23 -0400
Subject: [PATCH 657/856] replace MemoryCache with custom cache

This was causing significant frame stutters for some players since the migration to .NET 5 in Stardew Valley 1.5.5.
---
 build/common.targets                          |   3 -
 build/unix/prepare-install-package.sh         |   4 -
 build/windows/prepare-install-package.ps1     |   4 -
 docs/release-notes.md                         |   2 +
 src/SMAPI/Framework/Reflection/CacheEntry.cs  |  30 -----
 src/SMAPI/Framework/Reflection/Reflector.cs   | 110 +++++++++---------
 src/SMAPI/Framework/SCore.cs                  |   2 +
 .../Utilities/IntervalMemoryCache.cs          |  57 +++++++++
 src/SMAPI/SMAPI.csproj                        |   1 -
 9 files changed, 119 insertions(+), 94 deletions(-)
 delete mode 100644 src/SMAPI/Framework/Reflection/CacheEntry.cs
 create mode 100644 src/SMAPI/Framework/Utilities/IntervalMemoryCache.cs

diff --git a/build/common.targets b/build/common.targets
index 2e37e729..b2441af8 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -69,10 +69,7 @@
     <Copy SourceFiles="$(TargetDir)\MonoMod.Common.dll" DestinationFolder="$(GamePath)\smapi-internal" />
 
     <!-- .NET dependencies -->
-    <Copy SourceFiles="$(TargetDir)\System.Configuration.ConfigurationManager.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\System.Management.dll" DestinationFolder="$(GamePath)\smapi-internal" Condition="$(OS) == 'Windows_NT'" />
-    <Copy SourceFiles="$(TargetDir)\System.Runtime.Caching.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\System.Security.Permissions.dll" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
 
   <Target Name="CopyDefaultMods" Condition="'$(MSBuildProjectName)' == 'SMAPI.Mods.ConsoleCommands' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.ErrorHandler' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.SaveBackup'">
diff --git a/build/unix/prepare-install-package.sh b/build/unix/prepare-install-package.sh
index 9b195f37..01c3a0ec 100755
--- a/build/unix/prepare-install-package.sh
+++ b/build/unix/prepare-install-package.sh
@@ -142,15 +142,11 @@ for folder in ${folders[@]}; do
     cp "$smapiBin/SMAPI.metadata.json" "$bundlePath/smapi-internal/metadata.json"
     if [ $folder == "linux" ] || [ $folder == "macOS" ]; then
         cp "$installAssets/unix-launcher.sh" "$bundlePath"
-        cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
     else
         cp "$installAssets/windows-exe-config.xml" "$bundlePath/StardewModdingAPI.exe.config"
     fi
 
     # copy .NET dependencies
-    cp "$smapiBin/System.Configuration.ConfigurationManager.dll" "$bundlePath/smapi-internal"
-    cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
-    cp "$smapiBin/System.Security.Permissions.dll" "$bundlePath/smapi-internal"
     if [ $folder == "windows" ]; then
         cp "$smapiBin/System.Management.dll" "$bundlePath/smapi-internal"
     fi
diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index 5e116019..6731486b 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -162,16 +162,12 @@ foreach ($folder in $folders) {
     cp "$smapiBin/SMAPI.metadata.json" "$bundlePath/smapi-internal/metadata.json"
     if ($folder -eq "linux" -or $folder -eq "macOS") {
         cp "$installAssets/unix-launcher.sh" "$bundlePath"
-        cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
     }
     else {
         cp "$installAssets/windows-exe-config.xml" "$bundlePath/StardewModdingAPI.exe.config"
     }
 
     # copy .NET dependencies
-    cp "$smapiBin/System.Configuration.ConfigurationManager.dll" "$bundlePath/smapi-internal"
-    cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
-    cp "$smapiBin/System.Security.Permissions.dll" "$bundlePath/smapi-internal"
     if ($folder -eq "windows") {
         cp "$smapiBin/System.Management.dll" "$bundlePath/smapi-internal"
     }
diff --git a/docs/release-notes.md b/docs/release-notes.md
index cdc0f548..31f6edc2 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,8 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Optimized reflection cache to reduce frame skips for some players.
 * For mod authors:
   * Removed `runtimeconfig.json` setting which impacted hot reload support.
 
diff --git a/src/SMAPI/Framework/Reflection/CacheEntry.cs b/src/SMAPI/Framework/Reflection/CacheEntry.cs
deleted file mode 100644
index 27f48a1f..00000000
--- a/src/SMAPI/Framework/Reflection/CacheEntry.cs
+++ /dev/null
@@ -1,30 +0,0 @@
-using System.Diagnostics.CodeAnalysis;
-using System.Reflection;
-
-namespace StardewModdingAPI.Framework.Reflection
-{
-    /// <summary>A cached member reflection result.</summary>
-    internal readonly struct CacheEntry
-    {
-        /*********
-        ** Accessors
-        *********/
-        /// <summary>Whether the lookup found a valid match.</summary>
-        [MemberNotNullWhen(true, nameof(CacheEntry.MemberInfo))]
-        public bool IsValid => this.MemberInfo != null;
-
-        /// <summary>The reflection data for this member (or <c>null</c> if invalid).</summary>
-        public MemberInfo? MemberInfo { get; }
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="memberInfo">The reflection data for this member (or <c>null</c> if invalid).</param>
-        public CacheEntry(MemberInfo? memberInfo)
-        {
-            this.MemberInfo = memberInfo;
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/Reflection/Reflector.cs b/src/SMAPI/Framework/Reflection/Reflector.cs
index 79575c26..502a8519 100644
--- a/src/SMAPI/Framework/Reflection/Reflector.cs
+++ b/src/SMAPI/Framework/Reflection/Reflector.cs
@@ -1,6 +1,6 @@
 using System;
 using System.Reflection;
-using System.Runtime.Caching;
+using StardewModdingAPI.Framework.Utilities;
 
 namespace StardewModdingAPI.Framework.Reflection
 {
@@ -12,10 +12,7 @@ namespace StardewModdingAPI.Framework.Reflection
         ** Fields
         *********/
         /// <summary>The cached fields and methods found via reflection.</summary>
-        private readonly MemoryCache Cache = new(typeof(Reflector).FullName!);
-
-        /// <summary>The sliding cache expiration time.</summary>
-        private readonly TimeSpan SlidingCacheExpiry = TimeSpan.FromMinutes(5);
+        private readonly IntervalMemoryCache<string, MemberInfo?> Cache = new();
 
 
         /*********
@@ -136,6 +133,15 @@ namespace StardewModdingAPI.Framework.Reflection
             return method!;
         }
 
+        /****
+        ** Management
+        ****/
+        /// <summary>Start a new cache interval, clearing stale reflection lookups.</summary>
+        public void NewCacheInterval()
+        {
+            this.Cache.StartNewInterval();
+        }
+
 
         /*********
         ** Private methods
@@ -149,20 +155,23 @@ namespace StardewModdingAPI.Framework.Reflection
         private IReflectedField<TValue>? GetFieldFromHierarchy<TValue>(Type type, object? obj, string name, BindingFlags bindingFlags)
         {
             bool isStatic = bindingFlags.HasFlag(BindingFlags.Static);
-            FieldInfo? field = this.GetCached($"field::{isStatic}::{type.FullName}::{name}", () =>
-            {
-                for (Type? curType = type; curType != null; curType = curType.BaseType)
+            FieldInfo? field = this.GetCached(
+                'f', type, name, isStatic,
+                fetch: () =>
                 {
-                    FieldInfo? fieldInfo = curType.GetField(name, bindingFlags);
-                    if (fieldInfo != null)
+                    for (Type? curType = type; curType != null; curType = curType.BaseType)
                     {
-                        type = curType;
-                        return fieldInfo;
+                        FieldInfo? fieldInfo = curType.GetField(name, bindingFlags);
+                        if (fieldInfo != null)
+                        {
+                            type = curType;
+                            return fieldInfo;
+                        }
                     }
-                }
 
-                return null;
-            });
+                    return null;
+                }
+            );
 
             return field != null
                 ? new ReflectedField<TValue>(type, obj, field, isStatic)
@@ -178,20 +187,23 @@ namespace StardewModdingAPI.Framework.Reflection
         private IReflectedProperty<TValue>? GetPropertyFromHierarchy<TValue>(Type type, object? obj, string name, BindingFlags bindingFlags)
         {
             bool isStatic = bindingFlags.HasFlag(BindingFlags.Static);
-            PropertyInfo? property = this.GetCached<PropertyInfo>($"property::{isStatic}::{type.FullName}::{name}", () =>
-            {
-                for (Type? curType = type; curType != null; curType = curType.BaseType)
+            PropertyInfo? property = this.GetCached(
+                'p', type, name, isStatic,
+                fetch: () =>
                 {
-                    PropertyInfo? propertyInfo = curType.GetProperty(name, bindingFlags);
-                    if (propertyInfo != null)
+                    for (Type? curType = type; curType != null; curType = curType.BaseType)
                     {
-                        type = curType;
-                        return propertyInfo;
+                        PropertyInfo? propertyInfo = curType.GetProperty(name, bindingFlags);
+                        if (propertyInfo != null)
+                        {
+                            type = curType;
+                            return propertyInfo;
+                        }
                     }
-                }
 
-                return null;
-            });
+                    return null;
+                }
+            );
 
             return property != null
                 ? new ReflectedProperty<TValue>(type, obj, property, isStatic)
@@ -206,47 +218,41 @@ namespace StardewModdingAPI.Framework.Reflection
         private IReflectedMethod? GetMethodFromHierarchy(Type type, object? obj, string name, BindingFlags bindingFlags)
         {
             bool isStatic = bindingFlags.HasFlag(BindingFlags.Static);
-            MethodInfo? method = this.GetCached($"method::{isStatic}::{type.FullName}::{name}", () =>
-            {
-                for (Type? curType = type; curType != null; curType = curType.BaseType)
+            MethodInfo? method = this.GetCached(
+                'm', type, name, isStatic,
+                fetch: () =>
                 {
-                    MethodInfo? methodInfo = curType.GetMethod(name, bindingFlags);
-                    if (methodInfo != null)
+                    for (Type? curType = type; curType != null; curType = curType.BaseType)
                     {
-                        type = curType;
-                        return methodInfo;
+                        MethodInfo? methodInfo = curType.GetMethod(name, bindingFlags);
+                        if (methodInfo != null)
+                        {
+                            type = curType;
+                            return methodInfo;
+                        }
                     }
-                }
 
-                return null;
-            });
+                    return null;
+                }
+            );
 
             return method != null
-                ? new ReflectedMethod(type, obj, method, isStatic: bindingFlags.HasFlag(BindingFlags.Static))
+                ? new ReflectedMethod(type, obj, method, isStatic: isStatic)
                 : null;
         }
 
         /// <summary>Get a method or field through the cache.</summary>
         /// <typeparam name="TMemberInfo">The expected <see cref="MemberInfo"/> type.</typeparam>
-        /// <param name="key">The cache key.</param>
+        /// <param name="memberType">A letter representing the member type (like 'm' for method).</param>
+        /// <param name="type">The type whose members are being reflected.</param>
+        /// <param name="memberName">The member name.</param>
+        /// <param name="isStatic">Whether the member is static.</param>
         /// <param name="fetch">Fetches a new value to cache.</param>
-        private TMemberInfo? GetCached<TMemberInfo>(string key, Func<TMemberInfo?> fetch)
+        private TMemberInfo? GetCached<TMemberInfo>(char memberType, Type type, string memberName, bool isStatic, Func<TMemberInfo?> fetch)
             where TMemberInfo : MemberInfo
         {
-            // get from cache
-            if (this.Cache.Contains(key))
-            {
-                CacheEntry entry = (CacheEntry)this.Cache[key];
-                return entry.IsValid
-                    ? (TMemberInfo)entry.MemberInfo
-                    : default;
-            }
-
-            // fetch & cache new value
-            TMemberInfo? result = fetch();
-            CacheEntry cacheEntry = new(result);
-            this.Cache.Add(key, cacheEntry, new CacheItemPolicy { SlidingExpiration = this.SlidingCacheExpiry });
-            return result;
+            string key = $"{memberType}{(isStatic ? 's' : 'i')}{type.FullName}:{memberName}";
+            return (TMemberInfo?)this.Cache.GetOrSet(key, fetch);
         }
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 67f78400..c453562f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1164,6 +1164,8 @@ namespace StardewModdingAPI.Framework
         protected void OnNewDayAfterFade()
         {
             this.EventManager.DayEnding.RaiseEmpty();
+
+            this.Reflection.NewCacheInterval();
         }
 
         /// <summary>A callback invoked after an asset is fully loaded through a content manager.</summary>
diff --git a/src/SMAPI/Framework/Utilities/IntervalMemoryCache.cs b/src/SMAPI/Framework/Utilities/IntervalMemoryCache.cs
new file mode 100644
index 00000000..d2b69f51
--- /dev/null
+++ b/src/SMAPI/Framework/Utilities/IntervalMemoryCache.cs
@@ -0,0 +1,57 @@
+using System;
+using System.Collections.Generic;
+
+namespace StardewModdingAPI.Framework.Utilities
+{
+    /// <summary>A memory cache with sliding expiry based on custom intervals, with no background processing.</summary>
+    /// <typeparam name="TKey">The cache key type.</typeparam>
+    /// <typeparam name="TValue">The cache value type.</typeparam>
+    /// <remarks>This is optimized for small caches that are reset relatively rarely. Each cache entry is marked as hot (accessed since the interval started) or stale.
+    /// When a new interval is started, stale entries are cleared and hot entries become stale.</remarks>
+    internal class IntervalMemoryCache<TKey, TValue>
+        where TKey : notnull
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The cached values that were accessed during the current interval.</summary>
+        private Dictionary<TKey, TValue> HotCache = new();
+
+        /// <summary>The cached values that will expire on the next interval.</summary>
+        private Dictionary<TKey, TValue> StaleCache = new();
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Get a value from the cache, fetching it first if needed.</summary>
+        /// <param name="cacheKey">The unique key for the cached value.</param>
+        /// <param name="get">Get the latest data if it's not in the cache yet.</param>
+        public TValue GetOrSet(TKey cacheKey, Func<TValue> get)
+        {
+            // from hot cache
+            if (this.HotCache.TryGetValue(cacheKey, out TValue? value))
+                return value;
+
+            // from stale cache
+            if (this.StaleCache.TryGetValue(cacheKey, out value))
+            {
+                this.HotCache[cacheKey] = value;
+                return value;
+            }
+
+            // new value
+            value = get();
+            this.HotCache[cacheKey] = value;
+            return value;
+        }
+
+        /// <summary>Start a new cache interval, removing any stale entries.</summary>
+        public void StartNewInterval()
+        {
+            this.StaleCache.Clear();
+            if (this.HotCache.Count is not 0)
+                (this.StaleCache, this.HotCache) = (this.HotCache, this.StaleCache); // swap hot cache to stale
+        }
+    }
+}
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 27044679..95249bfd 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -28,7 +28,6 @@
     <PackageReference Include="Pintail" Version="2.1.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
-    <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />
   </ItemGroup>
 
   <ItemGroup>

From bf960ce283d794a11885a5fde6f123a4e6827853 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 31 May 2022 21:23:44 -0400
Subject: [PATCH 658/856] add backwards compatibility for mods using now-unused
 dependencies

---
 build/common.targets                          |  5 ++
 build/unix/prepare-install-package.sh         |  5 ++
 build/windows/prepare-install-package.ps1     |  5 ++
 .../Framework/ModData/ModWarning.cs           | 11 ++++-
 src/SMAPI/Framework/IModMetadata.cs           |  4 ++
 .../Framework/ModLoading/AssemblyLoader.cs    | 38 ++++++++++++++
 .../Finders/LegacyAssemblyFinder.cs           | 49 +++++++++++++++++++
 .../ModLoading/InstructionHandleResult.cs     | 11 ++++-
 src/SMAPI/Framework/ModLoading/ModMetadata.cs |  7 +++
 src/SMAPI/Framework/SCore.cs                  | 25 ++++++++++
 src/SMAPI/Metadata/InstructionMetadata.cs     |  3 ++
 src/SMAPI/SMAPI.csproj                        |  3 ++
 12 files changed, 164 insertions(+), 2 deletions(-)
 create mode 100644 src/SMAPI/Framework/ModLoading/Finders/LegacyAssemblyFinder.cs

diff --git a/build/common.targets b/build/common.targets
index b2441af8..10b94d7e 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -70,6 +70,11 @@
 
     <!-- .NET dependencies -->
     <Copy SourceFiles="$(TargetDir)\System.Management.dll" DestinationFolder="$(GamePath)\smapi-internal" Condition="$(OS) == 'Windows_NT'" />
+
+    <!-- Legacy .NET dependencies (remove in SMAPI 4.0.0) -->
+    <Copy SourceFiles="$(TargetDir)\System.Configuration.ConfigurationManager.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\System.Runtime.Caching.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\System.Security.Permissions.dll" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
 
   <Target Name="CopyDefaultMods" Condition="'$(MSBuildProjectName)' == 'SMAPI.Mods.ConsoleCommands' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.ErrorHandler' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.SaveBackup'">
diff --git a/build/unix/prepare-install-package.sh b/build/unix/prepare-install-package.sh
index 01c3a0ec..01cd2080 100755
--- a/build/unix/prepare-install-package.sh
+++ b/build/unix/prepare-install-package.sh
@@ -151,6 +151,11 @@ for folder in ${folders[@]}; do
         cp "$smapiBin/System.Management.dll" "$bundlePath/smapi-internal"
     fi
 
+    # copy legacy .NET dependencies (remove in SMAPI 4.0.0)
+    cp "$smapiBin/System.Configuration.ConfigurationManager.dll" "$bundlePath/smapi-internal"
+    cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
+    cp "$smapiBin/System.Security.Permissions.dll" "$bundlePath/smapi-internal"
+
     # copy bundled mods
     for modName in ${bundleModNames[@]}; do
         fromPath="src/SMAPI.Mods.$modName/bin/$buildConfig/$runtime/publish"
diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index 6731486b..7e3c6c86 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -172,6 +172,11 @@ foreach ($folder in $folders) {
         cp "$smapiBin/System.Management.dll" "$bundlePath/smapi-internal"
     }
 
+    # copy legacy .NET dependencies (remove in SMAPI 4.0.0)
+    cp "$smapiBin/System.Configuration.ConfigurationManager.dll" "$bundlePath/smapi-internal"
+    cp "$smapiBin/System.Runtime.Caching.dll" "$bundlePath/smapi-internal"
+    cp "$smapiBin/System.Security.Permissions.dll" "$bundlePath/smapi-internal"
+
     # copy bundled mods
     foreach ($modName in $bundleModNames) {
         $fromPath = "src/SMAPI.Mods.$modName/bin/$buildConfig/$runtime/publish"
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
index cf804df4..32c2ed6d 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
@@ -35,6 +35,15 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         AccessesFilesystem = 128,
 
         /// <summary>Uses .NET APIs for shell or process access.</summary>
-        AccessesShell = 256
+        AccessesShell = 256,
+
+        /// <summary>References the legacy <c>System.Configuration.ConfigurationManager</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
+        DetectedLegacyConfigurationDll = 512,
+
+        /// <summary>References the legacy <c>System.Runtime.Caching</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
+        DetectedLegacyCachingDll = 1024,
+
+        /// <summary>References the legacy <c>System.Security.Permissions</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
+        DetectedLegacyPermissionsDll = 2048
     }
 }
diff --git a/src/SMAPI/Framework/IModMetadata.cs b/src/SMAPI/Framework/IModMetadata.cs
index 7cee20b9..be25c070 100644
--- a/src/SMAPI/Framework/IModMetadata.cs
+++ b/src/SMAPI/Framework/IModMetadata.cs
@@ -88,6 +88,10 @@ namespace StardewModdingAPI.Framework
         /// <param name="warning">The warning to set.</param>
         IModMetadata SetWarning(ModWarning warning);
 
+        /// <summary>Remove a warning flag for the mod.</summary>
+        /// <param name="warning">The warning to remove.</param>
+        IModMetadata RemoveWarning(ModWarning warning);
+
         /// <summary>Set the mod instance.</summary>
         /// <param name="mod">The mod instance to set.</param>
         /// <param name="translations">The translations for this mod (if loaded).</param>
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index fb5ebc01..e5aaa8ee 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -163,6 +163,29 @@ namespace StardewModdingAPI.Framework.ModLoading
                 this.AssemblyDefinitionResolver.Add(assembly.Definition);
             }
 
+            // special case: clear legacy-DLL warnings if the mod bundles a copy
+            if (mod.Warnings.HasFlag(ModWarning.DetectedLegacyCachingDll))
+            {
+                if (File.Exists(Path.Combine(mod.DirectoryPath, "System.Runtime.Caching.dll")))
+                    mod.RemoveWarning(ModWarning.DetectedLegacyCachingDll);
+                else
+                {
+                    // remove duplicate warnings (System.Runtime.Caching.dll references these)
+                    mod.RemoveWarning(ModWarning.DetectedLegacyConfigurationDll);
+                    mod.RemoveWarning(ModWarning.DetectedLegacyPermissionsDll);
+                }
+            }
+            if (mod.Warnings.HasFlag(ModWarning.DetectedLegacyConfigurationDll))
+            {
+                if (File.Exists(Path.Combine(mod.DirectoryPath, "System.Configuration.ConfigurationManager.dll")))
+                    mod.RemoveWarning(ModWarning.DetectedLegacyConfigurationDll);
+            }
+            if (mod.Warnings.HasFlag(ModWarning.DetectedLegacyPermissionsDll))
+            {
+                if (File.Exists(Path.Combine(mod.DirectoryPath, "System.Security.Permissions.dll")))
+                    mod.RemoveWarning(ModWarning.DetectedLegacyPermissionsDll);
+            }
+
             // throw if incompatibilities detected
             if (!assumeCompatible && mod.Warnings.HasFlag(ModWarning.BrokenCodeLoaded))
                 throw new IncompatibleInstructionException();
@@ -429,6 +452,21 @@ namespace StardewModdingAPI.Framework.ModLoading
                     mod.SetWarning(ModWarning.AccessesShell);
                     break;
 
+                case InstructionHandleResult.DetectedLegacyCachingDll:
+                    template = $"{logPrefix}Detected reference to System.Runtime.Caching.dll, which will be removed in SMAPI 4.0.0.";
+                    mod.SetWarning(ModWarning.DetectedLegacyCachingDll);
+                    break;
+
+                case InstructionHandleResult.DetectedLegacyConfigurationDll:
+                    template = $"{logPrefix}Detected reference to System.Configuration.ConfigurationManager.dll, which will be removed in SMAPI 4.0.0.";
+                    mod.SetWarning(ModWarning.DetectedLegacyConfigurationDll);
+                    break;
+
+                case InstructionHandleResult.DetectedLegacyPermissionsDll:
+                    template = $"{logPrefix}Detected reference to System.Security.Permissions.dll, which will be removed in SMAPI 4.0.0.";
+                    mod.SetWarning(ModWarning.DetectedLegacyPermissionsDll);
+                    break;
+
                 case InstructionHandleResult.None:
                     break;
 
diff --git a/src/SMAPI/Framework/ModLoading/Finders/LegacyAssemblyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/LegacyAssemblyFinder.cs
new file mode 100644
index 00000000..d3437b05
--- /dev/null
+++ b/src/SMAPI/Framework/ModLoading/Finders/LegacyAssemblyFinder.cs
@@ -0,0 +1,49 @@
+using Mono.Cecil;
+using StardewModdingAPI.Framework.ModLoading.Framework;
+
+namespace StardewModdingAPI.Framework.ModLoading.Finders
+{
+    /// <summary>Detects assembly references which will break in SMAPI 4.0.0.</summary>
+    internal class LegacyAssemblyFinder : BaseInstructionHandler
+    {
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        public LegacyAssemblyFinder()
+            : base(defaultPhrase: "legacy assembly references") { }
+
+
+        /// <inheritdoc />
+        public override bool Handle(ModuleDefinition module)
+        {
+            foreach (AssemblyNameReference assembly in module.AssemblyReferences)
+            {
+                InstructionHandleResult flag = this.GetFlag(assembly);
+                if (flag is InstructionHandleResult.None)
+                    continue;
+
+                this.MarkFlag(flag);
+            }
+
+            return false;
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get the instruction handle flag for the given assembly reference, if any.</summary>
+        /// <param name="assemblyRef">The assembly reference.</param>
+        private InstructionHandleResult GetFlag(AssemblyNameReference assemblyRef)
+        {
+            return assemblyRef.Name switch
+            {
+                "System.Configuration.ConfigurationManager" => InstructionHandleResult.DetectedLegacyConfigurationDll,
+                "System.Runtime.Caching" => InstructionHandleResult.DetectedLegacyCachingDll,
+                "System.Security.Permission" => InstructionHandleResult.DetectedLegacyPermissionsDll,
+                _ => InstructionHandleResult.None
+            };
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs b/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
index e3f108cb..476c30d0 100644
--- a/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
+++ b/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
@@ -30,6 +30,15 @@ namespace StardewModdingAPI.Framework.ModLoading
         DetectedFilesystemAccess,
 
         /// <summary>The instruction accesses the OS shell or processes directly.</summary>
-        DetectedShellAccess
+        DetectedShellAccess,
+
+        /// <summary>The module references the legacy <c>System.Configuration.ConfigurationManager</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
+        DetectedLegacyConfigurationDll,
+
+        /// <summary>The module references the legacy <c>System.Runtime.Caching</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
+        DetectedLegacyCachingDll,
+
+        /// <summary>The module references the legacy <c>System.Security.Permissions</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
+        DetectedLegacyPermissionsDll
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index fe54634b..aa4d2d8c 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -138,6 +138,13 @@ namespace StardewModdingAPI.Framework.ModLoading
             return this;
         }
 
+        /// <inheritdoc />
+        public IModMetadata RemoveWarning(ModWarning warning)
+        {
+            this.ActualWarnings &= ~warning;
+            return this;
+        }
+
         /// <inheritdoc />
         public IModMetadata SetMod(IMod mod, TranslationHelper translations)
         {
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c453562f..731731d4 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1679,6 +1679,31 @@ namespace StardewModdingAPI.Framework
                 }
 #pragma warning restore CS0612, CS0618
 
+                // log deprecation warnings
+                if (metadata.HasWarnings(ModWarning.DetectedLegacyCachingDll, ModWarning.DetectedLegacyConfigurationDll, ModWarning.DetectedLegacyPermissionsDll))
+                {
+                    string?[] referenced =
+                        new[]
+                        {
+                            metadata.Warnings.HasFlag(ModWarning.DetectedLegacyConfigurationDll) ? "System.Configuration.ConfigurationManager" : null,
+                            metadata.Warnings.HasFlag(ModWarning.DetectedLegacyCachingDll) ? "System.Runtime.Caching" : null,
+                            metadata.Warnings.HasFlag(ModWarning.DetectedLegacyPermissionsDll) ? "System.Security.Permissions" : null
+                        }
+                        .Where(p => p is not null)
+                        .ToArray();
+
+                    foreach (string? name in referenced)
+                    {
+                        DeprecationManager.Warn(
+                            metadata,
+                            $"using {name} without bundling it",
+                            "3.14.7",
+                            DeprecationLevel.Notice,
+                            logStackTrace: false
+                        );
+                    }
+                }
+
                 // call entry method
                 Context.HeuristicModsRunningCode.Push(metadata);
                 try
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index 4d512546..dce0c6b1 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -53,6 +53,9 @@ namespace StardewModdingAPI.Metadata
 
                 // detect Harmony & rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
                 yield return new HarmonyRewriter();
+
+                // detect issues for SMAPI 4.0.0
+                yield return new LegacyAssemblyFinder();
             }
             else
                 yield return new HarmonyRewriter(shouldRewrite: false);
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 95249bfd..a0ca54cc 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -28,6 +28,9 @@
     <PackageReference Include="Pintail" Version="2.1.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
+
+    <!-- legacy package; remove in SMAPI 4.0.0 -->
+    <PackageReference Include="System.Runtime.Caching" Version="5.0.0" />
   </ItemGroup>
 
   <ItemGroup>

From 1cded44f7a5626a0d4f5c3ce48a83aa544d517c3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 1 Jun 2022 19:58:35 -0400
Subject: [PATCH 659/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 10b94d7e..ca9a1d12 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.14.6</Version>
+    <Version>3.14.7</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 31f6edc2..d8cfa350 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,7 +1,9 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
+## 3.14.7
+Released 01 June 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
   * Optimized reflection cache to reduce frame skips for some players.
 * For mod authors:
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 9d9a8061..564e480e 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.14.6",
+    "Version": "3.14.7",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.14.6"
+    "MinimumApiVersion": "3.14.7"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 07c2512b..39d22b5f 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.14.6",
+    "Version": "3.14.7",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.14.6"
+    "MinimumApiVersion": "3.14.7"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index ec048dea..8eaf2475 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.14.6",
+    "Version": "3.14.7",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.14.6"
+    "MinimumApiVersion": "3.14.7"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 9212fc90..c63324e3 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.14.6";
+        internal static string RawApiVersion = "3.14.7";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From fdb74df8a4c899b81009c7e04659be9007545788 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 6 Jun 2022 21:28:57 -0400
Subject: [PATCH 660/856] simplify repeated hash set creation

---
 src/SMAPI/Framework/Models/SConfig.cs | 7 +++----
 src/SMAPI/Framework/SCore.cs          | 4 ++--
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 1c7cd3ed..316f7ac3 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -76,7 +76,7 @@ namespace StardewModdingAPI.Framework.Models
         public ColorSchemeConfig ConsoleColors { get; }
 
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
-        public string[] SuppressUpdateChecks { get; }
+        public HashSet<string> SuppressUpdateChecks { get; }
 
 
         /********
@@ -110,7 +110,7 @@ namespace StardewModdingAPI.Framework.Models
             this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(this.UseCaseInsensitivePaths)];
             this.LogNetworkTraffic = logNetworkTraffic ?? (bool)SConfig.DefaultValues[nameof(this.LogNetworkTraffic)];
             this.ConsoleColors = consoleColors;
-            this.SuppressUpdateChecks = suppressUpdateChecks ?? Array.Empty<string>();
+            this.SuppressUpdateChecks = new HashSet<string>(suppressUpdateChecks ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
         }
 
         /// <summary>Override the value of <see cref="DeveloperMode"/>.</summary>
@@ -132,8 +132,7 @@ namespace StardewModdingAPI.Framework.Models
                     custom[name] = value;
             }
 
-            HashSet<string> curSuppressUpdateChecks = new(this.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
-            if (SConfig.DefaultSuppressUpdateChecks.Count != curSuppressUpdateChecks.Count || SConfig.DefaultSuppressUpdateChecks.Any(p => !curSuppressUpdateChecks.Contains(p)))
+            if (!this.SuppressUpdateChecks.SetEquals(SConfig.DefaultSuppressUpdateChecks))
                 custom[nameof(this.SuppressUpdateChecks)] = "[" + string.Join(", ", this.SuppressUpdateChecks) + "]";
 
             return custom;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 731731d4..fa217f20 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1507,7 +1507,7 @@ namespace StardewModdingAPI.Framework
                 {
                     try
                     {
-                        HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
+                        HashSet<string> suppressUpdateChecks = this.Settings.SuppressUpdateChecks;
 
                         // prepare search model
                         List<ModSearchEntryModel> searchMods = new List<ModSearchEntryModel>();
@@ -1608,7 +1608,7 @@ namespace StardewModdingAPI.Framework
             using (AssemblyLoader modAssemblyLoader = new(Constants.Platform, this.Monitor, this.Settings.ParanoidWarnings, this.Settings.RewriteMods))
             {
                 // init
-                HashSet<string> suppressUpdateChecks = new HashSet<string>(this.Settings.SuppressUpdateChecks, StringComparer.OrdinalIgnoreCase);
+                HashSet<string> suppressUpdateChecks = this.Settings.SuppressUpdateChecks;
                 IInterfaceProxyFactory proxyFactory = this.Settings.UsePintail
                     ? new InterfaceProxyFactory()
                     : new OriginalInterfaceProxyFactory();

From 8713914a1af3b5ac7e4a2cdce7e084055ac9cd33 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 8 Jun 2022 23:33:09 -0400
Subject: [PATCH 661/856] avoid NPC pathfinding rebuild if reachable locations
 didn't change

---
 docs/release-notes.md                     |  5 +++++
 src/SMAPI/Framework/ContentCoordinator.cs |  6 +++---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 26 +++++++++++------------
 3 files changed, 21 insertions(+), 16 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index d8cfa350..b7605bf6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,11 +1,16 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For mod authors:
+  * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
+
 ## 3.14.7
 Released 01 June 2022 for Stardew Valley 1.5.6 or later.
 
 * For players:
   * Optimized reflection cache to reduce frame skips for some players.
+
 * For mod authors:
   * Removed `runtimeconfig.json` setting which impacted hot reload support.
 
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index cfeb35c8..69a39ac7 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -465,7 +465,7 @@ namespace StardewModdingAPI.Framework
                     assets: invalidatedAssets.ToDictionary(p => p.Key, p => p.Value),
                     ignoreWorld: Context.IsWorldFullyUnloaded,
                     out IDictionary<IAssetName, bool> propagated,
-                    out bool updatedNpcWarps
+                    out bool updatedWarpRoutes
                 );
 
                 // log summary
@@ -481,8 +481,8 @@ namespace StardewModdingAPI.Framework
                         ? $"Propagated {propagatedKeys.Length} core assets ({FormatKeyList(propagatedKeys)})."
                         : "Propagated 0 core assets."
                     );
-                    if (updatedNpcWarps)
-                        report.AppendLine("Updated NPC pathfinding cache.");
+                    if (updatedWarpRoutes)
+                        report.AppendLine("Updated NPC warp route cache.");
                 }
                 this.Monitor.Log(report.ToString().TrimEnd());
             }
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 8ed6b591..b783b2b9 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -85,8 +85,8 @@ namespace StardewModdingAPI.Metadata
         /// <param name="assets">The asset keys and types to reload.</param>
         /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
         /// <param name="propagatedAssets">A lookup of asset names to whether they've been propagated.</param>
-        /// <param name="updatedNpcWarps">Whether the NPC pathfinding cache was reloaded.</param>
-        public void Propagate(IDictionary<IAssetName, Type> assets, bool ignoreWorld, out IDictionary<IAssetName, bool> propagatedAssets, out bool updatedNpcWarps)
+        /// <param name="changedWarpRoutes">Whether the NPC pathfinding warp route cache was reloaded.</param>
+        public void Propagate(IDictionary<IAssetName, Type> assets, bool ignoreWorld, out IDictionary<IAssetName, bool> propagatedAssets, out bool changedWarpRoutes)
         {
             // get base name lookup
             propagatedAssets = assets
@@ -107,7 +107,7 @@ namespace StardewModdingAPI.Metadata
             });
 
             // reload assets
-            updatedNpcWarps = false;
+            changedWarpRoutes = false;
             foreach (var bucket in buckets)
             {
                 switch (bucket.Key)
@@ -126,10 +126,10 @@ namespace StardewModdingAPI.Metadata
                         foreach (var entry in bucket)
                         {
                             bool changed = false;
-                            bool curChangedMapWarps = false;
+                            bool curChangedMapRoutes = false;
                             try
                             {
-                                changed = this.PropagateOther(entry.Key, entry.Value, ignoreWorld, out curChangedMapWarps);
+                                changed = this.PropagateOther(entry.Key, entry.Value, ignoreWorld, out curChangedMapRoutes);
                             }
                             catch (Exception ex)
                             {
@@ -137,14 +137,14 @@ namespace StardewModdingAPI.Metadata
                             }
 
                             propagatedAssets[entry.Key] = changed;
-                            updatedNpcWarps = updatedNpcWarps || curChangedMapWarps;
+                            changedWarpRoutes = changedWarpRoutes || curChangedMapRoutes;
                         }
                         break;
                 }
             }
 
-            // reload NPC pathfinding cache if any map changed
-            if (updatedNpcWarps)
+            // reload NPC pathfinding cache if any map routes changed
+            if (changedWarpRoutes)
                 NPC.populateRoutesFromLocationToLocationList();
         }
 
@@ -156,14 +156,14 @@ namespace StardewModdingAPI.Metadata
         /// <param name="assetName">The asset name to reload.</param>
         /// <param name="type">The asset type to reload.</param>
         /// <param name="ignoreWorld">Whether the in-game world is fully unloaded (e.g. on the title screen), so there's no need to propagate changes into the world.</param>
-        /// <param name="changedWarps">Whether any map warps were changed as part of this propagation.</param>
+        /// <param name="changedWarpRoutes">Whether the locations reachable by warps from this location changed as part of this propagation.</param>
         /// <returns>Returns whether an asset was loaded. The return value may be true or false, or a non-null value for true.</returns>
         [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "These deliberately match the asset names.")]
-        private bool PropagateOther(IAssetName assetName, Type type, bool ignoreWorld, out bool changedWarps)
+        private bool PropagateOther(IAssetName assetName, Type type, bool ignoreWorld, out bool changedWarpRoutes)
         {
             var content = this.MainContentManager;
             string key = assetName.BaseName;
-            changedWarps = false;
+            changedWarpRoutes = false;
 
             /****
             ** Special case: current map tilesheet
@@ -197,7 +197,7 @@ namespace StardewModdingAPI.Metadata
                             static ISet<string> GetWarpSet(GameLocation location)
                             {
                                 return new HashSet<string>(
-                                    location.warps.Select(p => $"{p.X} {p.Y} {p.TargetName} {p.TargetX} {p.TargetY}")
+                                    location.warps.Select(p => p.TargetName)
                                 );
                             }
 
@@ -205,7 +205,7 @@ namespace StardewModdingAPI.Metadata
                             this.UpdateMap(info);
                             var newWarps = GetWarpSet(location);
 
-                            changedWarps = changedWarps || oldWarps.Count != newWarps.Count || oldWarps.Any(p => !newWarps.Contains(p));
+                            changedWarpRoutes = changedWarpRoutes || oldWarps.Count != newWarps.Count || oldWarps.Any(p => !newWarps.Contains(p));
                             anyChanged = true;
                         }
                     }

From cb6fcb0450da28607e1a7307f5638cccbd6ce9f7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 6 Jun 2022 21:46:21 -0400
Subject: [PATCH 662/856] rework VerboseLogging option to allow enabling for
 specific mods

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Framework/Logging/LogManager.cs | 19 ++++++++++---------
 src/SMAPI/Framework/Models/SConfig.cs     | 17 ++++++++++-------
 src/SMAPI/Framework/SCore.cs              |  8 ++++----
 src/SMAPI/SMAPI.config.json               | 12 ++++++++++--
 5 files changed, 35 insertions(+), 22 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b7605bf6..e1aa47ab 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,6 +4,7 @@
 ## Upcoming release
 * For mod authors:
   * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
+  * In `smapi-internal/config.json`, you can now enable verbose logging for specific mods (instead of all or nothing).
 
 ## 3.14.7
 Released 01 June 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index ed5b6959..d811ed5c 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -31,8 +31,8 @@ namespace StardewModdingAPI.Framework.Logging
         /// <summary>Prefixing a low-level message with this character indicates that the console interceptor should write the string without intercepting it. (The character itself is not written.)</summary>
         private const char IgnoreChar = InterceptingTextWriter.IgnoreChar;
 
-        /// <summary>Get a named monitor instance.</summary>
-        private readonly Func<string, Monitor> GetMonitorImpl;
+        /// <summary>Create a monitor instance given the ID and name.</summary>
+        private readonly Func<string, string, Monitor> GetMonitorImpl;
 
         /// <summary>Regex patterns which match console non-error messages to suppress from the console and log.</summary>
         private readonly Regex[] SuppressConsolePatterns =
@@ -88,23 +88,23 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="logPath">The log file path to write.</param>
         /// <param name="colorConfig">The colors to use for text written to the SMAPI console.</param>
         /// <param name="writeToConsole">Whether to output log messages to the console.</param>
-        /// <param name="isVerbose">Whether verbose logging is enabled. This enables more detailed diagnostic messages than are normally needed.</param>
+        /// <param name="verboseLogging">The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</param>
         /// <param name="isDeveloperMode">Whether to enable full console output for developers.</param>
         /// <param name="getScreenIdForLog">Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</param>
-        public LogManager(string logPath, ColorSchemeConfig colorConfig, bool writeToConsole, bool isVerbose, bool isDeveloperMode, Func<int?> getScreenIdForLog)
+        public LogManager(string logPath, ColorSchemeConfig colorConfig, bool writeToConsole, HashSet<string> verboseLogging, bool isDeveloperMode, Func<int?> getScreenIdForLog)
         {
             // init log file
             this.LogFile = new LogFileManager(logPath);
 
             // init monitor
-            this.GetMonitorImpl = name => new Monitor(name, LogManager.IgnoreChar, this.LogFile, colorConfig, isVerbose, getScreenIdForLog)
+            this.GetMonitorImpl = (id, name) => new Monitor(name, LogManager.IgnoreChar, this.LogFile, colorConfig, verboseLogging.Contains("*") || verboseLogging.Contains(id), getScreenIdForLog)
             {
                 WriteToConsole = writeToConsole,
                 ShowTraceInConsole = isDeveloperMode,
                 ShowFullStampInConsole = isDeveloperMode
             };
-            this.Monitor = this.GetMonitor("SMAPI");
-            this.MonitorForGame = this.GetMonitor("game");
+            this.Monitor = this.GetMonitor("SMAPI", "SMAPI");
+            this.MonitorForGame = this.GetMonitor("game", "game");
 
             // redirect direct console output
             this.ConsoleInterceptor = new InterceptingTextWriter(
@@ -124,10 +124,11 @@ namespace StardewModdingAPI.Framework.Logging
         }
 
         /// <summary>Get a monitor instance derived from SMAPI's current settings.</summary>
+        /// <param name="id">The unique ID for the mod context.</param>
         /// <param name="name">The name of the module which will log messages with this instance.</param>
-        public Monitor GetMonitor(string name)
+        public Monitor GetMonitor(string id, string name)
         {
-            return this.GetMonitorImpl(name);
+            return this.GetMonitorImpl(id, name);
         }
 
         /// <summary>Set the title of the SMAPI console window.</summary>
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 316f7ac3..240af002 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -20,7 +20,6 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(UseBetaChannel)] = Constants.ApiVersion.IsPrerelease(),
             [nameof(GitHubProjectName)] = "Pathoschild/SMAPI",
             [nameof(WebApiBaseUrl)] = "https://smapi.io/api/",
-            [nameof(VerboseLogging)] = false,
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
             [nameof(UsePintail)] = true,
@@ -57,8 +56,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>The base URL for SMAPI's web API, used to perform update checks.</summary>
         public string WebApiBaseUrl { get; }
 
-        /// <summary>Whether SMAPI should log more information about the game context.</summary>
-        public bool VerboseLogging { get; }
+        /// <summary>The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</summary>
+        /// <remarks>The possible values are "*" (everything is verbose), "SMAPI", (SMAPI itself), or mod IDs.</remarks>
+        public HashSet<string> VerboseLogging { get; }
 
         /// <summary>Whether SMAPI should rewrite mods for compatibility.</summary>
         public bool RewriteMods { get; }
@@ -89,14 +89,14 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="useBetaChannel">Whether to show beta versions as valid updates.</param>
         /// <param name="gitHubProjectName">SMAPI's GitHub project name, used to perform update checks.</param>
         /// <param name="webApiBaseUrl">The base URL for SMAPI's web API, used to perform update checks.</param>
-        /// <param name="verboseLogging">Whether SMAPI should log more information about the game context.</param>
+        /// <param name="verboseLogging">The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</param>
         /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
         /// <param name="usePintail">Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</param>
         /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, bool? verboseLogging, bool? rewriteMods, bool? usePintail, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? usePintail, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
@@ -104,7 +104,7 @@ namespace StardewModdingAPI.Framework.Models
             this.UseBetaChannel = useBetaChannel ?? (bool)SConfig.DefaultValues[nameof(this.UseBetaChannel)];
             this.GitHubProjectName = gitHubProjectName;
             this.WebApiBaseUrl = webApiBaseUrl;
-            this.VerboseLogging = verboseLogging ?? (bool)SConfig.DefaultValues[nameof(this.VerboseLogging)];
+            this.VerboseLogging = new HashSet<string>(verboseLogging ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
             this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(this.RewriteMods)];
             this.UsePintail = usePintail ?? (bool)SConfig.DefaultValues[nameof(this.UsePintail)];
             this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(this.UseCaseInsensitivePaths)];
@@ -133,7 +133,10 @@ namespace StardewModdingAPI.Framework.Models
             }
 
             if (!this.SuppressUpdateChecks.SetEquals(SConfig.DefaultSuppressUpdateChecks))
-                custom[nameof(this.SuppressUpdateChecks)] = "[" + string.Join(", ", this.SuppressUpdateChecks) + "]";
+                custom[nameof(this.SuppressUpdateChecks)] = $"[{string.Join(", ", this.SuppressUpdateChecks)}]";
+
+            if (this.VerboseLogging.Any())
+                custom[nameof(this.VerboseLogging)] = $"[{string.Join(", ", this.VerboseLogging)}]";
 
             return custom;
         }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index fa217f20..4f4212dc 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -194,7 +194,7 @@ namespace StardewModdingAPI.Framework
             if (developerMode.HasValue)
                 this.Settings.OverrideDeveloperMode(developerMode.Value);
 
-            this.LogManager = new LogManager(logPath: logPath, colorConfig: this.Settings.ConsoleColors, writeToConsole: writeToConsole, isVerbose: this.Settings.VerboseLogging, isDeveloperMode: this.Settings.DeveloperMode, getScreenIdForLog: this.GetScreenIdForLog);
+            this.LogManager = new LogManager(logPath: logPath, colorConfig: this.Settings.ConsoleColors, writeToConsole: writeToConsole, verboseLogging: this.Settings.VerboseLogging, isDeveloperMode: this.Settings.DeveloperMode, getScreenIdForLog: this.GetScreenIdForLog);
             this.CommandManager = new CommandManager(this.Monitor);
             this.EventManager = new EventManager(this.ModRegistry);
             SCore.DeprecationManager = new DeprecationManager(this.Monitor, this.ModRegistry);
@@ -1827,7 +1827,7 @@ namespace StardewModdingAPI.Framework
             // load as content pack
             if (mod.IsContentPack)
             {
-                IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
+                IMonitor monitor = this.LogManager.GetMonitor(manifest.UniqueID, mod.DisplayName);
                 IFileLookup fileLookup = this.GetFileLookup(mod.DirectoryPath);
                 GameContentHelper gameContentHelper = new(this.ContentCore, mod, mod.DisplayName, monitor, this.Reflection);
                 IModContentHelper modContentHelper = new ModContentHelper(this.ContentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), this.Reflection);
@@ -1902,7 +1902,7 @@ namespace StardewModdingAPI.Framework
                     }
 
                     // init mod helpers
-                    IMonitor monitor = this.LogManager.GetMonitor(mod.DisplayName);
+                    IMonitor monitor = this.LogManager.GetMonitor(manifest.UniqueID, mod.DisplayName);
                     TranslationHelper translationHelper = new(mod, contentCore.GetLocale(), contentCore.Language);
                     IModHelper modHelper;
                     {
@@ -1965,7 +1965,7 @@ namespace StardewModdingAPI.Framework
             );
 
             // create mod helpers
-            IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.Name);
+            IMonitor packMonitor = this.LogManager.GetMonitor(packManifest.UniqueID, packManifest.Name);
             GameContentHelper gameContentHelper = new(contentCore, fakeMod, packManifest.Name, packMonitor, this.Reflection);
             IModContentHelper packContentHelper = new ModContentHelper(contentCore, packDirPath, fakeMod, packManifest.Name, gameContentHelper.GetUnderlyingContentManager(), this.Reflection);
             TranslationHelper packTranslationHelper = new(fakeMod, contentCore.GetLocale(), contentCore.Language);
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 8324f45b..a6ec42d3 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -16,9 +16,17 @@ copy all the settings, or you may cause bugs due to overridden changes in future
 */
 {
     /**
-     * Whether SMAPI should log more information about the game context.
+     * The logs for which to enable verbose logging, which may show a lot more information to
+     * simplify troubleshooting.
+     *
+     * The possible values are:
+     *   - "*" for everything (not recommended);
+     *   - "SMAPI" for messages from SMAPI itself;
+     *   - mod IDs from their manifest.json files.
+     *
+     * For example: [ "SMAPI", "Pathoschild.ContentPatcher" ]
      */
-    "VerboseLogging": false,
+    "VerboseLogging": [],
 
     /**
      * Whether SMAPI should check for newer versions of SMAPI and mods when you load the game. If new

From a546fd113f431bd8888da50aad087213193c937e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 May 2022 18:02:48 -0400
Subject: [PATCH 663/856] add experimental image load rewrite

---
 docs/release-notes.md                         |  4 ++
 src/SMAPI/Framework/ContentCoordinator.cs     | 10 ++++-
 .../ContentManagers/ModContentManager.cs      | 41 ++++++++++++++++---
 src/SMAPI/Framework/Models/SConfig.cs         |  8 +++-
 src/SMAPI/Framework/SCore.cs                  |  3 +-
 src/SMAPI/SMAPI.config.json                   |  5 +++
 src/SMAPI/SMAPI.csproj                        |  1 +
 7 files changed, 63 insertions(+), 9 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e1aa47ab..a1b5222e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,10 @@
 
 # Release notes
 ## Upcoming release
+* For players:
+  * Added experimental image load rewrite (disabled by default).  
+    _If you have many content mods installed, enabling `UseExperimentalImageLoading` in `smapi-internal/config.json` may reduce load times or stutters when they load many image files at once._
+
 * For mod authors:
   * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
   * In `smapi-internal/config.json`, you can now enable verbose logging for specific mods (instead of all or nothing).
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 69a39ac7..3ad112cd 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -32,6 +32,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>An asset key prefix for assets from SMAPI mod folders.</summary>
         private readonly string ManagedPrefix = "SMAPI";
 
+        /// <summary>Whether to use a newer approach when loading image files from mod folder which may be faster.</summary>
+        private readonly bool UseExperimentalImageLoading;
+
         /// <summary>Get a file lookup for the given directory.</summary>
         private readonly Func<string, IFileLookup> GetFileLookup;
 
@@ -130,7 +133,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="getFileLookup">Get a file lookup for the given directory.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations)
+        /// <param name="useExperimentalImageLoading">Whether to use a newer approach when loading image files from mod folder which may be faster.</param>
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations, bool useExperimentalImageLoading)
         {
             this.GetFileLookup = getFileLookup;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
@@ -141,6 +145,7 @@ namespace StardewModdingAPI.Framework
             this.OnAssetsInvalidated = onAssetsInvalidated;
             this.RequestAssetOperations = requestAssetOperations;
             this.FullRootDirectory = Path.Combine(Constants.GamePath, rootDirectory);
+            this.UseExperimentalImageLoading = useExperimentalImageLoading;
             this.ContentManagers.Add(
                 this.MainContentManager = new GameContentManager(
                     name: "Game1.content",
@@ -219,7 +224,8 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
-                    fileLookup: this.GetFileLookup(rootDirectory)
+                    fileLookup: this.GetFileLookup(rootDirectory),
+                    useExperimentalImageLoading: this.UseExperimentalImageLoading
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 1b94b8c6..055dcc5f 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -7,6 +7,7 @@ using BmFont;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
+using SkiaSharp;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Serialization;
@@ -25,6 +26,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Fields
         *********/
+        /// <summary>Whether to use a newer approach when loading image files from mod folder which may be faster.</summary>
+        private readonly bool UseExperimentalImageLoading;
+
         /// <summary>Encapsulates SMAPI's JSON file parsing.</summary>
         private readonly JsonHelper JsonHelper;
 
@@ -57,13 +61,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="fileLookup">A lookup for files within the <paramref name="rootDirectory"/>.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup)
+        /// <param name="useExperimentalImageLoading">Whether to use a newer approach when loading image files from mod folder which may be faster.</param>
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup, bool useExperimentalImageLoading)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
         {
             this.GameContentManager = gameContentManager;
             this.FileLookup = fileLookup;
             this.JsonHelper = jsonHelper;
             this.ModName = modName;
+            this.UseExperimentalImageLoading = useExperimentalImageLoading;
 
             this.TryLocalizeKeys = false;
         }
@@ -187,10 +193,35 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Texture2D)}'.");
 
             // load
-            using FileStream stream = File.OpenRead(file.FullName);
-            Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream);
-            texture = this.PremultiplyTransparency(texture);
-            return (T)(object)texture;
+            if (this.UseExperimentalImageLoading)
+            {
+                // load raw data
+                using FileStream stream = File.OpenRead(file.FullName);
+                using SKBitmap bitmap = SKBitmap.Decode(stream);
+                SKPMColor[] rawPixels = SKPMColor.PreMultiply(bitmap.Pixels);
+
+                // convert to XNA pixel format
+                Color[] pixels = new Color[rawPixels.Length];
+                for (int i = pixels.Length - 1; i >= 0; i--)
+                {
+                    SKPMColor pixel = rawPixels[i];
+                    pixels[i] = pixel.Alpha == 0
+                        ? Color.Transparent
+                        : new Color(r: pixel.Red, g: pixel.Green, b: pixel.Blue, alpha: pixel.Alpha);
+                }
+
+                // create texture
+                Texture2D texture = new(Game1.graphics.GraphicsDevice, bitmap.Width, bitmap.Height);
+                texture.SetData(pixels);
+                return (T)(object)texture;
+            }
+            else
+            {
+                using FileStream stream = File.OpenRead(file.FullName);
+                Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream);
+                texture = this.PremultiplyTransparency(texture);
+                return (T)(object)texture;
+            }
         }
 
         /// <summary>Load an unpacked image file (<c>.tbin</c> or <c>.tmx</c>).</summary>
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 240af002..f12da0a7 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -23,6 +23,7 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
             [nameof(UsePintail)] = true,
+            [nameof(UseExperimentalImageLoading)] = false,
             [nameof(UseCaseInsensitivePaths)] = Constants.Platform is Platform.Android or Platform.Linux
         };
 
@@ -66,6 +67,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</summary>
         public bool UsePintail { get; }
 
+        /// <summary>Whether to use a newer approach when loading image files from mod folder which may be faster.</summary>
+        public bool UseExperimentalImageLoading { get; }
+
         /// <summary>Whether to make SMAPI file APIs case-insensitive, even on Linux.</summary>
         public bool UseCaseInsensitivePaths { get; }
 
@@ -92,11 +96,12 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="verboseLogging">The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</param>
         /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
         /// <param name="usePintail">Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</param>
+        /// <param name="useExperimentalImageLoading">Whether to use a newer approach when loading image files from mod folder which may be faster.</param>
         /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? usePintail, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? usePintail, bool? useExperimentalImageLoading, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
@@ -107,6 +112,7 @@ namespace StardewModdingAPI.Framework.Models
             this.VerboseLogging = new HashSet<string>(verboseLogging ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
             this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(this.RewriteMods)];
             this.UsePintail = usePintail ?? (bool)SConfig.DefaultValues[nameof(this.UsePintail)];
+            this.UseExperimentalImageLoading = useExperimentalImageLoading ?? (bool)SConfig.DefaultValues[nameof(this.UseExperimentalImageLoading)];
             this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(this.UseCaseInsensitivePaths)];
             this.LogNetworkTraffic = logNetworkTraffic ?? (bool)SConfig.DefaultValues[nameof(this.LogNetworkTraffic)];
             this.ConsoleColors = consoleColors;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 4f4212dc..242776b3 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1301,7 +1301,8 @@ namespace StardewModdingAPI.Framework
                     onAssetLoaded: this.OnAssetLoaded,
                     onAssetsInvalidated: this.OnAssetsInvalidated,
                     getFileLookup: this.GetFileLookup,
-                    requestAssetOperations: this.RequestAssetOperations
+                    requestAssetOperations: this.RequestAssetOperations,
+                    useExperimentalImageLoading: this.Settings.UseExperimentalImageLoading
                 );
                 if (this.ContentCore.Language != this.Translator.LocaleEnum)
                     this.Translator.SetLocale(this.ContentCore.GetLocale(), this.ContentCore.Language);
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index a6ec42d3..8e710435 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -60,6 +60,11 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "UsePintail": true,
 
+    /**
+     * Whether to use a newer approach when loading image files from mod folder which may be faster.
+     */
+    "UseExperimentalImageLoading": false,
+
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially
      * sensitive .NET APIs like file or shell access. Note that many mods do this legitimately as
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index a0ca54cc..91e4c668 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -41,6 +41,7 @@
     <Reference Include="GalaxyCSharp" HintPath="$(GamePath)\GalaxyCSharp.dll" Private="False" />
     <Reference Include="Lidgren.Network" HintPath="$(GamePath)\Lidgren.Network.dll" Private="False" />
     <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="False" />
+    <Reference Include="SkiaSharp" HintPath="$(GamePath)\SkiaSharp.dll" Private="False" />
     <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="False" />
   </ItemGroup>
 

From 4708385f696d2e47d24e795f210752f4b0224bff Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 25 May 2022 22:46:51 -0400
Subject: [PATCH 664/856] add IRawTextureData asset type

---
 docs/release-notes.md                         |   3 +
 .../Framework/Content/AssetDataForImage.cs    | 179 ++++++++++++------
 src/SMAPI/Framework/Content/RawTextureData.cs |  10 +
 .../ContentManagers/GameContentManager.cs     |   4 +
 .../ContentManagers/ModContentManager.cs      |  23 ++-
 src/SMAPI/IAssetDataForImage.cs               |  10 +
 src/SMAPI/IContentHelper.cs                   |   2 +-
 src/SMAPI/IContentPack.cs                     |   2 +-
 src/SMAPI/IModContentHelper.cs                |   2 +-
 src/SMAPI/IRawTextureData.cs                  |  17 ++
 10 files changed, 188 insertions(+), 64 deletions(-)
 create mode 100644 src/SMAPI/Framework/Content/RawTextureData.cs
 create mode 100644 src/SMAPI/IRawTextureData.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a1b5222e..b22f4de9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -5,6 +5,9 @@
 * For players:
   * Added experimental image load rewrite (disabled by default).  
     _If you have many content mods installed, enabling `UseExperimentalImageLoading` in `smapi-internal/config.json` may reduce load times or stutters when they load many image files at once._
+* For mod authors:
+  * Added specialized `IRawTextureData` asset type.  
+    _When you're only loading a mod file to patch it into an asset, you can now load it using `helper.ModContent.Load<IRawTextureData>(path)`. This reads the image data from disk without initializing a `Texture2D` instance through the GPU. You can then pass this to SMAPI APIs that accept `Texture2D` instances._
 
 * For mod authors:
   * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 97729c95..3393b22f 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
@@ -28,74 +29,62 @@ namespace StardewModdingAPI.Framework.Content
         public AssetDataForImage(string? locale, IAssetName assetName, Texture2D data, Func<string, string> getNormalizedPath, Action<Texture2D> onDataReplaced)
             : base(locale, assetName, data, getNormalizedPath, onDataReplaced) { }
 
+        /// <inheritdoc />
+        public void PatchImage(IRawTextureData source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace)
+        {
+            this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
+
+            // validate source data
+            if (source == null)
+                throw new ArgumentNullException(nameof(source), "Can't patch from null source data.");
+
+            // get the pixels for the source area
+            Color[] sourceData;
+            {
+                int areaX = sourceArea.Value.X;
+                int areaY = sourceArea.Value.Y;
+                int areaWidth = sourceArea.Value.Width;
+                int areaHeight = sourceArea.Value.Height;
+
+                if (areaX == 0 && areaY == 0 && areaWidth == source.Width && areaHeight == source.Height)
+                    sourceData = source.Data;
+                else
+                {
+                    sourceData = new Color[areaWidth * areaHeight];
+                    int i = 0;
+                    for (int y = areaY, maxY = areaY + areaHeight - 1; y <= maxY; y++)
+                    {
+                        for (int x = areaX, maxX = areaX + areaWidth - 1; x <= maxX; x++)
+                        {
+                            int targetIndex = (y * source.Width) + x;
+                            sourceData[i++] = source.Data[targetIndex];
+                        }
+                    }
+                }
+            }
+
+            // apply
+            this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+        }
+
         /// <inheritdoc />
         public void PatchImage(Texture2D source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace)
         {
-            // get texture
+            this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
+
+            // validate source texture
             if (source == null)
                 throw new ArgumentNullException(nameof(source), "Can't patch from a null source texture.");
-            Texture2D target = this.Data;
-
-            // get areas
-            sourceArea ??= new Rectangle(0, 0, source.Width, source.Height);
-            targetArea ??= new Rectangle(0, 0, Math.Min(sourceArea.Value.Width, target.Width), Math.Min(sourceArea.Value.Height, target.Height));
-
-            // validate
             if (!source.Bounds.Contains(sourceArea.Value))
                 throw new ArgumentOutOfRangeException(nameof(sourceArea), "The source area is outside the bounds of the source texture.");
-            if (!target.Bounds.Contains(targetArea.Value))
-                throw new ArgumentOutOfRangeException(nameof(targetArea), "The target area is outside the bounds of the target texture.");
-            if (sourceArea.Value.Size != targetArea.Value.Size)
-                throw new InvalidOperationException("The source and target areas must be the same size.");
 
             // get source data
             int pixelCount = sourceArea.Value.Width * sourceArea.Value.Height;
             Color[] sourceData = GC.AllocateUninitializedArray<Color>(pixelCount);
             source.GetData(0, sourceArea, sourceData, 0, pixelCount);
 
-            // merge data in overlay mode
-            if (patchMode == PatchMode.Overlay)
-            {
-                // get target data
-                Color[] targetData = GC.AllocateUninitializedArray<Color>(pixelCount);
-                target.GetData(0, targetArea, targetData, 0, pixelCount);
-
-                // merge pixels
-                for (int i = 0; i < sourceData.Length; i++)
-                {
-                    Color above = sourceData[i];
-                    Color below = targetData[i];
-
-                    // shortcut transparency
-                    if (above.A < MinOpacity)
-                    {
-                        sourceData[i] = below;
-                        continue;
-                    }
-                    if (below.A < MinOpacity)
-                    {
-                        sourceData[i] = above;
-                        continue;
-                    }
-
-                    // merge pixels
-                    // This performs a conventional alpha blend for the pixels, which are already
-                    // premultiplied by the content pipeline. The formula is derived from
-                    // https://blogs.msdn.microsoft.com/shawnhar/2009/11/06/premultiplied-alpha/.
-                    // Note: don't use named arguments here since they're different between
-                    // Linux/macOS and Windows.
-                    float alphaBelow = 1 - (above.A / 255f);
-                    sourceData[i] = new Color(
-                        (int)(above.R + (below.R * alphaBelow)), // r
-                        (int)(above.G + (below.G * alphaBelow)), // g
-                        (int)(above.B + (below.B * alphaBelow)), // b
-                        Math.Max(above.A, below.A) // a
-                    );
-                }
-            }
-
-            // patch target texture
-            target.SetData(0, targetArea, sourceData, 0, pixelCount);
+            // apply
+            this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
         }
 
         /// <inheritdoc />
@@ -110,5 +99,85 @@ namespace StardewModdingAPI.Framework.Content
             this.PatchImage(original);
             return true;
         }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get the bounds for an image patch.</summary>
+        /// <param name="sourceArea">The source area to set if needed.</param>
+        /// <param name="targetArea">The target area to set if needed.</param>
+        /// <param name="sourceWidth">The width of the full source image.</param>
+        /// <param name="sourceHeight">The height of the full source image.</param>
+        private void GetPatchBounds([NotNull] ref Rectangle? sourceArea, [NotNull] ref Rectangle? targetArea, int sourceWidth, int sourceHeight)
+        {
+            sourceArea ??= new Rectangle(0, 0, sourceWidth, sourceHeight);
+            targetArea ??= new Rectangle(0, 0, Math.Min(sourceArea.Value.Width, this.Data.Width), Math.Min(sourceArea.Value.Height, this.Data.Height));
+        }
+
+        /// <summary>Overwrite part of the image.</summary>
+        /// <param name="sourceData">The image data to patch into the content.</param>
+        /// <param name="sourceWidth">The pixel width of the source image.</param>
+        /// <param name="sourceHeight">The pixel height of the source image.</param>
+        /// <param name="sourceArea">The part of the <paramref name="sourceData"/> to copy (or <c>null</c> to take the whole texture). This must be within the bounds of the <paramref name="sourceData"/> texture.</param>
+        /// <param name="targetArea">The part of the content to patch (or <c>null</c> to patch the whole texture). The original content within this area will be erased. This must be within the bounds of the existing spritesheet.</param>
+        /// <param name="patchMode">Indicates how an image should be patched.</param>
+        /// <exception cref="ArgumentNullException">One of the arguments is null.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">The <paramref name="targetArea"/> is outside the bounds of the spritesheet.</exception>
+        /// <exception cref="InvalidOperationException">The content being read isn't an image.</exception>
+        private void PatchImageImpl(Color[] sourceData, int sourceWidth, int sourceHeight, Rectangle sourceArea, Rectangle targetArea, PatchMode patchMode)
+        {
+            // get texture
+            Texture2D target = this.Data;
+            int pixelCount = sourceArea.Width * sourceArea.Height;
+
+            // validate
+            if (sourceArea.X < 0 || sourceArea.Y < 0 || sourceArea.Right > sourceWidth || sourceArea.Bottom > sourceHeight)
+                throw new ArgumentOutOfRangeException(nameof(sourceArea), "The source area is outside the bounds of the source texture.");
+            if (!target.Bounds.Contains(targetArea))
+                throw new ArgumentOutOfRangeException(nameof(targetArea), "The target area is outside the bounds of the target texture.");
+            if (sourceArea.Size != targetArea.Size)
+                throw new InvalidOperationException("The source and target areas must be the same size.");
+
+            // merge data
+            if (patchMode == PatchMode.Overlay)
+            {
+                // get target data
+                Color[] mergedData = GC.AllocateUninitializedArray<Color>(pixelCount);
+                target.GetData(0, targetArea, mergedData, 0, pixelCount);
+
+                // merge pixels
+                for (int i = 0; i < pixelCount; i++)
+                {
+                    Color above = sourceData[i];
+                    Color below = mergedData[i];
+
+                    // shortcut transparency
+                    if (above.A < MinOpacity)
+                        continue;
+                    if (below.A < MinOpacity)
+                        mergedData[i] = above;
+
+                    // merge pixels
+                    else
+                    {
+                        // This performs a conventional alpha blend for the pixels, which are already
+                        // premultiplied by the content pipeline. The formula is derived from
+                        // https://blogs.msdn.microsoft.com/shawnhar/2009/11/06/premultiplied-alpha/.
+                        float alphaBelow = 1 - (above.A / 255f);
+                        mergedData[i] = new Color(
+                            r: (int)(above.R + (below.R * alphaBelow)),
+                            g: (int)(above.G + (below.G * alphaBelow)),
+                            b: (int)(above.B + (below.B * alphaBelow)),
+                            alpha: Math.Max(above.A, below.A)
+                        );
+                    }
+                }
+
+                target.SetData(0, targetArea, mergedData, 0, pixelCount);
+            }
+            else
+                target.SetData(0, targetArea, sourceData, 0, pixelCount);
+        }
     }
 }
diff --git a/src/SMAPI/Framework/Content/RawTextureData.cs b/src/SMAPI/Framework/Content/RawTextureData.cs
new file mode 100644
index 00000000..4a0835b0
--- /dev/null
+++ b/src/SMAPI/Framework/Content/RawTextureData.cs
@@ -0,0 +1,10 @@
+using Microsoft.Xna.Framework;
+
+namespace StardewModdingAPI.Framework.Content
+{
+    /// <summary>The raw data for an image read from the filesystem.</summary>
+    /// <param name="Width">The image width.</param>
+    /// <param name="Height">The image height.</param>
+    /// <param name="Data">The loaded image data.</param>
+    internal record RawTextureData(int Width, int Height, Color[] Data) : IRawTextureData;
+}
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 4390d472..446f4a67 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -9,6 +9,7 @@ using Microsoft.Xna.Framework.Graphics;
 using StardewModdingAPI.Events;
 using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.Deprecations;
+using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
@@ -93,6 +94,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <inheritdoc />
         public override T LoadExact<T>(IAssetName assetName, bool useCache)
         {
+            if (typeof(IRawTextureData).IsAssignableFrom(typeof(T)))
+                throw new SContentLoadException(ContentLoadErrorType.Other, $"Can't load {nameof(IRawTextureData)} assets from the game content pipeline. This asset type is only available for mod files.");
+
             // raise first-load callback
             if (GameContentManager.IsFirstLoad)
             {
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 055dcc5f..eb4f4555 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -8,6 +8,7 @@ using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using SkiaSharp;
+using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.Exceptions;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Toolkit.Serialization;
@@ -188,12 +189,17 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file to load.</param>
         private T LoadImageFile<T>(IAssetName assetName, FileInfo file)
         {
-            // validate
+            // validate type
+            bool asRawData = false;
             if (typeof(T) != typeof(Texture2D))
-                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Texture2D)}'.");
+            {
+                asRawData = typeof(T) == typeof(IRawTextureData);
+                if (!asRawData)
+                    throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Texture2D)}' or '{typeof(IRawTextureData)}'.");
+            }
 
             // load
-            if (this.UseExperimentalImageLoading)
+            if (asRawData || this.UseExperimentalImageLoading)
             {
                 // load raw data
                 using FileStream stream = File.OpenRead(file.FullName);
@@ -211,9 +217,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 }
 
                 // create texture
-                Texture2D texture = new(Game1.graphics.GraphicsDevice, bitmap.Width, bitmap.Height);
-                texture.SetData(pixels);
-                return (T)(object)texture;
+                if (asRawData)
+                    return (T)(object)new RawTextureData(bitmap.Width, bitmap.Height, pixels);
+                else
+                {
+                    Texture2D texture = new(Game1.graphics.GraphicsDevice, bitmap.Width, bitmap.Height);
+                    texture.SetData(pixels);
+                    return (T)(object)texture;
+                }
             }
             else
             {
diff --git a/src/SMAPI/IAssetDataForImage.cs b/src/SMAPI/IAssetDataForImage.cs
index 6f8a4719..3e5b833d 100644
--- a/src/SMAPI/IAssetDataForImage.cs
+++ b/src/SMAPI/IAssetDataForImage.cs
@@ -10,6 +10,16 @@ namespace StardewModdingAPI
         /*********
         ** Public methods
         *********/
+        /// <summary>Overwrite part of the image.</summary>
+        /// <param name="source">The image to patch into the content.</param>
+        /// <param name="sourceArea">The part of the <paramref name="source"/> to copy (or <c>null</c> to take the whole texture). This must be within the bounds of the <paramref name="source"/> texture.</param>
+        /// <param name="targetArea">The part of the content to patch (or <c>null</c> to patch the whole texture). The original content within this area will be erased. This must be within the bounds of the existing spritesheet.</param>
+        /// <param name="patchMode">Indicates how an image should be patched.</param>
+        /// <exception cref="ArgumentNullException">One of the arguments is null.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">The <paramref name="targetArea"/> is outside the bounds of the spritesheet.</exception>
+        /// <exception cref="InvalidOperationException">The content being read isn't an image.</exception>
+        void PatchImage(IRawTextureData source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace);
+
         /// <summary>Overwrite part of the image.</summary>
         /// <param name="source">The image to patch into the content.</param>
         /// <param name="sourceArea">The part of the <paramref name="source"/> to copy (or <c>null</c> to take the whole texture). This must be within the bounds of the <paramref name="source"/> texture.</param>
diff --git a/src/SMAPI/IContentHelper.cs b/src/SMAPI/IContentHelper.cs
index 2cd0c1fc..7637edf0 100644
--- a/src/SMAPI/IContentHelper.cs
+++ b/src/SMAPI/IContentHelper.cs
@@ -35,7 +35,7 @@ namespace StardewModdingAPI
         ** Public methods
         *********/
         /// <summary>Load content from the game folder or mod folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
-        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
+        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, <see cref="IRawTextureData"/> (for mod content only), and data structures; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="key">The asset key to fetch (if the <paramref name="source"/> is <see cref="ContentSource.GameContent"/>), or the local path to a content file relative to the mod folder.</param>
         /// <param name="source">Where to search for a matching content asset.</param>
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
diff --git a/src/SMAPI/IContentPack.cs b/src/SMAPI/IContentPack.cs
index 1215fe0b..73b1a860 100644
--- a/src/SMAPI/IContentPack.cs
+++ b/src/SMAPI/IContentPack.cs
@@ -48,7 +48,7 @@ namespace StardewModdingAPI
             where TModel : class;
 
         /// <summary>Load content from the content pack folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
-        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, and dictionaries; other types may be supported by the game's content pipeline.</typeparam>
+        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, <see cref="IRawTextureData"/>, and data structures; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="key">The relative file path within the content pack (case-insensitive).</param>
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
         /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
diff --git a/src/SMAPI/IModContentHelper.cs b/src/SMAPI/IModContentHelper.cs
index f1f6ce94..1e2d82a8 100644
--- a/src/SMAPI/IModContentHelper.cs
+++ b/src/SMAPI/IModContentHelper.cs
@@ -12,7 +12,7 @@ namespace StardewModdingAPI
         ** Public methods
         *********/
         /// <summary>Load content from the mod folder and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
-        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, dictionaries, and lists; other types may be supported by the game's content pipeline.</typeparam>
+        /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, <see cref="IRawTextureData"/>, and data structures; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="relativePath">The local path to a content file relative to the mod folder.</param>
         /// <exception cref="ArgumentException">The <paramref name="relativePath"/> is empty or contains invalid characters.</exception>
         /// <exception cref="ContentLoadException">The content asset couldn't be loaded (e.g. because it doesn't exist).</exception>
diff --git a/src/SMAPI/IRawTextureData.cs b/src/SMAPI/IRawTextureData.cs
new file mode 100644
index 00000000..a4da52f3
--- /dev/null
+++ b/src/SMAPI/IRawTextureData.cs
@@ -0,0 +1,17 @@
+using Microsoft.Xna.Framework;
+
+namespace StardewModdingAPI
+{
+    /// <summary>The raw data for an image read from the filesystem.</summary>
+    public interface IRawTextureData
+    {
+        /// <summary>The image width.</summary>
+        int Width { get; }
+
+        /// <summary>The image height.</summary>
+        int Height { get; }
+
+        /// <summary>The loaded image data.</summary>
+        Color[] Data { get; }
+    }
+}

From 769475166ab3b92cd3763bb86e364a8b2c7d914f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 26 May 2022 00:51:11 -0400
Subject: [PATCH 665/856] enable raw image loading by default, rename setting

---
 docs/release-notes.md                                |  7 +++----
 src/SMAPI/Framework/ContentCoordinator.cs            | 12 ++++++------
 .../Framework/ContentManagers/ModContentManager.cs   | 12 ++++++------
 src/SMAPI/Framework/Models/SConfig.cs                | 12 ++++++------
 src/SMAPI/Framework/SCore.cs                         |  2 +-
 src/SMAPI/SMAPI.config.json                          |  5 +++--
 6 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index b22f4de9..7fff656a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,11 +3,10 @@
 # Release notes
 ## Upcoming release
 * For players:
-  * Added experimental image load rewrite (disabled by default).  
-    _If you have many content mods installed, enabling `UseExperimentalImageLoading` in `smapi-internal/config.json` may reduce load times or stutters when they load many image files at once._
+  * Optimized mod image file loading.
 * For mod authors:
-  * Added specialized `IRawTextureData` asset type.  
-    _When you're only loading a mod file to patch it into an asset, you can now load it using `helper.ModContent.Load<IRawTextureData>(path)`. This reads the image data from disk without initializing a `Texture2D` instance through the GPU. You can then pass this to SMAPI APIs that accept `Texture2D` instances._
+  * Added a new `IRawTextureData` asset type.  
+    _You can now load image files through `helper.ModContent` as `IRawTextureData` instead of `Texture2D`. This provides the image size and raw pixel data, which you can pass into other SMAPI APIs like `asset.AsImage().PatchImage`. This is much more efficient when you don't need a full `Texture2D` instance, since it bypasses the GPU operations needed to create one._
 
 * For mod authors:
   * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 3ad112cd..3e09ac62 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -32,8 +32,8 @@ namespace StardewModdingAPI.Framework
         /// <summary>An asset key prefix for assets from SMAPI mod folders.</summary>
         private readonly string ManagedPrefix = "SMAPI";
 
-        /// <summary>Whether to use a newer approach when loading image files from mod folder which may be faster.</summary>
-        private readonly bool UseExperimentalImageLoading;
+        /// <summary>Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</summary>
+        private readonly bool UseRawImageLoading;
 
         /// <summary>Get a file lookup for the given directory.</summary>
         private readonly Func<string, IFileLookup> GetFileLookup;
@@ -133,8 +133,8 @@ namespace StardewModdingAPI.Framework
         /// <param name="getFileLookup">Get a file lookup for the given directory.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        /// <param name="useExperimentalImageLoading">Whether to use a newer approach when loading image files from mod folder which may be faster.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations, bool useExperimentalImageLoading)
+        /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations, bool useRawImageLoading)
         {
             this.GetFileLookup = getFileLookup;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
@@ -145,7 +145,7 @@ namespace StardewModdingAPI.Framework
             this.OnAssetsInvalidated = onAssetsInvalidated;
             this.RequestAssetOperations = requestAssetOperations;
             this.FullRootDirectory = Path.Combine(Constants.GamePath, rootDirectory);
-            this.UseExperimentalImageLoading = useExperimentalImageLoading;
+            this.UseRawImageLoading = useRawImageLoading;
             this.ContentManagers.Add(
                 this.MainContentManager = new GameContentManager(
                     name: "Game1.content",
@@ -225,7 +225,7 @@ namespace StardewModdingAPI.Framework
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
                     fileLookup: this.GetFileLookup(rootDirectory),
-                    useExperimentalImageLoading: this.UseExperimentalImageLoading
+                    useRawImageLoading: this.UseRawImageLoading
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index eb4f4555..f0e9b1b9 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -27,8 +27,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Fields
         *********/
-        /// <summary>Whether to use a newer approach when loading image files from mod folder which may be faster.</summary>
-        private readonly bool UseExperimentalImageLoading;
+        /// <summary>Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</summary>
+        private readonly bool UseRawImageLoading;
 
         /// <summary>Encapsulates SMAPI's JSON file parsing.</summary>
         private readonly JsonHelper JsonHelper;
@@ -62,15 +62,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="fileLookup">A lookup for files within the <paramref name="rootDirectory"/>.</param>
-        /// <param name="useExperimentalImageLoading">Whether to use a newer approach when loading image files from mod folder which may be faster.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup, bool useExperimentalImageLoading)
+        /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup, bool useRawImageLoading)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
         {
             this.GameContentManager = gameContentManager;
             this.FileLookup = fileLookup;
             this.JsonHelper = jsonHelper;
             this.ModName = modName;
-            this.UseExperimentalImageLoading = useExperimentalImageLoading;
+            this.UseRawImageLoading = useRawImageLoading;
 
             this.TryLocalizeKeys = false;
         }
@@ -199,7 +199,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // load
-            if (asRawData || this.UseExperimentalImageLoading)
+            if (asRawData || this.UseRawImageLoading)
             {
                 // load raw data
                 using FileStream stream = File.OpenRead(file.FullName);
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index f12da0a7..6edaa818 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -23,7 +23,7 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
             [nameof(UsePintail)] = true,
-            [nameof(UseExperimentalImageLoading)] = false,
+            [nameof(UseRawImageLoading)] = true,
             [nameof(UseCaseInsensitivePaths)] = Constants.Platform is Platform.Android or Platform.Linux
         };
 
@@ -67,8 +67,8 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</summary>
         public bool UsePintail { get; }
 
-        /// <summary>Whether to use a newer approach when loading image files from mod folder which may be faster.</summary>
-        public bool UseExperimentalImageLoading { get; }
+        /// <summary>Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</summary>
+        public bool UseRawImageLoading { get; }
 
         /// <summary>Whether to make SMAPI file APIs case-insensitive, even on Linux.</summary>
         public bool UseCaseInsensitivePaths { get; }
@@ -96,12 +96,12 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="verboseLogging">The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</param>
         /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
         /// <param name="usePintail">Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</param>
-        /// <param name="useExperimentalImageLoading">Whether to use a newer approach when loading image files from mod folder which may be faster.</param>
+        /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
         /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? usePintail, bool? useExperimentalImageLoading, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? usePintail, bool? useRawImageLoading, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
@@ -112,7 +112,7 @@ namespace StardewModdingAPI.Framework.Models
             this.VerboseLogging = new HashSet<string>(verboseLogging ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
             this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(this.RewriteMods)];
             this.UsePintail = usePintail ?? (bool)SConfig.DefaultValues[nameof(this.UsePintail)];
-            this.UseExperimentalImageLoading = useExperimentalImageLoading ?? (bool)SConfig.DefaultValues[nameof(this.UseExperimentalImageLoading)];
+            this.UseRawImageLoading = useRawImageLoading ?? (bool)SConfig.DefaultValues[nameof(this.UseRawImageLoading)];
             this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(this.UseCaseInsensitivePaths)];
             this.LogNetworkTraffic = logNetworkTraffic ?? (bool)SConfig.DefaultValues[nameof(this.LogNetworkTraffic)];
             this.ConsoleColors = consoleColors;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 242776b3..f018acad 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1302,7 +1302,7 @@ namespace StardewModdingAPI.Framework
                     onAssetsInvalidated: this.OnAssetsInvalidated,
                     getFileLookup: this.GetFileLookup,
                     requestAssetOperations: this.RequestAssetOperations,
-                    useExperimentalImageLoading: this.Settings.UseExperimentalImageLoading
+                    useRawImageLoading: this.Settings.UseRawImageLoading
                 );
                 if (this.ContentCore.Language != this.Translator.LocaleEnum)
                     this.Translator.SetLocale(this.ContentCore.GetLocale(), this.ContentCore.Language);
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 8e710435..97e8e00c 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -61,9 +61,10 @@ copy all the settings, or you may cause bugs due to overridden changes in future
     "UsePintail": true,
 
     /**
-     * Whether to use a newer approach when loading image files from mod folder which may be faster.
+     * Whether to use raw image data when possible, instead of initializing an XNA Texture2D
+     * instance through the GPU.
      */
-    "UseExperimentalImageLoading": false,
+    "UseRawImageLoading": true,
 
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially

From db578c389e35ee026ed4ea12dfdcef99f8bc3b28 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 26 May 2022 00:57:13 -0400
Subject: [PATCH 666/856] drop support for pre-Pintail proxying

---
 docs/release-notes.md                         |   1 +
 src/SMAPI.Tests/Core/InterfaceProxyTests.cs   |   7 +-
 src/SMAPI/Framework/Models/SConfig.cs         |   6 -
 .../OriginalInterfaceProxyBuilder.cs          | 118 ------------------
 .../OriginalInterfaceProxyFactory.cs          |  57 ---------
 src/SMAPI/Framework/SCore.cs                  |   4 +-
 6 files changed, 4 insertions(+), 189 deletions(-)
 delete mode 100644 src/SMAPI/Framework/Reflection/OriginalInterfaceProxyBuilder.cs
 delete mode 100644 src/SMAPI/Framework/Reflection/OriginalInterfaceProxyFactory.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7fff656a..ddf97fe8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,7 @@
 * For mod authors:
   * Added a new `IRawTextureData` asset type.  
     _You can now load image files through `helper.ModContent` as `IRawTextureData` instead of `Texture2D`. This provides the image size and raw pixel data, which you can pass into other SMAPI APIs like `asset.AsImage().PatchImage`. This is much more efficient when you don't need a full `Texture2D` instance, since it bypasses the GPU operations needed to create one._
+  * Removed transitional `UsePintail` option added in 3.14.0 (now always enabled).
 
 * For mod authors:
   * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
diff --git a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
index 6be97526..d14c116f 100644
--- a/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
+++ b/src/SMAPI.Tests/Core/InterfaceProxyTests.cs
@@ -29,11 +29,8 @@ namespace SMAPI.Tests.Core
         /// <summary>The random number generator with which to create sample values.</summary>
         private readonly Random Random = new();
 
-        /// <summary>Sample user inputs for season names.</summary>
-        private static readonly IInterfaceProxyFactory[] ProxyFactories = {
-            new InterfaceProxyFactory(),
-            new OriginalInterfaceProxyFactory()
-        };
+        /// <summary>The proxy factory to use in unit tests.</summary>
+        private static readonly IInterfaceProxyFactory[] ProxyFactories = { new InterfaceProxyFactory() };
 
 
         /*********
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 6edaa818..baef6144 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -22,7 +22,6 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(WebApiBaseUrl)] = "https://smapi.io/api/",
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
-            [nameof(UsePintail)] = true,
             [nameof(UseRawImageLoading)] = true,
             [nameof(UseCaseInsensitivePaths)] = Constants.Platform is Platform.Android or Platform.Linux
         };
@@ -64,9 +63,6 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether SMAPI should rewrite mods for compatibility.</summary>
         public bool RewriteMods { get; }
 
-        /// <summary>Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</summary>
-        public bool UsePintail { get; }
-
         /// <summary>Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</summary>
         public bool UseRawImageLoading { get; }
 
@@ -95,7 +91,6 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="webApiBaseUrl">The base URL for SMAPI's web API, used to perform update checks.</param>
         /// <param name="verboseLogging">The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</param>
         /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
-        /// <param name="usePintail">Whether to use the experimental Pintail API proxying library, instead of the original proxying built into SMAPI itself.</param>
         /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
         /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
@@ -111,7 +106,6 @@ namespace StardewModdingAPI.Framework.Models
             this.WebApiBaseUrl = webApiBaseUrl;
             this.VerboseLogging = new HashSet<string>(verboseLogging ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
             this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(this.RewriteMods)];
-            this.UsePintail = usePintail ?? (bool)SConfig.DefaultValues[nameof(this.UsePintail)];
             this.UseRawImageLoading = useRawImageLoading ?? (bool)SConfig.DefaultValues[nameof(this.UseRawImageLoading)];
             this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(this.UseCaseInsensitivePaths)];
             this.LogNetworkTraffic = logNetworkTraffic ?? (bool)SConfig.DefaultValues[nameof(this.LogNetworkTraffic)];
diff --git a/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyBuilder.cs b/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyBuilder.cs
deleted file mode 100644
index 9576f768..00000000
--- a/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyBuilder.cs
+++ /dev/null
@@ -1,118 +0,0 @@
-using System;
-using System.Linq;
-using System.Reflection;
-using System.Reflection.Emit;
-
-namespace StardewModdingAPI.Framework.Reflection
-{
-    /// <summary>Generates a proxy class to access a mod API through an arbitrary interface.</summary>
-    internal class OriginalInterfaceProxyBuilder
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The target class type.</summary>
-        private readonly Type TargetType;
-
-        /// <summary>The generated proxy type.</summary>
-        private readonly Type ProxyType;
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="name">The type name to generate.</param>
-        /// <param name="moduleBuilder">The CLR module in which to create proxy classes.</param>
-        /// <param name="interfaceType">The interface type to implement.</param>
-        /// <param name="targetType">The target type.</param>
-        public OriginalInterfaceProxyBuilder(string name, ModuleBuilder moduleBuilder, Type interfaceType, Type targetType)
-        {
-            // validate
-            if (name == null)
-                throw new ArgumentNullException(nameof(name));
-            if (targetType == null)
-                throw new ArgumentNullException(nameof(targetType));
-
-            // define proxy type
-            TypeBuilder proxyBuilder = moduleBuilder.DefineType(name, TypeAttributes.Public | TypeAttributes.Class);
-            proxyBuilder.AddInterfaceImplementation(interfaceType);
-
-            // create field to store target instance
-            FieldBuilder targetField = proxyBuilder.DefineField("__Target", targetType, FieldAttributes.Private);
-
-            // create constructor which accepts target instance and sets field
-            {
-                ConstructorBuilder constructor = proxyBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard | CallingConventions.HasThis, new[] { targetType });
-                ILGenerator il = constructor.GetILGenerator();
-
-                il.Emit(OpCodes.Ldarg_0); // this
-                // ReSharper disable once AssignNullToNotNullAttribute -- never null
-                il.Emit(OpCodes.Call, typeof(object).GetConstructor(Type.EmptyTypes)!); // call base constructor
-                il.Emit(OpCodes.Ldarg_0);      // this
-                il.Emit(OpCodes.Ldarg_1);      // load argument
-                il.Emit(OpCodes.Stfld, targetField); // set field to loaded argument
-                il.Emit(OpCodes.Ret);
-            }
-
-            // proxy methods
-            foreach (MethodInfo proxyMethod in interfaceType.GetMethods())
-            {
-                var targetMethod = targetType.GetMethod(proxyMethod.Name, proxyMethod.GetParameters().Select(a => a.ParameterType).ToArray());
-                if (targetMethod == null)
-                    throw new InvalidOperationException($"The {interfaceType.FullName} interface defines method {proxyMethod.Name} which doesn't exist in the API.");
-
-                this.ProxyMethod(proxyBuilder, targetMethod, targetField);
-            }
-
-            // save info
-            this.TargetType = targetType;
-            this.ProxyType = proxyBuilder.CreateType()!;
-        }
-
-        /// <summary>Create an instance of the proxy for a target instance.</summary>
-        /// <param name="targetInstance">The target instance.</param>
-        public object CreateInstance(object targetInstance)
-        {
-            ConstructorInfo? constructor = this.ProxyType.GetConstructor(new[] { this.TargetType });
-            if (constructor == null)
-                throw new InvalidOperationException($"Couldn't find the constructor for generated proxy type '{this.ProxyType.Name}'."); // should never happen
-            return constructor.Invoke(new[] { targetInstance });
-        }
-
-
-        /*********
-        ** Private methods
-        *********/
-        /// <summary>Define a method which proxies access to a method on the target.</summary>
-        /// <param name="proxyBuilder">The proxy type being generated.</param>
-        /// <param name="target">The target method.</param>
-        /// <param name="instanceField">The proxy field containing the API instance.</param>
-        private void ProxyMethod(TypeBuilder proxyBuilder, MethodInfo target, FieldBuilder instanceField)
-        {
-            Type[] argTypes = target.GetParameters().Select(a => a.ParameterType).ToArray();
-
-            // create method
-            MethodBuilder methodBuilder = proxyBuilder.DefineMethod(target.Name, MethodAttributes.Public | MethodAttributes.Final | MethodAttributes.Virtual);
-            methodBuilder.SetParameters(argTypes);
-            methodBuilder.SetReturnType(target.ReturnType);
-
-            // create method body
-            {
-                ILGenerator il = methodBuilder.GetILGenerator();
-
-                // load target instance
-                il.Emit(OpCodes.Ldarg_0);
-                il.Emit(OpCodes.Ldfld, instanceField);
-
-                // invoke target method on instance
-                for (int i = 0; i < argTypes.Length; i++)
-                    il.Emit(OpCodes.Ldarg, i + 1);
-                il.Emit(OpCodes.Call, target);
-
-                // return result
-                il.Emit(OpCodes.Ret);
-            }
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyFactory.cs b/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyFactory.cs
deleted file mode 100644
index d6966978..00000000
--- a/src/SMAPI/Framework/Reflection/OriginalInterfaceProxyFactory.cs
+++ /dev/null
@@ -1,57 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Reflection;
-using System.Reflection.Emit;
-
-namespace StardewModdingAPI.Framework.Reflection
-{
-    /// <inheritdoc />
-    internal class OriginalInterfaceProxyFactory : IInterfaceProxyFactory
-    {
-        /*********
-        ** Fields
-        *********/
-        /// <summary>The CLR module in which to create proxy classes.</summary>
-        private readonly ModuleBuilder ModuleBuilder;
-
-        /// <summary>The generated proxy types.</summary>
-        private readonly IDictionary<string, OriginalInterfaceProxyBuilder> Builders = new Dictionary<string, OriginalInterfaceProxyBuilder>();
-
-
-        /*********
-        ** Public methods
-        *********/
-        /// <summary>Construct an instance.</summary>
-        public OriginalInterfaceProxyFactory()
-        {
-            AssemblyBuilder assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName($"StardewModdingAPI.Proxies, Version={this.GetType().Assembly.GetName().Version}, Culture=neutral"), AssemblyBuilderAccess.Run);
-            this.ModuleBuilder = assemblyBuilder.DefineDynamicModule("StardewModdingAPI.Proxies");
-        }
-
-        /// <inheritdoc />
-        public TInterface CreateProxy<TInterface>(object instance, string sourceModID, string targetModID)
-            where TInterface : class
-        {
-            lock (this.Builders)
-            {
-                // validate
-                if (instance == null)
-                    throw new InvalidOperationException("Can't proxy access to a null API.");
-                if (!typeof(TInterface).IsInterface)
-                    throw new InvalidOperationException("The proxy type must be an interface, not a class.");
-
-                // get proxy type
-                Type targetType = instance.GetType();
-                string proxyTypeName = $"StardewModdingAPI.Proxies.From<{sourceModID}_{typeof(TInterface).FullName}>_To<{targetModID}_{targetType.FullName}>";
-                if (!this.Builders.TryGetValue(proxyTypeName, out OriginalInterfaceProxyBuilder? builder))
-                {
-                    builder = new OriginalInterfaceProxyBuilder(proxyTypeName, this.ModuleBuilder, typeof(TInterface), targetType);
-                    this.Builders[proxyTypeName] = builder;
-                }
-
-                // create instance
-                return (TInterface)builder.CreateInstance(instance);
-            }
-        }
-    }
-}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index f018acad..fa3f8778 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1610,9 +1610,7 @@ namespace StardewModdingAPI.Framework
             {
                 // init
                 HashSet<string> suppressUpdateChecks = this.Settings.SuppressUpdateChecks;
-                IInterfaceProxyFactory proxyFactory = this.Settings.UsePintail
-                    ? new InterfaceProxyFactory()
-                    : new OriginalInterfaceProxyFactory();
+                IInterfaceProxyFactory proxyFactory = new InterfaceProxyFactory();
 
                 // load mods
                 foreach (IModMetadata mod in mods)

From b6a8dcdd46dbc2875b24e0f77049c61a5cf398d9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 29 Mar 2022 18:59:05 -0400
Subject: [PATCH 667/856] update to Harmony 2.2.1

---
 build/0Harmony.dll                            | Bin 167424 -> 238592 bytes
 build/0Harmony.xml                            | 594 +++++++++++++++++-
 docs/release-notes.md                         |   2 +
 .../TemporaryHacks/MiniMonoModHotfix.cs       |  25 -
 src/SMAPI/SMAPI.csproj                        |   2 +-
 5 files changed, 570 insertions(+), 53 deletions(-)

diff --git a/build/0Harmony.dll b/build/0Harmony.dll
index 91d36ea25de3ab3e6d9db9fccb11d7f9fe5ede6e..492255be297ccadecefc747c15558e8ce06dd3af 100644
GIT binary patch
literal 238592
zcmcG%2b>(m(ZD-5vpcitPTITE-YFlT72};<0TN(IU=TTDFxUvNEx=?O26iPISnYDy
zpTP!6CfL}Pvz$rJIpCadIOA-?Ip_E}htJ3RSM|)!?43yO_ul<(XF60@RaaMcSI0T&
zteY*zvaAfhhaR%55Av434f=fK$0X51%RfA1y*K}rJw7;a;#c-K{o+en6IV3Di<;+N
zHu0=;FTXt8JaOIy6U{A`Ph4{O#F0-vZQ`=<{0mkM4i;8Ks82b{vQ8Xuth)|e_?DR3
zkE}f>iUa#v)~n&nHKBk15bg=wpAc@X`RcX}-x47Fn?GEH%b#PN^FjfY|KuHcC5XQ_
zf%nPc0Pn99wRlp0KXR-R-WLJ4Bo+Lq&I!xPrGRqyk4^bkZNA{D&G<)mM){JwMtsL$
zBsphQv(<bS0m>UZYDQnnJN37L;#$?b;5i|H!m9<(ifh*#xWiM))cIYJD}Tb9ZDp;|
z$pLHgI@=o1(8vE+X8TXDtU~RX=53E{-)>n0)r#}#4k$CV^-;KEyw=FR8S5m-5LveU
z8cDk_lo{JNDX%8MS7^Yt9l-bj@&0E~ih}Jn8*}5rIshF}3owD(vp&ije|cg6R0X>&
zam}aBP3cbUB?Q1(2v_kadK1^9He=)4DRuatS{O&~s*X+F(({D-0K70nSqo0MAJ3B4
zyc+ZqpM$Uyt|lbsALCeVxCZB7eqp#j@5)FfSe!4D%}TDE*%=-{Sa=|hl@d0RDQ9v!
zE?GV8g-;}`HnMNlx?Rwbk15Zx7Au>}_aCh&bEE!RpbBndQS$~UClD&G);c1uY2G@J
zjtSQj=pV!*fgWugjK3N_NuJ$9c)H=CJi8lsgonuk?I}#5)rNua2)vuci?D^q)8UcY
zSGLE(BZ(^5A(gw}BlsXjdo%%xtJ*yVryHVob13BdDTr5Pa3c8S?~(By2Sz(Q{xRcq
ztTVxx6}}6VVsL`%?JOly$#uU>rot0IH<+(`c^?G|YO~{gSSv`e)hSM&atdnR*v6vg
zQi|^wHM*F!HbEzn4=Uf24?(+=&&hy1s;CP6q7rXS%i;_X6n~Md9-Rh_;KPV*cQn4*
z{2&Ttr}U^8b21j!n4YHYQq2;+Tx)}JWm(OsS?PDiRjOCxlJwNL9{LEG;Hpv<bPwg`
zuX?zeRQ4;JhS$vS4zkS(FaH#>mek)K{=OPrirF{#(M+iaMLRr|S7XfUist&uA?QUS
z-4pj%$<|6gNQGWIj-peicZN>^bR=8OhNp?cExYwR9%_dPrS&O{cxAWjZK_wC#)#LI
zqBgkEo)to4ZV*_OmA%FyulqEhlkE5tz^|3&!Ru1!22a^r_dkS?#&H@~c-@Uel(Py-
z*mJxtDjx@U-Lv9kx%z0O<R!Q(;n_s3^tw-vA-wK066Z4$C#oIe3kJPz${ROm`5l)W
zIz98yLq?+YAx|3s+usBBgOb-h2Moq%YpXfcQwaZDqUvBhFQx~)0rF|I5!Qw{!Zl44
zErxBHa&4l-Tieriv^LdN+D=A#%0jJ%YcxDxoKJH?DVBQ4R#`bJs&uFbEDA-B9qU_&
zSN@y@XC6fb(e8GL_ac5P`O)xOw4v7V{3tLB-mS~|1y|YK3&3S~vAY+h+!v+X7pL5p
zq}-RL+|N$ApObQ5mU2TgqUB6n`_MxV?N@OoCgEeBA-fwA=UfzC!K-F>uM}U{6c6!>
z$s?+7Q3<tObcYB07IC&SY=;;wg~m{83$K#x<ih9T$Yq9|@Oct3FB@LPdoY*Dhgajs
zk7T9`Ufp&5Yw$f#*1maw&ef(h+;F5N;!}F05}Ro*y|$noYHj7E^g1|{Ue`oi%S*{k
z;>h|`dUqs4RUFQS*9pYPP)1oA$r4Cad_IBY?1<aPmRpN?y6D-4C+X9WtA+lQTkoL{
zFSt(UZ?xfVrt^1sWjp`iWw&XBGHzRA+8QzAz8CP;3!vlEvjj!2;SXgRE9^G7W`n+O
z7O3`hLKnf5TOWw%{!0>OI{%hew(}oecALThnZ~p=V#fWTAfxUVe3(kn1=nm)EWbWb
z=(-jXv}kL~t&c=>|0@YIof&xzWjYVZJKMotgFb}?QiW(MKwHAy8TX@t`h~&;ED9H^
zhO&*C-3IgS6MSq|0(h~l<KRX9?AG<5>WGx>)(zs6jN7djiBoup07SMCfMhoU5Sqra
ztbM%oVv<xV6NemZS>cW19-la{=N_9_AG;?hH8oai0NGB5?jZwD8EXQ5@L=Qk7;>)N
zmKfV^5ArIwV;ei-aBtBvlr{iw*>)7xQBxQjRFh~5x8nFW2?c||iIUg8Z;z+ZE9@=l
zgku|TS$5tz7f0#FO*(j`ZOT|Q+WKcNdMrrNXva6+vV8t|=cI!c5;RVb;c!t*N$A`G
z723SAz3l%xI(_0<w6QPKi#5|}=9bLmcd6m`^5qlfxtGUmFN@h$`5Yd}r@IZ&H%1ZD
zDvGk|qe?-=-$7t)H=@&s*<#o&zGZ#*UZVKsipZCU2w$4NtaWt6U#t`+$2%_BZ%uOr
z_DqwiafOM~QIVt17|0BiZU%Sj79Q826jD|v$2eQJ6565ljVgtm>C6+4)3vF))yCM$
zE<>fvjLTrtZQTZNby8w{YFFSF<Ux%JIuv}ScA(uBOiuW6;Iw{-&V#Sq`jWOEtyc)O
zd8Bu2+J*ZB=PL<n-YkY$o`#zCK%!5L_&mkd@p-xRWle8)<`XFmPnkEc;th9#q3A7G
zV^?Z!TOv%jyLDJ%Uqx&~qr}_16-w^b5s7(q9OJgdzh#1cr!$Hx3vXW$-d+QQPyGzW
z_O-`AE|Fb_M@lfC6u{R3Se=v@pDG@dBG61f=%*4;iBZtO+`7*qr2P7Od1e?U_=qxq
zfv@%$K!AaaCf32Q1%w!r^jiw(Bk-VXWUz7U%n_FeY{~4I;VxLp`ejM$Wt{}?*XH1@
zA49Yt?Saj~N@Rj{Bv<yzIe!?`3h0mEs>}@3a_b>#<(1D&#Zwl@$yATxsBn`n=j)v~
zx||Q+3Zo+hZ={$h7s|zQp^x=aw&KKizCIVv0daH>k26xtrtypnmP_S9!)(mwSZy(V
z+n3-K@s#cGZEz62okzi)q8X3I{dY*{ojmODE}oU0#ds{^?F#QEq~zwp9*}<zA%pqw
z9lV;aN6Er>;u^_hTJPe0suL~~Z#LK;gJX#}U2Oj0oc~1Hnh`H^iik9PHxcDber)?f
zxTsdj5PA<mD@j90q4DYI1?B9PwM42EJ#sxx_yhSZ2M|V`F*eI()?xQp3&@^z>++e_
z{fMn<cNU5+I-SMx%5;{?E8AJht9HE|z85U@u}Bi@@igB?78Zr?!&$4ySk1AvgO4&t
zUi%T+%?gI3efYE#&ijd|PD+dq`Jn6e!+b_yKA<oX<5z$|<n-ib3c**?ey_~vsm_)v
zfz?K3rL#q%s||0Z<BtKaZBET~GX6RwN0ybhi{&lt%;z9caP3YW{Mac4d1X6Ad9^+S
z<xUQ#nVRW(I8!<JY?1?s(Hx+?pO@edlhjAlf!h`Yv~7;H6`Ck?x%CC5>2wB(f##6B
z?6$Osof2--D1zyWg6Sh*3O~xjZA;`9UvpPpX}n1mi*{QY;`(CGZ3{*ndDcB2GuaIW
zD*pZC-b0UV>jd~f+T||FoC!Y$>O!!`u;qUoSJB2$r)4SlpWsn1;QJ(w()3~gK836C
z?dhRmYlb4W78_l%Yq?saM@4JZI_c6)pYdC9@Ynh@>8jn&@a)ob6~fP{|MTMiLgN3T
z_`j6+?-T!*6aQDl|JB6*HStd+{;!LlT*mmnA^vYB{%?u@+ll`>;{R^q|DO22pZI?u
z{s$8OgW{h~{67@`k7EC%2(z}R`3b5)jaf|OQ>fi;w|>mKgQmsZrQ<I|D>~GR3|%Mc
zkO8_a0JRIv+xF?e(braGfN8&<3ZB(=TM~pn6VK7jA3?)59d%%$HHm+WD0tUy3)Xt2
z`A-4!j}>J8&w=w>=u_?1D1LFX<n-dV)oBV+K-7_}bpvHbjVnh9x|yth63Cd__yyQ1
z`+C|7GfT1vM8$anGZn!S{*uVjyaE4Lyz7O?v2aZ(*IWji&Kj0-%M0PJ1+KZ0utibx
zWte4xG`Fid?(M2Bba(l`0m?A0_4Wu+DE<sjjR6J)BAGV2RtSG5kKgm?uAl;FP2CH}
zjQgNeq(2Z*os<}V5k+9;xvm~yl2-EAaGM)orDkh`T(Gz7LtctreGkt+n$$8UBsND-
z)Z99n4Sm#XsgeVwT>Y@c+h2mKTFHffgqD94>Bx*GAVWDbooPZBHjjteuIi$k&VlXn
z|3r$KJGB7>I`v?hwiV4&0JGmL!GpujOhp{w{{ovTes^jWl`)m-$mV&ZYF;5pH%nZ%
z+Aoi3k;k7^9ung(Mjk$$OyK`j7(dAHa(F*4E1R1Yp#+D2i&?NYtN-tkPLzy1h!9fT
z(Ef``G+#t&pIp1hSOUU-2>9nB?OGCP>Nd&Ys4AL~u_&!6WGDQmq(Bcc);lOSn%8n>
zX2HH>&}rX@78Km0vKGnt(Ir_s`JrUiS_04$trd%!+k_24+Ppn>jrmRdw7Xi#{socN
zzj<6InB#;;+gjIK<klVaPvE&gQ#DzDiSRLIzrtzX1S4jlVRuBLoG4WIAIVO{*g=nu
zACq|ZoJWlR-{V8~{YOE^xcu>O_p3)iHzVl&Z3=4fn*F0}@9}Wi{&$Qn%G^Ve{M~&m
z<Y>}DGDJR}B8j9Mq5_55$NPX&&8bY=X$eN)nUE37<AP^E^SI!#^9!|K^z);Np3Xrg
zQhm{_9%q>SkBbtf)LcqfsssI$BxIHhFtFyP#DtrbQbJ~>#Q2$;@{TzvC1h4gOryCe
z@0^oTLT07JT$`J6$DEWBGAkt(Uety>i?%`j<_+jvvX9YMXe_~Z4!UN1L--DfeRXDX
z(46xqA8M`X(`R?pb9D=&Z7!#G&EZr+W^syn__)d*tM75aGj4ud@Qj`3=H%`<IgyZA
zIbn<)$^0<njRAyBv3vPt>zVA1hBF$tS^r2HWf8gCS6Q<m!*Z~RjcL{l=i=LTWFJ>q
z9d&6xJd{ziKI3;5(434y&LY5UFXMKZk8rK$?UvtdNA=;4`+Y+v)#XRjuw)`5V9}7t
zmg(=60YNo~fuU@;peM7xzylUbd5V_7bga!K8S9GWD|A_LlBkS-Axc?ot|d6cY-C(I
z8jkUPvs8e_kUP5k0yP*y7Mc3uCJ|ny+B`N+SoBQ7M#&p(F#;@TistEYd?`2TFCw_U
zAQuDXMq7*#4Pcad^M3T4lh{=mjhdvV&cq4JQNqou1x8~0B_!{zR7>s0lzEFmW+7b0
zqsF{`)}r;auu#g)i{YZ;GZK~j`4hbBwp-KS)*kq(m2gjab+P&iA(mdj$Gj;NC$0lS
zN$ocU&b1&`sCwbv0_V%)2|Nb9u*NGN2Kub?RKYB-cvF%gwQ0fz!L3z1!hI4jk&l2$
zo*n^A%16MYRCWjE`TGh{$)`>vL@OVj8EDDMhZ(Q0vp)9sc-_Oc_D4T3-pXAOc###j
zVO!T))NlJsvFi%cg<ReB%nFLzut#gIe<{O@Xw4#LRhA|AR)LR11|MtM@!E~z3-^OV
ze;GJS>E#cGfDvywYtf!DF2~vkE`V8=yaaNE-LvS1t3jG(u`7BpSSjV>tcc&S!!<En
z-ejdVK*num3@cSb)3%;yRZfcO+m^Hw%Ox*@Ae|TS+p=i-@cBq&;#ltn&jff{KhZ`h
z+#g1YZspPrDwOf+IWIhbkow+Tsg0xlf#MM<tKT+tQ5r^t4<=OQ*`5IylR`cgY60`!
zU&mV^+_vCt*j`N;AIVghZeu;ll&kO_t_PMmf}cu-IS988djV@wrE<3JA@6JGwjL<U
zgon|Yw&lOkZ14G!-8xtZk$Dz5o+M7v_6DdOL@HxbR6t&o9(pJ1DbjZDfeh@nLbN4D
z&5DA(RYLqjK(%;{=Z<zJ@nXaXh0b-xEhIY67q@A<9qTpV+f(qF)Q6Hfjj8AzMIRv)
zdp}wMbyFKH`H5fNF^rvZ?~S_={Ul!8!9MPo-Ik1PhWJ3Z0g@XRowczLRNQ4e=evt|
z7Tj^38CGKoJzl>@>b>Aq8<D~=>%&*j;=0WpRMm+8!$21GD@vk4+vIAyuLGHM)@1y<
zFEz5vd)2AI#ku9hRinA(^VU2Q%$iuy2Ny@oK9Q^zD}%wZd}Y6qs{=cObJ+6oI~6uR
zwsA1;v0vnYV71$Psjy`b1!BG&#G?=_q(~(5)kbFJXpq%Wn2Cz=nY9iipDW0xv!zVM
zVtwJ1=Ig=bN|!v}-HO07&3g#&4=1<PhRq~fkATd<%ly)l!BGVVdFjxuW?C0f^@~oW
zbp&Zj!&a_!B#sX4ZpLF)sfi%H!RcjgTSDqZ^EOQ$jaDw2v83%o$!toYw2w@qiMwJo
zjxcpy=GWSUtrXrBQFs(Y3hwfWP4z)`6rBYR?(!dQx}Ts8Cg|xJbT2_RWgR|Kz4JHK
zJx8jUOV;F7WNh(V-r;$~S4zPGJKTgT3OpJjxv`C<+@;>-tAB3hJuiX}w2yis8H)Ir
zm?U(Q>IC!~6<3$jH!V9a1$9o%oj8<5_D!sqrGm|pS`QZscd5v849!hoXBwi9W(0K%
zEH1coEIgL?O6?ik>e#c2V=&`E@DsupvlsJn%Qvhl<dn}<9=kA>Z#c8&O;{6_rEk_%
z&NQ@6A;lAfmdd9(etu!$rolY(8d4-?3n9}+R<LYBLfmsoK}B2x;wp)2vAFC?DaV|p
zD2Nvx2X8t@dNmkOqrQB&V`m;E$uP<+YOHkvzo+p#m)~>vJ&)h>`EBR-3Vv_ocMrc0
z@%s$F5^1H)k+}i+i9K~<^v0O5zQ&J^-=YOqH&w*S<EGLm>{od+V6xVJi9p-mf-=->
z)rrk$<Un}5Ft18pwN;zv#-_nxpK*1PzG&oFGB36QWrIQEW*XnDvs{|LeD&{4m~;iM
z0BjZ&Eu*-yL+H|S=JM6Q^>X2f%FE>$tiiF)E@TT!!f*$nh+8zd^CsN2mI75C8L0VQ
zsr=ih(Pr~x>m=}BlkD)RCEILjQy&v3n%P1v+2B~4`gjt0Z{qw!;=ChqZcm&t9*U5C
zGI90{r`pt~lF+*o=cf~=jBz6jGJuSny~(LsGnd^>-Y92jOK9sY8n&`dpVt@L;mKs2
zcHe(8Z~qh?;~T5TEj#Dyr<uM{Y_PiMEfeM)WXyI-&kIilj-sYva-Arml<P&%@oyyt
zy|=~Qk{+rYgB9HRe6K+<KLr%7!mSh?mbtHec<Y$Q@vl-+^(D;{$qN(57z53xOSW{=
zTI)0tUqkzaRA}KPU$>GL`>x#GgO<F`^l5lHFx5tB<?z7Fg0<95FIXHtbxs&PON%;J
zD3Xmcc$2?@n!9}d>VaDGb_n_#3EXzI$XWV>L@mr7)70M3?grw+!{l)|kI_-HVnya8
zZ)d_E`78Tpg3tD8wb?c$PhoGJuos?<ub}a+PZJ(F!)NrIJ}r3+KvNw9oP$&MQc531
zA7?SWS9V5E)m>wO+F(+^VuKZ@^Cc&DYUR@6wB@Od47jy$p_M<497=gfdMuB!Pp?o2
zpT&c;<J+D}^h`yb;rWD3ij=ioJ5mtvXPfnN)GM;LoJO(vZUor60C>tOBb!y+&Yl9$
zmS;A+kpSZkUn~X5s<}is;SGJh7ezk79j&N8ErPV$5(p|PnCM%^q9Vy2Gv>XE%`f!G
z3o{S&d??PVfTsYy#;eE*eCt{qC5+wcc(W^oevn<QhdBB62f**c6&oPlMVuO}!2))(
zvJ!cri0Ju*#?4t~pCZe{nGn06u=)qN(a~Wyd;#&bUHuF=x-rMCj;aW%n)^1|fjuhw
z%aE|OM)IJGEtskl3L6nR*dDyXi^1NZPed4^<7jMg*fu(z3zoQvlJ^2*B`-1R5G8Lc
zvn$)BO=?lK-42S4y?lwF6()j1435Ekqtg5hQggKasX^6Za7Ah6QwiC?IJR;8?AEj6
z^p36vu*5LondQ`R+tY>P4xKAo-d5V9#>GBx9bAl)Df+uYhq@BQtBd$ksYwm?wzYmn
z3($dE5divG=+LNSY&G8y@@1rsj6d1>7*reX%GTwAlDZIqxo#LL7*SV96wO6O$61#3
zMQi9gY*$AjGP6GP594NQWCyz|BYPw}7(Nt_wlz;j$7mPJ!5X_QvNM~UZ2zSQbF}pw
zo>jNAn24h7$!->uT;%G7S3)+GByyIB!@hlwEnA*k+uz2sHf^`1)M<>IdJgjBIa6a-
zjOJ&?y&afV6LhjIHt^Amz<|iS!dv0*0MQ>M8@2!|1Y2nWHsdOK$(TlWW|ztttn>+<
z^VXc<*`8X`I=@o!Z-$JHmx3pm@Xd$PRF&9-zr9SI*FJp#n|SS9Ir~xrzALT_vQz(O
zUS5+!dkeJJUxg89mRS!0k1>Gbv46?h_6oDcDs_OF7qQvNgA`NvT*<@QKa(*x#4I8g
z;Z?j!UU)SxCOG8fh1c+u%^w*%XSiukkh(J3V!Ff)+r--JyVY!I%;Hpx7j7k9c7Nz%
z%afpG^P}!t7#G$v_ywEM<PK0N<l`w6!RdBB6}2cGwXQE}%nQ5VN%#sD_QfwuC3SVn
z!+J+#NB4;yGfpl%P_quhN)r}QAS;8sn8!4O2K<X@3->0H5mveN8yVZPN0W&iMz0;_
zVq`A>6CRnNOywz&rZK8dDNJeYePE%z5S<y!&(fKzRcDH#GpjCJ`vxHMsy16>Kqn$x
zN9$tgXdEjpJK|MFazR6OcI-6N!fQp=c^yczcViMC+iD^Q;|_M#u(t*cx-VaL!|RCF
z@p`Z>q9fWjQYaVdei|QpW(>xnV$7F|+cr?AH7Qw96?}qGL3^f>s9;n<?Y30%7FEaX
zFcHSKsu}mUG7a$&<m%HBu<1d<4N1E#?QsYem!X}AR>vLcYSvt4x{f2tZc7VNuZ;Oy
zz+~XU6N&IybY%aQ*9}OiOS+iqEb0DI2x9dYs*@7q!&2}R&!@c)MoQ&U{eW_*O>dP^
zbHjfjfQ>!fwv;6i*9k}06NZg;1Fx|&!x!-i?)AvZ?*#LU@ybagvLY-ukBu4i;(B<1
zH9aygMDfwq*%sEgh4rNNM0g{K3+}Rgm&(W`Lkx;&?ZNLPel(7jyKL1yVm+-oi1F#F
zhC4Ay;HqlPu{R@zfm6kCL+l_+CIlPNIM8R~Ak#Qxp86{cY%q_?PNIRVhK_)iyjtTh
zv2?()-pTLvju{1ALJG9YlJ}2!e~MZ#2<%^ZKLwcIlSZtuxADXHwXVd!_I!YyQ8OoG
znq@h<#27hg;1_vkZ7g})cfgt)YY4{JGo1p>ZG3IKrQciqGsm=h)F|m7LOLt=qLHja
zOPL_ts595vKE`lDbHsJZs7<e9NrO2$L!}$k{ZF8jbv96>2zXA}+ja*GDpJQWO}PY^
z&}HxvlM<Fja!xt7ZTsv55@15p36!_IQ_d%B#}q^+CN!M@Gt3<+IOW2&x6h^^0VXt^
z0Gr1hDLT~JJ7*`5027){K&R-Al$>&D+ugGhNPr1VC(t|$GJk*|%7fue=<~=><Q?*_
z6m;{P@;oCx-jcS`JdZlkd=3v&<;`ehD}J37^S6N|0-7YSJk+gIvr<)>6=b)?Af75M
zF=EvP-9|smuLWj@!bpq^HiG7EX}n2j%+t|`lJ;*VRa~l?!TC;<rTO74#HE#CGv<hC
z5BpM-;}rC_G!E!BJZ8dMd#P2EHlIymHSVenXJwG}ZzJ9)nMOHVMP9NWSk@6$FO{F+
z82fM^_Lt7WF16pFjBrZ8oGLjo5@Q?b!}hXS*dCtOEz%U#ha=_HhRINgL!>>LOLsJ;
zJK9J0_Qygu%8;~peTW;PaSKeX_HV&cKiV!Y@EOdyBb9QcG31mNq-vs5u9(8K+o*mt
z-I*&_bl1vGDHH%y-yK178)za`PGgCR29wks8Jk6W%+MY$j|=UwZFluJcFN<sqdlIY
zJ>H`|mZqJ?(t0`KVg{eS#kKy%d%d*nm3{VTeh#%ZJGPtO>^W7-Tg-hi<}k+WD{+sV
zSuj2~+=;j7cx|z^z3_6fg!#AM0cmU#UW|Aan6_BDx5rSZl-$AK<Xk>?=J?s1H8mt;
zN3qbz)JJENSu^O>qOdj0I7ZHWSfdy_b1+~WDAT9;{qAXQ>v3T6^D4>D@$)SIFdWVM
zi49+kt9G(6@1-0^YmWaK340nFwCr}B>`|pqmy9!Z=1wZ7^v&4E(R{4dHBqL5J26A(
zno5@eO58n3#2Y~|Q0vmfW+J!X$XM7!G9Oru_A>sEPNn-J9?@RL?}`8WiT?-Ue<1OH
zM*N>m{GS*97ZU${;{S5u|C;!x68|^E|INhz9r1rR@qbbLUrPL65&u^c|JTKTf8u{o
z{L_j5TjKwA?4P7d%1rzi0c{s?Oo}v?FE?(H*VHQs)%mpL<Kb%&zZ`r$jf1bzqO&BD
zG4$(*8eerFu0wH+tr=Ch;(a~d+?xa}7}pYr!X_Sq<|Y%<I{^FE8k6BGAnSyGheIcP
z1F7|7p_XsfDp5A_XXXK93gP?cN;IJ|<aG`qEki?wWU`*ML0;L;Ve;Z!z~TDNc8<`u
z+c}cA<3A5o81m|in!gjBOvd%Pam;@nosgZ?=?nG>$SlUjA=kV+M+qJ?W70VqH&|%S
z#Z@mfGdViLt0cAK|BRtl=NN?^$_?f1wxsl5p@jXNygJ89WLutO>0cymX^miXD`9%T
zv~!%m*ll?Yc`Y*Gc8<rbb53K(<zRHytXbLXP)b&pc1eo%8+rN^Kw!7u6g#^I#(nJp
zIA+{GOJB>pG5xW`NP!34C-%eqMPS~fFcKptR|20VGw81E2mGr5zEuGw#;3<KTMmof
zj{1?!!}8b;XY%lL3u1E<PBj~3&-^ba_KCleoBc+c&k~p&mzYM0`dkPGa%K(7sk1b;
zUD8oevA;E$Y!Gmp_Y#^(k|==8A-UFa*Rq}@_4*<BlYQVv!km$(-4<1mjpTM)bVnz{
zif-%eWTJC~f~gX<MTLAi8e}QjqfVbH6pWTksaEz|P8msAkNK~rh&b&b>6_nxtz38~
z_(lh--Sq^iHDsj!HxbxDDlm!hsf0oO5ZiwX2n>T$B}S224a2*D!(Nl3@7|3&FNcU3
zMk$$}Lng0ehNJD0qazsD!h9D3X`=r~h)RqhdW=1FZ(QLkngL0!v@Sx@GWi5YJ=)Cp
z3Gv}bj5>t%{|z8xD^6^tcC?R<kWNKLs}j_Yol7Uq!e7XOJ#|_?7n&tQIGVZ`E{0DQ
zW=zI8@q(Jeh<^_vsXrm&@f~;~9-|OxxPfAHRFGr5Fx6l3M%<pxesc1fjz;QpcpaeP
zk@h8=)O6B{gzo~+NGTW|F8S{k=O6?6L7f04<UNEme$M1hX{Lh6qRAaI1;9|=a8%9>
z=XFMOC1*U|D>#ON%J7i?K5@>AVCID<OYVmJ_Y2A&gK}u5azYPfZghr0$fi1`YOiQ=
zQOOvA&@M?#oO8hzNv`74D7Y(UqY%j%6cOB*!i`{N^h&Y1&SL<{jKiLD=tco^uvGjv
z3$-YEw<_f-<E9+UoXGqXwn)!KNx~1nV+5?(ma;9+kBU`8g#II?_@H1&behB}8I{$T
znQs~{8$C-T`$z~?;pXNb62F=W<zd62K{KWTF&QMrke4RjWF3S4F=a%vKB9=F57IOr
ziZd7N`xvpz7RN|R9Pzy1DU=_(8B!P{H8CCEWl`%FH69EMlox5J%A={mGVQFH%r;jT
z1X;Z}Ayph*m1a6s_ru^Z&1-lLjFj`|)MM?S9-FdcP$D$tViEULQ)TN5o5cdXg>KWn
znZ5m~&fWB|H0%YRX)ewRn7s#2v6o+I4_W-#)*I}-K4aWsqrVlUrybDsl$7<MD<_->
zqi>HV-gPgcOuRQ2K)o68F!x|Mx@K4On)^t&Fcf}-oN<Q)eM_O#`Y4{kd~_Sk$MCrI
za=wx*wT2%TIT-1!iY}QbaQLS_ny(mdcrOqN77X^nB$eC9*=mpksg=8t3?_O$`~>l4
z`OYBee3Ae<07J+b<7^Sj3zc9%R-)bd-ZZVB5;C9Wkp>DsLqPKY@)mwJiCU5duNask
zVwlQ^7pzYM(2%+t6{t#ExikD6h`t_vo~L>#s)8af%b`aaYMEQVH?yvY>5%U}slTiH
zmvnVsAZc|{VthskfgG+2MsoS^i-e~MhhHLK&8d}<d~kR<$Bb%zgh^C6d{{1q_YtT2
ze9|eHq?HVZU*@5PO!yUCWwz<aNjyVg^?R4+qa!2DlgKnXN7=Y#4v36LJ4P2ig7R>D
zBsxa2nA0*#n%63hrR=b5z5u7(>l5s%E^EG6!u5oS8lUB?SqnzJEexA-%b`~m+vgbM
zU>3{b9YUAEGso|}%65PUYBD{VkuJP{Nu?%ZByP(>%v89tqZgOdi<w3aY?R6T0Vn(_
znCdwUW8V1vqG%><kTh$K+Aq{$Z5GaxQcT)kwP#H0=`z|=jovSvj>$(&Hw9)d)tYp_
zPJp9L0;5j91i^LKF_^#!&5|?q_SmTK&xJ5&8V$DlNxUb}R(J+YM(|u`>dt<^#S!2)
z0NhIe<u5!-fRA&g?(PF_3_DYw?hC2Mjo>#)Ub!@cwj0C^=#?;{cc-MyD$}CoYNOcp
z+<bwo<<B;Pb-UjJPtBg48@Kyy6F!T1xBDFvzP+C-xBFca{>j<l-!tK#njQXq6Fw_<
zZubW!{Epf1518<~W`{p$!gtILkMh+o&w7NvJ1wbpD~}%<e6vc|?f%Gw&yfdH;3B^{
z^7x4fpCgZ-n(#UDi0ICd$IlG>9C<|e=g1?%KSv%B{yFkc{N0}m6{(A>BmKyjx|qwD
zibzMSb>$bpIWmTJGp0tx_JP!yjMkZ2##EX6(6Y>Iy^4*s{#p_t7ZGa(u4QId8YX9y
z{@h9vMMyEkX=mkeuLvYnW1<kryGaxU%&9;kwLXa1jf@D+0GPJy7IJ-<^yfPC+agn)
z^tZ9)^-G}L@aa-#S40pifnXP18X^~N5(usmhzy%wk&G4D_ewhx*L6YVslX%N872}S
zFb%JJ0<y;jI#Em)AvacoFIl_p6fEm-_#4Wyfkk-~?h72Mrx~SD&#2K*^ty-i_j(+w
za$CQKW_40x<V>^~hL_BK0e?LKgF~76VdnC=WFwE+Z(qxYzae#HzdiDm@VB_6!9|rA
z?iNe~n#)(l!ru{-4}Z^-i>*GGXN5H5|3Q4LdFpL-&F#`b{gI&h1oJ^;ZT&5PMKb7>
z&f2X6#!24MOR_3kuSB3?4w?by+EWq)7s8Gf=h}l(2=0p!totBhOo^?&U=CqNk*Orb
zcoPG<=g}&I-2-Eidvj0M{Azjrn%M4Sd}!!b>-&`FH<%evweJN-{y)Kd3a_dGMOdD{
zY26EQJ!$+eP^LRrdl{jzIAmCFBzRD!DIP{8e-?qpU6@+RW$h8y?w_Dbgu6V2?Z?Q*
z9N%BZL{5*01pB{`-24U9Bg5t4(HWPim_qAsJY*szs6RQCh4Qff4~f9~b4NzXBaN-i
zUxOkA5t|nO1We7~bwx<XludcK^)CXM!tO~LbeNk4)9U6CK&B!e9aDKE{5KfubtCU|
zc~QCkLll+k|9An&<bu0)(CbNkR$0wTdmQ|d_P?pLUw0F+y+HD$+I{J)gi<IZ6k}y%
z6w4<)GUyY@@B&ksk)co?EiW)dc?oppsO#w|;xetI#Mga|k~9KS>t5DMQWg4K@=#yg
zysanIWS-N^G)AnCjFrbsH!{o`3UVqm@`Q+GCsBmWkekK{OJZC02VfLiwxVMljy^Y+
zmn38%sqP?^*sVut2u75YwGuWKY9D1oH6Kx}dph`wr8iD6vo(eKiipo-TdEFpOmk$?
zjEqMbFm7hul4*hn$-0rOmY&q-1dl-x*QYay1N<COl%HjG1D=pw_Zi}&LP{kYV%`kR
z$s`oi@}&jW=0OI;L)lZbn4=)klQ?K?2vXTlC*vG;b7^JY_Yw4KVU+2G><uAf?%Gv`
zYe}z@t){})&y8?uSW?@EJ^vvo*d@(P6jltg1-A}pqLT6|s|#h1DcM7BN86h36HqUi
zYc)^~8=w4l!h(#-7HoKqX<<az{?nv>FDfr;-$v#}mJBbEEw_cnV0lrcHGr!l;pIjC
z=Si*o@W|rw;&o1fVfPm@(t(>Lid~@%mXW39rR%<$wE9x*MwXQqYp>ax9qBcV!7-8i
zd#yluS#;v8QC=3QT?8VHIANj|QHYkf35h5)8f0)M8Ie2Ow5%B@m>weXJ1_~b+7z)d
z#wC<-SOmosL!rD>?TWSM+KBsasgfBSjGISOk(re#81W<Y=vqnk3z-_6Ddz&YK}Kt_
z+%GAGAzOvw=mOCN6J6BwS-5GGqV)7qbb#!%$%aw5Nf?C>GW^xLSz>%FjwpPn?8TD>
zW)d}?IhZGx?reCy7LdwEEY$KmHBrk$>$XU75B7RC6>#3v#IuNsq@yKaf}@ZWps9JV
za~GILmPY_m<;u&`HO>{Gn~)*5yu6%mF`-!qb3E4m0sh!qbX9q<vAH}{e|m%@#p|Qd
zok-K2m_yfuti3*wgLM9p9D?RtdT<fj;*Xg7;J~;<;(=!hoK1DAlsz@^UxPBM{e<1d
zEn9{42mf7nBxYtR=t*x!A~y08qz|`m<aZw?)8z%d(+!`oqmNV<Fy>Oud*fPZT2}7J
ziY^B_wBJnqkC>?p^$XQWiSZA{&d_nq8t@%KA+)m5oW-$3bBE4x@^U)I^D-+N%v8AX
zVuS8UGjkpo$re17TRBai>6|DD?aoOi{mJsGbe^ne4yV3?CNF4M4Jr666v;(fg+9D)
zTcB%EemC%@Z7H`(ir?;>Di|}Jr^w6coF=ca&gs0&oH^(QXQ7iw^6FYwq1m)Q(HKMx
zdO5+UyQ+?sn_@?@UX^QtBa=w%|Ax-T$&rw#UP{eos-;k$XUlzDTFd>{QM&OaEVd=H
zrPj1bSAu~nhqcm0LCl(@`a@%&a>P`bSUW{#g^!2hLT6(NvPV%Hl`8kxMh#9bLO;6|
z6b^Fasg&kHs~7wJ;Tmf?X9lc&YMfKXf~egDq^G|S)OILtQnf)a;1LVYfTXH=N+O4@
zWcMRwkkMUpjL6buP@xb?mBF?DNA7d^ogB2;7#s2FBFLB)RR%m_GU=slxV62Fm(Mh3
znRH&oJap8WPfV0l=@=<Q0ZdFqoM%lYkBA~R5&@}mq?oh);*z=YC@SC_fi$&%yf&`x
zLA+`+NV!LF5z^iWSr+E?v>~&rhyI5vd5!M7)`bW}{-#*}HGOaMAiAXZ60|8=j;Kra
zhd@6mgWFlKy}mqw<?`m6XC*w5gb<Z^4wn1$&+eW<wbA8M3<?&n%TlZ6L8dw>F+M$K
z(B0S%Gb}Lk6-HuwOwqvKAWhBjb|owm;lCZp_=ic*r8XPPx7-gaa<G^9kvN_M8EK#H
zIRTa2iO<=DJHWsMyBr1%i`Y8;DCruW@enphSY`F7aX33J*(dK9_fDqzG>?~n3#+l*
z8qqez>6{6(w)C8iz2lO~zQPXe$Y`7!pN2~=O(on*lQf=MroPmRsTv2{>i5aBFGyHX
zsz$a*!kjbG`xtDWIWw2N5%*|@WMLg1MyYh^F^qrLY#_52fi~OVG7=o*4rQ@IeZqqp
zNSW(FN=y*DCWwPD2H+jDA{Nxvb4KQ4gxYdpnH*eQyl-C5H64$P9695_*{kk$bc8ht
zu2|3=53c_%fH}*lJ0FaX^AfuG!T1L8y_rPD$G)afFGu6%a&GnIB*or-B`=x4;JC-L
z#MDX+m&Pd5Yb=|pbPYh$xw0z<WZi3Is$I`tTUN&^++gKs3I>GV=OGXDzieleJ#%WN
zfRBzeV|+z?Z|eC<_=G(ZH)xN#uvf`M%w-L8-1+!$%sH$qTrIpgE2r6mEN8;yuhp`g
zg%MAC)8A0FbPekbWH8!6)28}m8uObH)O?qOk4tXtt;i$eFH~*riCd31(Ic^sB{Py8
z8*w?az6g-AJ2QZDG0si(J<QRe5l=SaCP#;i<ijPvWa^%m(OW?kVaf3?g7=2o>L67N
z9%0GJ<-D9bI%bL|qY~gO&SFzI3Np8ZG&ry4=A>V$?`clXCD3|&jvnL`w9}lQqck(7
zG!5On9;eI4GW>ycV0l2xRobKdkm*UHhf@1EZB1UBVJlq5yRoRXoEKLrPVl13&`3Aj
z1D{*_w(*C1;_L1uaB@{5_q7&gxQr2AR!Z2U#P}F6fsd6D^rzw+Lpl|o8Yr}$ps6HA
zu80fdia2TAS~WsC!a#IWo$x*b?<Ys)|3fL~fcR@TJ1s38YkBJtiR*uuf{;^ybpo}C
z8C*QV-Q9izKi6>$;FPFMjlH7Pzs1e5p}4j**Wfgx$4lvnu5r8P$4&CHaLl+%r4gg|
zCaV%7x7P*T3;JP}3Ct>JR3|0Ir)><n7xu#}7npq%Mq+&0hCr^734AO)j<DGsQ6V|8
z;8t@TdXY@k>rm!#zj6n%AhhgsFX~4;A&6Okfw;u@RG6T9aX-u+0`n&FSDlm?-4xZ@
zk2HFU@jO~Axt~9S5fL1g%fA%yVOQ@VM)EJoxim4h&fhdf-R5ZsjAljV$HLX1s3Uvy
zaShI(5O>3?Kjii99K2`oc0pC0`V%Dl{ehblVpA&!G@FIUTVWDYMe-`=Up`M>$$ET_
z&gs&Gny!>_I%TqtWaj`7RVO7z?q&;oa0VTEY1vYTA%Zz8p721x3c(qz{YX=k)BR5*
zpc9hJYs=Gsc{A>6LAsVmA2A2vO1!fm*7QT{jaQCmlBDr^b2y5QF}{P+P+w1Ed_Lni
z>-@Xpb5a@Wg|uyCx!l?xGzBd2D_{n@|4QZQX|P^jYPaQ0PkMk*K1g^&EP-z2s&Quq
z0Ug?JxidqY*p;&NPP2Uo0j)zN6#Fj9WNQQd;#!p1^1{P#mx5=q&+%|vgZcI)LciVQ
zS#6B3bfJ1+oZsq5rXvv)Gb{)7C3aq}-gNVA>P#j)0t74{`ky2yV27FTkq?g~6zoUw
zYP=HhaB%1HL_Gc{05+h8E#nT42HXpe;kkYzCNJ3${=1heTeLq$0nib*bu2*DNr~~v
za-fGjJ0dWSDXLUPjYLL`R>ZP=;%;P#M9iHe9qZY@GG!#~51F+<U2btrj+RjiVx~~o
zpD?Q3J=dN}Xq~oIXz#eh_;*~gh8e!7_|^%@<6zf^uRw02HG2L9-h^Pwi^xJLGqy;t
z#q?kTL4w@yc*3-3!V_>6gXhuEornuDOCEFKNq8FPronTe4?Vjrm7so9uKjG-lS6B+
zc0O#%OJVMh8_6`UrgrC>?~yv5(Jn{#piHlT?8!oDl9J>=@s+)j<U~=ytsH!!j8BXV
zYu5kVlgRK~GD8uj^C+8hPc&?Jn!!>|vuLtZo$(}3rYc72rYz^eClkKX&Z+JRUGT_#
z(|nd@^*b?#RaG2SJcG&!PmvV0YvdaknMR>?D&9$PYXB!wpF)7KX(?w5!IWEvMrF-l
zH)ETR<(vi-^<je)qmH{LC`Rnrz1+4yX_J`jk15&FH+D`ZS<%B7Z#@;)nEx~(CVGWD
z^w0KLU39z5C7IT3GmaVeU?Fn`u+>S4@qrGy&+UhKlE7?K7>V)WJn+%BfctbadjA9-
zWPTfYl{4frgSl>hnjG9`;^rzF7Z$SoR`Yu%zZ?1O;`bANYx98G?OR1^-e~DTU%j{B
zHGy{frMO4^De1Z%Ec65a2LyII0ro!wl=*^E>A`7@>>>Wz?qO-r3#A9&or)BC6@Oak
z?d*kf0qKIXP{q8@60h5RUcZnI5h0zWLXsGt3K95}J{K&V6=g0nTAF6}e!^@zXZ|;Z
z-1MsH8WrPSs)QXfv*I?h^CFXhGX`f1dO5$5X)!P4UNb6p56c`>{Kq_yB|oY27tqYC
zYUW99W<k^L>oZ;E6EgnOL0BKmCLU%rC(k6N_J|NjLGJC9BT9wZ;S*OqZU15a8K9aJ
zq^7-b^d5eMQ0_jRK$*FrR<}r?ew%UAGlh62H#ohA?Qg<eGBHd~;2}8m)f3FksLjk-
ztJlYO-q`w$7-US}{WIi&dB&s}gUw1!FRo}rJFx0<oxT56`hcQ*fQO+TlgC_81=tjU
z;FdMzVdO^E&7Bwe0U-GhPao%KZl-Z|Wm59r`UXi?PA!e?isorZdemrXD)h=Ew3JiB
zdu8j(q*Rd`xqnd*jZF&jbe`qILYZ3kT%Kv^or7O^kW!k%!<!RoDIPwVgbo_xe-00H
z4#I;V@8dyr0okKtHr4q#T_by&FRDGq9w><3$$b*f<_){MFYE9;q}_*A<XWl}bCE_=
zlDy~4#a)`~K8PM?5d?OQFFfU}(IqiYtE~Bl#O_n9`R5q7oD*kKM8506UA)hNm%`cx
zej2Cq@f1CCQ1$}cVkZ>pOT4bkOm(h>OK*{`<#Z--ul)zPjG!;<LC^QPl2oDBek*}E
z8B_)z5CU!>-UEbF-!nqPpd<m36b5KVf<`z|G>x;OG#ACB8^=Z=GD&V=4va!B?!l~x
zLN4ir3`ZfC#v#JZB>D57O-LzMnX#R7_`($DtCPGVtmhEB{_{+D8SC?^UZ+g`iRZyR
z7~g<wkKs3jTmIs9Li!@cD*D&D3}lniFtjemRUHdMUMs8P(R)$!US{5tQfph#DNKs$
z7}vSDWGn|Qx6{TGeLE3)6obn-DSg{*iE}#A>T)~yoG=rg=}4RZNb%B()b4rs^b&7y
zWeu)fj{=+Jdd%MlqqjaRV6p;O`_y9q>LdUD$C9AO!^5NRq%xM`XO?tTI<uskB#fkc
zc|S`U&#mga6GAF&is*TL2vQOKB1|Is3itUBliH4Xn3X5hh(n@8d_Y0@{B|D_p9y7G
zRV${HFrH1=zz(ym7o+)TJYPA?WOi`3QKXkjg^5p@g`D5~3r%(NvibDcx)(%uJ&Wae
zki&NsGu}(NXe<MsVSaY>EAkHJ=XCYG6mSXF@iYf=Zs-cClp3sHUwyBk=jw)LqoCYZ
z;(tdJP`>Hrf4ArQp15j+W&Q7qbG0~8)*p!HJlm=G58#S2JT^1X*(p`yLL##MgS&~j
zTw+L%HMYA{SXw{q#bkT<gu5RRZn*ogxC~F2j1e0@?Ip|flAUGy-|huFz2NigN=6QG
zMhqko7ZQ<`MgKW5!T=Kz5d*&x*DU?J5&?H!A(?-eHs@s$H%qH--%Z%dC9DtmSgR?>
zUl}2P0!^O~`G5ItZxuXbsG|<PxX_6M)ImTu4p0XgF)H&^n)y+GR9wyY+p~TNuf4z@
zl2^u`pN<?gkxpOabE6wKuY*Q(<L2|lY3#>)9w`=<r5k3JWl|WFdW21>e~+9@J9U%R
z(cVoFFv%@U_-9gOI?9gI7FK+Wm!KoA8qAK7qpG<iRA8#+l2DE11H9uBYuJ+S@kU-{
zkM)YI_HoovzFUT3-48I!ANw|MqfYle^uX>QhkZfjGG;ag#kV5U!W7KiN#^^mdcA0k
z+{#*<<U7Laf5V_Xw72JISy}fS*|OW{SamOS^r~msY;?W`ERM+OPWZW0j*h-4xmDJl
zE8wriAs9|Ue+bRktdMJaso>SK7(2^VIAxnd%}i3Y&}FmLWUnY>Ga-$NA(_A!D(OV~
zA(8GDfOS6jxj1Ir=kbg_og*>&;Ta!lK_Q)TJt@=v)%aaK$-y4fC*dijSkbRu45k9=
z^?Z00$h%kbNYTDVXtyP7Qeu3J_JA={{qpX04En;YgpFj>&9xsUV;#bBy4!B*nBHJv
zD@CGv`}9-0IsJSj1H2}D<+|taoWg1`ryHBM3+$IE5&hin+E<|mDNY-Mx$b!+2oK{C
z?3>dI+w<M7@F;WWMrPOIjYg*u<Nr#~9jer1n@xmI%jsARJ%nfSo!;KU<U+;*I*p17
zCueVV(S*kc<pRf%oLbPVph||~tDfX@zQ2faCu*U1^mES)o1~&>{&L+7q|w}{dU)aC
z_@kN-&yyi``7WSrj-+-CH(!s4@YBFY^@oKZS2sVh7KYJT2o{_Djx03FmPkTn?_#w5
zG17PBD)`s(epLKDG)&(Lnn{Ehp^>p<b%2B1@YuSJaMn7c8PSuBgF(Ow!TX>+l5zFx
zCNlX=j%R<?Bz!(80e!!4`(;dSzJ9_4es988TBGm<z##7REG_+yIJuE`8cCGhtv3=q
zQ+XnqV!l4|3xbnLBQu|_6teycN!j=q6tXiFx`&8@8(vR%?<+UUn|~Gza<0Y=Zy?5;
zQ|?Vpu;w)hN%Q5Bk~y=?WxaZe#~e^D*;}twrs|SeI@UtY)1?q;-{SG*+T+cz!Dja2
zn7fR7hv_Hi2_#cClUK!+$qvHKO$5?4wztV!x;S-!Q_A6V%HbT*742#qU3{(=oBt#)
zrUkT`tA?pvFCs^*zXs8_efHba)z7mO+~)BT{YNQ;oa?_BFjiG3w?j);5_REk-EW{a
zwJxsP`en3gcq6dkO+1R>Hl8Jay97wS2a{V9M{>it=)y#a8R1$KphmL(OXTG?Plo!^
z=<`7I7-O7s8t3ak3-dJV<;<??;&N8UXdHhkyW1Fr4@92~l2i6R`%-nsp{`KZk12cV
zQ2q>0&BY_KT~ViMn}^~y3x9e{s(A)}|7Q5u_5gUzO)}Bp{k=gP-3z(MI_Rlp4ORN)
zy^zGYqW8CuZY<>Efd#!QJfyveJ{f1bKBI3}imJ6UcDzU&VurTfBd+rt|0BHZ8J7vr
z)YruLsEOm(2&(d(LS8GY+3+>`<|2aE8AnzwNN`t%EI@(M!9aPhm~KWNmY@$bmgUw7
z%+|>|2!v%F<i#>$cOWTzYHbkS2H(ZC*pXK2Bmhe}w{sH^GGFmhqB=K<r!7xEM9`6w
z8BcexT0bS<en0w=YfF+D_e7Z&l<D}~jC-=UUxwR9DT93beGdco<XLbZco?`-`rzt*
zzWu?6fjqSjl6>3_7weaqTh5qb@AfKwG_StG`t_i>-|O&5=G>q8W|3^|kT@WGi~13h
zw43xB*0V&mPl1-4r`sm-5utW(z@?qh^(vC%g_)PbKy^}Ld^AQjmYpWSuMp`_M1h#Q
zZzXZ<nTi8lI2d2+l@bq`pti_=qeNfM(#TE%sn#z;W204j|57RRuH5f=cPf+`;_8(K
zs+BSqZ_EAo*7@2-tOZ}e?6T!v%97_lkpQ{nn^0lr?Lu!oxesuJ=nTSmrdiAnUy9H6
zS4zaI;6}h-EpOD^M^y`E81otlT5Y0Quf=oC<#zK!FvvYF_%L&s`jPuNUcw8V6}e8r
zA9K0PU9p+25WWt$<`1N9z8)9naNfYHVcYDb*@bH?d?U~BO*|$Xn_IEpjH_tk#*?__
zL8CP1i{vXqZvkMXy#;&8<^<3DoTEJCJmn$Bn9FM&Mz)xNXbW@Q9dTi9*TQ_7l-gUt
zQJs_+A5jKA{06YE{GZNS{-WeB=}&$}l3ZdmdH3din2iGSHYFi3^0klXyN0y;Dk+iE
z3TW&ha#A);1bYwOPCBkY_m3nGZg>a28k=bB1sxfjMMDtPgMjp4#;(xCakJZjyN}K0
zh%-n|4^eV;1>N>33%9nT4^98=t(5z*0;9MO69Mq|=<uk3GM4SgKvAw}dAYu`W-JH}
z84GOSoe^Hs*<ie3>?lm4WzAzKU_w$KlaUK8BlCzxSeg69)Io8#<$nimySK)YzXivP
zd$vfPmXyMk7<0b~R)rL<$Q<+Bx(Gg6PY1A|Q*lLGFF5r4n`s$4w~<PAXFWp@-HGtS
zyLfPmph=HuW?d}l&yn=5S}2{{Nkd)I^e-2xC&C#x&J`SY3yynuG^fa*+ZNztjl|&1
zSRV%OB_bbPY~kZ|e*ieZNRe5<@DAjFQFbeCJ%S^VMSJUQ_|5M72!2r%_72FIT?(`n
z#-L(FR3>gxn8m9juEFF~v%Nq^Wqby2yg97yh4kQynyb{kn4Ww|^AL3}rAJSnR95-g
z)-mMcQt}};yt07!Iz-C;$dgH8Y?48zd4BAvkGtWkrQ3fe>}K?8R{vc%=i4s5B@rvl
z+9QUF%-5G&d}jr0a*=f;Y`Ri5d>O&NHYNB=`UG!eY|D3w<@@esEp@&jpjATk-O-yK
zFO#@S4Go$nqa1vMMaz{wx>v?@+&!|dPmz6gAK9MHoB&<5&vnq&yq^4<g;OGE4`ox1
zt6w10a!wRnz5ctAh<=*He3e8tR-w$I%TEQb{6#x{y03&4?X+HjW5zvSxY>u))k%r*
zk0)Ul111e~fxx^+VI;;!wavC0Y4e|o7Hi|7WjmK1y+j(<g$X^0G4x*D4|7pMPh$G%
zNsDFZ(MmFCG}f^?2zYfIpbi3F69=e+fY-(W>LB2Caez9ISyt+<%tc~fp9{4uOE45E
z0d{AI*BnqARGT+&T|L>~yqV%+xsT{B)`Q6~W(5MiQZhq-jDRJ^oZ+Vu2YP^Cw+HBY
zHpYQ<IW(P^T*cYKc;04-9M?^_xMaQ(EVEtxSkYi`pl8b^++5qn7S`}G$P5O1HgAU!
z$C2i-==kqIb(B9dggl8B?;2Til=bcBLoXD1CRhIXplZEW__XC3b~k*Vai1;j_Z#;!
zaNj?6=KbLZ@UzKG@*92-cQIIw@%15GB{%#qFDGXZegt>;Q65Bpj925kX79s|J;O|F
zShMHhXsg~dV<X}3Meuip)U}V3teWOByjMaZE<a)1%H=1GyT|3H@INe<pC<D0aA|lv
z(W+l%czlaJ))Aeu%?E`=o9yHmUPqKE?uOARTkfN>t|UL#zMdHWGf;1=Y-TDP@U;BT
z;;RpG0R!(zi4Tfqrc^y9#pj4aRFs{gci%AuQT8vU0P5A&=ZPzH-#|jw4!?lM4Zp~<
zI6a))n2bGnsWb}G;F!D&S_}3}))J*nZuM}kuv_;fNW(AVmfNrG;`E9HW$P;hv&i*T
zUVP}{YrJwkZLktCG={8^Jq!(Liw=RtW@wm(x!Syi>}%^E(&7e%<{SI`#f-bEFpn1a
z>ma_MHgCXFSM7Qgh}pEzx?fmmwb1_X8#pIL2wI=s3oZFGccXRR7S~FQZ))XprB=%D
zr8+4wKCODN{sjvDMlf`-iA^Oo;Ll6IB}Ty;XP8^ox_9)$UX{Q~jDZbo-RIlAvmf^A
z1Xf}cwl-FK3PVQ2x8J6OJG&%PFgLPqLC2z+ugutXv2v;vhgFE7?2u8P*6}3R<+Gzp
zmI}EbN7DLRdsqx=$)iCnF68xC@m|@(t0)w&qA+;h)Wa*T$ANcq53iz7yo$o$eRB`5
zxE=@I=k@R^3dO4^kY$F|e#_c|KDOGFgN&Q+rV!XJCo;n_+ZvaSPs1GTjgu%KB+o!}
zb^{?%KnV9hbaw+GQ9uYEKwP^U2*aZC_)K_wuJAYsoQyx;0guj(hMlRoEUtC#!JBcq
zck$A0-6-reg4A@`5~E!xw62rjZ=&`-O@E+Q1^Rp9Lb>Al`8=WZ{D{^&N$a-d*?b3e
z(^zNY4wzmbn4|(FvZ+<JZ$Kfrz27)gZDY4eB?{O4M{db!s-1Ln3)NN9MzrrDs?qkp
z4UzCWJi70W^Y|_tGw$`m!gq<NPD+e?Fe~UX(PHFaU~UkY?<tJL$SubKW9}PJi`EYa
zmM{A-!Okk#-B1f3Bxv(e8pw_iH!P@ZO#6Mc@a32|6B$mEq9bW3P)Va7s0e>ZC|ky6
zDx@&8f}MMaG<Ddqu9XVRUo?MbPERauz6TMTYbl%gF{C|0e{D87F?@Q9(8zY)DzBl;
zf>qpJA7m#OI9i>zX;@Zf04jP~yYqGp(K&%A<PHt-I(N$3@voJ7@ov_Q7(DR_5vMJq
zGp8+sGp8*>GbcF+;7<y$=*P1R+Y#SLLYc}Krm_oGIoW=eD2Z7trI|D=xrQZf^i(Mh
z<swPRS-Iy!?;4T0FIz9^)mCHBOx=%6b&}m&Ua>F=mSRf<%N3EjIMYxULpt`v@U@Or
zc)f}_IGdbPGN=S{bgVZqso${C)5*14o%(WT%La;!<EqMyvsrv*PpC}Pup{+knp>4f
zTS~-#wulW2S$Nm4dm}^JnjlZ2N6v1P#BPh0Xf0z8qNCr$YHR+{9L6-o<{jvTnG2HZ
zLqFQ{Q5G0`vY_}*UhHL5dDU}n_#=3eVU{tPJMR*xwmfxTqwM*&1cLe|fvMBkeC3{q
z&btZi(wSz$pWrP8jbYpWDK1v}g;YMI7z_Sqn1Rv{YH*>rq~MHA_%omY{yDG4moWR-
zynIW~?4!C!a{qHA?67+XrsNs^0%+#`4`J^Am*V6zSnVehp^C~mb84#a8HM_%kx$*|
z9|e>>o#i0)uY~M}%=|w?;NIz0GbewOwf?ilj<c=*wN5zL%n8cfq1bfRR*|{Vkzv<p
z!5*uO$|k=+zRwjj7Teft>ZS7tY`$8`9FMDKT59H~40nY3OdIhXo$xpCF}8+NJ>hS0
zmDnNZGsEhdh|0bN31CXm4f3{p7xN~Z#c8K7Z9ybfMLKjtDW{Zl%qaGi-1K#5*K$rn
z^+jJ81#u$DDpv|?rRo@wy5a92%zm&_kXvc-AVeAj<T=z~n?oJ-(>;~3p2pWw%y6*i
zRJ$!I<(y(7!#bReWV`ngHsW%LTiN9*0i?h}SVb0r+?9N#(&H<YuG#FSUs{Yx_4g1w
z^fKAr9NC^1Sff{)?^cSfPbpem_-_3HIQE6C{a?7xIG&2^R5x=<_(vj`oOlnxsv?7H
zsVNo<Nvb57=I5vh9I?n~K2&LL1+>1boYfT`v_t%6Mg=)U^F^#E-A1t1fO<Xl$-GE?
zS@VW*Iio>J0oissDwJA?Blx94V6TLL_;sdaHWf}9g?|Dk+=^1JKiW)Bv+@PzNH5KX
z7FCu*9pY&)01f}lgX{7ZA?d$}Gsgk{_Fr+GYIB;2nMx^xzu|8@h^Bip6`JneO4r{B
zN8XHHZN7T;$=}8LJ~puTA+f&O)<=;e{ZS<Ql!%MLF*FV$U%r}^=*OwfDUFHds}PO}
zH1mk^jWS(+GwV;TV~Q+iGCp8x<2%jRFUfT(mxE-|F_{$Qi!+%qnRJp&BDOi1jMv#t
zzc9|@q_y{3jeGIFd<Pf(nk0{=CdakPQ6jsvPLCG#D6eWaCwOx3(vl`uLG+lKepRU>
zb$}xrrfP&TFYdJefr!F?%0sN~S&{$hMT+S>EArpHNU?usMgFH3DMqZ}g!2Tnu1s$!
zU!?GvNpPnJi_?WXAJsG!kFV8@$9<T|qO7o)7Q~BkBn_71cK#0<bS)x3`SRJ@zGvDJ
zn=e7W=Ye?KmbEZBt?Q7VX|v7Iu`a8<#?qqhV~yP?mKKdC)|kY|HwlAvV<e1v8=C$M
z2l-Ys|A^{L`Gjj{t=&iSzl5a@khT5`U)4NIx4JW(lTxxZUGDD=!WoUyP5((i-si?O
zN~T)Qbl>04*G<CLLy~AxVq~v!(EUI^%r=2JNauqkMy~`&kPFfe_9xh$Ae9({^h5nH
zI})T4GYe_W9v$V<rQ2Ye!<zJ<s9PXsIr&g+-7^bzHI+jV$nHn_ao;Ss2S`?(lo*p3
zODSNf!(*?UO%%O^*lZIN0i6M77cl~~PfIMjM!~G~{*cnAOIr^!D=U+~pro3eg-mE^
z2cTN+YTIX4P`^b~MknCS6+b%Jyg}An7>^bV%wIIQ_V9A^WfJ2Qy?9LqKF_9H*thaa
z(hUaXd~<9O%Qy1j54|LH&;;oB0UAHaFXz52hm3VU+AoY-L>LTv5QfB<4~MYbf$LCp
zxm!7Mlxp2}u4yiXh~Zq>a?GIvSy$f|S-n8@Tx^(Rp9t$M83?Z%CVnU~Y8O&%;+Dh+
zYL|QxGLWx221O=>e~UDk4O>m#l6fIxXP!M(l<uTKlmRezEgczua$b+GvMz2;8_6{L
znefa4d6G`+jZC_~n7s?>OO`T&b7-Cm9j2E?b8678bOr;y9dA5u7DfiM^;$L`X33)V
z{!5j<A>RB5l%r!zW-Ky2$UU*;tgEKTw3V+p(VF?kt#g+T44$U8NLKoD>wg|zmi6-=
zpBy88<ID*aW9)0@a!!7W1f2?V8NPBBGbe4E+DS)SwJR*;P3pu6(%kW<`%tS>lta`Q
zT_Nqn)T&wjeP;Rh?ekB*7hS3S#BR7vx%8}N%hko{mhmN`pR&MPos<~)l4wwOoBu_y
zdhch}nlkKIEtevw+PZ+={dkP!V>o79KK>lv+b=Pa`5^QR{QKdcdv8Dd%My5r>4X1(
zz<;72{`Lf3V*21^`Mvwee)yLs@Dh{2>vg+f4$gGELzAX|(O9>UGXwwm16(8<IqhuE
z=?o>oGEPN{f-n!R&imkjT@OisWZKTA0wh-qjZ-1QH!46on6n0{yDyY>&@X^)W$#tQ
z$Hy@H14{%lf8HNBNFZm{`vWEU;O+uPxc{IZRMPVqtiDj)NhP2DEwe%;0J=fSz|`~X
zHzjD%nxE`05nppI^HJ+ZP2_Un0Uty||F|$rUR(fO&dOKTWa?e}2wJ;nOgayGj?Tko
zbSN9n*MKK1rpau}+(B5@fCDr@CL_XO4UnnajE;MwB!>xv4v%$?Bnmw<31#lOu$wV(
zgfCPAcR;{rp~`ideB}lLGO=L-!V&0_0Xe6$4*su~w#ErZ3C)BHcot~o!U_&PL>Z3p
zHlGq~{3iV!K|35LM&uCBS1<C7-NR0Yg%b5Nqqq#PKLl+C*dOL4+a5X}5x;DlXdMTK
zkyj!xsnZe0D-j>-k1$?|_;`PW@tVA?fVUgSo0_Jn6H_v!$HBVPX|i0j$0cXYACKqt
zT`NHEU!?7@FwR8^FGi4dTQZ|PyY_+6r2uUK@fi&SjlFH-nZ#3Q-btFMKR9topQ)y7
zad(i%U=kCC^=HL#5zO^0=0U!L(xVs8TH9@r-!8S8cONfu+a;e3b$1^x;@cI9<-GfN
zk>W1-U?y`0!c<;uXZf~~__zgKjps5qT1*%CB)w;>XSv+N=)xxJ-evJwFh|chym&X|
zkjgL%bmlILl2hkXMQc1R=)D5+;u}|AEAlN=-*Y41BK2L}V>G9XGQpx;=afx*r0)b<
zS=%+kXU^KZH7;+*+K9e9W<I&f`<ll|Hl}&R2{Fx#o{79MmQ7k2bmYV#xkS8XA=}Kb
zn^|--Q?9e&t(U<Jl`*DKUTA1gMa&H;#7Y1CZ1Q*$^jfc_6DruVHYp~16i;<q>;)=x
zJ}(`VY^!48`gPK8Ehf~z4%K#BO9bEx0Jv=d1L92ru~Z<ioB33vMAkmuJVz9NBaPOh
zd=OiAVH?{U`^VZQbx$V|S;;LWmSEs|Y8!Hxb3f`$_cKt@3H(ptm~mevOwh$)G)Rou
z4UTOZl%fkb26OTK|Cj@X<|N#i%RIC~b54d{++6W*7&_U}9b*2SQr;CG*4*0hEUSv2
zF?}3#vYKTknErPTSjGf>E`spsQr+%n`+0x0@V*QIRwpG!QUtYkLrZ}_*AM)f1XyAW
z@G5f_PUf2AfCj~0pq2b0UK-#p$t&BrPa=&zh|Xt3&TWb7wQ&MJw~do@PU}iKLOtYS
zw<W;LVlZ$;oixCpa?LJF(YZsRv0ZfT%`nV5j9#45`6?`%tCDm?>Q1?_Vc+=*QE1a!
zB!4ot^e03N&s{##dN)B;yYpiagwuIYUYX7hd66B}@2BwIA++AAw4Bb@1XrdrC9k%4
znEc&IiJPflw=EF_-O~$_%}H+)%F9KMk$d15h5T8Nf4d?79nwJlTfAx?Ppz{2Ou}W0
z{ZDbsxL*`3W|c)^bd@FMlP<`5iSYR&<<su`9SFBA&x*gCJfresK7%r;cs~|I*k}d6
z0w?L1pUjR~(EKPlF^E*1{i_*7dO9c0WUzI!lyx{k)(X={7Mpu6MfW{3LRG+U52EDS
z^mInP6jP~AN{o-e5Sa57)6(cjn<IbuymjOxP0$@aqjpy|{HKxJCrI{G)s`5ao|(ln
znb+T&w9Ij^pCa5#7<2WQgkGo>t{`B(WjB5*-@EtF5FMM_)&|nty8AR{?@yJ4w5LJE
z%k6Z0x^ZR)6mO%zIaa>ezJt$9yR{j+QEKi$3MwZ)pNDrk@!C%JD^e9skmjUOZmwE}
zyv(rzO@N)Au?~ip+eEJZB(mmPI^%qgz-=$&nNGb}Q>SASxhtNhgNLcma_gIjO4d~W
zh@6DKPeV20&uvQ}Vb1bim}u;`M7k@<vriAkcg!ozBLLvDL;^mG&Kb~Q(W>0~w$d?d
zcm4#RyH%cs{~7l?vv5`wXBx(UOGZ;9zCBB%EP9|0j(=ms*cXH`^U20kDlLe!CwiHZ
zf_PWrjSJ$$s35#OW)%c^dQ4?u5G-yAf`=&!7S8q32=hTjb9ICq+M`9rGLw%iMq#r7
zPlCDGfEs3alk&Y?<o?~LeE%0=i?H4XFTL`WK*Iizgh}~+Ps+lV^1Ue%<NkYU`3iVS
zj3NUm-<J!W@2AW6&j7kx<r$an4`$)4HU(!I#(>W%U&-~CW{U#x+&4RHHef8CG+-ni
z%Ffl#rN08cMI@hvlT?))+pFiTY{&W-;A1NDVx2gh4yh2#kG!MY=I{gr#kRBM%}Yqf
zj*w`|?MRtVqXjHPn6s?%Wy6{R(=dzd79+cdsmmORrL&;DlliV`;9e;*ejqB#zleA<
zoxkxC{{0m_hTXQr5q4=R%;ci;S4q{DM2(}Rm>-lP38a`YeuCokktGS8?ho}E<ITIk
zMeP>MTKc(GomAIMj|lt^XT#T;ZnXz*=tY;s>$1x%nRrGf+#O@=Nx7MC!8z7`7vOz#
z8Qrfk61e-3(axwm-v|9j>b87X&h7pZ)>ED3mxbpBd8kfGjK7`ybA1PWc`&wWNpoZ+
z{F`GbPsOP--f@-j=}3b?)*Y}l3i_4aqBrXAho|0`@TOS_&FPm?Zqz>)o#==C*euvw
z^N)l?$I?_+9JzN_|7<P;9N0U`pH55EqN{a&)t|?&NFG;f9wkP^Za%Rj=Mv^OPn(59
zx3l_K8R(qYQE7U2&w|x9w)^XTdS4ZKYm}bE$d`iC^!_^whoOgYvm1I(^=IWzRt>tp
z>8JNKp|`)%lNk9XaGKtovv3%C-;3zU2`@|5VX;qG=EVS7v~R&1Usd)Nty&x$;VoOW
zm&X_4>%m&{E%@*N2o-_@?9D!Usr!2i!QQs+K{3Mvu5sRsZ7~oYsF1~G{t59ZFFCxd
z)_@*>iky^*`DTZfuPu8@tyc>_2_*YP<rBq0o&C#Euxw+Ak4qk<y;El8XrN!O&4f=B
zVdzedvtdN+k#X!1X4fT^yT;4ES!|kG&m#GWt+cah-@GQOJFkZAUR%h_-x5&CBw#_U
zi{<~=6y%KSKbzQ(GwPVOC0r}Lk?74c$;WHK)%q#rBX-3<DI95}{+S?l+Y;C)xdy$0
zxI*H~m_LSuy8g4N^AAZ)EAulc?X_gk$7sQnQyqOav|cB)ey+6a&cA?m+ww%iPprjS
zw2pK&<+?a;K=*XkM{&qj&4%j<!Hl>3KbwjssTZyX9-6-pnr8uIZd1aF3Ail-%<t@B
zM(GO7B!5NBw$lW1bq}Zz#N-bW@)6L%k_GzZ2-BrKpeLn(UMspmryA5gERy?F48*0D
z+TzrU$@sLEQbNSitGllkx%@IJgMW(@!L)z9SGaCl0twrkgo&VkC7C`%xTJSfo7wEA
ze}mxrb%gIf5x(~(Y2CI2f^Q}Xi>?$C>ln<x5zHSzU^=jfd8JRbb_wp^M!5ek!u^y+
zidP8)_iK}|l+eNbJHefd-Xb{&?l%hV-$%Ir8{z(Ig2!!3Ah?fT)uR{Tj?~}}f?L&q
zK3G&wWh}VgB)I<=;hu?b-;v;P+Y$)we<xunJ%H~&3GPEh+Vov=qo{oCO{yIF@>|lT
z`m8AdW%-UiOJd}MxMo}=?R7@h!>l(8KmQx?!)}5MUvQOI_jmoMzMi0x7=sD~LFXa7
z(L~4Z`_tSnY2HuiRVO7zCpyT$pC$M($pDR)SyU67B_n6rthd0AoPj%ipLhstC5v@c
zb8U99d9lP^ippQZ%mYSKMJ^Bz3e$TRn-36`q)1lP*q96_Uh8lOUlX4NooCe#vi3d=
z;fc*eZMEJi^vyUdy(LRFXgyYzoD@rTcm(tc(}xzDNAH{5r;soxr_vd|n-xQr0}XA~
z108cNw#P8MnQ`o%*6P!(Lk-UvS%<UU7RfBxGd7D|3}O~?Xj-|%MJG3$7N#a*Fh|Rm
zy4uTdf^fu(CH!HyjW&FY$#vsFX?odU^U(d$!Ue6!G;d^T=BO=esddcx)-vHw#?A}j
zj}B>fV^6u(Uh9UGJzc-`_9!23hl-j0NR>Tv{7;1#hbEK4ukfu+nxsObY9?w}B3~Tc
zA75;ya**?{M@d*LP&FBxegYTPJ+hu~U!5w79I1%pKF>PiLhA{!uF!m2cRakVJmxGo
zngMe4G0C*5bfsv%GSruwKlY;83!=GkOm2*Z4Nf0Mp8nsd*lzN=r*-j-)?u-ZokCvk
zjLK%WmB3U&|MhVlJYaQNO%nZnm^wJVcTxvi(2_bhOM{aNV``VuqR_Q+F;8?S6ywWE
z64*JF>q@a^w07^VhMD>`&sx^7j*RnuOe*iGLbZK5w?IFHW}2PHnB|@>&0Ch_`O;LL
zQ#2f<;r#!S)gB)UR+zjVok-30>0G5^O1(T1-tLmJH%&-&Rtw_OR|etHS`5pI&0tNs
z;G_1T*M!CMa4S|kw)TO(ve!Nw9mz=ghLntKpAIYtk5L9_{ol~Xz{6@@Qm2QO#^vBx
zPlU$Zk)HR_kW3b)mlm62`}gHfN4CA}^<<hKx0Z_j$h|TrIhJ)#g!6%H+^!|UjxT&1
z<VfSO<ign7ra6;QB71xa^@<lBM_ip1^kVY`@L(DWXFcl|T)25P$Em`1(m3jJLv=@E
zNrK;CUD^CzFIBWbx)dW{9U-qpE$5y&Zk>giT({mn0SB)WdFhwzgPrrOT+CNyQ~iP{
zaX<Sx!|p1%+DkC;0bNDGOAtnwMhb4Zkjk{_dm6(`z$3MEj4>|;`SgiwVj0`0=8jyu
zUGa8RMv4I+_A3|1Hs;Gkv-x|M`1s&&v7A}`vu5@HhUVJs>4dZSvJK1R2O}{q5vOO=
zy~w(j!WH+C%*Udxa9-K#UW}Pu(VJlc_Q9GjTpvd2F}@l<N&xf4g>uPU9aDmGiH{>?
zcQAiT91RF%d@N5q8+e71lJ)w-dAZ>cJWZKr>i-XW?;Rdh@x>3%y}P-a3h4=i8Xzp`
zjow>8rPt6w2u)ydH=wX22Cx8v3MdxrqS(b=P{EFhfCU8vL_oy~c0|SB=bV|nI|2N@
z-rw`Q?_X~on4Qm=GiT1soI7`B?vx}8Gt8Xz0m#3khSbUOxO@Xa&1)F0TYPpQM!j-r
zy{py!F&MJHsCKq3`&tjYlGTYgvIs0$1aY|YzB9B*s*_MBoJIKE$i2!z9X_ka`hPlH
zhi~xW!+H=soaZ>s^O>vgWj-O3^um@WG}@+b098ue#Jb)=$lywJ4scA!V7pLyVBMVe
zee`HB<%O38H4@aHrT!zbo)9h}zN`!r-fJ<~ve(073>iM?&I;dC)*`RIe;^7?i=Kn>
zP#@4Oz77o6V#yS#Z$sav@Yp4!1%^O1-%vPo@?BdCmv@yS12|PCJmAJnG6>hcXA)GK
zdn2>uG0iZU*Zdoyf?ST(23v4R@CZ2O!ur)akc;g4)jQ?SF8V>fBY5w|<IuxD7c2El
z-WDG|@g`bPX&NI;jj`9GQ5+Yaje~;sA3@^ig<}7AJ%3yq^4G`u(i2n+Bca8@4`@i(
z6#=2Svhb+VI|*ET)r#z>c}%)_B%0SjS$vE#nnLc|hx@5!<I?1Ma`ckyD@Ou!rHGa6
z8wD@ss7BKd)vbY5&O$s<yKW<3>Nxy@Ug^0}7Ml^K1hE%^zr#dkUulMGGMP8()74lq
zf;75?E{z3epHVP}EGD7&CS?hnO(C8{x`AJLj1*C2(iq8Ig_A1WW-hklVi$pnH?Y&O
z8?Jc6<XI!Ed>jMiX&S~OZ+wn(nc*GoAYy4*bo-uYzg^PX4&LeyP^Z4Jh*<qTe6B>d
zZyZ40C|C6lwTD(8(in;cuPtgQ#EU6OzUm~Gmh5{Q;jMr}y;$0KTN>7?PXIU=BLgPF
zzdym<9;GVyk{GmtE+5|Y(W$p2c~X;bc}{CQcRmP13!YPf`^Xx=n?Tn+B}FF1CB}It
zK?GXyAeD*lONv?OPKeG)loWps)-R%kPoifz1{cW%sn8N)xR}vKVy8!Fm1RQg-B=Zb
zC8|gS%|LYCnu93`QS&fEWKeU2od<P%>7egVu#)N?h(}R{a&aN$!sDBapZ0fAPNWyp
zCGZYIl%#mG5`#m-*NxOjaM?*F$a9FeS(z7$`c6tT<!@4IQgY6KL`=I<{!-4!UrO!#
zrO5oHCM4p<&!mLpTN2_`MpHSXcPAvHypj=^Q2cO0B5Ix<{MbnUT6&7`^(#6rJ~Fp%
zr2j6$QxHZ*;|iY_#m`lq%awyovSjjcW)ud|zmWk{fZO{hhBi^z33YL<c0a6MM8;pj
z|GN0U9se=5<UgVdl$#$ve*C5|Rr34bZwA^L{15Tpj!ngrP<(Xev?(8GECY%~`Z%N7
z8;@T!h1eK1;w(O*`)g6@Nyx*Nc6?Ef#uivS&!&JW2|NM`I-_?g7^AI>Q4L$;qPbLF
zW7zQD`5MQKN|%gfrZ<i>Lz7bnzeuA@+px{~$Q}@G4ES+PKJ7x&!n)jzUzi%VO^>4%
z)QLPi%NuPqDr|(q^n1I(R3HDd@P7pU7vsOxC_go4kcC;_6032O{0>%=8c_3#b2^!o
z1!QxBQG%Fly9$193TdV$gK5wTe@mh#OF9a~@FtPpzXdwTIp&pPiOO#w9vY6uQ6*F#
z)5uIvqSNt<f|^gg;vd7Br}<_e03AI}e-4Glw6*h<=9`I78HPT-i_Ys1Pb2?LB2pq!
zqAkn<n?95~)@`?s@*&SyIvklkE-%H(xX>!M8fQ!{M^o}6=#!#zk~|p~ddfXIF@|P~
z)pNXscP~WAhu88nskpj)+~{%?JdFiRksx}Hkn4bG9vJN`|265<37a}#y>6b}O`llv
z9{m2s$b$DGsE(?up?9IbJt%TD0v)l&eIL5FvWfpTVx2{-$-dc?*{`6j|1D5`^n}&W
zE3{T@cUJ1ZM*G5!Mz7q!91=jyb6NmLX+_siE1O+Ea1sw>c3I#Qep*!Hr791`2IViN
zT&z(}GX*0Wn+G=yAl3klVlrhax?X%FDCD@AQlU{Sri|BOMKZ;&r4`MTfJTXBN~K1r
z!xWgBomM<k=4m{MOqs7yl9_UeMoDGLG)=>Frcn1el#BXIp_9Brlm<+}Ic+wj5mPLU
zrwLQA0L13WWXgq_&dr%pp;5A!GF78^nKDhIWHV*DM#*K$42_b{6g(w%>gaT#zAn-z
z#Y~x{QA(LITcfmL${dZ-jwxt=ZOI*&a<N9~#FUTFVuVVp3sdkN)24J|%7+@I2UA9C
za(Xdkp;m@vObKd~zD(((#X6rUi!`2oOzEca3}DIujWUQSdo{`srhKYVhB4)JjWU8M
zZ)ucrro5|BMl%J^ubua?O!-iwjAzOx8f79=-qt7=G6n65EoTZ-@L=1NsZ80eQKmEH
zphlU=lzkdy7E|_XlsQa!L!-=P$~KMSXA0UpJM~JYpvkc*^O^FIM!A$Jdo;>Iro5w3
z7BL0wr7fqLDQLHBN)1y!)+kGuQl-`V<xJVH+1Qm#*`raGF$K%sY{@H_g29JPS;-W9
zHMS|&FlC=cxsEBHYLqohsn+zlo+%$|JnNW(@58p_o0xJ?qujz2tP-<%Ze<ES7u%HE
znSw<@HswyHU>%=Lxtl3iHfK{dFy)X&xsNGW3uyD)&y>rwTs+7Wtjn@_9%jm7jq)f{
zmS~hsOj)W?o?y!58s#ab;OmGj`5C5Q^4O+4$CRry$_q?crcqvG%5shJGE-J)l&ws;
zTBE$ml$9Fgb*8M+C~q?58jZ4zDc5S0cbIaWM%m7k)f#07Q`TsdT})Z4Q9fYG^%~_P
zrre-WK4!{9?J3y9lyw@<KBk<|>U2L-Zq#@VGNp?q=MYoSN3~1-FjH>QVjX45%^KxP
zrcBV}9AnCJTI%00<vfk&JEq_ZrJdFfOc|*0oL~yRzS=xLF$LdDZOSi9snK-)jVUi^
zJSUlQi>C7_rmWW}e=+4&jdGePw`mk%(fjmvjbbw84vpew%AFd;V#-|_C6Xz3Ym{iF
z+@n!qnKDW%jXF%h*v8I#JX1Dku@aerj=#;5%#?dIo>ZpXr%}?GvQeYdXUhE=r2$hO
z&?t?V@}Nd(!jy+JN+wet)+o)H@`y&sVhYBGw$5IrjMQ?G&6LM9o?NDE(kS^%d0eAl
zVg&W|ghnZ5%99$UlqpYXlr~IxTBEdM$~aA*4orDQ<LShdXEjO}rj%>3x-sQBji(1w
zp4TY7nDT-~DPziJjnbDXFKU$YneviG>Bp3pHOc^{Y|$u#n6g!)3}MPE8f6$$Uezcg
zn1ZPsyS~bq@|wmonklbql(9^CL!*pm%9|QxB2(VdC>Jtin?{+!l(#j?RHnS6QKmEH
zU5zr6Dcd#5ET+7tQRXmZhenypltWq#`kC^XMyX`VPA%4artH!vmonvjjk1s_A83?C
zO!-iwR5RrxjZ(vu-5O;HQ$E%xmow!PjdCSZ_Gpx4OxdeZRxo9sMp?;}Pc_OlOxdqd
zu4Bppjk1O*2Q|v|Orgp7(70e7Q!vS9Q*L4keVz#M+`<$r%C#xCGG&Gq>vpC*rt#d#
zlwBI-Zl*k<Q8qB;Gfl($m~u#?+|QKHHOhlbIjm70X37zb@+ea<-*4-@i77`lo+p^{
zg+_UbDPL-oXPEN5Cg(Y(e5LWcz?5Se<wd4^ZBv%WgX1yT<f^K{*xw9d?16Jtv3-R+
zSRhC9Ta`kHXJ}3-@D0U8r#*C>AjT8$eoItzxI<oyR&ZEW3Z`+f%IrG?=4Qb2Jv>-4
z$CYOWNr>h90W^0mPD~*|ZeJO)gQQuL2-biuw&BY}0>{BB?-Fr)aUKMgO|ov?p&R`<
z*9}?5V1st*P*x!h@^I!A<_(`kUIQ<osA&Bjj1t8{oH)mre{oC-bipYFln39B@TV4~
zNaSW+eLsQ5lUtlG-_Icy&SkKMqWxmCEGGCXv(%S&6}W>$^I|DX4&4EtBSkGCzTZN8
zgxo=L>5}&xx*uKfQAPNEXTCx+NC;D`FC#aBlOWO^={a=cdCs|0p}JGC7X-E-7H-_E
z!t@0aBfYVXBQ27@3he4e(|LJl<kX>5so9>$dx=<unO%3PCrGh^RD8axP_N!oNF8_Y
zZY53rBuyTL5-3tiF^bLr&GBx6Lz(4y)d*36x~PY`@c)5XD{Oe8ddkHoRrdICaD`l&
zj1a9RGO=YH?2?u&&oO-*a^-Q`gP<??sUlRhfWK}#;wPHo$An33eyxtc-;DW*rud&Y
zlV7VV@Ru+@(G>raXYy-x2L7JRPc+5<)S3KRErEX&^Aqjg_}P48E&oN}<PXRAT6+gt
zNqGiPM-&QO;(!?qc}y*P2AHX)*PvDWe^G6j@X?8nsfDhT9DLx9pb#b&n?cMO$XdqL
ztQ;q`xUTd_#?x+|*;PT9d?&e~Aev;S!z5Xxp600R@lv$p_x%k$_!^6I(aAc`MW<>y
z7oDmD%UJ`bA+(D0$7$Y_Z!_=@Q84FWANWV#W5)>j_a7plMcGTSUDc5=eqO@pf#<aK
z7MXryNN-U?A>J!ct=?!joIbU+F3}^D4wtDJBuRlfC@q{MONB;frobO0{a8u(F<a%X
zA_soV=eVoL!R35Xgp5XIhcebku5vC=s(8vij)3D|xdHE|TAV&?Ta2#87ezfc+rqh_
zkZ^8ze-%C!^PiOCau?zIcD#XoBW~BIv~nphy0*Z#!vZNp6FA<KnRk`TUw64T1;vp4
zs;fGtwv2a3h5>C`)KG}`X)5Ap$QcEP-x+R^56!4uF})U~@K+%&Lp~v9IUbQ{xBmhB
zU?0^Ncr<(_<fUcbN6WajfUG{Lcs&$3!R7xX^iTy{U|eWsKZwOb^$?h))OLG&0Of(T
zZhQ6og;;rAQb*_$OZtSOag{}z5!jyC6*1}j3{L5c=m#TlTproO{?K0Vx}sSzF6G2u
zzUfMHdovJdX2YKn^1nmNZVI4=%7sc2t6tquo^<SgrjE6(#uouTlh?Y}59<x9Ms}6n
zI8u$(GP7|XTogiFi*xZ_FzHAM3kSA^-nAKae7Cphxdreu(I~`MOBg*3=ug;b$@jOd
z6DQ^xe6~*OaQq=XRX)7xqZfB$#bO|9kn3Usz8dO;WWRuy{ux~O+)4~BQr*nBfq=Ia
z>z%#hZ1#}J{#z{E<l&X+`mW?8r>bX#A4~26xK)UsE=kPdlw1*<_)1Qk3hj)C+Gla~
zoKa_zNbOiFA;fcJYi^vRBt`0Ng2jUQz9*lDC4ryTWwgcb^N8o7RUxggDkRoSTh#{r
zt`@10cYAYKH?Dqs(p6PruLF4>HBM`iNyZB#!-o%#*iM2Y^IO0ZV@tyFjC_)$j=(rn
z>j;dHjeA7%obY!x-G=hQTIhy>OP{HMll9?S#$|m*`9yM7=ZBlAP_xC2l?**cBUD1=
zUu`!|(&)KSp&qr@jbIaJaHOiIp$9nWwV5_b5pZBYnzsW9fiFe+xV&BBeEia%>2)DI
zr%tFTQBRg^x$0omR6K&YLz=rEJk(O~sp|e~@fhQ-6qGN&8q925VUQ-<6ZWQY(?Z^q
zFf~O{<+Icc>2F4T1>QxgN@x0FS_yXrRAKJVZADb!^E9m<sf!=lIkBCZ-dEu8>qowc
ze6IrYw{OhYaT}M4-WR=|@-qF8Q7gnvCYFjtQ4Mei$H}5&8D;yN_qmzOBCWi-7%SjG
zqgNd_$|f#c=Qp9t7mfI`U2*f?#uv%XQVZw{bNGc$S2^d5B;!TFQB4%ok5tCNCgS2p
z&xd2!_!{d-+2d>|(~wAiMtw0z)Rk5qZ`h`O54x^+Ufgt-HLYDp2*iRX8pRZcUzA-P
z`U#So*TSl<i(l>_#KUtM2jyXHQX<i6D1@0!UhRYOO`^bLINoRFtBljZnmhiZbDg?j
z`BS$4GOScFs}oQwQZhWJt({akSYZjt6e7FDXb05s{<N$`_CHob+RM;8d`=Xv@xbmt
zeA|!4o+Vxhqxz8AN<^$)M=v!xcZA39>7ZV6pkcHTje`nva8(D9>-$oXfxK9cQ~)nN
zY(0yNx<#J;&k(IgTvX&WGm78y_$Ne#B=K3I)DC?P{kGK7PhLJANP}P`IGB`x{1~L>
zO9w5>^wq-;(K0kzeMKv<X*kWUH%vl~6G)X%baZ9tT55HE0`r`YlIAi9@f3llI<a<{
z@1iotUO<#Ng~%+U4b6##tPY64RTUY&U_lC#=gi@<<7%v+(ChGhl83$w<WWfY=Ecza
zG!135mCDA2li)HagE%Re_VUMIMUXmYuQ_;L3Gv)YIjgIdoq6PPF^=Hj2-F{4YzXlx
z@%z36b9#B80p!AvRmQQtqFo=bV0COm1jI!(&TQQ`s&^fv(hvU;^PK<3fj$TS@5BEU
z_z%;e(`>~}_zw~JE!x30;cJ;69o2Yje#>?k2BT`a+m+RB2NU{)33%AR(LYRp>47jb
zOjyr^QDFk5Z22eHgq%f|zaot0V7wGY6D|M6VKl_@UlK;WEPquPwTWunq_}QW<Lbg_
zoS)kW#gdhSQQA_Q!-}H&Z2ZeX@b-Xx$g-6C61kYWK7xzBLuG97f{*O{y29HP%(x(2
z*0(8Yp#N*A8|s)|3t_5D#{+d5M!R^Rj%F2%Zn>1t;>AU<W-pp;D>qq&c^gAX7rPjX
zS-kM*ES@IJLoRq^JeRjAVD_AIDWJkGG<izI<=slQ7Kx+L`r#qNXz=WS{xX2tPgDGZ
zywM*fjxv!(ZWKJt;KB7KEU>x^@}y9#uL^NRE3UMX5Zi$N#g=ZfO-1AOuhQz-Y_wv<
zW>bpLjHIMB4yi%AD@j>Zy3OG&ftD%)Eh_nM5mM#+8?wrODn3nkdar;()pr@Hme+Jk
z3Ti#1M9SGp@IYIZ?-?>_%CxpjTGsNPW!_T#8T63a_*zgkk@@9fohaL$G?TRKTdEKJ
z7q%VMXytWjx#>y}&o2c|p-vYUqKQh&cAZWkk6d5ZU6m7=BfezX&jXiHA2Nhmr8d!~
zP%nWMRYqG@eYmy)vK}JP(4qas`8^~t+Lbc1q^?z6p<9?M50t63C~3?!trjhvX|z(u
zwkB6SreW$yqt$2H%v!Vzrd?Ev)_`fVYS9`pjn?dh(`dxBIXcba+izvbG_b0D6voAb
zjL<?I+Xhrsa#I0A`dHZ>E#0YIuC#RL%vjubAXXc6i%EjFoE~=67d`9L@?-4`w`1$=
zc1-Rj3*8_a!8gc8yYnzzL8WiWOvUT<mWyZ1jzu4h)eW;TIAL4H^88CIX+Pbd2h}gx
z&pGr!7dCX+ES_vl2~1+vKqX~7sW@woM{h1QdOHJRPHQo^16kZakk{7|-s~>ulTJXX
zc*n!ZqOPqgj7jDaO2g-+XlFvmq|iVsmPuY;c1Y$Fk~ujn)5bi8$8AUa7svsBi|X;n
zqc0cUtQOUNOc{mz0nJ~j`RT(-h=)F@g#4FkJQi9KNw4{gl$0rr)l!<LanINMmuP<a
zJQI?>z^2z63QNSWz~<Pi`9IbCv_vZ;<t@$suIAsV`9IYBpJ@KKH9sx93dww5^J7BU
zrenxs`!N``{rffl8=9Y%Q-x%1*ZjLQKPJ6xo;{lX9nHT(^V1@!kj#&5f6eFN5~QXq
z#6gW%$WM(|$WM({$WM(`$WM(_$WM(^$WM(@$WM(?$WM(>$bYfsrv@lQr}ii0r*<af
zrxr%~YYs#EP&<+dOGY7L?1B!8FAr86ofGS_eEIPC3gD=Dh41JzOz#WmiMzd<X)LwS
zq^Upei}0td^5A`ftveg&*Na|d4nK()6Xkff5Rz?HI?{TR(u(E-Bss2&*(DdPMZOL^
zFtUU|5vhW`TKI{{$?*6};EA;`4PFWlep=(l*9MM9?ie`0=Vf~2N@G`CYLYvr2d=8P
zMM-ENB_u^yxIltMM4TmJzb=CInbB@DY&t7`7W>5;(0b)K(Xv#|qnKi#z&Ya4P?y(G
z_ros?(AK*xG>gf}#4-Er;ET0fN^@U(z>xYK$ZvQ%;wNvnJV74@7dqu%o%tCj3OdR2
z?y24HgmmyAVQeuB71|;%HVb#rq_jgUD<{J@{45%d5etj}6<5}HN8*>d!X&30a_W)3
zsGI1TBe00ZQ8i!SM;;Q+r^M8J1?=BQUG8OQk3!>Fk5zM&EGX6635vJyc7~hff1B94
zz$*iLRFkmkFX05bf=c#A^;>}7caUy1C8?cxn#!zZIe$3ebISGePeb!qk)lEKaG4kX
zi>zwW+j}vZZ&MC9mq7d4;?(-{NYS`uNS-OY|4W|f>xOL9k|NizM~ak&VHp_I3N(yo
z<&SkTbECrrd&U8;h!>LAutiv2vwzXa<jSd~jvYUIMywp~pfNnRKE5kaFsVf&s;NG`
z-I2do*3;JmUYy#FBa3>%hvolR@ZSqQ5U>#<I`7Ma>2$q2T2p1LI0ZCPK6+9>8MtaG
zhr4L-{FI1BgQYD~X}6sq^J!xGefGRip5-}0ctM=4b6Cwty?RNrgUMkPJh`~LaUtxQ
z=J@%!%@9fX;j{|dNq+}EB0m>af>$qkR%D;_e4Wca{a?errNvkGL3%5<(o8mN9Q#zy
z%4<C3HBz)H3gyYoV>7&1&dQT{D3&Ly;?i&#$do7^%3@k7rK6aOGx8haC$i7VRg_i^
zrA2crI2$^xkPe~EN$@lpmm7hjqD$&T$;0`tGZ8N*5oZ#O%ZrT)&&$NoNEz|Uak-1f
zRdl0k70JYbx!%!e6cXI2F7J8BhWC6psOt;xlN7=8Lv$fbWKPor3wvxMuccW2JZR<Z
z2NpR9Pk?ONEX-S8Kk=6!6c@#?x>T;U%)qwM?|zYGgR__~qryM)cL#RDB87Q>BSCEL
z@b`gKx$D_C0CYO*@B@%cxjAM%GO>{RW`j|G=#21Qo<^PQ@l4|m@`8bA>zWzq`SJb^
z2=a6I9~6})d~PvtFOOlR-r~gyN2`j?NCZr~rHYQ1Q*&u9aS7z3L!s?4#Y^fqYK86v
zn1tV4Bedf$$K%}z;juWdp$UF-d-xxuRGW9ETkGxGl$o;6-M9&%l7vHKaTH86@}AQr
zM58g4Mc)(zI!*W%2P4c0?`wi4y-5@Q4n(lzblG8e)s*8PgoSs+`?f%MXiu<px7-TM
z8-TI<=M?E%C$gH>gPOkc5iut#lBW-N_p&QDHnN&lvtr{N!Xm3_;2`-TtGj{1T)rNZ
zASPbr;U>PGfRzNZp+Dv0M*PyB%m-^7&Wu$5yZ@xV7K?JFXQoA1>lT`tXKMLeZ7m5>
zSx3+rdi<vj8j10{yM`*m^uB`PXSHR)t0U`JbN(($mj?Lr5kap3?jz+<A(5_f^Q%_+
zEwn;EQ%h95UX}zg=Xvgv8Csluu!t;oQ{*B?=sw~uDa2*dY>ea8$=K*BTzptic2{O+
z)ym$dj6y%CMCLkN_)=Dke^j?n5z%9fRQYmw{_S9&_&X3!F?~O$U*D_LNyIlN0<M+l
zXlJPVpKq_OkEajEOVT{<AcWT7S#wu^4JR*}`Yu)t`H@awEj1%OG;OYt?MmQ!`Yks3
zv6fsRt-{)TLqe9=%6$uH@>RR|p8XgyP{j;~|DAyjQFD8-W5HrptY`R+WJFZ`K$7pS
z9nsC_zl9jT*BEO*7eSIS4{uHbSJN@zv*gSm>E}yBg<%ecd0G;WSMd;#JiLDnGhU>G
zcQBRo5IBfLY38QOU&$(&_!<#}Qvx`^GDz9RMnnEpWO^<PK8F(Kk2dH=6ff)s9of(U
zxN1`T7AYPL*g-M~Zlm=ST{5vp{}Y?suubiThtF%Lhf?L8%O~@!@^Q(`%WMxtw*Plg
zDR#ZAhH)e=stkW_cRa>iZr(EFnBT-IPuZt*O)%9(RT4h+59JoFqfjW-5uf|V`{NCs
z(MR7O!Cdt7HHp|0pDa&m!m2+mZfVk*SRCC{53dlaV7vhF;ifhpXQ7_d{+tY4&2(g-
zCSH!&+M}Ekp%=~XOhFNZ=F2Gtj>KO>&z3X~Ec}4=!x9wLlFu6AQ#(2ZznB;}Q;zpG
zwjQ>xP(*&ZEhf2AQ++5YET{_wdgOsmbu3v<p|luzk^?u8J~Rt-2RwlhWb9=oC&Kdh
zYy|WZBE$gbgYN79g+4GhO&_U;$1PLF7}@Q;``k%m4-}tUY4N%!OmzI0wB6os5G_V8
z5)aCx6?EV$3Ap^F4v~Daq&u*Vih$dZVaOxe(*Kf<o`72=5H56;NlqX_CQz$X`3O)f
z#UL}!MXSN)PLCyRvQEW%)Y>6r`!WQkL$*mkSrK{Z8(I-`{{*@R_MzpckH8st51^-h
z9dcLI0DjYpjc0WD_^0%0cm$mh-=lD{5s%_`#_t}Azn|l~s~T$Y8<8J}myxW-x~v2L
zDr+yvI;dnd(PTB%WM%5IK0Bu@$`>ZHaIQMba#c0cWHsmb`((a8KWBW(7bfQt0*93@
zEwuPq<X8D>smnU@ud?=&tfNYnSCiFBla;N@`l7ZhzpO%e0|C7Y<O$UB16=4uyTT0q
zih4GKzrn4JVDIm6eIu#Kx`28JTyJhZ=i>l$3Pm^xE}RyQWnrhSXCR%=5N{D(MRbeL
z5~r&Uq}=T!k%ejL{sE#HJOx*!`zLX6y8X^b7ZZ+1S4Q{?T%mNaXGETDjdY1_@fp{g
zF3aU~Sy(9D2hAV`E=cz@T$S!W@N&9%9}Aq>k<6z+)58&FRUuwX+*#TAfh|b5#sF`)
zALa7R#<QQ@#uZ!vc^Rh-S_ztMqwGd5-w?`HBNx4)Fs=$=*#qIZp9@je^yk`@gC~*K
zBXgH8H_;46A~iD@1(#Qr;~<KHf8mJ^^KeqRC_5QD#tsRUhkOStMw*z-#<zAe7z-Xu
zNp*sbRpd{O!D>B8_P&PRpciB4oES40hcK|$!H){X6JW)<aA{aM+0K*5ET2;n7lnRG
z6w9)58=8`NR~s5#<bek(6*`2{vP%>CP+QRjzlWfg+sA#G2p_g*Vd0D!tV@YozEMaB
zr@Z**;QhxZcHlnIdvmE+x<cei@@4Y~7DgP6$}ofRh=_Vo^84eL{>)$k=VnnNethe}
zELW)$^sm9l-CTr4C2rrXp%61jcwQ6qhpUp|GlS&vy7m8G_BqOAs@=`TMhcqSK*d#|
zn~d3Rx=Shpbr8$XI0Z*rjsMPfTWKZH;vfzV*^N54*MuerGf8-;&S(wZ97E6=8ki@=
zLtm?oC#_=^h^f&BFbgZN3Yyb1gXstln{O4yR<uOADgBs1LcZtlj;hKeLgT+VRy)ig
z33CyVyw4*L8#{=fFXBrp=eSsJRUahn3?qC!YXC|l4hSMMYJU}EfQu6fHbRI@O>%kL
z!Ag^?D1P5z{>SYbgL1*7PRGPZ?^yCiC0Kb$iBaBh0BnfzT&j!&k0Sc0I|cuEFvyV^
zqD}zFdlA#tk*8DfdQ>xkcm`8Rfi%utTJ*uzp`5Br;_F#-hZtOhE6ZF`Pp6<c%Ser;
zn)r}vf<AP1FGa~9XFKt~FaDz@<>Vp!Zv3ae3ef03R~GQpP-Sq5o=zpPJTZxfK1hn;
zsE!*ka9S9Gh(q(?WAJ;}uH(k1OE5Sh%V8TTi7``U6-VcIQUf1AK`iYH)<bv|RXO|_
z<fmGKzcKl#7T|A4eyS^OAh0ux+I4L8vTAVRPPko%4iN$kH~;w;p`i(#W|`{kgX+WC
zTrS^46u3OJs71QVH;L-vLO67krEfA-hKHvTb0YkYLV!F!){C!@RF*VmONDf@|GLKM
z)NW|B_zV~NFfa+<2B8*qYFRa~YfUX~9~&Xw5yW#Pd#4~7%y7Bn?N1gy8oBT~L?aw-
z|73ZlAr7W%aVK9pnpZ#~?eS{{TS7cq#wSc~1w>&#(NzB7iL0t<<oEZ)V!W#9<V~rX
zfgfo0C25weYgQ(=I8`Gb@>_j&nSU#C?Fvtp;w8xwpl&{)$!_$q{4pPrTt2)TXq{z*
z*b4i>Q<&fiE{0*5!D0l5-u>8tWd&wJixzQJM33^mju(@QKOLLF66Q?j-pLQdc@c3Y
zxvMAuS8Kk(yq7_0wA_akV}&)&%`=0j6?d>X!g*yi?%+lrBpPRUt)%+F>#vC9MDY6R
z>SD0r1DJ0X(#SO<sZ6_|OzBGOjQp4ct8r9*YP;nqcQaUkXcmq1tadLj!A{3p4=Q1D
zN<IW0Orw58rKU}zdgl3%Hu~XtX@0ARnCszHP;yy+Xb{ix`FaAFxCF`6^Rg^YCB^p5
zhK@Ns&Luv?Pc?o<WUV+bnK}m|vO)!2iVU^LlLd`kZQ+8Z09DW!_pvT69|m{Q=3RUa
z7Cu6u?Ity8k>5ZHv{^AJN>3zqq**ns!C{-p`L5tb6u9iodeK>>H#;xrq#jqaEBjHG
zyxj|S4K7@&MA30D7iovR7+7&gA=Jak$u4vGT0?^W3tF6c9F<1>v%4wjP{>kD71|-R
zUXprl6o;Q(lkY|QifojL(Xv+;WBK33!y@}6Sde4+SJj5LRNAoN@?n!%bRI5-!!{3C
zP#Pwxhav^`siVC-UZ{?Rymb6lNVTxi|Ai9n@^RY%+ZV^6H*GMXMzg96g@WN+Z~6(6
z%a4BUI5UXD@N|;zB+AL>gB9d;Q=Aw)MOSwMn^xW@!{tpOUVLEA!Klzga)G&sOy@i1
z*tN<!p(7|TYY3YlWrDrn$ns336UphCFs73}W>`hm$MQYIwWoU1SdfR6oQREa4eI1B
z(im@&@O&rI^9X!E5Z`cmeJMS38r@zW)W(#`06bvwp_2BH7n|so%d-;PIoKe{5zY&>
z54?(tp8H3UP;Ofld_ID!9|Oe<o(K8V|Hp&HF*#@-6hfR$q}*_X1ujOhplu-z^i|Kt
zkBpg`h!e8!IwLmTKFHZvP?f!R1HV@O*yt9rcM4&9r=C1Xm%{15Oe->XqOKFE8+n$d
z<w#3$aUtP&70WmA422%yoRZf55Aitpo~3+Io-s{%0qZ842@hF-A6adY6j4P1xNCeH
zY{A8ouW?b@$(87tMd$X4+O-8um$p4K&A%7b<B}2hTVJUC3m2}`#xD0z-Q;SS4V68$
zN*b9D3F9^zk2u@qQvA}N#-x=7PuyW?7sSw#sxtg=Y>k_(081DH$n`l37h#nYHt`Hq
zUO)lpVfOQ~&<yrN(a9n>qr`ZCL-u_c-k;yHefI}%E&CqWGi2Xvb*Nopfz=JbPjVVQ
zuz97yaZEPXvka~~ST%#guDp=JQHX7DBtgn$gY%HVg{6|gc~qH%snXyWpJ{MmrbiG}
z3O>W&P@98TH#t2KV;fv-711L#b33Exa)-!=$@?}85+m0nS-?@GpuFNG$4JG>-?XZM
z5R@I2o8aG%lGI<*{-wQY6KKxQCBimjXFwGLW$@o^$mTwW4TZy~ymUL!OZZ=Hh}*!o
zU?bnLjSNPPYT3va$VlkH8iK%F%v3WInL}!Fpaoh1bbIK%9Wo*ch7k?LPjYJ5i0oK=
z>T<1C3v0%8Bf<{WkP%UcZA2tN$_*P)SgLMBVX8DD#%CH)m`NHDDSWmO4QJh?5!JDc
zD6Wd=QUAk;(8!!KfuCzNix|3KkcwP!+4k1rq^YuXbJ=PE)eC8{Aax%#Vus}QagXT?
zTeH<r{Quk5Z0>W|S~%=%TMLJsWo!8X>;|%Gu+k~qgIglk^2-m&mA%nVdV>2sbYSm0
z)G0`H(QI?5!*agMR~MFM21h}N?24f+rm^7y{9>9K;{)W~P4CiN5;Ps2Ja}R}>UdC?
zxJbhP7Wm&5|Fg~DJhZm1AWYZon-4E2mz+hp^eoDPGblUEz(SC!NSgAJ80Dq-%1aSd
z*Cam>1gOE3a=16L!^H~u4uR-mP1sxR3X+VFpM*$1Ef#C!3N8WxePrxnv1%skB|Jx!
zaC0)32hlcE!)8?3jhA8mD^pPLub^OE@`EKhzSF4ii&b2T2H?LQ6~u>gVuN|;R@jTk
zZUdd5ZPm=McLu5Of@@v?Z%XyaJ;<Ew2JeFkru5!V+8_vn0jftY>f{HiM~;fmY7HbG
zUuAA_6!v;=p+Z9kSPSN{ayHEenF7`=j*}c;6-p*Lr>W(uh6i0L($eD_gy>nGAn9pJ
zpcYYnqHoR&t!eX!Jhi6qf6FFuwrnmAC$i_5tdGlg88pSPN(x|*jWB|Cm{eSb(L3b{
z<d^>3?NM36)qVrHJUVi-%MVNYYlzC_C+~*mQp^pyxI*NW^Ch!ge2=`mO}=D;i!Xh@
zW`?}{{hApi{aryM;U<dwE$JwEB*$s%U6@W_17679?eOI`l>CzW%uv)I#!x?!eTAO!
z{6Ib#@hs%lrZsW}GC?FmCo8h)SDHZ|u(YHHpp^`lIVL@Dz_`Xi`kuuRO1BMOR&ycD
zx0H<Wd^314Nygv{h2Ecxtu{j_8W;m$bOo@w-15FhY32v8TGXnk1liUUkJR&Mt3&OX
zi{J8gD79g3Uh{E+Y&Ok@jd0OsZ~-KQCONS3&kEdzg2D$5qFdhil$Lsg`N=kemm)wm
zi}`^iFru2pq(gpSDfuslW2cBxr+y5^%lxsH#>*q5QhB)Ah6Zuh5G@svvFOaIxsn8h
z@{G)2Odp<3!uO?R2+vKF7AKL^Bh8M4&*fKxDYzVt8C(HZTA~+IHWrRY{(mbpq%__g
z*CQn}xDrYG)>Dn<2k<%Gs#yhst!5_rPFGM#)$&|Pl>7iDtF4;VIy+iL+LFVsEn5bj
zGI}Np@e9*V2w+N<$JI9=X6V}=bitl6D1?D9W@+`$qals;?;d85BDi>xSAGJqa=kA9
z>Qt3>9!}TC(`}^W;{y?;6I@IDmKVL;a7B?`mOY1Q2G@aymougorDFD*V0Z^>6~Pd7
z1Dbw3Aeffbm5_@oJHlF+86|`{POIi7aM^_cV;M#|s5g0Sq+W!wyqclB4xzlv;BB>&
z!D|4s>9-T{%nZ?UL*H(G;&^wQ5zh?XS(_45tH?azBD;(DJaj*RN&zxy-f<Cr6Cu07
zs%ufYEmF-OS~mB*1^~1WOG5dEi{tO9Iat?9b3=4f!&4|Ux-TqvH{xLC_hn$r{JzQL
zdb~{*mp7Qfdk`GDOI60r;N7$GRtNsp-V1urpOlr`2z5cRe0gYR;U}fMQ&7x-tH@IS
zHFTNY2ISM^i&b+k;@Y)EbI=Wu4&~Vu%4V#*LP35nmf6b&50(9e`288Y^;S`lv`F2B
z7q9%9hXUAz8EO00v|Zio5ZbPuPTSSpk=$@`Q-SHy@D&?}{X0-d*m{IH-)KHioHSf6
zpF(u8teTCw)_5;Ggoc{l59j<ns~1^~qB4W%@VmV$NGKYI|2tCXSsmd*qlPITcexqF
z5X2oo%Nu^~)I_Bj+(ao-7Z;BTS{bY6aS-gn$B6T4XyZSGymLQ`nqailD`mcseXHgv
zJwmAaj2Bz<E_9t_$%o4{I}`5`m=1bM+>a)RrzHf5Xk_QR=tdAfEriT2_SY$+AuB!7
zP;o7#_>!I?N*Gf`T+-+K%@5p6abDHqpm0}Fw$dTGzVB%g9eVwsU|=_RDZ}R6foo({
zoJ9&1GHi|RyF#}@`~sV+-hxQjsqMjD4RkcI(-*x~3v1f3%-kavms>&1;G$;UhCZP;
z>77t8a0BW9p9_c{<=ufdsTI73Ip5JZ@6tGl9^ypj3Nqi-IPcati5}v-mpQj<ocCy)
zM3<auA4w!0B)R5#g&D+f90fzAERB;VVSVW3MEkC#g8KiAh2BHd#{P;j$J_BbB<@=c
zr}{O{7pB#zx=&lTP}bHUphXRZcz2>$(R8Ez+Xjf3FemI)x*A3AyB=QK?)S;56*KrA
zMdO)1o(sn$a5SH<U<P*}M4p?FgceT@LPBPN?#E69yX0{p_&B?Z(G5t#g|!=@k;?m^
zs_)Go!kc}@_ht%K-<#{H@68V*L+AY7Yza&z(|^3HC|-;QTQ1}W&SLz|#D6@J^zC^U
ze(;Tq)2_zS1@!7ZLIggErs@OuFn>gWY0(E@D`D0?$oeh}W#tp??}SH3T^y}NO;=G5
z&JHDkgYh7Y&!MT>L(=gDo5bg2;fy~D!MGQnuOnsB^+NIULVSt~AE2W1-ZQ;a063+D
zV#@En4^oNHcN^LVLs|a*d-+*+PDlezCKux@PA(mSP|ZQgsrFTuA>JRR=m{D4aHGmm
ze$%De34hb&qT_G64<K>+ruzxPt0<rF?<PN$C^xp7z@gRnUeHyIW7RM3r>nijfEdnL
zWAHTPFf{Jd*BF@M6m*q!PVv+lgBL(VJs-jkihxrL?nf~06Yhmd^UsG9_yabJY1)Gt
zy(UaIgNG0xEA23RR2d{FXNDOhEGsQCSc4*;SAep|!7U)m54|~9Q$TWk>tODfdM3lc
z)HBx0$dfo#a1}*Hz3&4nOpe6kyFb^v)R`0FdS79BsSr@_M3eRYB$bL@??3(+uJ^D2
zs&^I?s&`6Gt9OQ6?*ma@C%N7!wybxmqj0^mRIc|YkT})*=LoN&qJsYb`Kc7(|BU=p
z25bY*gB!1|ZTP7<0;1i@ob&B!_ewX@`}%w|Qa7R;x%j+W*?3(%IYn<QYL4vR5w2WZ
z_x2c(!uJ4Sl0;rM#q`ii4sU6S>c11qhh$eLRt>Rcr12Ol)R56Cx#LioS4G!eB{$w>
zE;@mrAnkNHM>s|O(T>`WHC3H!iuzOSsI|f=>d$u6VbnRP)=9~7|AQI)1x#{5T<vhI
z14M`(9?p;&nEnO^IUq!5fC>Z40c}!<dnQu-9aQwHPvS?vf;_~6*u6RS9~66%o=wWe
zDNtqM+@!x>@Fn?Agt&a@n}pvwp#H^Fytism|7Pm?GpMJTdaF)_4Tr{Pf54UlKeM5_
zstj6-8T<zkFu3~##K3Kc=DQtEj3>1?3QGvV;khN-3KFXqhl%QaMH=i7UGDdwDH3~_
zg!CfBIHY@upB?Q|FI+x_MwAGAl97uSRG^sYKCiq;xoi%{Z85go5xzS}nFvpW?^X;}
z6qzr>QoA~Mne?AftP-|N`%&FACJ=v8y0o1YeXk4)uOvRRHq5+<n7Lg38~@`D`JZse
z|D;3yryTO5H|r?B&p70N)*=6M4*8#V$p3;v{>={gUv$X-l0*KN9rDA>9o6qvhy1TN
z<bTy6|7#BUUw6p=hC_ZV{cu#CZ#m@0>H$ac@p0D?|2q!(F$wKRKE}3=_%Y$^h#x~;
zNBlb-@?*T?NdEf{`9E;T|Di+vj~w#vcF6y+L;g=3^6zoTzt<uEK8O6DI^^H)kpF-~
zeyrVeWS^fo<Uiz)|8s}@haK``2G&u2k2>W4!Xf{c4*9=w$bZZs|JM%rzj4U_twa9r
z9P)qfkpBmV{Kp;gpK!>J?_-Ya^CyS=_%`84KIWAj@ncTZ5kKaS9Pwjr%n?84R2=bR
z-0FxQ<4#BX7%w{F|H~o&-wydtJLLbzA-}*0B~He_hC_bSA-~HZzuO^yghPJIA-~5V
zf22eHD2M#f4*6po^2a*lk8{Xh$02`Rhy3vl`4b%SCpzTE*CI#HW3og36o>q&4*Am@
z@~1oGuji1zzC->Dhx`p3@;7wI-^d|<V~70sc<IRAnmXjqbjaV#A%Am+{8;$yD8E?_
z`CB^V_d4Wn<&ZzyA%BiT{#=LrSpVaw{PP|17dYfEbjV-ikiXa=e~Cl>QiuGl9rCwv
z$lul>e>;c#?H%%WaLC`$A%7=_{GA>0cX7zy)gga3hy2|g^7nAa-_s#~FNgfS9r9z>
zrla<%k3;^x4*Ab>$bY^={tF!P_jAbK-y#11hx`K_@(*&zKiDDv5QqFj9r6!z$Uod6
z{|JZtBOUUWJLDhbkbks8{xJ^u$2#O6=a7HAL;eX4`6oK$pX8ALLWlg59r9xhxuf>E
z!Xf`uhy2qV@=tfjKf@vaOo#jzIpm+^kbkyA{y7f$eGd8OI^@6DA-~@tf50Jsr9=LC
z4*BOh<iErr|D_K37dYf!=#W3?kbjXw{wjz3)eiYDbI4!gkbkj5{v{6impbIX+#&xJ
z4*9Qi$bXeX{$&pNmpkNN;gJ7ohx{uY@~?8pe~m-_YaQ}m=a7H(f8q}<fIZ&~Vy!F|
z#?rOl!5S=Sx7Wt5FoU>|$*qSkrX}w|9H`{>Vb2fkXL=LoqSkmou%lsTF{aqD`u42f
zAVs(NXx%N=8uA~`t%L}9f$dZY6p8L`#(9_&N>^j&=HOIJfZYE7!gbAzv{CZr+nnrk
zu+SB>>SA1(qy?dQt7>tEZpO{<Ux^(BGVx@&i4$wFa(E|~yeXGOpb&OYA;d$pojGjL
z<m0UTa#L{lzEF9Rl{%YE?HJAvU|Upl4R$<*7fpAd<La=qDWmq0viIR!9xV8XPAycY
z-l1@?{|T#-H^6oK?u9Fb=LhzXR&<cOtyKrqGadG+79@vk0OvW;Im0+N5w6-0d!Me%
z8l33I40MFBWWafUw%@l=XI_U>7%2z`Guj+xkPZn}qVLzaQQLGDuo=XW4Q^MmkB*V{
z)k^#pGf1cXnn60}S8?D(y)dYq{Ox9t4)jIxbe6BpPlx%2#IpjT$I$aJ^<%L8#loFm
znqQb-Qdm;do=6d57Tis+<Yv`EG{8roOBV>yY-pu_#++%`8Yjf{c+l=F18w+FQM$(v
z@t`&9GyJ?>`0WK;I0?ANEFbOXq(2keOh$focTQ9zfKx^Z9ZX26yWrf7|Ikq2lwt7(
z{wIMBEya1DwWo-{^dH~;Y5%kM3gBn_hX{f7Gj=$|!~BJqiC@^NsDuAPT#YFo`m@BR
zox4u3#D`tTUD%b}zdE%Vmn4o%pwNz;n}D($q0wSvC-Oho`CxZT4C;EkpC$TtAvc!&
zv)KPbXQITg|7UgwGG%YS%4wD;>O$_*otiJO#L7;T)-_$L`dVVwMdTjsMDE+OtNPXv
z`-W}y)e$AbH~TEnv;)zn4dxUlAMaO397CujnhYWTcJ|-YnRqsKB=@|z<Sy$)Za#P{
z;bXTWOX!3Y6Gi5LPE%9GuVXg*>Wg+ooJz&<evL$R+G(#P4s@Vc_a%~q$>*`0G;*Iy
zJnd~H?nok@cZ%;pUcR}6IDZ~Z{vV2oXDZ5bvv_6<m7b5KEd>9Eit<|LR^t-Ihhsc_
zQpG)Gl<p%)B~_TnX{s1Ma<ea5>={7iynQ-JZkklpH&b*NaI!2@^dHcq58TP*PKQ5B
z^lsg1TzzqS8<O*R3Gx5h=cz`SBB@Q2K9;zoE$LG=?5ReU7+*sEs|QiuH+fHvwM3&v
zM7f>w(zPSSt>W?ta*jUZ)Kj?J0vA$falNX(jl}ifZzO&~Ib3E?9)s*!;$_bJ2$nX5
z>+!yU$NOcA<fP6hna}%G_01N~UqJq?Tt|;zK$;9YuhUdZ>>GR$<PWO6s9(PLzQ^!s
ziNYA$X=<kE+lg{|dm*{6w{Oy?SX?*iic8yw)6-ubR4m30zo=guv9r@MxR-Y(_r)&D
zAm>On<tsbsv9dN|W)jiI4SRV|8}VxS%Y!Tt-THXH4&w2?i($im4WN7#jUe}AcXBVz
zptz!l+~Xa0lvyIPGr3*39PVX%{$*G}C2Y8yO0_JFINPISEb%Z~azZlsJM|#f&t<-6
zEZK7tw&YH*UQ1NNO%-*SvY9C}h7<jxfmMC$izg>gZGMVebP!v{lAc?KleFFQ$!$A|
z+!f&LBK8!o9*TN|d`s-)nvJUT^hp$V_4V|rFE;ks?8_9(N0a3QFCn)$sa`8f+{0Sk
z&Dxf*zjFhU;6pAF#Wf>Oj!hJW=aGA}|K!+A(Rn77fA72|kUV-6)ywK(M48c-+(fp?
zT-aoys2bU6>Soatn^-OJC+yG?<rk1!2yHDfx{%yYSla{VlmFMD<Ysf~zb27?ESF?=
z&PyNYV2SVM61}o7xi7Pv!3ed)x5LTu_rmhKh&K~g56u*<Sd$rSEz8;eBKtQ(w;tl!
zJSx?(kg!=8tYLtq#m}Txr~}HOj+lMXW?!Nxo<=rV9-z{ggB)36b?d6WSz=2;t8tb{
zN348NJ#YB5d=VT<ZbE-@cXt>L+uky11nTi=JPVoP1Ly!7sI2PSMu^d5dl8(+Qdqtv
zl4lV8?RG>jV@;kL{LgqxL?U;^V#0)rV5OhVr`mt0C-Hv`o(xyd;X;&&uP%M6QJEM&
zgv$1vp5%Y9g#7QrCZomv-c2T)FRseC{gMIV^1ioUk}W>MbC)gN;ivD~!6W)*iUoya
z4-a$sOvICwDK3C(i7(L>(Oco$hUD^_5L-|ecDk`*l#Sxiz7aC<KVH0d>2_}g{BB|3
zg)%U0yLT1*7NZFYMKkJ}B*W_9R`7VS^dgE!yO$_l#RwTzpTkB1Q5d}x<3((-MA%ac
zG<P_mSU$xiUVO-$bwq0pTg18~itda~j3UlN?0v043i~?}N)Z(t*1kWX47|^4pv%#b
zgqq?eAku6LOKHmYTg8i>oI<9!4Dp1RHH<i$iz`@);IP)Xy@{l>m_}j!#RH6<Q3yM)
zp!G83ox+}G6yKB30KUB{UJPJ8hoIj}QU*<>uyVSY8}aJSCp3!gQv|w`^FCJW;4*u#
z&32rsd!g9P=u~?`GZe~fM`(^h-?b$)Pod5nb}1pqoY8f=ca#V!G!U9yhtoJd=CJ2c
zX4eCK%jmBjGVE_gIejEL%_wGpME@|F*g+yv40$h?$Y6Abl43II2+mPR!Nq9SP>I}(
ze#)09g3-$H5?PEk%#+B&=!8O%j2fdhNoEwI+|d$6GxA(4Q4FIQYz3Ez6jDw2xm=ct
z793X8n@WC#LgOwav{GalMw57P`JnCI{>C+;Gjp~ops?#iAA_vtKCZv@Vi1Sji2PNE
z^<tDkb-S@2p*zKNmh$LeLU)VVj7G3c+$X9z-rLZ+LOdpxF{+qI=xK31w2T+cVK0fW
zopl^`FLORGZsF7uQ4bYjt9X*blG#4r1|rSApFv^U#WRe?u%6q+^NczaQP_tf-J}}Z
zi#pl^^e3ZV*y{EQ!$nd)<anQno{VDH%0CkqF#3(dj)>`uURKBlB*YxZtiajXb2;n_
z4m&0mxhO}I6skeDH(q?2NSw#Sa_R(&7W~|PEmpZ;TH+V9OBLdTc+wRC)Ed3=H_-Qe
z(&d6?+d!$n=?M}oK@Yh?{2`v@FkFBI^tagTay5+?r@Vv=<7F*gr12&r886n@#t02Q
zIO`hkFzV|e6mM*o@mQA>;{#1*GviYYWf`AoGFuvl8R1)y=x%t8qb?V6+n`*C#Uh)K
zty#A51#|9Tt@Dj<w6NC32@b;{9?+$y@eiYm>k{g17;Y+wt*mt)!^P+~MtzM4MmsqV
z{ftOP6C)|!U?bKYPJM(?m&0V<N8xJ32<Z6@m)U3|MdO@kq-kifk>REsJus4F&M-1L
z-b;*T8QB`=EF+Iokmcz!iWt>rUFI64jGki@FxqMHDh&))k-sinE|(fz-ElyLbErHQ
z8a)_o8bYWF=n90L?nt^U2BQ4knn-Ag(NmLorO}sVN()(LT)^l<43hBl8~qtQ$R)Va
z7^1~nWen5MYGV|0F5=Q%Ym8;I0mHuvJhkH)ozFR1XH3-M-DF(IVK_VyoVOX%8MWuS
zy~CJ^S(tb+9afHZ!kDGSyVvk>S<gU!V7IZ+@M~ckjY=)OM~on&)13OFMhznz-vgPO
zj3rvU$BoN1^pvqoLoXR?H1w)*6HB>?wSLREosqPc_l$cP$sFx8HZnSiL1~3}-*|x0
zrx;pSh`q)WZZt5WW10}F#1UgNqt*&-VRQ;LMq#gMsUI=kVksDUL&|aEBS!M+KVf{#
zNaprOV-F*l+n<bmjMi`+{cP-KB+L3Y;}9bnOIL{BjU$W>a*OhZ@dcw;j(5uViqRL0
z{xrU3G@ncNFXLNAH%F0_zm4x1C9ss!#&JebY`gy$KQelW?aVNLW^|OpO!HT+cMm!|
zUc+tv&S-5*iT+^pn+p4r(fB4Z>~BVYDD)4bHBDuhfeAXa3<|jz^;4V?jJ{IH!>C4a
zMlpI+p%_NP6=xiy6AIO3v|Mo}FnU%Y+~I-LBbrNHQW(9|OrkVKbyQeAMsKOG3`S2X
z)R56Gg&H%;%aT%>GTNwgX~w9BLM<2_P^cxN`AV}^j5a8g!>A@x%FJW5R-pn$_bF7w
z=y`=o7*#0ES~Ge;p|*@ZP${%$v|YvP$f&+Tof##ocwHIYrs};rqni}!$><t|dNXRM
zN}>;=x0QvQ$LNUSynxXlRo49(eWlVH$ml191~WQOaSmm)SA`8{G(v@qWOPV{jbb!T
zg^gj9qtG};X$nnX)LNlQjG8JmnNe4TDi}Si@-U52p~~M3Mm-g}h|%4Ob2g)R6-H<N
z$BSbs>|#bKDlEY0Clxl2QKUkbFgmG9cLAebDvYMR(a0-Q#b}s9moa)prLdUMG-ZQJ
z89kxU6^vq(g<Qqx0)>_{+NaRfjD{<FS;gohg|21fQ}wW#QKkx8%cy}0yMfUVrP+;)
z#wm0&ql=Yh>lvk})Nf;SRG~W<9aJgY#VA*ydl+S@^zLQ!ma5H-j2=|z0Y<G==|04$
zfmc3%k1(2|%JVTs9Tex|j7nA5lZ;H2ho>2BQen?BdR?LC8Ko;Jn;C6UVJ|W2q|g>d
zk1Cn3F#1b{y~gNvRZ4F#>Y>WzEk+5dB;IBeqe|jkM*URSdyL9d*iJ^5sId1Lja6YE
zGNPNq>5Z_P(I-l?PZ;e|XfLDpm7bq6`ay*qV6;btea0wR$^4wrK~*kC7`0JhUodK_
z&{vF(s`~qy(K3a;W%Q>)-!uAFq2r9MQ|L!VKP&Vzqk~G%Ul|Qly8O<F&TXQ+|H0^5
zh5lspm_mOunxN1>j4o5iu;@v>Lm?NVEeb_2+NqF-(boz^F)C7dk74w-D#18L^AxJf
z=q{C`1V+o0g(S&%3Z*d0RrZp`=t70+G5S-X3`Vn*O*CZmt3r(#tx^`!lu;WM){If1
z3Twe=x+>k4jBZq6tr)FUn&mKRt5VNnWGR^ijD(6;#HhOpD`C`8g|%i>snTo9sH-Z^
z_Kf-{)RECpRl1!S1(hyc8NH}bcSensW<41VSEx6m9~A1tXoAx0JVwV9x`5F@rDuOe
zaY~ngjM^)$2QwP4G#kojma6IDjApC!Ml$+H={btgT`Gk!j20_2j?ollArlzgs?wXp
zsDVmhGNXG{SOp`m3Y*4gtqPmLC|-qK#Hh2<dN!jA6sM2TUrLvY8C|MSfYDr~**r$C
zsWQ8S(I$l!FuF}4`WPH9Rwz`(=xtRlmoZwe&|*fWLQ5IdD9x^56r;4hiqS@uqvedg
zSLkX+{S;co=y!##Wi(cy)r=M?w3g9Qg>GQ<q)PopMmMXx-^}O*6}FzyV=C-6Ml}lE
z!Dy>OcQJZKp?erTrP8~X(RLNKkx_k>!UK$&DI0u<(HAQ05k{Y=c#kpqTZKK&$gSc%
z$;hip@M%U@E6!&bHCO0)M&~Kc%@&QP<w(kHzQibw$0QNv79b(6#0Ywo@R+Yy;TZyt
z`37@7#^an=^Ia`0-h7YIS{`dBn;$UeB1Wm^Zi`0jElO#Oo^F1k#j8&UVRC*V!`#P6
z&QCNn_cL0`=`}GAGLmDpX67MAa;(<EJj`gPNh2_?dDKcm9`Fz8<(OYuS;AAXHLIyO
zR`PmQf@m;mT;|}Kzou-<DiSFb?}0vQ+&;LUP5cgS-1yUQr!(azrZfb_CEgmo74B^V
z#$`4YA5Tkd*;HKMt8_ILf6QpovPf*6&<Yf9pEhu}Oz#Ny;U1N)!8P4l?`t%)X5|Ir
zGK)l1r!sKvtr*g>MBK`hTP_;k(j~He<1$@hLQw%0IOOF`1|{uca$8TG3ipGGxrp`i
zEJ|y|u!WFJDK-_!W2@n|E9eq$a9W1a=UB;7&?{ywgFBqv^eL<0pIN>d?(&)I;P#nu
zE8H>D?}K~8q{mtsV#B28k;=6*TEYEk!WOu$iCbC@uDQ3-zD9#<u4VTpcE4ixWp?+n
zyN%s~Cd63}uFQK=QCij|zNz@FklZa(Nax+`O8wuNNtEb$RGwE2r`)BqUmw?0jPLmd
z=-xh*yOX2dfhG?m?SOkt+76UPRHu~qA~E>F58%IU$R4<DIvhY~@6vsZ3^8xwSIA4}
zi9f=vnoIsC0$+h=#{54ajcO!8Ts*<>CW+KJm98Xl!;nf>iFl)Hw6{onHzf}4XH(J;
zx)bywv7q<lmPw*NIE%z;_$}+w=HoI))ST|!*gK-;gHhyu&F;pr<ZsRHGh-Ti!<@}P
zFX>M1KLK)+M>VrUd-U;w^3XhTe`hyqB>785lk4i~wK;Rj@<92-pJ!9X^(h8r0bGmA
z0lChh5?Go$F4GWW;J4VKEVd|%ZOLL=3h9>HyDcO{v)hf`k?c-mw?14;T+xo)l6LFk
z4ABZQQ$_1Wm1rKw!g2l{?AC$>?r4c`bZyti;hQRI0pG#ebV95*FI)zC#scD*)1fyg
zH<Xj>Zg(EshkFc#dwoZemXS+tDZ3|g#&``eEq5Z^{W(<rt40m=mWVq?O$Yy$DStxd
zZg&5eLH>7U{@F51Tna1766GWJHOk@?vpB^pPBDw?eX*FIzXLkg!E<MbBv@=yvA1Bh
z7ta)1-Nwm#U?Go>_k&U~zKSg2!YjR5;+ZMe!hM(B?`M#I%gk%RBjb{V!^Y<Af#iSK
zEgDJw&ZGC>86Pxaa?24lmjuXW4powSl-*x@ODkdu`)hiVe-XPsgI|~5R1CUcPs=vq
zsy^GY+K8L7snvQZhiq~kyOr$zRdh3S-qmXZN{QMWOT<ll0RGM6Cc=$4?@73=29rCo
z<7VhDTaUUE-$XeNVVfzMxC{QvMw1l{?DHw4ZJTfi?rwHBvb%=eqrE1#Ocl@fBzrhM
z^xY<@;%M2p%mlQM-#~JH$7W57L}Kwz@Mm?PC;DsuWR&glA?3(dTeMeA#k8rvc~ixv
zai_c`#=Lr-Rw0}0c4=&@5jA~Vk-MuPwv~mao9s&Fs9SrYxKk7Uh2HR-^xMz|wh>=7
zY}G1NoO0#E9T(pL?o}z|HWH(gQpM|Wz2U#v7@dUg;pJ3fR6b<eUE*PN(+5Jbbai_F
z9>YMNG!!j^7&m1c{ByI3^2BVSP`iz1q!ZcON|b;hwzVR^l=A{)8sZ3^EK3~Z=SxZ`
zha5a>(@BTsa1HT83c2IcDQ@q2vszJJDxqx;a{=6;uBA-52I)ow*1}yeY#rSFeV1~s
z*MsNlI-612lOyhg|Mj{LAoTEvC*e}-YKc`93*ox(uCc_-^k+d&&Ugjx3vel|cM)rY
zYZuG;6t0zW6z-|C@8J$`pM=}5F1d&66J>IQnGJq-EZjRHh|(pV+#M<8ehI%N?wygA
zP3dOBb<L;N<K3hz_^Hhg(H9rzfU;o{ak^6r;r5$Y=?aBPdevN_%uJ_HDXr}cqR7zH
z67o}A%0+kR)6yt|+pNxD@RLQk_zmR}@68>P?n2u#818O%|CmAkcV-Swr?^w&$#O=*
zJ>gyxPn5BcbHY6d?)7zN!tI<AfV(ZC8t#$0pSEg-mgmQo&Cm*w+pFhQtiwu#W_nh`
zeIfpK=rFbDA-L3rkp7$CpPBv?+<6oK<ht7e&J*s};a*>NC){lj8(^QKxsCNEOv-L5
z?n~MW_v$oqd(<QMY|5n>d$UW#@uK~#!&F%NI1kzU74g+@A4}PgL^=8j^8MC#NWB%>
zM$%_CEKut9Zqgr$PMoK~xiZp~lPcbbBG;3UoI~`M@cXS#QNJHlHfstCWcS^q+#IYh
znoBZ?LYzh5+!jG4cBF0_`2X~f|AqKA;M~Nqo@4iAcJE_X%IsW5b=qMBJvB``Oy*MR
z4hh$a>THr+#*#09d!#P8!&Au3O(*xgNRmIkC)rysyf3iU1MdszQrr>XX@oZ?wFXl;
zN0-9i!=zf?lU4=)*7{`US7(sFX9M!T&|o?IN0YCIJJfZQpO-t}-xfj7%aOX|4o@LB
zH+>g}Za`>7g9qRaa8oTLM?D4qE8;2W_VUCxxvbuY>rUMdcV;@d$r<Fnz;0@<@Oze8
za!VZR_hnAFojC!&Y-cX5q}-Lkr8XxOxqbnzA+{#{dQSf2^T-bC!Zk#Tq2!N(dv;tZ
ztAC(#V;7ax2{*Nz+alb#l$R8^uZS$TkD7&WH@G{({lzGQ`-MsF&2=c(xo9y$t@?FC
z2IZd1|Ne~Opf8_Ey$IR<_paEM6{6_xg^?Y5L)yrWBy(g(dPYWe9D}$Y;SG+JM6-T_
zn}fH!B@X$iOb(2micos@S>l1RdGNoRv@n<Qbs02Fj=CJ~#}>Kwd&r#>wHiFDD(-<h
zd*c0Ytvs^Bg8t(&Db}Oli8ra;JLRHw?*wX==*RJXY-t=oiVu}jy1hmnK$}CFyEsS0
z^CYAl>-QYoTiMQ!^*aTvq<@>DylRJrC{FkXVTJ<ZxpXf!{~4m(M!RwiG1o>XanwqU
zjfiu<M50aG-Qc7@7fab|Vvxn?O`~P;=s35HGK=@;M%XC5_*ibFLX`Sm6T>+Cxdg=<
zWX9Miv-m`AoQ=|pPv<5mB;#Qai9Z>ytw^>}W^qJb7^N52&4a}?rQmhqk`ZZnX#&f!
z7_Ax66zF~%73QU5L9PtjG^%S}JuzLO`$qK7t1mvX(b&8U(H0|dAyx}t-bHy0#4Lrb
z1j14P{DsPe)-8qf>=@C+Mw!Kxd7L!oA-#BUUY2-{rK}S#j98Y}Qhbf^ybx=}Zr^oz
zt;A0@x+O11{H4&mKKJG23lHWNNSDUhPvjMeh6>dMDiJg*PEszPyE(75NXJ;8I1}f*
zme*D+v(e$aj-o*;3R^1L4UW$5Caza#){wOPULuwb*h1LA!OipgqQ6N<T2FuRJ)_m>
z`D3GF`-_G-%!#@^nbKe6N+j;@Ix1>_C|4+A%FdVp=&3TNC~9y?>_D+gp}&&4S_4J9
zTp2dG-towR;)Fu$N=owwif(x_EUTm)&~=O!iyvD>h=Jm$3`6Rj@&}17`I6I<-8X-T
zz=Bfztrh$F56B-XRw{IQ@VNXD;#i>!E1I$>e~j2wB+<<2H{_2OzcN}avdf>$zfhzX
z%djrfpU<Bxo>FMS%n$OX3Jgi`w^Rh?ewja0Y+|%pRL%H3f0jtcJO@giOKG;KON-RR
zn^^z-gP1K+8OidTEgCUeiadyd*`k+3V(IkA0-xxo(8&JDKvNa+&**AhECP(yikUMS
z6kIH>P+>D?{2=^djY50prT{&m(DFuIjDXl<qoxIwVip!CQXXn18Cdo9BBQn9<lO9n
zOGNi}GVG4BcdP}XQlUW|3JVsBf(|llL3y`=Md;&5wA<Iks1oaK^rclT-nCJcQ6v7e
z(Ftpb$iWN~rM}zur**lguu+8PN^ygY;yla5P8+3oR$vAo6z`<5QuMS@L(es$%0|Mx
zPCRF$i;Oj*W#>@5T+j7ll8s6|>%{6XGHw#D*yxCHi}=w-T|Bpn+%8heyguI<w~Ivz
zHSaapbC=j}qlun-#l)_}DXri^F|ivXabDX#1rLgv?u6EghX(fp+NIF3al;E95)FFD
zu=Rr{0^O=mM%k=_N5xTv9-3QO@R)e2CvlSXBo}NF$0QO{`&Sh_A=>rgF!4mUuGSOc
zC?jcuPl)ZkDQvX}mMsNmd>Ns&qDQ9{1y6}(3e7QYD0oK1_mN?J>)cuJthijE=acUT
zI-$_xX`6uh^_84A)_)%8qw@)^6WhDL0_46xqIdJR6+9<;F<L8j<$X}_f|#q&`+<E0
zFN%j1x@-I^1uu(!{ban}Lys105l<=foBx}FSHv%jWa+*pn)fG8Dv4hUUK5oPi95T;
z<GEX+PzPVUcuQQT&>JKA=5G_XE3~VdtMF~{6r;6x{^}QQ7Xt>6OhUPZJH@4pD1}ai
z?+f=JPLEUgP{b)jDSRZ-6?$Wufz_2Y3YAVOE8H!fW3*T_ooI-U#iGF^WwB^EgV5F?
zQs$Bg0}4MD?%{-1i^y)X3ipZ286jTYyu$rr;us2BEMDv%EIc44jg_2ZikB3ACMp>%
z7ITZ27akJJ6e=sfuJChlr$VJgHx?ciM}e9s`#g*}4=M9#<ZTG6VMMvTukeVtX@X4Q
z`FZabekWd>NNB0pJa=E=ap9guXssBN_jTb3@!SlFW={I0@MjS@lh9&OR{VkStEjw)
z&}uPkv{CfCxO|pG6+kD&^|J{r7DLOUivAEE&5<ZGKNq`PDt!_~m&X_VDH<#!v|2=z
zwJ9=;S&SBoC#Q5OGL457+BT(Mk=uw3%6Ko%>{nzN<qF+}Ey9t;{zWqEnfarOB8|vu
zmdWjPl(9%6v3%CFqA24Ng<5u<TNG`4qtMRD3yNZlh|4&h*g1JgQLK@y&|9Tf7sVM9
zZFGH6U1N`p?kGw$n%7XgwPM=5`-@VHfI?lzKUtJ+T&~dik#7`b7^REB2+l9^b`>==
zwkhQ5`DsxTBX%i;EfrsR-%o31oTpIwxbM=M8<#0mG%F>&x$!h3`Oax>Y-6-mOzL>7
zsJZdc<s@abNNIPxsD-iO3PO^zrLl&Qe8yTDTN#l}{9V-2*l;CrE)}x_R&gt%?=p!t
z&PpoIHtuJ%Sk%A75IM%m<rKD9+z}x3heDI*W)$Zb$tx&qt+;1)W^t}js?fB2Z*jh{
zMxkw&6c!g6cPcb|e4FATLtHK6Ey?duTx{IAQiw?C(sj-S#U;kW3T+)Sw79kL91x{2
zVa}N1w#Gh%4i6bq+|l@pk<4vZ!@Y_)Wp29~=@N;9-9At3YAj-ep4Gf5#odf;D(tr5
z7ZrCm+}Fw!QYJ>nb~iRCw7%Sju;!~NOs3G&$Ymr`=xHpj6?T0sbgPZBu-0>vjTRO6
zGIrVMisCZkgpF1f_ca=<38lBL_yVK1jW!eyG-lf9;o`x@dK*1kJj{68MsF6E8>eiP
zBE}eX)`n#6EFNp*+vt<x@y7W!I#N8z@Y(2_;>pG`8=WYgVmxA_KZ>UsJ8Wc?%rFky
zD6V9t@so|xOJ*5Zh>pL-A}}ki#Am$3h{`idTx`5)qeaDjW0#GtD6Ta2*=S|)eB%on
ztt(z&{A8mhB~?bu4WazCD!I&PVWZY1ON{O|>RocBF~&wIV!1KJMmvjF7;|j&N%2Z!
zfsF>1Tx+bc(a4h3#sfAQU$Vw{)kf1xt~d7E$SS$f_`*hUB{vzzZ8X2+79(<9NNYo^
zH{xv+0o2?^RVB9??KE_o(a%PPxZS9zg=W`6^J<~0TIh;eXjLtALoIY$Ep)F$k<&|m
zK<bY$S{%8cGzI7x6;@|nSL+VrWfhh_FGAd5yrsfEL%chUohs~G#JkhjBg0@5DdH~U
zu#F<HcJ@0P-R!!@h`KRUW=l)%HL@5{duE7@MlU-oxnQF)*G9`r9xy(XNW`_NDtOTN
z(MH#mJZOlUSSG@5E_uj^XS7Z%=yPYu!^U(QJyx>Gc-KZRmON=3u+cjuPZ`H;bfDyE
z!?>Abl9ZoHo-vXYTH4{yl4p&%>t)!nY<KB%#x8{ta_W?BHj;0pFxks{$(V8*A$nHQ
zN?$UTNfdcUs~^M`<2pu*BkyaK0(7g*nIg6tv3GDhQQXH6uNWN_x?yya(pQXL3OzNt
zRq3lne}(FdC@Ou;7-`4rT>6GFSD_I-dzHRv+{tL2aP=%Neb;zcg>~$cB6b)@@096{
z?O9Q})A-d!b4x!kBJZNGbz;KAF?ByO#wzsC;02|-jVX+-6vxIbDgD@3q{2Q#ANpfs
zsX|NgX93-z(1O;L1)msO6&eM!$M{yE9fMbu?lpd9v{-Z(Sz@1I-c6}576p;Fm40f}
zXC&=qzmaL96tUmPvC#v`2aMK?E=S34DE-XnVTV0h`nfTY5xsr4lpZy{V|1lRo%Md{
zmqwF&D7`Du<2(#hqtLH&x>{cv%M==gr{hcGIf>YIzcjWnS}d%BzWHAo|JY%D^S?5h
zZ(y0={J!*<QE8)<#orrS8Lbm{k2_s@!uU&}14W+JCyY+_Qaou(KN{CFS}N`t^n>`(
z7<(UutreZRrL_Lh*u-d^C>q?T^)JRrh2q+HTmNPxZzRrj;y_VR>)(yJj8=<rgFCnW
z!`P<69&6XD^(mv({gU&x|HIy!09A3c|G#r)x`!PB4~h!nf;%E0yQnPZuwzhhM<a^H
z1w;`QA|@heG||Kbjcek9d1Hb*CNXN_f{7$*)L<emi3mnb(5S&gjmG=*(|v~VmpAYK
zcdPELTes@9%5OcN{&x5D^z`)f3@{VYKk!dOh@kg<h6O$`tPxb=^HShb!+S^ztOt(s
zmi{vA5cJ|W_^p4#$ATt<_ssCQpaSro8BPd#uiw-_Nj@X!V859_)q*@H%?UKfHG+I5
zEdcsi&>tb;k}TgBq=qgHl;tN#yq6St>Nd6yE2MS4D+3kzDpHN1S@>v)%5y(pUZM2I
z(02n>+3Q0_d|hBAry#Aco;hr?zm>e6lk{oC`+-*ST|pHQy8^A{)G}6Xh4k%^PXcY^
zcaZpc!d^a%w7`0Kq_<=*&)v>)7QxE+^FVufHPQlU$&3?$j`Ej+-k#wq8RbhN=LyK^
zD&G~}_mH!>?74&0vOu~9IX&c_NJY}6iJu3ymg9tXeDI0DHu5Y%_XfL49pyJf&V!Ra
z59}mw6ke0zCjz_3-w1La?ke?=>je2k$NBim3wN^ZEt9Oeo)7es8w9P0xE>fF_t}MQ
z!7(2s=W()*^)VZQWT)NeSr74v^9hpEI6=;Pfx+?(jh+Sek&Sy;PIeYs2Sv)oNDHJ(
zKFxySWtY9o`$DQ67iOCv2P6Gt_%o$-P@<eDyq11_)g*Z+QlYfb*ghypE=FQUvujYY
z{IHzWvOpRf-81L~xqKg^LYVn_17&{1DJ<F?lp^2!m{Z!=5kUjwlb>+<zVpPOfwKLl
zoN`9x2Bpd;4saTq@+wfnK~6_}76lEKBR;dxhM?i{Wh6c((&V0>GjD~I>-c_9nw*KW
zz?x1f4;m@Q9cCVD^&y}$NMA^gx||J4m+Ox(?+a;E_|>2cx$G#TWzx`@w}W1i$uUNJ
z>`s#HHTpAXlH86Hj58XXDSK<=7@Q^d67)TIQ)IJ7j=|Y-s-WY8Y4B8eltzxh)8s5c
zO@`Cp9C?;Tj=|IAg-EL;HtXlgCxkaR+HA;`osMHWrL^c~!MXA$8aW2fl)b-T-YR(h
zk{>WjUMi^Xs5ZfQ@_Iq+itw`B^h=)e$OymS*|JHaV4x~N_7ft43*?&`^$&hU{!`G3
z31frj%1uu2T2@S$5nLp<6EtGh!r%pRsz&RBUy}=w`0-mLFF|5`y*GG~T*e7T*5TmA
zvQs6ibA==iIT5@>9)Yw<>X-UW@SAdhpc}()1}~E@3c4`JKBPpxCusBNHX*BIudjH^
zo&{X@SS7C(^uw%fA#cm%Ywo=`CLm<B>?<g2Odp^OL9YU>m3Ilc-}Qx%_3~YfhK9T&
zhn(cKobY}j<Xw5AMngk3$;v72-S7Hh$YwcIP*nbekW#roqiG@U$rXZ*4(sgyFS%Ny
zypV13Z9&!GeIU!Hd7ah6@<PgFH$fRt=XQCnM$<xe%C&;Nf^xg$hZ^OD?2+xi;kDF&
zw^wefQC`SCIYiKt?yrP=Bp=jhamc4~ogm*HuY??uub$zx`1V*FazwU1%gH@=bx4JL
zQ_#iqjUmV7;B(x&nEqkN7xGX+C&Bwt{+C7{hMbU32$IHZ45^fxf6L2BV?GS|N)8cp
zGI(Fe*YY+&j|UzKIVqnIWS82;_LOX@;^kt~Dnd@nO9lN4=&bxi(6vctLaOBH=XuV@
zBWpvxlUEC>9Q|v^_wpe@u_K>^T#&B`N(izEt(J}7@p1!(IEP-8GXy0MX%Tu^J}jtd
zkItb#$nM|soSV~vL$Attf?mvz3%w?v6?ACKu+Tc$`U20{Z&G^bb$PX*QIjW!-jLm@
zxi@NZe&|j4q(()dKg*dHE#C6bdbvcScSCQ>rb`xYXXqUn9<RZ_RnpMO2SV@4>ouwj
zy(fELv3OOXzsXBAstaw9-G1O+^yGV?zsuelJqrCpUaXN4_DC+*$S&-$?DnIjoNL&h
za;BgOz1oL8k&j>F-h^J=!=A|(1nut?1Rn&AtL0w!klta6QYL76N;J@?oUH2tC;JoS
zh@h{KP6*nEbVig@QWD@#Ec@2+I?WM1sH)@&`l?3{YNeEGG$71c`9)B6UJ#JObzUwz
zZ)li};;m73n1j;!CiiTn?DcV0QUuvf-s|I{j2F}@Vy{nArC8AEL3@3SN|~UYIeUFv
zmGgr7r0(@;rrZ!z-F2@|bLEks2SJBI+!Uu<e0wonio;qcpJ}w$r=@aUqc_4@DZgp7
zJj`8j`dPHoZ%vqovKooc!mX7dzo2LB+I>q{Yh{$67Y1$vnks0LX(!M;LDmlYfJy{S
zbvXd^o}hNkj{tolsAG#SfxZ%S*ZvgHWkEw-z6H7?$hLVkkW|mx;@ILxAQwST?5_iP
z3CeK!1t>^Rv*!1J;smv9@dwawL9;!d0%Zzn<*D>)t-K=WHBTF$rGh$pHUZi!$kEdk
zs9aEhXDgsD1g(y33v@xys}7xjeil?qx&u8C^jediK#sTh9{IY40<{t3>DCv>UyxNR
zGmuHp_Ew2Ng9R14_XnCF=(76|pqB+5@E8fSSdhVUEYLfGK58)$XqTV|?%6;`1vPCs
z1E@;S0FT)~KMBehSP1k`(2#+z0omT+`_Oyf5+HX$F|jLvd<3;LtpSP<lsDyFpaFt@
z@Z1WNAt=@JL!g<0#(3@qS}3T>^JAd3f+9Q*0hI~5;du<`GeHTSl|W|%-Shkg=$fGI
zp67uY1g-GA1f>4T_u*5|8Xz}88$E9Tbrtlb=WU>HK^q4C2Gmc`gRn<HqXmtKcm|Xs
zsBj<+Z><yyn&W2&v`WyhY-gbN1^M_l2l`adkJ%nTCk4eNv<Lb@kbgoKpu2)rCG-H2
z?~3D)5C~)xRF=>SsH32a=t!UtLERl<ff58QaYzPA6V%)|5NL{^iN;|-a|In~@gmT2
zL8Dua11c3Hc}xcSNKmiV(|}G0YTa@c&_zKbJ>~$_3%VCk1oW4nXAz5lobK^G3Uhc1
zsGT4$<4T|aL8n`+1Bwyk;IRp4sGx2w{{=Kj&?JxTKm~%7u6u#r6m-AyexQwleu(`X
zXpf+IxyOMj1RYKI8t6MgP2<i2-4rx8;d`LRg8uTp0%U)m??dUpTA<c~W(~gu<SXcI
z%&$OEf?|h107@0~M#7&!;|1kM8hW=@@&tX8V+HiOpy>_{K<fpKgqKjYR(1%oYS{wl
zu%H+ZPoQ&xQd@QasuQ%rqZ`ogg5GH92W0&l--n$Z!9Xnqjh@~c$XiffQ#4Q?L4l@t
zpcFy1X)gec5%i*I5Kyilm&qf576`gIJsoJZ#Y=bz=mSB`XJ!E%6m&OtI?!oBRo?kP
zR|QS){3_6WK@HyXfk*@2habG(0BR=amCnn6It#kx{WegTpm@^;pd>*P;<o^e67**L
zHlV43%Hwwe%@cGnejiYYpxN;UfZh|dDgFr1CxX6={}SjcLAT>i0bLd(C438XM^KxD
zY9M&g2mD)QZ8h^pAQwSjrd<c}64WvA7oZ?P?{vNg6enni!yiDy1%2S~6ev?rq*3Vu
z*FQlEj5a_^1^v>Z3D9Oib6UCrl?&?X(F*7bL1S9C1-c+8q-7_dp9RhG=nnKmkV9lo
zAjjYN9%Z)<1!^N`oI_tAe?c!8%|IqWk6I)G4HgvQ(I04npqQ3JfL<0f-(w`uVnOba
zV}afg)GBTw&@Mq8<FbK{3JS`b0aPU@)?qf#PlDDu6aqaI<Y#;h$o3Du4>OHRfZPRL
zYOw;yM^IMFH9!%9T6(+-G(gb19$SGjEIDI71ez(RfB0^og@Rtl`xt1gpq7b;fXW1w
z7>@ycCg>A~N}w}>3R-^ybWPB}*5`p51U>b<1f)LX`;Z=41LP)XOu`MIu7a{6Zv%x3
znwIbzP(ML~A|C;b7Bn#78BmU(C$nf@xc&(mA7KZyN>H|^Gtm2jVp}%{`c#m88xNq9
zf^NCD2l_$K4)-oVcLlX}?*Sw~;`=bWRUnX2P)dtlKph2bZ5{~}BIr`nSfB(!!I8;8
zX@ZVV9|$x>(4v9EfaVHH&wdeTxu8u6<A6#9-N>E{^pT*C6Q%*35Og(V7SKgOKc~zA
zsuwgfstD*WL9cgS1myIX@6nQ|w}9FS8rx+hP=KHbo!0@y2%6Vr6VOmWGrIf>Xp*4X
zq1%B91dZvs7wAnvJA3X2+9>Fi*w2CX2pVWQ4pbp%cGs_gz7w?9d=}`YphM>GfgTHb
zoO=bx{!hLS36Zrxtp$09-2(Cz)IRT5peQ8xjjSmTfHIKS)1Rk(+bDG!*+sNhq$jLS
z<~5DzprjxbNr9u=Ms!jxKV=?&D&0j%eug=%hr@4<bx{T(6<Uv(NTn{yC{9v1{A|9f
zk|U^MBn5g+l&gyFt9DaL1nuhTEp=0N3i=x9l%UTdS<Y*MQvG}*x+#wZxpof*g15f0
zR$Jd07Y@`_(2j9&KvA4vkKp$NlnEN8f_H`!{FH5MM0cgNf!7iXzv<LnfnNh*bxPf`
zCW03uXgmB2#YgEUs7cb)2p?sH=FJ9LEvVe@wTK?dEkP|ZUyJZl3^K2?<M@(@o=SkA
z8Dam52vDX7I@q;5B1l;+s5a_AM6gnUR4CO(eGw6=xWivHv6hYOaUddG=`1MMbReRS
z5+LYi*qMk3<t0I1Ctr<-QVImM^Sv4ot!x%Fcgn2@lX6f{FW*}cF-o1FKYIKY5vMp2
zzP)Qbo<zheL4sDqD3J+DnjnuXhsZ?b4M8=N9U_yJ&jmdi=N9>b@{OR-td5Z>$}K^(
ze_-SQMWuWTiPNJa2Pv&IN{$??_zL<oYDDA^WrCo1-{{C;N|{E<k;CDwzPuJY-w}}`
zlum*cC6A35sq_+b<E3$tBb5|EJNz;uM=4VTJ)E2wIa*mDXn^my$T7-$g8EJ$8!=Yd
zCCIruqa%V|=#d*aR{2`crBS(&8OjBuLg~w>qR4TIj}>oOZjTj_FDapd`T|W*OoDzH
zwIXt&@`9jBph-#^QX#y>bVKB1<$d8LWo?U`qA1q9&eKtcBBv@wq(bRO--^g-%4(!l
z(%8gPk<;Oi8(Gd(@Kd&Hku#MPLGPyAikzj~)#%sAJmrcl&v|3a?~(b6y&b2iep1xS
zim#wEeVwBUl+l9XVp<qpQEuDwoaJ5T`Oa0I2yz_h8C9q(gun4)TX!7UDXK^*734b7
zFKWJWNTcwmg~|m%bED#;-cafsdAXIH<D-@+Ax${F4c=SI>w>bn431i+>=v{bXoYe?
zQ0LL3qgE>R@RtT`>j~qhM!l^J6SQ<{e$*NzQ=_?2Yn3_9Jm=D>3!~O6do@}b^^Q^@
zXs!3!sEtaJ3(vXLdu!AdWwjuO@jIioD*w{xVAQ{qj|91mKNYo2IW5S&|D~u8lph5B
z9(O6KOsN;Nf833z9m<~?HAL-FY}p?j!#-4uqtSbmc7mEfEqfJzK{ue5eM$rpf4=mw
zV&9CHdzjKR`eP+bP<2Gd=>1B(py;^B=!41xK`+l76#bc!Cusi6^ytINdZZQbv(_om
zN0n4~TQ&RXfSR>Bx<WaKv`U&ZE5rW_g}@uEEx+mXr80q&6cqJw^p{Ej(kkhlsRw{g
z2rBJ*y3Gm2tp#sqY1hNil}ehRy@S4r{z@qmbZF4w=&zM}L9++h+MiT5w&dk<qE5Ft
zso1yT^d8VD#a+<8DYo{fm0UqhGOD6aD@)yZ&KLS$j6S2R*62p`S!JU}kD|{h?`z~>
z`c}D&v_jew;A*N;!r>#PtS1%*xtq=_hXswA>}C2+SqOg{!@QxBt3od*-kzMIC%cAK
zD`y2s-ChW}s7P(NS1|pO;j$7UXt#Hu=?5hniT_0GM`adLAzsIRR9@A**V_K5yvfOW
zci&*?s<KYdfxgd_tIAHGHsbfsYLxHMTLr%-(A!j_{HT%HbWORdQ4-KYL1RM(nrao=
zmbH^_y-smJVlC?^)hX^8Ee*V`^wx3?H~pl{)F{JrOWDYCN<AaOrFzBGj@7vUD9co@
zOx9?YN4>IKqv@vG%3(p_5wlHqltJxzx!mB3(yvMhQla!l#5~ilinkZ{+J-Fz$`y3N
zd!gyBQm4^drhCeLLFFUYneHp312316UkWrzqwS^!B}-7N^mV4+mAQg^dz1p*)aZce
zp%T}T*Rp@qI@6!Za0_L^@0%*Qg03LFDd;%T8bRlfN|9DcuaEo^YN^wx%Jfw6?Zmdg
zyz3^36bMq&zceZ2phi_DO040pJ6TRO{kqAT^he@rH#;%~iH|HhG83stI%4~W$&RcS
z^qw=LZw2*g_7vzRT{(MlM|jQcsM($vyRhvQNk2L>N)$A@nH|t5B)&ZdGG2I9w$;`S
zWSOA-&Wt`p;xm{7`S`hVpNpKWNK>-|`BKn$r&eZ1a$e9<*H-2x<f@>7Qg%}(a#PR^
zhaHa2<gTDChU}&;@OP$o#PF<YO5nwrxDP=t9i^sZ3KDO%k>m+4*FMh2NGSZR8;o5n
z=SrNAillY6?aZ!ZxXyDUV}$qEHq6$IOcnH=TbOMNa#B#AR$;a+NoV|fs3PfGpjM<<
z&@%ThTX%8=iEWQc9^@fXjls~%AhjmG-C0{|3>|a5fv);6DwJ-(wV*Y5j8tRenG+5q
z_ux5KO<|r5C!2KijKWJ9(cRpd%obEKqQB%xijeqGX+z#Z;``o)tVSx5GUOn08}d-l
zOr^KEEote?w#Uo0BOQ@=xpu@CsYvRon#}FUaGlqIWC*X=KH1!Xyv7OkeW1A`DM#XU
zb|Qy$<vNiQqTFwe!_A$@ML}6K-Q1bf3p(9ofkPMaSXZtak>OW=+1TA~7w6NBI0>59
zY*9~da@n7I$K1YByOVlBBU(lD@F7+`xpx<+2XRH>E%PO9k@(*Fk}e|W4rRRAmxK$l
zZ!*N*kHiXca`m(ECkcY4lVo#GGE)$7%Q6R$g@Oh*Nj3+PrGn~PW|@P?W<m34t~r=|
zAZQ19*&IU31#P2Q=1|ftfVVo%Da#y2dJDSXnq}@qUJ!H_yl|3^#P^{$$rRrCW^q2f
z$sane50L_SovM4Gxetj!;^q31e!{zDx52kBc}eF*kg39>a8^Z-)xo@$)y)=~BT1(a
zM!c3N(gUeTY7S!}ilhi??-J(|O)iJ>a@B4N%_cHAtg)P#<RZa1gDsdzTsY5p1hx=E
zzDMFmESA(F@$JQuUqsH{hE?WRV&9vW^LE@|jw3EeJZC&<DLjAM4d!^_E9keVpPDC-
zeY%{9<Q5X&ULtw$ocC0e>q4@f5{X|QzC9nh*(r&HBJpy`#EitZo=lQO&POE7HknKm
zw4up-tA3<VP>gG-`315_&@c2ua|&4{s2;{(f3k%WoMXGp1IP&^{yRzo$wMUm`%9_B
zyDw|m7ZUr8r9mVDsYv>D=EvqiWWAs+vpzNtCJzOL&uZmAgcu|E9w|UWi7(PmhT3t*
z%)`hXK`s4GnMaV{k@)_lk-w1mzNZn}NLGu*b3rPSx>;43(@0A})lOH;BS|}5&QYYR
z@E$n-WFAG51kG&rllet5MVE6lnJK)r_P5QWNwFZM#ZTsR^0uJc&2F2=kgd9MW65^m
zrP)6)k0pnZc&jtWNnOqiQYCU)(<kN(a#>JW6D4LGxhCi=-Pv?J`B_))CDI_gXEw>^
zmxy;1@6Q<LFxv^lgv7Tuk)%9FX-K@!CXx(M?j@`2rV~k~ptqbBHJwCe3EJ<vv*~2A
z1c}#~N!B3oS~AHdk#mJ=6O&1{>AWnmTX;r?2j(ntTIWq6-wE$^=UwJ0q(M;EX1mPU
z#3h>VQIXp&^Hkz1s8y?7=4qrK65o0b87#aeE-o=SWFiu8=X5edmvcIqBXX{^ZV@w`
zED&_srbSFHc}tL!bH|t&WHl16WhN;_;@g`^%0$irb%^~;vR~)TA{D~xXd4(ai%6!%
z@tH@gk&2`d&aP4(8KCp>Nt*Dc*t$yj<WnTR^_R&Px|}bQ(;}y&mYQEC-w84}g~!Y$
zmjw~)QgZ>R6Lbu`Ipk*~z7MaE2H};%_Ff_F&5iARm3Si+Ngcs^l`KT!YsI<5DTW`F
zH+-XG=91A!yv{;00g1P|kmNq+6^L?cqz}!7<b9+sq&A^RG4n{X*v73Flh#PQmSWQN
zIgkCeIJ+_%)d%Kc5+=yi>4AAZi4ru*^?`W-Ne~q1_Q3oa86fC;>+qO`WGE7E^&&D_
zc#CWwm=}@hg7Tanm|rIg1i3YPV19$F5i||zTujQ4cr8mvx$t^84~$ttzS4Pbk#oXJ
zhb_ECt|RgNTT1TfaxNv0M9$9A$e5+XF^=!;X@`uMWuzGrFSmlUL*iRsLAr{ZNphI&
z3X&-3TJxNk5|S$DtCq>;m1MY}m927OR*|uSlHHTdZ<C3FD%>{&tR~rl?igQ=Swm(E
z8mai%tR)MPcw5$y5+vT1b!5HBnV^n0uOp>`x;c$EuP0@Ka$U!pH;{5ciEiV~?~sE?
zyv}#Y2_#<UyX1_>neAQ}^De0sG?ZjF-AH~B6mPRIW)t~KP%Zq8>1N^_-#D_i5O<^^
z>89;K^A<u9c<=Uu*`}0q5>x`S%~p~i$Qx#x_ehqYBS8NmO9h>BUKR5`xrM~rxsBWt
zUU$1>^ET2sv2p7k5MQJsX_VcTm=8#@=27WGG69LN;LFHHL2LzIM#_^|Eqn!EM$RDB
z*qoU*r$-sNz{$W?@MYvj;jtBb8M!IEXT!^4%1CfBtEI-kR`A<NUnJIQD(xU?!ejRj
zJ4uNkw)LH)tY72ScajrGeCs>O8BVzMo#cDrv90eUSB1y6zLWHNp>gZG2sA`{o55~D
z>}?GR?t3+2Z+R%!$j$%bn2(<;_lf3p@_*0$Q;pjBAC5Vok(>Xin9rUocUbc}`5$*b
zsu6q3LnFEQSI1P4Xlykfk;lmkNc>12Cqs~mq|VC7nByc<Pz>GS_yx%k6slf}`I5XW
zsJqRtF_mPAps%GTF<+6Df<BSu*ssY3L6yWN_9WRV=r4m)>?v|U(66#n>}hgB&=$w+
zrr(e=f`Z^a;0(Ek#M^n6JQChdHcw4wiG2z?4%|COj7UWi^Ue`(o%byX5Z)*DcIIzM
ztj?<<FX+4~@{-OwPqKw~-=<mYc`{FsU9)Df-;vFNLY<q%eov0-%3UB|2`|NVhvNlu
zMbJymI~=RYU0u$L<e~7U+IhrYBu)D_?$IUE3aLoyW52WMCE}y=E|VbPMcQ?Uy-ebD
z-WAecc*%A<9IucUb>0u;CE*!ulg&Sn89MJrGDmpx>~=Q&k-VYvu96kP`_kS!_A1$=
z^J++$@IGkPGq#5OuJf*uzl2xsw!`rnaURgPf3?INsYu#t9~xUr=5x>5FU}PE6DiT<
zyh-+GUQ+B$QlayHCf77CHTGxHp!4d9%Rt;7)R`7rPrNw6JOOVABT<@{5qpQE>b$!o
zNAogc?~-Djcb{z5yxiFPq+I7UkaL<>5ZgfNbl&eoPPMe9IQDm9<b-W`NZ`*&*+_<V
zE{=UjOgir|8KZe6v5!fv&U-?ZYu@_UC!|#8{Y8#yUTN%Kq)O*W^uFem#Y&V6YCI}3
zZN~}PQXVVQ0G&tZ0L?oXOK679Q|Ua-tB6%;iO#d8do=H4tTnCBdA9VL=2gYo(gvMp
zPhAFE`sH%0J@w**edb7`G_Nk!k*4ZACz_*q^|4O0Sm(LW&6?K`>q5(Qo{^r@yeF|n
zTBq}xQF(}^EhMfPHFCnXxKV%2vyXG5CY{%kj?p}0TuYj(^W5oj&2x`)r=>ctH9e|%
zUU98ymCkEJ?`xiSTpLP;HXgrrv>hinegSdqXn@Z1q60K9JkE<|=)8_}p5~e2I?@uI
z*O~6oyrj6!v_j`~rPnksHLfdd(0Sg}WtgSU(&D_S7bom99~z~38F4-|Rp<HA9L>v&
z^QFZ)&!2AAyxcf{TCVc~=sC?Rhzp=~IxmRI!!2zojtinjPS}<Z>aTf=<3gxO=Y`QR
znpYARMssyuI9;xJ>*K;{sm|*|k7{0NTpwDc^CIYd%`1zGpkzej@r$DEII;6DE{X=|
zJQE$Dc?aW6G(+db(0Q6y5f?*CbY2|Yqj@Le;%J4=OQ6>@uPQEqHt4)0>H;$*pO-Gj
zB~dR<*k}D{l;+jN^`ogeFNNl4UVU5&E!KGh=w{7ph#Nr5bzUkxr+H7}QfZye8%*Vq
zmbQ@i!PLkJ+cK2;Yo2}lP-@b7!|52!GsX|6xjHY6F4sKw_%vFo^G4C5n&%ZiidN~o
z(e%FNdB=~YWK`qv8$;W1V&`A{7#g7SGUx!!3y;sB89Hw~ou_%G`0=zv=S`q{G%qQB
z0<F+_ljt?gOO2mI8+2YKb$QX!XKC@7)Qc1L*%TV3c^UCjXsXVeN^>+XGkz*9)_FN}
zv*zW-=g@MUmrKuSUO{{=t<!lksXW@!mg4xC)W`|jl1KeDZ*hDcHR-&U=@`u`iGP{q
z>bwHFT=Uk)7tm6j_X<6#d8P5M&?=obm)_UBviP}_q&FVFd9)oTcK*fBqX9avm=4gq
zgYm^QL+34^^E9s_egQ4fc?;<t%{v*tkXGot*XcFQtBQY}Ht4*?)MbpN&o0L=re2(|
z&)%d_npYS9CQa3OOKFbg)yFTT#X4^}-K=>H@ylts&MTqkH1A1#39Zw4tEfEI(iW1i
ziW)g#TUJweb%mHG>=RZ~lg?X9$7r50VJ*$odF$zN&2vv!PfK;)JM^gLc_q9<t90H*
zdSCOr6E;$k(Rlne({`NL`IoSn2I#y}IzaQn6G~}@&U=r}(>zncd$dI7y-)XOUQ)vQ
zv_j{7K(A?DYQhJ!LFbiGmvNSUNlPfBUYxMccF-uz%ShNkQ+3`hnxlD{3A<>q&f7yb
zYhG@`9$K#R%IP`HD@Z7(bvo}ODv!6cr8wauYUG4%`GmsjMJ(&jgiokR=Y2}YXkJOe
zr!-gR9i+=OZ+*f+TB`FtqenHbG~qK^rSlHc`<hplaF~*p8js&m+Kv-D{}PVU0G(Gs
z2WZ~GgbJFW^S+?-G_NAz3tFP{PS8D?cQWAwt<ZU2(QBGlmGBj9(0M1R%LGfmTuwMi
zy*Oc?ou*NmSC?>_rs}*iG)MF56VA|Lop+9I*1U#<bF^INRnc>r_avc;*6F<Os65fq
z7LxcKHFCnXT%i7%XP<b1nsnYpI!5!1i5F?E&bv&PYo2@JWm>B9exOG+&nxi<TBY-@
z()*g{op_a!NsY(v8g0jkoqvhfXn@YEqXRTAJh6^u=)9lkJk2vD{zOZ3-c7nk^O6#8
z(h8mTGrgvHsfj<+2Ax+=T_#)lEG@B~dU3)&yF;TiFC*~|P1SjKX^!S)Cf=pRI`2N+
zta-VK_i4G#YoO;euOP93*6F<8shnwPOL5}w)W`|j@{sy#-r~fE)THws(=nP?lK7bB
z>bxg(x#q1;d_qfg-e2^n=9MP?MXPk4q~6y&czc{mvKo({thVFC&c8%i4bXW+9iVv!
z6N#Fk^Hg=7=2axBYKhLXR`+P$$wX_lLg(44*EFvx(N=BHdG@Ny6ic67PPA9OIANbT
zs!^I(m*}Xb>O3bkNAv0voz!BT=b~=byoN*<wOr>J)pMHnB+;nW>AYsDoNZ|fNouAV
zIbmDeRDaF0PjXXDI<KWVM)QnGE!A9|=dLc-JohAbwN&S|R*!0)S5j-WO6Rpv?`xiS
zQX7>_Z9IPM)OMWM`IppA4bXXB>Hy6PPx4YTbY4ewp5~d7I;tf)ud}*G^OBM}s}(x0
zt9niIQj@x>4LZ+Tb(v=Av$P~{)r%AMnU5N!c^OGQYO2ojRdX~iGs#yi)_MNwX3fh@
z@>k1sUVwT|^9qsz)H<CPq{=y#wiG7?sYXuNmJk(Qg=M+^C55OaofoE#(Y%tRFf~`_
zg{#XoZ+%j@TB`H<s7E!gG^vkTrSl@x`<hpl6rqyojmIxaZO4h7e@RhlfX*|i12peo
zl1a_bc`@od&8tX?QA>1QoVrKzPA0{v6*@0Ly{36pNeOC$&P!5VaxMLGIVnl?;)H$H
zPmR*Nx}<(;s?JMMb2P6$DMc;Tc>~nVn%9stKrPpKsp>h+dy<r@*6F;#syxHe7Lq(z
zHFCnX3|0L#&pvsmYSMYb)iIi9OdhW0>bx{{x#qbir>UhnZ<Kme^SqKrsZ}~}w0d9j
zypu<(WM<>>8>6=4#LmCuF=~L$%TNbsUU+hbnxXT?tMfF^lssN7(RmZpJ(`!4JVC9{
zd6U#@nwOe9No~-1nX1byOP{4BXR2PDu+OHbQJR;LJVi~_c~jLK&C5)lsut_K9Cfqi
z<tFE-<vK4{J*RmE$+>Es&YP*qd6u>mC(l%koUko<s=wwfPR>(JI`3t5jOLXjzpUo!
zyaIK(=B-aIP)l{*E9z0rD@}eyt<rgO)%%)PmONJ_`HjbKp4yHRJO7gBsR25#SRJ5w
z2a}7{44t<?ou_#f$qUpHowrckqj@Kj7pfIH?{)Q>=2a!Xt~Thr#j4B8mOi_jyjb<(
zgnjm=8l`!4$#1HuI&Z0(qj~koOVwhXw_M$<c@4?S)pDIzqMp;dC&?vhoz7dO%CjwP
zA^ldVMo!q4)vCYd+4ozmnsnY;b&Td2`>j=Tb>4b)x#qd|Td$Vtym!>2n&;K;9koj5
zZB*}To_D{EDk*3@ew)>HoY?u-Z?hVp^GekLnit-$RL#(N@2T@N&(!ZdwM6H=ukO*j
zq<-(K6*}(&^_u3T_WM9>(0OI5%bdoRm8mU}ilk$9Y5mI7?mBO~8Yn!2OM1WUDqM`T
zpDFGT#D1nYHe#1X>}Pz9<mNxV-yU@+*1~_rw^z;3ZDFsPDYnqsW=qUoHCND8bxTaS
zS|DhT)s~ojYO$cnHrf3?QWqofpR#?TmI!Z-?bwJ<)RC{S{o~vFM4gCa$vF+FNNOSH
znm<wV1u5`5d;8T@g4)pRrk|?sAn{rbs2?ElS`MgtL{4AB!`27XBRcP(S}DAB&Q_iW
z)!&eKEuX2+bU8m$tzKpAERsU4=JfkaZHC0Ra9C|Eyft?4CO<V;=N(b|>bxUrhR!>x
zX6n47>T;cTOkFFyvry+TwOr>_s0Vdkg<7lgj;p`uyyI}B4e&J`rf0GwNfz<%zAS~Q
zEUhxJal%~o?XG{9Q<errH0Ecqf~CkmmST0v&$$HySPka>Or6It)u#l7u@tWQcD^-*
z)w5_4a~tD-xAmO<PENAqGnwV=9Lq|*==Xfgz5ww*Q*y99Jip%6$9&)a#NK1+>>Co2
zM5OkES#5t$-;gOuRJbg^4Edd$pj4=n6Oo$bu~Pr1bhecZnJhmmMMbGE2eGpEqM26a
zFdZ?0)t{KnV!t6wdCj+zWvF3lSC*1Kkmcz=gVosu@)PL;Pzqm8YRq5j&+_w>&#}(h
zkjDItIr&y(NuS@C#_DHVS8#L@`05F(nWyuyr#}{DQOsp2GJGSA#a*%ebvX8TPVTOY
zV*U0(XO^e=G<JM>ye)>Myl<AF21{(I(^B(yW=o1Jo%U{w1IIVUye!|=udo-Evg>p$
z{J$H2gGa~G{>C~#!Li5FCnPqe|2(cS)^CfAOhtMd&lFzj^<0+X8p@8~4qf`s{hm*!
zq7?7>0O%_jzO=;hRN!c5F}%nb#xUDo)~oy|upW@1pIQ3lI2Iqlp6B)a&)VQDo^Gib
zz9FY=#WLG`0plFTR1&K#qz5}vD^pnfkq=9+8^MmOIi02O@!+Q$!w-jH+3{>l!bjI2
zPvclpq@O1~pTf5&V;)Ow{EXoB^V%LkDFwc^B}4D=I+qS$t>QD@?POLb8;7#A4rA8m
z2Kc^Rqx!*|X4z9VbFwd2v14%_l)|?mC5e3%Pm-)~kF2q`Z6rTD2U*X<IRdc)UtW}<
zp2sgW)^-NZP2LZDF6x%b+@LUabRPHRaie-eep$?BqhP$r@Z~L5bD=+L&-`c^+Vdft
z^{TWR`%0O~%CbB%=CQ;{qZ`wMF(=Dokgktqnmv>$KkjT+;VH6oOUuJ%Hnv@!!g6w#
z&yeu#G;AAl6-kB>W$C>cuw6wQcRq6X$mDT*7+03DngVBvjH64DoN#{Q?O`>;Tol0E
zsn}Xpr>v`!eUp;q8IQ+t?JVXFieM?jU}lryYhEm7?dNl*LHZ4608i*ES<204>H63l
z$<lv>Jn(%oI4_9w5YLW(O6NVsTgzwECwK+?ESS~IRE94#HpXmUEa@zUukQR0m!}YE
zDUKXo!@i)#QY?PHRAb8XrFi|kEZ;6uOM4n)_|hkCi>L7XjcUoyQh031&s)w^7Bz%p
z{eA)Ltmif8-T!C%Bn6JIr6*bZe4jL?{JTEkW&ihm!t*z(rB7JOf9ew_C(Ed7g(Ho9
z%f$fSu4Bqasa{{lvBBpe7R%BfS_(f0pP$M3Y{q9WKDX=F8;d5fbw!(zY+HV?GGXg0
zc3gPMk9ckRyS{}j)YtPquC**FthV_fthS!m|GfRzarR^9wPk<#InK^&IOAq94Txc-
z_RL^ycm_&fEy312y@zv`?QcpVb6Glkqp@{kI-4P3RijJcGXqcIXP^Fh_eLO_dq2Rf
z^D~sUZ5hrIOl8R*uT%9nW2fh`ZLt&?S2YTJdzGaW;tb5^a67o7S?0-*9&BG)<+D~z
zfwmDirfgsM+|JJweira^gwM2>VJnuobQboNF`lJ#fH|DcnK1X_HL(S(Y~j`Cf4d^^
zJ>{w&Ie(9D_GC3X;B3rd1ALpADW8Gc;F@qeT<K)I_9?J0%pE#}r5qW>Vm_<06z&rI
z5)sAG%f2sb$^ZX{Qhc=Vy|crs^D<ml^AsNQKID7N&OrrxgJ924+;{ecUCVXfvKnd3
z$yX6Fminh2vx4vAvTtcL)kZR0x!@>h3gf{5-@au>fsflxI8Lfz^(ad`=6VOON^Gsg
zubXhagCinK+auYS96Xg>x%mAQ&%@)}c&%aU85!3z3a)1eu4fGJWmA?uU^?6P0k}@M
z4Erlfzrr|tKE(^y1Btk%<*nuC*B<CMxSm4$+4p)IV}8%V)A{+%V?L|!vzQ+vKDPPn
zF=KS&S<LI_a|l}{vh#(l>nt%lAAg?6_T7@gU6#UEl8xt%rBq|f6`Xl2a~IFaujcFw
zRm2&}Q-<_nDK~M&%Tw}j_TXy_KG*U68r6lh^Y1awSsKvj{yoJOdykj>yZirU3hOcb
zwWAcS=FeX{EUo%K=j1)f^7Bz`>0#FM&&PZvtXIA&=GQEL(UXlW(WhAA#ya^Hvv8bP
zT5EA-_<H64Hs)sy+Y1@KbID4z!lTAV4v%^LJm$xgKmFi&c>MQL|CHySYUBC&b*CDx
zKJd+TyhiY&V@YAxP2RWsE{xa4pTn@&(&y~HhCLVJcSfwXE5q4U>?+QR%$239@I>PI
zbbSr~Ip%G!+}*Hk@uxs>xHdk7D+;z^;m=GOS2b*ld~DxNX2+VxLwYsFO>q6sS3Z2k
z?t%AlpHE<U__@!YGw>%TW|+<3X&7wFAUS2T_yjy_VqaZl%8zW_AQu0Ds|BVqe1+7K
zBEwfm+4-(d`KR~=9HqQ%jcYT@eK)_m=j$}fnvKnG{OQDoe(YHAxNCM}95|k}WJ5pJ
zDjxHClq7c7%=7bo;c9VNseelU&ppF?kDnur%KO0}`hoYr|5Qs~so2}6lGqXX4ChIH
z9Qm=}r8=T(8pe+JhqxZ*=NcbZeB``^qoq8L?K``(Gf4Va$z}DQ9>~(uab3sMa`*T5
znDvYzo`G=p`4m>$?{Gb3wf(2K%)c>@C2l-kyk<V{v6#0_mSW-B`tRcJ@m`geI_=GR
zV=tZ^mXyX){OI%a#@JG4x514$_3=5pM)OjQ@jsWkjpshUy7BlCj(>ehBCaaAtB<pB
ztlrCFN8vc`#Z8P`z%>-!Ifgy(1+H88Q#ihUIDtoyKl9}2T-iOiEP3Nu`S<%2o}!;`
z*$gR5ZE(AMw&co26s*;8-ad@?u>3xhyFPd=;4=vydq3kG$VaR`g{8xNE{sV<JTKxY
z>{u(}DGGZg3}-7UuanpFyt2{7@AB9a<HnfP&&#s>vNT}~8xK5%&&m8K@R&U(x2!|{
zDdm5ke|9cwIoBO<#MyJ#Mtv2J5qJ4L1@9TYuG@vrf7n-U;YlXUw+87pUU~mXNx1af
zKZEoGZoLk#XnaoQPlp;3SZ(~yPJd4EXEN;hj4Ynd@RsCb%lWMM_xAI>;L4ws>0|!n
zN}uPSVqTW#=T8fH$|u-MJpOwMclpz&g?RVG>*woUzMkjG^Kcyi<IVESijN|mUw_vy
z2d`FK6L8Myi>iOF#q+Zi{=Dmdr@YTS@hRK}yt<9YbD8!0zpEht?^gId=07PrgACGU
zoGbL|0&|7so_7{Jg@bSAqVj&=rS!2r55KqN{n;GP9rh&3ApO%3<oorXTzI~L_hr1d
z+5Yl>27D@L(HHTE^V;+=?<JmY4Rg*vw}kg3d=?t==+75kRzH^XG4Bn&6~5B=`#JUZ
z6w6QC8dr&YjryN|GRW6*f6vKN{{EB1zyC~-?<1Qrp6|mKhO@oqd!av?{J8KDD`FgV
z`Z?<VZp{0WmuiDYgs1GqnJNpPesl|E?fE{0DW8GY;heT&I_t6S-Pv5tX6*mQ|LuqW
zj)DJ<f&Y$y|BiwGj)DJ<f&Y$y|BiwG@5caJweqJ5{AUN2)jmuA`<k5J%{8iJWzO#=
z_^O*Lzc=A4=Q(hnE=%Wd&8+{~rGEAP@8aIlAwvXw)B8oqR(er75C2v8e+B;6NYf!b
zS8|lrNG;+2dHCN9{$GLrHPTv0TMKDxA#E+Bt%WojiM^A<8I(#bFm4NKEBS#sNui*w
zQY30TYJb#WsOhK^QKzBiqZXnrLR|yeQrZLx&t_4NfVPpG4XoyPQ24Dp(2mj(gRz%E
z+K=xWwU_4R1Vg+J{tjrrVJ^H0$SCa{5i4yo?1lFZ-NRCC6;?K12@W4E?Z$XN>JiY6
zk~h{6fTjFM=d@xe64X`Njcuqz%_jr1mP*yqmpxZOPZan3P&zBA@FCSl(ulM}(lX*R
z?xd7&m_6xR>6Y|I$VEtZ_4yHAd(P4ghF^Q$f%x%|`;guZ-WgmYtw>W1M{q0EGIR5Z
zIje=CKeW~p^!|u0hDtKl)Wa~$a6UT#;({qW?gQ?(z08JN(yU(n4WWh$KBElPav9WF
zN$eeZK+gPFo^vw97rc2q$5103_bve)nEwuxx(=l(Nv;da{}A%9t$%6AH$-*uhSqKl
zWi9LmU)!ybe!(~+*c<BK+?nNfj$|5^$JA~n(+LCFRw~WsAeOKVZ7@%RJ#$-Oo{Z@|
zVC(ntE<wtA(ZX6NH6ykjQi`zD4Z`xj(S&J$E7SIFOzm1R-Hp1?oyAvCKlflU_2m2b
z5aLf;@EE>(OzsWsBxg##5q;!bJc5~0SX>IkETur|<R2{MVoEi+m_1r9#`MLQvl!DC
zV@e68EXI@)k;3X(59!r%DQX#NIp#cwT7h~}s8!b#xrU6(8>`$S*AsH#%LBo^W<k8E
zXA!7h&({?;x|S)AU_7i*s<6~$&}!L0zt7sE80cry&x3yFe;Zt@uFsS@%u|nf8l+nh
z1IZI?TOF!Bj3QR{SWX@>ir9bZT4JCf1NV^z>4e`2h=0hc0{u0IX++*_P%p^SAYF&r
zYNS#9*cdo4%azthZ^O6gcN;E*wt_e^vn^=npib0=vhOEWN*8d1T=EH|Pq0-_poJ-N
zKKvehFUT1Z<PBrn&J;!6u_a!jJvr0!X#?gDz?5**DrryDhcpS!+#56%&gEw`&9Gor
zu#|4Nm)BfPGwkl$R!zmTJ_+)}Y(Or+(XS-)VFV@_*mf(42~!IFSo+%-2PLrh7mP<{
zv-mTN*J64<jQ#ytdMU<{nEn9cTFn17#=9_mH^xaA55@RV7%Mv-;};`Xd=2AG(5gx@
z9pg!mo`G#{L6^t*su|eYw)6me1DzfHXi)Y&l1iz4)E(I0EwL$(GBJBFx+By_hQ+PN
zsD5<7te4bK+A%##&BPvyG`t*i5oeE;P?o(BwE)u%bji%!P<CwMG4+TX2;WveBEJRm
zQa<@2?vB)!z8mwE+Ln5oud2n6|C!R3+L}8;dW6{kIt2A4)Rw5{v-=p@((~CrL8<fE
zb1=S(@t>&FilsZCx}rYBJRTTJayq<cwFAbJG2I*E0Irx)i`oZL*qp#-qy&h)O#M+u
zTd^7J6{|=?&xrY;;SsM}Eyn(gG(62)XH|mnG`cNtmsKHU<3FD!cl`)TT?jn|`V?lK
zMUZZg7SZtTRaR^0vD8aei|F>$t5%WnrJgse`pfWDZHULkJ+|6LCuT|3{pHrds&%B?
zc8r7ddN^Lsl>Tz~$hMI3jjy-$Zm2E5x)jro(7(FGSuZv`&3qM<%?~B0!{kdo)z<lj
zo!z~qNEpNGtnz7)|Bu$wX!q$itrwB37Qb4TV5u@ZYUQ{W1U22THps~aG@`G13&%z}
zUPq>p_ECN|)1b9xn?;~Wpzrq`X48N(!y@^o*q3b1(jDe3n~8E^aDh#YRE}q;RTw*?
zt->G$S`KggG$i+2X|qh;-FKbMBC;v_U7I!Xe7`#qi_2}=syt8LtYbEna`4PEHWkpS
zXG(?PS$42gsa)-P-eww|8gT>5-nQwYruTXTDUbcFY`dtwdCs=es8vrZ&{{v1GTD!%
z_$Ico^;2^aeQZP3_VEF>mH0*SNZeMH<QF%>wo3Xur>|NqAM82JwhH?pp1TlJXfvCC
zD&-;Rui9Qlw^F`0W{qtf##MMM>LIR{t6&bPwQYboBv@*|8H31dRRG_QXR8I-J-e^E
zUp@zC-+uW=IPVCS-7nwIXl=J&uEX>n;Ho;z@LJ4OwH)1Y!;+ap?TpapY<7*vn_$Q0
z%mTY~7=g_p&l<l)b|wRBzsX?CqLMr2td{*kx7baT{}uL)U4Jzv>b#v7rhAKeDtq0B
z^eHA=`-!q^)L?a@?2+nde}p;@Yy~NW!EHf9eY%6XcMG#;$Ic+JD@BTZ6>h7_!1`?s
z)W+W8x?%hf`^%V8Bds3!l6|`2e9$z|-F;`-ACcdHuNoPs8D{<f+<LfZLqga(djtHc
z)osNjQrgZuWS<1F0rF=iRuOp1CyZ)#m5+3&ByV=<VJJ4Vk6^2UY>e4=AF5ylRco7y
zJ)A1DcR7~hQAop-G)zg7{o;m04Gp<$Zu|>18P+-ZWL1v^4jH(`44L(0hMYLP#Gyud
z2aZC9%zD1RVRh&_hyDho-@6XeRL@CU9WtS|5w?Zu!=A3NZgCvD-yvW182h<HF78E!
z%#KASYJtef)>;LyFRbQ~@!qfkJ{kNwv?mkSHbbB#m85w~rh{>H@d#HM$6;MjN!nq0
zI;Jnf6-ySpvc8gJU^>BcKTL0h=@0N)a1P7%z&ukhPan+F8S^+}ih}E<c~Pvk)`>k}
zMK>H~^<vzM#n}GE*#5=xX1^lG#W0d<ZA-9M^U1xu<&Kpk6kGl_>_w8yRyg@28pe`A
z-JZSLaXr>!pi!|C?4}XVUfUdNBm-R2*_pLQiNsYOT(e*uSV`t#Kg<HHk-m=G;W&-B
z_bPWRmD#Z_g?gSTZ0&jsws<Fn<*x%Z7#>Y$Bf$l(bY+kyMJ|`wY*~Uw{2<@DVRQ`3
z^K}|4<u#erf61pqlL~ZCiaaaEzR<)#{o$OdmRX!n0`f;d%CFgL$t`j#Vq%juI2*7T
z16E2hn~N?BWi70d*vP4qZNgoh>aiahpk{;AAP2<sffP1|>*bCa(N0g~$I1}U8y@39
z*&ELZ+zV98PvpB~Ii#?+p4($eJ=U-dw`)|`R*VYUt~<J3sNSdnpo{DRlnvue&PIrz
zDZACUnF-GDg)FGqq_Crwq_FuX6;qNFc8-{oEck2gG)&0=H9!hioJk<2QYPpkyG*Fz
zs&g*ZkfCsw^>ePM=jcEK<YegukiS|kMl~ty9La#PU0fE6vaE%RMX41LCg%*rs;kMl
z1o9iC5{30rjZ`>lkPACTqg?Jmx+~oKoS5~J%X+M{lq>dp8OCd5&y@Wxi(oW<4!SA(
zxJ$Xh#$lzpC87pmwl+J6JyWi*cA9WzsKEAAlCF4;bZpMX#;dqq@<d&OXT%#2pH+Lg
zw`*E~Z7zo`8l;0lS<5qUyj_MP^$bP@(|9GNyV(%06i*44PAVg<hBrN_z_A8pZyjfI
z<1C2hJG}zR-aKA~dvO_i?=tqlNoA*NDY)!S<dx($oE-%?5(;oz1lwPS?XSaD6^MC;
z%~XEsO8>`AA5qU<Bbw|sd>-(u={;p`A~o(d{G514@>Ay~+8Gy-wGqz7YISaotFcDC
zncK>E3&xm1x}~NBb~4uEXlcOupJ3Y>a4Q66{%YAC)rfiv?y8m>-C^c8IkT&PL1Mbi
zcn@pKCl1~3NRQOpQ3s3$t2ZZmOVgCK6OS2fto-6Cjm}oP``(e*oN&hYNL|$<!O9Ek
z^hV7vup?+Pu=|SuObI7!eQv_IKxT0%tRI4<wpMHwU1V6BmEoFCp2Ccjgn0^~<*Id|
z^5QrrsZc3EJ=kxnYXiSh5OyvUDr_dtht{grnb^0fgq;`5@c1rM)KJxW8P>22YgneR
z8kS+HDx8=6tg@pkT&u7pY+VFBpnMwft?M*-@1Qd_p;mXtUV^xD+C$ehN=3w9uA8vt
zO-kNKCn=4r%(ib9YE==@qS-X^XNq65HR!HU`VR_fmVtZ0?!pE)i?`~N_!{W0(My_T
zVtTG{O?ms86^Qt^>1zqQUf*d3b4fy9xSC(-@@KPf!p_QK$YX$O8Jh<d<G#cD#Nk|9
zjQd+cSo(TQUymubNO*o`^LiYU^>`MS5Oyw?U~Q#XTPeBG`E2tt!oKxTO58@)H!sI}
z4q`oJgw1;gv9?m;m+9(OMn2Ez?-owjC@mxBAuc12CNlkM64O&tN4V8v57aAcF0H`*
zI*D3^S`X*)Gq_{jmwn!?7`~#=N4`ut`44vpz)}Iq!{|kJ1+rb9(xQ$qtx+DqQ-vDE
z(b!k5Q7$I1*c<L~YLo*Z-CEpIK8JV7+*15g{UAP-5DaPqUq-v7yn*Ro&vcdQVUJ>^
z2Hc}t$`5^AA%7QmgMt^o-^6|(ur7l00#`>yjNMVaP<I;+jcH2_q%Ej7rUX#d<{HTv
zpT=|>GpJ=arW>g9)Y&af7_-@LTgzM0hVBPjCSgh!*vD<gRFU&oj<J=2{x-e9E{(D~
zQ$JYYcWsq{ZYF9jYABfjEAUW*E3Ux5n3&(H0Mm;>4X`GEJgKbJViCKgf8MGD<Mo)Q
z6txVs9F<+Qw;2yY`xD&Lt=M(20^;}FPl6tIuR@JiX7#f5sF4=*V9#(m4>Wo>lNF=f
zL482s*-<|>H_qzS7V<0!4zpb*+YDQ0!|v$4J=iSd1hY`{F-hRQ)8mdb(dvBIK#z%5
z4e+LqX|P3CsB=YHx`!X!<InQQx5~}x0eAYd;mY_(dDjGg+eq1{c%<CMn2qp9$`gp$
zoeRuG$|n%lNGoUZCj&$5>u|r|9?iEBwm3YCwK)P-s-cGSlg@gCl4IRR!D`_`=yh-h
z=Ktam3ip7$=w&DcD`7Yy_dP1fK)lzUf~%l3e6Hn)R}&Y!vP{5~mYC8SQ@ru|5`sDc
z%SNJh#u{csvnx^G)=aIsGW{LbMc3fTRV7(~tJW{@2|)8WmQswd+?~bmV?DEnv$!FK
zX(GmNVV*g-()%`trO(23U^=b??QngVfUCiw7{872TNv-fI2zk_16NS>(^(D8u+GeQ
z7B5Hr1oa2hS5dd3evNt$m0&3^)UL4FtRy3_B|A{f*q+x>f5pBk#5VX~8^&Xwgk#EV
zOqq@;6S3?-EcFyig`=B*ITvB<iG9@-H4*c_gBpmXUPk>9%TB{mt+CV=)M?n0gTh&B
z2ja8G)tLVv)-V^_Fa*`mhUFQD{X8D`aT>-mFdl~S5R4_PClO0IVX51=+TVlP4)s-h
z>X?eH+J@uj$EK|QURX~h9)%@%#K+;2qODl-FBl)dIKK<ae`6@q@m-nj?a6c=j-^*I
z<zq8TIfB{`YxWIeDV?B&^*GKOP@hn?{(M5&`m>(0dH4yWKU0h{o6YJeyUNs4wi0N-
z`{)LV#pQUPNKhLv4}o)>-NU{eoKNBE<`>x79#a-ssWbYuHsSrF3Gb<mkj_?X?3tlE
z<}tx+|4dni^MIGiwrhfC9VMV={pLYgcGqSyu=^BmaG`A~yW=yeYy}vAwFRgj4!zhq
zKs61!(mGu2WMF#3<5y7j{s<FpB|v5Gi%7!QKr4H>dFB%to+8HMY#&boyC-<&8`xZt
zZx{e~7O5(mbC?TH3CO{TIi4)fEYGuQR*U(d@RZe)J#Bc)vjXp1E8vbeSURh!#+9CF
zD(@w>#x6Io)hWSydG;J;ksZO5G;Dbq>;<egRdzkfgq0gSL&kkH(D3}zo~f9p0NrAA
z7pv^)<zf||TdHg(Oa=D_Edlo#U5~w&iak@JvNeyNdL(*Yn@v_Vd5hZYwvvKcz<qJ&
zw54qd@Q!%DRj=HA5VLhcDb|0)>i0lbsT9i=$gJhNtu74wy3Ky8CgG>sR9el-t7~)C
zD!te3Hq}<|M*r4kB0f8cR0hm?+~$@QTOpUJKE2wvJ&65$&+2Gca9cLJ_HN6buq8tr
z9+3um!N+W<fIP3YJqb@~hC4J!Z2eG&PsRPz?OmLWb+DqlK~Lg-RpDM&;a;D_wmq_P
zgeQ=Xtm=X!YlAg=o*atLBJ$yinb6LFBh6r_j2#MbRqQ$kgJEy%Mfe!<!Pt@QE@Rv3
zP?K;)`Urj|vb<djdM<l?yCnI|StjRtbjxw=*MM=E%zC~I)`V@<2AQvU*!j{Rvo%kH
z%+@>&GF$V6<A{2~%gSv1^8}9|v0}$JLt*zv1~{j7wr6^%{bgL|*u(fYNcL9jp2BFw
zwq=C1bX(QNx^vp2_Rgr=Fy}3J_P88Y{`@KWj&x_QdkTxw;LJ^tpWq763(M{{ygoX_
z%NuI0mc6h}d&<U)JDlCH;xZJbc|$3-tr{saXsnkPTz`i<lyOy9TnblzSczc`8FITB
zv%Tu!CmnBil^fUy563o#Lz{nXZL(tLpvj7zgGpAbR4V8*<sgj76uA!Ssr0gzoTNKm
zj#8@h8^l8;w+^zjNg^E`;Xd1=gQIjo@&~;v4FtU^jRvigrh(p+=7QEsZ-d^I_JB4>
zA9t{ZpMZS^H8>bZM{B7C#vT}V$Jh_!#SmLdOAW_BOAIGKR~t@&t~Z<m-Dvn8^nJ`z
zhIw{jo^s4{5YrE1dIhGR!1R+?_6(N20C`-bYRq{Va=O6xN!S+aP;X*cCz+)fW!45a
znYF=PW^HIAvo?6i-$SY6m`74rPNG}}wN`3C?UkQEos?fdjmllf>56&Wln0RFt~>^9
zqdWsWf$1j|wv{u=3Fw(>h4svS%Ich`vUYAl-H&<*^*CxJD7*<kB^_Ph-j3z;uwvR4
zwF7Dw)IiiwR5PfxwAD(5Qrj?PJL+!KL#XLCteyv;))KX~gPb<DEOv$1TJnP!dJOeC
z>TT3}s83N1b}Ww#ssn0oP+5w!W37$HI2q$X=sv)dM|Mu&8thq4YR_UDh+U-appKHC
zy(GCvy)ll&xDeg>sEbgSp{_yQje5v|)o>QnQ9AG70^|0nLvyIv&yl5vqDG>|qxJ`d
zzqfN_?L5_l<vEXf3-y!>OIg#D=?2tIs9RCDp>9Xrjk*tYKk6aWBdEtwD^X9Oo<%*6
zT8(-IwFdP%>MhjUsP|AGpgux<ifS;jwoz0YR0mXNR9Dm%s2-?oQ9Gb^LG6y}hZ=|)
zirO1B64i_vkD83yA9WDwFw~K#>8RsSC!%JdPD7o6nvXgMwGeea>LS!7sLN1SqOL*R
zfVv5FE9y4X?Wns^_o41bJ%oA$^*CxJ>M7K-sOM3uQLmuZpk7D4g?bzH9_j<sN2pIx
z4X)V#s5Yn$sLrUas4Y-EP}`z*K<$Fs9n}vt5H%FFH)<rR88sd?8MQy^Ak<-~BT>^)
z$DvL{%|e}qIs-Kybq;DF>U`8is7p|np{_(-gSr8A6Y5sfZK&H(ccbn@-H&<*^$6;5
z)JoJ-sAo~nqgJC{L9Ic(j(Q9AHtIdp2dIxwpQ0L?VgIArpgN#Bqq?HDK=nXvi`oIT
z3u<>%Kh!|fP}JV2k*H?Wc+_On{-}dchoO!{O-CJvIuSJsbsFjn)O^%AsD-HWQ5T^u
zL0yKr5_Jvg2GmWcTT!>6Zb#jXx({_f>LJu4sK-$&QBR?sMLmyNjd}&O2K74XE!5kn
z_fQ|8K0<wpYG{uAk7|SJfa;9uirNCz1GOz`2h=X8-BJBe15ra!d!t68no;9XlTrJl
z4niG<IubP<bsXwM)GX9#s54OWQRko*qRvNMgt`QE8R|;ZHK-d<H=%At-G;gybvNoh
z)cvT3P>-M<N3BFXg?bkCJZd%S71SEk>!`O-Z=>EreSrE1^(m^s4f`L}2Gs%88PyfF
z1*!*XThtDyT~NED`k@A*hNAXHjYKu0#-k>q_D3CrIt+CrYC7sT)QPBBsMAnqpys2_
zK`lg`kGcqT3F<P`m8fe_H=u4p-HN&mbvx>A)P1P?Q4gUWK|PLIiFyk4Eb4jGYSb&J
zHK^B7Z=v2sy@&b$^%3e*R6`5we^eV(2UKTNSJW1$9;j_mJD_$!?T+e)8i*Q-+8Z?z
z)r=aCnvB{Xbr9+>)RCy^sN+y4qGq8^L!E(|k2(jn5OqH4BGe_Q%TQOMu0h>^x(RhF
z>NeEvsJl`3q3%aLgn9(^IBF&8Db%y5=TWOsub|eTUPrx!dK>i~>I2kAs83N1EwTSm
zZBQLhol#v;TcCQNwngoL+6A>csvl|~YA9-N)JRk_YCLK(YJb#0sKZc4qNbycL!F44
zg*pv&25LU)9MnS8`KXIfm!K{~U5UB|bpz@q)UBx7P`872l2%B^I`~L-s7<B*BYdP*
z(s0oBQa)%mX&z`#X(8%b&|cC}&}gY1G*N1o<|7T1LO@4IX3()x8t7zc3+Qyz+0rhE
zi=;zo(b78DN;Ld#>9G!DF&-=8Ez*b=w@4pK^Ikj#`p1hC4XxnbY7y#a`9taJw7H<}
zBR7KfA9)z`!N{waQY*8TdntQCixi9ri?@(1(v;E1Ko^d#1>HPap<ASbquYZXA03T4
z7PSa<3+U<5$53lg6_us5M~y}ui&})b1@!yT5mpDJxKTw`Y`e!$73=nfd!uWuS&CxA
zv<P(z>M_(>o?^>-qZZX*r@;Oyb}XemYBcIt)FRX^sK-!iQ5Ad4j~b0S7Ih2iG1OXA
z#Q}4oMx%~JEkfObdJMG|wY?+DAAuT;IvRB@>PFNpsE1LHq1K`*O>kSN(Wr%}n^2FS
z9z(4~Rh%$CYBcIt)FRX^sK-!iQ59#*j~b0yh+2et47C<jalxFZ(Wqlli%_?q9!5Qe
zT8pYQ#ZsuzsOhMMsGCrapdLf5L9Inqj93;m(%2M^X*9;^7>~uc5aS|@H(|U5<723`
zsERArgBsz=Mo~1zqcI+f@m!3HFy4sq7L1RfUd5DJ*Jy(=U22A-u^Efoqei2SMJ+<z
zf_e<K7FB7E`B9@$$D$UYZb3bUT8pZ<VSdzT)Ul{Vs9R8vp<Z=k?fJhrdlUGms`GvP
z+&j4w0)!CuB!nb@N<;!-N7*JT0|^0=sJMm6%p@5znF%u!AmRd2wN$NAs}`+Qi`LTC
zTIx!zibZR!wQjX))rz8})@r|2t)*)HKks|ax%bW_wEg|z^FH@I?^*6y-}9d3P7X8g
zDd1R))r>*L9gKSzA1$ETILQ2)%pYdnC?vV3kW*l+W(+d!VBEuaknu31r-;KdRx<{Q
zD4ihlI~eyc9%MYs=$Xi|7^@kBj5`?jFdk$)%;+iR@Ql@rLB<`7dl(Ng9%l4R;_!^s
zj6ud7jC&XlG9G61lyG>)YQ`Yr4#qu<2N@4DdP+GwV>M%taR=ib#)FK989ikjp0S#7
zLmAf+^V^u;!Tc@E?_vG`^9Pwf#Qb6A#bj=&$($x*HDi!*2jd>bgN%n6JySS5V>M%t
zaR=ib#)FK989h@uJYzLukZ}j&9>xPxDJKV+Kg9fD<~_%8T*hj~Ama|kJ&Xq#4>Nj>
z=kScxj6ud7jC&XlG9G61oWS83s~I<(!1c-eHs*IQzlZT4<6%b6G>*$y%@}0d!MKO<
zAmd?1PdSHYtY)k!r#Ugm{0_!Fj0YJHGkQ*>SfwY@*qp-ra^|a<-@ts3`Ot|x+cLk0
z@gU=2M$dFkXF8Q`3iHdEuV#J&^FijfF~5WPTbSR&{B6@I{R1pH$dW_MA7);h#C_=`
zehc$cm|xC(HS<Bn9gKSzZ##+7JjncEM$ZgRVFs6%`D(@>;||6>j0YJH&G@0X^qj-Y
zdnzdI6vpKhB(G*Z$hd>?7MAZ}{vhLFMlqAZduCD!Su-hDQ<$%23^MLu+{1W~@i3!j
z7QdHq>MV*|&3uq?2jd>bgN%n}QC%Ho-c!kO8LJtCjG;<OX9x3p7!NWYX7tSFSd7)P
zDYXrZLB`N*io1vTgN%n6J#)DA8H0>F7{4-y!!v&y^9Pwf%;=fRu^0pM3q@7if%y-L
zKb&)5KDE&yMzP>QF|182AjyVP2)8lb!uaT7iY1m)I;D)u83VpT(bRUEkKVqa>J(#9
z+cw5q7$2)5`P<cmS+#^yR}qF7OE*wz%NcLmz+pNGZ)1F$aYGm9gz*-}1B{0lMTC4y
z8J9C|VBE%di$coP0p<@WB#Ahe<1#L1+`zbv@fOD0&ZYbuVEz!J=;m0AQ@hD`IrAGB
zw=v$rc!2Q`qlj`W#^sC~7`HLr!gzr3?I@)wdMJEW5AmhUPi1~N^EJ$GV166pEsO^k
z4>3NLqPTDO5r(!9E<f)x;0DG6jE5M-R+5)8E@%A81r+`^#<wpd{;?f}Vp8Dk9iv2f
zVCpxBFTIvxEoc17wIsQP`P;6gFb9}F#P~M*it8wR)^+4t%KUQ14U7jE4>5}CIX{fc
z8Q=aErT^IPDee$_H&=K(ekU8B>wVX_Tzp%6L3hKAdyFAw*nGl#$Na)P!*h<O*JEXs
zWgX30X<cSrYdvDE^j_wD&RdtA$bKk$?U2Zj%ZJ=P<l!MhbH?Qq=bV%?Kc_k8?3_SO
zU(UrjSLNKEb7#)}oL6%u44pP~+0ekyJBR*u=s$-}9d^^Oy~FB<pEZ2z@Yjb2a$n2+
zOYRrB*&{w2@#%;!MtJfj<hAB)$V=vZC+}BzStEZta$J5({_gxCqb7`6JgQ;Tu2H`p
zb!61XqrMn5bo2?Mt47~9`sbtnG`eg|#hA0l+%RU}n8{;jj9oFdb?iA~yT@)EyLs%_
z#(rz;-D3}oeQNAq$4(o!WL)*Qt>d<j`(&Ike(3m?@!Q7l9$zw{W<uM9UrqSqgnvvJ
zSFog@wV=IVW5I<5mlix$@L|EH1)~ZJ3r{I*C_JYyRM=Ozv+#z(TM8d5e5Ej4)Kj#h
zXlKz4Mb8(#RrKeg4~jl68a;8^#03-AP3)d{(Znk!-ZSxqiH9c6E%p_kReVA5CB+Ae
zUoJjcJYmw;Cw+6$Et7sc>7hx#nzXRQSF*OGy`-z;!je5DKPq{p<ZwxSX@BW;r8ky-
zuk>K)3#FoLNLhYaPuZrjua{k4wx{ezWj`%@pzPtY$I5<P_H5bfWq&ElnVdU$>ExQp
zEt5A)zGL!FCqFRxiOEk-E}c?8W$TokQ?8ow{FD!-d_2W7b;8tXQ=6uqHudbO(W#eC
zy$(OUY2YizEU^T?{=F3I++|o}FBii_mB<w<@ExTe-$t&&S!c8OH@>g@65ml8#tp(_
z+$AjIC&Fv&6WPX3aR7cdPD1YyLyddIFylTk+_)cSq7R4>#(t4!{7j5A9>f=qKNq8n
zhs0>(VKK&dM2s~Kh;hcFV!ZJSF~K;9)6>U9q4BsVGJYv08c&E~<5yym@uVm*el1Fk
zr$m|Y8!_2<T1+v1E2bLHh~tcB#qq{-;soP)G0k{ElpDVjCmJt`>BjHHNybZJhVinf
zFkTTejX#K4#;c;zcumYUUKewWKZ?1=8)BYuNX*9_tOdqfVxe&uH?wf|Z@eQ;G5#bL
z8%M+v<IiF#zDZnW{6#D`-ov*pe-%~6`=Z+T0Cz|JCTflU6LrRiqTcwsSYdpGZ#h2}
zD~(UYD&rrb!T3}(8vhiljiaK;_?K8?d?wZ!pNn<I7oyqtw`eiG6s`CS;Z)o+Kg}?W
z(+v;48_Y7!Ff8Lt!)u&nWE*E2LyU8b9HY$`YHTou83ALs(Qf1#L1TmwGV+YDG1BNT
z@{LYol+k63HX_Ct<6L8`(QS+~qQ-cm$CzNmi~=KW6dJwQqu6LnG!jO!ku)Y5DWk;b
zGfIt3MwzkMm~3n@rr=A-sm6K6amH5Tc;kHI1mgl@nsK2~Zd_!XXlyg48{3VOjEjvK
z#tx$b-$~3gE-_{qml~DO7qgA88gq=D#$4lT#ysP4W4>{PvB0>}SZI9RSY%vfoNQce
zoMP-U78~C%mKfI<OO0<D%ZzJ{<;Hb}&$!;GGQMS08@r7f;|8PFxY4LHzHQVSHyJC8
z?-+jLW@Dvsi?PbM6<@=B*Jw2M7^{ujj3(oDV~z1Wd^viDvCjCu(QNEBT8tkUt;P>g
zt3N`m-iccMF>3WL)ap-AtNT!^KSizHjat12wR$gV^*+?<{ixLkP^<e<t3N}nK8RZV
zIcoJG)at{i)kjdP2T-ezqE>%_T0MwbeGIkwIBNBmsMRM>tG`06K8afWHEQ)K)aq|g
zt52g=e~Vgu2DSPuYV|qP>hq}87f`FeL#@7uTKzq0^(EBm%c#{?P^*7Ht-gv{eGRqx
zI%@TgsMR-6tA|jlZ=zP;LaiP~t-g&~eFwGrC)DZ@Lx>CJUbb3@MBnAWzcK$oIZ1-y
ztAN`WUtWC;_zTb74IH}YyTJ3-e-F6FM`6yb_yI8I+`E8(o=5WEGVW(QZpH(UG&esC
zjMY2_9G?4YU~1H}z~jgN9(ZEGYrv0(zXd#N)SrPP#(w}DRq!!T<o*lTHA*xIQ8?ZU
zoK!Fzcu~nHU`fdY;N>NgfG3qq1&%5?5xB5q7Vz8k^MN~Z7Xy!ERRJ&0TLGLqb~SLy
zgcjhiqBDT|iZ%ehI<W(IXkrxjNO1yam23h2tl&c6(TQIHjxYQg@YLd~fnCkl0ncpy
zHqh7nU0{Fx_kq)DehfT6b`S8alAi%jFF640DETGu<&xh3Yf7F6zE|=xaCONafuEGT
z4cu4q7vS|J{|9`y<R8G>N<IfZRbt{-A#ZIS0z7*12w>atF~Ccj3xV4!OMz#{j|a}4
zeG>3+oPI~VVdX;L{FO_AH>|7y`c|$4{$%AEU|;pAz{=dSfV*<rfkk7wfIVYkz{d+x
zz)<0Nz^vkJz-5yz1x_x!0vIU%2Jn;R-vWAk-vKVoy$v{R%nyLi7yJa6Uwj{MX5r6)
zvEp9<vrqgL@E_BD3w*2ocfd<ie*pe+<ssns6@LPLW#wOi=8V4szu){%;MOz#4g9z+
z3%{+n>Wrblt5%K#Uf>%Cd?7IrxH)$+Ffe8sa9CjlaAoma;OT`Y1FtV$4!o+c4tRHQ
z12B|a2du6+9k{6G9N>|&Lcn0nxxlI2y}-XFHvz}3JRexJ>0;o=sjmWGKI!Yg&C|XK
z{O3tG0N*<47U0Fxz6X5&q#pqrYkmrh`X2y(!~Zbw0smvbKl*<SyvYA7@OJ<2flv8g
z1Agd#3z)U?&%miGKL8Hf^fB<Mv;GA<ah1UD)qQuG7kFmwaNv(~M*(ZcOaOju%p~C7
z3Z??L7oG^LD4qrEm^2@_xNtFWYjG7Y-$%cFo1C;77|Cq`Hjg<2_(j16;Ns#A;L5@%
zaA$D>SnAsXELm|O@Wd5g0iL|&Yrs{x^xJRW$-NFZZ_KxW=Z*O;@Qs4+12-1_7&xi;
z9^jthpOK{Q0I+rOFM-WlegmAe>UrR|#=H#tdF~&9+a|pYJZ;infJW*60mHt306SLF
z-?G@~Gw~~TeJh6m*ZW2QPg^+#D7F*=&s|;$OqLuETs7$=;K<V1!1pIE1paj5QsCr?
zHNcCCRsvfJ)&Td8KNa}K=(B*Q_}YO_CcA)FHphVBcnWy?%JYEl#kT<;TzM(*?KM{b
zKUnh(;Kfzn0$xAuJHXvlw*lkjKLAFj{RH^+^80}O<v#}=IsF&FjuYv3M(>{UTj0g@
zzXP6D^9SHXCmsUcU;8KEqqTnp{yX(|;A-DLfwNBjH}HflSuIE{Lc01d)r9w)NE-MV
z#$WhIa(d-ZggI_TKCq%=9Pp{|WZ;{P6~LzDbAjC(Nr&%cEZs=*fqdPHMUdC6@G<%s
z*D|hW3@}C*H!}7!ZfD%dxQlT&<E@N)8TT>nXMB|LNyg_GUtxTc@m<Cb8ILj=t(2=A
z#(c&C#xllo#!ALTj6Oy`<66e`i~+_7<3`4Q#_fzd8Fw-6X1tYgFXKMO{fv(?KFRnT
z<137BGQP|BA>&a-<5bQ+V?JX6V;N&PV<qDvMjxY}aV_I|#sFi4aU)|t<95cKjJp_j
zGv3O$mvJBCe#S=`pJaTF@fF558Q*36knt#^aT@2JF`u!3v5c{tv668SqmR+gxR!A}
zV}LQjxRJ4+aXaHq#$AlN8E<9W%eaqmKjWi}PclBo_zL5jjPEjj$as{|z;8UG|1jn=
z7BH4EmNQl|E@JdC`We?Uu4fD|Mi@6T_A_p0+{w6$aW~_wjC&dPG45x4l<`T%=NMmM
ze3S8A#t#{fG8*{19LPUoK4Sr68DlwPCF3GSAETdfE#rE|0Aqx4BV#|~cE+8IyBK#f
z-paU_aUbJ;#zz^SWPFbC6~;Fi-(~!e@hGE#-`Yg}8S@zn7|R&T87mnVG5Q$&jB6R!
zGX@wVj2jvI8Mia;WZcELoAFl0y^Q-9_cK1q_$1?VjIS`h$@nhghm1!VjWap_jQNZO
zjAe}FjFpUw7=4WXGfk{+Jy<ah2hy!y3;YP6iB)bk_>n*ptI{0sCjd?Crwjvs2GA5|
z8oA)l0-EA%BM<yJK>W=?BOm+*pow3}7!AH1h+k|r#sYhc@xTj>0?01{nz%z;1Qcd5
z&@fAYrdbA@U`_!Rn8yJN%@cq{W;t-8IUQJR&Hzp_X97#iN?@ru2Uup#15P#<0H>IX
zfK$y=fXA6jfXAE5fG3zf;54%uSZ>w=Pc-X+(@j6{By$yThS><LFq?og&9%T;nCkKO
z%gk2bZ1XhW9CJNzu6ZVKo_RKKzS#y`U<QB-%^+}*83vwgb^=c^Bf!OGH*ksB16*px
zfy>N|z~yEV=rj9(Rpw@3wb>7>F}DJ1%?p5a=0(7Ib31T_xdZ4oF9EJJF9WVJcLE#C
z%YlvNmB7{JRlp{57jTVv4REb_EpVNAJ+Rr_4Qw%Q1h$$t0Z%n=2A*c#3OwE116*(3
z4m`uW19+yn7kC!#0HDRqJAvnzcLCeXeZURo-N1l(FR<Ob9~d<E14HJ6z_9rcu)}-=
z*l9ir>@p7mBj)44bIm7!-R6_PsQDDI$9x(XGoJy*&F6r<<_o}$=8M3D`4TW`z5+~{
zuLAqb*MXbNH-MY*Z8Uy4+&m2IH{SuCXC47=HQxoEZ@ve-z<eKgq4_u9MdpXVZRSV7
z?dB)Ii_K4gJItfNub7_!FEPIWUTS^`yv#HVQ+(C*0C$=e@M~r^@NzQ;c!fC(c%_*O
z{JNP3yvoc6UTuyB?lQ*$zhRCCUSk#jziAc$uQiK-*O?{2>&-IYx6CQP-R5z?8_W}c
zH=5<ZZ=2JBH<>el-!W$bZ#FA|x0rK)x0>^S-!&Hi_n3=-x0$B^Z#S0!zh^E3-eLNH
z-#4p)d(B$l56pVt4^2PtN9HQvon|BO$7U1oE^{sLCuTEnpV<ohsfm3aaksf1c#nA|
z@Luz5;C*Hr@P0D@e83C>_nTqh&&*EXgJuNybF&-xkl6!#*o*@oF*gDam`UKHW*_hu
z=4RkQvmf}FxfS@hc>(a3=0(6K%<aHmnLB__nwJ27ZC(a^%G?S3jd?lnY4b|pZ_TTK
z&zQS_&zjc&pEIuoK5t$Re8Joe{GE9t@I~_`;P1_wfiIc20$(=w0ADe02mZml1Nf@B
z7x<d_L*VP?oxneucLCop_W=)?cLU!v?*+bP-VZ!%?gzeYJ_vlrd<gg_^AX??^HJcR
z&4a*q&BuX%F`odwXFdu1tN9f0ee-GH2j(-tznRYg|Id5@_@VhC@bBhJz>myVfFGN$
z0zWZd2mZr+1Nf==Ch(u;Vc=2o9pJyrBS6FRu3-ohh#UN#_kdo{`@n3^-+)6r9|Chc
z9|4DYJ^>E%d<q=yISL%<`3!iu=L@881rT-R`4afD$1u@bvOK`MvMk_zS=qn`vT}f*
zW(@-#&B_ISmX!zmA}b&GW!7k*VT}cPtnon0Dgb6%MZg@Z7&y!-0p?m|z&vXTFyA^3
zINCY^IMyl$j<==*3#=KyB5NkF*s27USaX17);!=8YXR^$YZ34S>l9$QwFEfbS_Yh9
z`G7O6YG9>R3!G!s1Ls+O-~wwEaFNvrJjH4PF0s}Ems!m~pVbPiwoU`qTI+%J)|o)R
zbvAI7)dp;|0>CCK2wZE0fz4JYu+@qHPqVs#>#ZK(nN}QlwzU!1W+j0Es}C5oHUq;}
zKd{r<3XE760K2V=fIZfBVBFdP+-O|_Oj?%#`>dV7&DQ0>e(Or$R_iL@1=cR$Mb<UI
z?bfxx9oF^0ORU|%%d8uLJFT05ms>Xjue5FjUS;h8?y_zNUSr(>yw=(ayx#gDaJO|Q
z@J8z{;7!&(;LX<Ez+0_*fqSg`fwx=xfp=IB0{2=E0e@&c0=(0D6nK|)5V+5J9C)|&
z1n^$`h7dG~^%QWw^)&E7>lxrf)^or|tQUZfS}y_*S}y?~w_X80VZ91`(s~{El=TMi
zY3ohkGuC0?bJjb+7px<|7p-@JFIn#aU$Nc?zH0pq_`3BW@D1xD;G5Pbz{A$3z;~>p
zz$4aYz;~@LfbUsf0^hd`4@Riv0e)y%z>lnK;3rlN@Kb9T@Tipw{LIP&eqrSUzqCdJ
z4ewZ>$2%Tqc?*Eq-XdU*w-`9gTLR4WmI3p;Q-Jy2<A9^RCjiHK%Yoy)(}4xv8Ned%
zOklCM5?JD$11$5-15WWS03PRE1U$ie3b5R}1UTKh3^>E<1J3kT11r6?z&YM};5@G%
zxWKy#xX9ZGJjL4tT;g2|T;^>C`n;{cYVT>lTJL&bz4uI@-+MN2mA4Jp=nVjyyg}ev
zZy4C@?F6=ZBf!(V-N5zU9^jeYIPh%mMqrya2@H7qfI;tOVA$Ia?DTF0M!XjQyS*0y
zd%W9$aqkY`M(-uSr1vslpLZv4v-fgfzxPVuR_|573%t947kRG%Zuedb+~K_*c!_s6
z@G|d>z@6TkfR}r3243mC6?m0*4{(?FcHlMMJAl`E_X4l?{t&p^dnfQl?_I!~y!(JR
zd+!F`>b)1Z$9q5UcJF@R9o`3ld%X_<f9QP#c&GPK;9cH>z<u7wfp>eK0N(3;5_rG&
zDd2wZ)4&J4&v=$#rmM!u)%UV1f#1)b1N>3;Jm8PB7XW{fy$JZz>{EdEWG}(_R!dGL
z@YI|+z%z1I0nf@=06ZsW5pY9JBd|SZ34T4a10in^T?l!Dh$7?-B8HGRh+c%eK_n3J
z29ZL@SvXNUO+-XOY!x1yW~6Xlu@C106=uD8y1CoD%Y4{;*8ITqdd7N=_bl+N_T22b
z!!s;vbXG&w`mD~Z-mI&$nyhxK*SgZ$W8G)HYJFr4^B(Wr;=R#(i}xk()!DaaPZ+Xn
z$VWqroM|~v=KMWp^U$k@-Zu2^q3;j<Wa#i=V~3qH?3=@08}{z7i-%t`{NCXUa{ak$
zbFaw#N$xLmU(5}TIB&$x5jTx^aKvv$yfos-h>E;rc^~I}mN#PL@gwJtY#Mpq$RCe<
zcjVtkemQbh{*wIm{0s6g&A%%D!TjImzm)%%{EzZSjG8m5W>jL-j!}C@y*%puQ3a#d
zjlO#H4WnNlT{ULan3gfYF<Zubb<B6iygbGjJAdr5v8%^!8~dZN);RyTZ;rcd+#koy
z9=~{e&G?4#zaIa`@t=(!GU1X5-<ojmg!d=p7StE4F1VuLx`LYv_7*%}@I}Ft!m7e^
z3$H4CrtqJIrA2d#s*75Rt}5D7bYIbvMK2fqt0-$?!NlbgzdiAxiBC=ZQSp7nUltFU
zls9SGq~()ZCY>{B%cOfIJwNHlq<>EuQF4084JG%LJY4e2l9JMj(j}$g(s=35ON+{;
zl}#_ZsH|f0{K?xU@0|SbWY3hFrhIS8Yg68yGJI;q)MZnXQ}391*VOx`9+>+1eh<C_
z&Duu4U<<v34NUp(tS$6+ot=L#Oub<qxzc5&Z3ATw#z{6#co0^ncNg}{Gvm%~7$}S3
zZ!l(t+tW!h>_6jlSN?l#YAOCEPG-0t%^WCO!g15{+&YNto9AZ6eP`;!gXDQT{`N}d
zdv{?kG*gz~I!J%-niT`X_2KWmWX8Rm>)=$B_cYMyp!J|LaE^T@=q%9LpmRWNpba8V
z1jI<u4hrHs%#au>!k`XNCt9Hk6ak$J>IOwYJ)oEvFXEtH{95ovPy)XxoWx!96sQlh
z3A7os1=KGlit|8QMX@*^bb**JE(BeK6ZdVP?VyW6JH*N2E4Z<K3FuPLWuUK$#bPJu
zYoN<<I)4S|N}SMt9VhfxfvyJa0(}Fz<r?7=-xO8iT2Uje16?ob#J5B}^i(}GP`$Vj
zC;8t7-30m$=w{F@pj$!T1?>Ud2D%;eJ<uJX?}PS&egOI*=trPCK|coFg<AnX0qq0*
z6m&P}9?-p@`#|@D9sunJ{S5RV=;xq^Ko5f+0UZE63i<`;Am}mB<Dg%Ho&fy{^d#ul
zpr=5;0X+@+E$A80v!Lfd&x2k7{SNdZ==Y$PKre${0sR5=D(E%P>!3e^-T)l}y$N~?
zbQttD=pE3XKu17-2E7aV3+O%2UqSDK@C$R|Z=nAJeF*wH2xtGeA>kLFfc^pc6!cHf
zQP96YpMgFHeF6G6=u40={J2Ts7beI9$^uy+FDM%{1e60B3K|9)4$1|M0Of&3g7QJ5
zK%+rpKx0AUK;uCZKn0*eP!VV%s2DT}R01jmm4POMrhuk`jsqPJIsr5dR1P{3G#zvj
zXa=YPG!rxnR0*05ngf~(ng^N>S^!!IS_C>7bP8xOXbEU3Xc=fZ$OozdRfB3k`28MH
z2dW3H0Qo^HL90LwphnPYP!nhkXf0?Rs2S7(Y6YDNIt_F>Xg%l*(3zmKKxc!_0kwfP
zfC8X)P!JRXg+U#lPEZ#p0y-De4T^$#Krv7p)C<}ON`R7}6sQlh3A7os1=J5Z5406@
zKIj6_g`kT-+d$hv7lU?yz5==gbSdaE&{sh_L0<!14!Qz#CFtv*t3X$Sc7eWOtQ6OP
zzG<uy*MhDCU2int7X}){ZqN<JI&q`Xg5Mfw5jTOp1G*V>3+PtRcMTk9U<Mm1J}be6
z6g-cXkb5}0=}B(va>7kI_c--Df&Fos#r{H+D|fkaPgm~g$~{B5XDIhf<({eBmC9YI
z+_T}P_svoAIZD1t$s5)4d+K>eJ>OE#&-sb{MT5$PvvXq({z~!$^h@bp$Znj2s^=0@
zzHb?x6n>fM>!tTsD|wmcD9g({GTaon$$yq|&*o>A*s7ivDEWT%d{8}K!IRQ|#Y6cK
z;#K8-Rk>eR&o|WbP38ZlavxUi!|a|Q-cjy%l>3NsA5rdimHS=geowjIV>eD#mHU0=
z{+oJ!sGc7w|BsaW6ZQPmvv>jJ|EPL?rk=T3R6kiFkDoZHR?jKwd6`$%-!8AL&t1xW
zje0((o-e59i|YB3dcLBbuX-<=MD_TpcYG=3<8|eJUAaF~;l99=!hPYD?di#u^=@TL
zIeyTW`$e{LXDk04CC^jxJS8uIo8DKcp7Yexr=InA&Vn|X209)z8?+MpT`RH2)FARa
zMaD&*a^q>wbmNF;255<KMV8OFE32BHS7c4cvmWFJtpYWI%8fHDpV4h?MEGaD-PYsA
zBJZ=_?cQ?Z2i_ybBi^gMfgwkXJkQnM`-b?8&xaf|^E^k4)}hmluMI6X9vOPX_|?#7
zy`K-s_8jr#fS&apK_1>7R^oXC>(^F<xnlS#@Qt9go|lKWdOjaA9qDA_xr)>Kd`P+R
zOzw2N>r(F{cyG^$=|*bA`<~lJWP4I0Rv}!uu`q9y$Den^@aG+u<<FZAnvwMgR>NN%
zIo<f`$a3Q$Jf9r7%0uP(7u-4d(~Xh&hzE*+-<-e7vl;v^^WW#^mv~a%&L4$1qfjq+
z-aYELth>Q47(E?z_Al>}(Vu%mxB=CT9fUWq%bVwU-b-=fW3oLLk6Go(^Q`s!dCYX<
zlQHGS=&>WRM&cbK^Dp&Yk#(*0r?Iz!W@XP9myP$V0{zfRj9caT&bWK67su_l{ygpl
z>x!&WPjdWZ&w1msk?)O2zudTbLaFBt&?6ICAv=Qh$;Nx8qrM-&^Jk!Ey+jWbOh>-T
zjl%^fYvC$Sw{@>Ir|^8wlF{cOuT9=J%=0{-f>6hvAw_3<hZMDe%8ezUM$kD$4{%s2
zFVUwcAI0fLU$}de5AJd!cVf9Qd16*}$jHhLPkasGz2HZHKJeT%aY*)((H}rIB>S$3
zGqOG(@(=L!sJm65deq-4P`NQ{(nr~ld1j2OH)f1m1-jI`V$!AF1*0$Z-j#K!cLwSs
zKB>`zIv+B-<Wls%OTE<QOGZD7`VS0QGP)N0@4z21mW(#>E)(yamHp(%ji{Svk<PP7
zXBGO%vxxVscl4CwvQi^Ppnn)Sk9gllpY!CjqJOpyg*`C!Qtz!(i^T25Bv=Pi@jMB$
z?hMdExK9Qx1}z2E!w(iKX29Ex0Nf!EjZ4wi)|?8YB0*mw5$N~FBB_@C-f(l|yzr9Q
zv&7=1i`v>MXSIRr45!-G1X97S#&D`D9$MP2Jy__AMjc6YJhmyENVUZ4!?AE85cS8B
zsYG8e6^X}^PN=29wzir`vNsy&uZ{+iN%<Oj;cR|kOT0Oih{QT6hLmK+P*TL0!!hc^
zDVe#|fu1nGNy^uS10m^A6%X}OdQzU5-ds*4Q#wyd@fK!Q#v?IGf*mOKia??#9_#ld
zI{SLUu@t{{&~#Yn@9B*vQq_TIv^kOrFYRn=b28T)>5K(ZeTne-GCoy(B~?Aj)shIr
zlD&~=I6-mO1QIA=Dx8qj$$>JnEu&^i=gP21dY+v$+MCmn5^iyNYfU&AOhkIA)wt0}
zmYJNLTIFn&(W<^^x2$WKH<mZVJ5f^&@n9f&Y9J8_v`6I|Wvl^-a-2-*Y$>J2*6*r|
zgrgy+tp|-Z*N!%iIbSf<7s#kU>67_FCB+M6#Awu)Oon^fqY;_;L0@OTt#S@k$ht5!
zckPy7*r`YMsEa3h0x8{TxPDolnF*N;4+{22SE%Wa1$rVuS;@_P9UYM^6o2-h@duYK
zl3}SXDVKG9(P&0%v%DghiYF*-cHz}4<L%t4GJ3}Nl|rhnxs+&iA{<DC{S8tFsD#{J
zsGDdY7^XqP`R7=f<(Cnt{Bzj9wkN`)#~uNkJ@!KW)+FM+P(1xkpCF%3Xs(7(u+1;u
zfV7yA8Kn4jbVt2$F<DOP&~f1<u6(D-IbdBP-lMt+D;oQiv**eF5C}CPi-8y`P$`rd
zNo!WF5RSn`XKqa*jHdQ=bcBPcWK$y28Hoj0>CUkOGJ`B?U)e_}G3~?3nsVwEQl`^n
zRAV*a_P$QMgY_>*uL$b?z)p;4yKY!Ov6?nR<8!sJD6=`G5G_zSpQ=OYP9Db`NsE)d
zSU+b~=?M;<nV1ZmDV;6DQjcLSbMleW%vgg<=h|s8V~+>r($yhDWef*9YUKhR4p7_G
z(RdQ-ovL06GjlPxbT%iz9f3J_iTts3fmkOeIY$P|$j0E(xptDwpvzDnaJtK&N$H@n
zVbqK&n{6Q#aX@JXmChMdI#){3YRn)*?oyr>Np&@KbR@%adL1+cJAukYlo?-0nkek3
z2?wKrL^yr!VV?ncmQv(nHgk59OJ{8ilYAloZPpmy6kZ+PB2^a$btZCcWym<(a2x{G
zPAU=$rWyk6;V4(!9QnG;HXBqrcTnj9DMf~v$*4H$YAoj=MlMv1)68%n0=H+Hur88F
zDpSgilaRekM$rmJPhg~QRY=kaRjh%PU|qNeb)|h>Mjd5^G;Ufr&Ww^MJJQt?Y>(dl
zmbh|I=OshHAM0?5WO-b&Q=yk&%D5!WUGctX2pz?qpIx3*FKRYPmpYc1dcQvgm8W>F
zIJclN5R3HoMXATwc~{o3E#XKgt2B~ru^;vwW>7~tqQ2@#=fgJlH&n+%Qa9>av|TEm
z%DpmH5K0Y#fmRs&PziE+u~Q*QJek6b;}+@nOBIiZs3w(e$W;RF+wiT9_w-`iaho=v
z^J_U`tqUjnqC9#K4#|dG)2gbeW|&TjZ47jWYr^5)>Ub|ttB9jp$6fOoGT8@I!il9J
z>iwN;3`FBW#W$xMz9AGybkYcEjrCH;#0*Cky1%BnD;(@TUq?n}+x(TBQZvT0?V#@3
z*0iZZdp3l^(QuD;HK*Jz4yzJTwn?K*vLQrCwn~Scq;jhy-M--UDh(VJFJnAoT?G$H
z>A$SWD4`5ZB;%3><3vy)gD-awb?}u9^?*bec5|rJA4|=djin93qW#_L1k`a|AQEkg
z$xd-TmIag-ycIS$xMSGt6ec6TGJK{KMzl%~<}f(ji(R8gdLUnEW>}hat&)K43@)=n
zN-1R-7AyRvO_$N9rB`O|SSq_E+o<Y2u4Jf-vlIDqH7<`Pmh*e((R*nUN;fc7a_p<)
zJH{S-Axt*_A*1YM7=TLZHt<x^u${nVs1PZnjIr;rbuD{SI2b=jhL*SKb`rfMqnTw;
zio|hL37jd6rCNQkgTlh{konZ@FSVEyQ-DR}kHlOP4%acuIg5^6;hsiiELY1=gF)CB
zR+A?9^l1?SIW2M|72KtDWPH8VAk$Bq<fJHll7lQ`l9QpdR@Cztq_$ZDp66hx<l$No
z$h5s>)4JyZnXEGr4zeZT(z9AqlAhHnj`S>2$!u5bdu&i*o2gs?QC(jwh{tLyRB7`7
ztY4X8%GHzzg%jaWnh+U;%1cscOm3k_5VI-xwSD0}dUAcP3wMC!Q4@>yH}?i&aMo^N
zods(F4k#bV=s?x+XcS8@DWt9vh@~RfL5s&$U|EM98btEfZp1D_B-O8GK$5LY#$!qg
zt1z}P3199Aw7v$9Ht1>&rzjnoHSuh(6g_R|nX<uYxXO1?Wi4oH+nfmWR*LH8sf(8`
zY->YB2ck(?)pAy+U_DT>WIaUtD}~g>Tx{0Lq9rb$-1(uVRrB%WCLL;~lMZ`Y^6QXt
zZqq^CE)Hvl<GC#(k=C?Cl#8Q*KgNs(kN-B|==lagdF;+^1BU{-XC4}7ET<5d17wI}
z&jC88tf*DOb19a4GeODck-T%DB2`kiB2_WwQ;h$lDOEVAKX3yzrSis-4_u}JC#A9Q
z<}~d#55<=CgNLI);mFWWkfiG;2vC`6N(rJ21tbGyDj-O01q5EJWA}7CU_L>(!OQ>>
zheA39sn8)CeELP@Dw7gHczVOeWG9SwScbY~NlQsyT83Iq8f&)HL$d`orm>xEE0Eb*
zNz4|g5}55;5g=rSdsVpq)IhWkCUGROVYaA=up$X0`r&AwJ@_D(S&$<c86Vj1@lu*z
zYQh~&2`Dt!Saa+?4-Vb~`@9MP;{)8_)kR*NY%X(mS25;M1QKW12TJPh)(~O5hqo+6
zFH^Dc$mm#*q<1U`GI|jt#~u~%)XneeK#&d?0E71+N?i2{U0mt|l9zoz%c&2{k$qr}
zZt^*z9VuufEJMnsn!{>#{#>nQ!Lgdfb8g*yUrkN*qWSX{)y%J}S~RP!cG29b`STYp
z^etFaH``ZP=UZ4aXMSz<+&Og%>*mx})-0-;KX3NJ>bY|l`sOU0>uMIarj~N0siniw
z)H;&X%{r*tB{j7U7i?RnSyI}{ArrTKIJ)iSc5z~MI9B^IIXg$KI(d$!T<i;ekX}yn
zFLiVGF$n@H-41They&2GpMyJAKi4_oey(ERk=`#M$mo}l9J^n_bC7;HS9YJdqFugI
zc9psKY<`|y6mWwUWuB|q+f;BoGBO3pu`>nFK{5sDpfw|3D6=?^dvoP{-J8L2Z^lzM
z0k}c)twP`c2V6#OSxDMMErJo^*twt26(IAY62<Jj;25u6;I1y|kWpP83*Ey<I@Iuy
z4!g7Zbx1j2bWpd8!`k66d~_5ZK01cWp%(KhoZ25yE>6tN)4oEhOhk?mojUi~g=j&&
zz;EhHq)qXd+~B=*5$5-Js4p5`N_!`fO>{WZ(~AuXoWHR3S`$uT5uRKsdN^2ptG`C9
z!Om3&j;g?R$#YI{b)u%Ws<qx-b<C@pW1jQKdm$>AtSJ@F<=}w0vL-MU`x`{lI)A-?
zwXdPAv9@JJQ%&0%-#TBT@UL!e@vW||RnF%AWGdWK;cpTUx74<s>RTt)wXSZnBa@)^
z^y=C*E&is}(z~{~wV{Ps-@5wdHs88+zV+;Mb-remS2Cd6v;#`tanQ^lJ><+F`Kr#a
zl2%1+F3|xa+;PET(2j;M)+O%r?IdY}aguC}X$Mku95J_}Gv)G$x*g$-I(9-c2&_^^
z$Y%UWA1b@uQmu}&Rh;V7d7Zzu0S&RPw$6XL;Pz<qudb;*U5oV5TAOGHQT@zngMFkJ
zwWCH})bah5<fl3N%_O!r%P55GACSu4!QR}@8=0j9TD30^3>I@NTTYD18grB*FfwZ_
zq1px`l>$pRXS3}*f^+f+ht4C1ka^TW{Orvc(<06oi)F^Nyp?5K9OfuvU}VNvLKy=i
zGsY4QJ%@5Yp~1+|ETPa~WN4OfXoThB%(aUH&M6KYx;Pv{7DorcQ7OF11fVCSL!6%c
z?Wj`7QHkZ$ohYqZ#5KVw$(qn|3ZR+@oGgGNnx{ozRH*q{1V)J#Xb~6|Eu<%x9Gq6>
z?vir=SzHcbv$C_XH)(I34sojFER)4$q0P#YLuOZSt9B5h^2!`%O{eI0#Q?8cguG?8
zlt24%vo=#GbOPuk;?VetqmBWQ>=<BJDd9mH2@kD~h?Tks(WN3%>B!jBn^bI4IWhso
zDa`|!Qaj`;bq+XEICwzY$N(G{dd5}6R>kAFiB>^vc41JIj%X-A?xbe8Y!FaQz^A#d
zT?NO3wm7K7s=NZmew%2e!;#Kd7%bWW$0>mbJ2-8fG)19T(32lN^lqW{OeyDK04hzK
z8pq^^8#iq*c{&2I{uFFaDxcKrqPn{yg4<Fo;tEyOi460233t#NY*sZbk|MF}IK<0d
zpI|W#cH-oXg3^%TLNU|W7nPFL;Z7<CH4;*hkIfMrRiMPEkO+Ck+s}oommke3e$cfp
zW>$wc^Rp@u4s=tf_9!0Y&5SH4ng*$N0VvHj(E_u8s+$szVF#{FP<~J=JtX0x=ps4&
zA37bq#&JU(r@5gp)7;RCX>MqsG&gibn%loH-Hl<E?(aC)IV@`;c2YZ21Zrx2%Fb<9
zKFO$4aSZUf2}n*Qr)P6lLZ!unKvc_Np$CPimV*PU{7oFLA(V=DhY=AYSUx&Z?AjDb
zq?ldV)7vIi#{p{yYWe^)utYTh#+GOT)y6^{ktp^VWERBfad2qbKmtz;pcEd}fn*AY
z-pM3oH-)&!8)uMn$63RRNQRcB_oKLp&M3AU(I1i#j2^rm`4%l*iTGwtL^4(JEi}^F
z>A@M{Jw*x-2*t67sy%Uo1GUzTo{h27=CZ65OQT$|JmM8kgB}@>noY@A0SFwnCjw$M
z#^fe!b)@2biJCwvAVLh`C|Gqi)evdNu!;w9?4);9X<r7LtKwV`89f+cFo}csOTuhP
zI$OHQ3cjxt35v#eEM75~M=~5p1iNs7OWvF0^!!QXz;19V%*TbaWi2`gq=gA>#pR+W
zOOy(e`5}V|-mJYvDzT|K5fn)fh4hC6Za&b1T-AMv1Wa}uEC)KnA+!$a9bSu<M%&s*
zAw>dFTS(!h(XW?XA;Foe4&baU5P}{BP$+bD5dhKsDzvb_V|6$j3QIRPwk=77H_@g#
z*DL~X29wR<Kokz7(AE@_+laLD4ecpI*qT}N#n2~NNz2kWdRis5CW7;HBt=)!_|^vH
zva<^J+-QSe1;QR$BqY10zr!Dc#)4C3MZ5gTQ{xa~Sk(97NhReCJE4=6u6lXg6Nm-n
zNjo%IJfT<|N5-R@lw+|!w6wdettt@g#-%73d9l6+!S^2q_~PAzd-#*9!>MY#XI&r8
z4sdm1KvWJ<N4GpT#}nQEAsBVjV|ruc_a$PqX)^E)JYU2*$zVZu!s*4pAUKC;>53!=
zdf<R08VTa6@Swi9H!v`YePM49KR<60X4V0<SW?zAw~6Ap=`qM$d$2URWxx))2*MqK
z=X}MHeqmP5{EF2=%>SY<8HO$sEs01EJ*g)ti-7f-=Hv3}p78bdh7pWL<tohZ&=s_>
zW|pGL0U+d_O4?z9k|Do?iLqInE~ZmvrH@pal)OKgE<<V<zAAv!jC$}XVQVk6WO!XT
zsK%rnRt_-bOm&5A57;)^K`KG_^Qu5ni`C#zF(_ZG5|o>&#_dKP-OgU;rX@9=PF_WZ
zgpW=`&ZRVNV*84k=x|tcemmDRDL83xGIUp+BBO4VkD4V~Fw@vFxu>oIxNbiQ+<!@r
zrd(}3d<$Oi;VHTdrUOjBA?)|7$$?!wcS3W<p{`-1=|Jot^DU(%$O)PiCstvYm%%VP
z9p8=Rj>wl;dr7KhtC~olGluinNHAG}RD#_&=!CEAZt_49PMX3=tI-jJ>c8mezR)H|
z7{nbSmkd#HL!>H!09`II;!~pP0)M)P%OzvG1f+IwtB2G!WkXh+<JOn)97#)@qBw4}
zTDqVSx39x=!l9D1b&4aB4e7XLRfjkBaUPO3gN}kcsW;GFDp;yL?X+B=!&er-)8@MZ
zNvTWOho;UZ+(kmH_HYN(_-bMU9cVq~s5P5<gCva0M~wKoM3`R*4b~TK4s?XMd0~k1
zvk~S>06e~2;3tMOU+qL+p!;)f-qjrFGtvjSm5gi$$@3@@b<w_Lm%lm?><WvZyn-qn
zn6A}Hm2~@pWHU(~eHt?<%vIQ*xCN|uDj6(hsyKg$ri~81%&+Iv2C`{%!(!b)BP^LN
zM9g$SqA#Y0za0~SYGW`;<1yNuw8fj$w*&S)0O2P^hmRrJktf%U0O3nIHvvRgp0jfp
z`rss<<nW|iPfJ8nwxf1SIM^qh35;%-y_m_85sF7GUK8&lwk56@HS6-kBdbxhBdHuE
zP+?@>PnS{GRuUAKT+XpRzpoi)2ER`+b+D%R4SHcJU&m7q8h|vmo;{>YDg-$<sZCvu
zLJEcFE@sd~ZTiOgTDr7=Ig~%DfbLVDR|v`-MmC3+ijUb8#LTF@VP6U#?6mi#q%e@?
zqSxql<~TG%qzU5cN;~^faQZC4eh)11c#K`hjN?Gnu@Fz47?v@8)NSl^lo=+AEKM>I
zQ%@?Hyse5p!(Vss)l~r_l|J>5j$YSi1%e9A@0X1lqsnA0%+?x>44ct8k|C*iIba8w
zbrf(=ITkhH7TAPZ+p8|bE$8MlZAcC<sM)A|T$ZAsejjc?kI`yRMA?BlW=$QSRTb5Z
zNcOe!(`AaVyAus$8zL-0fuxSas)S-v2q<E@E2AU`u{w+em*dZaheK<#&XG`jHF0qW
zSzFBZ@Z`%Z?LTy)%19^D%*H|)l@zq?)JlW}{$x{!zDvXcIehHEWahAgI;riD<B8?U
zv{Ub95enCokn(1Xhj0jOjh56kf#nFPeI3+sC_9Qh$OMqZXzE}A)p}JwYSB(du3n%T
zSQ6qTl6D~rtuUn%(S9wVil`>jgF`FJXPs*W$8z_Qjs-}Ftu=QnM}T`&DnZ#Kq*HB?
zY??HYtQ5M#&*|B>t*fx+?PgKC%~6JVe$e@F3_&fSal|}@ZJ`YncG2}J#}$#n#Y^Y3
zwb4ZEnlkOU&gzI&gUbo^uhvbX3iiD;Ohm68QyL=d>|vXP*>$ikB4~JMTvDP57B=yR
zUx8?vkaAv2%Pu(q$dJJ}4&pEhRXqBT#(tq~>9B-)#TtBu2z!IwwADZ>IJXQ<$bJdF
zXU!}`weq}=omx+_gOcPgK-oq4)0cKw(3aBu7=2Ogh3f4V>|kOF4vW*eV3xrkPIPm_
zR<UKI11Xm@moUB2XK{4r7oWrM4wSm`sqGVNNs>ackNOdVm*S3q_7M1EN!BxJQ=}SK
z%4LeZ{FMEZ2C&{MsG~zUj-oblwVL%imO+JN5hsC<kg(SQM&2aE&WvKz7{XOS^=Tis
zB!*peG=RmV=+zevm07OL-x{Sc^x9B6*-W)PWAWIj*pb6zY>Tk{2zwuUdbUIjX4~!S
z>`bsG#LR-O1Kp$R-ldL2Z3sKTi7MDOYy`26!roD3TO0HaqEK>p&|HBYThWRQ@MHyS
zNBO;~N;#gWXo+i?NWYIHn?vo5%Xx<C9`+Nx3!fQls{mU~?cosim>h{(wI*}{Twb(?
z;{<G_yX?yLBrWgwkQVUAg3&&=(DrU6%i4CKu=I%=*?*2qPYaGDqskl)WcSnv+lP)!
z8xbv$lsi@VO@`bu3^&3ON9T4Tai+1POSoiB?db4m3MZ5_r|mr<$3qqax6UG{&X^;w
z-I5B&=$jWuq_ao1q}mc3=t=j4>FZR)gf%Zen{h%l!$^kp(7z^}=!w8Q9xQomDs@CU
z`_Kso^>%%0>ZHqyU%W7>>a->9_+feuU;s$9>xk2C)H-6>jriT`!qLDM=8}%Tt^{bf
z5U%kJ^q{XyV2pOTyr4U^zI4K~R%Wf~$aLboFu`Zxc6V3f)e$ITjsvD5?Gd^z?Dz)k
zh|N{~7?HFBVTN=wTMs;GNv<c*83{@j86}M!k}kIMuu}%bBn3QCOE#jGw01mMz0~?r
zq)Zkb(O3yfA#@^MA$jZ!*pXEeN%tl)b(EH+voU7*w2?WvhtI4(iMuG+V8Wih*711K
zf|tGNcL>;0mb=~B$<Jn}04!G!0R744_4OuE6Zdxr3fR;k8lX6NlMy`CpM69pU!qUx
zlpj=J4_U6tGtKEwvN^_H_R$?$BC1035uS`FPw|+?TAmJ)m{$i$%;Pvu&p%Q}qMg{o
zzFSGVH;yAD$AQ0trcNCe)djPGTr~G$M`<-KbHkS;YR5=*wF)(u$;aMnY7F%DlEBqf
zbW6yNgB7o0(C~_*%8Y3T4pWlc#RMj<+AaK%W2dn5irp_;NO}jm`CLXm;?YMvbiGK5
zF-?Hu0~I{&Sq_>SNfM%jwa}m_fwNtOYNCBNoDTKC{vu-(3!4x$EpZvUaCEH4#;i`<
zZ4V231j-=xFqBT&H6>4XY9&V}7759!{7Q$qKggwR=3`niDX12u1I^LD0(yoHJK~#Z
z+mSWOnm{s1+Yf#4A?<(#HEl%EUSpS_^(Ip9647`kKapHrJPNCyU1WaC+6~7#6|0QQ
z1}VYGBYCvOpqj}hr$f9XGgR{_$zpS#Q{h7bJ`|E%Z$#j*P&FS;l4T$|Yi5p*o0+2{
zWi7?}TeE!boY^3Bq=MCVe=JBZX(v}uGqq&ow)S==0--QX)T9QnKIn$w6-f;y&)C!A
zusAG5ucJtmnq2$pG#nT2bMaz{?N_Q7+q#ny4smQ5IyaJc1+Ak=%k7rmUq}hI6kEbc
z^&KQm>0)vEaHAUo!7ax*krcPHXLC5*t?C>H_I6DZua31)&Oj8MgAn>4*@Y+dF)S6j
z0<qOJu}5(jwmHo$HCe__3y|K`I~W2d$&N$s)L@kA<qecX1GW_KV=ppOn8n$ERW7Wp
zFek7>E+EJyPf_?|Xyl&uuOu(mi;^dmCb=kmG_4hy`&_oE{akD@z*=>C<7ZZ4&`?r}
zB^>w$EPG`ZaJNAn?}mesXhn5IIvs<TBq6>I=?bUS1&?iCG>ReAOZtV_PBasBUalwB
zI_y%Fz&y4y$)aao|B402)7LA+ETuduLMlah-GT$vK|#Q(N+se^R&sQ86L$oXm^oqa
zl0(hj#9|GSOtO&jg$aj~pk)x$cR0{PVdIH@<={fF;t{>{yD}UYijJT1eh0Ji)(W#Q
zXM5QEU<Ue>pJ@Lc-9Y}P3exp*{^2-el_)3g>R{6CRBqC4zGx@9RjR9px*aUDE!c%@
z?uzu_6DWJt!EVw3Y7i&T*}I#g2t)^W=#4PGXjuq7L7N0>&y!jDT%X5X(spvUlFoDc
zdU_?t8wMQ|8B4ubk_=(ay}k%5{PKWJ&8V4TY1!CPs(wFjMROu_*2))3_;O6Ti0{Xw
zi};F6x`=Pdq>K2XOuC5g%A||<x=gx=Z_K2N{J5s#Na)^-<I-1WSR!xFNR}_qNS5!=
zFstt{sT7m}q!V;5({NyPHti#?)X3EMHVw1#VvUsYof;{1Sb4)n+AvjdESv%{>PMQz
zeUeBD3o@wm2z+Qm2(uw4f-M5M*-0BoIDDbad)`K3Uv*<g@t8UVt|yS<s)>`)C9@$f
zWGD%i(RfJ=21&SEYEMC*apIjZIp=bmre<Y|u}ky3qvNc(M1X&*Nc&>hMHfG`vmwya
z9tt?0Dq>Jm-buf>gkk$rMp*{T3#2h{nFa@pG0EeH1TYvS@7gC*Cnz$w`c#pkYMWAS
z?LtyP>a4;Zr>-#d(Re$V=rU~`QQmo|(Dr+pXA5rmRM5IE!<&^ZEltv6#o{o2`f#kt
z`(L7m^|9pjI#qe0E?pVJB&5FK6ue?_<`Yp5!;20Wv_HPsa=Aj-;FBr&8(ek8mFsqs
zPIL}UsV|Z}>K0Kabi1W#>6S#GIYLdi-U91d{(72-xPMEHQgwS`so-{!w!wL>TNH66
zg${|mAgUA6Qat}kC-1<!-1<<7yO&F@chp@X%%Hdj;SwN+ti2;aQvc~5G#|MnJOj~h
znz>{+s&lePJsWcd7mF{f@C-Ci>WqW*(7^%monAn>qx&YdaYuLKXa?oaBk*0Z-sU5D
zb6+oQU%I7@v=gFk1vz1rRA$H#(-sq6Ef29BvEE;3>Pt0s@cFIF4`<Vzeeu2|+ZHal
zKI=k~E@>}a&*5?92-UqPHTTj&P3>GtbKK4=9kDxp)HnF|OdJufb{r>`V;FXhTNlHT
z$lYGIn^rfQ9f7iY96{L5TgFe5*&CBs7xg&0$krM-iKD#^-cw0Lphl$D3*mC5;>Zjm
zS52JPR)IvgB@ShsS_u;XoMR^_hqMylU>gBX+8n|IJ(~v#=_Gkl${fV9xwT7`%_Z#N
zfyDl7tm|>a619WPyu7tzYd(6V<FG4BAGL54H90V!rYTv1^)m06aL<ro2K@;fZA((o
z>|x2_G5Dl1iYM63hZxMkxQ;>BAV!z^P>A>%R+q3f*@p_?`b`~dlE?Yy+Sn797ZCwl
z5u5~WLXystXEO5gAFq)_bG%1g{gQ5^DT7L9`s#^RRa9*{G0b`L2j^tqWLKnvw)M^k
z<9GDg@=L|>vjAHhy})-Ne0>lj75A2jXzq^ma+kuDU1@hv4`K=K@A4B@c)5t|z*Szo
zfT$+(1Wul5*b`TL`H5S;dU|b$#H6e$!Cp-Xk?QG{YaR3$a^RjOag<yF2PcFZ`{H!{
z6r5f2&2%~wz@|To<x+@Qe^TFsluHLHVur-N<3&mV#t}bw#k{(Yd7L*(2KE63k=<O~
zUP_48RL4S^%%#n)eCgM*lmLfo`1Dyh5^UHDzf=2Az@%pr=ro%mF#1{H{|9gR_Nu-J
zZHHhe(`2Mwq~SG>?f@mBT|5Z2!|v`{;Og;Oq_=prySW$3$Us!?!f+nx&=5ID8-Yqj
zd$_Vc%X>MB$C;7tq;&MCq*xdYB1JnXf9Ng6we$U0EP<$#;*)kPsIgautv2GZRb-2Z
zvA4#+%Q|DdLOy5&x+n<4L0|Drh>kE;x$unRf?&c?2&i8^=2S^QFXGITb{@L%kjcth
zLkUsG`>%AHNbN<XT~<r~^$g{OLZao<gQK`E8A51pSX(%vQ$LW(#dA5y&~iDYo#hfB
z9hVCxhuf*tw<|!(c@bh_vQDCFk`;ndJ3s#=;&gtC{bzMbxgs2es<XeRR8FTaD}h{G
zDu>knr{T9fI4aq;^rbqwZkh~nup1o4?{D#sZQ&(}2rZ@U-yXqEDGVp)Fcp0qGlAN2
zu{*rI%jZbwdavX1Co@b~mmg}v6;R$nr>*xsmpFyg+Ine+fvh~|px8(E=Cp2<4!%l9
z-y`rv9xVGg2sU`=r~rX6D6oyeipWti%1O3>VmH$*7pXpBNn;m~T(z_Zi0!J3Lvzx8
znW7+;78ICAN7`W%t_8rLXZsrdL7U@{)JTvvHag9#H5pbYxc?%v)S3)S{U<Fb5<?4Q
zirQI4Izi+JWzz#Wrbt?6>#6k^VmWxYl_^#jHAzn@mex~nVkGGkl!Q8naolP!I0Ee1
z@d=D95Z3P4L5d{!u02i&<P}L|9qom)%`{0T>`HvL!uw^li3B)*0}4R*55dbqI&Q93
z$0@yem&*}ym<(C3oucb^`0R^<$dsOKofV$_0Z4`GKB4}hQhZs0PeRhxZA<aN2ret4
zqw*yCzb2^G!g4<UAJTATCgX*&GVIki)gJ9?x&^7Y+lBnPodXZ|VQ=sS0whI?XM8CR
zj(@NPNWXcC_Jj!;bWM$RCrp>2f8eg1Z8ECu6<m{Y$*3ogYH>m#gKlT$&m+=sOR{x{
zoWR1P3k_@{;hX_qKndC>5v`a9*QC%NLG%XxDvIw!Cj_18*b51@ktY?e{tVEcBy~W)
z#w6<kH?4KUx-MUH!aNc=xE_Z}5>j8UC}$*w$rI{GeuR>gyQlJ^f(qfsaKz;6B&axh
z)ZsQ}l9wOKgN$cvHX&;~4>fgE(N+lO#YevpPP4ZDl~yXxK#9(>oUN1C^A6JQq}q|}
zOzQxS3CxQaeiy4dd7`F+>6dADFXcr$;OY7~8p@dV(UWb!xtX7Y^2I(dG^!31=-U!O
zCi}I!N99DWjAJ1>O`^;9R4sHS=(srqA96Xej6ErPRRxu}DFSVzn_Zuvas|YDkL68s
zFy`Wf?Qbh?TY{r7>>y!kkn8^>j0UMh)vwpc?v39Rqx}e8%VK{{w4<eid@ntTPD(l`
zNvDRi=8%pkLSr=`9Z3uc`n6l>vd@oUu^}1`M%vn8g|^AN=}D2=9A`n&mcZ`E7^Dm1
zNqrV9KMR1HPJ*~5!Q(^;Uoy(JhqKo?xRiY@iD^BF4*|6c8wH#u_Xk7>h3PvQT+PR?
zlu}2qYbB&?Y?7ldyIct6a^Zz^O;<(N-5HYttt&~Yd$dbrcWReRjXjqH?{T?0p+Zof
z@|WwivU3Dsb?EI#C_>umKB;46NMWL*fEhv<(at^kB)*l_Z$_@DTksu2EN+sx2~X>;
z=2Sm9;LECkPQlqF$B1<5Lp$3}vqPzJ%3n?A17?{NS!$#Jamx~mCzd(ace&qUkCU!i
z(PAnfZ_IM9<mQ%fP&Uc1;U`(S+>|^zzmo`WG)Z|}U7NIX>q>>pN9ja?B?FDYrlNF3
zVmLEb9!gtC7cN6`dF)}%3kVuyd}~j7+BX2Cl6E<{a$Rm&y)FU0#pUFBprdt{41?C?
zk}1$eqf3ZVRrg^C_qb%3^W^1Fm&~pkmke>W+3b=A^kpJait5%(OPp5cv>Z)hjLXYK
zN&eK5MUklVB26Ldg*VD+0?OQ0#t0AL15ZACQx}htay!NO*i%K;>ek+VuduKG*s4}<
z+*ed5`g>Dx9R2rp^}EBtMwJKF$QbTf@=p}=r4IcYm4X&=Qk;})bGiqF=47M}T^9{>
zCIvceBq&*Z?N7S2)@Z`_%(QMt50M_2Y3*HM-bIt*4o(h62?EN>g5IOm6HoJ+rx)XB
z#{P1WJ<|k>m(Fc#qji#Kj06+$WV|EA_NEUrM1K-uN<toE3hGyi#YI1S0VZ!6V5)%j
z=!TkCpHn0S{}yEuJ47<R+|i^8Qyf&V;wVkUsx*}gn~Yd@>R&F$96&!{Zrf0NOO&ti
z(sT_K--07JC~p3oNb+*wmlUvodj3mG+b6-?*QnRiG{S#mMGhBaP2Oun4tVk><>L~{
z^J46W+rgUqd)nh}fn)ExLeXsLIxTVeaG~_La>-S9roFlfG$hmu-G{Wx$J^5D!kzg2
zZ)~X#@U}bp8v80G)Th#9JeAP#jGda3XI0C3xhlu6E9YqI^rBD*x>J`Hh8J&X5-1OO
zWSRaad*oQw{V6SmQU-(mrJwY}DqC^1#4~=Nil(i!MB%QMXPs$ce6o|~<_+73S_*JQ
z4LA!z-`6Jz>6%_%TS;cDezg?a3mC}F7^(PjQnmqfE%h;VWP%E&Ztil29WOa`$+3nT
z8a&GBN!^Q|vTVevjZ(I6$&^E2GIb?OW1Y8%Nz3u?b)iqdTGJc9@(r|=tLA#L1d?>=
zfw$!_{@lA_@Ca;iwy}^7EK2zog=9kVhZ}`5bmbP5Dumv%QDt$Qa*GvpBlmP@$fy5x
z9co+WrPMyI!0>aqdYx4CEHT(YafNMBa{;ySjDmB2hK85bA(c;DI<#Sk?y6UgTxV%+
zEJEqt4C`3?*E8^;7<SfR@?v2GKY9Gi8}GQ`D&L`2!)zSDfVGA0p9ob#pZcmy?Hns9
z?T#vz+Pt}s^`=@ZqY+81(AJP<+xs;q*Ame6v@=V;C5k%HQ@#57QthR%9w+s#{*1;T
z3c>A*rg4w83@_Df=_5O?Ms>ui6(qVEt7XTXBD+W_Hd0;~OKQ{Hk-}0`THcWb>^N$3
zlNB-lB?0;K&3v&`PXo$9Mwnu?WviTQ7h(>=9miM*UqEnE<9t6!A9%>iKJ1dp(wB1A
z9bB#&feURQCr1hwk3k{OaK`pIT~NhBhZDz@B)S`m$(fyUyN3n^u3y@_q#-5dT}wLh
z=M^HhC>4Y3@X3pE%K6<Lhu5@95SNjgacdbb<>hLUI8xu#LoiGd_=<$M5P_cA`Nl1E
zS;`$<LWB~`Jb=SxMECg{IT2U}Y$F$<x$ZQk`MdfI2kk^p$LSvIQCT&zy9&DeOVWYA
z%c6I{u(Yk<^{K4j2HBzUkuR=F&|ipQu{s!VN#x~BB|xru(^1Ez4M@e~{!Rkt?{-SK
zu&Z2gDWsDc+K{H4>z*nFy0=Of6%aqV!`Z?8CECYWN8c3avO!g-D<<;(Oapmt4s#Iv
z_79nv^b;HSg4{M5(MC1+vrkBZrlw;gByeAYF68hHS$;cyqf6!jPx&oz6J4^P%c<0U
zY??cgT6yQe2U9=?YJh@rT)ZFWI9t#dl#<^^H+Yq!11A#t&pFUYq0i!5;>r{6R9r$v
zrR>Thq7?5P%iTb1fe6fQ`0Ga4IfkmCjgpY78>!LhmL!}%DMl+9C=Jq4u!iK*^-Z}N
zq`CpMfoZ#STk1-78DIJrg6s`q^vM6XL9C3K|1~Mq_vLtATJaxZyNASo2&UBY|D0dy
zx&M#JW#sw4q~OlCJLux2v+=d2G>=5)?+Ec#1B?LNgvH7$*2y0`%6?79G-zZ(N)A_a
zL~|_A3tK9MJ*iaJx;U7&1few9sN2h>1FKFoUrAouxn!<M2^rIpLo|8AQ#x@~Kr%^E
z8Z<v(*NHz6$LDc!nJhC1yNB+bKzRbln&2-|<P-)yK)<yljSu?5PlQ1D38)%e%hSJO
zby@)Tpkkdg^NGzao^D-3M5RX8rC;yDHk0!!C|H<dZGnZO3?hHm3$Mitz;SSYyDx=Z
zacq}l-m}Fj2S;VtRN-R{x)wu!?MnAyTG^=k+sw+#6C8k#=8#uZK#ByI{%}_365#fv
z_QR5B6K4eXH}T6*J-CsG-?Sn#k*ZH5`Byqx5}VXzY~tu{E<ICmLV29VZj4y6H8%;V
zR9FTVZp8HCx;wvRwR-XgAuPcRL|2h;7`a76LR(~|K-+9l`}4$++93_Jh1O=0q59@6
zJLyzYxpc&P<r95{=NQ|C2I4&`9fwlH;t<H~kIqDzat&{2DDzA?lwG7;s5I<tP!~?S
znJ52N4Zhc>KM2Vw$xRTQlyd2`l(SbosYEbqMKgAE+wmkf|Lzxla1K`)s`}*}7g#6!
zy&JvV-{8Z?Q20WT{%|ZhKYA!121+*@GcXO%@KS(tJ)C~1l{CdbVeyS0M+Uo&6uoxS
z+hIDfA4-j-fo(oYA?6R-;?`9vh3b_Uiqef1>c(##_3_{RS`)`~$}g3lBG>4x=YCZ|
z1H`zBh3{|G1~tdz!)cdD*@<*G?UKr>3{koPb&^6?UT7;^ZC8*B73gwN9GISDNb-gU
z@!cS$SM8kw_m&v9kzP??*kk>pe*nam;w`-MNtfPjVL+`yI03XMB4Wg$g!mv3KWu|N
zFMHdZ9h5opp<nl-K@TL6{0%_t?!yuyO9n@*(nJ5~pZ!6D;C(8(IER7e{2?#-gPAa}
zbTRcIi{7K;9X8j3uR<P<v*C&bKMsMg0YqOiK!Nk41{t9rgP=0k!RRJ0c|K}ihhlq5
z{c#rJ{V{yCkA9n?2I5U7eSLyf-IxsEk<kj6glN04DN)<g3tzps)Qb&jTAOEGYrA^Y
zg*W=U%hOkgfWW0H5f?FmR74AYSlcJC#uoSyAki+OkZu*T#05f}Fj&||#KbR`AzWC8
zn=)9q7Npbbgvs^eeVY)s8#1vyr$uyuDHSOdtW+gdicIt&Gb#9m5F&^dQHCjO07;aB
z>p{X4uN1yi3<`}~3~<421y?Gjfs^SUD?|@cqZHaX<zB>!AbSDC3yYH=k04#*6L<!Y
z2a-{!I7{hGVdQUc>EN+t&U%qgs^kcATP`YuIF2fYN<gK<tf=zPgiz<=9rUI)A;#Ar
zx0I6}j#&?%!Q{=hybfV0Rd=-`9S<m<$`(R8RI8M}$W3z%qdM#3+=#Yb@L0PdR0LcM
zH7h$uIqG9N$O%h6mFPC)vlP^hG&=B~>aapI;EBtyNT-X_n9U)DA#$lU;z*|(?-AKP
z<Sc~p`b90m_o2KLKfrZ{j#DxXd>>MYBP~i%`pVWQ=XedMFUsS|;&d?=Z#fxx5u;_U
zXNs9{$$W}jDN`;FLS>hVCCIxdaQkc(l-I3d4p8K*7Of~tgAmrqNLl1JaNfcwgN!3`
z9SO?gImv!E^-5hs!ZR6ZRiGRRw5#xJ#XB!R&Sd_mTp_rW@7M~|4)x3+>Q0XnkynAb
z#dndAQyqw0a#P)qMC40f*>`D3i?V^~cOg8ziH0&#D5AQi_MrhT+ktursRog^iNjD&
zpk5$`$sSAZ7Ne<W<LgY2d>_Iem#z|;k*XZU_^mp;Lyj}5L)7}P$*S&9Cr}f*{ZQK$
zwV-HjMY`CE!uX@!h)bw=E7gzF186i+U!;*5MOf;uq%o*nNMBHmrno1lR;oT$n*R@J
z<TWB)U0*22BAJ62-bGr%(Ji{|DAyH`uR}Z<om7)t14V1##_u`0(wm{`#2DLw630;n
zx33uOl$}ziS`oQaPMsgItQu*OzSOy)7?dljVai)ST-3Uyh}{8n$3|(2WeZbnQ;75y
z76rPG4)B3yuSFZTpwBddYY{6%6Q&uY=ou=+lxFTJ)K5}qQK{Ff&`NRSh(;g6l?@h#
zd}P}pm0Zek2l7rO605WZ)pLOCqq1B&l#WfhnaWK4f_gTMGC2-Pp)*AH|DUu-TVln5
zlxfB)<#~iOJoQo1U8MI&J_|GhB(;E1D_cmn4~=Fy?&(RjpIM#`ZU<Qst=&Yn)Se=L
zKue6DBItjqpx!052luvZA8C)(NRT=KiG3iq$}U9(Q<AcRDErh{ve8KGQsLa0)D=sU
zx9;dIT(#7JDDFm7lbm#@+GXbqi!EHx03=lPSbDOX{BeZ}F{oRTTn;ChC&~>q8$GGo
za7CL#&|63a42&)6t5F(Kj+Ad*<w4FDRgNxSFG2*MNF1e+J}|_1{6;oH$m*nWR$(A5
zhN^0#Y1)IyqkQlXvh%i~JfvQeG|k|TKdi%>v}z3xk}|2OZqDy!pcw5=TdA^qdNY-r
zR3t0^T$0H8gDOUj+u*x}OGSp0QsFr@7?`UuM8(*8sDvhz#D`~#SdV-_>Va`$Ev9_t
zQtBzyJ46oEJPjgIsrwO?VqnctuaZiH-Wh~Tc%~suGMa=3lXV&8EVJ9DsktIqHZn$<
zP)7G8BgT@S9xBwEsMSO^NzoEb)VF2tph<vQo%#-?L_D=1O(10SQU8)A8x7wriYH}G
zeL*S-kweA^O)g@YOqpt1PRP^)^*bm9IgsTDq5Nf}lt=l~^@1FuXHxEUpVVsF-J+Ct
zISG(*iQ|1#h75&Wot}=&In@~DAU&*XPg1|+=a}H)IC4?FQ6AHC;0jeB>ymUsdb(mP
zjSW(HQch+C+Ikt8@^RD*jeA{AX_%8KAnS-U02$y~agtQFhpzG7LDC-BrcOMq^2PYU
zas^{!#$;E1+$qT%Wt8oNdXylQHVxOId^9zav7-$su_V16{x=;X^&09bPxcH-jdCGo
zq`NCJYFticwo$sk(M_3c6XZPV+Ly~7yHB$Lq7BT9a+gp_dPyeZ>E27DI@8o^K)%~y
z=A;{dVo??MrvS7Wm8%mqPpwNUL@KKuzf#L%w-ItVF2yi8S5S`^wLavf9VyVvK%<#@
z6fNa+-gP~uzr7J@k=7#3dnR<x*+TefZj!Z^US3=;<djKgoWR;a=1Jy;@=PN{nl2$x
zCX8a)FPb6O6E^+=0m4vSi#Y>*2iKOaI7I{F;14bEn?>b7zhkARV)SRuq^F|3NS9Kr
z$+>`PF?~GBdL`XVGh@0LO@36H)Mf)`+7`@*)T*=y_+Q>Ew(VSvipuP+?%}8#RjZ&S
z$`YiBM6QX$upFgTMY4g4BFX-=jwAn0WKXUfsRK(tUfq@duQ?G#$9|6(KlnRD0Zk~h
znwFi1)C5f+m;!SAs8BLF#1feU_mnbNO~|R=85n8}n_Y`FFDAcX(xRp{wXjO5%g>Wj
z#(z=*(#m)5uZW@*FbUS7Gn1jP9x2zrFsQ-`xE_P3QiyF&X$v5IywPkL;wq<oB&rT=
z<H-KzZY*iOI(?D+bVE@yZNj3MDlWn4Q8US^r@0x&%BWD<&7xSe*q44Z63HAt50!c{
zc$)R8uhU4M38GXf#yrHBiRXMg#S~o@8p+gisY#^WpyyuMw3#`EURt8#`VdPS==~T8
z^nV5_un|Zb8>MLQE@(&mN(hi_iwlG?o<`X~`$-I=SzpejqD(H^$cm-yFIxE1$gD*O
z${m(}ZKMa>%Su0&)0t6a3N+41i%E;80-HEwr^#jaG;tREWKEW{d>V2&9a}n6(W$6h
zvr)sSt8JI1PjaN{sNmA{8EBkjj$l1CJ3UyBWAdS0B*$m4(JZrqj1;GLybMJ@TAF)q
zlT74I<L)HQqb1n&pf2N{0(4H`mq&h%){$<h)JSWHvF><U@rg2OPTk?%M!g*(ho(TP
z6B?Z`iF;b%9&Cq$!jVBl+KP;6Y0go{*K6m2wd3TN8dhrx*WS~%%bU?FX$~iqQ-J~Q
z9v>B0yp!EV^8>y5JUsP0QGxzO)k9l$VW<JhbN~gxueEa~scQPMpDf2D#iMuN!<}QM
zDDvgjE5)Eq8*Ee!qv9&d&vT*>t?6COy;VsYTXJnFw;5?<(<*>$3-@+udIOgV*nZn?
zCgYD@RhnU{R6x>-f>APLl+v!6-dU#Cx!YW(AghvgaP-7TV_`E=rv*d$!dZs+Z&}3B
zi+5=$Wo;VK!b?uAV%sC@QOA8qI$fdD*p~K@>@Y2eOsnWjyOp~2vHWOur`Dip<Ns^#
zdtj@&&OGmXe)hXI_T#;0NS*eXytHI$CJti~XlYAkVB(~(g~UmmmhO-Z4mPnj2HW75
z5-nBleWnq!OSMEpB_e?qR#YMq(Nc*@M8X<6q7spu5s`>wBt~K+W<?}NOC%~0iP`S&
z_dDNx_u0n8Njjs|?tuM$_nv$He&;*izjLnd^u-n1mg_XI7m<g9q%GhG!MS-2zuX@n
z_qavughR|luna65%QoC{f6>BxocC(~$w^{2f|;a`gbJ5HWdBW{9IuHJ$w{WY>HTc(
zI0Pq;y^lCO>ODD_oXN-tc{%oca6A(C+wg2VrX^~Fv|z3$FnT9q{tT41Y5P&6C7zt+
zjkDfJ%h0NIo>Lqc<%~_A4eC@=`>j#E&#13)AeI6k)@$+nRePk$Q`_JntoFS)M>L+<
zaf4{l%%F4+H5*4vp5RCv%_$0_m{Ba4DD<lBY-eGUTc{BuA?KtFOVK>^)=ghXPB%Ln
zl=6!`bu$v_ZMGf7L^R5W8FFR6XIixEv+H}sBU(UC<gC8}i8O@g&S3PuQa$c&)W`iS
z_-RlD)T@jU;7^A_fNX%V<Sn3dbTW_|9pr7UEtq@{KCQf5Bh@v=`~?X$eUWonQX5bP
zRkJ+J8X6CA$jXtXy4u|`qFA01C2~{PmEBMP)e*vK`Bc68He08A%`>GRq}Bs8B<P|z
za&cj@6}KbvQ|xlg_1tTwB4E#Hld~L%)Z`?u1+4nk;R(e%nS`Vt!l>E*Xn`>l_cY3K
z<eYFCOEW`$v4s*z)7XdL7`<2LYK5a3t+a&~k<eeV(>nEs)F;Efu9h7m$7!)1=KfM-
z<9N@^)mA6ka^WXOlczux7h>YL;+{JPw!*Yuu)fIR;e2udSLzG?=8JXk-h}5AMDemn
zhQ~vS3>L0zPDtE2lXibGSD)rdq<NN)+nq_2vH5l2Uz7;Jn{##I-mLS->=gApqop=4
zFU+?`U0OJl)%3C4f{EvU2DQIbt#i-efBQ0>y*ClvDS>!+u}F^x`I$_PK-b-6-RC0S
z=c;9HV*S_8)0uw-;ygQ7e`fOjCh!<7GHT{~3eGQF<J?3W|Dv6|Hvy})`WNA>dHU7s
z=IZ^tNjmQu<|N^dKP%XKH}7q_Z4{{&x8A-RiK^h8`3~>@iph9!uHMockB`VWQ;U&j
z1|OcrFZWi-_tTkXhJ>ASqUKw>x9V=uV|sl>_2MVE;$bElu)`2*F8<`Ln7b77%r;e7
zg65F(^=YVZ#Lh{71*R8UaeiAQXuaG_YIt+5bZ6dGv-i`ejg;GcZ`lDhy}PLXtQyI_
z)einF^J`9X&ea^-JM--6kM7;mx$67Oe$J_*T|Z~4ta<i!POhI%t)JQF;7v|7ZFc8s
z&)nj2XJR5oVxZM+6uT33lq+<}W0GyaWJamgOjMmtPl&!2{f5{+h;n#;HP`gaRBIGU
zvzNy`72NZ4)qVH6qCVZT&TVtm=_Y7?z5a5GYi1kOl>dyHU;2E#pFV4JU_PV%&sc0T
zdmeMrXVg1#?|wgro<#u{dehx7u*qvP)xb00!n@D?EHN~v!$dA|e*QiAWS-^cv;#KG
zHDc1t9sQYSPv%?&bJaAA`lrVvW>Mz{pWVA^uDmCu<`krH|7O-Tj~>pW*1L1UJ^MQ6
z`ic8Gcdhg2^_<Etu7CQP{0v8OPBne+`sUHo=Ixb$Mx@%j-QAG%ZB_b#>vB6{MX{+s
zPMT=|MEZtjsAG*3?XJ1Q7u=I@2W3jAGmZv%100D9tjun04Q$_NGuAomj6=otF}GaZ
zc7h8(GxXwutFuGE-tI5k5_P9LQ9bWAgRv(uJQrW58jZV9ElNq!S1LlUnusy+Twu+e
z>vAeNp1|29oQ1}H0i1Q27m246mYbPwxSxx}RZK<U#)<M)#AB}R=XCa%*54=N5?`E3
zUg>$zJqjAfHU0}T+0Xu%t$qQ9)2Q99)wU{bn|suMlzIQ$t-6ts%ci&gxw!3B()!Dd
zb>0j41@g1o6LDLs6k<CdxS~i6J-b-=xpm7e0dA(ctqtxmGIr>88TER@!>qOX{9vy{
zA-?CPaZMAH4?iQ5Xs1pbyY=Gsjk!kHMpOnzX<9eJh~gd&{&xH9r$3sR76<yH-7x0|
zvp1A7G?yq^DR;Qf#T4hWR#U+H9{1K~?`Uyb#g*oPeb;jy@}UyoNfDiZUG_cP_lOqU
zfR1+SDeNQl;7m+!#aub5^kNq!Hg>%^4XD`Uk6%LJIkQ2`kuyFc)i%q3YN|es;4Q4a
z!-kSxYKYu4Zw2WRpNDpQ6FrSpAq^L&?!5b_j|Fdxq6SIRW_L(~yjV%QKRUNJ^HhYl
zZF;|Eo|#|`j;BdCciw?q>b9$9))uwLlS^*Z(V_E}aZAa?92hg%g^`lK@MnK;J%D<n
z-D$6NIU*~3xq^CdW*M(Jeo7N;7wYh8a0m>q2*mLh9bmz$JI)bxyDdsv=y--J!QFFP
zD|$hThhF}pVot+&8f}3gH5aFHYYr)`vrVVR;f!!R*k*g+?i{`iWw}<o#ZicS0F<fh
zF?_|X3HFfdrb3TzyB8~-K+kv{itB_&Fx(2^yhL2b+F~h@z}ePE@NARnicWL$M6#1K
z33~~KH9Vo6eXh2r&<f=RccfW5e!?~8o<%*o+nzO72x;5rB_5c5w#7*Zu5jbtA3Y6v
zxEBw}t=tHuc{aVr@f^mjvR~8BhL9?pYf>#ygEtoJq%q5ELvF8`l7bX-l7#g0a?>R(
zQfjy0RBQqeXJ`Po2;#*VT=xjREVx||JdJdmO#{S>I)JYUmH_wg)vg7xA<NTlk$mzV
zoO$q&?<ag8+sIF0t!@P8dk;{)#_zE%7mvPz&EQc*J-vq=1)Zt;8F|y+z*sT1g)GAt
zYn<-n>t~OGF6_(mIDJtiRf50f5{?;(@gW{RAd%e>1}<pstlur2j2Ry?=0v%84g<3!
zyNf;1&ad|N+=RLlMa)mN2Lbtmxmc)Lp~RNHTR_wMSz))YMM9clgNuG=Wk1~;nyr+p
zkHB#1oX<e^{AQ&b^Eky6@6)fS+OvNYWaTI$As%^9iPxX1u)}kBKGS#N2%<PgEcj>l
zF*=aLgKDG*RU>;C*B(VkoKglGRCzbivu~;lmo|kH{(d-UPf@~SMZ^>kuOQv2@`#G=
zjZb=A^yea9i^7RP`?%M;y+rV4+@XK1;YJ;b*I;#*yx{mBr%UcE#LPoI+d(a!p1Au=
zL|x-7&pg@}QJ2TaqSsXLja%f@8`1SIp~L`BLF2_IC(hiP;gxi#*+|gL=9fri$lbFV
zBEz^+Lzs)JpoWf)YB-jNm}Yk6pG6Aijk;Y8>h>=eK%frzy4ceV%GtQjfIO_*?E=kb
z96TsF(;j!Ph4ZYIJEfHf#^zJi?26nlpU2$I$H8=~t$H{y%i@KyP19AL;|aDII~UVq
zC(-dms#Qwf>YU!Ur`JY>%{<l1#YyVwQji~bRm{m6zNZ=+T;2+&k~V_xS@WRP#bAb0
zQ%=E9`Pkd$xi*w1Q#rQ*BW&(~o^fhw50n-2dMkdUwdABxbasbwZu$$9RqE^e)g_+9
zs2Nz9T_UD!q#+#rqyFO6jZIagrC6Ow(3de-p2eMMjZh<VLnX3pwxbJsaPN+z@zkah
z)$9VrDg$NFsdo~LL?Ii{p5aT?Ua1TDoR7sbDb)w$9NFXZiBY`d>)>5?h>RTW*523A
zEBAgK)9$Wh93km(d%=JCV-SGvgz!~{FG+&nSJWJLQ;LpFNfQ_KqEe*z<>^MA-F2%u
z>Owr(v)|gQe%C4z#F4>5CL#}TAkiDSY%}stI9sp<d%DnaJm9;}RV;5}PN6|GpZW2E
zUwrvl;UJuA?p`B_PD*|O)_h>Sh`<A){F5u|K!oZSo4tk8pF1=3r+Ps}Ojb|1#AW2A
z$&e$!lq)c(bB?v+5RmuCCiI)`B1z0?AI0MMA<}pdmNMsgF$hmtBA{3w9US()(J|wA
zG3)%HCX7O!J@?X-TsRIZC*0YQRDGOQT7Gj&9<M&q_FgTOn|J?QHmmpE-~Ib<{O#>G
ze{kXt&;8B+c=jJZ_G*e=B2`Qz{91tAVqPW*GP>U&_#$C`1X+`Hi}S%Ji9)LAHM3}e
z_wOePAfX;K^M#9i@DKjteE5q*KJ@$|;BWKcgG~8YDax1+CXs@oxTs^x<;AIVBEO^7
zOJ*_!w3i>qWYV>{*YiJZ%?DvV__?3<(1%=kU45}8|I-YfjAU?C-jFMA%7u$t^CPaF
zXX}a{i=d0lkwVc7vgAjQ13k_(u+R&BuKeRnEm{oTN-pv8%=T6;_)Wh2BC@sS%C+i9
z25luWDynh4ld8)FzpgJP6F?}T7K2~2sS+qrNG!phIKd!)l^@|~N*qTiS=WFjmLz;D
zR>Hs+DWy`;@y2v*YsSyygX8(&D3WoJL3ea@lvgOzqB6-PiG1462XE(tcaj{ZpC3sk
z(_SjWf63MYn#qUtNKAXlWPT(+616+B0E1z_OBiC>btYxlUy`oHbi9iKLYXCAGP*$D
zy*e+MC}fihXXHWE$!0IxoZwu(n?xzr*X%VX(n$C%$dU3AiNa%P-o};d#;-IH-9{Ks
zmUxTrS|X!V2a(M+%ZoGyy#-Wb%5O2N$7|7%LQ8D}uk~~*C>uRJs`R5u@689}QTn*j
z$FtMgMg=nyj@~ydhi)(@;|p|^3pZoNYSIZGOwd}}=+!3j<&w`|AF1`px@0<=NF-X9
z;7@iWYC+q^)><E^2}m<pC}0UB6IcPL@B{Er1Mqvvd?!}RSF=e@&HITZ35U4y-V<-6
z8(fwgYDeM+puc6&xF#(fMJwr8dRVjI)o|3!QKrzeIA3l`W%6McehPn@#?>AS?izjy
zJ}HIuuG$MTZYc{sNO1A`%^qsOj58znqQGJpM{tdeyq7E_o3n|et4n=h|C1m_p<d6C
zF}VmiD*aR{vS=LF@_2-ls&V)WicI+cgYo^AS&uFA0?;KY__cIHKDfg5QOK7du?kUF
z^T9uAtzY5d9f25xG{JJgHE^w$C;)O<XX=W{LZP()j!#0s{52Q+h|LoO)(9tqn4`qh
zjU-dxMc#!!1|cS!+#GQX`QSs%z#xbd-j7U8<mO?G2RSXZ)PT8C28=O!_O*1);#}}i
z63ZGtxct~Iac9h^CwR9|`M5L}RF!b)A7c@_^r(0}WQVJhl0Ly%c{d3rnDo(Y_V^vm
z#6Lrzf^lmgvJ16oAd)Lr{v{Mhh76s_v=&lz`SM$&X!&RZwM6+in5~s`z)-_h))Tfi
zrBj%SU>s{L7bZaEOlv09ic7~2xX3_?5|M6LIOq^b2bRgWb}${#A}E`NjJxVD&V{wQ
zMSoBW788a8x!B;YRJFUrV@x3*XACzQt~K0*s!0vIt*g}5WGM|;)#wJtpMl0<UAZtP
zhRGGt4c;!+Em&wlx(1_kKd2ZN8Ia2@_(FjU1VI^$x7KnFTsBKAA-UEAA;&q^eEGKv
z)3u;l_+T!4C?76^0`$OVnWQLDevgFzz~%e^bs=9SU;dp>jg~<PP05FZ;qR0y{9Qah
z%P>EhsAZM3@)fDJ-+{?lMXvl0C}`QrS9}j6xq>zprfXVFm2ePAEdyLE2B%hr<`y9Z
zra0oC#DDjvQ`1Vi>>PA9D$5%Zhn4dBtLbz;+>Z<Vw8Z(Dg#&|NCxQ92&P%iafnOWA
zc(5Q#T98!65F3thz~3mA3s=;olRi*GI+bb7cjC&g0p<$tBx^%1r*h$ed~hoteg_be
z0CHY*&zC>KLa43x(NZngqLz0)j4MprM_`wRhFtmMx^$`@|0H1i#&kLtKAs;z0`h@-
zLl|A?#0J#Rf|al^(UMNrG~~lg4d@ne%1bn~)T4`Ha@8I7)wvri*H+jrDF06j(pWIh
zDw!$yvBfCZ(%>@IHWh2|w57#82Y)1x0V!gh@L4q3!nUZWsE*aK7gSBFy7vMI0r8$r
zw_;T#^UxKJlKGM^DILNRq%>ZLl^yoMtl)z5(Kj;ODyjkKgHCZ51!CAELC|BBggx<-
z7o)TnYcb}0C*>OEFYH0XJ{Un4DqX)QjnM_aN5%QhR^O(MwkZ>vy|g_{w))M;NlP{#
zzK9>+$8-;{9T=pzjUH*F1COPf^5J2mQG-oZ8US0M1to)haEUt5GJ*K0wb_fb*`)Mc
zq<T<9`mRy5#T_M?lkT{bbf;`YCFBNZ8_ed&L+Sg;hkmQ?r~Fi{-`LauYJ&ODckm6U
zP)8yb!HAT|3EvqH?<H$9sRjUyDJ)S!ePy~{MIz@HqSW&ejj)Zw9Uz?PI_M%8jnG;y
zg^#hOs&0<kji0W?%%CH6lnn(+v}C3Mq5uNShy1HYzi<h&h@%;M1iW2W2Zhm^$rz17
zj}jgpgKVDnl9}ZFcT?jcoHHUa8D|QOtpNFqibmQc35+?D`7u@JF*2z85f5^HTtXLe
zYw5$FGIil5x0EmG0$JTp^w`~@xKoI*jOry6VQw35L7tG;kP!>18I!p*-I#<B37`PT
zKd?7oyUUFF06J2M87yJ+HZu0$$0TV%)zs0_z`9*kk-=k+qXgyh*yE&Q`NvwVV^6Xk
z+8CKykZ>g946%&Nh?5|J)))0oL<mSj_M{$3C3fhoze+zSXQGv+HQ79Ll%VGoq8OYE
z_dl6T`k1A9x+<7g)`%z6aCC^KNH{9qy{Hop)Lyg*LQQZGqLXaEjU5-Xbip}MgK)e+
z42Y^^jhp8h8iqAU@adCcd{A@AOx6d*)s$rXTVTotRPix8mmi^{@<AfLuk;~_HI)xf
z37!@_vnXB9`N7g6)Kz|@F<oZ~7`hLas)R`#an%&^!Da9&QB?0`XPI8+`YWi7;4+7h
zk&AJTIl;|743{O|pQh8!Rt2#{>={VO&e~cgDTVo%k;TeY<$O3@KcmvBhmKIe{#>vh
zVjAp0!kPL&T78;!<#{kG7^fE~O9qk^V(I4h1><(lb;bNJF-(V#Ju4l~2N&=_EchOJ
zq-;qa6)GK4E=r_>5a+0Gi2AUQjaMEt<IiHCKC6h_S^cOXstjFeK(?>KjV{<|_kkUw
z%UrO}EW%))W2!;{5~5)424-@~P3V+(bLxK5J$yZpi7IGi4fr+T1ObQA93(T5D<SKt
zLd&Jx*o#<qj+w)Wd^j1YE2zB*sViPcT}{{$Kzfwl_$i!7J_y?`yov^X3VxkHKPa|P
z--Jj2oHSn}MC^g~5HTu5hwzXWDk$ZLveYV8N7Nxy=BY!x&{DV-HSZ;}5a=lIb88f0
znpzb1t|FzwM(}+!MvB7KEBKT!H?UH$B3tt%MlG~(aM1w!b4Nb>G&j~`ZItr;l=ncS
z0)$t;?6Ll@AQ0i!HHFByt}(b@Ml0<tx6<TMgqtWVT3WEuT70+=>Iar<lHx=hJmSNG
z!U~4vfOI!szMoDN*m9{cvMW)fkdZ3|+aZ|5Pn}IkFp0|R3b0~OA>}tJ%LM`E4<a5s
zx5QhRu7hN70U11oSjvaDk-ot3G31H0d>gc*wm{y{#i)+M7}MB;<1`*=?MK5rp5zs!
zK=`XluD2}LTb!-ncu`>$sF4i#)F~Zw%CVB%^=J&&n$r;2;oHav8|594H5a~samii7
ztWe8@Z_~I7--a0gn!)0Dhj0v(LsM7KyL|Wvtfo}H?5rtNk}t!wGgXG$s5M+T-%d<b
z_Kn|=ADJ=by0CGEW-R*AxW|)ex;>a2NJ(a8TrK=4A>RyR*hHNbz6&vZ0~vAU#xVAC
z_HZmj_$29Pa$~=s#Db)tLXg|q2vJeFSpZ=Z-Q=cc#MEc1vf{RZ(os5bio(3SC?8DO
z2zB8ekxXSqLt(i==+}bOncQBjsxIg&1Py50=gUh)PgheLYKq1^l{6RlR=(U0#|o^O
z4}Yt<EEF)dL~iVt&bBS+(R=m?E=JPn!z2k7ey3GlE1Zo&12j%+Eu8i614*?zvH;+(
z++hl;Y^_Db1!P6VW5*K+RDmqGX!c;bW}KO*2gsj->Fq-g`>^b2<t4xmidvM{Xk2R>
zG4vA5!zpmA_qDsksAOpR2!oOZrcC6NJ4K>Z<h`+9xm9r`qRADv)UPo51_2RV0j7Pv
z>Vdmdj~tN|=$e2tx+>zbRn8?@MJ55GqD}Zmw4lO&;+!HN8ie0WQ)bZiF}1N*B&K--
zRm%01@5lcV>trYs9BLUT|4^>q?jgdkE;hNu654ZD@IkW)4;BE$UU0^Z?QBaLBDCL0
zykH+RjFv}BA=!~eL%q=a<hAp(0HQ9y^g<8OpXh;m4&Gz-#$u#MQ4?hm%W}5!{TVvj
z=&2H$J<M2igJRV+x@bOwX-gRvX0?^ptMggy2wr2shMOQ%gFE#UX`*6HU9<O)3>ZfF
zD^%bBM=Z}#C*Gr|*-@v-0^mr~bHao1OcQB#9;I{}G01pE%mnjlypc428=Zh)fc{Cg
zW@>U{Z)ehVm|O(umLQ5BZsG)kO%fUPnCS(iYP1kBa=h5}&|8FAf$ioyYuF(9W$Ycr
zWofV{GD-O0sPPlXQ4acj#DLr_R%n4wT;I`$U|h7JSVPm%b(n<)1<9PjSl;Y73)6cg
zk}u;?5@a`seZLc1%n^w&UN@l@@~G%OVymSS6QyWgfwYV7v|6_aZjB@}6`m-`3yP8Q
zLCC8#Jc5yYIpIWUW%;?lCL*VZM$nwK$rxb}9<C(H_|pGSlfU6Yd!t{C?X^jU_B*bG
z0Fk`Pl7-HpblewbI;w>IZh2xqCSL@TaVI3+qM<V7UIzTkeE9%bFtQRrjV039?>maY
zIf0D_kEBABD*eER$%vl3VVIb#LbtrWQUdlJc<?R!I5t9W=xvoE2NrQWt?c8KgrhFu
zXoe&mfe*hRor04A2OGcgh{GL5B#|m#J`|7tEh(GBc+Tdypx$y$G`FduBy1JYuRdCp
z<cNDDniZNpAnY;06M`oNPg#!OsN(R5$s;SB8du=74RWL)mlD<y7`i;j8OH+IgwADk
zfm$pTvw@AEW-pJGi1;R!I35(Jem1e*C0;Y5l^{f=1fDcmnybt;G8{F+y4?*J3Uy~?
z<wJw8an=j*RvyJ9VP)c(-6a~;Ri-1$vUC<qjQ?`($k5t3%a!Z#1K|qefIDdjw_$#@
zaR(Vx#C9Z{$P^5_QiBIY{44Dez_tK+TA_f!2$7OdkOQU>*0|IcE<IQxzd_s3nXt^j
zx6#(3+osg+A`~yS4j?DEg#IM`m3;Xu9QQ(gX}&~T0UHvCsRR8Z?<lDd&*6+o^DKqv
zF0ZJ8NaGd_rZZR0r9DDzf}+<+h#6-DW3#pZ8<<f6ESCU0DP!WdEEW9PF%mAE)TS3s
zpE~$8!**}1&%d#e+am9S<UsEweR@rP0oJ@rm9@)sYBQ9AIgVCcKOvbWBh5Xj>@ZH9
zl)(k_Fo@Tl#LkVaHf==V8I}oVYZ9ZMgjMfEEUxiG&V6GuI<38fc1Qa*ET=a4uy6EY
z($Q1lWL-wO=soymblcw8iidOoaKUZrM8*kx+6~;x$>1KnVvr08_h*wel?^st(0oA!
zOA=saJckc~%?-*r3E%QVA}<l7BDUrn4U|7k=C22%<EdXm1FD7w6mDyfnY;;8yrBTl
zgqcdhk;0|VEi?FXoFl|>6<^U9p>8xrNhi*V-Gd?sBErHDso5YptxVsO4t`gwO8F(y
z*tN<<tFl&ZX~}=A{8W7=Ls@{gpTxzSaO8tl^Q5fSk6dF>EzIYV+_WPXlm+SmuOV28
z&4jV{f%0P?!k12hJXkq}BxYAyln#!RW_cOv`8~BQ@|KrD+v=992r6q?vW`KbL?)ZA
zFC-V%W?E|zA1yxwhV)X27KBCV*W|}O0`2*TPS4mU5Y4R_=qNXhm<#$BK#&O_ZnzPw
zf*?oO1tx;FEI$I4)tX~XpDrxc77CEPR7nNgXRz55CEzw&tgGDWIYm0Re%!`$7p`3!
zunA>QcQFI%501)I?~=G0j}phl{lkKzf_ntzWxNsSdS9caov}dFUVU@aDa3e77E_7M
zS_iQM2}hz(L>$4dY=kn-*QJ@uAf^I_$P{Sdeq@;UY%^5*F#Mz+#~}w%RSSu>BU$G^
zfZYwKRQ!UP_tR+>&Ii|U$$)m0Y>PU$R@q$}hv<dYeuw4hgh?`SgD;5_8EW}NR4CMK
z{VH&}<<hv+YZszqP%wTLSyEA~aN2#Nd53!VC+7H1t4e*YN(sWpbbO*Z;)v37v==2S
zOeASbyI&)isE9j-dN4e!zP!RYSa-Of&E#Y+*ATYIYvMcf>KBj!ZsBu}oy^6cgIlH)
zr);F$!qtTnI|x^WzvCVr!}N@6K<b9zM3`{lD$0LarW&d_YvHG^Cfb}X8xout|I|5H
zpJFY_-&RAtg8i_@p?$DSDDBE;s7m%VK_MX)hymgfOAK>bz_wy@4L72jvGi@ap;EX%
z+=em|+r*4ek}?wP#sOg$PwKeB{^`GX>1VkQ8@}sz{r%q-{{G!d|G}U5PtAXL|B-)q
zHuWgp%UC-7IN04kos;VGJZ}+?KSw7ac}7xy`;>`1%vk+;S@n6iMrLq_Lw9@G=md52
zhY~YP;ORUbdhYY?<1Np6vFi8*q_4VSJP`lPjHXh2R7da<PS@aHDnXDWK=8&(F);;E
z=cRfHE)ujOPwF7SErQL+ojONQ<hGBO`UCzE{49}3@nl-^>t1kTc_R4FGrp0wyy~0w
z%cIZN#c7qVRJRwcpndzTy@(Gs?#9R69$&S*ga6x$_zvG_X;<IlJNrublJa1Cv8(hl
zzU7Bc<aH0d+PCxZmpdNYzH0lox35^yyQ-t-v7W_=?qv4)R|kes6TXCw4>O~>L`_|5
zEjCI9crfcXjkIFk#jYpM-{jm4?M<YCXOGWHIr^39d6X0DWL$;=y|+mk479#WQQgwS
zjC=pH!g4N7uUMaL+eg<W)WduT?G?-^rrl%p1=rB)Za&AEGORb+nj=W+U{Y9%yC7s<
z?cKZ>^`bK>j-5Va3F`qN9$DsX6kdbhl9Ki@X$rZWIk&G;ZbFqRMywiS5rIC1Lb9$!
zxoBbf7XS8Z>T-KY+JFF+Vz+?c0KrxCO4aYhB+%A!ZS6N9oJ5{5C))#hhJ$>cow{yh
zgMunW!|IPNM%25Hu;RTq+ftVOXY~!cbvTCMNa$C>qLWE`i21T&G(J)6jV@IvGs=o(
zK%;haxWEam=yUY-4UR0_9EEMEKdY{fvJ?GLLTA(x!&28=^VGQ*GgPTY!&6U+2gDke
zgn|7cS_JACc6q~A8wZ#p!$$Vuydd$D1cy`?H*u9;8@L$2N-J#)1@(n)F#nN=DA-4}
zq8aVJKw4%p(Ze9Dbh%Wy8mW5hF1c#LdNjA0RUad$=ho0PZOPQLRxz~o<w_fuNsREK
z^`a2<0!LgpfAlvIE3``uT!z+VtuuNC@ZKgWH{7CNbra~#VAKTmK$zw@3PrG&K)TSc
z=ual=YL(B0(3$T}RGR|ONGY?*a-(*;s$<1@SBVrnwWi~xa+bLl5fq~y1XJumnTxi(
zI!X*ZC9aR|gDXi%9&{@XVY0-=h@BYls^lI|#+Rf^xr?AXN(?`()D{PI^iV?XO64+q
zyTW2#bfrZROo~ddCv;ohV+5%5Zlszbw7x1lQi^%xczk&@a<t&9av}9o1eG26Iq0KF
zE`+Kxg<NO}jOvZ`1l^T+A*Cy%s`!k^6ShlOwK4k^g28A+VOJCDt~kT+u5h9f-W9|P
zk1hmnA|es|5~uXA8;`ptp7cc;Z+@x3I&NVL0Y=%7|4r=H!ja;6-b^+LlhvKqrTaYX
z_IOj(EzUCN&Yjb(<c)5R`*_M|!$_n00H5Bv0Q@Fm3-tYyu%eNPHtzx);&4|ugb`nt
ze3t_!4%~&mB%4Sn^i9bP_6Hvz^f5wTjVExwnN465K<UwA-Qd(LGC}KDKJ^N58=MW>
zoYc)xyMdbnUFI_LAr5ae;<t&OI|@TPb|!1-z?3qy*hdO<`zikrnMvBwPjfW%fY*H7
zg3wCvAw883U5V&HtA|PYP|uLnc`30Nt;N22e#8owW)+4t=?Z~(5DDlws<+djTFl)4
zLW~9^rZT}8kP%S`M<T9wrjhO8O(F&iyOK8<xaN@P3zh#`HZtPnxIy;99~@!e2b(Ja
z92e(><I>ICI6HDD&F8pOzH#iQ)xrhER->0pWMTe-19+fp6^=wA1=m@eF+-Vp!#**~
zj#xs07``xT1>ZpD(fcA>w73*C$1{UCi_?HgapHA6i@+4lez`~Q(1y6L$dh@PMM%0e
zy29$rCUah#3`&A#3l;X^bd$7bQ?x*v?_hNy4jI<B7HylfQk8|JRiijJ+>zx8VN_Cw
zRoCfb_ezH=xn{#21x9cR1C#;Ld9s5?NP7OXSZ`x-J-z#J2+;3N(#J7O;S36w9A9x#
z8OLL&Z#<K1^bpxby&41vjFuQTLl`PQ@(_G>^_kL?ZPzD3F}gX`&Yf7WL|(vyO3tRD
zd^2~CC8R^x?hexii|#VQc$mN7GK@P*5jXG=*@sgYwr0>(o*24}(@`2t36ceAK7!rM
zP??w#MuUN1UcoxN!MKr+lmY|XX~c+;I>iSiP??)oO_)M632`(Ro*AbN=g+xmL>6Ez
zm`u{gViFVJ9z-#~Rd|R4MyO{;W&w5zmA~J(9!*bS+2q2hmKNcgEiDYY<VRatS~$a~
z7oG-5ZzY4tB%9YsGtwS)(}i<V22$FtVBQ8?kNJ_@UO0%tkXbxs%OqSf2Nx+4b9<SU
zGHn48i20DUb1xS2k=x5QRSaj@+=a_R{)I<MdZ<vE6`+*sBP?Flh!%qb$gt40u4@*z
zj^m-)2L?BTtqyR7xFTF~?kZ{zrZl_Ms*o2B<=`4@N|uKbL_k&-g$zaEq@xO2=A2@O
znw`Wkam)qIBj&@muuP8PP<-W9HX7ptlp`(&=8KU|M9)<!A3`6g03rse6m4MfV4~QX
z$P`?~?4lcC)^SBX#3AhkShXSL3ufH)`ARdlW?YKc4IDRR%*R}?ZAd#DI>7lE(UT0x
zZt%3#xDK~5%n^()6kBP<yp2`&HtHwikc#;bXQ+RZWkuRrb$*whLx-{FSCy2FHaQuw
z(!#d{3@nTI99nM0!qO_hcqyn6U=%5*98be6_1H{Trcm#ZfE<sg#)}0c5ijt=MHNgH
zxNol2fJA6zmEh!55~XicgvXNM6_Id2zI6@37|9CyNw{LO3e7xN5c%K3v1(My)1FR;
z+`-O0<N;p4AUP>3rWz%;G8$WQp@)bLJODo61^R6Fq1RMI45;K=PAwdaF4I)>alXzK
z_i@<5i30S-r;&v2ta3AV9TC!qpxh`)kT(`b>eb{jwM;PHR5S{dc<0WyhUZbSn{g@}
zn_6tzjyHECQw*Fd=nhWBunG+w38+TQZfgM&$Hk(NRb=CtkY=ny4y^i@?}UXOG~*{Q
zEW!`C%=6*zk%XHj&Fk-7MG!Zf-0P|kdC*CSFkO`J2npoZY^3u_$j5dVLk`{%J5UE!
zo@3c?O}qn+w0UO&Dn&|_A{_@yzLTGp!aO+cNn%agt{lHlRZUMrUJXh8wjP%tO2~@X
zU4~VpYP9OLs9d+kzcKp(GSWJqv>0D7*=+4q6^7o4Oc@^WhtPqSP#>j@WVMAW6B1Q%
z3z)0pI0Oj$gB{W69x-@4I2t`TDm_xdvP(&;IC%zJ2_~ew2ER+DG}tmi$hSVagffCC
zMtm6uD!7Hra@^cS$z;Ale(m=1oMS~<L4U<d6@7_s&|_Dp%qP@6lF6XMz>Y{GN#3Ho
zyDcR#?P}6!_?AmRotAJE$C#u_xRz<?kGB?_uVA~SnR=XI!LBD944$-s3*$CRM>0GW
z9^GaZ%A>F{j7UVKaBcOu9nwsLdxDM8sF3ZWVjH0H2&K}f5$&S=gmzI!GCbnXV(1Z{
zsAhFRTc|jahA1<9g%VtNU1bm|LXjmNcB`-!_-X}K%_dj~m=&lqxK2yF`{0z|jX^pd
zRgPa~k(a`m3s9*#5fxy$?GOr%3YA+i+b;aAR?6qtR{6Z(1;LAgFi((vN$|4Zq~KM-
zYl7DWZwO8a-W0qgcw6ue;h0wU7=x$zF}GXPsOzlYB0;>9fv4)#SW(wY1=|GM1v>;+
z3a%DhBe+(uQ*gcDM!_z@Zo$ohTLiZX_6qh34hjwnjtcG(+$$Ie?i1WEctG%=;32`o
zf=2|837!x<DR@fowBQ-Rvx4UY&kJ4<yeK#!cuDZG;H2PH!E1uo1#bvW3EmXEC3su#
z4&gpeFeT^<HVS417YViq76gleO9k5m+XXuWR|>8cTqC$vuv2io;6}kN!EV9Lf?EW)
z3ib;23l0hn3yuoz5!@>n2<{WyFL*%kpx`0F!-7Wyj|rX-JSlie@U-9=!Lx$r1kVdz
z5WFZjA$Upfvf!lPRl#e5*9C6~P6^%=yd`*B@DAb6J;9WqFW4xU6<j3PB3KYC3N96F
z6Kogk5L_v^T5yfvTER}i^@1A(y9B!hHw$hN+$z{B*e^IJI4n3SxJPiWU?8|paKGRI
z!GnT_1P==y5j-Y%Lhz*EDZ$f%X9Uj*o)bJTctP-@;Dq2M!OMb^f>#Bv30@bxAvh&?
zQ}CAHZNWQ)Z+L<!L0_;@Fe|u7utl&SSQK0;*e2L6*de%5aJAqX!L@>&@KUg+R)Eo0
zQ`u+32_M-*lSq}1=4=DJ&nTzXg$MYqK5Q$!@t!RpW<vj3uh3Mk5r{?+XUxEmfW5*f
zN7!Chgl54hGZ~NCTEW47m1c5dv0^phNRB-~&;S{f7tf(^`T7Bl*Rrax9WU}@6z#AV
zaQXuSf$@qf_~cA<Y8a<WWI(s037K^5=(@A1dFAS%@r@#|7!$5W##s_DUXiHgafcD%
z&gmmPgpJ7>l+~4otvy*)sJcZ3HBek+Z^x;^sBTAM*JamZdc{$FVH<o-w8LTf$!2vy
z1W?B!Lckk@WsX-%kc<1l&bU>;kN%zxOVFl*;|?1N%9UXvC|4w*%V8F_flO|9K4ghk
zIh6-D3_RhH?vu1)h@qtsVBi%A2_Mfckq*zEH}b3eO7?ohjF?=Bm%$F?y#f-vum&0o
zH$^3b-&sR2M;H`UA(%3ryO`t)yfVVTVU<X6<a6N}Qst@fF@EB5;LqvhkPwx_C9}ga
za*RhRg3e34uY#~~k{oGgHRDv9tT%9}NKOQU6lpl<tG9h%&e=6?mx0=t=*n4~s-rbC
zj^Herk+V`nPCQ@M%OE_N0Hw`y%-{-D!<S7mV$<Nmx@92C1qb-%zuno8ni(5#&&7HS
z4ZvoFksBTdmmrES!;t16c|;Z|^Kd?BL-K<8aa?7D2b*z$Vt@sQ6wSf$+8qot)!>*p
z&f(T}&@@bU(0FX6U&-te4_)pivjES~!HviOwl?S7C+l~?A8hK-+e3N^myoLi$zWu#
zB7#&J8IrPa^LUD-vbzTl%q3K|3D_w5j~>ul(cMwq!Gsr{WPFm*hieF46zrs(>(M6(
zb{&0h1wynOf7nCejg|$7=fF$QL!Jg?@kzMQ8E#0R3P#kBgcshl6bbnz2uT@2bU+j%
zWWk{02oe$hbDlTeHRIh>fi+pnd@0KDV?LaKWJ4)T0PE-Jd&xZRnCSu!Ch!1RCO9(8
zuj_{pV}j~+zw$C3<MKix!~Tw9D3n-S+ZIwm7WPOv5j?;{9wd3N4)X-ZNs<=i#qOTQ
zdj(?yi$RWutKdDlPQcFB_^r85nTOR=uH-w>xVr^~uCRVBVy8Pk;T_U&AQby1aE1YK
z`jdMph)ua;qDWE>q#}p4PS+JT?mZB;qj}(Tp_Stf9Yq>8FmMAxIZl8d$y@k>K$t#e
zfeXW!mazrpdik6bC|nf77YtuCJYo2f;md|64PP~U&G2=@Hw;f1zG?WD;oFAqI6USV
zP8s$MHyX|wUSzn%aKUiV@KVDt6F9!HcEcTpR~lYzc#Yw;hC2<fH@wksm*H;1n+<O<
zywz~8;eNw|hKCK08s1}gui?P(KEwMBA258-@FBy84IeRl%<u`rCk>x6eA@6C!)Fbj
zGko6g1;ZB&PZ+*r__E<i!&ePoGko3f4Z~B0ZyLU3__pCY4)5~}rwsds8x3a-FEZR>
zxL~+wc&Xtw!|jGU46ii2+VC2~YYlfAUT=7#;V#47hBq7DVtA|JUc>!{2MrG!9yPqj
z@Lt1#;eCep8$Mw8py5M?4;wyW_?Y1nhEEzkW%#t=GltI^K4<v6;R}W@8lEtG$?#>v
zlZLMvzGnEk;Twjh4Bs?-%kXW(cO3q?XE<fpH{57AYj~027Q+R@MZ-%Cw;66X++ld7
z;njxM7+!0*)9`x38x40E?l!#H@D{^c4fh)EH#}%~*zl;~J%;xh4h-)zyx;Hv!v_r?
zGJM$Z5yQs}pD=vV@F~Nm4WBW5*6=yQ=M7&le9`cP;Y)@u8=f?L)$ldL*A3q=JZ1Q%
z;ai4p8@}W48=m2mVc&40;jH0BhFc653>OVAHQZ*n-EfEDm4;UvUSoKz;ZFS#h=LER
z1@8nvfrjwHaQwn4V`rhmQb2kaernph41Rt5CTrWcMdG(P>#u;MLXD3zHEn#snW+r@
z*ZK(iofAASctP-@;Dq2M!OMb^f>#Bv30@bxAvh&?Q}CAHZNWQ)2nrJ7Pi`nENZ6?B
ztl%QS7QupGQE;hXn_#<Ohu})V)q-mT*9vwDt{2=W*d^F4xLI(E;8ww2!G6I(!C}Es
z!99X|1p~o-g8Kyz2p$wXBzRcxh~P276M`oNPYIqDJR^8k@SNaz!3%;H1t$bA30@YQ
z6uc^UP4K$l4Z$hFn}W9lZwuZbL{N}0CFlz_3T6ct3AP9p1dD=81=|GM1v>;+3a%Dh
zBe+(uQ*gcDM!_z@Zo$ohTLiZX_6qh34hjwnjtcG(+$$Ie?i1WEctG%=;32`of=2|8
z37!x<DR@fowBQ-Rvx4UY&kJ4<yeK#!cuDZG;H2PH!E1uo1#bvW3EmXEC3su#4k3bq
zgegH^uu(88xJa-?upn3zTq@Wm*e=*1xKePn;2OcTf}Miv1vd(I33dx^7ThAZRj^mE
zUvN-xSa4KukKkUxKyaVne!&BR2L%ra9u_<zcueqw;7P$#f~N(~2%Z%@CwN})g5X8L
z3BgN(mjx#UuL@ohye@b{a7yr|;4Q)1f_DfJ6eLUu`htyuS;0kuErJEXqTo`&Ho<nm
z4#Aazs|D8xt`+R8Yjcr3puz$G1rs2rE7$OaA)4vZw&9O|rrXTvAwCbGPkg~Jl^*Y@
z^oXhSh^h35sq~1c^oXw+zHXRGkLgr;#8i63RC>fzdc;(Ez;b$sQ+7|K$9pP0Vk$ji
zDm`K<Jz^?7Vk$l2rG}~Wcu%EAOr=LmrAJJqM@*$hOr=NMX?VTijfT4ncN^Ypc#Gk!
zhI<Y78y++~Y<Sf09>aSL2Zr|<-f#GT;e&<`89r?Ih~Z;~PZ&OF_>|$(hR+y2Yxtbu
z^M)@NzG!&D@Fl~S4Nn@rYWSMr>xOR_o-%yX@GZl)4c~ECP7mn6FJ<?>;YPz*!;1{J
z7%mtt8eVF+&2YQn4#O)AuQt5K@LI#2hSwY3Xt>L8x8co(w;0}PxYuyM;X%X0hDQzW
zF}&AsV0fS5{e}-1K4|!m;lqZH7(QnBgyEBhPZ>UK_>AGRhR+#3Z}@`Yi-so*Uow2z
z@TB3ZhOZgEZuo}bDZ@7n-!gpL@EwQc^kDvfp0a!2aHHX@;YEg93>OR+4KFp^X1LvO
zhvAimR~ueqc&*`1!|M%iG~8vl+wf+?TMTbC+-tbs@Sx#g!=r}x7~X3*Fuc$3e!~Y0
zA2fW(@L|J83?DOm!thDMrwpGqe8%uu!{-d2H+;eHMZ*(@FB!gUc+&7y!`BR7H+;kJ
zl;N9(ZyCOA_>RMJdNBWQr0m`|+-Nv!c#+{2!v(`d!%Gdf8E!Y+VR)tC)rQv?UTe6s
zkns~Z1jBzz5_qwyJ9*!acJ&NDJ+$-5J=^+*`N~pv|E{5*>`ovb-oL`XTD*|udAWqw
zxV~rCj-j2eclYfc#kV)Unee{8X=vxrrlH>DFN_Wh?q2@Hz~J%?8^7PTvu{_==+LgN
zT|;|b$49La-qLS<r>C!P#kYDMdHGv?-+pA}w^ly-$m)*OD;|05JCCk@`LRb=u3FWL
z4+gDDcrDAHezN<Cp<R9JhKJjuSF&EiJ6Y&zX3<l-dUo{vWN6o`oddgv2YX(B8n@o!
zgqK~nvv*ft&+cMZ&#vCSfmi!HuQB1JpX(b$B5v+Wc)2HrhF{+`@Jjz^@$cR)KH9P3
zTb}n+!dthl_=@^FSll_Z^O0T*ZC7dA=)h}z#o?aOZT-c;ftPpn?0UVpeP~yaeJl3t
z>@9NG#T`SvrNKTBf=xZT{L$qrmg6%>yfHfA+hw42N9C?7;r-x+-F?M%+qU)X-rYSk
z1d?s)8|@$J?L<dk=^5=?^Hgc)wl&>&IqlE?yba_V?%Or``i7m`hn9c8ZxlZ+cN@Cc
zw``f`txR}-HnYN~2KokjpX=N18gX^CZD%6uL80KkC%oXuyo&7vd6#MAs$jRqKF{7)
zXNyLH5sdcjY8!ohxNm5CTlcc|qFQiG47=eDkfP5eyiGHEID=B_FiAr@=c3i~vuO2r
z!dq=Kv2oz#<xdRt_I2;-*|~doV6bo3!)u-x+W8uY-97Y7Y1f9G#sot<cmH|sOE0bV
zyyp|%)7||8yNf$CU&W!FgRd9+_6%Slh(0g(Y<u-5;Jw|&Z9_Z2I0G*a3=WLGUfeyf
zb6a0=w7;*oZLnwe?jmX!)?0-5U<FwE;i?|Rz1jWn8aLSI`oQGd`gXAsV68_IUfWy+
zI{RKOy|QuWl~-JDe6<SeR|}UMnc@o8?Scfi=G@JnB)omE;><IIK-0Rx!J(gQ!W)kR
z!-IWDsNb-&AFnZv_Vs$B32$iTWZaF*z8IsZl+FF?Sc~KkaKLK`Z{&~M=roR*-t6wE
z+4~b-XO@(jNs<Jfcym7K6hUW|!4x>k<APZ<DQk7Xh9HLT($LrOH<+qsxr<Wh-|ZgS
zX&l;z4`|e*-VLLDJ3Oz!329C=#I&1l)h~elPWw0UuA6%%{!d;Pr#-IROjhOdyq6%3
zI|m0h^$hIvcI@5;+1$6hcW_X-|L_p%$g*AP3f9g6;}FNc{rmr#0#L~qe~ae@)5+j?
zwBs)6%(ouDo6pyH2VyqGHNFz){m^?JZ<GHJAJcmdR~zuo`O~=H0QeNH`ENY+zy3GZ
zQ&OB5<G;{T$Cu8Yu>>Hl$pmWUyYNrpb$NdCaRc6H*VjSuY^k`p8&BQ$hxpaW=nIRk
zmeZ*zRGL7a_?05QiT}!7YPzUA9r#?6`@a(39Rdx!Bi>)4EI+lkLm!^vXXGIJ@PU{j
z>fvYN_`MwWp(uW{XeYil$<NR6?fmFtSp(i{NSXc(ok8^EWtH5eFE2$OQ;WX}%JJ}%
zEz#FbqYuoKL<9EWFTGr)Z~TT2KU@=invY{&ryBS<8uvN9F5q42-2lFj37ZT5zKb_E
z5*2#zJ85_Mk}2}d{PYaVcEC!F%l;5$`2imL5DlI`iqG2ccLjb)%kO$k$j{kxUm0?r
z?umOmvyJ8GD?g>ke@|(w8_@>8`#Y!^8OC_spHS#Wjow|-ir(9x;G<}Lg$H92|Nc^a
znECe*BF<uuc8D_f>WdpUzh%V_{<sg<#iQUFA)TX73Bd*wou=oXNv)Z*TCFncKu>;U
liyvO(=L~0k?q?Q_HORTZ=^C#Q&u)Kbt_=T{{{J!s{ts@Xr#%1w

literal 167424
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
X`C*T5M8Pm+-_mmZub=<#DDZy);+(dU

diff --git a/build/0Harmony.xml b/build/0Harmony.xml
index ba2f340e..8499d20b 100644
--- a/build/0Harmony.xml
+++ b/build/0Harmony.xml
@@ -265,6 +265,9 @@
         <member name="F:HarmonyLib.MethodType.StaticConstructor">
             <summary>This is a static constructor</summary>
         </member>
+        <member name="F:HarmonyLib.MethodType.Enumerator">
+            <summary>This targets the MoveNext method of the enumerator result</summary>
+        </member>
         <member name="T:HarmonyLib.ArgumentType">
              <summary>Specifies the type of argument</summary>
             
@@ -475,6 +478,13 @@
              <param name="argumentTypes">An array of argument types to target overloads</param>
              <param name="argumentVariations">An array of <see cref="T:HarmonyLib.ArgumentType"/></param>
             
+        </member>
+        <member name="M:HarmonyLib.HarmonyPatch.#ctor(System.String,System.String,HarmonyLib.MethodType)">
+             <summary>An annotation that specifies a method, property or constructor to patch</summary>
+             <param name="typeName">The full name of the declaring class/type</param>
+             <param name="methodName">The name of the method, property or constructor to patch</param>
+             <param name="methodType">The <see cref="T:HarmonyLib.MethodType"/></param>
+            
         </member>
         <member name="T:HarmonyLib.HarmonyDelegate">
              <summary>Annotation to define the original method for delegate injection</summary>
@@ -796,6 +806,13 @@
              <param name="expression">The lambda expression using the method</param>
              <returns></returns>
             
+        </member>
+        <member name="M:HarmonyLib.CodeInstruction.CallClosure``1(``0)">
+             <summary>Returns an instruction to call the specified closure</summary>
+             <typeparam name="T">The delegate type to emit</typeparam>
+             <param name="closure">The closure that defines the method to call</param>
+             <returns>A <see cref="T:HarmonyLib.CodeInstruction"/> that calls the closure as a method</returns>
+            
         </member>
         <member name="M:HarmonyLib.CodeInstruction.LoadField(System.Type,System.String,System.Boolean)">
             <summary>Creates a CodeInstruction loading a field (LD[S]FLD[A])</summary>
@@ -980,6 +997,11 @@
              <returns>For normal frames, <c>frame.GetMethod()</c> is returned. For frames containing patched methods, the replacement method is returned or <c>null</c> if no method can be found</returns>
             
         </member>
+        <member name="M:HarmonyLib.Harmony.GetOriginalMethodFromStackframe(System.Diagnostics.StackFrame)">
+            <summary>Gets the original method from the stackframe and uses original if method is a dynamic replacement</summary>
+            <param name="frame">The <see cref="T:System.Diagnostics.StackFrame"/></param>
+            <returns>The original method from that stackframe</returns>
+        </member>
         <member name="M:HarmonyLib.Harmony.VersionInfo(System.Version@)">
              <summary>Gets Harmony version for all active Harmony instances</summary>
              <param name="currentVersion">[out] The current Harmony version</param>
@@ -1210,7 +1232,7 @@
             
         </member>
         <member name="T:HarmonyLib.PatchInfoSerialization">
-            <summary>Patch serialization</summary>
+             <summary>Patch serialization</summary>
             
         </member>
         <member name="M:HarmonyLib.PatchInfoSerialization.Binder.BindToType(System.String,System.String)">
@@ -1241,27 +1263,27 @@
             
         </member>
         <member name="T:HarmonyLib.PatchInfo">
-            <summary>Serializable patch information</summary>
+             <summary>Serializable patch information</summary>
             
         </member>
         <member name="F:HarmonyLib.PatchInfo.prefixes">
-            <summary>Prefixes as an array of <see cref="T:HarmonyLib.Patch"/></summary>
+             <summary>Prefixes as an array of <see cref="T:HarmonyLib.Patch"/></summary>
             
         </member>
         <member name="F:HarmonyLib.PatchInfo.postfixes">
-            <summary>Postfixes as an array of <see cref="T:HarmonyLib.Patch"/></summary>
+             <summary>Postfixes as an array of <see cref="T:HarmonyLib.Patch"/></summary>
             
         </member>
         <member name="F:HarmonyLib.PatchInfo.transpilers">
-            <summary>Transpilers as an array of <see cref="T:HarmonyLib.Patch"/></summary>
+             <summary>Transpilers as an array of <see cref="T:HarmonyLib.Patch"/></summary>
             
         </member>
         <member name="F:HarmonyLib.PatchInfo.finalizers">
-            <summary>Finalizers as an array of <see cref="T:HarmonyLib.Patch"/></summary>
+             <summary>Finalizers as an array of <see cref="T:HarmonyLib.Patch"/></summary>
             
         </member>
         <member name="P:HarmonyLib.PatchInfo.Debugging">
-            <summary>Returns if any of the patches wants debugging turned on</summary>
+             <summary>Returns if any of the patches wants debugging turned on</summary>
             
         </member>
         <member name="M:HarmonyLib.PatchInfo.AddPrefixes(System.String,HarmonyLib.HarmonyMethod[])">
@@ -1339,35 +1361,35 @@
             
         </member>
         <member name="T:HarmonyLib.Patch">
-            <summary>A serializable patch</summary>
+             <summary>A serializable patch</summary>
             
         </member>
         <member name="F:HarmonyLib.Patch.index">
-            <summary>Zero-based index</summary>
+             <summary>Zero-based index</summary>
             
         </member>
         <member name="F:HarmonyLib.Patch.owner">
-            <summary>The owner (Harmony ID)</summary>
+             <summary>The owner (Harmony ID)</summary>
             
         </member>
         <member name="F:HarmonyLib.Patch.priority">
-            <summary>The priority, see <see cref="T:HarmonyLib.Priority"/></summary>
+             <summary>The priority, see <see cref="T:HarmonyLib.Priority"/></summary>
             
         </member>
         <member name="F:HarmonyLib.Patch.before">
-            <summary>Keep this patch before the patches indicated in the list of Harmony IDs</summary>
+             <summary>Keep this patch before the patches indicated in the list of Harmony IDs</summary>
             
         </member>
         <member name="F:HarmonyLib.Patch.after">
-            <summary>Keep this patch after the patches indicated in the list of Harmony IDs</summary>
+             <summary>Keep this patch after the patches indicated in the list of Harmony IDs</summary>
             
         </member>
         <member name="F:HarmonyLib.Patch.debug">
-            <summary>A flag that will log the replacement method via <see cref="T:HarmonyLib.FileLog"/> every time this patch is used to build the replacement, even in the future</summary>
+             <summary>A flag that will log the replacement method via <see cref="T:HarmonyLib.FileLog"/> every time this patch is used to build the replacement, even in the future</summary>
             
         </member>
         <member name="P:HarmonyLib.Patch.PatchMethod">
-            <summary>The method of the static patch method</summary>
+             <summary>The method of the static patch method</summary>
             
         </member>
         <member name="M:HarmonyLib.Patch.#ctor(System.Reflection.MethodInfo,System.Int32,System.String,System.Int32,System.String[],System.String[],System.Boolean)">
@@ -1760,6 +1782,12 @@
              <param name="name">The name of the field</param>
              <returns>A field or null when type/name is null or when the field cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredField(System.String)">
+             <summary>Gets the reflection information for a directly declared field</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A field or null when the field cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.Field(System.Type,System.String)">
              <summary>Gets the reflection information for a field by searching the type and all its super types</summary>
@@ -1767,6 +1795,12 @@
              <param name="name">The name of the field (case sensitive)</param>
              <returns>A field or null when type/name is null or when the field cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.Field(System.String)">
+             <summary>Gets the reflection information for a field by searching the type and all its super types</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A field or null when the field cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.DeclaredField(System.Type,System.Int32)">
              <summary>Gets the reflection information for a field</summary>
@@ -1781,6 +1815,12 @@
              <param name="name">The name of the property (case sensitive)</param>
              <returns>A property or null when type/name is null or when the property cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredProperty(System.String)">
+             <summary>Gets the reflection information for a directly declared property</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A property or null when the property cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.DeclaredPropertyGetter(System.Type,System.String)">
              <summary>Gets the reflection information for the getter method of a directly declared property</summary>
@@ -1788,6 +1828,12 @@
              <param name="name">The name of the property (case sensitive)</param>
              <returns>A method or null when type/name is null or when the property cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredPropertyGetter(System.String)">
+             <summary>Gets the reflection information for the getter method of a directly declared property</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A method or null when the property cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.DeclaredPropertySetter(System.Type,System.String)">
              <summary>Gets the reflection information for the setter method of a directly declared property</summary>
@@ -1795,6 +1841,12 @@
              <param name="name">The name of the property (case sensitive)</param>
              <returns>A method or null when type/name is null or when the property cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredPropertySetter(System.String)">
+             <summary>Gets the reflection information for the Setter method of a directly declared property</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A method or null when the property cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.Property(System.Type,System.String)">
              <summary>Gets the reflection information for a property by searching the type and all its super types</summary>
@@ -1802,6 +1854,12 @@
              <param name="name">The name</param>
              <returns>A property or null when type/name is null or when the property cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.Property(System.String)">
+             <summary>Gets the reflection information for a property by searching the type and all its super types</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A property or null when the property cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.PropertyGetter(System.Type,System.String)">
              <summary>Gets the reflection information for the getter method of a property by searching the type and all its super types</summary>
@@ -1809,6 +1867,12 @@
              <param name="name">The name</param>
              <returns>A method or null when type/name is null or when the property cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.PropertyGetter(System.String)">
+             <summary>Gets the reflection information for the getter method of a property by searching the type and all its super types</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A method or null when type/name is null or when the property cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.PropertySetter(System.Type,System.String)">
              <summary>Gets the reflection information for the setter method of a property by searching the type and all its super types</summary>
@@ -1816,6 +1880,12 @@
              <param name="name">The name</param>
              <returns>A method or null when type/name is null or when the property cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.PropertySetter(System.String)">
+             <summary>Gets the reflection information for the setter method of a property by searching the type and all its super types</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A method or null when type/name is null or when the property cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.DeclaredMethod(System.Type,System.String,System.Type[],System.Type[])">
              <summary>Gets the reflection information for a directly declared method</summary>
@@ -1825,6 +1895,14 @@
              <param name="generics">Optional list of types that define the generic version of the method</param>
              <returns>A method or null when type/name is null or when the method cannot be found</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.DeclaredMethod(System.String,System.Type[],System.Type[])">
+             <summary>Gets the reflection information for a directly declared method</summary>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <param name="parameters">Optional parameters to target a specific overload of the method</param>
+             <param name="generics">Optional list of types that define the generic version of the method</param>
+             <returns>A method or null when the method cannot be found</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.Method(System.Type,System.String,System.Type[],System.Type[])">
              <summary>Gets the reflection information for a method by searching the type and all its super types</summary>
@@ -1837,12 +1915,17 @@
         </member>
         <member name="M:HarmonyLib.AccessTools.Method(System.String,System.Type[],System.Type[])">
              <summary>Gets the reflection information for a method by searching the type and all its super types</summary>
-             <param name="typeColonMethodname">The target method in the form <c>TypeFullName:MethodName</c>, where the type name matches a form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
              <param name="parameters">Optional parameters to target a specific overload of the method</param>
              <param name="generics">Optional list of types that define the generic version of the method</param>
-             <returns>A method or null when type/name is null or when the method cannot be found</returns>
+             <returns>A method or null when the method cannot be found</returns>
             
         </member>
+        <member name="M:HarmonyLib.AccessTools.EnumeratorMoveNext(System.Reflection.MethodBase)">
+            <summary>Gets the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method of an enumerator method</summary>
+            <param name="method">Enumerator method that creates the enumerator <see cref="T:System.Collections.IEnumerator" /></param>
+            <returns>The internal <see cref="M:System.Collections.IEnumerator.MoveNext" /> method of the enumerator or <b>null</b> if no valid enumerator is detected</returns>
+        </member>
         <member name="M:HarmonyLib.AccessTools.GetMethodNames(System.Type)">
              <summary>Gets the names of all method that are declared in a type</summary>
              <param name="type">The declaring class/type</param>
@@ -2109,6 +2192,12 @@
              </remarks>
             
         </member>
+        <member name="M:HarmonyLib.AccessTools.FieldRefAccess``1(System.String)">
+            <summary>Creates a field reference delegate for an instance field of a class or static field (NOT an instance field of a struct)</summary>
+            <typeparam name="F"> type of the field</typeparam>
+            <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+            <returns>A readable/assignable <see cref="T:HarmonyLib.AccessTools.FieldRef`2"/> delegate with <c>T=object</c></returns>
+        </member>
         <member name="M:HarmonyLib.AccessTools.FieldRefAccess``2(System.Reflection.FieldInfo)">
              <summary>Creates a field reference delegate for an instance field of a class or static field (NOT an instance field of a struct)</summary>
              <typeparam name="T">
@@ -2281,6 +2370,13 @@
              <param name="fieldName">The name of the field</param>
              <returns>A readable/assignable reference to the field</returns>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.StaticFieldRefAccess``1(System.String)">
+             <summary>Creates a static field reference</summary>
+             <typeparam name="F">The type of the field</typeparam>
+             <param name="typeColonName">The member in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <returns>A readable/assignable reference to the field</returns>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.StaticFieldRefAccess``2(System.Reflection.FieldInfo)">
              <summary>Creates a static field reference</summary>
@@ -2336,6 +2432,34 @@
              </para>
              </remarks>
             
+        </member>
+        <member name="M:HarmonyLib.AccessTools.MethodDelegate``1(System.String,System.Object,System.Boolean)">
+             <summary>Creates a delegate to a given method</summary>
+             <typeparam name="DelegateType">The delegate Type</typeparam>
+             <param name="typeColonName">The method in the form <c>TypeFullName:MemberName</c>, where TypeFullName matches the form recognized by <a href="https://docs.microsoft.com/en-us/dotnet/api/system.type.gettype">Type.GetType</a> like <c>Some.Namespace.Type</c>.</param>
+             <param name="instance">
+             Only applies for instance methods. If <c>null</c> (default), returned delegate is an open (a.k.a. unbound) instance delegate
+             where an instance is supplied as the first argument to the delegate invocation; else, delegate is a closed (a.k.a. bound)
+             instance delegate where the delegate invocation always applies to the given <paramref name="instance"/>.
+             </param>
+             <param name="virtualCall">
+             Only applies for instance methods. If <c>true</c> (default) and <paramref name="typeColonName"/> is virtual, invocation of the delegate
+             calls the instance method virtually (the instance type's most-derived/overriden implementation of the method is called);
+             else, invocation of the delegate calls the exact specified <paramref name="typeColonName"/> (this is useful for calling base class methods)
+             Note: if <c>false</c> and <paramref name="typeColonName"/> is an interface method, an ArgumentException is thrown.
+             </param>
+             <returns>A delegate of given <typeparamref name="DelegateType"/> to given <paramref name="typeColonName"/></returns>
+             <remarks>
+             <para>
+             Delegate invocation is more performant and more convenient to use than <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])"/>
+             at a one-time setup cost.
+             </para>
+             <para>
+             Works for both type of static and instance methods, both open and closed (a.k.a. unbound and bound) instance methods,
+             and both class and struct methods.
+             </para>
+             </remarks>
+            
         </member>
         <member name="M:HarmonyLib.AccessTools.HarmonyDelegate``1(System.Object)">
              <summary>Creates a delegate for a given delegate definition, attributed with [<see cref="T:HarmonyLib.HarmonyDelegate"/>]</summary>
@@ -2508,6 +2632,412 @@
              <param name="objects">The objects</param>
              <returns>The hash code</returns>
             
+        </member>
+        <member name="T:HarmonyLib.CodeMatch">
+            <summary>A CodeInstruction match</summary>
+        </member>
+        <member name="F:HarmonyLib.CodeMatch.name">
+            <summary>The name of the match</summary>
+        </member>
+        <member name="F:HarmonyLib.CodeMatch.opcodes">
+            <summary>The matched opcodes</summary>
+        </member>
+        <member name="F:HarmonyLib.CodeMatch.operands">
+            <summary>The matched operands</summary>
+        </member>
+        <member name="F:HarmonyLib.CodeMatch.jumpsFrom">
+            <summary>The jumps from the match</summary>
+        </member>
+        <member name="F:HarmonyLib.CodeMatch.jumpsTo">
+            <summary>The jumps to the match</summary>
+        </member>
+        <member name="F:HarmonyLib.CodeMatch.predicate">
+            <summary>The match predicate</summary>
+        </member>
+        <member name="M:HarmonyLib.CodeMatch.#ctor(System.Nullable{System.Reflection.Emit.OpCode},System.Object,System.String)">
+             <summary>Creates a code match</summary>
+             <param name="opcode">The optional opcode</param>
+             <param name="operand">The optional operand</param>
+             <param name="name">The optional name</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatch.#ctor(HarmonyLib.CodeInstruction,System.String)">
+             <summary>Creates a code match</summary>
+             <param name="instruction">The CodeInstruction</param>
+             <param name="name">An optional name</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatch.#ctor(System.Func{HarmonyLib.CodeInstruction,System.Boolean},System.String)">
+             <summary>Creates a code match</summary>
+             <param name="predicate">The predicate</param>
+             <param name="name">An optional name</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatch.ToString">
+             <summary>Returns a string that represents the match</summary>
+             <returns>A string representation</returns>
+            
+        </member>
+        <member name="T:HarmonyLib.CodeMatcher">
+            <summary>A CodeInstruction matcher</summary>
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.Pos">
+             <summary>The current position</summary>
+             <value>The index or -1 if out of bounds</value>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.Length">
+             <summary>Gets the number of code instructions in this matcher</summary>
+             <value>The count</value>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.IsValid">
+             <summary>Checks whether the position of this CodeMatcher is within bounds</summary>
+             <value>True if this CodeMatcher is valid</value>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.IsInvalid">
+             <summary>Checks whether the position of this CodeMatcher is outside its bounds</summary>
+             <value>True if this CodeMatcher is invalid</value>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.Remaining">
+             <summary>Gets the remaining code instructions</summary>
+             <value>The remaining count</value>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.Opcode">
+             <summary>Gets the opcode at the current position</summary>
+             <value>The opcode</value>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.Operand">
+             <summary>Gets the operand at the current position</summary>
+             <value>The operand</value>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.Labels">
+             <summary>Gets the labels at the current position</summary>
+             <value>The labels</value>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.Blocks">
+             <summary>Gets the exception blocks at the current position</summary>
+             <value>The blocks</value>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.#ctor">
+            <summary>Creates an empty code matcher</summary>
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.#ctor(System.Collections.Generic.IEnumerable{HarmonyLib.CodeInstruction},System.Reflection.Emit.ILGenerator)">
+             <summary>Creates a code matcher from an enumeration of instructions</summary>
+             <param name="instructions">The instructions (transpiler argument)</param>
+             <param name="generator">An optional IL generator</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Clone">
+             <summary>Makes a clone of this instruction matcher</summary>
+             <returns>A copy of this matcher</returns>
+            
+        </member>
+        <member name="P:HarmonyLib.CodeMatcher.Instruction">
+             <summary>Gets instructions at the current position</summary>
+             <value>The instruction</value>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.InstructionAt(System.Int32)">
+             <summary>Gets instructions at the current position with offset</summary>
+             <param name="offset">The offset</param>
+             <returns>The instruction</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Instructions">
+             <summary>Gets all instructions</summary>
+             <returns>A list of instructions</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.InstructionEnumeration">
+             <summary>Gets all instructions as an enumeration</summary>
+             <returns>A list of instructions</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Instructions(System.Int32)">
+             <summary>Gets some instructions counting from current position</summary>
+             <param name="count">Number of instructions</param>
+             <returns>A list of instructions</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.InstructionsInRange(System.Int32,System.Int32)">
+             <summary>Gets all instructions within a range</summary>
+             <param name="start">The start index</param>
+             <param name="end">The end index</param>
+             <returns>A list of instructions</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.InstructionsWithOffsets(System.Int32,System.Int32)">
+             <summary>Gets all instructions within a range (relative to current position)</summary>
+             <param name="startOffset">The start offset</param>
+             <param name="endOffset">The end offset</param>
+             <returns>A list of instructions</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.DistinctLabels(System.Collections.Generic.IEnumerable{HarmonyLib.CodeInstruction})">
+             <summary>Gets a list of all distinct labels</summary>
+             <param name="instructions">The instructions (transpiler argument)</param>
+             <returns>A list of Labels</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.ReportFailure(System.Reflection.MethodBase,System.Action{System.String})">
+             <summary>Reports a failure</summary>
+             <param name="method">The method involved</param>
+             <param name="logger">The logger</param>
+             <returns>True if current position is invalid and error was logged</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.ThrowIfInvalid(System.String)">
+             <summary>Throw an InvalidOperationException if current state is invalid (position out of bounds / last match failed)</summary>
+             <param name="explanation">Explanation of where/why the exception was thrown that will be added to the exception message</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.ThrowIfNotMatch(System.String,HarmonyLib.CodeMatch[])">
+             <summary>Throw an InvalidOperationException if current state is invalid (position out of bounds / last match failed),
+             or if the matches do not match at current position</summary>
+             <param name="explanation">Explanation of where/why the exception was thrown that will be added to the exception message</param>
+             <param name="matches">Some code matches</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.ThrowIfNotMatchForward(System.String,HarmonyLib.CodeMatch[])">
+             <summary>Throw an InvalidOperationException if current state is invalid (position out of bounds / last match failed),
+             or if the matches do not match at any point between current position and the end</summary>
+             <param name="explanation">Explanation of where/why the exception was thrown that will be added to the exception message</param>
+             <param name="matches">Some code matches</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.ThrowIfNotMatchBack(System.String,HarmonyLib.CodeMatch[])">
+             <summary>Throw an InvalidOperationException if current state is invalid (position out of bounds / last match failed),
+             or if the matches do not match at any point between current position and the start</summary>
+             <param name="explanation">Explanation of where/why the exception was thrown that will be added to the exception message</param>
+             <param name="matches">Some code matches</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.ThrowIfFalse(System.String,System.Func{HarmonyLib.CodeMatcher,System.Boolean})">
+             <summary>Throw an InvalidOperationException if current state is invalid (position out of bounds / last match failed),
+             or if the check function returns false</summary>
+             <param name="explanation">Explanation of where/why the exception was thrown that will be added to the exception message</param>
+             <param name="stateCheckFunc">Function that checks validity of current state. If it returns false, an exception is thrown</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.SetInstruction(HarmonyLib.CodeInstruction)">
+             <summary>Sets an instruction at current position</summary>
+             <param name="instruction">The instruction to set</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.SetInstructionAndAdvance(HarmonyLib.CodeInstruction)">
+             <summary>Sets instruction at current position and advances</summary>
+             <param name="instruction">The instruction</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Set(System.Reflection.Emit.OpCode,System.Object)">
+             <summary>Sets opcode and operand at current position</summary>
+             <param name="opcode">The opcode</param>
+             <param name="operand">The operand</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.SetAndAdvance(System.Reflection.Emit.OpCode,System.Object)">
+             <summary>Sets opcode and operand at current position and advances</summary>
+             <param name="opcode">The opcode</param>
+             <param name="operand">The operand</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.SetOpcodeAndAdvance(System.Reflection.Emit.OpCode)">
+             <summary>Sets opcode at current position and advances</summary>
+             <param name="opcode">The opcode</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.SetOperandAndAdvance(System.Object)">
+             <summary>Sets operand at current position and advances</summary>
+             <param name="operand">The operand</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.CreateLabel(System.Reflection.Emit.Label@)">
+             <summary>Creates a label at current position</summary>
+             <param name="label">[out] The label</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.CreateLabelAt(System.Int32,System.Reflection.Emit.Label@)">
+             <summary>Creates a label at a position</summary>
+             <param name="position">The position</param>
+             <param name="label">[out] The new label</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.CreateLabelWithOffsets(System.Int32,System.Reflection.Emit.Label@)">
+             <summary>Creates a label at a position</summary>
+             <param name="offset">The offset</param>
+             <param name="label">[out] The new label</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.AddLabels(System.Collections.Generic.IEnumerable{System.Reflection.Emit.Label})">
+             <summary>Adds an enumeration of labels to current position</summary>
+             <param name="labels">The labels</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.AddLabelsAt(System.Int32,System.Collections.Generic.IEnumerable{System.Reflection.Emit.Label})">
+             <summary>Adds an enumeration of labels at a position</summary>
+             <param name="position">The position</param>
+             <param name="labels">The labels</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.SetJumpTo(System.Reflection.Emit.OpCode,System.Int32,System.Reflection.Emit.Label@)">
+             <summary>Sets jump to</summary>
+             <param name="opcode">Branch instruction</param>
+             <param name="destination">Destination for the jump</param>
+             <param name="label">[out] The created label</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Insert(HarmonyLib.CodeInstruction[])">
+             <summary>Inserts some instructions</summary>
+             <param name="instructions">The instructions</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Insert(System.Collections.Generic.IEnumerable{HarmonyLib.CodeInstruction})">
+             <summary>Inserts an enumeration of instructions</summary>
+             <param name="instructions">The instructions</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.InsertBranch(System.Reflection.Emit.OpCode,System.Int32)">
+             <summary>Inserts a branch</summary>
+             <param name="opcode">The branch opcode</param>
+             <param name="destination">Branch destination</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.InsertAndAdvance(HarmonyLib.CodeInstruction[])">
+             <summary>Inserts some instructions and advances the position</summary>
+             <param name="instructions">The instructions</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.InsertAndAdvance(System.Collections.Generic.IEnumerable{HarmonyLib.CodeInstruction})">
+             <summary>Inserts an enumeration of instructions and advances the position</summary>
+             <param name="instructions">The instructions</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.InsertBranchAndAdvance(System.Reflection.Emit.OpCode,System.Int32)">
+             <summary>Inserts a branch and advances the position</summary>
+             <param name="opcode">The branch opcode</param>
+             <param name="destination">Branch destination</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.RemoveInstruction">
+             <summary>Removes current instruction</summary>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.RemoveInstructions(System.Int32)">
+             <summary>Removes some instruction from current position by count</summary>
+             <param name="count">Number of instructions</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.RemoveInstructionsInRange(System.Int32,System.Int32)">
+             <summary>Removes the instructions in a range</summary>
+             <param name="start">The start</param>
+             <param name="end">The end</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.RemoveInstructionsWithOffsets(System.Int32,System.Int32)">
+             <summary>Removes the instructions in a offset range</summary>
+             <param name="startOffset">The start offset</param>
+             <param name="endOffset">The end offset</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Advance(System.Int32)">
+             <summary>Advances the current position</summary>
+             <param name="offset">The offset</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Start">
+             <summary>Moves the current position to the start</summary>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.End">
+             <summary>Moves the current position to the end</summary>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.SearchForward(System.Func{HarmonyLib.CodeInstruction,System.Boolean})">
+             <summary>Searches forward with a predicate and advances position</summary>
+             <param name="predicate">The predicate</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.SearchBackwards(System.Func{HarmonyLib.CodeInstruction,System.Boolean})">
+             <summary>Searches backwards with a predicate and reverses position</summary>
+             <param name="predicate">The predicate</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.MatchStartForward(HarmonyLib.CodeMatch[])">
+             <summary>Matches forward and advances position to beginning of matching sequence</summary>
+             <param name="matches">Some code matches</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.MatchEndForward(HarmonyLib.CodeMatch[])">
+             <summary>Matches forward and advances position to ending of matching sequence</summary>
+             <param name="matches">Some code matches</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.MatchStartBackwards(HarmonyLib.CodeMatch[])">
+             <summary>Matches backwards and reverses position to beginning of matching sequence</summary>
+             <param name="matches">Some code matches</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.MatchEndBackwards(HarmonyLib.CodeMatch[])">
+             <summary>Matches backwards and reverses position to ending of matching sequence</summary>
+             <param name="matches">Some code matches</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.Repeat(System.Action{HarmonyLib.CodeMatcher},System.Action{System.String})">
+             <summary>Repeats a match action until boundaries are met</summary>
+             <param name="matchAction">The match action</param>
+             <param name="notFoundAction">An optional action that is executed when no match is found</param>
+             <returns>The same code matcher</returns>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatcher.NamedMatch(System.String)">
+             <summary>Gets a match by its name</summary>
+             <param name="name">The match name</param>
+             <returns>An instruction</returns>
+            
         </member>
         <member name="T:HarmonyLib.GeneralExtensions">
              <summary>General extensions for common cases</summary>
@@ -2574,6 +3104,11 @@
              <summary>Extensions for <see cref="T:HarmonyLib.CodeInstruction"/></summary>
             
         </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.IsValid(System.Reflection.Emit.OpCode)">
+            <summary>Returns if an <see cref="T:System.Reflection.Emit.OpCode"/> is initialized and valid</summary>
+            <param name="code">The <see cref="T:System.Reflection.Emit.OpCode"/></param>
+            <returns></returns>
+        </member>
         <member name="M:HarmonyLib.CodeInstructionExtensions.OperandIs(HarmonyLib.CodeInstruction,System.Object)">
              <summary>Shortcut for testing whether the operand is equal to a non-null value</summary>
              <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
@@ -2715,15 +3250,15 @@
             <returns>A list of <see cref="T:System.Reflection.Emit.Label"/></returns>
         </member>
         <member name="M:HarmonyLib.CodeInstructionExtensions.MoveLabelsTo(HarmonyLib.CodeInstruction,HarmonyLib.CodeInstruction)">
-            <summary>Moves all labels from the code instruction to a different one</summary>
+            <summary>Moves all labels from the code instruction to another one</summary>
             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels from</param>
-            <param name="other">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels to</param>
+            <param name="other">The other <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels to</param>
             <returns>The code instruction labels were moved from (now empty)</returns>
         </member>
         <member name="M:HarmonyLib.CodeInstructionExtensions.MoveLabelsFrom(HarmonyLib.CodeInstruction,HarmonyLib.CodeInstruction)">
-            <summary>Moves all labels from a different code instruction to the current one</summary>
-            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels from</param>
-            <param name="other">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels to</param>
+            <summary>Moves all labels from another code instruction to the current one</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels to</param>
+            <param name="other">The other <see cref="T:HarmonyLib.CodeInstruction"/> to move the labels from</param>
             <returns>The code instruction that received the labels</returns>
         </member>
         <member name="M:HarmonyLib.CodeInstructionExtensions.WithBlocks(HarmonyLib.CodeInstruction,HarmonyLib.ExceptionBlock[])">
@@ -2744,15 +3279,15 @@
             <returns>A list of <see cref="T:HarmonyLib.ExceptionBlock"/></returns>
         </member>
         <member name="M:HarmonyLib.CodeInstructionExtensions.MoveBlocksTo(HarmonyLib.CodeInstruction,HarmonyLib.CodeInstruction)">
-            <summary>Moves all ExceptionBlocks from the code instruction to a different one</summary>
+            <summary>Moves all ExceptionBlocks from the code instruction to another one</summary>
             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks from</param>
-            <param name="other">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks to</param>
+            <param name="other">The other <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks to</param>
             <returns>The code instruction blocks were moved from (now empty)</returns>
         </member>
         <member name="M:HarmonyLib.CodeInstructionExtensions.MoveBlocksFrom(HarmonyLib.CodeInstruction,HarmonyLib.CodeInstruction)">
-            <summary>Moves all ExceptionBlocks from a different code instruction to the current one</summary>
-            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks from</param>
-            <param name="other">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks to</param>
+            <summary>Moves all ExceptionBlocks from another code instruction to the current one</summary>
+            <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks to</param>
+            <param name="other">The other <see cref="T:HarmonyLib.CodeInstruction"/> to move the ExceptionBlocks from</param>
             <returns>The code instruction that received the blocks</returns>
         </member>
         <member name="T:HarmonyLib.CollectionExtensions">
@@ -2859,6 +3394,11 @@
              <summary>Log a string directly to disk. Slower method that prevents missing information in case of a crash</summary>
              <param name="str">The string to log.</param>
             
+        </member>
+        <member name="M:HarmonyLib.FileLog.Debug(System.String)">
+             <summary>Log a string directly to disk if Harmony.DEBUG is true. Slower method that prevents missing information in case of a crash</summary>
+             <param name="str">The string to log.</param>
+            
         </member>
         <member name="M:HarmonyLib.FileLog.Reset">
              <summary>Resets and deletes the log</summary>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index ddf97fe8..0781eb40 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,8 @@
 * For mod authors:
   * Added a new `IRawTextureData` asset type.  
     _You can now load image files through `helper.ModContent` as `IRawTextureData` instead of `Texture2D`. This provides the image size and raw pixel data, which you can pass into other SMAPI APIs like `asset.AsImage().PatchImage`. This is much more efficient when you don't need a full `Texture2D` instance, since it bypasses the GPU operations needed to create one._
+  * Updated to Harmony 2.2.1 (see what's new in [2.2.0](https://github.com/pardeike/Harmony/releases/tag/v2.2.0.0) and [2.2.1](https://github.com/pardeike/Harmony/releases/tag/v2.2.1.0)).
+  * Updated dependencies (MonoMod.Common 21.6.21.1 → 22.3.5.1).
   * Removed transitional `UsePintail` option added in 3.14.0 (now always enabled).
 
 * For mod authors:
diff --git a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
index b5fc1f57..1fcda077 100644
--- a/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
+++ b/src/SMAPI/Framework/TemporaryHacks/MiniMonoModHotfix.cs
@@ -27,15 +27,6 @@ namespace MonoMod.Utils
         private static readonly object[] _NoArgs = Array.Empty<object>();
         private static readonly object?[] _CacheGetterArgs = { /* MemberListType.All */ 0, /* name apparently always null? */ null };
 
-        private static readonly Type? t_RuntimeModule =
-            typeof(Module).Assembly
-            .GetType("System.Reflection.RuntimeModule");
-
-        private static readonly PropertyInfo? p_RuntimeModule_RuntimeType =
-            typeof(Module).Assembly
-            .GetType("System.Reflection.RuntimeModule")
-            ?.GetProperty("RuntimeType", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
-
         private static readonly Type? t_RuntimeType =
             typeof(Type).Assembly
             .GetType("System.RuntimeType");
@@ -109,22 +100,6 @@ namespace MonoMod.Utils
             }
         }
 
-        public static Type? GetModuleType(this Module? module)
-        {
-            // Sadly we can't blindly resolve type 0x02000001 as the runtime throws ArgumentException.
-
-            if (module == null || t_RuntimeModule == null || !t_RuntimeModule.IsInstanceOfType(module))
-                return null;
-
-            // .NET
-            if (p_RuntimeModule_RuntimeType != null)
-                return (Type?)p_RuntimeModule_RuntimeType.GetValue(module, _NoArgs);
-
-            // The hotfix doesn't apply to Mono anyway, thus that's not copied over.
-
-            return null;
-        }
-
         public static Type? GetRealDeclaringType(this MemberInfo member)
         {
             return member.DeclaringType ?? member.Module.GetModuleType();
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 91e4c668..5bc12429 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -23,7 +23,7 @@
   <ItemGroup>
     <PackageReference Include="LargeAddressAware" Version="1.0.5" />
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
-    <PackageReference Include="MonoMod.Common" Version="21.6.21.1" />
+    <PackageReference Include="MonoMod.Common" Version="22.3.5.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="Pintail" Version="2.1.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />

From 5ffa260e02fc8a6eae40c1fd798da2a4877262c0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 26 May 2022 01:41:49 -0400
Subject: [PATCH 668/856] add validation error when loading XNB file as
 IRawTextureData

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index f0e9b1b9..44c9d8e4 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -258,6 +258,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
         private T LoadXnbFile<T>(IAssetName assetName)
         {
+            if (typeof(T) == typeof(IRawTextureData))
+                throw this.GetLoadError(assetName, ContentLoadErrorType.Other, $"can't read XNB file as type {typeof(IRawTextureData)}; that type can only be read from a PNG file.");
+
             // the underlying content manager adds a .xnb extension implicitly, so
             // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
             IAssetName loadName = assetName.Name.EndsWith(".xnb", StringComparison.OrdinalIgnoreCase)

From 2134cef74fc7549387defc639789ebc0bcb5b5db Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 27 May 2022 20:47:50 -0400
Subject: [PATCH 669/856] link to SMAPI 3.15 release highlights

---
 docs/release-notes.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0781eb40..db229ecf 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -2,6 +2,8 @@
 
 # Release notes
 ## Upcoming release
+See [release highlights](https://www.patreon.com/posts/66986798).
+
 * For players:
   * Optimized mod image file loading.
 * For mod authors:

From 4f6965eef3c7690dcfc1e1946362a84f68f40767 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 28 May 2022 15:07:19 -0400
Subject: [PATCH 670/856] encapsulate loading the raw image data for mod
 patching

---
 .../ContentManagers/ModContentManager.cs      | 53 +++++++++++++------
 1 file changed, 36 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 44c9d8e4..fb031ccb 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
 using System.IO;
 using System.Linq;
@@ -201,27 +202,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // load
             if (asRawData || this.UseRawImageLoading)
             {
-                // load raw data
-                using FileStream stream = File.OpenRead(file.FullName);
-                using SKBitmap bitmap = SKBitmap.Decode(stream);
-                SKPMColor[] rawPixels = SKPMColor.PreMultiply(bitmap.Pixels);
+                this.LoadRawImageData(file, out int width, out int height, out Color[] pixels, asRawData);
 
-                // convert to XNA pixel format
-                Color[] pixels = new Color[rawPixels.Length];
-                for (int i = pixels.Length - 1; i >= 0; i--)
-                {
-                    SKPMColor pixel = rawPixels[i];
-                    pixels[i] = pixel.Alpha == 0
-                        ? Color.Transparent
-                        : new Color(r: pixel.Red, g: pixel.Green, b: pixel.Blue, alpha: pixel.Alpha);
-                }
-
-                // create texture
                 if (asRawData)
-                    return (T)(object)new RawTextureData(bitmap.Width, bitmap.Height, pixels);
+                    return (T)(object)new RawTextureData(width, height, pixels);
                 else
                 {
-                    Texture2D texture = new(Game1.graphics.GraphicsDevice, bitmap.Width, bitmap.Height);
+                    Texture2D texture = new(Game1.graphics.GraphicsDevice, width, height);
                     texture.SetData(pixels);
                     return (T)(object)texture;
                 }
@@ -235,6 +222,38 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
         }
 
+        /// <summary>Load the raw image data from a file on disk.</summary>
+        /// <param name="file">The file whose data to load.</param>
+        /// <param name="width">The pixel width for the loaded image data.</param>
+        /// <param name="height">The pixel height for the loaded image data.</param>
+        /// <param name="pixels">The premultiplied pixel data.</param>
+        /// <param name="forRawData">Whether the data is being loaded for an <see cref="IRawTextureData"/> (true) or <see cref="Texture2D"/> (false) instance.</param>
+        /// <remarks>This is separate to let framework mods intercept the data before it's loaded, if needed.</remarks>
+        [SuppressMessage("ReSharper", "UnusedParameter.Local", Justification = "The 'forRawData' parameter is only added for mods which may intercept this method.")]
+        [SuppressMessage("Style", "IDE0060:Remove unused parameter", Justification = "The 'forRawData' parameter is only added for mods which may intercept this method.")]
+        private void LoadRawImageData(FileInfo file, out int width, out int height, out Color[] pixels, bool forRawData)
+        {
+            // load raw data
+            SKPMColor[] rawPixels;
+            {
+                using FileStream stream = File.OpenRead(file.FullName);
+                using SKBitmap bitmap = SKBitmap.Decode(stream);
+                rawPixels = SKPMColor.PreMultiply(bitmap.Pixels);
+                width = bitmap.Width;
+                height = bitmap.Height;
+            }
+
+            // convert to XNA pixel format
+            pixels = new Color[rawPixels.Length];
+            for (int i = pixels.Length - 1; i >= 0; i--)
+            {
+                SKPMColor pixel = rawPixels[i];
+                pixels[i] = pixel.Alpha == 0
+                    ? Color.Transparent
+                    : new Color(r: pixel.Red, g: pixel.Green, b: pixel.Blue, alpha: pixel.Alpha);
+            }
+        }
+
         /// <summary>Load an unpacked image file (<c>.tbin</c> or <c>.tmx</c>).</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>

From 9d21e0bbecb64243cf98e6c9a10ed5aa4ceed2bf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 28 May 2022 19:17:33 -0400
Subject: [PATCH 671/856] simplify pixel conversion loop

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index fb031ccb..e1d9ce78 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -245,7 +245,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // convert to XNA pixel format
             pixels = new Color[rawPixels.Length];
-            for (int i = pixels.Length - 1; i >= 0; i--)
+            for (int i = 0; i < pixels.Length; i++)
             {
                 SKPMColor pixel = rawPixels[i];
                 pixels[i] = pixel.Alpha == 0

From 5585f5e876459e1764e44754b5b7d933fa1456de Mon Sep 17 00:00:00 2001
From: Ameisen <14104310+ameisen@users.noreply.github.com>
Date: Sun, 29 May 2022 18:11:23 -0500
Subject: [PATCH 672/856] Refactored ModContentManager.cs so it actually fit on
 my 1440p screens. Changed LocalTilesheetExtensions into an array. Marked
 'CreateTemporary' as 'Obsolete' which is conventional for methods that only
 throw. Moved the type validation logic into its own method as it's largely
 shared for each loader. Changed allocators to use
 `GC.AllocateUninitializedArray`, as the data does not need to be initialized.
 Changed `LoadRawImageData` to use a `ValueTuple` return instead of returning
 with multiple `out`s, which is bad practice. Preferred rethrowing handlers
 rather than exception filters (which generate bizarre and _very difficult to
 patch_ code). Marked GetLoadError as debugger step through and hidden, as
 it's just an exception generator. Marked PremultiplyTransparency,
 GetContentKeyForTilesheetImageSource, and LoadRawImageData as static as they
 have no dependency on instance data (nor should they). Fixed `.xnb` extension
 search to properly use OrdinalIgnoreCase.

---
 .../ContentManagers/ModContentManager.cs      | 239 ++++++++++++++----
 1 file changed, 183 insertions(+), 56 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index e1d9ce78..fe5aaf5d 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,11 +1,11 @@
 using System;
-using System.Collections.Generic;
+using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
+using System.Drawing;
 using System.Globalization;
 using System.IO;
 using System.Linq;
 using BmFont;
-using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using SkiaSharp;
@@ -19,11 +19,12 @@ using StardewValley;
 using xTile;
 using xTile.Format;
 using xTile.Tiles;
+using Color = Microsoft.Xna.Framework.Color;
 
 namespace StardewModdingAPI.Framework.ContentManagers
 {
     /// <summary>A content manager which handles reading files from a SMAPI mod folder with support for unpacked files.</summary>
-    internal class ModContentManager : BaseContentManager
+    internal sealed class ModContentManager : BaseContentManager
     {
         /*********
         ** Fields
@@ -44,7 +45,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private readonly IFileLookup FileLookup;
 
         /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
-        private static readonly HashSet<string> LocalTilesheetExtensions = new(StringComparer.OrdinalIgnoreCase) { ".png", ".xnb" };
+        private static readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
 
 
         /*********
@@ -64,8 +65,21 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="fileLookup">A lookup for files within the <paramref name="rootDirectory"/>.</param>
         /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup, bool useRawImageLoading)
-            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
+        public ModContentManager(
+            string name,
+            IContentManager gameContentManager,
+            IServiceProvider serviceProvider,
+            string modName,
+            string rootDirectory,
+            CultureInfo currentCulture,
+            ContentCoordinator coordinator,
+            IMonitor monitor,
+            Reflector reflection,
+            JsonHelper jsonHelper,
+            Action<BaseContentManager> onDisposing,
+            IFileLookup fileLookup,
+            bool useRawImageLoading
+        ) : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
         {
             this.GameContentManager = gameContentManager;
             this.FileLookup = fileLookup;
@@ -102,7 +116,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string? contentManagerID, out IAssetName? relativePath))
                 {
                     if (contentManagerID != this.Name)
-                        throw this.GetLoadError(assetName, ContentLoadErrorType.AccessDenied, "can't load a different mod's managed asset key through this mod content manager.");
+                    {
+                        throw this.GetLoadError(
+                            assetName,
+                            ContentLoadErrorType.AccessDenied,
+                            "can't load a different mod's managed asset key through this mod content manager."
+                        );
+                    }
+
                     assetName = relativePath;
                 }
             }
@@ -127,7 +148,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     _ => this.HandleUnknownFileType<T>(assetName, file)
                 };
             }
-            catch (Exception ex) when (ex is not SContentLoadException)
+            catch (SContentLoadException)
+            {
+                throw;
+            }
+            catch (Exception ex)
             {
                 throw this.GetLoadError(assetName, ContentLoadErrorType.Other, "an unexpected error occurred.", ex);
             }
@@ -138,6 +163,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
+        [Obsolete($"Temporary {nameof(ModContentManager)}s are unsupported")]
         public override LocalizedContentManager CreateTemporary()
         {
             throw new NotSupportedException("Can't create a temporary mod content manager.");
@@ -157,6 +183,67 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
+        /// <summary>
+        /// Validates that the provided <typeparamref name="TInput">type</typeparamref> is compatible with <typeparamref name="TExpected"/>.
+        /// </summary>
+        /// <typeparam name="TInput">Type to validate compatibility of.</typeparam>
+        /// <typeparam name="TExpected">Type to validate compatibility against.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file being loaded.</param>
+        /// <param name="exception">The exception to throw if the type validation fails, otherwise <see langword="null"/>.</param>
+        /// <returns><see langword="true"/> if the type validation succeeds, otherwise <see langword="false"/></returns>
+        private bool ValidateType<TInput, TExpected>(
+            IAssetName assetName,
+            FileInfo file,
+            [NotNullWhen(false)] out SContentLoadException? exception
+        )
+        {
+            if (typeof(TInput).IsAssignableFrom(typeof(TExpected)))
+            {
+                exception = null;
+                return true;
+            }
+
+            exception = this.GetLoadError(
+                assetName,
+                ContentLoadErrorType.InvalidData,
+                $"can't read file with extension '{file.Extension}' as type '{typeof(TInput)}'; must be type '{typeof(TExpected)}'."
+            );
+            return false;
+        }
+
+        /// <summary>
+        /// Validates that the provided <typeparamref name="TInput">type</typeparamref>
+        /// is compatible with <typeparamref name="TExpected0"/> or <typeparamref name="TExpected1"/>
+        /// </summary>
+        /// <typeparam name="TInput">Type to validate compatibility of.</typeparam>
+        /// <typeparam name="TExpected0">First type to validate compatibility against.</typeparam>
+        /// /// <typeparam name="TExpected1">Second type to validate compatibility against.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file being loaded.</param>
+        /// <param name="exception">The exception to throw if the type validation fails, otherwise <see langword="null"/>.</param>
+        /// <returns><see langword="true"/> if the type validation succeeds, otherwise <see langword="false"/></returns>
+        private bool ValidateType<TInput, TExpected0, TExpected1>(
+            IAssetName assetName,
+            FileInfo file,
+            [NotNullWhen(false)] out SContentLoadException? exception
+        )
+        {
+            if (typeof(TInput).IsAssignableFrom(typeof(TExpected0)) || typeof(TInput).IsAssignableFrom(typeof(TExpected1)))
+            {
+                exception = null;
+                return true;
+            }
+
+            exception = this.GetLoadError(
+                assetName,
+                ContentLoadErrorType.InvalidData,
+                $"can't read file with extension '{file.Extension}' as type '{typeof(TInput)}'; must be type '{typeof(TExpected0)}' or '{typeof(TExpected1)}'."
+            );
+            return false;
+        }
+
+
         /// <summary>Load an unpacked font file (<c>.fnt</c>).</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
@@ -164,8 +251,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadFont<T>(IAssetName assetName, FileInfo file)
         {
             // validate
-            if (!typeof(T).IsAssignableFrom(typeof(XmlSource)))
-                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(XmlSource)}'.");
+            if (!this.ValidateType<T, XmlSource>(assetName, file, out var exception))
+            {
+                throw exception;
+            }
 
             // load
             string source = File.ReadAllText(file.FullName);
@@ -179,7 +268,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadDataFile<T>(IAssetName assetName, FileInfo file)
         {
             if (!this.JsonHelper.ReadJsonFileIfExists(file.FullName, out T? asset))
-                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, "the JSON file is invalid."); // should never happen since we check for file existence before calling this method
+            {
+                // should never happen as we check for file existence before calling this method
+                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, "the JSON file is invalid.");
+            }
 
             return asset;
         }
@@ -191,24 +283,23 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadImageFile<T>(IAssetName assetName, FileInfo file)
         {
             // validate type
-            bool asRawData = false;
-            if (typeof(T) != typeof(Texture2D))
+            if (!this.ValidateType<T, Texture2D, IRawTextureData>(assetName, file, out var exception))
             {
-                asRawData = typeof(T) == typeof(IRawTextureData);
-                if (!asRawData)
-                    throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Texture2D)}' or '{typeof(IRawTextureData)}'.");
+                throw exception;
             }
 
+            bool asRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
+
             // load
             if (asRawData || this.UseRawImageLoading)
             {
-                this.LoadRawImageData(file, out int width, out int height, out Color[] pixels, asRawData);
+                (Size size, Color[] pixels) = ModContentManager.LoadRawImageData(file, asRawData);
 
                 if (asRawData)
-                    return (T)(object)new RawTextureData(width, height, pixels);
+                    return (T)(object)new RawTextureData(size.Width, size.Height, pixels);
                 else
                 {
-                    Texture2D texture = new(Game1.graphics.GraphicsDevice, width, height);
+                    Texture2D texture = new(Game1.graphics.GraphicsDevice, size.Width, size.Height);
                     texture.SetData(pixels);
                     return (T)(object)texture;
                 }
@@ -217,34 +308,32 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 using FileStream stream = File.OpenRead(file.FullName);
                 Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream);
-                texture = this.PremultiplyTransparency(texture);
+                texture = ModContentManager.PremultiplyTransparency(texture);
                 return (T)(object)texture;
             }
         }
 
         /// <summary>Load the raw image data from a file on disk.</summary>
         /// <param name="file">The file whose data to load.</param>
-        /// <param name="width">The pixel width for the loaded image data.</param>
-        /// <param name="height">The pixel height for the loaded image data.</param>
-        /// <param name="pixels">The premultiplied pixel data.</param>
         /// <param name="forRawData">Whether the data is being loaded for an <see cref="IRawTextureData"/> (true) or <see cref="Texture2D"/> (false) instance.</param>
         /// <remarks>This is separate to let framework mods intercept the data before it's loaded, if needed.</remarks>
         [SuppressMessage("ReSharper", "UnusedParameter.Local", Justification = "The 'forRawData' parameter is only added for mods which may intercept this method.")]
         [SuppressMessage("Style", "IDE0060:Remove unused parameter", Justification = "The 'forRawData' parameter is only added for mods which may intercept this method.")]
-        private void LoadRawImageData(FileInfo file, out int width, out int height, out Color[] pixels, bool forRawData)
+        private static (Size Size, Color[] Data) LoadRawImageData(FileInfo file, bool forRawData)
         {
+            Size size;
+
             // load raw data
             SKPMColor[] rawPixels;
             {
                 using FileStream stream = File.OpenRead(file.FullName);
                 using SKBitmap bitmap = SKBitmap.Decode(stream);
                 rawPixels = SKPMColor.PreMultiply(bitmap.Pixels);
-                width = bitmap.Width;
-                height = bitmap.Height;
+                size = new(bitmap.Width, bitmap.Height);
             }
 
             // convert to XNA pixel format
-            pixels = new Color[rawPixels.Length];
+            var pixels = GC.AllocateUninitializedArray<Color>(rawPixels.Length);
             for (int i = 0; i < pixels.Length; i++)
             {
                 SKPMColor pixel = rawPixels[i];
@@ -252,6 +341,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     ? Color.Transparent
                     : new Color(r: pixel.Red, g: pixel.Green, b: pixel.Blue, alpha: pixel.Alpha);
             }
+
+            return (size, pixels);
         }
 
         /// <summary>Load an unpacked image file (<c>.tbin</c> or <c>.tmx</c>).</summary>
@@ -261,8 +352,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadMapFile<T>(IAssetName assetName, FileInfo file)
         {
             // validate
-            if (typeof(T) != typeof(Map))
-                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(T)}'; must be type '{typeof(Map)}'.");
+            if (!this.ValidateType<T, Map>(assetName, file, out var exception))
+            {
+                throw exception;
+            }
 
             // load
             FormatManager formatManager = FormatManager.Instance;
@@ -277,8 +370,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
         private T LoadXnbFile<T>(IAssetName assetName)
         {
-            if (typeof(T) == typeof(IRawTextureData))
-                throw this.GetLoadError(assetName, ContentLoadErrorType.Other, $"can't read XNB file as type {typeof(IRawTextureData)}; that type can only be read from a PNG file.");
+            if (typeof(IRawTextureData).IsAssignableFrom(typeof(T)))
+            {
+                throw this.GetLoadError(
+                    assetName,
+                    ContentLoadErrorType.Other,
+                    $"can't read XNB file as type {typeof(IRawTextureData)}; that type can only be read from a PNG file."
+                );
+            }
 
             // the underlying content manager adds a .xnb extension implicitly, so
             // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
@@ -303,7 +402,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file to load.</param>
         private T HandleUnknownFileType<T>(IAssetName assetName, FileInfo file)
         {
-            throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidName, $"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'.");
+            throw this.GetLoadError(
+                assetName,
+                ContentLoadErrorType.InvalidName,
+                $"unknown file extension '{file.Extension}'; must be one of: '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'."
+            );
         }
 
         /// <summary>Get an error which indicates that an asset couldn't be loaded.</summary>
@@ -311,6 +414,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="assetName">The asset name that failed to load.</param>
         /// <param name="reasonPhrase">The reason the file couldn't be loaded.</param>
         /// <param name="exception">The underlying exception, if applicable.</param>
+        [DebuggerStepThrough, DebuggerHidden]
         private SContentLoadException GetLoadError(IAssetName assetName, ContentLoadErrorType errorType, string reasonPhrase, Exception? exception = null)
         {
             return new(errorType, $"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);
@@ -325,16 +429,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
             FileInfo file = this.FileLookup.GetFile(path);
 
             // try with default image extensions
-            if (!file.Exists && typeof(Texture2D).IsAssignableFrom(typeof(T)) && !ModContentManager.LocalTilesheetExtensions.Contains(file.Extension))
+            if (file.Exists || !typeof(Texture2D).IsAssignableFrom(typeof(T)) || ModContentManager.LocalTilesheetExtensions.Contains(file.Extension))
+                return file;
+
+            foreach (string extension in ModContentManager.LocalTilesheetExtensions)
             {
-                foreach (string extension in ModContentManager.LocalTilesheetExtensions)
+                FileInfo result = new(file.FullName + extension);
+                if (result.Exists)
                 {
-                    FileInfo result = new(file.FullName + extension);
-                    if (result.Exists)
-                    {
-                        file = result;
-                        break;
-                    }
+                    file = result;
+                    break;
                 }
             }
 
@@ -345,10 +449,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="texture">The texture to premultiply.</param>
         /// <returns>Returns a premultiplied texture.</returns>
         /// <remarks>Based on <a href="https://gamedev.stackexchange.com/a/26037">code by David Gouveia</a>.</remarks>
-        private Texture2D PremultiplyTransparency(Texture2D texture)
+        private static Texture2D PremultiplyTransparency(Texture2D texture)
         {
             // premultiply pixels
-            Color[] data = new Color[texture.Width * texture.Height];
+            Color[] data = GC.AllocateUninitializedArray<Color>(texture.Width * texture.Height);
             texture.GetData(data);
             bool changed = false;
             for (int i = 0; i < data.Length; i++)
@@ -357,7 +461,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (pixel.A is (byte.MinValue or byte.MaxValue))
                     continue; // no need to change fully transparent/opaque pixels
 
-                data[i] = new Color(pixel.R * pixel.A / byte.MaxValue, pixel.G * pixel.A / byte.MaxValue, pixel.B * pixel.A / byte.MaxValue, pixel.A); // slower version: Color.FromNonPremultiplied(data[i].ToVector4())
+                data[i] = new Color(
+                    pixel.R * pixel.A / byte.MaxValue,
+                    pixel.G * pixel.A / byte.MaxValue,
+                    pixel.B * pixel.A / byte.MaxValue,
+                    pixel.A
+                ); // slower version: Color.FromNonPremultiplied(data[i].ToVector4())
                 changed = true;
             }
 
@@ -370,7 +479,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Fix custom map tilesheet paths so they can be found by the content manager.</summary>
         /// <param name="map">The map whose tilesheets to fix.</param>
         /// <param name="relativeMapPath">The relative map path within the mod folder.</param>
-        /// <param name="fixEagerPathPrefixes">Whether to undo the game's eager tilesheet path prefixing for maps loaded from an <c>.xnb</c> file, which incorrectly prefixes tilesheet paths with the map's local asset key folder.</param>
+        /// <param name="fixEagerPathPrefixes">
+        /// Whether to undo the game's eager tilesheet path prefixing for maps loaded from an <c>.xnb</c> file,
+        /// which incorrectly prefixes tilesheet paths with the map's local asset key folder.
+        /// </param>
         /// <exception cref="ContentLoadException">A map tilesheet couldn't be resolved.</exception>
         private void FixTilesheetPaths(Map map, string relativeMapPath, bool fixEagerPathPrefixes)
         {
@@ -388,18 +500,28 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
                 // reverse incorrect eager tilesheet path prefixing
                 if (fixEagerPathPrefixes && relativeMapFolder.Length > 0 && imageSource.StartsWith(relativeMapFolder))
-                    imageSource = imageSource.Substring(relativeMapFolder.Length + 1);
+                    imageSource = imageSource[(relativeMapFolder.Length + 1)..];
 
                 // validate tilesheet path
                 string errorPrefix = $"{this.ModName} loaded map '{relativeMapPath}' with invalid tilesheet path '{imageSource}'.";
                 if (Path.IsPathRooted(imageSource) || PathUtilities.GetSegments(imageSource).Contains(".."))
-                    throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} Tilesheet paths must be a relative path without directory climbing (../).");
+                {
+                    throw new SContentLoadException(
+                        ContentLoadErrorType.InvalidData,
+                        $"{errorPrefix} Tilesheet paths must be a relative path without directory climbing (../)."
+                    );
+                }
 
                 // load best match
                 try
                 {
                     if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out IAssetName? assetName, out string? error))
-                        throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} {error}");
+                    {
+                        throw new SContentLoadException(
+                            ContentLoadErrorType.InvalidData,
+                            $"{errorPrefix} {error}"
+                        );
+                    }
 
                     if (assetName is not null)
                     {
@@ -409,7 +531,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         tilesheet.ImageSource = assetName.Name;
                     }
                 }
-                catch (Exception ex) when (ex is not SContentLoadException)
+                catch (SContentLoadException)
+                {
+                    throw;
+                }
+                catch (Exception ex)
                 {
                     throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} The tilesheet couldn't be loaded.", ex);
                 }
@@ -425,7 +551,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <remarks>See remarks on <see cref="FixTilesheetPaths"/>.</remarks>
         private bool TryGetTilesheetAssetName(string modRelativeMapFolder, string relativePath, out IAssetName? assetName, out string? error)
         {
-            assetName = null;
             error = null;
 
             // nothing to do
@@ -440,7 +565,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // opened in Tiled, while still mapping it to the vanilla 'Maps/spring_town' asset at runtime.
             {
                 string filename = Path.GetFileName(relativePath);
-                if (filename.StartsWith("."))
+                if (filename.StartsWith('.'))
                     relativePath = Path.Combine(Path.GetDirectoryName(relativePath) ?? "", filename.TrimStart('.'));
             }
 
@@ -455,10 +580,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // get from game assets
-            IAssetName contentKey = this.Coordinator.ParseAssetName(this.GetContentKeyForTilesheetImageSource(relativePath), allowLocales: false);
+            AssetName contentKey = this.Coordinator.ParseAssetName(ModContentManager.GetContentKeyForTilesheetImageSource(relativePath), allowLocales: false);
             try
             {
-                this.GameContentManager.LoadLocalized<Texture2D>(contentKey, this.GameContentManager.Language, useCache: true); // no need to bypass cache here, since we're not storing the asset
+                // no need to bypass cache here, since we're not storing the asset
+                this.GameContentManager.LoadLocalized<Texture2D>(contentKey, this.GameContentManager.Language, useCache: true);
                 assetName = contentKey;
                 return true;
             }
@@ -476,6 +602,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // not found
+            assetName = null;
             error = "The tilesheet couldn't be found relative to either map file or the game's content folder.";
             return false;
         }
@@ -486,16 +613,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // get file path
             string path = Path.Combine(this.GameContentManager.FullRootDirectory, key);
-            if (!path.EndsWith(".xnb"))
+            if (!path.EndsWith(".xnb", StringComparison.OrdinalIgnoreCase))
                 path += ".xnb";
 
             // get file
-            return new FileInfo(path).Exists;
+            return File.Exists(path);
         }
 
         /// <summary>Get the asset key for a tilesheet in the game's <c>Maps</c> content folder.</summary>
         /// <param name="relativePath">The tilesheet image source.</param>
-        private string GetContentKeyForTilesheetImageSource(string relativePath)
+        private static string GetContentKeyForTilesheetImageSource(string relativePath)
         {
             string key = relativePath;
             string topFolder = PathUtilities.GetSegments(key, limit: 2)[0];
@@ -506,7 +633,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
             // remove file extension from unpacked file
             if (key.EndsWith(".png", StringComparison.OrdinalIgnoreCase))
-                key = key.Substring(0, key.Length - 4);
+                key = key[..^4];
 
             return key;
         }

From 87c7095e8d7bfc1c1819e7d17cfea3d07c65dfea Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 30 May 2022 01:22:50 -0400
Subject: [PATCH 673/856] apply style conventions

---
 .../ContentManagers/ModContentManager.cs      | 155 +++++-------------
 1 file changed, 37 insertions(+), 118 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index fe5aaf5d..d4a30f71 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -65,21 +65,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="fileLookup">A lookup for files within the <paramref name="rootDirectory"/>.</param>
         /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
-        public ModContentManager(
-            string name,
-            IContentManager gameContentManager,
-            IServiceProvider serviceProvider,
-            string modName,
-            string rootDirectory,
-            CultureInfo currentCulture,
-            ContentCoordinator coordinator,
-            IMonitor monitor,
-            Reflector reflection,
-            JsonHelper jsonHelper,
-            Action<BaseContentManager> onDisposing,
-            IFileLookup fileLookup,
-            bool useRawImageLoading
-        ) : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup, bool useRawImageLoading)
+            : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
         {
             this.GameContentManager = gameContentManager;
             this.FileLookup = fileLookup;
@@ -116,14 +103,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string? contentManagerID, out IAssetName? relativePath))
                 {
                     if (contentManagerID != this.Name)
-                    {
-                        throw this.GetLoadError(
-                            assetName,
-                            ContentLoadErrorType.AccessDenied,
-                            "can't load a different mod's managed asset key through this mod content manager."
-                        );
-                    }
-
+                        throw this.GetLoadError(assetName, ContentLoadErrorType.AccessDenied, "can't load a different mod's managed asset key through this mod content manager.");
                     assetName = relativePath;
                 }
             }
@@ -148,12 +128,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     _ => this.HandleUnknownFileType<T>(assetName, file)
                 };
             }
-            catch (SContentLoadException)
-            {
-                throw;
-            }
             catch (Exception ex)
             {
+                if (ex is SContentLoadException)
+                    throw;
+
                 throw this.GetLoadError(assetName, ContentLoadErrorType.Other, "an unexpected error occurred.", ex);
             }
 
@@ -183,20 +162,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
-        /// <summary>
-        /// Validates that the provided <typeparamref name="TInput">type</typeparamref> is compatible with <typeparamref name="TExpected"/>.
-        /// </summary>
+        /// <summary>Validates that the provided <typeparamref name="TInput">type</typeparamref> is compatible with <typeparamref name="TExpected"/>.</summary>
         /// <typeparam name="TInput">Type to validate compatibility of.</typeparam>
         /// <typeparam name="TExpected">Type to validate compatibility against.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
         /// <param name="file">The file being loaded.</param>
         /// <param name="exception">The exception to throw if the type validation fails, otherwise <see langword="null"/>.</param>
         /// <returns><see langword="true"/> if the type validation succeeds, otherwise <see langword="false"/></returns>
-        private bool ValidateType<TInput, TExpected>(
-            IAssetName assetName,
-            FileInfo file,
-            [NotNullWhen(false)] out SContentLoadException? exception
-        )
+        private bool ValidateType<TInput, TExpected>(IAssetName assetName, FileInfo file, [NotNullWhen(false)] out SContentLoadException? exception)
         {
             if (typeof(TInput).IsAssignableFrom(typeof(TExpected)))
             {
@@ -204,18 +177,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return true;
             }
 
-            exception = this.GetLoadError(
-                assetName,
-                ContentLoadErrorType.InvalidData,
-                $"can't read file with extension '{file.Extension}' as type '{typeof(TInput)}'; must be type '{typeof(TExpected)}'."
-            );
+            exception = this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(TInput)}'; must be type '{typeof(TExpected)}'.");
             return false;
         }
 
-        /// <summary>
-        /// Validates that the provided <typeparamref name="TInput">type</typeparamref>
-        /// is compatible with <typeparamref name="TExpected0"/> or <typeparamref name="TExpected1"/>
-        /// </summary>
+        /// <summary>Validates that the provided <typeparamref name="TInput">type</typeparamref> is compatible with <typeparamref name="TExpected0"/> or <typeparamref name="TExpected1"/>.</summary>
         /// <typeparam name="TInput">Type to validate compatibility of.</typeparam>
         /// <typeparam name="TExpected0">First type to validate compatibility against.</typeparam>
         /// /// <typeparam name="TExpected1">Second type to validate compatibility against.</typeparam>
@@ -223,11 +189,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file being loaded.</param>
         /// <param name="exception">The exception to throw if the type validation fails, otherwise <see langword="null"/>.</param>
         /// <returns><see langword="true"/> if the type validation succeeds, otherwise <see langword="false"/></returns>
-        private bool ValidateType<TInput, TExpected0, TExpected1>(
-            IAssetName assetName,
-            FileInfo file,
-            [NotNullWhen(false)] out SContentLoadException? exception
-        )
+        private bool ValidateType<TInput, TExpected0, TExpected1>(IAssetName assetName, FileInfo file, [NotNullWhen(false)] out SContentLoadException? exception)
         {
             if (typeof(TInput).IsAssignableFrom(typeof(TExpected0)) || typeof(TInput).IsAssignableFrom(typeof(TExpected1)))
             {
@@ -235,11 +197,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 return true;
             }
 
-            exception = this.GetLoadError(
-                assetName,
-                ContentLoadErrorType.InvalidData,
-                $"can't read file with extension '{file.Extension}' as type '{typeof(TInput)}'; must be type '{typeof(TExpected0)}' or '{typeof(TExpected1)}'."
-            );
+            exception = this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(TInput)}'; must be type '{typeof(TExpected0)}' or '{typeof(TExpected1)}'.");
             return false;
         }
 
@@ -252,9 +210,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // validate
             if (!this.ValidateType<T, XmlSource>(assetName, file, out var exception))
-            {
                 throw exception;
-            }
 
             // load
             string source = File.ReadAllText(file.FullName);
@@ -268,10 +224,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadDataFile<T>(IAssetName assetName, FileInfo file)
         {
             if (!this.JsonHelper.ReadJsonFileIfExists(file.FullName, out T? asset))
-            {
-                // should never happen as we check for file existence before calling this method
-                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, "the JSON file is invalid.");
-            }
+                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, "the JSON file is invalid."); // should never happen since we check for file existence before calling this method
 
             return asset;
         }
@@ -284,16 +237,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // validate type
             if (!this.ValidateType<T, Texture2D, IRawTextureData>(assetName, file, out var exception))
-            {
                 throw exception;
-            }
 
             bool asRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
 
             // load
             if (asRawData || this.UseRawImageLoading)
             {
-                (Size size, Color[] pixels) = ModContentManager.LoadRawImageData(file, asRawData);
+                (Size size, Color[] pixels) = this.LoadRawImageData(file, asRawData);
 
                 if (asRawData)
                     return (T)(object)new RawTextureData(size.Width, size.Height, pixels);
@@ -308,7 +259,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 using FileStream stream = File.OpenRead(file.FullName);
                 Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream);
-                texture = ModContentManager.PremultiplyTransparency(texture);
+                texture = this.PremultiplyTransparency(texture);
                 return (T)(object)texture;
             }
         }
@@ -319,7 +270,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <remarks>This is separate to let framework mods intercept the data before it's loaded, if needed.</remarks>
         [SuppressMessage("ReSharper", "UnusedParameter.Local", Justification = "The 'forRawData' parameter is only added for mods which may intercept this method.")]
         [SuppressMessage("Style", "IDE0060:Remove unused parameter", Justification = "The 'forRawData' parameter is only added for mods which may intercept this method.")]
-        private static (Size Size, Color[] Data) LoadRawImageData(FileInfo file, bool forRawData)
+        private (Size Size, Color[] Data) LoadRawImageData(FileInfo file, bool forRawData)
         {
             Size size;
 
@@ -353,9 +304,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // validate
             if (!this.ValidateType<T, Map>(assetName, file, out var exception))
-            {
                 throw exception;
-            }
 
             // load
             FormatManager formatManager = FormatManager.Instance;
@@ -371,13 +320,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadXnbFile<T>(IAssetName assetName)
         {
             if (typeof(IRawTextureData).IsAssignableFrom(typeof(T)))
-            {
-                throw this.GetLoadError(
-                    assetName,
-                    ContentLoadErrorType.Other,
-                    $"can't read XNB file as type {typeof(IRawTextureData)}; that type can only be read from a PNG file."
-                );
-            }
+                throw this.GetLoadError(assetName, ContentLoadErrorType.Other, $"can't read XNB file as type {typeof(IRawTextureData)}; that type can only be read from a PNG file.");
 
             // the underlying content manager adds a .xnb extension implicitly, so
             // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
@@ -402,11 +345,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file to load.</param>
         private T HandleUnknownFileType<T>(IAssetName assetName, FileInfo file)
         {
-            throw this.GetLoadError(
-                assetName,
-                ContentLoadErrorType.InvalidName,
-                $"unknown file extension '{file.Extension}'; must be one of: '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'."
-            );
+            throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidName, $"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'.");
         }
 
         /// <summary>Get an error which indicates that an asset couldn't be loaded.</summary>
@@ -429,16 +368,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
             FileInfo file = this.FileLookup.GetFile(path);
 
             // try with default image extensions
-            if (file.Exists || !typeof(Texture2D).IsAssignableFrom(typeof(T)) || ModContentManager.LocalTilesheetExtensions.Contains(file.Extension))
-                return file;
-
-            foreach (string extension in ModContentManager.LocalTilesheetExtensions)
+            if (!file.Exists && typeof(Texture2D).IsAssignableFrom(typeof(T)) && !ModContentManager.LocalTilesheetExtensions.Contains(file.Extension))
             {
-                FileInfo result = new(file.FullName + extension);
-                if (result.Exists)
+                foreach (string extension in ModContentManager.LocalTilesheetExtensions)
                 {
-                    file = result;
-                    break;
+                    FileInfo result = new(file.FullName + extension);
+                    if (result.Exists)
+                    {
+                        file = result;
+                        break;
+                    }
                 }
             }
 
@@ -449,7 +388,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="texture">The texture to premultiply.</param>
         /// <returns>Returns a premultiplied texture.</returns>
         /// <remarks>Based on <a href="https://gamedev.stackexchange.com/a/26037">code by David Gouveia</a>.</remarks>
-        private static Texture2D PremultiplyTransparency(Texture2D texture)
+        private Texture2D PremultiplyTransparency(Texture2D texture)
         {
             // premultiply pixels
             Color[] data = GC.AllocateUninitializedArray<Color>(texture.Width * texture.Height);
@@ -461,12 +400,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (pixel.A is (byte.MinValue or byte.MaxValue))
                     continue; // no need to change fully transparent/opaque pixels
 
-                data[i] = new Color(
-                    pixel.R * pixel.A / byte.MaxValue,
-                    pixel.G * pixel.A / byte.MaxValue,
-                    pixel.B * pixel.A / byte.MaxValue,
-                    pixel.A
-                ); // slower version: Color.FromNonPremultiplied(data[i].ToVector4())
+                data[i] = new Color(pixel.R * pixel.A / byte.MaxValue, pixel.G * pixel.A / byte.MaxValue, pixel.B * pixel.A / byte.MaxValue, pixel.A); // slower version: Color.FromNonPremultiplied(data[i].ToVector4())
                 changed = true;
             }
 
@@ -479,10 +413,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>Fix custom map tilesheet paths so they can be found by the content manager.</summary>
         /// <param name="map">The map whose tilesheets to fix.</param>
         /// <param name="relativeMapPath">The relative map path within the mod folder.</param>
-        /// <param name="fixEagerPathPrefixes">
-        /// Whether to undo the game's eager tilesheet path prefixing for maps loaded from an <c>.xnb</c> file,
-        /// which incorrectly prefixes tilesheet paths with the map's local asset key folder.
-        /// </param>
+        /// <param name="fixEagerPathPrefixes">Whether to undo the game's eager tilesheet path prefixing for maps loaded from an <c>.xnb</c> file, which incorrectly prefixes tilesheet paths with the map's local asset key folder.</param>
         /// <exception cref="ContentLoadException">A map tilesheet couldn't be resolved.</exception>
         private void FixTilesheetPaths(Map map, string relativeMapPath, bool fixEagerPathPrefixes)
         {
@@ -505,23 +436,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // validate tilesheet path
                 string errorPrefix = $"{this.ModName} loaded map '{relativeMapPath}' with invalid tilesheet path '{imageSource}'.";
                 if (Path.IsPathRooted(imageSource) || PathUtilities.GetSegments(imageSource).Contains(".."))
-                {
-                    throw new SContentLoadException(
-                        ContentLoadErrorType.InvalidData,
-                        $"{errorPrefix} Tilesheet paths must be a relative path without directory climbing (../)."
-                    );
-                }
+                    throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} Tilesheet paths must be a relative path without directory climbing (../).");
 
                 // load best match
                 try
                 {
                     if (!this.TryGetTilesheetAssetName(relativeMapFolder, imageSource, out IAssetName? assetName, out string? error))
-                    {
-                        throw new SContentLoadException(
-                            ContentLoadErrorType.InvalidData,
-                            $"{errorPrefix} {error}"
-                        );
-                    }
+                        throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} {error}");
 
                     if (assetName is not null)
                     {
@@ -531,12 +452,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                         tilesheet.ImageSource = assetName.Name;
                     }
                 }
-                catch (SContentLoadException)
-                {
-                    throw;
-                }
                 catch (Exception ex)
                 {
+                    if (ex is SContentLoadException)
+                        throw;
+
                     throw new SContentLoadException(ContentLoadErrorType.InvalidData, $"{errorPrefix} The tilesheet couldn't be loaded.", ex);
                 }
             }
@@ -580,11 +500,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             // get from game assets
-            AssetName contentKey = this.Coordinator.ParseAssetName(ModContentManager.GetContentKeyForTilesheetImageSource(relativePath), allowLocales: false);
+            AssetName contentKey = this.Coordinator.ParseAssetName(this.GetContentKeyForTilesheetImageSource(relativePath), allowLocales: false);
             try
             {
-                // no need to bypass cache here, since we're not storing the asset
-                this.GameContentManager.LoadLocalized<Texture2D>(contentKey, this.GameContentManager.Language, useCache: true);
+                this.GameContentManager.LoadLocalized<Texture2D>(contentKey, this.GameContentManager.Language, useCache: true); // no need to bypass cache here, since we're not storing the asset
                 assetName = contentKey;
                 return true;
             }
@@ -622,7 +541,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
         /// <summary>Get the asset key for a tilesheet in the game's <c>Maps</c> content folder.</summary>
         /// <param name="relativePath">The tilesheet image source.</param>
-        private static string GetContentKeyForTilesheetImageSource(string relativePath)
+        private string GetContentKeyForTilesheetImageSource(string relativePath)
         {
             string key = relativePath;
             string topFolder = PathUtilities.GetSegments(key, limit: 2)[0];

From ba7f5701def491f66b3e14aa5990eba521dfcf7c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 30 May 2022 01:22:50 -0400
Subject: [PATCH 674/856] simplify asset type validaiton

---
 .../ContentManagers/ModContentManager.cs      | 67 +++++--------------
 1 file changed, 15 insertions(+), 52 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index d4a30f71..1f38b76b 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -162,57 +162,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Private methods
         *********/
-        /// <summary>Validates that the provided <typeparamref name="TInput">type</typeparamref> is compatible with <typeparamref name="TExpected"/>.</summary>
-        /// <typeparam name="TInput">Type to validate compatibility of.</typeparam>
-        /// <typeparam name="TExpected">Type to validate compatibility against.</typeparam>
-        /// <param name="assetName">The asset name relative to the loader root directory.</param>
-        /// <param name="file">The file being loaded.</param>
-        /// <param name="exception">The exception to throw if the type validation fails, otherwise <see langword="null"/>.</param>
-        /// <returns><see langword="true"/> if the type validation succeeds, otherwise <see langword="false"/></returns>
-        private bool ValidateType<TInput, TExpected>(IAssetName assetName, FileInfo file, [NotNullWhen(false)] out SContentLoadException? exception)
-        {
-            if (typeof(TInput).IsAssignableFrom(typeof(TExpected)))
-            {
-                exception = null;
-                return true;
-            }
-
-            exception = this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(TInput)}'; must be type '{typeof(TExpected)}'.");
-            return false;
-        }
-
-        /// <summary>Validates that the provided <typeparamref name="TInput">type</typeparamref> is compatible with <typeparamref name="TExpected0"/> or <typeparamref name="TExpected1"/>.</summary>
-        /// <typeparam name="TInput">Type to validate compatibility of.</typeparam>
-        /// <typeparam name="TExpected0">First type to validate compatibility against.</typeparam>
-        /// /// <typeparam name="TExpected1">Second type to validate compatibility against.</typeparam>
-        /// <param name="assetName">The asset name relative to the loader root directory.</param>
-        /// <param name="file">The file being loaded.</param>
-        /// <param name="exception">The exception to throw if the type validation fails, otherwise <see langword="null"/>.</param>
-        /// <returns><see langword="true"/> if the type validation succeeds, otherwise <see langword="false"/></returns>
-        private bool ValidateType<TInput, TExpected0, TExpected1>(IAssetName assetName, FileInfo file, [NotNullWhen(false)] out SContentLoadException? exception)
-        {
-            if (typeof(TInput).IsAssignableFrom(typeof(TExpected0)) || typeof(TInput).IsAssignableFrom(typeof(TExpected1)))
-            {
-                exception = null;
-                return true;
-            }
-
-            exception = this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(TInput)}'; must be type '{typeof(TExpected0)}' or '{typeof(TExpected1)}'.");
-            return false;
-        }
-
-
         /// <summary>Load an unpacked font file (<c>.fnt</c>).</summary>
         /// <typeparam name="T">The type of asset to load.</typeparam>
         /// <param name="assetName">The asset name relative to the loader root directory.</param>
         /// <param name="file">The file to load.</param>
         private T LoadFont<T>(IAssetName assetName, FileInfo file)
         {
-            // validate
-            if (!this.ValidateType<T, XmlSource>(assetName, file, out var exception))
-                throw exception;
+            this.AssertValidType<T>(assetName, file, typeof(XmlSource));
 
-            // load
             string source = File.ReadAllText(file.FullName);
             return (T)(object)new XmlSource(source);
         }
@@ -235,10 +192,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file to load.</param>
         private T LoadImageFile<T>(IAssetName assetName, FileInfo file)
         {
-            // validate type
-            if (!this.ValidateType<T, Texture2D, IRawTextureData>(assetName, file, out var exception))
-                throw exception;
-
+            this.AssertValidType<T>(assetName, file, typeof(Texture2D), typeof(IRawTextureData));
             bool asRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
 
             // load
@@ -302,11 +256,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file to load.</param>
         private T LoadMapFile<T>(IAssetName assetName, FileInfo file)
         {
-            // validate
-            if (!this.ValidateType<T, Map>(assetName, file, out var exception))
-                throw exception;
+            this.AssertValidType<T>(assetName, file, typeof(Map));
 
-            // load
             FormatManager formatManager = FormatManager.Instance;
             Map map = formatManager.LoadMap(file.FullName);
             map.assetPath = assetName.Name;
@@ -348,6 +299,18 @@ namespace StardewModdingAPI.Framework.ContentManagers
             throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidName, $"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'.");
         }
 
+        /// <summary>Assert that the asset type is compatible with one of the allowed types.</summary>
+        /// <typeparam name="TAsset">The actual asset type.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file being loaded.</param>
+        /// <param name="validTypes">The allowed asset types.</param>
+        /// <exception cref="SContentLoadException">The <typeparamref name="TAsset"/> is not compatible with any of the <paramref name="validTypes"/>.</exception>
+        private void AssertValidType<TAsset>(IAssetName assetName, FileInfo file, params Type[] validTypes)
+        {
+            if (!validTypes.Any(validType => validType.IsAssignableFrom(typeof(TAsset))))
+                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(TAsset)}'; must be type '{string.Join("' or '", validTypes.Select(p => p.FullName))}'.");
+        }
+
         /// <summary>Get an error which indicates that an asset couldn't be loaded.</summary>
         /// <param name="errorType">Why loading an asset through the content pipeline failed.</param>
         /// <param name="assetName">The asset name that failed to load.</param>

From 565677c18ca4e12a2d8635b4ea2db49255d28142 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 30 May 2022 01:22:51 -0400
Subject: [PATCH 675/856] use IRawTextureData instead of intermediate tuple

---
 .../ContentManagers/ModContentManager.cs      | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 1f38b76b..160e3c19 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,11 +1,11 @@
 using System;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
-using System.Drawing;
 using System.Globalization;
 using System.IO;
 using System.Linq;
 using BmFont;
+using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using SkiaSharp;
@@ -19,7 +19,6 @@ using StardewValley;
 using xTile;
 using xTile.Format;
 using xTile.Tiles;
-using Color = Microsoft.Xna.Framework.Color;
 
 namespace StardewModdingAPI.Framework.ContentManagers
 {
@@ -198,14 +197,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // load
             if (asRawData || this.UseRawImageLoading)
             {
-                (Size size, Color[] pixels) = this.LoadRawImageData(file, asRawData);
+                IRawTextureData raw = this.LoadRawImageData(file, asRawData);
 
                 if (asRawData)
-                    return (T)(object)new RawTextureData(size.Width, size.Height, pixels);
+                    return (T)raw;
                 else
                 {
-                    Texture2D texture = new(Game1.graphics.GraphicsDevice, size.Width, size.Height);
-                    texture.SetData(pixels);
+                    Texture2D texture = new(Game1.graphics.GraphicsDevice, raw.Width, raw.Height);
+                    texture.SetData(raw.Data);
                     return (T)(object)texture;
                 }
             }
@@ -224,17 +223,18 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <remarks>This is separate to let framework mods intercept the data before it's loaded, if needed.</remarks>
         [SuppressMessage("ReSharper", "UnusedParameter.Local", Justification = "The 'forRawData' parameter is only added for mods which may intercept this method.")]
         [SuppressMessage("Style", "IDE0060:Remove unused parameter", Justification = "The 'forRawData' parameter is only added for mods which may intercept this method.")]
-        private (Size Size, Color[] Data) LoadRawImageData(FileInfo file, bool forRawData)
+        private IRawTextureData LoadRawImageData(FileInfo file, bool forRawData)
         {
-            Size size;
-
             // load raw data
+            int width;
+            int height;
             SKPMColor[] rawPixels;
             {
                 using FileStream stream = File.OpenRead(file.FullName);
                 using SKBitmap bitmap = SKBitmap.Decode(stream);
                 rawPixels = SKPMColor.PreMultiply(bitmap.Pixels);
-                size = new(bitmap.Width, bitmap.Height);
+                width = bitmap.Width;
+                height = bitmap.Height;
             }
 
             // convert to XNA pixel format
@@ -247,7 +247,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     : new Color(r: pixel.Red, g: pixel.Green, b: pixel.Blue, alpha: pixel.Alpha);
             }
 
-            return (size, pixels);
+            return new RawTextureData(width, height, pixels);
         }
 
         /// <summary>Load an unpacked image file (<c>.tbin</c> or <c>.tmx</c>).</summary>

From 43e9e2cfe2c6938121d9a5e106acfc944a1821c6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 30 May 2022 01:30:43 -0400
Subject: [PATCH 676/856] fix accidental case-sensitivity change

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 160e3c19..8e2d58a6 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -331,7 +331,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             FileInfo file = this.FileLookup.GetFile(path);
 
             // try with default image extensions
-            if (!file.Exists && typeof(Texture2D).IsAssignableFrom(typeof(T)) && !ModContentManager.LocalTilesheetExtensions.Contains(file.Extension))
+            if (!file.Exists && typeof(Texture2D).IsAssignableFrom(typeof(T)) && !ModContentManager.LocalTilesheetExtensions.Contains(file.Extension, StringComparer.OrdinalIgnoreCase))
             {
                 foreach (string extension in ModContentManager.LocalTilesheetExtensions)
                 {

From 03897776e08cb0703c9763e3b5dcc81d85f277f9 Mon Sep 17 00:00:00 2001
From: Ameisen <14104310+ameisen@users.noreply.github.com>
Date: Wed, 1 Jun 2022 19:39:47 -0500
Subject: [PATCH 677/856] Cleaning up and optimizing `ContentCache.cs`

---
 src/SMAPI/Framework/Content/ContentCache.cs | 31 +++++++++++++--------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index 736ee5da..959d4fb3 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Framework.Content
         ** Fields
         *********/
         /// <summary>The underlying asset cache.</summary>
-        private readonly IDictionary<string, object> Cache;
+        private readonly Dictionary<string, object> Cache;
 
 
         /*********
@@ -29,7 +29,7 @@ namespace StardewModdingAPI.Framework.Content
         }
 
         /// <summary>The current cache keys.</summary>
-        public IEnumerable<string> Keys => this.Cache.Keys;
+        public Dictionary<string, object>.KeyCollection Keys => this.Cache.Keys;
 
 
         /*********
@@ -89,33 +89,40 @@ namespace StardewModdingAPI.Framework.Content
         /// <returns>Returns the removed key (if any).</returns>
         public bool Remove(string key, bool dispose)
         {
-            // get entry
-            if (!this.Cache.TryGetValue(key, out object? value))
+            // remove and get entry
+            if (!this.Cache.Remove(key, out object? value))
                 return false;
 
             // dispose & remove entry
             if (dispose && value is IDisposable disposable)
                 disposable.Dispose();
 
-            return this.Cache.Remove(key);
+            return true;
         }
 
-        /// <summary>Purge matched assets from the cache.</summary>
+        /// <summary>Purge assets matching <paramref name="predicate"/> from the cache.</summary>
         /// <param name="predicate">Matches the asset keys to invalidate.</param>
-        /// <param name="dispose">Whether to dispose invalidated assets. This should only be <c>true</c> when they're being invalidated as part of a dispose, to avoid crashing the game.</param>
-        /// <returns>Returns the removed keys (if any).</returns>
+        /// <param name="dispose">Whether to dispose invalidated assets. This should only be <see langword="true"/> when they're being invalidated as part of a <see cref="IDisposable.Dispose"/>, to avoid crashing the game.</param>
+        /// <returns>Returns any removed keys.</returns>
         public IEnumerable<string> Remove(Func<string, object, bool> predicate, bool dispose)
         {
             List<string> removed = new List<string>();
-            foreach (string key in this.Cache.Keys.ToArray())
+            foreach ((string key, object value) in this.Cache)
             {
-                if (predicate(key, this.Cache[key]))
+                if (predicate(key, value))
                 {
-                    this.Remove(key, dispose);
                     removed.Add(key);
                 }
             }
-            return removed;
+
+            foreach (string key in removed)
+            {
+                this.Remove(key, dispose);
+            }
+
+            // If `removed` is empty, return an empty `Enumerable` instead so that `removed`
+            // can be quickly collected in Gen0 instead of potentially living longer.
+            return removed.Count == 0 ? Enumerable.Empty<string>() : removed;
         }
     }
 }

From 62328e438487a55cb84ee09ef966092572b2252e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 2 Jun 2022 01:28:04 -0400
Subject: [PATCH 678/856] tweak new code, update release notes

---
 docs/release-notes.md                       |  1 +
 src/SMAPI/Framework/Content/ContentCache.cs | 12 ++++--------
 2 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index db229ecf..66447b3d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -6,6 +6,7 @@ See [release highlights](https://www.patreon.com/posts/66986798).
 
 * For players:
   * Optimized mod image file loading.
+  * Minor optimizations (thanks to Michael Kuklinski / Ameisen!).
 * For mod authors:
   * Added a new `IRawTextureData` asset type.  
     _You can now load image files through `helper.ModContent` as `IRawTextureData` instead of `Texture2D`. This provides the image size and raw pixel data, which you can pass into other SMAPI APIs like `asset.AsImage().PatchImage`. This is much more efficient when you don't need a full `Texture2D` instance, since it bypasses the GPU operations needed to create one._
diff --git a/src/SMAPI/Framework/Content/ContentCache.cs b/src/SMAPI/Framework/Content/ContentCache.cs
index 959d4fb3..bf42812b 100644
--- a/src/SMAPI/Framework/Content/ContentCache.cs
+++ b/src/SMAPI/Framework/Content/ContentCache.cs
@@ -106,23 +106,19 @@ namespace StardewModdingAPI.Framework.Content
         /// <returns>Returns any removed keys.</returns>
         public IEnumerable<string> Remove(Func<string, object, bool> predicate, bool dispose)
         {
-            List<string> removed = new List<string>();
+            List<string> removed = new();
             foreach ((string key, object value) in this.Cache)
             {
                 if (predicate(key, value))
-                {
                     removed.Add(key);
-                }
             }
 
             foreach (string key in removed)
-            {
                 this.Remove(key, dispose);
-            }
 
-            // If `removed` is empty, return an empty `Enumerable` instead so that `removed`
-            // can be quickly collected in Gen0 instead of potentially living longer.
-            return removed.Count == 0 ? Enumerable.Empty<string>() : removed;
+            return removed.Count == 0
+                ? Enumerable.Empty<string>() // let GC collect the list in gen0 instead of potentially living longer
+                : removed;
         }
     }
 }

From b6d15ec57fb0aa420db81f310057e869eb3f0c53 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 7 Jun 2022 20:41:41 -0400
Subject: [PATCH 679/856] update unit test & web dependencies

---
 .../SMAPI.ModBuildConfig.Analyzer.Tests.csproj     |  6 +++---
 src/SMAPI.Tests/SMAPI.Tests.csproj                 |  8 ++++----
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj             |  2 +-
 src/SMAPI.Web/SMAPI.Web.csproj                     | 14 +++++++-------
 4 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
index 264932e4..3be9c225 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
@@ -6,9 +6,9 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="3.10.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.9.4" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
-    <PackageReference Include="NUnit3TestAdapter" Version="3.17.0" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.2.0" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 67997b30..f09abbb1 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -14,11 +14,11 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="FluentAssertions" Version="6.5.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.9.4" />
-    <PackageReference Include="Moq" Version="4.16.1" />
+    <PackageReference Include="FluentAssertions" Version="6.7.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.2.0" />
+    <PackageReference Include="Moq" Version="4.18.1" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
-    <PackageReference Include="NUnit" Version="3.13.2" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index ec27bf79..2400b76d 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -9,7 +9,7 @@
   <Import Project="..\..\build\common.targets" />
 
   <ItemGroup>
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.33" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.43" />
     <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
     <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index f1400e62..4c2569e1 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -15,14 +15,14 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Azure.Storage.Blobs" Version="12.10.0" />
-    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.27" />
+    <PackageReference Include="Azure.Storage.Blobs" Version="12.12.0" />
+    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.29" />
     <PackageReference Include="Hangfire.MemoryStorage" Version="1.7.0" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.33" />
-    <PackageReference Include="Humanizer.Core" Version="2.13.14" />
-    <PackageReference Include="JetBrains.Annotations" Version="2021.3.0" />
-    <PackageReference Include="Markdig" Version="0.26.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="6.0.0" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.43" />
+    <PackageReference Include="Humanizer.Core" Version="2.14.1" />
+    <PackageReference Include="JetBrains.Annotations" Version="2022.1.0" />
+    <PackageReference Include="Markdig" Version="0.30.2" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="6.0.5" />
     <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.14" />
     <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.5" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />

From 0bb9fc42933fc01c349a685e061a753cecb49518 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 7 Jun 2022 21:27:11 -0400
Subject: [PATCH 680/856] update Newtonsoft.Json

---
 docs/release-notes.md                               | 13 ++++++-------
 .../SMAPI.ModBuildConfig.csproj                     |  2 +-
 src/SMAPI.Tests/SMAPI.Tests.csproj                  |  2 +-
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj              |  2 +-
 src/SMAPI/SMAPI.csproj                              |  2 +-
 5 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 66447b3d..83dcd53d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,16 +7,15 @@ See [release highlights](https://www.patreon.com/posts/66986798).
 * For players:
   * Optimized mod image file loading.
   * Minor optimizations (thanks to Michael Kuklinski / Ameisen!).
-* For mod authors:
-  * Added a new `IRawTextureData` asset type.  
-    _You can now load image files through `helper.ModContent` as `IRawTextureData` instead of `Texture2D`. This provides the image size and raw pixel data, which you can pass into other SMAPI APIs like `asset.AsImage().PatchImage`. This is much more efficient when you don't need a full `Texture2D` instance, since it bypasses the GPU operations needed to create one._
-  * Updated to Harmony 2.2.1 (see what's new in [2.2.0](https://github.com/pardeike/Harmony/releases/tag/v2.2.0.0) and [2.2.1](https://github.com/pardeike/Harmony/releases/tag/v2.2.1.0)).
-  * Updated dependencies (MonoMod.Common 21.6.21.1 → 22.3.5.1).
-  * Removed transitional `UsePintail` option added in 3.14.0 (now always enabled).
 
 * For mod authors:
-  * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
+  * Added a [new `IRawTextureData` asset type](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Raw_texture_data), so mods can avoid creating full `Texture2D` instances in many cases.
   * In `smapi-internal/config.json`, you can now enable verbose logging for specific mods (instead of all or nothing).
+  * Updated dependencies:
+    * Harmony 2.2.1 (see changes in [2.2.0](https://github.com/pardeike/Harmony/releases/tag/v2.2.0.0) and [2.2.1](https://github.com/pardeike/Harmony/releases/tag/v2.2.1.0));
+    * Newtonsoft.Json 13.0.1 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.1)).
+  * Removed transitional `UsePintail` option added in 3.14.0 (now always enabled).
+  * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
 
 ## 3.14.7
 Released 01 June 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index c5790186..e25da168 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -24,7 +24,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.Build.Utilities.Core" Version="16.10" />
-    <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
 
     <!--
       This is imported through Microsoft.Build.Utilities.Core. When installed by a mod, NuGet
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index f09abbb1..2c32a932 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -17,7 +17,7 @@
     <PackageReference Include="FluentAssertions" Version="6.7.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.2.0" />
     <PackageReference Include="Moq" Version="4.18.1" />
-    <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="NUnit" Version="3.13.3" />
   </ItemGroup>
 
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 2400b76d..e021993f 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -10,7 +10,7 @@
 
   <ItemGroup>
     <PackageReference Include="HtmlAgilityPack" Version="1.11.43" />
-    <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
     <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
     <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 5bc12429..3ee7d44a 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -24,7 +24,7 @@
     <PackageReference Include="LargeAddressAware" Version="1.0.5" />
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="22.3.5.1" />
-    <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="Pintail" Version="2.1.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />

From 11a497c1f6f62c0956d6d7265883f58504cee653 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 7 Jun 2022 21:27:56 -0400
Subject: [PATCH 681/856] update Pintail

---
 docs/release-notes.md  | 3 ++-
 src/SMAPI/SMAPI.csproj | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 83dcd53d..e8e3f043 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,7 +13,8 @@ See [release highlights](https://www.patreon.com/posts/66986798).
   * In `smapi-internal/config.json`, you can now enable verbose logging for specific mods (instead of all or nothing).
   * Updated dependencies:
     * Harmony 2.2.1 (see changes in [2.2.0](https://github.com/pardeike/Harmony/releases/tag/v2.2.0.0) and [2.2.1](https://github.com/pardeike/Harmony/releases/tag/v2.2.1.0));
-    * Newtonsoft.Json 13.0.1 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.1)).
+    * Newtonsoft.Json 13.0.1 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.1));
+    * Pintail 2.2.0.
   * Removed transitional `UsePintail` option added in 3.14.0 (now always enabled).
   * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
 
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 3ee7d44a..3abefeab 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="22.3.5.1" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="Pintail" Version="2.1.0" />
+    <PackageReference Include="Pintail" Version="2.2.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
 

From 0189b282f4db300c70eeef5e9f714aa450deafde Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 10 Jun 2022 22:14:28 -0400
Subject: [PATCH 682/856] add image compatibility mode for PyTK

---
 .../ContentManagers/ModContentManager.cs      | 45 +++++++++++++++++--
 src/SMAPI/Framework/SCore.cs                  |  6 +++
 2 files changed, 47 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 8e2d58a6..8c5d0f84 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
@@ -46,6 +47,16 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
         private static readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
 
+        /// <summary>A lookup of image file paths to whether they have PyTK scaling information.</summary>
+        private static readonly Dictionary<string, bool> IsPyTkScaled = new(StringComparer.OrdinalIgnoreCase);
+
+
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>Whether to enable legacy compatibility mode for PyTK scale-up textures.</summary>
+        internal static bool EnablePyTkLegacyMode;
+
 
         /*********
         ** Public methods
@@ -192,14 +203,40 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadImageFile<T>(IAssetName assetName, FileInfo file)
         {
             this.AssertValidType<T>(assetName, file, typeof(Texture2D), typeof(IRawTextureData));
-            bool asRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
+            bool expectsRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
+            bool asRawData = expectsRawData || this.UseRawImageLoading;
+
+            // disable raw data if PyTK will rescale the image (until it supports raw data)
+            if (asRawData && !expectsRawData)
+            {
+                if (ModContentManager.EnablePyTkLegacyMode)
+                {
+                    if (!ModContentManager.IsPyTkScaled.TryGetValue(file.FullName, out bool isScaled))
+                    {
+                        string? dirPath = file.DirectoryName;
+                        string fileName = $"{Path.GetFileNameWithoutExtension(file.Name)}.pytk.json";
+
+                        string path = dirPath is not null
+                            ? Path.Combine(dirPath, fileName)
+                            : fileName;
+
+                        ModContentManager.IsPyTkScaled[file.FullName] = isScaled = File.Exists(path);
+                    }
+
+                    asRawData = !isScaled;
+                    if (!asRawData)
+                        this.Monitor.LogOnce("Enabled compatibility mode for PyTK scaled textures. This won't cause any issues, but may impact performance.", LogLevel.Warn);
+                }
+                else
+                    asRawData = true;
+            }
 
             // load
-            if (asRawData || this.UseRawImageLoading)
+            if (asRawData)
             {
-                IRawTextureData raw = this.LoadRawImageData(file, asRawData);
+                IRawTextureData raw = this.LoadRawImageData(file, expectsRawData);
 
-                if (asRawData)
+                if (expectsRawData)
                     return (T)raw;
                 else
                 {
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index fa3f8778..7792c64a 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1636,6 +1636,12 @@ namespace StardewModdingAPI.Framework
             // initialize translations
             this.ReloadTranslations(loaded);
 
+            // set temporary PyTK compatibility mode
+            {
+                IModInfo? pyTk = this.ModRegistry.Get("Platonymous.Toolkit");
+                ModContentManager.EnablePyTkLegacyMode = pyTk is not null && pyTk.Manifest.Version.IsOlderThan("1.23.1");
+            }
+
             // initialize loaded non-content-pack mods
             this.Monitor.Log("Launching mods...", LogLevel.Debug);
 #pragma warning disable CS0612, CS0618 // deprecated code

From 15f829e48c1ee9731a812798841ee102e024775d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 12 Jun 2022 12:26:51 -0400
Subject: [PATCH 683/856] patch PyTK temporarily to fix scale-up compatibility
 in SMAPI 3.15

---
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs       |  7 +-
 .../ModPatches/PyTkPatcher.cs                 | 79 +++++++++++++++++++
 .../SMAPI.Mods.ErrorHandler.csproj            |  3 -
 src/SMAPI.sln                                 |  4 +-
 src/SMAPI/Framework/SCore.cs                  |  2 +
 src/SMAPI/Properties/AssemblyInfo.cs          |  1 +
 6 files changed, 89 insertions(+), 7 deletions(-)
 create mode 100644 src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs

diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index bfbfd2dc..22e68421 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -2,6 +2,7 @@ using System;
 using System.Reflection;
 using StardewModdingAPI.Events;
 using StardewModdingAPI.Internal.Patching;
+using StardewModdingAPI.Mods.ErrorHandler.ModPatches;
 using StardewModdingAPI.Mods.ErrorHandler.Patches;
 using StardewValley;
 
@@ -29,6 +30,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler
 
             // apply patches
             HarmonyPatcher.Apply(this.ModManifest.UniqueID, this.Monitor,
+                // game patches
                 new DialoguePatcher(monitorForGame, this.Helper.Reflection),
                 new EventPatcher(monitorForGame),
                 new GameLocationPatcher(monitorForGame),
@@ -37,7 +39,10 @@ namespace StardewModdingAPI.Mods.ErrorHandler
                 new ObjectPatcher(),
                 new SaveGamePatcher(this.Monitor, this.OnSaveContentRemoved),
                 new SpriteBatchPatcher(),
-                new UtilityPatcher()
+                new UtilityPatcher(),
+
+                // mod patches
+                new PyTkPatcher(helper.ModRegistry)
             );
 
             // hook events
diff --git a/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs b/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs
new file mode 100644
index 00000000..9ee864db
--- /dev/null
+++ b/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs
@@ -0,0 +1,79 @@
+using System;
+using System.Diagnostics.CodeAnalysis;
+using System.Reflection;
+using HarmonyLib;
+using Microsoft.Xna.Framework;
+using Microsoft.Xna.Framework.Graphics;
+using StardewModdingAPI.Framework;
+using StardewModdingAPI.Framework.Content;
+using StardewModdingAPI.Internal;
+using StardewModdingAPI.Internal.Patching;
+
+//
+// This is part of a three-part fix for PyTK 1.23.0 and earlier. When removing this, search
+// 'Platonymous.Toolkit' to find the other part in SMAPI and Content Patcher.
+//
+
+namespace StardewModdingAPI.Mods.ErrorHandler.ModPatches
+{
+    /// <summary>Harmony patches for the PyTK mod for compatibility with newer SMAPI versions.</summary>
+    /// <remarks>Patch methods must be static for Harmony to work correctly. See the Harmony documentation before renaming patch arguments.</remarks>
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "Argument names are defined by Harmony and methods are named for clarity.")]
+    [SuppressMessage("ReSharper", "StringLiteralTypo", Justification = "'Platonymous' is part of the mod ID.")]
+    internal class PyTkPatcher : BasePatcher
+    {
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The PyTK mod metadata, if it's installed.</summary>
+        private static IModMetadata? PyTk;
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="modRegistry">The mod registry from which to read PyTK metadata.</param>
+        public PyTkPatcher(IModRegistry modRegistry)
+        {
+            IModMetadata? pyTk = (IModMetadata?)modRegistry.Get(@"Platonymous.Toolkit");
+            if (pyTk is not null && !pyTk.Manifest.Version.IsNewerThan("1.23.0"))
+                PyTkPatcher.PyTk = pyTk;
+        }
+
+        /// <inheritdoc />
+        public override void Apply(Harmony harmony, IMonitor monitor)
+        {
+            try
+            {
+                // get mod info
+                IModMetadata? pyTk = PyTkPatcher.PyTk;
+                if (pyTk is null)
+                    return;
+
+                // get patch method
+                const string patchMethodName = "PatchImage";
+                MethodInfo? patch = AccessTools.Method(pyTk.Mod!.GetType(), patchMethodName);
+                if (patch is null)
+                {
+                    monitor.Log("Failed applying compatibility patch for PyTK. Its image scaling feature may not work correctly.", LogLevel.Warn);
+                    monitor.Log($"Couldn't find patch method '{pyTk.Mod.GetType().FullName}.{patchMethodName}'.");
+                    return;
+                }
+
+                // apply patch
+                harmony = new($"{harmony.Id}.compatibility-patches.PyTK");
+                harmony.Patch(
+                    original: AccessTools.Method(typeof(AssetDataForImage), nameof(AssetDataForImage.PatchImage), new[] { typeof(Texture2D), typeof(Rectangle), typeof(Rectangle), typeof(PatchMode) }),
+                    prefix: new HarmonyMethod(patch)
+                );
+            }
+            catch (Exception ex)
+            {
+                monitor.Log("Failed applying compatibility patch for PyTK. Its image scaling feature may not work correctly.", LogLevel.Warn);
+                monitor.Log(ex.GetLogSummary());
+            }
+        }
+    }
+}
diff --git a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
index 78cdb315..53c37e97 100644
--- a/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
+++ b/src/SMAPI.Mods.ErrorHandler/SMAPI.Mods.ErrorHandler.csproj
@@ -24,7 +24,4 @@
     <None Update="i18n\*.json" CopyToOutputDirectory="PreserveNewest" />
     <None Update="manifest.json" CopyToOutputDirectory="PreserveNewest" />
   </ItemGroup>
-
-  <Import Project="..\SMAPI.Internal\SMAPI.Internal.projitems" Label="Shared" />
-  <Import Project="..\SMAPI.Internal.Patching\SMAPI.Internal.Patching.projitems" Label="Shared" />
 </Project>
diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index d9f60a5c..2e5ba0ea 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -103,14 +103,12 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "lib", "lib", "{3B5BF14D-F61
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Tests.ModApiProvider", "SMAPI.Tests.ModApiProvider\SMAPI.Tests.ModApiProvider.csproj", "{239AEEAC-07D1-4A3F-AA99-8C74F5038F50}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SMAPI.Tests.ModApiConsumer", "SMAPI.Tests.ModApiConsumer\SMAPI.Tests.ModApiConsumer.csproj", "{2A4DF030-E8B1-4BBD-AA93-D4DE68CB9D85}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SMAPI.Tests.ModApiConsumer", "SMAPI.Tests.ModApiConsumer\SMAPI.Tests.ModApiConsumer.csproj", "{2A4DF030-E8B1-4BBD-AA93-D4DE68CB9D85}"
 EndProject
 Global
 	GlobalSection(SharedMSBuildProjectFiles) = preSolution
 		SMAPI.Internal\SMAPI.Internal.projitems*{0634ea4c-3b8f-42db-aea6-ca9e4ef6e92f}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{0a9bb24f-15ff-4c26-b1a2-81f7ae316518}*SharedItemsImports = 5
-		SMAPI.Internal.Patching\SMAPI.Internal.Patching.projitems*{491e775b-ead0-44d4-b6ca-f1fc3e316d33}*SharedItemsImports = 5
-		SMAPI.Internal\SMAPI.Internal.projitems*{491e775b-ead0-44d4-b6ca-f1fc3e316d33}*SharedItemsImports = 5
 		SMAPI.Internal.Patching\SMAPI.Internal.Patching.projitems*{6c16e948-3e5c-47a7-bf4b-07a7469a87a5}*SharedItemsImports = 13
 		SMAPI.Internal\SMAPI.Internal.projitems*{80efd92f-728f-41e0-8a5b-9f6f49a91899}*SharedItemsImports = 5
 		SMAPI.Internal\SMAPI.Internal.projitems*{85208f8d-6fd1-4531-be05-7142490f59fe}*SharedItemsImports = 13
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 7792c64a..0fbf6525 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1637,6 +1637,8 @@ namespace StardewModdingAPI.Framework
             this.ReloadTranslations(loaded);
 
             // set temporary PyTK compatibility mode
+            // This is part of a three-part fix for PyTK 1.23.0 and earlier. When removing this,
+            // search 'Platonymous.Toolkit' to find the other part in SMAPI and Content Patcher.
             {
                 IModInfo? pyTk = this.ModRegistry.Get("Platonymous.Toolkit");
                 ModContentManager.EnablePyTkLegacyMode = pyTk is not null && pyTk.Manifest.Version.IsOlderThan("1.23.1");
diff --git a/src/SMAPI/Properties/AssemblyInfo.cs b/src/SMAPI/Properties/AssemblyInfo.cs
index daa58943..afff16b8 100644
--- a/src/SMAPI/Properties/AssemblyInfo.cs
+++ b/src/SMAPI/Properties/AssemblyInfo.cs
@@ -3,3 +3,4 @@ using System.Runtime.CompilerServices;
 [assembly: InternalsVisibleTo("SMAPI.Tests")]
 [assembly: InternalsVisibleTo("DynamicProxyGenAssembly2")] // Moq for unit testing
 [assembly: InternalsVisibleTo("ContentPatcher")]
+[assembly: InternalsVisibleTo("ErrorHandler")]

From e8bcbf7e5ac52662c12045d1a2a72edbd641bf4c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 12 Jun 2022 20:29:56 -0400
Subject: [PATCH 684/856] update compatibility list

---
 docs/release-notes.md                     | 1 +
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e8e3f043..c1605f23 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,7 @@ See [release highlights](https://www.patreon.com/posts/66986798).
 * For players:
   * Optimized mod image file loading.
   * Minor optimizations (thanks to Michael Kuklinski / Ameisen!).
+  * Updated compatibility list.
 
 * For mod authors:
   * Added a [new `IRawTextureData` asset type](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Raw_texture_data), so mods can avoid creating full `Texture2D` instances in many cases.
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 53c9db82..16a89647 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -170,6 +170,11 @@
         /*********
         ** Broke in SMAPI 3.14.0
         *********/
+        "CFAutomate": {
+            "ID": "Platonymous.CFAutomate",
+            "~2.12.9 | Status": "AssumeBroken",
+            "~2.12.9 | StatusReasonDetails": "causes runtime errors in newer versions of Automate"
+        },
         "Dynamic Game Assets": {
             "ID": "spacechase0.DynamicGameAssets",
             "~1.4.1 | Status": "AssumeBroken",

From 525351e90582beb0d79fa75bef161270e85a3ea2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Jun 2022 19:21:38 -0400
Subject: [PATCH 685/856] fix case-sensitive mod ID check

---
 docs/release-notes.md        | 1 +
 src/SMAPI/Framework/SCore.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c1605f23..14658340 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -17,6 +17,7 @@ See [release highlights](https://www.patreon.com/posts/66986798).
     * Newtonsoft.Json 13.0.1 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.1));
     * Pintail 2.2.0.
   * Removed transitional `UsePintail` option added in 3.14.0 (now always enabled).
+  * Fixed `onBehalfOf` arguments in the new content API being case-sensitive.
   * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
 
 ## 3.14.7
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 0fbf6525..385a94ea 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1231,7 +1231,7 @@ namespace StardewModdingAPI.Framework
             }
 
             // make sure it's a content pack for the requesting mod
-            if (!onBehalfOf.IsContentPack || !string.Equals(onBehalfOf.Manifest.ContentPackFor?.UniqueID, mod.Manifest.UniqueID))
+            if (!onBehalfOf.IsContentPack || !string.Equals(onBehalfOf.Manifest.ContentPackFor?.UniqueID, mod.Manifest.UniqueID, StringComparison.OrdinalIgnoreCase))
             {
                 mod.LogAsModOnce($"{errorPrefix}: that isn't a content pack for this mod.", LogLevel.Warn);
                 return null;

From 011aa4c9d07d6fc313d6d1ee107651778bb3c665 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 16 Jun 2022 22:14:09 -0400
Subject: [PATCH 686/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 6 +++---
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index ca9a1d12..8b17c45a 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,7 +1,7 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.14.7</Version>
+    <Version>3.15.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 14658340..496d016a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,8 +1,8 @@
 ← [README](README.md)
 
 # Release notes
-## Upcoming release
-See [release highlights](https://www.patreon.com/posts/66986798).
+## 3.15.0
+Released 17 June 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/67877219).
 
 * For players:
   * Optimized mod image file loading.
@@ -10,7 +10,7 @@ See [release highlights](https://www.patreon.com/posts/66986798).
   * Updated compatibility list.
 
 * For mod authors:
-  * Added a [new `IRawTextureData` asset type](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Raw_texture_data), so mods can avoid creating full `Texture2D` instances in many cases.
+  * Added an [`IRawTextureData` asset type](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0#Raw_texture_data), to avoid creating full `Texture2D` instances in many cases.
   * In `smapi-internal/config.json`, you can now enable verbose logging for specific mods (instead of all or nothing).
   * Updated dependencies:
     * Harmony 2.2.1 (see changes in [2.2.0](https://github.com/pardeike/Harmony/releases/tag/v2.2.0.0) and [2.2.1](https://github.com/pardeike/Harmony/releases/tag/v2.2.1.0));
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 564e480e..300de9d2 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.14.7",
+    "Version": "3.15.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.14.7"
+    "MinimumApiVersion": "3.15.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 39d22b5f..15a1e0f3 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.14.7",
+    "Version": "3.15.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.14.7"
+    "MinimumApiVersion": "3.15.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 8eaf2475..1a11742c 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.14.7",
+    "Version": "3.15.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.14.7"
+    "MinimumApiVersion": "3.15.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index c63324e3..db88563e 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -50,7 +50,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.14.7";
+        internal static string RawApiVersion = "3.15.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From e0ef8a20a5e7ccf1de32ff1a06f1aa62e37eb1db Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 19 Jun 2022 17:21:53 -0400
Subject: [PATCH 687/856] fix mod count in log parser metadata

---
 docs/release-notes.md                         |  4 ++++
 .../Framework/LogParsing/LogParser.cs         |  4 ++--
 .../Framework/LogParsing/Models/LogModInfo.cs | 20 ++++++++++++++++---
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  2 +-
 4 files changed, 24 insertions(+), 6 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 496d016a..bb776fd7 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For the web UI:
+  * Fixed the mod count in the log parser metadata.
+
 ## 3.15.0
 Released 17 June 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/67877219).
 
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 55272b23..7fc8f958 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -77,8 +77,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 };
 
                 // parse log messages
-                LogModInfo smapiMod = new(name: "SMAPI", author: "Pathoschild", version: "", description: "", loaded: true);
-                LogModInfo gameMod = new(name: "game", author: "", version: "", description: "", loaded: true);
+                LogModInfo smapiMod = new(name: "SMAPI", author: "Pathoschild", version: "", description: "", loaded: true, isMod: false);
+                LogModInfo gameMod = new(name: "game", author: "", version: "", description: "", loaded: true, isMod: false);
                 IDictionary<string, List<LogModInfo>> mods = new Dictionary<string, List<LogModInfo>>();
                 bool inModList = false;
                 bool inContentPackList = false;
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
index a6b9165c..4b80a830 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
@@ -39,9 +39,15 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         [MemberNotNullWhen(true, nameof(LogModInfo.UpdateVersion), nameof(LogModInfo.UpdateLink))]
         public bool HasUpdate => this.UpdateVersion != null && this.Version != this.UpdateVersion;
 
-        /// <summary>Whether the mod is a content pack for another mod.</summary>
+        /// <summary>Whether this is an actual mod (rather than a special entry for SMAPI or the game itself).</summary>
+        public bool IsMod { get; }
+
+        /// <summary>Whether this is a C# code mod.</summary>
+        public bool IsCodeMod { get; }
+
+        /// <summary>Whether this is a content pack for another mod.</summary>
         [MemberNotNullWhen(true, nameof(LogModInfo.ContentPackFor))]
-        public bool IsContentPack => !string.IsNullOrWhiteSpace(this.ContentPackFor);
+        public bool IsContentPack { get; }
 
 
         /*********
@@ -57,7 +63,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         /// <param name="contentPackFor">The name of the mod for which this is a content pack (if applicable).</param>
         /// <param name="errors">The number of errors logged by this mod.</param>
         /// <param name="loaded">Whether the mod was loaded into the game.</param>
-        public LogModInfo(string name, string author, string version, string description, string? updateVersion = null, string? updateLink = null, string? contentPackFor = null, int errors = 0, bool loaded = true)
+        /// <param name="isMod">Whether this is an actual mod (instead of a special entry for SMAPI or the game).</param>
+        public LogModInfo(string name, string author, string version, string description, string? updateVersion = null, string? updateLink = null, string? contentPackFor = null, int errors = 0, bool loaded = true, bool isMod = true)
         {
             this.Name = name;
             this.Author = author;
@@ -68,6 +75,13 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
             this.ContentPackFor = contentPackFor;
             this.Errors = errors;
             this.Loaded = loaded;
+
+            if (isMod)
+            {
+                this.IsMod = true;
+                this.IsContentPack = !string.IsNullOrWhiteSpace(this.ContentPackFor);
+                this.IsCodeMod = !this.IsContentPack;
+            }
         }
 
         /// <summary>Add an update alert for this mod.</summary>
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 5e55906d..33239a2b 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -293,7 +293,7 @@ else if (log?.IsValid == true)
         <table
             id="metadata"
             class="table"
-            data-code-mods="@log.Mods.Count(p => !p.IsContentPack)"
+            data-code-mods="@log.Mods.Count(p => p.IsCodeMod)"
             data-content-packs="@log.Mods.Count(p => p.IsContentPack)"
             data-os="@log.OperatingSystem"
             data-game-version="@log.GameVersion"

From dab1ef6acc243726247cee57877c3b3100106522 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 20 Jun 2022 18:01:48 -0400
Subject: [PATCH 688/856] add flag to disable deprecated code

---
 build/common.targets                          | 18 ++++---
 docs/technical/smapi.md                       |  1 +
 .../Framework/ModData/ModWarning.cs           |  4 ++
 src/SMAPI/Constants.cs                        |  4 ++
 src/SMAPI/Framework/Content/AssetInfo.cs      | 12 +++--
 .../Content/AssetInterceptorChange.cs         |  3 +-
 src/SMAPI/Framework/ContentCoordinator.cs     | 20 +++++++-
 .../ContentManagers/GameContentManager.cs     | 24 +++++++--
 src/SMAPI/Framework/ContentPack.cs            |  2 +
 .../Framework/ModHelpers/CommandHelper.cs     |  4 ++
 .../Framework/ModHelpers/ContentHelper.cs     |  2 +
 src/SMAPI/Framework/ModHelpers/ModHelper.cs   | 17 +++++--
 .../Framework/ModLoading/AssemblyLoader.cs    |  4 ++
 .../Finders/LegacyAssemblyFinder.cs           |  2 +
 .../ModLoading/InstructionHandleResult.cs     |  2 +
 src/SMAPI/Framework/SCore.cs                  | 22 +++++++--
 src/SMAPI/GameFramework.cs                    |  4 ++
 src/SMAPI/IAssetEditor.cs                     |  2 +
 src/SMAPI/IAssetInfo.cs                       | 16 ++++--
 src/SMAPI/IAssetLoader.cs                     |  2 +
 src/SMAPI/ICommandHelper.cs                   |  2 +
 src/SMAPI/IContentHelper.cs                   |  2 +
 src/SMAPI/IContentPack.cs                     |  4 ++
 src/SMAPI/IModHelper.cs                       |  4 ++
 src/SMAPI/Metadata/InstructionMetadata.cs     |  2 +
 src/SMAPI/Utilities/PerScreen.cs              | 49 +++++++++----------
 26 files changed, 173 insertions(+), 55 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 8b17c45a..92fd9a9a 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -5,6 +5,7 @@
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
+    <DefineConstants>$(DefineConstants);SMAPI_DEPRECATED</DefineConstants>
 
     <!--enable nullable annotations, except in .NET Standard 2.0 where they aren't supported-->
     <Nullable Condition="'$(TargetFramework)' != 'netstandard2.0'">enable</Nullable>
@@ -20,14 +21,17 @@
     <!--
       suppress warnings that don't apply, so it's easier to spot actual issues.
 
-      warning | builds  | summary                                   | rationale
-      ┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
-      CS0436  | all     | local type conflicts with imported type   | SMAPI needs to use certain low-level code during very early compatibility checks, before it's safe to load any other DLLs.
-      CA1416  | all     | platform code available on all platforms  | Compiler doesn't recognize the #if constants used by SMAPI.
-      CS0809  | all     | obsolete overload for non-onsolete member | This is deliberate to signal to mods that certain APIs are only implemented for the game and shouldn't be called by mods.
-      NU1701  | all     | NuGet package targets older .NET version  | All such packages are carefully tested to make sure they do work.
+      warning | builds     | summary                                   | rationale
+      ┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ | ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
+      CS0436  | all        | local type conflicts with imported type   | SMAPI needs to use certain low-level code during very early compatibility checks, before it's safe to load any other DLLs.
+      CS0612  | deprecated | member is obsolete                        | internal references to deprecated code when deprecated code is enabled.
+      CS0618  | deprecated | member is obsolete (with message)         | internal references to deprecated code when deprecated code is enabled.
+      CA1416  | all        | platform code available on all platforms  | Compiler doesn't recognize the #if constants used by SMAPI.
+      CS0809  | all        | obsolete overload for non-obsolete member | This is deliberate to signal to mods that certain APIs are only implemented for the game and shouldn't be called by mods.
+      NU1701  | all        | NuGet package targets older .NET version  | All such packages are carefully tested to make sure they do work.
     -->
-    <NoWarn>$(NoWarn);CS0436;CA1416;CS0809;NU1701</NoWarn>
+      <NoWarn Condition="$(DefineConstants.Contains(SMAPI_DEPRECATED))">$(NoWarn);CS0612;CS0618</NoWarn>
+      <NoWarn>$(NoWarn);CS0436;CA1416;CS0809;NU1701</NoWarn>
   </PropertyGroup>
 
   <!--find game folder-->
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 44b6e49f..90990ee4 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -62,6 +62,7 @@ SMAPI uses a small number of conditional compilation constants, which you can se
 flag | purpose
 ---- | -------
 `SMAPI_FOR_WINDOWS` | Whether SMAPI is being compiled for Windows; if not set, the code assumes Linux/macOS. Set automatically in `common.targets`.
+`SMAPI_DEPRECATED`  | Whether to include deprecated code in the build.
 
 ## Compile from source code
 ### Main project
diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
index 32c2ed6d..338192af 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
@@ -18,9 +18,11 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <summary>The mod patches the game in a way that may impact stability.</summary>
         PatchesGame = 4,
 
+#if SMAPI_FOR_WINDOWS
         /// <summary>The mod uses the <c>dynamic</c> keyword which won't work on Linux/macOS.</summary>
         [Obsolete("This value is no longer used by SMAPI and will be removed in the upcoming SMAPI 4.0.0.")]
         UsesDynamic = 8,
+#endif
 
         /// <summary>The mod references specialized 'unvalidated update tick' events which may impact stability.</summary>
         UsesUnvalidatedUpdateTick = 16,
@@ -37,6 +39,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <summary>Uses .NET APIs for shell or process access.</summary>
         AccessesShell = 256,
 
+#if SMAPI_DEPRECATED
         /// <summary>References the legacy <c>System.Configuration.ConfigurationManager</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
         DetectedLegacyConfigurationDll = 512,
 
@@ -45,5 +48,6 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
 
         /// <summary>References the legacy <c>System.Security.Permissions</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
         DetectedLegacyPermissionsDll = 2048
+#endif
     }
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index db88563e..33468717 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -6,7 +6,9 @@ using System.Reflection;
 using Mono.Cecil;
 using StardewModdingAPI.Enums;
 using StardewModdingAPI.Framework;
+#if SMAPI_DEPRECATED
 using StardewModdingAPI.Framework.Deprecations;
+#endif
 using StardewModdingAPI.Framework.ModLoading;
 using StardewModdingAPI.Toolkit.Framework;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -77,6 +79,7 @@ namespace StardewModdingAPI
         /// <summary>The game framework running the game.</summary>
         public static GameFramework GameFramework { get; } = EarlyConstants.GameFramework;
 
+#if SMAPI_DEPRECATED
         /// <summary>The path to the game folder.</summary>
         [Obsolete($"Use {nameof(Constants)}.{nameof(GamePath)} instead. This property will be removed in SMAPI 4.0.0.")]
         public static string ExecutionPath
@@ -93,6 +96,7 @@ namespace StardewModdingAPI
                 return Constants.GamePath;
             }
         }
+#endif
 
         /// <summary>The path to the game folder.</summary>
         public static string GamePath { get; } = EarlyConstants.GamePath;
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 773e3126..43feed27 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -1,7 +1,9 @@
 using System;
 using System.Collections.Generic;
 using Microsoft.Xna.Framework.Graphics;
+#if SMAPI_DEPRECATED
 using StardewModdingAPI.Framework.Deprecations;
+#endif
 
 namespace StardewModdingAPI.Framework.Content
 {
@@ -29,6 +31,10 @@ namespace StardewModdingAPI.Framework.Content
         /// <inheritdoc />
         public IAssetName NameWithoutLocale => this.NameWithoutLocaleImpl ??= this.Name.GetBaseAssetName();
 
+        /// <inheritdoc />
+        public Type DataType { get; }
+
+#if SMAPI_DEPRECATED
         /// <inheritdoc />
         [Obsolete($"Use {nameof(AssetInfo.Name)} or {nameof(AssetInfo.NameWithoutLocale)} instead. This property will be removed in SMAPI 4.0.0.")]
         public string AssetName
@@ -50,9 +56,7 @@ namespace StardewModdingAPI.Framework.Content
                 return this.NameWithoutLocale.Name;
             }
         }
-
-        /// <inheritdoc />
-        public Type DataType { get; }
+#endif
 
 
         /*********
@@ -71,6 +75,7 @@ namespace StardewModdingAPI.Framework.Content
             this.GetNormalizedPath = getNormalizedPath;
         }
 
+#if SMAPI_DEPRECATED
         /// <inheritdoc />
         [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(AssetInfo.NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead. This method will be removed in SMAPI 4.0.0.")]
         public bool AssetNameEquals(string path)
@@ -90,6 +95,7 @@ namespace StardewModdingAPI.Framework.Content
 
             return this.NameWithoutLocale.IsEquivalentTo(path);
         }
+#endif
 
 
         /*********
diff --git a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
index f3d4f3f4..3b5068dc 100644
--- a/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
+++ b/src/SMAPI/Framework/Content/AssetInterceptorChange.cs
@@ -1,8 +1,8 @@
+#if SMAPI_DEPRECATED
 using System;
 using System.Reflection;
 using StardewModdingAPI.Internal;
 
-#pragma warning disable CS0618 // obsolete asset interceptors deliberately supported here
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>A wrapper for <see cref="IAssetEditor"/> and <see cref="IAssetLoader"/> for internal cache invalidation.</summary>
@@ -103,3 +103,4 @@ namespace StardewModdingAPI.Framework.Content
         }
     }
 }
+#endif
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 3e09ac62..9e044b44 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -12,7 +12,9 @@ using StardewModdingAPI.Framework.Content;
 using StardewModdingAPI.Framework.ContentManagers;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Utilities;
+#if SMAPI_DEPRECATED
 using StardewModdingAPI.Internal;
+#endif
 using StardewModdingAPI.Metadata;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities.PathLookups;
@@ -84,6 +86,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>The cached asset load/edit operations to apply, indexed by asset name.</summary>
         private readonly TickCacheDictionary<IAssetName, AssetOperationGroup?> AssetOperationsByKey = new();
 
+#if SMAPI_DEPRECATED
         /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetLoader"/> implementations.</summary>
         [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         private readonly Dictionary<IAssetLoader, Dictionary<Type, AssetLoadOperation>> LegacyLoaderCache = new(ReferenceEqualityComparer.Instance);
@@ -91,6 +94,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>A cache of asset operation groups created for legacy <see cref="IAssetEditor"/> implementations.</summary>
         [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         private readonly Dictionary<IAssetEditor, Dictionary<Type, AssetEditOperation>> LegacyEditorCache = new(ReferenceEqualityComparer.Instance);
+#endif
 
 
         /*********
@@ -102,6 +106,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>The current language as a constant.</summary>
         public LocalizedContentManager.LanguageCode Language => this.MainContentManager.Language;
 
+#if SMAPI_DEPRECATED
         /// <summary>Interceptors which provide the initial versions of matching assets.</summary>
         [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         public IList<ModLinked<IAssetLoader>> Loaders { get; } = new List<ModLinked<IAssetLoader>>();
@@ -109,6 +114,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Interceptors which edit matching assets after they're loaded.</summary>
         [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         public IList<ModLinked<IAssetEditor>> Editors { get; } = new List<ModLinked<IAssetEditor>>();
+#endif
 
         /// <summary>The absolute path to the <see cref="ContentManager.RootDirectory"/>.</summary>
         public string FullRootDirectory { get; }
@@ -498,15 +504,25 @@ namespace StardewModdingAPI.Framework
             return invalidatedAssets.Keys;
         }
 
+#if SMAPI_DEPRECATED
         /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The asset info to load or edit.</param>
         public AssetOperationGroup? GetAssetOperations<T>(IAssetInfo info)
             where T : notnull
+#else
+        /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now.</summary>
+        /// <param name="info">The asset info to load or edit.</param>
+        public AssetOperationGroup? GetAssetOperations(IAssetInfo info)
+#endif
         {
             return this.AssetOperationsByKey.GetOrSet(
                 info.Name,
+#if SMAPI_DEPRECATED
                 () => this.GetAssetOperationsWithoutCache<T>(info)
+#else
+                () => this.RequestAssetOperations(info)
+#endif
             );
         }
 
@@ -629,6 +645,7 @@ namespace StardewModdingAPI.Framework
             return map;
         }
 
+#if SMAPI_DEPRECATED
         /// <summary>Get the asset load and edit operations to apply to a given asset if it's (re)loaded now, ignoring the <see cref="AssetOperationsByKey"/> cache.</summary>
         /// <typeparam name="T">The asset type.</typeparam>
         /// <param name="info">The asset info to load or edit.</param>
@@ -639,7 +656,6 @@ namespace StardewModdingAPI.Framework
             AssetOperationGroup? group = this.RequestAssetOperations(info);
 
             // legacy load operations
-#pragma warning disable CS0612, CS0618 // deprecated code
             if (this.Editors.Count > 0 || this.Loaders.Count > 0)
             {
                 IAssetInfo legacyInfo = this.GetLegacyAssetInfo(info);
@@ -738,7 +754,6 @@ namespace StardewModdingAPI.Framework
                     );
                 }
             }
-#pragma warning restore CS0612, CS0618
 
             return group;
         }
@@ -818,5 +833,6 @@ namespace StardewModdingAPI.Framework
             // else no change needed
             return asset;
         }
+#endif
     }
 }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index 446f4a67..df7bdc59 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -76,7 +76,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // custom asset from a loader
             string locale = this.GetLocale();
             IAssetInfo info = new AssetInfo(locale, assetName, typeof(T), this.AssertAndNormalizeAssetName);
-            AssetOperationGroup? operations = this.Coordinator.GetAssetOperations<T>(info);
+            AssetOperationGroup? operations = this.Coordinator.GetAssetOperations
+#if SMAPI_DEPRECATED
+                <T>
+#endif
+                (info);
             if (operations?.LoadOperations.Count > 0)
             {
                 if (!this.AssertMaxOneRequiredLoader(info, operations.LoadOperations, out string? error))
@@ -129,7 +133,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 data = this.AssetsBeingLoaded.Track(assetName.Name, () =>
                 {
                     IAssetInfo info = new AssetInfo(assetName.LocaleCode, assetName, typeof(T), this.AssertAndNormalizeAssetName);
-                    AssetOperationGroup? operations = this.Coordinator.GetAssetOperations<T>(info);
+                    AssetOperationGroup? operations = this.Coordinator.GetAssetOperations
+#if SMAPI_DEPRECATED
+                        <T>
+#endif
+                        (info);
                     IAssetData asset =
                         this.ApplyLoader<T>(info, operations?.LoadOperations)
                         ?? new AssetDataForObject(info, this.RawLoad<T>(assetName, useCache), this.AssertAndNormalizeAssetName, this.Reflection);
@@ -294,7 +302,11 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 ? $"Multiple mods want to provide the '{info.Name}' asset: {string.Join(", ", loaderNames)}"
                 : $"The '{loaderNames[0]}' mod wants to provide the '{info.Name}' asset multiple times";
 
-            error = $"{errorPhrase}. An asset can't be loaded multiple times, so SMAPI will use the default asset instead. Uninstall one of the mods to fix this. (Message for modders: you should avoid {nameof(AssetLoadPriority)}.{nameof(AssetLoadPriority.Exclusive)} and {nameof(IAssetLoader)} if possible to avoid conflicts.)";
+            error = $"{errorPhrase}. An asset can't be loaded multiple times, so SMAPI will use the default asset instead. Uninstall one of the mods to fix this. (Message for modders: you should avoid {nameof(AssetLoadPriority)}.{nameof(AssetLoadPriority.Exclusive)}"
+#if SMAPI_DEPRECATED
+                + " and {nameof(IAssetLoader)}"
+#endif
+                + " if possible to avoid conflicts.)";
             return false;
         }
 
@@ -349,6 +361,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     // handle mismatch
                     if (loadedMap.TileSheets.Count <= vanillaSheet.Index || loadedMap.TileSheets[vanillaSheet.Index].Id != vanillaSheet.Id)
                     {
+#if SMAPI_DEPRECATED
                         // only show warning if not farm map
                         // This is temporary: mods shouldn't do this for any vanilla map, but these are the ones we know will crash. Showing a warning for others instead gives modders time to update their mods, while still simplifying troubleshooting.
                         bool isFarmMap = info.Name.IsEquivalentTo("Maps/Farm") || info.Name.IsEquivalentTo("Maps/Farm_Combat") || info.Name.IsEquivalentTo("Maps/Farm_Fishing") || info.Name.IsEquivalentTo("Maps/Farm_Foraging") || info.Name.IsEquivalentTo("Maps/Farm_FourCorners") || info.Name.IsEquivalentTo("Maps/Farm_Island") || info.Name.IsEquivalentTo("Maps/Farm_Mining");
@@ -361,7 +374,12 @@ namespace StardewModdingAPI.Framework.ContentManagers
                             mod.LogAsMod($"SMAPI blocked a '{info.Name}' map load: {reason}", LogLevel.Error);
                             return false;
                         }
+
                         mod.LogAsMod($"SMAPI found an issue with a '{info.Name}' map load: {reason}", LogLevel.Warn);
+#else
+                        mod.LogAsMod($"SMAPI found an issue with a '{info.Name}' map load: {this.GetOnBehalfOfLabel(loader.OnBehalfOf, parenthetical: false) ?? "mod"} reordered the original tilesheets, which often causes crashes.\nTechnical details for mod author: Expected order: {string.Join(", ", vanillaTilesheetRefs.Select(p => p.Id))}. See https://stardewvalleywiki.com/Modding:Maps#Tilesheet_order for help.", LogLevel.Error);
+                        return false;
+#endif
                     }
                 }
             }
diff --git a/src/SMAPI/Framework/ContentPack.cs b/src/SMAPI/Framework/ContentPack.cs
index 70fe51f8..a1d977e4 100644
--- a/src/SMAPI/Framework/ContentPack.cs
+++ b/src/SMAPI/Framework/ContentPack.cs
@@ -96,6 +96,7 @@ namespace StardewModdingAPI.Framework
             }
         }
 
+#if SMAPI_DEPRECATED
         /// <inheritdoc />
         [Obsolete($"Use {nameof(IContentPack.ModContent)}.{nameof(IModContentHelper.Load)} instead. This method will be removed in SMAPI 4.0.0.")]
         public T LoadAsset<T>(string key)
@@ -110,6 +111,7 @@ namespace StardewModdingAPI.Framework
         {
             return this.ModContent.GetInternalAssetName(key).Name;
         }
+#endif
 
 
         /*********
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index ddbd618a..21435f62 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -1,5 +1,7 @@
 using System;
+#if SMAPI_DEPRECATED
 using StardewModdingAPI.Framework.Deprecations;
+#endif
 
 namespace StardewModdingAPI.Framework.ModHelpers
 {
@@ -32,6 +34,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
             return this;
         }
 
+#if SMAPI_DEPRECATED
         /// <inheritdoc />
         [Obsolete("Use mod-provided APIs to integrate with mods instead. This method will be removed in SMAPI 4.0.0.")]
         public bool Trigger(string name, string[] arguments)
@@ -45,5 +48,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             return this.CommandManager.Trigger(name, arguments);
         }
+#endif
     }
 }
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 427adac2..9992cb52 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -1,3 +1,4 @@
+#if SMAPI_DEPRECATED
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
@@ -249,3 +250,4 @@ namespace StardewModdingAPI.Framework.ModHelpers
         }
     }
 }
+#endif
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 48973691..9ac3b6f7 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -1,7 +1,9 @@
 using System;
 using System.IO;
 using StardewModdingAPI.Events;
+#if SMAPI_DEPRECATED
 using StardewModdingAPI.Framework.Deprecations;
+#endif
 using StardewModdingAPI.Framework.Input;
 
 namespace StardewModdingAPI.Framework.ModHelpers
@@ -9,12 +11,14 @@ namespace StardewModdingAPI.Framework.ModHelpers
     /// <summary>Provides simplified APIs for writing mods.</summary>
     internal class ModHelper : BaseHelper, IModHelper, IDisposable
     {
+#if SMAPI_DEPRECATED
         /*********
         ** Fields
         *********/
         /// <summary>The backing field for <see cref="Content"/>.</summary>
         [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         private readonly ContentHelper ContentImpl;
+#endif
 
 
         /*********
@@ -26,6 +30,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <inheritdoc />
         public IModEvents Events { get; }
 
+#if SMAPI_DEPRECATED
         /// <inheritdoc />
         [Obsolete($"Use {nameof(IGameContentHelper)} or {nameof(IModContentHelper)} instead.")]
         public IContentHelper Content
@@ -42,6 +47,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 return this.ContentImpl;
             }
         }
+#endif
 
         /// <inheritdoc />
         public IGameContentHelper GameContent { get; }
@@ -82,7 +88,6 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="modDirectory">The full path to the mod's folder.</param>
         /// <param name="currentInputState">Manages the game's input state for the current player instance. That may not be the main player in split-screen mode.</param>
         /// <param name="events">Manages access to events raised by SMAPI.</param>
-        /// <param name="contentHelper">An API for loading content assets.</param>
         /// <param name="gameContentHelper">An API for loading content assets from the game's <c>Content</c> folder or via <see cref="IModEvents.Content"/>.</param>
         /// <param name="modContentHelper">An API for loading content assets from your mod's files.</param>
         /// <param name="contentPackHelper">An API for managing content packs.</param>
@@ -96,9 +101,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <exception cref="InvalidOperationException">The <paramref name="modDirectory"/> path does not exist on disk.</exception>
         public ModHelper(
             IModMetadata mod, string modDirectory, Func<SInputState> currentInputState, IModEvents events,
-#pragma warning disable CS0612 // deprecated code
+#if SMAPI_DEPRECATED
             ContentHelper contentHelper,
-#pragma warning restore CS0612
+#endif
             IGameContentHelper gameContentHelper, IModContentHelper modContentHelper, IContentPackHelper contentPackHelper, ICommandHelper commandHelper, IDataHelper dataHelper, IModRegistry modRegistry, IReflectionHelper reflectionHelper, IMultiplayerHelper multiplayer, ITranslationHelper translationHelper
         )
             : base(mod)
@@ -111,9 +116,9 @@ namespace StardewModdingAPI.Framework.ModHelpers
 
             // initialize
             this.DirectoryPath = modDirectory;
-#pragma warning disable CS0612 // deprecated code
+#if SMAPI_DEPRECATED
             this.ContentImpl = contentHelper ?? throw new ArgumentNullException(nameof(contentHelper));
-#pragma warning restore CS0612
+#endif
             this.GameContent = gameContentHelper ?? throw new ArgumentNullException(nameof(gameContentHelper));
             this.ModContent = modContentHelper ?? throw new ArgumentNullException(nameof(modContentHelper));
             this.ContentPacks = contentPackHelper ?? throw new ArgumentNullException(nameof(contentPackHelper));
@@ -127,12 +132,14 @@ namespace StardewModdingAPI.Framework.ModHelpers
             this.Events = events;
         }
 
+#if SMAPI_DEPRECATED
         /// <summary>Get the underlying instance for <see cref="IContentHelper"/>.</summary>
         [Obsolete("This only exists to support legacy code and will be removed in SMAPI 4.0.0.")]
         public ContentHelper GetLegacyContentHelper()
         {
             return this.ContentImpl;
         }
+#endif
 
         /****
         ** Mod config file
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index e5aaa8ee..eb940c41 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -163,6 +163,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 this.AssemblyDefinitionResolver.Add(assembly.Definition);
             }
 
+#if SMAPI_DEPRECATED
             // special case: clear legacy-DLL warnings if the mod bundles a copy
             if (mod.Warnings.HasFlag(ModWarning.DetectedLegacyCachingDll))
             {
@@ -185,6 +186,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 if (File.Exists(Path.Combine(mod.DirectoryPath, "System.Security.Permissions.dll")))
                     mod.RemoveWarning(ModWarning.DetectedLegacyPermissionsDll);
             }
+#endif
 
             // throw if incompatibilities detected
             if (!assumeCompatible && mod.Warnings.HasFlag(ModWarning.BrokenCodeLoaded))
@@ -452,6 +454,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                     mod.SetWarning(ModWarning.AccessesShell);
                     break;
 
+#if SMAPI_DEPRECATED
                 case InstructionHandleResult.DetectedLegacyCachingDll:
                     template = $"{logPrefix}Detected reference to System.Runtime.Caching.dll, which will be removed in SMAPI 4.0.0.";
                     mod.SetWarning(ModWarning.DetectedLegacyCachingDll);
@@ -466,6 +469,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                     template = $"{logPrefix}Detected reference to System.Security.Permissions.dll, which will be removed in SMAPI 4.0.0.";
                     mod.SetWarning(ModWarning.DetectedLegacyPermissionsDll);
                     break;
+#endif
 
                 case InstructionHandleResult.None:
                     break;
diff --git a/src/SMAPI/Framework/ModLoading/Finders/LegacyAssemblyFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/LegacyAssemblyFinder.cs
index d3437b05..77380907 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/LegacyAssemblyFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/LegacyAssemblyFinder.cs
@@ -1,3 +1,4 @@
+#if SMAPI_DEPRECATED
 using Mono.Cecil;
 using StardewModdingAPI.Framework.ModLoading.Framework;
 
@@ -47,3 +48,4 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
         }
     }
 }
+#endif
diff --git a/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs b/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
index 476c30d0..189ca64e 100644
--- a/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
+++ b/src/SMAPI/Framework/ModLoading/InstructionHandleResult.cs
@@ -32,6 +32,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>The instruction accesses the OS shell or processes directly.</summary>
         DetectedShellAccess,
 
+#if SMAPI_DEPRECATED
         /// <summary>The module references the legacy <c>System.Configuration.ConfigurationManager</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
         DetectedLegacyConfigurationDll,
 
@@ -40,5 +41,6 @@ namespace StardewModdingAPI.Framework.ModLoading
 
         /// <summary>The module references the legacy <c>System.Security.Permissions</c> assembly and doesn't include a copy in the mod folder, so it'll break in SMAPI 4.0.0.</summary>
         DetectedLegacyPermissionsDll
+#endif
     }
 }
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 385a94ea..ff3eadf5 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -32,7 +32,9 @@ using StardewModdingAPI.Framework.Networking;
 using StardewModdingAPI.Framework.Reflection;
 using StardewModdingAPI.Framework.Rendering;
 using StardewModdingAPI.Framework.Serialization;
+#if SMAPI_DEPRECATED
 using StardewModdingAPI.Framework.StateTracking.Comparers;
+#endif
 using StardewModdingAPI.Framework.StateTracking.Snapshots;
 using StardewModdingAPI.Framework.Utilities;
 using StardewModdingAPI.Internal;
@@ -139,8 +141,10 @@ namespace StardewModdingAPI.Framework
         /// <summary>The maximum number of consecutive attempts SMAPI should make to recover from an update error.</summary>
         private readonly Countdown UpdateCrashTimer = new(60); // 60 ticks = roughly one second
 
+#if SMAPI_DEPRECATED
         /// <summary>Asset interceptors added or removed since the last tick.</summary>
         private readonly List<AssetInterceptorChange> ReloadAssetInterceptorsQueue = new();
+#endif
 
         /// <summary>A list of queued commands to parse and execute.</summary>
         /// <remarks>This property must be thread-safe, since it's accessed from a separate console input thread.</remarks>
@@ -483,6 +487,7 @@ namespace StardewModdingAPI.Framework
                     return;
                 }
 
+#if SMAPI_DEPRECATED
                 /*********
                 ** Reload assets when interceptors are added/removed
                 *********/
@@ -515,6 +520,7 @@ namespace StardewModdingAPI.Framework
                     // reload affected assets
                     this.ContentCore.InvalidateCache(asset => interceptors.Any(p => p.CanIntercept(asset)));
                 }
+#endif
 
                 /*********
                 ** Parse commands
@@ -1646,9 +1652,9 @@ namespace StardewModdingAPI.Framework
 
             // initialize loaded non-content-pack mods
             this.Monitor.Log("Launching mods...", LogLevel.Debug);
-#pragma warning disable CS0612, CS0618 // deprecated code
             foreach (IModMetadata metadata in loadedMods)
             {
+#if SMAPI_DEPRECATED
                 // add interceptors
                 if (metadata.Mod?.Helper is ModHelper helper)
                 {
@@ -1684,7 +1690,6 @@ namespace StardewModdingAPI.Framework
                     content.ObservableAssetEditors.CollectionChanged += (_, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetEditor>(), e.OldItems?.Cast<IAssetEditor>(), this.ContentCore.Editors);
                     content.ObservableAssetLoaders.CollectionChanged += (_, e) => this.OnAssetInterceptorsChanged(metadata, e.NewItems?.Cast<IAssetLoader>(), e.OldItems?.Cast<IAssetLoader>(), this.ContentCore.Loaders);
                 }
-#pragma warning restore CS0612, CS0618
 
                 // log deprecation warnings
                 if (metadata.HasWarnings(ModWarning.DetectedLegacyCachingDll, ModWarning.DetectedLegacyConfigurationDll, ModWarning.DetectedLegacyPermissionsDll))
@@ -1710,6 +1715,7 @@ namespace StardewModdingAPI.Framework
                         );
                     }
                 }
+#endif
 
                 // call entry method
                 Context.HeuristicModsRunningCode.Push(metadata);
@@ -1750,6 +1756,7 @@ namespace StardewModdingAPI.Framework
             this.Monitor.Log("Mods loaded and ready!", LogLevel.Debug);
         }
 
+#if SMAPI_DEPRECATED
         /// <summary>Raised after a mod adds or removes asset interceptors.</summary>
         /// <typeparam name="T">The asset interceptor type (one of <see cref="IAssetEditor"/> or <see cref="IAssetLoader"/>).</typeparam>
         /// <param name="mod">The mod metadata.</param>
@@ -1772,6 +1779,7 @@ namespace StardewModdingAPI.Framework
                     list.Remove(entry);
             }
         }
+#endif
 
         /// <summary>Load a given mod.</summary>
         /// <param name="mod">The mod to load.</param>
@@ -1915,9 +1923,9 @@ namespace StardewModdingAPI.Framework
                     {
                         IModEvents events = new ModEvents(mod, this.EventManager);
                         ICommandHelper commandHelper = new CommandHelper(mod, this.CommandManager);
-#pragma warning disable CS0612 // deprecated code
+#if SMAPI_DEPRECATED
                         ContentHelper contentHelper = new(contentCore, mod.DirectoryPath, mod, monitor, this.Reflection);
-#pragma warning restore CS0612
+#endif
                         GameContentHelper gameContentHelper = new(contentCore, mod, mod.DisplayName, monitor, this.Reflection);
                         IModContentHelper modContentHelper = new ModContentHelper(contentCore, mod.DirectoryPath, mod, mod.DisplayName, gameContentHelper.GetUnderlyingContentManager(), this.Reflection);
                         IContentPackHelper contentPackHelper = new ContentPackHelper(
@@ -1930,7 +1938,11 @@ namespace StardewModdingAPI.Framework
                         IModRegistry modRegistryHelper = new ModRegistryHelper(mod, this.ModRegistry, proxyFactory, monitor);
                         IMultiplayerHelper multiplayerHelper = new MultiplayerHelper(mod, this.Multiplayer);
 
-                        modHelper = new ModHelper(mod, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events, contentHelper, gameContentHelper, modContentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
+                        modHelper = new ModHelper(mod, mod.DirectoryPath, () => this.GetCurrentGameInstance().Input, events,
+#if SMAPI_DEPRECATED
+                            contentHelper,
+#endif
+                            gameContentHelper, modContentHelper, contentPackHelper, commandHelper, dataHelper, modRegistryHelper, reflectionHelper, multiplayerHelper, translationHelper);
                     }
 
                     // init mod
diff --git a/src/SMAPI/GameFramework.cs b/src/SMAPI/GameFramework.cs
index 60fbe56e..009865fe 100644
--- a/src/SMAPI/GameFramework.cs
+++ b/src/SMAPI/GameFramework.cs
@@ -1,13 +1,17 @@
+#if SMAPI_DEPRECATED
 using System;
+#endif
 
 namespace StardewModdingAPI
 {
     /// <summary>The game framework running the game.</summary>
     public enum GameFramework
     {
+#if SMAPI_DEPRECATED
         /// <summary>The XNA Framework, previously used on Windows.</summary>
         [Obsolete("Stardew Valley no longer uses XNA Framework on any supported platform.  This value will be removed in SMAPI 4.0.0.")]
         Xna,
+#endif
 
         /// <summary>The MonoGame framework.</summary>
         MonoGame
diff --git a/src/SMAPI/IAssetEditor.cs b/src/SMAPI/IAssetEditor.cs
index 9f22ed83..f3238ba9 100644
--- a/src/SMAPI/IAssetEditor.cs
+++ b/src/SMAPI/IAssetEditor.cs
@@ -1,3 +1,4 @@
+#if SMAPI_DEPRECATED
 using System;
 using StardewModdingAPI.Events;
 
@@ -19,3 +20,4 @@ namespace StardewModdingAPI
         void Edit<T>(IAssetData asset);
     }
 }
+#endif
diff --git a/src/SMAPI/IAssetInfo.cs b/src/SMAPI/IAssetInfo.cs
index 44fd91a5..20064946 100644
--- a/src/SMAPI/IAssetInfo.cs
+++ b/src/SMAPI/IAssetInfo.cs
@@ -8,25 +8,34 @@ namespace StardewModdingAPI
         /*********
         ** Accessors
         *********/
+#if SMAPI_DEPRECATED
         /// <summary>The content's locale code, if the content is localized.</summary>
         /// <remarks>LEGACY NOTE: when reading this field from an <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> implementation, for non-localized assets it will return the current game locale (or an empty string for English) instead of null.</remarks>
+#else
+        /// <summary>The content's locale code, if the content is localized.</summary>
+#endif
         string? Locale { get; }
 
+#if SMAPI_DEPRECATED
         /// <summary>The asset name being read.</summary>
         /// <remarks>LEGACY NOTE: when reading this field from an <see cref="IAssetLoader"/> or <see cref="IAssetEditor"/> implementation, it's always equivalent to <see cref="NameWithoutLocale"/> for backwards compatibility.</remarks>
+#else
+        /// <summary>The asset name being read.</summary>
+#endif
         public IAssetName Name { get; }
 
         /// <summary>The <see cref="Name"/> with any locale codes stripped.</summary>
         /// <remarks>For example, if <see cref="Name"/> contains a locale like <c>Data/Bundles.fr-FR</c>, this will be the name without locale like <c>Data/Bundles</c>. If the name has no locale, this field is equivalent.</remarks>
         public IAssetName NameWithoutLocale { get; }
 
+        /// <summary>The content data type.</summary>
+        Type DataType { get; }
+
+#if SMAPI_DEPRECATED
         /// <summary>The normalized asset name being read. The format may change between platforms; see <see cref="AssetNameEquals"/> to compare with a known path.</summary>
         [Obsolete($"Use {nameof(Name)} or {nameof(NameWithoutLocale)} instead. This property will be removed in SMAPI 4.0.0.")]
         string AssetName { get; }
 
-        /// <summary>The content data type.</summary>
-        Type DataType { get; }
-
 
         /*********
         ** Public methods
@@ -35,5 +44,6 @@ namespace StardewModdingAPI
         /// <param name="path">The expected asset path, relative to the game's content folder and without the .xnb extension or locale suffix (like 'Data\ObjectInformation').</param>
         [Obsolete($"Use {nameof(Name)}.{nameof(IAssetName.IsEquivalentTo)} or {nameof(NameWithoutLocale)}.{nameof(IAssetName.IsEquivalentTo)} instead. This method will be removed in SMAPI 4.0.0.")]
         bool AssetNameEquals(string path);
+#endif
     }
 }
diff --git a/src/SMAPI/IAssetLoader.cs b/src/SMAPI/IAssetLoader.cs
index 96b98793..205980a7 100644
--- a/src/SMAPI/IAssetLoader.cs
+++ b/src/SMAPI/IAssetLoader.cs
@@ -1,3 +1,4 @@
+#if SMAPI_DEPRECATED
 using System;
 using StardewModdingAPI.Events;
 
@@ -19,3 +20,4 @@ namespace StardewModdingAPI
         T Load<T>(IAssetInfo asset);
     }
 }
+#endif
diff --git a/src/SMAPI/ICommandHelper.cs b/src/SMAPI/ICommandHelper.cs
index 9f1c345c..c92a09c2 100644
--- a/src/SMAPI/ICommandHelper.cs
+++ b/src/SMAPI/ICommandHelper.cs
@@ -17,11 +17,13 @@ namespace StardewModdingAPI
         /// <exception cref="ArgumentException">There's already a command with that name.</exception>
         ICommandHelper Add(string name, string documentation, Action<string, string[]> callback);
 
+#if SMAPI_DEPRECATED
         /// <summary>Trigger a command.</summary>
         /// <param name="name">The command name.</param>
         /// <param name="arguments">The command arguments.</param>
         /// <returns>Returns whether a matching command was triggered.</returns>
         [Obsolete("Use mod-provided APIs to integrate with mods instead. This method will be removed in SMAPI 4.0.0.")]
         bool Trigger(string name, string[] arguments);
+#endif
     }
 }
diff --git a/src/SMAPI/IContentHelper.cs b/src/SMAPI/IContentHelper.cs
index 7637edf0..b0e30a82 100644
--- a/src/SMAPI/IContentHelper.cs
+++ b/src/SMAPI/IContentHelper.cs
@@ -1,3 +1,4 @@
+#if SMAPI_DEPRECATED
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.Contracts;
@@ -80,3 +81,4 @@ namespace StardewModdingAPI
             where T : notnull;
     }
 }
+#endif
diff --git a/src/SMAPI/IContentPack.cs b/src/SMAPI/IContentPack.cs
index 73b1a860..5047b172 100644
--- a/src/SMAPI/IContentPack.cs
+++ b/src/SMAPI/IContentPack.cs
@@ -1,7 +1,9 @@
 using System;
+#if SMAPI_DEPRECATED
 using Microsoft.Xna.Framework.Content;
 using Microsoft.Xna.Framework.Graphics;
 using xTile;
+#endif
 
 namespace StardewModdingAPI
 {
@@ -47,6 +49,7 @@ namespace StardewModdingAPI
         void WriteJsonFile<TModel>(string path, TModel data)
             where TModel : class;
 
+#if SMAPI_DEPRECATED
         /// <summary>Load content from the content pack folder (if not already cached), and return it. When loading a <c>.png</c> file, this must be called outside the game's draw loop.</summary>
         /// <typeparam name="T">The expected data type. The main supported types are <see cref="Map"/>, <see cref="Texture2D"/>, <see cref="IRawTextureData"/>, and data structures; other types may be supported by the game's content pipeline.</typeparam>
         /// <param name="key">The relative file path within the content pack (case-insensitive).</param>
@@ -61,5 +64,6 @@ namespace StardewModdingAPI
         /// <exception cref="ArgumentException">The <paramref name="key"/> is empty or contains invalid characters.</exception>
         [Obsolete($"Use {nameof(IContentPack.ModContent)}.{nameof(IModContentHelper.GetInternalAssetName)} instead. This method will be removed in SMAPI 4.0.0.")]
         string GetActualAssetKey(string key);
+#endif
     }
 }
diff --git a/src/SMAPI/IModHelper.cs b/src/SMAPI/IModHelper.cs
index 15e4ed8d..a44d92c1 100644
--- a/src/SMAPI/IModHelper.cs
+++ b/src/SMAPI/IModHelper.cs
@@ -1,4 +1,6 @@
+#if SMAPI_DEPRECATED
 using System;
+#endif
 using StardewModdingAPI.Events;
 
 namespace StardewModdingAPI
@@ -25,9 +27,11 @@ namespace StardewModdingAPI
         /// <remarks>This API is intended for reading content assets from the mod files (like game data, images, etc); see also <see cref="Data"/> which is intended for persisting internal mod data.</remarks>
         IModContentHelper ModContent { get; }
 
+#if SMAPI_DEPRECATED
         /// <summary>An API for loading content assets.</summary>
         [Obsolete($"Use {nameof(IGameContentHelper)} or {nameof(IModContentHelper)} instead.")]
         IContentHelper Content { get; }
+#endif
 
         /// <summary>An API for managing content packs.</summary>
         IContentPackHelper ContentPacks { get; }
diff --git a/src/SMAPI/Metadata/InstructionMetadata.cs b/src/SMAPI/Metadata/InstructionMetadata.cs
index dce0c6b1..efa91d20 100644
--- a/src/SMAPI/Metadata/InstructionMetadata.cs
+++ b/src/SMAPI/Metadata/InstructionMetadata.cs
@@ -54,8 +54,10 @@ namespace StardewModdingAPI.Metadata
                 // detect Harmony & rewrite for SMAPI 3.12 (Harmony 1.x => 2.0 update)
                 yield return new HarmonyRewriter();
 
+#if SMAPI_DEPRECATED
                 // detect issues for SMAPI 4.0.0
                 yield return new LegacyAssemblyFinder();
+#endif
             }
             else
                 yield return new HarmonyRewriter(shouldRewrite: false);
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index b86310b8..54657ade 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -1,8 +1,10 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+#if SMAPI_DEPRECATED
 using StardewModdingAPI.Framework;
 using StardewModdingAPI.Framework.Deprecations;
+#endif
 
 namespace StardewModdingAPI.Utilities
 {
@@ -41,12 +43,31 @@ namespace StardewModdingAPI.Utilities
         /// <summary>Construct an instance.</summary>
         /// <remarks><strong>Limitation with nullable reference types:</strong> when the underlying type <typeparamref name="T"/> is nullable, this sets the default value to null regardless of whether you marked the type parameter nullable. To avoid that, set the default value with the 'createNewState' argument instead.</remarks>
         public PerScreen()
-            : this(null, nullExpected: true) { }
+        {
+            this.CreateNewState = (() => default!);
+        }
 
         /// <summary>Construct an instance.</summary>
         /// <param name="createNewState">Create the initial state for a screen.</param>
         public PerScreen(Func<T> createNewState)
-            : this(createNewState, nullExpected: false) { }
+        {
+            if (createNewState is null)
+            {
+#if SMAPI_DEPRECATED
+                createNewState = (() => default!);
+                SCore.DeprecationManager.Warn(
+                    null,
+                    $"calling the {nameof(PerScreen<T>)} constructor with null",
+                    "3.14.0",
+                    DeprecationLevel.Notice
+                );
+#else
+                throw new ArgumentNullException(nameof(createNewState));
+#endif
+            }
+
+            this.CreateNewState = createNewState;
+        }
 
         /// <summary>Get all active values by screen ID. This doesn't initialize the value for a screen ID if it's not created yet.</summary>
         public IEnumerable<KeyValuePair<int, T>> GetActiveValues()
@@ -84,30 +105,6 @@ namespace StardewModdingAPI.Utilities
         /*********
         ** Private methods
         *********/
-        /// <summary>Construct an instance.</summary>
-        /// <param name="createNewState">Create the initial state for a screen.</param>
-        /// <param name="nullExpected">Whether a null <paramref name="createNewState"/> value is expected.</param>
-        /// <remarks>This constructor only exists to maintain backwards compatibility. In SMAPI 4.0.0, the overload that passes <c>nullExpected: false</c> should throw an exception instead.</remarks>
-        private PerScreen(Func<T>? createNewState, bool nullExpected)
-        {
-            if (createNewState is null)
-            {
-                createNewState = (() => default!);
-
-                if (!nullExpected)
-                {
-                    SCore.DeprecationManager.Warn(
-                        null,
-                        $"calling the {nameof(PerScreen<T>)} constructor with null",
-                        "3.14.0",
-                        DeprecationLevel.Notice
-                    );
-                }
-            }
-
-            this.CreateNewState = createNewState;
-        }
-
         /// <summary>Remove screens which are no longer active.</summary>
         private void RemoveDeadScreens()
         {

From c91fbc82f8803c400880a56fc1571abd76411fdf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 20 Jun 2022 18:02:41 -0400
Subject: [PATCH 689/856] deprecate support for updating ancient versions of
 SMAPI

---
 docs/release-notes.md                       | 6 ++++++
 src/SMAPI.Installer/InteractiveInstaller.cs | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index bb776fd7..16b47670 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,12 @@
 ← [README](README.md)
 
 # Release notes
+<!--
+## 4.0.0
+* The installer no longer supports updating from SMAPI 2.11.3 or earlier (released in 2019).  
+  _If needed, you can update to SMAPI 3.15.0 first and then install to the latest version._
+-->
+
 ## Upcoming release
 * For the web UI:
   * Fixed the mod count in the log parser metadata.
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 19cefd32..5a6aa747 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -54,6 +54,7 @@ namespace StardewModdingApi.Installer
             yield return GetInstallPath("smapi-internal");
             yield return GetInstallPath("steam_appid.txt");
 
+#if SMAPI_DEPRECATED
             // obsolete
             yield return GetInstallPath("libgdiplus.dylib");                 // before 3.13 (macOS only)
             yield return GetInstallPath(Path.Combine("Mods", ".cache"));     // 1.3-1.4
@@ -82,6 +83,7 @@ namespace StardewModdingApi.Installer
                 foreach (DirectoryInfo modDir in modsDir.EnumerateDirectories())
                     yield return Path.Combine(modDir.FullName, ".cache"); // 1.4–1.7
             }
+#endif
 
             yield return Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "StardewValley", "ErrorLogs"); // remove old log files
         }
@@ -477,8 +479,10 @@ namespace StardewModdingApi.Installer
                         File.WriteAllText(paths.ApiConfigPath, text);
                     }
 
+#if SMAPI_DEPRECATED
                     // remove obsolete appdata mods
                     this.InteractivelyRemoveAppDataMods(paths.ModsDir, bundledModsDir);
+#endif
                 }
             }
             Console.WriteLine();
@@ -805,6 +809,7 @@ namespace StardewModdingApi.Installer
             }
         }
 
+#if SMAPI_DEPRECATED
         /// <summary>Interactively move mods out of the app data directory.</summary>
         /// <param name="properModsDir">The directory which should contain all mods.</param>
         /// <param name="packagedModsDir">The installer directory containing packaged mods.</param>
@@ -887,6 +892,7 @@ namespace StardewModdingApi.Installer
                 directory.Delete(recursive: true);
             }
         }
+#endif
 
         /// <summary>Get whether a file or folder should be copied from the installer files.</summary>
         /// <param name="entry">The file or folder info.</param>

From be086cf0056294bc5643bde3bb5b7b73aa4b362f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 22 Jun 2022 01:53:37 -0400
Subject: [PATCH 690/856] avoid unneeded overhead of ConcurrentQueue

---
 docs/release-notes.md               |  3 ++
 src/SMAPI/Framework/CommandQueue.cs | 47 +++++++++++++++++++++++++++++
 src/SMAPI/Framework/SCore.cs        | 43 +++++++++++++-------------
 3 files changed, 72 insertions(+), 21 deletions(-)
 create mode 100644 src/SMAPI/Framework/CommandQueue.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 16b47670..622a146a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Minor optimizations.
+
 * For the web UI:
   * Fixed the mod count in the log parser metadata.
 
diff --git a/src/SMAPI/Framework/CommandQueue.cs b/src/SMAPI/Framework/CommandQueue.cs
new file mode 100644
index 00000000..c51016ad
--- /dev/null
+++ b/src/SMAPI/Framework/CommandQueue.cs
@@ -0,0 +1,47 @@
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+
+namespace StardewModdingAPI.Framework
+{
+    /// <summary>A thread-safe command queue optimized for infrequent changes.</summary>
+    internal class CommandQueue
+    {
+        /********
+        ** Fields
+        ********/
+        /// <summary>The underlying list of queued commands to parse and execute.</summary>
+        private readonly List<string> RawCommandQueue = new();
+
+
+        /********
+        ** Public methods
+        ********/
+        /// <summary>Add a command to the queue.</summary>
+        /// <param name="command">The command to add.</param>
+        public void Add(string command)
+        {
+            lock (this.RawCommandQueue)
+                this.RawCommandQueue.Add(command);
+        }
+
+        /// <summary>Remove and return all queued commands, if any.</summary>
+        /// <param name="queued">The commands that were dequeued, in the order they were originally queued.</param>
+        /// <returns>Returns whether any values were dequeued.</returns>
+        [SuppressMessage("ReSharper", "InconsistentlySynchronizedField", Justification = "Deliberately check if it's empty before locking unnecessarily.")]
+        public bool TryDequeue([NotNullWhen(true)] out string[]? queued)
+        {
+            if (this.RawCommandQueue.Count is 0)
+            {
+                queued = null;
+                return false;
+            }
+
+            lock (this.RawCommandQueue)
+            {
+                queued = this.RawCommandQueue.ToArray();
+                this.RawCommandQueue.Clear();
+                return queued.Length > 0;
+            }
+        }
+    }
+}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index ff3eadf5..cc332225 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
@@ -147,8 +146,7 @@ namespace StardewModdingAPI.Framework
 #endif
 
         /// <summary>A list of queued commands to parse and execute.</summary>
-        /// <remarks>This property must be thread-safe, since it's accessed from a separate console input thread.</remarks>
-        private readonly ConcurrentQueue<string> RawCommandQueue = new();
+        private readonly CommandQueue RawCommandQueue = new();
 
         /// <summary>A list of commands to execute on each screen.</summary>
         private readonly PerScreen<List<QueuedCommand>> ScreenCommandQueue = new(() => new List<QueuedCommand>());
@@ -437,7 +435,7 @@ namespace StardewModdingAPI.Framework
                 () => this.LogManager.RunConsoleInputLoop(
                     commandManager: this.CommandManager,
                     reloadTranslations: this.ReloadTranslations,
-                    handleInput: input => this.RawCommandQueue.Enqueue(input),
+                    handleInput: input => this.RawCommandQueue.Add(input),
                     continueWhile: () => this.IsGameRunning && !this.CancellationToken.IsCancellationRequested
                 )
             ).Start();
@@ -525,29 +523,32 @@ namespace StardewModdingAPI.Framework
                 /*********
                 ** Parse commands
                 *********/
-                while (this.RawCommandQueue.TryDequeue(out string? rawInput))
+                if (this.RawCommandQueue.TryDequeue(out string[]? rawCommands))
                 {
-                    // parse command
-                    string? name;
-                    string[]? args;
-                    Command? command;
-                    int screenId;
-                    try
+                    foreach (string rawInput in rawCommands)
                     {
-                        if (!this.CommandManager.TryParse(rawInput, out name, out args, out command, out screenId))
+                        // parse command
+                        string? name;
+                        string[]? args;
+                        Command? command;
+                        int screenId;
+                        try
                         {
-                            this.Monitor.Log("Unknown command; type 'help' for a list of available commands.", LogLevel.Error);
+                            if (!this.CommandManager.TryParse(rawInput, out name, out args, out command, out screenId))
+                            {
+                                this.Monitor.Log("Unknown command; type 'help' for a list of available commands.", LogLevel.Error);
+                                continue;
+                            }
+                        }
+                        catch (Exception ex)
+                        {
+                            this.Monitor.Log($"Failed parsing that command:\n{ex.GetLogSummary()}", LogLevel.Error);
                             continue;
                         }
-                    }
-                    catch (Exception ex)
-                    {
-                        this.Monitor.Log($"Failed parsing that command:\n{ex.GetLogSummary()}", LogLevel.Error);
-                        continue;
-                    }
 
-                    // queue command for screen
-                    this.ScreenCommandQueue.GetValueForScreen(screenId).Add(new(command, name, args));
+                        // queue command for screen
+                        this.ScreenCommandQueue.GetValueForScreen(screenId).Add(new(command, name, args));
+                    }
                 }
 
 

From 1021c3291088d8e47dc23c608aaa7ff1f81c9fd7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 22 Jun 2022 20:15:25 -0400
Subject: [PATCH 691/856] update fluent HTTP client

---
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj | 2 +-
 src/SMAPI.Web/SMAPI.Web.csproj         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index e021993f..7b79105f 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -11,7 +11,7 @@
   <ItemGroup>
     <PackageReference Include="HtmlAgilityPack" Version="1.11.43" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
+    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
     <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
     <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
   </ItemGroup>
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index 4c2569e1..0a460e9e 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="6.0.5" />
     <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.14" />
     <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.5" />
-    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.0" />
+    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
   </ItemGroup>
   <ItemGroup>
     <DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="1.0.1" />

From 525ca7c9c99272c5aff557545c285f4307526589 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 24 Jun 2022 02:06:25 -0400
Subject: [PATCH 692/856] fix config.user.json overrides no longer applied

---
 docs/release-notes.md                 |  1 +
 src/SMAPI/Framework/Models/SConfig.cs | 30 +++++++++++++++------------
 2 files changed, 18 insertions(+), 13 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 622a146a..8920662f 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,7 @@
 ## Upcoming release
 * For players:
   * Minor optimizations.
+  * Fixed `smapi-internal/config.user.json` overrides not applied after SMAPI 3.14.0.
 
 * For the web UI:
   * Fixed the mod count in the log parser metadata.
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index baef6144..62b15405 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -38,45 +38,49 @@ namespace StardewModdingAPI.Framework.Models
         /********
         ** Accessors
         ********/
+        //
+        // Note: properties must be writable to support merging config.user.json into it.
+        //
+
         /// <summary>Whether to enable development features.</summary>
-        public bool DeveloperMode { get; private set; }
+        public bool DeveloperMode { get; set; }
 
         /// <summary>Whether to check for newer versions of SMAPI and mods on startup.</summary>
-        public bool CheckForUpdates { get; }
+        public bool CheckForUpdates { get; set; }
 
         /// <summary>Whether to add a section to the 'mod issues' list for mods which which directly use potentially sensitive .NET APIs like file or shell access.</summary>
-        public bool ParanoidWarnings { get; }
+        public bool ParanoidWarnings { get; set; }
 
         /// <summary>Whether to show beta versions as valid updates.</summary>
-        public bool UseBetaChannel { get; }
+        public bool UseBetaChannel { get; set; }
 
         /// <summary>SMAPI's GitHub project name, used to perform update checks.</summary>
-        public string GitHubProjectName { get; }
+        public string GitHubProjectName { get; set; }
 
         /// <summary>The base URL for SMAPI's web API, used to perform update checks.</summary>
-        public string WebApiBaseUrl { get; }
+        public string WebApiBaseUrl { get; set; }
 
         /// <summary>The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</summary>
         /// <remarks>The possible values are "*" (everything is verbose), "SMAPI", (SMAPI itself), or mod IDs.</remarks>
-        public HashSet<string> VerboseLogging { get; }
+        public HashSet<string> VerboseLogging { get; set; }
 
         /// <summary>Whether SMAPI should rewrite mods for compatibility.</summary>
-        public bool RewriteMods { get; }
+        public bool RewriteMods { get; set; }
 
         /// <summary>Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</summary>
-        public bool UseRawImageLoading { get; }
+        public bool UseRawImageLoading { get; set; }
 
         /// <summary>Whether to make SMAPI file APIs case-insensitive, even on Linux.</summary>
-        public bool UseCaseInsensitivePaths { get; }
+        public bool UseCaseInsensitivePaths { get; set; }
 
         /// <summary>Whether SMAPI should log network traffic. Best combined with <see cref="VerboseLogging"/>, which includes network metadata.</summary>
-        public bool LogNetworkTraffic { get; }
+        public bool LogNetworkTraffic { get; set; }
 
         /// <summary>The colors to use for text written to the SMAPI console.</summary>
-        public ColorSchemeConfig ConsoleColors { get; }
+        public ColorSchemeConfig ConsoleColors { get; set; }
 
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
-        public HashSet<string> SuppressUpdateChecks { get; }
+        public HashSet<string> SuppressUpdateChecks { get; set; }
 
 
         /********

From ca9efad7a7949ca87f3ccf7ec4d01332d1fad84b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 24 Jun 2022 17:00:39 -0400
Subject: [PATCH 693/856] avoid cancellation token for tracking exit state

This apparently causes noticeable lag for a minority of players.
---
 src/SMAPI/Framework/SCore.cs | 27 ++++++++++-----------------
 1 file changed, 10 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index cc332225..16c168a0 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -66,8 +66,8 @@ namespace StardewModdingAPI.Framework
         /****
         ** Low-level components
         ****/
-        /// <summary>Tracks whether the game should exit immediately and any pending initialization should be cancelled.</summary>
-        private readonly CancellationTokenSource CancellationToken = new();
+        /// <summary>Whether the game should exit immediately and any pending initialization should be cancelled.</summary>
+        private bool IsExiting;
 
         /// <summary>Manages the SMAPI console window and log file.</summary>
         private readonly LogManager LogManager;
@@ -272,16 +272,6 @@ namespace StardewModdingAPI.Framework
                     new TitleMenuPatcher(this.OnLoadStageChanged)
                 );
 
-                // add exit handler
-                this.CancellationToken.Token.Register(() =>
-                {
-                    if (this.IsGameRunning)
-                    {
-                        this.LogManager.WriteCrashLog();
-                        this.Game.Exit();
-                    }
-                });
-
                 // set window titles
                 this.UpdateWindowTitles();
             }
@@ -358,8 +348,8 @@ namespace StardewModdingAPI.Framework
 
             // dispose core components
             this.IsGameRunning = false;
+            this.IsExiting = true;
             this.ContentCore?.Dispose();
-            this.CancellationToken.Dispose();
             this.Game?.Dispose();
             this.LogManager.Dispose(); // dispose last to allow for any last-second log messages
 
@@ -374,7 +364,7 @@ namespace StardewModdingAPI.Framework
         /// <summary>Initialize mods before the first game asset is loaded. At this point the core content managers are loaded (so mods can load their own assets), but the game is mostly uninitialized.</summary>
         private void InitializeBeforeFirstAssetLoaded()
         {
-            if (this.CancellationToken.IsCancellationRequested)
+            if (this.IsExiting)
             {
                 this.Monitor.Log("SMAPI shutting down: aborting initialization.", LogLevel.Warn);
                 return;
@@ -436,7 +426,7 @@ namespace StardewModdingAPI.Framework
                     commandManager: this.CommandManager,
                     reloadTranslations: this.ReloadTranslations,
                     handleInput: input => this.RawCommandQueue.Add(input),
-                    continueWhile: () => this.IsGameRunning && !this.CancellationToken.IsCancellationRequested
+                    continueWhile: () => this.IsGameRunning && !this.IsExiting
                 )
             ).Start();
         }
@@ -479,7 +469,7 @@ namespace StardewModdingAPI.Framework
                 ** Special cases
                 *********/
                 // Abort if SMAPI is exiting.
-                if (this.CancellationToken.IsCancellationRequested)
+                if (this.IsExiting)
                 {
                     this.Monitor.Log("SMAPI shutting down: aborting update.");
                     return;
@@ -2233,7 +2223,10 @@ namespace StardewModdingAPI.Framework
         private void ExitGameImmediately(string message)
         {
             this.Monitor.LogFatal(message);
-            this.CancellationToken.Cancel();
+            this.LogManager.WriteCrashLog();
+
+            this.IsExiting = true;
+            this.Game.Exit();
         }
 
         /// <summary>Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</summary>

From bbc476a2cf3cbe1d7600f630c54a3c66c5146eb1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 26 Jun 2022 14:41:35 -0400
Subject: [PATCH 694/856] split local deploy into its own targets file

---
 build/common.targets             | 80 +++++---------------------------
 build/deploy-local-smapi.targets | 69 +++++++++++++++++++++++++++
 build/find-game-folder.targets   |  6 +++
 src/SMAPI.sln                    |  1 +
 4 files changed, 87 insertions(+), 69 deletions(-)
 create mode 100644 build/deploy-local-smapi.targets

diff --git a/build/common.targets b/build/common.targets
index 92fd9a9a..230758bd 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -1,3 +1,9 @@
+<!--
+
+This MSBuild file sets the common configuration and build scripts used by all the projects in this
+repo. It imports the other MSBuild files as needed.
+
+-->
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
@@ -6,6 +12,8 @@
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
     <DefineConstants>$(DefineConstants);SMAPI_DEPRECATED</DefineConstants>
+    <DebugType>pdbonly</DebugType>
+    <DebugSymbols>true</DebugSymbols>
 
     <!--enable nullable annotations, except in .NET Standard 2.0 where they aren't supported-->
     <Nullable Condition="'$(TargetFramework)' != 'netstandard2.0'">enable</Nullable>
@@ -36,79 +44,13 @@
 
   <!--find game folder-->
   <Import Project="find-game-folder.targets" />
-
-  <!-- if game path is invalid, show one user-friendly error instead of a slew of reference errors -->
   <Target Name="ValidateInstallPath" AfterTargets="BeforeBuild">
+    <!-- if game path is invalid, show one user-friendly error instead of a slew of reference errors -->
     <Error Condition="!Exists('$(GamePath)')" Text="Failed to find the game install path automatically. You can specify where to find it; see https://smapi.io/package/custom-game-path." />
   </Target>
 
-  <!-- copy files into game directory and enable debugging -->
-  <Target Name="CopySmapiFiles" AfterTargets="AfterBuild" Condition="'$(CopyToGameFolder)' == 'true'">
-    <CallTarget Targets="CopySMAPI;CopyDefaultMods" />
-  </Target>
-  <Target Name="CopySMAPI" Condition="'$(MSBuildProjectName)' == 'SMAPI'">
-    <ItemGroup>
-      <TranslationFiles Include="$(TargetDir)\i18n\*.json" />
-    </ItemGroup>
-
-    <!-- SMAPI -->
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFolder="$(GamePath)" Condition="$(OS) == 'Windows_NT'" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName)" DestinationFolder="$(GamePath)" Condition="$(OS) != 'Windows_NT'" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)" />
-    <Copy SourceFiles="$(TargetDir)\SMAPI.config.json" DestinationFiles="$(GamePath)\smapi-internal\config.json" />
-    <Copy SourceFiles="$(TargetDir)\SMAPI.metadata.json" DestinationFiles="$(GamePath)\smapi-internal\metadata.json" />
-    <Copy SourceFiles="$(TargetDir)\Newtonsoft.Json.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\TMXTile.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\Pintail.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\smapi-internal\i18n" />
-
-    <!-- Harmony + dependencies -->
-    <Copy SourceFiles="$(TargetDir)\0Harmony.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\0Harmony.xml" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\Mono.Cecil.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Mdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Pdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\MonoMod.Common.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-
-    <!-- .NET dependencies -->
-    <Copy SourceFiles="$(TargetDir)\System.Management.dll" DestinationFolder="$(GamePath)\smapi-internal" Condition="$(OS) == 'Windows_NT'" />
-
-    <!-- Legacy .NET dependencies (remove in SMAPI 4.0.0) -->
-    <Copy SourceFiles="$(TargetDir)\System.Configuration.ConfigurationManager.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\System.Runtime.Caching.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\System.Security.Permissions.dll" DestinationFolder="$(GamePath)\smapi-internal" />
-  </Target>
-
-  <Target Name="CopyDefaultMods" Condition="'$(MSBuildProjectName)' == 'SMAPI.Mods.ConsoleCommands' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.ErrorHandler' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.SaveBackup'">
-    <ItemGroup>
-      <TranslationFiles Include="$(TargetDir)\i18n\*.json" />
-    </ItemGroup>
-
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" Condition="Exists('$(TargetDir)\$(TargetName).pdb')" />
-    <Copy SourceFiles="$(TargetDir)\manifest.json" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" />
-    <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)\i18n" />
-  </Target>
-
-  <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit'" AfterTargets="PostBuildEvent">
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
-  </Target>
-
-  <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces'" AfterTargets="PostBuildEvent">
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
-    <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
-  </Target>
-
-  <!-- common build settings -->
-  <PropertyGroup>
-    <DebugType>pdbonly</DebugType>
-    <DebugSymbols>true</DebugSymbols>
-  </PropertyGroup>
+  <!--deploy local files-->
+  <Import Project="deploy-local-smapi.targets" Condition="'$(CopyToGameFolder)' == 'true'" />
 
   <!-- launch SMAPI through Visual Studio -->
   <PropertyGroup Condition="'$(MSBuildProjectName)' == 'SMAPI'">
diff --git a/build/deploy-local-smapi.targets b/build/deploy-local-smapi.targets
new file mode 100644
index 00000000..80501788
--- /dev/null
+++ b/build/deploy-local-smapi.targets
@@ -0,0 +1,69 @@
+<!--
+
+This MSBuild file copies SMAPI and the bundled mods into the local Stardew Valley folder on build
+to simplify testing. This just avoids needing to run the SMAPI installer each time.
+
+This assumes `find-game-folder.targets` has already been imported and validated.
+
+-->
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <Target Name="CopySmapiFiles" AfterTargets="AfterBuild">
+    <CallTarget Targets="CopySMAPI;CopyDefaultMods" />
+  </Target>
+  <Target Name="CopySMAPI" Condition="'$(MSBuildProjectName)' == 'SMAPI'">
+    <!-- SMAPI -->
+    <ItemGroup>
+      <TranslationFiles Include="$(TargetDir)\i18n\*.json" />
+    </ItemGroup>
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).exe" DestinationFolder="$(GamePath)" Condition="$(OS) == 'Windows_NT'" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName)" DestinationFolder="$(GamePath)" Condition="$(OS) != 'Windows_NT'" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)" />
+    <Copy SourceFiles="$(TargetDir)\SMAPI.config.json" DestinationFiles="$(GamePath)\smapi-internal\config.json" />
+    <Copy SourceFiles="$(TargetDir)\SMAPI.metadata.json" DestinationFiles="$(GamePath)\smapi-internal\metadata.json" />
+    <Copy SourceFiles="$(TargetDir)\Newtonsoft.Json.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\TMXTile.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\Pintail.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\smapi-internal\i18n" />
+
+    <!-- Harmony + dependencies -->
+    <Copy SourceFiles="$(TargetDir)\0Harmony.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\0Harmony.xml" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\Mono.Cecil.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Mdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Pdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\MonoMod.Common.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+
+    <!-- .NET dependencies -->
+    <Copy SourceFiles="$(TargetDir)\System.Management.dll" DestinationFolder="$(GamePath)\smapi-internal" Condition="$(OS) == 'Windows_NT'" />
+
+    <!-- Legacy .NET dependencies (remove in SMAPI 4.0.0) -->
+    <Copy SourceFiles="$(TargetDir)\System.Configuration.ConfigurationManager.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\System.Runtime.Caching.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\System.Security.Permissions.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+  </Target>
+
+  <Target Name="CopyDefaultMods" Condition="'$(MSBuildProjectName)' == 'SMAPI.Mods.ConsoleCommands' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.ErrorHandler' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.SaveBackup'">
+    <ItemGroup>
+      <TranslationFiles Include="$(TargetDir)\i18n\*.json" />
+    </ItemGroup>
+
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" Condition="Exists('$(TargetDir)\$(TargetName).pdb')" />
+    <Copy SourceFiles="$(TargetDir)\manifest.json" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)" />
+    <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)\i18n" />
+  </Target>
+
+  <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit'" AfterTargets="PostBuildEvent">
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
+  </Target>
+
+  <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces'" AfterTargets="PostBuildEvent">
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
+  </Target>
+</Project>
diff --git a/build/find-game-folder.targets b/build/find-game-folder.targets
index ba7cb26c..b73b1169 100644
--- a/build/find-game-folder.targets
+++ b/build/find-game-folder.targets
@@ -1,3 +1,9 @@
+<!--
+
+This MSBuild file detects the Stardew Valley install path if possible, and sets the 'GamePath'
+property.
+
+-->
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <!-- import developer's custom path (if any) -->
   <Import Condition="$(OS) != 'Windows_NT' AND Exists('$(HOME)\stardewvalley.targets')" Project="$(HOME)\stardewvalley.targets" />
diff --git a/src/SMAPI.sln b/src/SMAPI.sln
index 2e5ba0ea..8bf86487 100644
--- a/src/SMAPI.sln
+++ b/src/SMAPI.sln
@@ -27,6 +27,7 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{09CF91E5-5BAB-4650-A200-E5EA9A633046}"
 	ProjectSection(SolutionItems) = preProject
 		..\build\common.targets = ..\build\common.targets
+		..\build\deploy-local-smapi.targets = ..\build\deploy-local-smapi.targets
 		..\build\find-game-folder.targets = ..\build\find-game-folder.targets
 	EndProjectSection
 EndProject

From 8254a821cc7e7c1f6f8e528e70ba8a9956b13bc4 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 26 Jun 2022 15:03:25 -0400
Subject: [PATCH 695/856] copy .NET metadata files on local deploy

---
 build/deploy-local-smapi.targets | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/build/deploy-local-smapi.targets b/build/deploy-local-smapi.targets
index 80501788..cb330e24 100644
--- a/build/deploy-local-smapi.targets
+++ b/build/deploy-local-smapi.targets
@@ -44,6 +44,14 @@ This assumes `find-game-folder.targets` has already been imported and validated.
     <Copy SourceFiles="$(TargetDir)\System.Security.Permissions.dll" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
 
+  <!-- .NET metadata files -->
+  <Target Name="CopyNetMetadata" Condition="'$(MSBuildProjectName)' == 'SMAPI.Installer'" AfterTargets="PostBuildEvent">
+    <Copy SourceFiles="$(TargetDir)\assets\runtimeconfig.json" DestinationFiles="$(GamePath)\StardewModdingAPI.runtimeconfig.json" />
+    <Copy SourceFiles="$(TargetDir)\assets\windows-exe-config.xml" DestinationFiles="$(GamePath)\StardewModdingAPI.exe.config" Condition="$(OS) == 'Windows_NT'" />
+    <Copy SourceFiles="$(GamePath)\Stardew Valley.deps.json" DestinationFiles="$(GamePath)\StardewModdingAPI.deps.json" Condition="!Exists('$(GamePath)\StardewModdingAPI.deps.json')" />
+  </Target>
+
+  <!-- bundled mods -->
   <Target Name="CopyDefaultMods" Condition="'$(MSBuildProjectName)' == 'SMAPI.Mods.ConsoleCommands' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.ErrorHandler' OR '$(MSBuildProjectName)' == 'SMAPI.Mods.SaveBackup'">
     <ItemGroup>
       <TranslationFiles Include="$(TargetDir)\i18n\*.json" />
@@ -55,12 +63,12 @@ This assumes `find-game-folder.targets` has already been imported and validated.
     <Copy SourceFiles="@(TranslationFiles)" DestinationFolder="$(GamePath)\Mods\$(AssemblyName)\i18n" />
   </Target>
 
+  <!-- toolkit -->
   <Target Name="CopyToolkit" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit'" AfterTargets="PostBuildEvent">
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).xml" DestinationFolder="$(GamePath)\smapi-internal" />
   </Target>
-
   <Target Name="CopyToolkitCoreInterfaces" Condition="'$(MSBuildProjectName)' == 'SMAPI.Toolkit.CoreInterfaces'" AfterTargets="PostBuildEvent">
     <Copy SourceFiles="$(TargetDir)\$(TargetName).dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\$(TargetName).pdb" DestinationFolder="$(GamePath)\smapi-internal" />

From 5e1212e99aa7cb8c0333a57fa60236df79b0ac6d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 28 Jun 2022 01:13:11 -0400
Subject: [PATCH 696/856] update schema for Content Patcher 1.27.0

---
 docs/release-notes.md                              | 1 +
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8920662f..4c504150 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -13,6 +13,7 @@
   * Fixed `smapi-internal/config.user.json` overrides not applied after SMAPI 3.14.0.
 
 * For the web UI:
+  * Updated the JSON validator/schema for Content Patcher 1.27.0.
   * Fixed the mod count in the log parser metadata.
 
 ## 3.15.0
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index f0fe74c2..631fbc63 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -14,9 +14,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features, avoid obsolete behavior, and reduce load times.",
             "type": "string",
-            "const": "1.26.0",
+            "pattern": "^1\\.27\\.[0-9]+$",
             "@errorMessages": {
-                "const": "Incorrect value '@value'. You should always use the latest format version (currently 1.26.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
+                "pattern": "Incorrect value '@value'. You should always use the latest format version (currently 1.27.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
             }
         },
         "ConfigSchema": {

From 6d11c41facb2e1397a25110517cc281f87be2caf Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 28 Jun 2022 18:17:27 -0400
Subject: [PATCH 697/856] migrate update checks to FluentHttpClient

WebClient isn't needed for compatibility with macOS after the .NET 5 update in Stardew Valley 1.5.5, and causes noticeable lag for some players even when running on a background thread.
---
 build/deploy-local-smapi.targets              |  4 ++
 build/unix/prepare-install-package.sh         |  2 +-
 build/windows/prepare-install-package.ps1     |  2 +-
 docs/release-notes.md                         |  5 +-
 .../Framework/Clients/WebApi/WebApiClient.cs  | 56 +++++++------------
 src/SMAPI.Toolkit/Serialization/JsonHelper.cs | 26 +++++----
 src/SMAPI.Web/Startup.cs                      |  2 +-
 src/SMAPI/Framework/SCore.cs                  | 44 ++++++++++-----
 src/SMAPI/SMAPI.csproj                        |  1 +
 9 files changed, 78 insertions(+), 64 deletions(-)

diff --git a/build/deploy-local-smapi.targets b/build/deploy-local-smapi.targets
index cb330e24..6ea5f0a2 100644
--- a/build/deploy-local-smapi.targets
+++ b/build/deploy-local-smapi.targets
@@ -35,6 +35,10 @@ This assumes `find-game-folder.targets` has already been imported and validated.
     <Copy SourceFiles="$(TargetDir)\Mono.Cecil.Pdb.dll" DestinationFolder="$(GamePath)\smapi-internal" />
     <Copy SourceFiles="$(TargetDir)\MonoMod.Common.dll" DestinationFolder="$(GamePath)\smapi-internal" />
 
+    <!-- FluentHttpClient + dependencies -->
+    <Copy SourceFiles="$(TargetDir)\Pathoschild.Http.Client.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+    <Copy SourceFiles="$(TargetDir)\System.Net.Http.Formatting.dll" DestinationFolder="$(GamePath)\smapi-internal" />
+
     <!-- .NET dependencies -->
     <Copy SourceFiles="$(TargetDir)\System.Management.dll" DestinationFolder="$(GamePath)\smapi-internal" Condition="$(OS) == 'Windows_NT'" />
 
diff --git a/build/unix/prepare-install-package.sh b/build/unix/prepare-install-package.sh
index 01cd2080..1d805e00 100755
--- a/build/unix/prepare-install-package.sh
+++ b/build/unix/prepare-install-package.sh
@@ -134,7 +134,7 @@ for folder in ${folders[@]}; do
     cp -r "$smapiBin/i18n" "$bundlePath/smapi-internal"
 
     # bundle smapi-internal
-    for name in "0Harmony.dll" "0Harmony.xml" "Mono.Cecil.dll" "Mono.Cecil.Mdb.dll" "Mono.Cecil.Pdb.dll" "MonoMod.Common.dll" "Newtonsoft.Json.dll" "Pintail.dll" "TMXTile.dll" "SMAPI.Toolkit.dll" "SMAPI.Toolkit.pdb" "SMAPI.Toolkit.xml" "SMAPI.Toolkit.CoreInterfaces.dll" "SMAPI.Toolkit.CoreInterfaces.pdb" "SMAPI.Toolkit.CoreInterfaces.xml"; do
+    for name in "0Harmony.dll" "0Harmony.xml" "Mono.Cecil.dll" "Mono.Cecil.Mdb.dll" "Mono.Cecil.Pdb.dll" "MonoMod.Common.dll" "Newtonsoft.Json.dll" "Pathoschild.Http.Client.dll" "Pintail.dll" "TMXTile.dll" "SMAPI.Toolkit.dll" "SMAPI.Toolkit.pdb" "SMAPI.Toolkit.xml" "SMAPI.Toolkit.CoreInterfaces.dll" "SMAPI.Toolkit.CoreInterfaces.pdb" "SMAPI.Toolkit.CoreInterfaces.xml" "System.Net.Http.Formatting.dll"; do
         cp "$smapiBin/$name" "$bundlePath/smapi-internal"
     done
 
diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index 7e3c6c86..87a4fe01 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -154,7 +154,7 @@ foreach ($folder in $folders) {
     cp -Recurse "$smapiBin/i18n" "$bundlePath/smapi-internal"
 
     # bundle smapi-internal
-    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "Pintail.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml")) {
+    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "Pathoschild.Http.Client.dll", "Pintail.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml", "System.Net.Http.Formatting.dll")) {
         cp "$smapiBin/$name" "$bundlePath/smapi-internal"
     }
 
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4c504150..414396f4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,9 +9,12 @@
 
 ## Upcoming release
 * For players:
-  * Minor optimizations.
+  * Fixed lag which occurred for some players since Stardew Valley 1.5.5.
   * Fixed `smapi-internal/config.user.json` overrides not applied after SMAPI 3.14.0.
 
+* For mod authors:
+  * The [FluentHttpClient package](https://github.com/Pathoschild/FluentHttpClient#readme) is now loaded by SMAPI.
+
 * For the web UI:
   * Updated the JSON validator/schema for Content Patcher 1.27.0.
   * Fixed the mod count in the log parser metadata.
diff --git a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
index d4282617..ef1904d4 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/WebApi/WebApiClient.cs
@@ -1,27 +1,24 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Net;
-using Newtonsoft.Json;
+using System.Threading.Tasks;
+using Pathoschild.Http.Client;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
 {
     /// <summary>Provides methods for interacting with the SMAPI web API.</summary>
-    public class WebApiClient
+    public class WebApiClient : IDisposable
     {
         /*********
         ** Fields
         *********/
-        /// <summary>The base URL for the web API.</summary>
-        private readonly Uri BaseUrl;
-
         /// <summary>The API version number.</summary>
         private readonly ISemanticVersion Version;
 
-        /// <summary>The JSON serializer settings to use.</summary>
-        private readonly JsonSerializerSettings JsonSettings = new JsonHelper().JsonSettings;
+        /// <summary>The underlying HTTP client.</summary>
+        private readonly IClient Client;
 
 
         /*********
@@ -32,8 +29,11 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         /// <param name="version">The web API version.</param>
         public WebApiClient(string baseUrl, ISemanticVersion version)
         {
-            this.BaseUrl = new Uri(baseUrl);
             this.Version = version;
+            this.Client = new FluentClient(baseUrl)
+                .SetUserAgent($"SMAPI/{version}");
+
+            this.Client.Formatters.JsonFormatter.SerializerSettings = JsonHelper.CreateDefaultSettings();
         }
 
         /// <summary>Get metadata about a set of mods from the web API.</summary>
@@ -42,36 +42,22 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
         /// <param name="gameVersion">The Stardew Valley version installed by the player.</param>
         /// <param name="platform">The OS on which the player plays.</param>
         /// <param name="includeExtendedMetadata">Whether to include extended metadata for each mod.</param>
-        public IDictionary<string, ModEntryModel> GetModInfo(ModSearchEntryModel[] mods, ISemanticVersion apiVersion, ISemanticVersion gameVersion, Platform platform, bool includeExtendedMetadata = false)
+        public async Task<IDictionary<string, ModEntryModel>> GetModInfoAsync(ModSearchEntryModel[] mods, ISemanticVersion apiVersion, ISemanticVersion gameVersion, Platform platform, bool includeExtendedMetadata = false)
         {
-            return this.Post<ModSearchModel, ModEntryModel[]>(
-                $"v{this.Version}/mods",
-                new ModSearchModel(mods, apiVersion, gameVersion, platform, includeExtendedMetadata)
-            ).ToDictionary(p => p.ID);
+            ModEntryModel[] result = await this.Client
+                .PostAsync(
+                    $"v{this.Version}/mods",
+                    new ModSearchModel(mods, apiVersion, gameVersion, platform, includeExtendedMetadata)
+                )
+                .As<ModEntryModel[]>();
+
+            return result.ToDictionary(p => p.ID);
         }
 
-
-        /*********
-        ** Private methods
-        *********/
-        /// <summary>Fetch the response from the backend API.</summary>
-        /// <typeparam name="TBody">The body content type.</typeparam>
-        /// <typeparam name="TResult">The expected response type.</typeparam>
-        /// <param name="url">The request URL, optionally excluding the base URL.</param>
-        /// <param name="content">The body content to post.</param>
-        private TResult Post<TBody, TResult>(string url, TBody content)
+        /// <inheritdoc />
+        public void Dispose()
         {
-            // note: avoid HttpClient for macOS compatibility
-            using WebClient client = new();
-
-            Uri fullUrl = new(this.BaseUrl, url);
-            string data = JsonConvert.SerializeObject(content);
-
-            client.Headers["Content-Type"] = "application/json";
-            client.Headers["User-Agent"] = $"SMAPI/{this.Version}";
-            string response = client.UploadString(fullUrl, data);
-            return JsonConvert.DeserializeObject<TResult>(response, this.JsonSettings)
-                ?? throw new InvalidOperationException($"Could not parse the response from POST {url}.");
+            this.Client.Dispose();
         }
     }
 }
diff --git a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
index 1a003c51..a5d7e2e8 100644
--- a/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
+++ b/src/SMAPI.Toolkit/Serialization/JsonHelper.cs
@@ -15,21 +15,27 @@ namespace StardewModdingAPI.Toolkit.Serialization
         ** Accessors
         *********/
         /// <summary>The JSON settings to use when serializing and deserializing files.</summary>
-        public JsonSerializerSettings JsonSettings { get; } = new()
-        {
-            Formatting = Formatting.Indented,
-            ObjectCreationHandling = ObjectCreationHandling.Replace, // avoid issue where default ICollection<T> values are duplicated each time the config is loaded
-            Converters = new List<JsonConverter>
-            {
-                new SemanticVersionConverter(),
-                new StringEnumConverter()
-            }
-        };
+        public JsonSerializerSettings JsonSettings { get; } = JsonHelper.CreateDefaultSettings();
 
 
         /*********
         ** Public methods
         *********/
+        /// <summary>Create an instance of the default JSON serializer settings.</summary>
+        public static JsonSerializerSettings CreateDefaultSettings()
+        {
+            return new()
+            {
+                Formatting = Formatting.Indented,
+                ObjectCreationHandling = ObjectCreationHandling.Replace, // avoid issue where default ICollection<T> values are duplicated each time the config is loaded
+                Converters = new List<JsonConverter>
+                {
+                    new SemanticVersionConverter(),
+                    new StringEnumConverter()
+                }
+            };
+        }
+
         /// <summary>Read a JSON file.</summary>
         /// <typeparam name="TModel">The model type.</typeparam>
         /// <param name="fullPath">The absolute file path.</param>
diff --git a/src/SMAPI.Web/Startup.cs b/src/SMAPI.Web/Startup.cs
index 9980d00c..54c25979 100644
--- a/src/SMAPI.Web/Startup.cs
+++ b/src/SMAPI.Web/Startup.cs
@@ -199,7 +199,7 @@ namespace StardewModdingAPI.Web
         /// <param name="settings">The serializer settings to edit.</param>
         private void ConfigureJsonNet(JsonSerializerSettings settings)
         {
-            foreach (JsonConverter converter in new JsonHelper().JsonSettings.Converters)
+            foreach (JsonConverter converter in JsonHelper.CreateDefaultSettings().Converters)
                 settings.Converters.Add(converter);
 
             settings.Formatting = Formatting.Indented;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 16c168a0..fdfe70fc 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -10,6 +10,7 @@ using System.Runtime.ExceptionServices;
 using System.Security;
 using System.Text;
 using System.Threading;
+using System.Threading.Tasks;
 using Microsoft.Xna.Framework;
 #if SMAPI_FOR_WINDOWS
 using Microsoft.Win32;
@@ -406,7 +407,7 @@ namespace StardewModdingAPI.Framework
                 this.CheckForSoftwareConflicts();
 
                 // check for updates
-                this.CheckForUpdatesAsync(mods);
+                _ = this.CheckForUpdatesAsync(mods); // ignore task since the main thread doesn't need to wait for it
             }
 
             // update window titles
@@ -1450,16 +1451,15 @@ namespace StardewModdingAPI.Framework
 
         /// <summary>Asynchronously check for a new version of SMAPI and any installed mods, and print alerts to the console if an update is available.</summary>
         /// <param name="mods">The mods to include in the update check (if eligible).</param>
-        private void CheckForUpdatesAsync(IModMetadata[] mods)
+        private async Task CheckForUpdatesAsync(IModMetadata[] mods)
         {
-            if (!this.Settings.CheckForUpdates)
-                return;
-
-            new Thread(() =>
+            try
             {
+                if (!this.Settings.CheckForUpdates)
+                    return;
+
                 // create client
-                string url = this.Settings.WebApiBaseUrl;
-                WebApiClient client = new(url, Constants.ApiVersion);
+                using WebApiClient client = new(this.Settings.WebApiBaseUrl, Constants.ApiVersion);
                 this.Monitor.Log("Checking for updates...");
 
                 // check SMAPI version
@@ -1469,9 +1469,15 @@ namespace StardewModdingAPI.Framework
                     try
                     {
                         // fetch update check
-                        ModEntryModel response = client.GetModInfo(new[] { new ModSearchEntryModel("Pathoschild.SMAPI", Constants.ApiVersion, new[] { $"GitHub:{this.Settings.GitHubProjectName}" }) }, apiVersion: Constants.ApiVersion, gameVersion: Constants.GameVersion, platform: Constants.Platform).Single().Value;
-                        updateFound = response.SuggestedUpdate?.Version;
-                        updateUrl = response.SuggestedUpdate?.Url;
+                        IDictionary<string, ModEntryModel> response = await client.GetModInfoAsync(
+                            mods: new[] { new ModSearchEntryModel("Pathoschild.SMAPI", Constants.ApiVersion, new[] { $"GitHub:{this.Settings.GitHubProjectName}" }) },
+                            apiVersion: Constants.ApiVersion,
+                            gameVersion: Constants.GameVersion,
+                            platform: Constants.Platform
+                        );
+                        ModEntryModel updateInfo = response.Single().Value;
+                        updateFound = updateInfo.SuggestedUpdate?.Version;
+                        updateUrl = updateInfo.SuggestedUpdate?.Url;
 
                         // log message
                         if (updateFound != null)
@@ -1480,10 +1486,10 @@ namespace StardewModdingAPI.Framework
                             this.Monitor.Log("   SMAPI okay.");
 
                         // show errors
-                        if (response.Errors.Any())
+                        if (updateInfo.Errors.Any())
                         {
                             this.Monitor.Log("Couldn't check for a new version of SMAPI. This won't affect your game, but you may not be notified of new versions if this keeps happening.", LogLevel.Warn);
-                            this.Monitor.Log($"Error: {string.Join("\n", response.Errors)}");
+                            this.Monitor.Log($"Error: {string.Join("\n", updateInfo.Errors)}");
                         }
                     }
                     catch (Exception ex)
@@ -1523,7 +1529,7 @@ namespace StardewModdingAPI.Framework
 
                         // fetch results
                         this.Monitor.Log($"   Checking for updates to {searchMods.Count} mods...");
-                        IDictionary<string, ModEntryModel> results = client.GetModInfo(searchMods.ToArray(), apiVersion: Constants.ApiVersion, gameVersion: Constants.GameVersion, platform: Constants.Platform);
+                        IDictionary<string, ModEntryModel> results = await client.GetModInfoAsync(searchMods.ToArray(), apiVersion: Constants.ApiVersion, gameVersion: Constants.GameVersion, platform: Constants.Platform);
 
                         // extract update alerts & errors
                         var updates = new List<Tuple<IModMetadata, ISemanticVersion, string>>();
@@ -1573,7 +1579,15 @@ namespace StardewModdingAPI.Framework
                         );
                     }
                 }
-            }).Start();
+            }
+            catch (Exception ex)
+            {
+                this.Monitor.Log("Couldn't check for updates. This won't affect your game, but you won't be notified of SMAPI or mod updates if this keeps happening.", LogLevel.Warn);
+                this.Monitor.Log(ex is WebException && ex.InnerException == null
+                    ? ex.Message
+                    : ex.ToString()
+                );
+            }
         }
 
         /// <summary>Create a directory path if it doesn't exist.</summary>
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 3abefeab..c05512e9 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -25,6 +25,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="22.3.5.1" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
+    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
     <PackageReference Include="Pintail" Version="2.2.0" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />

From 0c0f7898f4ff3b2e4afdbdc438674b30be7dacc7 Mon Sep 17 00:00:00 2001
From: TehPers <tehperz@gmail.com>
Date: Tue, 28 Jun 2022 16:37:58 -0700
Subject: [PATCH 698/856] Search assembly directory for dependencies

---
 src/SMAPI/Framework/ModLoading/AssemblyLoader.cs | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index eb940c41..bd29a159 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -264,8 +264,18 @@ namespace StardewModdingAPI.Framework.ModLoading
             if (!file.Exists)
                 yield break; // not a local assembly
 
+            // add the assembly's directory temporarily if needed
+            // this is needed by F# mods which bundle FSharp.Core.dll, for example
+            string? temporarySearchDir = null;
+            if (file.DirectoryName is not null && !this.AssemblyDefinitionResolver.GetSearchDirectories().Contains(file.DirectoryName))
+            {
+                this.AssemblyDefinitionResolver.AddSearchDirectory(file.DirectoryName);
+                temporarySearchDir = file.DirectoryName;
+            }
+
             // read assembly
             AssemblyDefinition assembly;
+            try
             {
                 byte[] assemblyBytes = File.ReadAllBytes(file.FullName);
                 Stream readStream = this.TrackForDisposal(new MemoryStream(assemblyBytes));
@@ -286,6 +296,12 @@ namespace StardewModdingAPI.Framework.ModLoading
                     assembly = this.TrackForDisposal(AssemblyDefinition.ReadAssembly(readStream, new ReaderParameters(ReadingMode.Immediate) { AssemblyResolver = assemblyResolver, InMemory = true }));
                 }
             }
+            finally
+            {
+                // clean up temporary search directory
+                if (temporarySearchDir is not null)
+                    this.AssemblyDefinitionResolver.RemoveSearchDirectory(temporarySearchDir);
+            }
 
             // skip if already visited
             if (visitedAssemblyNames.Contains(assembly.Name.Name))

From 6b411d1dee49a636a8a8c9a88d9cfc0720c7c1dd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 28 Jun 2022 20:48:28 -0400
Subject: [PATCH 699/856] fix deprecation check

---
 src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
index 338192af..4c76f417 100644
--- a/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
+++ b/src/SMAPI.Toolkit/Framework/ModData/ModWarning.cs
@@ -18,7 +18,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModData
         /// <summary>The mod patches the game in a way that may impact stability.</summary>
         PatchesGame = 4,
 
-#if SMAPI_FOR_WINDOWS
+#if SMAPI_DEPRECATED
         /// <summary>The mod uses the <c>dynamic</c> keyword which won't work on Linux/macOS.</summary>
         [Obsolete("This value is no longer used by SMAPI and will be removed in the upcoming SMAPI 4.0.0.")]
         UsesDynamic = 8,

From bd88727948fc8066ec7d788ff4647b4c78168b3d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 28 Jun 2022 20:48:58 -0400
Subject: [PATCH 700/856] remove obsolete override

SMAPI no longer raises UsesDynamic warnings.
---
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 16a89647..4e6f4669 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -107,12 +107,6 @@
             "Default | UpdateKey": "Nexus:1726"
         },
 
-        "Rubydew": {
-            "ID": "bwdy.rubydew",
-            "SuppressWarnings": "UsesDynamic", // mod explicitly loads DLLs for Linux/macOS compatibility
-            "Default | UpdateKey": "Nexus:3656"
-        },
-
         "SpaceCore": {
             "ID": "spacechase0.SpaceCore",
             "Default | UpdateKey": "Nexus:1348"

From d717e246b67bd1b019dab26562be1dfdc8edc73a Mon Sep 17 00:00:00 2001
From: Ishan Jalan <44338423+strobel1ght@users.noreply.github.com>
Date: Sat, 2 Jul 2022 08:42:35 +0530
Subject: [PATCH 701/856] Current version in mod check

Added "(You have x.x.x)" to the mod update check.
---
 .DS_Store                    | Bin 0 -> 10244 bytes
 build/.DS_Store              | Bin 0 -> 6148 bytes
 src/.DS_Store                | Bin 0 -> 8196 bytes
 src/SMAPI/.DS_Store          | Bin 0 -> 6148 bytes
 src/SMAPI/Framework/SCore.cs |   2 +-
 src/SMAPI/SMAPI.sln          |  25 +++++++++++++++++++++++++
 6 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 .DS_Store
 create mode 100644 build/.DS_Store
 create mode 100644 src/.DS_Store
 create mode 100644 src/SMAPI/.DS_Store
 create mode 100644 src/SMAPI/SMAPI.sln

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..ba9468ef9378d82e8b742a8dcd4010c8c1d73e35
GIT binary patch
literal 10244
zcmeHMU2GIp6u#fIrL%OP1GKha2R2=ZfGw;AZ23#Jf69N6ZRxiBEW0}+9hlCPo!xD*
z)HEhO2%_;x<6q>-zsQ4%7+-u)6n#`Q!5AMf8udjJd{KGu%)PUeZt+bMftlpanRD(r
z_wM=TJ9qcqWsIRCuiwX5m@y_(^Q5ZK?IxGk@3k41<XgN>P&{LLdej|BTTXh0Z(s-z
z2oMMm2oMMm2oU&xAVA;Q-X&KF8QcQ|0t5mCt|Q>B4`FJajQMg>NWOH?jc)-+mXn!Z
z^i2Bz9uxLu%$Jiw@=zL6>>l8U!rx**gj0Xmb0-<|<)n}zoI!*$_%p-bp@7d$abfPx
z5EC-E2M7cR%tXK|n+ld@d1f+e+W!4~dc-o_Tr~PMq_XmgS(S37TqPff4>_apTq>7$
zJ5t$wp4RI)R=W6{O7As|(WF|_>DalHX&YG{VCn|B?C&>i-5Kq0^0w~s*tqDBLvkpo
z){T$1wKj#<Mxzr=;qmn?QF>l;|HMQ{u8pkTxF>nk8n&G$L=N!R0XC;3r<2nYD#Ww4
z<=BVG>P3_@ojEMS+#3!mZsA0)r&E$<8FN{dWp0lo{bVe+&?%0V%Hl<8ep94oXm*t{
zN9#`v4DM5s>ihz6uxBJ^I<~vl$hstxYPCyT-I{Ui-C4uy@6R|^e%N-C>by+K%H*w7
z&S<x+xcP`dwrV$%bu4SQ<C@+u1Bsk5mh<{%bR`B|C!6c!gC$HFUwEl`*Vtpwpk~47
zqM_ZI5~3n>c5dC0rOTUJS~tbIx9)uCQnfm7{sN^|8Kk1HbLPXQksV068N=31`*7c=
zspp3J3#MzPEu+^?4I80(XbN4bu3xz5?gmX04pRX|*F-*T9?P4#<7z~f`5a-bQQ5E4
zXWHrL-YmMTo}+PS_GMb5w$JP7%o=pp{eTtPy-Kf3$;)a=IIdEnO7Bss=8)<N%Nk{!
z)@P;Ch80qEF;APaLF+FF{6p$?Vce|LYKe?9JWMINAz^FRI<<q|v^!F6u4lxsy^nNJ
z^gTd*gYHl&YxIoLYT|#QZDi%Il<Zzmw{GSf-brZeYSgp=Z@6|{=Q%8@Us$chwLV$>
zLQblxX%|dd!RWP$g-njbIw$$tiNsclw-hP9EDm%e78QDkex+!vg>|tV>=0GhI6KXr
zV`tdA>;n6QeZ{_GKeMas4*;`JiP@+^4HjW3ny?P7Xv2DRpa;9L2XXAj5KJ6_i!mI>
zI8NYkoWv=d##49}FX3gpf-`snZ{r=D!+ZD;7x5WB$CtQ*@9_hE#IN`hf8m-`A=OFs
z(n6_GYLc3zRZ^?eCT);5O1q>UDIuk#Ba$PHi3FtLvU#AGpl?4;a;nh$GhFHH%?qvJ
z!7W?2ZNGI2?ebh+S~azI)rFU>T)nn!bNh7)3eFa3dL#Kc<EPaLXFO*_30p7m8dMf9
zDHh#S8H%#(qf#-(WUpe?O5Z!ORHjl<D|~hN3R1VLvxM5vyh^6BR3)w|4J~UzRD5cg
zuQs=m3ZW<)H-)GS)pB2593z!+rJ<p#n})fl%KsL}FS9G`C-xh=MjW4u1*pe8h!V3q
zum!s~x8vx;K_qbqY3LY+4F|`F<tH$KM=^=Vh~rNZ%b&(Gcpfj{MPmA^cnz=PO}s@s
zKacnE0Y1XVxPVW6#(ztE{{>e|IJ|Q@hw=LqhfBT>r#l8(fIxsifIxsifWV!MK$%EB
z?4AF2|MUO<cQQml?g0X~Jpw52ig$HTn#IjwX~y1JdzjiGYTo7fO$y0F=*ExZN%G@(
uQoM7;<<vZ1fAh?rW4>)tNFGi;Je;IB&HvB;3<&oB!T#Srg1S@p|9=DT*dLw%

literal 0
HcmV?d00001

diff --git a/build/.DS_Store b/build/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..decdd55791f83b4535087de523bd19903adeb123
GIT binary patch
literal 6148
zcmeHK%}T>S5T5OiO(;SRiXH=A3&tP(!Aq$11&ruHr8cH$Fz!mz7@-t$)fe(jd>&_Z
zx5c*hD$?%2>^D0*lQ7?g-3$P*W)|%LH~?Uw5|(Tnei2$Hosp9ER1q0HBh1s6FcBfn
zKWCzi<3BP$dsl%BIK=SwbN|AZBu@LD_r*%(N_C}X)vUU88$60U=y&>A+U)eMX?7t*
z5{~Rnco}!|wzGCBc)t_#Zciq}Q5QpQu3{dEyeTpsr7|~A3zlu!ZD(UJI67>&`<^#!
zxP#+e5AD5!;n23$x3*8t+fT_e7w?KghM$|1RgEL~Kx16aYtZ9~;1B4d_!{I`B!>tD
zTIpgGJ5^Ma-X|gM2=OtsG{pu*7%>bO29}lqeTZ81rDebrZWu5O%wvGg2N#vl*H|c&
zM+XkF1wgEzTMF9LOHhuh(brfg#1#~#QV~@u(=7&5>F9TLoUgG^sM3My=7Z@sGu@#u
z`F4E1E5m{L3e9L3FbqsGP*zii?*Fs-{r_Z=nHdHQ0}I6ftF(ev6HC%}>r8QU*Se^8
rs3a6uC>*DtA+KVLrK@-oRSNoDG7x=@g+lb8m>&U2gBc71f6Bl&h3t<r

literal 0
HcmV?d00001

diff --git a/src/.DS_Store b/src/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..da9de5748c191eefcd2ad717f709252d1efa0acc
GIT binary patch
literal 8196
zcmeHMU2GIp6u#fIz>FQ}6pJmx7FMdD*w8J%1wpnge=XEDZ2zg&-JOAsOlRuO>@GqY
zOEek?PyW4PG$!f;8h_%0iqWVsF~(>JiKvM`G5V+piSlARckXP%w(w>mN#`c_o_o%{
z=iWVMzH@KRUB(#N^F|9}^^7r@DyLc%HP<P8oYy%;3MG|9LHdk!W{Tcq#&$Dv=0<|Z
z1Ca+J4@4e_JP>){=I{XB*}TX%xc9|q)J7hNJTNakz|V&`RZf#3ofb4WI;aU!0HQnv
z2nzKn4+wPPAx(yKTF^k1))d(TLREw*2823|$N6-k$&gM9D%2T-IzzZK!VCq$?xYtF
zrZXf3joQcqkq72_fQQclmSWwkjrEr0@9$<NZOii$iA#_wDi<tVBrlSy<OfpYZZYMj
z{k+$n&K>4lpX=J0Qa_y;u*~9^R@>n^e%f-(T%ceXCQTU~v>d}Nw!3-9@B-bG7?2fN
z8Pn=co^0LP6yKCcOf|(%ZrhNc{>Cj+Q;NK-vH9LZW5?_X$2~1<KzI(Y#j|WWQ*My$
z6*|O&M8)QkL6=JgDYsOqi}k+#fkAb6$jZ7-$~s|=Y1JNC)k$n`&Mc5MgIU+kPdMI~
zR+CNJ*}R?h%{JTSlSx+XWpl1=_qv|tTdp%a<eSI+(n4iJLnEG>^E-mY#xyPOnTJeT
z%PN?=X+>IUDc`MUk}u;8m^qJVV=^HORL(D{i`{<by5>#WcDC>By8mLeR<rchT2&n(
z7dpOm#4>aJMa%HVhtpoxbPUTmI#{qgD`T5|PI|(uL6f2cTJ_6yeJG!?9?4t&qgtaZ
z2hxU>x;kpm59xLdzM7%EBa8W~SL*s<KGKmhsWn1{HEVUX&m$*j>2TsbO{&^=jJ~nv
zg<B<BRK4F$XG~i&6tU0dEvi0P5Y}l2LgDsWRUgW_6BA^L7s~G2rRxv!Z4ahBzh}~P
z=qG(1?%hFSBi?vAXZ92cW1(~(NrTTva;~(;uza^Pcz~=J=F7DiMqtBIt)^P<)ep(q
zH!^(=%PCldYx22(x7?UK%b&#<YfP>a-=J~VAEFaDRH+rrOv~@E2DXN^(w)`Ejxd*<
zVrSVo_BQ)~U0`3bOYA518~c-8W&Z$>PyrRoP=|Uf$7(dA1skvtJFp*}=t2rZ7{OtT
z!o<U{F#!ifOyMz1;}p)|X*`SP@I21p6}*bq@D@JCC-@Yf;VWFmclaK^;xGJ-tCA$C
z(qd_eR43I-y0k)CFEvZ8Qk&Ez^+>(q*Gr{v8kw;s=tyZI*PIU&PT~8WbpHC`6x+AI
zvr9dA(}&ZyOGE%IyR9zHqpEdh+YA5&VoM;s7Wx6+%c3N}dw_>oSiMMLwj$P`t|~?0
z?C9*LKrxTYJTA3GV)knF4w(W)TOioA>fJJhh_+C$O|kVd1*IkhtlARWs8Hx>6@qPw
zZB=9qg4wR_P$&qsO2Ia$Nk!3Ez{EOYdt?eEP5!SD{x!SIeq_J1E9@#3q6!*T;VvYw
z1xf71KEm_?bYlR67$#(MTpz(WEF6Q6JYoAdPT+AofhX}4P7}VLA%t^$zknC<5?;o6
zypA{UCf>vQxPTAw5h4ByT*MFf8NbZJad$b6aitu`g;dV5UFRrCOUN%*m=9cqFtVQK
z|9fuy{y!gF5!o1dVBUHFmAg~B+sXVJ9fdsCj#GVzDldHAw4i|sH9<N~G)TvZ&ir9W
e{WwkKI?0eu3rZ3y|I<T&65apN{Xd`Y|9=64n@@rO

literal 0
HcmV?d00001

diff --git a/src/SMAPI/.DS_Store b/src/SMAPI/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..b2c4b00c8b9d1fcd1f987081145e11bb74c759d3
GIT binary patch
literal 6148
zcmeHKOH0E*5T0$TO(;SSiXH=A3&saN@DghE2N=<VN=-=6&@@~6Fo#meRsWFx#NXr0
z?p7?V;7P>J!0b0Wk1YFb*arZJ<|x_)r~`n7N?5Y7Ss)ZAos*LB5DN8;7;=!%hfbK!
zWwYZiGC*r*!v(Hc0A2X9euG|^$`GS(VJ}SvL)U#5rE+CuwQ5zZnsx6#$=n|X!_lA_
z^lzzmC1n~;?I65P;=Em7Ka<%oNV2%E3X&+sl)IZGi)7xEqbwSzT3-h&+p^pB&GGp7
zsNo#A?xf+2Pxf52_YWr%+uGRPIlXLm(rzYSG@Al{JSA%er|^o#f{8u*{VbK)BSxo{
z(+WmrfEi#0mWBbd0a~@CnK4h48DIu}$^h*T4l1E%u+XTs4s7W9Nbw3G3EK3QAao3R
z1`CZCK@qwXQI`ty#1Oh1{f^1=3>F%7IS4f}e#eX~%nL=R(b4aybP%3KZkYjQV3vWh
z?$+u2KmY#yKU>5-W`G&^R}6?s%WpMtO6F{xn;f0B4(bCc3FQ?UKTFV1M=|EoQM`q!
a1pN*fh@QbhBYIHyBA{sCh8g%(20j1`T1^}P

literal 0
HcmV?d00001

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index fdfe70fc..283755d6 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1565,7 +1565,7 @@ namespace StardewModdingAPI.Framework
                             this.Monitor.Newline();
                             this.Monitor.Log($"You can update {updates.Count} mod{(updates.Count != 1 ? "s" : "")}:", LogLevel.Alert);
                             foreach ((IModMetadata mod, ISemanticVersion newVersion, string newUrl) in updates)
-                                this.Monitor.Log($"   {mod.DisplayName} {newVersion}: {newUrl}", LogLevel.Alert);
+                                this.Monitor.Log($"   {mod.DisplayName} {newVersion}: {newUrl} (You have {mod.Manifest.Version}", LogLevel.Alert);
                         }
                         else
                             this.Monitor.Log("   All mods up to date.");
diff --git a/src/SMAPI/SMAPI.sln b/src/SMAPI/SMAPI.sln
new file mode 100644
index 00000000..1821b0b6
--- /dev/null
+++ b/src/SMAPI/SMAPI.sln
@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 16
+VisualStudioVersion = 25.0.1700.5
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SMAPI", "SMAPI.csproj", "{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {FD0C4E68-CA54-4AD5-8171-DA621027A9DF}
+	EndGlobalSection
+EndGlobal

From f44a2fbfcfd06ac82c5b77177b0fd9475757d945 Mon Sep 17 00:00:00 2001
From: Chase Warrington <spacechase0.and.cat@gmail.com>
Date: Mon, 4 Jul 2022 20:42:27 -0400
Subject: [PATCH 702/856] Add app.manifest, fixing DPI awareness

---
 src/SMAPI/SMAPI.csproj |  1 +
 src/SMAPI/app.manifest | 42 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 43 insertions(+)
 create mode 100644 src/SMAPI/app.manifest

diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index c05512e9..1c745702 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -16,6 +16,7 @@
 
     <!-- tiered compilation breaks Harmony -->
     <TieredCompilation>false</TieredCompilation>
+    <ApplicationManifest>app.manifest</ApplicationManifest>
   </PropertyGroup>
 
   <Import Project="..\..\build\common.targets" />
diff --git a/src/SMAPI/app.manifest b/src/SMAPI/app.manifest
new file mode 100644
index 00000000..d209bf77
--- /dev/null
+++ b/src/SMAPI/app.manifest
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="utf-8"?>
+<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
+  <assemblyIdentity version="1.0.0.0" name="Game1"/>
+  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
+    <security>
+      <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
+        <requestedExecutionLevel  level="asInvoker" uiAccess="false" />
+      </requestedPrivileges>
+    </security>
+  </trustInfo>
+
+  <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
+    <application>
+      <!-- A list of the Windows versions that this application has been tested on and is
+           is designed to work with. Uncomment the appropriate elements and Windows will 
+           automatically selected the most compatible environment. -->
+
+      <!-- Windows Vista -->
+      <supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f0}" />
+
+      <!-- Windows 7 -->
+      <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}" />
+
+      <!-- Windows 8 -->
+      <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}" />
+
+      <!-- Windows 8.1 -->
+      <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}" />
+
+      <!-- Windows 10 -->
+      <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
+
+    </application>
+  </compatibility>
+
+  <application xmlns="urn:schemas-microsoft-com:asm.v3">
+    <windowsSettings>
+      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/pm</dpiAware>
+    </windowsSettings>
+  </application>
+
+</assembly>

From f3a4b316b7294fea897514a08c45bc9d926a00c6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 5 Jul 2022 19:01:28 -0400
Subject: [PATCH 703/856] fix PyTK compatibility mode not handling some edge
 cases

---
 docs/release-notes.md                         |  2 ++
 .../ContentManagers/ModContentManager.cs      | 27 +++++--------------
 2 files changed, 8 insertions(+), 21 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 414396f4..3bc8724b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,8 @@
 * For players:
   * Fixed lag which occurred for some players since Stardew Valley 1.5.5.
   * Fixed `smapi-internal/config.user.json` overrides not applied after SMAPI 3.14.0.
+  * Fixed PyTK not rescaling images correctly in some cases.  
+    _When PyTK 1.23.0 or earlier is installed, this will disable the main performance improvements in SMAPI 3.15.0._
 
 * For mod authors:
   * The [FluentHttpClient package](https://github.com/Pathoschild/FluentHttpClient#readme) is now loaded by SMAPI.
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 8c5d0f84..f3cf05d9 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
@@ -47,9 +46,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <summary>If a map tilesheet's image source has no file extensions, the file extensions to check for in the local mod folder.</summary>
         private static readonly string[] LocalTilesheetExtensions = { ".png", ".xnb" };
 
-        /// <summary>A lookup of image file paths to whether they have PyTK scaling information.</summary>
-        private static readonly Dictionary<string, bool> IsPyTkScaled = new(StringComparer.OrdinalIgnoreCase);
-
 
         /*********
         ** Accessors
@@ -211,24 +207,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 if (ModContentManager.EnablePyTkLegacyMode)
                 {
-                    if (!ModContentManager.IsPyTkScaled.TryGetValue(file.FullName, out bool isScaled))
-                    {
-                        string? dirPath = file.DirectoryName;
-                        string fileName = $"{Path.GetFileNameWithoutExtension(file.Name)}.pytk.json";
-
-                        string path = dirPath is not null
-                            ? Path.Combine(dirPath, fileName)
-                            : fileName;
-
-                        ModContentManager.IsPyTkScaled[file.FullName] = isScaled = File.Exists(path);
-                    }
-
-                    asRawData = !isScaled;
-                    if (!asRawData)
-                        this.Monitor.LogOnce("Enabled compatibility mode for PyTK scaled textures. This won't cause any issues, but may impact performance.", LogLevel.Warn);
+                    // PyTK intercepts Texture2D file loads to rescale them (e.g. for HD portraits),
+                    // but doesn't support IRawTextureData loads yet. We can't just check if the
+                    // current file has a '.pytk.json' rescale file though, since PyTK may still
+                    // rescale it if the original asset or another edit gets rescaled.
+                    asRawData = false;
+                    this.Monitor.LogOnce("Enabled compatibility mode for PyTK 1.23.0 or earlier. This won't cause any issues, but may impact performance.", LogLevel.Warn);
                 }
-                else
-                    asRawData = true;
             }
 
             // load

From 0ba4fd1785fc6a6aa931f18552261f33c2a2c0ef Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 5 Jul 2022 22:09:46 -0400
Subject: [PATCH 704/856] detect missing/outdated Error Handler for 'suggested
 fixes' section

---
 docs/release-notes.md                         |   1 +
 .../Framework/LogParsing/LogParser.cs         |   2 +
 .../Framework/LogParsing/Models/LogModInfo.cs |  32 ++++-
 .../Framework/LogParsing/Models/ParsedLog.cs  |   3 +
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 120 ++++++++++--------
 5 files changed, 105 insertions(+), 53 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3bc8724b..8361a780 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,6 +18,7 @@
   * The [FluentHttpClient package](https://github.com/Pathoschild/FluentHttpClient#readme) is now loaded by SMAPI.
 
 * For the web UI:
+  * The log parser now detects a missing or outdated Error Handler mod for its 'suggested fixes' section.
   * Updated the JSON validator/schema for Content Patcher 1.27.0.
   * Fixed the mod count in the log parser metadata.
 
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 7fc8f958..0efa62c5 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -200,6 +200,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             log.GameVersion = match.Groups["gameVersion"].Value;
                             log.OperatingSystem = match.Groups["os"].Value;
                             smapiMod.OverrideVersion(log.ApiVersion);
+
+                            log.ApiVersionParsed = smapiMod.GetParsedVersion();
                         }
 
                         // mod path line
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
index 4b80a830..557f08ff 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
@@ -1,10 +1,19 @@
+using System;
 using System.Diagnostics.CodeAnalysis;
+using StardewModdingAPI.Toolkit;
 
 namespace StardewModdingAPI.Web.Framework.LogParsing.Models
 {
     /// <summary>Metadata about a mod or content pack in the log.</summary>
     public class LogModInfo
     {
+        /*********
+        ** Private fields
+        *********/
+        /// <summary>The parsed mod version, if valid.</summary>
+        private Lazy<ISemanticVersion?> ParsedVersionImpl;
+
+
         /*********
         ** Accessors
         *********/
@@ -68,7 +77,6 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         {
             this.Name = name;
             this.Author = author;
-            this.Version = version;
             this.Description = description;
             this.UpdateVersion = updateVersion;
             this.UpdateLink = updateLink;
@@ -82,6 +90,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
                 this.IsContentPack = !string.IsNullOrWhiteSpace(this.ContentPackFor);
                 this.IsCodeMod = !this.IsContentPack;
             }
+
+            this.OverrideVersion(version);
         }
 
         /// <summary>Add an update alert for this mod.</summary>
@@ -95,9 +105,29 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
 
         /// <summary>Override the version number, for cases like SMAPI itself where the version is only known later during parsing.</summary>
         /// <param name="version">The new mod version.</param>
+        [MemberNotNull(nameof(LogModInfo.Version), nameof(LogModInfo.ParsedVersionImpl))]
         public void OverrideVersion(string version)
         {
             this.Version = version;
+            this.ParsedVersionImpl = new Lazy<ISemanticVersion?>(this.ParseVersion);
+        }
+
+        /// <summary>Get the semantic version for this mod, if it's valid.</summary>
+        public ISemanticVersion? GetParsedVersion()
+        {
+            return this.ParsedVersionImpl.Value;
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Get the semantic version for this mod, if it's valid.</summary>
+        public ISemanticVersion? ParseVersion()
+        {
+            return !string.IsNullOrWhiteSpace(this.Version) && SemanticVersion.TryParse(this.Version, out ISemanticVersion? version)
+                ? version
+                : null;
         }
     }
 }
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
index 6951e434..3f649199 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
@@ -28,6 +28,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         /// <summary>The SMAPI version.</summary>
         public string? ApiVersion { get; set; }
 
+        /// <summary>The parsed SMAPI version, if it's valid.</summary>
+        public ISemanticVersion? ApiVersionParsed { get; set; }
+
         /// <summary>The game version.</summary>
         public string? GameVersion { get; set; }
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 33239a2b..8bf5d86d 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -8,24 +8,29 @@
 @{
     ViewData["Title"] = "SMAPI log parser";
 
+    // get log info
     ParsedLog? log = Model!.ParsedLog;
-
     IDictionary<string, LogModInfo[]> contentPacks = Model.GetContentPacksByMod();
+    ISet<int> screenIds = new HashSet<int>(log?.Messages.Select(p => p.ScreenId) ?? Array.Empty<int>());
+
+    // detect suggested fixes
+    LogModInfo[] outdatedMods = log?.Mods.Where(mod => mod.HasUpdate).ToArray() ?? Array.Empty<LogModInfo>();
+    LogModInfo? errorHandler = log?.Mods.FirstOrDefault(p => p.IsCodeMod && p.Name == "Error Handler");
+    bool hasOlderErrorHandler = errorHandler?.GetParsedVersion() is not null && log?.ApiVersionParsed is not null && log.ApiVersionParsed.IsNewerThan(errorHandler.GetParsedVersion());
+
+    // get filters
     IDictionary<string, bool> defaultFilters = Enum
         .GetValues<LogLevel>()
         .ToDictionary(level => level.ToString().ToLower(), level => level != LogLevel.Trace);
-
     IDictionary<int, string> logLevels = Enum
         .GetValues<LogLevel>()
         .ToDictionary(level => (int)level, level => level.ToString().ToLower());
-
     IDictionary<int, string> logSections = Enum
         .GetValues<LogSection>()
         .ToDictionary(section => (int)section, section => section.ToString());
 
+    // get form
     string curPageUrl = this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID }, absoluteUrl: true)!;
-
-    ISet<int> screenIds = new HashSet<int>(log?.Messages.Select(p => p.ScreenId) ?? Array.Empty<int>());
 }
 
 @section Head {
@@ -69,7 +74,7 @@
             </text>
         }
     </script>
-    
+
     <script>
         $(function() {
             smapi.logParser(
@@ -158,7 +163,7 @@ else if (log?.IsValid == true)
     <div id="os-instructions">
         <div>
             <ul data-tabs>
-                @foreach (Platform platform in new[] {Platform.Android, Platform.Linux, Platform.Mac, Platform.Windows})
+                @foreach (Platform platform in new[] { Platform.Android, Platform.Linux, Platform.Mac, Platform.Windows })
                 {
                     @if (platform == Platform.Windows)
                     {
@@ -237,55 +242,66 @@ else if (log?.IsValid == true)
 @if (log?.IsValid == true)
 {
     <div id="output">
-        @if (log.Mods.Any(mod => mod.HasUpdate))
+        @if (outdatedMods.Any() || errorHandler is null || hasOlderErrorHandler)
         {
             <h2>Suggested fixes</h2>
             <ul id="fix-list">
-                <li>
-                    Consider updating these mods to fix problems:
+                @if (errorHandler is null)
+                {
+                    <li>You don't have the <strong>Error Handler</strong> mod installed. This automatically prevents many game or mod errors. You can <a href="https://stardewvalleywiki.com/Modding:Player_Guide#Install_SMAPI">reinstall SMAPI</a> to re-add it.</li>
+                }
+                @if (hasOlderErrorHandler)
+                {
+                    <li>Your <strong>Error Handler</strong> mod is older than SMAPI. You may be missing some game/mod error fixes. You can <a href="https://stardewvalleywiki.com/Modding:Player_Guide#Install_SMAPI">reinstall SMAPI</a> to update it.</li>
+                }
+                @if (outdatedMods.Any())
+                {
+                    <li>
+                        Consider updating these mods to fix problems:
 
-                    <table id="updates" class="table">
-                        @foreach (LogModInfo mod in log.Mods.Where(mod => (mod.HasUpdate && !mod.IsContentPack) || (contentPacks.TryGetValue(mod.Name, out LogModInfo[]? contentPackList) && contentPackList.Any(pack => pack.HasUpdate))))
-                        {
-                            <tr class="mod-entry">
-                                <td>
-                                    <strong class=@(!mod.HasUpdate ? "hidden" : "")>@mod.Name</strong>
-                                    @if (contentPacks != null && contentPacks.TryGetValue(mod.Name, out LogModInfo[]? contentPackList))
-                                    {
-                                        <div class="content-packs">
-                                            @foreach (LogModInfo contentPack in contentPackList.Where(pack => pack.HasUpdate))
-                                            {
-                                                <text>+ @contentPack.Name</text><br />
-                                            }
-                                        </div>
-                                    }
-                                </td>
-                                <td>
-                                    @if (mod.HasUpdate)
-                                    {
-                                        <a href="@mod.UpdateLink" target="_blank">
-                                            @(mod.Version == null ? mod.UpdateVersion : $"{mod.Version} → {mod.UpdateVersion}")
-                                        </a>
-                                    }
-                                    else
-                                    {
-                                        <text>&nbsp;</text>
-                                    }
+                        <table id="updates" class="table">
+                            @foreach (LogModInfo mod in log.Mods.Where(mod => (mod.HasUpdate && !mod.IsContentPack) || (contentPacks.TryGetValue(mod.Name, out LogModInfo[]? contentPackList) && contentPackList.Any(pack => pack.HasUpdate))))
+                            {
+                                <tr class="mod-entry">
+                                    <td>
+                                        <strong class=@(!mod.HasUpdate ? "hidden" : "")>@mod.Name</strong>
+                                        @if (contentPacks != null && contentPacks.TryGetValue(mod.Name, out LogModInfo[]? contentPackList))
+                                        {
+                                            <div class="content-packs">
+                                                @foreach (LogModInfo contentPack in contentPackList.Where(pack => pack.HasUpdate))
+                                                {
+                                                    <text>+ @contentPack.Name</text><br />
+                                                }
+                                            </div>
+                                        }
+                                    </td>
+                                    <td>
+                                        @if (mod.HasUpdate)
+                                        {
+                                            <a href="@mod.UpdateLink" target="_blank">
+                                                @(mod.Version == null ? mod.UpdateVersion : $"{mod.Version} → {mod.UpdateVersion}")
+                                            </a>
+                                        }
+                                        else
+                                        {
+                                            <text>&nbsp;</text>
+                                        }
 
-                                    @if (contentPacks != null && contentPacks.TryGetValue(mod.Name, out contentPackList))
-                                    {
-                                        <div>
-                                            @foreach (LogModInfo contentPack in contentPackList.Where(pack => pack.HasUpdate))
-                                            {
-                                                <a href="@contentPack.UpdateLink" target="_blank">@contentPack.Version → @contentPack.UpdateVersion</a><br />
-                                            }
-                                        </div>
-                                    }
-                                </td>
-                            </tr>
-                        }
-                    </table>
-                </li>
+                                        @if (contentPacks != null && contentPacks.TryGetValue(mod.Name, out contentPackList))
+                                        {
+                                            <div>
+                                                @foreach (LogModInfo contentPack in contentPackList.Where(pack => pack.HasUpdate))
+                                                {
+                                                    <a href="@contentPack.UpdateLink" target="_blank">@contentPack.Version → @contentPack.UpdateVersion</a><br />
+                                                }
+                                            </div>
+                                        }
+                                    </td>
+                                </tr>
+                            }
+                        </table>
+                    </li>
+                }
             </ul>
         }
 
@@ -434,7 +450,7 @@ else if (log?.IsValid == true)
                 <div>
                     This website uses JavaScript to display a filterable table. To view this log, please enable JavaScript or <a href="@this.Url.PlainAction("Index", "LogParser", new { id = Model.PasteID, format = LogViewFormat.RawView })">view the raw log</a>.
                 </div>
-                <br/>
+                <br />
             </noscript>
 
             <log-table>

From 42099f24eea1a3858d980e707a3333854a14e0e9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 5 Jul 2022 22:36:02 -0400
Subject: [PATCH 705/856] improve log parser's 'suggested fixes' styles

---
 docs/release-notes.md                         |  4 ++-
 src/SMAPI.Web/Views/LogParser/Index.cshtml    |  4 +--
 .../wwwroot/Content/css/log-parser.css        | 34 ++++++++++++++++---
 3 files changed, 35 insertions(+), 7 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8361a780..a94bb295 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -18,7 +18,9 @@
   * The [FluentHttpClient package](https://github.com/Pathoschild/FluentHttpClient#readme) is now loaded by SMAPI.
 
 * For the web UI:
-  * The log parser now detects a missing or outdated Error Handler mod for its 'suggested fixes' section.
+  * Improved the log parser's 'suggested fixes' section:
+    * added warning if Error Handler is missing or outdated;
+    * improved visual styles.
   * Updated the JSON validator/schema for Content Patcher 1.27.0.
   * Fixed the mod count in the log parser metadata.
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 8bf5d86d..b824b768 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -39,7 +39,7 @@
         <meta name="robots" content="noindex" />
     }
     <link rel="stylesheet" href="~/Content/css/file-upload.css" />
-    <link rel="stylesheet" href="~/Content/css/log-parser.css?r=20220409" />
+    <link rel="stylesheet" href="~/Content/css/log-parser.css" />
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3/dist/css/tabby-ui-vertical.min.css" />
 
     <script src="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3" crossorigin="anonymous"></script>
@@ -248,7 +248,7 @@ else if (log?.IsValid == true)
             <ul id="fix-list">
                 @if (errorHandler is null)
                 {
-                    <li>You don't have the <strong>Error Handler</strong> mod installed. This automatically prevents many game or mod errors. You can <a href="https://stardewvalleywiki.com/Modding:Player_Guide#Install_SMAPI">reinstall SMAPI</a> to re-add it.</li>
+                    <li class="important">You don't have the <strong>Error Handler</strong> mod installed. This automatically prevents many game or mod errors. You can <a href="https://stardewvalleywiki.com/Modding:Player_Guide#Install_SMAPI">reinstall SMAPI</a> to re-add it.</li>
                 }
                 @if (hasOlderErrorHandler)
                 {
diff --git a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
index 1d457e35..f136a96f 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
@@ -53,6 +53,36 @@ table caption {
     opacity: 0.3;
 }
 
+/*********
+** Suggested fixes
+*********/
+#fix-list {
+    padding-left: 1em;
+    margin-bottom: 2em;
+}
+
+#fix-list li {
+    padding: 0.5em;
+    background: #FFC;
+    border: 1px solid #880;
+    border-radius: 5px;
+    list-style-type: none;
+}
+
+#fix-list li:not(:last-child) {
+     margin-bottom: 0.5em;
+}
+
+#fix-list li.important {
+    background: #FCC;
+    border-color: #800;
+}
+
+#fix-list li::before {
+    content: "⚠ ";
+}
+
+
 /*********
 ** Log metadata & filters
 *********/
@@ -84,10 +114,6 @@ table caption {
     min-height: 1.3em;
 }
 
-#fix-list {
-    margin-bottom: 2em;
-}
-
 #updates {
     min-width: 10em;
 }

From 454f3a45ba104f2495386f6fe30d8ddab6beb80e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 5 Jul 2022 23:19:53 -0400
Subject: [PATCH 706/856] fix trace logs not tracking reloaded map tilesheets
 as asset propagation

---
 docs/release-notes.md                     |  1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 64 +++++++++++++----------
 2 files changed, 36 insertions(+), 29 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a94bb295..2b491c57 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,6 +16,7 @@
 
 * For mod authors:
   * The [FluentHttpClient package](https://github.com/Pathoschild/FluentHttpClient#readme) is now loaded by SMAPI.
+  * Fixed `TRACE` logs not tracking reloaded map tilesheets as a propagated asset.
 
 * For the web UI:
   * Improved the log parser's 'suggested fixes' section:
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index b783b2b9..1b4d1737 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -164,6 +164,7 @@ namespace StardewModdingAPI.Metadata
             var content = this.MainContentManager;
             string key = assetName.BaseName;
             changedWarpRoutes = false;
+            bool changed = false;
 
             /****
             ** Special case: current map tilesheet
@@ -175,7 +176,10 @@ namespace StardewModdingAPI.Metadata
                 foreach (TileSheet tilesheet in Game1.currentLocation.map.TileSheets)
                 {
                     if (this.IsSameBaseName(assetName, tilesheet.ImageSource))
+                    {
                         Game1.mapDisplayDevice.LoadTileSheet(tilesheet);
+                        changed = true;
+                    }
                 }
             }
 
@@ -184,8 +188,6 @@ namespace StardewModdingAPI.Metadata
             ****/
             if (type == typeof(Map))
             {
-                bool anyChanged = false;
-
                 if (!ignoreWorld)
                 {
                     foreach (LocationInfo info in this.GetLocationsWithInfo())
@@ -206,12 +208,12 @@ namespace StardewModdingAPI.Metadata
                             var newWarps = GetWarpSet(location);
 
                             changedWarpRoutes = changedWarpRoutes || oldWarps.Count != newWarps.Count || oldWarps.Any(p => !newWarps.Contains(p));
-                            anyChanged = true;
+                            changed = true;
                         }
                     }
                 }
 
-                return anyChanged;
+                return changed;
             }
 
             /****
@@ -223,7 +225,7 @@ namespace StardewModdingAPI.Metadata
                 ** Animals
                 ****/
                 case "animals/horse":
-                    return !ignoreWorld && this.UpdatePetOrHorseSprites<Horse>(assetName);
+                    return changed | (!ignoreWorld && this.UpdatePetOrHorseSprites<Horse>(assetName));
 
                 /****
                 ** Buildings
@@ -239,7 +241,7 @@ namespace StardewModdingAPI.Metadata
                         Farm farm = Game1.getFarm();
                         farm?.ApplyHousePaint();
 
-                        return removedFromCache || farm != null;
+                        return changed | (removedFromCache || farm != null);
                     }
 
                 /****
@@ -253,7 +255,7 @@ namespace StardewModdingAPI.Metadata
                 case "characters/farmer/farmer_base_bald":
                 case "characters/farmer/farmer_girl_base":
                 case "characters/farmer/farmer_girl_base_bald":
-                    return !ignoreWorld && this.UpdatePlayerSprites(assetName);
+                    return changed | (!ignoreWorld && this.UpdatePlayerSprites(assetName));
 
                 case "characters/farmer/hairstyles": // Game1.LoadContent
                     FarmerRenderer.hairStylesTexture = this.LoadTexture(key);
@@ -305,10 +307,10 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "data/farmanimals": // FarmAnimal constructor
-                    return !ignoreWorld && this.UpdateFarmAnimalData();
+                    return changed | (!ignoreWorld && this.UpdateFarmAnimalData());
 
                 case "data/hairdata": // Farmer.GetHairStyleMetadataFile
-                    return this.UpdateHairData();
+                    return changed | this.UpdateHairData();
 
                 case "data/movies": // MovieTheater.GetMovieData
                 case "data/moviesreactions": // MovieTheater.GetMovieReactions
@@ -316,7 +318,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "data/npcdispositions": // NPC constructor
-                    return !ignoreWorld && this.UpdateNpcDispositions(content, assetName);
+                    return changed | (!ignoreWorld && this.UpdateNpcDispositions(content, assetName));
 
                 case "data/npcgifttastes": // Game1.LoadContent
                     Game1.NPCGiftTastes = content.Load<Dictionary<string, string>>(key);
@@ -428,7 +430,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "loosesprites/suspensionbridge": // SuspensionBridge constructor
-                    return !ignoreWorld && this.UpdateSuspensionBridges(content, assetName);
+                    return changed | (!ignoreWorld && this.UpdateSuspensionBridges(content, assetName));
 
                 /****
                 ** Content\Maps
@@ -456,16 +458,16 @@ namespace StardewModdingAPI.Metadata
                             return true;
                         }
                     }
-                    return false;
+                    return changed;
 
                 case "minigames/titlebuttons": // TitleMenu
-                    return this.UpdateTitleButtons(content, assetName);
+                    return changed | this.UpdateTitleButtons(content, assetName);
 
                 /****
                 ** Content\Strings
                 ****/
                 case "strings/stringsfromcsfiles":
-                    return this.UpdateStringsFromCsFiles(content);
+                    return changed | this.UpdateStringsFromCsFiles(content);
 
                 /****
                 ** Content\TileSheets
@@ -490,7 +492,7 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "tilesheets/critters": // Critter constructor
-                    return !ignoreWorld && this.UpdateCritterTextures(assetName);
+                    return changed | (!ignoreWorld && this.UpdateCritterTextures(assetName));
 
                 case "tilesheets/crops": // Game1.LoadContent
                     Game1.cropSpriteSheet = content.Load<Texture2D>(key);
@@ -559,27 +561,27 @@ namespace StardewModdingAPI.Metadata
                     return true;
 
                 case "terrainfeatures/mushroom_tree": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(Tree.mushroomTree);
+                    return changed | (!ignoreWorld && this.UpdateTreeTextures(Tree.mushroomTree));
 
                 case "terrainfeatures/tree_palm": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(Tree.palmTree);
+                    return changed | (!ignoreWorld && this.UpdateTreeTextures(Tree.palmTree));
 
                 case "terrainfeatures/tree1_fall": // from Tree
                 case "terrainfeatures/tree1_spring": // from Tree
                 case "terrainfeatures/tree1_summer": // from Tree
                 case "terrainfeatures/tree1_winter": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(Tree.bushyTree);
+                    return changed | (!ignoreWorld && this.UpdateTreeTextures(Tree.bushyTree));
 
                 case "terrainfeatures/tree2_fall": // from Tree
                 case "terrainfeatures/tree2_spring": // from Tree
                 case "terrainfeatures/tree2_summer": // from Tree
                 case "terrainfeatures/tree2_winter": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(Tree.leafyTree);
+                    return changed | (!ignoreWorld && this.UpdateTreeTextures(Tree.leafyTree));
 
                 case "terrainfeatures/tree3_fall": // from Tree
                 case "terrainfeatures/tree3_spring": // from Tree
                 case "terrainfeatures/tree3_winter": // from Tree
-                    return !ignoreWorld && this.UpdateTreeTextures(Tree.pineTree);
+                    return changed | (!ignoreWorld && this.UpdateTreeTextures(Tree.pineTree));
             }
 
             /****
@@ -588,25 +590,29 @@ namespace StardewModdingAPI.Metadata
             if (!ignoreWorld)
             {
                 // dynamic textures
-                if (assetName.StartsWith("animals/cat"))
-                    return this.UpdatePetOrHorseSprites<Cat>(assetName);
-                if (assetName.StartsWith("animals/dog"))
-                    return this.UpdatePetOrHorseSprites<Dog>(assetName);
                 if (assetName.IsDirectlyUnderPath("Animals"))
-                    return this.UpdateFarmAnimalSprites(assetName);
+                {
+                    if (assetName.StartsWith("animals/cat"))
+                        return changed | this.UpdatePetOrHorseSprites<Cat>(assetName);
+
+                    if (assetName.StartsWith("animals/dog"))
+                        return changed | this.UpdatePetOrHorseSprites<Dog>(assetName);
+
+                    return changed | this.UpdateFarmAnimalSprites(assetName);
+                }
 
                 if (assetName.IsDirectlyUnderPath("Buildings"))
-                    return this.UpdateBuildings(assetName);
+                    return changed | this.UpdateBuildings(assetName);
 
                 if (assetName.StartsWith("LooseSprites/Fence"))
-                    return this.UpdateFenceTextures(assetName);
+                    return changed | this.UpdateFenceTextures(assetName);
 
                 // dynamic data
                 if (assetName.IsDirectlyUnderPath("Characters/Dialogue"))
-                    return this.UpdateNpcDialogue(assetName);
+                    return changed | this.UpdateNpcDialogue(assetName);
 
                 if (assetName.IsDirectlyUnderPath("Characters/schedules"))
-                    return this.UpdateNpcSchedules(assetName);
+                    return changed | this.UpdateNpcSchedules(assetName);
             }
 
             return false;

From 543e45f9bde5929ca3c12db23f7d5b2ae0c653cd Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 5 Jul 2022 23:21:51 -0400
Subject: [PATCH 707/856] remove artifacts, tweak text

---
 .DS_Store                    | Bin 10244 -> 0 bytes
 build/.DS_Store              | Bin 6148 -> 0 bytes
 src/.DS_Store                | Bin 8196 -> 0 bytes
 src/SMAPI/.DS_Store          | Bin 6148 -> 0 bytes
 src/SMAPI/Framework/SCore.cs |   2 +-
 src/SMAPI/SMAPI.sln          |  25 -------------------------
 6 files changed, 1 insertion(+), 26 deletions(-)
 delete mode 100644 .DS_Store
 delete mode 100644 build/.DS_Store
 delete mode 100644 src/.DS_Store
 delete mode 100644 src/SMAPI/.DS_Store
 delete mode 100644 src/SMAPI/SMAPI.sln

diff --git a/.DS_Store b/.DS_Store
deleted file mode 100644
index ba9468ef9378d82e8b742a8dcd4010c8c1d73e35..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10244
zcmeHMU2GIp6u#fIrL%OP1GKha2R2=ZfGw;AZ23#Jf69N6ZRxiBEW0}+9hlCPo!xD*
z)HEhO2%_;x<6q>-zsQ4%7+-u)6n#`Q!5AMf8udjJd{KGu%)PUeZt+bMftlpanRD(r
z_wM=TJ9qcqWsIRCuiwX5m@y_(^Q5ZK?IxGk@3k41<XgN>P&{LLdej|BTTXh0Z(s-z
z2oMMm2oMMm2oU&xAVA;Q-X&KF8QcQ|0t5mCt|Q>B4`FJajQMg>NWOH?jc)-+mXn!Z
z^i2Bz9uxLu%$Jiw@=zL6>>l8U!rx**gj0Xmb0-<|<)n}zoI!*$_%p-bp@7d$abfPx
z5EC-E2M7cR%tXK|n+ld@d1f+e+W!4~dc-o_Tr~PMq_XmgS(S37TqPff4>_apTq>7$
zJ5t$wp4RI)R=W6{O7As|(WF|_>DalHX&YG{VCn|B?C&>i-5Kq0^0w~s*tqDBLvkpo
z){T$1wKj#<Mxzr=;qmn?QF>l;|HMQ{u8pkTxF>nk8n&G$L=N!R0XC;3r<2nYD#Ww4
z<=BVG>P3_@ojEMS+#3!mZsA0)r&E$<8FN{dWp0lo{bVe+&?%0V%Hl<8ep94oXm*t{
zN9#`v4DM5s>ihz6uxBJ^I<~vl$hstxYPCyT-I{Ui-C4uy@6R|^e%N-C>by+K%H*w7
z&S<x+xcP`dwrV$%bu4SQ<C@+u1Bsk5mh<{%bR`B|C!6c!gC$HFUwEl`*Vtpwpk~47
zqM_ZI5~3n>c5dC0rOTUJS~tbIx9)uCQnfm7{sN^|8Kk1HbLPXQksV068N=31`*7c=
zspp3J3#MzPEu+^?4I80(XbN4bu3xz5?gmX04pRX|*F-*T9?P4#<7z~f`5a-bQQ5E4
zXWHrL-YmMTo}+PS_GMb5w$JP7%o=pp{eTtPy-Kf3$;)a=IIdEnO7Bss=8)<N%Nk{!
z)@P;Ch80qEF;APaLF+FF{6p$?Vce|LYKe?9JWMINAz^FRI<<q|v^!F6u4lxsy^nNJ
z^gTd*gYHl&YxIoLYT|#QZDi%Il<Zzmw{GSf-brZeYSgp=Z@6|{=Q%8@Us$chwLV$>
zLQblxX%|dd!RWP$g-njbIw$$tiNsclw-hP9EDm%e78QDkex+!vg>|tV>=0GhI6KXr
zV`tdA>;n6QeZ{_GKeMas4*;`JiP@+^4HjW3ny?P7Xv2DRpa;9L2XXAj5KJ6_i!mI>
zI8NYkoWv=d##49}FX3gpf-`snZ{r=D!+ZD;7x5WB$CtQ*@9_hE#IN`hf8m-`A=OFs
z(n6_GYLc3zRZ^?eCT);5O1q>UDIuk#Ba$PHi3FtLvU#AGpl?4;a;nh$GhFHH%?qvJ
z!7W?2ZNGI2?ebh+S~azI)rFU>T)nn!bNh7)3eFa3dL#Kc<EPaLXFO*_30p7m8dMf9
zDHh#S8H%#(qf#-(WUpe?O5Z!ORHjl<D|~hN3R1VLvxM5vyh^6BR3)w|4J~UzRD5cg
zuQs=m3ZW<)H-)GS)pB2593z!+rJ<p#n})fl%KsL}FS9G`C-xh=MjW4u1*pe8h!V3q
zum!s~x8vx;K_qbqY3LY+4F|`F<tH$KM=^=Vh~rNZ%b&(Gcpfj{MPmA^cnz=PO}s@s
zKacnE0Y1XVxPVW6#(ztE{{>e|IJ|Q@hw=LqhfBT>r#l8(fIxsifIxsifWV!MK$%EB
z?4AF2|MUO<cQQml?g0X~Jpw52ig$HTn#IjwX~y1JdzjiGYTo7fO$y0F=*ExZN%G@(
uQoM7;<<vZ1fAh?rW4>)tNFGi;Je;IB&HvB;3<&oB!T#Srg1S@p|9=DT*dLw%

diff --git a/build/.DS_Store b/build/.DS_Store
deleted file mode 100644
index decdd55791f83b4535087de523bd19903adeb123..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeHK%}T>S5T5OiO(;SRiXH=A3&tP(!Aq$11&ruHr8cH$Fz!mz7@-t$)fe(jd>&_Z
zx5c*hD$?%2>^D0*lQ7?g-3$P*W)|%LH~?Uw5|(Tnei2$Hosp9ER1q0HBh1s6FcBfn
zKWCzi<3BP$dsl%BIK=SwbN|AZBu@LD_r*%(N_C}X)vUU88$60U=y&>A+U)eMX?7t*
z5{~Rnco}!|wzGCBc)t_#Zciq}Q5QpQu3{dEyeTpsr7|~A3zlu!ZD(UJI67>&`<^#!
zxP#+e5AD5!;n23$x3*8t+fT_e7w?KghM$|1RgEL~Kx16aYtZ9~;1B4d_!{I`B!>tD
zTIpgGJ5^Ma-X|gM2=OtsG{pu*7%>bO29}lqeTZ81rDebrZWu5O%wvGg2N#vl*H|c&
zM+XkF1wgEzTMF9LOHhuh(brfg#1#~#QV~@u(=7&5>F9TLoUgG^sM3My=7Z@sGu@#u
z`F4E1E5m{L3e9L3FbqsGP*zii?*Fs-{r_Z=nHdHQ0}I6ftF(ev6HC%}>r8QU*Se^8
rs3a6uC>*DtA+KVLrK@-oRSNoDG7x=@g+lb8m>&U2gBc71f6Bl&h3t<r

diff --git a/src/.DS_Store b/src/.DS_Store
deleted file mode 100644
index da9de5748c191eefcd2ad717f709252d1efa0acc..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMU2GIp6u#fIz>FQ}6pJmx7FMdD*w8J%1wpnge=XEDZ2zg&-JOAsOlRuO>@GqY
zOEek?PyW4PG$!f;8h_%0iqWVsF~(>JiKvM`G5V+piSlARckXP%w(w>mN#`c_o_o%{
z=iWVMzH@KRUB(#N^F|9}^^7r@DyLc%HP<P8oYy%;3MG|9LHdk!W{Tcq#&$Dv=0<|Z
z1Ca+J4@4e_JP>){=I{XB*}TX%xc9|q)J7hNJTNakz|V&`RZf#3ofb4WI;aU!0HQnv
z2nzKn4+wPPAx(yKTF^k1))d(TLREw*2823|$N6-k$&gM9D%2T-IzzZK!VCq$?xYtF
zrZXf3joQcqkq72_fQQclmSWwkjrEr0@9$<NZOii$iA#_wDi<tVBrlSy<OfpYZZYMj
z{k+$n&K>4lpX=J0Qa_y;u*~9^R@>n^e%f-(T%ceXCQTU~v>d}Nw!3-9@B-bG7?2fN
z8Pn=co^0LP6yKCcOf|(%ZrhNc{>Cj+Q;NK-vH9LZW5?_X$2~1<KzI(Y#j|WWQ*My$
z6*|O&M8)QkL6=JgDYsOqi}k+#fkAb6$jZ7-$~s|=Y1JNC)k$n`&Mc5MgIU+kPdMI~
zR+CNJ*}R?h%{JTSlSx+XWpl1=_qv|tTdp%a<eSI+(n4iJLnEG>^E-mY#xyPOnTJeT
z%PN?=X+>IUDc`MUk}u;8m^qJVV=^HORL(D{i`{<by5>#WcDC>By8mLeR<rchT2&n(
z7dpOm#4>aJMa%HVhtpoxbPUTmI#{qgD`T5|PI|(uL6f2cTJ_6yeJG!?9?4t&qgtaZ
z2hxU>x;kpm59xLdzM7%EBa8W~SL*s<KGKmhsWn1{HEVUX&m$*j>2TsbO{&^=jJ~nv
zg<B<BRK4F$XG~i&6tU0dEvi0P5Y}l2LgDsWRUgW_6BA^L7s~G2rRxv!Z4ahBzh}~P
z=qG(1?%hFSBi?vAXZ92cW1(~(NrTTva;~(;uza^Pcz~=J=F7DiMqtBIt)^P<)ep(q
zH!^(=%PCldYx22(x7?UK%b&#<YfP>a-=J~VAEFaDRH+rrOv~@E2DXN^(w)`Ejxd*<
zVrSVo_BQ)~U0`3bOYA518~c-8W&Z$>PyrRoP=|Uf$7(dA1skvtJFp*}=t2rZ7{OtT
z!o<U{F#!ifOyMz1;}p)|X*`SP@I21p6}*bq@D@JCC-@Yf;VWFmclaK^;xGJ-tCA$C
z(qd_eR43I-y0k)CFEvZ8Qk&Ez^+>(q*Gr{v8kw;s=tyZI*PIU&PT~8WbpHC`6x+AI
zvr9dA(}&ZyOGE%IyR9zHqpEdh+YA5&VoM;s7Wx6+%c3N}dw_>oSiMMLwj$P`t|~?0
z?C9*LKrxTYJTA3GV)knF4w(W)TOioA>fJJhh_+C$O|kVd1*IkhtlARWs8Hx>6@qPw
zZB=9qg4wR_P$&qsO2Ia$Nk!3Ez{EOYdt?eEP5!SD{x!SIeq_J1E9@#3q6!*T;VvYw
z1xf71KEm_?bYlR67$#(MTpz(WEF6Q6JYoAdPT+AofhX}4P7}VLA%t^$zknC<5?;o6
zypA{UCf>vQxPTAw5h4ByT*MFf8NbZJad$b6aitu`g;dV5UFRrCOUN%*m=9cqFtVQK
z|9fuy{y!gF5!o1dVBUHFmAg~B+sXVJ9fdsCj#GVzDldHAw4i|sH9<N~G)TvZ&ir9W
e{WwkKI?0eu3rZ3y|I<T&65apN{Xd`Y|9=64n@@rO

diff --git a/src/SMAPI/.DS_Store b/src/SMAPI/.DS_Store
deleted file mode 100644
index b2c4b00c8b9d1fcd1f987081145e11bb74c759d3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeHKOH0E*5T0$TO(;SSiXH=A3&saN@DghE2N=<VN=-=6&@@~6Fo#meRsWFx#NXr0
z?p7?V;7P>J!0b0Wk1YFb*arZJ<|x_)r~`n7N?5Y7Ss)ZAos*LB5DN8;7;=!%hfbK!
zWwYZiGC*r*!v(Hc0A2X9euG|^$`GS(VJ}SvL)U#5rE+CuwQ5zZnsx6#$=n|X!_lA_
z^lzzmC1n~;?I65P;=Em7Ka<%oNV2%E3X&+sl)IZGi)7xEqbwSzT3-h&+p^pB&GGp7
zsNo#A?xf+2Pxf52_YWr%+uGRPIlXLm(rzYSG@Al{JSA%er|^o#f{8u*{VbK)BSxo{
z(+WmrfEi#0mWBbd0a~@CnK4h48DIu}$^h*T4l1E%u+XTs4s7W9Nbw3G3EK3QAao3R
z1`CZCK@qwXQI`ty#1Oh1{f^1=3>F%7IS4f}e#eX~%nL=R(b4aybP%3KZkYjQV3vWh
z?$+u2KmY#yKU>5-W`G&^R}6?s%WpMtO6F{xn;f0B4(bCc3FQ?UKTFV1M=|EoQM`q!
a1pN*fh@QbhBYIHyBA{sCh8g%(20j1`T1^}P

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 283755d6..d0effb03 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1565,7 +1565,7 @@ namespace StardewModdingAPI.Framework
                             this.Monitor.Newline();
                             this.Monitor.Log($"You can update {updates.Count} mod{(updates.Count != 1 ? "s" : "")}:", LogLevel.Alert);
                             foreach ((IModMetadata mod, ISemanticVersion newVersion, string newUrl) in updates)
-                                this.Monitor.Log($"   {mod.DisplayName} {newVersion}: {newUrl} (You have {mod.Manifest.Version}", LogLevel.Alert);
+                                this.Monitor.Log($"   {mod.DisplayName} {newVersion}: {newUrl} (you have {mod.Manifest.Version})", LogLevel.Alert);
                         }
                         else
                             this.Monitor.Log("   All mods up to date.");
diff --git a/src/SMAPI/SMAPI.sln b/src/SMAPI/SMAPI.sln
deleted file mode 100644
index 1821b0b6..00000000
--- a/src/SMAPI/SMAPI.sln
+++ /dev/null
@@ -1,25 +0,0 @@
-
-Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 25.0.1700.5
-MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SMAPI", "SMAPI.csproj", "{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|Any CPU = Debug|Any CPU
-		Release|Any CPU = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{A09B2199-7A4C-4F47-8406-9A73A2FEAA96}.Release|Any CPU.Build.0 = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-	GlobalSection(ExtensibilityGlobals) = postSolution
-		SolutionGuid = {FD0C4E68-CA54-4AD5-8171-DA621027A9DF}
-	EndGlobalSection
-EndGlobal

From 60b4a10d0fc103ab8eed1dadf0eed615cfbe7915 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 5 Jul 2022 23:30:09 -0400
Subject: [PATCH 708/856] update release notes

---
 docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 2b491c57..00f145fe 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For players:
+  * Update alerts now mention which mod version you have now (thanks to ishanjalan!).
   * Fixed lag which occurred for some players since Stardew Valley 1.5.5.
   * Fixed `smapi-internal/config.user.json` overrides not applied after SMAPI 3.14.0.
   * Fixed PyTK not rescaling images correctly in some cases.  

From 2347644a1fa3537b198d063232ba814769ffe044 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Jul 2022 18:36:29 -0400
Subject: [PATCH 709/856] update compatibility list for broken CFAutomate
 unofficial update

---
 docs/release-notes.md                     | 1 +
 src/SMAPI.Web/wwwroot/SMAPI.metadata.json | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 00f145fe..0c3248e0 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -14,6 +14,7 @@
   * Fixed `smapi-internal/config.user.json` overrides not applied after SMAPI 3.14.0.
   * Fixed PyTK not rescaling images correctly in some cases.  
     _When PyTK 1.23.0 or earlier is installed, this will disable the main performance improvements in SMAPI 3.15.0._
+  * Updated compatibility list.
 
 * For mod authors:
   * The [FluentHttpClient package](https://github.com/Pathoschild/FluentHttpClient#readme) is now loaded by SMAPI.
diff --git a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
index 4e6f4669..d654b181 100644
--- a/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
+++ b/src/SMAPI.Web/wwwroot/SMAPI.metadata.json
@@ -166,8 +166,8 @@
         *********/
         "CFAutomate": {
             "ID": "Platonymous.CFAutomate",
-            "~2.12.9 | Status": "AssumeBroken",
-            "~2.12.9 | StatusReasonDetails": "causes runtime errors in newer versions of Automate"
+            "~2.12.11 | Status": "AssumeBroken",
+            "~2.12.11 | StatusReasonDetails": "causes runtime errors in newer versions of Automate"
         },
         "Dynamic Game Assets": {
             "ID": "spacechase0.DynamicGameAssets",

From 4d9fd63d9e890a10029508c7d7e31dcc0b579db7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Jul 2022 19:24:49 -0400
Subject: [PATCH 710/856] update code annotations

---
 src/SMAPI.Installer/InteractiveInstaller.cs            |  1 +
 src/SMAPI.ModBuildConfig/DeployModTask.cs              |  3 +--
 .../Framework/ItemRepository.cs                        |  2 +-
 src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs | 10 +++++-----
 .../Framework/LowLevelEnvironmentUtility.cs            |  7 +++++--
 .../Framework/Clients/ModDrop/ModDropClient.cs         |  2 +-
 .../Framework/ContentManagers/BaseContentManager.cs    |  3 +--
 src/SMAPI/Framework/Logging/LogManager.cs              |  2 +-
 src/SMAPI/Framework/ModLoading/ModMetadata.cs          |  2 +-
 src/SMAPI/Framework/ModLoading/ModResolver.cs          |  4 ++--
 .../ModLoading/RewriteFacades/HarmonyInstanceFacade.cs |  2 +-
 .../ModLoading/RewriteFacades/SpriteBatchFacade.cs     |  1 -
 src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs   |  2 +-
 src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs     |  2 +-
 src/SMAPI/Framework/SCore.cs                           |  6 +++---
 src/SMAPI/Framework/SGame.cs                           |  3 +++
 src/SMAPI/Metadata/CoreAssetPropagator.cs              |  2 +-
 src/SMAPI/Translation.cs                               |  2 +-
 src/SMAPI/Utilities/SDate.cs                           |  2 +-
 19 files changed, 31 insertions(+), 27 deletions(-)

diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index 5a6aa747..fd1a6047 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -453,6 +453,7 @@ namespace StardewModdingApi.Installer
                             }
 
                             // find target folder
+                            // ReSharper disable once ConditionalAccessQualifierIsNonNullableAccordingToAPIContract -- avoid error if the Mods folder has invalid mods, since they're not validated yet
                             ModFolder? targetMod = targetMods.FirstOrDefault(p => p.Manifest?.UniqueID?.Equals(sourceMod.Manifest.UniqueID, StringComparison.OrdinalIgnoreCase) == true);
                             DirectoryInfo defaultTargetFolder = new(Path.Combine(paths.ModsPath, sourceMod.Directory.Name));
                             DirectoryInfo targetFolder = targetMod?.Directory ?? defaultTargetFolder;
diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index c7026ee1..88412d92 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -227,8 +227,7 @@ namespace StardewModdingAPI.ModBuildConfig
                 string fromPath = entry.Value.FullName;
                 string toPath = Path.Combine(modFolderPath, entry.Key);
 
-                // ReSharper disable once AssignNullToNotNullAttribute -- not applicable in this context
-                Directory.CreateDirectory(Path.GetDirectoryName(toPath));
+                Directory.CreateDirectory(Path.GetDirectoryName(toPath)!);
 
                 File.Copy(fromPath, toPath, overwrite: true);
             }
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 3722e155..88ddfe6b 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -30,7 +30,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
         /// <summary>Get all spawnable items.</summary>
         /// <param name="itemTypes">The item types to fetch (or null for any type).</param>
         /// <param name="includeVariants">Whether to include flavored variants like "Sunflower Honey".</param>
-        [SuppressMessage("ReSharper", "AccessToModifiedClosure", Justification = "TryCreate invokes the lambda immediately.")]
+        [SuppressMessage("ReSharper", "AccessToModifiedClosure", Justification = $"{nameof(ItemRepository.TryCreate)} invokes the lambda immediately.")]
         public IEnumerable<SearchableItem> GetAll(ItemType[]? itemTypes = null, bool includeVariants = true)
         {
             //
diff --git a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
index 7f06d170..3bdd145a 100644
--- a/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
+++ b/src/SMAPI.Toolkit/Framework/Clients/Wiki/WikiClient.cs
@@ -283,8 +283,8 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         }
 
         /// <summary>The response model for the MediaWiki parse API.</summary>
-        [SuppressMessage("ReSharper", "ClassNeverInstantiated.Local")]
-        [SuppressMessage("ReSharper", "UnusedAutoPropertyAccessor.Local")]
+        [SuppressMessage("ReSharper", "ClassNeverInstantiated.Local", Justification = "Used via JSON deserialization.")]
+        [SuppressMessage("ReSharper", "UnusedAutoPropertyAccessor.Local", Justification = "Used via JSON deserialization.")]
         private class ResponseModel
         {
             /*********
@@ -306,9 +306,9 @@ namespace StardewModdingAPI.Toolkit.Framework.Clients.Wiki
         }
 
         /// <summary>The inner response model for the MediaWiki parse API.</summary>
-        [SuppressMessage("ReSharper", "ClassNeverInstantiated.Local")]
-        [SuppressMessage("ReSharper", "CollectionNeverUpdated.Local")]
-        [SuppressMessage("ReSharper", "UnusedAutoPropertyAccessor.Local")]
+        [SuppressMessage("ReSharper", "ClassNeverInstantiated.Local", Justification = "Used via JSON deserialization.")]
+        [SuppressMessage("ReSharper", "CollectionNeverUpdated.Local", Justification = "Used via JSON deserialization.")]
+        [SuppressMessage("ReSharper", "UnusedAutoPropertyAccessor.Local", Justification = "Used via JSON deserialization.")]
         private class ResponseParseModel
         {
             /*********
diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index 6978567e..118b71b2 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -21,6 +21,7 @@ namespace StardewModdingAPI.Toolkit.Framework
         /// <summary>Get the OS name from the system uname command.</summary>
         /// <param name="buffer">The buffer to fill with the resulting string.</param>
         [DllImport("libc")]
+        [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "This is the actual external command name.")]
         static extern int uname(IntPtr buffer);
 
 
@@ -51,7 +52,6 @@ namespace StardewModdingAPI.Toolkit.Framework
 
         /// <summary>Get the human-readable OS name and version.</summary>
         /// <param name="platform">The current platform.</param>
-        [SuppressMessage("ReSharper", "EmptyGeneralCatchClause", Justification = "Error suppressed deliberately to fallback to default behaviour.")]
         public static string GetFriendlyPlatformName(string platform)
         {
 #if SMAPI_FOR_WINDOWS
@@ -65,7 +65,10 @@ namespace StardewModdingAPI.Toolkit.Framework
 
                 return result ?? "Windows";
             }
-            catch { }
+            catch
+            {
+                // fallback to default behavior
+            }
 #endif
 
             string name = Environment.OSVersion.ToString();
diff --git a/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs b/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
index c60b2c90..f5a5f930 100644
--- a/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/ModDrop/ModDropClient.cs
@@ -42,7 +42,7 @@ namespace StardewModdingAPI.Web.Framework.Clients.ModDrop
 
         /// <summary>Get update check info about a mod.</summary>
         /// <param name="id">The mod ID.</param>
-        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The nullability is validated in this method.")]
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "The nullability is validated in this method.")]
         public async Task<IModPage?> GetModData(string id)
         {
             IModPage page = new GenericModPage(this.SiteKey, id);
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index d7be0c37..54f8e2a2 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -111,7 +111,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         }
 
         /// <inheritdoc />
-        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "Copied as-is from game code")]
         public sealed override string LoadBaseString(string path)
         {
             try
@@ -119,7 +118,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // copied as-is from LocalizedContentManager.LoadBaseString
                 // This is only changed to call this.Load instead of base.Load, to support mod assets
                 this.ParseStringPath(path, out string assetName, out string key);
-                Dictionary<string, string> strings = this.Load<Dictionary<string, string>>(assetName, LanguageCode.en);
+                Dictionary<string, string>? strings = this.Load<Dictionary<string, string>?>(assetName, LanguageCode.en);
                 return strings != null && strings.ContainsKey(key)
                     ? this.GetString(strings, key)
                     : path;
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index d811ed5c..c0b7c0ba 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -400,7 +400,7 @@ namespace StardewModdingAPI.Framework.Logging
         /// <param name="mods">The loaded mods.</param>
         /// <param name="skippedMods">The mods which could not be loaded.</param>
         /// <param name="logParanoidWarnings">Whether to log issues for mods which directly use potentially sensitive .NET APIs like file or shell access.</param>
-        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "Manifests aren't guaranteed non-null at this point in the loading process.")]
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "Manifests aren't guaranteed non-null at this point in the loading process.")]
         private void LogModWarnings(IEnumerable<IModMetadata> mods, IModMetadata[] skippedMods, bool logParanoidWarnings)
         {
             // get mods with warnings
diff --git a/src/SMAPI/Framework/ModLoading/ModMetadata.cs b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
index aa4d2d8c..ac7a6bbd 100644
--- a/src/SMAPI/Framework/ModLoading/ModMetadata.cs
+++ b/src/SMAPI/Framework/ModLoading/ModMetadata.cs
@@ -83,7 +83,7 @@ namespace StardewModdingAPI.Framework.ModLoading
 
         /// <inheritdoc />
         [MemberNotNullWhen(true, nameof(ModMetadata.ContentPack))]
-        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The manifest may be null for broken mods while loading.")]
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "The manifest may be null for broken mods while loading.")]
         public bool IsContentPack => this.Manifest?.ContentPackFor != null;
 
         /// <summary>The fake content packs created by this mod, if any.</summary>
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 3e7144f9..abc46d47 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -60,8 +60,8 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="getUpdateUrl">Get an update URL for an update key (if valid).</param>
         /// <param name="getFileLookup">Get a file lookup for the given directory.</param>
         /// <param name="validateFilesExist">Whether to validate that files referenced in the manifest (like <see cref="IManifest.EntryDll"/>) exist on disk. This can be disabled to only validate the manifest itself.</param>
-        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "Manifest values may be null before they're validated.")]
-        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "Manifest values may be null before they're validated.")]
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "Manifest values may be null before they're validated.")]
+        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract", Justification = "Manifest values may be null before they're validated.")]
         public void ValidateManifests(IEnumerable<IModMetadata> mods, ISemanticVersion apiVersion, Func<string, string?> getUpdateUrl, Func<string, IFileLookup> getFileLookup, bool validateFilesExist = true)
         {
             mods = mods.ToArray();
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
index 9c8ba2b0..be45272e 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/HarmonyInstanceFacade.cs
@@ -28,7 +28,7 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
             return new Harmony(id);
         }
 
-        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "If the user passes a null original method, we let it fail in the underlying Harmony instance instead of handling it here.")]
+        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract", Justification = "If the user passes a null original method, we let it fail in the underlying Harmony instance instead of handling it here.")]
         public DynamicMethod Patch(MethodBase original, HarmonyMethod? prefix = null, HarmonyMethod? postfix = null, HarmonyMethod? transpiler = null)
         {
             // In Harmony 1.x you could target a virtual method that's not implemented by the
diff --git a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
index 67569424..3eb31df3 100644
--- a/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
+++ b/src/SMAPI/Framework/ModLoading/RewriteFacades/SpriteBatchFacade.cs
@@ -10,7 +10,6 @@ namespace StardewModdingAPI.Framework.ModLoading.RewriteFacades
     /// <summary>Provides <see cref="SpriteBatch"/> method signatures that can be injected into mod code for compatibility with mods written for XNA Framework before Stardew Valley 1.5.5.</summary>
     /// <remarks>This is public to support SMAPI rewriting and should not be referenced directly by mods.</remarks>
     [SuppressMessage("ReSharper", "UnusedMember.Global", Justification = "Used via assembly rewriting")]
-    [SuppressMessage("ReSharper", "CS0109", Justification = "The 'new' modifier applies when compiled on Linux/macOS.")]
     [SuppressMessage("ReSharper", "CS1591", Justification = "Documentation not needed for facade classes.")]
     public class SpriteBatchFacade : SpriteBatch
     {
diff --git a/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs b/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
index 1e150508..cc936489 100644
--- a/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
+++ b/src/SMAPI/Framework/Networking/MultiplayerPeerMod.cs
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Framework.Networking
         *********/
         /// <summary>Construct an instance.</summary>
         /// <param name="mod">The mod metadata.</param>
-        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The ID shouldn't be null, but we should handle it to avoid an error just in case.")]
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "The ID shouldn't be null, but we should handle it to avoid an error just in case.")]
         public MultiplayerPeerMod(RemoteContextModModel mod)
         {
             this.Name = mod.Name;
diff --git a/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs b/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
index 94b13378..dac41629 100644
--- a/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
+++ b/src/SMAPI/Framework/Rendering/SXnaDisplayDevice.cs
@@ -14,7 +14,7 @@ namespace StardewModdingAPI.Framework.Rendering
 {
     /// <summary>A map display device which reimplements the default logic.</summary>
     /// <remarks>This is an exact copy of <see cref="XnaDisplayDevice"/>, except that private fields are protected and all methods are virtual.</remarks>
-    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Field naming deliberately matches " + nameof(XnaDisplayDevice) + " to minimize differences.")]
+    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = $"Field naming deliberately matches {nameof(XnaDisplayDevice)} to minimize differences.")]
     internal class SXnaDisplayDevice : IDisplayDevice
     {
         /*********
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index d0effb03..d9969d4d 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -325,7 +325,7 @@ namespace StardewModdingAPI.Framework
         }
 
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
-        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "May be disposed before SMAPI is fully initialized.")]
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "May be disposed before SMAPI is fully initialized.")]
         public void Dispose()
         {
             // skip if already disposed
@@ -1285,7 +1285,7 @@ namespace StardewModdingAPI.Framework
         private LocalizedContentManager CreateContentManager(IServiceProvider serviceProvider, string rootDirectory)
         {
             // Game1._temporaryContent initializing from SGame constructor
-            // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- this is the method that initializes it
+            // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- this is the method that initializes it
             if (this.ContentCore == null)
             {
                 this.ContentCore = new ContentCoordinator(
@@ -1808,7 +1808,7 @@ namespace StardewModdingAPI.Framework
                 string relativePath = mod.GetRelativePathWithRoot();
                 if (mod.IsContentPack)
                     this.Monitor.Log($"   {mod.DisplayName} (from {relativePath}) [content pack]...");
-                // ReSharper disable once ConstantConditionalAccessQualifier -- mod may be invalid at this point
+                // ReSharper disable once ConditionalAccessQualifierIsNonNullableAccordingToAPIContract -- mod may be invalid at this point
                 else if (mod.Manifest?.EntryDll != null)
                     this.Monitor.Log($"   {mod.DisplayName} (from {relativePath}{Path.DirectorySeparatorChar}{mod.Manifest.EntryDll})..."); // don't use Path.Combine here, since EntryDLL might not be valid
                 else
diff --git a/src/SMAPI/Framework/SGame.cs b/src/SMAPI/Framework/SGame.cs
index 38043e1c..feb0988a 100644
--- a/src/SMAPI/Framework/SGame.cs
+++ b/src/SMAPI/Framework/SGame.cs
@@ -252,6 +252,7 @@ namespace StardewModdingAPI.Framework
         [SuppressMessage("ReSharper", "LocalVariableHidesMember", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "MergeIntoPattern", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "PossibleLossOfFraction", Justification = "copied from game code as-is")]
+        [SuppressMessage("ReSharper", "PossibleNullReferenceException", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantArgumentDefaultValue", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantBaseQualifier", Justification = "copied from game code as-is")]
         [SuppressMessage("ReSharper", "RedundantCast", Justification = "copied from game code as-is")]
@@ -261,6 +262,8 @@ namespace StardewModdingAPI.Framework
         [SuppressMessage("ReSharper", "MergeIntoPattern", Justification = "copied from game code as-is")]
         [SuppressMessage("SMAPI.CommonErrors", "AvoidImplicitNetFieldCast", Justification = "copied from game code as-is")]
         [SuppressMessage("SMAPI.CommonErrors", "AvoidNetField", Justification = "copied from game code as-is")]
+
+        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalse", Justification = "Deliberate to minimize chance of errors when copying event calls into new versions of this code.")]
         private void DrawImpl(GameTime gameTime, RenderTarget2D target_screen)
         {
             var events = this.Events;
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 1b4d1737..1ef9a8f2 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -966,7 +966,7 @@ namespace StardewModdingAPI.Metadata
             {
                 // get suspension bridges field
                 var field = this.Reflection.GetField<IEnumerable<SuspensionBridge>?>(location, nameof(IslandNorth.suspensionBridges), required: false);
-                // ReSharper disable once ConditionIsAlwaysTrueOrFalse -- field is nullable when required: false
+                // ReSharper disable once ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract -- field is nullable when required: false
                 if (field == null || !typeof(IEnumerable<SuspensionBridge>).IsAssignableFrom(field.FieldInfo.FieldType))
                     continue;
 
diff --git a/src/SMAPI/Translation.cs b/src/SMAPI/Translation.cs
index 01cb92b2..5cc119d9 100644
--- a/src/SMAPI/Translation.cs
+++ b/src/SMAPI/Translation.cs
@@ -121,7 +121,7 @@ namespace StardewModdingAPI
         /// <summary>Get a string representation of the given translation.</summary>
         /// <param name="translation">The translation key.</param>
         /// <remarks><strong>Limitation with nullable reference types: if there's no text and you disabled the fallback via <see cref="UsePlaceholder"/>, this will return null but the return value will still be marked non-nullable.</strong></remarks>
-        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The null check is required due to limitations in nullable type annotations (see remarks).")]
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "The null check is required due to limitations in nullable type annotations (see remarks).")]
         public static implicit operator string(Translation translation)
         {
             return translation?.ToString()!;
diff --git a/src/SMAPI/Utilities/SDate.cs b/src/SMAPI/Utilities/SDate.cs
index 1d4e4489..c7ad41bd 100644
--- a/src/SMAPI/Utilities/SDate.cs
+++ b/src/SMAPI/Utilities/SDate.cs
@@ -250,7 +250,7 @@ namespace StardewModdingAPI.Utilities
         /// <param name="year">The year.</param>
         /// <param name="allowDayZero">Whether to allow 0 spring Y1 as a valid date.</param>
         /// <exception cref="ArgumentException">One of the arguments has an invalid value (like day 35).</exception>
-        [SuppressMessage("ReSharper", "ConstantConditionalAccessQualifier", Justification = "The nullability is validated in this constructor.")]
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "The nullability is validated in this constructor.")]
         private SDate(int day, string season, int year, bool allowDayZero)
         {
             season = season?.Trim().ToLowerInvariant()!; // null-checked below

From 9c9552531f8f085cded6ed5158503e75b00be1ff Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Jul 2022 19:25:15 -0400
Subject: [PATCH 711/856] fix build warnings

---
 src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs  | 2 +-
 src/SMAPI.Toolkit/ModToolkit.cs                            | 2 +-
 .../Serialization/Converters/SemanticVersionConverter.cs   | 7 ++++++-
 .../Serialization/Converters/SimpleReadOnlyConverter.cs    | 7 ++++++-
 src/SMAPI/Framework/ModHelpers/ModHelper.cs                | 1 +
 src/SMAPI/Framework/Models/SConfig.cs                      | 2 +-
 src/SMAPI/Framework/SCore.cs                               | 2 +-
 src/SMAPI/Framework/Serialization/KeybindConverter.cs      | 5 ++++-
 src/SMAPI/Utilities/SDate.cs                               | 4 ++--
 9 files changed, 23 insertions(+), 9 deletions(-)

diff --git a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
index 118b71b2..f464f4bb 100644
--- a/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
+++ b/src/SMAPI.Toolkit/Framework/LowLevelEnvironmentUtility.cs
@@ -22,7 +22,7 @@ namespace StardewModdingAPI.Toolkit.Framework
         /// <param name="buffer">The buffer to fill with the resulting string.</param>
         [DllImport("libc")]
         [SuppressMessage("ReSharper", "IdentifierTypo", Justification = "This is the actual external command name.")]
-        static extern int uname(IntPtr buffer);
+        private static extern int uname(IntPtr buffer);
 
 
         /*********
diff --git a/src/SMAPI.Toolkit/ModToolkit.cs b/src/SMAPI.Toolkit/ModToolkit.cs
index 0df75a31..55b9bdd8 100644
--- a/src/SMAPI.Toolkit/ModToolkit.cs
+++ b/src/SMAPI.Toolkit/ModToolkit.cs
@@ -65,7 +65,7 @@ namespace StardewModdingAPI.Toolkit
         /// <param name="metadataPath">The file path for the SMAPI metadata file.</param>
         public ModDatabase GetModDatabase(string metadataPath)
         {
-            MetadataModel metadata = JsonConvert.DeserializeObject<MetadataModel>(File.ReadAllText(metadataPath));
+            MetadataModel metadata = JsonConvert.DeserializeObject<MetadataModel>(File.ReadAllText(metadataPath)) ?? new MetadataModel();
             ModDataRecord[] records = metadata.ModData.Select(pair => new ModDataRecord(pair.Key, pair.Value)).ToArray();
             return new ModDatabase(records, this.GetUpdateUrl);
         }
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
index c32c3185..913d54e0 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/SemanticVersionConverter.cs
@@ -48,7 +48,12 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
                     return this.ReadObject(JObject.Load(reader));
 
                 case JsonToken.String:
-                    return this.ReadString(JToken.Load(reader).Value<string>(), path);
+                    {
+                        string? value = JToken.Load(reader).Value<string>();
+                        return value is not null
+                            ? this.ReadString(value, path)
+                            : null;
+                    }
 
                 default:
                     throw new SParseException($"Can't parse {nameof(ISemanticVersion)} from {reader.TokenType} node (path: {reader.Path}).");
diff --git a/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs b/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
index 1c59f5e7..cdf2ed77 100644
--- a/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
+++ b/src/SMAPI.Toolkit/Serialization/Converters/SimpleReadOnlyConverter.cs
@@ -42,7 +42,12 @@ namespace StardewModdingAPI.Toolkit.Serialization.Converters
                     return this.ReadObject(JObject.Load(reader), path);
 
                 case JsonToken.String:
-                    return this.ReadString(JToken.Load(reader).Value<string>(), path);
+                    {
+                        string? value = JToken.Load(reader).Value<string>();
+                        return value is not null
+                            ? this.ReadString(value, path)
+                            : null;
+                    }
 
                 default:
                     throw new SParseException($"Can't parse {typeof(T).Name} from {reader.TokenType} node (path: {reader.Path}).");
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 9ac3b6f7..caa66bad 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -88,6 +88,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <param name="modDirectory">The full path to the mod's folder.</param>
         /// <param name="currentInputState">Manages the game's input state for the current player instance. That may not be the main player in split-screen mode.</param>
         /// <param name="events">Manages access to events raised by SMAPI.</param>
+        /// <param name="contentHelper">An API for loading content assets.</param>
         /// <param name="gameContentHelper">An API for loading content assets from the game's <c>Content</c> folder or via <see cref="IModEvents.Content"/>.</param>
         /// <param name="modContentHelper">An API for loading content assets from your mod's files.</param>
         /// <param name="contentPackHelper">An API for managing content packs.</param>
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 62b15405..9444c046 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -100,7 +100,7 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? usePintail, bool? useRawImageLoading, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useRawImageLoading, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index d9969d4d..46d65f6a 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -191,7 +191,7 @@ namespace StardewModdingAPI.Framework
             string logPath = this.GetLogPath();
 
             // init basics
-            this.Settings = JsonConvert.DeserializeObject<SConfig>(File.ReadAllText(Constants.ApiConfigPath));
+            this.Settings = JsonConvert.DeserializeObject<SConfig>(File.ReadAllText(Constants.ApiConfigPath)) ?? throw new InvalidOperationException("The 'smapi-internal/config.json' file is missing or invalid. You can reinstall SMAPI to fix this.");
             if (File.Exists(Constants.ApiUserConfigPath))
                 JsonConvert.PopulateObject(File.ReadAllText(Constants.ApiUserConfigPath), this.Settings);
             if (developerMode.HasValue)
diff --git a/src/SMAPI/Framework/Serialization/KeybindConverter.cs b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
index 539f1291..f7b8e67e 100644
--- a/src/SMAPI/Framework/Serialization/KeybindConverter.cs
+++ b/src/SMAPI/Framework/Serialization/KeybindConverter.cs
@@ -49,7 +49,10 @@ namespace StardewModdingAPI.Framework.Serialization
 
                 case JsonToken.String:
                     {
-                        string str = JToken.Load(reader).Value<string>();
+                        string? str = JToken.Load(reader).Value<string>();
+
+                        if (str is null)
+                            return new Keybind(Array.Empty<SButton>());
 
                         if (objectType == typeof(Keybind))
                         {
diff --git a/src/SMAPI/Utilities/SDate.cs b/src/SMAPI/Utilities/SDate.cs
index c7ad41bd..06ee8b91 100644
--- a/src/SMAPI/Utilities/SDate.cs
+++ b/src/SMAPI/Utilities/SDate.cs
@@ -278,11 +278,11 @@ namespace StardewModdingAPI.Utilities
 
         /// <summary>Get whether a date represents 0 spring Y1, which is the date during the in-game intro.</summary>
         /// <param name="day">The day of month.</param>
-        /// <param name="season">The season name.</param>
+        /// <param name="season">The normalized season name.</param>
         /// <param name="year">The year.</param>
         private bool IsDayZero(int day, string season, int year)
         {
-            return day == 0 && season?.Trim().ToLower() == "spring" && year == 1;
+            return day == 0 && season == "spring" && year == 1;
         }
 
         /// <summary>Get the day of week for a given date.</summary>

From bcb9e25d8666d2c1384515063ffbf987c36b8b0e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 6 Jul 2022 22:25:45 -0400
Subject: [PATCH 712/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 12 ++++++------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 230758bd..230bef41 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.15.0</Version>
+    <Version>3.15.1</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0c3248e0..8b258fb3 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,10 +7,12 @@
   _If needed, you can update to SMAPI 3.15.0 first and then install to the latest version._
 -->
 
-## Upcoming release
+## 3.15.1
+Released 06 July 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
-  * Update alerts now mention which mod version you have now (thanks to ishanjalan!).
-  * Fixed lag which occurred for some players since Stardew Valley 1.5.5.
+  * Added current version to update alerts (thanks to ishan!).
+  * Fixed lag for some players since Stardew Valley 1.5.5.
   * Fixed `smapi-internal/config.user.json` overrides not applied after SMAPI 3.14.0.
   * Fixed PyTK not rescaling images correctly in some cases.  
     _When PyTK 1.23.0 or earlier is installed, this will disable the main performance improvements in SMAPI 3.15.0._
@@ -21,9 +23,7 @@
   * Fixed `TRACE` logs not tracking reloaded map tilesheets as a propagated asset.
 
 * For the web UI:
-  * Improved the log parser's 'suggested fixes' section:
-    * added warning if Error Handler is missing or outdated;
-    * improved visual styles.
+  * Added log parser suggested fix for missing/outdated Error Handler, and improved visual styles.
   * Updated the JSON validator/schema for Content Patcher 1.27.0.
   * Fixed the mod count in the log parser metadata.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 300de9d2..3c2dec19 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.15.0",
+    "Version": "3.15.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.15.0"
+    "MinimumApiVersion": "3.15.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 15a1e0f3..28b4b149 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.15.0",
+    "Version": "3.15.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.15.0"
+    "MinimumApiVersion": "3.15.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 1a11742c..1944575b 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.15.0",
+    "Version": "3.15.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.15.0"
+    "MinimumApiVersion": "3.15.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 33468717..d733e61e 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.15.0";
+        internal static string RawApiVersion = "3.15.1";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From dcb3a97727401c2b3704e277bc4062b3bd89448e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jul 2022 17:44:27 -0400
Subject: [PATCH 713/856] add log parser warning for PyTK compatibility mode

---
 docs/release-notes.md                      | 4 ++++
 src/SMAPI.Web/Views/LogParser/Index.cshtml | 7 ++++++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8b258fb3..cf237a82 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   _If needed, you can update to SMAPI 3.15.0 first and then install to the latest version._
 -->
 
+## Upcoming release
+* For the web UI:
+  * Added log parser warning about performance of PyTK 1.23.0 or earlier.
+
 ## 3.15.1
 Released 06 July 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index b824b768..57e26ace 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -17,6 +17,7 @@
     LogModInfo[] outdatedMods = log?.Mods.Where(mod => mod.HasUpdate).ToArray() ?? Array.Empty<LogModInfo>();
     LogModInfo? errorHandler = log?.Mods.FirstOrDefault(p => p.IsCodeMod && p.Name == "Error Handler");
     bool hasOlderErrorHandler = errorHandler?.GetParsedVersion() is not null && log?.ApiVersionParsed is not null && log.ApiVersionParsed.IsNewerThan(errorHandler.GetParsedVersion());
+    bool isPyTkCompatibilityMode = log?.ApiVersionParsed?.IsOlderThan("3.15.0") is false && log.Mods.Any(p => p.IsCodeMod && p.Name == "PyTK" && p.GetParsedVersion()?.IsOlderThan("1.23.1") is true);
 
     // get filters
     IDictionary<string, bool> defaultFilters = Enum
@@ -242,7 +243,7 @@ else if (log?.IsValid == true)
 @if (log?.IsValid == true)
 {
     <div id="output">
-        @if (outdatedMods.Any() || errorHandler is null || hasOlderErrorHandler)
+        @if (outdatedMods.Any() || errorHandler is null || hasOlderErrorHandler || isPyTkCompatibilityMode)
         {
             <h2>Suggested fixes</h2>
             <ul id="fix-list">
@@ -254,6 +255,10 @@ else if (log?.IsValid == true)
                 {
                     <li>Your <strong>Error Handler</strong> mod is older than SMAPI. You may be missing some game/mod error fixes. You can <a href="https://stardewvalleywiki.com/Modding:Player_Guide#Install_SMAPI">reinstall SMAPI</a> to update it.</li>
                 }
+                @if (isPyTkCompatibilityMode)
+                {
+                    <li>PyTK 1.23.0 or earlier isn't compatible with newer SMAPI performance optimizations. This may increase loading times or in-game lag.</li>
+                }
                 @if (outdatedMods.Any())
                 {
                     <li>

From 1b25710cf26ccc46485c9475e33980a5490b9561 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jul 2022 17:48:01 -0400
Subject: [PATCH 714/856] fix installer partly applying color theme before it's
 selected

---
 docs/release-notes.md                       |  3 +++
 src/SMAPI.Installer/InteractiveInstaller.cs | 12 ++++++------
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index cf237a82..6c3edb77 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Fixed Linux/macOS installer's color theme question partly unreadable if the terminal background is dark.
+
 * For the web UI:
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
 
diff --git a/src/SMAPI.Installer/InteractiveInstaller.cs b/src/SMAPI.Installer/InteractiveInstaller.cs
index fd1a6047..d00a5df4 100644
--- a/src/SMAPI.Installer/InteractiveInstaller.cs
+++ b/src/SMAPI.Installer/InteractiveInstaller.cs
@@ -206,7 +206,7 @@ namespace StardewModdingApi.Installer
                 Console.WriteLine();
 
                 // handle choice
-                string choice = this.InteractivelyChoose("Type 1 or 2, then press enter.", new[] { "1", "2" });
+                string choice = this.InteractivelyChoose("Type 1 or 2, then press enter.", new[] { "1", "2" }, printLine: Console.WriteLine);
                 switch (choice)
                 {
                     case "1":
@@ -629,22 +629,22 @@ namespace StardewModdingApi.Installer
         }
 
         /// <summary>Interactively ask the user to choose a value.</summary>
-        /// <param name="print">A callback which prints a message to the console.</param>
+        /// <param name="printLine">A callback which prints a message to the console.</param>
         /// <param name="message">The message to print.</param>
         /// <param name="options">The allowed options (not case sensitive).</param>
         /// <param name="indent">The indentation to prefix to output.</param>
-        private string InteractivelyChoose(string message, string[] options, string indent = "", Action<string>? print = null)
+        private string InteractivelyChoose(string message, string[] options, string indent = "", Action<string>? printLine = null)
         {
-            print ??= this.PrintInfo;
+            printLine ??= this.PrintInfo;
 
             while (true)
             {
-                print(indent + message);
+                printLine(indent + message);
                 Console.Write(indent);
                 string? input = Console.ReadLine()?.Trim().ToLowerInvariant();
                 if (input == null || !options.Contains(input))
                 {
-                    print($"{indent}That's not a valid option.");
+                    printLine($"{indent}That's not a valid option.");
                     continue;
                 }
                 return input;

From 1b3a1a48d0d0d7e2423db54f3266cabd80a5a9b3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jul 2022 19:02:33 -0400
Subject: [PATCH 715/856] refactor assembly resolver to avoid repeatedly
 copying search directory list

---
 src/SMAPI/Constants.cs                        |  4 +-
 .../ModLoading/AssemblyDefinitionResolver.cs  | 70 +++++++++++++++++--
 .../Framework/ModLoading/AssemblyLoader.cs    |  5 +-
 3 files changed, 67 insertions(+), 12 deletions(-)

diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 33468717..442f2ec8 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -244,8 +244,8 @@ namespace StardewModdingAPI
         internal static void ConfigureAssemblyResolver(AssemblyDefinitionResolver resolver)
         {
             // add search paths
-            resolver.AddSearchDirectory(Constants.GamePath);
-            resolver.AddSearchDirectory(Constants.InternalFilesPath);
+            resolver.TryAddSearchDirectory(Constants.GamePath);
+            resolver.TryAddSearchDirectory(Constants.InternalFilesPath);
 
             // add SMAPI explicitly
             // Normally this would be handled automatically by the search paths, but for some reason there's a specific
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
index b3378ad1..5a850255 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyDefinitionResolver.cs
@@ -4,18 +4,31 @@ using Mono.Cecil;
 namespace StardewModdingAPI.Framework.ModLoading
 {
     /// <summary>A minimal assembly definition resolver which resolves references to known assemblies.</summary>
-    internal class AssemblyDefinitionResolver : DefaultAssemblyResolver
+    internal class AssemblyDefinitionResolver : IAssemblyResolver
     {
         /*********
         ** Fields
         *********/
+        /// <summary>The underlying assembly resolver.</summary>
+        private readonly DefaultAssemblyResolverWrapper Resolver = new();
+
         /// <summary>The known assemblies.</summary>
         private readonly IDictionary<string, AssemblyDefinition> Lookup = new Dictionary<string, AssemblyDefinition>();
 
+        /// <summary>The directory paths to search for assemblies.</summary>
+        private readonly HashSet<string> SearchPaths = new();
+
 
         /*********
         ** Public methods
         *********/
+        /// <summary>Construct an instance.</summary>
+        public AssemblyDefinitionResolver()
+        {
+            foreach (string path in this.Resolver.GetSearchDirectories())
+                this.SearchPaths.Add(path);
+        }
+
         /// <summary>Add known assemblies to the resolver.</summary>
         /// <param name="assemblies">The known assemblies.</param>
         public void Add(params AssemblyDefinition[] assemblies)
@@ -29,7 +42,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="names">The assembly names for which it should be returned.</param>
         public void AddWithExplicitNames(AssemblyDefinition assembly, params string[] names)
         {
-            this.RegisterAssembly(assembly);
+            this.Resolver.AddAssembly(assembly);
             foreach (string name in names)
                 this.Lookup[name] = assembly;
         }
@@ -37,18 +50,52 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Resolve an assembly reference.</summary>
         /// <param name="name">The assembly name.</param>
         /// <exception cref="AssemblyResolutionException">The assembly can't be resolved.</exception>
-        public override AssemblyDefinition Resolve(AssemblyNameReference name)
+        public AssemblyDefinition Resolve(AssemblyNameReference name)
         {
-            return this.ResolveName(name.Name) ?? base.Resolve(name);
+            return this.ResolveName(name.Name) ?? this.Resolver.Resolve(name);
         }
 
         /// <summary>Resolve an assembly reference.</summary>
         /// <param name="name">The assembly name.</param>
         /// <param name="parameters">The assembly reader parameters.</param>
         /// <exception cref="AssemblyResolutionException">The assembly can't be resolved.</exception>
-        public override AssemblyDefinition Resolve(AssemblyNameReference name, ReaderParameters parameters)
+        public AssemblyDefinition Resolve(AssemblyNameReference name, ReaderParameters parameters)
         {
-            return this.ResolveName(name.Name) ?? base.Resolve(name, parameters);
+            return this.ResolveName(name.Name) ?? this.Resolver.Resolve(name, parameters);
+        }
+
+        /// <summary>Add a directory path to search for assemblies, if it's non-null and not already added.</summary>
+        /// <param name="path">The path to search.</param>
+        /// <returns>Returns whether the path was successfully added.</returns>
+        public bool TryAddSearchDirectory(string? path)
+        {
+            if (path is not null && this.SearchPaths.Add(path))
+            {
+                this.Resolver.AddSearchDirectory(path);
+                return true;
+            }
+
+            return false;
+        }
+
+        /// <summary>Remove a directory path to search for assemblies, if it's non-null.</summary>
+        /// <param name="path">The path to remove.</param>
+        /// <returns>Returns whether the path was in the list and removed.</returns>
+        public bool RemoveSearchDirectory(string? path)
+        {
+            if (path is not null && this.SearchPaths.Remove(path))
+            {
+                this.Resolver.RemoveSearchDirectory(path);
+                return true;
+            }
+
+            return false;
+        }
+
+        /// <inheritdoc />
+        public void Dispose()
+        {
+            this.Resolver.Dispose();
         }
 
 
@@ -63,5 +110,16 @@ namespace StardewModdingAPI.Framework.ModLoading
                 ? match
                 : null;
         }
+
+        /// <summary>An internal wrapper around <see cref="DefaultAssemblyResolver"/> to allow access to its protected methods.</summary>
+        private class DefaultAssemblyResolverWrapper : DefaultAssemblyResolver
+        {
+            /// <summary>Add an assembly to the resolver.</summary>
+            /// <param name="assembly">The assembly to add.</param>
+            public void AddAssembly(AssemblyDefinition assembly)
+            {
+                this.RegisterAssembly(assembly);
+            }
+        }
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index bd29a159..01037870 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -267,11 +267,8 @@ namespace StardewModdingAPI.Framework.ModLoading
             // add the assembly's directory temporarily if needed
             // this is needed by F# mods which bundle FSharp.Core.dll, for example
             string? temporarySearchDir = null;
-            if (file.DirectoryName is not null && !this.AssemblyDefinitionResolver.GetSearchDirectories().Contains(file.DirectoryName))
-            {
-                this.AssemblyDefinitionResolver.AddSearchDirectory(file.DirectoryName);
+            if (this.AssemblyDefinitionResolver.TryAddSearchDirectory(file.DirectoryName))
                 temporarySearchDir = file.DirectoryName;
-            }
 
             // read assembly
             AssemblyDefinition assembly;

From bc71665c1c696f5b99902bd3fc583f750a342fbe Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jul 2022 19:11:40 -0400
Subject: [PATCH 716/856] apply editorconfig

---
 src/SMAPI/app.manifest | 56 ++++++++++++++++++++----------------------
 1 file changed, 27 insertions(+), 29 deletions(-)

diff --git a/src/SMAPI/app.manifest b/src/SMAPI/app.manifest
index d209bf77..89aeca70 100644
--- a/src/SMAPI/app.manifest
+++ b/src/SMAPI/app.manifest
@@ -1,42 +1,40 @@
 <?xml version="1.0" encoding="utf-8"?>
 <assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
-  <assemblyIdentity version="1.0.0.0" name="Game1"/>
-  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
-    <security>
-      <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
-        <requestedExecutionLevel  level="asInvoker" uiAccess="false" />
-      </requestedPrivileges>
-    </security>
-  </trustInfo>
+    <assemblyIdentity version="1.0.0.0" name="Game1" />
+    <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
+        <security>
+            <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
+                <requestedExecutionLevel  level="asInvoker" uiAccess="false" />
+            </requestedPrivileges>
+        </security>
+    </trustInfo>
 
-  <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
-    <application>
-      <!-- A list of the Windows versions that this application has been tested on and is
+    <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
+        <application>
+            <!-- A list of the Windows versions that this application has been tested on and is
            is designed to work with. Uncomment the appropriate elements and Windows will 
            automatically selected the most compatible environment. -->
 
-      <!-- Windows Vista -->
-      <supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f0}" />
+            <!-- Windows Vista -->
+            <supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f0}" />
 
-      <!-- Windows 7 -->
-      <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}" />
+            <!-- Windows 7 -->
+            <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}" />
 
-      <!-- Windows 8 -->
-      <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}" />
+            <!-- Windows 8 -->
+            <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}" />
 
-      <!-- Windows 8.1 -->
-      <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}" />
+            <!-- Windows 8.1 -->
+            <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}" />
 
-      <!-- Windows 10 -->
-      <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
+            <!-- Windows 10 -->
+            <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
+        </application>
+    </compatibility>
 
+    <application xmlns="urn:schemas-microsoft-com:asm.v3">
+        <windowsSettings>
+            <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/pm</dpiAware>
+        </windowsSettings>
     </application>
-  </compatibility>
-
-  <application xmlns="urn:schemas-microsoft-com:asm.v3">
-    <windowsSettings>
-      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/pm</dpiAware>
-    </windowsSettings>
-  </application>
-
 </assembly>

From 0c787de2df202eb35c40b24b907619ecf750f051 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jul 2022 19:13:45 -0400
Subject: [PATCH 717/856] match settings used by the game

---
 src/SMAPI/app.manifest | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/app.manifest b/src/SMAPI/app.manifest
index 89aeca70..42faff59 100644
--- a/src/SMAPI/app.manifest
+++ b/src/SMAPI/app.manifest
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
-    <assemblyIdentity version="1.0.0.0" name="Game1" />
+    <assemblyIdentity version="1.0.0.0" name="StardropEngine"/>
     <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
         <security>
             <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
@@ -35,6 +35,7 @@
     <application xmlns="urn:schemas-microsoft-com:asm.v3">
         <windowsSettings>
             <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/pm</dpiAware>
+            <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">permonitorv2,permonitor</dpiAwareness>
         </windowsSettings>
     </application>
 </assembly>

From 8eeda8b4c496f73d2101c59f5b443bb6c2a2a06b Mon Sep 17 00:00:00 2001
From: Ishan Jalan <ishan1337@gmail.com>
Date: Fri, 8 Jul 2022 12:28:53 +0530
Subject: [PATCH 718/856] SVGs for pufferchick and pufferchick-cool

SVG > PNG
---
 .gitignore                                                | 4 ++++
 src/SMAPI.Web/Views/Index/Index.cshtml                    | 2 +-
 src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg | 1 +
 src/SMAPI.Web/wwwroot/Content/images/pufferchick.svg      | 1 +
 src/SMAPI.Web/wwwroot/Content/js/index.js                 | 4 ++--
 5 files changed, 9 insertions(+), 3 deletions(-)
 create mode 100644 src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
 create mode 100644 src/SMAPI.Web/wwwroot/Content/images/pufferchick.svg

diff --git a/.gitignore b/.gitignore
index 527ac6bb..e4cc7c26 100644
--- a/.gitignore
+++ b/.gitignore
@@ -34,3 +34,7 @@ appsettings.Development.json
 # Azure generated files
 src/SMAPI.Web/Properties/PublishProfiles/*.pubxml
 src/SMAPI.Web/Properties/ServiceDependencies/* - Web Deploy/
+src/SMAPI.Web/.DS_Store
+src/SMAPI.Web/wwwroot/Content/images/.DS_Store
+src/SMAPI.Web/wwwroot/Content/.DS_Store
+src/SMAPI.Web/wwwroot/.DS_Store
diff --git a/src/SMAPI.Web/Views/Index/Index.cshtml b/src/SMAPI.Web/Views/Index/Index.cshtml
index acb8df78..308ed1e5 100644
--- a/src/SMAPI.Web/Views/Index/Index.cshtml
+++ b/src/SMAPI.Web/Views/Index/Index.cshtml
@@ -15,7 +15,7 @@
 
 <h1>
     SMAPI
-    <img id="pufferchick" src="Content/images/pufferchick.png" />
+    <img id="pufferchick" src="Content/images/pufferchick.svg" />
 </h1>
 <div id="blurb">
     <p>The mod loader for Stardew Valley.</p>
diff --git a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
new file mode 100644
index 00000000..0b4c3ad1
--- /dev/null
+++ b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
@@ -0,0 +1 @@
+<svg width="57" height="57" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 18h3v9H0v-9Zm30 33h3v6h-3v-6ZM19 30h3v6h-3v-6Zm17 21h3v6h-3v-6ZM3 15h6v3H3v-3Zm6 3h6v3H9v-3Zm0 24h6v3H9v-3ZM24 6h6v3h-6V6Z" fill="#6B3407"/><path d="M15 42h6v3h-6v-3Zm30 0h6v3h-6v-3ZM33 24h6v3h-6v-3Z" fill="#8F4039"/><path d="M27 3h6v3h-6V3Z" fill="#FF4D1E"/><path d="M33 9h6v3h-6V9Z" fill="#8F4039"/><path d="M24 48h15v3H24v-3Zm-2-12h12v3H22v-3ZM21 0h12v3H21V0Zm0 3h3v3h-3V3Zm12 0h3v3h-3V3Zm3 3h3v3h-3V6ZM3 27h3v3H3v-3Z" fill="#6B3407"/><path d="M3 24h3v3H3v-3Zm3 3h3v3H6v-3Zm-3 6h3v3H3v-3Zm6 6h3v3H9v-3Zm10-3h3v3h-3v-3Zm15-3h3v3h-3v-3Z" fill="#9A4E0F"/><path d="M6 39h3v3H6v-3Zm16-9h3v3h-3v-3Z" fill="#6B3407"/><path d="M18 45h3v3h-3v-3Zm6 0h3v3h-3v-3Zm21 0h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-3-3h3v3h-3v-3Zm6-9h3v3h-3v-3Zm-3-3h3v3h-3v-3ZM27 9h3v3h-3V9Z" fill="#8F4039"/><path d="M24 3h3v3h-3V3Zm9 3h3v3h-3V6Z" fill="#C31E1E"/><path d="M30 6h3v3h-3V6Z" fill="#FF4D1E"/><path d="M24 12h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 18h3v3H3v-3Z" fill="#FFE2AF"/><path d="M6 18h3v3H6v-3Zm-3 3h3v3H3v-3Zm9 0h3v3h-3v-3Zm13 9h3v3h-3v-3Zm9 0h3v3h-3v-3Zm0 6h3v3h-3v-3ZM9 27h3v6H9v-6Zm-6 3h3v3H3v-3Zm12 6h3v3h-3v-3Z" fill="#DEA159"/><path d="M15 39h3v3h-3v-3Zm6 3h3v3h-3v-3Zm24-9h3v3h-3v-3Zm0-6h3v3h-3v-3Zm-18 0h15v3H27v-3Zm0 12h6v3h-6v-3Zm6 3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm0-12h9v3h-9v-3Zm-3-9h9v3h-9v-3Zm-12 0h9v3h-9v-3Zm0 9h9v3h-9v-3Zm6-6h12v6H30v-6Zm7 15h5v3h-5v-3Zm0-3h14v3H37v-3ZM27 12h9v3h-9v-3Z" fill="#FCD100"/><path d="M21 45h3v3h-3v-3Z" fill="#DF8900"/><path d="M21 45h3v3h-3v-3Zm21-3h3v3h-3v-3Zm3-3h3v3h-3v-3Zm3-6h3v3h-3v-3Zm-6 0h3v3h-3v-3Zm3-15h3v3h-3v-3Zm-9-6h3v3h-3v-3Zm-15 3h3v3h-3v-3Zm-3 3h3v3h-3v-3Zm6 9h3v3h-3v-3Zm9 12h3v3h-3v-3Zm15-15h3v6h-3v-6ZM19 39h8v3h-8v-3Zm5 3h9v3h-9v-3Zm3 3h12v3H27v-3Zm-9-15h1v12h-1V30Zm-3 3h3v3h-3v-3Zm0-9h3v3h-3v-3Zm0 3h3v3h-3v-3Zm3 0h3v3h-3v-3Z" fill="#DF8900"/><path d="M42 45h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-33-9h3v3h-3v-3Zm6-6h3v6h-3v-6Zm0-12h3v3h-3v-3Zm0 6h3v3h-3v-3Zm-3 3h3v6h-3v-6Zm33 6h3v3h-3v-3Zm-6-6h3v3h-3v-3Zm-21-3h3v6h-3v-6Z" fill="#FCD100"/><path d="M9 36h3v3H9v-3Zm-3-3h3v6H6v-6Zm6-3h3v12h-3V30Z" fill="#DEA159"/><path d="M6 30h3v3H6v-3Zm3 3h3v3H9v-3Zm13 0h12v3H22v-3Zm6-3h6v3h-6v-3ZM6 21h6v6H6v-6Zm6 3h3v6h-3v-6Z" fill="#FFE2AF"/><path d="M21 9h3v3h-3V9Zm18 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M42 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M42 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M27 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M27 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M21 21h3v3h-3v-3Zm9-12h3v3h-3V9Zm3 6h3v3h-3v-3Zm9-3h3v3h-3v-3Zm0 15h3v3h-3v-3Zm-5 9h2v3h-2v-3Z" fill="#FFFF0C"/><path d="M42 9h3v3h-3V9Zm9 21h3v6h-3v-6Zm-3-12h3v6h-3v-6Zm-3-6h3v6h-3v-6Zm-27 0h3v6h-3v-6Zm-3 6h3v6h-3v-6Zm24 27h3v3h-3v-3Zm3 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 36h3v3H3v-3Zm-3-6h3v6H0v-6Z" fill="#6B3407"/><path d="M8.097 17v1.548h9.29v1.549h1.549v1.548h1.548v1.549h1.548v1.548h9.29v-1.549h1.549v-1.548h1.548v-1.548h3.097v1.548h1.549v1.549h10.838v-1.549h1.549v-1.548H53V17H8.097Zm0 1.548H5v1.549h3.097v-1.549Z" fill="#000"/><path d="M20.484 18.548v1.549h1.548v-1.549h-1.548Zm1.548 1.549v1.548h1.549v-1.548h-1.549Zm1.549 0h1.548v-1.549H23.58v1.549Zm1.548 0v1.548h1.548v-1.548H25.13Zm1.548 1.548v1.549h1.549v-1.549h-1.549Zm-1.548 0H23.58v1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548H43.71v-1.548h-1.55v1.548h-1.548v-1.548h-1.548v-1.549Z" fill="#fff"/></svg>
\ No newline at end of file
diff --git a/src/SMAPI.Web/wwwroot/Content/images/pufferchick.svg b/src/SMAPI.Web/wwwroot/Content/images/pufferchick.svg
new file mode 100644
index 00000000..5e77e493
--- /dev/null
+++ b/src/SMAPI.Web/wwwroot/Content/images/pufferchick.svg
@@ -0,0 +1 @@
+<svg width="56" height="56" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 17.684h2.947v8.842H0v-8.842Zm29.474 32.421h2.947V56h-2.947v-5.895ZM18.667 29.474h2.947v5.894h-2.947v-5.894Zm16.701 20.631h2.948V56h-2.948v-5.895ZM2.947 14.737h5.895v2.947H2.947v-2.947Zm5.895 2.947h5.895v2.948H8.842v-2.948Zm0 23.579h5.895v2.948H8.842v-2.948ZM23.579 5.895h5.895v2.947h-5.895V5.895Z" fill="#6B3407"/><path d="M14.737 41.263h5.895v2.948h-5.895v-2.948Zm29.473 0h5.895v2.948h-5.894v-2.948ZM32.421 23.579h5.895v2.947H32.42V23.58Z" fill="#8F4039"/><path d="M26.526 2.947h5.895v2.948h-5.895V2.947Z" fill="#FF4D1E"/><path d="M32.421 8.842h5.895v2.947H32.42V8.843Z" fill="#8F4039"/><path d="M23.579 47.158h14.737v2.947H23.579v-2.947Zm-1.965-11.79h11.79v2.948h-11.79v-2.948ZM20.632 0h11.79v2.947h-11.79V0Zm0 2.947h2.947v2.948h-2.947V2.947Zm11.789 0h2.947v2.948h-2.947V2.947Zm2.947 2.948h2.948v2.947h-2.948V5.895ZM2.947 26.526h2.948v2.948H2.947v-2.948Z" fill="#6B3407"/><path d="M2.947 23.579h2.948v2.947H2.947V23.58Zm2.948 2.947h2.947v2.948H5.895v-2.948Zm-2.948 5.895h2.948v2.947H2.947v-2.947Zm5.895 5.895h2.947v2.947H8.843v-2.947Zm9.825-2.948h2.947v2.948h-2.947v-2.948Zm14.737-2.947h2.947v2.947h-2.947v-2.947Z" fill="#9A4E0F"/><path d="M5.895 38.316h2.947v2.947H5.895v-2.947Zm15.719-8.842h2.947v2.947h-2.947v-2.947Z" fill="#6B3407"/><path d="M17.684 44.21h2.948v2.948h-2.948V44.21Zm5.895 0h2.947v2.948H23.58V44.21Zm20.631 0h2.948v2.948H44.21V44.21Zm5.895-5.894h2.948v2.947h-2.948v-2.947Zm-2.947-2.948h2.947v2.948h-2.947v-2.948Zm5.895-8.842H56v2.948h-2.947v-2.948Zm-2.948-2.947h2.948v2.947h-2.948V23.58ZM26.526 8.842h2.948v2.947h-2.948V8.843Z" fill="#8F4039"/><path d="M23.579 2.947h2.947v2.948H23.58V2.947Zm8.842 2.948h2.947v2.947h-2.947V5.895Z" fill="#C31E1E"/><path d="M29.474 5.895h2.947v2.947h-2.947V5.895Z" fill="#FF4D1E"/><path d="M23.579 11.79h2.947v2.947H23.58V11.79Z" fill="#8F4039"/><path d="M2.947 17.684h2.948v2.948H2.947v-2.948Z" fill="#FFE2AF"/><path d="M5.895 17.684h2.947v2.948H5.895v-2.948Zm-2.948 2.948h2.948v2.947H2.947v-2.947Zm8.843 0h2.947v2.947H11.79v-2.947Zm12.771 8.842h2.948v2.947H24.56v-2.947Zm8.843 0h2.947v2.947h-2.947v-2.947Zm0 5.894h2.947v2.948h-2.947v-2.948ZM8.842 26.526h2.947v5.895H8.843v-5.895Zm-5.895 2.948h2.948v2.947H2.947v-2.947Zm11.79 5.894h2.947v2.948h-2.947v-2.948Z" fill="#DEA159"/><path d="M14.737 38.316h2.947v2.947h-2.947v-2.947Zm5.895 2.947h2.947v2.948h-2.947v-2.948Zm23.578-8.842h2.948v2.947H44.21v-2.947Zm0-5.895h2.948v2.948H44.21v-2.948Zm-17.684 0h14.737v2.948H26.526v-2.948Zm0 11.79h5.895v2.947h-5.895v-2.947Zm5.895 2.947h8.842v2.948h-8.842v-2.948Z" fill="#FCD100"/><path d="M35.368 38.316h8.843v2.947h-8.843v-2.947Zm2.948-2.948h8.842v2.948h-8.842v-2.948Zm0-11.789h8.842v2.947h-8.842V23.58Zm-2.948-8.842h8.843v2.947h-8.843v-2.947Zm-11.789 0h8.842v2.947H23.58v-2.947Zm0 8.842h8.842v2.947H23.58V23.58Zm5.895-5.895h11.79v5.895h-11.79v-5.895Zm6.876 14.737h4.913v2.947h-4.912v-2.947Zm0-2.947h13.755v2.947H36.351v-2.947ZM26.526 11.79h8.842v2.947h-8.842V11.79Z" fill="#FCD100"/><path d="M20.632 44.21h2.947v2.948h-2.947V44.21Z" fill="#DF8900"/><path d="M20.632 44.21h2.947v2.948h-2.947V44.21Zm20.631-2.947h2.948v2.948h-2.948v-2.948Z" fill="#DF8900"/><path d="M44.21 38.316h2.948v2.947H44.21v-2.947Zm2.948-5.895h2.947v2.947h-2.947v-2.947Zm-5.895 0h2.948v2.947h-2.948v-2.947Zm2.947-14.737h2.948v2.948H44.21v-2.948Zm-8.842-5.894h2.948v2.947h-2.948V11.79Zm-14.736 2.947h2.947v2.947h-2.947v-2.947Zm-2.948 2.947h2.948v2.948h-2.948v-2.948Zm5.895 8.842h2.947v2.948H23.58v-2.948Zm8.842 11.79h2.947v2.947h-2.947v-2.947Zm14.737-14.737h2.947v5.895h-2.947v-5.895ZM18.667 38.316h7.86v2.947h-7.86v-2.947Z" fill="#DF8900"/><path d="M23.579 41.263h8.842v2.948H23.58v-2.948Z" fill="#DF8900"/><path d="M26.526 44.21h11.79v2.948h-11.79V44.21Zm-8.842-14.736h.983v11.79h-.983v-11.79Zm-2.947 2.947h2.947v2.947h-2.947v-2.947Zm0-8.842h2.947v2.947h-2.947V23.58Zm0 2.947h2.947v2.948h-2.947v-2.948Z" fill="#DF8900"/><path d="M17.684 26.526h2.948v2.948h-2.948v-2.948Z" fill="#DF8900"/><path d="M41.263 44.21h2.948v2.948h-2.948V44.21Zm5.895-5.894h2.947v2.947h-2.947v-2.947Zm-32.421-8.842h2.947v2.947h-2.947v-2.947Zm5.895-5.895h2.947v5.895h-2.947v-5.895Zm0-11.789h2.947v2.947h-2.947V11.79Zm0 5.894h2.947v2.948h-2.947v-2.948Zm-2.948 2.948h2.948v5.894h-2.948v-5.894Zm32.421 5.894h2.948v2.948h-2.948v-2.948Zm-5.895-5.894h2.948v2.947H44.21v-2.947Zm-20.631-2.948h2.947v5.895H23.58v-5.895Z" fill="#FCD100"/><path d="M8.842 35.368h2.947v2.948H8.843v-2.948Zm-2.947-2.947h2.947v5.895H5.895V32.42Zm5.895-2.947h2.947v11.79H11.79v-11.79Z" fill="#DEA159"/><path d="M5.895 29.474h2.947v2.947H5.895v-2.947Zm2.947 2.947h2.947v2.947H8.843v-2.947Zm12.772 0h11.79v2.947h-11.79v-2.947Zm5.895-2.947h5.895v2.947h-5.895v-2.947ZM5.895 20.632h5.895v5.894H5.895v-5.894Zm5.895 2.947h2.947v5.895H11.79v-5.895Z" fill="#FFE2AF"/><path d="M20.632 8.842h2.947v2.947h-2.947V8.843Zm17.684 2.948h2.947v2.947h-2.947V11.79Z" fill="#8F4039"/><path d="M41.263 17.684h2.948v2.948h-2.948v-2.948Z" fill="#2F2000"/><path d="M41.263 20.632h2.948v2.947h-2.948v-2.947Z" fill="#F4F7AC"/><path d="M26.526 17.684h2.948v2.948h-2.948v-2.948Z" fill="#2F2000"/><path d="M26.526 20.632h2.948v2.947h-2.948v-2.947Z" fill="#F4F7AC"/><path d="M20.632 20.632h2.947v2.947h-2.947v-2.947Zm8.842-11.79h2.947v2.947h-2.947V8.843Zm2.947 5.895h2.947v2.947h-2.947v-2.947Zm8.842-2.947h2.948v2.947h-2.948V11.79Zm0 14.736h2.948v2.948h-2.948v-2.948Zm-4.913 8.842h1.966v2.948H36.35v-2.948Z" fill="#FFFF0C"/><path d="M41.263 8.842h2.948v2.947h-2.948V8.843Zm8.842 20.632h2.948v5.894h-2.948v-5.894Zm-2.947-11.79h2.947v5.895h-2.947v-5.895ZM44.21 11.79h2.948v5.894H44.21V11.79Zm-26.526 0h2.948v5.894h-2.948V11.79Zm-2.947 5.894h2.947v5.895h-2.947v-5.895ZM38.316 44.21h2.947v2.948h-2.947V44.21Zm2.947 2.948h2.948v2.947h-2.948v-2.947Z" fill="#8F4039"/><path d="M2.947 35.368h2.948v2.948H2.947v-2.948ZM0 29.474h2.947v5.894H0v-5.894Z" fill="#6B3407"/></svg>
\ No newline at end of file
diff --git a/src/SMAPI.Web/wwwroot/Content/js/index.js b/src/SMAPI.Web/wwwroot/Content/js/index.js
index d0734b02..04db5c2f 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/index.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/index.js
@@ -3,10 +3,10 @@ $(document).ready(function () {
     var pufferchick = $("#pufferchick");
     $(".cta-dropdown").hover(
         function () {
-            pufferchick.attr("src", "Content/images/pufferchick-cool.png");
+            pufferchick.attr("src", "Content/images/pufferchick-cool.svg");
         },
         function () {
-            pufferchick.attr("src", "Content/images/pufferchick.png");
+            pufferchick.attr("src", "Content/images/pufferchick.svg");
         }
     );
 

From 173bc4f517586a0b0cbbcf3ec6f966800c734bd4 Mon Sep 17 00:00:00 2001
From: Ishan Jalan <ishan1337@gmail.com>
Date: Fri, 8 Jul 2022 20:50:34 +0530
Subject: [PATCH 719/856] Updated pufferchick cool

---
 .gitignore                                                | 1 +
 src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index e4cc7c26..daf93b7e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -38,3 +38,4 @@ src/SMAPI.Web/.DS_Store
 src/SMAPI.Web/wwwroot/Content/images/.DS_Store
 src/SMAPI.Web/wwwroot/Content/.DS_Store
 src/SMAPI.Web/wwwroot/.DS_Store
+.DS_Store
diff --git a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
index 0b4c3ad1..a4985468 100644
--- a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
+++ b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
@@ -1 +1 @@
-<svg width="57" height="57" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 18h3v9H0v-9Zm30 33h3v6h-3v-6ZM19 30h3v6h-3v-6Zm17 21h3v6h-3v-6ZM3 15h6v3H3v-3Zm6 3h6v3H9v-3Zm0 24h6v3H9v-3ZM24 6h6v3h-6V6Z" fill="#6B3407"/><path d="M15 42h6v3h-6v-3Zm30 0h6v3h-6v-3ZM33 24h6v3h-6v-3Z" fill="#8F4039"/><path d="M27 3h6v3h-6V3Z" fill="#FF4D1E"/><path d="M33 9h6v3h-6V9Z" fill="#8F4039"/><path d="M24 48h15v3H24v-3Zm-2-12h12v3H22v-3ZM21 0h12v3H21V0Zm0 3h3v3h-3V3Zm12 0h3v3h-3V3Zm3 3h3v3h-3V6ZM3 27h3v3H3v-3Z" fill="#6B3407"/><path d="M3 24h3v3H3v-3Zm3 3h3v3H6v-3Zm-3 6h3v3H3v-3Zm6 6h3v3H9v-3Zm10-3h3v3h-3v-3Zm15-3h3v3h-3v-3Z" fill="#9A4E0F"/><path d="M6 39h3v3H6v-3Zm16-9h3v3h-3v-3Z" fill="#6B3407"/><path d="M18 45h3v3h-3v-3Zm6 0h3v3h-3v-3Zm21 0h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-3-3h3v3h-3v-3Zm6-9h3v3h-3v-3Zm-3-3h3v3h-3v-3ZM27 9h3v3h-3V9Z" fill="#8F4039"/><path d="M24 3h3v3h-3V3Zm9 3h3v3h-3V6Z" fill="#C31E1E"/><path d="M30 6h3v3h-3V6Z" fill="#FF4D1E"/><path d="M24 12h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 18h3v3H3v-3Z" fill="#FFE2AF"/><path d="M6 18h3v3H6v-3Zm-3 3h3v3H3v-3Zm9 0h3v3h-3v-3Zm13 9h3v3h-3v-3Zm9 0h3v3h-3v-3Zm0 6h3v3h-3v-3ZM9 27h3v6H9v-6Zm-6 3h3v3H3v-3Zm12 6h3v3h-3v-3Z" fill="#DEA159"/><path d="M15 39h3v3h-3v-3Zm6 3h3v3h-3v-3Zm24-9h3v3h-3v-3Zm0-6h3v3h-3v-3Zm-18 0h15v3H27v-3Zm0 12h6v3h-6v-3Zm6 3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm0-12h9v3h-9v-3Zm-3-9h9v3h-9v-3Zm-12 0h9v3h-9v-3Zm0 9h9v3h-9v-3Zm6-6h12v6H30v-6Zm7 15h5v3h-5v-3Zm0-3h14v3H37v-3ZM27 12h9v3h-9v-3Z" fill="#FCD100"/><path d="M21 45h3v3h-3v-3Z" fill="#DF8900"/><path d="M21 45h3v3h-3v-3Zm21-3h3v3h-3v-3Zm3-3h3v3h-3v-3Zm3-6h3v3h-3v-3Zm-6 0h3v3h-3v-3Zm3-15h3v3h-3v-3Zm-9-6h3v3h-3v-3Zm-15 3h3v3h-3v-3Zm-3 3h3v3h-3v-3Zm6 9h3v3h-3v-3Zm9 12h3v3h-3v-3Zm15-15h3v6h-3v-6ZM19 39h8v3h-8v-3Zm5 3h9v3h-9v-3Zm3 3h12v3H27v-3Zm-9-15h1v12h-1V30Zm-3 3h3v3h-3v-3Zm0-9h3v3h-3v-3Zm0 3h3v3h-3v-3Zm3 0h3v3h-3v-3Z" fill="#DF8900"/><path d="M42 45h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-33-9h3v3h-3v-3Zm6-6h3v6h-3v-6Zm0-12h3v3h-3v-3Zm0 6h3v3h-3v-3Zm-3 3h3v6h-3v-6Zm33 6h3v3h-3v-3Zm-6-6h3v3h-3v-3Zm-21-3h3v6h-3v-6Z" fill="#FCD100"/><path d="M9 36h3v3H9v-3Zm-3-3h3v6H6v-6Zm6-3h3v12h-3V30Z" fill="#DEA159"/><path d="M6 30h3v3H6v-3Zm3 3h3v3H9v-3Zm13 0h12v3H22v-3Zm6-3h6v3h-6v-3ZM6 21h6v6H6v-6Zm6 3h3v6h-3v-6Z" fill="#FFE2AF"/><path d="M21 9h3v3h-3V9Zm18 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M42 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M42 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M27 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M27 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M21 21h3v3h-3v-3Zm9-12h3v3h-3V9Zm3 6h3v3h-3v-3Zm9-3h3v3h-3v-3Zm0 15h3v3h-3v-3Zm-5 9h2v3h-2v-3Z" fill="#FFFF0C"/><path d="M42 9h3v3h-3V9Zm9 21h3v6h-3v-6Zm-3-12h3v6h-3v-6Zm-3-6h3v6h-3v-6Zm-27 0h3v6h-3v-6Zm-3 6h3v6h-3v-6Zm24 27h3v3h-3v-3Zm3 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 36h3v3H3v-3Zm-3-6h3v6H0v-6Z" fill="#6B3407"/><path d="M8.097 17v1.548h9.29v1.549h1.549v1.548h1.548v1.549h1.548v1.548h9.29v-1.549h1.549v-1.548h1.548v-1.548h3.097v1.548h1.549v1.549h10.838v-1.549h1.549v-1.548H53V17H8.097Zm0 1.548H5v1.549h3.097v-1.549Z" fill="#000"/><path d="M20.484 18.548v1.549h1.548v-1.549h-1.548Zm1.548 1.549v1.548h1.549v-1.548h-1.549Zm1.549 0h1.548v-1.549H23.58v1.549Zm1.548 0v1.548h1.548v-1.548H25.13Zm1.548 1.548v1.549h1.549v-1.549h-1.549Zm-1.548 0H23.58v1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548H43.71v-1.548h-1.55v1.548h-1.548v-1.548h-1.548v-1.549Z" fill="#fff"/></svg>
\ No newline at end of file
+<svg width="57" height="57" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 18h3v9H0v-9Zm30 33h3v6h-3v-6ZM19 30h3v6h-3v-6Zm17 21h3v6h-3v-6ZM3 15h6v3H3v-3Zm6 3h6v3H9v-3Zm0 24h6v3H9v-3ZM24 6h6v3h-6V6Z" fill="#6B3407"/><path d="M15 42h6v3h-6v-3Zm30 0h6v3h-6v-3ZM33 24h6v3h-6v-3Z" fill="#8F4039"/><path d="M27 3h6v3h-6V3Z" fill="#FF4D1E"/><path d="M33 9h6v3h-6V9Z" fill="#8F4039"/><path d="M24 48h15v3H24v-3Zm-2-12h12v3H22v-3ZM21 0h12v3H21V0Zm0 3h3v3h-3V3Zm12 0h3v3h-3V3Zm3 3h3v3h-3V6ZM3 27h3v3H3v-3Z" fill="#6B3407"/><path d="M3 24h3v3H3v-3Zm3 3h3v3H6v-3Zm-3 6h3v3H3v-3Zm6 6h3v3H9v-3Zm10-3h3v3h-3v-3Zm15-3h3v3h-3v-3Z" fill="#9A4E0F"/><path d="M6 39h3v3H6v-3Zm16-9h3v3h-3v-3Z" fill="#6B3407"/><path d="M18 45h3v3h-3v-3Zm6 0h3v3h-3v-3Zm21 0h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-3-3h3v3h-3v-3Zm6-9h3v3h-3v-3Zm-3-3h3v3h-3v-3ZM27 9h3v3h-3V9Z" fill="#8F4039"/><path d="M24 3h3v3h-3V3Zm9 3h3v3h-3V6Z" fill="#C31E1E"/><path d="M30 6h3v3h-3V6Z" fill="#FF4D1E"/><path d="M24 12h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 18h3v3H3v-3Z" fill="#FFE2AF"/><path d="M6 18h3v3H6v-3Zm-3 3h3v3H3v-3Zm9 0h3v3h-3v-3Zm13 9h3v3h-3v-3Zm9 0h3v3h-3v-3Zm0 6h3v3h-3v-3ZM9 27h3v6H9v-6Zm-6 3h3v3H3v-3Zm12 6h3v3h-3v-3Z" fill="#DEA159"/><path d="M15 39h3v3h-3v-3Zm6 3h3v3h-3v-3Zm24-9h3v3h-3v-3Zm0-6h3v3h-3v-3Zm-18 0h15v3H27v-3Zm0 12h6v3h-6v-3Zm6 3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm0-12h9v3h-9v-3Zm-3-9h9v3h-9v-3Zm-12 0h9v3h-9v-3Zm0 9h9v3h-9v-3Zm6-6h12v6H30v-6Zm7 15h5v3h-5v-3Zm0-3h14v3H37v-3ZM27 12h9v3h-9v-3Z" fill="#FCD100"/><path d="M21 45h3v3h-3v-3Z" fill="#DF8900"/><path d="M21 45h3v3h-3v-3Zm21-3h3v3h-3v-3Zm3-3h3v3h-3v-3Zm3-6h3v3h-3v-3Zm-6 0h3v3h-3v-3Zm3-15h3v3h-3v-3Zm-9-6h3v3h-3v-3Zm-15 3h3v3h-3v-3Zm-3 3h3v3h-3v-3Zm6 9h3v3h-3v-3Zm9 12h3v3h-3v-3Zm15-15h3v6h-3v-6ZM19 39h8v3h-8v-3Zm5 3h9v3h-9v-3Zm3 3h12v3H27v-3Zm-9-15h1v12h-1V30Zm-3 3h3v3h-3v-3Zm0-9h3v3h-3v-3Zm0 3h3v3h-3v-3Zm3 0h3v3h-3v-3Z" fill="#DF8900"/><path d="M42 45h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-33-9h3v3h-3v-3Zm6-6h3v6h-3v-6Zm0-12h3v3h-3v-3Zm0 6h3v3h-3v-3Zm-3 3h3v6h-3v-6Zm33 6h3v3h-3v-3Zm-6-6h3v3h-3v-3Zm-21-3h3v6h-3v-6Z" fill="#FCD100"/><path d="M9 36h3v3H9v-3Zm-3-3h3v6H6v-6Zm6-3h3v12h-3V30Z" fill="#DEA159"/><path d="M6 30h3v3H6v-3Zm3 3h3v3H9v-3Zm13 0h12v3H22v-3Zm6-3h6v3h-6v-3ZM6 21h6v6H6v-6Zm6 3h3v6h-3v-6Z" fill="#FFE2AF"/><path d="M21 9h3v3h-3V9Zm18 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M42 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M42 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M27 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M27 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M21 21h3v3h-3v-3Zm9-12h3v3h-3V9Zm3 6h3v3h-3v-3Zm9-3h3v3h-3v-3Zm0 15h3v3h-3v-3Zm-5 9h2v3h-2v-3Z" fill="#FFFF0C"/><path d="M42 9h3v3h-3V9Zm9 21h3v6h-3v-6Zm-3-12h3v6h-3v-6Zm-3-6h3v6h-3v-6Zm-27 0h3v6h-3v-6Zm-3 6h3v6h-3v-6Zm24 27h3v3h-3v-3Zm3 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 36h3v3H3v-3Zm-3-6h3v6H0v-6Z" fill="#6B3407"/><path d="M15.097 17v1.548h2.29v1.549h1.549v1.548h1.548v1.549h1.548v1.548h8.29v-1.549h1.549v-1.548h1.548v-1.548h4.097v1.548h1.549v1.549h1.583v2H46v-2h2.903v-1.549h1.549v-1.548H52V17H15.097Z" fill="#000"/><path d="M20 18.548v1.549h1.548v-1.549H20Zm1.548 1.549v1.548h1.549v-1.548h-1.549Zm1.549 0h1.548v-1.549h-1.549l.001 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm1.548 1.548v1.549h1.549v-1.549h-1.549Zm-1.548 0h-1.548l-.001 1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548h-1.548v-1.548h-1.549l-.001 1.548h-1.548l.001-1.548H38.58l.001-1.549Z" fill="#436173"/><path d="M20.484 18.548v1.549h1.548v-1.549h-1.548Zm1.548 1.549v1.548h1.549v-1.548h-1.55Zm1.549 0h1.548v-1.549h-1.55l.002 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm1.548 1.548v1.549h1.549v-1.549h-1.55Zm-1.548 0H23.58l-.001 1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548H43.71v-1.548h-1.55v1.548h-1.548v-1.548h-1.548v-1.549Z" fill="#667575"/></svg>
\ No newline at end of file

From a52f24307b45e028aa08bc13352a89293567b850 Mon Sep 17 00:00:00 2001
From: Ishan Jalan <ishan1337@gmail.com>
Date: Fri, 8 Jul 2022 21:03:43 +0530
Subject: [PATCH 720/856] pufferchick-cool updated [2]

---
 src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
index a4985468..cb38da73 100644
--- a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
+++ b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
@@ -1 +1 @@
-<svg width="57" height="57" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 18h3v9H0v-9Zm30 33h3v6h-3v-6ZM19 30h3v6h-3v-6Zm17 21h3v6h-3v-6ZM3 15h6v3H3v-3Zm6 3h6v3H9v-3Zm0 24h6v3H9v-3ZM24 6h6v3h-6V6Z" fill="#6B3407"/><path d="M15 42h6v3h-6v-3Zm30 0h6v3h-6v-3ZM33 24h6v3h-6v-3Z" fill="#8F4039"/><path d="M27 3h6v3h-6V3Z" fill="#FF4D1E"/><path d="M33 9h6v3h-6V9Z" fill="#8F4039"/><path d="M24 48h15v3H24v-3Zm-2-12h12v3H22v-3ZM21 0h12v3H21V0Zm0 3h3v3h-3V3Zm12 0h3v3h-3V3Zm3 3h3v3h-3V6ZM3 27h3v3H3v-3Z" fill="#6B3407"/><path d="M3 24h3v3H3v-3Zm3 3h3v3H6v-3Zm-3 6h3v3H3v-3Zm6 6h3v3H9v-3Zm10-3h3v3h-3v-3Zm15-3h3v3h-3v-3Z" fill="#9A4E0F"/><path d="M6 39h3v3H6v-3Zm16-9h3v3h-3v-3Z" fill="#6B3407"/><path d="M18 45h3v3h-3v-3Zm6 0h3v3h-3v-3Zm21 0h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-3-3h3v3h-3v-3Zm6-9h3v3h-3v-3Zm-3-3h3v3h-3v-3ZM27 9h3v3h-3V9Z" fill="#8F4039"/><path d="M24 3h3v3h-3V3Zm9 3h3v3h-3V6Z" fill="#C31E1E"/><path d="M30 6h3v3h-3V6Z" fill="#FF4D1E"/><path d="M24 12h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 18h3v3H3v-3Z" fill="#FFE2AF"/><path d="M6 18h3v3H6v-3Zm-3 3h3v3H3v-3Zm9 0h3v3h-3v-3Zm13 9h3v3h-3v-3Zm9 0h3v3h-3v-3Zm0 6h3v3h-3v-3ZM9 27h3v6H9v-6Zm-6 3h3v3H3v-3Zm12 6h3v3h-3v-3Z" fill="#DEA159"/><path d="M15 39h3v3h-3v-3Zm6 3h3v3h-3v-3Zm24-9h3v3h-3v-3Zm0-6h3v3h-3v-3Zm-18 0h15v3H27v-3Zm0 12h6v3h-6v-3Zm6 3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm0-12h9v3h-9v-3Zm-3-9h9v3h-9v-3Zm-12 0h9v3h-9v-3Zm0 9h9v3h-9v-3Zm6-6h12v6H30v-6Zm7 15h5v3h-5v-3Zm0-3h14v3H37v-3ZM27 12h9v3h-9v-3Z" fill="#FCD100"/><path d="M21 45h3v3h-3v-3Z" fill="#DF8900"/><path d="M21 45h3v3h-3v-3Zm21-3h3v3h-3v-3Zm3-3h3v3h-3v-3Zm3-6h3v3h-3v-3Zm-6 0h3v3h-3v-3Zm3-15h3v3h-3v-3Zm-9-6h3v3h-3v-3Zm-15 3h3v3h-3v-3Zm-3 3h3v3h-3v-3Zm6 9h3v3h-3v-3Zm9 12h3v3h-3v-3Zm15-15h3v6h-3v-6ZM19 39h8v3h-8v-3Zm5 3h9v3h-9v-3Zm3 3h12v3H27v-3Zm-9-15h1v12h-1V30Zm-3 3h3v3h-3v-3Zm0-9h3v3h-3v-3Zm0 3h3v3h-3v-3Zm3 0h3v3h-3v-3Z" fill="#DF8900"/><path d="M42 45h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-33-9h3v3h-3v-3Zm6-6h3v6h-3v-6Zm0-12h3v3h-3v-3Zm0 6h3v3h-3v-3Zm-3 3h3v6h-3v-6Zm33 6h3v3h-3v-3Zm-6-6h3v3h-3v-3Zm-21-3h3v6h-3v-6Z" fill="#FCD100"/><path d="M9 36h3v3H9v-3Zm-3-3h3v6H6v-6Zm6-3h3v12h-3V30Z" fill="#DEA159"/><path d="M6 30h3v3H6v-3Zm3 3h3v3H9v-3Zm13 0h12v3H22v-3Zm6-3h6v3h-6v-3ZM6 21h6v6H6v-6Zm6 3h3v6h-3v-6Z" fill="#FFE2AF"/><path d="M21 9h3v3h-3V9Zm18 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M42 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M42 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M27 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M27 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M21 21h3v3h-3v-3Zm9-12h3v3h-3V9Zm3 6h3v3h-3v-3Zm9-3h3v3h-3v-3Zm0 15h3v3h-3v-3Zm-5 9h2v3h-2v-3Z" fill="#FFFF0C"/><path d="M42 9h3v3h-3V9Zm9 21h3v6h-3v-6Zm-3-12h3v6h-3v-6Zm-3-6h3v6h-3v-6Zm-27 0h3v6h-3v-6Zm-3 6h3v6h-3v-6Zm24 27h3v3h-3v-3Zm3 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 36h3v3H3v-3Zm-3-6h3v6H0v-6Z" fill="#6B3407"/><path d="M15.097 17v1.548h2.29v1.549h1.549v1.548h1.548v1.549h1.548v1.548h8.29v-1.549h1.549v-1.548h1.548v-1.548h4.097v1.548h1.549v1.549h1.583v2H46v-2h2.903v-1.549h1.549v-1.548H52V17H15.097Z" fill="#000"/><path d="M20 18.548v1.549h1.548v-1.549H20Zm1.548 1.549v1.548h1.549v-1.548h-1.549Zm1.549 0h1.548v-1.549h-1.549l.001 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm1.548 1.548v1.549h1.549v-1.549h-1.549Zm-1.548 0h-1.548l-.001 1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548h-1.548v-1.548h-1.549l-.001 1.548h-1.548l.001-1.548H38.58l.001-1.549Z" fill="#436173"/><path d="M20.484 18.548v1.549h1.548v-1.549h-1.548Zm1.548 1.549v1.548h1.549v-1.548h-1.55Zm1.549 0h1.548v-1.549h-1.55l.002 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm1.548 1.548v1.549h1.549v-1.549h-1.55Zm-1.548 0H23.58l-.001 1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548H43.71v-1.548h-1.55v1.548h-1.548v-1.548h-1.548v-1.549Z" fill="#667575"/></svg>
\ No newline at end of file
+<svg width="57" height="57" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 18h3v9H0v-9Zm30 33h3v6h-3v-6ZM19 30h3v6h-3v-6Zm17 21h3v6h-3v-6ZM3 15h6v3H3v-3Zm6 3h6v3H9v-3Zm0 24h6v3H9v-3ZM24 6h6v3h-6V6Z" fill="#6B3407"/><path d="M15 42h6v3h-6v-3Zm30 0h6v3h-6v-3ZM33 24h6v3h-6v-3Z" fill="#8F4039"/><path d="M27 3h6v3h-6V3Z" fill="#FF4D1E"/><path d="M33 9h6v3h-6V9Z" fill="#8F4039"/><path d="M24 48h15v3H24v-3Zm-2-12h12v3H22v-3ZM21 0h12v3H21V0Zm0 3h3v3h-3V3Zm12 0h3v3h-3V3Zm3 3h3v3h-3V6ZM3 27h3v3H3v-3Z" fill="#6B3407"/><path d="M3 24h3v3H3v-3Zm3 3h3v3H6v-3Zm-3 6h3v3H3v-3Zm6 6h3v3H9v-3Zm10-3h3v3h-3v-3Zm15-3h3v3h-3v-3Z" fill="#9A4E0F"/><path d="M6 39h3v3H6v-3Zm16-9h3v3h-3v-3Z" fill="#6B3407"/><path d="M18 45h3v3h-3v-3Zm6 0h3v3h-3v-3Zm21 0h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-3-3h3v3h-3v-3Zm6-9h3v3h-3v-3Zm-3-3h3v3h-3v-3ZM27 9h3v3h-3V9Z" fill="#8F4039"/><path d="M24 3h3v3h-3V3Zm9 3h3v3h-3V6Z" fill="#C31E1E"/><path d="M30 6h3v3h-3V6Z" fill="#FF4D1E"/><path d="M24 12h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 18h3v3H3v-3Z" fill="#FFE2AF"/><path d="M6 18h3v3H6v-3Zm-3 3h3v3H3v-3Zm9 0h3v3h-3v-3Zm13 9h3v3h-3v-3Zm9 0h3v3h-3v-3Zm0 6h3v3h-3v-3ZM9 27h3v6H9v-6Zm-6 3h3v3H3v-3Zm12 6h3v3h-3v-3Z" fill="#DEA159"/><path d="M15 39h3v3h-3v-3Zm6 3h3v3h-3v-3Zm24-9h3v3h-3v-3Zm0-6h3v3h-3v-3Zm-18 0h15v3H27v-3Zm0 12h6v3h-6v-3Zm6 3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm0-12h9v3h-9v-3Zm-3-9h9v3h-9v-3Zm-12 0h9v3h-9v-3Zm0 9h9v3h-9v-3Zm6-6h12v6H30v-6Zm7 15h5v3h-5v-3Zm0-3h14v3H37v-3ZM27 12h9v3h-9v-3Z" fill="#FCD100"/><path d="M21 45h3v3h-3v-3Z" fill="#DF8900"/><path d="M21 45h3v3h-3v-3Zm21-3h3v3h-3v-3Zm3-3h3v3h-3v-3Zm3-6h3v3h-3v-3Zm-6 0h3v3h-3v-3Zm3-15h3v3h-3v-3Zm-9-6h3v3h-3v-3Zm-15 3h3v3h-3v-3Zm-3 3h3v3h-3v-3Zm6 9h3v3h-3v-3Zm9 12h3v3h-3v-3Zm15-15h3v6h-3v-6ZM19 39h8v3h-8v-3Zm5 3h9v3h-9v-3Zm3 3h12v3H27v-3Zm-9-15h1v12h-1V30Zm-3 3h3v3h-3v-3Zm0-9h3v3h-3v-3Zm0 3h3v3h-3v-3Zm3 0h3v3h-3v-3Z" fill="#DF8900"/><path d="M42 45h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-33-9h3v3h-3v-3Zm6-6h3v6h-3v-6Zm0-12h3v3h-3v-3Zm0 6h3v3h-3v-3Zm-3 3h3v6h-3v-6Zm33 6h3v3h-3v-3Zm-6-6h3v3h-3v-3Zm-21-3h3v6h-3v-6Z" fill="#FCD100"/><path d="M9 36h3v3H9v-3Zm-3-3h3v6H6v-6Zm6-3h3v12h-3V30Z" fill="#DEA159"/><path d="M6 30h3v3H6v-3Zm3 3h3v3H9v-3Zm13 0h12v3H22v-3Zm6-3h6v3h-6v-3ZM6 21h6v6H6v-6Zm6 3h3v6h-3v-6Z" fill="#FFE2AF"/><path d="M21 9h3v3h-3V9Zm18 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M42 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M42 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M27 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M27 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M21 21h3v3h-3v-3Zm9-12h3v3h-3V9Zm3 6h3v3h-3v-3Zm9-3h3v3h-3v-3Zm0 15h3v3h-3v-3Zm-5 9h2v3h-2v-3Z" fill="#FFFF0C"/><path d="M42 9h3v3h-3V9Zm9 21h3v6h-3v-6Zm-3-12h3v6h-3v-6Zm-3-6h3v6h-3v-6Zm-27 0h3v6h-3v-6Zm-3 6h3v6h-3v-6Zm24 27h3v3h-3v-3Zm3 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 36h3v3H3v-3Zm-3-6h3v6H0v-6Z" fill="#6B3407"/><path d="M15.097 17v1.548h2.29v1.549h1.549v1.548h1.548v1.549h1.548v1.548h7.29v-1.549h1.549v-1.548h1.548v-1.548h5.097v1.548h1.549v1.549h1.583v1.546H47v-1.546h1.903v-1.549h1.549v-1.548H52V17H15.097Z" fill="#000"/><path d="M20 18.548v1.549h1.548v-1.549H20Zm1.548 1.549v1.548h1.549v-1.548h-1.549Zm1.549 0h1.548v-1.549h-1.549l.001 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm1.548 1.548v1.549h1.549v-1.549h-1.549Zm-1.548 0h-1.548l-.001 1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548h-1.548v-1.548h-1.549l-.001 1.548h-1.548l.001-1.548H38.58l.001-1.549Z" fill="#436173"/><path d="M20.484 18.548v1.549h1.548v-1.549h-1.548Zm1.548 1.549v1.548h1.549v-1.548h-1.55Zm1.549 0h1.548v-1.549h-1.55l.002 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm1.548 1.548v1.549h1.549v-1.549h-1.55Zm-1.548 0H23.58l-.001 1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548H43.71v-1.548h-1.55v1.548h-1.548v-1.548h-1.548v-1.549Z" fill="#667575"/></svg>
\ No newline at end of file

From 5da690cbefb34acaecaeaa17110d1b701f3d87ba Mon Sep 17 00:00:00 2001
From: Ishan Jalan <ishan1337@gmail.com>
Date: Fri, 8 Jul 2022 21:27:54 +0530
Subject: [PATCH 721/856] Update pufferchick-cool.svg

---
 src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
index cb38da73..28b03976 100644
--- a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
+++ b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
@@ -1 +1 @@
-<svg width="57" height="57" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 18h3v9H0v-9Zm30 33h3v6h-3v-6ZM19 30h3v6h-3v-6Zm17 21h3v6h-3v-6ZM3 15h6v3H3v-3Zm6 3h6v3H9v-3Zm0 24h6v3H9v-3ZM24 6h6v3h-6V6Z" fill="#6B3407"/><path d="M15 42h6v3h-6v-3Zm30 0h6v3h-6v-3ZM33 24h6v3h-6v-3Z" fill="#8F4039"/><path d="M27 3h6v3h-6V3Z" fill="#FF4D1E"/><path d="M33 9h6v3h-6V9Z" fill="#8F4039"/><path d="M24 48h15v3H24v-3Zm-2-12h12v3H22v-3ZM21 0h12v3H21V0Zm0 3h3v3h-3V3Zm12 0h3v3h-3V3Zm3 3h3v3h-3V6ZM3 27h3v3H3v-3Z" fill="#6B3407"/><path d="M3 24h3v3H3v-3Zm3 3h3v3H6v-3Zm-3 6h3v3H3v-3Zm6 6h3v3H9v-3Zm10-3h3v3h-3v-3Zm15-3h3v3h-3v-3Z" fill="#9A4E0F"/><path d="M6 39h3v3H6v-3Zm16-9h3v3h-3v-3Z" fill="#6B3407"/><path d="M18 45h3v3h-3v-3Zm6 0h3v3h-3v-3Zm21 0h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-3-3h3v3h-3v-3Zm6-9h3v3h-3v-3Zm-3-3h3v3h-3v-3ZM27 9h3v3h-3V9Z" fill="#8F4039"/><path d="M24 3h3v3h-3V3Zm9 3h3v3h-3V6Z" fill="#C31E1E"/><path d="M30 6h3v3h-3V6Z" fill="#FF4D1E"/><path d="M24 12h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 18h3v3H3v-3Z" fill="#FFE2AF"/><path d="M6 18h3v3H6v-3Zm-3 3h3v3H3v-3Zm9 0h3v3h-3v-3Zm13 9h3v3h-3v-3Zm9 0h3v3h-3v-3Zm0 6h3v3h-3v-3ZM9 27h3v6H9v-6Zm-6 3h3v3H3v-3Zm12 6h3v3h-3v-3Z" fill="#DEA159"/><path d="M15 39h3v3h-3v-3Zm6 3h3v3h-3v-3Zm24-9h3v3h-3v-3Zm0-6h3v3h-3v-3Zm-18 0h15v3H27v-3Zm0 12h6v3h-6v-3Zm6 3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm0-12h9v3h-9v-3Zm-3-9h9v3h-9v-3Zm-12 0h9v3h-9v-3Zm0 9h9v3h-9v-3Zm6-6h12v6H30v-6Zm7 15h5v3h-5v-3Zm0-3h14v3H37v-3ZM27 12h9v3h-9v-3Z" fill="#FCD100"/><path d="M21 45h3v3h-3v-3Z" fill="#DF8900"/><path d="M21 45h3v3h-3v-3Zm21-3h3v3h-3v-3Zm3-3h3v3h-3v-3Zm3-6h3v3h-3v-3Zm-6 0h3v3h-3v-3Zm3-15h3v3h-3v-3Zm-9-6h3v3h-3v-3Zm-15 3h3v3h-3v-3Zm-3 3h3v3h-3v-3Zm6 9h3v3h-3v-3Zm9 12h3v3h-3v-3Zm15-15h3v6h-3v-6ZM19 39h8v3h-8v-3Zm5 3h9v3h-9v-3Zm3 3h12v3H27v-3Zm-9-15h1v12h-1V30Zm-3 3h3v3h-3v-3Zm0-9h3v3h-3v-3Zm0 3h3v3h-3v-3Zm3 0h3v3h-3v-3Z" fill="#DF8900"/><path d="M42 45h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-33-9h3v3h-3v-3Zm6-6h3v6h-3v-6Zm0-12h3v3h-3v-3Zm0 6h3v3h-3v-3Zm-3 3h3v6h-3v-6Zm33 6h3v3h-3v-3Zm-6-6h3v3h-3v-3Zm-21-3h3v6h-3v-6Z" fill="#FCD100"/><path d="M9 36h3v3H9v-3Zm-3-3h3v6H6v-6Zm6-3h3v12h-3V30Z" fill="#DEA159"/><path d="M6 30h3v3H6v-3Zm3 3h3v3H9v-3Zm13 0h12v3H22v-3Zm6-3h6v3h-6v-3ZM6 21h6v6H6v-6Zm6 3h3v6h-3v-6Z" fill="#FFE2AF"/><path d="M21 9h3v3h-3V9Zm18 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M42 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M42 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M27 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M27 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M21 21h3v3h-3v-3Zm9-12h3v3h-3V9Zm3 6h3v3h-3v-3Zm9-3h3v3h-3v-3Zm0 15h3v3h-3v-3Zm-5 9h2v3h-2v-3Z" fill="#FFFF0C"/><path d="M42 9h3v3h-3V9Zm9 21h3v6h-3v-6Zm-3-12h3v6h-3v-6Zm-3-6h3v6h-3v-6Zm-27 0h3v6h-3v-6Zm-3 6h3v6h-3v-6Zm24 27h3v3h-3v-3Zm3 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 36h3v3H3v-3Zm-3-6h3v6H0v-6Z" fill="#6B3407"/><path d="M15.097 17v1.548h2.29v1.549h1.549v1.548h1.548v1.549h1.548v1.548h7.29v-1.549h1.549v-1.548h1.548v-1.548h5.097v1.548h1.549v1.549h1.583v1.546H47v-1.546h1.903v-1.549h1.549v-1.548H52V17H15.097Z" fill="#000"/><path d="M20 18.548v1.549h1.548v-1.549H20Zm1.548 1.549v1.548h1.549v-1.548h-1.549Zm1.549 0h1.548v-1.549h-1.549l.001 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm1.548 1.548v1.549h1.549v-1.549h-1.549Zm-1.548 0h-1.548l-.001 1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548h-1.548v-1.548h-1.549l-.001 1.548h-1.548l.001-1.548H38.58l.001-1.549Z" fill="#436173"/><path d="M20.484 18.548v1.549h1.548v-1.549h-1.548Zm1.548 1.549v1.548h1.549v-1.548h-1.55Zm1.549 0h1.548v-1.549h-1.55l.002 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm1.548 1.548v1.549h1.549v-1.549h-1.55Zm-1.548 0H23.58l-.001 1.549h1.549v-1.549Zm13.936-3.097h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548H43.71v-1.548h-1.55v1.548h-1.548v-1.548h-1.548v-1.549Z" fill="#667575"/></svg>
\ No newline at end of file
+<svg width="57" height="57" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 18h3v9H0v-9Zm30 33h3v6h-3v-6ZM19 30h3v6h-3v-6Zm17 21h3v6h-3v-6ZM3 15h6v3H3v-3Zm6 3h6v3H9v-3Zm0 24h6v3H9v-3ZM24 6h6v3h-6V6Z" fill="#6B3407"/><path d="M15 42h6v3h-6v-3Zm30 0h6v3h-6v-3ZM33 24h6v3h-6v-3Z" fill="#8F4039"/><path d="M27 3h6v3h-6V3Z" fill="#FF4D1E"/><path d="M33 9h6v3h-6V9Z" fill="#8F4039"/><path d="M24 48h15v3H24v-3Zm-2-12h12v3H22v-3ZM21 0h12v3H21V0Zm0 3h3v3h-3V3Zm12 0h3v3h-3V3Zm3 3h3v3h-3V6ZM3 27h3v3H3v-3Z" fill="#6B3407"/><path d="M3 24h3v3H3v-3Zm3 3h3v3H6v-3Zm-3 6h3v3H3v-3Zm6 6h3v3H9v-3Zm10-3h3v3h-3v-3Zm15-3h3v3h-3v-3Z" fill="#9A4E0F"/><path d="M6 39h3v3H6v-3Zm16-9h3v3h-3v-3Z" fill="#6B3407"/><path d="M18 45h3v3h-3v-3Zm6 0h3v3h-3v-3Zm21 0h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-3-3h3v3h-3v-3Zm6-9h3v3h-3v-3Zm-3-3h3v3h-3v-3ZM27 9h3v3h-3V9Z" fill="#8F4039"/><path d="M24 3h3v3h-3V3Zm9 3h3v3h-3V6Z" fill="#C31E1E"/><path d="M30 6h3v3h-3V6Z" fill="#FF4D1E"/><path d="M24 12h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 18h3v3H3v-3Z" fill="#FFE2AF"/><path d="M6 18h3v3H6v-3Zm-3 3h3v3H3v-3Zm9 0h3v3h-3v-3Zm13 9h3v3h-3v-3Zm9 0h3v3h-3v-3Zm0 6h3v3h-3v-3ZM9 27h3v6H9v-6Zm-6 3h3v3H3v-3Zm12 6h3v3h-3v-3Z" fill="#DEA159"/><path d="M15 39h3v3h-3v-3Zm6 3h3v3h-3v-3Zm24-9h3v3h-3v-3Zm0-6h3v3h-3v-3Zm-18 0h15v3H27v-3Zm0 12h6v3h-6v-3Zm6 3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm0-12h9v3h-9v-3Zm-3-9h9v3h-9v-3Zm-12 0h9v3h-9v-3Zm0 9h9v3h-9v-3Zm6-6h12v6H30v-6Zm7 15h5v3h-5v-3Zm0-3h14v3H37v-3ZM27 12h9v3h-9v-3Z" fill="#FCD100"/><path d="M21 45h3v3h-3v-3Z" fill="#DF8900"/><path d="M21 45h3v3h-3v-3Zm21-3h3v3h-3v-3Zm3-3h3v3h-3v-3Zm3-6h3v3h-3v-3Zm-6 0h3v3h-3v-3Zm3-15h3v3h-3v-3Zm-9-6h3v3h-3v-3Zm-15 3h3v3h-3v-3Zm-3 3h3v3h-3v-3Zm6 9h3v3h-3v-3Zm9 12h3v3h-3v-3Zm15-15h3v6h-3v-6ZM19 39h8v3h-8v-3Zm5 3h9v3h-9v-3Zm3 3h12v3H27v-3Zm-9-15h1v12h-1V30Zm-3 3h3v3h-3v-3Zm0-9h3v3h-3v-3Zm0 3h3v3h-3v-3Zm3 0h3v3h-3v-3Z" fill="#DF8900"/><path d="M42 45h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-33-9h3v3h-3v-3Zm6-6h3v6h-3v-6Zm0-12h3v3h-3v-3Zm0 6h3v3h-3v-3Zm-3 3h3v6h-3v-6Zm33 6h3v3h-3v-3Zm-6-6h3v3h-3v-3Zm-21-3h3v6h-3v-6Z" fill="#FCD100"/><path d="M9 36h3v3H9v-3Zm-3-3h3v6H6v-6Zm6-3h3v12h-3V30Z" fill="#DEA159"/><path d="M6 30h3v3H6v-3Zm3 3h3v3H9v-3Zm13 0h12v3H22v-3Zm6-3h6v3h-6v-3ZM6 21h6v6H6v-6Zm6 3h3v6h-3v-6Z" fill="#FFE2AF"/><path d="M21 9h3v3h-3V9Zm18 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M42 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M42 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M27 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M27 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M21 21h3v3h-3v-3Zm9-12h3v3h-3V9Zm3 6h3v3h-3v-3Zm9-3h3v3h-3v-3Zm0 15h3v3h-3v-3Zm-5 9h2v3h-2v-3Z" fill="#FFFF0C"/><path d="M42 9h3v3h-3V9Zm9 21h3v6h-3v-6Zm-3-12h3v6h-3v-6Zm-3-6h3v6h-3v-6Zm-27 0h3v6h-3v-6Zm-3 6h3v6h-3v-6Zm24 27h3v3h-3v-3Zm3 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 36h3v3H3v-3Zm-3-6h3v6H0v-6Z" fill="#6B3407"/><path d="M15.097 17v1.548h2.29v1.549h1.549v1.548h1.548v1.549h1.548v1.548h7.29v-1.549h1.549v-1.548h1.548v-1.548h5.097v1.548h1.549v1.549h1.583v1.546H47v-1.546h1.903v-1.549h1.549v-1.548H52V17H15.097Z" fill="#000"/><path d="M20 18.548v1.549h1.548v-1.549H20Zm1.548 1.549v1.548h1.549v-1.548h-1.549Zm1.549 0h1.548v-1.549h-1.549l.001 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm13.936-1.549h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548h-1.548v-1.548h-1.549l-.001 1.548h-1.548l.001-1.548H38.58l.001-1.549Z" fill="#436173"/><path d="M20.484 18.548v1.549h1.548v-1.549h-1.548Zm1.548 1.549v1.548h1.549v-1.548h-1.55Zm1.549 0h1.548v-1.549h-1.55l.002 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm13.936-1.549h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548H43.71v-1.548h-1.55v1.548h-1.548v-1.548h-1.548v-1.549Z" fill="#667575"/></svg>
\ No newline at end of file

From 72ba455d5afbeaff089a6b5ab57d8009910be5e0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jul 2022 19:36:09 -0400
Subject: [PATCH 722/856] simplify .gitignore

---
 .gitignore | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/.gitignore b/.gitignore
index daf93b7e..a89ccd21 100644
--- a/.gitignore
+++ b/.gitignore
@@ -34,8 +34,6 @@ appsettings.Development.json
 # Azure generated files
 src/SMAPI.Web/Properties/PublishProfiles/*.pubxml
 src/SMAPI.Web/Properties/ServiceDependencies/* - Web Deploy/
-src/SMAPI.Web/.DS_Store
-src/SMAPI.Web/wwwroot/Content/images/.DS_Store
-src/SMAPI.Web/wwwroot/Content/.DS_Store
-src/SMAPI.Web/wwwroot/.DS_Store
+
+# macOS
 .DS_Store

From 477ecbab6ee4f011c68736c821cbe1476b384d29 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jul 2022 19:36:32 -0400
Subject: [PATCH 723/856] bypass browser cache & delete unused images

---
 src/SMAPI.Web/Views/Index/Index.cshtml           |   2 +-
 .../wwwroot/Content/images/pufferchick-cool.png  | Bin 1099 -> 0 bytes
 .../wwwroot/Content/images/pufferchick.png       | Bin 831 -> 0 bytes
 3 files changed, 1 insertion(+), 1 deletion(-)
 delete mode 100644 src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.png
 delete mode 100644 src/SMAPI.Web/wwwroot/Content/images/pufferchick.png

diff --git a/src/SMAPI.Web/Views/Index/Index.cshtml b/src/SMAPI.Web/Views/Index/Index.cshtml
index 308ed1e5..d6472fcb 100644
--- a/src/SMAPI.Web/Views/Index/Index.cshtml
+++ b/src/SMAPI.Web/Views/Index/Index.cshtml
@@ -10,7 +10,7 @@
 @section Head {
     <link rel="stylesheet" href="~/Content/css/index.css" />
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
-    <script src="~/Content/js/index.js"></script>
+    <script src="~/Content/js/index.js?r=20220708"></script>
 }
 
 <h1>
diff --git a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.png b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.png
deleted file mode 100644
index f359146c8470bdb49e3b55683e0c13eb8e555c3c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1099
zcmeAS@N?(olHy`uVBq!ia0vp^mOyO9!3HF`dOm6cDVB6cUq=Rpjs4tz5?O(K&H|6f
zVg?4j!ywFfJby(BP*AeOHKHUqKdq!Zu_%?HATcwqL@zJ3M8QPQK+nkVqeA9X1_tI6
zo-U3d8P0E~`eum)inK;w<nvk}Xw1QA+;xtHQ;8+8MWHJ}ZKevdBfH>6cH4|9!M-`x
z#jJXVM0YT<URR8{zj|Nj&sR_HeG(1L^jO0zfAH~N>)6<n9xheszY2VBP5Ab`H?!<0
z*Cm%*_sy5x6xH?+&aA&bBQ0Fw!S8Qnt$Vg5)>^IR_t~s%Q^m1zgWcS#?8|0ea^-Q5
zm?Y1VUE)$6xiDx~hx=s3C5x1Io#vW)DQy1yx1OC*tuMOQgkMm<6?WqD<`A~bMQiso
zzu;FC&DDPLGg7PBWTLX%$LGga9QtfqS8LU}_g?#=*Rw;}GL_t8&MdaQpUiR7-Q(Xc
zwWwPfde0VyO%P$*@Xx+=cS-H$Qw@UJ2`=8!N00t@J@MguScKyBo?SdShCP4&g?;?|
zx{x)Sqxs{@){Ujt<WC$t8M5s1fp+Ig6T_^acXrdaZ?r4=;$pUDmJ~04v-@{ZBfHLv
zFLwQl+4S*C?-_CKNESP}JJSo_I&^P*BX_Rr*U=<3_iEwA&%8ETU(>6%dUUb2O=oAQ
zY>E4~`)9wt`2MM={rI(NrB?f!lNaCo)Es$+FSR`8edq29=MOm_GuV<74oT@fXnbic
zc1@(`{oYC6f0;ag|LtktuQ$4y)qnC2TwT;>&T{{nmXq6|RR<#8$=6(2ZaMk!ap~6c
z_o`}B+~elFFi)sc(*GhIaP4E;gWFNLCk|97&5n-VB)YS9bD4qV-&yVX2U3b7<!{XC
zX)a&8>M`%aYhuoImNP;k7=!nGzo5Lv`t(=nt<Ig1@(+COP53e|YpSAch0MmR;0oqy
z(|bXn;CmEO(fCuYO0lz?<?ptL_mxLx$8*Q9_3$X_7kRLKK6F7{MrwM2SR(&(p=$+s
z(pd*r%t?MBtS8~LsJ)mo+hRL!q+;<s=U-2E2ONrgbFy*wT82B1e>$HK(o2$%bDqzw
zH0S6%nH{qg*BH!u-=_1w#-&2#@DqXQ9|F#uYTUfWUQ{m6AdBN>6SwfB4-9hWlXtAC
z(VvxIdvc{>++OJ$ToRH_anmNWG;+2J={<9lTk}0(?^feQ6VILEnwrGg6Va`7uaL0d
zBxSwNe2eBYS4+;=w=RF0sFtdG%o|xRd-iX9ivLx$L%gCta=eZ`=XzZ9k<ZposjXg_
z+Hxtf^Sk@BkIc+^3Qo;7C#>wmWy3p+ub!GNs`b?7h`}A#c<<fa+&1T&c@D>Z*}7%-
zjsuSo!eN|;pZth5I2-z)_2VDC8PBvn9IB`j_xW6;xOo4(L!VZjy765MnDH4rUHx3v
IIVCg!0C~0hegFUf

diff --git a/src/SMAPI.Web/wwwroot/Content/images/pufferchick.png b/src/SMAPI.Web/wwwroot/Content/images/pufferchick.png
deleted file mode 100644
index 1de9cf472447de7ae754afb34a0aa50085fa0695..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 831
zcmV-F1Hk-=P)<h;3K|Lk000e1NJLTq0021v0024&1^@s63XJh900001b5ch_0Itp)
z=>Px#1ZP1_K>z@;j|==^1poj7=}AOERA@u(l`(D>K@3L!js}SvMBIRehK>tB&lxxg
zReCylBo4s|xBy6;0f`1_VK$!4i}&-yquKu#iRP1D<9KYpNSmCNWjUPpFP|(u`1eO6
zi=!x!7XJOw$l@qUq=kQfG_p7f1-@QgZ7gpz?Dw;dKo&>g(Nof3zn^skvgjEJ1qdbi
zi(rq97>|<jjD$y%DQVb<@hB-zZ?0dzS}Imr!}_v3-C&*Avo%pYl`7JrH_<_?Pf5d`
zt%>TXRFM{$@Q6R(P8(4@;>U+u_%`~b*!p&=NQ+Fkm`6wTh$(r5B>#L9Yi)*$d8iWc
zP(c0M!(Fz%ohn#Rf(2`BhKr}9;Ovr=S$=-m`2OkL273sXWyD@QzeWAL1>bTPZ!o2O
zc=VJMZ~+&qBMUrK{k#R=au;tfrG0ob#VAbJ!v#Dj`o@0!{=C6@hUhJCFr|H_q<}qK
zz{UTy<j1$qHk6=;-v$@=!b6Gb_3#G1HNBfm$$Q`ebwCy#M^vweH}I|L-Q?egvk?jN
zJB%brbOh_YMBjNd|Bi4KEKJFVEJ?9QhIPWBWeH~yzTsTL9?tFIju?|UhIPUPQxb1D
zm#~L(dq_!UzC+gQw@~3MzRAGdN`QN!`jo725oLG`>s(OaEWXLW-IP!=Q9YEb|2_&l
zk}?^}5+2G~88}P*tB452m?_!8gOMaWfXDL~F00=~3-*&t4~hCiVI^3Yl8;4_P?&Hi
z;bI;X!Tt#LtDOZ?+DA!wlwd(EDn!Rcus?$RYG=We_EAzEC0J043ej;9?2ll-+F3BA
zeUy|Z6E2GmVm$-jQkZpH-;R><WWvSKp{!@%+bMZpl$578JVJfTS!~=I&a_fKO3Kq4
z9;A-XV&m3urj_zhQl8%MAa#5e8@Gltt(1?F@|+`-;V#y#bv#@UagI=iyI8l@@o+)J
zIYJrkV%=KD!v&XwGMV}avUmw1nW#R3EM9_0CaRAhi;s)t^cS*G#epNc6w?3z002ov
JPDHLkV1kq~gL?n~


From 9435711216ee8a8c224d70a18391f9f57f725b35 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 8 Jul 2022 19:40:54 -0400
Subject: [PATCH 724/856] update release notes

---
 docs/release-notes.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6c3edb77..df3949be 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,10 +9,15 @@
 
 ## Upcoming release
 * For players:
-  * Fixed Linux/macOS installer's color theme question partly unreadable if the terminal background is dark.
+  * Fixed SMAPI applying different DPI awareness settings than the game (thanks to spacechase0!).
+  * Fixed Linux/macOS installer's color scheme question partly unreadable if the terminal background is dark.
+
+* For mod authors:
+  * While loading your mod, SMAPI now searches for indirect dependencies in your mod's folder to support edge cases like F# mods (thanks to TehPers)!
 
 * For the web UI:
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
+  * Converted pufferchick icons to SVG (thanks to ishan!).
 
 ## 3.15.1
 Released 06 July 2022 for Stardew Valley 1.5.6 or later.

From 521129ad213da58fda5851f181a81bf661dde9b5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Jul 2022 00:53:11 -0400
Subject: [PATCH 725/856] raise deprecation levels

---
 docs/release-notes.md                           | 2 ++
 src/SMAPI/Constants.cs                          | 2 +-
 src/SMAPI/Framework/Content/AssetInfo.cs        | 4 ++--
 src/SMAPI/Framework/ModHelpers/CommandHelper.cs | 2 +-
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs | 8 ++++----
 src/SMAPI/Framework/ModHelpers/ModHelper.cs     | 2 +-
 src/SMAPI/Framework/SCore.cs                    | 6 +++---
 src/SMAPI/Utilities/PerScreen.cs                | 2 +-
 8 files changed, 15 insertions(+), 13 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index df3949be..13c0dce8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -14,6 +14,8 @@
 
 * For mod authors:
   * While loading your mod, SMAPI now searches for indirect dependencies in your mod's folder to support edge cases like F# mods (thanks to TehPers)!
+  * **Raised deprecation message levels.**  
+    _Deprecation warnings are now player-visible in the SMAPI console as grayed-out `DEBUG` messages. They'll be raised to `WARN` level in SMAPI 3.17 next month, which will be the last major release before SMAPI 4.0._
 
 * For the web UI:
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index c59af612..7aaa33bb 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -90,7 +90,7 @@ namespace StardewModdingAPI
                     source: null,
                     nounPhrase: $"{nameof(Constants)}.{nameof(Constants.ExecutionPath)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Notice
+                    severity: DeprecationLevel.Info
                 );
 
                 return Constants.GamePath;
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index 43feed27..af000300 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -45,7 +45,7 @@ namespace StardewModdingAPI.Framework.Content
                     source: null,
                     nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetName)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Notice,
+                    severity: DeprecationLevel.Info,
                     unlessStackIncludes: new[]
                     {
                         $"{typeof(AssetInterceptorChange).FullName}.{nameof(AssetInterceptorChange.CanIntercept)}",
@@ -84,7 +84,7 @@ namespace StardewModdingAPI.Framework.Content
                 source: null,
                 nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetNameEquals)}",
                 version: "3.14.0",
-                severity: DeprecationLevel.Notice,
+                severity: DeprecationLevel.Info,
                 unlessStackIncludes: new[]
                 {
                     $"{typeof(AssetInterceptorChange).FullName}.{nameof(AssetInterceptorChange.CanIntercept)}",
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index 21435f62..b7d4861f 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -43,7 +43,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 source: this.Mod,
                 nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.ConsoleCommands)}.{nameof(ICommandHelper.Trigger)}",
                 version: "3.8.1",
-                severity: DeprecationLevel.Notice
+                severity: DeprecationLevel.Info
             );
 
             return this.CommandManager.Trigger(name, arguments);
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 9992cb52..0a1633bf 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -62,7 +62,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                     source: this.Mod,
                     nounPhrase: $"{nameof(IContentHelper)}.{nameof(IContentHelper.AssetLoaders)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Notice
+                    severity: DeprecationLevel.Info
                 );
 
                 return this.ObservableAssetLoaders;
@@ -78,7 +78,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                     source: this.Mod,
                     nounPhrase: $"{nameof(IContentHelper)}.{nameof(IContentHelper.AssetEditors)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Notice
+                    severity: DeprecationLevel.Info
                 );
 
                 return this.ObservableAssetEditors;
@@ -126,7 +126,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                                 this.Mod,
                                 "loading assets from the Content folder with a .xnb file extension",
                                 "3.14.0",
-                                DeprecationLevel.Notice
+                                DeprecationLevel.Info
                             );
                         }
 
@@ -150,7 +150,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                                         this.Mod,
                                         "loading XNB files from the mod folder without the .xnb file extension",
                                         "3.14.0",
-                                        DeprecationLevel.Notice
+                                        DeprecationLevel.Info
                                     );
                                     return data;
                                 }
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index caa66bad..1cdd8536 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -41,7 +41,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                     source: this.Mod,
                     nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.Content)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Notice
+                    severity: DeprecationLevel.Info
                 );
 
                 return this.ContentImpl;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 46d65f6a..1a1bb9f8 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1670,7 +1670,7 @@ namespace StardewModdingAPI.Framework
                             source: metadata,
                             nounPhrase: $"{nameof(IAssetEditor)}",
                             version: "3.14.0",
-                            severity: DeprecationLevel.Notice,
+                            severity: DeprecationLevel.Info,
                             logStackTrace: false
                         );
 
@@ -1683,7 +1683,7 @@ namespace StardewModdingAPI.Framework
                             source: metadata,
                             nounPhrase: $"{nameof(IAssetLoader)}",
                             version: "3.14.0",
-                            severity: DeprecationLevel.Notice,
+                            severity: DeprecationLevel.Info,
                             logStackTrace: false
                         );
 
@@ -1715,7 +1715,7 @@ namespace StardewModdingAPI.Framework
                             metadata,
                             $"using {name} without bundling it",
                             "3.14.7",
-                            DeprecationLevel.Notice,
+                            DeprecationLevel.Info,
                             logStackTrace: false
                         );
                     }
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 54657ade..468df0bd 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -59,7 +59,7 @@ namespace StardewModdingAPI.Utilities
                     null,
                     $"calling the {nameof(PerScreen<T>)} constructor with null",
                     "3.14.0",
-                    DeprecationLevel.Notice
+                    DeprecationLevel.Info
                 );
 #else
                 throw new ArgumentNullException(nameof(createNewState));

From 6d9dcdc2f850b840c5f2e9ff30698e9eee92670b Mon Sep 17 00:00:00 2001
From: Ishan Jalan <ishan1337@gmail.com>
Date: Sat, 9 Jul 2022 08:57:02 +0530
Subject: [PATCH 726/856] Update pufferchick-cool.svg

---
 src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
index 28b03976..2734c289 100644
--- a/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
+++ b/src/SMAPI.Web/wwwroot/Content/images/pufferchick-cool.svg
@@ -1 +1 @@
-<svg width="57" height="57" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 18h3v9H0v-9Zm30 33h3v6h-3v-6ZM19 30h3v6h-3v-6Zm17 21h3v6h-3v-6ZM3 15h6v3H3v-3Zm6 3h6v3H9v-3Zm0 24h6v3H9v-3ZM24 6h6v3h-6V6Z" fill="#6B3407"/><path d="M15 42h6v3h-6v-3Zm30 0h6v3h-6v-3ZM33 24h6v3h-6v-3Z" fill="#8F4039"/><path d="M27 3h6v3h-6V3Z" fill="#FF4D1E"/><path d="M33 9h6v3h-6V9Z" fill="#8F4039"/><path d="M24 48h15v3H24v-3Zm-2-12h12v3H22v-3ZM21 0h12v3H21V0Zm0 3h3v3h-3V3Zm12 0h3v3h-3V3Zm3 3h3v3h-3V6ZM3 27h3v3H3v-3Z" fill="#6B3407"/><path d="M3 24h3v3H3v-3Zm3 3h3v3H6v-3Zm-3 6h3v3H3v-3Zm6 6h3v3H9v-3Zm10-3h3v3h-3v-3Zm15-3h3v3h-3v-3Z" fill="#9A4E0F"/><path d="M6 39h3v3H6v-3Zm16-9h3v3h-3v-3Z" fill="#6B3407"/><path d="M18 45h3v3h-3v-3Zm6 0h3v3h-3v-3Zm21 0h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-3-3h3v3h-3v-3Zm6-9h3v3h-3v-3Zm-3-3h3v3h-3v-3ZM27 9h3v3h-3V9Z" fill="#8F4039"/><path d="M24 3h3v3h-3V3Zm9 3h3v3h-3V6Z" fill="#C31E1E"/><path d="M30 6h3v3h-3V6Z" fill="#FF4D1E"/><path d="M24 12h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 18h3v3H3v-3Z" fill="#FFE2AF"/><path d="M6 18h3v3H6v-3Zm-3 3h3v3H3v-3Zm9 0h3v3h-3v-3Zm13 9h3v3h-3v-3Zm9 0h3v3h-3v-3Zm0 6h3v3h-3v-3ZM9 27h3v6H9v-6Zm-6 3h3v3H3v-3Zm12 6h3v3h-3v-3Z" fill="#DEA159"/><path d="M15 39h3v3h-3v-3Zm6 3h3v3h-3v-3Zm24-9h3v3h-3v-3Zm0-6h3v3h-3v-3Zm-18 0h15v3H27v-3Zm0 12h6v3h-6v-3Zm6 3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm3-3h9v3h-9v-3Zm0-12h9v3h-9v-3Zm-3-9h9v3h-9v-3Zm-12 0h9v3h-9v-3Zm0 9h9v3h-9v-3Zm6-6h12v6H30v-6Zm7 15h5v3h-5v-3Zm0-3h14v3H37v-3ZM27 12h9v3h-9v-3Z" fill="#FCD100"/><path d="M21 45h3v3h-3v-3Z" fill="#DF8900"/><path d="M21 45h3v3h-3v-3Zm21-3h3v3h-3v-3Zm3-3h3v3h-3v-3Zm3-6h3v3h-3v-3Zm-6 0h3v3h-3v-3Zm3-15h3v3h-3v-3Zm-9-6h3v3h-3v-3Zm-15 3h3v3h-3v-3Zm-3 3h3v3h-3v-3Zm6 9h3v3h-3v-3Zm9 12h3v3h-3v-3Zm15-15h3v6h-3v-6ZM19 39h8v3h-8v-3Zm5 3h9v3h-9v-3Zm3 3h12v3H27v-3Zm-9-15h1v12h-1V30Zm-3 3h3v3h-3v-3Zm0-9h3v3h-3v-3Zm0 3h3v3h-3v-3Zm3 0h3v3h-3v-3Z" fill="#DF8900"/><path d="M42 45h3v3h-3v-3Zm6-6h3v3h-3v-3Zm-33-9h3v3h-3v-3Zm6-6h3v6h-3v-6Zm0-12h3v3h-3v-3Zm0 6h3v3h-3v-3Zm-3 3h3v6h-3v-6Zm33 6h3v3h-3v-3Zm-6-6h3v3h-3v-3Zm-21-3h3v6h-3v-6Z" fill="#FCD100"/><path d="M9 36h3v3H9v-3Zm-3-3h3v6H6v-6Zm6-3h3v12h-3V30Z" fill="#DEA159"/><path d="M6 30h3v3H6v-3Zm3 3h3v3H9v-3Zm13 0h12v3H22v-3Zm6-3h6v3h-6v-3ZM6 21h6v6H6v-6Zm6 3h3v6h-3v-6Z" fill="#FFE2AF"/><path d="M21 9h3v3h-3V9Zm18 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M42 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M42 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M27 18h3v3h-3v-3Z" fill="#2F2000"/><path d="M27 21h3v3h-3v-3Z" fill="#F4F7AC"/><path d="M21 21h3v3h-3v-3Zm9-12h3v3h-3V9Zm3 6h3v3h-3v-3Zm9-3h3v3h-3v-3Zm0 15h3v3h-3v-3Zm-5 9h2v3h-2v-3Z" fill="#FFFF0C"/><path d="M42 9h3v3h-3V9Zm9 21h3v6h-3v-6Zm-3-12h3v6h-3v-6Zm-3-6h3v6h-3v-6Zm-27 0h3v6h-3v-6Zm-3 6h3v6h-3v-6Zm24 27h3v3h-3v-3Zm3 3h3v3h-3v-3Z" fill="#8F4039"/><path d="M3 36h3v3H3v-3Zm-3-6h3v6H0v-6Z" fill="#6B3407"/><path d="M15.097 17v1.548h2.29v1.549h1.549v1.548h1.548v1.549h1.548v1.548h7.29v-1.549h1.549v-1.548h1.548v-1.548h5.097v1.548h1.549v1.549h1.583v1.546H47v-1.546h1.903v-1.549h1.549v-1.548H52V17H15.097Z" fill="#000"/><path d="M20 18.548v1.549h1.548v-1.549H20Zm1.548 1.549v1.548h1.549v-1.548h-1.549Zm1.549 0h1.548v-1.549h-1.549l.001 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm13.936-1.549h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548h-1.548v-1.548h-1.549l-.001 1.548h-1.548l.001-1.548H38.58l.001-1.549Z" fill="#436173"/><path d="M20.484 18.548v1.549h1.548v-1.549h-1.548Zm1.548 1.549v1.548h1.549v-1.548h-1.55Zm1.549 0h1.548v-1.549h-1.55l.002 1.549Zm1.548 0v1.548h1.548v-1.548h-1.548Zm13.936-1.549h1.548v1.549h1.548v-1.549h1.549v1.549h1.548v1.548H43.71v-1.548h-1.55v1.548h-1.548v-1.548h-1.548v-1.549Z" fill="#667575"/></svg>
\ No newline at end of file
+<svg width="56" height="56" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 17.684h2.947v8.842H0v-8.842Zm29.474 32.421h2.947V56h-2.947v-5.895ZM18.667 29.474h2.947v5.894h-2.947v-5.894Zm16.701 20.631h2.948V56h-2.948v-5.895ZM2.948 14.737h5.894v2.947H2.947v-2.947Zm5.894 2.947h5.895v2.948H8.842v-2.948Zm0 23.58h5.895v2.947H8.842v-2.948ZM23.58 5.893h5.895v2.948H23.58V5.895Z" fill="#6B3407"/><path d="M14.737 41.263h5.895v2.948h-5.895v-2.948Zm29.474 0h5.894v2.948h-5.894v-2.948ZM32.42 23.58h5.895v2.947H32.42V23.58Z" fill="#8F4039"/><path d="M26.526 2.947h5.895v2.948h-5.895V2.947Z" fill="#FF4D1E"/><path d="M32.421 8.842h5.895v2.947H32.42V8.843Z" fill="#8F4039"/><path d="M23.579 47.158h14.737v2.947H23.579v-2.947Zm-1.965-11.79h11.79v2.948h-11.79v-2.948ZM20.632 0h11.79v2.947h-11.79V0Zm0 2.947h2.947v2.948h-2.947V2.947Zm11.79 0h2.946v2.948h-2.947V2.947Zm2.946 2.948h2.948v2.947h-2.948V5.895ZM2.948 26.526h2.947v2.948H2.947v-2.948Z" fill="#6B3407"/><path d="M2.947 23.579h2.948v2.947H2.947V23.58Zm2.948 2.947h2.947v2.948H5.895v-2.948Zm-2.948 5.895h2.948v2.947H2.947v-2.947Zm5.895 5.895h2.947v2.947H8.843v-2.947Zm9.825-2.948h2.947v2.948h-2.947v-2.948Zm14.736-2.947h2.948v2.947h-2.947v-2.947Z" fill="#9A4E0F"/><path d="M5.895 38.316h2.947v2.947H5.895v-2.947Zm15.719-8.842h2.947v2.947h-2.947v-2.947Z" fill="#6B3407"/><path d="M17.684 44.21h2.948v2.948h-2.948V44.21Zm5.895 0h2.947v2.948H23.58V44.21Zm20.632 0h2.947v2.948H44.21V44.21Zm5.894-5.894h2.948v2.947h-2.948v-2.947Zm-2.947-2.948h2.947v2.948h-2.947v-2.948Zm5.895-8.842H56v2.948h-2.947v-2.948Zm-2.948-2.947h2.948v2.947h-2.948V23.58ZM26.526 8.842h2.948v2.947h-2.948V8.843Z" fill="#8F4039"/><path d="M23.579 2.947h2.947v2.948H23.58V2.947Zm8.842 2.948h2.947v2.947h-2.947V5.895Z" fill="#C31E1E"/><path d="M29.474 5.895h2.947v2.947h-2.947V5.895Z" fill="#FF4D1E"/><path d="M23.579 11.79h2.947v2.947H23.58V11.79Z" fill="#8F4039"/><path d="M2.947 17.684h2.948v2.948H2.947v-2.948Z" fill="#FFE2AF"/><path d="M5.895 17.684h2.947v2.948H5.895v-2.948Zm-2.948 2.948h2.948v2.947H2.947v-2.947Zm8.843 0h2.947v2.947H11.79v-2.947Zm12.771 8.842h2.948v2.947H24.56v-2.947Zm8.843 0h2.947v2.947h-2.947v-2.947Zm0 5.894h2.947v2.948h-2.947v-2.948ZM8.841 26.526h2.947v5.895H8.843v-5.895Zm-5.895 2.948h2.948v2.947H2.947v-2.947Zm11.79 5.894h2.947v2.948h-2.947v-2.948Z" fill="#DEA159"/><path d="M14.737 38.316h2.947v2.947h-2.947v-2.947Zm5.895 2.947h2.947v2.948h-2.947v-2.948Zm23.579-8.842h2.947v2.947H44.21v-2.947Zm0-5.895h2.947v2.948H44.21v-2.948Zm-17.685 0h14.737v2.948H26.526v-2.948Zm0 11.79h5.895v2.947h-5.895v-2.947Zm5.895 2.947h8.842v2.948h-8.842v-2.948Zm2.947-2.947h8.843v2.947h-8.843v-2.947Zm2.948-2.948h8.842v2.948h-8.842v-2.948Zm0-11.79h8.842v2.948h-8.842V23.58Zm-2.948-8.841h8.843v2.947h-8.843v-2.947Zm-11.79 0h8.843v2.947H23.58v-2.947Zm0 8.842h8.843v2.947H23.58V23.58Zm5.896-5.895h11.79v5.895h-11.79v-5.895Zm6.877 14.737h4.912v2.947h-4.912v-2.947Zm0-2.947h13.754v2.947H36.351v-2.947ZM26.526 11.79h8.842v2.947h-8.842V11.79Z" fill="#FCD100"/><path d="M20.632 44.21h2.947v2.948h-2.947V44.21Z" fill="#DF8900"/><path d="M20.632 44.21h2.947v2.948h-2.947V44.21Zm20.631-2.947h2.948v2.948h-2.948v-2.948Zm2.948-2.947h2.947v2.947H44.21v-2.947Zm2.947-5.895h2.947v2.947h-2.947v-2.947Zm-5.895 0h2.948v2.947h-2.948v-2.947Zm2.948-14.737h2.947v2.948H44.21v-2.948Zm-8.843-5.895h2.948v2.948h-2.948V11.79Zm-14.736 2.948h2.947v2.947h-2.947v-2.947Zm-2.948 2.947h2.948v2.948h-2.948v-2.948Zm5.895 8.842h2.947v2.948H23.58v-2.948Zm8.842 11.79h2.947v2.947h-2.947v-2.947Zm14.737-14.737h2.947v5.895h-2.947v-5.895ZM18.667 38.316h7.86v2.947h-7.86v-2.947Zm4.912 2.947h8.842v2.948H23.58v-2.948Zm2.947 2.948h11.79v2.947h-11.79V44.21Zm-8.842-14.737h.983v11.79h-.983v-11.79Zm-2.947 2.947h2.947v2.947h-2.947v-2.947Zm0-8.842h2.947v2.947h-2.947V23.58Zm0 2.947h2.947v2.948h-2.947v-2.948Zm2.947 0h2.948v2.948h-2.948v-2.948Z" fill="#DF8900"/><path d="M41.263 44.21h2.948v2.948h-2.948V44.21Zm5.895-5.894h2.947v2.947h-2.947v-2.947Zm-32.421-8.842h2.947v2.947h-2.947v-2.947Zm5.895-5.895h2.947v5.895h-2.947v-5.895Zm0-11.79h2.947v2.948h-2.947V11.79Zm0 5.895h2.947v2.948h-2.947v-2.948Zm-2.948 2.948h2.948v5.894h-2.948v-5.894Zm32.421 5.894h2.948v2.948h-2.948v-2.948Zm-5.894-5.894h2.947v2.947H44.21v-2.947Zm-20.632-2.948h2.947v5.895H23.58v-5.895Z" fill="#FCD100"/><path d="M8.842 35.368h2.947v2.948H8.843v-2.948Zm-2.947-2.947h2.947v5.895H5.895V32.42Zm5.895-2.947h2.947v11.79H11.79v-11.79Z" fill="#DEA159"/><path d="M5.895 29.474h2.947v2.947H5.895v-2.947Zm2.947 2.947h2.947v2.947H8.843v-2.947Zm12.772 0h11.79v2.947h-11.79v-2.947Zm5.895-2.947h5.895v2.947h-5.895v-2.947ZM5.895 20.632h5.895v5.894H5.895v-5.894Zm5.895 2.947h2.947v5.895H11.79v-5.895Z" fill="#FFE2AF"/><path d="M20.632 8.842h2.947v2.947h-2.947V8.843Zm17.684 2.947h2.947v2.948h-2.947V11.79Z" fill="#8F4039"/><path d="M41.263 17.684h2.948v2.948h-2.948v-2.948Z" fill="#2F2000"/><path d="M41.263 20.632h2.948v2.947h-2.948v-2.947Z" fill="#F4F7AC"/><path d="M26.526 17.684h2.948v2.948h-2.948v-2.948Z" fill="#2F2000"/><path d="M26.526 20.632h2.948v2.947h-2.948v-2.947Z" fill="#F4F7AC"/><path d="M20.632 20.632h2.947v2.947h-2.947v-2.947Zm8.842-11.79h2.947v2.947h-2.947V8.843Zm2.947 5.895h2.947v2.947h-2.947v-2.947Zm8.842-2.947h2.948v2.947h-2.948V11.79Zm0 14.736h2.948v2.948h-2.948v-2.948Zm-4.912 8.842h1.965v2.948H36.35v-2.948Z" fill="#FFFF0C"/><path d="M41.263 8.842h2.948v2.947h-2.948V8.843Zm8.842 20.632h2.948v5.894h-2.948v-5.894Zm-2.947-11.79h2.947v5.895h-2.947v-5.895ZM44.21 11.79h2.947v5.895H44.21V11.79Zm-26.527 0h2.948v5.895h-2.948V11.79Zm-2.947 5.895h2.947v5.895h-2.947v-5.895Zm23.579 26.527h2.947v2.947h-2.947V44.21Zm2.947 2.947h2.948v2.947h-2.948v-2.947Z" fill="#8F4039"/><path d="M2.947 35.368h2.948v2.948H2.947v-2.948ZM0 29.474h2.947v5.894H0v-5.894Z" fill="#6B3407"/><path d="M14.832 16.702v1.52h2.25v1.522h1.522v1.521h1.52v1.522h1.521v1.52h7.163v-1.52h1.521v-1.522h1.521v-1.52h5.008v1.52h1.522v1.522h1.555v1.519h6.24v-1.519h1.87v-1.522h1.522v-1.52h1.52v-3.043H14.833Z" fill="#000"/><path d="M19.65 18.223v1.521h1.52v-1.521h-1.52Zm1.52 1.521v1.521h1.522v-1.52H21.17Zm1.522 0h1.52v-1.521h-1.521v1.521Zm1.52 0v1.521h1.521v-1.52h-1.52Zm13.692-1.521h1.521v1.521h1.52v-1.521h1.523v1.521h1.52v1.521h-1.52v-1.52h-1.522l-.001 1.52h-1.521l.001-1.52h-1.522l.001-1.522Z" fill="#436173"/><path d="M20.125 18.223v1.521h1.52v-1.521h-1.52Zm1.52 1.521v1.521h1.522v-1.52h-1.522Zm1.522 0h1.521v-1.521h-1.522l.001 1.521Zm1.521 0v1.521h1.52v-1.52h-1.52Zm13.692-1.521h1.52v1.521h1.521v-1.521h1.522v1.521h1.52v1.521h-1.52v-1.52h-1.522v1.52h-1.522l.001-1.52h-1.52v-1.522Z" fill="#667575"/></svg>
\ No newline at end of file

From 830d2c57cc4f02d0dbc9504bde641a0c3c412234 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 9 Jul 2022 01:06:32 -0400
Subject: [PATCH 727/856] update log parser for new update alert format

---
 docs/release-notes.md                           | 1 +
 src/SMAPI.Web/Framework/LogParsing/LogParser.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 13c0dce8..6ae59ad8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -20,6 +20,7 @@
 * For the web UI:
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
   * Converted pufferchick icons to SVG (thanks to ishan!).
+  * Updated log parser for new update alert format in SMAPI 3.15.1.
 
 ## 3.15.1
 Released 06 July 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 0efa62c5..4a110dcd 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -42,7 +42,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         private readonly Regex ModUpdateListStartPattern = new(@"^You can update \d+ mods?:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching an entry in SMAPI's mod update list.</summary>
-        private readonly Regex ModUpdateListEntryPattern = new(@"^   (?<name>.+) (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ModUpdateListEntryPattern = new(@"^   (?<name>.+) (?<version>[^\s]+): (?<link>[^\s]+)(?: \(you have [^\)]+\))?$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching SMAPI's update line.</summary>
         private readonly Regex SmapiUpdatePattern = new(@"^You can update SMAPI to (?<version>[^\s]+): (?<link>.+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase);

From da1eca369642a128d7c3608b3c5b45d61f05350a Mon Sep 17 00:00:00 2001
From: Ishan Jalan <ishan1337@gmail.com>
Date: Sun, 17 Jul 2022 09:53:52 +0530
Subject: [PATCH 728/856] Moving Sidebar GIF to SVG

---
 .../wwwroot/Content/images/sidebar-bg.gif        | Bin 1104 -> 0 bytes
 .../wwwroot/Content/images/sidebar-bg.svg        |   1 +
 2 files changed, 1 insertion(+)
 delete mode 100644 src/SMAPI.Web/wwwroot/Content/images/sidebar-bg.gif
 create mode 100644 src/SMAPI.Web/wwwroot/Content/images/sidebar-bg.svg

diff --git a/src/SMAPI.Web/wwwroot/Content/images/sidebar-bg.gif b/src/SMAPI.Web/wwwroot/Content/images/sidebar-bg.gif
deleted file mode 100644
index 48e9af5a033ad34ecfe9b737d48a31d1172fe396..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1104
zcmb8o2{+pZ008iRB8em-!5pFPTO17y646y#qa`+Brmt&N>PlLz)k-5B3klLK4cXSY
zg4A<FUs-6iSao!vs60xsux?~wi93%lU8UPT!hT=i7kN5@NTP)S1ppTV$Ye6PT&_?k
zluD&arCM5AT3%jOtJNBfW_5LSeSKZ4)#`M*{r&xegM)YfpVK}Bgak|gAK+jAod8t7
z;37z6)Y0z=Uf|(dxN!mwASP`-u~GHb#s2aasC3xQ085#~c2pN3J{z_D`VgAx65Hl=
z-*i~aC`+EYIA%^vUrT3&r=i=mD_;;KN36V~FWhuS<WWGzxOfg1lTiSG-Own+;ZlKf
zzL12#pkUxqN;L-F7zS$1X~x{It!>A2bhWiV>LERl_WnqQpF4sSJ?$XFV2Bq1@baO8
zKy)w|KIU1`HxW1p0?)c3#wUaX*vFt7ZiaIzmN!2K1S^KFZv>#EU?hA)_#33#F*bRS
z@abMi-XW=YpvG=c@AS5r&f{=ZU|Wg0kr!T!v~Pa7XL=qir0KEv*#7LHqHn@r;zrp*
zKRcnRWB>)gp`4mdy6kfgwhO`#IrO^W+JXbf9J!(8NutjnJcn4G>y7<f4p_xJx1(zf
z=d^V-zX=h;T&g|xUJ03ArVW0<ZY4@ijW-q1>(HaYkx#^)wz0nw6S5LC$B9DO5Jgqu
zENe6R<D(LO$}|oOo*(grY$v9lFNk#YJLvYm^AaPm5AyNvPcwZOO(rI0Yk5;D>Gx}1
z4aYUd+7s^XWQQ6Ssz?!KR|E##zDf)b{}J-2&VA)48*#Rk7_uXF#@!AGVg>5nQ*L&o
zf%LPtqUNN*ZST;<kLEkHv-OF6%sn0(N71*GQ)kwTi*6QRnf9zL3tk+D)&$%QjfgoT
zD1ip>lCg8V;op%nAkX=0G=8E{u3jX8#r8~`tmkV;2Dh^?nZsvu2`A$1)8E>$Y21i5
z_>@q1JpudW?oN7A{^jq?fv6|c8<vz0E&rr>iSlJB?9HX!GU`xYi#S~B|6Ey!x9(b|
zDL@O>bU$ozs-Kh**<$dm+_fmF7C7ZjA&gm%R2n*668Ht(Tc#Pm|At1tQ;3+ErBv!4
zoNUVBSJ_<;O=TEm9(DJa5kjfY8uM=jC@v*k)o$Sc$*x3IN?1E<l;jT2h_-T2EKjkX
zk4Z0dd{X6T-x=*YDFR9+s=L^pbpuEXrUq*fVSr2cd$vMtzTj*2Ra^x+_f#cLTnoWF
zs?jrxscC`6@)}2Po5hx^VN{6O2w+>dB0+KER;Sx~UX?ciYwesrP{B^(!wA<t5BZ?c
z<;>B}W7W^_KL{EXB5(gXp8#ev_E+nN42H7BflUbG_qlE^dZQ&lQUHAXX;)<LXe)l3
z&9IfrdJ;b%mrjz#9%s35;qx%#ys?X2wUm0td7o~JsU}qN5@a_88tMj}&e%>)pSK(Y
S?U`hczy3Lf2sHr%<bMEr77-x;

diff --git a/src/SMAPI.Web/wwwroot/Content/images/sidebar-bg.svg b/src/SMAPI.Web/wwwroot/Content/images/sidebar-bg.svg
new file mode 100644
index 00000000..f0613272
--- /dev/null
+++ b/src/SMAPI.Web/wwwroot/Content/images/sidebar-bg.svg
@@ -0,0 +1 @@
+<svg width="63" height="126" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#a)"><path d="M63.002 30.06c-18.36 0-33.297 14.778-33.297 32.94 0 18.163 14.938 32.94 33.297 32.94 18.359 0 33.295-14.776 33.295-32.94 0-18.162-14.936-32.94-33.295-32.94ZM115.603 63c0-1.674-.088-3.327-.244-4.96L126 53.78a61.838 61.838 0 0 0-2.182-9.52l-11.451.73a51.898 51.898 0 0 0-4.358-8.944l7.708-8.395a63.075 63.075 0 0 0-6.159-7.63L99.556 25.6a52.684 52.684 0 0 0-7.83-6.186l3.27-10.892a63.833 63.833 0 0 0-8.886-4.243l-6.57 9.323a52.763 52.763 0 0 0-9.774-2.198L67.934.187a65.106 65.106 0 0 0-9.87 0l-1.83 11.216A52.795 52.795 0 0 0 46.46 13.6l-6.568-9.323a63.782 63.782 0 0 0-8.886 4.243l3.271 10.892a52.659 52.659 0 0 0-7.832 6.186l-10.001-5.576a63.235 63.235 0 0 0-6.16 7.629l7.71 8.395a51.7 51.7 0 0 0-4.359 8.945l-11.452-.73A62.05 62.05 0 0 0 0 53.78l10.642 4.258a51.832 51.832 0 0 0-.245 4.96c0 1.673.088 3.326.245 4.96L0 72.217a62.178 62.178 0 0 0 2.182 9.52l11.452-.731a51.65 51.65 0 0 0 4.36 8.944l-7.711 8.396a63.311 63.311 0 0 0 6.16 7.629l10-5.576a52.731 52.731 0 0 0 7.833 6.186l-3.271 10.892a63.789 63.789 0 0 0 8.886 4.242l6.568-9.321a52.772 52.772 0 0 0 9.775 2.198l1.83 11.216c3.285.248 6.585.248 9.87 0l1.832-11.216a52.76 52.76 0 0 0 9.774-2.198l6.569 9.321a63.767 63.767 0 0 0 8.886-4.242l-3.269-10.892a52.904 52.904 0 0 0 7.83-6.186l10.002 5.576a63.1 63.1 0 0 0 6.159-7.63l-7.711-8.395a51.625 51.625 0 0 0 4.361-8.944l11.451.73a61.714 61.714 0 0 0 2.182-9.52l-10.641-4.258c.156-1.633.244-3.286.244-4.96V63Zm-52.601 38.253c-21.322 0-38.67-17.16-38.67-38.252 0-21.093 17.348-38.253 38.67-38.253 21.321 0 38.668 17.16 38.668 38.253s-17.347 38.252-38.668 38.252Z" fill="#C4C4C4"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h63v126H0z"/></clipPath></defs></svg>
\ No newline at end of file

From 88517715a3551240ce87892950ec513235874857 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Jul 2022 11:04:45 -0400
Subject: [PATCH 729/856] update image reference

---
 src/SMAPI.Web/wwwroot/Content/css/main.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/wwwroot/Content/css/main.css b/src/SMAPI.Web/wwwroot/Content/css/main.css
index a0a407d8..79de9c39 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/main.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/main.css
@@ -68,7 +68,7 @@ a {
     margin-top: 3em;
     min-height: 75%;
     width: 12em;
-    background: url("../images/sidebar-bg.gif") no-repeat top right;
+    background: url("../images/sidebar-bg.svg") no-repeat top right;
     color: #666;
 }
 

From 1b7dfb28f2968ccce0ee0669e88a7258f1662e81 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Jul 2022 11:07:53 -0400
Subject: [PATCH 730/856] update release notes

---
 docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6ae59ad8..40f79d8e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -19,7 +19,7 @@
 
 * For the web UI:
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
-  * Converted pufferchick icons to SVG (thanks to ishan!).
+  * Converted images to SVG (thanks to ishan!).
   * Updated log parser for new update alert format in SMAPI 3.15.1.
 
 ## 3.15.1

From 3da5917eed5fc9db3017e2bf0d0f9bf92c295e6a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 17 Jul 2022 11:29:50 -0400
Subject: [PATCH 731/856] update Pintail

---
 docs/release-notes.md  | 3 ++-
 src/SMAPI/SMAPI.csproj | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 40f79d8e..cae29411 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,6 +16,7 @@
   * While loading your mod, SMAPI now searches for indirect dependencies in your mod's folder to support edge cases like F# mods (thanks to TehPers)!
   * **Raised deprecation message levels.**  
     _Deprecation warnings are now player-visible in the SMAPI console as grayed-out `DEBUG` messages. They'll be raised to `WARN` level in SMAPI 3.17 next month, which will be the last major release before SMAPI 4.0._
+  * Updated to Pintail 2.2.1 (see [changes](https://github.com/Nanoray-pl/Pintail/blob/master/docs/release-notes.md#221)).
 
 * For the web UI:
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
@@ -56,7 +57,7 @@ Released 17 June 2022 for Stardew Valley 1.5.6 or later. See [release highlights
   * Updated dependencies:
     * Harmony 2.2.1 (see changes in [2.2.0](https://github.com/pardeike/Harmony/releases/tag/v2.2.0.0) and [2.2.1](https://github.com/pardeike/Harmony/releases/tag/v2.2.1.0));
     * Newtonsoft.Json 13.0.1 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.1));
-    * Pintail 2.2.0.
+    * Pintail 2.2.0 (see [changes](https://github.com/Nanoray-pl/Pintail/blob/master/docs/release-notes.md#220)).
   * Removed transitional `UsePintail` option added in 3.14.0 (now always enabled).
   * Fixed `onBehalfOf` arguments in the new content API being case-sensitive.
   * Fixed map edits which change warps sometimes rebuilding the NPC pathfinding cache unnecessarily, which could cause a noticeable delay for players.
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 1c745702..36db0545 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -27,7 +27,7 @@
     <PackageReference Include="MonoMod.Common" Version="22.3.5.1" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
-    <PackageReference Include="Pintail" Version="2.2.0" />
+    <PackageReference Include="Pintail" Version="2.2.1" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
 

From ea4307a282468c20c27c6b8c2722bd46f6d5c64d Mon Sep 17 00:00:00 2001
From: Ishan Jalan <44338423+ishanjalan@users.noreply.github.com>
Date: Wed, 20 Jul 2022 22:30:09 +0530
Subject: [PATCH 732/856] Update unix-launcher.sh

This will open the default shell. Works for me after testing.
---
 src/SMAPI.Installer/assets/unix-launcher.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index ae9624e7..cff21bb0 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -58,7 +58,7 @@ if [ "$(uname)" == "Darwin" ]; then
             echo "\"$0\" $@ --use-current-shell" >> /tmp/open-smapi-terminal.sh
             chmod +x /tmp/open-smapi-terminal.sh
             cat /tmp/open-smapi-terminal.sh
-            open -W -a Terminal /tmp/open-smapi-terminal.sh
+            open -W /tmp/open-smapi-terminal.sh
             rm /tmp/open-smapi-terminal.sh
             exit 0
         fi

From ea4664856dff10cb3371a859dcf09be2f4608299 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 21 Jul 2022 22:46:05 +0000
Subject: [PATCH 733/856] Bump Azure.Storage.Blobs from 12.12.0 to 12.13.0 in
 /src/SMAPI.Web

Bumps [Azure.Storage.Blobs](https://github.com/Azure/azure-sdk-for-net) from 12.12.0 to 12.13.0.
- [Release notes](https://github.com/Azure/azure-sdk-for-net/releases)
- [Commits](https://github.com/Azure/azure-sdk-for-net/compare/Azure.Storage.Blobs_12.12.0...Azure.Storage.Blobs_12.13.0)

---
updated-dependencies:
- dependency-name: Azure.Storage.Blobs
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 src/SMAPI.Web/SMAPI.Web.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index 0a460e9e..d26cb6f8 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -15,7 +15,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Azure.Storage.Blobs" Version="12.12.0" />
+    <PackageReference Include="Azure.Storage.Blobs" Version="12.13.0" />
     <PackageReference Include="Hangfire.AspNetCore" Version="1.7.29" />
     <PackageReference Include="Hangfire.MemoryStorage" Version="1.7.0" />
     <PackageReference Include="HtmlAgilityPack" Version="1.11.43" />

From fd3850add9ddeccc4dd3d27493b90a98cca786ed Mon Sep 17 00:00:00 2001
From: KediDili <78353874+KediDili@users.noreply.github.com>
Date: Fri, 22 Jul 2022 21:24:15 +0300
Subject: [PATCH 734/856] Fix for mistranslation in tr.json

Somebody accidentally translated tr.json to Russian. This PR fixes that.
---
 src/SMAPI/i18n/tr.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/i18n/tr.json b/src/SMAPI/i18n/tr.json
index e97a48ba..ba0c33c9 100644
--- a/src/SMAPI/i18n/tr.json
+++ b/src/SMAPI/i18n/tr.json
@@ -2,5 +2,5 @@
     // short date format for SDate
     // tokens: {{day}} (like 15), {{season}} (like Spring), {{seasonLowercase}} (like spring), {{year}} (like 2)
     "generic.date": "{{day}} {{season}}",
-    "generic.date-with-year": "{{day}} {{season}} года {{year}}"
+    "generic.date-with-year": "{{day}} {{season}} Yıl {{year}}"
 }

From a50a730886e2649472011e5c0eca5113b3774555 Mon Sep 17 00:00:00 2001
From: Ishan Jalan <44338423+ishanjalan@users.noreply.github.com>
Date: Sun, 24 Jul 2022 12:01:34 +0530
Subject: [PATCH 735/856] unix-launcher.sh optimisations

I ran the file through Rider which used Intellisense(?) to suggest changes in addition to moving from .sh to .command
---
 src/SMAPI.Installer/assets/unix-launcher.sh | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index cff21bb0..b9d468a0 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -54,12 +54,12 @@ if [ "$(uname)" == "Darwin" ]; then
         # https://stackoverflow.com/a/29511052/262123
         if [ "$USE_CURRENT_SHELL" == "false" ]; then
             echo "Reopening in the Terminal app..."
-            echo '#!/bin/sh' > /tmp/open-smapi-terminal.sh
-            echo "\"$0\" $@ --use-current-shell" >> /tmp/open-smapi-terminal.sh
-            chmod +x /tmp/open-smapi-terminal.sh
-            cat /tmp/open-smapi-terminal.sh
-            open -W /tmp/open-smapi-terminal.sh
-            rm /tmp/open-smapi-terminal.sh
+            echo '#!/bin/sh' > /tmp/open-smapi-terminal.command
+            echo "\"$0\" $@ --use-current-shell" >> /tmp/open-smapi-terminal.command
+            chmod +x /tmp/open-smapi-terminal.command
+            cat /tmp/open-smapi-terminal.command
+            open -W /tmp/open-smapi-terminal.command
+            rm /tmp/open-smapi-terminal.command
             exit 0
         fi
     fi

From dd2e3e9d933c69aba2a11815191046903c7fa5ee Mon Sep 17 00:00:00 2001
From: Ishan Jalan <44338423+ishanjalan@users.noreply.github.com>
Date: Sun, 24 Jul 2022 12:07:38 +0530
Subject: [PATCH 736/856] Jetbrains Rider suggestions

I ran the file on Rider and it had a few suggestions

<img width="506" alt="image" src="https://user-images.githubusercontent.com/44338423/180635394-cb45defa-47f4-444c-ad10-e0fc89522fe7.png">
---
 src/SMAPI.Installer/assets/unix-launcher.sh | 24 +++++++++++----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index b9d468a0..88a3a328 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -55,7 +55,7 @@ if [ "$(uname)" == "Darwin" ]; then
         if [ "$USE_CURRENT_SHELL" == "false" ]; then
             echo "Reopening in the Terminal app..."
             echo '#!/bin/sh' > /tmp/open-smapi-terminal.command
-            echo "\"$0\" $@ --use-current-shell" >> /tmp/open-smapi-terminal.command
+            echo "\"$0\" $* --use-current-shell" >> /tmp/open-smapi-terminal.command
             chmod +x /tmp/open-smapi-terminal.command
             cat /tmp/open-smapi-terminal.command
             open -W /tmp/open-smapi-terminal.command
@@ -71,8 +71,8 @@ fi
 ##########
 # script must be run from the game folder
 if [ ! -f "Stardew Valley.dll" ]; then
-    echo "Oops! SMAPI must be placed in the Stardew Valley game folder.\nSee instructions: https://stardewvalleywiki.com/Modding:Player_Guide";
-    read
+    printf "Oops! SMAPI must be placed in the Stardew Valley game folder.\nSee instructions: https://stardewvalleywiki.com/Modding:Player_Guide";
+    read -r
     exit 1
 fi
 
@@ -102,37 +102,39 @@ else
 
         # find the true shell behind x-terminal-emulator
         if [ "$TERMINAL_NAME" = "x-terminal-emulator" ]; then
-            export TERMINAL_NAME="$(basename "$(readlink -f $(command -v x-terminal-emulator))")"
+            TERMINAL_NAME="$(basename "$(readlink -f "$(command -v x-terminal-emulator)")")"
+            export TERMINAL_NAME
         fi
 
         # run in selected terminal and account for quirks
-        export TERMINAL_PATH="$(command -v $TERMINAL_NAME)"
-        if [ -x $TERMINAL_PATH ]; then
+        TERMINAL_PATH="$(command -v "$TERMINAL_NAME")"
+        export TERMINAL_PATH
+        if [ -x "$TERMINAL_PATH" ]; then
             case $TERMINAL_NAME in
                 terminal|termite)
                     # consumes only one argument after -e
                     # options containing space characters are unsupported
-                    exec $TERMINAL_NAME -e "env TERM=xterm $LAUNCH_FILE $@"
+                    exec "$TERMINAL_NAME" -e "env TERM=xterm $LAUNCH_FILE $*"
                     ;;
 
                 xterm|konsole|alacritty)
                     # consumes all arguments after -e
-                    exec $TERMINAL_NAME -e env TERM=xterm $LAUNCH_FILE "$@"
+                    exec "$TERMINAL_NAME" -e env TERM=xterm $LAUNCH_FILE "$*"
                     ;;
 
                 terminator|xfce4-terminal|mate-terminal)
                     # consumes all arguments after -x
-                    exec $TERMINAL_NAME -x env TERM=xterm $LAUNCH_FILE "$@"
+                    exec "$TERMINAL_NAME" -x env TERM=xterm $LAUNCH_FILE "$*"
                     ;;
 
                 gnome-terminal)
                     # consumes all arguments after --
-                    exec $TERMINAL_NAME -- env TERM=xterm $LAUNCH_FILE "$@"
+                    exec "$TERMINAL_NAME" -- env TERM=xterm $LAUNCH_FILE "$*"
                     ;;
 
                 kitty)
                     # consumes all trailing arguments
-                    exec $TERMINAL_NAME env TERM=xterm $LAUNCH_FILE "$@"
+                    exec "$TERMINAL_NAME" env TERM=xterm $LAUNCH_FILE "$*"
                     ;;
 
                 *)

From edf2c5dbea777460ef0eb9d5829089ee18cc17b0 Mon Sep 17 00:00:00 2001
From: lanturnalis <96697794+lanturnalis@users.noreply.github.com>
Date: Mon, 25 Jul 2022 21:31:09 -0500
Subject: [PATCH 737/856] Add condition to DebugType to allow for overriding

---
 src/SMAPI.ModBuildConfig/build/smapi.targets | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index b66ec27b..70182125 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -9,7 +9,7 @@
   **********************************************-->
   <PropertyGroup>
     <!-- include PDB file by default to enable line numbers in stack traces -->
-    <DebugType>pdbonly</DebugType>
+    <DebugType Condition="'$(DebugType)' == ''">pdbonly</DebugType>
     <DebugSymbols>true</DebugSymbols>
 
     <!-- don't create the 'refs' folder (which isn't useful for mods) -->

From ab34b6142dcd04e629012a1c30d37bc9c7e5df5e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 28 Jul 2022 21:47:21 -0400
Subject: [PATCH 738/856] undo $@ to $* change per discussion

---
 src/SMAPI.Installer/assets/unix-launcher.sh | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI.Installer/assets/unix-launcher.sh b/src/SMAPI.Installer/assets/unix-launcher.sh
index 88a3a328..778663d7 100644
--- a/src/SMAPI.Installer/assets/unix-launcher.sh
+++ b/src/SMAPI.Installer/assets/unix-launcher.sh
@@ -55,7 +55,7 @@ if [ "$(uname)" == "Darwin" ]; then
         if [ "$USE_CURRENT_SHELL" == "false" ]; then
             echo "Reopening in the Terminal app..."
             echo '#!/bin/sh' > /tmp/open-smapi-terminal.command
-            echo "\"$0\" $* --use-current-shell" >> /tmp/open-smapi-terminal.command
+            echo "\"$0\" $@ --use-current-shell" >> /tmp/open-smapi-terminal.command
             chmod +x /tmp/open-smapi-terminal.command
             cat /tmp/open-smapi-terminal.command
             open -W /tmp/open-smapi-terminal.command
@@ -114,27 +114,27 @@ else
                 terminal|termite)
                     # consumes only one argument after -e
                     # options containing space characters are unsupported
-                    exec "$TERMINAL_NAME" -e "env TERM=xterm $LAUNCH_FILE $*"
+                    exec "$TERMINAL_NAME" -e "env TERM=xterm $LAUNCH_FILE $@"
                     ;;
 
                 xterm|konsole|alacritty)
                     # consumes all arguments after -e
-                    exec "$TERMINAL_NAME" -e env TERM=xterm $LAUNCH_FILE "$*"
+                    exec "$TERMINAL_NAME" -e env TERM=xterm $LAUNCH_FILE "$@"
                     ;;
 
                 terminator|xfce4-terminal|mate-terminal)
                     # consumes all arguments after -x
-                    exec "$TERMINAL_NAME" -x env TERM=xterm $LAUNCH_FILE "$*"
+                    exec "$TERMINAL_NAME" -x env TERM=xterm $LAUNCH_FILE "$@"
                     ;;
 
                 gnome-terminal)
                     # consumes all arguments after --
-                    exec "$TERMINAL_NAME" -- env TERM=xterm $LAUNCH_FILE "$*"
+                    exec "$TERMINAL_NAME" -- env TERM=xterm $LAUNCH_FILE "$@"
                     ;;
 
                 kitty)
                     # consumes all trailing arguments
-                    exec "$TERMINAL_NAME" env TERM=xterm $LAUNCH_FILE "$*"
+                    exec "$TERMINAL_NAME" env TERM=xterm $LAUNCH_FILE "$@"
                     ;;
 
                 *)

From 7a3b0e180f62e2e3094510e7e12eb64af6089560 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Fri, 5 Aug 2022 17:21:53 -0400
Subject: [PATCH 739/856] Adds an error message for an invaild png

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index f3cf05d9..c825b38c 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -254,6 +254,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 using FileStream stream = File.OpenRead(file.FullName);
                 using SKBitmap bitmap = SKBitmap.Decode(stream);
+                if (bitmap is null)
+                    throw new InvalidDataException("{file.FullName} appears not to be a valid image file.");
                 rawPixels = SKPMColor.PreMultiply(bitmap.Pixels);
                 width = bitmap.Width;
                 height = bitmap.Height;

From 8c58bdae6f10dfb55d44f900480059f495d5f37e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Aug 2022 19:32:58 -0400
Subject: [PATCH 740/856] remove DebugType build property

The 'portable' format is preferred in newer .NET versions, but it's set by default now so we don't need to override it anymore.
---
 src/SMAPI.ModBuildConfig/build/smapi.targets | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 70182125..12619439 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -8,8 +8,7 @@
   ** Set build options
   **********************************************-->
   <PropertyGroup>
-    <!-- include PDB file by default to enable line numbers in stack traces -->
-    <DebugType Condition="'$(DebugType)' == ''">pdbonly</DebugType>
+    <!-- enable line numbers in stack traces -->
     <DebugSymbols>true</DebugSymbols>
 
     <!-- don't create the 'refs' folder (which isn't useful for mods) -->

From 08eafe7d898780e22d01b69e820aaa665f3a2d56 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Aug 2022 19:42:40 -0400
Subject: [PATCH 741/856] tweak new error text

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index c825b38c..8ecbc4cc 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -254,8 +254,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 using FileStream stream = File.OpenRead(file.FullName);
                 using SKBitmap bitmap = SKBitmap.Decode(stream);
+
                 if (bitmap is null)
-                    throw new InvalidDataException("{file.FullName} appears not to be a valid image file.");
+                    throw new InvalidDataException($"Failed to load {file.FullName}. This doesn't seem to be a valid PNG image.");
+
                 rawPixels = SKPMColor.PreMultiply(bitmap.Pixels);
                 width = bitmap.Width;
                 height = bitmap.Height;

From 1749a82947c84fec253f7ca6016e8428cdcd87b1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Aug 2022 19:50:29 -0400
Subject: [PATCH 742/856] update release notes

---
 docs/release-notes.md         | 6 +++++-
 docs/technical/mod-package.md | 3 +++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index cae29411..3591c375 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,8 +9,12 @@
 
 ## Upcoming release
 * For players:
-  * Fixed SMAPI applying different DPI awareness settings than the game (thanks to spacechase0!).
+  * Fixed SMAPI on Windows applying different DPI awareness settings than the game (thanks to spacechase0!).
   * Fixed Linux/macOS installer's color scheme question partly unreadable if the terminal background is dark.
+  * Fixed error message when a mod loads an invalid PNG file (thanks to atravita!).
+  * Fixed macOS launcher using Terminal regardless of the system's default terminal (thanks to ishan!).
+  * Fixed best practices in Linux/macOS launcher scripts (thanks to ishan!).
+  * Improved translations. Thanks to KediDili (updated Turkish)!
 
 * For mod authors:
   * While loading your mod, SMAPI now searches for indirect dependencies in your mod's folder to support edge cases like F# mods (thanks to TehPers)!
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index dd65a992..ca78be55 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -412,6 +412,9 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
+### Upcoming release
+* Switched to the newer crossplatform `portable` debug symbols (thanks to lanturnalis!).
+
 ### 4.0.1
 Released 14 April 2022.
 

From 352fa4759e0b52ad25bd5d210639f57eabad6c89 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Aug 2022 19:54:07 -0400
Subject: [PATCH 743/856] fix error when a mod is both duplicated and missing
 the DLL

---
 docs/release-notes.md                         | 1 +
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3591c375..080a4f20 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,6 +12,7 @@
   * Fixed SMAPI on Windows applying different DPI awareness settings than the game (thanks to spacechase0!).
   * Fixed Linux/macOS installer's color scheme question partly unreadable if the terminal background is dark.
   * Fixed error message when a mod loads an invalid PNG file (thanks to atravita!).
+  * Fixed error message when a mod is duplicated, but one of the copies is also missing the DLL file. This now shows the duplicate-mod message instead of the missing-DLL message.
   * Fixed macOS launcher using Terminal regardless of the system's default terminal (thanks to ishan!).
   * Fixed best practices in Linux/macOS launcher scripts (thanks to ishan!).
   * Improved translations. Thanks to KediDili (updated Turkish)!
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index abc46d47..a487ba28 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -47,7 +47,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 IModMetadata metadata = new ModMetadata(folder.DisplayName, folder.Directory.FullName, rootPath, manifest, dataRecord, isIgnored: shouldIgnore);
                 if (shouldIgnore)
                     metadata.SetStatus(status, ModFailReason.DisabledByDotConvention, "disabled by dot convention");
-                else
+                else if (metadata.Status == ModMetadataStatus.Failed)
                     metadata.SetStatus(status, ModFailReason.InvalidManifest, folder.ManifestParseErrorText);
 
                 yield return metadata;
@@ -223,8 +223,8 @@ namespace StardewModdingAPI.Framework.ModLoading
                 {
                     foreach (IModMetadata mod in group)
                     {
-                        if (mod.Status == ModMetadataStatus.Failed)
-                            continue; // don't replace metadata error
+                        if (mod.Status == ModMetadataStatus.Failed && mod.FailReason != ModFailReason.InvalidManifest)
+                            continue;
 
                         string folderList = string.Join(", ", group.Select(p => p.GetRelativePathWithRoot()).OrderBy(p => p));
                         mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.Duplicate, $"you have multiple copies of this mod installed. To fix this, delete these folders and reinstall the mod: {folderList}.");

From e376386d250780c50f17c40f82419128b4e7beab Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Aug 2022 21:43:46 -0400
Subject: [PATCH 744/856] set error code on exit (#868)

---
 docs/release-notes.md            |  2 ++
 src/SMAPI/Framework/ExitState.cs | 15 +++++++++
 src/SMAPI/Framework/SCore.cs     | 54 +++++++++++++++++++++-----------
 3 files changed, 53 insertions(+), 18 deletions(-)
 create mode 100644 src/SMAPI/Framework/ExitState.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 080a4f20..14421c1a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,8 @@
 
 ## Upcoming release
 * For players:
+  * SMAPI now sets a success/error code when the game exits.  
+    _This is used by your OS (like Windows) to decide whether to keep the console window open when the game ends._
   * Fixed SMAPI on Windows applying different DPI awareness settings than the game (thanks to spacechase0!).
   * Fixed Linux/macOS installer's color scheme question partly unreadable if the terminal background is dark.
   * Fixed error message when a mod loads an invalid PNG file (thanks to atravita!).
diff --git a/src/SMAPI/Framework/ExitState.cs b/src/SMAPI/Framework/ExitState.cs
new file mode 100644
index 00000000..bc022d91
--- /dev/null
+++ b/src/SMAPI/Framework/ExitState.cs
@@ -0,0 +1,15 @@
+namespace StardewModdingAPI.Framework
+{
+    /// <summary>The SMAPI exit state.</summary>
+    internal enum ExitState
+    {
+        /// <summary>SMAPI didn't trigger an explicit exit.</summary>
+        None,
+
+        /// <summary>The game is exiting normally.</summary>
+        GameExit,
+
+        /// <summary>The game is exiting due to an error.</summary>
+        Crash
+    }
+}
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 1a1bb9f8..cbb559c1 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1,6 +1,5 @@
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
@@ -50,6 +49,7 @@ using StardewModdingAPI.Utilities;
 using StardewValley;
 using StardewValley.Menus;
 using StardewValley.Objects;
+using StardewValley.SDKs;
 using xTile.Display;
 using LanguageCode = StardewValley.LocalizedContentManager.LanguageCode;
 using MiniMonoModHotfix = MonoMod.Utils.MiniMonoModHotfix;
@@ -67,8 +67,11 @@ namespace StardewModdingAPI.Framework
         /****
         ** Low-level components
         ****/
+        /// <summary>A state which indicates whether SMAPI should exit immediately and any pending initialization should be cancelled.</summary>
+        private ExitState ExitState;
+
         /// <summary>Whether the game should exit immediately and any pending initialization should be cancelled.</summary>
-        private bool IsExiting;
+        private bool IsExiting => this.ExitState != ExitState.None;
 
         /// <summary>Manages the SMAPI console window and log file.</summary>
         private readonly LogManager LogManager;
@@ -297,22 +300,13 @@ namespace StardewModdingAPI.Framework
                 this.IsGameRunning = true;
                 StardewValley.Program.releaseBuild = true; // game's debug logic interferes with SMAPI opening the game window
                 this.Game.Run();
+                this.Dispose(isError: false);
             }
             catch (Exception ex)
             {
                 this.LogManager.LogFatalLaunchError(ex);
                 this.LogManager.PressAnyKeyToExit();
-            }
-            finally
-            {
-                try
-                {
-                    this.Dispose();
-                }
-                catch (Exception ex)
-                {
-                    this.Monitor.Log($"The game ended, but SMAPI wasn't able to dispose correctly. Technical details: {ex}", LogLevel.Error);
-                }
+                this.Dispose(isError: true);
             }
         }
 
@@ -327,6 +321,14 @@ namespace StardewModdingAPI.Framework
         /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "May be disposed before SMAPI is fully initialized.")]
         public void Dispose()
+        {
+            this.Dispose(isError: true); // if we got here, SMAPI didn't detect the exit before it happened
+        }
+
+        /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
+        /// <param name="isError">Whether the process is exiting due to an error or crash.</param>
+        [SuppressMessage("ReSharper", "ConditionalAccessQualifierIsNonNullableAccordingToAPIContract", Justification = "May be disposed before SMAPI is fully initialized.")]
+        public void Dispose(bool isError)
         {
             // skip if already disposed
             if (this.IsDisposed)
@@ -349,13 +351,29 @@ namespace StardewModdingAPI.Framework
 
             // dispose core components
             this.IsGameRunning = false;
-            this.IsExiting = true;
+            if (this.ExitState == ExitState.None || isError)
+                this.ExitState = isError ? ExitState.Crash : ExitState.GameExit;
             this.ContentCore?.Dispose();
             this.Game?.Dispose();
             this.LogManager.Dispose(); // dispose last to allow for any last-second log messages
 
-            // end game (moved from Game1.OnExiting to let us clean up first)
-            Process.GetCurrentProcess().Kill();
+            // clean up SDK
+            // This avoids Steam connection errors when it exits unexpectedly. The game avoids this
+            // by killing the entire process, but we can't set the error code if we do that.
+            try
+            {
+                FieldInfo? field = typeof(StardewValley.Program).GetField("_sdk", BindingFlags.NonPublic | BindingFlags.Static);
+                SDKHelper? sdk = field?.GetValue(null) as SDKHelper;
+                sdk?.Shutdown();
+            }
+            catch
+            {
+                // well, at least we tried
+            }
+
+            // end game with error code
+            // This helps the OS decide whether to keep the window open (e.g. Windows may keep it open on error).
+            Environment.Exit(this.ExitState == ExitState.Crash ? 1 : 0);
         }
 
 
@@ -1250,7 +1268,7 @@ namespace StardewModdingAPI.Framework
         private void OnGameExiting()
         {
             this.Multiplayer.Disconnect(StardewValley.Multiplayer.DisconnectType.ClosedGame);
-            this.Dispose();
+            this.Dispose(isError: false);
         }
 
         /// <summary>Raised when a mod network message is received.</summary>
@@ -2239,7 +2257,7 @@ namespace StardewModdingAPI.Framework
             this.Monitor.LogFatal(message);
             this.LogManager.WriteCrashLog();
 
-            this.IsExiting = true;
+            this.ExitState = ExitState.Crash;
             this.Game.Exit();
         }
 

From d813c4e2c8522584beaf1432725b4cdd2cc251b5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 8 Aug 2022 22:27:07 -0400
Subject: [PATCH 745/856] fix log parsing for invalid content packs (#860)

---
 docs/release-notes.md                         |  1 +
 .../Framework/LogParsing/LogParser.cs         | 10 +++----
 .../Framework/LogParsing/Models/LogModInfo.cs | 22 +++++++--------
 .../Framework/LogParsing/Models/ModType.cs    | 15 +++++++++++
 src/SMAPI.Web/ViewModels/LogParserModel.cs    |  2 +-
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 27 ++++++++++++++-----
 6 files changed, 52 insertions(+), 25 deletions(-)
 create mode 100644 src/SMAPI.Web/Framework/LogParsing/Models/ModType.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 14421c1a..46d910a9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -29,6 +29,7 @@
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
   * Converted images to SVG (thanks to ishan!).
   * Updated log parser for new update alert format in SMAPI 3.15.1.
+  * Fixed parsing for invalid content packs.
 
 ## 3.15.1
 Released 06 July 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 4a110dcd..18ba754c 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -36,7 +36,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
         private readonly Regex ContentPackListStartPattern = new(@"^Loaded \d+ content packs:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching an entry in SMAPI's content pack list.</summary>
-        private readonly Regex ContentPackListEntryPattern = new(@"^   (?<name>.+?) (?<version>[^\s]+)(?: by (?<author>[^\|]+))? \| for (?<for>[^\|]+)(?: \| (?<description>.+))?$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+        private readonly Regex ContentPackListEntryPattern = new(@"^   (?<name>.+?) (?<version>[^\s]+)(?: by (?<author>[^\|]+))? \| for (?<for>[^\|]*)(?: \| (?<description>.+))?$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
 
         /// <summary>A regex pattern matching the start of SMAPI's mod update list.</summary>
         private readonly Regex ModUpdateListStartPattern = new(@"^You can update \d+ mods?:$", RegexOptions.Compiled | RegexOptions.IgnoreCase);
@@ -77,8 +77,8 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                 };
 
                 // parse log messages
-                LogModInfo smapiMod = new(name: "SMAPI", author: "Pathoschild", version: "", description: "", loaded: true, isMod: false);
-                LogModInfo gameMod = new(name: "game", author: "", version: "", description: "", loaded: true, isMod: false);
+                LogModInfo smapiMod = new(ModType.Special, name: "SMAPI", author: "Pathoschild", version: "", description: "", loaded: true);
+                LogModInfo gameMod = new(ModType.Special, name: "game", author: "", version: "", description: "", loaded: true);
                 IDictionary<string, List<LogModInfo>> mods = new Dictionary<string, List<LogModInfo>>();
                 bool inModList = false;
                 bool inContentPackList = false;
@@ -133,7 +133,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
 
                             if (!mods.TryGetValue(name, out List<LogModInfo>? entries))
                                 mods[name] = entries = new List<LogModInfo>();
-                            entries.Add(new LogModInfo(name: name, author: author, version: version, description: description, loaded: true));
+                            entries.Add(new LogModInfo(ModType.CodeMod, name: name, author: author, version: version, description: description, loaded: true));
 
                             message.Section = LogSection.ModsList;
                         }
@@ -156,7 +156,7 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
 
                             if (!mods.TryGetValue(name, out List<LogModInfo>? entries))
                                 mods[name] = entries = new List<LogModInfo>();
-                            entries.Add(new LogModInfo(name: name, author: author, version: version, description: description, contentPackFor: forMod, loaded: true));
+                            entries.Add(new LogModInfo(ModType.ContentPack, name: name, author: author, version: version, description: description, contentPackFor: forMod, loaded: true));
 
                             message.Section = LogSection.ContentPackList;
                         }
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
index 557f08ff..c81942e4 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/LogModInfo.cs
@@ -48,21 +48,24 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         [MemberNotNullWhen(true, nameof(LogModInfo.UpdateVersion), nameof(LogModInfo.UpdateLink))]
         public bool HasUpdate => this.UpdateVersion != null && this.Version != this.UpdateVersion;
 
+        /// <summary>The mod type.</summary>
+        public ModType ModType { get; }
+
         /// <summary>Whether this is an actual mod (rather than a special entry for SMAPI or the game itself).</summary>
-        public bool IsMod { get; }
+        public bool IsMod => this.ModType != ModType.Special;
 
         /// <summary>Whether this is a C# code mod.</summary>
-        public bool IsCodeMod { get; }
+        public bool IsCodeMod => this.ModType == ModType.CodeMod;
 
         /// <summary>Whether this is a content pack for another mod.</summary>
-        [MemberNotNullWhen(true, nameof(LogModInfo.ContentPackFor))]
-        public bool IsContentPack { get; }
+        public bool IsContentPack => this.ModType == ModType.ContentPack;
 
 
         /*********
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="modType">The mod type.</param>
         /// <param name="name">The mod name.</param>
         /// <param name="author">The mod author.</param>
         /// <param name="version">The mod version.</param>
@@ -72,9 +75,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         /// <param name="contentPackFor">The name of the mod for which this is a content pack (if applicable).</param>
         /// <param name="errors">The number of errors logged by this mod.</param>
         /// <param name="loaded">Whether the mod was loaded into the game.</param>
-        /// <param name="isMod">Whether this is an actual mod (instead of a special entry for SMAPI or the game).</param>
-        public LogModInfo(string name, string author, string version, string description, string? updateVersion = null, string? updateLink = null, string? contentPackFor = null, int errors = 0, bool loaded = true, bool isMod = true)
+        public LogModInfo(ModType modType, string name, string author, string version, string description, string? updateVersion = null, string? updateLink = null, string? contentPackFor = null, int errors = 0, bool loaded = true)
         {
+            this.ModType = modType;
             this.Name = name;
             this.Author = author;
             this.Description = description;
@@ -84,13 +87,6 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
             this.Errors = errors;
             this.Loaded = loaded;
 
-            if (isMod)
-            {
-                this.IsMod = true;
-                this.IsContentPack = !string.IsNullOrWhiteSpace(this.ContentPackFor);
-                this.IsCodeMod = !this.IsContentPack;
-            }
-
             this.OverrideVersion(version);
         }
 
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/ModType.cs b/src/SMAPI.Web/Framework/LogParsing/Models/ModType.cs
new file mode 100644
index 00000000..363aaaec
--- /dev/null
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/ModType.cs
@@ -0,0 +1,15 @@
+namespace StardewModdingAPI.Web.Framework.LogParsing.Models
+{
+    /// <summary>The type for a <see cref="LogModInfo"/> instance.</summary>
+    public enum ModType
+    {
+        /// <summary>A special non-mod entry (e.g. for SMAPI or the game itself).</summary>
+        Special,
+
+        /// <summary>A C# mod.</summary>
+        CodeMod,
+
+        /// <summary>A content pack loaded by a C# mod.</summary>
+        ContentPack
+    }
+}
diff --git a/src/SMAPI.Web/ViewModels/LogParserModel.cs b/src/SMAPI.Web/ViewModels/LogParserModel.cs
index c39a9b0a..34d0b4df 100644
--- a/src/SMAPI.Web/ViewModels/LogParserModel.cs
+++ b/src/SMAPI.Web/ViewModels/LogParserModel.cs
@@ -107,7 +107,7 @@ namespace StardewModdingAPI.Web.ViewModels
             // group by mod
             return mods
                 .Where(mod => mod.IsContentPack)
-                .GroupBy(mod => mod.ContentPackFor!)
+                .GroupBy(mod => mod.ContentPackFor ?? "")
                 .ToDictionary(group => group.Key, group => group.ToArray());
         }
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 57e26ace..f71c6ac1 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -352,16 +352,31 @@ else if (log?.IsValid == true)
                     <span class="notice btn txt" v-on:click="toggleContentPacks">toggle content packs in list</span>
                 }
             </caption>
-            @foreach (var mod in log.Mods.Where(p => p.Loaded && !p.IsContentPack))
-            {
-                if (contentPacks == null || !contentPacks.TryGetValue(mod.Name, out LogModInfo[]? contentPackList))
-                    contentPackList = null;
 
+            @{
+                var modsWithContentPacks = log.Mods
+                    .Where(mod => mod.Loaded && !mod.IsContentPack)
+                    .Select(mod => (
+                        Mod: mod,
+                        ContentPacks: contentPacks?.TryGetValue(mod.Name, out LogModInfo[]? contentPackList) == true ? contentPackList : Array.Empty<LogModInfo>()
+                    ))
+                    .ToList();
+                if (contentPacks?.TryGetValue("", out LogModInfo[] invalidPacks) == true)
+                {
+                    modsWithContentPacks.Add((
+                        Mod: new LogModInfo(ModType.CodeMod, "<invalid content packs>", "", "", ""),
+                        ContentPacks: invalidPacks
+                    ));
+                }
+            }
+
+            @foreach ((LogModInfo mod, LogModInfo[] contentPackList) in modsWithContentPacks)
+            {
                 <tr v-on:click="toggleMod('@Model.GetSlug(mod.Name)')" class="mod-entry" v-bind:class="{ hidden: !showMods['@Model.GetSlug(mod.Name)'] }">
                     <td><input type="checkbox" v-bind:checked="showMods['@Model.GetSlug(mod.Name)']" v-bind:class="{ invisible: !anyModsHidden }" /></td>
                     <td>
                         <strong v-pre>@mod.Name</strong> @mod.Version
-                        @if (contentPackList != null)
+                        @if (contentPackList.Any())
                         {
                             <div v-if="!hideContentPacks" class="content-packs">
                                 @foreach (var contentPack in contentPackList)
@@ -374,7 +389,7 @@ else if (log?.IsValid == true)
                     </td>
                     <td>
                         @mod.Author
-                        @if (contentPackList != null)
+                        @if (contentPackList.Any())
                         {
                             <div v-if="!hideContentPacks" class="content-packs">
                                 @foreach (var contentPack in contentPackList)

From 4d9384b8288fa5dcd36a9c8cbd66574a2896605f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 14 Aug 2022 19:17:21 -0400
Subject: [PATCH 746/856] switch SMAPI to portable PDB format

---
 build/common.targets  | 1 -
 docs/release-notes.md | 1 +
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/build/common.targets b/build/common.targets
index 230bef41..026b56df 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -12,7 +12,6 @@ repo. It imports the other MSBuild files as needed.
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
     <DefineConstants>$(DefineConstants);SMAPI_DEPRECATED</DefineConstants>
-    <DebugType>pdbonly</DebugType>
     <DebugSymbols>true</DebugSymbols>
 
     <!--enable nullable annotations, except in .NET Standard 2.0 where they aren't supported-->
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 46d910a9..7526e655 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -24,6 +24,7 @@
   * **Raised deprecation message levels.**  
     _Deprecation warnings are now player-visible in the SMAPI console as grayed-out `DEBUG` messages. They'll be raised to `WARN` level in SMAPI 3.17 next month, which will be the last major release before SMAPI 4.0._
   * Updated to Pintail 2.2.1 (see [changes](https://github.com/Nanoray-pl/Pintail/blob/master/docs/release-notes.md#221)).
+  * Switched SMAPI's `.pdb` file to the newer 'portable' format. This has no effect on mods.
 
 * For the web UI:
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.

From 5ab87efaa07a0972fd59c88c8aab456a6133329d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 16 Aug 2022 22:03:21 -0400
Subject: [PATCH 747/856] log error if mod files are detected directly under
 Mods folder

---
 docs/release-notes.md        | 1 +
 src/SMAPI/Framework/SCore.cs | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7526e655..1734ca2d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For players:
+  * Added error message if mod files are detected directly under `Mods` (instead of each mod having its own subfolder).
   * SMAPI now sets a success/error code when the game exits.  
     _This is used by your OS (like Windows) to decide whether to keep the console window open when the game ends._
   * Fixed SMAPI on Windows applying different DPI awareness settings than the game (thanks to spacechase0!).
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index cbb559c1..0f86ed6b 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -405,7 +405,14 @@ namespace StardewModdingAPI.Framework
                 {
                     string[] looseFiles = new DirectoryInfo(this.ModsPath).GetFiles().Select(p => p.Name).ToArray();
                     if (looseFiles.Any())
+                    {
+                        if (looseFiles.Any(name => name.Equals("manifest.json", StringComparison.OrdinalIgnoreCase) || name.EndsWith(".dll", StringComparison.OrdinalIgnoreCase)))
+                        {
+                            this.Monitor.Log($"Detected mod files directly inside the '{Path.GetFileName(this.ModsPath)}' folder. These will be ignored. Each mod must have its own subfolder instead.", LogLevel.Error);
+                        }
+
                         this.Monitor.Log($"  Ignored loose files: {string.Join(", ", looseFiles.OrderBy(p => p, StringComparer.OrdinalIgnoreCase))}");
+                    }
                 }
 
                 // load manifests

From f23cd450a0cca3ede1dacb198b4dd6432a44bf16 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 16 Aug 2022 22:03:22 -0400
Subject: [PATCH 748/856] clarify docs

---
 docs/technical/smapi.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index 90990ee4..b8a1683b 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -33,14 +33,15 @@ argument | purpose
 `--uninstall` | Preselects the uninstall action, skipping the prompt asking what the user wants to do.
 `--game-path "path"` | Specifies the full path to the folder containing the Stardew Valley executable, skipping automatic detection and any prompt to choose a path. If the path is not valid, the installer displays an error.
 
-SMAPI itself recognises five arguments **on Windows only**, but these are intended for internal use
-or testing and may change without warning. On Linux/macOS, see _environment variables_ below.
+SMAPI itself recognises five arguments, but these are meant for internal use or testing, and might
+change without warning. **On Linux/macOS**, command-line arguments won't work; see _environment
+variables_ below instead.
 
 argument | purpose
 -------- | -------
 `--developer-mode`<br />`--developer-mode-off` | Enable or disable features intended for mod developers. Currently this only makes `TRACE`-level messages appear in the console.
-`--no-terminal` | The SMAPI launcher won't try to open a terminal window, and SMAPI won't log anything to the console. (Messages will still be written to the log file.)
-`--use-current-shell` | The SMAPI launcher won't try to open a terminal window, but SMAPI will still log to the console. (Messages will still be written to the log file.)
+`--no-terminal` | SMAPI won't log anything to the console. On Linux/macOS only, this will also prevent the launch script from trying to open a terminal window. (Messages will still be written to the log file.)
+`--use-current-shell` | On Linux/macOS only, the launch script won't try to open a terminal window. All console output will be sent to the shell running the launch script.
 `--mods-path` | The path to search for mods, if not the standard `Mods` folder. This can be a path relative to the game folder (like `--mods-path "Mods (test)"`) or an absolute path.
 
 ### Environment variables

From c51a593e93ba4d7e41971ed64cfa413449d501e3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Tue, 16 Aug 2022 22:03:22 -0400
Subject: [PATCH 749/856] fix log parser error if a mod logged a null character

---
 docs/release-notes.md                            |  3 ++-
 src/SMAPI.Web/Controllers/LogParserController.cs | 16 ++++++++++++----
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 1734ca2d..5626dcc8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -31,7 +31,8 @@
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
   * Converted images to SVG (thanks to ishan!).
   * Updated log parser for new update alert format in SMAPI 3.15.1.
-  * Fixed parsing for invalid content packs.
+  * Fixed log parsing for invalid content packs.
+  * Fixed log parsing if a mod logged a null character.
 
 ## 3.15.1
 Released 06 July 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Web/Controllers/LogParserController.cs b/src/SMAPI.Web/Controllers/LogParserController.cs
index 33af5a81..a3bcf4c3 100644
--- a/src/SMAPI.Web/Controllers/LogParserController.cs
+++ b/src/SMAPI.Web/Controllers/LogParserController.cs
@@ -1,7 +1,9 @@
 using System;
-using System.Linq;
+using System.Collections.Specialized;
+using System.IO;
 using System.Text;
 using System.Threading.Tasks;
+using System.Web;
 using Microsoft.AspNetCore.Mvc;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewModdingAPI.Web.Framework;
@@ -87,9 +89,15 @@ namespace StardewModdingAPI.Web.Controllers
         public async Task<ActionResult> PostAsync()
         {
             // get raw log text
-            string? input = this.Request.Form["input"].FirstOrDefault();
-            if (string.IsNullOrWhiteSpace(input))
-                return this.View("Index", this.GetModel(null, uploadError: "The log file seems to be empty."));
+            // note: avoid this.Request.Form, which fails if any mod logged a null character.
+            string? input;
+            {
+                using StreamReader reader = new StreamReader(this.Request.Body);
+                NameValueCollection parsed = HttpUtility.ParseQueryString(await reader.ReadToEndAsync());
+                input = parsed["input"];
+                if (string.IsNullOrWhiteSpace(input))
+                    return this.View("Index", this.GetModel(null, uploadError: "The log file seems to be empty."));
+            }
 
             // upload log
             UploadResult uploadResult = await this.Storage.SaveAsync(input);

From b2103bbfa6691cd6726d626fbf8c0567b8092746 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 18 Aug 2022 22:39:37 -0400
Subject: [PATCH 750/856] update schema for Content Patcher 1.28.0

---
 docs/release-notes.md                              | 1 +
 src/SMAPI.Web/wwwroot/schemas/content-patcher.json | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5626dcc8..87693512 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -31,6 +31,7 @@
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
   * Converted images to SVG (thanks to ishan!).
   * Updated log parser for new update alert format in SMAPI 3.15.1.
+  * Updated the JSON validator/schema for Content Patcher 1.28.0.
   * Fixed log parsing for invalid content packs.
   * Fixed log parsing if a mod logged a null character.
 
diff --git a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
index 631fbc63..a00403c0 100644
--- a/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
+++ b/src/SMAPI.Web/wwwroot/schemas/content-patcher.json
@@ -14,9 +14,9 @@
             "title": "Format version",
             "description": "The format version. You should always use the latest version to enable the latest features, avoid obsolete behavior, and reduce load times.",
             "type": "string",
-            "pattern": "^1\\.27\\.[0-9]+$",
+            "pattern": "^1\\.28\\.[0-9]+$",
             "@errorMessages": {
-                "pattern": "Incorrect value '@value'. You should always use the latest format version (currently 1.27.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
+                "pattern": "Incorrect value '@value'. You should always use the latest format version (currently 1.28.0) to enable the latest features, avoid obsolete behavior, and reduce load times."
             }
         },
         "ConfigSchema": {

From 263130bafcf10e5ce2527eb8643b00052a41f9b5 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 20 Aug 2022 16:15:29 -0400
Subject: [PATCH 751/856] fix deprecation notices split into two messages
 unnecessarily

---
 src/SMAPI/Framework/Deprecations/DeprecationManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index 4597a764..f58f085e 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -124,7 +124,7 @@ namespace StardewModdingAPI.Framework.Deprecations
                 }
 
                 // log message
-                if (level == LogLevel.Trace)
+                if (level is LogLevel.Trace or LogLevel.Debug)
                 {
                     if (warning.LogStackTrace)
                         message += $"\n{this.GetSimplifiedStackTrace(warning.StackTrace, warning.Mod)}";

From f780d140f0c87de9f10d6f55d501c958316548d0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 20 Aug 2022 16:36:15 -0400
Subject: [PATCH 752/856] fix early mod load errors incorrectly suppressed

---
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index a487ba28..c5648c74 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -47,7 +47,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 IModMetadata metadata = new ModMetadata(folder.DisplayName, folder.Directory.FullName, rootPath, manifest, dataRecord, isIgnored: shouldIgnore);
                 if (shouldIgnore)
                     metadata.SetStatus(status, ModFailReason.DisabledByDotConvention, "disabled by dot convention");
-                else if (metadata.Status == ModMetadataStatus.Failed)
+                else if (status == ModMetadataStatus.Failed)
                     metadata.SetStatus(status, ModFailReason.InvalidManifest, folder.ManifestParseErrorText);
 
                 yield return metadata;

From f3a79219e85c9af18f2f6d8b2aaa794afa08578d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 20 Aug 2022 17:01:07 -0400
Subject: [PATCH 753/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 14 ++++++++------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 026b56df..383e258b 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.15.1</Version>
+    <Version>3.16.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 87693512..ca7d6e6e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -4,10 +4,12 @@
 <!--
 ## 4.0.0
 * The installer no longer supports updating from SMAPI 2.11.3 or earlier (released in 2019).  
-  _If needed, you can update to SMAPI 3.15.0 first and then install to the latest version._
+  _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.16.0
+Released 22 August 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/70797008).
+
 * For players:
   * Added error message if mod files are detected directly under `Mods` (instead of each mod having its own subfolder).
   * SMAPI now sets a success/error code when the game exits.  
@@ -21,16 +23,16 @@
   * Improved translations. Thanks to KediDili (updated Turkish)!
 
 * For mod authors:
-  * While loading your mod, SMAPI now searches for indirect dependencies in your mod's folder to support edge cases like F# mods (thanks to TehPers)!
+  * While loading your mod, SMAPI now searches for indirect dependencies in your mod's folder (thanks to TehPers)! This mainly enables F# mods.
   * **Raised deprecation message levels.**  
-    _Deprecation warnings are now player-visible in the SMAPI console as grayed-out `DEBUG` messages. They'll be raised to `WARN` level in SMAPI 3.17 next month, which will be the last major release before SMAPI 4.0._
+    _Deprecation warnings are now player-visible in the SMAPI console as faded `DEBUG` messages._
   * Updated to Pintail 2.2.1 (see [changes](https://github.com/Nanoray-pl/Pintail/blob/master/docs/release-notes.md#221)).
-  * Switched SMAPI's `.pdb` file to the newer 'portable' format. This has no effect on mods.
+  * Switched SMAPI's `.pdb` files to the newer 'portable' format. This has no effect on mods.
 
 * For the web UI:
   * Added log parser warning about performance of PyTK 1.23.0 or earlier.
   * Converted images to SVG (thanks to ishan!).
-  * Updated log parser for new update alert format in SMAPI 3.15.1.
+  * Updated log parser for the new update alert format in SMAPI 3.15.1.
   * Updated the JSON validator/schema for Content Patcher 1.28.0.
   * Fixed log parsing for invalid content packs.
   * Fixed log parsing if a mod logged a null character.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 3c2dec19..adc45ec3 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.15.1",
+    "Version": "3.16.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.15.1"
+    "MinimumApiVersion": "3.16.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 28b4b149..3a3c9283 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.15.1",
+    "Version": "3.16.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.15.1"
+    "MinimumApiVersion": "3.16.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 1944575b..eb98aa32 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.15.1",
+    "Version": "3.16.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.15.1"
+    "MinimumApiVersion": "3.16.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 7aaa33bb..c79a72ef 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.15.1";
+        internal static string RawApiVersion = "3.16.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 1d5017f1197862d0d9c9f7aa4e13216cad3746d6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 24 Aug 2022 17:49:12 -0400
Subject: [PATCH 754/856] fix broken mods with no ID listed as duplicate

---
 docs/release-notes.md                         | 3 +++
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 4 ++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ca7d6e6e..68dc7874 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,9 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
+## Upcoming release
+* Fixed broken mods sometimes incorrectly listed as duplicate.
+
 ## 3.16.0
 Released 22 August 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/70797008).
 
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index c5648c74..5f1fbe4b 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -218,12 +218,12 @@ namespace StardewModdingAPI.Framework.ModLoading
             {
                 var duplicatesByID = mods
                     .GroupBy(mod => mod.Manifest?.UniqueID?.Trim(), mod => mod, StringComparer.OrdinalIgnoreCase)
-                    .Where(p => p.Count() > 1);
+                    .Where(p => !string.IsNullOrEmpty(p.Key) && p.Count() > 1);
                 foreach (var group in duplicatesByID)
                 {
                     foreach (IModMetadata mod in group)
                     {
-                        if (mod.Status == ModMetadataStatus.Failed && mod.FailReason != ModFailReason.InvalidManifest)
+                        if (mod.Status == ModMetadataStatus.Failed && mod.FailReason is not (ModFailReason.InvalidManifest or ModFailReason.LoadFailed or ModFailReason.MissingDependencies))
                             continue;
 
                         string folderList = string.Join(", ", group.Select(p => p.GetRelativePathWithRoot()).OrderBy(p => p));

From c2f474bf88a43e293d28851785a57a9ca1e60f2e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 24 Aug 2022 17:49:17 -0400
Subject: [PATCH 755/856] distinguish empty/XNB folders from invalid manifest
 for error-tracking

---
 src/SMAPI/Framework/ModLoading/ModFailReason.cs |  8 +++++++-
 src/SMAPI/Framework/ModLoading/ModResolver.cs   | 11 ++++++++++-
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModFailReason.cs b/src/SMAPI/Framework/ModLoading/ModFailReason.cs
index cd4623e7..cfb76a33 100644
--- a/src/SMAPI/Framework/ModLoading/ModFailReason.cs
+++ b/src/SMAPI/Framework/ModLoading/ModFailReason.cs
@@ -9,6 +9,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Multiple copies of the mod are installed.</summary>
         Duplicate,
 
+        /// <summary>The folder is empty or contains only ignored files.</summary>
+        EmptyFolder,
+
         /// <summary>The mod has incompatible code instructions, needs a newer SMAPI version, or is marked 'assume broken' in the SMAPI metadata list.</summary>
         Incompatible,
 
@@ -22,6 +25,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         MissingDependencies,
 
         /// <summary>The mod is marked obsolete in the SMAPI metadata list.</summary>
-        Obsolete
+        Obsolete,
+
+        /// <summary>The folder is an XNB mod, which can't be loaded through SMAPI.</summary>
+        XnbMod
     }
 }
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 5f1fbe4b..fe56f4d2 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -48,7 +48,16 @@ namespace StardewModdingAPI.Framework.ModLoading
                 if (shouldIgnore)
                     metadata.SetStatus(status, ModFailReason.DisabledByDotConvention, "disabled by dot convention");
                 else if (status == ModMetadataStatus.Failed)
-                    metadata.SetStatus(status, ModFailReason.InvalidManifest, folder.ManifestParseErrorText);
+                {
+                    ModFailReason reason = folder.ManifestParseError switch
+                    {
+                        ModParseError.EmptyFolder or ModParseError.EmptyVortexFolder => ModFailReason.EmptyFolder,
+                        ModParseError.XnbMod => ModFailReason.XnbMod,
+                        _ => ModFailReason.InvalidManifest
+                    };
+
+                    metadata.SetStatus(status, reason, folder.ManifestParseErrorText);
+                }
 
                 yield return metadata;
             }

From 2bb8e8353ba35c2db96f88a052400997232d25f8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 29 Aug 2022 18:00:41 -0400
Subject: [PATCH 756/856] update compatibility workaround for the recent PyTK
 update

---
 docs/release-notes.md                                    | 4 +++-
 src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs    | 4 ++--
 src/SMAPI.Web/Views/LogParser/Index.cshtml               | 4 ++--
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 2 +-
 src/SMAPI/Framework/SCore.cs                             | 4 ++--
 5 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 68dc7874..5e84136c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,7 +8,9 @@
 -->
 
 ## Upcoming release
-* Fixed broken mods sometimes incorrectly listed as duplicate.
+* For players:
+  * Updated compatibility workaround for the recent PyTK update.
+  * Fixed broken mods sometimes incorrectly listed as duplicate.
 
 ## 3.16.0
 Released 22 August 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/70797008).
diff --git a/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs b/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs
index 9ee864db..83cd42b9 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs
@@ -10,7 +10,7 @@ using StardewModdingAPI.Internal;
 using StardewModdingAPI.Internal.Patching;
 
 //
-// This is part of a three-part fix for PyTK 1.23.0 and earlier. When removing this, search
+// This is part of a three-part fix for PyTK 1.23.* and earlier. When removing this, search
 // 'Platonymous.Toolkit' to find the other part in SMAPI and Content Patcher.
 //
 
@@ -38,7 +38,7 @@ namespace StardewModdingAPI.Mods.ErrorHandler.ModPatches
         public PyTkPatcher(IModRegistry modRegistry)
         {
             IModMetadata? pyTk = (IModMetadata?)modRegistry.Get(@"Platonymous.Toolkit");
-            if (pyTk is not null && !pyTk.Manifest.Version.IsNewerThan("1.23.0"))
+            if (pyTk is not null && pyTk.Manifest.Version.IsOlderThan("1.24.0"))
                 PyTkPatcher.PyTk = pyTk;
         }
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index f71c6ac1..24fe5fa2 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -17,7 +17,7 @@
     LogModInfo[] outdatedMods = log?.Mods.Where(mod => mod.HasUpdate).ToArray() ?? Array.Empty<LogModInfo>();
     LogModInfo? errorHandler = log?.Mods.FirstOrDefault(p => p.IsCodeMod && p.Name == "Error Handler");
     bool hasOlderErrorHandler = errorHandler?.GetParsedVersion() is not null && log?.ApiVersionParsed is not null && log.ApiVersionParsed.IsNewerThan(errorHandler.GetParsedVersion());
-    bool isPyTkCompatibilityMode = log?.ApiVersionParsed?.IsOlderThan("3.15.0") is false && log.Mods.Any(p => p.IsCodeMod && p.Name == "PyTK" && p.GetParsedVersion()?.IsOlderThan("1.23.1") is true);
+    bool isPyTkCompatibilityMode = log?.ApiVersionParsed?.IsOlderThan("3.15.0") is false && log.Mods.Any(p => p.IsCodeMod && p.Name == "PyTK" && p.GetParsedVersion()?.IsOlderThan("1.24.0") is true);
 
     // get filters
     IDictionary<string, bool> defaultFilters = Enum
@@ -257,7 +257,7 @@ else if (log?.IsValid == true)
                 }
                 @if (isPyTkCompatibilityMode)
                 {
-                    <li>PyTK 1.23.0 or earlier isn't compatible with newer SMAPI performance optimizations. This may increase loading times or in-game lag.</li>
+                    <li>PyTK 1.23.* or earlier isn't compatible with newer SMAPI performance optimizations. This may increase loading times or in-game lag.</li>
                 }
                 @if (outdatedMods.Any())
                 {
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 8ecbc4cc..6a36ab48 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -212,7 +212,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     // current file has a '.pytk.json' rescale file though, since PyTK may still
                     // rescale it if the original asset or another edit gets rescaled.
                     asRawData = false;
-                    this.Monitor.LogOnce("Enabled compatibility mode for PyTK 1.23.0 or earlier. This won't cause any issues, but may impact performance.", LogLevel.Warn);
+                    this.Monitor.LogOnce("Enabled compatibility mode for PyTK 1.23.* or earlier. This won't cause any issues, but may impact performance.", LogLevel.Warn);
                 }
             }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 0f86ed6b..a5e51bdf 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1673,11 +1673,11 @@ namespace StardewModdingAPI.Framework
             this.ReloadTranslations(loaded);
 
             // set temporary PyTK compatibility mode
-            // This is part of a three-part fix for PyTK 1.23.0 and earlier. When removing this,
+            // This is part of a three-part fix for PyTK 1.23.* and earlier. When removing this,
             // search 'Platonymous.Toolkit' to find the other part in SMAPI and Content Patcher.
             {
                 IModInfo? pyTk = this.ModRegistry.Get("Platonymous.Toolkit");
-                ModContentManager.EnablePyTkLegacyMode = pyTk is not null && pyTk.Manifest.Version.IsOlderThan("1.23.1");
+                ModContentManager.EnablePyTkLegacyMode = pyTk is not null && pyTk.Manifest.Version.IsOlderThan("1.24.0");
             }
 
             // initialize loaded non-content-pack mods

From 47a68fbb7bb6afc9ecaa3a13b450ddc865754de8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 29 Aug 2022 18:17:53 -0400
Subject: [PATCH 757/856] deprecate PyTK compatibility mode

---
 src/SMAPI.Mods.ErrorHandler/ModEntry.cs                  | 8 ++++++--
 src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs    | 2 ++
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 6 +++++-
 src/SMAPI/Framework/SCore.cs                             | 2 ++
 4 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
index 22e68421..25056b5e 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModEntry.cs
@@ -2,7 +2,9 @@ using System;
 using System.Reflection;
 using StardewModdingAPI.Events;
 using StardewModdingAPI.Internal.Patching;
+#if SMAPI_DEPRECATED
 using StardewModdingAPI.Mods.ErrorHandler.ModPatches;
+#endif
 using StardewModdingAPI.Mods.ErrorHandler.Patches;
 using StardewValley;
 
@@ -39,10 +41,12 @@ namespace StardewModdingAPI.Mods.ErrorHandler
                 new ObjectPatcher(),
                 new SaveGamePatcher(this.Monitor, this.OnSaveContentRemoved),
                 new SpriteBatchPatcher(),
-                new UtilityPatcher(),
+                new UtilityPatcher()
 
+#if SMAPI_DEPRECATED
                 // mod patches
-                new PyTkPatcher(helper.ModRegistry)
+                , new PyTkPatcher(helper.ModRegistry)
+#endif
             );
 
             // hook events
diff --git a/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs b/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs
index 83cd42b9..f084902a 100644
--- a/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs
+++ b/src/SMAPI.Mods.ErrorHandler/ModPatches/PyTkPatcher.cs
@@ -1,3 +1,4 @@
+#if SMAPI_DEPRECATED
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
@@ -77,3 +78,4 @@ namespace StardewModdingAPI.Mods.ErrorHandler.ModPatches
         }
     }
 }
+#endif
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 6a36ab48..cc6f8372 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -50,8 +50,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Accessors
         *********/
+#if SMAPI_DEPRECATED
         /// <summary>Whether to enable legacy compatibility mode for PyTK scale-up textures.</summary>
         internal static bool EnablePyTkLegacyMode;
+#endif
 
 
         /*********
@@ -202,6 +204,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             bool expectsRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
             bool asRawData = expectsRawData || this.UseRawImageLoading;
 
+#if SMAPI_DEPRECATED
             // disable raw data if PyTK will rescale the image (until it supports raw data)
             if (asRawData && !expectsRawData)
             {
@@ -212,9 +215,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     // current file has a '.pytk.json' rescale file though, since PyTK may still
                     // rescale it if the original asset or another edit gets rescaled.
                     asRawData = false;
-                    this.Monitor.LogOnce("Enabled compatibility mode for PyTK 1.23.* or earlier. This won't cause any issues, but may impact performance.", LogLevel.Warn);
+                    this.Monitor.LogOnce("Enabled compatibility mode for PyTK 1.23.* or earlier. This won't cause any issues, but may impact performance. This will no longer be supported in the upcoming SMAPI 4.0.0.", LogLevel.Warn);
                 }
             }
+#endif
 
             // load
             if (asRawData)
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index a5e51bdf..16ff2537 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1672,6 +1672,7 @@ namespace StardewModdingAPI.Framework
             // initialize translations
             this.ReloadTranslations(loaded);
 
+#if SMAPI_DEPRECATED
             // set temporary PyTK compatibility mode
             // This is part of a three-part fix for PyTK 1.23.* and earlier. When removing this,
             // search 'Platonymous.Toolkit' to find the other part in SMAPI and Content Patcher.
@@ -1679,6 +1680,7 @@ namespace StardewModdingAPI.Framework
                 IModInfo? pyTk = this.ModRegistry.Get("Platonymous.Toolkit");
                 ModContentManager.EnablePyTkLegacyMode = pyTk is not null && pyTk.Manifest.Version.IsOlderThan("1.24.0");
             }
+#endif
 
             // initialize loaded non-content-pack mods
             this.Monitor.Log("Launching mods...", LogLevel.Debug);

From 8b6c732d7168edacf44d4dbabd8613f2c38ebc19 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 29 Aug 2022 18:18:21 -0400
Subject: [PATCH 758/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 6 ++++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 383e258b..1a81a105 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.16.0</Version>
+    <Version>3.16.1</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5e84136c..f306607c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,9 +7,11 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.16.1
+Released 29 August 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
-  * Updated compatibility workaround for the recent PyTK update.
+  * Updated PyTK compatibility mode for the latest PyTK version.
   * Fixed broken mods sometimes incorrectly listed as duplicate.
 
 ## 3.16.0
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index adc45ec3..f3dc8aef 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.16.0",
+    "Version": "3.16.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.16.0"
+    "MinimumApiVersion": "3.16.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 3a3c9283..cbcf0f82 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.16.0",
+    "Version": "3.16.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.16.0"
+    "MinimumApiVersion": "3.16.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index eb98aa32..5aa092ef 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.16.0",
+    "Version": "3.16.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.16.0"
+    "MinimumApiVersion": "3.16.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index c79a72ef..14aaf166 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.16.0";
+        internal static string RawApiVersion = "3.16.1";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 5af87fc3be989c092dfcc9f328aa8bf3e7d48664 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 31 Aug 2022 17:08:30 -0400
Subject: [PATCH 759/856] remove compatibility section in the new app manifest

This apparently leads to NoSuitableGraphicsDeviceException errors when launching SMAPI for some players.
---
 docs/release-notes.md  |  4 ++++
 src/SMAPI/app.manifest | 23 -----------------------
 2 files changed, 4 insertions(+), 23 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index f306607c..a572e6cf 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
+## Upcoming release
+* For players:
+  * Fixed some players with compatible GPUs incorrectly getting `NoSuitableGraphicsDeviceException` errors on launch.
+
 ## 3.16.1
 Released 29 August 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI/app.manifest b/src/SMAPI/app.manifest
index 42faff59..cdddb390 100644
--- a/src/SMAPI/app.manifest
+++ b/src/SMAPI/app.manifest
@@ -9,29 +9,6 @@
         </security>
     </trustInfo>
 
-    <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
-        <application>
-            <!-- A list of the Windows versions that this application has been tested on and is
-           is designed to work with. Uncomment the appropriate elements and Windows will 
-           automatically selected the most compatible environment. -->
-
-            <!-- Windows Vista -->
-            <supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f0}" />
-
-            <!-- Windows 7 -->
-            <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}" />
-
-            <!-- Windows 8 -->
-            <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}" />
-
-            <!-- Windows 8.1 -->
-            <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}" />
-
-            <!-- Windows 10 -->
-            <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
-        </application>
-    </compatibility>
-
     <application xmlns="urn:schemas-microsoft-com:asm.v3">
         <windowsSettings>
             <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/pm</dpiAware>

From 41e95642f004b2bf96b8855a276454260cb5ed0e Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 31 Aug 2022 17:15:58 -0400
Subject: [PATCH 760/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 6 ++++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 1a81a105..7fe66fab 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.16.1</Version>
+    <Version>3.16.2</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index a572e6cf..ab23b46e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,9 +7,11 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.16.2
+Released 31 August 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
-  * Fixed some players with compatible GPUs incorrectly getting `NoSuitableGraphicsDeviceException` errors on launch.
+  * Fixed `NoSuitableGraphicsDeviceException` launch error for some players with compatible GPUs since 3.16.0.
 
 ## 3.16.1
 Released 29 August 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index f3dc8aef..abe8b334 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.16.1",
+    "Version": "3.16.2",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.16.1"
+    "MinimumApiVersion": "3.16.2"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index cbcf0f82..b6764bc0 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.16.1",
+    "Version": "3.16.2",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.16.1"
+    "MinimumApiVersion": "3.16.2"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 5aa092ef..a2657168 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.16.1",
+    "Version": "3.16.2",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.16.1"
+    "MinimumApiVersion": "3.16.2"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 14aaf166..493aebd9 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.16.1";
+        internal static string RawApiVersion = "3.16.2";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From f0e52061e34f3a397dbe1120590d062feb1be0ef Mon Sep 17 00:00:00 2001
From: Tyler <gibbstyler7@gmail.com>
Date: Mon, 5 Sep 2022 13:11:36 -0500
Subject: [PATCH 761/856] fix ComparableListWatcher not removing items in zero
 case

---
 .../StateTracking/FieldWatchers/ComparableListWatcher.cs        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
index 0b13434a..b24f4178 100644
--- a/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
+++ b/src/SMAPI/Framework/StateTracking/FieldWatchers/ComparableListWatcher.cs
@@ -63,7 +63,7 @@ namespace StardewModdingAPI.Framework.StateTracking.FieldWatchers
             {
                 if (this.LastValues.Count > 0)
                 {
-                    this.AddedImpl.AddRange(this.LastValues);
+                    this.RemovedImpl.AddRange(this.LastValues);
                     this.LastValues.Clear();
                 }
                 return;

From 715b9b09bae846e1f199ad2271283940c8fce7bd Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Sun, 18 Sep 2022 12:05:46 -0400
Subject: [PATCH 762/856] Update ModScanner.cs

Add a few more files to the ignored files like .7z
---
 src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index a85ef109..d115810a 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -45,10 +45,14 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             ".png",
             ".psd",
             ".tif",
+            ".xcf", // gimp files
 
             // archives
             ".rar",
             ".zip",
+            ".7z",
+            ".tar",
+            ".tar.gz"
 
             // backup files
             ".backup",

From e8da8fff5163eacd6ae7870eaa8c7dbc8285e3e7 Mon Sep 17 00:00:00 2001
From: Khloe Leclair <xivkhloeleclair@gmail.com>
Date: Mon, 26 Sep 2022 15:18:36 -0400
Subject: [PATCH 763/856] Initial work on a way for mods to return specific API
 instances to specific mods.

---
 .../Framework/ModHelpers/ModRegistryHelper.cs | 53 ++++++++++++++++---
 src/SMAPI/IMod.cs                             |  6 +++
 src/SMAPI/Mod.cs                              |  6 +++
 3 files changed, 59 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 348ba225..9ad3e3ae 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -1,5 +1,7 @@
+using System;
 using System.Collections.Generic;
 using StardewModdingAPI.Framework.Reflection;
+using StardewModdingAPI.Internal;
 
 namespace StardewModdingAPI.Framework.ModHelpers
 {
@@ -15,8 +17,8 @@ namespace StardewModdingAPI.Framework.ModHelpers
         /// <summary>Encapsulates monitoring and logging for the mod.</summary>
         private readonly IMonitor Monitor;
 
-        /// <summary>The mod IDs for APIs accessed by this instanced.</summary>
-        private readonly HashSet<string> AccessedModApis = new();
+        /// <summary>The APIs accessed by this instance.</summary>
+        private readonly Dictionary<string, object?> AccessedModApis = new();
 
         /// <summary>Generates proxy classes to access mod APIs through an arbitrary interface.</summary>
         private readonly IInterfaceProxyFactory ProxyFactory;
@@ -66,11 +68,50 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 return null;
             }
 
-            // get raw API
+            // get our cached API if one is available
             IModMetadata? mod = this.Registry.Get(uniqueID);
-            if (mod?.Api != null && this.AccessedModApis.Add(mod.Manifest.UniqueID))
-                this.Monitor.Log($"Accessed mod-provided API for {mod.DisplayName}.");
-            return mod?.Api;
+            if (mod == null)
+                return null;
+
+            if (this.AccessedModApis.ContainsKey(mod.Manifest.UniqueID))
+            {
+                return this.AccessedModApis[mod.Manifest.UniqueID];
+            }
+
+            object? api;
+
+            // safely request a specific API instance
+            try
+            {
+                api = mod.Mod?.GetApi(this.Mod.Manifest);
+                if (api != null && !api.GetType().IsPublic)
+                {
+                    api = null;
+                    this.Monitor.Log($"{mod.DisplayName} provided a specific API instance with a non-public type. This isn't currently supported, so the specific API won't be available to the requesting mod.", LogLevel.Warn);
+                }
+
+                if (api != null)
+                    this.Monitor.Log($"Accessed specific mod-provided API ({api.GetType().FullName}) for {mod.DisplayName}.");
+            }
+            catch (Exception ex)
+            {
+                this.Monitor.Log($"Failed loading specific mod-provided API for {mod.DisplayName}. Integrations with other mods may not work. Error: {ex.GetLogSummary()}", LogLevel.Error);
+                api = null;
+            }
+
+            // fall back to the generic API instance
+            if (api == null)
+            {
+                api = mod.Api;
+                if (api != null)
+                {
+                    this.Monitor.Log($"Accessed mod-provided API for {mod.DisplayName}.");
+                }
+            }
+
+            // cache the API instance and return it
+            this.AccessedModApis[mod.Manifest.UniqueID] = api;
+            return api;
         }
 
         /// <inheritdoc />
diff --git a/src/SMAPI/IMod.cs b/src/SMAPI/IMod.cs
index b81ba0e3..6041bf66 100644
--- a/src/SMAPI/IMod.cs
+++ b/src/SMAPI/IMod.cs
@@ -25,5 +25,11 @@ namespace StardewModdingAPI
 
         /// <summary>Get an API that other mods can access. This is always called after <see cref="Entry"/>.</summary>
         object? GetApi();
+
+        /// <summary>Get an API that a specific other mod can access. This method is called the first time the other mod calls <see cref="IModRegistry.GetApi(string)"/> for this mod.</summary>
+        /// <param name="manifest">The other mod's manifest.</param>
+        /// <returns>Returns an API for another mod, or <c>null</c> if the other mod should use the general API returned from <see cref="GetApi()"/>.</returns>
+        object? GetApi(IManifest manifest);
+
     }
 }
diff --git a/src/SMAPI/Mod.cs b/src/SMAPI/Mod.cs
index f764752b..1a5f5594 100644
--- a/src/SMAPI/Mod.cs
+++ b/src/SMAPI/Mod.cs
@@ -30,6 +30,12 @@ namespace StardewModdingAPI
             return null;
         }
 
+        /// <inheritdoc />
+        public virtual object? GetApi(IManifest manifest)
+        {
+            return null;
+        }
+
         /// <summary>Release or reset unmanaged resources.</summary>
         public void Dispose()
         {

From c0e31d17a6d3f235c8a251e851c446e00c804cdb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 28 Sep 2022 23:21:12 -0400
Subject: [PATCH 764/856] fix handling of GitHub prerelease versions marked as
 non-prerelease

---
 docs/release-notes.md                          |  4 ++++
 src/SMAPI.Web/Controllers/ModsApiController.cs | 17 +++++++++++++----
 2 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ab23b46e..ea459bcb 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
+## Upcoming release
+* For players:
+  * Fixed update alert shown for a prerelease version on GitHub if it's not marked as prerelease.
+
 ## 3.16.2
 Released 31 August 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Web/Controllers/ModsApiController.cs b/src/SMAPI.Web/Controllers/ModsApiController.cs
index 401bba4f..71fb42c2 100644
--- a/src/SMAPI.Web/Controllers/ModsApiController.cs
+++ b/src/SMAPI.Web/Controllers/ModsApiController.cs
@@ -159,11 +159,20 @@ namespace StardewModdingAPI.Web.Controllers
                     continue;
                 }
 
+                // if there's only a prerelease version (e.g. from GitHub), don't override the main version
+                ISemanticVersion? curMain = data.Version;
+                ISemanticVersion? curPreview = data.PreviewVersion;
+                if (curPreview == null && curMain?.IsPrerelease() == true)
+                {
+                    curPreview = curMain;
+                    curMain = null;
+                }
+
                 // handle versions
-                if (this.IsNewer(data.Version, main?.Version))
-                    main = new ModEntryVersionModel(data.Version, data.Url!);
-                if (this.IsNewer(data.PreviewVersion, optional?.Version))
-                    optional = new ModEntryVersionModel(data.PreviewVersion, data.Url!);
+                if (this.IsNewer(curMain, main?.Version))
+                    main = new ModEntryVersionModel(curMain, data.Url!);
+                if (this.IsNewer(curPreview, optional?.Version))
+                    optional = new ModEntryVersionModel(curPreview, data.Url!);
             }
 
             // get unofficial version

From c6b3446e9cb1d1e02db9db86f143ecfe75e9908c Mon Sep 17 00:00:00 2001
From: pizzaoverhead <pizzaoverhead@gmail.com>
Date: Thu, 29 Sep 2022 13:33:45 +0100
Subject: [PATCH 765/856] Added checking for alternative Steam library install
 locations when looking for the Stardew Valley install.

---
 .../Framework/GameScanning/GameScanner.cs     | 36 ++++++++++++++
 .../GameScanning/SteamLibraryCollection.cs    | 47 +++++++++++++++++++
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj        |  1 +
 3 files changed, 84 insertions(+)
 create mode 100644 src/SMAPI.Toolkit/Framework/GameScanning/SteamLibraryCollection.cs

diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 8e1538a5..8e24dcdf 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -9,6 +9,7 @@ using StardewModdingAPI.Toolkit.Utilities;
 using System.Reflection;
 #if SMAPI_FOR_WINDOWS
 using Microsoft.Win32;
+using VdfParser;
 #endif
 
 namespace StardewModdingAPI.Toolkit.Framework.GameScanning
@@ -158,7 +159,14 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                         // via Steam library path
                         string? steamPath = this.GetCurrentUserRegistryValue(@"Software\Valve\Steam", "SteamPath");
                         if (steamPath != null)
+                        {
                             yield return Path.Combine(steamPath.Replace('/', '\\'), @"steamapps\common\Stardew Valley");
+
+                            // Check for Steam libraries in other locations
+                            string? path = this.GetPathFromSteamLibrary(steamPath);
+                            if (!string.IsNullOrWhiteSpace(path))
+                                yield return path;
+                        }
 #endif
 
                         // default GOG/Steam paths
@@ -243,6 +251,34 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
             using (openKey)
                 return (string?)openKey.GetValue(name);
         }
+
+        /// <summary>Get the game directory path from alternative Steam library locations.</summary>
+        /// <param name="steamPath">The full path to the directory containing steam.exe.</param>
+        /// <returns>The game directory, if found.</returns>
+        private string? GetPathFromSteamLibrary(string? steamPath)
+        {
+            string stardewAppId = "413150";
+            if (steamPath != null)
+            {
+                string? libraryFoldersPath = Path.Combine(steamPath.Replace('/', '\\'), "steamapps\\libraryfolders.vdf");
+                using FileStream fs = File.OpenRead(libraryFoldersPath);
+                VdfDeserializer deserializer = new VdfDeserializer();
+                SteamLibraryCollection libraries = deserializer.Deserialize<SteamLibraryCollection>(fs);
+                if (libraries.libraryfolders != null)
+                {
+                    var stardewLibrary = libraries.libraryfolders.FirstOrDefault(f =>
+                    {
+                        var apps = f.Value?.apps;
+                        return apps != null && apps.Any(a => a.Key.Equals(stardewAppId));
+                    });
+                    if (stardewLibrary.Value?.path != null)
+                    {
+                        return Path.Combine(stardewLibrary.Value.path.Replace("\\\\", "\\"), @"steamapps\common\Stardew Valley");
+                    }
+                }
+            }
+            return null;
+        }
 #endif
     }
 }
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/SteamLibraryCollection.cs b/src/SMAPI.Toolkit/Framework/GameScanning/SteamLibraryCollection.cs
new file mode 100644
index 00000000..7a186f69
--- /dev/null
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/SteamLibraryCollection.cs
@@ -0,0 +1,47 @@
+#if SMAPI_FOR_WINDOWS
+using System.Collections.Generic;
+
+namespace StardewModdingAPI.Toolkit.Framework.GameScanning
+{
+#pragma warning disable IDE1006 // Model requires lowercase naming.
+#pragma warning disable CS8618 // Required for model.
+    /// <summary>Model for Steam's libraryfolders.vdf.</summary>
+    public class SteamLibraryCollection
+    {
+        /// <summary>Each entry identifies a different location that part of the Steam games library is installed to.</summary>
+        public LibraryFolders<int, LibraryFolder> libraryfolders { get; set; }
+    }
+
+    /// <summary>A collection of LibraryFolders. Like a dictionary, but has contentstatsid used as an index also.</summary>
+    /// <typeparam name="TKey"></typeparam>
+    /// <typeparam name="TValue"></typeparam>
+#pragma warning disable CS8714 // Required for model.
+    public class LibraryFolders<TKey, TValue> : Dictionary<TKey, TValue>
+#pragma warning restore CS8714
+    {
+        /// <summary>Index of the library, starting from "0".</summary>
+        public string contentstatsid { get; set; }
+    }
+
+    /// <summary>A Steam library folder, containing information on the location and size of games installed there.</summary>
+    public class LibraryFolder
+    {
+        /// <summary>The escaped path to this Steam library folder. There will be a steam.exe here, but this may not be the one the player generally launches.</summary>
+        public string path { get; set; }
+        /// <summary>Label for the library, or ""</summary>
+        public string label { get; set; }
+        /// <summary>~19-digit identifier.</summary>
+        public string contentid { get; set; }
+        /// <summary>Size of the library in bytes. May show 0 when size is non-zero.</summary>
+        public string totalsize { get; set; }
+        /// <summary>Used for downloads.</summary>
+        public string update_clean_bytes_tally { get; set; }
+        /// <summary>Normally "0".</summary>
+        public string time_last_update_corruption { get; set; }
+        /// <summary>List of Steam app IDs, and their current size in bytes.</summary>
+        public Dictionary<string, string> apps { get; set; }
+    }
+#pragma warning restore IDE1006
+#pragma warning restore CS8618
+}
+#endif
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 7b79105f..411fd469 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -14,6 +14,7 @@
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
     <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
     <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
+    <PackageReference Include="VdfConverter" Version="1.0.3" />
   </ItemGroup>
 
   <ItemGroup>

From 2c2542657890d896750384bbaa2cb765379bad06 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 7 Oct 2022 00:16:00 -0400
Subject: [PATCH 766/856] fix issues with BundleExtraAssemblies

---
 docs/technical/mod-package.md                |  2 ++
 src/SMAPI.ModBuildConfig/build/smapi.targets | 20 ++++++++++++--------
 2 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index ca78be55..c483754e 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -414,6 +414,8 @@ when you compile it.
 ## Release notes
 ### Upcoming release
 * Switched to the newer crossplatform `portable` debug symbols (thanks to lanturnalis!).
+* Fixed `BundleExtraAssemblies` option being partly case-sensitive.
+* Fixed `BundleExtraAssemblies` not applying `All` value to game assemblies.
 
 ### 4.0.1
 Released 14 April 2022.
diff --git a/src/SMAPI.ModBuildConfig/build/smapi.targets b/src/SMAPI.ModBuildConfig/build/smapi.targets
index 12619439..b4fd312e 100644
--- a/src/SMAPI.ModBuildConfig/build/smapi.targets
+++ b/src/SMAPI.ModBuildConfig/build/smapi.targets
@@ -27,8 +27,12 @@
     <EnableGameDebugging Condition="'$(EnableGameDebugging)' == ''">true</EnableGameDebugging>
     <BundleExtraAssemblies Condition="'$(BundleExtraAssemblies)' == ''"></BundleExtraAssemblies>
 
+    <!-- simplify conditions -->
+    <_BundleExtraAssembliesForGame>$([System.Text.RegularExpressions.Regex]::IsMatch('$(BundleExtraAssemblies)', '\bGame|All\b', RegexOptions.IgnoreCase))</_BundleExtraAssembliesForGame>
+    <_BundleExtraAssembliesForAny>$([System.Text.RegularExpressions.Regex]::IsMatch('$(BundleExtraAssemblies)', '\bGame|System|ThirdParty|All\b', RegexOptions.IgnoreCase))</_BundleExtraAssembliesForAny>
+
     <!-- coppy referenced DLLs into build output -->
-    <CopyLocalLockFileAssemblies Condition="$(BundleExtraAssemblies.Contains('ThirdParty')) OR $(BundleExtraAssemblies.Contains('Game')) OR $(BundleExtraAssemblies.Contains('System')) OR $(BundleExtraAssemblies.Contains('All'))">true</CopyLocalLockFileAssemblies>
+    <CopyLocalLockFileAssemblies Condition="$(_BundleExtraAssembliesForAny)">true</CopyLocalLockFileAssemblies>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(OS)' == 'Windows_NT' AND '$(EnableGameDebugging)' == 'true'">
@@ -44,17 +48,17 @@
   **********************************************-->
   <ItemGroup>
     <!-- game -->
-    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
-    <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
-    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
-    <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
+    <Reference Include="Stardew Valley" HintPath="$(GamePath)\Stardew Valley.dll" Private="$(_BundleExtraAssembliesForGame)" />
+    <Reference Include="StardewValley.GameData" HintPath="$(GamePath)\StardewValley.GameData.dll" Private="$(_BundleExtraAssembliesForGame)" />
+    <Reference Include="MonoGame.Framework" HintPath="$(GamePath)\MonoGame.Framework.dll" Private="$(_BundleExtraAssembliesForGame)" />
+    <Reference Include="xTile" HintPath="$(GamePath)\xTile.dll" Private="$(_BundleExtraAssembliesForGame)" />
 
     <!-- SMAPI -->
-    <Reference Include="StardewModdingAPI" HintPath="$(GamePath)\StardewModdingAPI.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
-    <Reference Include="SMAPI.Toolkit.CoreInterfaces" HintPath="$(GamePath)\smapi-internal\SMAPI.Toolkit.CoreInterfaces.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
+    <Reference Include="StardewModdingAPI" HintPath="$(GamePath)\StardewModdingAPI.dll" Private="$(_BundleExtraAssembliesForGame)" />
+    <Reference Include="SMAPI.Toolkit.CoreInterfaces" HintPath="$(GamePath)\smapi-internal\SMAPI.Toolkit.CoreInterfaces.dll" Private="$(_BundleExtraAssembliesForGame)" />
 
     <!-- Harmony -->
-    <Reference Include="0Harmony" Condition="'$(EnableHarmony)' == 'true'" HintPath="$(GamePath)\smapi-internal\0Harmony.dll" Private="$(BundleExtraAssemblies.Contains('Game'))" />
+    <Reference Include="0Harmony" Condition="'$(EnableHarmony)' == 'true'" HintPath="$(GamePath)\smapi-internal\0Harmony.dll" Private="$(_BundleExtraAssembliesForGame)" />
   </ItemGroup>
 
 

From 5a0d337fcf6d18eed55334361b3eef3021912498 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 7 Oct 2022 00:21:09 -0400
Subject: [PATCH 767/856] update FluentHttpClient

---
 docs/release-notes.md                  | 3 +++
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj | 2 +-
 src/SMAPI.Web/SMAPI.Web.csproj         | 2 +-
 src/SMAPI/SMAPI.csproj                 | 2 +-
 4 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ea459bcb..04874729 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,9 @@
 * For players:
   * Fixed update alert shown for a prerelease version on GitHub if it's not marked as prerelease.
 
+* For mod authors:
+  * Updated to [FluentHttpClient](https://github.com/Pathoschild/FluentHttpClient#readme) 4.2.0 (see [changes](https://github.com/Pathoschild/FluentHttpClient/blob/develop/RELEASE-NOTES.md#420)).
+
 ## 3.16.2
 Released 31 August 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 7b79105f..bd4f4e3d 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -11,7 +11,7 @@
   <ItemGroup>
     <PackageReference Include="HtmlAgilityPack" Version="1.11.43" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
+    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.2.0" />
     <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
     <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
   </ItemGroup>
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index d26cb6f8..81b187fe 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -25,7 +25,7 @@
     <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="6.0.5" />
     <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.14" />
     <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.5" />
-    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
+    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.2.0" />
   </ItemGroup>
   <ItemGroup>
     <DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="1.0.1" />
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index 36db0545..e5d8937c 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -26,7 +26,7 @@
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="22.3.5.1" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
-    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
+    <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.2.0" />
     <PackageReference Include="Pintail" Version="2.2.1" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />

From a7f03abe25128dba78d8c22802370a3f9a8aff11 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 8 Oct 2022 13:16:38 -0400
Subject: [PATCH 768/856] change square brackets to round ones in manifest name

---
 docs/release-notes.md                         |  1 +
 .../Serialization/Models/Manifest.cs          | 53 +++++++++++++++----
 2 files changed, 43 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 04874729..4875d1cd 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,6 +12,7 @@
   * Fixed update alert shown for a prerelease version on GitHub if it's not marked as prerelease.
 
 * For mod authors:
+  * SMAPI now treats square brackets in the manifest `Name` field as round brackets, to avoid breaking tools which parse log files.
   * Updated to [FluentHttpClient](https://github.com/Pathoschild/FluentHttpClient#readme) 4.2.0 (see [changes](https://github.com/Pathoschild/FluentHttpClient/blob/develop/RELEASE-NOTES.md#420)).
 
 ## 3.16.2
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index da3ad608..8a449f0a 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
+using System.Text;
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Converters;
 
@@ -90,13 +91,13 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         [JsonConstructor]
         public Manifest(string uniqueId, string name, string author, string description, ISemanticVersion version, ISemanticVersion? minimumApiVersion, string? entryDll, IManifestContentPackFor? contentPackFor, IManifestDependency[]? dependencies, string[]? updateKeys)
         {
-            this.UniqueID = this.NormalizeWhitespace(uniqueId);
-            this.Name = this.NormalizeWhitespace(name);
-            this.Author = this.NormalizeWhitespace(author);
-            this.Description = this.NormalizeWhitespace(description);
+            this.UniqueID = this.NormalizeField(uniqueId);
+            this.Name = this.NormalizeField(name, replaceSquareBrackets: true);
+            this.Author = this.NormalizeField(author);
+            this.Description = this.NormalizeField(description);
             this.Version = version;
             this.MinimumApiVersion = minimumApiVersion;
-            this.EntryDll = this.NormalizeWhitespace(entryDll);
+            this.EntryDll = this.NormalizeField(entryDll);
             this.ContentPackFor = contentPackFor;
             this.Dependencies = dependencies ?? Array.Empty<IManifestDependency>();
             this.UpdateKeys = updateKeys ?? Array.Empty<string>();
@@ -113,17 +114,47 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
         /*********
         ** Private methods
         *********/
-        /// <summary>Normalize whitespace in a raw string.</summary>
+        /// <summary>Normalize a manifest field to strip newlines, trim whitespace, and optionally strip square brackets.</summary>
         /// <param name="input">The input to strip.</param>
+        /// <param name="replaceSquareBrackets">Whether to replace square brackets with round ones. This is used in the mod name to avoid breaking the log format.</param>
 #if NET5_0_OR_GREATER
         [return: NotNullIfNotNull("input")]
 #endif
-        private string? NormalizeWhitespace(string? input)
+        private string? NormalizeField(string? input, bool replaceSquareBrackets = false)
         {
-            return input
-                ?.Trim()
-                .Replace("\r", "")
-                .Replace("\n", "");
+            input = input?.Trim();
+
+            if (!string.IsNullOrEmpty(input))
+            {
+                StringBuilder? builder = null;
+
+                for (int i = 0; i < input.Length; i++)
+                {
+                    switch (input[i])
+                    {
+                        case '\r':
+                        case '\n':
+                            builder ??= new StringBuilder(input);
+                            builder[i] = ' ';
+                            break;
+
+                        case '[' when replaceSquareBrackets:
+                            builder ??= new StringBuilder(input);
+                            builder[i] = '(';
+                            break;
+
+                        case ']' when replaceSquareBrackets:
+                            builder ??= new StringBuilder(input);
+                            builder[i] = ')';
+                            break;
+                    }
+                }
+
+                if (builder != null)
+                    input = builder.ToString();
+            }
+
+            return input;
         }
     }
 }

From 7c90385d8df7bbf9469fc468480b26ebb134abd8 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Mon, 15 Aug 2022 19:13:24 -0400
Subject: [PATCH 769/856] Pre-calculate the strings for log levels.

---
 src/SMAPI/Framework/Monitor.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/Monitor.cs b/src/SMAPI/Framework/Monitor.cs
index 6b53daff..8ba175e6 100644
--- a/src/SMAPI/Framework/Monitor.cs
+++ b/src/SMAPI/Framework/Monitor.cs
@@ -25,7 +25,9 @@ namespace StardewModdingAPI.Framework
         private readonly LogFileManager LogFile;
 
         /// <summary>The maximum length of the <see cref="LogLevel"/> values.</summary>
-        private static readonly int MaxLevelLength = (from level in Enum.GetValues(typeof(LogLevel)).Cast<LogLevel>() select level.ToString().Length).Max();
+        private static readonly int MaxLevelLength = (from level in Enum.GetValues<LogLevel>() select level.ToString().Length).Max();
+
+        private static readonly Dictionary<ConsoleLogLevel, string> LogStrings = Enum.GetValues<ConsoleLogLevel>().ToDictionary(k => k, v => v.ToString().ToUpper().PadRight(MaxLevelLength));
 
         /// <summary>A cache of messages that should only be logged once.</summary>
         private readonly HashSet<string> LogOnceCache = new();
@@ -147,7 +149,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="level">The log level.</param>
         private string GenerateMessagePrefix(string source, ConsoleLogLevel level)
         {
-            string levelStr = level.ToString().ToUpper().PadRight(Monitor.MaxLevelLength);
+            string levelStr = LogStrings[level];
             int? playerIndex = this.GetScreenIdForLog();
 
             return $"[{DateTime.Now:HH:mm:ss} {levelStr}{(playerIndex != null ? $" screen_{playerIndex}" : "")} {source}]";

From 78643710ce09197dbb5505fd8cc2361c8ada0830 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Mon, 15 Aug 2022 19:13:39 -0400
Subject: [PATCH 770/856] Use array pools in editing images.

---
 .../Framework/Content/AssetDataForImage.cs    | 43 ++++++++++++-------
 1 file changed, 28 insertions(+), 15 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 3393b22f..98d6725a 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Buffers;
 using System.Diagnostics.CodeAnalysis;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
@@ -47,44 +48,55 @@ namespace StardewModdingAPI.Framework.Content
                 int areaHeight = sourceArea.Value.Height;
 
                 if (areaX == 0 && areaY == 0 && areaWidth == source.Width && areaHeight == source.Height)
+                {
                     sourceData = source.Data;
+                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+                }
                 else
                 {
-                    sourceData = new Color[areaWidth * areaHeight];
-                    int i = 0;
-                    for (int y = areaY, maxY = areaY + areaHeight - 1; y <= maxY; y++)
+                    int pixelCount = areaWidth * areaHeight;
+                    sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
+
+                    for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
                     {
-                        for (int x = areaX, maxX = areaX + areaWidth - 1; x <= maxX; x++)
-                        {
-                            int targetIndex = (y * source.Width) + x;
-                            sourceData[i++] = source.Data[targetIndex];
-                        }
+                        // avoiding an variable that increments allows the processor to re-arrange here.
+                        int sourceIndex = (y * source.Width) + areaX;
+                        int targetIndex = (y - areaY) * areaWidth;
+                        Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
                     }
+
+                    // apply
+                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+
+                    // return
+                    ArrayPool<Color>.Shared.Return(sourceData);
                 }
             }
-
-            // apply
-            this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
         }
 
         /// <inheritdoc />
         public void PatchImage(Texture2D source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace)
         {
+            // validate
+            if (source == null)
+                throw new ArgumentNullException(nameof(source), "Can't patch from a null source texture.");
+
             this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
 
             // validate source texture
-            if (source == null)
-                throw new ArgumentNullException(nameof(source), "Can't patch from a null source texture.");
             if (!source.Bounds.Contains(sourceArea.Value))
                 throw new ArgumentOutOfRangeException(nameof(sourceArea), "The source area is outside the bounds of the source texture.");
 
             // get source data
             int pixelCount = sourceArea.Value.Width * sourceArea.Value.Height;
-            Color[] sourceData = GC.AllocateUninitializedArray<Color>(pixelCount);
+            Color[] sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
             source.GetData(0, sourceArea, sourceData, 0, pixelCount);
 
             // apply
             this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+
+            // return
+            ArrayPool<Color>.Shared.Return(sourceData);
         }
 
         /// <inheritdoc />
@@ -143,7 +155,7 @@ namespace StardewModdingAPI.Framework.Content
             if (patchMode == PatchMode.Overlay)
             {
                 // get target data
-                Color[] mergedData = GC.AllocateUninitializedArray<Color>(pixelCount);
+                Color[] mergedData = ArrayPool<Color>.Shared.Rent(pixelCount);
                 target.GetData(0, targetArea, mergedData, 0, pixelCount);
 
                 // merge pixels
@@ -175,6 +187,7 @@ namespace StardewModdingAPI.Framework.Content
                 }
 
                 target.SetData(0, targetArea, mergedData, 0, pixelCount);
+                ArrayPool<Color>.Shared.Return(mergedData);
             }
             else
                 target.SetData(0, targetArea, sourceData, 0, pixelCount);

From 4a1055e573e9d8b0aa654238889596be07c29193 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Tue, 16 Aug 2022 15:30:21 -0400
Subject: [PATCH 771/856] arraypool in the modcontentmanager, a bit of fussing

---
 .../Framework/Content/AssetDataForImage.cs    | 15 ++++---
 .../ContentManagers/ModContentManager.cs      | 40 ++++++++++++-------
 .../Framework/ModLoading/AssemblyLoader.cs    |  2 +-
 src/SMAPI/Framework/Monitor.cs                |  7 +++-
 4 files changed, 38 insertions(+), 26 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 98d6725a..46c2a22e 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -33,12 +33,12 @@ namespace StardewModdingAPI.Framework.Content
         /// <inheritdoc />
         public void PatchImage(IRawTextureData source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace)
         {
-            this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
-
-            // validate source data
+            // nullcheck
             if (source == null)
                 throw new ArgumentNullException(nameof(source), "Can't patch from null source data.");
 
+            this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
+
             // get the pixels for the source area
             Color[] sourceData;
             {
@@ -59,7 +59,6 @@ namespace StardewModdingAPI.Framework.Content
 
                     for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
                     {
-                        // avoiding an variable that increments allows the processor to re-arrange here.
                         int sourceIndex = (y * source.Width) + areaX;
                         int targetIndex = (y - areaY) * areaWidth;
                         Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
@@ -77,13 +76,13 @@ namespace StardewModdingAPI.Framework.Content
         /// <inheritdoc />
         public void PatchImage(Texture2D source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace)
         {
-            // validate
+            // nullcheck
             if (source == null)
                 throw new ArgumentNullException(nameof(source), "Can't patch from a null source texture.");
 
             this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
 
-            // validate source texture
+            // validate source bounds
             if (!source.Bounds.Contains(sourceArea.Value))
                 throw new ArgumentOutOfRangeException(nameof(sourceArea), "The source area is outside the bounds of the source texture.");
 
@@ -161,8 +160,8 @@ namespace StardewModdingAPI.Framework.Content
                 // merge pixels
                 for (int i = 0; i < pixelCount; i++)
                 {
-                    Color above = sourceData[i];
-                    Color below = mergedData[i];
+                    ref Color above = ref sourceData[i];
+                    ref Color below = ref mergedData[i];
 
                     // shortcut transparency
                     if (above.A < MinOpacity)
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index cc6f8372..dd30c225 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -1,9 +1,11 @@
 using System;
+using System.Buffers;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
 using System.IO;
 using System.Linq;
+using System.Runtime.CompilerServices;
 using BmFont;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Content;
@@ -111,7 +113,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (this.Coordinator.TryParseManagedAssetKey(assetName.Name, out string? contentManagerID, out IAssetName? relativePath))
                 {
                     if (contentManagerID != this.Name)
-                        throw this.GetLoadError(assetName, ContentLoadErrorType.AccessDenied, "can't load a different mod's managed asset key through this mod content manager.");
+                        this.ThrowLoadError(assetName, ContentLoadErrorType.AccessDenied, "can't load a different mod's managed asset key through this mod content manager.");
                     assetName = relativePath;
                 }
             }
@@ -123,7 +125,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 // get file
                 FileInfo file = this.GetModFile<T>(assetName.Name);
                 if (!file.Exists)
-                    throw this.GetLoadError(assetName, ContentLoadErrorType.AssetDoesNotExist, "the specified path doesn't exist.");
+                    this.ThrowLoadError(assetName, ContentLoadErrorType.AssetDoesNotExist, "the specified path doesn't exist.");
 
                 // load content
                 asset = file.Extension.ToLower() switch
@@ -141,7 +143,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 if (ex is SContentLoadException)
                     throw;
 
-                throw this.GetLoadError(assetName, ContentLoadErrorType.Other, "an unexpected error occurred.", ex);
+                this.ThrowLoadError(assetName, ContentLoadErrorType.Other, "an unexpected error occurred.", ex);
+                return default;
             }
 
             // track & return asset
@@ -189,7 +192,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadDataFile<T>(IAssetName assetName, FileInfo file)
         {
             if (!this.JsonHelper.ReadJsonFileIfExists(file.FullName, out T? asset))
-                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, "the JSON file is invalid."); // should never happen since we check for file existence before calling this method
+                this.ThrowLoadError(assetName, ContentLoadErrorType.InvalidData, "the JSON file is invalid."); // should never happen since we check for file existence before calling this method
 
             return asset;
         }
@@ -301,7 +304,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadXnbFile<T>(IAssetName assetName)
         {
             if (typeof(IRawTextureData).IsAssignableFrom(typeof(T)))
-                throw this.GetLoadError(assetName, ContentLoadErrorType.Other, $"can't read XNB file as type {typeof(IRawTextureData)}; that type can only be read from a PNG file.");
+                this.ThrowLoadError(assetName, ContentLoadErrorType.Other, $"can't read XNB file as type {typeof(IRawTextureData)}; that type can only be read from a PNG file.");
 
             // the underlying content manager adds a .xnb extension implicitly, so
             // we need to strip it here to avoid trying to load a '.xnb.xnb' file.
@@ -326,7 +329,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="file">The file to load.</param>
         private T HandleUnknownFileType<T>(IAssetName assetName, FileInfo file)
         {
-            throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidName, $"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'.");
+            this.ThrowLoadError(assetName, ContentLoadErrorType.InvalidName, $"unknown file extension '{file.Extension}'; must be one of '.fnt', '.json', '.png', '.tbin', '.tmx', or '.xnb'.");
+            return default;
         }
 
         /// <summary>Assert that the asset type is compatible with one of the allowed types.</summary>
@@ -338,18 +342,20 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private void AssertValidType<TAsset>(IAssetName assetName, FileInfo file, params Type[] validTypes)
         {
             if (!validTypes.Any(validType => validType.IsAssignableFrom(typeof(TAsset))))
-                throw this.GetLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(TAsset)}'; must be type '{string.Join("' or '", validTypes.Select(p => p.FullName))}'.");
+                this.ThrowLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(TAsset)}'; must be type '{string.Join("' or '", validTypes.Select(p => p.FullName))}'.");
         }
 
-        /// <summary>Get an error which indicates that an asset couldn't be loaded.</summary>
+        /// <summary>Throws an error which indicates that an asset couldn't be loaded.</summary>
         /// <param name="errorType">Why loading an asset through the content pipeline failed.</param>
         /// <param name="assetName">The asset name that failed to load.</param>
         /// <param name="reasonPhrase">The reason the file couldn't be loaded.</param>
         /// <param name="exception">The underlying exception, if applicable.</param>
+        [DoesNotReturn]
         [DebuggerStepThrough, DebuggerHidden]
-        private SContentLoadException GetLoadError(IAssetName assetName, ContentLoadErrorType errorType, string reasonPhrase, Exception? exception = null)
+        [MethodImpl(MethodImplOptions.NoInlining)]
+        private void ThrowLoadError(IAssetName assetName, ContentLoadErrorType errorType, string reasonPhrase, Exception? exception = null)
         {
-            return new(errorType, $"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);
+            throw new SContentLoadException(errorType, $"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);
         }
 
         /// <summary>Get a file from the mod folder.</summary>
@@ -384,12 +390,14 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private Texture2D PremultiplyTransparency(Texture2D texture)
         {
             // premultiply pixels
-            Color[] data = GC.AllocateUninitializedArray<Color>(texture.Width * texture.Height);
-            texture.GetData(data);
+            int count = texture.Width * texture.Height;
+            Color[] data = ArrayPool<Color>.Shared.Rent(count);
+            texture.GetData(data, 0, count);
+
             bool changed = false;
-            for (int i = 0; i < data.Length; i++)
+            for (int i = 0; i < count; i++)
             {
-                Color pixel = data[i];
+                ref Color pixel = ref data[i];
                 if (pixel.A is (byte.MinValue or byte.MaxValue))
                     continue; // no need to change fully transparent/opaque pixels
 
@@ -398,8 +406,10 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
 
             if (changed)
-                texture.SetData(data);
+                texture.SetData(data, 0, count);
 
+            // return
+            ArrayPool<Color>.Shared.Return(data);
             return texture;
         }
 
diff --git a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
index 01037870..ae08d972 100644
--- a/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
+++ b/src/SMAPI/Framework/ModLoading/AssemblyLoader.cs
@@ -221,7 +221,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// </remarks>
         public static Assembly? ResolveAssembly(string name)
         {
-            string shortName = name.Split(new[] { ',' }, 2).First(); // get simple name (without version and culture)
+            string shortName = name.Split(',', 2).First(); // get simple name (without version and culture)
             return AppDomain.CurrentDomain
                 .GetAssemblies()
                 .FirstOrDefault(p => p.GetName().Name == shortName);
diff --git a/src/SMAPI/Framework/Monitor.cs b/src/SMAPI/Framework/Monitor.cs
index 8ba175e6..d33bf259 100644
--- a/src/SMAPI/Framework/Monitor.cs
+++ b/src/SMAPI/Framework/Monitor.cs
@@ -27,10 +27,13 @@ namespace StardewModdingAPI.Framework
         /// <summary>The maximum length of the <see cref="LogLevel"/> values.</summary>
         private static readonly int MaxLevelLength = (from level in Enum.GetValues<LogLevel>() select level.ToString().Length).Max();
 
+        /// <summary>A mapping of console log levels to their string form.</summary>
         private static readonly Dictionary<ConsoleLogLevel, string> LogStrings = Enum.GetValues<ConsoleLogLevel>().ToDictionary(k => k, v => v.ToString().ToUpper().PadRight(MaxLevelLength));
 
+        private readonly record struct LogOnceCacheEntry(string message, LogLevel level);
+
         /// <summary>A cache of messages that should only be logged once.</summary>
-        private readonly HashSet<string> LogOnceCache = new();
+        private readonly HashSet<LogOnceCacheEntry> LogOnceCache = new();
 
         /// <summary>Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</summary>
         private readonly Func<int?> GetScreenIdForLog;
@@ -86,7 +89,7 @@ namespace StardewModdingAPI.Framework
         /// <inheritdoc />
         public void LogOnce(string message, LogLevel level = LogLevel.Trace)
         {
-            if (this.LogOnceCache.Add($"{message}|{level}"))
+            if (this.LogOnceCache.Add(new LogOnceCacheEntry(message, level)))
                 this.LogImpl(this.Source, message, (ConsoleLogLevel)level);
         }
 

From 581763c36392e28ed6e05690ff84b66da5882e78 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Tue, 16 Aug 2022 16:46:10 -0400
Subject: [PATCH 772/856] Skip math if above is fully opaque.

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 46c2a22e..ea04f57a 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -160,13 +160,13 @@ namespace StardewModdingAPI.Framework.Content
                 // merge pixels
                 for (int i = 0; i < pixelCount; i++)
                 {
-                    ref Color above = ref sourceData[i];
-                    ref Color below = ref mergedData[i];
+                    Color above = sourceData[i];
+                    Color below = mergedData[i];
 
                     // shortcut transparency
                     if (above.A < MinOpacity)
                         continue;
-                    if (below.A < MinOpacity)
+                    if (below.A < MinOpacity || above.A == byte.MaxValue)
                         mergedData[i] = above;
 
                     // merge pixels

From 0a2a1a08def3d97f21b4138d9e39c563389b492a Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Tue, 16 Aug 2022 19:30:20 -0400
Subject: [PATCH 773/856] Favor record structs when there are four or fewer
 elements.

---
 .../Framework/Content/AssetDataForImage.cs    | 41 +++++++++++++------
 .../Framework/Content/AssetEditOperation.cs   |  2 +-
 .../Framework/Content/AssetLoadOperation.cs   |  2 +-
 .../ContentManagers/GameContentManager.cs     |  4 +-
 4 files changed, 33 insertions(+), 16 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index ea04f57a..5016bcd4 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -40,7 +40,7 @@ namespace StardewModdingAPI.Framework.Content
             this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
 
             // get the pixels for the source area
-            Color[] sourceData;
+            Color[] trimmedSourceData;
             {
                 int areaX = sourceArea.Value.X;
                 int areaY = sourceArea.Value.Y;
@@ -49,26 +49,42 @@ namespace StardewModdingAPI.Framework.Content
 
                 if (areaX == 0 && areaY == 0 && areaWidth == source.Width && areaHeight == source.Height)
                 {
-                    sourceData = source.Data;
-                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+                    trimmedSourceData = source.Data;
+                    this.PatchImageImpl(trimmedSourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
                 }
                 else
                 {
                     int pixelCount = areaWidth * areaHeight;
-                    sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
+                    trimmedSourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
 
-                    for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
+                    // shortcut! If I want a horizontal slice of the texture
+                    // I can copy the whole array in one pass
+                    // Likely ~uncommon but Array.Copy significantly benefits
+                    // from being able to do this.
+                    if (areaWidth == source.Width && areaX == 0)
                     {
-                        int sourceIndex = (y * source.Width) + areaX;
-                        int targetIndex = (y - areaY) * areaWidth;
-                        Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
+                        int sourceIndex = areaY * source.Width;
+                        int targetIndex = 0;
+
+                        Array.Copy(source.Data, sourceIndex, trimmedSourceData, targetIndex, pixelCount);
+                    }
+                    else
+                    {
+                        // copying line-by-line
+                        // Array.Copy isn't great at small scale
+                        for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
+                        {
+                            int sourceIndex = (y * source.Width) + areaX;
+                            int targetIndex = (y - areaY) * areaWidth;
+                            Array.Copy(source.Data, sourceIndex, trimmedSourceData, targetIndex, areaWidth);
+                        }
                     }
 
                     // apply
-                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+                    this.PatchImageImpl(trimmedSourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
 
                     // return
-                    ArrayPool<Color>.Shared.Return(sourceData);
+                    ArrayPool<Color>.Shared.Return(trimmedSourceData);
                 }
             }
         }
@@ -160,8 +176,9 @@ namespace StardewModdingAPI.Framework.Content
                 // merge pixels
                 for (int i = 0; i < pixelCount; i++)
                 {
-                    Color above = sourceData[i];
-                    Color below = mergedData[i];
+                    // should probably benchmark this...
+                    ref Color above = ref sourceData[i];
+                    ref Color below = ref mergedData[i];
 
                     // shortcut transparency
                     if (above.A < MinOpacity)
diff --git a/src/SMAPI/Framework/Content/AssetEditOperation.cs b/src/SMAPI/Framework/Content/AssetEditOperation.cs
index 11b8811b..893f59bd 100644
--- a/src/SMAPI/Framework/Content/AssetEditOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetEditOperation.cs
@@ -8,5 +8,5 @@ namespace StardewModdingAPI.Framework.Content
     /// <param name="Priority">If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</param>
     /// <param name="OnBehalfOf">The content pack on whose behalf the edit is being applied, if any.</param>
     /// <param name="ApplyEdit">Apply the edit to an asset.</param>
-    internal record AssetEditOperation(IModMetadata Mod, AssetEditPriority Priority, IModMetadata? OnBehalfOf, Action<IAssetData> ApplyEdit);
+    internal readonly record struct AssetEditOperation(IModMetadata Mod, AssetEditPriority Priority, IModMetadata? OnBehalfOf, Action<IAssetData> ApplyEdit);
 }
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
index 7af07dfd..58886849 100644
--- a/src/SMAPI/Framework/Content/AssetLoadOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -8,5 +8,5 @@ namespace StardewModdingAPI.Framework.Content
     /// <param name="Priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
     /// <param name="OnBehalfOf">The content pack on whose behalf the asset is being loaded, if any.</param>
     /// <param name="GetData">Load the initial value for an asset.</param>
-    internal record AssetLoadOperation(IModMetadata Mod, IModMetadata? OnBehalfOf, AssetLoadPriority Priority, Func<IAssetInfo, object> GetData);
+    internal readonly record struct AssetLoadOperation(IModMetadata Mod, IModMetadata? OnBehalfOf, AssetLoadPriority Priority, Func<IAssetInfo, object> GetData);
 }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index df7bdc59..a8c70356 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -172,7 +172,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             where T : notnull
         {
             // find matching loader
-            AssetLoadOperation? loader = null;
+            AssetLoadOperation loader = default;
             if (loadOperations?.Count > 0)
             {
                 if (!this.AssertMaxOneRequiredLoader(info, loadOperations, out string? error))
@@ -183,7 +183,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
                 loader = loadOperations.OrderByDescending(p => p.Priority).FirstOrDefault();
             }
-            if (loader == null)
+            if (loader.Mod == null) // aka, this is default.
                 return null;
 
             // fetch asset from loader

From 627100509c0a9c637b495473ef71f13093e885d2 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Wed, 17 Aug 2022 21:11:47 -0400
Subject: [PATCH 774/856] hide throwhelper from stack trace in dotnet 6

---
 src/SMAPI/Framework/ContentManagers/ModContentManager.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index dd30c225..0c793808 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -353,6 +353,9 @@ namespace StardewModdingAPI.Framework.ContentManagers
         [DoesNotReturn]
         [DebuggerStepThrough, DebuggerHidden]
         [MethodImpl(MethodImplOptions.NoInlining)]
+#if NET6_0_OR_GREATER
+        [StackTraceHidden]
+#endif
         private void ThrowLoadError(IAssetName assetName, ContentLoadErrorType errorType, string reasonPhrase, Exception? exception = null)
         {
             throw new SContentLoadException(errorType, $"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);

From d29c01b8155a6fe2607066da6f0a5cfb45b28d3c Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Thu, 18 Aug 2022 20:51:45 -0400
Subject: [PATCH 775/856] Partially revert "Favor record structs when there are
 four or fewer elements."

This reverts commit f5d49515c4eddfb415903a89d70654cf9b6de299.
---
 .../Framework/Content/AssetDataForImage.cs    | 38 +++++++++----------
 .../Framework/Content/AssetEditOperation.cs   |  2 +-
 .../Framework/Content/AssetLoadOperation.cs   |  2 +-
 .../ContentManagers/GameContentManager.cs     |  4 +-
 4 files changed, 22 insertions(+), 24 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 5016bcd4..5f175217 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -40,7 +40,7 @@ namespace StardewModdingAPI.Framework.Content
             this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
 
             // get the pixels for the source area
-            Color[] trimmedSourceData;
+            Color[] sourceData;
             {
                 int areaX = sourceArea.Value.X;
                 int areaY = sourceArea.Value.Y;
@@ -49,42 +49,40 @@ namespace StardewModdingAPI.Framework.Content
 
                 if (areaX == 0 && areaY == 0 && areaWidth == source.Width && areaHeight == source.Height)
                 {
-                    trimmedSourceData = source.Data;
-                    this.PatchImageImpl(trimmedSourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+                    sourceData = source.Data;
+                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
                 }
                 else
                 {
                     int pixelCount = areaWidth * areaHeight;
-                    trimmedSourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
+                    sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
 
-                    // shortcut! If I want a horizontal slice of the texture
-                    // I can copy the whole array in one pass
-                    // Likely ~uncommon but Array.Copy significantly benefits
-                    // from being able to do this.
-                    if (areaWidth == source.Width && areaX == 0)
+                    if (areaX == 0 && areaWidth == source.Width)
                     {
-                        int sourceIndex = areaY * source.Width;
-                        int targetIndex = 0;
+                        // shortcut copying because the area to copy is contiguous. This is
+                        // probably uncommon, but Array.Copy benefits a lot.
+
+                        int sourceIndex = areaY * areaWidth;
+                        int targetIndex = 0;
+                        Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
 
-                        Array.Copy(source.Data, sourceIndex, trimmedSourceData, targetIndex, pixelCount);
                     }
                     else
                     {
-                        // copying line-by-line
-                        // Array.Copy isn't great at small scale
+                        // slower copying, line by line
                         for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
                         {
                             int sourceIndex = (y * source.Width) + areaX;
                             int targetIndex = (y - areaY) * areaWidth;
-                            Array.Copy(source.Data, sourceIndex, trimmedSourceData, targetIndex, areaWidth);
+                            Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
                         }
                     }
 
                     // apply
-                    this.PatchImageImpl(trimmedSourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
 
                     // return
-                    ArrayPool<Color>.Shared.Return(trimmedSourceData);
+                    ArrayPool<Color>.Shared.Return(sourceData);
                 }
             }
         }
@@ -176,9 +174,9 @@ namespace StardewModdingAPI.Framework.Content
                 // merge pixels
                 for (int i = 0; i < pixelCount; i++)
                 {
-                    // should probably benchmark this...
-                    ref Color above = ref sourceData[i];
-                    ref Color below = ref mergedData[i];
+                    // ref locals here? Not sure.
+                    Color above = sourceData[i];
+                    Color below = mergedData[i];
 
                     // shortcut transparency
                     if (above.A < MinOpacity)
diff --git a/src/SMAPI/Framework/Content/AssetEditOperation.cs b/src/SMAPI/Framework/Content/AssetEditOperation.cs
index 893f59bd..11b8811b 100644
--- a/src/SMAPI/Framework/Content/AssetEditOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetEditOperation.cs
@@ -8,5 +8,5 @@ namespace StardewModdingAPI.Framework.Content
     /// <param name="Priority">If there are multiple edits that apply to the same asset, the priority with which this one should be applied.</param>
     /// <param name="OnBehalfOf">The content pack on whose behalf the edit is being applied, if any.</param>
     /// <param name="ApplyEdit">Apply the edit to an asset.</param>
-    internal readonly record struct AssetEditOperation(IModMetadata Mod, AssetEditPriority Priority, IModMetadata? OnBehalfOf, Action<IAssetData> ApplyEdit);
+    internal record AssetEditOperation(IModMetadata Mod, AssetEditPriority Priority, IModMetadata? OnBehalfOf, Action<IAssetData> ApplyEdit);
 }
diff --git a/src/SMAPI/Framework/Content/AssetLoadOperation.cs b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
index 58886849..7af07dfd 100644
--- a/src/SMAPI/Framework/Content/AssetLoadOperation.cs
+++ b/src/SMAPI/Framework/Content/AssetLoadOperation.cs
@@ -8,5 +8,5 @@ namespace StardewModdingAPI.Framework.Content
     /// <param name="Priority">If there are multiple loads that apply to the same asset, the priority with which this one should be applied.</param>
     /// <param name="OnBehalfOf">The content pack on whose behalf the asset is being loaded, if any.</param>
     /// <param name="GetData">Load the initial value for an asset.</param>
-    internal readonly record struct AssetLoadOperation(IModMetadata Mod, IModMetadata? OnBehalfOf, AssetLoadPriority Priority, Func<IAssetInfo, object> GetData);
+    internal record AssetLoadOperation(IModMetadata Mod, IModMetadata? OnBehalfOf, AssetLoadPriority Priority, Func<IAssetInfo, object> GetData);
 }
diff --git a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
index a8c70356..df7bdc59 100644
--- a/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/GameContentManager.cs
@@ -172,7 +172,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             where T : notnull
         {
             // find matching loader
-            AssetLoadOperation loader = default;
+            AssetLoadOperation? loader = null;
             if (loadOperations?.Count > 0)
             {
                 if (!this.AssertMaxOneRequiredLoader(info, loadOperations, out string? error))
@@ -183,7 +183,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
                 loader = loadOperations.OrderByDescending(p => p.Priority).FirstOrDefault();
             }
-            if (loader.Mod == null) // aka, this is default.
+            if (loader == null)
                 return null;
 
             // fetch asset from loader

From ff523c619a040c8eb2d2f1c1a0d19c8fe83f1c75 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Fri, 19 Aug 2022 11:10:19 -0400
Subject: [PATCH 776/856] fix fast-track array copying

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 5f175217..9c71328f 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -64,7 +64,7 @@ namespace StardewModdingAPI.Framework.Content
 
                         int sourceIndex = areaY * areaWidth;
                         int targetIndex = 0;
-                        Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
+                        Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, pixelCount);
 
                     }
                     else

From ce63efa2f45ee770fdb628a45f5a6b63544b0031 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Mon, 22 Aug 2022 19:32:45 -0400
Subject: [PATCH 777/856] Avoid making copy if the source image is just taller
 than the sourceArea.

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 9c71328f..bcdebff6 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -47,10 +47,12 @@ namespace StardewModdingAPI.Framework.Content
                 int areaWidth = sourceArea.Value.Width;
                 int areaHeight = sourceArea.Value.Height;
 
-                if (areaX == 0 && areaY == 0 && areaWidth == source.Width && areaHeight == source.Height)
+                if (areaX == 0 && areaY == 0 && areaWidth == source.Width && areaHeight <= source.Height)
                 {
+                    // It's actually fine if the source is taller than the sourceArea
+                    // the "extra" bits on the end of the array can just be ignored.
                     sourceData = source.Data;
-                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+                    this.PatchImageImpl(sourceData, areaWidth, areaHeight, sourceArea.Value, targetArea.Value, patchMode);
                 }
                 else
                 {

From c1d5d19e43a9305ebf71696408fc8a0777794f55 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Mon, 22 Aug 2022 22:35:08 -0400
Subject: [PATCH 778/856] Skip transparent rows at the start and end when doing
 a patch overlay.

---
 .../Framework/Content/AssetDataForImage.cs    | 51 +++++++++++++++++--
 1 file changed, 46 insertions(+), 5 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index bcdebff6..90468316 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Buffers;
 using System.Diagnostics.CodeAnalysis;
+using System.Linq;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
@@ -166,9 +167,51 @@ namespace StardewModdingAPI.Framework.Content
             if (sourceArea.Size != targetArea.Size)
                 throw new InvalidOperationException("The source and target areas must be the same size.");
 
-            // merge data
-            if (patchMode == PatchMode.Overlay)
+            if (patchMode == PatchMode.Replace)
+                target.SetData(0, targetArea, sourceData, 0, pixelCount);
+            else
             {
+                // merge data
+
+                // Content packs have a habit of using large amounts of blank space.
+                // Adjusting bounds to ignore transparent pixels at the start and end.
+
+                int startIndex = -1;
+                for (int i = 0; i < pixelCount; i++)
+                {
+                    if (sourceData[i].A >= MinOpacity)
+                    {
+                        startIndex = i;
+                        break;
+                    }
+                }
+
+                if (startIndex == -1)
+                    return;
+
+                int endIndex = -1;
+                for (int i = pixelCount - 1; i >= startIndex; i--)
+                {
+                    if (sourceData[i].A >= MinOpacity)
+                    {
+                        endIndex = i;
+                        break;
+                    }
+                }
+
+                if (endIndex == -1)
+                    return;
+
+                int topoffset = startIndex / sourceArea.Width;
+                int bottomoffset = endIndex / sourceArea.Width;
+
+                // Update target rectangle
+                targetArea = new(targetArea.X, targetArea.Y + topoffset, targetArea.Width, bottomoffset - topoffset + 1);
+
+                pixelCount = targetArea.Width * targetArea.Height;
+
+                int sourceoffset = topoffset * sourceArea.Width;
+
                 // get target data
                 Color[] mergedData = ArrayPool<Color>.Shared.Rent(pixelCount);
                 target.GetData(0, targetArea, mergedData, 0, pixelCount);
@@ -177,7 +220,7 @@ namespace StardewModdingAPI.Framework.Content
                 for (int i = 0; i < pixelCount; i++)
                 {
                     // ref locals here? Not sure.
-                    Color above = sourceData[i];
+                    Color above = sourceData[sourceoffset + i];
                     Color below = mergedData[i];
 
                     // shortcut transparency
@@ -205,8 +248,6 @@ namespace StardewModdingAPI.Framework.Content
                 target.SetData(0, targetArea, mergedData, 0, pixelCount);
                 ArrayPool<Color>.Shared.Return(mergedData);
             }
-            else
-                target.SetData(0, targetArea, sourceData, 0, pixelCount);
         }
     }
 }

From 09fd12ddfe89c5d36b1db66167dd741e4f8a7e0f Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Mon, 22 Aug 2022 23:44:07 -0400
Subject: [PATCH 779/856] use startindex/endindex since I've already calculated
 those...

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 90468316..70fa369f 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -207,7 +207,6 @@ namespace StardewModdingAPI.Framework.Content
 
                 // Update target rectangle
                 targetArea = new(targetArea.X, targetArea.Y + topoffset, targetArea.Width, bottomoffset - topoffset + 1);
-
                 pixelCount = targetArea.Width * targetArea.Height;
 
                 int sourceoffset = topoffset * sourceArea.Width;
@@ -217,11 +216,11 @@ namespace StardewModdingAPI.Framework.Content
                 target.GetData(0, targetArea, mergedData, 0, pixelCount);
 
                 // merge pixels
-                for (int i = 0; i < pixelCount; i++)
+                for (int i = startIndex; i <= endIndex; i++)
                 {
                     // ref locals here? Not sure.
-                    Color above = sourceData[sourceoffset + i];
-                    Color below = mergedData[i];
+                    Color above = sourceData[i];
+                    Color below = mergedData[i - sourceoffset];
 
                     // shortcut transparency
                     if (above.A < MinOpacity)

From a3b8546ec8975ef1941e7618cef773c41d5c423f Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Mon, 22 Aug 2022 23:50:52 -0400
Subject: [PATCH 780/856] cleanup and comments

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 70fa369f..f00d2d4c 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -187,7 +187,7 @@ namespace StardewModdingAPI.Framework.Content
                 }
 
                 if (startIndex == -1)
-                    return;
+                    return; // apparently a completely blank texture?
 
                 int endIndex = -1;
                 for (int i = pixelCount - 1; i >= startIndex; i--)
@@ -200,8 +200,9 @@ namespace StardewModdingAPI.Framework.Content
                 }
 
                 if (endIndex == -1)
-                    return;
+                    return; // should never happen
 
+                // Calculate new Y bounds
                 int topoffset = startIndex / sourceArea.Width;
                 int bottomoffset = endIndex / sourceArea.Width;
 

From 496c438be244c6e51f34cbcf238913edf55a8618 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Tue, 23 Aug 2022 14:34:23 -0400
Subject: [PATCH 781/856] fix indexing again, because apparently I'm bad at
 math now?

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index f00d2d4c..2bbcc60c 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -219,15 +219,17 @@ namespace StardewModdingAPI.Framework.Content
                 // merge pixels
                 for (int i = startIndex; i <= endIndex; i++)
                 {
+                    int targetIndex = i - sourceoffset;
+
                     // ref locals here? Not sure.
                     Color above = sourceData[i];
-                    Color below = mergedData[i - sourceoffset];
+                    Color below = mergedData[targetIndex];
 
                     // shortcut transparency
                     if (above.A < MinOpacity)
                         continue;
                     if (below.A < MinOpacity || above.A == byte.MaxValue)
-                        mergedData[i] = above;
+                        mergedData[targetIndex] = above;
 
                     // merge pixels
                     else
@@ -236,7 +238,7 @@ namespace StardewModdingAPI.Framework.Content
                         // premultiplied by the content pipeline. The formula is derived from
                         // https://blogs.msdn.microsoft.com/shawnhar/2009/11/06/premultiplied-alpha/.
                         float alphaBelow = 1 - (above.A / 255f);
-                        mergedData[i] = new Color(
+                        mergedData[targetIndex] = new Color(
                             r: (int)(above.R + (below.R * alphaBelow)),
                             g: (int)(above.G + (below.G * alphaBelow)),
                             b: (int)(above.B + (below.B * alphaBelow)),

From 798a56bd2e94e9e60b588222c730e313c3dbe075 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Sun, 28 Aug 2022 16:14:57 -0400
Subject: [PATCH 782/856] Avoid copying memory for contingous buffers.

---
 .../Framework/Content/AssetDataForImage.cs    | 39 ++++++++-----------
 1 file changed, 16 insertions(+), 23 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 2bbcc60c..068634b3 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -40,6 +40,11 @@ namespace StardewModdingAPI.Framework.Content
 
             this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
 
+            // check to see if the Data is sufficiently long.
+            // while SMAPI's impl is going to be, it's not necessarily the case for mod impl.
+            if (source.Data.Length < (sourceArea.Value.Bottom - 1) * source.Width + sourceArea.Value.Right)
+                throw new ArgumentException("Source data insufficiently long for this operation.");
+
             // get the pixels for the source area
             Color[] sourceData;
             {
@@ -48,37 +53,24 @@ namespace StardewModdingAPI.Framework.Content
                 int areaWidth = sourceArea.Value.Width;
                 int areaHeight = sourceArea.Value.Height;
 
-                if (areaX == 0 && areaY == 0 && areaWidth == source.Width && areaHeight <= source.Height)
+                if (areaWidth == source.Width)
                 {
                     // It's actually fine if the source is taller than the sourceArea
                     // the "extra" bits on the end of the array can just be ignored.
                     sourceData = source.Data;
-                    this.PatchImageImpl(sourceData, areaWidth, areaHeight, sourceArea.Value, targetArea.Value, patchMode);
+                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode, areaY);
                 }
                 else
                 {
                     int pixelCount = areaWidth * areaHeight;
                     sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
 
-                    if (areaX == 0 && areaWidth == source.Width)
+                    // slower copying, line by line
+                    for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
                     {
-                        // shortcut copying because the area to copy is contiguous. This is
-                        // probably uncommon, but Array.Copy benefits a lot.
-
-                        int sourceIndex = areaY * areaWidth;
-                        int targetIndex = 0;
-                        Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, pixelCount);
-
-                    }
-                    else
-                    {
-                        // slower copying, line by line
-                        for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
-                        {
-                            int sourceIndex = (y * source.Width) + areaX;
-                            int targetIndex = (y - areaY) * areaWidth;
-                            Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
-                        }
+                        int sourceIndex = (y * source.Width) + areaX;
+                        int targetIndex = (y - areaY) * areaWidth;
+                        Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
                     }
 
                     // apply
@@ -150,10 +142,11 @@ namespace StardewModdingAPI.Framework.Content
         /// <param name="sourceArea">The part of the <paramref name="sourceData"/> to copy (or <c>null</c> to take the whole texture). This must be within the bounds of the <paramref name="sourceData"/> texture.</param>
         /// <param name="targetArea">The part of the content to patch (or <c>null</c> to patch the whole texture). The original content within this area will be erased. This must be within the bounds of the existing spritesheet.</param>
         /// <param name="patchMode">Indicates how an image should be patched.</param>
+        /// <param name="startRow">The row to start on, for the sourceData.</param>
         /// <exception cref="ArgumentNullException">One of the arguments is null.</exception>
         /// <exception cref="ArgumentOutOfRangeException">The <paramref name="targetArea"/> is outside the bounds of the spritesheet.</exception>
         /// <exception cref="InvalidOperationException">The content being read isn't an image.</exception>
-        private void PatchImageImpl(Color[] sourceData, int sourceWidth, int sourceHeight, Rectangle sourceArea, Rectangle targetArea, PatchMode patchMode)
+        private void PatchImageImpl(Color[] sourceData, int sourceWidth, int sourceHeight, Rectangle sourceArea, Rectangle targetArea, PatchMode patchMode, int startRow = 0)
         {
             // get texture
             Texture2D target = this.Data;
@@ -168,7 +161,7 @@ namespace StardewModdingAPI.Framework.Content
                 throw new InvalidOperationException("The source and target areas must be the same size.");
 
             if (patchMode == PatchMode.Replace)
-                target.SetData(0, targetArea, sourceData, 0, pixelCount);
+                target.SetData(0, targetArea, sourceData, startRow * sourceArea.Width, pixelCount);
             else
             {
                 // merge data
@@ -177,7 +170,7 @@ namespace StardewModdingAPI.Framework.Content
                 // Adjusting bounds to ignore transparent pixels at the start and end.
 
                 int startIndex = -1;
-                for (int i = 0; i < pixelCount; i++)
+                for (int i = startRow * sourceArea.Width; i < pixelCount; i++)
                 {
                     if (sourceData[i].A >= MinOpacity)
                     {

From 48d0f70ffd07df9ba364808a71407800834f95d3 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Thu, 6 Oct 2022 08:16:57 -0400
Subject: [PATCH 783/856] fix indexing math again.

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 068634b3..636d4a71 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -137,8 +137,8 @@ namespace StardewModdingAPI.Framework.Content
 
         /// <summary>Overwrite part of the image.</summary>
         /// <param name="sourceData">The image data to patch into the content.</param>
-        /// <param name="sourceWidth">The pixel width of the source image.</param>
-        /// <param name="sourceHeight">The pixel height of the source image.</param>
+        /// <param name="sourceWidth">The pixel width of the original source image.</param>
+        /// <param name="sourceHeight">The pixel height of the original source image.</param>
         /// <param name="sourceArea">The part of the <paramref name="sourceData"/> to copy (or <c>null</c> to take the whole texture). This must be within the bounds of the <paramref name="sourceData"/> texture.</param>
         /// <param name="targetArea">The part of the content to patch (or <c>null</c> to patch the whole texture). The original content within this area will be erased. This must be within the bounds of the existing spritesheet.</param>
         /// <param name="patchMode">Indicates how an image should be patched.</param>
@@ -183,7 +183,7 @@ namespace StardewModdingAPI.Framework.Content
                     return; // apparently a completely blank texture?
 
                 int endIndex = -1;
-                for (int i = pixelCount - 1; i >= startIndex; i--)
+                for (int i = startRow * sourceArea.Width + pixelCount - 1; i >= startIndex; i--)
                 {
                     if (sourceData[i].A >= MinOpacity)
                     {

From 40d5cd7c05d4e0a4e6894cd7b9f6d7d747716837 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 8 Oct 2022 17:42:32 -0400
Subject: [PATCH 784/856]  use try..finally to make sure rented arrays are
 returned

---
 .../Framework/Content/AssetDataForImage.cs    | 110 ++++++++++--------
 .../ContentManagers/ModContentManager.cs      |  37 +++---
 2 files changed, 81 insertions(+), 66 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 636d4a71..3abcd328 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Buffers;
 using System.Diagnostics.CodeAnalysis;
-using System.Linq;
 using Microsoft.Xna.Framework;
 using Microsoft.Xna.Framework.Graphics;
 using StardewValley;
@@ -64,20 +63,23 @@ namespace StardewModdingAPI.Framework.Content
                 {
                     int pixelCount = areaWidth * areaHeight;
                     sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
-
-                    // slower copying, line by line
-                    for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
+                    try
                     {
-                        int sourceIndex = (y * source.Width) + areaX;
-                        int targetIndex = (y - areaY) * areaWidth;
-                        Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
+                        // slower copying, line by line
+                        for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
+                        {
+                            int sourceIndex = (y * source.Width) + areaX;
+                            int targetIndex = (y - areaY) * areaWidth;
+                            Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
+                        }
+
+                        // apply
+                        this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+                    }
+                    finally
+                    {
+                        ArrayPool<Color>.Shared.Return(sourceData);
                     }
-
-                    // apply
-                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
-
-                    // return
-                    ArrayPool<Color>.Shared.Return(sourceData);
                 }
             }
         }
@@ -98,13 +100,15 @@ namespace StardewModdingAPI.Framework.Content
             // get source data
             int pixelCount = sourceArea.Value.Width * sourceArea.Value.Height;
             Color[] sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
-            source.GetData(0, sourceArea, sourceData, 0, pixelCount);
-
-            // apply
-            this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
-
-            // return
-            ArrayPool<Color>.Shared.Return(sourceData);
+            try
+            {
+                source.GetData(0, sourceArea, sourceData, 0, pixelCount);
+                this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+            }
+            finally
+            {
+                ArrayPool<Color>.Shared.Return(sourceData);
+            }
         }
 
         /// <inheritdoc />
@@ -207,41 +211,47 @@ namespace StardewModdingAPI.Framework.Content
 
                 // get target data
                 Color[] mergedData = ArrayPool<Color>.Shared.Rent(pixelCount);
-                target.GetData(0, targetArea, mergedData, 0, pixelCount);
-
-                // merge pixels
-                for (int i = startIndex; i <= endIndex; i++)
+                try
                 {
-                    int targetIndex = i - sourceoffset;
-
-                    // ref locals here? Not sure.
-                    Color above = sourceData[i];
-                    Color below = mergedData[targetIndex];
-
-                    // shortcut transparency
-                    if (above.A < MinOpacity)
-                        continue;
-                    if (below.A < MinOpacity || above.A == byte.MaxValue)
-                        mergedData[targetIndex] = above;
+                    target.GetData(0, targetArea, mergedData, 0, pixelCount);
 
                     // merge pixels
-                    else
+                    for (int i = startIndex; i <= endIndex; i++)
                     {
-                        // This performs a conventional alpha blend for the pixels, which are already
-                        // premultiplied by the content pipeline. The formula is derived from
-                        // https://blogs.msdn.microsoft.com/shawnhar/2009/11/06/premultiplied-alpha/.
-                        float alphaBelow = 1 - (above.A / 255f);
-                        mergedData[targetIndex] = new Color(
-                            r: (int)(above.R + (below.R * alphaBelow)),
-                            g: (int)(above.G + (below.G * alphaBelow)),
-                            b: (int)(above.B + (below.B * alphaBelow)),
-                            alpha: Math.Max(above.A, below.A)
-                        );
-                    }
-                }
+                        int targetIndex = i - sourceoffset;
 
-                target.SetData(0, targetArea, mergedData, 0, pixelCount);
-                ArrayPool<Color>.Shared.Return(mergedData);
+                        // ref locals here? Not sure.
+                        Color above = sourceData[i];
+                        Color below = mergedData[targetIndex];
+
+                        // shortcut transparency
+                        if (above.A < MinOpacity)
+                            continue;
+                        if (below.A < MinOpacity || above.A == byte.MaxValue)
+                            mergedData[targetIndex] = above;
+
+                        // merge pixels
+                        else
+                        {
+                            // This performs a conventional alpha blend for the pixels, which are already
+                            // premultiplied by the content pipeline. The formula is derived from
+                            // https://blogs.msdn.microsoft.com/shawnhar/2009/11/06/premultiplied-alpha/.
+                            float alphaBelow = 1 - (above.A / 255f);
+                            mergedData[targetIndex] = new Color(
+                                r: (int)(above.R + (below.R * alphaBelow)),
+                                g: (int)(above.G + (below.G * alphaBelow)),
+                                b: (int)(above.B + (below.B * alphaBelow)),
+                                alpha: Math.Max(above.A, below.A)
+                            );
+                        }
+                    }
+
+                    target.SetData(0, targetArea, mergedData, 0, pixelCount);
+                }
+                finally
+                {
+                    ArrayPool<Color>.Shared.Return(mergedData);
+                }
             }
         }
     }
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 0c793808..6b8a5874 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -395,25 +395,30 @@ namespace StardewModdingAPI.Framework.ContentManagers
             // premultiply pixels
             int count = texture.Width * texture.Height;
             Color[] data = ArrayPool<Color>.Shared.Rent(count);
-            texture.GetData(data, 0, count);
-
-            bool changed = false;
-            for (int i = 0; i < count; i++)
+            try
             {
-                ref Color pixel = ref data[i];
-                if (pixel.A is (byte.MinValue or byte.MaxValue))
-                    continue; // no need to change fully transparent/opaque pixels
+                texture.GetData(data, 0, count);
 
-                data[i] = new Color(pixel.R * pixel.A / byte.MaxValue, pixel.G * pixel.A / byte.MaxValue, pixel.B * pixel.A / byte.MaxValue, pixel.A); // slower version: Color.FromNonPremultiplied(data[i].ToVector4())
-                changed = true;
+                bool changed = false;
+                for (int i = 0; i < count; i++)
+                {
+                    ref Color pixel = ref data[i];
+                    if (pixel.A is (byte.MinValue or byte.MaxValue))
+                        continue; // no need to change fully transparent/opaque pixels
+
+                    data[i] = new Color(pixel.R * pixel.A / byte.MaxValue, pixel.G * pixel.A / byte.MaxValue, pixel.B * pixel.A / byte.MaxValue, pixel.A); // slower version: Color.FromNonPremultiplied(data[i].ToVector4())
+                    changed = true;
+                }
+
+                if (changed)
+                    texture.SetData(data, 0, count);
+
+                return texture;
+            }
+            finally
+            {
+                ArrayPool<Color>.Shared.Return(data);
             }
-
-            if (changed)
-                texture.SetData(data, 0, count);
-
-            // return
-            ArrayPool<Color>.Shared.Return(data);
-            return texture;
         }
 
         /// <summary>Fix custom map tilesheet paths so they can be found by the content manager.</summary>

From 2e0bc5ddfe90102fe5adbc90b2d53c5cbb8405fe Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 8 Oct 2022 17:45:50 -0400
Subject: [PATCH 785/856] tweak new code

---
 .../Framework/Content/AssetDataForImage.cs    | 181 ++++++++----------
 .../ContentManagers/ModContentManager.cs      |  13 +-
 .../Framework/Logging/LogOnceCacheKey.cs      |  10 +
 src/SMAPI/Framework/Monitor.cs                |  14 +-
 4 files changed, 103 insertions(+), 115 deletions(-)
 create mode 100644 src/SMAPI/Framework/Logging/LogOnceCacheKey.cs

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 3abcd328..0380dd9e 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -33,71 +33,59 @@ namespace StardewModdingAPI.Framework.Content
         /// <inheritdoc />
         public void PatchImage(IRawTextureData source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace)
         {
-            // nullcheck
             if (source == null)
                 throw new ArgumentNullException(nameof(source), "Can't patch from null source data.");
 
+            // get normalized bounds
             this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
-
-            // check to see if the Data is sufficiently long.
-            // while SMAPI's impl is going to be, it's not necessarily the case for mod impl.
             if (source.Data.Length < (sourceArea.Value.Bottom - 1) * source.Width + sourceArea.Value.Right)
-                throw new ArgumentException("Source data insufficiently long for this operation.");
+                throw new ArgumentException("Can't apply image patch because the source image is smaller than the source area.", nameof(source));
+            int areaX = sourceArea.Value.X;
+            int areaY = sourceArea.Value.Y;
+            int areaWidth = sourceArea.Value.Width;
+            int areaHeight = sourceArea.Value.Height;
 
-            // get the pixels for the source area
-            Color[] sourceData;
+            // shortcut: if the area width matches the source image, we can apply the image as-is without needing
+            // to copy the pixels into a smaller subset. It's fine if the source is taller than the area, since we'll
+            // just ignore the extra data at the end of the pixel array.
+            if (areaWidth == source.Width)
             {
-                int areaX = sourceArea.Value.X;
-                int areaY = sourceArea.Value.Y;
-                int areaWidth = sourceArea.Value.Width;
-                int areaHeight = sourceArea.Value.Height;
+                this.PatchImageImpl(source.Data, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode, areaY);
+                return;
+            }
 
-                if (areaWidth == source.Width)
+            // else copy the pixels within the smaller area & apply that
+            int pixelCount = areaWidth * areaHeight;
+            Color[] sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
+            try
+            {
+                for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
                 {
-                    // It's actually fine if the source is taller than the sourceArea
-                    // the "extra" bits on the end of the array can just be ignored.
-                    sourceData = source.Data;
-                    this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode, areaY);
+                    int sourceIndex = (y * source.Width) + areaX;
+                    int targetIndex = (y - areaY) * areaWidth;
+                    Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
                 }
-                else
-                {
-                    int pixelCount = areaWidth * areaHeight;
-                    sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
-                    try
-                    {
-                        // slower copying, line by line
-                        for (int y = areaY, maxY = areaY + areaHeight; y < maxY; y++)
-                        {
-                            int sourceIndex = (y * source.Width) + areaX;
-                            int targetIndex = (y - areaY) * areaWidth;
-                            Array.Copy(source.Data, sourceIndex, sourceData, targetIndex, areaWidth);
-                        }
 
-                        // apply
-                        this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
-                    }
-                    finally
-                    {
-                        ArrayPool<Color>.Shared.Return(sourceData);
-                    }
-                }
+                this.PatchImageImpl(sourceData, source.Width, source.Height, sourceArea.Value, targetArea.Value, patchMode);
+            }
+            finally
+            {
+                ArrayPool<Color>.Shared.Return(sourceData);
             }
         }
 
         /// <inheritdoc />
         public void PatchImage(Texture2D source, Rectangle? sourceArea = null, Rectangle? targetArea = null, PatchMode patchMode = PatchMode.Replace)
         {
-            // nullcheck
             if (source == null)
                 throw new ArgumentNullException(nameof(source), "Can't patch from a null source texture.");
 
+            // get normalized bounds
             this.GetPatchBounds(ref sourceArea, ref targetArea, source.Width, source.Height);
-
-            // validate source bounds
             if (!source.Bounds.Contains(sourceArea.Value))
                 throw new ArgumentOutOfRangeException(nameof(sourceArea), "The source area is outside the bounds of the source texture.");
 
-            // get source data
+            // get source data & apply
             int pixelCount = sourceArea.Value.Width * sourceArea.Value.Height;
             Color[] sourceData = ArrayPool<Color>.Shared.Rent(pixelCount);
             try
@@ -164,94 +152,91 @@ namespace StardewModdingAPI.Framework.Content
             if (sourceArea.Size != targetArea.Size)
                 throw new InvalidOperationException("The source and target areas must be the same size.");
 
+            // shortcut: replace the entire area
             if (patchMode == PatchMode.Replace)
-                target.SetData(0, targetArea, sourceData, startRow * sourceArea.Width, pixelCount);
-            else
             {
-                // merge data
+                target.SetData(0, targetArea, sourceData, startRow * sourceArea.Width, pixelCount);
+                return;
+            }
 
-                // Content packs have a habit of using large amounts of blank space.
-                // Adjusting bounds to ignore transparent pixels at the start and end.
-
-                int startIndex = -1;
+            // skip transparent pixels at the start & end (e.g. large spritesheet with a few sprites replaced)
+            int startIndex = -1;
+            int endIndex = -1;
+            {
                 for (int i = startRow * sourceArea.Width; i < pixelCount; i++)
                 {
-                    if (sourceData[i].A >= MinOpacity)
+                    if (sourceData[i].A >= AssetDataForImage.MinOpacity)
                     {
                         startIndex = i;
                         break;
                     }
                 }
-
                 if (startIndex == -1)
-                    return; // apparently a completely blank texture?
+                    return; // blank texture
 
-                int endIndex = -1;
                 for (int i = startRow * sourceArea.Width + pixelCount - 1; i >= startIndex; i--)
                 {
-                    if (sourceData[i].A >= MinOpacity)
+                    if (sourceData[i].A >= AssetDataForImage.MinOpacity)
                     {
                         endIndex = i;
                         break;
                     }
                 }
-
                 if (endIndex == -1)
-                    return; // should never happen
+                    return; // ???
+            }
 
-                // Calculate new Y bounds
-                int topoffset = startIndex / sourceArea.Width;
-                int bottomoffset = endIndex / sourceArea.Width;
+            // update target rectangle
+            int sourceOffset;
+            {
+                int topOffset = startIndex / sourceArea.Width;
+                int bottomOffset = endIndex / sourceArea.Width;
 
-                // Update target rectangle
-                targetArea = new(targetArea.X, targetArea.Y + topoffset, targetArea.Width, bottomoffset - topoffset + 1);
+                targetArea = new(targetArea.X, targetArea.Y + topOffset, targetArea.Width, bottomOffset - topOffset + 1);
                 pixelCount = targetArea.Width * targetArea.Height;
+                sourceOffset = topOffset * sourceArea.Width;
+            }
 
-                int sourceoffset = topoffset * sourceArea.Width;
+            // apply
+            Color[] mergedData = ArrayPool<Color>.Shared.Rent(pixelCount);
+            try
+            {
+                target.GetData(0, targetArea, mergedData, 0, pixelCount);
 
-                // get target data
-                Color[] mergedData = ArrayPool<Color>.Shared.Rent(pixelCount);
-                try
+                for (int i = startIndex; i <= endIndex; i++)
                 {
-                    target.GetData(0, targetArea, mergedData, 0, pixelCount);
+                    int targetIndex = i - sourceOffset;
+
+                    Color above = sourceData[i];
+                    Color below = mergedData[targetIndex];
+
+                    // shortcut transparency
+                    if (above.A < AssetDataForImage.MinOpacity)
+                        continue;
+                    if (below.A < AssetDataForImage.MinOpacity || above.A == byte.MaxValue)
+                        mergedData[targetIndex] = above;
 
                     // merge pixels
-                    for (int i = startIndex; i <= endIndex; i++)
+                    else
                     {
-                        int targetIndex = i - sourceoffset;
-
-                        // ref locals here? Not sure.
-                        Color above = sourceData[i];
-                        Color below = mergedData[targetIndex];
-
-                        // shortcut transparency
-                        if (above.A < MinOpacity)
-                            continue;
-                        if (below.A < MinOpacity || above.A == byte.MaxValue)
-                            mergedData[targetIndex] = above;
-
-                        // merge pixels
-                        else
-                        {
-                            // This performs a conventional alpha blend for the pixels, which are already
-                            // premultiplied by the content pipeline. The formula is derived from
-                            // https://blogs.msdn.microsoft.com/shawnhar/2009/11/06/premultiplied-alpha/.
-                            float alphaBelow = 1 - (above.A / 255f);
-                            mergedData[targetIndex] = new Color(
-                                r: (int)(above.R + (below.R * alphaBelow)),
-                                g: (int)(above.G + (below.G * alphaBelow)),
-                                b: (int)(above.B + (below.B * alphaBelow)),
-                                alpha: Math.Max(above.A, below.A)
-                            );
-                        }
+                        // This performs a conventional alpha blend for the pixels, which are already
+                        // premultiplied by the content pipeline. The formula is derived from
+                        // https://blogs.msdn.microsoft.com/shawnhar/2009/11/06/premultiplied-alpha/.
+                        float alphaBelow = 1 - (above.A / 255f);
+                        mergedData[targetIndex] = new Color(
+                            r: (int)(above.R + (below.R * alphaBelow)),
+                            g: (int)(above.G + (below.G * alphaBelow)),
+                            b: (int)(above.B + (below.B * alphaBelow)),
+                            alpha: Math.Max(above.A, below.A)
+                        );
                     }
+                }
 
-                    target.SetData(0, targetArea, mergedData, 0, pixelCount);
-                }
-                finally
-                {
-                    ArrayPool<Color>.Shared.Return(mergedData);
-                }
+                target.SetData(0, targetArea, mergedData, 0, pixelCount);
+            }
+            finally
+            {
+                ArrayPool<Color>.Shared.Return(mergedData);
             }
         }
     }
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 6b8a5874..72dcf6e1 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -241,7 +241,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             {
                 using FileStream stream = File.OpenRead(file.FullName);
                 Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream);
-                texture = this.PremultiplyTransparency(texture);
+                this.PremultiplyTransparency(texture);
                 return (T)(object)texture;
             }
         }
@@ -345,17 +345,15 @@ namespace StardewModdingAPI.Framework.ContentManagers
                 this.ThrowLoadError(assetName, ContentLoadErrorType.InvalidData, $"can't read file with extension '{file.Extension}' as type '{typeof(TAsset)}'; must be type '{string.Join("' or '", validTypes.Select(p => p.FullName))}'.");
         }
 
-        /// <summary>Throws an error which indicates that an asset couldn't be loaded.</summary>
+        /// <summary>Throw an error which indicates that an asset couldn't be loaded.</summary>
         /// <param name="errorType">Why loading an asset through the content pipeline failed.</param>
         /// <param name="assetName">The asset name that failed to load.</param>
         /// <param name="reasonPhrase">The reason the file couldn't be loaded.</param>
         /// <param name="exception">The underlying exception, if applicable.</param>
+        /// <exception cref="SContentLoadException" />
         [DoesNotReturn]
         [DebuggerStepThrough, DebuggerHidden]
         [MethodImpl(MethodImplOptions.NoInlining)]
-#if NET6_0_OR_GREATER
-        [StackTraceHidden]
-#endif
         private void ThrowLoadError(IAssetName assetName, ContentLoadErrorType errorType, string reasonPhrase, Exception? exception = null)
         {
             throw new SContentLoadException(errorType, $"Failed loading asset '{assetName}' from {this.Name}: {reasonPhrase}", exception);
@@ -390,9 +388,8 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="texture">The texture to premultiply.</param>
         /// <returns>Returns a premultiplied texture.</returns>
         /// <remarks>Based on <a href="https://gamedev.stackexchange.com/a/26037">code by David Gouveia</a>.</remarks>
-        private Texture2D PremultiplyTransparency(Texture2D texture)
+        private void PremultiplyTransparency(Texture2D texture)
         {
-            // premultiply pixels
             int count = texture.Width * texture.Height;
             Color[] data = ArrayPool<Color>.Shared.Rent(count);
             try
@@ -412,8 +409,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
 
                 if (changed)
                     texture.SetData(data, 0, count);
-
-                return texture;
             }
             finally
             {
diff --git a/src/SMAPI/Framework/Logging/LogOnceCacheKey.cs b/src/SMAPI/Framework/Logging/LogOnceCacheKey.cs
new file mode 100644
index 00000000..4d31ffeb
--- /dev/null
+++ b/src/SMAPI/Framework/Logging/LogOnceCacheKey.cs
@@ -0,0 +1,10 @@
+using System.Diagnostics.CodeAnalysis;
+
+namespace StardewModdingAPI.Framework.Logging
+{
+    /// <summary>The cache key for the <see cref="Monitor.LogOnceCache"/>.</summary>
+    /// <param name="Message">The log message.</param>
+    /// <param name="Level">The log level.</param>
+    [SuppressMessage("ReSharper", "NotAccessedPositionalProperty.Local", Justification = "This is only used as a lookup key.")]
+    internal readonly record struct LogOnceCacheKey(string Message, LogLevel Level);
+}
diff --git a/src/SMAPI/Framework/Monitor.cs b/src/SMAPI/Framework/Monitor.cs
index d33bf259..4ed2c9bb 100644
--- a/src/SMAPI/Framework/Monitor.cs
+++ b/src/SMAPI/Framework/Monitor.cs
@@ -25,15 +25,13 @@ namespace StardewModdingAPI.Framework
         private readonly LogFileManager LogFile;
 
         /// <summary>The maximum length of the <see cref="LogLevel"/> values.</summary>
-        private static readonly int MaxLevelLength = (from level in Enum.GetValues<LogLevel>() select level.ToString().Length).Max();
+        private static readonly int MaxLevelLength = Enum.GetValues<LogLevel>().Max(level => level.ToString().Length);
 
-        /// <summary>A mapping of console log levels to their string form.</summary>
-        private static readonly Dictionary<ConsoleLogLevel, string> LogStrings = Enum.GetValues<ConsoleLogLevel>().ToDictionary(k => k, v => v.ToString().ToUpper().PadRight(MaxLevelLength));
-
-        private readonly record struct LogOnceCacheEntry(string message, LogLevel level);
+        /// <summary>The cached representation for each level when added to a log header.</summary>
+        private static readonly Dictionary<ConsoleLogLevel, string> LogStrings = Enum.GetValues<ConsoleLogLevel>().ToDictionary(level => level, level => level.ToString().ToUpper().PadRight(Monitor.MaxLevelLength));
 
         /// <summary>A cache of messages that should only be logged once.</summary>
-        private readonly HashSet<LogOnceCacheEntry> LogOnceCache = new();
+        private readonly HashSet<LogOnceCacheKey> LogOnceCache = new();
 
         /// <summary>Get the screen ID that should be logged to distinguish between players in split-screen mode, if any.</summary>
         private readonly Func<int?> GetScreenIdForLog;
@@ -89,7 +87,7 @@ namespace StardewModdingAPI.Framework
         /// <inheritdoc />
         public void LogOnce(string message, LogLevel level = LogLevel.Trace)
         {
-            if (this.LogOnceCache.Add(new LogOnceCacheEntry(message, level)))
+            if (this.LogOnceCache.Add(new LogOnceCacheKey(message, level)))
                 this.LogImpl(this.Source, message, (ConsoleLogLevel)level);
         }
 
@@ -152,7 +150,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="level">The log level.</param>
         private string GenerateMessagePrefix(string source, ConsoleLogLevel level)
         {
-            string levelStr = LogStrings[level];
+            string levelStr = Monitor.LogStrings[level];
             int? playerIndex = this.GetScreenIdForLog();
 
             return $"[{DateTime.Now:HH:mm:ss} {levelStr}{(playerIndex != null ? $" screen_{playerIndex}" : "")} {source}]";

From a565ac9405a95d24f7cf945228935107e91bb89f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 8 Oct 2022 19:59:21 -0400
Subject: [PATCH 786/856] make GetApi methods mutually exclusive & improve docs

---
 .../Framework/ModHelpers/ModRegistryHelper.cs | 56 +++++++++----------
 src/SMAPI/Framework/SCore.cs                  |  5 ++
 src/SMAPI/IMod.cs                             | 12 ++--
 3 files changed, 37 insertions(+), 36 deletions(-)

diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 9ad3e3ae..8cc73481 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -68,49 +68,43 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 return null;
             }
 
-            // get our cached API if one is available
+            // get the target mod
             IModMetadata? mod = this.Registry.Get(uniqueID);
             if (mod == null)
                 return null;
 
-            if (this.AccessedModApis.ContainsKey(mod.Manifest.UniqueID))
+            // fetch API
+            if (!this.AccessedModApis.TryGetValue(mod.Manifest.UniqueID, out object? api))
             {
-                return this.AccessedModApis[mod.Manifest.UniqueID];
-            }
+                // if the target has a global API, this is mutually exclusive with per-mod APIs
+                if (mod.Api != null)
+                    api = mod.Api;
 
-            object? api;
-
-            // safely request a specific API instance
-            try
-            {
-                api = mod.Mod?.GetApi(this.Mod.Manifest);
-                if (api != null && !api.GetType().IsPublic)
+                // else try to get a per-mod API
+                else
                 {
-                    api = null;
-                    this.Monitor.Log($"{mod.DisplayName} provided a specific API instance with a non-public type. This isn't currently supported, so the specific API won't be available to the requesting mod.", LogLevel.Warn);
+                    try
+                    {
+                        api = mod.Mod?.GetApi(this.Mod.Manifest);
+                        if (api != null && !api.GetType().IsPublic)
+                        {
+                            api = null;
+                            this.Monitor.Log($"{mod.DisplayName} provides a per-mod API instance with a non-public type. This isn't currently supported, so the API won't be available to other mods.", LogLevel.Warn);
+                        }
+                    }
+                    catch (Exception ex)
+                    {
+                        this.Monitor.Log($"Failed loading the per-mod API instance from {mod.DisplayName}. Integrations with other mods may not work. Error: {ex.GetLogSummary()}", LogLevel.Error);
+                        api = null;
+                    }
                 }
 
+                // cache & log API access
+                this.AccessedModApis[mod.Manifest.UniqueID] = api;
                 if (api != null)
-                    this.Monitor.Log($"Accessed specific mod-provided API ({api.GetType().FullName}) for {mod.DisplayName}.");
-            }
-            catch (Exception ex)
-            {
-                this.Monitor.Log($"Failed loading specific mod-provided API for {mod.DisplayName}. Integrations with other mods may not work. Error: {ex.GetLogSummary()}", LogLevel.Error);
-                api = null;
+                    this.Monitor.Log($"Accessed mod-provided API ({api.GetType().FullName}) for {mod.DisplayName}.");
             }
 
-            // fall back to the generic API instance
-            if (api == null)
-            {
-                api = mod.Api;
-                if (api != null)
-                {
-                    this.Monitor.Log($"Accessed mod-provided API for {mod.DisplayName}.");
-                }
-            }
-
-            // cache the API instance and return it
-            this.AccessedModApis[mod.Manifest.UniqueID] = api;
             return api;
         }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 16ff2537..4ba0dd9c 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1779,6 +1779,11 @@ namespace StardewModdingAPI.Framework
                 {
                     this.Monitor.Log($"Failed loading mod-provided API for {metadata.DisplayName}. Integrations with other mods may not work. Error: {ex.GetLogSummary()}", LogLevel.Error);
                 }
+
+                // validate mod doesn't implement both GetApi() and GetApi(mod)
+                if (metadata.Api != null && metadata.Mod!.GetType().GetMethod(nameof(Mod.GetApi), new Type[] { typeof(IManifest) })!.DeclaringType != typeof(Mod))
+                    metadata.LogAsMod($"Mod implements both {nameof(Mod.GetApi)}() and {nameof(Mod.GetApi)}({nameof(IManifest)}), which isn't allowed. The latter will be ignored.", LogLevel.Error);
+
                 Context.HeuristicModsRunningCode.TryPop(out _);
             }
 
diff --git a/src/SMAPI/IMod.cs b/src/SMAPI/IMod.cs
index 6041bf66..4576246a 100644
--- a/src/SMAPI/IMod.cs
+++ b/src/SMAPI/IMod.cs
@@ -23,13 +23,15 @@ namespace StardewModdingAPI
         /// <param name="helper">Provides simplified APIs for writing mods.</param>
         void Entry(IModHelper helper);
 
-        /// <summary>Get an API that other mods can access. This is always called after <see cref="Entry"/>.</summary>
+        /// <summary>Get an <a href="https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations">API that other mods can access</a>. This is always called after <see cref="Entry"/>, and is only called once even if multiple mods access it.</summary>
+        /// <remarks>You can implement <see cref="GetApi()"/> to provide one instance to all mods, or <see cref="GetApi(IManifest)"/> to provide a separate instance per mod. These are mutually exclusive, so you can only implement one of them.</remarks>
+        /// <remarks>Returns the API instance, or <c>null</c> if the mod has no API.</remarks>
         object? GetApi();
 
-        /// <summary>Get an API that a specific other mod can access. This method is called the first time the other mod calls <see cref="IModRegistry.GetApi(string)"/> for this mod.</summary>
-        /// <param name="manifest">The other mod's manifest.</param>
-        /// <returns>Returns an API for another mod, or <c>null</c> if the other mod should use the general API returned from <see cref="GetApi()"/>.</returns>
+        /// <summary>Get an <a href="https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations">API that other mods can access</a>. This is always called after <see cref="Entry"/>, and is called once per mod that accesses the API (even if they access it multiple times).</summary>
+        /// <param name="manifest">The manifest for the mod accessing the API.</param>
+        /// <remarks>Returns the API instance, or <c>null</c> if the mod has no API. Note that the manifest is provided for informational purposes only, and that denying API access to specific mods is strongly discouraged and may be considered abusive.</remarks>
+        /// <inheritdoc cref="GetApi()" include="/Remarks" />
         object? GetApi(IManifest manifest);
-
     }
 }

From 8d6670cfc8abf7e71197d2f621314fb04a0543b8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 8 Oct 2022 20:33:01 -0400
Subject: [PATCH 787/856] pass mod info to GetApi instead

---
 src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs | 2 +-
 src/SMAPI/IMod.cs                                   | 6 +++---
 src/SMAPI/Mod.cs                                    | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
index 8cc73481..93edd597 100644
--- a/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModRegistryHelper.cs
@@ -85,7 +85,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 {
                     try
                     {
-                        api = mod.Mod?.GetApi(this.Mod.Manifest);
+                        api = mod.Mod?.GetApi(this.Mod);
                         if (api != null && !api.GetType().IsPublic)
                         {
                             api = null;
diff --git a/src/SMAPI/IMod.cs b/src/SMAPI/IMod.cs
index 4576246a..19d01311 100644
--- a/src/SMAPI/IMod.cs
+++ b/src/SMAPI/IMod.cs
@@ -24,14 +24,14 @@ namespace StardewModdingAPI
         void Entry(IModHelper helper);
 
         /// <summary>Get an <a href="https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations">API that other mods can access</a>. This is always called after <see cref="Entry"/>, and is only called once even if multiple mods access it.</summary>
-        /// <remarks>You can implement <see cref="GetApi()"/> to provide one instance to all mods, or <see cref="GetApi(IManifest)"/> to provide a separate instance per mod. These are mutually exclusive, so you can only implement one of them.</remarks>
+        /// <remarks>You can implement <see cref="GetApi()"/> to provide one instance to all mods, or <see cref="GetApi(IModInfo)"/> to provide a separate instance per mod. These are mutually exclusive, so you can only implement one of them.</remarks>
         /// <remarks>Returns the API instance, or <c>null</c> if the mod has no API.</remarks>
         object? GetApi();
 
         /// <summary>Get an <a href="https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations">API that other mods can access</a>. This is always called after <see cref="Entry"/>, and is called once per mod that accesses the API (even if they access it multiple times).</summary>
-        /// <param name="manifest">The manifest for the mod accessing the API.</param>
+        /// <param name="mod">The mod accessing the API.</param>
         /// <remarks>Returns the API instance, or <c>null</c> if the mod has no API. Note that the manifest is provided for informational purposes only, and that denying API access to specific mods is strongly discouraged and may be considered abusive.</remarks>
         /// <inheritdoc cref="GetApi()" include="/Remarks" />
-        object? GetApi(IManifest manifest);
+        object? GetApi(IModInfo mod);
     }
 }
diff --git a/src/SMAPI/Mod.cs b/src/SMAPI/Mod.cs
index 1a5f5594..01157886 100644
--- a/src/SMAPI/Mod.cs
+++ b/src/SMAPI/Mod.cs
@@ -31,7 +31,7 @@ namespace StardewModdingAPI
         }
 
         /// <inheritdoc />
-        public virtual object? GetApi(IManifest manifest)
+        public virtual object? GetApi(IModInfo mod)
         {
             return null;
         }

From ab66266b4bc4d7b1a7ae76d05693e9dd30c03989 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 8 Oct 2022 21:32:10 -0400
Subject: [PATCH 788/856] update installer for VdfConverter & rework avoid
 custom models

---
 build/windows/prepare-install-package.ps1     |  2 +-
 .../Framework/GameScanning/GameScanner.cs     | 44 ++++++++++-------
 .../GameScanning/SteamLibraryCollection.cs    | 47 -------------------
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj        |  2 +-
 4 files changed, 30 insertions(+), 65 deletions(-)
 delete mode 100644 src/SMAPI.Toolkit/Framework/GameScanning/SteamLibraryCollection.cs

diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index 87a4fe01..002bcbca 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -154,7 +154,7 @@ foreach ($folder in $folders) {
     cp -Recurse "$smapiBin/i18n" "$bundlePath/smapi-internal"
 
     # bundle smapi-internal
-    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "Pathoschild.Http.Client.dll", "Pintail.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml", "System.Net.Http.Formatting.dll")) {
+    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "Pathoschild.Http.Client.dll", "Pintail.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml", "System.Net.Http.Formatting.dll", "VdfConverter.dll")) {
         cp "$smapiBin/$name" "$bundlePath/smapi-internal"
     }
 
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 8e24dcdf..66465ffe 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -24,6 +24,9 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         /// <summary>The current OS.</summary>
         private readonly Platform Platform;
 
+        /// <summary>The Steam app ID for Stardew Valley.</summary>
+        private const string SteamAppId = "413150";
+
 
         /*********
         ** Public methods
@@ -146,7 +149,7 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
 #if SMAPI_FOR_WINDOWS
                         IDictionary<string, string> registryKeys = new Dictionary<string, string>
                         {
-                            [@"SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Steam App 413150"] = "InstallLocation", // Steam
+                            [@"SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Steam App " + GameScanner.SteamAppId] = "InstallLocation", // Steam
                             [@"SOFTWARE\WOW6432Node\GOG.com\Games\1453375253"] = "PATH", // GOG on 64-bit Windows
                         };
                         foreach (var pair in registryKeys)
@@ -160,9 +163,10 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
                         string? steamPath = this.GetCurrentUserRegistryValue(@"Software\Valve\Steam", "SteamPath");
                         if (steamPath != null)
                         {
+                            // conventional path
                             yield return Path.Combine(steamPath.Replace('/', '\\'), @"steamapps\common\Stardew Valley");
 
-                            // Check for Steam libraries in other locations
+                            // from Steam's .vdf file
                             string? path = this.GetPathFromSteamLibrary(steamPath);
                             if (!string.IsNullOrWhiteSpace(path))
                                 yield return path;
@@ -257,26 +261,34 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         /// <returns>The game directory, if found.</returns>
         private string? GetPathFromSteamLibrary(string? steamPath)
         {
-            string stardewAppId = "413150";
-            if (steamPath != null)
+            if (steamPath == null)
+                return null;
+
+            // get raw .vdf data
+            string libraryFoldersPath = Path.Combine(steamPath.Replace('/', '\\'), "steamapps\\libraryfolders.vdf");
+            using FileStream fileStream = File.OpenRead(libraryFoldersPath);
+            VdfDeserializer deserializer = new();
+            dynamic libraries = deserializer.Deserialize(fileStream);
+            if (libraries?.libraryfolders is null)
+                return null;
+
+            // get path from Stardew Valley app (if any)
+            foreach (dynamic pair in libraries.libraryfolders)
             {
-                string? libraryFoldersPath = Path.Combine(steamPath.Replace('/', '\\'), "steamapps\\libraryfolders.vdf");
-                using FileStream fs = File.OpenRead(libraryFoldersPath);
-                VdfDeserializer deserializer = new VdfDeserializer();
-                SteamLibraryCollection libraries = deserializer.Deserialize<SteamLibraryCollection>(fs);
-                if (libraries.libraryfolders != null)
+                dynamic library = pair.Value;
+
+                foreach (dynamic app in library.apps)
                 {
-                    var stardewLibrary = libraries.libraryfolders.FirstOrDefault(f =>
+                    string key = app.Key;
+                    if (key == GameScanner.SteamAppId)
                     {
-                        var apps = f.Value?.apps;
-                        return apps != null && apps.Any(a => a.Key.Equals(stardewAppId));
-                    });
-                    if (stardewLibrary.Value?.path != null)
-                    {
-                        return Path.Combine(stardewLibrary.Value.path.Replace("\\\\", "\\"), @"steamapps\common\Stardew Valley");
+                        string path = library.path;
+
+                        return Path.Combine(path.Replace("\\\\", "\\"), "steamapps", "common", "Stardew Valley");
                     }
                 }
             }
+
             return null;
         }
 #endif
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/SteamLibraryCollection.cs b/src/SMAPI.Toolkit/Framework/GameScanning/SteamLibraryCollection.cs
deleted file mode 100644
index 7a186f69..00000000
--- a/src/SMAPI.Toolkit/Framework/GameScanning/SteamLibraryCollection.cs
+++ /dev/null
@@ -1,47 +0,0 @@
-#if SMAPI_FOR_WINDOWS
-using System.Collections.Generic;
-
-namespace StardewModdingAPI.Toolkit.Framework.GameScanning
-{
-#pragma warning disable IDE1006 // Model requires lowercase naming.
-#pragma warning disable CS8618 // Required for model.
-    /// <summary>Model for Steam's libraryfolders.vdf.</summary>
-    public class SteamLibraryCollection
-    {
-        /// <summary>Each entry identifies a different location that part of the Steam games library is installed to.</summary>
-        public LibraryFolders<int, LibraryFolder> libraryfolders { get; set; }
-    }
-
-    /// <summary>A collection of LibraryFolders. Like a dictionary, but has contentstatsid used as an index also.</summary>
-    /// <typeparam name="TKey"></typeparam>
-    /// <typeparam name="TValue"></typeparam>
-#pragma warning disable CS8714 // Required for model.
-    public class LibraryFolders<TKey, TValue> : Dictionary<TKey, TValue>
-#pragma warning restore CS8714
-    {
-        /// <summary>Index of the library, starting from "0".</summary>
-        public string contentstatsid { get; set; }
-    }
-
-    /// <summary>A Steam library folder, containing information on the location and size of games installed there.</summary>
-    public class LibraryFolder
-    {
-        /// <summary>The escaped path to this Steam library folder. There will be a steam.exe here, but this may not be the one the player generally launches.</summary>
-        public string path { get; set; }
-        /// <summary>Label for the library, or ""</summary>
-        public string label { get; set; }
-        /// <summary>~19-digit identifier.</summary>
-        public string contentid { get; set; }
-        /// <summary>Size of the library in bytes. May show 0 when size is non-zero.</summary>
-        public string totalsize { get; set; }
-        /// <summary>Used for downloads.</summary>
-        public string update_clean_bytes_tally { get; set; }
-        /// <summary>Normally "0".</summary>
-        public string time_last_update_corruption { get; set; }
-        /// <summary>List of Steam app IDs, and their current size in bytes.</summary>
-        public Dictionary<string, string> apps { get; set; }
-    }
-#pragma warning restore IDE1006
-#pragma warning restore CS8618
-}
-#endif
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 411fd469..6080a85e 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -14,7 +14,7 @@
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.1.1" />
     <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
     <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
-    <PackageReference Include="VdfConverter" Version="1.0.3" />
+    <PackageReference Include="VdfConverter" Version="1.0.3" Condition="'$(OS)' == 'Windows_NT'" />
   </ItemGroup>
 
   <ItemGroup>

From a220e14f2d22f5d481c87bfd76d1b9eeaebf04e3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 13:50:24 -0400
Subject: [PATCH 789/856] polish recent changes & update release notes

---
 docs/release-notes.md                         |  7 +-
 .../Framework/ModScanning/ModScanner.cs       |  2 +-
 src/SMAPI/Framework/SCore.cs                  | 67 ++++++++++---------
 src/SMAPI/IMod.cs                             |  2 +-
 4 files changed, 44 insertions(+), 34 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4875d1cd..75e143e8 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,11 +9,16 @@
 
 ## Upcoming release
 * For players:
-  * Fixed update alert shown for a prerelease version on GitHub if it's not marked as prerelease.
+  * The SMAPI installer now also detects game folders listed in Steam's `.vdf` library data on Windows (thanks to pizzaoverhead!).
+  * Optimized performance and memory usage (thanks to atravita!).
+  * Added more file extensions to ignore when searching for mod folders: `.7z`, `.tar`, `.tar.gz`, and `.xcf` (thanks to atravita!).
+  * Fixed update alerts incorrectly shown for prerelease versions on GitHub that aren't marked as prerelease.
 
 * For mod authors:
+  * When [providing a mod API for a C# mod](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations), you can now get an optional parameter with the mod requesting the API (thanks to KhloeLeclair!). This avoids needing the pattern where each method needs the requesting mod's manifest.
   * SMAPI now treats square brackets in the manifest `Name` field as round brackets, to avoid breaking tools which parse log files.
   * Updated to [FluentHttpClient](https://github.com/Pathoschild/FluentHttpClient#readme) 4.2.0 (see [changes](https://github.com/Pathoschild/FluentHttpClient/blob/develop/RELEASE-NOTES.md#420)).
+  * Fixed `LocationListChanged` event not raised & memory leak occurring when a generated mine/volcano is removed (thanks to tylergibbs2!).
 
 ## 3.16.2
 Released 31 August 2022 for Stardew Valley 1.5.6 or later.
diff --git a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
index d115810a..5e9e3c35 100644
--- a/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/ModScanning/ModScanner.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI.Toolkit.Framework.ModScanning
             ".zip",
             ".7z",
             ".tar",
-            ".tar.gz"
+            ".tar.gz",
 
             // backup files
             ".backup",
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 4ba0dd9c..98eb2803 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1686,12 +1686,16 @@ namespace StardewModdingAPI.Framework
             this.Monitor.Log("Launching mods...", LogLevel.Debug);
             foreach (IModMetadata metadata in loadedMods)
             {
+                IMod mod =
+                    metadata.Mod
+                    ?? throw new InvalidOperationException($"The '{metadata.DisplayName}' mod is not initialized correctly."); // should never happen, but avoids nullability warnings
+
 #if SMAPI_DEPRECATED
                 // add interceptors
-                if (metadata.Mod?.Helper is ModHelper helper)
+                if (mod.Helper is ModHelper helper)
                 {
                     // ReSharper disable SuspiciousTypeConversion.Global
-                    if (metadata.Mod is IAssetEditor editor)
+                    if (mod is IAssetEditor editor)
                     {
                         SCore.DeprecationManager.Warn(
                             source: metadata,
@@ -1704,7 +1708,7 @@ namespace StardewModdingAPI.Framework
                         this.ContentCore.Editors.Add(new ModLinked<IAssetEditor>(metadata, editor));
                     }
 
-                    if (metadata.Mod is IAssetLoader loader)
+                    if (mod is IAssetLoader loader)
                     {
                         SCore.DeprecationManager.Warn(
                             source: metadata,
@@ -1749,41 +1753,42 @@ namespace StardewModdingAPI.Framework
                 }
 #endif
 
-                // call entry method
+                // initialize mod
                 Context.HeuristicModsRunningCode.Push(metadata);
-                try
                 {
-                    IMod mod = metadata.Mod!;
-                    mod.Entry(mod.Helper!);
-                }
-                catch (Exception ex)
-                {
-                    metadata.LogAsMod($"Mod crashed on entry and might not work correctly. Technical details:\n{ex.GetLogSummary()}", LogLevel.Error);
-                }
-
-                // get mod API
-                try
-                {
-                    object? api = metadata.Mod!.GetApi();
-                    if (api != null && !api.GetType().IsPublic)
+                    // call entry method
+                    try
                     {
-                        api = null;
-                        this.Monitor.Log($"{metadata.DisplayName} provides an API instance with a non-public type. This isn't currently supported, so the API won't be available to other mods.", LogLevel.Warn);
+                        mod.Entry(mod.Helper!);
+                    }
+                    catch (Exception ex)
+                    {
+                        metadata.LogAsMod($"Mod crashed on entry and might not work correctly. Technical details:\n{ex.GetLogSummary()}", LogLevel.Error);
                     }
 
-                    if (api != null)
-                        this.Monitor.Log($"   Found mod-provided API ({api.GetType().FullName}).");
-                    metadata.SetApi(api);
-                }
-                catch (Exception ex)
-                {
-                    this.Monitor.Log($"Failed loading mod-provided API for {metadata.DisplayName}. Integrations with other mods may not work. Error: {ex.GetLogSummary()}", LogLevel.Error);
-                }
+                    // get mod API
+                    try
+                    {
+                        object? api = mod.GetApi();
+                        if (api != null && !api.GetType().IsPublic)
+                        {
+                            api = null;
+                            this.Monitor.Log($"{metadata.DisplayName} provides an API instance with a non-public type. This isn't currently supported, so the API won't be available to other mods.", LogLevel.Warn);
+                        }
 
-                // validate mod doesn't implement both GetApi() and GetApi(mod)
-                if (metadata.Api != null && metadata.Mod!.GetType().GetMethod(nameof(Mod.GetApi), new Type[] { typeof(IManifest) })!.DeclaringType != typeof(Mod))
-                    metadata.LogAsMod($"Mod implements both {nameof(Mod.GetApi)}() and {nameof(Mod.GetApi)}({nameof(IManifest)}), which isn't allowed. The latter will be ignored.", LogLevel.Error);
+                        if (api != null)
+                            this.Monitor.Log($"   Found mod-provided API ({api.GetType().FullName}).");
+                        metadata.SetApi(api);
+                    }
+                    catch (Exception ex)
+                    {
+                        this.Monitor.Log($"Failed loading mod-provided API for {metadata.DisplayName}. Integrations with other mods may not work. Error: {ex.GetLogSummary()}", LogLevel.Error);
+                    }
 
+                    // validate mod doesn't implement both GetApi() and GetApi(mod)
+                    if (metadata.Api != null && mod.GetType().GetMethod(nameof(Mod.GetApi), new Type[] { typeof(IModInfo) })!.DeclaringType != typeof(Mod))
+                        metadata.LogAsMod($"Mod implements both {nameof(Mod.GetApi)}() and {nameof(Mod.GetApi)}({nameof(IModInfo)}), which isn't allowed. The latter will be ignored.", LogLevel.Error);
+                }
                 Context.HeuristicModsRunningCode.TryPop(out _);
             }
 
diff --git a/src/SMAPI/IMod.cs b/src/SMAPI/IMod.cs
index 19d01311..87c9880c 100644
--- a/src/SMAPI/IMod.cs
+++ b/src/SMAPI/IMod.cs
@@ -30,7 +30,7 @@ namespace StardewModdingAPI
 
         /// <summary>Get an <a href="https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations">API that other mods can access</a>. This is always called after <see cref="Entry"/>, and is called once per mod that accesses the API (even if they access it multiple times).</summary>
         /// <param name="mod">The mod accessing the API.</param>
-        /// <remarks>Returns the API instance, or <c>null</c> if the mod has no API. Note that the manifest is provided for informational purposes only, and that denying API access to specific mods is strongly discouraged and may be considered abusive.</remarks>
+        /// <remarks>Returns the API instance, or <c>null</c> if the mod has no API. Note that <paramref name="mod"/> is provided for informational purposes only, and that denying API access to specific mods is strongly discouraged and may be considered abusive.</remarks>
         /// <inheritdoc cref="GetApi()" include="/Remarks" />
         object? GetApi(IModInfo mod);
     }

From 3d10d08a1ac281620b60c0e5fd1d51b2da896a0d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 14:08:16 -0400
Subject: [PATCH 790/856] make deprecation warnings a bit stronger for the
 upcoming 4.0.0 release

---
 docs/release-notes.md                                  | 3 ++-
 src/SMAPI/Framework/Deprecations/DeprecationManager.cs | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 75e143e8..4352e2ba 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,7 +16,8 @@
 
 * For mod authors:
   * When [providing a mod API for a C# mod](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations), you can now get an optional parameter with the mod requesting the API (thanks to KhloeLeclair!). This avoids needing the pattern where each method needs the requesting mod's manifest.
-  * SMAPI now treats square brackets in the manifest `Name` field as round brackets, to avoid breaking tools which parse log files.
+  * SMAPI now treats square brackets in the manifest `Name` field as round ones to avoid breaking tools which parse log files.
+  * Made deprecation message wording stronger for the upcoming SMAPI 4.0.0 release.
   * Updated to [FluentHttpClient](https://github.com/Pathoschild/FluentHttpClient#readme) 4.2.0 (see [changes](https://github.com/Pathoschild/FluentHttpClient/blob/develop/RELEASE-NOTES.md#420)).
   * Fixed `LocationListChanged` event not raised & memory leak occurring when a generated mine/volcano is removed (thanks to tylergibbs2!).
 
diff --git a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index f58f085e..5a5850d1 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -101,7 +101,7 @@ namespace StardewModdingAPI.Framework.Deprecations
             foreach (DeprecationWarning warning in this.QueuedWarnings.OrderBy(p => p.ModName).ThenBy(p => p.NounPhrase))
             {
                 // build message
-                string message = $"{warning.ModName} uses deprecated code ({warning.NounPhrase} is deprecated since SMAPI {warning.Version}).";
+                string message = $"{warning.ModName} uses deprecated code ({warning.NounPhrase}) and will break in the upcoming SMAPI 4.0.0.";
 
                 // get log level
                 LogLevel level;

From 8dc12fd01c9274b045bafb04f02ef97fd8999c5d Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 14:30:40 -0400
Subject: [PATCH 791/856] optimize string splits

---
 docs/release-notes.md                                       | 1 +
 .../Framework/Commands/Player/SetColorCommand.cs            | 2 +-
 src/SMAPI.Tests/Utilities/KeybindListTests.cs               | 6 +++---
 src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs        | 4 ++--
 src/SMAPI/Framework/Logging/LogManager.cs                   | 2 +-
 src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs       | 2 +-
 src/SMAPI/Framework/SCore.cs                                | 2 +-
 src/SMAPI/Utilities/Keybind.cs                              | 4 ++--
 8 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4352e2ba..e4324d40 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,7 @@
 * For players:
   * The SMAPI installer now also detects game folders listed in Steam's `.vdf` library data on Windows (thanks to pizzaoverhead!).
   * Optimized performance and memory usage (thanks to atravita!).
+  * Other internal optimizations.
   * Added more file extensions to ignore when searching for mod folders: `.7z`, `.tar`, `.tar.gz`, and `.xcf` (thanks to atravita!).
   * Fixed update alerts incorrectly shown for prerelease versions on GitHub that aren't marked as prerelease.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
index 12a51bc9..ea9f1d82 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/SetColorCommand.cs
@@ -63,7 +63,7 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework.Commands.Player
         /// <param name="color">The color to set.</param>
         private bool TryParseColor(string input, out Color color)
         {
-            string[] colorHexes = input.Split(new[] { ',' }, 3);
+            string[] colorHexes = input.Split(',', 3);
             if (int.TryParse(colorHexes[0], out int r) && int.TryParse(colorHexes[1], out int g) && int.TryParse(colorHexes[2], out int b))
             {
                 color = new Color(r, g, b);
diff --git a/src/SMAPI.Tests/Utilities/KeybindListTests.cs b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
index c4c086de..c5fd5daf 100644
--- a/src/SMAPI.Tests/Utilities/KeybindListTests.cs
+++ b/src/SMAPI.Tests/Utilities/KeybindListTests.cs
@@ -136,11 +136,11 @@ namespace SMAPI.Tests.Utilities
             foreach (string rawPair in stateMap.Split(','))
             {
                 // parse values
-                string[] parts = rawPair.Split(new[] { ':' }, 2);
+                string[] parts = rawPair.Split(':', 2, StringSplitOptions.TrimEntries);
                 if (!Enum.TryParse(parts[0], ignoreCase: true, out SButton curButton))
-                    Assert.Fail($"The state map is invalid: unknown button value '{parts[0].Trim()}'");
+                    Assert.Fail($"The state map is invalid: unknown button value '{parts[0]}'");
                 if (!Enum.TryParse(parts[1], ignoreCase: true, out SButtonState state))
-                    Assert.Fail($"The state map is invalid: unknown state value '{parts[1].Trim()}'");
+                    Assert.Fail($"The state map is invalid: unknown state value '{parts[1]}'");
 
                 // get state
                 if (curButton == button)
diff --git a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
index 23b25f95..46c3092c 100644
--- a/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
+++ b/src/SMAPI.Web/Framework/Clients/Nexus/NexusClient.cs
@@ -121,10 +121,10 @@ namespace StardewModdingAPI.Web.Framework.Clients.Nexus
             HtmlNode? node = doc.DocumentNode.SelectSingleNode("//div[contains(@class, 'site-notice')][contains(@class, 'warning')]");
             if (node != null)
             {
-                string[] errorParts = node.InnerText.Trim().Split(new[] { '\n' }, 2, System.StringSplitOptions.RemoveEmptyEntries);
+                string[] errorParts = node.InnerText.Trim().Split('\n', 2, StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
                 string errorCode = errorParts[0];
                 string? errorText = errorParts.Length > 1 ? errorParts[1] : null;
-                switch (errorCode.Trim().ToLower())
+                switch (errorCode.ToLower())
                 {
                     case "not found":
                         return null;
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index c0b7c0ba..d5b33289 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -223,7 +223,7 @@ namespace StardewModdingAPI.Framework.Logging
             // show update alert
             if (File.Exists(Constants.UpdateMarker))
             {
-                string[] rawUpdateFound = File.ReadAllText(Constants.UpdateMarker).Split(new[] { '|' }, 2);
+                string[] rawUpdateFound = File.ReadAllText(Constants.UpdateMarker).Split('|', 2);
                 if (SemanticVersion.TryParse(rawUpdateFound[0], out ISemanticVersion? updateFound))
                 {
                     if (Constants.ApiVersion.IsPrerelease() && updateFound.IsNewerThan(Constants.ApiVersion))
diff --git a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
index f5d449c5..4dd9ccc6 100644
--- a/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
+++ b/src/SMAPI/Framework/ModLoading/Finders/EventFinder.cs
@@ -58,7 +58,7 @@ namespace StardewModdingAPI.Framework.ModLoading.Finders
                 MethodReference? methodRef = RewriteHelper.AsMethodReference(instruction);
                 if (methodRef != null && methodRef.DeclaringType.FullName == this.FullTypeName && this.MethodNames.Contains(methodRef.Name))
                 {
-                    string eventName = methodRef.Name.Split(new[] { '_' }, 2)[1];
+                    string eventName = methodRef.Name.Split('_', 2)[1];
                     this.MethodNames.Remove($"add_{eventName}");
                     this.MethodNames.Remove($"remove_{eventName}");
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 98eb2803..114c4bb3 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1384,7 +1384,7 @@ namespace StardewModdingAPI.Framework
                     }
 
                     // check min length for specific types
-                    switch (fields[SObject.objectInfoTypeIndex].Split(new[] { ' ' }, 2)[0])
+                    switch (fields[SObject.objectInfoTypeIndex].Split(' ', 2)[0])
                     {
                         case "Cooking":
                             if (fields.Length < SObject.objectInfoBuffDurationIndex + 1)
diff --git a/src/SMAPI/Utilities/Keybind.cs b/src/SMAPI/Utilities/Keybind.cs
index 3455ce77..3532620d 100644
--- a/src/SMAPI/Utilities/Keybind.cs
+++ b/src/SMAPI/Utilities/Keybind.cs
@@ -54,12 +54,12 @@ namespace StardewModdingAPI.Utilities
             }
 
             // parse buttons
-            string[] rawButtons = input.Split('+');
+            string[] rawButtons = input.Split('+', StringSplitOptions.TrimEntries);
             SButton[] buttons = new SButton[rawButtons.Length];
             List<string> rawErrors = new List<string>();
             for (int i = 0; i < buttons.Length; i++)
             {
-                string rawButton = rawButtons[i].Trim();
+                string rawButton = rawButtons[i];
                 if (string.IsNullOrWhiteSpace(rawButton))
                     rawErrors.Add("Invalid empty button value");
                 else if (!Enum.TryParse(rawButton, ignoreCase: true, out SButton button))

From d0704ef6f0040d10aa89e9cf1ee8d38098bff5df Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 14:34:31 -0400
Subject: [PATCH 792/856] fix nullability warnings

---
 src/SMAPI.Tests/Utilities/SemanticVersionTests.cs | 4 ++--
 src/SMAPI.Web/Views/LogParser/Index.cshtml        | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
index fedadba6..77c0da5f 100644
--- a/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
+++ b/src/SMAPI.Tests/Utilities/SemanticVersionTests.cs
@@ -382,11 +382,11 @@ namespace SMAPI.Tests.Utilities
         {
             // act
             string json = JsonConvert.SerializeObject(new SemanticVersion(versionStr));
-            SemanticVersion after = JsonConvert.DeserializeObject<SemanticVersion>(json);
+            SemanticVersion? after = JsonConvert.DeserializeObject<SemanticVersion>(json);
 
             // assert
             Assert.IsNotNull(after, "The semantic version after deserialization is unexpectedly null.");
-            Assert.AreEqual(versionStr, after.ToString(), "The semantic version after deserialization doesn't match the input version.");
+            Assert.AreEqual(versionStr, after!.ToString(), "The semantic version after deserialization doesn't match the input version.");
         }
 
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 24fe5fa2..b982bc0c 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -361,7 +361,7 @@ else if (log?.IsValid == true)
                         ContentPacks: contentPacks?.TryGetValue(mod.Name, out LogModInfo[]? contentPackList) == true ? contentPackList : Array.Empty<LogModInfo>()
                     ))
                     .ToList();
-                if (contentPacks?.TryGetValue("", out LogModInfo[] invalidPacks) == true)
+                if (contentPacks?.TryGetValue("", out LogModInfo[]? invalidPacks) == true)
                 {
                     modsWithContentPacks.Add((
                         Mod: new LogModInfo(ModType.CodeMod, "<invalid content packs>", "", "", ""),

From d143ab1077d7a3fb8638f0cc494aadf8688a0952 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 14:45:50 -0400
Subject: [PATCH 793/856] update to Harmony 2.2.2

---
 build/0Harmony.dll      | Bin 238592 -> 241152 bytes
 build/0Harmony.xml      |  27 +++++++++++++++++++++++++--
 docs/release-notes.md   |   2 +-
 docs/technical/smapi.md |   4 ++--
 4 files changed, 28 insertions(+), 5 deletions(-)

diff --git a/build/0Harmony.dll b/build/0Harmony.dll
index 492255be297ccadecefc747c15558e8ce06dd3af..72ca2b61010fba570cfa42f15e917c84324bfbdc 100644
GIT binary patch
literal 241152
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

literal 238592
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

diff --git a/build/0Harmony.xml b/build/0Harmony.xml
index 8499d20b..f1b9b4cf 100644
--- a/build/0Harmony.xml
+++ b/build/0Harmony.xml
@@ -845,7 +845,7 @@
             
         </member>
         <member name="F:HarmonyLib.ExceptionBlockType.BeginExceptFilterBlock">
-            <summary>The beginning of an except filter block</summary>
+            <summary>The beginning of an except filter block (currently not supported to use in a patch)</summary>
             
         </member>
         <member name="F:HarmonyLib.ExceptionBlockType.BeginFaultBlock">
@@ -2660,6 +2660,18 @@
              <param name="operand">The optional operand</param>
              <param name="name">The optional name</param>
             
+        </member>
+        <member name="M:HarmonyLib.CodeMatch.#ctor(System.Linq.Expressions.Expression{System.Action},System.String)">
+             <summary>Creates a code match that calls a method</summary>
+             <param name="expression">The lambda expression using the method</param>
+             <param name="name">The optional name</param>
+            
+        </member>
+        <member name="M:HarmonyLib.CodeMatch.#ctor(System.Linq.Expressions.LambdaExpression,System.String)">
+             <summary>Creates a code match that calls a method</summary>
+             <param name="expression">The lambda expression using the method</param>
+             <param name="name">The optional name</param>
+            
         </member>
         <member name="M:HarmonyLib.CodeMatch.#ctor(HarmonyLib.CodeInstruction,System.String)">
              <summary>Creates a code match</summary>
@@ -3216,6 +3228,13 @@
              <param name="e">The enum</param>
              <returns>True if the instruction loads the constant</returns>
             
+        </member>
+        <member name="M:HarmonyLib.CodeInstructionExtensions.LoadsConstant(HarmonyLib.CodeInstruction,System.String)">
+             <summary>Tests if the code instruction loads a string constant</summary>
+             <param name="code">The <see cref="T:HarmonyLib.CodeInstruction"/></param>
+             <param name="str">The string</param>
+             <returns>True if the instruction loads the constant</returns>
+            
         </member>
         <member name="M:HarmonyLib.CodeInstructionExtensions.LoadsField(HarmonyLib.CodeInstruction,System.Reflection.FieldInfo,System.Boolean)">
              <summary>Tests if the code instruction loads a field</summary>
@@ -3346,7 +3365,11 @@
              <summary>A file log for debugging</summary>
             
         </member>
-        <member name="F:HarmonyLib.FileLog.logPath">
+        <member name="P:HarmonyLib.FileLog.LogWriter">
+             <summary>Set this to make Harmony write its log content to this stream</summary>
+            
+        </member>
+        <member name="P:HarmonyLib.FileLog.LogPath">
              <summary>Full pathname of the log file, defaults to a file called <c>harmony.log.txt</c> on your Desktop</summary>
             
         </member>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index e4324d40..89883f87 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -19,7 +19,7 @@
   * When [providing a mod API for a C# mod](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations), you can now get an optional parameter with the mod requesting the API (thanks to KhloeLeclair!). This avoids needing the pattern where each method needs the requesting mod's manifest.
   * SMAPI now treats square brackets in the manifest `Name` field as round ones to avoid breaking tools which parse log files.
   * Made deprecation message wording stronger for the upcoming SMAPI 4.0.0 release.
-  * Updated to [FluentHttpClient](https://github.com/Pathoschild/FluentHttpClient#readme) 4.2.0 (see [changes](https://github.com/Pathoschild/FluentHttpClient/blob/develop/RELEASE-NOTES.md#420)).
+  * Updated dependencies: [Harmony](https://harmony.pardeike.net) 2.2.2 (see [changes](https://github.com/pardeike/Harmony/releases/tag/v2.2.2.0)) and [FluentHttpClient](https://github.com/Pathoschild/FluentHttpClient#readme) 4.2.0 (see [changes](https://github.com/Pathoschild/FluentHttpClient/blob/develop/RELEASE-NOTES.md#420)).
   * Fixed `LocationListChanged` event not raised & memory leak occurring when a generated mine/volcano is removed (thanks to tylergibbs2!).
 
 ## 3.16.2
diff --git a/docs/technical/smapi.md b/docs/technical/smapi.md
index b8a1683b..d115aefa 100644
--- a/docs/technical/smapi.md
+++ b/docs/technical/smapi.md
@@ -78,8 +78,8 @@ the `SMAPI` project with debugging from Visual Studio or Rider should launch SMA
 debugger attached, so you can intercept errors and step through the code being executed.
 
 ### Custom Harmony build
-SMAPI uses [a custom build of Harmony](https://github.com/Pathoschild/Harmony#readme), which is
-included in the `build` folder. To use a different build, just replace `0Harmony.dll` in that
+SMAPI uses [a custom build of Harmony 2.2.2](https://github.com/Pathoschild/Harmony#readme), which
+is included in the `build` folder. To use a different build, just replace `0Harmony.dll` in that
 folder before compiling.
 
 ## Prepare a release

From 42ff20cd92a3a28faca8de0c309396efa147f0e2 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 15:01:25 -0400
Subject: [PATCH 794/856] suppress Harmony debug mode by default

---
 docs/release-notes.md                 |  2 ++
 src/SMAPI/Framework/Models/SConfig.cs | 10 ++++++++--
 src/SMAPI/Framework/SCore.cs          |  9 +++++++++
 src/SMAPI/SMAPI.config.json           | 14 ++++++++------
 4 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 89883f87..4de0fa66 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -10,6 +10,8 @@
 ## Upcoming release
 * For players:
   * The SMAPI installer now also detects game folders listed in Steam's `.vdf` library data on Windows (thanks to pizzaoverhead!).
+  * SMAPI now prevents mods from enabling Harmony debug mode, which impacts performance and creates a file on your desktop.  
+    _You can allow debug mode by editing `smapi-internal/config.json` in your game folder._
   * Optimized performance and memory usage (thanks to atravita!).
   * Other internal optimizations.
   * Added more file extensions to ignore when searching for mod folders: `.7z`, `.tar`, `.tar.gz`, and `.xcf` (thanks to atravita!).
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 9444c046..b3061fba 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -23,7 +23,8 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
             [nameof(UseRawImageLoading)] = true,
-            [nameof(UseCaseInsensitivePaths)] = Constants.Platform is Platform.Android or Platform.Linux
+            [nameof(UseCaseInsensitivePaths)] = Constants.Platform is Platform.Android or Platform.Linux,
+            [nameof(SuppressHarmonyDebugMode)] = true
         };
 
         /// <summary>The default values for <see cref="SuppressUpdateChecks"/>, to log changes if different.</summary>
@@ -79,6 +80,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>The colors to use for text written to the SMAPI console.</summary>
         public ColorSchemeConfig ConsoleColors { get; set; }
 
+        /// <summary>Whether to prevent mods from enabling Harmony's debug mode, which impacts performance and creates a file on your desktop. Debug mode should never be enabled by a released mod.</summary>
+        public bool SuppressHarmonyDebugMode { get; set; }
+
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
         public HashSet<string> SuppressUpdateChecks { get; set; }
 
@@ -99,8 +103,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
+        /// <param name="suppressHarmonyDebugMode">Whether to prevent mods from enabling Harmony's debug mode, which impacts performance and creates a file on your desktop. Debug mode should never be enabled by a released mod.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useRawImageLoading, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useRawImageLoading, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
@@ -114,6 +119,7 @@ namespace StardewModdingAPI.Framework.Models
             this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(this.UseCaseInsensitivePaths)];
             this.LogNetworkTraffic = logNetworkTraffic ?? (bool)SConfig.DefaultValues[nameof(this.LogNetworkTraffic)];
             this.ConsoleColors = consoleColors;
+            this.SuppressHarmonyDebugMode = suppressHarmonyDebugMode ?? (bool)SConfig.DefaultValues[nameof(this.SuppressHarmonyDebugMode)];
             this.SuppressUpdateChecks = new HashSet<string>(suppressUpdateChecks ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
         }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 114c4bb3..3e6cd853 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -501,6 +501,15 @@ namespace StardewModdingAPI.Framework
                     return;
                 }
 
+                /*********
+                ** Prevent Harmony debug mode
+                *********/
+                if (HarmonyLib.Harmony.DEBUG && this.Settings.SuppressHarmonyDebugMode)
+                {
+                    HarmonyLib.Harmony.DEBUG = false;
+                    this.Monitor.LogOnce("A mod enabled Harmony debug mode, which impacts performance and creates a file on your desktop. SMAPI will try to keep it disabled. (You can allow debug mode by editing the smapi-internal/config.json file.)", LogLevel.Warn);
+                }
+
 #if SMAPI_DEPRECATED
                 /*********
                 ** Reload assets when interceptors are added/removed
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 97e8e00c..2d4239ba 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -54,12 +54,6 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "UseCaseInsensitivePaths": null,
 
-    /**
-     * Whether to use the experimental Pintail API proxying library, instead of the original
-     * proxying built into SMAPI itself.
-     */
-    "UsePintail": true,
-
     /**
      * Whether to use raw image data when possible, instead of initializing an XNA Texture2D
      * instance through the GPU.
@@ -138,6 +132,14 @@ copy all the settings, or you may cause bugs due to overridden changes in future
         }
     },
 
+    /**
+     * Whether to prevent mods from enabling Harmony's debug mode, which impacts performance and
+     * creates a file on your desktop. Debug mode should never be enabled by a released mod.
+     *
+     * If you actually need debug mode to test your own mod, set this to false.
+     */
+    "SuppressHarmonyDebugMode": true,
+
     /**
      * The mod IDs SMAPI should ignore when performing update checks or validating update keys.
      */

From 9a15da5a173e5e218c16e2e4ef0af0c98968e1cb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 16:59:05 -0400
Subject: [PATCH 795/856] add 'strict mode' release with deprecated APIs
 stripped out

---
 docs/release-notes.md                         |  1 +
 .../Framework/LogParsing/LogParser.cs         |  9 ++++++-
 .../Framework/LogParsing/Models/ParsedLog.cs  |  3 +++
 src/SMAPI.Web/Views/LogParser/Index.cshtml    | 25 ++++++++++++++++---
 .../wwwroot/Content/css/log-parser.css        |  5 ++++
 src/SMAPI/Framework/Logging/LogManager.cs     | 10 +++++++-
 src/SMAPI/Framework/SCore.cs                  |  9 ++++---
 7 files changed, 53 insertions(+), 9 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4de0fa66..5bf3b875 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,6 +9,7 @@
 
 ## Upcoming release
 * For players:
+  * You can now download SMAPI 'strict mode' from the [Nexus optional files](https://www.nexusmods.com/stardewvalley/mods/2400/). This removes all deprecated APIs, which may significantly improve performance. However mods which still show deprecation warnings won't work.
   * The SMAPI installer now also detects game folders listed in Steam's `.vdf` library data on Windows (thanks to pizzaoverhead!).
   * SMAPI now prevents mods from enabling Harmony debug mode, which impacts performance and creates a file on your desktop.  
     _You can allow debug mode by editing `smapi-internal/config.json` in your game folder._
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 18ba754c..5e0dedf3 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -199,8 +199,15 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                             log.ApiVersion = match.Groups["apiVersion"].Value;
                             log.GameVersion = match.Groups["gameVersion"].Value;
                             log.OperatingSystem = match.Groups["os"].Value;
-                            smapiMod.OverrideVersion(log.ApiVersion);
 
+                            const string strictModeSuffix = " (strict mode)";
+                            if (log.ApiVersion.EndsWith(strictModeSuffix))
+                            {
+                                log.IsStrictMode = true;
+                                log.ApiVersion = log.ApiVersion[..^strictModeSuffix.Length];
+                            }
+
+                            smapiMod.OverrideVersion(log.ApiVersion);
                             log.ApiVersionParsed = smapiMod.GetParsedVersion();
                         }
 
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
index 3f649199..cda0f653 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
@@ -25,6 +25,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         /****
         ** Log data
         ****/
+        /// <summary>Whether SMAPI is running in strict mode, which disables all deprecated APIs.</summary>
+        public bool IsStrictMode { get; set; }
+
         /// <summary>The SMAPI version.</summary>
         public string? ApiVersion { get; set; }
 
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index b982bc0c..28127903 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -40,7 +40,7 @@
         <meta name="robots" content="noindex" />
     }
     <link rel="stylesheet" href="~/Content/css/file-upload.css" />
-    <link rel="stylesheet" href="~/Content/css/log-parser.css" />
+    <link rel="stylesheet" href="~/Content/css/log-parser.css?r=20221009" />
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3/dist/css/tabby-ui-vertical.min.css" />
 
     <script src="https://cdn.jsdelivr.net/npm/tabbyjs@12.0.3" crossorigin="anonymous"></script>
@@ -243,7 +243,7 @@ else if (log?.IsValid == true)
 @if (log?.IsValid == true)
 {
     <div id="output">
-        @if (outdatedMods.Any() || errorHandler is null || hasOlderErrorHandler || isPyTkCompatibilityMode)
+        @if (outdatedMods.Any() || errorHandler is null || hasOlderErrorHandler || isPyTkCompatibilityMode || log.IsStrictMode)
         {
             <h2>Suggested fixes</h2>
             <ul id="fix-list">
@@ -257,7 +257,14 @@ else if (log?.IsValid == true)
                 }
                 @if (isPyTkCompatibilityMode)
                 {
-                    <li>PyTK 1.23.* or earlier isn't compatible with newer SMAPI performance optimizations. This may increase loading times or in-game lag.</li>
+                    if (log.IsStrictMode)
+                    {
+                        <li>PyTK's image scaling isn't compatible with SMAPI strict mode.</li>
+                    }
+                    else
+                    {
+                        <li>PyTK 1.23.* or earlier isn't compatible with newer SMAPI performance optimizations. This may increase loading times or in-game lag.</li>
+                    }
                 }
                 @if (outdatedMods.Any())
                 {
@@ -307,6 +314,10 @@ else if (log?.IsValid == true)
                         </table>
                     </li>
                 }
+                @if (log.IsStrictMode)
+                {
+                    <li class="notice">SMAPI is running in 'strict mode', which removes all deprecated APIs. This can significantly improve performance, but some mods may not work. You can <a href="https://stardewvalleywiki.com/Modding:Player_Guide#Install_SMAPI">reinstall SMAPI</a> to disable it if you run into problems.</li>
+                }
             </ul>
         }
 
@@ -329,7 +340,13 @@ else if (log?.IsValid == true)
             </tr>
             <tr>
                 <th>SMAPI:</th>
-                <td v-pre>@log.ApiVersion</td>
+                <td v-pre>
+                    @log.ApiVersion
+                    @if (log.IsStrictMode)
+                    {
+                        <strong>(strict mode)</strong>
+                    }
+                </td>
             </tr>
             <tr>
                 <th>Folder:</th>
diff --git a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
index f136a96f..995f5aa9 100644
--- a/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
+++ b/src/SMAPI.Web/wwwroot/Content/css/log-parser.css
@@ -73,6 +73,11 @@ table caption {
      margin-bottom: 0.5em;
 }
 
+#fix-list li.notice {
+    background: #EEFFEE;
+    border-color: #080;
+}
+
 #fix-list li.important {
     background: #FCC;
     border-color: #800;
diff --git a/src/SMAPI/Framework/Logging/LogManager.cs b/src/SMAPI/Framework/Logging/LogManager.cs
index d5b33289..ffffc9c7 100644
--- a/src/SMAPI/Framework/Logging/LogManager.cs
+++ b/src/SMAPI/Framework/Logging/LogManager.cs
@@ -269,7 +269,11 @@ namespace StardewModdingAPI.Framework.Logging
         public void LogIntro(string modsPath, IDictionary<string, object?> customSettings)
         {
             // log platform
-            this.Monitor.Log($"SMAPI {Constants.ApiVersion} with Stardew Valley {Constants.GameVersion} (build {Constants.GetBuildVersionLabel()}) on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
+            this.Monitor.Log($"SMAPI {Constants.ApiVersion} "
+#if !SMAPI_DEPRECATED
+                + "(strict mode) "
+#endif
+                + $"with Stardew Valley {Constants.GameVersion} (build {Constants.GetBuildVersionLabel()}) on {EnvironmentUtility.GetFriendlyPlatformName(Constants.Platform)}", LogLevel.Info);
 
             // log basic info
             this.Monitor.Log($"Mods go here: {modsPath}", LogLevel.Info);
@@ -280,6 +284,10 @@ namespace StardewModdingAPI.Framework.Logging
             // log custom settings
             if (customSettings.Any())
                 this.Monitor.Log($"Loaded with custom settings: {string.Join(", ", customSettings.OrderBy(p => p.Key).Select(p => $"{p.Key}: {p.Value}"))}");
+
+#if !SMAPI_DEPRECATED
+            this.Monitor.Log("SMAPI is running in 'strict mode', which removes all deprecated APIs. This can significantly improve performance, but some mods may not work. You can reinstall SMAPI to disable it if you run into problems.", LogLevel.Info);
+#endif
         }
 
         /// <summary>Log details for settings that don't match the default.</summary>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 3e6cd853..4d6deb15 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1681,15 +1681,18 @@ namespace StardewModdingAPI.Framework
             // initialize translations
             this.ReloadTranslations(loaded);
 
-#if SMAPI_DEPRECATED
             // set temporary PyTK compatibility mode
             // This is part of a three-part fix for PyTK 1.23.* and earlier. When removing this,
             // search 'Platonymous.Toolkit' to find the other part in SMAPI and Content Patcher.
             {
                 IModInfo? pyTk = this.ModRegistry.Get("Platonymous.Toolkit");
-                ModContentManager.EnablePyTkLegacyMode = pyTk is not null && pyTk.Manifest.Version.IsOlderThan("1.24.0");
-            }
+                if (pyTk is not null && pyTk.Manifest.Version.IsOlderThan("1.24.0"))
+#if SMAPI_DEPRECATED
+                    ModContentManager.EnablePyTkLegacyMode = true;
+#else
+                    this.Monitor.Log("PyTK's image scaling is not compatible with SMAPI strict mode.", LogLevel.Warn);
 #endif
+            }
 
             // initialize loaded non-content-pack mods
             this.Monitor.Log("Launching mods...", LogLevel.Debug);

From 037d7e357b169936fa858f6c8b9c1388ca75840b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 17:39:11 -0400
Subject: [PATCH 796/856] set texture name earlier to support mods like
 SpriteMaster

---
 docs/release-notes.md                         |  1 +
 .../Framework/Content/AssetDataForImage.cs    |  2 +-
 .../ContentManagers/BaseContentManager.cs     |  2 +-
 .../ContentManagers/ModContentManager.cs      |  4 +--
 src/SMAPI/Framework/InternalExtensions.cs     | 30 +++++++++++++++++++
 5 files changed, 35 insertions(+), 4 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 5bf3b875..da3db590 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -22,6 +22,7 @@
   * When [providing a mod API for a C# mod](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations), you can now get an optional parameter with the mod requesting the API (thanks to KhloeLeclair!). This avoids needing the pattern where each method needs the requesting mod's manifest.
   * SMAPI now treats square brackets in the manifest `Name` field as round ones to avoid breaking tools which parse log files.
   * Made deprecation message wording stronger for the upcoming SMAPI 4.0.0 release.
+  * The `Texture2D.Name` field is now set earlier to support mods like SpriteMaster.
   * Updated dependencies: [Harmony](https://harmony.pardeike.net) 2.2.2 (see [changes](https://github.com/pardeike/Harmony/releases/tag/v2.2.2.0)) and [FluentHttpClient](https://github.com/Pathoschild/FluentHttpClient#readme) 4.2.0 (see [changes](https://github.com/Pathoschild/FluentHttpClient/blob/develop/RELEASE-NOTES.md#420)).
   * Fixed `LocationListChanged` event not raised & memory leak occurring when a generated mine/volcano is removed (thanks to tylergibbs2!).
 
diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 0380dd9e..241c09a8 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -106,7 +106,7 @@ namespace StardewModdingAPI.Framework.Content
                 return false;
 
             Texture2D original = this.Data;
-            Texture2D texture = new(Game1.graphics.GraphicsDevice, Math.Max(original.Width, minWidth), Math.Max(original.Height, minHeight));
+            Texture2D texture = new Texture2D(Game1.graphics.GraphicsDevice, Math.Max(original.Width, minWidth), Math.Max(original.Height, minHeight)).SetName(original.Name);
             this.ReplaceWith(texture);
             this.PatchImage(original);
             return true;
diff --git a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
index 54f8e2a2..1e9f4ffe 100644
--- a/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/BaseContentManager.cs
@@ -336,7 +336,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             // track asset key
             if (value is Texture2D texture)
-                texture.Name = assetName.Name;
+                texture.SetName(assetName);
 
             // save to cache
             // Note: even if the asset was loaded and cached right before this method was called,
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 72dcf6e1..30dd4215 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -232,7 +232,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
                     return (T)raw;
                 else
                 {
-                    Texture2D texture = new(Game1.graphics.GraphicsDevice, raw.Width, raw.Height);
+                    Texture2D texture = new Texture2D(Game1.graphics.GraphicsDevice, raw.Width, raw.Height).SetName(assetName);
                     texture.SetData(raw.Data);
                     return (T)(object)texture;
                 }
@@ -240,7 +240,7 @@ namespace StardewModdingAPI.Framework.ContentManagers
             else
             {
                 using FileStream stream = File.OpenRead(file.FullName);
-                Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream);
+                Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream).SetName(assetName);
                 this.PremultiplyTransparency(texture);
                 return (T)(object)texture;
             }
diff --git a/src/SMAPI/Framework/InternalExtensions.cs b/src/SMAPI/Framework/InternalExtensions.cs
index ba9bbcec..7ad30d35 100644
--- a/src/SMAPI/Framework/InternalExtensions.cs
+++ b/src/SMAPI/Framework/InternalExtensions.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Threading;
 using Microsoft.Xna.Framework.Graphics;
@@ -163,5 +164,34 @@ namespace StardewModdingAPI.Framework
         {
             return reflection.GetField<bool>(spriteBatch, "_beginCalled").GetValue();
         }
+
+        /****
+        ** Texture2D
+        ****/
+        /// <summary>Set the texture name field.</summary>
+        /// <param name="texture">The texture whose name to set.</param>
+        /// <param name="assetName">The asset name to set.</param>
+        /// <returns>Returns the texture for chaining.</returns>
+        [return: NotNullIfNotNull("texture")]
+        public static Texture2D? SetName(this Texture2D? texture, IAssetName assetName)
+        {
+            if (texture != null)
+                texture.Name = assetName.Name;
+
+            return texture;
+        }
+
+        /// <summary>Set the texture name field.</summary>
+        /// <param name="texture">The texture whose name to set.</param>
+        /// <param name="assetName">The asset name to set.</param>
+        /// <returns>Returns the texture for chaining.</returns>
+        [return: NotNullIfNotNull("texture")]
+        public static Texture2D? SetName(this Texture2D? texture, string assetName)
+        {
+            if (texture != null)
+                texture.Name = assetName;
+
+            return texture;
+        }
     }
 }

From b78b269cf53529bcb73fa99538a3e9eb23e283b0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 17:56:33 -0400
Subject: [PATCH 797/856] split PyTK raw-image-load check into a separate
 method so it can be patched by mods like SpriteMaster

---
 .../ContentManagers/ModContentManager.cs      | 51 ++++++++++++-------
 1 file changed, 32 insertions(+), 19 deletions(-)

diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index 30dd4215..ddb6f6f5 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -204,31 +204,22 @@ namespace StardewModdingAPI.Framework.ContentManagers
         private T LoadImageFile<T>(IAssetName assetName, FileInfo file)
         {
             this.AssertValidType<T>(assetName, file, typeof(Texture2D), typeof(IRawTextureData));
-            bool expectsRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
-            bool asRawData = expectsRawData || this.UseRawImageLoading;
-
+            bool returnRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
+            bool loadRawData =
+                returnRawData
+                || (
+                    this.UseRawImageLoading
 #if SMAPI_DEPRECATED
-            // disable raw data if PyTK will rescale the image (until it supports raw data)
-            if (asRawData && !expectsRawData)
-            {
-                if (ModContentManager.EnablePyTkLegacyMode)
-                {
-                    // PyTK intercepts Texture2D file loads to rescale them (e.g. for HD portraits),
-                    // but doesn't support IRawTextureData loads yet. We can't just check if the
-                    // current file has a '.pytk.json' rescale file though, since PyTK may still
-                    // rescale it if the original asset or another edit gets rescaled.
-                    asRawData = false;
-                    this.Monitor.LogOnce("Enabled compatibility mode for PyTK 1.23.* or earlier. This won't cause any issues, but may impact performance. This will no longer be supported in the upcoming SMAPI 4.0.0.", LogLevel.Warn);
-                }
-            }
+                    && !this.ShouldDisableIntermediateRawDataLoad<T>(assetName, file)
 #endif
+                );
 
             // load
-            if (asRawData)
+            if (loadRawData)
             {
-                IRawTextureData raw = this.LoadRawImageData(file, expectsRawData);
+                IRawTextureData raw = this.LoadRawImageData(file, returnRawData);
 
-                if (expectsRawData)
+                if (returnRawData)
                     return (T)raw;
                 else
                 {
@@ -246,6 +237,28 @@ namespace StardewModdingAPI.Framework.ContentManagers
             }
         }
 
+#if SMAPI_DEPRECATED
+        /// <summary>Get whether to disable loading an image as <see cref="IRawTextureData"/> before building a <see cref="Texture2D"/> instance. This isn't called if the mod requested <see cref="IRawTextureData"/> directly.</summary>
+        /// <typeparam name="T">The type of asset being loaded.</typeparam>
+        /// <param name="assetName">The asset name relative to the loader root directory.</param>
+        /// <param name="file">The file being loaded.</param>
+        private bool ShouldDisableIntermediateRawDataLoad<T>(IAssetName assetName, FileInfo file)
+        {
+            // disable raw data if PyTK will rescale the image (until it supports raw data)
+            if (ModContentManager.EnablePyTkLegacyMode)
+            {
+                // PyTK intercepts Texture2D file loads to rescale them (e.g. for HD portraits),
+                // but doesn't support IRawTextureData loads yet. We can't just check if the
+                // current file has a '.pytk.json' rescale file though, since PyTK may still
+                // rescale it if the original asset or another edit gets rescaled.
+                this.Monitor.LogOnce("Enabled compatibility mode for PyTK 1.23.* or earlier. This won't cause any issues, but may impact performance. This will no longer be supported in the upcoming SMAPI 4.0.0.", LogLevel.Warn);
+                return true;
+            }
+
+            return false;
+        }
+#endif
+
         /// <summary>Load the raw image data from a file on disk.</summary>
         /// <param name="file">The file whose data to load.</param>
         /// <param name="forRawData">Whether the data is being loaded for an <see cref="IRawTextureData"/> (true) or <see cref="Texture2D"/> (false) instance.</param>

From 27856ebea25791d2d82a42a670327f6dd5c4ac23 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 18:03:05 -0400
Subject: [PATCH 798/856] drop UseRawImageLoading option

Raw image loading is now always enabled, except in PyTK compatibility mode.
---
 docs/release-notes.md                         |  1 +
 src/SMAPI/Framework/ContentCoordinator.cs     | 10 +----
 .../ContentManagers/ModContentManager.cs      | 44 +++++++------------
 src/SMAPI/Framework/Models/SConfig.cs         |  8 +---
 src/SMAPI/Framework/SCore.cs                  |  3 +-
 src/SMAPI/SMAPI.config.json                   |  6 ---
 6 files changed, 20 insertions(+), 52 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index da3db590..b5a0adaf 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -16,6 +16,7 @@
   * Optimized performance and memory usage (thanks to atravita!).
   * Other internal optimizations.
   * Added more file extensions to ignore when searching for mod folders: `.7z`, `.tar`, `.tar.gz`, and `.xcf` (thanks to atravita!).
+  * Removed `UseRawImageLoading` option. This is now always enabled, except when PyTK is installed.
   * Fixed update alerts incorrectly shown for prerelease versions on GitHub that aren't marked as prerelease.
 
 * For mod authors:
diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index 9e044b44..cf26307f 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -34,9 +34,6 @@ namespace StardewModdingAPI.Framework
         /// <summary>An asset key prefix for assets from SMAPI mod folders.</summary>
         private readonly string ManagedPrefix = "SMAPI";
 
-        /// <summary>Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</summary>
-        private readonly bool UseRawImageLoading;
-
         /// <summary>Get a file lookup for the given directory.</summary>
         private readonly Func<string, IFileLookup> GetFileLookup;
 
@@ -139,8 +136,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="getFileLookup">Get a file lookup for the given directory.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations, bool useRawImageLoading)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations)
         {
             this.GetFileLookup = getFileLookup;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
@@ -151,7 +147,6 @@ namespace StardewModdingAPI.Framework
             this.OnAssetsInvalidated = onAssetsInvalidated;
             this.RequestAssetOperations = requestAssetOperations;
             this.FullRootDirectory = Path.Combine(Constants.GamePath, rootDirectory);
-            this.UseRawImageLoading = useRawImageLoading;
             this.ContentManagers.Add(
                 this.MainContentManager = new GameContentManager(
                     name: "Game1.content",
@@ -230,8 +225,7 @@ namespace StardewModdingAPI.Framework
                     reflection: this.Reflection,
                     jsonHelper: this.JsonHelper,
                     onDisposing: this.OnDisposing,
-                    fileLookup: this.GetFileLookup(rootDirectory),
-                    useRawImageLoading: this.UseRawImageLoading
+                    fileLookup: this.GetFileLookup(rootDirectory)
                 );
                 this.ContentManagers.Add(manager);
                 return manager;
diff --git a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
index ddb6f6f5..badbd766 100644
--- a/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
+++ b/src/SMAPI/Framework/ContentManagers/ModContentManager.cs
@@ -30,9 +30,6 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /*********
         ** Fields
         *********/
-        /// <summary>Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</summary>
-        private readonly bool UseRawImageLoading;
-
         /// <summary>Encapsulates SMAPI's JSON file parsing.</summary>
         private readonly JsonHelper JsonHelper;
 
@@ -74,15 +71,13 @@ namespace StardewModdingAPI.Framework.ContentManagers
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onDisposing">A callback to invoke when the content manager is being disposed.</param>
         /// <param name="fileLookup">A lookup for files within the <paramref name="rootDirectory"/>.</param>
-        /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
-        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup, bool useRawImageLoading)
+        public ModContentManager(string name, IContentManager gameContentManager, IServiceProvider serviceProvider, string modName, string rootDirectory, CultureInfo currentCulture, ContentCoordinator coordinator, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action<BaseContentManager> onDisposing, IFileLookup fileLookup)
             : base(name, serviceProvider, rootDirectory, currentCulture, coordinator, monitor, reflection, onDisposing, isNamespaced: true)
         {
             this.GameContentManager = gameContentManager;
             this.FileLookup = fileLookup;
             this.JsonHelper = jsonHelper;
             this.ModName = modName;
-            this.UseRawImageLoading = useRawImageLoading;
 
             this.TryLocalizeKeys = false;
         }
@@ -205,36 +200,27 @@ namespace StardewModdingAPI.Framework.ContentManagers
         {
             this.AssertValidType<T>(assetName, file, typeof(Texture2D), typeof(IRawTextureData));
             bool returnRawData = typeof(T).IsAssignableTo(typeof(IRawTextureData));
-            bool loadRawData =
-                returnRawData
-                || (
-                    this.UseRawImageLoading
+
 #if SMAPI_DEPRECATED
-                    && !this.ShouldDisableIntermediateRawDataLoad<T>(assetName, file)
-#endif
-                );
-
-            // load
-            if (loadRawData)
-            {
-                IRawTextureData raw = this.LoadRawImageData(file, returnRawData);
-
-                if (returnRawData)
-                    return (T)raw;
-                else
-                {
-                    Texture2D texture = new Texture2D(Game1.graphics.GraphicsDevice, raw.Width, raw.Height).SetName(assetName);
-                    texture.SetData(raw.Data);
-                    return (T)(object)texture;
-                }
-            }
-            else
+            if (!returnRawData && this.ShouldDisableIntermediateRawDataLoad<T>(assetName, file))
             {
                 using FileStream stream = File.OpenRead(file.FullName);
                 Texture2D texture = Texture2D.FromStream(Game1.graphics.GraphicsDevice, stream).SetName(assetName);
                 this.PremultiplyTransparency(texture);
                 return (T)(object)texture;
             }
+#endif
+
+            IRawTextureData raw = this.LoadRawImageData(file, returnRawData);
+
+            if (returnRawData)
+                return (T)raw;
+            else
+            {
+                Texture2D texture = new Texture2D(Game1.graphics.GraphicsDevice, raw.Width, raw.Height).SetName(assetName);
+                texture.SetData(raw.Data);
+                return (T)(object)texture;
+            }
         }
 
 #if SMAPI_DEPRECATED
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index b3061fba..bceb0940 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -22,7 +22,6 @@ namespace StardewModdingAPI.Framework.Models
             [nameof(WebApiBaseUrl)] = "https://smapi.io/api/",
             [nameof(LogNetworkTraffic)] = false,
             [nameof(RewriteMods)] = true,
-            [nameof(UseRawImageLoading)] = true,
             [nameof(UseCaseInsensitivePaths)] = Constants.Platform is Platform.Android or Platform.Linux,
             [nameof(SuppressHarmonyDebugMode)] = true
         };
@@ -68,9 +67,6 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether SMAPI should rewrite mods for compatibility.</summary>
         public bool RewriteMods { get; set; }
 
-        /// <summary>Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</summary>
-        public bool UseRawImageLoading { get; set; }
-
         /// <summary>Whether to make SMAPI file APIs case-insensitive, even on Linux.</summary>
         public bool UseCaseInsensitivePaths { get; set; }
 
@@ -99,13 +95,12 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="webApiBaseUrl">The base URL for SMAPI's web API, used to perform update checks.</param>
         /// <param name="verboseLogging">The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</param>
         /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
-        /// <param name="useRawImageLoading">Whether to use raw image data when possible, instead of initializing an XNA Texture2D instance through the GPU.</param>
         /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
         /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressHarmonyDebugMode">Whether to prevent mods from enabling Harmony's debug mode, which impacts performance and creates a file on your desktop. Debug mode should never be enabled by a released mod.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useRawImageLoading, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks)
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
@@ -115,7 +110,6 @@ namespace StardewModdingAPI.Framework.Models
             this.WebApiBaseUrl = webApiBaseUrl;
             this.VerboseLogging = new HashSet<string>(verboseLogging ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
             this.RewriteMods = rewriteMods ?? (bool)SConfig.DefaultValues[nameof(this.RewriteMods)];
-            this.UseRawImageLoading = useRawImageLoading ?? (bool)SConfig.DefaultValues[nameof(this.UseRawImageLoading)];
             this.UseCaseInsensitivePaths = useCaseInsensitivePaths ?? (bool)SConfig.DefaultValues[nameof(this.UseCaseInsensitivePaths)];
             this.LogNetworkTraffic = logNetworkTraffic ?? (bool)SConfig.DefaultValues[nameof(this.LogNetworkTraffic)];
             this.ConsoleColors = consoleColors;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 4d6deb15..40979b09 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1333,8 +1333,7 @@ namespace StardewModdingAPI.Framework
                     onAssetLoaded: this.OnAssetLoaded,
                     onAssetsInvalidated: this.OnAssetsInvalidated,
                     getFileLookup: this.GetFileLookup,
-                    requestAssetOperations: this.RequestAssetOperations,
-                    useRawImageLoading: this.Settings.UseRawImageLoading
+                    requestAssetOperations: this.RequestAssetOperations
                 );
                 if (this.ContentCore.Language != this.Translator.LocaleEnum)
                     this.Translator.SetLocale(this.ContentCore.GetLocale(), this.ContentCore.Language);
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 2d4239ba..635e3add 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -54,12 +54,6 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "UseCaseInsensitivePaths": null,
 
-    /**
-     * Whether to use raw image data when possible, instead of initializing an XNA Texture2D
-     * instance through the GPU.
-     */
-    "UseRawImageLoading": true,
-
     /**
      * Whether to add a section to the 'mod issues' list for mods which directly use potentially
      * sensitive .NET APIs like file or shell access. Note that many mods do this legitimately as

From 4d2ad379b4198fa7a341c6ba2bb6455d488b414f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 19:29:18 -0400
Subject: [PATCH 799/856] fix package error

---
 build/windows/prepare-install-package.ps1 | 6 +++++-
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj    | 2 +-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/build/windows/prepare-install-package.ps1 b/build/windows/prepare-install-package.ps1
index 002bcbca..71de1154 100644
--- a/build/windows/prepare-install-package.ps1
+++ b/build/windows/prepare-install-package.ps1
@@ -154,10 +154,14 @@ foreach ($folder in $folders) {
     cp -Recurse "$smapiBin/i18n" "$bundlePath/smapi-internal"
 
     # bundle smapi-internal
-    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "Pathoschild.Http.Client.dll", "Pintail.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml", "System.Net.Http.Formatting.dll", "VdfConverter.dll")) {
+    foreach ($name in @("0Harmony.dll", "0Harmony.xml", "Mono.Cecil.dll", "Mono.Cecil.Mdb.dll", "Mono.Cecil.Pdb.dll", "MonoMod.Common.dll", "Newtonsoft.Json.dll", "Pathoschild.Http.Client.dll", "Pintail.dll", "TMXTile.dll", "SMAPI.Toolkit.dll", "SMAPI.Toolkit.pdb", "SMAPI.Toolkit.xml", "SMAPI.Toolkit.CoreInterfaces.dll", "SMAPI.Toolkit.CoreInterfaces.pdb", "SMAPI.Toolkit.CoreInterfaces.xml", "System.Net.Http.Formatting.dll")) {
         cp "$smapiBin/$name" "$bundlePath/smapi-internal"
     }
 
+    if ($folder -eq "windows") {
+        cp "$smapiBin/VdfConverter.dll" "$bundlePath/smapi-internal"
+    }
+
     cp "$smapiBin/SMAPI.config.json" "$bundlePath/smapi-internal/config.json"
     cp "$smapiBin/SMAPI.metadata.json" "$bundlePath/smapi-internal/metadata.json"
     if ($folder -eq "linux" -or $folder -eq "macOS") {
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 0086f38a..10f1df70 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -14,7 +14,7 @@
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.2.0" />
     <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
     <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
-    <PackageReference Include="VdfConverter" Version="1.0.3" Condition="'$(OS)' == 'Windows_NT'" />
+    <PackageReference Include="VdfConverter" Version="1.0.3" Condition="'$(OS)' == 'Windows_NT'" Private="False" />
   </ItemGroup>
 
   <ItemGroup>

From ee77efcc976ef1a5ee64933a6174d2fac9c6d0f9 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 9 Oct 2022 19:42:24 -0400
Subject: [PATCH 800/856] prepare for release

---
 build/common.targets                                 |  2 +-
 docs/release-notes.md                                | 12 +++++++-----
 docs/technical/mod-package.md                        |  4 +++-
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj |  2 +-
 src/SMAPI.Mods.ConsoleCommands/manifest.json         |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json            |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json              |  4 ++--
 src/SMAPI/Constants.cs                               |  2 +-
 8 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 7fe66fab..02cf69bd 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.16.2</Version>
+    <Version>3.17.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index b5a0adaf..7574d62b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,20 +7,22 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.17.0
+Released 09 October 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/73090322).
+
 * For players:
-  * You can now download SMAPI 'strict mode' from the [Nexus optional files](https://www.nexusmods.com/stardewvalley/mods/2400/). This removes all deprecated APIs, which may significantly improve performance. However mods which still show deprecation warnings won't work.
-  * The SMAPI installer now also detects game folders listed in Steam's `.vdf` library data on Windows (thanks to pizzaoverhead!).
+  * You can now download SMAPI 'strict mode' from [Nexus files](https://www.nexusmods.com/stardewvalley/mods/2400/?tab=files), which removes all deprecated APIs. This may significantly improve performance, but mods which still show deprecation warnings won't work.
+  * The SMAPI installer now also detects game folders in Steam's `.vdf` library data on Windows (thanks to pizzaoverhead!).
   * SMAPI now prevents mods from enabling Harmony debug mode, which impacts performance and creates a file on your desktop.  
     _You can allow debug mode by editing `smapi-internal/config.json` in your game folder._
   * Optimized performance and memory usage (thanks to atravita!).
   * Other internal optimizations.
   * Added more file extensions to ignore when searching for mod folders: `.7z`, `.tar`, `.tar.gz`, and `.xcf` (thanks to atravita!).
-  * Removed `UseRawImageLoading` option. This is now always enabled, except when PyTK is installed.
+  * Removed transitional `UseRawImageLoading` option added in 3.15.0. This is now always enabled, except when PyTK is installed.
   * Fixed update alerts incorrectly shown for prerelease versions on GitHub that aren't marked as prerelease.
 
 * For mod authors:
-  * When [providing a mod API for a C# mod](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations), you can now get an optional parameter with the mod requesting the API (thanks to KhloeLeclair!). This avoids needing the pattern where each method needs the requesting mod's manifest.
+  * When [providing a mod API in a C# mod](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Integrations), you can now get the mod requesting it as an optional parameter (thanks to KhloeLeclair!).
   * SMAPI now treats square brackets in the manifest `Name` field as round ones to avoid breaking tools which parse log files.
   * Made deprecation message wording stronger for the upcoming SMAPI 4.0.0 release.
   * The `Texture2D.Name` field is now set earlier to support mods like SpriteMaster.
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index c483754e..77260a57 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -412,7 +412,9 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
-### Upcoming release
+### 4.0.2
+Released 09 October 2022.
+
 * Switched to the newer crossplatform `portable` debug symbols (thanks to lanturnalis!).
 * Fixed `BundleExtraAssemblies` option being partly case-sensitive.
 * Fixed `BundleExtraAssemblies` not applying `All` value to game assemblies.
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index e25da168..cded6f65 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -10,7 +10,7 @@
     <!--NuGet package-->
     <PackageId>Pathoschild.Stardew.ModBuildConfig</PackageId>
     <Title>Build package for SMAPI mods</Title>
-    <Version>4.0.1</Version>
+    <Version>4.0.2</Version>
     <Authors>Pathoschild</Authors>
     <Description>Automates the build configuration for crossplatform Stardew Valley SMAPI mods. For SMAPI 3.13.0 or later.</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index abe8b334..754e543a 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.16.2",
+    "Version": "3.17.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.16.2"
+    "MinimumApiVersion": "3.17.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index b6764bc0..8f94e5ab 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.16.2",
+    "Version": "3.17.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.16.2"
+    "MinimumApiVersion": "3.17.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index a2657168..a9401fc3 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.16.2",
+    "Version": "3.17.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.16.2"
+    "MinimumApiVersion": "3.17.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 493aebd9..31dafa8e 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.16.2";
+        internal static string RawApiVersion = "3.17.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 474c76183b601dc9ebd238a9acb69cd71f598af0 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 10 Oct 2022 13:36:11 -0400
Subject: [PATCH 801/856] fix error when Steam .vdf file doesn't exist

---
 docs/release-notes.md                                   | 4 ++++
 src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs | 6 +++++-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 7574d62b..9f50fafa 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
+## Upcoming release
+* For players:
+  * Fixed installer error on Windows if the Steam library folder exists but doesn't contain Steam's `.vdf` library data file.
+
 ## 3.17.0
 Released 09 October 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/73090322).
 
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 66465ffe..1d518738 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -264,8 +264,12 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
             if (steamPath == null)
                 return null;
 
-            // get raw .vdf data
+            // get .vdf file path
             string libraryFoldersPath = Path.Combine(steamPath.Replace('/', '\\'), "steamapps\\libraryfolders.vdf");
+            if (!File.Exists(libraryFoldersPath))
+                return null;
+
+            // read data
             using FileStream fileStream = File.OpenRead(libraryFoldersPath);
             VdfDeserializer deserializer = new();
             dynamic libraries = deserializer.Deserialize(fileStream);

From 5739745b76d8c339dee6af0123e310dab6ebcf07 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 10 Oct 2022 20:03:01 -0400
Subject: [PATCH 802/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 02cf69bd..2f1f822e 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.17.0</Version>
+    <Version>3.17.1</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9f50fafa..9c4fdefc 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,7 +7,9 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.17.1
+Released 10 October 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
   * Fixed installer error on Windows if the Steam library folder exists but doesn't contain Steam's `.vdf` library data file.
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 754e543a..ecac30bf 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.17.0",
+    "Version": "3.17.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.17.0"
+    "MinimumApiVersion": "3.17.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 8f94e5ab..3d708876 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.17.0",
+    "Version": "3.17.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.17.0"
+    "MinimumApiVersion": "3.17.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index a9401fc3..c2bf5f05 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.17.0",
+    "Version": "3.17.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.17.0"
+    "MinimumApiVersion": "3.17.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 31dafa8e..ea41a4ee 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.17.0";
+        internal static string RawApiVersion = "3.17.1";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 0c191eb32c41ffedd321951cda70b521e9b51c96 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Sat, 15 Oct 2022 08:36:24 -0400
Subject: [PATCH 803/856] make asset name comparing lazy.

---
 src/SMAPI/Framework/Content/AssetName.cs      | 114 +++++++++++++-----
 .../AssetPathUtilities/AssetPartYielder.cs    |  67 ++++++++++
 2 files changed, 148 insertions(+), 33 deletions(-)
 create mode 100644 src/SMAPI/Utilities/AssetPathUtilities/AssetPartYielder.cs

diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 148354a1..05e1d1c2 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -1,7 +1,11 @@
 using System;
 using StardewModdingAPI.Toolkit.Utilities;
+using StardewModdingAPI.Utilities.AssetPathUtilities;
+
 using StardewValley;
 
+using ToolkitPathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
+
 namespace StardewModdingAPI.Framework.Content
 {
     /// <summary>An asset name that can be loaded through the content pipeline.</summary>
@@ -94,10 +98,28 @@ namespace StardewModdingAPI.Framework.Content
             if (string.IsNullOrWhiteSpace(assetName))
                 return false;
 
-            assetName = PathUtilities.NormalizeAssetName(assetName);
+            AssetPartYielder compareTo = new(useBaseName ? this.BaseName : this.Name);
+            AssetPartYielder compareFrom = new(assetName);
+            
+            while (true)
+            {
+                bool otherHasMore = compareFrom.MoveNext();
+                bool iHaveMore = compareTo.MoveNext();
 
-            string compareTo = useBaseName ? this.BaseName : this.Name;
-            return compareTo.Equals(assetName, StringComparison.OrdinalIgnoreCase);
+                // neither of us have any more to yield, I'm done.
+                if (!otherHasMore && !iHaveMore)
+                    return true;
+
+                // One of us has more but the other doesn't, this isn't a match.
+                if (otherHasMore ^ iHaveMore)
+                    return false;
+
+                // My next bit doesn't match their next bit, this isn't a match.
+                if (!compareTo.Current.Equals(compareFrom.Current, StringComparison.OrdinalIgnoreCase))
+                    return false;
+
+                // continue checking.
+            }
         }
 
         /// <inheritdoc />
@@ -119,42 +141,68 @@ namespace StardewModdingAPI.Framework.Content
             if (prefix is null)
                 return false;
 
-            string rawTrimmed = prefix.Trim();
+            ReadOnlySpan<char> trimmed = prefix.AsSpan().Trim();
 
-            // asset keys can't have a leading slash, but NormalizeAssetName will trim them
-            if (rawTrimmed.StartsWith('/') || rawTrimmed.StartsWith('\\'))
+            // just because most ReadOnlySpan/Span APIs expect a ReadOnlySpan/Span, easier to read.
+            ReadOnlySpan<char> seperators = new(ToolkitPathUtilities.PossiblePathSeparators);
+
+            // asset keys can't have a leading slash, but AssetPathYielder won't yield that.
+            if (seperators.Contains(trimmed[0]))
                 return false;
 
-            // normalize prefix
-            {
-                string normalized = PathUtilities.NormalizeAssetName(prefix);
-
-                // keep trailing slash
-                if (rawTrimmed.EndsWith('/') || rawTrimmed.EndsWith('\\'))
-                    normalized += PathUtilities.PreferredAssetSeparator;
-
-                prefix = normalized;
-            }
-
-            // compare
-            if (prefix.Length == 0)
+            if (trimmed.Length == 0)
                 return true;
 
-            return
-                this.Name.StartsWith(prefix, StringComparison.OrdinalIgnoreCase)
-                && (
-                    allowPartialWord
-                    || this.Name.Length == prefix.Length
-                    || !char.IsLetterOrDigit(prefix[^1]) // last character in suffix is word separator
-                    || !char.IsLetterOrDigit(this.Name[prefix.Length]) // or first character after it is
-                )
-                && (
-                    allowSubfolder
-                    || this.Name.Length == prefix.Length
-                    || !this.Name[prefix.Length..].Contains(PathUtilities.PreferredAssetSeparator)
-                );
-        }
+            AssetPartYielder compareTo = new(this.Name);
+            AssetPartYielder compareFrom = new(trimmed);
 
+            while (true)
+            {
+                bool otherHasMore = compareFrom.MoveNext();
+                bool iHaveMore = compareTo.MoveNext();
+
+                // Neither of us have any more to yield, I'm done.
+                if (!otherHasMore && !iHaveMore)
+                    return true;
+
+                // the prefix is actually longer than the asset name, this can't be true.
+                if (otherHasMore && !iHaveMore)
+                    return false;
+
+                // they're done, I have more. (These are going to be word boundaries, I don't need to check that).
+                if (!otherHasMore && iHaveMore)
+                {
+                    return allowSubfolder || !compareTo.Remainder.Contains(seperators, StringComparison.Ordinal);
+                }
+
+                // check my next segment against theirs.
+                if (otherHasMore && iHaveMore)
+                {
+                    // my next segment doesn't match theirs.
+                    if (!compareTo.Current.StartsWith(compareFrom.Current, StringComparison.OrdinalIgnoreCase))
+                        return false;
+
+                    // my next segment starts with theirs but isn't an exact match.
+                    if (compareTo.Current.Length != compareFrom.Current.Length)
+                    {
+                        // something like "Maps/" would require an exact match.
+                        if (seperators.Contains(trimmed[^1]))
+                            return false;
+
+                        // check for partial word.
+                        if (!allowPartialWord
+                            && char.IsLetterOrDigit(compareFrom.Current[^1]) // last character in suffix is not word separator
+                            && char.IsLetterOrDigit(compareTo.Current[compareFrom.Current.Length]) // and the first character after it isn't either.
+                            )
+                            return false;
+
+                        return allowSubfolder || !compareTo.Remainder.Contains(seperators, StringComparison.Ordinal);
+                    }
+
+                    // exact matches should continue checking.
+                }
+            }
+        }
 
         /// <inheritdoc />
         public bool IsDirectlyUnderPath(string? assetFolder)
diff --git a/src/SMAPI/Utilities/AssetPathUtilities/AssetPartYielder.cs b/src/SMAPI/Utilities/AssetPathUtilities/AssetPartYielder.cs
new file mode 100644
index 00000000..a55a0ab4
--- /dev/null
+++ b/src/SMAPI/Utilities/AssetPathUtilities/AssetPartYielder.cs
@@ -0,0 +1,67 @@
+using System;
+
+using ToolkitPathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
+
+namespace StardewModdingAPI.Utilities.AssetPathUtilities;
+
+/// <summary>
+/// A helper class that yields out each bit of an asset path
+/// </summary>
+internal ref struct AssetPartYielder
+{
+    private ReadOnlySpan<char> remainder;
+
+    /// <summary>
+    /// Construct an instance.
+    /// </summary>
+    /// <param name="assetName">The asset name.</param>
+    internal AssetPartYielder(ReadOnlySpan<char> assetName)
+    {
+        this.remainder = AssetPartYielder.TrimLeadingPathSeperators(assetName);
+    }
+
+    /// <summary>
+    /// The remainder of the assetName (that hasn't been yielded out yet.)
+    /// </summary>
+    internal ReadOnlySpan<char> Remainder => this.remainder;
+
+    /// <summary>
+    /// The current segment.
+    /// </summary>
+    public ReadOnlySpan<char> Current { get; private set; } = default;
+
+    // this is just so it can be used in a foreach loop.
+    public AssetPartYielder GetEnumerator() => this;
+
+    /// <summary>
+    /// Moves the enumerator to the next element.
+    /// </summary>
+    /// <returns>True if there is a new</returns>
+    public bool MoveNext()
+    {
+        if (this.remainder.Length == 0)
+        {
+            return false;
+        }
+
+        int index = this.remainder.IndexOfAny(ToolkitPathUtilities.PossiblePathSeparators);
+
+        // no more seperator characters found, I'm done.
+        if (index < 0)
+        {
+            this.Current = this.remainder;
+            this.remainder = ReadOnlySpan<char>.Empty;
+            return true;
+        }
+
+        // Yield the next seperate character bit
+        this.Current = this.remainder[..index];
+        this.remainder = AssetPartYielder.TrimLeadingPathSeperators(this.remainder[(index + 1)..]);
+        return true;
+    }
+
+    private static ReadOnlySpan<char> TrimLeadingPathSeperators(ReadOnlySpan<char> span)
+    {
+        return span.TrimStart(new ReadOnlySpan<char>(ToolkitPathUtilities.PossiblePathSeparators));
+    }
+}

From 72ee547e1e0eb502a90381b3c9f1da3a9c5f2b18 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Sat, 15 Oct 2022 11:03:39 -0400
Subject: [PATCH 804/856] And fixing the indexing math again.

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 241c09a8..7c8cc6a8 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -192,7 +192,7 @@ namespace StardewModdingAPI.Framework.Content
                 int topOffset = startIndex / sourceArea.Width;
                 int bottomOffset = endIndex / sourceArea.Width;
 
-                targetArea = new(targetArea.X, targetArea.Y + topOffset, targetArea.Width, bottomOffset - topOffset + 1);
+                targetArea = new(targetArea.X, targetArea.Y + topOffset - startRow, targetArea.Width, bottomOffset - topOffset + 1);
                 pixelCount = targetArea.Width * targetArea.Height;
                 sourceOffset = topOffset * sourceArea.Width;
             }

From 70cde89480e43bb1369c1063c7b19f757784f269 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Oct 2022 14:41:45 -0400
Subject: [PATCH 805/856] tweak naming in new code

---
 src/SMAPI/Framework/Content/AssetName.cs      | 52 +++++++++----------
 ...tYielder.cs => AssetNamePartEnumerator.cs} | 31 ++++++-----
 2 files changed, 40 insertions(+), 43 deletions(-)
 rename src/SMAPI/Utilities/AssetPathUtilities/{AssetPartYielder.cs => AssetNamePartEnumerator.cs} (54%)

diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 05e1d1c2..d7ee6dba 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -1,9 +1,7 @@
 using System;
 using StardewModdingAPI.Toolkit.Utilities;
 using StardewModdingAPI.Utilities.AssetPathUtilities;
-
 using StardewValley;
-
 using ToolkitPathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 
 namespace StardewModdingAPI.Framework.Content
@@ -98,24 +96,24 @@ namespace StardewModdingAPI.Framework.Content
             if (string.IsNullOrWhiteSpace(assetName))
                 return false;
 
-            AssetPartYielder compareTo = new(useBaseName ? this.BaseName : this.Name);
-            AssetPartYielder compareFrom = new(assetName);
-            
+            AssetNamePartEnumerator curParts = new(useBaseName ? this.BaseName : this.Name);
+            AssetNamePartEnumerator otherParts = new(assetName);
+
             while (true)
             {
-                bool otherHasMore = compareFrom.MoveNext();
-                bool iHaveMore = compareTo.MoveNext();
+                bool otherHasMore = otherParts.MoveNext();
+                bool curHasMore = curParts.MoveNext();
 
                 // neither of us have any more to yield, I'm done.
-                if (!otherHasMore && !iHaveMore)
+                if (!otherHasMore && !curHasMore)
                     return true;
 
                 // One of us has more but the other doesn't, this isn't a match.
-                if (otherHasMore ^ iHaveMore)
+                if (otherHasMore ^ curHasMore)
                     return false;
 
                 // My next bit doesn't match their next bit, this isn't a match.
-                if (!compareTo.Current.Equals(compareFrom.Current, StringComparison.OrdinalIgnoreCase))
+                if (!curParts.Current.Equals(otherParts.Current, StringComparison.OrdinalIgnoreCase))
                     return false;
 
                 // continue checking.
@@ -144,59 +142,59 @@ namespace StardewModdingAPI.Framework.Content
             ReadOnlySpan<char> trimmed = prefix.AsSpan().Trim();
 
             // just because most ReadOnlySpan/Span APIs expect a ReadOnlySpan/Span, easier to read.
-            ReadOnlySpan<char> seperators = new(ToolkitPathUtilities.PossiblePathSeparators);
+            ReadOnlySpan<char> pathSeparators = new(ToolkitPathUtilities.PossiblePathSeparators);
 
             // asset keys can't have a leading slash, but AssetPathYielder won't yield that.
-            if (seperators.Contains(trimmed[0]))
+            if (pathSeparators.Contains(trimmed[0]))
                 return false;
 
             if (trimmed.Length == 0)
                 return true;
 
-            AssetPartYielder compareTo = new(this.Name);
-            AssetPartYielder compareFrom = new(trimmed);
+            AssetNamePartEnumerator curParts = new(this.Name);
+            AssetNamePartEnumerator prefixParts = new(trimmed);
 
             while (true)
             {
-                bool otherHasMore = compareFrom.MoveNext();
-                bool iHaveMore = compareTo.MoveNext();
+                bool prefixHasMore = prefixParts.MoveNext();
+                bool curHasMore = curParts.MoveNext();
 
                 // Neither of us have any more to yield, I'm done.
-                if (!otherHasMore && !iHaveMore)
+                if (!prefixHasMore && !curHasMore)
                     return true;
 
                 // the prefix is actually longer than the asset name, this can't be true.
-                if (otherHasMore && !iHaveMore)
+                if (prefixHasMore && !curHasMore)
                     return false;
 
                 // they're done, I have more. (These are going to be word boundaries, I don't need to check that).
-                if (!otherHasMore && iHaveMore)
+                if (!prefixHasMore && curHasMore)
                 {
-                    return allowSubfolder || !compareTo.Remainder.Contains(seperators, StringComparison.Ordinal);
+                    return allowSubfolder || !curParts.Remainder.Contains(pathSeparators, StringComparison.Ordinal);
                 }
 
                 // check my next segment against theirs.
-                if (otherHasMore && iHaveMore)
+                if (prefixHasMore && curHasMore)
                 {
                     // my next segment doesn't match theirs.
-                    if (!compareTo.Current.StartsWith(compareFrom.Current, StringComparison.OrdinalIgnoreCase))
+                    if (!curParts.Current.StartsWith(prefixParts.Current, StringComparison.OrdinalIgnoreCase))
                         return false;
 
                     // my next segment starts with theirs but isn't an exact match.
-                    if (compareTo.Current.Length != compareFrom.Current.Length)
+                    if (curParts.Current.Length != prefixParts.Current.Length)
                     {
                         // something like "Maps/" would require an exact match.
-                        if (seperators.Contains(trimmed[^1]))
+                        if (pathSeparators.Contains(trimmed[^1]))
                             return false;
 
                         // check for partial word.
                         if (!allowPartialWord
-                            && char.IsLetterOrDigit(compareFrom.Current[^1]) // last character in suffix is not word separator
-                            && char.IsLetterOrDigit(compareTo.Current[compareFrom.Current.Length]) // and the first character after it isn't either.
+                            && char.IsLetterOrDigit(prefixParts.Current[^1]) // last character in suffix is not word separator
+                            && char.IsLetterOrDigit(curParts.Current[prefixParts.Current.Length]) // and the first character after it isn't either.
                             )
                             return false;
 
-                        return allowSubfolder || !compareTo.Remainder.Contains(seperators, StringComparison.Ordinal);
+                        return allowSubfolder || !curParts.Remainder.Contains(pathSeparators, StringComparison.Ordinal);
                     }
 
                     // exact matches should continue checking.
diff --git a/src/SMAPI/Utilities/AssetPathUtilities/AssetPartYielder.cs b/src/SMAPI/Utilities/AssetPathUtilities/AssetNamePartEnumerator.cs
similarity index 54%
rename from src/SMAPI/Utilities/AssetPathUtilities/AssetPartYielder.cs
rename to src/SMAPI/Utilities/AssetPathUtilities/AssetNamePartEnumerator.cs
index a55a0ab4..0840617a 100644
--- a/src/SMAPI/Utilities/AssetPathUtilities/AssetPartYielder.cs
+++ b/src/SMAPI/Utilities/AssetPathUtilities/AssetNamePartEnumerator.cs
@@ -1,5 +1,4 @@
 using System;
-
 using ToolkitPathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 
 namespace StardewModdingAPI.Utilities.AssetPathUtilities;
@@ -7,23 +6,23 @@ namespace StardewModdingAPI.Utilities.AssetPathUtilities;
 /// <summary>
 /// A helper class that yields out each bit of an asset path
 /// </summary>
-internal ref struct AssetPartYielder
+internal ref struct AssetNamePartEnumerator
 {
-    private ReadOnlySpan<char> remainder;
+    private ReadOnlySpan<char> RemainderImpl;
 
     /// <summary>
     /// Construct an instance.
     /// </summary>
     /// <param name="assetName">The asset name.</param>
-    internal AssetPartYielder(ReadOnlySpan<char> assetName)
+    internal AssetNamePartEnumerator(ReadOnlySpan<char> assetName)
     {
-        this.remainder = AssetPartYielder.TrimLeadingPathSeperators(assetName);
+        this.RemainderImpl = AssetNamePartEnumerator.TrimLeadingPathSeparators(assetName);
     }
 
     /// <summary>
     /// The remainder of the assetName (that hasn't been yielded out yet.)
     /// </summary>
-    internal ReadOnlySpan<char> Remainder => this.remainder;
+    internal ReadOnlySpan<char> Remainder => this.RemainderImpl;
 
     /// <summary>
     /// The current segment.
@@ -31,7 +30,7 @@ internal ref struct AssetPartYielder
     public ReadOnlySpan<char> Current { get; private set; } = default;
 
     // this is just so it can be used in a foreach loop.
-    public AssetPartYielder GetEnumerator() => this;
+    public AssetNamePartEnumerator GetEnumerator() => this;
 
     /// <summary>
     /// Moves the enumerator to the next element.
@@ -39,28 +38,28 @@ internal ref struct AssetPartYielder
     /// <returns>True if there is a new</returns>
     public bool MoveNext()
     {
-        if (this.remainder.Length == 0)
+        if (this.RemainderImpl.Length == 0)
         {
             return false;
         }
 
-        int index = this.remainder.IndexOfAny(ToolkitPathUtilities.PossiblePathSeparators);
+        int index = this.RemainderImpl.IndexOfAny(ToolkitPathUtilities.PossiblePathSeparators);
 
-        // no more seperator characters found, I'm done.
+        // no more separator characters found, I'm done.
         if (index < 0)
         {
-            this.Current = this.remainder;
-            this.remainder = ReadOnlySpan<char>.Empty;
+            this.Current = this.RemainderImpl;
+            this.RemainderImpl = ReadOnlySpan<char>.Empty;
             return true;
         }
 
-        // Yield the next seperate character bit
-        this.Current = this.remainder[..index];
-        this.remainder = AssetPartYielder.TrimLeadingPathSeperators(this.remainder[(index + 1)..]);
+        // Yield the next separate character bit
+        this.Current = this.RemainderImpl[..index];
+        this.RemainderImpl = AssetNamePartEnumerator.TrimLeadingPathSeparators(this.RemainderImpl[(index + 1)..]);
         return true;
     }
 
-    private static ReadOnlySpan<char> TrimLeadingPathSeperators(ReadOnlySpan<char> span)
+    private static ReadOnlySpan<char> TrimLeadingPathSeparators(ReadOnlySpan<char> span)
     {
         return span.TrimStart(new ReadOnlySpan<char>(ToolkitPathUtilities.PossiblePathSeparators));
     }

From eed1deb3c75ba2aeea94ea9a57f9fe7ad92a90ce Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Oct 2022 14:41:45 -0400
Subject: [PATCH 806/856] apply conventions to asset part enumerator

---
 .../AssetNamePartEnumerator.cs                | 98 ++++++++++---------
 1 file changed, 51 insertions(+), 47 deletions(-)

diff --git a/src/SMAPI/Utilities/AssetPathUtilities/AssetNamePartEnumerator.cs b/src/SMAPI/Utilities/AssetPathUtilities/AssetNamePartEnumerator.cs
index 0840617a..11987ed6 100644
--- a/src/SMAPI/Utilities/AssetPathUtilities/AssetNamePartEnumerator.cs
+++ b/src/SMAPI/Utilities/AssetPathUtilities/AssetNamePartEnumerator.cs
@@ -1,66 +1,70 @@
 using System;
 using ToolkitPathUtilities = StardewModdingAPI.Toolkit.Utilities.PathUtilities;
 
-namespace StardewModdingAPI.Utilities.AssetPathUtilities;
-
-/// <summary>
-/// A helper class that yields out each bit of an asset path
-/// </summary>
-internal ref struct AssetNamePartEnumerator
+namespace StardewModdingAPI.Utilities.AssetPathUtilities
 {
-    private ReadOnlySpan<char> RemainderImpl;
-
-    /// <summary>
-    /// Construct an instance.
-    /// </summary>
-    /// <param name="assetName">The asset name.</param>
-    internal AssetNamePartEnumerator(ReadOnlySpan<char> assetName)
+    /// <summary>Handles enumerating the normalized segments in an asset name.</summary>
+    internal ref struct AssetNamePartEnumerator
     {
-        this.RemainderImpl = AssetNamePartEnumerator.TrimLeadingPathSeparators(assetName);
-    }
+        /*********
+        ** Fields
+        *********/
+        /// <summary>The backing field for <see cref="Remainder"/>.</summary>
+        private ReadOnlySpan<char> RemainderImpl;
 
-    /// <summary>
-    /// The remainder of the assetName (that hasn't been yielded out yet.)
-    /// </summary>
-    internal ReadOnlySpan<char> Remainder => this.RemainderImpl;
 
-    /// <summary>
-    /// The current segment.
-    /// </summary>
-    public ReadOnlySpan<char> Current { get; private set; } = default;
+        /*********
+        ** Properties
+        *********/
+        /// <summary>The remainder of the asset name being enumerated, ignoring segments which have already been yielded.</summary>
+        public ReadOnlySpan<char> Remainder => this.RemainderImpl;
 
-    // this is just so it can be used in a foreach loop.
-    public AssetNamePartEnumerator GetEnumerator() => this;
+        /// <summary>Get the current segment.</summary>
+        public ReadOnlySpan<char> Current { get; private set; } = default;
 
-    /// <summary>
-    /// Moves the enumerator to the next element.
-    /// </summary>
-    /// <returns>True if there is a new</returns>
-    public bool MoveNext()
-    {
-        if (this.RemainderImpl.Length == 0)
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="assetName">The asset name to enumerate.</param>
+        public AssetNamePartEnumerator(ReadOnlySpan<char> assetName)
         {
-            return false;
+            this.RemainderImpl = AssetNamePartEnumerator.TrimLeadingPathSeparators(assetName);
         }
 
-        int index = this.RemainderImpl.IndexOfAny(ToolkitPathUtilities.PossiblePathSeparators);
-
-        // no more separator characters found, I'm done.
-        if (index < 0)
+        /// <summary>Move the enumerator to the next segment.</summary>
+        /// <returns>Returns true if a new value was found (accessible via <see cref="Current"/>).</returns>
+        public bool MoveNext()
         {
-            this.Current = this.RemainderImpl;
-            this.RemainderImpl = ReadOnlySpan<char>.Empty;
+            if (this.RemainderImpl.Length == 0)
+                return false;
+
+            int index = this.RemainderImpl.IndexOfAny(ToolkitPathUtilities.PossiblePathSeparators);
+
+            // no more separator characters found, I'm done.
+            if (index < 0)
+            {
+                this.Current = this.RemainderImpl;
+                this.RemainderImpl = ReadOnlySpan<char>.Empty;
+                return true;
+            }
+
+            // Yield the next separate character bit
+            this.Current = this.RemainderImpl[..index];
+            this.RemainderImpl = AssetNamePartEnumerator.TrimLeadingPathSeparators(this.RemainderImpl[(index + 1)..]);
             return true;
         }
 
-        // Yield the next separate character bit
-        this.Current = this.RemainderImpl[..index];
-        this.RemainderImpl = AssetNamePartEnumerator.TrimLeadingPathSeparators(this.RemainderImpl[(index + 1)..]);
-        return true;
-    }
 
-    private static ReadOnlySpan<char> TrimLeadingPathSeparators(ReadOnlySpan<char> span)
-    {
-        return span.TrimStart(new ReadOnlySpan<char>(ToolkitPathUtilities.PossiblePathSeparators));
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Trim path separators at the start of the given path or segment.</summary>
+        /// <param name="span">The path or segment to trim.</param>
+        private static ReadOnlySpan<char> TrimLeadingPathSeparators(ReadOnlySpan<char> span)
+        {
+            return span.TrimStart(new ReadOnlySpan<char>(ToolkitPathUtilities.PossiblePathSeparators));
+        }
     }
 }

From 4e3b2810e6951b72bdf5c5cbdd23a079d53a4c96 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Oct 2022 14:41:45 -0400
Subject: [PATCH 807/856] fix index-out-of-range error when StartsWith prefix
 is empty

---
 src/SMAPI/Framework/Content/AssetName.cs | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index d7ee6dba..c0572105 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -139,21 +139,19 @@ namespace StardewModdingAPI.Framework.Content
             if (prefix is null)
                 return false;
 
+            // get initial values
             ReadOnlySpan<char> trimmed = prefix.AsSpan().Trim();
+            if (trimmed.Length == 0)
+                return true;
+            ReadOnlySpan<char> pathSeparators = new(ToolkitPathUtilities.PossiblePathSeparators); // just to simplify calling other span APIs
 
-            // just because most ReadOnlySpan/Span APIs expect a ReadOnlySpan/Span, easier to read.
-            ReadOnlySpan<char> pathSeparators = new(ToolkitPathUtilities.PossiblePathSeparators);
-
-            // asset keys can't have a leading slash, but AssetPathYielder won't yield that.
+            // asset keys can't have a leading slash, but AssetPathYielder will trim them
             if (pathSeparators.Contains(trimmed[0]))
                 return false;
 
-            if (trimmed.Length == 0)
-                return true;
-
+            // compare segments
             AssetNamePartEnumerator curParts = new(this.Name);
             AssetNamePartEnumerator prefixParts = new(trimmed);
-
             while (true)
             {
                 bool prefixHasMore = prefixParts.MoveNext();

From 5d30b47e1e903f7ceb53116528255934c238e5ba Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Oct 2022 14:41:46 -0400
Subject: [PATCH 808/856] fix IsEquivalentTo no longer ignoring surrounding
 whitespace

---
 src/SMAPI/Framework/Content/AssetName.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index c0572105..6220ea61 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -97,7 +97,7 @@ namespace StardewModdingAPI.Framework.Content
                 return false;
 
             AssetNamePartEnumerator curParts = new(useBaseName ? this.BaseName : this.Name);
-            AssetNamePartEnumerator otherParts = new(assetName);
+            AssetNamePartEnumerator otherParts = new(assetName.AsSpan().Trim());
 
             while (true)
             {

From 573f732c2a2118d7a4848151764df6bef1a47008 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Oct 2022 14:41:46 -0400
Subject: [PATCH 809/856] reduce sequential bool checks a bit

---
 src/SMAPI/Framework/Content/AssetName.cs | 77 ++++++++++++------------
 1 file changed, 37 insertions(+), 40 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 6220ea61..bdb79dde 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -101,22 +101,20 @@ namespace StardewModdingAPI.Framework.Content
 
             while (true)
             {
-                bool otherHasMore = otherParts.MoveNext();
                 bool curHasMore = curParts.MoveNext();
+                bool otherHasMore = otherParts.MoveNext();
 
-                // neither of us have any more to yield, I'm done.
-                if (!otherHasMore && !curHasMore)
+                // mismatch: lengths differ
+                if (otherHasMore != curHasMore)
+                    return false;
+
+                // match: both reached the end without a mismatch
+                if (!curHasMore)
                     return true;
 
-                // One of us has more but the other doesn't, this isn't a match.
-                if (otherHasMore ^ curHasMore)
-                    return false;
-
-                // My next bit doesn't match their next bit, this isn't a match.
+                // mismatch: current segment is different
                 if (!curParts.Current.Equals(otherParts.Current, StringComparison.OrdinalIgnoreCase))
                     return false;
-
-                // continue checking.
             }
         }
 
@@ -154,48 +152,47 @@ namespace StardewModdingAPI.Framework.Content
             AssetNamePartEnumerator prefixParts = new(trimmed);
             while (true)
             {
-                bool prefixHasMore = prefixParts.MoveNext();
                 bool curHasMore = curParts.MoveNext();
+                bool prefixHasMore = prefixParts.MoveNext();
 
-                // Neither of us have any more to yield, I'm done.
-                if (!prefixHasMore && !curHasMore)
-                    return true;
-
-                // the prefix is actually longer than the asset name, this can't be true.
-                if (prefixHasMore && !curHasMore)
-                    return false;
-
-                // they're done, I have more. (These are going to be word boundaries, I don't need to check that).
-                if (!prefixHasMore && curHasMore)
+                // reached end of prefix or asset name
+                if (prefixHasMore != curHasMore)
                 {
+                    // mismatch: prefix is longer
+                    if (prefixHasMore)
+                        return false;
+
+                    // possible match: all prefix segments matched
                     return allowSubfolder || !curParts.Remainder.Contains(pathSeparators, StringComparison.Ordinal);
                 }
 
-                // check my next segment against theirs.
-                if (prefixHasMore && curHasMore)
+                // match: previous segments matched exactly and both reached the end
+                if (!prefixHasMore)
+                    return true;
+
+                // compare segment
+                if (curParts.Current.Length == prefixParts.Current.Length)
                 {
-                    // my next segment doesn't match theirs.
+                    // mismatch: segments aren't equivalent
+                    if (!curParts.Current.Equals(prefixParts.Current, StringComparison.OrdinalIgnoreCase))
+                        return false;
+                }
+                else
+                {
+                    // mismatch: cur segment doesn't start with prefix
                     if (!curParts.Current.StartsWith(prefixParts.Current, StringComparison.OrdinalIgnoreCase))
                         return false;
 
-                    // my next segment starts with theirs but isn't an exact match.
-                    if (curParts.Current.Length != prefixParts.Current.Length)
-                    {
-                        // something like "Maps/" would require an exact match.
-                        if (pathSeparators.Contains(trimmed[^1]))
-                            return false;
+                    // mismatch: something like "Maps/" would need an exact match
+                    if (pathSeparators.Contains(trimmed[^1]))
+                        return false;
 
-                        // check for partial word.
-                        if (!allowPartialWord
-                            && char.IsLetterOrDigit(prefixParts.Current[^1]) // last character in suffix is not word separator
-                            && char.IsLetterOrDigit(curParts.Current[prefixParts.Current.Length]) // and the first character after it isn't either.
-                            )
-                            return false;
+                    // mismatch: partial word match not allowed, and the first or last letter of the suffix isn't a word separator
+                    if (!allowPartialWord && char.IsLetterOrDigit(prefixParts.Current[^1]) && char.IsLetterOrDigit(curParts.Current[prefixParts.Current.Length]))
+                        return false;
 
-                        return allowSubfolder || !curParts.Remainder.Contains(pathSeparators, StringComparison.Ordinal);
-                    }
-
-                    // exact matches should continue checking.
+                    // possible match
+                    return allowSubfolder || !curParts.Remainder.Contains(pathSeparators, StringComparison.Ordinal);
                 }
             }
         }

From e31c96d5b816caa9b0b9e950306b9292a87380d7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Oct 2022 15:08:39 -0400
Subject: [PATCH 810/856] add missing test adapter package

---
 src/SMAPI.Tests/SMAPI.Tests.csproj | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 2c32a932..597cd7dd 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -19,6 +19,7 @@
     <PackageReference Include="Moq" Version="4.18.1" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="NUnit" Version="3.13.3" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
   </ItemGroup>
 
   <ItemGroup>

From 4e91174b3ed265c31c54b2242711ca9d51bae1ca Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 16 Oct 2022 15:17:03 -0400
Subject: [PATCH 811/856] update release notes

---
 docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9c4fdefc..ff5d61ba 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
+## Upcoming release
+* For mod authors:
+  * Fixed image patches sometimes applied one pixel higher than expected after 3.17.0 (thanks to atravita!).
+
 ## 3.17.1
 Released 10 October 2022 for Stardew Valley 1.5.6 or later.
 

From 4dcc6904b9e72ac3567dfafe3824c2de48218b58 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Sun, 16 Oct 2022 18:04:19 -0400
Subject: [PATCH 812/856] fix issues with subfolders

---
 src/SMAPI.Tests/Core/AssetNameTests.cs   | 14 ++++++++++++++
 src/SMAPI.Tests/SMAPI.Tests.csproj       |  1 +
 src/SMAPI/Framework/Content/AssetName.cs |  8 ++++----
 3 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index 655e9bae..fe70e330 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -243,6 +243,20 @@ namespace SMAPI.Tests.Core
             return result;
         }
 
+        [TestCase("Mods/SomeMod/SomeSubdirectory", "Mods/Some", true, ExpectedResult = true)]
+        [TestCase("Mods/SomeMod/SomeSubdirectory", "Mods/Some", false, ExpectedResult = false)]
+        public bool StartsWith_SubfolderWithPartial(string mainAssetName, string otherAssetName, bool allowSubfolder)
+        {
+            // arrange
+            mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
+
+            // act
+            AssetName name = AssetName.Parse(mainAssetName, _ => null);
+
+            // assert value
+            return name.StartsWith(otherAssetName, allowPartialWord: true, allowSubfolder: allowSubfolder);
+        }
+
 
         /****
         ** GetHashCode
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 2c32a932..597cd7dd 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -19,6 +19,7 @@
     <PackageReference Include="Moq" Version="4.18.1" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="NUnit" Version="3.13.3" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index bdb79dde..9d59f222 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -162,8 +162,8 @@ namespace StardewModdingAPI.Framework.Content
                     if (prefixHasMore)
                         return false;
 
-                    // possible match: all prefix segments matched
-                    return allowSubfolder || !curParts.Remainder.Contains(pathSeparators, StringComparison.Ordinal);
+                    // possible match: all prefix segments matched.
+                    return allowSubfolder || (pathSeparators.Contains(trimmed[^1]) ? curParts.Remainder.Length == 0 : curParts.Current.Length == 0);
                 }
 
                 // match: previous segments matched exactly and both reached the end
@@ -192,7 +192,7 @@ namespace StardewModdingAPI.Framework.Content
                         return false;
 
                     // possible match
-                    return allowSubfolder || !curParts.Remainder.Contains(pathSeparators, StringComparison.Ordinal);
+                    return allowSubfolder || (pathSeparators.Contains(trimmed[^1]) ? curParts.Remainder.IndexOfAny(ToolkitPathUtilities.PossiblePathSeparators) < 0 : curParts.Remainder.Length == 0);
                 }
             }
         }
@@ -203,7 +203,7 @@ namespace StardewModdingAPI.Framework.Content
             if (assetFolder is null)
                 return false;
 
-            return this.StartsWith(assetFolder + "/", allowPartialWord: false, allowSubfolder: false);
+            return this.StartsWith(assetFolder + ToolkitPathUtilities.PreferredPathSeparator, allowPartialWord: false, allowSubfolder: false);
         }
 
         /// <inheritdoc />

From 0e4dd8a7b446d85d4603d55043af42aac5968b5a Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 17 Oct 2022 20:02:19 -0400
Subject: [PATCH 813/856] prevent Steam vdf read errors from crashing the
 installer

---
 docs/release-notes.md                         |  3 +
 .../Framework/GameScanning/GameScanner.cs     | 63 +++++++++++--------
 2 files changed, 40 insertions(+), 26 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ff5d61ba..02d085d5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Fixed installer crash if Steam's library data is invalid or in an old format; it'll now be ignored instead.
+
 * For mod authors:
   * Fixed image patches sometimes applied one pixel higher than expected after 3.17.0 (thanks to atravita!).
 
diff --git a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
index 1d518738..88142805 100644
--- a/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
+++ b/src/SMAPI.Toolkit/Framework/GameScanning/GameScanner.cs
@@ -261,39 +261,50 @@ namespace StardewModdingAPI.Toolkit.Framework.GameScanning
         /// <returns>The game directory, if found.</returns>
         private string? GetPathFromSteamLibrary(string? steamPath)
         {
-            if (steamPath == null)
-                return null;
-
-            // get .vdf file path
-            string libraryFoldersPath = Path.Combine(steamPath.Replace('/', '\\'), "steamapps\\libraryfolders.vdf");
-            if (!File.Exists(libraryFoldersPath))
-                return null;
-
-            // read data
-            using FileStream fileStream = File.OpenRead(libraryFoldersPath);
-            VdfDeserializer deserializer = new();
-            dynamic libraries = deserializer.Deserialize(fileStream);
-            if (libraries?.libraryfolders is null)
-                return null;
-
-            // get path from Stardew Valley app (if any)
-            foreach (dynamic pair in libraries.libraryfolders)
+            try
             {
-                dynamic library = pair.Value;
+                if (steamPath == null)
+                    return null;
 
-                foreach (dynamic app in library.apps)
+                // get .vdf file path
+                string libraryFoldersPath = Path.Combine(steamPath.Replace('/', '\\'), "steamapps\\libraryfolders.vdf");
+                if (!File.Exists(libraryFoldersPath))
+                    return null;
+
+                // read data
+                using FileStream fileStream = File.OpenRead(libraryFoldersPath);
+                VdfDeserializer deserializer = new();
+                dynamic libraries = deserializer.Deserialize(fileStream);
+                if (libraries?.libraryfolders is null)
+                    return null;
+
+                // get path from Stardew Valley app (if any)
+                foreach (dynamic pair in libraries.libraryfolders)
                 {
-                    string key = app.Key;
-                    if (key == GameScanner.SteamAppId)
-                    {
-                        string path = library.path;
+                    dynamic library = pair.Value;
 
-                        return Path.Combine(path.Replace("\\\\", "\\"), "steamapps", "common", "Stardew Valley");
+                    foreach (dynamic app in library.apps)
+                    {
+                        string key = app.Key;
+                        if (key == GameScanner.SteamAppId)
+                        {
+                            string path = library.path;
+
+                            return Path.Combine(path.Replace("\\\\", "\\"), "steamapps", "common", "Stardew Valley");
+                        }
                     }
                 }
-            }
 
-            return null;
+                return null;
+            }
+            catch
+            {
+                // The file might not be parseable in some cases (e.g. some players have an older Steam version using
+                // a different format). Ideally we'd log an error to know when it's actually an issue, but the SMAPI
+                // installer doesn't have a logging mechanism (and third-party code calling the toolkit may not either).
+                // So for now, just ignore the error and fallback to the other discovery mechanisms.
+                return null;
+            }
         }
 #endif
     }

From b99dbf53bda9dc1178a3b6e8cbafea609f3ee6dc Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Tue, 18 Oct 2022 18:58:41 -0400
Subject: [PATCH 814/856] fix this case.

---
 src/SMAPI.Tests/Core/AssetNameTests.cs   | 2 ++
 src/SMAPI/Framework/Content/AssetName.cs | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index fe70e330..fbc94e95 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -245,6 +245,8 @@ namespace SMAPI.Tests.Core
 
         [TestCase("Mods/SomeMod/SomeSubdirectory", "Mods/Some", true, ExpectedResult = true)]
         [TestCase("Mods/SomeMod/SomeSubdirectory", "Mods/Some", false, ExpectedResult = false)]
+        [TestCase("Mods/Jasper/Data", "Mods/Jas/Image", true, ExpectedResult = false)]
+        [TestCase("Mods/Jasper/Data", "Mods/Jas/Image", true, ExpectedResult = false)]
         public bool StartsWith_SubfolderWithPartial(string mainAssetName, string otherAssetName, bool allowSubfolder)
         {
             // arrange
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 9d59f222..7b87c0c5 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -179,6 +179,10 @@ namespace StardewModdingAPI.Framework.Content
                 }
                 else
                 {
+                    // mismatch: prefix has more beyond this, and this segment isn't an exact match
+                    if (prefixParts.Remainder.Length != 0)
+                        return false;
+
                     // mismatch: cur segment doesn't start with prefix
                     if (!curParts.Current.StartsWith(prefixParts.Current, StringComparison.OrdinalIgnoreCase))
                         return false;

From 61d6ec12daee843f758e5f828a713a72a767a94b Mon Sep 17 00:00:00 2001
From: Tyler <gibbstyler7@gmail.com>
Date: Tue, 18 Oct 2022 20:03:28 -0500
Subject: [PATCH 815/856] add detailed manifest validation errors at build time

---
 src/SMAPI.ModBuildConfig/DeployModTask.cs     | 33 ++++++-
 .../Framework/ModFileManager.cs               | 12 ---
 .../Serialization/Models/Manifest.cs          | 96 ++++++++++++++++++
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 98 ++-----------------
 4 files changed, 138 insertions(+), 101 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index 88412d92..357e02b5 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -7,7 +7,10 @@ using System.Reflection;
 using System.Text.RegularExpressions;
 using Microsoft.Build.Framework;
 using Microsoft.Build.Utilities;
+using Newtonsoft.Json;
 using StardewModdingAPI.ModBuildConfig.Framework;
+using StardewModdingAPI.Toolkit.Serialization;
+using StardewModdingAPI.Toolkit.Serialization.Models;
 using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.ModBuildConfig
@@ -75,6 +78,34 @@ namespace StardewModdingAPI.ModBuildConfig
                 this.Log.LogMessage(MessageImportance.High, $"[mod build package] Handling build with options {string.Join(", ", properties)}");
             }
 
+            // check if manifest file exists
+            FileInfo manifestFile = new(Path.Combine(this.ProjectDir, "manifest.json"));
+            if (!manifestFile.Exists)
+            {
+                this.Log.LogError("[mod build package] The mod does not have a manifest.json file.");
+                return false;
+            }
+
+            // check if the json is valid
+            Manifest manifest;
+            try
+            {
+                new JsonHelper().ReadJsonFileIfExists(manifestFile.FullName, out manifest);
+            } catch (JsonReaderException ex)
+            {
+                // log the inner exception, otherwise the message will be generic
+                Exception exToShow = ex.InnerException ?? ex;
+                this.Log.LogError($"[mod build package] Failed to parse manifest.json: {exToShow.Message}");
+                return false;
+            }
+
+            // validate the manifest's fields
+            if (!manifest.TryValidate(out string error))
+            {
+                this.Log.LogError($"[mod build package] The mod manifest is invalid: {error}");
+                return false;
+            }
+
             if (!this.EnableModDeploy && !this.EnableModZip)
                 return true; // nothing to do
 
@@ -101,7 +132,7 @@ namespace StardewModdingAPI.ModBuildConfig
                 // create release zip
                 if (this.EnableModZip)
                 {
-                    string zipName = this.EscapeInvalidFilenameCharacters($"{this.ModFolderName} {package.GetManifestVersion()}.zip");
+                    string zipName = this.EscapeInvalidFilenameCharacters($"{this.ModFolderName} {manifest.Version}.zip");
                     string zipPath = Path.Combine(this.ModZipPath, zipName);
 
                     this.Log.LogMessage(MessageImportance.High, $"[mod build package] Generating the release zip at {zipPath}...");
diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index 80955f67..00f3f439 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -3,8 +3,6 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Text.RegularExpressions;
-using StardewModdingAPI.Toolkit.Serialization;
-using StardewModdingAPI.Toolkit.Serialization.Models;
 using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.ModBuildConfig.Framework
@@ -113,16 +111,6 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
             return new Dictionary<string, FileInfo>(this.Files, StringComparer.OrdinalIgnoreCase);
         }
 
-        /// <summary>Get a semantic version from the mod manifest.</summary>
-        /// <exception cref="UserErrorException">The manifest is missing or invalid.</exception>
-        public string GetManifestVersion()
-        {
-            if (!this.Files.TryGetValue(this.ManifestFileName, out FileInfo manifestFile) || !new JsonHelper().ReadJsonFileIfExists(manifestFile.FullName, out Manifest manifest))
-                throw new InvalidOperationException($"The mod does not have a {this.ManifestFileName} file."); // shouldn't happen since we validate in constructor
-
-            return manifest.Version.ToString();
-        }
-
 
         /*********
         ** Private methods
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 8a449f0a..4f84a60d 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -1,9 +1,12 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
+using System.IO;
+using System.Linq;
 using System.Text;
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Converters;
+using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Toolkit.Serialization.Models
 {
@@ -103,6 +106,99 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
             this.UpdateKeys = updateKeys ?? Array.Empty<string>();
         }
 
+        /// <summary>Try to validate a manifest's fields. Fails if any invalid field is found.</summary>
+        /// <param name="error">The error message to display to the user.</param>
+        /// <returns>Returns whether the manifest was validated successfully.</returns>
+        public bool TryValidate(out string error)
+        {
+            // validate DLL / content pack fields
+            bool hasDll = !string.IsNullOrWhiteSpace(this.EntryDll);
+            bool isContentPack = this.ContentPackFor != null;
+
+            // validate field presence
+            if (!hasDll && !isContentPack)
+            {
+                error = $"manifest has no {nameof(IManifest.EntryDll)} or {nameof(IManifest.ContentPackFor)} field; must specify one.";
+                return false;
+            }
+            if (hasDll && isContentPack)
+            {
+                error = $"manifest sets both {nameof(IManifest.EntryDll)} and {nameof(IManifest.ContentPackFor)}, which are mutually exclusive.";
+                return false;
+            }
+
+            // validate DLL filename format
+            if (hasDll && this.EntryDll!.Intersect(Path.GetInvalidFileNameChars()).Any())
+            {
+                error = $"manifest has invalid filename '{this.EntryDll}' for the EntryDLL field.";
+                return false;
+            }
+
+            // validate content pack
+            else if (isContentPack)
+            {
+                // invalid content pack ID
+                if (string.IsNullOrWhiteSpace(this.ContentPackFor!.UniqueID))
+                {
+                    error = $"manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.";
+                    return false;
+                }
+            }
+
+            // validate required fields
+            {
+                List<string> missingFields = new List<string>(3);
+
+                if (string.IsNullOrWhiteSpace(this.Name))
+                    missingFields.Add(nameof(IManifest.Name));
+                if (this.Version == null || this.Version.ToString() == "0.0.0")
+                    missingFields.Add(nameof(IManifest.Version));
+                if (string.IsNullOrWhiteSpace(this.UniqueID))
+                    missingFields.Add(nameof(IManifest.UniqueID));
+
+                if (missingFields.Any())
+                {
+                    error = $"manifest is missing required fields ({string.Join(", ", missingFields)}).";
+                    return false;
+                }
+            }
+
+            // validate ID format
+            if (!PathUtilities.IsSlug(this.UniqueID))
+            {
+                error = "manifest specifies an invalid ID (IDs must only contain letters, numbers, underscores, periods, or hyphens).";
+                return false;
+            }
+
+            // validate dependencies
+            foreach (IManifestDependency? dependency in this.Dependencies)
+            {
+                // null dependency
+                if (dependency == null)
+                {
+                    error = $"manifest has a null entry under {nameof(IManifest.Dependencies)}.";
+                    return false;
+                }
+
+                // missing ID
+                if (string.IsNullOrWhiteSpace(dependency.UniqueID))
+                {
+                    error = $"manifest has a {nameof(IManifest.Dependencies)} entry with no {nameof(IManifestDependency.UniqueID)} field.";
+                    return false;
+                }
+
+                // invalid ID
+                if (!PathUtilities.IsSlug(dependency.UniqueID))
+                {
+                    error = $"manifest has a {nameof(IManifest.Dependencies)} entry with an invalid {nameof(IManifestDependency.UniqueID)} field (IDs must only contain letters, numbers, underscores, periods, or hyphens).";
+                    return false;
+                }
+            }
+
+            error = "";
+            return true;
+        }
+
         /// <summary>Override the update keys loaded from the mod info.</summary>
         /// <param name="updateKeys">The new update keys to set.</param>
         internal void OverrideUpdateKeys(params string[] updateKeys)
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index fe56f4d2..352c22cc 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -8,7 +8,6 @@ using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
 using StardewModdingAPI.Toolkit.Serialization.Models;
-using StardewModdingAPI.Toolkit.Utilities;
 using StardewModdingAPI.Toolkit.Utilities.PathLookups;
 
 namespace StardewModdingAPI.Framework.ModLoading
@@ -126,100 +125,23 @@ namespace StardewModdingAPI.Framework.ModLoading
                     continue;
                 }
 
-                // validate DLL / content pack fields
+                // check for dll if it's supposed to have one
+                if (!string.IsNullOrEmpty(mod.Manifest.EntryDll) && validateFilesExist)
                 {
-                    bool hasDll = !string.IsNullOrWhiteSpace(mod.Manifest.EntryDll);
-                    bool isContentPack = mod.Manifest.ContentPackFor != null;
-
-                    // validate field presence
-                    if (!hasDll && !isContentPack)
+                    IFileLookup pathLookup = getFileLookup(mod.DirectoryPath);
+                    FileInfo file = pathLookup.GetFile(mod.Manifest.EntryDll!);
+                    if (!file.Exists)
                     {
-                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has no {nameof(IManifest.EntryDll)} or {nameof(IManifest.ContentPackFor)} field; must specify one.");
-                        continue;
-                    }
-                    if (hasDll && isContentPack)
-                    {
-                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest sets both {nameof(IManifest.EntryDll)} and {nameof(IManifest.ContentPackFor)}, which are mutually exclusive.");
-                        continue;
-                    }
-
-                    // validate DLL
-                    if (hasDll)
-                    {
-                        // invalid filename format
-                        if (mod.Manifest.EntryDll!.Intersect(Path.GetInvalidFileNameChars()).Any())
-                        {
-                            mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has invalid filename '{mod.Manifest.EntryDll}' for the EntryDLL field.");
-                            continue;
-                        }
-
-                        // file doesn't exist
-                        if (validateFilesExist)
-                        {
-                            IFileLookup pathLookup = getFileLookup(mod.DirectoryPath);
-                            FileInfo file = pathLookup.GetFile(mod.Manifest.EntryDll!);
-                            if (!file.Exists)
-                            {
-                                mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
-                                continue;
-                            }
-                        }
-                    }
-
-                    // validate content pack
-                    else
-                    {
-                        // invalid content pack ID
-                        if (string.IsNullOrWhiteSpace(mod.Manifest.ContentPackFor!.UniqueID))
-                        {
-                            mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.");
-                            continue;
-                        }
-                    }
-                }
-
-                // validate required fields
-                {
-                    List<string> missingFields = new List<string>(3);
-
-                    if (string.IsNullOrWhiteSpace(mod.Manifest.Name))
-                        missingFields.Add(nameof(IManifest.Name));
-                    if (mod.Manifest.Version == null || mod.Manifest.Version.ToString() == "0.0.0")
-                        missingFields.Add(nameof(IManifest.Version));
-                    if (string.IsNullOrWhiteSpace(mod.Manifest.UniqueID))
-                        missingFields.Add(nameof(IManifest.UniqueID));
-
-                    if (missingFields.Any())
-                    {
-                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest is missing required fields ({string.Join(", ", missingFields)}).");
+                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its DLL '{mod.Manifest.EntryDll}' doesn't exist.");
                         continue;
                     }
                 }
 
-                // validate ID format
-                if (!PathUtilities.IsSlug(mod.Manifest.UniqueID))
-                    mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, "its manifest specifies an invalid ID (IDs must only contain letters, numbers, underscores, periods, or hyphens).");
-
-                // validate dependencies
-                foreach (IManifestDependency? dependency in mod.Manifest.Dependencies)
+                // validate manifest
+                if (mod.Manifest is Manifest manifest && !manifest.TryValidate(out string manifestError))
                 {
-                    // null dependency
-                    if (dependency == null)
-                    {
-                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has a null entry under {nameof(IManifest.Dependencies)}.");
-                        continue;
-                    }
-
-                    // missing ID
-                    if (string.IsNullOrWhiteSpace(dependency.UniqueID))
-                    {
-                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has a {nameof(IManifest.Dependencies)} entry with no {nameof(IManifestDependency.UniqueID)} field.");
-                        continue;
-                    }
-
-                    // invalid ID
-                    if (!PathUtilities.IsSlug(dependency.UniqueID))
-                        mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its manifest has a {nameof(IManifest.Dependencies)} entry with an invalid {nameof(IManifestDependency.UniqueID)} field (IDs must only contain letters, numbers, underscores, periods, or hyphens).");
+                    mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its {manifestError}");
+                    continue;
                 }
             }
 

From 55eec58eafb9ba07f3e8b0a1c8394cb114de17a0 Mon Sep 17 00:00:00 2001
From: Tyler <gibbstyler7@gmail.com>
Date: Wed, 19 Oct 2022 10:21:19 -0500
Subject: [PATCH 816/856] simplify ContentPackFor validation check

---
 src/SMAPI.Toolkit/Serialization/Models/Manifest.cs | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 4f84a60d..1607cf3e 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -134,15 +134,11 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
                 return false;
             }
 
-            // validate content pack
-            else if (isContentPack)
+            // validate content pack ID
+            else if (isContentPack && string.IsNullOrWhiteSpace(this.ContentPackFor!.UniqueID))
             {
-                // invalid content pack ID
-                if (string.IsNullOrWhiteSpace(this.ContentPackFor!.UniqueID))
-                {
-                    error = $"manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.";
-                    return false;
-                }
+                error = $"manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.";
+                return false;
             }
 
             // validate required fields

From 8090b30c6e489ae213493328d6f84f15ca18a592 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 21 Oct 2022 20:12:02 -0400
Subject: [PATCH 817/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 5 +++--
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 2f1f822e..3c22b913 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.17.1</Version>
+    <Version>3.17.2</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 02d085d5..a8ddb0a0 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,10 +7,11 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.17.2
+Released 21 October 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
   * Fixed installer crash if Steam's library data is invalid or in an old format; it'll now be ignored instead.
-
 * For mod authors:
   * Fixed image patches sometimes applied one pixel higher than expected after 3.17.0 (thanks to atravita!).
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index ecac30bf..d1296dbe 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.17.1",
+    "Version": "3.17.2",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.17.1"
+    "MinimumApiVersion": "3.17.2"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index 3d708876..c3757e8f 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.17.1",
+    "Version": "3.17.2",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.17.1"
+    "MinimumApiVersion": "3.17.2"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index c2bf5f05..78821a3e 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.17.1",
+    "Version": "3.17.2",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.17.1"
+    "MinimumApiVersion": "3.17.2"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index ea41a4ee..77900ca6 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.17.1";
+        internal static string RawApiVersion = "3.17.2";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From bb2fde18292352471501887013ca2b7f60a9dc25 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Dola=C5=9B?= <me@shockah.pl>
Date: Wed, 9 Nov 2022 17:25:25 +0100
Subject: [PATCH 818/856] Added ModsToLoadFirst/Last to SMAPI config, along
 with the implementation

---
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 22 ++++++++++++++-----
 src/SMAPI/Framework/Models/SConfig.cs         | 12 +++++++++-
 src/SMAPI/Framework/SCore.cs                  | 10 ++++++++-
 src/SMAPI/SMAPI.config.json                   | 12 +++++++++-
 4 files changed, 48 insertions(+), 8 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index fe56f4d2..b90f9ba5 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -245,7 +245,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Sort the given mods by the order they should be loaded.</summary>
         /// <param name="mods">The mods to process.</param>
         /// <param name="modDatabase">Handles access to SMAPI's internal mod metadata list.</param>
-        public IEnumerable<IModMetadata> ProcessDependencies(IEnumerable<IModMetadata> mods, ModDatabase modDatabase)
+        /// <param name="modIdsToLoadFirst">The mod IDs SMAPI should try to load first, before any other mods not included in this list.</param>
+        /// <param name="modIdsToLoadLast">The mod IDs SMAPI should try to load last, after all other mods not included in this list.</param>
+        public IEnumerable<IModMetadata> ProcessDependencies(IEnumerable<IModMetadata> mods, IReadOnlyList<string> modIdsToLoadFirst, IReadOnlyList<string> modIdsToLoadLast, ModDatabase modDatabase)
         {
             // initialize metadata
             mods = mods.ToArray();
@@ -260,8 +262,18 @@ namespace StardewModdingAPI.Framework.ModLoading
             }
 
             // sort mods
-            foreach (IModMetadata mod in mods)
-                this.ProcessDependencies(mods.ToArray(), modDatabase, mod, states, sortedMods, new List<IModMetadata>());
+            IModMetadata[] allMods = mods.ToArray();
+            IModMetadata[] modsToLoadFirst = allMods.Where(m => modIdsToLoadFirst.Contains(m.Manifest.UniqueID)).ToArray();
+            IModMetadata[] modsToLoadLast = allMods.Where(m => modIdsToLoadLast.Contains(m.Manifest.UniqueID)).ToArray();
+            IModMetadata[] modsToLoadAsUsual = allMods.Where(m => !modsToLoadFirst.Contains(m) && !modsToLoadLast.Contains(m)).ToArray();
+
+            List<IModMetadata> orderSortedMods = new();
+            orderSortedMods.AddRange(modsToLoadFirst);
+            orderSortedMods.AddRange(modsToLoadAsUsual);
+            orderSortedMods.AddRange(modsToLoadLast);
+
+            foreach (IModMetadata mod in orderSortedMods)
+                this.ProcessDependencies(orderSortedMods, modDatabase, mod, states, sortedMods, new List<IModMetadata>());
 
             return sortedMods.Reverse();
         }
@@ -278,7 +290,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <param name="sortedMods">The list in which to save mods sorted by dependency order.</param>
         /// <param name="currentChain">The current change of mod dependencies.</param>
         /// <returns>Returns the mod dependency status.</returns>
-        private ModDependencyStatus ProcessDependencies(IModMetadata[] mods, ModDatabase modDatabase, IModMetadata mod, IDictionary<IModMetadata, ModDependencyStatus> states, Stack<IModMetadata> sortedMods, ICollection<IModMetadata> currentChain)
+        private ModDependencyStatus ProcessDependencies(IReadOnlyList<IModMetadata> mods, ModDatabase modDatabase, IModMetadata mod, IDictionary<IModMetadata, ModDependencyStatus> states, Stack<IModMetadata> sortedMods, ICollection<IModMetadata> currentChain)
         {
             // check if already visited
             switch (states[mod])
@@ -409,7 +421,7 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Get the dependencies declared in a manifest.</summary>
         /// <param name="manifest">The mod manifest.</param>
         /// <param name="loadedMods">The loaded mods.</param>
-        private IEnumerable<ModDependency> GetDependenciesFrom(IManifest manifest, IModMetadata[] loadedMods)
+        private IEnumerable<ModDependency> GetDependenciesFrom(IManifest manifest, IReadOnlyList<IModMetadata> loadedMods)
         {
             IModMetadata? FindMod(string id) => loadedMods.FirstOrDefault(m => m.HasID(id));
 
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index bceb0940..ddd721d5 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -82,6 +82,12 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
         public HashSet<string> SuppressUpdateChecks { get; set; }
 
+        /// <summary>The mod IDs SMAPI should try to load first, before any other mods not included in this list.</summary>
+        public List<string> ModsToLoadFirst { get; set; }
+
+        /// <summary>The mod IDs SMAPI should try to load last, after all other mods not included in this list.</summary>
+        public List<string> ModsToLoadLast { get; set; }
+
 
         /********
         ** Public methods
@@ -100,7 +106,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressHarmonyDebugMode">Whether to prevent mods from enabling Harmony's debug mode, which impacts performance and creates a file on your desktop. Debug mode should never be enabled by a released mod.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks)
+        /// <param name="modsToLoadFirst">The mod IDs SMAPI should try to load first, before any other mods not included in this list.</param>
+        /// <param name="modsToLoadLast">The mod IDs SMAPI should try to load last, after all other mods not included in this list.</param>
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks, string[]? modsToLoadFirst, string[]? modsToLoadLast)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
@@ -115,6 +123,8 @@ namespace StardewModdingAPI.Framework.Models
             this.ConsoleColors = consoleColors;
             this.SuppressHarmonyDebugMode = suppressHarmonyDebugMode ?? (bool)SConfig.DefaultValues[nameof(this.SuppressHarmonyDebugMode)];
             this.SuppressUpdateChecks = new HashSet<string>(suppressUpdateChecks ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
+            this.ModsToLoadFirst = new List<string>(modsToLoadFirst ?? Array.Empty<string>());
+            this.ModsToLoadLast = new List<string>(modsToLoadLast ?? Array.Empty<string>());
         }
 
         /// <summary>Override the value of <see cref="DeveloperMode"/>.</summary>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 40979b09..7bd60490 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -423,9 +423,17 @@ namespace StardewModdingAPI.Framework
                     this.Monitor.Log($"  Skipped {mod.GetRelativePathWithRoot()} (folder name starts with a dot).");
                 mods = mods.Where(p => !p.IsIgnored).ToArray();
 
+                // warn about mods that should load first or last which are not found at all
+                foreach (string modId in this.Settings.ModsToLoadFirst)
+                    if (!mods.Any(m => m.Manifest.UniqueID == modId))
+                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load first, but it could not be found.", LogLevel.Warn);
+                foreach (string modId in this.Settings.ModsToLoadLast)
+                    if (!mods.Any(m => m.Manifest.UniqueID == modId))
+                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load last, but it could not be found.", LogLevel.Warn);
+
                 // load mods
                 resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl, getFileLookup: this.GetFileLookup);
-                mods = resolver.ProcessDependencies(mods, modDatabase).ToArray();
+                mods = resolver.ProcessDependencies(mods, this.Settings.ModsToLoadFirst, this.Settings.ModsToLoadLast, modDatabase).ToArray();
                 this.LoadMods(mods, this.Toolkit.JsonHelper, this.ContentCore, modDatabase);
 
                 // check for software likely to cause issues
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 635e3add..1a342df2 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -141,5 +141,15 @@ copy all the settings, or you may cause bugs due to overridden changes in future
         "SMAPI.ConsoleCommands",
         "SMAPI.ErrorHandler",
         "SMAPI.SaveBackup"
-    ]
+    ],
+
+    /**
+     * The mod IDs SMAPI should try to load first, before any other mods not included in this list.
+     */
+    "ModsToLoadFirst": [],
+
+    /**
+     * The mod IDs SMAPI should try to load last, after all other mods not included in this list.
+     */
+    "ModsToLoadLast": []
 }

From 42b4b6b6a4ae1bb59182857b383539b24b063215 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Dola=C5=9B?= <me@shockah.pl>
Date: Wed, 9 Nov 2022 19:50:32 +0100
Subject: [PATCH 819/856] Renamed first/last to early/late; ignoring mods
 declared as both and warning about those

---
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 16 ++++++++--------
 src/SMAPI/Framework/Models/SConfig.cs         | 18 +++++++++---------
 src/SMAPI/Framework/SCore.cs                  | 15 +++++++++------
 src/SMAPI/SMAPI.config.json                   |  8 ++++----
 4 files changed, 30 insertions(+), 27 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index b90f9ba5..f9ba73c4 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -245,9 +245,9 @@ namespace StardewModdingAPI.Framework.ModLoading
         /// <summary>Sort the given mods by the order they should be loaded.</summary>
         /// <param name="mods">The mods to process.</param>
         /// <param name="modDatabase">Handles access to SMAPI's internal mod metadata list.</param>
-        /// <param name="modIdsToLoadFirst">The mod IDs SMAPI should try to load first, before any other mods not included in this list.</param>
-        /// <param name="modIdsToLoadLast">The mod IDs SMAPI should try to load last, after all other mods not included in this list.</param>
-        public IEnumerable<IModMetadata> ProcessDependencies(IEnumerable<IModMetadata> mods, IReadOnlyList<string> modIdsToLoadFirst, IReadOnlyList<string> modIdsToLoadLast, ModDatabase modDatabase)
+        /// <param name="modIdsToLoadEarly">The mod IDs SMAPI should try to load early, before any other mods not included in this list.</param>
+        /// <param name="modIdsToLoadLate">The mod IDs SMAPI should try to load late, after all other mods not included in this list.</param>
+        public IEnumerable<IModMetadata> ProcessDependencies(IEnumerable<IModMetadata> mods, IReadOnlyList<string> modIdsToLoadEarly, IReadOnlyList<string> modIdsToLoadLate, ModDatabase modDatabase)
         {
             // initialize metadata
             mods = mods.ToArray();
@@ -263,14 +263,14 @@ namespace StardewModdingAPI.Framework.ModLoading
 
             // sort mods
             IModMetadata[] allMods = mods.ToArray();
-            IModMetadata[] modsToLoadFirst = allMods.Where(m => modIdsToLoadFirst.Contains(m.Manifest.UniqueID)).ToArray();
-            IModMetadata[] modsToLoadLast = allMods.Where(m => modIdsToLoadLast.Contains(m.Manifest.UniqueID)).ToArray();
-            IModMetadata[] modsToLoadAsUsual = allMods.Where(m => !modsToLoadFirst.Contains(m) && !modsToLoadLast.Contains(m)).ToArray();
+            IModMetadata[] modsToLoadEarly = allMods.Where(m => modIdsToLoadEarly.Contains(m.Manifest.UniqueID) && !modIdsToLoadLate.Contains(m.Manifest.UniqueID)).ToArray();
+            IModMetadata[] modsToLoadLate = allMods.Where(m => modIdsToLoadLate.Contains(m.Manifest.UniqueID) && !modIdsToLoadEarly.Contains(m.Manifest.UniqueID)).ToArray();
+            IModMetadata[] modsToLoadAsUsual = allMods.Where(m => !modsToLoadEarly.Contains(m) && !modsToLoadLate.Contains(m)).ToArray();
 
             List<IModMetadata> orderSortedMods = new();
-            orderSortedMods.AddRange(modsToLoadFirst);
+            orderSortedMods.AddRange(modsToLoadEarly);
             orderSortedMods.AddRange(modsToLoadAsUsual);
-            orderSortedMods.AddRange(modsToLoadLast);
+            orderSortedMods.AddRange(modsToLoadLate);
 
             foreach (IModMetadata mod in orderSortedMods)
                 this.ProcessDependencies(orderSortedMods, modDatabase, mod, states, sortedMods, new List<IModMetadata>());
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index ddd721d5..40d3450f 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -82,11 +82,11 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
         public HashSet<string> SuppressUpdateChecks { get; set; }
 
-        /// <summary>The mod IDs SMAPI should try to load first, before any other mods not included in this list.</summary>
-        public List<string> ModsToLoadFirst { get; set; }
+        /// <summary>The mod IDs SMAPI should try to load early, before any other mods not included in this list.</summary>
+        public List<string> ModsToLoadEarly { get; set; }
 
-        /// <summary>The mod IDs SMAPI should try to load last, after all other mods not included in this list.</summary>
-        public List<string> ModsToLoadLast { get; set; }
+        /// <summary>The mod IDs SMAPI should try to load late, after all other mods not included in this list.</summary>
+        public List<string> ModsToLoadLate { get; set; }
 
 
         /********
@@ -106,9 +106,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressHarmonyDebugMode">Whether to prevent mods from enabling Harmony's debug mode, which impacts performance and creates a file on your desktop. Debug mode should never be enabled by a released mod.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        /// <param name="modsToLoadFirst">The mod IDs SMAPI should try to load first, before any other mods not included in this list.</param>
-        /// <param name="modsToLoadLast">The mod IDs SMAPI should try to load last, after all other mods not included in this list.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks, string[]? modsToLoadFirst, string[]? modsToLoadLast)
+        /// <param name="modsToLoadEarly">The mod IDs SMAPI should try to load early, before any other mods not included in this list.</param>
+        /// <param name="modsToLoadLate">The mod IDs SMAPI should try to load late, after all other mods not included in this list.</param>
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks, string[]? modsToLoadEarly, string[]? modsToLoadLate)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
@@ -123,8 +123,8 @@ namespace StardewModdingAPI.Framework.Models
             this.ConsoleColors = consoleColors;
             this.SuppressHarmonyDebugMode = suppressHarmonyDebugMode ?? (bool)SConfig.DefaultValues[nameof(this.SuppressHarmonyDebugMode)];
             this.SuppressUpdateChecks = new HashSet<string>(suppressUpdateChecks ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
-            this.ModsToLoadFirst = new List<string>(modsToLoadFirst ?? Array.Empty<string>());
-            this.ModsToLoadLast = new List<string>(modsToLoadLast ?? Array.Empty<string>());
+            this.ModsToLoadEarly = new List<string>(modsToLoadEarly ?? Array.Empty<string>());
+            this.ModsToLoadLate = new List<string>(modsToLoadLate ?? Array.Empty<string>());
         }
 
         /// <summary>Override the value of <see cref="DeveloperMode"/>.</summary>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 7bd60490..9e91924e 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -423,17 +423,20 @@ namespace StardewModdingAPI.Framework
                     this.Monitor.Log($"  Skipped {mod.GetRelativePathWithRoot()} (folder name starts with a dot).");
                 mods = mods.Where(p => !p.IsIgnored).ToArray();
 
-                // warn about mods that should load first or last which are not found at all
-                foreach (string modId in this.Settings.ModsToLoadFirst)
+                // warn about mods that should load early or late which are not found at all, or both
+                foreach (string modId in this.Settings.ModsToLoadEarly)
                     if (!mods.Any(m => m.Manifest.UniqueID == modId))
-                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load first, but it could not be found.", LogLevel.Warn);
-                foreach (string modId in this.Settings.ModsToLoadLast)
+                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load early, but it could not be found.", LogLevel.Warn);
+                foreach (string modId in this.Settings.ModsToLoadLate)
                     if (!mods.Any(m => m.Manifest.UniqueID == modId))
-                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load last, but it could not be found.", LogLevel.Warn);
+                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load late, but it could not be found.", LogLevel.Warn);
+                foreach (string modId in this.Settings.ModsToLoadEarly)
+                    if (this.Settings.ModsToLoadLate.Contains(modId))
+                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load both early and late - this will be ignored.", LogLevel.Warn);
 
                 // load mods
                 resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl, getFileLookup: this.GetFileLookup);
-                mods = resolver.ProcessDependencies(mods, this.Settings.ModsToLoadFirst, this.Settings.ModsToLoadLast, modDatabase).ToArray();
+                mods = resolver.ProcessDependencies(mods, this.Settings.ModsToLoadEarly, this.Settings.ModsToLoadLate, modDatabase).ToArray();
                 this.LoadMods(mods, this.Toolkit.JsonHelper, this.ContentCore, modDatabase);
 
                 // check for software likely to cause issues
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 1a342df2..68645d24 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -144,12 +144,12 @@ copy all the settings, or you may cause bugs due to overridden changes in future
     ],
 
     /**
-     * The mod IDs SMAPI should try to load first, before any other mods not included in this list.
+     * The mod IDs SMAPI should try to load early, before any other mods not included in this list.
      */
-    "ModsToLoadFirst": [],
+    "ModsToLoadEarly": [],
 
     /**
-     * The mod IDs SMAPI should try to load last, after all other mods not included in this list.
+     * The mod IDs SMAPI should try to load late, after all other mods not included in this list.
      */
-    "ModsToLoadLast": []
+    "ModsToLoadLate": []
 }

From 9fd8c35b462bc19efb520da21cda66f83559a66e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Dola=C5=9B?= <me@shockah.pl>
Date: Wed, 9 Nov 2022 20:26:50 +0100
Subject: [PATCH 820/856] Actually taking order into consideration

---
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 14 ++++++++++++--
 src/SMAPI/Framework/SCore.cs                  |  4 ++--
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index f9ba73c4..8ef5e4a8 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -263,8 +263,18 @@ namespace StardewModdingAPI.Framework.ModLoading
 
             // sort mods
             IModMetadata[] allMods = mods.ToArray();
-            IModMetadata[] modsToLoadEarly = allMods.Where(m => modIdsToLoadEarly.Contains(m.Manifest.UniqueID) && !modIdsToLoadLate.Contains(m.Manifest.UniqueID)).ToArray();
-            IModMetadata[] modsToLoadLate = allMods.Where(m => modIdsToLoadLate.Contains(m.Manifest.UniqueID) && !modIdsToLoadEarly.Contains(m.Manifest.UniqueID)).ToArray();
+            IModMetadata[] modsToLoadEarly = modIdsToLoadEarly
+                .Where(modId => !modIdsToLoadLate.Contains(modId))
+                .Select(modId => allMods.FirstOrDefault(m => m.Manifest.UniqueID == modId))
+                .Where(m => m != null)
+                .Select(m => m!)
+                .ToArray();
+            IModMetadata[] modsToLoadLate = modIdsToLoadLate
+                .Where(modId => !modIdsToLoadEarly.Contains(modId))
+                .Select(modId => allMods.FirstOrDefault(m => m.Manifest.UniqueID == modId))
+                .Where(m => m != null)
+                .Select(m => m!)
+                .ToArray();
             IModMetadata[] modsToLoadAsUsual = allMods.Where(m => !modsToLoadEarly.Contains(m) && !modsToLoadLate.Contains(m)).ToArray();
 
             List<IModMetadata> orderSortedMods = new();
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 9e91924e..4d1eb959 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -426,10 +426,10 @@ namespace StardewModdingAPI.Framework
                 // warn about mods that should load early or late which are not found at all, or both
                 foreach (string modId in this.Settings.ModsToLoadEarly)
                     if (!mods.Any(m => m.Manifest.UniqueID == modId))
-                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load early, but it could not be found.", LogLevel.Warn);
+                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load early, but it could not be found or was skipped.", LogLevel.Warn);
                 foreach (string modId in this.Settings.ModsToLoadLate)
                     if (!mods.Any(m => m.Manifest.UniqueID == modId))
-                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load late, but it could not be found.", LogLevel.Warn);
+                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load late, but it could not be found or was skipped.", LogLevel.Warn);
                 foreach (string modId in this.Settings.ModsToLoadEarly)
                     if (this.Settings.ModsToLoadLate.Contains(modId))
                         this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load both early and late - this will be ignored.", LogLevel.Warn);

From beb0b0aaf4e349cf911504a72b484d5642f6ac58 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 9 Nov 2022 20:03:41 -0500
Subject: [PATCH 821/856] fix & improve split-screen column in log parser

---
 docs/release-notes.md                                 |  4 ++++
 src/SMAPI.Web/Framework/LogParsing/LogParser.cs       |  4 ++++
 .../Framework/LogParsing/Models/ParsedLog.cs          |  3 +++
 src/SMAPI.Web/Views/LogParser/Index.cshtml            |  6 +++---
 src/SMAPI.Web/wwwroot/Content/js/log-parser.js        | 11 ++---------
 5 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index a8ddb0a0..e140b13b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
+## Upcoming release
+* For the web UI:
+  * Fixed log parser not showing screen IDs in split-screen mode, and improved screen display.
+
 ## 3.17.2
 Released 21 October 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
index 5e0dedf3..c39e612b 100644
--- a/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/LogParser.cs
@@ -108,6 +108,10 @@ namespace StardewModdingAPI.Web.Framework.LogParsing
                         }
                     }
 
+                    // detect split-screen mode
+                    if (message.ScreenId != 0)
+                        log.IsSplitScreen = true;
+
                     // collect SMAPI metadata
                     if (message.Mod == "SMAPI")
                     {
diff --git a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
index cda0f653..2a2e5f5c 100644
--- a/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
+++ b/src/SMAPI.Web/Framework/LogParsing/Models/ParsedLog.cs
@@ -22,6 +22,9 @@ namespace StardewModdingAPI.Web.Framework.LogParsing.Models
         /// <summary>The raw log text.</summary>
         public string? RawText { get; set; }
 
+        /// <summary>Whether there are messages from multiple screens in the log.</summary>
+        public bool IsSplitScreen { get; set; }
+
         /****
         ** Log data
         ****/
diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index 28127903..c1251c21 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -47,7 +47,7 @@
     <script src="https://cdn.jsdelivr.net/npm/vue@2.6.14" crossorigin="anonymous"></script>
     <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1" crossorigin="anonymous"></script>
     <script src="~/Content/js/file-upload.js"></script>
-    <script src="~/Content/js/log-parser.js?r=20220409"></script>
+    <script src="~/Content/js/log-parser.js"></script>
 
     <script id="serializedData" type="application/json">
         @if (!Model.ShowRaw)
@@ -86,7 +86,8 @@
                     showMods: @this.ForJson(log?.Mods.Where(p => p.Loaded && !p.IsContentPack).Select(p => Model.GetSlug(p.Name)).Distinct().ToDictionary(slug => slug, _ => true)),
                     showSections: @this.ForJson(Enum.GetNames(typeof(LogSection)).ToDictionary(section => section, _ => false)),
                     showLevels: @this.ForJson(defaultFilters),
-                    enableFilters: @this.ForJson(!Model.ShowRaw)
+                    enableFilters: @this.ForJson(!Model.ShowRaw),
+                    isSplitScreen: @this.ForJson(log?.IsSplitScreen ?? false)
                 }
             );
 
@@ -494,7 +495,6 @@ else if (log?.IsValid == true)
                 <log-line
                     v-for="msg in visibleMessages"
                     v-bind:key="msg.id"
-                    v-bind:showScreenId="showScreenId"
                     v-bind:message="msg"
                     v-bind:highlight="shouldHighlight"
                 />
diff --git a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
index fccd00be..324218bb 100644
--- a/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
+++ b/src/SMAPI.Web/wwwroot/Content/js/log-parser.js
@@ -424,10 +424,6 @@ smapi.logParser = function (state) {
     Vue.component("log-line", {
         functional: true,
         props: {
-            showScreenId: {
-                type: Boolean,
-                required: true
-            },
             message: {
                 type: Object,
                 required: true
@@ -456,7 +452,7 @@ smapi.logParser = function (state) {
                             "td",
                             {
                                 attrs: {
-                                    colspan: context.props.showScreenId ? 4 : 3
+                                    colspan: state.isSplitScreen ? 4 : 3
                                 }
                             },
                             ""
@@ -541,7 +537,7 @@ smapi.logParser = function (state) {
                 },
                 [
                     createElement("td", message.Time),
-                    context.props.showScreenId ? createElement("td", message.ScreenId) : null,
+                    state.isSplitScreen ? createElement("td", { attrs: { title: (message.ScreenId == 0 ? "main screen" : "screen #" + (message.ScreenId + 1)) + " in split-screen mode" } }, `🖵${message.ScreenId + 1}`) : null,
                     createElement("td", level.toUpperCase()),
                     createElement(
                         "td",
@@ -588,9 +584,6 @@ smapi.logParser = function (state) {
             anyModsShown: function () {
                 return stats.modsShown > 0;
             },
-            showScreenId: function () {
-                return this.data.screenIds.length > 1;
-            },
 
             // Maybe not strictly necessary, but the Vue template is being
             // weird about accessing data entries on the app rather than

From 76e5588f02b247204969efb488c3fb293601faeb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 9 Nov 2022 21:41:04 -0500
Subject: [PATCH 822/856] add option to disable console input

---
 docs/release-notes.md                 |  3 +++
 src/SMAPI/Framework/Models/SConfig.cs | 34 ++++++++++++++++-----------
 src/SMAPI/Framework/SCore.cs          | 19 ++++++++-------
 src/SMAPI/SMAPI.config.json           |  6 +++++
 4 files changed, 40 insertions(+), 22 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index e140b13b..0843f59a 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Added config option to disable console input. This may reduce CPU usage on some Linux systems.
+
 * For the web UI:
   * Fixed log parser not showing screen IDs in split-screen mode, and improved screen display.
 
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index bceb0940..825ebb44 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -16,6 +16,7 @@ namespace StardewModdingAPI.Framework.Models
         private static readonly IDictionary<string, object> DefaultValues = new Dictionary<string, object>
         {
             [nameof(CheckForUpdates)] = true,
+            [nameof(ListenForConsoleInput)] = true,
             [nameof(ParanoidWarnings)] = Constants.IsDebugBuild,
             [nameof(UseBetaChannel)] = Constants.ApiVersion.IsPrerelease(),
             [nameof(GitHubProjectName)] = "Pathoschild/SMAPI",
@@ -48,6 +49,9 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>Whether to check for newer versions of SMAPI and mods on startup.</summary>
         public bool CheckForUpdates { get; set; }
 
+        /// <summary>Whether SMAPI should listen for console input to support console commands.</summary>
+        public bool ListenForConsoleInput { get; set; }
+
         /// <summary>Whether to add a section to the 'mod issues' list for mods which which directly use potentially sensitive .NET APIs like file or shell access.</summary>
         public bool ParanoidWarnings { get; set; }
 
@@ -87,23 +91,25 @@ namespace StardewModdingAPI.Framework.Models
         ** Public methods
         ********/
         /// <summary>Construct an instance.</summary>
-        /// <param name="developerMode">Whether to enable development features.</param>
-        /// <param name="checkForUpdates">Whether to check for newer versions of SMAPI and mods on startup.</param>
-        /// <param name="paranoidWarnings">Whether to add a section to the 'mod issues' list for mods which which directly use potentially sensitive .NET APIs like file or shell access.</param>
-        /// <param name="useBetaChannel">Whether to show beta versions as valid updates.</param>
-        /// <param name="gitHubProjectName">SMAPI's GitHub project name, used to perform update checks.</param>
-        /// <param name="webApiBaseUrl">The base URL for SMAPI's web API, used to perform update checks.</param>
-        /// <param name="verboseLogging">The log contexts for which to enable verbose logging, which may show a lot more information to simplify troubleshooting.</param>
-        /// <param name="rewriteMods">Whether SMAPI should rewrite mods for compatibility.</param>
-        /// <param name="useCaseInsensitivePaths">>Whether to make SMAPI file APIs case-insensitive, even on Linux.</param>
-        /// <param name="logNetworkTraffic">Whether SMAPI should log network traffic.</param>
-        /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
-        /// <param name="suppressHarmonyDebugMode">Whether to prevent mods from enabling Harmony's debug mode, which impacts performance and creates a file on your desktop. Debug mode should never be enabled by a released mod.</param>
-        /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks)
+        /// <param name="developerMode"><inheritdoc cref="DeveloperMode" path="/summary" /></param>
+        /// <param name="checkForUpdates"><inheritdoc cref="CheckForUpdates" path="/summary" /></param>
+        /// <param name="listenForConsoleInput"><inheritdoc cref="ListenForConsoleInput" path="/summary" /></param>
+        /// <param name="paranoidWarnings"><inheritdoc cref="ParanoidWarnings" path="/summary" /></param>
+        /// <param name="useBetaChannel"><inheritdoc cref="UseBetaChannel" path="/summary" /></param>
+        /// <param name="gitHubProjectName"><inheritdoc cref="GitHubProjectName" path="/summary" /></param>
+        /// <param name="webApiBaseUrl"><inheritdoc cref="WebApiBaseUrl" path="/summary" /></param>
+        /// <param name="verboseLogging"><inheritdoc cref="VerboseLogging" path="/summary" /></param>
+        /// <param name="rewriteMods"><inheritdoc cref="RewriteMods" path="/summary" /></param>
+        /// <param name="useCaseInsensitivePaths"><inheritdoc cref="UseCaseInsensitivePaths" path="/summary" /></param>
+        /// <param name="logNetworkTraffic"><inheritdoc cref="LogNetworkTraffic" path="/summary" /></param>
+        /// <param name="consoleColors"><inheritdoc cref="ConsoleColors" path="/summary" /></param>
+        /// <param name="suppressHarmonyDebugMode"><inheritdoc cref="SuppressHarmonyDebugMode" path="/summary" /></param>
+        /// <param name="suppressUpdateChecks"><inheritdoc cref="SuppressUpdateChecks" path="/summary" /></param>
+        public SConfig(bool developerMode, bool? checkForUpdates, bool? listenForConsoleInput, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks)
         {
             this.DeveloperMode = developerMode;
             this.CheckForUpdates = checkForUpdates ?? (bool)SConfig.DefaultValues[nameof(this.CheckForUpdates)];
+            this.ListenForConsoleInput = listenForConsoleInput ?? (bool)SConfig.DefaultValues[nameof(this.ListenForConsoleInput)];
             this.ParanoidWarnings = paranoidWarnings ?? (bool)SConfig.DefaultValues[nameof(this.ParanoidWarnings)];
             this.UseBetaChannel = useBetaChannel ?? (bool)SConfig.DefaultValues[nameof(this.UseBetaChannel)];
             this.GitHubProjectName = gitHubProjectName;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 40979b09..7bb54653 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -447,14 +447,17 @@ namespace StardewModdingAPI.Framework
                 this.Monitor.Log("SMAPI found problems in your game's content files which are likely to cause errors or crashes. Consider uninstalling XNB mods or reinstalling the game.", LogLevel.Error);
 
             // start SMAPI console
-            new Thread(
-                () => this.LogManager.RunConsoleInputLoop(
-                    commandManager: this.CommandManager,
-                    reloadTranslations: this.ReloadTranslations,
-                    handleInput: input => this.RawCommandQueue.Add(input),
-                    continueWhile: () => this.IsGameRunning && !this.IsExiting
-                )
-            ).Start();
+            if (this.Settings.ListenForConsoleInput)
+            {
+                new Thread(
+                    () => this.LogManager.RunConsoleInputLoop(
+                        commandManager: this.CommandManager,
+                        reloadTranslations: this.ReloadTranslations,
+                        handleInput: input => this.RawCommandQueue.Add(input),
+                        continueWhile: () => this.IsGameRunning && !this.IsExiting
+                    )
+                ).Start();
+            }
         }
 
         /// <summary>Raised after an instance finishes loading its initial content.</summary>
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 635e3add..52f25fdd 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -41,6 +41,12 @@ copy all the settings, or you may cause bugs due to overridden changes in future
      */
     "DeveloperMode": true,
 
+    /**
+     * Whether SMAPI should listen for console input. Disabling this will prevent you from using
+     * console commands. On some specific Linux systems, disabling this may reduce CPU usage.
+     */
+    "ListenForConsoleInput": true,
+
     /**
      * Whether SMAPI should rewrite mods for compatibility. This may prevent older mods from
      * loading, but bypasses a Visual Studio crash when debugging.

From 303b3924ae3ef905d77b9d7ef0f9efc70e58c2b8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 10 Nov 2022 21:50:01 -0500
Subject: [PATCH 823/856] fix case where prefix ends with a path separator

---
 src/SMAPI.Tests/Core/AssetNameTests.cs   |  8 +++++++-
 src/SMAPI/Framework/Content/AssetName.cs | 23 ++++++++++++-----------
 2 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index fbc94e95..fdaa2c01 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -151,6 +151,12 @@ namespace SMAPI.Tests.Core
 
         // with locale codes
         [TestCase("Data/Achievements.fr-FR", "Data/Achievements", ExpectedResult = true)]
+
+        // prefix ends with path separator
+        [TestCase("Data/Events/Boop", "Data/Events/", ExpectedResult = true)]
+        [TestCase("Data/Events/Boop", "Data/Events\\", ExpectedResult = true)]
+        [TestCase("Data/Events", "Data/Events/", ExpectedResult = false)]
+        [TestCase("Data/Events", "Data/Events\\", ExpectedResult = false)]
         public bool StartsWith_SimpleCases(string mainAssetName, string prefix)
         {
             // arrange
@@ -247,7 +253,7 @@ namespace SMAPI.Tests.Core
         [TestCase("Mods/SomeMod/SomeSubdirectory", "Mods/Some", false, ExpectedResult = false)]
         [TestCase("Mods/Jasper/Data", "Mods/Jas/Image", true, ExpectedResult = false)]
         [TestCase("Mods/Jasper/Data", "Mods/Jas/Image", true, ExpectedResult = false)]
-        public bool StartsWith_SubfolderWithPartial(string mainAssetName, string otherAssetName, bool allowSubfolder)
+        public bool StartsWith_PartialMatchInPathSegment(string mainAssetName, string otherAssetName, bool allowSubfolder)
         {
             // arrange
             mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 7b87c0c5..99968299 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -138,37 +138,38 @@ namespace StardewModdingAPI.Framework.Content
                 return false;
 
             // get initial values
-            ReadOnlySpan<char> trimmed = prefix.AsSpan().Trim();
-            if (trimmed.Length == 0)
+            ReadOnlySpan<char> trimmedPrefix = prefix.AsSpan().Trim();
+            if (trimmedPrefix.Length == 0)
                 return true;
             ReadOnlySpan<char> pathSeparators = new(ToolkitPathUtilities.PossiblePathSeparators); // just to simplify calling other span APIs
 
             // asset keys can't have a leading slash, but AssetPathYielder will trim them
-            if (pathSeparators.Contains(trimmed[0]))
+            if (pathSeparators.Contains(trimmedPrefix[0]))
                 return false;
 
             // compare segments
             AssetNamePartEnumerator curParts = new(this.Name);
-            AssetNamePartEnumerator prefixParts = new(trimmed);
+            AssetNamePartEnumerator prefixParts = new(trimmedPrefix);
             while (true)
             {
                 bool curHasMore = curParts.MoveNext();
                 bool prefixHasMore = prefixParts.MoveNext();
 
-                // reached end of prefix or asset name
+                // reached end for one side
                 if (prefixHasMore != curHasMore)
                 {
                     // mismatch: prefix is longer
                     if (prefixHasMore)
                         return false;
 
-                    // possible match: all prefix segments matched.
-                    return allowSubfolder || (pathSeparators.Contains(trimmed[^1]) ? curParts.Remainder.Length == 0 : curParts.Current.Length == 0);
+                    // match if subfolder paths are fine (e.g. prefix 'Data/Events' with target 'Data/Events/Beach')
+                    return allowSubfolder;
                 }
 
-                // match: previous segments matched exactly and both reached the end
+                // previous segments matched exactly and both reached the end
+                // match if prefix doesn't end with '/' (which should only match subfolders)
                 if (!prefixHasMore)
-                    return true;
+                    return !pathSeparators.Contains(trimmedPrefix[^1]);
 
                 // compare segment
                 if (curParts.Current.Length == prefixParts.Current.Length)
@@ -188,7 +189,7 @@ namespace StardewModdingAPI.Framework.Content
                         return false;
 
                     // mismatch: something like "Maps/" would need an exact match
-                    if (pathSeparators.Contains(trimmed[^1]))
+                    if (pathSeparators.Contains(trimmedPrefix[^1]))
                         return false;
 
                     // mismatch: partial word match not allowed, and the first or last letter of the suffix isn't a word separator
@@ -196,7 +197,7 @@ namespace StardewModdingAPI.Framework.Content
                         return false;
 
                     // possible match
-                    return allowSubfolder || (pathSeparators.Contains(trimmed[^1]) ? curParts.Remainder.IndexOfAny(ToolkitPathUtilities.PossiblePathSeparators) < 0 : curParts.Remainder.Length == 0);
+                    return allowSubfolder || (pathSeparators.Contains(trimmedPrefix[^1]) ? curParts.Remainder.IndexOfAny(ToolkitPathUtilities.PossiblePathSeparators) < 0 : curParts.Remainder.Length == 0);
                 }
             }
         }

From 346fddda670704c1458e42104ee7405fc1de7ccc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 10 Nov 2022 23:27:38 -0500
Subject: [PATCH 824/856] move validation logic out of Manifest model

This avoids tightly coupling higher logic to the implementation class, since we can validate the interface.
---
 src/SMAPI.ModBuildConfig/DeployModTask.cs     |   6 +-
 .../Framework/ManifestValidator.cs            | 101 ++++++++++++++++++
 .../Serialization/Models/Manifest.cs          |  92 ----------------
 src/SMAPI/Framework/ModLoading/ModResolver.cs |   3 +-
 4 files changed, 107 insertions(+), 95 deletions(-)
 create mode 100644 src/SMAPI.Toolkit/Framework/ManifestValidator.cs

diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index 357e02b5..70761a2f 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -9,6 +9,7 @@ using Microsoft.Build.Framework;
 using Microsoft.Build.Utilities;
 using Newtonsoft.Json;
 using StardewModdingAPI.ModBuildConfig.Framework;
+using StardewModdingAPI.Toolkit.Framework;
 using StardewModdingAPI.Toolkit.Serialization;
 using StardewModdingAPI.Toolkit.Serialization.Models;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -91,7 +92,8 @@ namespace StardewModdingAPI.ModBuildConfig
             try
             {
                 new JsonHelper().ReadJsonFileIfExists(manifestFile.FullName, out manifest);
-            } catch (JsonReaderException ex)
+            }
+            catch (JsonReaderException ex)
             {
                 // log the inner exception, otherwise the message will be generic
                 Exception exToShow = ex.InnerException ?? ex;
@@ -100,7 +102,7 @@ namespace StardewModdingAPI.ModBuildConfig
             }
 
             // validate the manifest's fields
-            if (!manifest.TryValidate(out string error))
+            if (!ManifestValidator.TryValidate(manifest, out string error))
             {
                 this.Log.LogError($"[mod build package] The mod manifest is invalid: {error}");
                 return false;
diff --git a/src/SMAPI.Toolkit/Framework/ManifestValidator.cs b/src/SMAPI.Toolkit/Framework/ManifestValidator.cs
new file mode 100644
index 00000000..62cfd8e9
--- /dev/null
+++ b/src/SMAPI.Toolkit/Framework/ManifestValidator.cs
@@ -0,0 +1,101 @@
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using StardewModdingAPI.Toolkit.Utilities;
+
+namespace StardewModdingAPI.Toolkit.Framework
+{
+    /// <summary>Validates manifest fields.</summary>
+    public static class ManifestValidator
+    {
+        /// <summary>Try to validate a manifest's fields. Fails if any invalid field is found.</summary>
+        /// <param name="manifest">The manifest to validate.</param>
+        /// <param name="error">The error message to display to the user.</param>
+        /// <returns>Returns whether the manifest was validated successfully.</returns>
+        public static bool TryValidate(IManifest manifest, out string error)
+        {
+            // validate DLL / content pack fields
+            bool hasDll = !string.IsNullOrWhiteSpace(manifest.EntryDll);
+            bool isContentPack = manifest.ContentPackFor != null;
+
+            // validate field presence
+            if (!hasDll && !isContentPack)
+            {
+                error = $"manifest has no {nameof(IManifest.EntryDll)} or {nameof(IManifest.ContentPackFor)} field; must specify one.";
+                return false;
+            }
+            if (hasDll && isContentPack)
+            {
+                error = $"manifest sets both {nameof(IManifest.EntryDll)} and {nameof(IManifest.ContentPackFor)}, which are mutually exclusive.";
+                return false;
+            }
+
+            // validate DLL filename format
+            if (hasDll && manifest.EntryDll!.Intersect(Path.GetInvalidFileNameChars()).Any())
+            {
+                error = $"manifest has invalid filename '{manifest.EntryDll}' for the EntryDLL field.";
+                return false;
+            }
+
+            // validate content pack ID
+            else if (isContentPack && string.IsNullOrWhiteSpace(manifest.ContentPackFor!.UniqueID))
+            {
+                error = $"manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.";
+                return false;
+            }
+
+            // validate required fields
+            {
+                List<string> missingFields = new List<string>(3);
+
+                if (string.IsNullOrWhiteSpace(manifest.Name))
+                    missingFields.Add(nameof(IManifest.Name));
+                if (manifest.Version == null || manifest.Version.ToString() == "0.0.0")
+                    missingFields.Add(nameof(IManifest.Version));
+                if (string.IsNullOrWhiteSpace(manifest.UniqueID))
+                    missingFields.Add(nameof(IManifest.UniqueID));
+
+                if (missingFields.Any())
+                {
+                    error = $"manifest is missing required fields ({string.Join(", ", missingFields)}).";
+                    return false;
+                }
+            }
+
+            // validate ID format
+            if (!PathUtilities.IsSlug(manifest.UniqueID))
+            {
+                error = "manifest specifies an invalid ID (IDs must only contain letters, numbers, underscores, periods, or hyphens).";
+                return false;
+            }
+
+            // validate dependencies
+            foreach (IManifestDependency? dependency in manifest.Dependencies)
+            {
+                // null dependency
+                if (dependency == null)
+                {
+                    error = $"manifest has a null entry under {nameof(IManifest.Dependencies)}.";
+                    return false;
+                }
+
+                // missing ID
+                if (string.IsNullOrWhiteSpace(dependency.UniqueID))
+                {
+                    error = $"manifest has a {nameof(IManifest.Dependencies)} entry with no {nameof(IManifestDependency.UniqueID)} field.";
+                    return false;
+                }
+
+                // invalid ID
+                if (!PathUtilities.IsSlug(dependency.UniqueID))
+                {
+                    error = $"manifest has a {nameof(IManifest.Dependencies)} entry with an invalid {nameof(IManifestDependency.UniqueID)} field (IDs must only contain letters, numbers, underscores, periods, or hyphens).";
+                    return false;
+                }
+            }
+
+            error = "";
+            return true;
+        }
+    }
+}
diff --git a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
index 1607cf3e..8a449f0a 100644
--- a/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
+++ b/src/SMAPI.Toolkit/Serialization/Models/Manifest.cs
@@ -1,12 +1,9 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
-using System.IO;
-using System.Linq;
 using System.Text;
 using Newtonsoft.Json;
 using StardewModdingAPI.Toolkit.Serialization.Converters;
-using StardewModdingAPI.Toolkit.Utilities;
 
 namespace StardewModdingAPI.Toolkit.Serialization.Models
 {
@@ -106,95 +103,6 @@ namespace StardewModdingAPI.Toolkit.Serialization.Models
             this.UpdateKeys = updateKeys ?? Array.Empty<string>();
         }
 
-        /// <summary>Try to validate a manifest's fields. Fails if any invalid field is found.</summary>
-        /// <param name="error">The error message to display to the user.</param>
-        /// <returns>Returns whether the manifest was validated successfully.</returns>
-        public bool TryValidate(out string error)
-        {
-            // validate DLL / content pack fields
-            bool hasDll = !string.IsNullOrWhiteSpace(this.EntryDll);
-            bool isContentPack = this.ContentPackFor != null;
-
-            // validate field presence
-            if (!hasDll && !isContentPack)
-            {
-                error = $"manifest has no {nameof(IManifest.EntryDll)} or {nameof(IManifest.ContentPackFor)} field; must specify one.";
-                return false;
-            }
-            if (hasDll && isContentPack)
-            {
-                error = $"manifest sets both {nameof(IManifest.EntryDll)} and {nameof(IManifest.ContentPackFor)}, which are mutually exclusive.";
-                return false;
-            }
-
-            // validate DLL filename format
-            if (hasDll && this.EntryDll!.Intersect(Path.GetInvalidFileNameChars()).Any())
-            {
-                error = $"manifest has invalid filename '{this.EntryDll}' for the EntryDLL field.";
-                return false;
-            }
-
-            // validate content pack ID
-            else if (isContentPack && string.IsNullOrWhiteSpace(this.ContentPackFor!.UniqueID))
-            {
-                error = $"manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.";
-                return false;
-            }
-
-            // validate required fields
-            {
-                List<string> missingFields = new List<string>(3);
-
-                if (string.IsNullOrWhiteSpace(this.Name))
-                    missingFields.Add(nameof(IManifest.Name));
-                if (this.Version == null || this.Version.ToString() == "0.0.0")
-                    missingFields.Add(nameof(IManifest.Version));
-                if (string.IsNullOrWhiteSpace(this.UniqueID))
-                    missingFields.Add(nameof(IManifest.UniqueID));
-
-                if (missingFields.Any())
-                {
-                    error = $"manifest is missing required fields ({string.Join(", ", missingFields)}).";
-                    return false;
-                }
-            }
-
-            // validate ID format
-            if (!PathUtilities.IsSlug(this.UniqueID))
-            {
-                error = "manifest specifies an invalid ID (IDs must only contain letters, numbers, underscores, periods, or hyphens).";
-                return false;
-            }
-
-            // validate dependencies
-            foreach (IManifestDependency? dependency in this.Dependencies)
-            {
-                // null dependency
-                if (dependency == null)
-                {
-                    error = $"manifest has a null entry under {nameof(IManifest.Dependencies)}.";
-                    return false;
-                }
-
-                // missing ID
-                if (string.IsNullOrWhiteSpace(dependency.UniqueID))
-                {
-                    error = $"manifest has a {nameof(IManifest.Dependencies)} entry with no {nameof(IManifestDependency.UniqueID)} field.";
-                    return false;
-                }
-
-                // invalid ID
-                if (!PathUtilities.IsSlug(dependency.UniqueID))
-                {
-                    error = $"manifest has a {nameof(IManifest.Dependencies)} entry with an invalid {nameof(IManifestDependency.UniqueID)} field (IDs must only contain letters, numbers, underscores, periods, or hyphens).";
-                    return false;
-                }
-            }
-
-            error = "";
-            return true;
-        }
-
         /// <summary>Override the update keys loaded from the mod info.</summary>
         /// <param name="updateKeys">The new update keys to set.</param>
         internal void OverrideUpdateKeys(params string[] updateKeys)
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 352c22cc..0b4fe3e9 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -4,6 +4,7 @@ using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using StardewModdingAPI.Toolkit;
+using StardewModdingAPI.Toolkit.Framework;
 using StardewModdingAPI.Toolkit.Framework.ModData;
 using StardewModdingAPI.Toolkit.Framework.ModScanning;
 using StardewModdingAPI.Toolkit.Framework.UpdateData;
@@ -138,7 +139,7 @@ namespace StardewModdingAPI.Framework.ModLoading
                 }
 
                 // validate manifest
-                if (mod.Manifest is Manifest manifest && !manifest.TryValidate(out string manifestError))
+                if (!ManifestValidator.TryValidate(mod.Manifest, out string manifestError))
                 {
                     mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its {manifestError}");
                     continue;

From 6ee0d2f93d5d06556915f41e29621c59d9e9e551 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 10 Nov 2022 23:27:38 -0500
Subject: [PATCH 825/856] don't validate manifest if we're not deploying or
 zipping the mod

That would break cases like unit test projects, which don't have a manifest.json file.
---
 src/SMAPI.ModBuildConfig/DeployModTask.cs | 66 ++++++++++++-----------
 1 file changed, 36 insertions(+), 30 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index 70761a2f..1581b282 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -79,38 +79,44 @@ namespace StardewModdingAPI.ModBuildConfig
                 this.Log.LogMessage(MessageImportance.High, $"[mod build package] Handling build with options {string.Join(", ", properties)}");
             }
 
-            // check if manifest file exists
-            FileInfo manifestFile = new(Path.Combine(this.ProjectDir, "manifest.json"));
-            if (!manifestFile.Exists)
-            {
-                this.Log.LogError("[mod build package] The mod does not have a manifest.json file.");
-                return false;
-            }
-
-            // check if the json is valid
-            Manifest manifest;
-            try
-            {
-                new JsonHelper().ReadJsonFileIfExists(manifestFile.FullName, out manifest);
-            }
-            catch (JsonReaderException ex)
-            {
-                // log the inner exception, otherwise the message will be generic
-                Exception exToShow = ex.InnerException ?? ex;
-                this.Log.LogError($"[mod build package] Failed to parse manifest.json: {exToShow.Message}");
-                return false;
-            }
-
-            // validate the manifest's fields
-            if (!ManifestValidator.TryValidate(manifest, out string error))
-            {
-                this.Log.LogError($"[mod build package] The mod manifest is invalid: {error}");
-                return false;
-            }
-
+            // skip if nothing to do
+            // (This must be checked before the manifest validation, to allow cases like unit test projects.)
             if (!this.EnableModDeploy && !this.EnableModZip)
-                return true; // nothing to do
+                return true;
 
+            // validate the manifest file
+            Manifest manifest;
+            {
+                // check if manifest file exists
+                FileInfo manifestFile = new(Path.Combine(this.ProjectDir, "manifest.json"));
+                if (!manifestFile.Exists)
+                {
+                    this.Log.LogError("[mod build package] The mod does not have a manifest.json file.");
+                    return false;
+                }
+
+                // check if the json is valid
+                try
+                {
+                    new JsonHelper().ReadJsonFileIfExists(manifestFile.FullName, out manifest);
+                }
+                catch (JsonReaderException ex)
+                {
+                    // log the inner exception, otherwise the message will be generic
+                    Exception exToShow = ex.InnerException ?? ex;
+                    this.Log.LogError($"[mod build package] Failed to parse manifest.json: {exToShow.Message}");
+                    return false;
+                }
+
+                // validate the manifest's fields
+                if (!ManifestValidator.TryValidate(manifest, out string error))
+                {
+                    this.Log.LogError($"[mod build package] The mod manifest is invalid: {error}");
+                    return false;
+                }
+            }
+
+            // deploy files
             try
             {
                 // parse extra DLLs to bundle

From 867afdd96ff8896dc81fdab204cf045713d32d91 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 10 Nov 2022 23:27:38 -0500
Subject: [PATCH 826/856] tweak new code

---
 src/SMAPI.ModBuildConfig/DeployModTask.cs     | 27 ++++-----
 .../Framework/ManifestValidator.cs            | 57 ++++++++++---------
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 16 +++---
 3 files changed, 51 insertions(+), 49 deletions(-)

diff --git a/src/SMAPI.ModBuildConfig/DeployModTask.cs b/src/SMAPI.ModBuildConfig/DeployModTask.cs
index 1581b282..3508a6db 100644
--- a/src/SMAPI.ModBuildConfig/DeployModTask.cs
+++ b/src/SMAPI.ModBuildConfig/DeployModTask.cs
@@ -85,33 +85,30 @@ namespace StardewModdingAPI.ModBuildConfig
                 return true;
 
             // validate the manifest file
-            Manifest manifest;
+            IManifest manifest;
             {
-                // check if manifest file exists
-                FileInfo manifestFile = new(Path.Combine(this.ProjectDir, "manifest.json"));
-                if (!manifestFile.Exists)
-                {
-                    this.Log.LogError("[mod build package] The mod does not have a manifest.json file.");
-                    return false;
-                }
-
-                // check if the json is valid
                 try
                 {
-                    new JsonHelper().ReadJsonFileIfExists(manifestFile.FullName, out manifest);
+                    string manifestPath = Path.Combine(this.ProjectDir, "manifest.json");
+                    if (!new JsonHelper().ReadJsonFileIfExists(manifestPath, out Manifest rawManifest))
+                    {
+                        this.Log.LogError("[mod build package] The mod's manifest.json file doesn't exist.");
+                        return false;
+                    }
+                    manifest = rawManifest;
                 }
                 catch (JsonReaderException ex)
                 {
                     // log the inner exception, otherwise the message will be generic
                     Exception exToShow = ex.InnerException ?? ex;
-                    this.Log.LogError($"[mod build package] Failed to parse manifest.json: {exToShow.Message}");
+                    this.Log.LogError($"[mod build package] The mod's manifest.json file isn't valid JSON: {exToShow.Message}");
                     return false;
                 }
 
-                // validate the manifest's fields
-                if (!ManifestValidator.TryValidate(manifest, out string error))
+                // validate manifest fields
+                if (!ManifestValidator.TryValidateFields(manifest, out string error))
                 {
-                    this.Log.LogError($"[mod build package] The mod manifest is invalid: {error}");
+                    this.Log.LogError($"[mod build package] The mod's manifest.json file is invalid: {error}");
                     return false;
                 }
             }
diff --git a/src/SMAPI.Toolkit/Framework/ManifestValidator.cs b/src/SMAPI.Toolkit/Framework/ManifestValidator.cs
index 62cfd8e9..461dc325 100644
--- a/src/SMAPI.Toolkit/Framework/ManifestValidator.cs
+++ b/src/SMAPI.Toolkit/Framework/ManifestValidator.cs
@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using StardewModdingAPI.Toolkit.Utilities;
@@ -8,40 +9,47 @@ namespace StardewModdingAPI.Toolkit.Framework
     /// <summary>Validates manifest fields.</summary>
     public static class ManifestValidator
     {
-        /// <summary>Try to validate a manifest's fields. Fails if any invalid field is found.</summary>
+        /// <summary>Validate a manifest's fields.</summary>
         /// <param name="manifest">The manifest to validate.</param>
-        /// <param name="error">The error message to display to the user.</param>
-        /// <returns>Returns whether the manifest was validated successfully.</returns>
-        public static bool TryValidate(IManifest manifest, out string error)
+        /// <param name="error">The error message indicating why validation failed, if applicable.</param>
+        /// <returns>Returns whether all manifest fields validated successfully.</returns>
+        [SuppressMessage("ReSharper", "ConditionIsAlwaysTrueOrFalseAccordingToNullableAPIContract", Justification = "This is the method that ensures those annotations are respected.")]
+        public static bool TryValidateFields(IManifest manifest, out string error)
         {
-            // validate DLL / content pack fields
+            //
+            // Note: SMAPI assumes that it can grammatically append the returned sentence in the
+            // form "failed loading <mod> because its <error>". Any errors returned should be valid
+            // in that format, unless the SMAPI call is adjusted accordingly.
+            //
+
             bool hasDll = !string.IsNullOrWhiteSpace(manifest.EntryDll);
             bool isContentPack = manifest.ContentPackFor != null;
 
-            // validate field presence
-            if (!hasDll && !isContentPack)
+            // validate use of EntryDll vs ContentPackFor fields
+            if (hasDll == isContentPack)
             {
-                error = $"manifest has no {nameof(IManifest.EntryDll)} or {nameof(IManifest.ContentPackFor)} field; must specify one.";
-                return false;
-            }
-            if (hasDll && isContentPack)
-            {
-                error = $"manifest sets both {nameof(IManifest.EntryDll)} and {nameof(IManifest.ContentPackFor)}, which are mutually exclusive.";
+                error = hasDll
+                    ? $"manifest sets both {nameof(IManifest.EntryDll)} and {nameof(IManifest.ContentPackFor)}, which are mutually exclusive."
+                    : $"manifest has no {nameof(IManifest.EntryDll)} or {nameof(IManifest.ContentPackFor)} field; must specify one.";
                 return false;
             }
 
-            // validate DLL filename format
-            if (hasDll && manifest.EntryDll!.Intersect(Path.GetInvalidFileNameChars()).Any())
+            // validate EntryDll/ContentPackFor format
+            if (hasDll)
             {
-                error = $"manifest has invalid filename '{manifest.EntryDll}' for the EntryDLL field.";
-                return false;
+                if (manifest.EntryDll!.Intersect(Path.GetInvalidFileNameChars()).Any())
+                {
+                    error = $"manifest has invalid filename '{manifest.EntryDll}' for the {nameof(IManifest.EntryDll)} field.";
+                    return false;
+                }
             }
-
-            // validate content pack ID
-            else if (isContentPack && string.IsNullOrWhiteSpace(manifest.ContentPackFor!.UniqueID))
+            else
             {
-                error = $"manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.";
-                return false;
+                if (string.IsNullOrWhiteSpace(manifest.ContentPackFor!.UniqueID))
+                {
+                    error = $"manifest declares {nameof(IManifest.ContentPackFor)} without its required {nameof(IManifestContentPackFor.UniqueID)} field.";
+                    return false;
+                }
             }
 
             // validate required fields
@@ -69,24 +77,21 @@ namespace StardewModdingAPI.Toolkit.Framework
                 return false;
             }
 
-            // validate dependencies
+            // validate dependency format
             foreach (IManifestDependency? dependency in manifest.Dependencies)
             {
-                // null dependency
                 if (dependency == null)
                 {
                     error = $"manifest has a null entry under {nameof(IManifest.Dependencies)}.";
                     return false;
                 }
 
-                // missing ID
                 if (string.IsNullOrWhiteSpace(dependency.UniqueID))
                 {
                     error = $"manifest has a {nameof(IManifest.Dependencies)} entry with no {nameof(IManifestDependency.UniqueID)} field.";
                     return false;
                 }
 
-                // invalid ID
                 if (!PathUtilities.IsSlug(dependency.UniqueID))
                 {
                     error = $"manifest has a {nameof(IManifest.Dependencies)} entry with an invalid {nameof(IManifestDependency.UniqueID)} field (IDs must only contain letters, numbers, underscores, periods, or hyphens).";
diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 0b4fe3e9..9db9db99 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -126,7 +126,14 @@ namespace StardewModdingAPI.Framework.ModLoading
                     continue;
                 }
 
-                // check for dll if it's supposed to have one
+                // validate manifest format
+                if (!ManifestValidator.TryValidateFields(mod.Manifest, out string manifestError))
+                {
+                    mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its {manifestError}");
+                    continue;
+                }
+
+                // check that DLL exists if applicable
                 if (!string.IsNullOrEmpty(mod.Manifest.EntryDll) && validateFilesExist)
                 {
                     IFileLookup pathLookup = getFileLookup(mod.DirectoryPath);
@@ -137,13 +144,6 @@ namespace StardewModdingAPI.Framework.ModLoading
                         continue;
                     }
                 }
-
-                // validate manifest
-                if (!ManifestValidator.TryValidate(mod.Manifest, out string manifestError))
-                {
-                    mod.SetStatus(ModMetadataStatus.Failed, ModFailReason.InvalidManifest, $"its {manifestError}");
-                    continue;
-                }
             }
 
             // validate IDs are unique

From 0629f19698c9920e2988d96f316d227f97932df8 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 01:22:45 -0500
Subject: [PATCH 827/856] change new fields to hash sets & simplify sorting

This makes the mod IDs case-insensitive (like the 'SuppressUpdateChecks' field), fixes a build error in unit tests, and avoids re-scanning the mod list multiple times.
---
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 50 +++++++++----------
 src/SMAPI/Framework/Models/SConfig.cs         | 16 +++---
 src/SMAPI/Framework/SCore.cs                  | 28 +++++++----
 3 files changed, 51 insertions(+), 43 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 8ef5e4a8..1080a888 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -242,12 +242,32 @@ namespace StardewModdingAPI.Framework.ModLoading
             }
         }
 
+        /// <summary>Apply preliminary overrides to the load order based on the SMAPI configuration.</summary>
+        /// <param name="mods">The mods to process.</param>
+        /// <param name="modIdsToLoadEarly">The mod IDs SMAPI should load before any other mods (except those needed to load them).</param>
+        /// <param name="modIdsToLoadLate">The mod IDs SMAPI should load after any other mods.</param>
+        public IModMetadata[] ApplyLoadOrderOverrides(IModMetadata[] mods, HashSet<string> modIdsToLoadEarly, HashSet<string> modIdsToLoadLate)
+        {
+            if (!modIdsToLoadEarly.Any() && !modIdsToLoadLate.Any())
+                return mods;
+
+            return mods
+                .OrderBy(mod =>
+                {
+                    string id = mod.Manifest.UniqueID;
+                    if (modIdsToLoadEarly.Contains(id))
+                        return -1;
+                    if (modIdsToLoadLate.Contains(id))
+                        return 1;
+                    return 0;
+                })
+                .ToArray();
+        }
+
         /// <summary>Sort the given mods by the order they should be loaded.</summary>
         /// <param name="mods">The mods to process.</param>
         /// <param name="modDatabase">Handles access to SMAPI's internal mod metadata list.</param>
-        /// <param name="modIdsToLoadEarly">The mod IDs SMAPI should try to load early, before any other mods not included in this list.</param>
-        /// <param name="modIdsToLoadLate">The mod IDs SMAPI should try to load late, after all other mods not included in this list.</param>
-        public IEnumerable<IModMetadata> ProcessDependencies(IEnumerable<IModMetadata> mods, IReadOnlyList<string> modIdsToLoadEarly, IReadOnlyList<string> modIdsToLoadLate, ModDatabase modDatabase)
+        public IEnumerable<IModMetadata> ProcessDependencies(IReadOnlyList<IModMetadata> mods, ModDatabase modDatabase)
         {
             // initialize metadata
             mods = mods.ToArray();
@@ -262,28 +282,8 @@ namespace StardewModdingAPI.Framework.ModLoading
             }
 
             // sort mods
-            IModMetadata[] allMods = mods.ToArray();
-            IModMetadata[] modsToLoadEarly = modIdsToLoadEarly
-                .Where(modId => !modIdsToLoadLate.Contains(modId))
-                .Select(modId => allMods.FirstOrDefault(m => m.Manifest.UniqueID == modId))
-                .Where(m => m != null)
-                .Select(m => m!)
-                .ToArray();
-            IModMetadata[] modsToLoadLate = modIdsToLoadLate
-                .Where(modId => !modIdsToLoadEarly.Contains(modId))
-                .Select(modId => allMods.FirstOrDefault(m => m.Manifest.UniqueID == modId))
-                .Where(m => m != null)
-                .Select(m => m!)
-                .ToArray();
-            IModMetadata[] modsToLoadAsUsual = allMods.Where(m => !modsToLoadEarly.Contains(m) && !modsToLoadLate.Contains(m)).ToArray();
-
-            List<IModMetadata> orderSortedMods = new();
-            orderSortedMods.AddRange(modsToLoadEarly);
-            orderSortedMods.AddRange(modsToLoadAsUsual);
-            orderSortedMods.AddRange(modsToLoadLate);
-
-            foreach (IModMetadata mod in orderSortedMods)
-                this.ProcessDependencies(orderSortedMods, modDatabase, mod, states, sortedMods, new List<IModMetadata>());
+            foreach (IModMetadata mod in mods)
+                this.ProcessDependencies(mods, modDatabase, mod, states, sortedMods, new List<IModMetadata>());
 
             return sortedMods.Reverse();
         }
diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index 40d3450f..ee2dc18d 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -82,11 +82,11 @@ namespace StardewModdingAPI.Framework.Models
         /// <summary>The mod IDs SMAPI should ignore when performing update checks or validating update keys.</summary>
         public HashSet<string> SuppressUpdateChecks { get; set; }
 
-        /// <summary>The mod IDs SMAPI should try to load early, before any other mods not included in this list.</summary>
-        public List<string> ModsToLoadEarly { get; set; }
+        /// <summary>The mod IDs SMAPI should load before any other mods (except those needed to load them).</summary>
+        public HashSet<string> ModsToLoadEarly { get; set; }
 
-        /// <summary>The mod IDs SMAPI should try to load late, after all other mods not included in this list.</summary>
-        public List<string> ModsToLoadLate { get; set; }
+        /// <summary>The mod IDs SMAPI should load after any other mods.</summary>
+        public HashSet<string> ModsToLoadLate { get; set; }
 
 
         /********
@@ -106,8 +106,8 @@ namespace StardewModdingAPI.Framework.Models
         /// <param name="consoleColors">The colors to use for text written to the SMAPI console.</param>
         /// <param name="suppressHarmonyDebugMode">Whether to prevent mods from enabling Harmony's debug mode, which impacts performance and creates a file on your desktop. Debug mode should never be enabled by a released mod.</param>
         /// <param name="suppressUpdateChecks">The mod IDs SMAPI should ignore when performing update checks or validating update keys.</param>
-        /// <param name="modsToLoadEarly">The mod IDs SMAPI should try to load early, before any other mods not included in this list.</param>
-        /// <param name="modsToLoadLate">The mod IDs SMAPI should try to load late, after all other mods not included in this list.</param>
+        /// <param name="modsToLoadEarly">The mod IDs SMAPI should load before any other mods (except those needed to load them).</param>
+        /// <param name="modsToLoadLate">The mod IDs SMAPI should load after any other mods.</param>
         public SConfig(bool developerMode, bool? checkForUpdates, bool? paranoidWarnings, bool? useBetaChannel, string gitHubProjectName, string webApiBaseUrl, string[]? verboseLogging, bool? rewriteMods, bool? useCaseInsensitivePaths, bool? logNetworkTraffic, ColorSchemeConfig consoleColors, bool? suppressHarmonyDebugMode, string[]? suppressUpdateChecks, string[]? modsToLoadEarly, string[]? modsToLoadLate)
         {
             this.DeveloperMode = developerMode;
@@ -123,8 +123,8 @@ namespace StardewModdingAPI.Framework.Models
             this.ConsoleColors = consoleColors;
             this.SuppressHarmonyDebugMode = suppressHarmonyDebugMode ?? (bool)SConfig.DefaultValues[nameof(this.SuppressHarmonyDebugMode)];
             this.SuppressUpdateChecks = new HashSet<string>(suppressUpdateChecks ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
-            this.ModsToLoadEarly = new List<string>(modsToLoadEarly ?? Array.Empty<string>());
-            this.ModsToLoadLate = new List<string>(modsToLoadLate ?? Array.Empty<string>());
+            this.ModsToLoadEarly = new HashSet<string>(modsToLoadEarly ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
+            this.ModsToLoadLate = new HashSet<string>(modsToLoadLate ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
         }
 
         /// <summary>Override the value of <see cref="DeveloperMode"/>.</summary>
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 4d1eb959..fb835002 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -424,19 +424,27 @@ namespace StardewModdingAPI.Framework
                 mods = mods.Where(p => !p.IsIgnored).ToArray();
 
                 // warn about mods that should load early or late which are not found at all, or both
-                foreach (string modId in this.Settings.ModsToLoadEarly)
-                    if (!mods.Any(m => m.Manifest.UniqueID == modId))
-                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load early, but it could not be found or was skipped.", LogLevel.Warn);
-                foreach (string modId in this.Settings.ModsToLoadLate)
-                    if (!mods.Any(m => m.Manifest.UniqueID == modId))
-                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load late, but it could not be found or was skipped.", LogLevel.Warn);
-                foreach (string modId in this.Settings.ModsToLoadEarly)
-                    if (this.Settings.ModsToLoadLate.Contains(modId))
-                        this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load both early and late - this will be ignored.", LogLevel.Warn);
+                {
+                    HashSet<string> installedIds = new HashSet<string>(mods.Select(p => p.Manifest.UniqueID), StringComparer.OrdinalIgnoreCase);
+
+                    foreach (string modId in this.Settings.ModsToLoadEarly)
+                    {
+                        if (!installedIds.Contains(modId))
+                            this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load early, but it could not be found or was skipped.", LogLevel.Warn);
+                    }
+                    foreach (string modId in this.Settings.ModsToLoadLate)
+                    {
+                        if (this.Settings.ModsToLoadEarly.Contains(modId))
+                            this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load both early and late - this will be ignored.", LogLevel.Warn);
+                        else if (!installedIds.Contains(modId))
+                            this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load late, but it could not be found or was skipped.", LogLevel.Warn);
+                    }
+                }
 
                 // load mods
                 resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl, getFileLookup: this.GetFileLookup);
-                mods = resolver.ProcessDependencies(mods, this.Settings.ModsToLoadEarly, this.Settings.ModsToLoadLate, modDatabase).ToArray();
+                mods = resolver.ApplyLoadOrderOverrides(mods, this.Settings.ModsToLoadEarly, this.Settings.ModsToLoadLate);
+                mods = resolver.ProcessDependencies(mods, modDatabase).ToArray();
                 this.LoadMods(mods, this.Toolkit.JsonHelper, this.ContentCore, modDatabase);
 
                 // check for software likely to cause issues

From 3059794622e4442bf289dde7b4f533d8021d3bf7 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 01:22:46 -0500
Subject: [PATCH 828/856] adjust warning messages & log header when load order
 is edited

---
 src/SMAPI/Framework/Models/SConfig.cs |  6 ++++++
 src/SMAPI/Framework/SCore.cs          | 22 ++++++++++------------
 src/SMAPI/SMAPI.config.json           | 12 +++++++-----
 3 files changed, 23 insertions(+), 17 deletions(-)

diff --git a/src/SMAPI/Framework/Models/SConfig.cs b/src/SMAPI/Framework/Models/SConfig.cs
index ee2dc18d..158831a9 100644
--- a/src/SMAPI/Framework/Models/SConfig.cs
+++ b/src/SMAPI/Framework/Models/SConfig.cs
@@ -146,6 +146,12 @@ namespace StardewModdingAPI.Framework.Models
                     custom[name] = value;
             }
 
+            if (this.ModsToLoadEarly.Any())
+                custom[nameof(this.ModsToLoadEarly)] = $"[{string.Join(", ", this.ModsToLoadEarly)}]";
+
+            if (this.ModsToLoadLate.Any())
+                custom[nameof(this.ModsToLoadLate)] = $"[{string.Join(", ", this.ModsToLoadLate)}]";
+
             if (!this.SuppressUpdateChecks.SetEquals(SConfig.DefaultSuppressUpdateChecks))
                 custom[nameof(this.SuppressUpdateChecks)] = $"[{string.Join(", ", this.SuppressUpdateChecks)}]";
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index fb835002..7f564a28 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -427,18 +427,16 @@ namespace StardewModdingAPI.Framework
                 {
                     HashSet<string> installedIds = new HashSet<string>(mods.Select(p => p.Manifest.UniqueID), StringComparer.OrdinalIgnoreCase);
 
-                    foreach (string modId in this.Settings.ModsToLoadEarly)
-                    {
-                        if (!installedIds.Contains(modId))
-                            this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load early, but it could not be found or was skipped.", LogLevel.Warn);
-                    }
-                    foreach (string modId in this.Settings.ModsToLoadLate)
-                    {
-                        if (this.Settings.ModsToLoadEarly.Contains(modId))
-                            this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load both early and late - this will be ignored.", LogLevel.Warn);
-                        else if (!installedIds.Contains(modId))
-                            this.Monitor.Log($"  SMAPI configuration specifies a mod {modId} that should load late, but it could not be found or was skipped.", LogLevel.Warn);
-                    }
+                    string[] missingEarlyMods = this.Settings.ModsToLoadEarly.Where(id => !installedIds.Contains(id)).OrderBy(p => p, StringComparer.OrdinalIgnoreCase).ToArray();
+                    string[] missingLateMods = this.Settings.ModsToLoadLate.Where(id => !installedIds.Contains(id)).OrderBy(p => p, StringComparer.OrdinalIgnoreCase).ToArray();
+                    string[] duplicateMods = this.Settings.ModsToLoadLate.Where(id => this.Settings.ModsToLoadEarly.Contains(id)).OrderBy(p => p, StringComparer.OrdinalIgnoreCase).ToArray();
+
+                    if (missingEarlyMods.Any())
+                        this.Monitor.Log($"  The 'smapi-internal/config.json' file lists mod IDs in {nameof(this.Settings.ModsToLoadEarly)} which aren't installed: '{string.Join("', '", missingEarlyMods)}'.", LogLevel.Warn);
+                    if (missingLateMods.Any())
+                        this.Monitor.Log($"  The 'smapi-internal/config.json' file lists mod IDs in {nameof(this.Settings.ModsToLoadLate)} which aren't installed: '{string.Join("', '", missingLateMods)}'.", LogLevel.Warn);
+                    if (duplicateMods.Any())
+                        this.Monitor.Log($"  The 'smapi-internal/config.json' file lists mod IDs which are in both {nameof(this.Settings.ModsToLoadEarly)} and {nameof(this.Settings.ModsToLoadLate)}: '{string.Join("', '", duplicateMods)}'. These will be loaded early.", LogLevel.Warn);
                 }
 
                 // load mods
diff --git a/src/SMAPI/SMAPI.config.json b/src/SMAPI/SMAPI.config.json
index 68645d24..0ab68a7d 100644
--- a/src/SMAPI/SMAPI.config.json
+++ b/src/SMAPI/SMAPI.config.json
@@ -144,12 +144,14 @@ copy all the settings, or you may cause bugs due to overridden changes in future
     ],
 
     /**
-     * The mod IDs SMAPI should try to load early, before any other mods not included in this list.
+     * The mod IDs SMAPI should load before any other mods (except those needed to load them)
+     * or after any other mods.
+     *
+     * This lets you manually fix the load order if needed, but this is a last resort — SMAPI
+     * automatically adjusts the load order based on mods' dependencies, so needing to manually
+     * edit the order is usually a problem with one or both mods' metadata that can be reported to
+     * the mod author.
      */
     "ModsToLoadEarly": [],
-
-    /**
-     * The mod IDs SMAPI should try to load late, after all other mods not included in this list.
-     */
     "ModsToLoadLate": []
 }

From dbf7750f3e27cf7c50e2f06005fd14da95627dc3 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 01:22:46 -0500
Subject: [PATCH 829/856] only validate & apply custom load order if there is
 one

---
 src/SMAPI/Framework/SCore.cs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 7f564a28..be5bc40f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -423,7 +423,11 @@ namespace StardewModdingAPI.Framework
                     this.Monitor.Log($"  Skipped {mod.GetRelativePathWithRoot()} (folder name starts with a dot).");
                 mods = mods.Where(p => !p.IsIgnored).ToArray();
 
-                // warn about mods that should load early or late which are not found at all, or both
+                // validate manifests
+                resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl, getFileLookup: this.GetFileLookup);
+
+                // apply load order customizations
+                if (this.Settings.ModsToLoadEarly.Any() || this.Settings.ModsToLoadLate.Any())
                 {
                     HashSet<string> installedIds = new HashSet<string>(mods.Select(p => p.Manifest.UniqueID), StringComparer.OrdinalIgnoreCase);
 
@@ -437,11 +441,11 @@ namespace StardewModdingAPI.Framework
                         this.Monitor.Log($"  The 'smapi-internal/config.json' file lists mod IDs in {nameof(this.Settings.ModsToLoadLate)} which aren't installed: '{string.Join("', '", missingLateMods)}'.", LogLevel.Warn);
                     if (duplicateMods.Any())
                         this.Monitor.Log($"  The 'smapi-internal/config.json' file lists mod IDs which are in both {nameof(this.Settings.ModsToLoadEarly)} and {nameof(this.Settings.ModsToLoadLate)}: '{string.Join("', '", duplicateMods)}'. These will be loaded early.", LogLevel.Warn);
+
+                    mods = resolver.ApplyLoadOrderOverrides(mods, this.Settings.ModsToLoadEarly, this.Settings.ModsToLoadLate);
                 }
 
                 // load mods
-                resolver.ValidateManifests(mods, Constants.ApiVersion, toolkit.GetUpdateUrl, getFileLookup: this.GetFileLookup);
-                mods = resolver.ApplyLoadOrderOverrides(mods, this.Settings.ModsToLoadEarly, this.Settings.ModsToLoadLate);
                 mods = resolver.ProcessDependencies(mods, modDatabase).ToArray();
                 this.LoadMods(mods, this.Toolkit.JsonHelper, this.ContentCore, modDatabase);
 

From e44562c9c5fccaa2056347f7a288b67d933cfdfa Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 01:35:42 -0500
Subject: [PATCH 830/856] update release notes

---
 docs/release-notes.md         | 6 +++++-
 docs/technical/mod-package.md | 3 +++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 0843f59a..c247a9d5 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,7 +9,11 @@
 
 ## Upcoming release
 * For players:
-  * Added config option to disable console input. This may reduce CPU usage on some Linux systems.
+  * Added config options to override the mod load order, for the rare cases where that's needed (thanks to Shockah!).
+  * Added config option to disable console input, which may reduce CPU usage on some Linux systems.
+
+* For mod authors:
+  * Optimized asset name comparisons (thanks to atravita!).
 
 * For the web UI:
   * Fixed log parser not showing screen IDs in split-screen mode, and improved screen display.
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 77260a57..707b1641 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -412,6 +412,9 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
+## Upcoming release
+* Added `manifest.json` format validation on build (thanks to tylergibbs2!).
+
 ### 4.0.2
 Released 09 October 2022.
 

From cefd9e23b06599aca3fefba7a78c6c785f4e5d57 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 01:38:45 -0500
Subject: [PATCH 831/856] set max game version

---
 docs/release-notes.md  | 1 +
 src/SMAPI/Constants.cs | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index c247a9d5..014e8814 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,7 @@
 * For players:
   * Added config options to override the mod load order, for the rare cases where that's needed (thanks to Shockah!).
   * Added config option to disable console input, which may reduce CPU usage on some Linux systems.
+  * Set the max game version to 1.5.6 (since 1.6 will need a SMAPI update).
 
 * For mod authors:
   * Optimized asset name comparisons (thanks to atravita!).
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 77900ca6..222e5276 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -71,7 +71,7 @@ namespace StardewModdingAPI
         public static ISemanticVersion MinimumGameVersion { get; } = new GameVersion("1.5.6");
 
         /// <summary>The maximum supported version of Stardew Valley, if any.</summary>
-        public static ISemanticVersion? MaximumGameVersion { get; } = null;
+        public static ISemanticVersion? MaximumGameVersion { get; } = new GameVersion("1.5.6");
 
         /// <summary>The target game platform.</summary>
         public static GamePlatform TargetPlatform { get; } = EarlyConstants.Platform;

From 28ba3408bc84dd9d33f0aed126080be4dceb17f6 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 01:47:12 -0500
Subject: [PATCH 832/856] raise all deprecation messages to the final level

---
 docs/release-notes.md                                  | 1 +
 src/SMAPI/Constants.cs                                 | 2 +-
 src/SMAPI/Framework/Content/AssetInfo.cs               | 4 ++--
 src/SMAPI/Framework/Deprecations/DeprecationManager.cs | 2 +-
 src/SMAPI/Framework/ModHelpers/CommandHelper.cs        | 2 +-
 src/SMAPI/Framework/ModHelpers/ContentHelper.cs        | 4 ++--
 src/SMAPI/Framework/ModHelpers/ModHelper.cs            | 2 +-
 src/SMAPI/Framework/SCore.cs                           | 6 +++---
 src/SMAPI/Utilities/PerScreen.cs                       | 2 +-
 9 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 014e8814..972360bc 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -15,6 +15,7 @@
 
 * For mod authors:
   * Optimized asset name comparisons (thanks to atravita!).
+  * Raised all deprecation messages to the final 'pending removal' level.
 
 * For the web UI:
   * Fixed log parser not showing screen IDs in split-screen mode, and improved screen display.
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 222e5276..4cb30dc9 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -90,7 +90,7 @@ namespace StardewModdingAPI
                     source: null,
                     nounPhrase: $"{nameof(Constants)}.{nameof(Constants.ExecutionPath)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Info
+                    severity: DeprecationLevel.PendingRemoval
                 );
 
                 return Constants.GamePath;
diff --git a/src/SMAPI/Framework/Content/AssetInfo.cs b/src/SMAPI/Framework/Content/AssetInfo.cs
index af000300..52ef02e6 100644
--- a/src/SMAPI/Framework/Content/AssetInfo.cs
+++ b/src/SMAPI/Framework/Content/AssetInfo.cs
@@ -45,7 +45,7 @@ namespace StardewModdingAPI.Framework.Content
                     source: null,
                     nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetName)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Info,
+                    severity: DeprecationLevel.PendingRemoval,
                     unlessStackIncludes: new[]
                     {
                         $"{typeof(AssetInterceptorChange).FullName}.{nameof(AssetInterceptorChange.CanIntercept)}",
@@ -84,7 +84,7 @@ namespace StardewModdingAPI.Framework.Content
                 source: null,
                 nounPhrase: $"{nameof(IAssetInfo)}.{nameof(IAssetInfo.AssetNameEquals)}",
                 version: "3.14.0",
-                severity: DeprecationLevel.Info,
+                severity: DeprecationLevel.PendingRemoval,
                 unlessStackIncludes: new[]
                 {
                     $"{typeof(AssetInterceptorChange).FullName}.{nameof(AssetInterceptorChange.CanIntercept)}",
diff --git a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
index 5a5850d1..f44b5d7d 100644
--- a/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
+++ b/src/SMAPI/Framework/Deprecations/DeprecationManager.cs
@@ -101,7 +101,7 @@ namespace StardewModdingAPI.Framework.Deprecations
             foreach (DeprecationWarning warning in this.QueuedWarnings.OrderBy(p => p.ModName).ThenBy(p => p.NounPhrase))
             {
                 // build message
-                string message = $"{warning.ModName} uses deprecated code ({warning.NounPhrase}) and will break in the upcoming SMAPI 4.0.0.";
+                string message = $"{warning.ModName} uses deprecated code ({warning.NounPhrase}) and will break in the next major SMAPI update.";
 
                 // get log level
                 LogLevel level;
diff --git a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
index b7d4861f..90edc137 100644
--- a/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/CommandHelper.cs
@@ -43,7 +43,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                 source: this.Mod,
                 nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.ConsoleCommands)}.{nameof(ICommandHelper.Trigger)}",
                 version: "3.8.1",
-                severity: DeprecationLevel.Info
+                severity: DeprecationLevel.PendingRemoval
             );
 
             return this.CommandManager.Trigger(name, arguments);
diff --git a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
index 0a1633bf..152b264c 100644
--- a/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ContentHelper.cs
@@ -62,7 +62,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                     source: this.Mod,
                     nounPhrase: $"{nameof(IContentHelper)}.{nameof(IContentHelper.AssetLoaders)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Info
+                    severity: DeprecationLevel.PendingRemoval
                 );
 
                 return this.ObservableAssetLoaders;
@@ -78,7 +78,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                     source: this.Mod,
                     nounPhrase: $"{nameof(IContentHelper)}.{nameof(IContentHelper.AssetEditors)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Info
+                    severity: DeprecationLevel.PendingRemoval
                 );
 
                 return this.ObservableAssetEditors;
diff --git a/src/SMAPI/Framework/ModHelpers/ModHelper.cs b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
index 1cdd8536..531289d0 100644
--- a/src/SMAPI/Framework/ModHelpers/ModHelper.cs
+++ b/src/SMAPI/Framework/ModHelpers/ModHelper.cs
@@ -41,7 +41,7 @@ namespace StardewModdingAPI.Framework.ModHelpers
                     source: this.Mod,
                     nounPhrase: $"{nameof(IModHelper)}.{nameof(IModHelper.Content)}",
                     version: "3.14.0",
-                    severity: DeprecationLevel.Info
+                    severity: DeprecationLevel.PendingRemoval
                 );
 
                 return this.ContentImpl;
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 8e21e7dc..90621ee8 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1736,7 +1736,7 @@ namespace StardewModdingAPI.Framework
                             source: metadata,
                             nounPhrase: $"{nameof(IAssetEditor)}",
                             version: "3.14.0",
-                            severity: DeprecationLevel.Info,
+                            severity: DeprecationLevel.PendingRemoval,
                             logStackTrace: false
                         );
 
@@ -1749,7 +1749,7 @@ namespace StardewModdingAPI.Framework
                             source: metadata,
                             nounPhrase: $"{nameof(IAssetLoader)}",
                             version: "3.14.0",
-                            severity: DeprecationLevel.Info,
+                            severity: DeprecationLevel.PendingRemoval,
                             logStackTrace: false
                         );
 
@@ -1781,7 +1781,7 @@ namespace StardewModdingAPI.Framework
                             metadata,
                             $"using {name} without bundling it",
                             "3.14.7",
-                            DeprecationLevel.Info,
+                            DeprecationLevel.PendingRemoval,
                             logStackTrace: false
                         );
                     }
diff --git a/src/SMAPI/Utilities/PerScreen.cs b/src/SMAPI/Utilities/PerScreen.cs
index 468df0bd..87bf2027 100644
--- a/src/SMAPI/Utilities/PerScreen.cs
+++ b/src/SMAPI/Utilities/PerScreen.cs
@@ -59,7 +59,7 @@ namespace StardewModdingAPI.Utilities
                     null,
                     $"calling the {nameof(PerScreen<T>)} constructor with null",
                     "3.14.0",
-                    DeprecationLevel.Info
+                    DeprecationLevel.PendingRemoval
                 );
 #else
                 throw new ArgumentNullException(nameof(createNewState));

From 42bcd3068f24a4b3ec14e1ec6132956218643679 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 02:33:28 -0500
Subject: [PATCH 833/856] add unit test for assumption about HashSet<T> order

This will let us detect if the behavior ever changes in a future version of .NET, so we need to change the new ModsToLoadEarly/Late config fields.
---
 src/SMAPI.Tests/Core/AssumptionTests.cs | 62 +++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 src/SMAPI.Tests/Core/AssumptionTests.cs

diff --git a/src/SMAPI.Tests/Core/AssumptionTests.cs b/src/SMAPI.Tests/Core/AssumptionTests.cs
new file mode 100644
index 00000000..efc9da3f
--- /dev/null
+++ b/src/SMAPI.Tests/Core/AssumptionTests.cs
@@ -0,0 +1,62 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using FluentAssertions;
+using FluentAssertions.Execution;
+using NUnit.Framework;
+using StardewModdingAPI.Framework.Models;
+
+namespace SMAPI.Tests.Core
+{
+    /// <summary>Unit tests which validate assumptions about .NET used in the SMAPI implementation.</summary>
+    [TestFixture]
+    internal class AssumptionTests
+    {
+        /*********
+        ** Unit tests
+        *********/
+        /****
+        ** Constructor
+        ****/
+        [Test(Description = $"Assert that {nameof(HashSet<string>)} maintains insertion order when no elements are removed. If this fails, we'll need to change the implementation for the {nameof(SConfig.ModsToLoadEarly)} and {nameof(SConfig.ModsToLoadLate)} options.")]
+        [TestCase("construct from array")]
+        [TestCase("add incrementally")]
+        public void HashSet_MaintainsInsertionOrderWhenNoElementsAreRemoved(string populateMethod)
+        {
+            // arrange
+            string[] inserted = Enumerable.Range(0, 1000)
+                .Select(_ => Guid.NewGuid().ToString("N"))
+                .ToArray();
+
+            // act
+            HashSet<string> set;
+            switch (populateMethod)
+            {
+                case "construct from array":
+                    set = new(inserted, StringComparer.OrdinalIgnoreCase);
+                    break;
+
+                case "add incrementally":
+                    set = new(StringComparer.OrdinalIgnoreCase);
+                    foreach (string value in inserted)
+                        set.Add(value);
+                    break;
+
+                default:
+                    throw new AssertionFailedException($"Unknown populate method '{populateMethod}'.");
+            }
+
+            // assert
+            string[] actualOrder = set.ToArray();
+            actualOrder.Should().HaveCount(inserted.Length);
+            for (int i = 0; i < inserted.Length; i++)
+            {
+                string expected = inserted[i];
+                string actual = actualOrder[i];
+
+                if (actual != expected)
+                    throw new AssertionFailedException($"The hash set differed at index {i}: expected {expected}, but found {actual} instead.");
+            }
+        }
+    }
+}

From be84248a9a0a57ee1b2384e63b25fc9bb694fa4d Mon Sep 17 00:00:00 2001
From: SinZ <github@361zn.is>
Date: Fri, 11 Nov 2022 22:01:48 +1100
Subject: [PATCH 834/856] Add logic to remove from the multiplayer map cache
 for asset propagation

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 1ef9a8f2..d94fe2ae 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1166,6 +1166,13 @@ namespace StardewModdingAPI.Metadata
             GameLocation location = locationInfo.Location;
             Vector2? playerPos = Game1.player?.Position;
 
+            // clear cachedMultiplayerMaps so Asset Propegation works on farmhands and Map edits can be applied after an initial load
+            if (!Game1.IsMasterGame)
+            {
+                var multiplayer = this.Reflection.GetField<Multiplayer>(typeof(Game1), "multiplayer").GetValue();
+                multiplayer.cachedMultiplayerMaps.Remove(locationInfo.Location.NameOrUniqueName);
+            }
+
             // reload map
             location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist
             location.reloadMap();

From 4ca546a7a8d5e0f6c9e0df7370f4e6c858d5b69b Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Fri, 11 Nov 2022 06:38:35 -0500
Subject: [PATCH 835/856] directly add tests over the trailing slash.

---
 src/SMAPI.Tests/Core/AssetNameTests.cs   | 20 ++++++++++++++++++++
 src/SMAPI/Framework/Content/AssetName.cs |  2 +-
 2 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index fdaa2c01..cd4d0473 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -265,6 +265,26 @@ namespace SMAPI.Tests.Core
             return name.StartsWith(otherAssetName, allowPartialWord: true, allowSubfolder: allowSubfolder);
         }
 
+        // the enumerator strips the trailing path seperator
+        // so each of these cases has to be handled on each branch.
+        [TestCase("Mods/SomeMod", "Mods/", false, ExpectedResult = true)]
+        [TestCase("Mods/SomeMod", "Mods", false, ExpectedResult = false)]
+        [TestCase("Mods/Jasper/Data", "Mods/Jas/", false, ExpectedResult = false)]
+        [TestCase("Mods/Jasper/Data", "Mods/Jas", false, ExpectedResult = false)]
+        [TestCase("Mods/Jas", "Mods/Jas/", false, ExpectedResult = false)]
+        [TestCase("Mods/Jas", "Mods/Jas", false, ExpectedResult = true)]
+        public bool StartsWith_PrefixHasSeperator(string mainAssetName, string otherAssetName, bool allowSubfolder)
+        {
+            // arrange
+            mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
+
+            // act
+            AssetName name = AssetName.Parse(mainAssetName, _ => null);
+
+            // assert value
+            return name.StartsWith(otherAssetName, allowPartialWord: true, allowSubfolder: allowSubfolder);
+        }
+
 
         /****
         ** GetHashCode
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 99968299..83593de8 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -163,7 +163,7 @@ namespace StardewModdingAPI.Framework.Content
                         return false;
 
                     // match if subfolder paths are fine (e.g. prefix 'Data/Events' with target 'Data/Events/Beach')
-                    return allowSubfolder;
+                    return allowSubfolder || (pathSeparators.Contains(trimmedPrefix[^1]) && curParts.Remainder.Length == 0);
                 }
 
                 // previous segments matched exactly and both reached the end

From 2bccdd97370b958187b0ad99437e4ca85ec5ae1f Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Fri, 11 Nov 2022 06:52:46 -0500
Subject: [PATCH 836/856] edit comment.

---
 src/SMAPI/Framework/Content/AssetName.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index 83593de8..a1c6a5da 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -163,6 +163,8 @@ namespace StardewModdingAPI.Framework.Content
                         return false;
 
                     // match if subfolder paths are fine (e.g. prefix 'Data/Events' with target 'Data/Events/Beach')
+                    // special case if the original prefix ended with a '/' - subfolder checking pushes forward one, to check the Remainder instead of Current
+                    // which is necessarily nonzero in this block.
                     return allowSubfolder || (pathSeparators.Contains(trimmedPrefix[^1]) && curParts.Remainder.Length == 0);
                 }
 

From 286c2d244949f4eee62e2de440938d2d8ae3ce76 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 20:55:24 -0500
Subject: [PATCH 837/856] pass multiplayer into asset propagator to avoid
 reflection

---
 src/SMAPI/Framework/ContentCoordinator.cs |  5 +++--
 src/SMAPI/Framework/SCore.cs              |  1 +
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 16 +++++++++-------
 3 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/src/SMAPI/Framework/ContentCoordinator.cs b/src/SMAPI/Framework/ContentCoordinator.cs
index cf26307f..86415a5f 100644
--- a/src/SMAPI/Framework/ContentCoordinator.cs
+++ b/src/SMAPI/Framework/ContentCoordinator.cs
@@ -129,6 +129,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="rootDirectory">The root directory to search for content.</param>
         /// <param name="currentCulture">The current culture for which to localize content.</param>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
+        /// <param name="multiplayer">The multiplayer instance whose map cache to update during asset propagation.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="jsonHelper">Encapsulates SMAPI's JSON file parsing.</param>
         /// <param name="onLoadingFirstAsset">A callback to invoke the first time *any* game content manager loads an asset.</param>
@@ -136,7 +137,7 @@ namespace StardewModdingAPI.Framework
         /// <param name="getFileLookup">Get a file lookup for the given directory.</param>
         /// <param name="onAssetsInvalidated">A callback to invoke when any asset names have been invalidated from the cache.</param>
         /// <param name="requestAssetOperations">Get the load/edit operations to apply to an asset by querying registered <see cref="IContentEvents.AssetRequested"/> event handlers.</param>
-        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations)
+        public ContentCoordinator(IServiceProvider serviceProvider, string rootDirectory, CultureInfo currentCulture, IMonitor monitor, Multiplayer multiplayer, Reflector reflection, JsonHelper jsonHelper, Action onLoadingFirstAsset, Action<BaseContentManager, IAssetName> onAssetLoaded, Func<string, IFileLookup> getFileLookup, Action<IList<IAssetName>> onAssetsInvalidated, Func<IAssetInfo, AssetOperationGroup?> requestAssetOperations)
         {
             this.GetFileLookup = getFileLookup;
             this.Monitor = monitor ?? throw new ArgumentNullException(nameof(monitor));
@@ -177,7 +178,7 @@ namespace StardewModdingAPI.Framework
             this.ContentManagers.Add(contentManagerForAssetPropagation);
 
             this.VanillaContentManager = new LocalizedContentManager(serviceProvider, rootDirectory);
-            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, reflection, name => this.ParseAssetName(name, allowLocales: true));
+            this.CoreAssets = new CoreAssetPropagator(this.MainContentManager, contentManagerForAssetPropagation, this.Monitor, multiplayer, reflection, name => this.ParseAssetName(name, allowLocales: true));
             this.LocaleCodes = new Lazy<Dictionary<string, LocalizedContentManager.LanguageCode>>(() => this.GetLocaleCodes(customLanguages: Enumerable.Empty<ModLanguage>()));
         }
 
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index 40979b09..cf1e73fc 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -1327,6 +1327,7 @@ namespace StardewModdingAPI.Framework
                     rootDirectory: rootDirectory,
                     currentCulture: Thread.CurrentThread.CurrentUICulture,
                     monitor: this.Monitor,
+                    multiplayer: this.Multiplayer,
                     reflection: this.Reflection,
                     jsonHelper: this.Toolkit.JsonHelper,
                     onLoadingFirstAsset: this.InitializeBeforeFirstAssetLoaded,
diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index d94fe2ae..037e4573 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -40,6 +40,9 @@ namespace StardewModdingAPI.Metadata
         /// <summary>Writes messages to the console.</summary>
         private readonly IMonitor Monitor;
 
+        /// <summary>The multiplayer instance whose map cache to update.</summary>
+        private readonly Multiplayer Multiplayer;
+
         /// <summary>Simplifies access to private game code.</summary>
         private readonly Reflector Reflection;
 
@@ -70,13 +73,15 @@ namespace StardewModdingAPI.Metadata
         /// <param name="mainContent">The main content manager through which to reload assets.</param>
         /// <param name="disposableContent">An internal content manager used only for asset propagation.</param>
         /// <param name="monitor">Writes messages to the console.</param>
+        /// <param name="multiplayer">The multiplayer instance whose map cache to update.</param>
         /// <param name="reflection">Simplifies access to private code.</param>
         /// <param name="parseAssetName">Parse a raw asset name.</param>
-        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, IMonitor monitor, Reflector reflection, Func<string, IAssetName> parseAssetName)
+        public CoreAssetPropagator(LocalizedContentManager mainContent, GameContentManagerForAssetPropagation disposableContent, IMonitor monitor, Multiplayer multiplayer, Reflector reflection, Func<string, IAssetName> parseAssetName)
         {
             this.MainContentManager = mainContent;
             this.DisposableContentManager = disposableContent;
             this.Monitor = monitor;
+            this.Multiplayer = multiplayer;
             this.Reflection = reflection;
             this.ParseAssetName = parseAssetName;
         }
@@ -1166,12 +1171,9 @@ namespace StardewModdingAPI.Metadata
             GameLocation location = locationInfo.Location;
             Vector2? playerPos = Game1.player?.Position;
 
-            // clear cachedMultiplayerMaps so Asset Propegation works on farmhands and Map edits can be applied after an initial load
-            if (!Game1.IsMasterGame)
-            {
-                var multiplayer = this.Reflection.GetField<Multiplayer>(typeof(Game1), "multiplayer").GetValue();
-                multiplayer.cachedMultiplayerMaps.Remove(locationInfo.Location.NameOrUniqueName);
-            }
+            // clear multiplayer cache for farmhands
+            if (!Context.IsMainPlayer)
+                this.Multiplayer.cachedMultiplayerMaps.Remove(location.NameOrUniqueName);
 
             // reload map
             location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist

From ad2dcc28791eb8026335646474fb2e0766fcc51b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 21:22:52 -0500
Subject: [PATCH 838/856] expand code comments for clarity

---
 src/SMAPI.Tests/Core/AssetNameTests.cs   |  5 ++---
 src/SMAPI/Framework/Content/AssetName.cs | 12 ++++++++----
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/src/SMAPI.Tests/Core/AssetNameTests.cs b/src/SMAPI.Tests/Core/AssetNameTests.cs
index cd4d0473..2d546ec7 100644
--- a/src/SMAPI.Tests/Core/AssetNameTests.cs
+++ b/src/SMAPI.Tests/Core/AssetNameTests.cs
@@ -265,15 +265,14 @@ namespace SMAPI.Tests.Core
             return name.StartsWith(otherAssetName, allowPartialWord: true, allowSubfolder: allowSubfolder);
         }
 
-        // the enumerator strips the trailing path seperator
-        // so each of these cases has to be handled on each branch.
+        // The enumerator strips the trailing path separator, so each of these cases has to be handled on each branch.
         [TestCase("Mods/SomeMod", "Mods/", false, ExpectedResult = true)]
         [TestCase("Mods/SomeMod", "Mods", false, ExpectedResult = false)]
         [TestCase("Mods/Jasper/Data", "Mods/Jas/", false, ExpectedResult = false)]
         [TestCase("Mods/Jasper/Data", "Mods/Jas", false, ExpectedResult = false)]
         [TestCase("Mods/Jas", "Mods/Jas/", false, ExpectedResult = false)]
         [TestCase("Mods/Jas", "Mods/Jas", false, ExpectedResult = true)]
-        public bool StartsWith_PrefixHasSeperator(string mainAssetName, string otherAssetName, bool allowSubfolder)
+        public bool StartsWith_PrefixHasSeparator(string mainAssetName, string otherAssetName, bool allowSubfolder)
         {
             // arrange
             mainAssetName = PathUtilities.NormalizeAssetName(mainAssetName);
diff --git a/src/SMAPI/Framework/Content/AssetName.cs b/src/SMAPI/Framework/Content/AssetName.cs
index a1c6a5da..8355f9ec 100644
--- a/src/SMAPI/Framework/Content/AssetName.cs
+++ b/src/SMAPI/Framework/Content/AssetName.cs
@@ -162,10 +162,14 @@ namespace StardewModdingAPI.Framework.Content
                     if (prefixHasMore)
                         return false;
 
-                    // match if subfolder paths are fine (e.g. prefix 'Data/Events' with target 'Data/Events/Beach')
-                    // special case if the original prefix ended with a '/' - subfolder checking pushes forward one, to check the Remainder instead of Current
-                    // which is necessarily nonzero in this block.
-                    return allowSubfolder || (pathSeparators.Contains(trimmedPrefix[^1]) && curParts.Remainder.Length == 0);
+                    // match: every segment in the prefix matched and subfolders are allowed (e.g. prefix 'Data/Events' with target 'Data/Events/Beach')
+                    if (allowSubfolder)
+                        return true;
+
+                    // Special case: the prefix ends with a path separator, but subfolders aren't allowed. This case
+                    // matches if there's no further path separator in the asset name *after* the current separator.
+                    // For example, the prefix 'A/B/' matches 'A/B/C' but not 'A/B/C/D'.
+                    return pathSeparators.Contains(trimmedPrefix[^1]) && curParts.Remainder.Length == 0;
                 }
 
                 // previous segments matched exactly and both reached the end

From 9771cefa6a695b9e13737ccf37222810b3de3015 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 21:42:49 -0500
Subject: [PATCH 839/856] update release notes

---
 docs/release-notes.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 972360bc..c299cfa1 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -9,16 +9,18 @@
 
 ## Upcoming release
 * For players:
-  * Added config options to override the mod load order, for the rare cases where that's needed (thanks to Shockah!).
+  * Added config options to override the mod load order for specific mods (thanks to Shockah!).
   * Added config option to disable console input, which may reduce CPU usage on some Linux systems.
   * Set the max game version to 1.5.6 (since 1.6 will need a SMAPI update).
+  * Fixed map edits not always applied for farmhands in multiplayer (thanks to SinZ163!).
 
 * For mod authors:
   * Optimized asset name comparisons (thanks to atravita!).
   * Raised all deprecation messages to the final 'pending removal' level.
+  * **This is the last non-bugfix update before SMAPI 4.0.0, which will drop all deprecated APIs.** If you haven't [fixed deprecation warnings in your mod code](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0) (if any), you should do it soon. SMAPI 4.0.0 will release alongside the upcoming Stardew Valley 1.6.
 
 * For the web UI:
-  * Fixed log parser not showing screen IDs in split-screen mode, and improved screen display.
+  * The log parser now detects split-screen mode and shows which screen logged each message.
 
 ## 3.17.2
 Released 21 October 2022 for Stardew Valley 1.5.6 or later.

From c1e3b25dcaff2406fa1e3a457c1ba9c0f8ecda7f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Fri, 11 Nov 2022 21:43:42 -0500
Subject: [PATCH 840/856] fix load-early/late mods not correctly sorted
 relative to others in the same list

---
 src/SMAPI/Framework/ModLoading/ModResolver.cs | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/SMAPI/Framework/ModLoading/ModResolver.cs b/src/SMAPI/Framework/ModLoading/ModResolver.cs
index 96975e05..cb62e16f 100644
--- a/src/SMAPI/Framework/ModLoading/ModResolver.cs
+++ b/src/SMAPI/Framework/ModLoading/ModResolver.cs
@@ -174,14 +174,20 @@ namespace StardewModdingAPI.Framework.ModLoading
             if (!modIdsToLoadEarly.Any() && !modIdsToLoadLate.Any())
                 return mods;
 
+            string[] earlyArray = modIdsToLoadEarly.ToArray();
+            string[] lateArray = modIdsToLoadLate.ToArray();
+
             return mods
                 .OrderBy(mod =>
                 {
                     string id = mod.Manifest.UniqueID;
-                    if (modIdsToLoadEarly.Contains(id))
-                        return -1;
-                    if (modIdsToLoadLate.Contains(id))
-                        return 1;
+
+                    if (modIdsToLoadEarly.TryGetValue(id, out string? actualId))
+                        return -int.MaxValue + Array.IndexOf(earlyArray, actualId);
+
+                    if (modIdsToLoadLate.TryGetValue(id, out actualId))
+                        return int.MaxValue - Array.IndexOf(lateArray, actualId);
+
                     return 0;
                 })
                 .ToArray();

From 57d3e2b98ed5429e4bd61cd1cd33b84ec3ad7b8c Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 12 Nov 2022 13:50:02 -0500
Subject: [PATCH 841/856] also update multiplayer map cache for host player

---
 src/SMAPI/Metadata/CoreAssetPropagator.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/SMAPI/Metadata/CoreAssetPropagator.cs b/src/SMAPI/Metadata/CoreAssetPropagator.cs
index 037e4573..97ae32e4 100644
--- a/src/SMAPI/Metadata/CoreAssetPropagator.cs
+++ b/src/SMAPI/Metadata/CoreAssetPropagator.cs
@@ -1171,9 +1171,8 @@ namespace StardewModdingAPI.Metadata
             GameLocation location = locationInfo.Location;
             Vector2? playerPos = Game1.player?.Position;
 
-            // clear multiplayer cache for farmhands
-            if (!Context.IsMainPlayer)
-                this.Multiplayer.cachedMultiplayerMaps.Remove(location.NameOrUniqueName);
+            // remove from multiplayer cache
+            this.Multiplayer.cachedMultiplayerMaps.Remove(location.NameOrUniqueName);
 
             // reload map
             location.interiorDoors.Clear(); // prevent errors when doors try to update tiles which no longer exist

From 613946003d5a2a6ea7c13a4dca04bda4f2387957 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 12 Nov 2022 15:14:59 -0500
Subject: [PATCH 842/856] prepare for release

---
 build/common.targets                         |  2 +-
 docs/release-notes.md                        | 14 ++++++++------
 src/SMAPI.Mods.ConsoleCommands/manifest.json |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      |  4 ++--
 src/SMAPI/Constants.cs                       |  2 +-
 6 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 3c22b913..4b92ecc2 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.17.2</Version>
+    <Version>3.18.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index c299cfa1..9b2dea77 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,17 +7,19 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.18.0
+Released 12 November 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/74565278).
+
 * For players:
-  * Added config options to override the mod load order for specific mods (thanks to Shockah!).
-  * Added config option to disable console input, which may reduce CPU usage on some Linux systems.
-  * Set the max game version to 1.5.6 (since 1.6 will need a SMAPI update).
+  * You can now override the mod load order in `smapi-internal/config.json` (thanks to Shockah!).
+  * You can now disable console input in `smapi-internal/config.json`, which may reduce CPU usage on some Linux systems.
   * Fixed map edits not always applied for farmhands in multiplayer (thanks to SinZ163!).
+  * Internal changes to prepare for the upcoming Stardew Valley 1.6 and SMAPI 4.0.
 
 * For mod authors:
   * Optimized asset name comparisons (thanks to atravita!).
-  * Raised all deprecation messages to the final 'pending removal' level.
-  * **This is the last non-bugfix update before SMAPI 4.0.0, which will drop all deprecated APIs.** If you haven't [fixed deprecation warnings in your mod code](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0) (if any), you should do it soon. SMAPI 4.0.0 will release alongside the upcoming Stardew Valley 1.6.
+  * Raised all deprecation messages to the 'pending removal' level.
+  * **This is the last major update before SMAPI 4.0.0, which will drop all deprecated APIs.** If you haven't [fixed deprecation warnings in your mod code](https://stardewvalleywiki.com/Modding:Migrate_to_SMAPI_4.0) (if any), you should do it soon. SMAPI 4.0.0 will release alongside the upcoming Stardew Valley 1.6.
 
 * For the web UI:
   * The log parser now detects split-screen mode and shows which screen logged each message.
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index d1296dbe..ddb0e20d 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.17.2",
+    "Version": "3.18.0",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.17.2"
+    "MinimumApiVersion": "3.18.0"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index c3757e8f..eeea1d28 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.17.2",
+    "Version": "3.18.0",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.17.2"
+    "MinimumApiVersion": "3.18.0"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 78821a3e..0acf066d 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.17.2",
+    "Version": "3.18.0",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.17.2"
+    "MinimumApiVersion": "3.18.0"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 4cb30dc9..02e75e05 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.17.2";
+        internal static string RawApiVersion = "3.18.0";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From d521c20e8ae123bdcdbcabcc246ca24bc74dad3c Mon Sep 17 00:00:00 2001
From: AnotherPillow <Thepilous_@outlook.com>
Date: Sun, 13 Nov 2022 17:06:10 +0000
Subject: [PATCH 843/856] Only check for Error Handler on SMAPI 3.9+

---
 src/SMAPI.Web/Views/LogParser/Index.cshtml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/SMAPI.Web/Views/LogParser/Index.cshtml b/src/SMAPI.Web/Views/LogParser/Index.cshtml
index c1251c21..b989417e 100644
--- a/src/SMAPI.Web/Views/LogParser/Index.cshtml
+++ b/src/SMAPI.Web/Views/LogParser/Index.cshtml
@@ -248,7 +248,7 @@ else if (log?.IsValid == true)
         {
             <h2>Suggested fixes</h2>
             <ul id="fix-list">
-                @if (errorHandler is null)
+                @if (errorHandler is null && log.ApiVersionParsed?.IsNewerThan("3.8.4") is true)
                 {
                     <li class="important">You don't have the <strong>Error Handler</strong> mod installed. This automatically prevents many game or mod errors. You can <a href="https://stardewvalleywiki.com/Modding:Player_Guide#Install_SMAPI">reinstall SMAPI</a> to re-add it.</li>
                 }

From 72f5df2d207481b4d83ea34379ef0dada86ff8fc Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 13 Nov 2022 12:17:07 -0500
Subject: [PATCH 844/856] update release notes

---
 docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9b2dea77..13213a25 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
+## Upcoming release
+* For the web UI:
+  * The log parser no longer warns about missing Error Handler on Android, where it doesn't exist yet (thanks to AnotherPillow!).
+
 ## 3.18.0
 Released 12 November 2022 for Stardew Valley 1.5.6 or later. See [release highlights](https://www.patreon.com/posts/74565278).
 

From e2c1d2b1c9ff03853e77faf6d36b2a27f219b488 Mon Sep 17 00:00:00 2001
From: atravita-mods <94934860+atravita-mods@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:38:10 -0500
Subject: [PATCH 845/856] more indexing errors joy

---
 src/SMAPI/Framework/Content/AssetDataForImage.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 7c8cc6a8..5832570b 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -163,7 +163,8 @@ namespace StardewModdingAPI.Framework.Content
             int startIndex = -1;
             int endIndex = -1;
             {
-                for (int i = startRow * sourceArea.Width; i < pixelCount; i++)
+                int endPixel = pixelCount + startRow * sourceArea.Width;
+                for (int i = startRow * sourceArea.Width; i < endPixel; i++)
                 {
                     if (sourceData[i].A >= AssetDataForImage.MinOpacity)
                     {
@@ -174,7 +175,7 @@ namespace StardewModdingAPI.Framework.Content
                 if (startIndex == -1)
                     return; // blank texture
 
-                for (int i = startRow * sourceArea.Width + pixelCount - 1; i >= startIndex; i--)
+                for (int i = endPixel - 1; i >= startIndex; i--)
                 {
                     if (sourceData[i].A >= AssetDataForImage.MinOpacity)
                     {

From ae5829a3ee5ab1bde79735c6f3a0004f6047a922 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 14 Nov 2022 17:28:59 -0500
Subject: [PATCH 846/856] tweak variables for clarity

---
 .../Framework/Content/AssetDataForImage.cs    | 43 +++++++++----------
 1 file changed, 21 insertions(+), 22 deletions(-)

diff --git a/src/SMAPI/Framework/Content/AssetDataForImage.cs b/src/SMAPI/Framework/Content/AssetDataForImage.cs
index 5832570b..89ced1ba 100644
--- a/src/SMAPI/Framework/Content/AssetDataForImage.cs
+++ b/src/SMAPI/Framework/Content/AssetDataForImage.cs
@@ -140,9 +140,11 @@ namespace StardewModdingAPI.Framework.Content
         /// <exception cref="InvalidOperationException">The content being read isn't an image.</exception>
         private void PatchImageImpl(Color[] sourceData, int sourceWidth, int sourceHeight, Rectangle sourceArea, Rectangle targetArea, PatchMode patchMode, int startRow = 0)
         {
-            // get texture
+            // get texture info
             Texture2D target = this.Data;
             int pixelCount = sourceArea.Width * sourceArea.Height;
+            int firstPixel = startRow * sourceArea.Width;
+            int lastPixel = firstPixel + pixelCount - 1;
 
             // validate
             if (sourceArea.X < 0 || sourceArea.Y < 0 || sourceArea.Right > sourceWidth || sourceArea.Bottom > sourceHeight)
@@ -155,37 +157,34 @@ namespace StardewModdingAPI.Framework.Content
             // shortcut: replace the entire area
             if (patchMode == PatchMode.Replace)
             {
-                target.SetData(0, targetArea, sourceData, startRow * sourceArea.Width, pixelCount);
+                target.SetData(0, targetArea, sourceData, firstPixel, pixelCount);
                 return;
             }
 
             // skip transparent pixels at the start & end (e.g. large spritesheet with a few sprites replaced)
             int startIndex = -1;
             int endIndex = -1;
+            for (int i = firstPixel; i <= lastPixel; i++)
             {
-                int endPixel = pixelCount + startRow * sourceArea.Width;
-                for (int i = startRow * sourceArea.Width; i < endPixel; i++)
+                if (sourceData[i].A >= AssetDataForImage.MinOpacity)
                 {
-                    if (sourceData[i].A >= AssetDataForImage.MinOpacity)
-                    {
-                        startIndex = i;
-                        break;
-                    }
+                    startIndex = i;
+                    break;
                 }
-                if (startIndex == -1)
-                    return; // blank texture
-
-                for (int i = endPixel - 1; i >= startIndex; i--)
-                {
-                    if (sourceData[i].A >= AssetDataForImage.MinOpacity)
-                    {
-                        endIndex = i;
-                        break;
-                    }
-                }
-                if (endIndex == -1)
-                    return; // ???
             }
+            if (startIndex == -1)
+                return; // blank texture
+
+            for (int i = lastPixel; i >= startIndex; i--)
+            {
+                if (sourceData[i].A >= AssetDataForImage.MinOpacity)
+                {
+                    endIndex = i;
+                    break;
+                }
+            }
+            if (endIndex == -1)
+                return; // ???
 
             // update target rectangle
             int sourceOffset;

From 4c66aa63c53cd98e0fe63568747181ad9eb24a58 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 14 Nov 2022 17:45:43 -0500
Subject: [PATCH 847/856] update release notes

---
 docs/release-notes.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 13213a25..70694ce6 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -8,6 +8,9 @@
 -->
 
 ## Upcoming release
+* For players:
+  * Fixed mod texture edits sometimes cut off (thanks to atravita!).
+
 * For the web UI:
   * The log parser no longer warns about missing Error Handler on Android, where it doesn't exist yet (thanks to AnotherPillow!).
 

From a2944eed5c635ecf9afaefe9cf377f049a40731f Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Thu, 1 Dec 2022 19:43:56 -0500
Subject: [PATCH 848/856] prepare for release

---
 build/common.targets                         | 2 +-
 docs/release-notes.md                        | 4 +++-
 src/SMAPI.Mods.ConsoleCommands/manifest.json | 4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json    | 4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json      | 4 ++--
 src/SMAPI/Constants.cs                       | 2 +-
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 4b92ecc2..512107a0 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.18.0</Version>
+    <Version>3.18.1</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 70694ce6..ae98a0c4 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,7 +7,9 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.18.1
+Released 01 December 2022 for Stardew Valley 1.5.6 or later.
+
 * For players:
   * Fixed mod texture edits sometimes cut off (thanks to atravita!).
 
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index ddb0e20d..0afb5837 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.18.0",
+    "Version": "3.18.1",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.18.0"
+    "MinimumApiVersion": "3.18.1"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index eeea1d28..fe802d88 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.18.0",
+    "Version": "3.18.1",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.18.0"
+    "MinimumApiVersion": "3.18.1"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 0acf066d..9a587a2b 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.18.0",
+    "Version": "3.18.1",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.18.0"
+    "MinimumApiVersion": "3.18.1"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index 02e75e05..c5058e4b 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.18.0";
+        internal static string RawApiVersion = "3.18.1";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>

From 86607423916785ae7d0933436d8a755581f35b2b Mon Sep 17 00:00:00 2001
From: DaLion <daleao.matheus@gmail.com>
Date: Wed, 7 Dec 2022 18:13:17 -0300
Subject: [PATCH 849/856] Replaced slingshot ID check with Type check.

---
 src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 88ddfe6b..99de01b9 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -104,9 +104,10 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                 // weapons
                 if (ShouldGet(ItemType.Weapon))
                 {
-                    foreach (int id in this.TryLoad<int, string>("Data\\weapons").Keys)
+					var weaponsData = this.TryLoad<int, string>("Data\\weapons");
+                    foreach (int id in weaponsData.Keys)
                     {
-                        yield return this.TryCreate(ItemType.Weapon, id, p => p.ID is >= 32 and <= 34
+                        yield return this.TryCreate(ItemType.Weapon, id, p => weaponsData[p.ID].Split('/')[8] == "4"
                             ? new Slingshot(p.ID)
                             : new MeleeWeapon(p.ID)
                         );

From 45979c57dd350fc5c08155fd0794cf3c3519a256 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 28 Dec 2022 11:30:35 -0500
Subject: [PATCH 850/856] defer weapon data parsing until needed, handle
 invalid formats

---
 .../Framework/ItemRepository.cs                 | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
index 99de01b9..c4619577 100644
--- a/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
+++ b/src/SMAPI.Mods.ConsoleCommands/Framework/ItemRepository.cs
@@ -104,13 +104,18 @@ namespace StardewModdingAPI.Mods.ConsoleCommands.Framework
                 // weapons
                 if (ShouldGet(ItemType.Weapon))
                 {
-					var weaponsData = this.TryLoad<int, string>("Data\\weapons");
-                    foreach (int id in weaponsData.Keys)
+                    Dictionary<int, string> weaponsData = this.TryLoad<int, string>("Data\\weapons");
+                    foreach (KeyValuePair<int, string> pair in weaponsData)
                     {
-                        yield return this.TryCreate(ItemType.Weapon, id, p => weaponsData[p.ID].Split('/')[8] == "4"
-                            ? new Slingshot(p.ID)
-                            : new MeleeWeapon(p.ID)
-                        );
+                        string rawFields = pair.Value;
+                        yield return this.TryCreate(ItemType.Weapon, pair.Key, p =>
+                        {
+                            string[] fields = rawFields.Split('/');
+                            bool isSlingshot = fields.Length > 8 && fields[8] == "4";
+                            return isSlingshot
+                                ? new Slingshot(p.ID)
+                                : new MeleeWeapon(p.ID);
+                        });
                     }
                 }
 

From 81d3baa3b516a41c4be79e833516f890b92e3dbb Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Wed, 28 Dec 2022 11:35:05 -0500
Subject: [PATCH 851/856] simplify Save Backup compression

We don't need special handling for macOS anymore, since all platforms have .NET 5 now.
---
 docs/release-notes.md                 |  4 ++
 src/SMAPI.Mods.SaveBackup/ModEntry.cs | 57 +++------------------------
 2 files changed, 9 insertions(+), 52 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index ae98a0c4..54cbf96c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,6 +7,10 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
+## Upcoming release
+* For players:
+  * Fixed save backups being empty in rare cases on macOS.
+
 ## 3.18.1
 Released 01 December 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.Mods.SaveBackup/ModEntry.cs b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
index a79c092f..8a22a5f3 100644
--- a/src/SMAPI.Mods.SaveBackup/ModEntry.cs
+++ b/src/SMAPI.Mods.SaveBackup/ModEntry.cs
@@ -1,10 +1,8 @@
 using System;
-using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.IO.Compression;
 using System.Linq;
-using System.Reflection;
 using System.Threading.Tasks;
 using StardewValley;
 
@@ -81,7 +79,7 @@ namespace StardewModdingAPI.Mods.SaveBackup
                 }
 
                 // compress backup if possible
-                if (!this.TryCompress(fallbackDir.FullName, targetFile, out Exception? compressError))
+                if (!this.TryCompressDir(fallbackDir.FullName, targetFile, out Exception? compressError))
                 {
                     this.Monitor.Log(Constants.TargetPlatform != GamePlatform.Android
                         ? $"Backed up to {fallbackDir.FullName}." // expected to fail on Android
@@ -136,19 +134,16 @@ namespace StardewModdingAPI.Mods.SaveBackup
             }
         }
 
-        /// <summary>Create a zip using the best available method.</summary>
-        /// <param name="sourcePath">The file or directory path to zip.</param>
+        /// <summary>Try to create a compressed zip file for a directory.</summary>
+        /// <param name="sourcePath">The directory path to zip.</param>
         /// <param name="destination">The destination file to create.</param>
         /// <param name="error">The error which occurred trying to compress, if applicable. This is <see cref="NotSupportedException"/> if compression isn't supported on this platform.</param>
         /// <returns>Returns whether compression succeeded.</returns>
-        private bool TryCompress(string sourcePath, FileInfo destination, [NotNullWhen(false)] out Exception? error)
+        private bool TryCompressDir(string sourcePath, FileInfo destination, [NotNullWhen(false)] out Exception? error)
         {
             try
             {
-                if (Constants.TargetPlatform == GamePlatform.Mac)
-                    this.CompressUsingMacProcess(sourcePath, destination); // due to limitations with the bundled Mono on macOS, we can't reference System.IO.Compression
-                else
-                    this.CompressUsingNetFramework(sourcePath, destination);
+                ZipFile.CreateFromDirectory(sourcePath, destination.FullName, CompressionLevel.Fastest, false);
 
                 error = null;
                 return true;
@@ -160,48 +155,6 @@ namespace StardewModdingAPI.Mods.SaveBackup
             }
         }
 
-        /// <summary>Create a zip using the .NET compression library.</summary>
-        /// <param name="sourcePath">The file or directory path to zip.</param>
-        /// <param name="destination">The destination file to create.</param>
-        /// <exception cref="NotSupportedException">The compression libraries aren't available on this system.</exception>
-        private void CompressUsingNetFramework(string sourcePath, FileInfo destination)
-        {
-            // get compress method
-            MethodInfo createFromDirectory;
-            try
-            {
-                // create compressed backup
-                Assembly coreAssembly = Assembly.Load("System.IO.Compression, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089");
-                Assembly fsAssembly = Assembly.Load("System.IO.Compression.FileSystem, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089");
-                Type compressionLevelType = coreAssembly.GetType("System.IO.Compression.CompressionLevel") ?? throw new InvalidOperationException("Can't load CompressionLevel type.");
-                Type zipFileType = fsAssembly.GetType("System.IO.Compression.ZipFile") ?? throw new InvalidOperationException("Can't load ZipFile type.");
-                createFromDirectory = zipFileType.GetMethod("CreateFromDirectory", new[] { typeof(string), typeof(string), compressionLevelType, typeof(bool) }) ?? throw new InvalidOperationException("Can't load ZipFile.CreateFromDirectory method.");
-            }
-            catch (Exception ex)
-            {
-                throw new NotSupportedException("Couldn't load the .NET compression libraries on this system.", ex);
-            }
-
-            // compress file
-            createFromDirectory.Invoke(null, new object[] { sourcePath, destination.FullName, CompressionLevel.Fastest, false });
-        }
-
-        /// <summary>Create a zip using a process command on macOS.</summary>
-        /// <param name="sourcePath">The file or directory path to zip.</param>
-        /// <param name="destination">The destination file to create.</param>
-        private void CompressUsingMacProcess(string sourcePath, FileInfo destination)
-        {
-            DirectoryInfo saveFolder = new(sourcePath);
-            ProcessStartInfo startInfo = new()
-            {
-                FileName = "zip",
-                Arguments = $"-rq \"{destination.FullName}\" \"{saveFolder.Name}\" -x \"*.DS_Store\" -x \"__MACOSX\"",
-                WorkingDirectory = $"{saveFolder.FullName}/../",
-                CreateNoWindow = true
-            };
-            new Process { StartInfo = startInfo }.Start();
-        }
-
         /// <summary>Recursively copy a directory or file.</summary>
         /// <param name="source">The file or folder to copy.</param>
         /// <param name="targetFolder">The folder to copy into.</param>

From d35f45fc3242d330a2021017054e932eff64f2ca Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sat, 7 Jan 2023 17:55:15 -0500
Subject: [PATCH 852/856] fix game assemblies not excluded from release zip
 when bundle type not set

---
 docs/technical/mod-package.md                 |  1 +
 .../Framework/ModFileManager.cs               | 23 ++++++++++++++-----
 2 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 707b1641..0e710e50 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -414,6 +414,7 @@ when you compile it.
 ## Release notes
 ## Upcoming release
 * Added `manifest.json` format validation on build (thanks to tylergibbs2!).
+* Fixed game assemblies no longer excluded from the release zip if referenced explicitly without setting `BundleExtraAssemblies`.
 
 ### 4.0.2
 Released 09 October 2022.
diff --git a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
index 00f3f439..d47e492a 100644
--- a/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
+++ b/src/SMAPI.ModBuildConfig/Framework/ModFileManager.cs
@@ -215,13 +215,24 @@ namespace StardewModdingAPI.ModBuildConfig.Framework
                     return true;
             }
 
-            // check for bundled assembly types
-            // When bundleAssemblyTypes is set, *all* dependencies are copied into the build output but only those which match the given assembly types should be bundled.
-            if (bundleAssemblyTypes != ExtraAssemblyTypes.None)
+            // ignore by assembly type
+            ExtraAssemblyTypes type = this.GetExtraAssemblyType(file, modDllName);
+            switch (bundleAssemblyTypes)
             {
-                var type = this.GetExtraAssemblyType(file, modDllName);
-                if (type != ExtraAssemblyTypes.None && !bundleAssemblyTypes.HasFlag(type))
-                    return true;
+                // Only explicitly-referenced assemblies are in the build output. These should be added to the zip,
+                // since it's possible the game won't load them (except game assemblies which will always be loaded
+                // separately). If they're already loaded, SMAPI will just ignore them.
+                case ExtraAssemblyTypes.None:
+                    if (type is ExtraAssemblyTypes.Game)
+                        return true;
+                    break;
+
+                // All assemblies are in the build output (due to how .NET builds references), but only those which
+                // match the bundled type should be in the zip.
+                default:
+                    if (type != ExtraAssemblyTypes.None && !bundleAssemblyTypes.HasFlag(type))
+                        return true;
+                    break;
             }
 
             return false;

From b246fe61452f15026382c7d6da687116fec546e1 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 Jan 2023 16:43:23 -0500
Subject: [PATCH 853/856] update web to .NET 7

---
 src/SMAPI.Web/SMAPI.Web.csproj | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index 81b187fe..7d4013bd 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -2,7 +2,7 @@
   <PropertyGroup>
     <AssemblyName>SMAPI.Web</AssemblyName>
     <RootNamespace>StardewModdingAPI.Web</RootNamespace>
-    <TargetFramework>net6.0</TargetFramework>
+    <TargetFramework>net7.0</TargetFramework>
     <LangVersion>latest</LangVersion>
   </PropertyGroup>
 
@@ -22,7 +22,7 @@
     <PackageReference Include="Humanizer.Core" Version="2.14.1" />
     <PackageReference Include="JetBrains.Annotations" Version="2022.1.0" />
     <PackageReference Include="Markdig" Version="0.30.2" />
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="6.0.5" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="7.0.1" />
     <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.14" />
     <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.5" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.2.0" />

From 5518b8d461732796b0da5f4c9ba85be96bddc205 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 Jan 2023 16:48:30 -0500
Subject: [PATCH 854/856] update packages

---
 docs/release-notes.md                                  |  3 +++
 .../SMAPI.ModBuildConfig.Analyzer.Tests.csproj         |  4 ++--
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj   |  2 +-
 src/SMAPI.Tests/SMAPI.Tests.csproj                     | 10 +++++-----
 src/SMAPI.Toolkit/SMAPI.Toolkit.csproj                 |  4 ++--
 src/SMAPI.Web/SMAPI.Web.csproj                         | 10 +++++-----
 src/SMAPI/SMAPI.csproj                                 |  6 +++---
 7 files changed, 21 insertions(+), 18 deletions(-)

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 54cbf96c..3731157b 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -11,6 +11,9 @@
 * For players:
   * Fixed save backups being empty in rare cases on macOS.
 
+* For mod authors:
+  * Updated to Newtonsoft.Json 13.0.2 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.2)) and Pintail 2.2.1 (see [changes](https://github.com/Nanoray-pl/Pintail/blob/master/docs/release-notes.md#222)).
+
 ## 3.18.1
 Released 01 December 2022 for Stardew Valley 1.5.6 or later.
 
diff --git a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
index 3be9c225..1719d39b 100644
--- a/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
+++ b/src/SMAPI.ModBuildConfig.Analyzer.Tests/SMAPI.ModBuildConfig.Analyzer.Tests.csproj
@@ -6,9 +6,9 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="3.10.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.2.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.4.1" />
     <PackageReference Include="NUnit" Version="3.13.3" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.3.1" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index cded6f65..efc808a1 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -24,7 +24,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.Build.Utilities.Core" Version="16.10" />
-    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.2" />
 
     <!--
       This is imported through Microsoft.Build.Utilities.Core. When installed by a mod, NuGet
diff --git a/src/SMAPI.Tests/SMAPI.Tests.csproj b/src/SMAPI.Tests/SMAPI.Tests.csproj
index 597cd7dd..0b1fb638 100644
--- a/src/SMAPI.Tests/SMAPI.Tests.csproj
+++ b/src/SMAPI.Tests/SMAPI.Tests.csproj
@@ -14,12 +14,12 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="FluentAssertions" Version="6.7.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.2.0" />
-    <PackageReference Include="Moq" Version="4.18.1" />
-    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
+    <PackageReference Include="FluentAssertions" Version="6.8.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.4.1" />
+    <PackageReference Include="Moq" Version="4.18.4" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.2" />
     <PackageReference Include="NUnit" Version="3.13.3" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.3.1" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
index 10f1df70..9529241f 100644
--- a/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
+++ b/src/SMAPI.Toolkit/SMAPI.Toolkit.csproj
@@ -9,8 +9,8 @@
   <Import Project="..\..\build\common.targets" />
 
   <ItemGroup>
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.43" />
-    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.46" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.2" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.2.0" />
     <PackageReference Include="System.Management" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
     <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" Condition="'$(OS)' == 'Windows_NT'" />
diff --git a/src/SMAPI.Web/SMAPI.Web.csproj b/src/SMAPI.Web/SMAPI.Web.csproj
index 7d4013bd..1c0e4e42 100644
--- a/src/SMAPI.Web/SMAPI.Web.csproj
+++ b/src/SMAPI.Web/SMAPI.Web.csproj
@@ -15,13 +15,13 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Azure.Storage.Blobs" Version="12.13.0" />
-    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.29" />
+    <PackageReference Include="Azure.Storage.Blobs" Version="12.14.1" />
+    <PackageReference Include="Hangfire.AspNetCore" Version="1.7.32" />
     <PackageReference Include="Hangfire.MemoryStorage" Version="1.7.0" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.43" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.46" />
     <PackageReference Include="Humanizer.Core" Version="2.14.1" />
-    <PackageReference Include="JetBrains.Annotations" Version="2022.1.0" />
-    <PackageReference Include="Markdig" Version="0.30.2" />
+    <PackageReference Include="JetBrains.Annotations" Version="2022.3.1" />
+    <PackageReference Include="Markdig" Version="0.30.4" />
     <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="7.0.1" />
     <PackageReference Include="Newtonsoft.Json.Schema" Version="3.0.14" />
     <PackageReference Include="Pathoschild.FluentNexus" Version="1.0.5" />
diff --git a/src/SMAPI/SMAPI.csproj b/src/SMAPI/SMAPI.csproj
index e5d8937c..59ad47f0 100644
--- a/src/SMAPI/SMAPI.csproj
+++ b/src/SMAPI/SMAPI.csproj
@@ -22,12 +22,12 @@
   <Import Project="..\..\build\common.targets" />
 
   <ItemGroup>
-    <PackageReference Include="LargeAddressAware" Version="1.0.5" />
+    <PackageReference Include="LargeAddressAware" Version="1.0.6" />
     <PackageReference Include="Mono.Cecil" Version="0.11.4" />
     <PackageReference Include="MonoMod.Common" Version="22.3.5.1" />
-    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.2" />
     <PackageReference Include="Pathoschild.Http.FluentClient" Version="4.2.0" />
-    <PackageReference Include="Pintail" Version="2.2.1" />
+    <PackageReference Include="Pintail" Version="2.2.2" />
     <PackageReference Include="Platonymous.TMXTile" Version="1.5.9" />
     <PackageReference Include="System.Reflection.Emit" Version="4.7.0" />
 

From e5407417a0cc80f9cb3d7eb7b43bdb207322a4ec Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Sun, 8 Jan 2023 22:05:22 -0500
Subject: [PATCH 855/856] add delegating mod hooks for mod use

---
 docs/release-notes.md                     |   1 +
 src/SMAPI/Framework/SCore.cs              |  10 +-
 src/SMAPI/Framework/SModHooks.cs          |  18 ++-
 src/SMAPI/Utilities/DelegatingModHooks.cs | 137 ++++++++++++++++++++++
 4 files changed, 153 insertions(+), 13 deletions(-)
 create mode 100644 src/SMAPI/Utilities/DelegatingModHooks.cs

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 3731157b..d095ce7c 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -12,6 +12,7 @@
   * Fixed save backups being empty in rare cases on macOS.
 
 * For mod authors:
+  * Added `DelegatingModHooks` utility for rare cases where a mod needs to override SMAPI's mod hooks in the game directly.
   * Updated to Newtonsoft.Json 13.0.2 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.2)) and Pintail 2.2.1 (see [changes](https://github.com/Nanoray-pl/Pintail/blob/master/docs/release-notes.md#222)).
 
 ## 3.18.1
diff --git a/src/SMAPI/Framework/SCore.cs b/src/SMAPI/Framework/SCore.cs
index c977ad65..1d146d5f 100644
--- a/src/SMAPI/Framework/SCore.cs
+++ b/src/SMAPI/Framework/SCore.cs
@@ -258,7 +258,11 @@ namespace StardewModdingAPI.Framework
                     monitor: this.Monitor,
                     reflection: this.Reflection,
                     eventManager: this.EventManager,
-                    modHooks: new SModHooks(this.OnNewDayAfterFade, this.Monitor),
+                    modHooks: new SModHooks(
+                        parent: new ModHooks(),
+                        beforeNewDayAfterFade: this.OnNewDayAfterFade,
+                        monitor: this.Monitor
+                    ),
                     multiplayer: this.Multiplayer,
                     exitGameImmediately: this.ExitGameImmediately,
 
@@ -1795,7 +1799,7 @@ namespace StardewModdingAPI.Framework
                     // call entry method
                     try
                     {
-                        mod.Entry(mod.Helper!);
+                        mod.Entry(mod.Helper);
                     }
                     catch (Exception ex)
                     {
@@ -1822,7 +1826,7 @@ namespace StardewModdingAPI.Framework
                     }
 
                     // validate mod doesn't implement both GetApi() and GetApi(mod)
-                    if (metadata.Api != null && mod.GetType().GetMethod(nameof(Mod.GetApi), new Type[] { typeof(IModInfo) })!.DeclaringType != typeof(Mod))
+                    if (metadata.Api != null && mod.GetType().GetMethod(nameof(Mod.GetApi), new[] { typeof(IModInfo) })!.DeclaringType != typeof(Mod))
                         metadata.LogAsMod($"Mod implements both {nameof(Mod.GetApi)}() and {nameof(Mod.GetApi)}({nameof(IModInfo)}), which isn't allowed. The latter will be ignored.", LogLevel.Error);
                 }
                 Context.HeuristicModsRunningCode.TryPop(out _);
diff --git a/src/SMAPI/Framework/SModHooks.cs b/src/SMAPI/Framework/SModHooks.cs
index a7736c8b..ac4f242c 100644
--- a/src/SMAPI/Framework/SModHooks.cs
+++ b/src/SMAPI/Framework/SModHooks.cs
@@ -1,11 +1,12 @@
 using System;
 using System.Threading.Tasks;
+using StardewModdingAPI.Utilities;
 using StardewValley;
 
 namespace StardewModdingAPI.Framework
 {
     /// <summary>Invokes callbacks for mod hooks provided by the game.</summary>
-    internal class SModHooks : ModHooks
+    internal class SModHooks : DelegatingModHooks
     {
         /*********
         ** Fields
@@ -21,25 +22,24 @@ namespace StardewModdingAPI.Framework
         ** Public methods
         *********/
         /// <summary>Construct an instance.</summary>
+        /// <param name="parent">The underlying hooks to call by default.</param>
         /// <param name="beforeNewDayAfterFade">A callback to invoke before <see cref="Game1.newDayAfterFade"/> runs.</param>
         /// <param name="monitor">Writes messages to the console.</param>
-        public SModHooks(Action beforeNewDayAfterFade, IMonitor monitor)
+        public SModHooks(ModHooks parent, Action beforeNewDayAfterFade, IMonitor monitor)
+            : base(parent)
         {
             this.BeforeNewDayAfterFade = beforeNewDayAfterFade;
             this.Monitor = monitor;
         }
 
-        /// <summary>A hook invoked when <see cref="Game1.newDayAfterFade"/> is called.</summary>
-        /// <param name="action">The vanilla <see cref="Game1.newDayAfterFade"/> logic.</param>
+        /// <inheritdoc />
         public override void OnGame1_NewDayAfterFade(Action action)
         {
             this.BeforeNewDayAfterFade();
             action();
         }
 
-        /// <summary>Start an asynchronous task for the game.</summary>
-        /// <param name="task">The task to start.</param>
-        /// <param name="id">A unique key which identifies the task.</param>
+        /// <inheritdoc />
         public override Task StartTask(Task task, string id)
         {
             this.Monitor.Log($"Synchronizing '{id}' task...");
@@ -48,9 +48,7 @@ namespace StardewModdingAPI.Framework
             return task;
         }
 
-        /// <summary>Start an asynchronous task for the game.</summary>
-        /// <param name="task">The task to start.</param>
-        /// <param name="id">A unique key which identifies the task.</param>
+        /// <inheritdoc />
         public override Task<T> StartTask<T>(Task<T> task, string id)
         {
             this.Monitor.Log($"Synchronizing '{id}' task...");
diff --git a/src/SMAPI/Utilities/DelegatingModHooks.cs b/src/SMAPI/Utilities/DelegatingModHooks.cs
new file mode 100644
index 00000000..3ebcf997
--- /dev/null
+++ b/src/SMAPI/Utilities/DelegatingModHooks.cs
@@ -0,0 +1,137 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.Xna.Framework.Input;
+using StardewModdingAPI.Events;
+using StardewModdingAPI.Framework;
+using StardewValley;
+using StardewValley.Events;
+
+namespace StardewModdingAPI.Utilities
+{
+    /// <summary>An implementation of <see cref="ModHooks"/> which automatically calls the parent instance for any method that's not overridden.</summary>
+    /// <remarks>The mod hooks are primarily meant for SMAPI to use. Using this directly in mods is a last resort, since it's very easy to break SMAPI this way. This class requires that SMAPI is present in the parent chain.</remarks>
+    public class DelegatingModHooks : ModHooks
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The underlying instance to delegate to by default.</summary>
+        public ModHooks Parent { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="modHooks">The underlying instance to delegate to by default.</param>
+        public DelegatingModHooks(ModHooks modHooks)
+        {
+            this.AssertSmapiInChain(modHooks);
+
+            this.Parent = modHooks;
+        }
+
+        /// <summary>Raised before the in-game clock changes.</summary>
+        /// <param name="action">Run the vanilla update logic.</param>
+        /// <remarks>In mods, consider using <see cref="IGameLoopEvents.TimeChanged"/> instead.</remarks>
+        public override void OnGame1_PerformTenMinuteClockUpdate(Action action)
+        {
+            this.Parent.OnGame1_PerformTenMinuteClockUpdate(action);
+        }
+
+        /// <summary>Raised before initializing the new day and saving.</summary>
+        /// <param name="action">Run the vanilla update logic.</param>
+        /// <remarks>In mods, consider using <see cref="IGameLoopEvents.DayEnding"/> or <see cref="IGameLoopEvents.Saving"/> instead.</remarks>
+        public override void OnGame1_NewDayAfterFade(Action action)
+        {
+            this.Parent.OnGame1_NewDayAfterFade(action);
+        }
+
+        /// <summary>Raised before showing the end-of-day menus (e.g. shipping menus, level-up screen, etc).</summary>
+        /// <param name="action">Run the vanilla update logic.</param>
+        public override void OnGame1_ShowEndOfNightStuff(Action action)
+        {
+            this.Parent.OnGame1_ShowEndOfNightStuff(action);
+        }
+
+        /// <summary>Raised before updating the gamepad, mouse, and keyboard input state.</summary>
+        /// <param name="keyboardState">The keyboard state.</param>
+        /// <param name="mouseState">The mouse state.</param>
+        /// <param name="gamePadState">The gamepad state.</param>
+        /// <param name="action">Run the vanilla update logic.</param>
+        /// <remarks>In mods, consider using <see cref="IInputEvents"/> instead.</remarks>
+        public override void OnGame1_UpdateControlInput(ref KeyboardState keyboardState, ref MouseState mouseState, ref GamePadState gamePadState, Action action)
+        {
+            this.Parent.OnGame1_UpdateControlInput(ref keyboardState, ref mouseState, ref gamePadState, action);
+        }
+
+        /// <summary>Raised before a location is updated for the local player entering it.</summary>
+        /// <param name="location">The location that will be updated.</param>
+        /// <param name="action">Run the vanilla update logic.</param>
+        /// <remarks>In mods, consider using <see cref="IPlayerEvents.Warped"/> instead.</remarks>
+        public override void OnGameLocation_ResetForPlayerEntry(GameLocation location, Action action)
+        {
+            this.Parent.OnGameLocation_ResetForPlayerEntry(location, action);
+        }
+
+        /// <summary>Raised before the game checks for an action to trigger for a player interaction with a tile.</summary>
+        /// <param name="location">The location being checked.</param>
+        /// <param name="tileLocation">The tile position being checked.</param>
+        /// <param name="viewport">The game's current position and size within the map, measured in pixels.</param>
+        /// <param name="who">The player interacting with the tile.</param>
+        /// <param name="action">Run the vanilla update logic.</param>
+        /// <returns>Returns whether the interaction was handled.</returns>
+        public override bool OnGameLocation_CheckAction(GameLocation location, xTile.Dimensions.Location tileLocation, xTile.Dimensions.Rectangle viewport, Farmer who, Func<bool> action)
+        {
+            return this.Parent.OnGameLocation_CheckAction(location, tileLocation, viewport, who, action);
+        }
+
+        /// <summary>Raised before the game picks a night event to show on the farm after the player sleeps.</summary>
+        /// <param name="action">Run the vanilla update logic.</param>
+        /// <returns>Returns the selected farm event.</returns>
+        public override FarmEvent OnUtility_PickFarmEvent(Func<FarmEvent> action)
+        {
+            return this.Parent.OnUtility_PickFarmEvent(action);
+        }
+
+        /// <summary>Start an asynchronous task for the game.</summary>
+        /// <param name="task">The task to start.</param>
+        /// <param name="id">A unique key which identifies the task.</param>
+        public override Task StartTask(Task task, string id)
+        {
+            return this.Parent.StartTask(task, id);
+        }
+
+        /// <summary>Start an asynchronous task for the game.</summary>
+        /// <typeparam name="T">The type returned by the task when it completes.</typeparam>
+        /// <param name="task">The task to start.</param>
+        /// <param name="id">A unique key which identifies the task.</param>
+        public override Task<T> StartTask<T>(Task<T> task, string id)
+        {
+            return this.Parent.StartTask<T>(task, id);
+        }
+
+
+        /*********
+        ** Private methods
+        *********/
+        /// <summary>Assert that SMAPI's mod hook implementation is in the inheritance chain.</summary>
+        /// <param name="hooks">The mod hooks to check.</param>
+        private void AssertSmapiInChain(ModHooks hooks)
+        {
+            // this is SMAPI
+            if (this is SModHooks)
+                return;
+
+            // SMAPI in delegated chain
+            for (ModHooks? cur = hooks; cur != null; cur = (cur as DelegatingModHooks)?.Parent)
+            {
+                if (cur is SModHooks)
+                    return;
+            }
+
+            // SMAPI not found
+            throw new InvalidOperationException($"Can't create a {nameof(DelegatingModHooks)} instance without SMAPI's mod hooks in the parent chain.");
+        }
+    }
+}

From 25b8e13ba827a0512f5089d3bd22e8ed1a15e7ba Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <Pathoschild@users.noreply.github.com>
Date: Mon, 9 Jan 2023 12:27:29 -0500
Subject: [PATCH 856/856] prepare for release

---
 build/common.targets                                 |  2 +-
 docs/release-notes.md                                | 11 +++++++----
 docs/technical/mod-package.md                        |  6 ++++--
 src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj |  2 +-
 src/SMAPI.Mods.ConsoleCommands/manifest.json         |  4 ++--
 src/SMAPI.Mods.ErrorHandler/manifest.json            |  4 ++--
 src/SMAPI.Mods.SaveBackup/manifest.json              |  4 ++--
 src/SMAPI/Constants.cs                               |  2 +-
 8 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/build/common.targets b/build/common.targets
index 512107a0..590e0415 100644
--- a/build/common.targets
+++ b/build/common.targets
@@ -7,7 +7,7 @@ repo. It imports the other MSBuild files as needed.
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <!--set general build properties -->
-    <Version>3.18.1</Version>
+    <Version>3.18.2</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>
diff --git a/docs/release-notes.md b/docs/release-notes.md
index d095ce7c..9eb55b36 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -7,13 +7,16 @@
   _If needed, you can update to SMAPI 3.16.0 first and then install the latest version._
 -->
 
-## Upcoming release
+## 3.18.2
+Released 09 January 2023 for Stardew Valley 1.5.6 or later.
+
 * For players:
-  * Fixed save backups being empty in rare cases on macOS.
+  * Fixed empty save backups for some macOS players.
+  * Fixed `player_add` console command not handling custom slingshots correctly (thanks too DaLion!).
 
 * For mod authors:
-  * Added `DelegatingModHooks` utility for rare cases where a mod needs to override SMAPI's mod hooks in the game directly.
-  * Updated to Newtonsoft.Json 13.0.2 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.2)) and Pintail 2.2.1 (see [changes](https://github.com/Nanoray-pl/Pintail/blob/master/docs/release-notes.md#222)).
+  * Added `DelegatingModHooks` utility for mods which need to override SMAPI's mod hooks directly.
+  * Updated to Newtonsoft.Json 13.0.2 (see [changes](https://github.com/JamesNK/Newtonsoft.Json/releases/tag/13.0.2)) and Pintail 2.2.2 (see [changes](https://github.com/Nanoray-pl/Pintail/blob/master/docs/release-notes.md#222)).
 
 ## 3.18.1
 Released 01 December 2022 for Stardew Valley 1.5.6 or later.
diff --git a/docs/technical/mod-package.md b/docs/technical/mod-package.md
index 0e710e50..23f0b221 100644
--- a/docs/technical/mod-package.md
+++ b/docs/technical/mod-package.md
@@ -412,9 +412,11 @@ The NuGet package is generated automatically in `StardewModdingAPI.ModBuildConfi
 when you compile it.
 
 ## Release notes
-## Upcoming release
+### 4.1.0
+Released 08 January 2023.
+
 * Added `manifest.json` format validation on build (thanks to tylergibbs2!).
-* Fixed game assemblies no longer excluded from the release zip if referenced explicitly without setting `BundleExtraAssemblies`.
+* Fixed game DLLs not excluded from the release zip when they're referenced explicitly but `BundleExtraAssemblies` isn't set.
 
 ### 4.0.2
 Released 09 October 2022.
diff --git a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
index efc808a1..badabfc7 100644
--- a/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
+++ b/src/SMAPI.ModBuildConfig/SMAPI.ModBuildConfig.csproj
@@ -10,7 +10,7 @@
     <!--NuGet package-->
     <PackageId>Pathoschild.Stardew.ModBuildConfig</PackageId>
     <Title>Build package for SMAPI mods</Title>
-    <Version>4.0.2</Version>
+    <Version>4.1.0</Version>
     <Authors>Pathoschild</Authors>
     <Description>Automates the build configuration for crossplatform Stardew Valley SMAPI mods. For SMAPI 3.13.0 or later.</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
diff --git a/src/SMAPI.Mods.ConsoleCommands/manifest.json b/src/SMAPI.Mods.ConsoleCommands/manifest.json
index 0afb5837..6ababef0 100644
--- a/src/SMAPI.Mods.ConsoleCommands/manifest.json
+++ b/src/SMAPI.Mods.ConsoleCommands/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Console Commands",
     "Author": "SMAPI",
-    "Version": "3.18.1",
+    "Version": "3.18.2",
     "Description": "Adds SMAPI console commands that let you manipulate the game.",
     "UniqueID": "SMAPI.ConsoleCommands",
     "EntryDll": "ConsoleCommands.dll",
-    "MinimumApiVersion": "3.18.1"
+    "MinimumApiVersion": "3.18.2"
 }
diff --git a/src/SMAPI.Mods.ErrorHandler/manifest.json b/src/SMAPI.Mods.ErrorHandler/manifest.json
index fe802d88..82630479 100644
--- a/src/SMAPI.Mods.ErrorHandler/manifest.json
+++ b/src/SMAPI.Mods.ErrorHandler/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Error Handler",
     "Author": "SMAPI",
-    "Version": "3.18.1",
+    "Version": "3.18.2",
     "Description": "Handles some common vanilla errors to log more useful info or avoid breaking the game.",
     "UniqueID": "SMAPI.ErrorHandler",
     "EntryDll": "ErrorHandler.dll",
-    "MinimumApiVersion": "3.18.1"
+    "MinimumApiVersion": "3.18.2"
 }
diff --git a/src/SMAPI.Mods.SaveBackup/manifest.json b/src/SMAPI.Mods.SaveBackup/manifest.json
index 9a587a2b..e29a3ed3 100644
--- a/src/SMAPI.Mods.SaveBackup/manifest.json
+++ b/src/SMAPI.Mods.SaveBackup/manifest.json
@@ -1,9 +1,9 @@
 {
     "Name": "Save Backup",
     "Author": "SMAPI",
-    "Version": "3.18.1",
+    "Version": "3.18.2",
     "Description": "Automatically backs up all your saves once per day into its folder.",
     "UniqueID": "SMAPI.SaveBackup",
     "EntryDll": "SaveBackup.dll",
-    "MinimumApiVersion": "3.18.1"
+    "MinimumApiVersion": "3.18.2"
 }
diff --git a/src/SMAPI/Constants.cs b/src/SMAPI/Constants.cs
index c5058e4b..482ec816 100644
--- a/src/SMAPI/Constants.cs
+++ b/src/SMAPI/Constants.cs
@@ -52,7 +52,7 @@ namespace StardewModdingAPI
         internal static int? LogScreenId { get; set; }
 
         /// <summary>SMAPI's current raw semantic version.</summary>
-        internal static string RawApiVersion = "3.18.1";
+        internal static string RawApiVersion = "3.18.2";
     }
 
     /// <summary>Contains SMAPI's constants and assumptions.</summary>